Release v1.1.1

CHANGELOG.md

@@ -3,6 +3,27 @@
 All notable changes to Micron2HTML are documented in this file.
 The format follows [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [Unreleased]
+
+## [1.1.1] - 2026-08-09
+
+### Added
+
+- **`` `FT<6hex> `` / `` `BT<6hex> `` — 24-bit exact-color escape from
+  NomadNet's reference parser** (e.g. `` `FT8b4513 `` for saddle-brown
+  foreground). Re-added after being dropped in earlier versions. Not
+  portable — MeshChat's `MicronParser.js` doesn't render this form —
+  so pages targeting cross-client compatibility should still use the
+  standard `` `Fxxx `` 3-hex shorthand. Intended for authors who need
+  exact colors on Micron2HTML-based renderers and are willing to
+  accept the portability cost.
+
+  Invalid or too-short input consumes the full `` T + 6 `` chars so
+  garbage doesn't leak as text, matching the 3-hex parser's
+  "always consume, apply only when valid" convention. 3-hex remains
+  the default and always-portable form; the T-prefix is checked
+  first so `` `FTrrggbb `` isn't mis-consumed as `` `FT?? ``.
+
 ## [1.1.0] - 2026-07-30
 
 ### Changed — goal correction: MeshChat parity → NomadNet parity

__init__.py

@@ -1,4 +1,4 @@
 from .converter import MicronConverter, default_url_resolver, UrlResolver, slugify_micron
 
 __all__ = ["MicronConverter", "default_url_resolver", "UrlResolver", "slugify_micron"]
-__version__ = "1.1.0"
+__version__ = "1.1.1"

converter.py

@@ -750,26 +750,40 @@ def _parse_inline(self, text: str, node_hash: str, base_path: str,
     def _parse_color(self, text: str, i: int, n: int):
         """Parse a Micron color token after the F/B prefix.
 
-        Format: 3 hex chars — each nibble doubled (f→ff, 8→88, 0→00).
+        Two forms:
+
+          1. **3 hex chars** — each nibble doubled (f→ff, 8→88, 0→00).
+             This is the canonical form and the one MeshChat +
+             every mainstream .mu page uses.
+          2. **``T`` + 6 hex chars** — a 24-bit exact-color extension
+             from NomadNet's reference parser (e.g. ``FTrrggbb``).
+             Not portable — MeshChat doesn't render it; pages relying
+             on it will look wrong on MeshChat. Supported here for
+             feature parity with NomadNet's parser and for authors who
+             need exact colors on Micron2HTML-based clients, but
+             actively discouraged in documentation.
 
         NomadNet parity notes:
-          - Always consume the next 3 chars after F/B (if available),
-            regardless of whether they're valid hex. Both MicronParser.py
-            (`line[i+1:i+4]` + `skip = 3`) and MeshChat's MicronParser.js
-            (`line.substr(i+1,3)` + `skip = 3`) do this unconditionally.
-          - If the 3 chars aren't valid hex, no colour is applied (the
-            colour-state holds the invalid string; rendering ignores it),
-            but the 3 chars are still consumed so they don't leak as text.
-          - NomadNet's *reference parser* also accepts a `T<6hex>` 24-bit
-            form (`FTrrggbb`) — but its own Guide.py never teaches this to
-            page authors, and MeshChat doesn't implement it either. Since
-            the point of this converter is to render what real `.mu` pages
-            actually contain, not every corner of one client's source, we
-            deliberately stay 3-hex-only: any real-world page relying on
-            `FT<6hex>` wouldn't render correctly in MeshChat anyway.
+          - Always consume the next 3 (or ``T`` + 6) chars after F/B
+            if available, regardless of whether they're valid hex.
+            Both NomadNet's MicronParser.py and MeshChat's
+            MicronParser.js do this unconditionally so garbage
+            doesn't leak into rendered text.
+          - If the chars aren't valid hex, no colour is applied
+            (the colour-state holds the invalid string; rendering
+            ignores it).
 
         Returns (css_color_str | None, new_index).
         """
+        # T<6hex> exact-color extension — check BEFORE the 3-hex path
+        # so a `FTrrggbb` isn't mis-consumed as `T` + garbage.
+        if i < n and text[i] == "T" and i + 7 <= n:
+            h6 = text[i + 1:i + 7]
+            if all(c in _HEX for c in h6):
+                return "#" + h6.lower(), i + 7
+            # Invalid 6-hex — still consume ``T`` + 6 chars so they
+            # don't leak into rendered text.
+            return None, i + 7
         if i + 3 <= n:
             h3 = text[i:i + 3]
             if all(c in _HEX for c in h3):

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "Micron2HTML"
-version = "1.1.0"
+version = "1.1.1"
 description = "Convert Micron markup (NomadNet) to HTML"
 readme = "README.md"
 license = { text = "MIT" }

tests/test_converter.py

@@ -242,16 +242,40 @@ def test_invalid_hex_consumes_three_chars(self, conv):
         assert "xxx" not in out
         assert "hello" in out
 
-    def test_24bit_T_format_not_supported(self, conv):
-        # NomadNet's own reference parser DOES accept `FT<6hex>`, but its
-        # Guide.py never teaches it and MeshChat doesn't implement it — we
-        # stay 3-hex-only to match what real page authors actually write.
-        # The `T` plus 2 next chars are consumed as a (failed) 3-char hex,
-        # leaving the tail as visible text.
+    def test_24bit_T_format_fg(self, conv):
+        # NomadNet's reference parser accepts `FT<6hex>` for exact
+        # 24-bit color. Re-added for feature parity — MeshChat still
+        # doesn't render this form, so it's actively discouraged in
+        # authoring docs, but the parser handles it correctly.
         out = conv.convert("`FT8b4513 brown`f")
-        assert "color:#8b4513" not in out
-        assert "color:#" not in out  # no colour applied
+        assert "color:#8b4513" in out
         assert "brown" in out
+        # `T + 6 hex` (7 chars) must be fully consumed — nothing leaks
+        assert "8b4513" not in out.split(">")[-1]  # no leak into text
+
+    def test_24bit_T_format_bg(self, conv):
+        # Same behaviour on the background side.
+        out = conv.convert("`BT2c3e50 dark`b")
+        assert "background-color:#2c3e50" in out
+        assert "dark" in out
+
+    def test_24bit_T_format_invalid_hex_consumes_all_seven(self, conv):
+        # Invalid 6-hex after `T` still consumes all 7 chars (the T
+        # plus the six that follow) so garbage doesn't leak as text.
+        # Matches the 3-hex parser's "always consume, apply only
+        # when valid" convention.
+        out = conv.convert("`FTzzzzzz visible`f")
+        assert "color:#" not in out
+        assert "zzzzzz" not in out
+        assert "visible" in out
+
+    def test_24bit_T_format_falls_back_when_too_short(self, conv):
+        # `FT` with fewer than 6 chars after is treated as a normal
+        # 3-hex attempt on `T??` — invalid, consumes 3 chars.
+        # Guards against a `FTab` string near end-of-input crashing
+        # or being interpreted as a partial exact-color escape.
+        out = conv.convert("`FTab")
+        assert "color:#" not in out
 
     def test_header_fg_bg_3digit(self, conv):
         out = conv.convert("#!bg=333\n#!fg=aaa\nhello")