@almadar/core 10.90.0 → 10.92.0

package/dist/factory/index.js

@@ -929,6 +929,7 @@ var patterns_registry_default = {
       tier: "organisms",
       family: "core",
       description: "Data table with columns and sorting",
+      fieldsContract: "display",
       suggestedFor: [
         "data-dense views",
         "comparisons",
@@ -1397,6 +1398,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"
+              ]
+            }
+          }
         }
       }
     },
@@ -1627,7 +1670,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",
@@ -5221,7 +5263,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -5381,7 +5426,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -8415,6 +8463,7 @@ var patterns_registry_default = {
     button: {
       type: "button",
       category: "component",
+      sourceFile: "components/core/atoms/Button.tsx",
       tier: "atoms",
       family: "core",
       description: "Clickable button that emits events",
@@ -8559,7 +8608,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -8601,7 +8653,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         label: {
           types: [
@@ -8626,6 +8679,7 @@ var patterns_registry_default = {
     badge: {
       type: "badge",
       category: "component",
+      sourceFile: "components/core/atoms/Badge.tsx",
       tier: "atoms",
       family: "core",
       description: "Small label for status or count",
@@ -8757,7 +8811,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -9257,6 +9314,7 @@ var patterns_registry_default = {
     input: {
       type: "input",
       category: "component",
+      sourceFile: "components/core/atoms/Input.tsx",
       tier: "atoms",
       family: "core",
       description: "Text input field",
@@ -9384,9 +9442,7 @@ var patterns_registry_default = {
             "function",
             "string"
           ],
-          description: "Callback or declarative event key when clear button is clicked",
-          kind: "event-ref",
-          emitPayloadSchema: []
+          description: "Callback or declarative event key when clear button is clicked"
         },
         options: {
           types: [
@@ -9431,16 +9487,9 @@ var patterns_registry_default = {
           kind: "event-ref",
           emitPayloadSchema: [
             {
-              name: "value",
-              type: "string",
-              required: true,
-              typeWhen: [
-                {
-                  knob: "inputType",
-                  equals: "number",
-                  type: "number"
-                }
-              ]
+              name: "_payload",
+              type: "object",
+              required: false
             }
           ]
         }
@@ -9510,6 +9559,7 @@ var patterns_registry_default = {
     select: {
       type: "select",
       category: "component",
+      sourceFile: "components/core/atoms/Select.tsx",
       tier: "atoms",
       family: "core",
       description: "Dropdown select input",
@@ -9699,7 +9749,26 @@ var patterns_registry_default = {
             "function",
             "string"
           ],
-          description: "Value-based change: a React callback (internal use) OR a declarative event key that emits `{ value }` on the bus (render-ui / lolo authoring). Mirrors the `onChange` handler|event convention so it's an event-emitting prop, not a bare callback."
+          description: "Value-based change: a React callback (internal use) OR a declarative event key that emits `{ value }` on the bus (render-ui / lolo authoring). Mirrors the `onChange` handler|event convention so it's an event-emitting prop, not a bare callback.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "value",
+              type: "string",
+              required: true,
+              schema: {
+                types: [
+                  "string",
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "string"
+                  ]
+                }
+              }
+            }
+          ]
         }
       }
     },
@@ -10646,6 +10715,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.",
@@ -10709,7 +10779,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",
@@ -12254,6 +12323,7 @@ var patterns_registry_default = {
     "input-group": {
       type: "input-group",
       category: "form",
+      sourceFile: "components/core/molecules/InputGroup.tsx",
       tier: "molecules",
       family: "core",
       description: "InputGroup Molecule Component  A component for grouping input with addons (icons, buttons, text). Uses Input, Button, Icon, and Typography atoms.",
@@ -12374,9 +12444,7 @@ var patterns_registry_default = {
             "function",
             "string"
           ],
-          description: "Callback or declarative event key when clear button is clicked",
-          kind: "event-ref",
-          emitPayloadSchema: []
+          description: "Callback or declarative event key when clear button is clicked"
         },
         options: {
           types: [
@@ -12420,16 +12488,9 @@ var patterns_registry_default = {
           kind: "event-ref",
           emitPayloadSchema: [
             {
-              name: "value",
-              type: "string",
-              required: true,
-              typeWhen: [
-                {
-                  knob: "inputType",
-                  equals: "number",
-                  type: "number"
-                }
-              ]
+              name: "_payload",
+              type: "object",
+              required: false
             }
           ]
         },
@@ -14729,6 +14790,7 @@ var patterns_registry_default = {
     "game-shell": {
       type: "game-shell",
       category: "game",
+      sourceFile: "components/game/templates/GameShell.tsx",
       tier: "templates",
       family: "game",
       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>',
@@ -14854,7 +14916,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -14949,7 +15014,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -18306,6 +18374,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",
@@ -18373,7 +18442,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Custom state node renderer \u2014 when provided, replaces the default circle nodes",
-          kind: "callback",
           callbackArgs: [
             {
               name: "state",
@@ -18757,6 +18825,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",
@@ -18894,7 +18963,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Additional payload for long-press events",
-          payloadFor: "longPressEvent"
+          payloadFor: "longPressEvent",
+          eventPayloadBrand: true
         },
         swipeLeftEvent: {
           types: [
@@ -18956,7 +19026,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",
@@ -18974,7 +19043,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",
@@ -19520,6 +19588,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",
@@ -19549,7 +19618,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Custom state resolver per dot index",
-          kind: "callback",
           callbackArgs: [
             {
               name: "index",
@@ -19599,6 +19667,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",
@@ -20005,7 +20074,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",
@@ -20023,7 +20091,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",
@@ -20056,6 +20123,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"
+              ]
+            }
+          }
         }
       }
     },
@@ -20066,6 +20175,7 @@ var patterns_registry_default = {
       tier: "molecules",
       family: "core",
       description: "DataList component",
+      fieldsContract: "display",
       suggestedFor: [
         "data",
         "list",
@@ -20549,7 +20659,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",
@@ -20567,7 +20676,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",
@@ -20616,6 +20724,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"
+              ]
+            }
+          }
         }
       }
     },
@@ -20926,6 +21076,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",
@@ -21028,7 +21179,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         onChange: {
           types: [
@@ -21048,7 +21200,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Format function for tooltip display",
-          kind: "callback",
           callbackArgs: [
             {
               name: "value",
@@ -21898,7 +22049,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",
@@ -21938,7 +22088,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Children-as-function fallback for renderItem (compiler compatibility)",
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -22096,6 +22245,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.",
@@ -22123,7 +22273,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",
@@ -22167,7 +22316,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "reorderPayload prop",
-          payloadFor: "reorderEvent"
+          payloadFor: "reorderEvent",
+          eventPayloadBrand: true
         },
         dragHandlePosition: {
           types: [
@@ -29217,6 +29367,7 @@ var patterns_registry_default = {
     "choice-button": {
       type: "choice-button",
       category: "game",
+      sourceFile: "components/game/atoms/ChoiceButton.tsx",
       tier: "atoms",
       family: "game",
       description: "ChoiceButton component",
@@ -29306,7 +29457,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -29396,6 +29550,7 @@ var patterns_registry_default = {
     "control-button": {
       type: "control-button",
       category: "game",
+      sourceFile: "components/game/atoms/ControlButton.tsx",
       tier: "atoms",
       family: "game",
       description: "ControlButton component",
@@ -29471,7 +29626,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -29588,6 +29746,7 @@ var patterns_registry_default = {
     "dialogue-bubble": {
       type: "dialogue-bubble",
       category: "game",
+      sourceFile: "components/game/atoms/DialogueBubble.tsx",
       tier: "atoms",
       family: "game",
       description: "DialogueBubble component",
@@ -29678,7 +29837,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -29749,6 +29911,7 @@ var patterns_registry_default = {
     "health-bar": {
       type: "health-bar",
       category: "game",
+      sourceFile: "components/game/atoms/HealthBar.tsx",
       tier: "atoms",
       family: "game",
       description: "HealthBar component",
@@ -29897,7 +30060,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -29992,7 +30158,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -30027,6 +30196,7 @@ var patterns_registry_default = {
     "score-display": {
       type: "score-display",
       category: "game",
+      sourceFile: "components/game/atoms/ScoreDisplay.tsx",
       tier: "atoms",
       family: "game",
       description: "ScoreDisplay component",
@@ -30102,7 +30272,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -30189,6 +30362,7 @@ var patterns_registry_default = {
     "timer-display": {
       type: "timer-display",
       category: "game",
+      sourceFile: "components/game/atoms/TimerDisplay.tsx",
       tier: "atoms",
       family: "game",
       description: "TimerDisplay component",
@@ -30315,7 +30489,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -31624,6 +31801,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",
@@ -31645,7 +31823,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Callback invoked with the search query, returns results",
-          kind: "callback",
           callbackArgs: [
             {
               name: "query",
@@ -32585,6 +32762,7 @@ var patterns_registry_default = {
     "game-hud": {
       type: "game-hud",
       category: "game",
+      sourceFile: "components/game/molecules/GameHud.tsx",
       tier: "molecules",
       family: "game",
       description: "GameHud component",
@@ -32675,7 +32853,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -32769,7 +32950,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -32926,7 +33110,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -33020,7 +33207,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -33209,7 +33399,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -33556,7 +33749,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -33597,6 +33793,7 @@ var patterns_registry_default = {
     "stat-badge": {
       type: "stat-badge",
       category: "game",
+      sourceFile: "components/game/molecules/StatBadge.tsx",
       tier: "molecules",
       family: "game",
       description: "StatBadge component",
@@ -33672,7 +33869,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -33767,7 +33967,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -34293,6 +34496,7 @@ var patterns_registry_default = {
     "game-audio-toggle": {
       type: "game-audio-toggle",
       category: "game",
+      sourceFile: "components/game/atoms/GameAudioToggle.tsx",
       tier: "atoms",
       family: "game",
       description: "GameAudioToggle component",
@@ -34424,7 +34628,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -34519,7 +34726,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -34568,6 +34778,7 @@ var patterns_registry_default = {
     "trait-slot": {
       type: "trait-slot",
       category: "game",
+      sourceFile: "components/game/molecules/TraitSlot.tsx",
       tier: "molecules",
       family: "game",
       description: "Event Contract: Emits: UI:CLICK Emits: UI:REMOVE",
@@ -34680,7 +34891,10 @@ var patterns_registry_default = {
                     "1:1",
                     "16:9",
                     "5:7",
-                    "8:1"
+                    "8:1",
+                    "4:1",
+                    "5:3",
+                    "1:2"
                   ]
                 },
                 atlas: {
@@ -34923,7 +35137,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -35100,7 +35317,10 @@ var patterns_registry_default = {
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       atlas: {
@@ -35326,7 +35546,10 @@ var patterns_registry_default = {
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       atlas: {
@@ -35521,6 +35744,7 @@ var patterns_registry_default = {
     "action-palette": {
       type: "action-palette",
       category: "game",
+      sourceFile: "components/game/molecules/ActionPalette.tsx",
       tier: "molecules",
       family: "game",
       description: "ActionPalette Component  Grid of draggable ActionTile components for the Sequencer tier. Kids pick from these to build their sequence.",
@@ -35631,7 +35855,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -35819,6 +36046,7 @@ var patterns_registry_default = {
     "action-tile": {
       type: "action-tile",
       category: "game",
+      sourceFile: "components/game/molecules/ActionTile.tsx",
       tier: "molecules",
       family: "game",
       description: "ActionTile Component  A draggable action tile for the Sequencer tier (ages 5-8). Kids drag these from the ActionPalette into SequenceBar slots. Sets SlotItemData on dataTransfer for TraitSlot compatibility.",
@@ -36031,7 +36259,10 @@ var patterns_registry_default = {
                     "1:1",
                     "16:9",
                     "5:7",
-                    "8:1"
+                    "8:1",
+                    "4:1",
+                    "5:3",
+                    "1:2"
                   ]
                 },
                 atlas: {
@@ -36194,6 +36425,7 @@ var patterns_registry_default = {
     "sequence-bar": {
       type: "sequence-bar",
       category: "game",
+      sourceFile: "components/game/molecules/SequenceBar.tsx",
       tier: "molecules",
       family: "game",
       description: "SequenceBar Component  A row of TraitSlot components forming the action sequence for the Sequencer tier (ages 5-8). Kids drag ActionTiles from the palette into these slots to build their sequence.",
@@ -36304,7 +36536,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -36532,7 +36767,10 @@ var patterns_registry_default = {
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       atlas: {
@@ -37773,6 +38011,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",
@@ -38229,7 +38468,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",
@@ -38247,7 +38485,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",
@@ -38273,6 +38510,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"
+              ]
+            }
+          }
         }
       }
     },
@@ -38854,6 +39133,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",
@@ -38891,7 +39171,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",
@@ -38918,6 +39197,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",
@@ -39009,7 +39289,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",
@@ -39027,7 +39306,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",
@@ -39581,6 +39859,7 @@ var patterns_registry_default = {
     "canvas-2d": {
       type: "canvas-2d",
       category: "game",
+      sourceFile: "components/game/molecules/Canvas2D.tsx",
       tier: "molecules",
       family: "game",
       description: "Canvas2D component",
@@ -39727,7 +40006,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -39822,10 +40104,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: {
@@ -39833,10 +40117,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: {
@@ -40039,6 +40325,7 @@ var patterns_registry_default = {
     "control-grid": {
       type: "control-grid",
       category: "game",
+      sourceFile: "components/game/molecules/ControlGrid.tsx",
       tier: "molecules",
       family: "game",
       description: "ControlGrid component",
@@ -40150,7 +40437,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -40293,10 +40583,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: {
@@ -40304,10 +40596,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: {
@@ -40379,7 +40673,10 @@ var patterns_registry_default = {
                   "1:1",
                   "16:9",
                   "5:7",
-                  "8:1"
+                  "8:1",
+                  "4:1",
+                  "5:3",
+                  "1:2"
                 ]
               },
               atlas: {
@@ -40450,6 +40747,7 @@ var patterns_registry_default = {
     "game-icon": {
       type: "game-icon",
       category: "game",
+      sourceFile: "components/core/atoms/GameIcon.tsx",
       tier: "atoms",
       family: "core",
       description: "GameIcon component",
@@ -40525,7 +40823,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -44249,6 +44550,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",
@@ -45280,10 +45582,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: {
@@ -45291,10 +45595,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: {
@@ -48823,6 +49129,7 @@ var patterns_registry_default = {
     "draw-sprite": {
       type: "draw-sprite",
       category: "game",
+      sourceFile: "components/game/atoms/DrawSprite.tsx",
       tier: "atoms",
       family: "game",
       description: "DrawSprite component",
@@ -48944,7 +49251,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -49928,6 +50238,7 @@ var patterns_registry_default = {
     "draw-sprite-layer": {
       type: "draw-sprite-layer",
       category: "game",
+      sourceFile: "components/game/molecules/DrawSpriteLayer.tsx",
       tier: "molecules",
       family: "game",
       description: "DrawSpriteLayer component",
@@ -50070,7 +50381,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -50376,6 +50690,7 @@ var patterns_registry_default = {
     canvas: {
       type: "canvas",
       category: "game",
+      sourceFile: "components/game/molecules/Canvas.tsx",
       tier: "molecules",
       family: "game",
       description: "Canvas component",
@@ -50615,7 +50930,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -51032,10 +51350,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: "keyMap prop",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         keyUpMap: {
@@ -51043,10 +51363,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: "keyUpMap prop",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         editable: {
@@ -53048,6 +53370,7 @@ var patterns_registry_default = {
     "draw-fx-layer": {
       type: "draw-fx-layer",
       category: "game",
+      sourceFile: "components/game/molecules/DrawFxLayer.tsx",
       tier: "molecules",
       family: "game",
       description: "DrawFxLayer component",
@@ -53423,7 +53746,10 @@ var patterns_registry_default = {
                   "1:1",
                   "16:9",
                   "5:7",
-                  "8:1"
+                  "8:1",
+                  "4:1",
+                  "5:3",
+                  "1:2"
                 ]
               },
               atlas: {
@@ -54841,7 +55167,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -54973,7 +55302,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "The skeleton (bind pose; FK chain via `parent` names).",
+          description: "The skeleton (bind pose; FK chain via `parent` names). Falls back to the rigbundle's `bones` when empty.",
           required: true,
           items: {
             types: [
@@ -55056,6 +55385,12 @@ var patterns_registry_default = {
             "frames"
           ]
         },
+        clipName: {
+          types: [
+            "string"
+          ],
+          description: "Named clip inside the rigbundle at `meshUrl` (`clips[clipName].frames`); used when `clip` is absent. Empty/unknown = no clip."
+        },
         frame: {
           types: [
             "number"
@@ -55260,7 +55595,8 @@ var EntityFieldSchema = z.lazy(() => {
     properties: z.record(EntityFieldSchema).optional(),
     intrinsic: z.boolean().optional(),
     description: z.string().optional(),
-    synonyms: z.string().optional()
+    synonyms: z.string().optional(),
+    mergedFrom: z.string().optional()
   };
   function scalarVariant(t) {
     return z.object({