@almadar/core 10.90.0 → 10.92.0

package/dist/patterns/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-09-10T08:51:20.514Z",
+  "exportedAt": "2026-09-12T18:14:02.248Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -9,6 +9,7 @@
       "tier": "organisms",
       "family": "core",
       "description": "Data table with columns and sorting",
+      "fieldsContract": "display",
       "suggestedFor": [
         "data-dense views",
         "comparisons",
@@ -477,6 +478,48 @@
             "card-rows"
           ],
           "default": "dense"
+        },
+        "relationsData": {
+          "types": [
+            "object"
+          ],
+          "description": "Relation display data: { fieldName: [{value, label}] } — 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"
+              ]
+            }
+          }
         }
       }
     },
@@ -707,7 +750,6 @@
             "function"
           ],
           "description": "Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "item",
@@ -4301,7 +4343,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -4461,7 +4506,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -7495,6 +7543,7 @@
     "button": {
       "type": "button",
       "category": "component",
+      "sourceFile": "components/core/atoms/Button.tsx",
       "tier": "atoms",
       "family": "core",
       "description": "Clickable button that emits events",
@@ -7639,7 +7688,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -7681,7 +7733,8 @@
             "object"
           ],
           "description": "Payload to include with the action event",
-          "payloadFor": "action"
+          "payloadFor": "action",
+          "eventPayloadBrand": true
         },
         "label": {
           "types": [
@@ -7706,6 +7759,7 @@
     "badge": {
       "type": "badge",
       "category": "component",
+      "sourceFile": "components/core/atoms/Badge.tsx",
       "tier": "atoms",
       "family": "core",
       "description": "Small label for status or count",
@@ -7837,7 +7891,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -8337,6 +8394,7 @@
     "input": {
       "type": "input",
       "category": "component",
+      "sourceFile": "components/core/atoms/Input.tsx",
       "tier": "atoms",
       "family": "core",
       "description": "Text input field",
@@ -8464,9 +8522,7 @@
             "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": [
@@ -8511,16 +8567,9 @@
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
-              "name": "value",
-              "type": "string",
-              "required": true,
-              "typeWhen": [
-                {
-                  "knob": "inputType",
-                  "equals": "number",
-                  "type": "number"
-                }
-              ]
+              "name": "_payload",
+              "type": "object",
+              "required": false
             }
           ]
         }
@@ -8590,6 +8639,7 @@
     "select": {
       "type": "select",
       "category": "component",
+      "sourceFile": "components/core/atoms/Select.tsx",
       "tier": "atoms",
       "family": "core",
       "description": "Dropdown select input",
@@ -8779,7 +8829,26 @@
             "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"
+                  ]
+                }
+              }
+            }
+          ]
         }
       }
     },
@@ -9726,6 +9795,7 @@
     "repeatable-form-section": {
       "type": "repeatable-form-section",
       "category": "form",
+      "sourceFile": "components/core/molecules/RepeatableFormSection.tsx",
       "tier": "molecules",
       "family": "core",
       "description": "RepeatableFormSection — a form section that repeats a fixed group of fields, letting the user add or remove entries.",
@@ -9789,7 +9859,6 @@
           ],
           "description": "Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
           "required": true,
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "item",
@@ -11334,6 +11403,7 @@
     "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.",
@@ -11454,9 +11524,7 @@
             "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": [
@@ -11500,16 +11568,9 @@
           "kind": "event-ref",
           "emitPayloadSchema": [
             {
-              "name": "value",
-              "type": "string",
-              "required": true,
-              "typeWhen": [
-                {
-                  "knob": "inputType",
-                  "equals": "number",
-                  "type": "number"
-                }
-              ]
+              "name": "_payload",
+              "type": "object",
+              "required": false
             }
           ]
         },
@@ -13809,6 +13870,7 @@
     "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 — 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>",
@@ -13934,7 +13996,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -14029,7 +14094,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -17386,6 +17454,7 @@
     "state-machine-view": {
       "type": "state-machine-view",
       "category": "display",
+      "sourceFile": "components/core/organisms/StateMachineView.tsx",
       "tier": "organisms",
       "family": "core",
       "description": "StateMachineView component",
@@ -17453,7 +17522,6 @@
             "function"
           ],
           "description": "Custom state node renderer — when provided, replaces the default circle nodes",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "state",
@@ -17837,6 +17905,7 @@
     "calendar-grid": {
       "type": "calendar-grid",
       "category": "display",
+      "sourceFile": "components/core/molecules/CalendarGrid.tsx",
       "tier": "molecules",
       "family": "core",
       "description": "CalendarGrid component",
@@ -17974,7 +18043,8 @@
             "object"
           ],
           "description": "Additional payload for long-press events",
-          "payloadFor": "longPressEvent"
+          "payloadFor": "longPressEvent",
+          "eventPayloadBrand": true
         },
         "swipeLeftEvent": {
           "types": [
@@ -18036,7 +18106,6 @@
             "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",
@@ -18054,7 +18123,6 @@
             "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 …={@item.field}/>)` — the same contract `data-list` / `data-grid` / `carousel` already use.",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "item",
@@ -18600,6 +18668,7 @@
     "progress-dots": {
       "type": "progress-dots",
       "category": "component",
+      "sourceFile": "components/core/molecules/ProgressDots.tsx",
       "tier": "molecules",
       "family": "core",
       "description": "ProgressDots component",
@@ -18629,7 +18698,6 @@
             "function"
           ],
           "description": "Custom state resolver per dot index",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "index",
@@ -18679,6 +18747,7 @@
       "family": "core",
       "description": "DataGrid — 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",
@@ -19085,7 +19154,6 @@
             "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",
@@ -19103,7 +19171,6 @@
             "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 …={@item.field}/>), binding per-item fields via @item.field.",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "item",
@@ -19136,6 +19203,48 @@
             "card-rows"
           ],
           "default": "dense"
+        },
+        "relationsData": {
+          "types": [
+            "object"
+          ],
+          "description": "Relation display data: { fieldName: [{value, label}] } — 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"
+              ]
+            }
+          }
         }
       }
     },
@@ -19146,6 +19255,7 @@
       "tier": "molecules",
       "family": "core",
       "description": "DataList component",
+      "fieldsContract": "display",
       "suggestedFor": [
         "data",
         "list",
@@ -19629,7 +19739,6 @@
             "function"
           ],
           "description": "Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored.",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "item",
@@ -19647,7 +19756,6 @@
             "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 …={@item.field}/>), binding per-item fields via @item.field.",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "item",
@@ -19696,6 +19804,48 @@
             "card-rows"
           ],
           "default": "dense"
+        },
+        "relationsData": {
+          "types": [
+            "object"
+          ],
+          "description": "Relation display data: { fieldName: [{value, label}] } — 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"
+              ]
+            }
+          }
         }
       }
     },
@@ -20006,6 +20156,7 @@
     "range-slider": {
       "type": "range-slider",
       "category": "component",
+      "sourceFile": "components/core/atoms/RangeSlider.tsx",
       "tier": "atoms",
       "family": "core",
       "description": "RangeSlider component",
@@ -20108,7 +20259,8 @@
             "object"
           ],
           "description": "Payload to include with the action event",
-          "payloadFor": "action"
+          "payloadFor": "action",
+          "eventPayloadBrand": true
         },
         "onChange": {
           "types": [
@@ -20128,7 +20280,6 @@
             "function"
           ],
           "description": "Format function for tooltip display",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "value",
@@ -20978,7 +21129,6 @@
             "function"
           ],
           "description": "Render function for each slide. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "item",
@@ -21018,7 +21168,6 @@
             "function"
           ],
           "description": "Children-as-function fallback for renderItem (compiler compatibility)",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "item",
@@ -21176,6 +21325,7 @@
     "sortable-list": {
       "type": "sortable-list",
       "category": "display",
+      "sourceFile": "components/core/molecules/SortableList.tsx",
       "tier": "molecules",
       "family": "core",
       "description": "SortableList — a drag-and-drop reorderable list of items.",
@@ -21203,7 +21353,6 @@
           ],
           "description": "Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
           "required": true,
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "item",
@@ -21247,7 +21396,8 @@
             "object"
           ],
           "description": "reorderPayload prop",
-          "payloadFor": "reorderEvent"
+          "payloadFor": "reorderEvent",
+          "eventPayloadBrand": true
         },
         "dragHandlePosition": {
           "types": [
@@ -28297,6 +28447,7 @@
     "choice-button": {
       "type": "choice-button",
       "category": "game",
+      "sourceFile": "components/game/atoms/ChoiceButton.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "ChoiceButton component",
@@ -28386,7 +28537,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -28476,6 +28630,7 @@
     "control-button": {
       "type": "control-button",
       "category": "game",
+      "sourceFile": "components/game/atoms/ControlButton.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "ControlButton component",
@@ -28551,7 +28706,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -28668,6 +28826,7 @@
     "dialogue-bubble": {
       "type": "dialogue-bubble",
       "category": "game",
+      "sourceFile": "components/game/atoms/DialogueBubble.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "DialogueBubble component",
@@ -28758,7 +28917,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -28829,6 +28991,7 @@
     "health-bar": {
       "type": "health-bar",
       "category": "game",
+      "sourceFile": "components/game/atoms/HealthBar.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "HealthBar component",
@@ -28977,7 +29140,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -29072,7 +29238,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -29107,6 +29276,7 @@
     "score-display": {
       "type": "score-display",
       "category": "game",
+      "sourceFile": "components/game/atoms/ScoreDisplay.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "ScoreDisplay component",
@@ -29182,7 +29352,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -29269,6 +29442,7 @@
     "timer-display": {
       "type": "timer-display",
       "category": "game",
+      "sourceFile": "components/game/atoms/TimerDisplay.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "TimerDisplay component",
@@ -29395,7 +29569,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -30704,6 +30881,7 @@
     "doc-search": {
       "type": "doc-search",
       "category": "filter",
+      "sourceFile": "components/core/molecules/DocSearch.tsx",
       "tier": "molecules",
       "family": "core",
       "description": "DocSearch component",
@@ -30725,7 +30903,6 @@
             "function"
           ],
           "description": "Callback invoked with the search query, returns results",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "query",
@@ -31665,6 +31842,7 @@
     "game-hud": {
       "type": "game-hud",
       "category": "game",
+      "sourceFile": "components/game/molecules/GameHud.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "GameHud component",
@@ -31755,7 +31933,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -31849,7 +32030,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -32006,7 +32190,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -32100,7 +32287,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -32289,7 +32479,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -32636,7 +32829,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -32677,6 +32873,7 @@
     "stat-badge": {
       "type": "stat-badge",
       "category": "game",
+      "sourceFile": "components/game/molecules/StatBadge.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "StatBadge component",
@@ -32752,7 +32949,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -32847,7 +33047,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -33373,6 +33576,7 @@
     "game-audio-toggle": {
       "type": "game-audio-toggle",
       "category": "game",
+      "sourceFile": "components/game/atoms/GameAudioToggle.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "GameAudioToggle component",
@@ -33504,7 +33708,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -33599,7 +33806,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -33648,6 +33858,7 @@
     "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",
@@ -33760,7 +33971,10 @@
                     "1:1",
                     "16:9",
                     "5:7",
-                    "8:1"
+                    "8:1",
+                    "4:1",
+                    "5:3",
+                    "1:2"
                   ]
                 },
                 "atlas": {
@@ -34003,7 +34217,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -34180,7 +34397,10 @@
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       "atlas": {
@@ -34406,7 +34626,10 @@
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       "atlas": {
@@ -34601,6 +34824,7 @@
     "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.",
@@ -34711,7 +34935,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -34899,6 +35126,7 @@
     "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.",
@@ -35111,7 +35339,10 @@
                     "1:1",
                     "16:9",
                     "5:7",
-                    "8:1"
+                    "8:1",
+                    "4:1",
+                    "5:3",
+                    "1:2"
                   ]
                 },
                 "atlas": {
@@ -35274,6 +35505,7 @@
     "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.",
@@ -35384,7 +35616,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -35612,7 +35847,10 @@
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       "atlas": {
@@ -36853,6 +37091,7 @@
       "family": "core",
       "description": "TableView — 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",
@@ -37309,7 +37548,6 @@
             "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",
@@ -37327,7 +37565,6 @@
             "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 …={@item.field}/>), binding per-item fields via @item.field.",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "item",
@@ -37353,6 +37590,48 @@
             "bordered"
           ],
           "default": "dense"
+        },
+        "relationsData": {
+          "types": [
+            "object"
+          ],
+          "description": "Relation display data: { fieldName: [{value, label}] } — 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"
+              ]
+            }
+          }
         }
       }
     },
@@ -37934,6 +38213,7 @@
     "code-runner-panel": {
       "type": "code-runner-panel",
       "category": "display",
+      "sourceFile": "components/core/organisms/CodeRunnerPanel.tsx",
       "tier": "organisms",
       "family": "core",
       "description": "CodeRunnerPanel component",
@@ -37971,7 +38251,6 @@
             "function"
           ],
           "description": "Simulate executing the code. Omit to render a read-only block. Real execution is a separate future track — this callback supplies deterministic simulated output for UI feedback.",
-          "kind": "callback",
           "callbackArgs": [
             {
               "name": "code",
@@ -37998,6 +38277,7 @@
     "segment-renderer": {
       "type": "segment-renderer",
       "category": "display",
+      "sourceFile": "components/core/organisms/SegmentRenderer.tsx",
       "tier": "organisms",
       "family": "core",
       "description": "SegmentRenderer component",
@@ -38089,7 +38369,6 @@
             "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",
@@ -38107,7 +38386,6 @@
             "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",
@@ -38661,6 +38939,7 @@
     "canvas-2d": {
       "type": "canvas-2d",
       "category": "game",
+      "sourceFile": "components/game/molecules/Canvas2D.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "Canvas2D component",
@@ -38807,7 +39086,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -38902,10 +39184,12 @@
             "object"
           ],
           "description": "Maps a keydown `e.code` → the board's SEMANTIC event (device-agnostic input).",
+          "kind": "event-map",
           "mapValue": {
             "types": [
               "string"
-            ]
+            ],
+            "kind": "event"
           }
         },
         "keyUpMap": {
@@ -38913,10 +39197,12 @@
             "object"
           ],
           "description": "Maps a keyup `e.code` → the board's SEMANTIC event.",
+          "kind": "event-map",
           "mapValue": {
             "types": [
               "string"
-            ]
+            ],
+            "kind": "event"
           }
         },
         "editable": {
@@ -39119,6 +39405,7 @@
     "control-grid": {
       "type": "control-grid",
       "category": "game",
+      "sourceFile": "components/game/molecules/ControlGrid.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "ControlGrid component",
@@ -39230,7 +39517,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -39373,10 +39663,12 @@
             "object"
           ],
           "description": "Per-direction PRESS → 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": {
@@ -39384,10 +39676,12 @@
             "object"
           ],
           "description": "Per-direction RELEASE → semantic event, e.g. `{ left: \"STOP\", right: \"STOP\" }`. Omit a direction to ignore its release.",
+          "kind": "event-map",
           "mapValue": {
             "types": [
               "string"
-            ]
+            ],
+            "kind": "event"
           }
         },
         "directionAssets": {
@@ -39459,7 +39753,10 @@
                   "1:1",
                   "16:9",
                   "5:7",
-                  "8:1"
+                  "8:1",
+                  "4:1",
+                  "5:3",
+                  "1:2"
                 ]
               },
               "atlas": {
@@ -39530,6 +39827,7 @@
     "game-icon": {
       "type": "game-icon",
       "category": "game",
+      "sourceFile": "components/core/atoms/GameIcon.tsx",
       "tier": "atoms",
       "family": "core",
       "description": "GameIcon component",
@@ -39605,7 +39903,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -43329,6 +43630,7 @@
     "math-canvas": {
       "type": "math-canvas",
       "category": "learning",
+      "sourceFile": "components/learning/molecules/MathCanvas.tsx",
       "tier": "molecules",
       "family": "learning",
       "description": "MathCanvas component",
@@ -44360,10 +44662,12 @@
             "object"
           ],
           "description": "Maps a keydown `e.code` → the board's SEMANTIC event (device-agnostic input), emitted as `UI:{event}` — same contract as the game canvas keyMap.",
+          "kind": "event-map",
           "mapValue": {
             "types": [
               "string"
-            ]
+            ],
+            "kind": "event"
           }
         },
         "keyUpMap": {
@@ -44371,10 +44675,12 @@
             "object"
           ],
           "description": "Maps a keyup `e.code` → the board's SEMANTIC event.",
+          "kind": "event-map",
           "mapValue": {
             "types": [
               "string"
-            ]
+            ],
+            "kind": "event"
           }
         },
         "isLoading": {
@@ -47903,6 +48209,7 @@
     "draw-sprite": {
       "type": "draw-sprite",
       "category": "game",
+      "sourceFile": "components/game/atoms/DrawSprite.tsx",
       "tier": "atoms",
       "family": "game",
       "description": "DrawSprite component",
@@ -48024,7 +48331,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -49008,6 +49318,7 @@
     "draw-sprite-layer": {
       "type": "draw-sprite-layer",
       "category": "game",
+      "sourceFile": "components/game/molecules/DrawSpriteLayer.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "DrawSpriteLayer component",
@@ -49150,7 +49461,10 @@
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   "atlas": {
@@ -49456,6 +49770,7 @@
     "canvas": {
       "type": "canvas",
       "category": "game",
+      "sourceFile": "components/game/molecules/Canvas.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "Canvas component",
@@ -49695,7 +50010,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -50112,10 +50430,12 @@
             "object"
           ],
           "description": "keyMap prop",
+          "kind": "event-map",
           "mapValue": {
             "types": [
               "string"
-            ]
+            ],
+            "kind": "event"
           }
         },
         "keyUpMap": {
@@ -50123,10 +50443,12 @@
             "object"
           ],
           "description": "keyUpMap prop",
+          "kind": "event-map",
           "mapValue": {
             "types": [
               "string"
-            ]
+            ],
+            "kind": "event"
           }
         },
         "editable": {
@@ -52128,6 +52450,7 @@
     "draw-fx-layer": {
       "type": "draw-fx-layer",
       "category": "game",
+      "sourceFile": "components/game/molecules/DrawFxLayer.tsx",
       "tier": "molecules",
       "family": "game",
       "description": "DrawFxLayer component",
@@ -52503,7 +52826,10 @@
                   "1:1",
                   "16:9",
                   "5:7",
-                  "8:1"
+                  "8:1",
+                  "4:1",
+                  "5:3",
+                  "1:2"
                 ]
               },
               "atlas": {
@@ -53921,7 +54247,10 @@
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             "atlas": {
@@ -54053,7 +54382,7 @@
           "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": [
@@ -54136,6 +54465,12 @@
             "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"