@almadar/core 10.91.0 → 10.93.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",
@@ -9456,6 +9498,7 @@ var patterns_registry_default = {
     textarea: {
       type: "textarea",
       category: "component",
+      sourceFile: "components/core/atoms/Textarea.tsx",
       tier: "atoms",
       family: "core",
       description: "Multi-line text input",
@@ -9488,7 +9531,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Declarative event name for trait dispatch",
+          description: "Declarative event: fires on \u2318/Ctrl+Enter with `{ value }`.",
           kind: "event"
         },
         error: {
@@ -10673,6 +10716,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 +10780,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 +18375,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 +18443,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 +18826,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 +18964,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Additional payload for long-press events",
-          payloadFor: "longPressEvent"
+          payloadFor: "longPressEvent",
+          eventPayloadBrand: true
         },
         swipeLeftEvent: {
           types: [
@@ -18982,7 +19027,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 +19044,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 +19589,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 +19619,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Custom state resolver per dot index",
-          kind: "callback",
           callbackArgs: [
             {
               name: "index",
@@ -19625,6 +19668,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 +20075,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 +20092,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 +20124,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 +20176,7 @@ var patterns_registry_default = {
       tier: "molecules",
       family: "core",
       description: "DataList component",
+      fieldsContract: "display",
       suggestedFor: [
         "data",
         "list",
@@ -20575,7 +20660,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 +20677,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 +20725,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 +21077,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 +21180,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         onChange: {
           types: [
@@ -21074,7 +21201,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Format function for tooltip display",
-          kind: "callback",
           callbackArgs: [
             {
               name: "value",
@@ -21924,7 +22050,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 +22089,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Children-as-function fallback for renderItem (compiler compatibility)",
-          kind: "callback",
           callbackArgs: [
             {
               name: "item",
@@ -22122,6 +22246,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 +22274,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 +22317,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "reorderPayload prop",
-          payloadFor: "reorderEvent"
+          payloadFor: "reorderEvent",
+          eventPayloadBrand: true
         },
         dragHandlePosition: {
           types: [
@@ -31677,6 +31802,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 +31824,6 @@ var patterns_registry_default = {
             "function"
           ],
           description: "Callback invoked with the search query, returns results",
-          kind: "callback",
           callbackArgs: [
             {
               name: "query",
@@ -37887,6 +38012,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 +38469,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 +38486,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 +38511,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 +39134,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 +39172,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 +39198,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 +39290,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 +39307,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",
@@ -39939,22 +40104,26 @@ var patterns_registry_default = {
           types: [
             "object"
           ],
-          description: "Maps a keydown `e.code` \u2192 the board's SEMANTIC event (device-agnostic input).",
+          description: "Maps a keydown `e.code` \u2014 optionally prefixed `Mod+` (\u2318/Ctrl), `Shift+`, `Alt+` in that order \u2014 to the board's SEMANTIC event (device-agnostic input), emitted as `UI:{event}`; keystrokes inside inputs/textareas never route.",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         keyUpMap: {
           types: [
             "object"
           ],
-          description: "Maps a keyup `e.code` \u2192 the board's SEMANTIC event.",
+          description: "Maps a keyup `e.code` \u2014 optionally prefixed `Mod+` (\u2318/Ctrl), `Shift+`, `Alt+` in that order \u2014 to the board's SEMANTIC event, emitted as `UI:{event}`; keystrokes inside inputs/textareas never route.",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         editable: {
@@ -40415,10 +40584,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 +40597,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 +44551,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",
@@ -45408,22 +45582,26 @@ var patterns_registry_default = {
           types: [
             "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.",
+          description: "Maps a keydown `e.code` \u2014 optionally prefixed `Mod+` (\u2318/Ctrl), `Shift+`, `Alt+` in that order \u2014 to the board's SEMANTIC event (device-agnostic input), emitted as `UI:{event}` \u2014 same contract as the game canvas keyMap; keystrokes inside inputs/textareas never route.",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         keyUpMap: {
           types: [
             "object"
           ],
-          description: "Maps a keyup `e.code` \u2192 the board's SEMANTIC event.",
+          description: "Maps a keyup `e.code` \u2014 optionally prefixed `Mod+` (\u2318/Ctrl), `Shift+`, `Alt+` in that order \u2014 to the board's SEMANTIC event, emitted as `UI:{event}`; keystrokes inside inputs/textareas never route.",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         isLoading: {
@@ -51172,22 +51350,26 @@ var patterns_registry_default = {
           types: [
             "object"
           ],
-          description: "keyMap prop",
+          description: "Maps a keydown `e.code` \u2014 optionally prefixed `Mod+` (\u2318/Ctrl), `Shift+`, `Alt+` in that order \u2014 to the board's SEMANTIC event (device-agnostic input), emitted as `UI:{event}`; keystrokes inside inputs/textareas never route.",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         keyUpMap: {
           types: [
             "object"
           ],
-          description: "keyUpMap prop",
+          description: "Maps a keyup `e.code` \u2014 optionally prefixed `Mod+` (\u2318/Ctrl), `Shift+`, `Alt+` in that order \u2014 to the board's SEMANTIC event, emitted as `UI:{event}`; keystrokes inside inputs/textareas never route.",
+          kind: "event-map",
           mapValue: {
             types: [
               "string"
-            ]
+            ],
+            kind: "event"
           }
         },
         editable: {
@@ -55252,6 +55434,188 @@ var patterns_registry_default = {
         }
       },
       drawable: true
+    },
+    gantt: {
+      type: "gantt",
+      category: "component",
+      sourceFile: "components/core/molecules/Gantt.tsx",
+      tier: "molecules",
+      family: "core",
+      description: "Gantt \u2014 view-only task schedule rendering rows as bars on a day axis.",
+      capabilities: "gantt chart, project timeline, schedule view, task bars, dependency arrows, roadmap, milestone plan",
+      fieldsContract: "display",
+      suggestedFor: [
+        "gantt"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        tasks: {
+          types: [
+            "object",
+            "array"
+          ],
+          description: 'Schema entity data \u2014 the task rows to place on the axis. pattern-sync tags it `kind:"entity", cardinality:"collection"` so consumers bind the domain entity without name-matching the prop.',
+          kind: "entity",
+          cardinality: "collection",
+          default: []
+        },
+        links: {
+          types: [
+            "array"
+          ],
+          description: "Dependency arrows between task ids",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              from: {
+                types: [
+                  "string"
+                ]
+              },
+              to: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "from",
+              "to"
+            ]
+          },
+          default: []
+        },
+        titleField: {
+          types: [
+            "string"
+          ],
+          description: "Row field holding the bar label. Defaults to `title`.",
+          default: "title"
+        },
+        startField: {
+          types: [
+            "string"
+          ],
+          description: "Row field holding the start timestamp (ISO or epoch). Defaults to `start`.",
+          default: "start"
+        },
+        endField: {
+          types: [
+            "string"
+          ],
+          description: "Row field holding the end timestamp (ISO or epoch). Defaults to `end`. When absent, `durationField` (days) is used instead.",
+          default: "end"
+        },
+        durationField: {
+          types: [
+            "string"
+          ],
+          description: "Row field holding the task length in days, used when the row has no end."
+        },
+        statusField: {
+          types: [
+            "string"
+          ],
+          description: "Row field holding the bar status (drives bar colour). Defaults to `status`.",
+          default: "status"
+        },
+        groupField: {
+          types: [
+            "string"
+          ],
+          description: "Row field rows are grouped under header rows by. Empty (default) = flat list.",
+          default: ""
+        },
+        rangeStart: {
+          types: [
+            "string",
+            "date"
+          ],
+          description: "First visible day (ISO or Date). Defaults to 2 days before the earliest task."
+        },
+        rangeEnd: {
+          types: [
+            "string",
+            "date"
+          ],
+          description: "Last visible day (ISO or Date). Defaults to 2 days after the latest task end."
+        },
+        showToday: {
+          types: [
+            "boolean"
+          ],
+          description: "Paint the today marker line when today falls inside the range (default true).",
+          default: true
+        },
+        dayWidth: {
+          types: [
+            "number"
+          ],
+          description: "Pixels per day on the axis (default 28)",
+          default: 28
+        },
+        barClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event emitted when a bar is clicked: UI:{barClickEvent} with { id }",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "id",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state",
+          default: false
+        },
+        error: {
+          types: [
+            "object"
+          ],
+          description: "Error state",
+          properties: {
+            message: {
+              types: [
+                "string"
+              ]
+            },
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            code: {
+              types: [
+                "string"
+              ]
+            },
+            stack: {
+              types: [
+                "string"
+              ]
+            }
+          },
+          propertyRequired: [
+            "message"
+          ],
+          default: null
+        }
+      }
     }
   }};
 var JsonValueSchema = z.lazy(