@almadar/core 10.91.0 → 10.92.0

package/dist/{effect-Bt8vKHwd.d.ts → effect-DGa2ixo7.d.ts}

@@ -2825,7 +2825,7 @@ type EntityData = Record<string, EntityRow[]>;
  *
  * DO NOT EDIT MANUALLY — regenerated by almadar-pattern-sync `patterns` command.
  *
- * Generated: 2026-09-12T07:27:40.309Z
+ * Generated: 2026-09-12T18:14:02.464Z
  * Pattern count: 280
  */
 
@@ -3733,6 +3733,7 @@ interface PatternPropsMap {
         renderItem?: ((...args: unknown[]) => unknown) | string | SExpr;
         pageSize?: number | string | SExpr;
         look?: string | SExpr;
+        relationsData?: PatternPropValue | string | SExpr;
     };
     'data-list': {
         type: 'data-list';
@@ -3775,6 +3776,7 @@ interface PatternPropsMap {
         sortBy?: string | SExpr;
         sortDirection?: string | SExpr;
         look?: string | SExpr;
+        relationsData?: PatternPropValue | string | SExpr;
     };
     'date-range-picker': {
         type: 'date-range-picker';
@@ -4247,6 +4249,7 @@ interface PatternPropsMap {
         headerActions?: unknown | string | SExpr;
         showTotal?: boolean | string | SExpr;
         look?: string | SExpr;
+        relationsData?: PatternPropValue | string | SExpr;
     };
     'error-boundary': {
         type: 'error-boundary';
@@ -6240,6 +6243,7 @@ interface PatternPropsMap {
         children?: ((...args: unknown[]) => unknown) | string | SExpr;
         renderItem?: ((...args: unknown[]) => unknown) | string | SExpr;
         look?: string | SExpr;
+        relationsData?: PatternPropValue | string | SExpr;
     };
     'tabs': {
         type: 'tabs';

package/dist/{entityAccess-BdDX85rM.d.ts → entityAccess-CXennIKj.d.ts}

@@ -1,4 +1,4 @@
-import { O as OrbitalSchema } from './schema-ovDTDQz9.js';
+import { O as OrbitalSchema } from './schema-DIL07Bmv.js';
 import { S as SExpr } from './expression-WfTp2arD.js';
 
 /**

package/dist/factory/index.d.ts

@@ -1,7 +1,7 @@
-import { k as FactorySignatureCatalog, h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, T as TraitOverlay, J as JsonSchema } from '../types-rh0naR6C.js';
-export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, l as FactorySignatureEntityField, m as FactoryTraitSignature, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, q as TraitOverlayEntry, r as TraitOverlayListener } from '../types-rh0naR6C.js';
-import { a as EntityPersistence, E as EntityField } from '../effect-Bt8vKHwd.js';
-import { a as TraitReference } from '../trait-C3e3btfn.js';
+import { k as FactorySignatureCatalog, h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, T as TraitOverlay, J as JsonSchema } from '../types-F5EPwMor.js';
+export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, l as FactorySignatureEntityField, m as FactoryTraitSignature, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, q as TraitOverlayEntry, r as TraitOverlayListener } from '../types-F5EPwMor.js';
+import { a as EntityPersistence, E as EntityField } from '../effect-DGa2ixo7.js';
+import { a as TraitReference } from '../trait-DHb48lyx.js';
 export { J as JsonValue } from '../json-D8gmyK3l.js';
 import 'zod';
 import '../expression-WfTp2arD.js';

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",
@@ -10673,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.",
@@ -10736,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",
@@ -18332,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",
@@ -18399,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",
@@ -18783,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",
@@ -18920,7 +18963,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Additional payload for long-press events",
-          payloadFor: "longPressEvent"
+          payloadFor: "longPressEvent",
+          eventPayloadBrand: true
         },
         swipeLeftEvent: {
           types: [
@@ -18982,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",
@@ -19000,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",
@@ -19546,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",
@@ -19575,7 +19618,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Custom state resolver per dot index",
-          kind: "callback",
           callbackArgs: [
             {
               name: "index",
@@ -19625,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",
@@ -20031,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",
@@ -20049,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",
@@ -20082,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"
+              ]
+            }
+          }
         }
       }
     },
@@ -20092,6 +20175,7 @@ var patterns_registry_default = {
       tier: "molecules",
       family: "core",
       description: "DataList component",
+      fieldsContract: "display",
       suggestedFor: [
         "data",
         "list",
@@ -20575,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",
@@ -20593,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",
@@ -20642,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"
+              ]
+            }
+          }
         }
       }
     },
@@ -20952,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",
@@ -21054,7 +21179,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         onChange: {
           types: [
@@ -21074,7 +21200,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Format function for tooltip display",
-          kind: "callback",
           callbackArgs: [
             {
               name: "value",
@@ -21924,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",
@@ -21964,7 +22088,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Children-as-function fallback for renderItem (compiler compatibility)",
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -22122,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.",
@@ -22149,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",
@@ -22193,7 +22316,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "reorderPayload prop",
-          payloadFor: "reorderEvent"
+          payloadFor: "reorderEvent",
+          eventPayloadBrand: true
         },
         dragHandlePosition: {
           types: [
@@ -31677,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",
@@ -31698,7 +31823,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Callback invoked with the search query, returns results",
-          kind: "callback",
           callbackArgs: [
             {
               name: "query",
@@ -37887,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",
@@ -38343,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",
@@ -38361,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",
@@ -38387,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"
+              ]
+            }
+          }
         }
       }
     },
@@ -38968,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",
@@ -39005,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",
@@ -39032,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",
@@ -39123,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",
@@ -39141,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",
@@ -39940,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: {
@@ -39951,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: {
@@ -40415,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: {
@@ -40426,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: {
@@ -44378,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",
@@ -45409,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: {
@@ -45420,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: {
@@ -51173,10 +51350,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: "keyMap prop",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         keyUpMap: {
@@ -51184,10 +51363,12 @@ var patterns_registry_default = {
             "object"
           ],
           description: "keyUpMap prop",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         editable: {