@beehexa/hexasync-template-model 2608.21.4 → 2610.3.1

package/dist/stepGlyph.js

@@ -1,108 +1,155 @@
 /**
- * A node's label: name, then key, then the step type — with a glyph standing in for an icon.
- *
- * ### What was wrong, and it was one line in each renderer
- *
- * Both `render.ts` files built a label as `node.label ?? node.name ?? node.stepKey ?? node.address` — a
- * FALLBACK chain, so a step with a name showed its name and nothing else. The key and the type were computed,
- * carried on every node, and then dropped at the last step before drawing. A reader looking at a diagram
- * beside the YAML could not tell which `key:` a box was, which is the one thing they need in order to jump to
- * it, and `next:`/`outputs:` reference steps BY KEY.
- *
- * The brainstorm that started this feature asked for exactly this: *"each node is missing its `key` and
- * `type/displayType` … The key must be after the node's `name`, and the `type/displayType` must be shown as an
- * icon in the node"*.
- *
- * ### Why a glyph and not the SVG set
- *
- * ⚠️ Stated rather than quietly downgraded. `ux/step-icons/` holds 12 authored SVGs, and they cannot go inside
- * a mermaid node here: the webview renders with `securityLevel: 'strict'`, which sanitises label HTML through
- * DOMPurify (`renderHtml.ts:493` records the same constraint for the report), and an inline `<svg>` does not
- * survive that. Raising it to `'loose'` to admit one would also admit mermaid's `click … call fn()` — which is
- * precisely why `flowDiagram.ts` chose strict.
- *
- * So the icon slot is filled by a per-FAMILY unicode glyph, which survives sanitising, needs no asset
- * pipeline, and renders identically in the editor, the report and the browser host. The type name is drawn
- * beside it, so the glyph is a hint and never the only signal — that is the "fallback to text", present
- * always rather than only when something fails.
- *
- * Wiring the real SVG set belongs with the shared step-icon package the toolchain PRD lists under
- * *"Unblocks"*, where a `<span class="step-icon step-icon--api">` and CSS can do it without loosening mermaid.
+ * Every glyph must come from Arrows (U+2190–U+21FF), Geometric Shapes (U+25A0–U+25FF), or Mathematical
+ * Operators (U+2200–U+22FF). Those blocks have reliable coverage in the fonts a webview receives.
  */
-/**
- * Families, taken from the authored icon set (`ux/step-icons/_family-*.svg`) so the two cannot diverge.
- *
- * ⚠️ EVERY glyph must come from Arrows (U+2190–U+21FF), Geometric Shapes (U+25A0–U+25FF) or Mathematical
- * Operators (U+2200–U+22FF), and `stepGlyph.spec.ts` enforces it. Those three blocks have near-universal
- * coverage in the fonts a webview actually gets; anything outside them draws as a tofu box on some machine,
- * and a box is indistinguishable from "this node has no icon".
- *
- * Two of the first ten broke that rule and a reader saw both: *"why are some nodes have icons, but some are
- * not?"*
- *
- *  * `query` was `?` — a plain ASCII question mark. It has perfect coverage and reads as a MISSING
- *    CHARACTER, which is worse: the glyph rendered exactly as intended and still looked like a failure.
- *  * `control` was `⑂` (U+2442), in the Optical Character Recognition block. Rare enough that common fonts
- *    omit it, so it drew as a box.
- *
- * The lesson is that "does this codepoint exist" is the wrong question. The right one is "does it read as an
- * icon on a machine I have never seen", and the answer is only reliable inside those three blocks.
- */
-const GLYPHS = {
-    /** An outbound request. */
+const PARENT_GLYPHS = {
     call: '↗',
-    /** A branch. The diamond shape the flow already draws for a decision, in the label. */
     control: '◆',
-    /** Fan-out — dispatch, loop, batch. */
     orchestrate: '↻',
-    /** Rows read back. Was `?`, which read as a missing character. */
     query: '≡',
-    /** Something remembered for the rest of the run. */
     state: '▣',
-    /** A start or an end. */
     terminal: '◉',
-    /** Shape in, different shape out. */
     transform: '⇄',
-    /** A screen the operator sees. */
     ui: '▤',
-    /** Time passing. */
     wait: '◔',
-    /** Data pushed somewhere. */
     write: '⇩',
 };
 /**
- * Which family a step type belongs to.
+ * Keep authored punctuation literal inside Mermaid 12 Markdown labels.
  *
- * Matched on the type name because that is what both runtimes carry — a worker step's `displayType` and a
- * frontend step's `type` are the same idea spelled twice (AD-21 keeps the vocabularies apart, not the
- * concept). Unknown types get the neutral glyph rather than no glyph, so a box never loses its icon slot and
- * start shifting the text alignment of its neighbours.
+ * Mermaid's SVG-label path drops Markdown `escape` tokens and does not decode numeric entities. U+FEFF is zero-width
+ * whitespace: bracketing authored Markdown punctuation with it makes the lexer keep the punctuation in ordinary text
+ * tokens while leaving the visible text unchanged. The renderer-owned bold delimiters are added afterwards.
+ *
+ * It lives HERE, beside the composer, rather than in `flowRender.ts` where it started: the composer and the renderer
+ * must escape one heading identically or the same node gets two different labels depending on which surface built it,
+ * and the only way to guarantee that is one function. `flowRender.ts` imports it — never the other way round, because
+ * that is the dependency direction this package already has.
  */
+export function escapeMarkdownText(value) {
+    const htmlSafe = value
+        .replace(/[\r\n]+/g, ' ')
+        .replace(/&/g, '&amp;')
+        .replace(/"/g, '&quot;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/`/g, '&amp;#96;');
+    return htmlSafe.replace(/[\\*_[\]{}()#+\-.!|~]/g, (character) => `\uFEFF${character}\uFEFF`);
+}
+/** The sole result for absent or unknown worker vocabulary. */
+export const UNMAPPED_STEP_ICON = {
+    family: 'unmapped',
+    glyph: '□',
+};
+/** The approved 32 drawing families, rolled up to the strict-host glyph vocabulary. */
+export const STEP_FAMILY_PARENTS = {
+    'call.dialect': 'call',
+    'call.event': 'call',
+    'call.http': 'call',
+    'call.webhook': 'call',
+    'control.if': 'control',
+    'control.switch': 'control',
+    'orchestrate.composite': 'orchestrate',
+    'orchestrate.enqueue': 'orchestrate',
+    'orchestrate.pull': 'orchestrate',
+    'query.dsl': 'query',
+    'query.file': 'query',
+    'query.history': 'query',
+    'query.kv': 'query',
+    'query.metrics': 'query',
+    'query.record': 'query',
+    'query.sql': 'query',
+    'state.cache': 'state',
+    'state.item': 'state',
+    'state.kv': 'state',
+    'state.removal': 'state',
+    'state.task-data': 'state',
+    'terminal.begin': 'terminal',
+    'terminal.end': 'terminal',
+    'terminal.error': 'terminal',
+    'transform.decode': 'transform',
+    'transform.filter': 'transform',
+    'transform.template': 'transform',
+    'wait.sleep': 'wait',
+    'write.delete': 'write',
+    'write.index': 'write',
+    'write.push': 'write',
+    'write.seed': 'write',
+};
+/** Every id in Epic 7's authoritative 51/51 runtime roster, in manifest order. */
+export const WORKER_STEP_FAMILIES = {
+    API: 'call.http',
+    BASE64_TO_MIME_TYPE: 'transform.decode',
+    Begin: 'terminal.begin',
+    CACHE: 'state.cache',
+    CHECK_FORMAT: 'transform.filter',
+    Composite: 'orchestrate.composite',
+    DIRECT_INDEX: 'write.index',
+    DOWNLOAD_CSV: 'query.file',
+    ENQUEUER: 'orchestrate.enqueue',
+    EXCEL_READER: 'query.file',
+    EXCEPTION: 'terminal.error',
+    End: 'terminal.end',
+    Error: 'terminal.error',
+    FORWARD: 'transform.filter',
+    GET_KEY_VALUE: 'query.kv',
+    GraphQL: 'call.dialect',
+    IF: 'control.if',
+    IGNORE_ITEM: 'state.item',
+    INVALIDATE_CACHE: 'state.cache',
+    JSONata: 'transform.template',
+    LOOKUP_STEP: 'query.history',
+    Liquid: 'transform.template',
+    METRIC_QUERY: 'query.metrics',
+    OData: 'call.dialect',
+    PUBLISH_EVENT: 'call.event',
+    PULLER: 'orchestrate.pull',
+    PUSHER: 'write.push',
+    QUERY_MANY: 'query.record',
+    QUERY_METRICS: 'query.metrics',
+    QUERY_SINGLE: 'query.record',
+    QueryDSL: 'query.dsl',
+    REMOVE_DATA: 'write.delete',
+    RESET_ITEM: 'state.item',
+    RESOLVE_RAW_DATA: 'transform.decode',
+    Restful: 'call.dialect',
+    SAVE_TASK_DATA: 'state.task-data',
+    SEED_DATA: 'write.seed',
+    SET_KEY_VALUE: 'state.kv',
+    SLEEP: 'wait.sleep',
+    SQL: 'query.sql',
+    SQL_PROXY: 'query.sql',
+    SWITCH: 'control.switch',
+    Scriban: 'transform.template',
+    TRACK_FOR_REMOVAL: 'state.removal',
+    UPDATE_ITEM_STATUS: 'state.item',
+    UPDATE_ITEM_SYNC_PROCESS: 'state.item',
+    UPDATE_TASK_DATA_STATUS: 'state.task-data',
+    VALUES: 'transform.template',
+    VERIFY_CACHED: 'state.cache',
+    WEBHOOK_FORWARD: 'call.webhook',
+    cURL: 'call.dialect',
+};
+/** Resolve only the worker runtime domain. Unknown and absent values are deliberately neutral. */
 export function familyOfStepType(type) {
+    if (!type || !Object.hasOwn(WORKER_STEP_FAMILIES, type))
+        return UNMAPPED_STEP_ICON.family;
+    return WORKER_STEP_FAMILIES[type];
+}
+/**
+ * Retained frontend-domain chain. Its meaningful fallback is existing frontend behavior and must not be used
+ * for worker ids.
+ */
+export function familyOfFrontendStepType(type) {
     const t = type.toUpperCase();
     if (/FORM|SHOW|SELECT|REDIRECT|BROWSER|MESSAGE|INFO/.test(t))
         return 'ui';
     if (/^API$|HTTP|REQUEST|WEBHOOK|CALL/.test(t))
         return 'call';
-    /**
-     * WAIT before everything else that could claim it.
-     *
-     * `SLEEP` is a real corpus type (`MisaAmisCustomerCallbackMessagePusher.yaml` carries one) and the authored
-     * set drew it its own clock. Ahead of `query` because `POLL` contains no query word but reads as one, and
-     * ahead of `state` because `WAIT_FOR_RECENT_USER_CREATED` — an authored KEY, not a type — must not be
-     * classified by a substring of its name if it ever reaches here as one.
-     */
     if (/SLEEP|WAIT|DELAY|POLL|RETRY|SCHEDULE/.test(t))
         return 'wait';
     if (/SQL|QUERY|FIND|GET|READ|FETCH/.test(t))
         return 'query';
-    /**
-     * WRITE before STATE, because the authored set separates them and the words overlap.
-     *
-     * `write` is a step that PUSHES data somewhere — insert, upsert, seed, push. `state` is a step that
-     * remembers something for the rest of the run — `SET_STORAGE`, `REGISTER_*`. `SAVE` and `WRITE` were in
-     * the state bucket and belong here; `SET_` and `STORAGE` stay there.
-     */
     if (/WRITE|INSERT|UPSERT|SEED|PUSH|CREATE|DELETE/.test(t))
         return 'write';
     if (/SET_|STORAGE|SAVE|UPDATE|REGISTER/.test(t))
@@ -117,39 +164,291 @@ export function familyOfStepType(type) {
         return 'terminal';
     return 'orchestrate';
 }
+/** Resolve a child or parent family to a strict-host glyph. */
+export function glyphOfStepFamily(family) {
+    if (!family)
+        return UNMAPPED_STEP_ICON.glyph;
+    const parent = Object.hasOwn(STEP_FAMILY_PARENTS, family)
+        ? STEP_FAMILY_PARENTS[family]
+        : family;
+    return Object.hasOwn(PARENT_GLYPHS, parent)
+        ? PARENT_GLYPHS[parent]
+        : UNMAPPED_STEP_ICON.glyph;
+}
+/** Resolve a worker id through the explicit child-family map and parent rollup. */
+export function glyphOfStepType(type) {
+    return glyphOfStepFamily(familyOfStepType(type));
+}
+/** Resolve a frontend id through the retained regex chain. */
+export function glyphOfFrontendStepType(type) {
+    return type
+        ? glyphOfStepFamily(familyOfFrontendStepType(type))
+        : UNMAPPED_STEP_ICON.glyph;
+}
+/** The dashboard tile anatomy. Hosts resolve these token names; the vocabulary never bakes in theme colours. */
+export const STEP_ICON_TILE = {
+    alignment: 'left',
+    shape: 'square',
+    radiusToken: 'rounded.xl',
+    backgroundToken: 'tile-bg',
+    glyphToken: 'tile-glyph',
+};
 /**
- * The glyph for a step type.
+ * The approved single-colour family drawings. These are path fragments rather than files so browser consumers can
+ * use the package without a filesystem or a remote asset origin.
+ */
+const STEP_ICON_SVG = {
+    'call.http': '<path d="M14 3h7v7"/><path d="M21 3l-9 9"/><path d="M19 14v5a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2h5"/>',
+    'call.webhook': '<path d="M13 2 3 14h9l-1 8 10-12h-9l1-8z"/>',
+    'call.event': '<path d="M12 11.5v.01"/><path d="M8.6 8.6a5 5 0 0 0 0 6.8"/><path d="M15.4 15.4a5 5 0 0 0 0-6.8"/><path d="M5.6 5.6a9 9 0 0 0 0 12.8"/><path d="M18.4 18.4a9 9 0 0 0 0-12.8"/>',
+    'call.dialect': '<path d="M4 17l6-6-6-6"/><path d="M12 19h8"/>',
+    'query.dsl': '<path d="M8 3H7a2 2 0 0 0-2 2v4a2 2 0 0 1-2 2 2 2 0 0 1 2 2v4a2 2 0 0 0 2 2h1"/><path d="M16 21h1a2 2 0 0 0 2-2v-4a2 2 0 0 1 2-2 2 2 0 0 1-2-2V5a2 2 0 0 0-2-2h-1"/><path d="M9 12h6"/>',
+    'query.sql': '<ellipse cx="12" cy="5" rx="8" ry="3"/><path d="M4 5v14c0 1.66 3.58 3 8 3s8-1.34 8-3V5"/><path d="M4 12c0 1.66 3.58 3 8 3s8-1.34 8-3"/>',
+    'query.record': '<path d="M8 6h13"/><path d="M8 12h13"/><path d="M8 18h13"/><path d="M3.5 6h.01"/><path d="M3.5 12h.01"/><path d="M3.5 18h.01"/>',
+    'query.metrics': '<path d="M3 3v16a2 2 0 0 0 2 2h16"/><path d="M7 16v-4"/><path d="M12 16V8"/><path d="M17 16v-6"/>',
+    'query.history': '<path d="M3 12a9 9 0 1 0 2.6-6.4L3 8"/><path d="M3 3v5h5"/><path d="M12 7.5V12l3 2"/>',
+    'query.kv': '<circle cx="8" cy="15" r="4"/><path d="M10.85 12.15 19 4"/><path d="M18 5l2 2"/><path d="M15 8l2 2"/>',
+    'query.file': '<path d="M15 2H7a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V6z"/><path d="M14 2v4a2 2 0 0 0 2 2h3"/><path d="M8.5 13h7"/><path d="M8.5 17h7"/>',
+    'state.kv': '<path d="M12.6 2.6A2 2 0 0 0 11.2 2H4a2 2 0 0 0-2 2v7.2a2 2 0 0 0 .6 1.4l8.7 8.7a2.4 2.4 0 0 0 3.4 0l6.6-6.6a2.4 2.4 0 0 0 0-3.4z"/><path d="M7.5 7.5h.01"/>',
+    'state.cache': '<path d="M4 8.5h16V19a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2z"/><rect x="2" y="3.5" width="20" height="5" rx="1"/><path d="M10 12.5h4"/>',
+    'state.task-data': '<path d="M15.2 3a2 2 0 0 1 1.4.6l3.8 3.8a2 2 0 0 1 .6 1.4V19a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z"/><path d="M17 21v-7a1 1 0 0 0-1-1H8a1 1 0 0 0-1 1v7"/><path d="M7 3v4a1 1 0 0 0 1 1h6"/>',
+    'state.item': '<path d="M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2"/><rect x="8" y="2" width="8" height="4" rx="1"/><path d="M9 13.5l2 2 4-4"/>',
+    'state.removal': '<path d="M4 15s1-1 4-1 5 2 8 2 4-1 4-1V3s-1 1-4 1-5-2-8-2-4 1-4 1z"/><path d="M4 22v-7"/>',
+    'write.push': '<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="M17 8l-5-5-5 5"/><path d="M12 3v12"/>',
+    'write.index': '<path d="M12 2v8"/><path d="M16 6l-4 4-4-4"/><path d="M3 14h18"/><path d="M22 14v5a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2v-5l3.4-6.8A2 2 0 0 1 7.2 6H8"/><path d="M6.5 17.5h.01"/>',
+    'write.seed': '<path d="M7 21h10"/><path d="M12 21v-8"/><path d="M12 13C12 9 9 6 5 6c0 4 3 7 7 7z"/><path d="M12 13c0-3.5 2.5-6.5 6.5-6.5 0 3.5-2.5 6.5-6.5 6.5z"/>',
+    'write.delete': '<path d="M3 6h18"/><path d="M8 6V4.5A1.5 1.5 0 0 1 9.5 3h5A1.5 1.5 0 0 1 16 4.5V6"/><path d="M18.5 6l-.9 13.1A2 2 0 0 1 15.6 21H8.4a2 2 0 0 1-2-1.9L5.5 6"/><path d="M10 11v6"/><path d="M14 11v6"/>',
+    'orchestrate.enqueue': '<path d="M2 12h8"/><path d="M7 9l3 3-3 3"/><path d="M14 4h6a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2h-6"/><path d="M14 8v8"/>',
+    'orchestrate.pull': '<path d="M4.4 14.9A7 7 0 1 1 15.7 7h1.8a4.5 4.5 0 0 1 2.4 8.3"/><path d="M12 12v9"/><path d="M8.5 17.5 12 21l3.5-3.5"/>',
+    'orchestrate.composite': '<path d="M12 2.5 3.5 7v10l8.5 4.5 8.5-4.5V7z"/><path d="M3.5 7 12 11.5 20.5 7"/><path d="M12 11.5v10"/>',
+    'transform.template': '<path d="M8 3H7a2 2 0 0 0-2 2v4a2 2 0 0 1-2 2 2 2 0 0 1 2 2v4a2 2 0 0 0 2 2h1"/><path d="M16 21h1a2 2 0 0 0 2-2v-4a2 2 0 0 1 2-2 2 2 0 0 1-2-2V5a2 2 0 0 0-2-2h-1"/>',
+    'transform.filter': '<path d="M21.5 3.5H2.5l7.6 9v7.2l3.8 1.8v-9z"/>',
+    'transform.decode': '<path d="M8 3 4 7l4 4"/><path d="M4 7h16"/><path d="M16 21l4-4-4-4"/><path d="M20 17H4"/>',
+    'control.if': '<path d="M16 3h5v5"/><path d="M8 3H3v5"/><path d="M12 22v-8.3a4 4 0 0 0-1.2-2.8L3 3"/><path d="M15 9l6-6"/>',
+    'control.switch': '<path d="M4 4v14a2 2 0 0 0 2 2h2"/><path d="M4 7h10"/><path d="M4 13h10"/><path d="M8 20h6"/><path d="M17 4h3"/><path d="M17 10h3"/><path d="M17 17h3"/>',
+    'terminal.begin': '<circle cx="12" cy="12" r="9"/><path d="M10 8.5 16 12l-6 3.5z"/>',
+    'terminal.end': '<circle cx="12" cy="12" r="9"/><rect x="9" y="9" width="6" height="6" rx="1"/>',
+    'terminal.error': '<path d="M10.3 4 2.6 17.5A2 2 0 0 0 4.3 20.5h15.4a2 2 0 0 0 1.7-3L13.7 4a2 2 0 0 0-3.4 0z"/><path d="M12 9.5v4"/><path d="M12 17h.01"/>',
+    'wait.sleep': '<circle cx="12" cy="12" r="9"/><path d="M12 7v5l3.5 2"/>',
+};
+const maskImage = (body) => {
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="black" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">${body}</svg>`;
+    return `url("data:image/svg+xml,${encodeURIComponent(svg)}")`;
+};
+/** Normalize a family into the asset-backed class Mermaid copies to the rendered node group. */
+export function stepIconClassName(family) {
+    const resolved = family !== undefined &&
+        Object.hasOwn(STEP_FAMILY_PARENTS, family)
+        ? family
+        : UNMAPPED_STEP_ICON.family;
+    return `ic-${resolved.replaceAll('.', '-')}`;
+}
+const iconAssets = {};
+const defineLazyAsset = (family, parent, strictGlyph, svgBody) => {
+    let value;
+    Object.defineProperty(iconAssets, family, {
+        enumerable: true,
+        get: () => {
+            value ??= {
+                family,
+                parent,
+                className: stepIconClassName(family),
+                strictGlyph,
+                looseMaskImage: maskImage(svgBody),
+                tint: 'currentColor',
+            };
+            return value;
+        },
+    });
+};
+for (const family of Object.keys(STEP_FAMILY_PARENTS)) {
+    const parent = STEP_FAMILY_PARENTS[family];
+    defineLazyAsset(family, parent, glyphOfStepFamily(parent), STEP_ICON_SVG[family]);
+}
+defineLazyAsset(UNMAPPED_STEP_ICON.family, UNMAPPED_STEP_ICON.family, UNMAPPED_STEP_ICON.glyph, '<rect x="4" y="4" width="16" height="16" rx="2"/><path d="M8 8l8 8M16 8l-8 8"/>');
+/**
+ * Complete local loose-host assets. Each mask is percent-encoded on first property access, so strict-only rendering
+ * pays only for class and glyph lookup.
+ */
+export const STEP_ICON_ASSETS = iconAssets;
+/**
+ * The in-node error marker: one glyph for a strict host, the approved drawing for a loose one.
  *
- * Empty for a step with NO type — there is no icon to stand in for, and a placeholder would render as a
- * second separator (`name · · KEY`), which is how this was caught.
+ * **Why `⚠` (U+26A0, Miscellaneous Symbols) and not a glyph from the three approved blocks.** `PARENT_GLYPHS`'
+ * Arrows / Geometric Shapes / Mathematical Operators rule exists so 32 FAMILY glyphs render in the fonts a webview
+ * receives; it does not cover a marker, and none of the three blocks contains an exclamation-in-triangle — the shape
+ * DESIGN.md names. U+26A0 was MEASURED surviving a Mermaid 12.0.0 strict-mode render inside a backtick-quoted
+ * markdown label on 2026-09-28, alongside `×` and `◆`, and it is the one glyph in the canvas's whole vocabulary whose
+ * absence would be obvious rather than silent (a failed node also carries `emphasis` width, a red stroke and a tinted
+ * fill, so the marker is never the only signal — `node-failed`'s three channels are independent by design).
+ *
+ * **The same glyph is used at BOTH fidelities.** Story 8.3 could split strict glyph from loose mask because the mask
+ * arrives through a class the host's own stylesheet paints; a run-state mark cannot, because AD-23 forbids any host
+ * CSS rule that carries run state onto a node. `looseMaskImage` is therefore exported for a loose host's LEGEND or
+ * inspector chrome — not for the node — and it reuses `terminal.error`'s approved path fragment rather than authoring
+ * a second exclamation-in-triangle.
  */
-export function glyphOfStepType(type) {
-    if (!type)
+export const RUN_STATE_ERROR_MARKER = {
+    glyph: '\u26a0',
+    className: stepIconClassName('terminal.error'),
+    get looseMaskImage() {
+        return STEP_ICON_ASSETS['terminal.error'].looseMaskImage;
+    },
+    tint: 'currentColor',
+};
+/** The multiplication sign the count badge reads with (`×997`). MEASURED surviving a strict-mode render. */
+export const REPEAT_BADGE_GLYPH = '\u00d7';
+/**
+ * The largest count the badge will draw.
+ *
+ * A bound, not a formatting choice: `Number.isInteger(1e21)` is TRUE, so an unbounded check drew `×1e+21` — the
+ * exponent notation JavaScript switches to above 1e20, which is not a count any reader can act on and not a claim
+ * about a run that the generator can stand behind. A billion occurrences is already far outside anything the
+ * accumulator can produce, so beyond it the honest answer is no badge.
+ */
+export const REPEAT_BADGE_MAX = 1_000_000_000;
+/** Is this a count worth drawing? One predicate, so the label and the style pass can never disagree. */
+export function isCountableRepeat(repeat) {
+    return repeat !== undefined &&
+        Number.isSafeInteger(repeat) &&
+        repeat > 1 &&
+        repeat <= REPEAT_BADGE_MAX;
+}
+/** `×N` for a count worth stating, and nothing at all otherwise. */
+export function repeatBadgeText(repeat) {
+    return isCountableRepeat(repeat) ? `${REPEAT_BADGE_GLYPH}${repeat}` : undefined;
+}
+/**
+ * What a screen reader is told about the run, in words.
+ *
+ * NFR13 forbids carrying state in colour alone, and a screen-reader user is the one reader who sees no line-work at
+ * all: no stroke, no dash, no opacity, no marker. So the state and the repeat count have to reach `accDescr` as text
+ * or they do not reach that reader at all.
+ *
+ * **`indeterminate` IS stated**, in words, even though it is the plainest thing on the canvas. The drawing gives every
+ * node a reading the moment a typed overlay is in use, precisely so a reader cannot confuse "the run never reached
+ * this" with "nobody told us about this"; a text channel that stayed silent for the indeterminate ones would hand a
+ * screen-reader user back exactly the ambiguity the visual rule removes. The two channels agree or one of them lies.
+ */
+const RUN_STATE_TEXT = {
+    ranOk: 'ran OK',
+    ranFailed: 'failed',
+    neverReached: 'never ran',
+    branchNotTaken: 'branch not taken',
+    indeterminate: 'run state unknown',
+};
+export function runStateAlternativeText(runState) {
+    if (runState === undefined)
         return '';
-    return GLYPHS[familyOfStepType(type)] ?? '·';
+    /**
+     * The lookup is GUARDED, not indexed.
+     *
+     * An overlay can arrive as parsed JSON or a `postMessage` payload, where `state: 'running'` is one keystroke away
+     * and types prove nothing. Indexed blind it would put the literal word `undefined` into `accDescr` — a sentence
+     * read aloud to the one reader who has no other channel.
+     */
+    const state = runState.state !== undefined && Object.hasOwn(RUN_STATE_TEXT, runState.state)
+        ? RUN_STATE_TEXT[runState.state]
+        : '';
+    const ran = isCountableRepeat(runState.repeat) ? `ran ${runState.repeat} times` : '';
+    return [state, ran].filter((part) => part !== '').join(', ');
 }
+const visibleText = (value) => {
+    const normalized = value?.trim();
+    return normalized ? normalized : undefined;
+};
 /**
- * The three lines a reader needs, in the order the brainstorm asked for: name, then key, then type.
+ * Compose the shared node-card anatomy and its structural renderer provenance.
  *
- * ⚠️ ONE LINE, not `<br/>`, and that was measured rather than assumed. The first version used `<br/>`; the
- * shared renderer's `escapeLabel` turns `<` into `&lt;` — correctly, it is what stops an authored step name
- * injecting markup — so mermaid received `&lt;br/&gt;` and would have drawn it as visible text in every box.
- * Weakening `escapeLabel` to admit one tag would trade a real safety property for a cosmetic one.
+ * The label has two semantic text roles rather than a two-physical-line limit: the bold heading may wrap, and the
+ * upright key/type description follows it. Strict hosts keep a Unicode glyph and explicit type text; loose hosts
+ * reserve the icon through the node's family class and keep the key as their description.
  *
- * A junction (START/END) has its own label and no key or type — it returns unchanged, because decorating a
- * terminal with an empty key line would put a blank row in every diagram.
+ * Boundary whitespace is not visible content. Normalizing it here keeps a blank explicit label from defeating the
+ * name/key/address fallback or moving Mermaid's bold delimiters away from the heading.
+ */
+export function composeNodeLabelModel(node, fidelity, domain, iconFamily, runState) {
+    const stepKey = visibleText(node.stepKey);
+    const type = visibleText(node.type) ?? visibleText(node.displayType);
+    const heading = visibleText(node.label) ??
+        visibleText(node.name) ??
+        stepKey ??
+        visibleText(node.address) ??
+        '?';
+    const marker = runState?.marker === true ? RUN_STATE_ERROR_MARKER.glyph : undefined;
+    const badge = repeatBadgeText(runState?.repeat);
+    /**
+     * The no-anatomy early return, and why run-state content overrides it.
+     *
+     * A node with neither `stepKey` nor `type` has no card to lay out, so it returns a bare string and the renderer
+     * emits a plain quoted label. But a marker or a badge is a fact about the RUN, not about the card: dropping it
+     * here would make a failed node with no key silently indistinguishable from a healthy one. So the moment either is
+     * present, anatomy is composed anyway — with the heading as its only text role.
+     */
+    if (!stepKey && !type) {
+        if (marker === undefined && badge === undefined)
+            return { text: heading };
+        const bare = {
+            ...(marker ? { marker } : {}),
+            heading,
+            ...(badge ? { badge } : {}),
+        };
+        // Escaped here exactly as `renderLabelAnatomy` escapes it, through the same function: two spellings of one
+        // heading is two different labels for one node depending on which surface composed it.
+        return {
+            text: `\`${marker ? `${marker} ` : ''}**${escapeMarkdownText(heading)}**${badge ? ` ${badge}` : ''}\``,
+            anatomy: bare,
+        };
+    }
+    const glyph = iconFamily !== undefined
+        ? glyphOfStepFamily(iconFamily)
+        : domain === 'worker'
+            ? glyphOfStepType(type)
+            : type
+                ? glyphOfFrontendStepType(type)
+                : '';
+    const description = fidelity === 'loose'
+        ? stepKey
+        : [stepKey, type].filter(Boolean).join(' · ') || undefined;
+    const anatomy = {
+        ...(fidelity === 'strict' && glyph ? { icon: glyph } : {}),
+        // Right of the icon tile, per DESIGN.md's card order: icon tile, marker, heading, description, badge.
+        ...(marker ? { marker } : {}),
+        heading,
+        ...(description ? { description } : {}),
+        ...(badge ? { badge } : {}),
+    };
+    const composedHeading = `${anatomy.icon ? `${anatomy.icon} ` : ''}${anatomy.marker ? `${anatomy.marker} ` : ''}**${anatomy.heading}**`;
+    const tail = anatomy.badge ? ` ${anatomy.badge}` : '';
+    return {
+        text: anatomy.description
+            ? `\`${composedHeading}\n${anatomy.description}${tail}\``
+            : `\`${composedHeading}${tail}\``,
+        anatomy,
+    };
+}
+/** String-only compatibility surface; renderers use `composeNodeLabelModel` so provenance stays structural. */
+export function composeNodeLabel(node, fidelity, domain, iconFamily) {
+    return composeNodeLabelModel(node, fidelity, domain, iconFamily).text;
+}
+/**
+ * Screen-reader text for a node. The icon is deliberately absent: strict Unicode names are noisy, while loose masks
+ * are decorative. Fidelity and domain stay in the signature so callers can compose visual and accessible labels from
+ * the same inputs without branching.
  */
-export function composeNodeLabel(node) {
-    const type = node.type ?? node.displayType;
-    const heading = node.label ?? node.name ?? node.stepKey ?? node.address;
-    // A junction, or a node carrying neither of the two facts this function exists to add.
-    if (!node.stepKey && !type)
-        return heading;
-    // The glyph leads the added half rather than the whole label, so the NAME stays what the eye lands on.
-    // Every part is filtered, so a key with no type (or the reverse) yields ONE separator, not an empty slot.
-    const second = [glyphOfStepType(type), [node.stepKey, type].filter(Boolean).join(' · ')]
-        .filter(Boolean)
-        .join(' ');
-    return second ? `${heading} · ${second}` : heading;
+export function composeAccessibleNodeLabel(node, _fidelity, _domain, runState) {
+    const type = node.type?.trim() || node.displayType?.trim() || undefined;
+    const stepKey = node.stepKey?.trim() || undefined;
+    const heading = [
+        node.name?.trim(),
+        node.label?.trim(),
+        stepKey,
+        node.address.trim() || '?',
+    ].find((value) => Boolean(value));
+    const detail = [stepKey, type].filter(Boolean).join(' · ');
+    const named = detail ? `${heading} · ${detail}` : heading;
+    // Run state is appended, never substituted: the reader still needs to know WHICH step failed.
+    const run = runStateAlternativeText(runState);
+    return run === '' ? named : `${named} · ${run}`;
 }
 //# sourceMappingURL=stepGlyph.js.map

package/dist/stepGlyph.js.map

@@ -1 +1 @@
-{"version":3,"file":"stepGlyph.js","sourceRoot":"","sources":["../src/stepGlyph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,GAAqC;IAC/C,2BAA2B;IAC3B,IAAI,EAAE,GAAG;IACT,uFAAuF;IACvF,OAAO,EAAE,GAAG;IACZ,uCAAuC;IACvC,WAAW,EAAE,GAAG;IAChB,kEAAkE;IAClE,KAAK,EAAE,GAAG;IACV,oDAAoD;IACpD,KAAK,EAAE,GAAG;IACV,yBAAyB;IACzB,QAAQ,EAAE,GAAG;IACb,qCAAqC;IACrC,SAAS,EAAE,GAAG;IACd,kCAAkC;IAClC,EAAE,EAAE,GAAG;IACP,oBAAoB;IACpB,IAAI,EAAE,GAAG;IACT,6BAA6B;IAC7B,KAAK,EAAE,GAAG;CACX,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,IAAI,gDAAgD,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,IAAI,iCAAiC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC7D;;;;;;;OAOG;IACH,IAAI,sCAAsC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAClE,IAAI,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IAC5D;;;;;;OAMG;IACH,IAAI,6CAA6C,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1E,IAAI,mCAAmC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IAChE,IAAI,8BAA8B,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,WAAW,CAAC;IAC/D,IAAI,kCAAkC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,aAAa,CAAC;IACrE,IAAI,4BAA4B,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3D,IAAI,8BAA8B,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC;IAC9D,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAwB;IACtD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAOhC;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;IACxE,uFAAuF;IACvF,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC;IAE3C,uGAAuG;IACvG,0GAA0G;IAC1G,MAAM,MAAM,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACrF,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACrD,CAAC"}
+{"version":3,"file":"stepGlyph.js","sourceRoot":"","sources":["../src/stepGlyph.ts"],"names":[],"mappings":"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"}

package/dist/workerStepVocabularyAudit.d.ts

@@ -0,0 +1,19 @@
+export declare const WORKER_ROSTER_MAX_AGE_MS = 86400000;
+export interface WorkerRosterAuditOptions {
+    readonly now: Date;
+    readonly maxAgeMs: number;
+}
+export interface WorkerRosterAudit {
+    readonly valid: boolean;
+    readonly stale: boolean;
+    readonly unmapped: readonly string[];
+    readonly missingFromRoster: readonly string[];
+    readonly errors: readonly string[];
+    readonly warnings: readonly string[];
+}
+/**
+ * Check provenance, freshness, roster shape, and bidirectional map drift without consulting a sibling
+ * repository or the ambient clock. Staleness is advisory; malformed provenance and roster drift are failures.
+ */
+export declare function auditWorkerRosterManifest(manifest: unknown, options: WorkerRosterAuditOptions): WorkerRosterAudit;
+//# sourceMappingURL=workerStepVocabularyAudit.d.ts.map

package/dist/workerStepVocabularyAudit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerStepVocabularyAudit.d.ts","sourceRoot":"","sources":["../src/workerStepVocabularyAudit.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,WAAa,CAAC;AAEnD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAsDD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CA6FnB"}