@almadar/patterns 2.32.1 → 2.33.0

package/dist/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-05-29T02:49:56.240Z",
+  "exportedAt": "2026-05-29T09:18:13.002Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -18,7 +18,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -242,7 +242,7 @@
           "types": [
             "string"
           ],
-          "description": "Layer 2 visual treatment \u2014 orthogonal to the semantic variant.",
+          "description": "Layer 2 visual treatment — orthogonal to the semantic variant.",
           "enumValues": [
             "dense",
             "spacious",
@@ -269,7 +269,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [
@@ -446,7 +446,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [
@@ -694,7 +694,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [
@@ -1176,7 +1176,7 @@
           "types": [
             "string"
           ],
-          "description": "Form mode \u2014 'create' for new records, 'edit' for updating existing. Accepts `string` so schema-driven callers (whose `config.mode` is typed as `string` per the trait's declared config block) compile cleanly. The runtime treats anything other than 'edit' as 'create'."
+          "description": "Form mode — 'create' for new records, 'edit' for updating existing. Accepts `string` so schema-driven callers (whose `config.mode` is typed as `string` per the trait's declared config block) compile cleanly. The runtime treats anything other than 'edit' as 'create'."
         },
         "fields": {
           "types": [
@@ -1514,7 +1514,7 @@
     "form-section": {
       "type": "form-section",
       "category": "form",
-      "description": "Alias for form \u2014 Complete form with fields and actions",
+      "description": "Alias for form — Complete form with fields and actions",
       "suggestedFor": [
         "create forms",
         "edit forms",
@@ -1582,7 +1582,7 @@
           "types": [
             "string"
           ],
-          "description": "Form mode \u2014 'create' for new records, 'edit' for updating existing. Accepts `string` so schema-driven callers (whose `config.mode` is typed as `string` per the trait's declared config block) compile cleanly. The runtime treats anything other than 'edit' as 'create'."
+          "description": "Form mode — 'create' for new records, 'edit' for updating existing. Accepts `string` so schema-driven callers (whose `config.mode` is typed as `string` per the trait's declared config block) compile cleanly. The runtime treats anything other than 'edit' as 'create'."
         },
         "fields": {
           "types": [
@@ -2130,7 +2130,7 @@
           "types": [
             "string"
           ],
-          "description": "Layer 2 visual treatment \u2014 orthogonal to the semantic variant.",
+          "description": "Layer 2 visual treatment — orthogonal to the semantic variant.",
           "enumValues": [
             "toolbar",
             "chips",
@@ -2307,7 +2307,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative tab change event \u2014 emits UI:{tabChangeEvent} with { tabId }",
+          "description": "Declarative tab change event — emits UI:{tabChangeEvent} with { tabId }",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -2499,7 +2499,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative step click event \u2014 emits UI:{stepClickEvent} with { stepIndex }",
+          "description": "Declarative step click event — emits UI:{stepClickEvent} with { stepIndex }",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -2585,7 +2585,7 @@
           "types": [
             "string"
           ],
-          "description": "Event to emit on Back click \u2014 emits UI:{onBack} with { currentStep, totalSteps }",
+          "description": "Event to emit on Back click — emits UI:{onBack} with { currentStep, totalSteps }",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -2605,7 +2605,7 @@
           "types": [
             "string"
           ],
-          "description": "Event to emit on Next click \u2014 emits UI:{onNext} with { currentStep, totalSteps }",
+          "description": "Event to emit on Next click — emits UI:{onNext} with { currentStep, totalSteps }",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -2625,7 +2625,7 @@
           "types": [
             "string"
           ],
-          "description": "Event to emit on Complete click \u2014 emits UI:{onComplete} with { currentStep, totalSteps }",
+          "description": "Event to emit on Complete click — emits UI:{onComplete} with { currentStep, totalSteps }",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -3337,7 +3337,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative page change event \u2014 emits UI:{pageChangeEvent} with { page }",
+          "description": "Declarative page change event — emits UI:{pageChangeEvent} with { page }",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -3351,7 +3351,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative page size change event \u2014 emits UI:{pageSizeChangeEvent} with { pageSize }",
+          "description": "Declarative page size change event — emits UI:{pageSizeChangeEvent} with { pageSize }",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -3441,7 +3441,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative action event \u2014 emits UI:{actionEvent} via eventBus when action button is clicked",
+          "description": "Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked",
           "kind": "event-ref",
           "emitPayloadSchema": []
         },
@@ -3449,7 +3449,7 @@
           "types": [
             "string"
           ],
-          "description": "Layer 2 visual treatment \u2014 orthogonal to the semantic variant (which carries status color).",
+          "description": "Layer 2 visual treatment — orthogonal to the semantic variant (which carries status color).",
           "enumValues": [
             "illustrated",
             "icon-only",
@@ -3535,7 +3535,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative retry event \u2014 emits UI:{retryEvent} via eventBus when retry button is clicked",
+          "description": "Declarative retry event — emits UI:{retryEvent} via eventBus when retry button is clicked",
           "kind": "event-ref",
           "emitPayloadSchema": []
         }
@@ -3631,7 +3631,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative dismiss event \u2014 emits UI:{dismissEvent} via eventBus when toast is dismissed",
+          "description": "Declarative dismiss event — emits UI:{dismissEvent} via eventBus when toast is dismissed",
           "kind": "event-ref",
           "emitPayloadSchema": []
         },
@@ -3639,7 +3639,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative action event \u2014 emits UI:{actionEvent} via eventBus when action button is clicked",
+          "description": "Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked",
           "kind": "event-ref",
           "emitPayloadSchema": []
         }
@@ -3779,7 +3779,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative close event \u2014 emits UI:{closeEvent} via eventBus when modal should close",
+          "description": "Declarative close event — emits UI:{closeEvent} via eventBus when modal should close",
           "kind": "event-ref",
           "emitPayloadSchema": []
         },
@@ -3794,7 +3794,7 @@
           "types": [
             "string"
           ],
-          "description": "Layer 2 visual treatment \u2014 orthogonal to the semantic variant.",
+          "description": "Layer 2 visual treatment — orthogonal to the semantic variant.",
           "enumValues": [
             "centered-card",
             "top-sheet",
@@ -3899,7 +3899,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative close event \u2014 emits UI:{closeEvent} via eventBus when drawer should close",
+          "description": "Declarative close event — emits UI:{closeEvent} via eventBus when drawer should close",
           "kind": "event"
         }
       }
@@ -4052,7 +4052,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -4382,7 +4382,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          "description": "Declarative event name — emits UI:{action} via eventBus on click",
           "kind": "event"
         },
         "actionPayload": {
@@ -4395,7 +4395,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative hover event \u2014 emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave",
+          "description": "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave",
           "kind": "event"
         },
         "maxWidth": {
@@ -4875,7 +4875,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          "description": "Declarative event name — emits UI:{action} via eventBus on click",
           "kind": "event"
         },
         "actionPayload": {
@@ -4956,7 +4956,7 @@
             "string",
             "number"
           ],
-          "description": "Badge label text (alternative to children for schema-driven rendering). Numeric values are auto-coerced to string for rendering \u2014 common case is unread counts, error counts, status codes, etc."
+          "description": "Badge label text (alternative to children for schema-driven rendering). Numeric values are auto-coerced to string for rendering — common case is unread counts, error counts, status codes, etc."
         },
         "icon": {
           "types": [
@@ -4968,7 +4968,7 @@
           "types": [
             "function"
           ],
-          "description": "When set, renders a small X button on the right of the badge that invokes this handler \u2014 turns the badge into a removable chip. Used by the TagInput molecule and other \"list of removable values\" surfaces.",
+          "description": "When set, renders a small X button on the right of the badge that invokes this handler — turns the badge into a removable chip. Used by the TagInput molecule and other \"list of removable values\" surfaces.",
           "kind": "callback",
           "callbackArgs": []
         },
@@ -5072,7 +5072,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          "description": "Declarative event name — emits UI:{action} via eventBus on click",
           "kind": "event"
         },
         "actionPayload": {
@@ -5229,7 +5229,7 @@
           "types": [
             "string"
           ],
-          "description": "Layer 2 visual treatment \u2014 orthogonal to the semantic variant.",
+          "description": "Layer 2 visual treatment — orthogonal to the semantic variant.",
           "enumValues": [
             "elevated",
             "flat-bordered",
@@ -5948,7 +5948,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative dismiss event \u2014 emits UI:{dismissEvent} via eventBus when alert is dismissed",
+          "description": "Declarative dismiss event — emits UI:{dismissEvent} via eventBus when alert is dismissed",
           "kind": "event"
         }
       }
@@ -6325,7 +6325,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative toggle event \u2014 emits UI:{toggleEvent} with { itemId, isOpen }",
+          "description": "Declarative toggle event — emits UI:{toggleEvent} with { itemId, isOpen }",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -6865,7 +6865,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          "description": "Declarative event name — emits UI:{action} via eventBus on click",
           "kind": "event"
         }
       }
@@ -7022,7 +7022,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          "description": "Declarative event name — emits UI:{action} via eventBus on click",
           "kind": "event"
         },
         "actionPayload": {
@@ -7116,14 +7116,14 @@
           "types": [
             "string"
           ],
-          "description": "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          "description": "Declarative event name — emits UI:{action} via eventBus on click",
           "kind": "event"
         },
         "hoverEvent": {
           "types": [
             "string"
           ],
-          "description": "Declarative hover event \u2014 emits UI:{hoverEvent} with { hovered: true/false }",
+          "description": "Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false }",
           "kind": "event"
         }
       }
@@ -8061,7 +8061,7 @@
           "types": [
             "string"
           ],
-          "description": "Panel width as Tailwind class string. Default fills the viewport on mobile and snaps to `w-96` (384 px) at `sm:` and above so phones don't lose content to a fixed 384 px column. Consumers passing a custom value should include a `w-full` mobile fallback in the same string (e.g. `\"w-full sm:w-[480px]\"`) \u2014 Tailwind's JIT can't see dynamically-concatenated class names. @default 'w-full sm:w-96'",
+          "description": "Panel width as Tailwind class string. Default fills the viewport on mobile and snaps to `w-96` (384 px) at `sm:` and above so phones don't lose content to a fixed 384 px column. Consumers passing a custom value should include a `w-full` mobile fallback in the same string (e.g. `\"w-full sm:w-[480px]\"`) — Tailwind's JIT can't see dynamically-concatenated class names. @default 'w-full sm:w-96'",
           "default": "w-full sm:w-96"
         },
         "position": {
@@ -8092,7 +8092,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative close event \u2014 emits UI:{closeEvent} via eventBus when panel should close",
+          "description": "Declarative close event — emits UI:{closeEvent} via eventBus when panel should close",
           "kind": "event-ref",
           "emitPayloadSchema": []
         }
@@ -8437,7 +8437,7 @@
           "types": [
             "string"
           ],
-          "description": "Layer 2 visual treatment \u2014 orthogonal to the structural variant (which currently flips mobile vs desktop).",
+          "description": "Layer 2 visual treatment — orthogonal to the structural variant (which currently flips mobile vs desktop).",
           "enumValues": [
             "hero",
             "compact-bar",
@@ -9182,7 +9182,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -9672,14 +9672,14 @@
           "types": [
             "boolean"
           ],
-          "description": "Show the top-bar search box. Default `false` \u2014 opt in by setting `searchEvent` (any truthy value implies showSearch) or this flag.",
+          "description": "Show the top-bar search box. Default `false` — opt in by setting `searchEvent` (any truthy value implies showSearch) or this flag.",
           "default": false
         },
         "searchEvent": {
           "types": [
             "string"
           ],
-          "description": "Declarative search event \u2014 fires `UI:{searchEvent}` on the bus when the user submits the search box (Enter key). Setting this implies `showSearch=true`. Use `onSearchSubmit` for direct React usage instead.",
+          "description": "Declarative search event — fires `UI:{searchEvent}` on the bus when the user submits the search box (Enter key). Setting this implies `showSearch=true`. Use `onSearchSubmit` for direct React usage instead.",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -9706,7 +9706,7 @@
           "types": [
             "array"
           ],
-          "description": "Generic top-bar action buttons rendered between the search bar and the notifications bell. Each entry: `{icon, label?, event, badge?, variant?}`. Domain-agnostic \u2014 consumers add a cart icon, profile button, help-bubble, or any other top-bar action by appending entries. Empty array (default) renders nothing.",
+          "description": "Generic top-bar action buttons rendered between the search bar and the notifications bell. Each entry: `{icon, label?, event, badge?, variant?}`. Domain-agnostic — consumers add a cart icon, profile button, help-bubble, or any other top-bar action by appending entries. Empty array (default) renders nothing.",
           "kind": "event-list",
           "eventField": "event",
           "items": {
@@ -9763,7 +9763,7 @@
           "types": [
             "string"
           ],
-          "description": "Declarative bell click event \u2014 fires `UI:{notificationClickEvent}` on the bus with an empty payload when the user clicks the bell.",
+          "description": "Declarative bell click event — fires `UI:{notificationClickEvent}` on the bus with an empty payload when the user clicks the bell.",
           "kind": "event-ref",
           "emitPayloadSchema": []
         },
@@ -9779,14 +9779,14 @@
           "types": [
             "boolean"
           ],
-          "description": "Show the theme toggle button in the header. Default `true` \u2014 universally useful for a11y / dark mode.",
+          "description": "Show the theme toggle button in the header. Default `true` — universally useful for a11y / dark mode.",
           "default": true
         },
         "sidebarFooter": {
           "types": [
             "node"
           ],
-          "description": "Custom sidebar footer (optional). When omitted, the sidebar has no footer \u2014 apps that need Settings/etc. add them via navItems."
+          "description": "Custom sidebar footer (optional). When omitted, the sidebar has no footer — apps that need Settings/etc. add them via navItems."
         },
         "currentPath": {
           "types": [
@@ -9950,7 +9950,7 @@
     "game-shell": {
       "type": "game-shell",
       "category": "template",
-      "description": "GameShell  A full-screen layout wrapper for game applications. Replaces DashboardLayout for game clients \u2014 no sidebar nav, just full-viewport rendering with an optional HUD overlay bar.  Used as a React Router layout route element: <Route element={<GameShell appName=\"TraitWars\" />}> <Route index element={<WorldMapPage />} /> ... </Route>",
+      "description": "GameShell  A full-screen layout wrapper for game applications. Replaces DashboardLayout for game clients — no sidebar nav, just full-viewport rendering with an optional HUD overlay bar.  Used as a React Router layout route element: <Route element={<GameShell appName=\"TraitWars\" />}> <Route index element={<WorldMapPage />} /> ... </Route>",
       "suggestedFor": [
         "game",
         "shell",
@@ -10035,7 +10035,7 @@
           "types": [
             "string"
           ],
-          "description": "Layer 2 visual treatment \u2014 drives the chart sub-renderer (bar / line / pie / etc.).",
+          "description": "Layer 2 visual treatment — drives the chart sub-renderer (bar / line / pie / etc.).",
           "enumValues": [
             "bar-vertical",
             "bar-horizontal",
@@ -10223,7 +10223,7 @@
           "types": [
             "boolean"
           ],
-          "description": "Format X-axis labels as time (ISO date in \u2192 \"Mar 2026\"-style label out)",
+          "description": "Format X-axis labels as time (ISO date in → \"Mar 2026\"-style label out)",
           "default": false
         },
         "drillEvent": {
@@ -10671,7 +10671,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -11709,7 +11709,7 @@
             "node",
             "function"
           ],
-          "description": "Fallback UI when an error is caught \u2014 ReactNode or render function"
+          "description": "Fallback UI when an error is caught — ReactNode or render function"
         },
         "className": {
           "types": [
@@ -11890,7 +11890,7 @@
           "types": [
             "function"
           ],
-          "description": "GAP-51: called with the new code on every keystroke when `editable === true`. Consumers should debounce + parse downstream \u2014 `CodeBlock` does not.",
+          "description": "GAP-51: called with the new code on every keystroke when `editable === true`. Consumers should debounce + parse downstream — `CodeBlock` does not.",
           "kind": "callback",
           "callbackArgs": [
             {
@@ -11903,14 +11903,14 @@
           "types": [
             "object"
           ],
-          "description": "GAP-80: line-level error/warning highlights for editable mode. Map of 1-based line number \u2192 severity. The overlay paints a colored background on each line: error = red, warning = yellow. Pass undefined (default) to disable. The consumer is responsible for computing the path \u2192 line map from the schema + validation results."
+          "description": "GAP-80: line-level error/warning highlights for editable mode. Map of 1-based line number → severity. The overlay paints a colored background on each line: error = red, warning = yellow. Pass undefined (default) to disable. The consumer is responsible for computing the path → line map from the schema + validation results."
         }
       }
     },
     "markdown-content": {
       "type": "markdown-content",
       "category": "component",
-      "description": "MarkdownContent Molecule Component  Renders markdown content with support for GFM (GitHub Flavored Markdown), math equations (KaTeX), and raw HTML. Handles inline code only \u2014 fenced code blocks should be parsed out and rendered with CodeBlock component.  Event Contract: - No events emitted (display-only component) - entityAware: false  NOTE: react-markdown's `components` override API requires native HTML elements \u2014 this is the same library-boundary exception as `<iframe>` in DocumentViewer and `<svg>` in JazariStateMachine/StateMachineView.",
+      "description": "MarkdownContent Molecule Component  Renders markdown content with support for GFM (GitHub Flavored Markdown), math equations (KaTeX), and raw HTML. Handles inline code only — fenced code blocks should be parsed out and rendered with CodeBlock component.  Event Contract: - No events emitted (display-only component) - entityAware: false  NOTE: react-markdown's `components` override API requires native HTML elements — this is the same library-boundary exception as `<iframe>` in DocumentViewer and `<svg>` in JazariStateMachine/StateMachineView.",
       "suggestedFor": [
         "markdown",
         "content",
@@ -11959,7 +11959,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [
@@ -12031,7 +12031,7 @@
           "types": [
             "string"
           ],
-          "description": "Raw content string \u2014 auto-parsed into segments"
+          "description": "Raw content string — auto-parsed into segments"
         },
         "segments": {
           "types": [
@@ -12092,7 +12092,7 @@
           "types": [
             "object"
           ],
-          "description": "Full schema \u2014 extracts first trait's state machine"
+          "description": "Full schema — extracts first trait's state machine"
         },
         "trait": {
           "types": [
@@ -12173,7 +12173,7 @@
           "types": [
             "function"
           ],
-          "description": "Custom state node renderer \u2014 when provided, replaces the default circle nodes",
+          "description": "Custom state node renderer — when provided, replaces the default circle nodes",
           "kind": "callback",
           "callbackArgs": [
             {
@@ -12523,7 +12523,7 @@
             "number",
             "string"
           ],
-          "description": "Override the viewport-driven day window. `'auto'` (default) tracks `window.innerWidth` \u2014 1 day on mobile, 3 on tablet, 7 on laptop+. Pass an explicit number to force a fixed window (useful for print layouts or screenshot tests).",
+          "description": "Override the viewport-driven day window. `'auto'` (default) tracks `window.innerWidth` — 1 day on mobile, 3 on tablet, 7 on laptop+. Pass an explicit number to force a fixed window (useful for print layouts or screenshot tests).",
           "default": "auto"
         }
       }
@@ -13089,21 +13089,21 @@
           "types": [
             "boolean"
           ],
-          "description": "Mark this container as the DnD root for its subtree \u2014 descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
+          "description": "Mark this container as the DnD root for its subtree — descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
         },
         "entity": {
           "types": [
             "object",
             "array"
           ],
-          "description": "Schema entity data \u2014 single record or collection, typed against `@almadar/core`'s `EntityRow` so the narrow type declared on the emitting trait's `Event { data : [X] }` flows through to the prop without widening. The generic `T` lets consumers pass a narrower entity (e.g. `CartItem`) and have the `children` render function receive cards typed to that exact shape.",
+          "description": "Schema entity data — single record or collection, typed against `@almadar/core`'s `EntityRow` so the narrow type declared on the emitting trait's `Event { data : [X] }` flows through to the prop without widening. The generic `T` lets consumers pass a narrower entity (e.g. `CartItem`) and have the `children` render function receive cards typed to that exact shape.",
           "required": true
         },
         "fields": {
           "types": [
             "array"
           ],
-          "description": "Field definitions for rendering each card. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits \u2014 both names resolve to the same shape here. Pass either.",
+          "description": "Field definitions for rendering each card. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either.",
           "items": {
             "types": [
               "object"
@@ -13165,7 +13165,7 @@
           "types": [
             "array"
           ],
-          "description": "Alias for `fields` \u2014 the compiler emits `columns` for field defs.",
+          "description": "Alias for `fields` — the compiler emits `columns` for field defs.",
           "items": {
             "types": [
               "object"
@@ -13399,7 +13399,7 @@
           "types": [
             "string"
           ],
-          "description": "Layer 2 visual treatment \u2014 mirrors the `entity-table` look enum so data-grid / data-list / entity-table share one knob name from authors.",
+          "description": "Layer 2 visual treatment — mirrors the `entity-table` look enum so data-grid / data-list / entity-table share one knob name from authors.",
           "enumValues": [
             "dense",
             "spacious",
@@ -13469,21 +13469,21 @@
           "types": [
             "boolean"
           ],
-          "description": "Mark this container as the DnD root for its subtree \u2014 descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
+          "description": "Mark this container as the DnD root for its subtree — descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
         },
         "entity": {
           "types": [
             "object",
             "array"
           ],
-          "description": "Schema entity data \u2014 single record or collection, typed against `@almadar/core`'s `EntityRow` so the narrow type declared on the emitting trait's `Event { data : [X] }` flows through to the prop without widening. The generic `T` lets consumers pass a narrower entity (e.g. `CartItem`) and have the `children` render function receive items of that exact shape.",
+          "description": "Schema entity data — single record or collection, typed against `@almadar/core`'s `EntityRow` so the narrow type declared on the emitting trait's `Event { data : [X] }` flows through to the prop without widening. The generic `T` lets consumers pass a narrower entity (e.g. `CartItem`) and have the `children` render function receive items of that exact shape.",
           "required": true
         },
         "fields": {
           "types": [
             "array"
           ],
-          "description": "Field definitions for rendering each row. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits \u2014 both names resolve to the same shape here. Pass either.",
+          "description": "Field definitions for rendering each row. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits — both names resolve to the same shape here. Pass either.",
           "items": {
             "types": [
               "object"
@@ -13540,7 +13540,7 @@
           "types": [
             "array"
           ],
-          "description": "Alias for `fields` \u2014 the compiler emits `columns` for field defs.",
+          "description": "Alias for `fields` — the compiler emits `columns` for field defs.",
           "items": {
             "types": [
               "object"
@@ -13822,7 +13822,7 @@
           "types": [
             "string"
           ],
-          "description": "Layer 2 visual treatment \u2014 mirrors the `entity-table` look enum so data-grid / data-list / entity-table share one knob name from authors.",
+          "description": "Layer 2 visual treatment — mirrors the `entity-table` look enum so data-grid / data-list / entity-table share one knob name from authors.",
           "enumValues": [
             "dense",
             "spacious",
@@ -15338,7 +15338,7 @@
           "types": [
             "number"
           ],
-          "description": "Signed delta vs previous period. >0 renders \u2191 green, <0 renders \u2193 red, 0 hides. Polarity reversal via `trendPolarity`."
+          "description": "Signed delta vs previous period. >0 renders ↑ green, <0 renders ↓ red, 0 hides. Polarity reversal via `trendPolarity`."
         },
         "trendPolarity": {
           "types": [
@@ -15355,7 +15355,7 @@
           "types": [
             "string"
           ],
-          "description": "When `'percent'`, renders trend with a `%` suffix (e.g. `\u2193 3.3%`); default is `'absolute'`.",
+          "description": "When `'percent'`, renders trend with a `%` suffix (e.g. `↓ 3.3%`); default is `'absolute'`.",
           "enumValues": [
             "absolute",
             "percent"
@@ -15383,7 +15383,7 @@
           "types": [
             "string"
           ],
-          "description": "Prefix prepended to the formatted value (e.g. \"\u2248 \")."
+          "description": "Prefix prepended to the formatted value (e.g. \"≈ \")."
         },
         "suffix": {
           "types": [
@@ -16739,7 +16739,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -16888,7 +16888,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -17036,7 +17036,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -17274,7 +17274,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -17438,7 +17438,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -17607,7 +17607,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -17729,7 +17729,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -17883,7 +17883,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
           "items": {
             "types": [
               "object"
@@ -18695,14 +18695,14 @@
             "boolean",
             "object"
           ],
-          "description": "Enable Suspense boundaries around each slot. When true, each inline slot is wrapped in `<ErrorBoundary><Suspense>` with Skeleton fallbacks. Opt-in \u2014 existing isLoading prop pattern still works."
+          "description": "Enable Suspense boundaries around each slot. When true, each inline slot is wrapped in `<ErrorBoundary><Suspense>` with Skeleton fallbacks. Opt-in — existing isLoading prop pattern still works."
         }
       }
     },
     "trait-frame": {
       "type": "trait-frame",
       "category": "component",
-      "description": "TraitFrame \u2014 renders the current frame of a referenced trait.  Resolves the `@trait.X[.slot]` binding at render time by looking up the referenced trait's last `render-ui` payload from the orbital's `UISlotManager`. Re-renders automatically when that trait transitions via the per-trait subscription channel (`subscribeTrait`).  This is the single rendering primitive both runtime paths converge on:  - **Interpreted path** \u2014 the trait-binding resolver in `renderer/trait-binding-resolver.ts` walks pattern trees at render time, substituting `\"@trait.X\"` string children with this component. - **Compiled path** \u2014 the TypeScript shell codegen in `orbital-shell-typescript/src/backend.rs::pattern_to_jsx_with_data` emits this component directly into generated JSX wherever a `@trait.*` string appears in a pattern tree.  Embedding is passive: the referenced trait's state machine runs unchanged; TraitFrame is only a read-only lens on its current frame. Event propagation happens over the shared event bus, not through this component.",
+      "description": "TraitFrame — renders the current frame of a referenced trait.  Resolves the `@trait.X[.slot]` binding at render time by looking up the referenced trait's last `render-ui` payload from the orbital's `UISlotManager`. Re-renders automatically when that trait transitions via the per-trait subscription channel (`subscribeTrait`).  This is the single rendering primitive both runtime paths converge on:  - **Interpreted path** — the trait-binding resolver in `renderer/trait-binding-resolver.ts` walks pattern trees at render time, substituting `\"@trait.X\"` string children with this component. - **Compiled path** — the TypeScript shell codegen in `orbital-shell-typescript/src/backend.rs::pattern_to_jsx_with_data` emits this component directly into generated JSX wherever a `@trait.*` string appears in a pattern tree.  Embedding is passive: the referenced trait's state machine runs unchanged; TraitFrame is only a read-only lens on its current frame. Event propagation happens over the shared event bus, not through this component.",
       "suggestedFor": [
         "trait",
         "frame",
@@ -18891,7 +18891,7 @@
           "types": [
             "function"
           ],
-          "description": "Called when the user clicks the remove (\u00d7) button",
+          "description": "Called when the user clicks the remove (×) button",
           "kind": "callback",
           "callbackArgs": []
         },
@@ -18899,7 +18899,7 @@
           "types": [
             "boolean"
           ],
-          "description": "Disable the remove button (renders without \u00d7 control)",
+          "description": "Disable the remove button (renders without × control)",
           "default": true
         },
         "onClick": {
@@ -18928,7 +18928,7 @@
           "types": [
             "string"
           ],
-          "description": "Event name dispatched via event bus when the remove (\u00d7) button is clicked. Payload: { label }",
+          "description": "Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label }",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -21043,7 +21043,7 @@
     "state-indicator": {
       "type": "state-indicator",
       "category": "game",
-      "description": "StateIndicator Component  Displays a visual indicator for a game entity's current state. Generic \u2014 not tied to any specific game. Projects can extend the state styles via the `stateStyles` prop.",
+      "description": "StateIndicator Component  Displays a visual indicator for a game entity's current state. Generic — not tied to any specific game. Projects can extend the state styles via the `stateStyles` prop.",
       "suggestedFor": [
         "state",
         "indicator",
@@ -23210,7 +23210,7 @@
     "combat-log": {
       "type": "combat-log",
       "category": "game",
-      "description": "CombatLog Component  Scrollable log of combat events with icons and colors. Generalized from Trait Wars \u2014 removed asset manifest coupling.",
+      "description": "CombatLog Component  Scrollable log of combat events with icons and colors. Generalized from Trait Wars — removed asset manifest coupling.",
       "suggestedFor": [
         "combat",
         "log",
@@ -23794,13 +23794,13 @@
           "types": [
             "string"
           ],
-          "description": "Event name emitted each tick with { dt, frame } \u2014 for closed-circuit .orb integration"
+          "description": "Event name emitted each tick with { dt, frame } — for closed-circuit .orb integration"
         },
         "drawEvent": {
           "types": [
             "string"
           ],
-          "description": "Event name emitted each draw frame with { frame } \u2014 for closed-circuit .orb integration"
+          "description": "Event name emitted each draw frame with { frame } — for closed-circuit .orb integration"
         }
       }
     },
@@ -24847,7 +24847,7 @@
           "types": [
             "function"
           ],
-          "description": "--- Event handlers (legacy callbacks \u2014 prefer declarative event string props below) ---",
+          "description": "--- Event handlers (legacy callbacks — prefer declarative event string props below) ---",
           "kind": "callback",
           "callbackArgs": [
             {
@@ -25106,7 +25106,7 @@
           "types": [
             "boolean"
           ],
-          "description": "Whether there are active effects \u2014 keeps RAF loop alive",
+          "description": "Whether there are active effects — keeps RAF loop alive",
           "default": false
         },
         "assetBaseUrl": {
@@ -26124,7 +26124,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [
@@ -26204,7 +26204,7 @@
             "object",
             "string"
           ],
-          "description": "Field name translation map \u2014 a BookFieldMap object or locale key (\"ar\")"
+          "description": "Field name translation map — a BookFieldMap object or locale key (\"ar\")"
         }
       }
     },
@@ -27446,7 +27446,7 @@
           "types": [
             "object"
           ],
-          "description": "Sound manifest \u2014 keys mapped to SoundEntry definitions",
+          "description": "Sound manifest — keys mapped to SoundEntry definitions",
           "required": true
         },
         "baseUrl": {
@@ -27725,7 +27725,7 @@
           "types": [
             "object"
           ],
-          "description": "Category \u2192 color mapping"
+          "description": "Category → color mapping"
         },
         "tooltipFrameUrl": {
           "types": [
@@ -28373,7 +28373,7 @@
     "simulation-canvas": {
       "type": "simulation-canvas",
       "category": "game",
-      "description": "SimulationCanvas  Self-contained 2D physics canvas for educational presets. Runs its own Euler integration loop \u2014 no external physics hook needed.",
+      "description": "SimulationCanvas  Self-contained 2D physics canvas for educational presets. Runs its own Euler integration loop — no external physics hook needed.",
       "suggestedFor": [
         "simulation",
         "canvas",
@@ -30008,7 +30008,7 @@
           "types": [
             "object"
           ],
-          "description": "Category \u2192 color mapping"
+          "description": "Category → color mapping"
         },
         "size": {
           "types": [
@@ -30189,7 +30189,7 @@
           "types": [
             "object"
           ],
-          "description": "Category \u2192 color mapping"
+          "description": "Category → color mapping"
         }
       }
     },
@@ -30208,7 +30208,7 @@
           "types": [
             "array"
           ],
-          "description": "The current sequence (sparse \u2014 undefined means empty slot)",
+          "description": "The current sequence (sparse — undefined means empty slot)",
           "required": true,
           "items": {
             "types": [
@@ -30273,7 +30273,7 @@
           "types": [
             "object"
           ],
-          "description": "Category \u2192 color mapping"
+          "description": "Category → color mapping"
         },
         "slotFeedback": {
           "types": [
@@ -30539,7 +30539,7 @@
           "types": [
             "object"
           ],
-          "description": "Category \u2192 color mapping"
+          "description": "Category → color mapping"
         },
         "stepDurationMs": {
           "types": [
@@ -31434,7 +31434,7 @@
             "object",
             "array"
           ],
-          "description": "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit"
+          "description": "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit"
         },
         "className": {
           "types": [
@@ -31828,7 +31828,7 @@
           "types": [
             "string"
           ],
-          "description": "Stroke color. `auto` (default): success when the series trends up (last \u2265 first), error when it trends down.",
+          "description": "Stroke color. `auto` (default): success when the series trends up (last ≥ first), error when it trends down.",
           "enumValues": [
             "auto",
             "primary",
@@ -31904,7 +31904,7 @@
           "types": [
             "string"
           ],
-          "description": "Event name emitted as `UI:{event}` with payload `{ from, to }`. Optional \u2014 when omitted, only the `onChange` callback fires.",
+          "description": "Event name emitted as `UI:{event}` with payload `{ from, to }`. Optional — when omitted, only the `onChange` callback fires.",
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
@@ -32073,7 +32073,7 @@
           "types": [
             "string"
           ],
-          "description": "Placeholder for the entry input. Default: `\"Type and press Enter\u2026\"`."
+          "description": "Placeholder for the entry input. Default: `\"Type and press Enter…\"`."
         },
         "disabled": {
           "types": [
@@ -32272,14 +32272,14 @@
           "types": [
             "boolean"
           ],
-          "description": "Mark this container as the DnD root for its subtree \u2014 descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
+          "description": "Mark this container as the DnD root for its subtree — descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
         },
         "entity": {
           "types": [
             "object",
             "array"
           ],
-          "description": "Schema entity data \u2014 single record or collection.",
+          "description": "Schema entity data — single record or collection.",
           "required": true
         },
         "columns": {
@@ -32630,7 +32630,7 @@
           "types": [
             "string"
           ],
-          "description": "Layer 2 visual treatment \u2014 mirrors the data-list / entity-table look enum so authors share one knob name across row renderers.",
+          "description": "Layer 2 visual treatment — mirrors the data-list / entity-table look enum so authors share one knob name across row renderers.",
           "enumValues": [
             "dense",
             "spacious",
@@ -32645,7 +32645,7 @@
     "heading": {
       "type": "heading",
       "category": "component",
-      "description": "Alias for typography \u2014 Typography Atom Component  Text elements following the KFlow design system with theme-aware styling.",
+      "description": "Alias for typography — Typography Atom Component  Text elements following the KFlow design system with theme-aware styling.",
       "suggestedFor": [
         "typography"
       ],
@@ -32799,7 +32799,7 @@
     "text": {
       "type": "text",
       "category": "component",
-      "description": "Alias for typography \u2014 Typography Atom Component  Text elements following the KFlow design system with theme-aware styling.",
+      "description": "Alias for typography — Typography Atom Component  Text elements following the KFlow design system with theme-aware styling.",
       "suggestedFor": [
         "typography"
       ],