@almadar/patterns 2.12.2 → 2.14.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-04-03T05:25:58.152Z",
+  exportedAt: "2026-04-18T11:44:35.778Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -103,7 +103,8 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Columns can be Column objects or simple string field names"
+          itemKind: "field-ref",
+          description: "Columns can be Column objects or simple string field names. String elements must resolve to fields on the linked entity."
         },
         itemActions: {
           types: [
@@ -497,7 +498,8 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Entity field name containing an image URL to display as card thumbnail"
+          kind: "field-ref",
+          description: "Entity field name containing an image URL to display as card thumbnail. Must resolve to a field on the linked entity."
         }
       }
     },
@@ -1283,7 +1285,8 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Filter definitions from schema",
+          itemKind: "field-ref",
+          description: "Filter definitions from schema. String elements must resolve to fields on the linked entity.",
           required: true
         },
         onFilterChange: {
@@ -10645,6 +10648,24 @@ var patterns_registry_default = {
             "string"
           ],
           description: "Additional CSS classes"
+        },
+        editable: {
+          types: [
+            "boolean"
+          ],
+          description: "When true, render an editable surface that composes a transparent `Textarea` over a Prism-highlighted overlay. The overlay re-tokenizes on each keystroke (driven from a local mirror of the textarea value), so users see syntax-highlighted code while still being able to type. Folding is skipped in editable mode. History: GAP-51 first-cut shipped plain (no-highlighting) editable text; GAP-77 (2026-04-12) added the Prism overlay layer. Default: false (existing read-only behavior unchanged)."
+        },
+        onChange: {
+          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."
+        },
+        errorLines: {
+          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."
         }
       }
     },
@@ -13185,7 +13206,8 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Entity field name containing an image URL for card thumbnails"
+          kind: "field-ref",
+          description: "Entity field name containing an image URL for card thumbnails. Must resolve to a field on the linked entity."
         },
         selectable: {
           types: [
@@ -13291,7 +13313,8 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Group items by a field value (renders section headers between groups)"
+          kind: "field-ref",
+          description: "Group items by a field value (renders section headers between groups). Must resolve to a field on the linked entity."
         },
         senderField: {
           types: [
@@ -20578,6 +20601,18 @@ var patterns_registry_default = {
           ],
           description: "onLevelChange prop"
         },
+        onOrbitalDoubleClick: {
+          types: [
+            "function"
+          ],
+          description: "GAP-52: fired when the user double-clicks an orbital. Consumers (e.g. the builder workspace) use this as the trigger to enter cosmic mode (`AvlOrbitalsCosmicZoom`) for the focused orbital. The level at which this fires is controlled by `cosmicEntryLevel` (default `'expanded'`). At `'expanded'` the existing overview\u2192expanded drill is preserved \u2014 the callback fires only on the second double-click. At `'overview'` the callback fires on the FIRST double-click and the existing drill is suppressed for that interaction. `'both'` fires at either level. The callback runs unconditionally \u2014 persona / permission gating is the consumer's responsibility."
+        },
+        cosmicEntryLevel: {
+          types: [
+            "string"
+          ],
+          description: "GAP-53: which level the `onOrbitalDoubleClick` callback fires at. - `'expanded'` (default, non-breaking) \u2014 fires only at L2 expanded; the first overview double-click still drills overview\u2192expanded. - `'overview'` \u2014 fires at L1 overview on the FIRST double-click. The overview\u2192expanded drill is suppressed when the callback is provided. - `'both'` \u2014 fires at either level."
+        },
         initialOrbital: {
           types: [
             "string"
@@ -22790,6 +22825,155 @@ var patterns_registry_default = {
         }
       }
     },
+    "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.",
+      suggestedFor: [
+        "trait",
+        "frame",
+        "trait frame"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        traitName: {
+          types: [
+            "string"
+          ],
+          description: "Name of the trait whose current frame to embed. Must match a trait declared in the current orbital. Compiler validates that the name exists at build time (see `ORB_BINDING_TRAIT_UNKNOWN`).",
+          required: true
+        },
+        fallback: {
+          types: [
+            "node"
+          ],
+          description: "Rendered when the referenced trait has not (yet) emitted any render-ui. Use a skeleton, spinner, or message. Defaults to `null` (renders nothing), so an unfulfilled reference drops cleanly out of a parent `children:` array."
+        }
+      }
+    },
+    "file-tree": {
+      type: "file-tree",
+      category: "component",
+      description: "FileTree component",
+      suggestedFor: [
+        "file",
+        "tree",
+        "file tree"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        tree: {
+          types: [
+            "array"
+          ],
+          description: "The tree data",
+          required: true
+        },
+        selectedPath: {
+          types: [
+            "string"
+          ],
+          description: "Currently selected file path"
+        },
+        onFileSelect: {
+          types: [
+            "function"
+          ],
+          description: "Called when a file is clicked"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "CSS class"
+        },
+        indent: {
+          types: [
+            "number"
+          ],
+          description: "Indent size per level in px (default: 16)"
+        }
+      }
+    },
+    "avl-orbitals-cosmic-zoom": {
+      type: "avl-orbitals-cosmic-zoom",
+      category: "display",
+      description: "AvlOrbitalsCosmicZoom component",
+      suggestedFor: [
+        "avl",
+        "orbitals",
+        "cosmic",
+        "zoom",
+        "avl orbitals cosmic zoom"
+      ],
+      typicalSize: "large",
+      propsSchema: {
+        schema: {
+          types: [
+            "object",
+            "string"
+          ],
+          description: "The orbital schema (parsed object or JSON string)",
+          required: true
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "CSS class for the outer container"
+        },
+        color: {
+          types: [
+            "string"
+          ],
+          description: "Primary color for the visualization"
+        },
+        animated: {
+          types: [
+            "boolean"
+          ],
+          description: "Enable animations (default: true)"
+        },
+        width: {
+          types: [
+            "number",
+            "string"
+          ],
+          description: "Container width"
+        },
+        height: {
+          types: [
+            "number",
+            "string"
+          ],
+          description: "Container height"
+        },
+        highlightedOrbital: {
+          types: [
+            "string"
+          ],
+          description: "GAP-52: name of the orbital to highlight with a persistent ring/glow. Independent from user-driven selection (click). Used by the builder workspace when entering cosmic mode from a focused orbital \u2014 the focused orbital is highlighted while the user can still click any other orbital to select it."
+        },
+        onOrbitalSelect: {
+          types: [
+            "function"
+          ],
+          description: "GAP-55: fired when the user clicks an orbital tile. Consumers (e.g. the builder workspace) use this as the trigger to drill INTO the clicked orbital \u2014 typically by switching back to the canvas tab and opening the clicked orbital at L2 expanded. Local `selected` toggle (visual highlight + info panel) still fires regardless of whether the callback is provided."
+        },
+        minZoom: {
+          types: [
+            "number"
+          ],
+          description: "GAP-54: minimum zoom factor when scroll-wheel zooming. Default 0.4."
+        },
+        maxZoom: {
+          types: [
+            "number"
+          ],
+          description: "GAP-54: maximum zoom factor when scroll-wheel zooming. Default 3."
+        }
+      }
+    },
     heading: {
       type: "heading",
       category: "component",
@@ -23606,7 +23790,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-04-03T05:25:58.152Z",
+  exportedAt: "2026-04-18T11:44:35.778Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -25386,6 +25570,21 @@ var component_mapping_default = {
       importPath: "@/components/organisms/OrbInspector",
       category: "debug"
     },
+    "trait-frame": {
+      component: "TraitFrame",
+      importPath: "@/components/atoms/TraitFrame",
+      category: "component"
+    },
+    "file-tree": {
+      component: "FileTree",
+      importPath: "@/components/molecules/FileTree",
+      category: "component"
+    },
+    "avl-orbitals-cosmic-zoom": {
+      component: "AvlOrbitalsCosmicZoom",
+      importPath: "@/components/organisms/AvlOrbitalsCosmicZoom",
+      category: "display"
+    },
     heading: {
       component: "Typography",
       importPath: "@/components/atoms/Typography",
@@ -25402,7 +25601,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-04-03T05:25:58.152Z",
+  exportedAt: "2026-04-18T11:44:35.778Z",
   contracts: {
     form: {
       emits: [
@@ -26694,6 +26893,13 @@ var event_contracts_default = {
             type: "object"
           }
         },
+        {
+          event: "CODE_CHANGE",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
         {
           event: "SERVICE_MODE_TOGGLE",
           trigger: "action",