@almadar/core 10.91.0 → 10.92.0

package/dist/patterns/index.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-12T07:27:39.835Z",
+  exportedAt: "2026-09-12T18:14:02.248Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -12,6 +12,7 @@ var patterns_registry_default = {
       tier: "organisms",
       family: "core",
       description: "Data table with columns and sorting",
+      fieldsContract: "display",
       suggestedFor: [
         "data-dense views",
         "comparisons",
@@ -480,6 +481,48 @@ var patterns_registry_default = {
             "card-rows"
           ],
           default: "dense"
+        },
+        relationsData: {
+          types: [
+            "object"
+          ],
+          description: "Relation display data: { fieldName: [{value, label}] } \u2014 injected server-side by the runtime (relation-option injection) or bound by compiled codegen; resolves stored foreign ids to display names for a column whose field is relation-typed. Same contract DetailPanel takes.",
+          mapValue: {
+            types: [
+              "array"
+            ],
+            items: {
+              types: [
+                "object"
+              ],
+              properties: {
+                value: {
+                  types: [
+                    "string"
+                  ]
+                },
+                label: {
+                  types: [
+                    "string"
+                  ]
+                },
+                description: {
+                  types: [
+                    "string"
+                  ]
+                },
+                disabled: {
+                  types: [
+                    "boolean"
+                  ]
+                }
+              },
+              required: [
+                "value",
+                "label"
+              ]
+            }
+          }
         }
       }
     },
@@ -710,7 +753,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -9756,6 +9798,7 @@ var patterns_registry_default = {
     "repeatable-form-section": {
       type: "repeatable-form-section",
       category: "form",
+      sourceFile: "components/core/molecules/RepeatableFormSection.tsx",
       tier: "molecules",
       family: "core",
       description: "RepeatableFormSection \u2014 a form section that repeats a fixed group of fields, letting the user add or remove entries.",
@@ -9819,7 +9862,6 @@ var patterns_registry_default = {
           ],
           description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           required: true,
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -17415,6 +17457,7 @@ var patterns_registry_default = {
     "state-machine-view": {
       type: "state-machine-view",
       category: "display",
+      sourceFile: "components/core/organisms/StateMachineView.tsx",
       tier: "organisms",
       family: "core",
       description: "StateMachineView component",
@@ -17482,7 +17525,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Custom state node renderer \u2014 when provided, replaces the default circle nodes",
-          kind: "callback",
           callbackArgs: [
             {
               name: "state",
@@ -17866,6 +17908,7 @@ var patterns_registry_default = {
     "calendar-grid": {
       type: "calendar-grid",
       category: "display",
+      sourceFile: "components/core/molecules/CalendarGrid.tsx",
       tier: "molecules",
       family: "core",
       description: "CalendarGrid component",
@@ -18003,7 +18046,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Additional payload for long-press events",
-          payloadFor: "longPressEvent"
+          payloadFor: "longPressEvent",
+          eventPayloadBrand: true
         },
         swipeLeftEvent: {
           types: [
@@ -18065,7 +18109,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Render function for one event chip's content. Receives the row and its index in the materialised events array. The grid keeps ownership of placement, colour and the click target; this replaces only what is drawn INSIDE the chip, so a host can show a time + instructor + badge stack instead of the default single label.",
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -18083,7 +18126,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: 'Per-event render function (schema-level alias for the children render prop). In `.orb`: `["fn", "item", { pattern tree with @item.field bindings }]`. In `.lolo`: `renderItem: (fn item <Component \u2026={@item.field}/>)` \u2014 the same contract `data-list` / `data-grid` / `carousel` already use.',
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -18629,6 +18671,7 @@ var patterns_registry_default = {
     "progress-dots": {
       type: "progress-dots",
       category: "component",
+      sourceFile: "components/core/molecules/ProgressDots.tsx",
       tier: "molecules",
       family: "core",
       description: "ProgressDots component",
@@ -18658,7 +18701,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Custom state resolver per dot index",
-          kind: "callback",
           callbackArgs: [
             {
               name: "index",
@@ -18708,6 +18750,7 @@ var patterns_registry_default = {
       family: "core",
       description: "DataGrid \u2014 structured records grid rendering rows over configurable columns, with sort, select, and drag-reorder.",
       capabilities: "admin table, records grid, user list, CRUD list, manage-records view, spreadsheet-style data grid, sortable columns",
+      fieldsContract: "display",
       suggestedFor: [
         "data",
         "grid",
@@ -19114,7 +19157,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Render prop for custom per-card content. When provided, `fields` are ignored; `itemActions` render as a footer beneath the custom content.",
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -19132,7 +19174,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: 'Per-item render function (schema-level alias for children render prop). In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. In .lolo, author the per-item renderer as renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.',
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -19165,6 +19206,48 @@ var patterns_registry_default = {
             "card-rows"
           ],
           default: "dense"
+        },
+        relationsData: {
+          types: [
+            "object"
+          ],
+          description: "Relation display data: { fieldName: [{value, label}] } \u2014 injected server-side by the runtime (relation-option injection) or bound by compiled codegen; resolves stored foreign ids to display names for a field whose type is relation. Same contract DetailPanel takes.",
+          mapValue: {
+            types: [
+              "array"
+            ],
+            items: {
+              types: [
+                "object"
+              ],
+              properties: {
+                value: {
+                  types: [
+                    "string"
+                  ]
+                },
+                label: {
+                  types: [
+                    "string"
+                  ]
+                },
+                description: {
+                  types: [
+                    "string"
+                  ]
+                },
+                disabled: {
+                  types: [
+                    "boolean"
+                  ]
+                }
+              },
+              required: [
+                "value",
+                "label"
+              ]
+            }
+          }
         }
       }
     },
@@ -19175,6 +19258,7 @@ var patterns_registry_default = {
       tier: "molecules",
       family: "core",
       description: "DataList component",
+      fieldsContract: "display",
       suggestedFor: [
         "data",
         "list",
@@ -19658,7 +19742,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored.",
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -19676,7 +19759,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: 'Per-item render function (schema-level alias for children render prop). In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. In .lolo, author the per-item renderer as renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.',
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -19725,6 +19807,48 @@ var patterns_registry_default = {
             "card-rows"
           ],
           default: "dense"
+        },
+        relationsData: {
+          types: [
+            "object"
+          ],
+          description: "Relation display data: { fieldName: [{value, label}] } \u2014 injected server-side by the runtime (relation-option injection) or bound by compiled codegen; resolves stored foreign ids to display names for a field whose type is relation. Same contract DetailPanel takes.",
+          mapValue: {
+            types: [
+              "array"
+            ],
+            items: {
+              types: [
+                "object"
+              ],
+              properties: {
+                value: {
+                  types: [
+                    "string"
+                  ]
+                },
+                label: {
+                  types: [
+                    "string"
+                  ]
+                },
+                description: {
+                  types: [
+                    "string"
+                  ]
+                },
+                disabled: {
+                  types: [
+                    "boolean"
+                  ]
+                }
+              },
+              required: [
+                "value",
+                "label"
+              ]
+            }
+          }
         }
       }
     },
@@ -20035,6 +20159,7 @@ var patterns_registry_default = {
     "range-slider": {
       type: "range-slider",
       category: "component",
+      sourceFile: "components/core/atoms/RangeSlider.tsx",
       tier: "atoms",
       family: "core",
       description: "RangeSlider component",
@@ -20137,7 +20262,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         onChange: {
           types: [
@@ -20157,7 +20283,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Format function for tooltip display",
-          kind: "callback",
           callbackArgs: [
             {
               name: "value",
@@ -21007,7 +21132,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Render function for each slide. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -21047,7 +21171,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Children-as-function fallback for renderItem (compiler compatibility)",
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -21205,6 +21328,7 @@ var patterns_registry_default = {
     "sortable-list": {
       type: "sortable-list",
       category: "display",
+      sourceFile: "components/core/molecules/SortableList.tsx",
       tier: "molecules",
       family: "core",
       description: "SortableList \u2014 a drag-and-drop reorderable list of items.",
@@ -21232,7 +21356,6 @@ var patterns_registry_default = {
           ],
           description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           required: true,
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -21276,7 +21399,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "reorderPayload prop",
-          payloadFor: "reorderEvent"
+          payloadFor: "reorderEvent",
+          eventPayloadBrand: true
         },
         dragHandlePosition: {
           types: [
@@ -30760,6 +30884,7 @@ var patterns_registry_default = {
     "doc-search": {
       type: "doc-search",
       category: "filter",
+      sourceFile: "components/core/molecules/DocSearch.tsx",
       tier: "molecules",
       family: "core",
       description: "DocSearch component",
@@ -30781,7 +30906,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Callback invoked with the search query, returns results",
-          kind: "callback",
           callbackArgs: [
             {
               name: "query",
@@ -36970,6 +37094,7 @@ var patterns_registry_default = {
       family: "core",
       description: "TableView \u2014 sortable, selectable data table rendering rows over configurable columns, with inline row actions and grouping.",
       capabilities: "admin console table, records list, CRUD data table, user list, manage-users grid, sortable columns, row selection with bulk actions, grouped list view",
+      fieldsContract: "display",
       suggestedFor: [
         "table",
         "view",
@@ -37426,7 +37551,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Custom per-row render. When provided, the whole row content is delegated to this function (columns are ignored for the body; the header still renders). Mirrors DataList's children render prop.",
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -37444,7 +37568,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: 'Per-row render function (schema alias). In .orb: ["fn","item",{...}]. The compiler converts this to the children render prop. In .lolo, author the per-row renderer as renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.',
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -37470,6 +37593,48 @@ var patterns_registry_default = {
             "bordered"
           ],
           default: "dense"
+        },
+        relationsData: {
+          types: [
+            "object"
+          ],
+          description: "Relation display data: { fieldName: [{value, label}] } \u2014 injected server-side by the runtime (relation-option injection) or bound by compiled codegen; resolves stored foreign ids to display names for a column whose field is relation-typed. Same contract DetailPanel takes.",
+          mapValue: {
+            types: [
+              "array"
+            ],
+            items: {
+              types: [
+                "object"
+              ],
+              properties: {
+                value: {
+                  types: [
+                    "string"
+                  ]
+                },
+                label: {
+                  types: [
+                    "string"
+                  ]
+                },
+                description: {
+                  types: [
+                    "string"
+                  ]
+                },
+                disabled: {
+                  types: [
+                    "boolean"
+                  ]
+                }
+              },
+              required: [
+                "value",
+                "label"
+              ]
+            }
+          }
         }
       }
     },
@@ -38051,6 +38216,7 @@ var patterns_registry_default = {
     "code-runner-panel": {
       type: "code-runner-panel",
       category: "display",
+      sourceFile: "components/core/organisms/CodeRunnerPanel.tsx",
       tier: "organisms",
       family: "core",
       description: "CodeRunnerPanel component",
@@ -38088,7 +38254,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Simulate executing the code. Omit to render a read-only block. Real execution is a separate future track \u2014 this callback supplies deterministic simulated output for UI feedback.",
-          kind: "callback",
           callbackArgs: [
             {
               name: "code",
@@ -38115,6 +38280,7 @@ var patterns_registry_default = {
     "segment-renderer": {
       type: "segment-renderer",
       category: "display",
+      sourceFile: "components/core/organisms/SegmentRenderer.tsx",
       tier: "organisms",
       family: "core",
       description: "SegmentRenderer component",
@@ -38206,7 +38372,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Simulate executing runnable code blocks. Omit to render runnable blocks as read-only. Real execution is a future track.",
-          kind: "callback",
           callbackArgs: [
             {
               name: "code",
@@ -38224,7 +38389,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Optional render slot for `visualization` segment types. When not provided, visualization segments are silently skipped. Callers can wire this to any custom component or orbital generator.",
-          kind: "callback",
           callbackArgs: [
             {
               name: "type",
@@ -39023,10 +39187,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Maps a keydown `e.code` \u2192 the board's SEMANTIC event (device-agnostic input).",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         keyUpMap: {
@@ -39034,10 +39200,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Maps a keyup `e.code` \u2192 the board's SEMANTIC event.",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         editable: {
@@ -39498,10 +39666,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: 'Per-direction PRESS \u2192 the board\'s SEMANTIC event (kind="dpad"), e.g. `{ left: "LEFT", right: "RIGHT", up: "JUMP" }`. Lets the d-pad emit the SAME intent events as the keyboard so the FSM stays device-agnostic.',
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         directionReleaseEvents: {
@@ -39509,10 +39679,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: 'Per-direction RELEASE \u2192 semantic event, e.g. `{ left: "STOP", right: "STOP" }`. Omit a direction to ignore its release.',
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         directionAssets: {
@@ -43461,6 +43633,7 @@ var patterns_registry_default = {
     "math-canvas": {
       type: "math-canvas",
       category: "learning",
+      sourceFile: "components/learning/molecules/MathCanvas.tsx",
       tier: "molecules",
       family: "learning",
       description: "MathCanvas component",
@@ -44492,10 +44665,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Maps a keydown `e.code` \u2192 the board's SEMANTIC event (device-agnostic input), emitted as `UI:{event}` \u2014 same contract as the game canvas keyMap.",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         keyUpMap: {
@@ -44503,10 +44678,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Maps a keyup `e.code` \u2192 the board's SEMANTIC event.",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         isLoading: {
@@ -50256,10 +50433,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: "keyMap prop",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         keyUpMap: {
@@ -50267,10 +50446,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: "keyUpMap prop",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         editable: {
@@ -54360,7 +54541,7 @@ var patterns_registry_default = {
 // src/patterns/integrators-registry.json
 var integrators_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-12T12:14:53.173Z",
+  exportedAt: "2026-09-12T17:27:32.966Z",
   integrators: {
     github: {
       name: "github",
@@ -58148,6 +58329,141 @@ var integrators_registry_default = {
             }
           }
         },
+        {
+          name: "buildLayers",
+          description: "Build per-part cutout layer images (name, box, z-order, pivot) from a source image and rig.",
+          params: [
+            {
+              name: "imagePath",
+              type: "string",
+              required: true,
+              description: "Path to the source image."
+            },
+            {
+              name: "rig",
+              type: "object",
+              required: true,
+              description: "The rig definition (parts, boxes, pivots, \u2026) as JSON."
+            },
+            {
+              name: "outDir",
+              type: "string",
+              required: true,
+              description: "Output directory for the layer images."
+            }
+          ],
+          responseShape: {
+            layers: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  name: {
+                    type: "string",
+                    required: true
+                  },
+                  path: {
+                    type: "string",
+                    required: true
+                  },
+                  x: {
+                    type: "number",
+                    required: true
+                  },
+                  y: {
+                    type: "number",
+                    required: true
+                  },
+                  w: {
+                    type: "number",
+                    required: true
+                  },
+                  h: {
+                    type: "number",
+                    required: true
+                  },
+                  z: {
+                    type: "number",
+                    required: true
+                  },
+                  pivot: {
+                    type: "[number, number]",
+                    required: true
+                  },
+                  isRest: {
+                    type: "boolean",
+                    required: true
+                  }
+                }
+              }
+            }
+          }
+        },
+        {
+          name: "pose",
+          description: "Sample a pose/animation preset into per-frame, per-part transforms for a rig.",
+          params: [
+            {
+              name: "imagePath",
+              type: "string",
+              required: true,
+              description: "Path to the source image."
+            },
+            {
+              name: "rig",
+              type: "object",
+              required: true,
+              description: "The rig definition (parts, boxes, pivots, \u2026) as JSON."
+            },
+            {
+              name: "roles",
+              type: "object",
+              required: true,
+              description: "Map of part name to preset bone role.",
+              mapValue: {
+                type: "string"
+              }
+            },
+            {
+              name: "preset",
+              type: "string",
+              required: false,
+              description: "Animation preset name."
+            },
+            {
+              name: "overrides",
+              type: "object",
+              required: false,
+              description: "Per-part motion overrides applied over the preset."
+            }
+          ],
+          responseShape: {
+            fps: "number",
+            frames: {
+              type: "array",
+              items: {
+                type: "object",
+                mapValue: {
+                  type: "object",
+                  properties: {
+                    angle: {
+                      type: "number",
+                      required: true
+                    },
+                    bx: {
+                      type: "number",
+                      required: true
+                    },
+                    by: {
+                      type: "number",
+                      required: true
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
         {
           name: "generate",
           description: "Generate one image on the local image server (text-to-image, or a Kontext edit conditioned on `sourcePath`).",
@@ -58225,7 +58541,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-12T07:27:39.835Z",
+  exportedAt: "2026-09-12T18:14:02.248Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -59675,7 +59991,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-12T07:27:39.835Z",
+  exportedAt: "2026-09-12T18:14:02.248Z",
   contracts: {
     form: {
       emits: [