@north-light/crouter 0.3.160 → 0.3.162

package/dist/clients/attach/__tests__/markdown-headings.test.js

@@ -25,3 +25,11 @@ test('copies message blocks for terminal-only decoration', () => {
     assert.match(rendered.content[0].text, /^\x1b\[[^m]+mDetail/);
     assert.equal(rendered.content[1], source.content[1], 'non-Markdown blocks preserve identity');
 });
+test('expands private-use codepoint references to glyphs, and only those', () => {
+    const source = { content: [{ type: 'text', text: 'icons: U+F188 U+F0001 — not U+0041 or U+241C, nor MU+FFFF' }] };
+    const rendered = styleAttachMessageMarkdown(source);
+    const text = rendered.content[0].text;
+    assert.match(text, new RegExp(`icons: ${String.fromCodePoint(0xf188)} ${String.fromCodePoint(0xf0001)}`), 'PUA references become their glyphs');
+    assert.match(text, /not U\+0041 or U\+241C/, 'ordinary codepoint references stay as text');
+    assert.match(text, /MU\+FFFF/, 'a reference glued to a word is not a reference');
+});

package/dist/clients/attach/render/glyph-codepoints.d.ts

@@ -0,0 +1,3 @@
+/** Replace every private-use `U+XXXX` reference in `text` with the character it
+ *  names. Non-PUA references and malformed digits pass through untouched. */
+export declare function expandGlyphCodepoints(text: string): string;

package/dist/clients/attach/render/glyph-codepoints.js

@@ -0,0 +1,42 @@
+// glyph-codepoints.ts — render `U+XXXX` as the glyph it names, for the private-
+// use areas only.
+//
+// Nerd Font icons live in the Unicode private-use areas, and PUA codepoints are
+// effectively absent from model tokenizer vocabularies: an agent cannot type one
+// into its reply (the character never becomes tokens, so it is simply missing
+// from the message) and cannot even perceive one in a prompt. Agents CAN name a
+// codepoint accurately, so the viewer closes the gap at the other end — an agent
+// writes `U+F188` and the reader sees the bug glyph.
+//
+// Scoped to the private-use areas on purpose. Those are exactly the codepoints
+// an agent cannot write literally, so expanding them adds an ability rather than
+// taking one away; every other codepoint reference (`U+0041`, `U+241C`) is left
+// as text, because a message discussing Unicode wants the hex on screen and
+// could have contained the character itself if it meant the character.
+/** `U+` followed by 4-6 hex digits, not glued to a surrounding word. Case
+ *  insensitive on both the prefix and the digits. */
+const CODEPOINT = /\bU\+([0-9A-Fa-f]{4,6})\b/g;
+/** Private-use areas: the BMP block plus planes 15 and 16. Nerd Fonts use the
+ *  BMP block and, since v3, the supplementary block above U+F0000. */
+function isPrivateUse(cp) {
+    return ((cp >= 0xe000 && cp <= 0xf8ff) ||
+        (cp >= 0xf0000 && cp <= 0xffffd) ||
+        (cp >= 0x100000 && cp <= 0x10fffd));
+}
+/** Replace every private-use `U+XXXX` reference in `text` with the character it
+ *  names. Non-PUA references and malformed digits pass through untouched. */
+export function expandGlyphCodepoints(text) {
+    if (!text.includes('U+') && !text.includes('u+'))
+        return text;
+    return text.replace(CODEPOINT, (match, hex) => {
+        const cp = Number.parseInt(hex, 16);
+        if (!isPrivateUse(cp))
+            return match;
+        try {
+            return String.fromCodePoint(cp);
+        }
+        catch {
+            return match;
+        }
+    });
+}

package/dist/clients/attach/render/markdown-headings.js

@@ -7,6 +7,12 @@
 // owns parsing, wrapping, inline formatting, and H1/H2's established styling.
 // This stays attach-local — persisted messages and copied text remain ordinary
 // Markdown without terminal escape sequences.
+//
+// The same per-block copy carries the viewer's other source-text transform:
+// private-use `U+XXXX` references become their glyphs (see glyph-codepoints.ts),
+// so an agent that cannot type a Nerd Font character can still put one on
+// screen.
+import { expandGlyphCodepoints } from './glyph-codepoints.js';
 const ATX_HEADING = /^(\s{0,3})(#{3,6})(?:[ \t]+|$)(.*?)([ \t]+#+[ \t]*)?$/;
 const FENCE_OPEN = /^\s{0,3}(`{3,}|~{3,})/;
 // A constant-lightness ramp from warm yellow to cool blue, with saturation
@@ -49,6 +55,11 @@ export function styleAttachMarkdownHeadings(markdown) {
         return `${indent}${headingColor(hashes.length)(body)}`;
     }).join('\n');
 }
+/** Every source-text transform the viewer applies to a Markdown-bearing block,
+ *  in one place: heading hierarchy, then glyph expansion. */
+function renderableText(markdown) {
+    return expandGlyphCodepoints(styleAttachMarkdownHeadings(markdown));
+}
 /** Copy a pi message for terminal rendering and decorate only Markdown-bearing
  * text/thinking blocks. The broker's source event is never mutated. */
 export function styleAttachMessageMarkdown(message) {
@@ -56,7 +67,7 @@ export function styleAttachMessageMarkdown(message) {
         return message;
     const candidate = message;
     if (typeof candidate.content === 'string') {
-        return { ...candidate, content: styleAttachMarkdownHeadings(candidate.content) };
+        return { ...candidate, content: renderableText(candidate.content) };
     }
     if (!Array.isArray(candidate.content))
         return message;
@@ -67,10 +78,10 @@ export function styleAttachMessageMarkdown(message) {
                 return part;
             const block = part;
             if (block.type === 'text' && typeof block.text === 'string') {
-                return { ...block, text: styleAttachMarkdownHeadings(block.text) };
+                return { ...block, text: renderableText(block.text) };
             }
             if (block.type === 'thinking' && typeof block.thinking === 'string') {
-                return { ...block, thinking: styleAttachMarkdownHeadings(block.thinking) };
+                return { ...block, thinking: renderableText(block.thinking) };
             }
             return part;
         }),
@@ -78,5 +89,5 @@ export function styleAttachMessageMarkdown(message) {
 }
 /** Copy an expanded pi summary without changing its persisted source. */
 export function styleAttachSummaryMarkdown(message) {
-    return { ...message, summary: styleAttachMarkdownHeadings(message.summary) };
+    return { ...message, summary: renderableText(message.summary) };
 }