@almadar/core 10.111.0 → 10.112.0

package/dist/patterns/index.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-28T12:49:04.761Z",
+  exportedAt: "2026-09-30T15:57:56.420Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -284,6 +284,12 @@ var patterns_registry_default = {
                 types: [
                   "function"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -399,6 +405,12 @@ var patterns_registry_default = {
                   "string"
                 ],
                 kind: "event"
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -719,6 +731,12 @@ var patterns_registry_default = {
                 types: [
                   "function"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -1216,6 +1234,12 @@ var patterns_registry_default = {
                 types: [
                   "string"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -1553,6 +1577,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -1610,6 +1640,12 @@ var patterns_registry_default = {
                 "ghost",
                 "danger"
               ]
+            },
+            when: {
+              types: [
+                "sexpr",
+                "function"
+              ]
             }
           },
           propertyRequired: [
@@ -1823,6 +1859,13 @@ var patterns_registry_default = {
           ],
           description: "Page title - accepts string or number from generated code accessing dynamic entity data"
         },
+        icon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "Icon shown before the title."
+        },
         subtitle: {
           types: [
             "string",
@@ -3910,6 +3953,7 @@ var patterns_registry_default = {
       tier: "molecules",
       family: "core",
       description: "Search input with events",
+      minUsableWidth: 160,
       suggestedFor: [
         "search functionality",
         "quick filters"
@@ -6421,6 +6465,13 @@ var patterns_registry_default = {
             "full-screen"
           ],
           default: "centered-card"
+        },
+        contained: {
+          types: [
+            "boolean"
+          ],
+          description: "Render inside the nearest positioned ancestor (a preview frame) instead of portaling over the whole window; page scroll is left alone.",
+          default: false
         }
       }
     },
@@ -6445,6 +6496,21 @@ var patterns_registry_default = {
           description: "Whether the drawer is open (defaults to true when rendered by slot wrapper)",
           default: true
         },
+        onExited: {
+          types: [
+            "function"
+          ],
+          description: "Fires after the exit animation completes (the drawer is about to unmount).",
+          kind: "callback",
+          callbackArgs: []
+        },
+        contained: {
+          types: [
+            "boolean"
+          ],
+          description: "Render inside the nearest positioned ancestor (a preview frame) instead of over the window.",
+          default: false
+        },
         onClose: {
           types: [
             "function"
@@ -6554,6 +6620,14 @@ var patterns_registry_default = {
           kind: "callback",
           callbackArgs: []
         },
+        onExited: {
+          types: [
+            "function"
+          ],
+          description: "Fires after the exit animation completes (the dialog is about to unmount).",
+          kind: "callback",
+          callbackArgs: []
+        },
         onConfirm: {
           types: [
             "function"
@@ -14500,6 +14574,19 @@ var patterns_registry_default = {
           description: 'Format X-axis labels as time (ISO date in \u2192 "Mar 2026"-style label out)',
           default: false
         },
+        period: {
+          types: [
+            "string"
+          ],
+          description: 'Bucket granularity of a time axis \u2014 labels read "Oct 2", "Week of Sep 28", "Oct 2026", "Q4 2026" or "2026"',
+          enumValues: [
+            "day",
+            "week",
+            "month",
+            "quarter",
+            "year"
+          ]
+        },
         drillEvent: {
           types: [
             "string"
@@ -17827,6 +17914,52 @@ var patterns_registry_default = {
             }
           ]
         },
+        onTransitionClick: {
+          types: [
+            "function"
+          ],
+          description: "Direct transition-click callback, for React hosts (e.g. a canvas node).",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "transition",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  index: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  event: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  from: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  to: {
+                    types: [
+                      "string"
+                    ]
+                  }
+                },
+                required: [
+                  "index",
+                  "event",
+                  "from",
+                  "to"
+                ]
+              }
+            }
+          ]
+        },
         selectedState: {
           types: [
             "string"
@@ -19107,6 +19240,7 @@ var patterns_registry_default = {
       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",
+      minUsableWidth: 200,
       suggestedFor: [
         "data",
         "grid",
@@ -19162,6 +19296,47 @@ var patterns_registry_default = {
           ],
           description: "Mark this container as the DnD root for its subtree \u2014 descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
         },
+        emptyIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "Domain icon for the empty state."
+        },
+        emptyTitle: {
+          types: [
+            "string"
+          ],
+          description: 'Specific title ("No orders yet").'
+        },
+        emptyDescription: {
+          types: [
+            "string"
+          ],
+          description: "What will appear here once rows exist."
+        },
+        emptyAction: {
+          types: [
+            "object"
+          ],
+          description: "Create-the-first-item action.",
+          properties: {
+            label: {
+              types: [
+                "string"
+              ]
+            },
+            event: {
+              types: [
+                "string"
+              ],
+              kind: "event"
+            }
+          },
+          propertyRequired: [
+            "label"
+          ]
+        },
         entity: {
           types: [
             "object",
@@ -19352,6 +19527,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -19615,6 +19796,7 @@ var patterns_registry_default = {
       family: "core",
       description: "DataList component",
       fieldsContract: "display",
+      minUsableWidth: 200,
       suggestedFor: [
         "data",
         "list",
@@ -19671,6 +19853,47 @@ var patterns_registry_default = {
           ],
           description: "Mark this container as the DnD root for its subtree \u2014 descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
         },
+        emptyIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "Domain icon for the empty state."
+        },
+        emptyTitle: {
+          types: [
+            "string"
+          ],
+          description: 'Specific title ("No orders yet").'
+        },
+        emptyDescription: {
+          types: [
+            "string"
+          ],
+          description: "What will appear here once rows exist."
+        },
+        emptyAction: {
+          types: [
+            "object"
+          ],
+          description: "Create-the-first-item action.",
+          properties: {
+            label: {
+              types: [
+                "string"
+              ]
+            },
+            event: {
+              types: [
+                "string"
+              ],
+              kind: "event"
+            }
+          },
+          propertyRequired: [
+            "label"
+          ]
+        },
         entity: {
           types: [
             "object",
@@ -19836,6 +20059,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -21860,14 +22089,19 @@ var patterns_registry_default = {
                 ],
                 eventPayloadBrand: true,
                 payloadFor: "event"
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
               "label",
               "event"
             ]
-          },
-          default: []
+          }
         },
         rightActions: {
           types: [
@@ -21915,14 +22149,19 @@ var patterns_registry_default = {
                 ],
                 eventPayloadBrand: true,
                 payloadFor: "event"
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
               "label",
               "event"
             ]
-          },
-          default: []
+          }
         },
         threshold: {
           types: [
@@ -22959,6 +23198,12 @@ var patterns_registry_default = {
           propertyRequired: [
             "enabled"
           ]
+        },
+        pageKey: {
+          types: [
+            "string"
+          ],
+          description: "The current page (path or name). When set, the main slot's content animates in on every page change (`PageTransition`); a layout's own content region claims the transition so its chrome stays still."
         }
       }
     },
@@ -33470,6 +33715,7 @@ var patterns_registry_default = {
       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",
+      minUsableWidth: 240,
       suggestedFor: [
         "table",
         "view",
@@ -33525,6 +33771,47 @@ var patterns_registry_default = {
           ],
           description: "Mark this container as the DnD root for its subtree \u2014 descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
         },
+        emptyIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "Domain icon for the empty state."
+        },
+        emptyTitle: {
+          types: [
+            "string"
+          ],
+          description: 'Specific title ("No orders yet").'
+        },
+        emptyDescription: {
+          types: [
+            "string"
+          ],
+          description: "What will appear here once rows exist."
+        },
+        emptyAction: {
+          types: [
+            "object"
+          ],
+          description: "Create-the-first-item action.",
+          properties: {
+            label: {
+              types: [
+                "string"
+              ]
+            },
+            event: {
+              types: [
+                "string"
+              ],
+              kind: "event"
+            }
+          },
+          propertyRequired: [
+            "label"
+          ]
+        },
         entity: {
           types: [
             "object",
@@ -33754,6 +34041,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -46837,6 +47130,37 @@ var patterns_registry_default = {
       ],
       typicalSize: "small",
       propsSchema: {
+        animation: {
+          types: [
+            "string"
+          ],
+          description: "Which motion preset to use (maps to `animate-<name>-in/out`).",
+          required: true,
+          enumValues: [
+            "modal",
+            "overlay",
+            "slide-up",
+            "drawer",
+            "popover",
+            "toast",
+            "fade",
+            "page"
+          ]
+        },
+        animate: {
+          types: [
+            "boolean"
+          ],
+          description: "Per-instance opt-out. Global opt-out is `--motion-enable` / reduced-motion. @default true"
+        },
+        onExited: {
+          types: [
+            "function"
+          ],
+          description: "Fired after the exit animation completes (before unmount).",
+          kind: "callback",
+          callbackArgs: []
+        },
         show: {
           types: [
             "boolean"
@@ -46877,7 +47201,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Value that changes on navigation (e.g. `location.pathname`).",
+          description: "Value that changes on navigation (a page path).",
           required: true
         },
         children: {
@@ -50414,9 +50738,10 @@ var patterns_registry_default = {
         },
         children: {
           types: [
-            "node"
+            "node",
+            "function"
           ],
-          description: "Compiled mode: render children directly instead of resolving from context"
+          description: "Compiled mode: render children directly instead of resolving from context. A function receives the slot's presence \u2014 compiled self-overlaying content (Modal / ConfirmDialog) takes it as `isOpen`/`onExited` to play its exit."
         },
         pattern: {
           types: [
@@ -51666,14 +51991,15 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "What made this version (a user save, an agent turn, a restore, an undo/redo, a snapshot).",
+          description: "What made this version (a user save, an agent turn, a restore, an undo/redo, a snapshot, a merge of a teammate's work).",
           enumValues: [
             "user",
             "agent",
             "restore",
             "undo",
             "redo",
-            "snapshot"
+            "snapshot",
+            "merge"
           ]
         },
         additions: {
@@ -52097,6 +52423,52 @@ var patterns_registry_default = {
             }
           ]
         },
+        onTransitionClick: {
+          types: [
+            "function"
+          ],
+          description: "Direct transition-click callback, for React hosts (e.g. a canvas node).",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "transition",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  index: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  event: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  from: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  to: {
+                    types: [
+                      "string"
+                    ]
+                  }
+                },
+                required: [
+                  "index",
+                  "event",
+                  "from",
+                  "to"
+                ]
+              }
+            }
+          ]
+        },
         selectedState: {
           types: [
             "string"
@@ -56294,7 +56666,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-28T12:49:04.761Z",
+  exportedAt: "2026-09-30T15:57:56.420Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -57604,7 +57976,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-28T12:49:04.761Z",
+  exportedAt: "2026-09-30T15:57:56.420Z",
   contracts: {
     form: {
       emits: [
@@ -59487,6 +59859,13 @@ function eventListPropsOf(patternType) {
 function getPatternFieldsContract(patternType) {
   return getPatternDefinition(patternType)?.fieldsContract;
 }
+function getPatternMinUsableWidths() {
+  const out = /* @__PURE__ */ new Map();
+  for (const [name, entry] of Object.entries(patterns_registry_default.patterns ?? {})) {
+    if (typeof entry.minUsableWidth === "number") out.set(name, entry.minUsableWidth);
+  }
+  return out;
+}
 function isDrawablePattern(patternType) {
   const definition = getPatternDefinition(patternType);
   if (!definition) return false;
@@ -59526,6 +59905,6 @@ function propHostsDrawables(schema) {
   return false;
 }
 
-export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, PROP_KINDS, SELF_OVERLAY_PATTERN_TYPES, buildRecommendationContext, collectRenderUiPatternTypes, component_mapping_default as componentMapping, event_contracts_default as eventContracts, eventKeyPropsOf, eventListPropsOf, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternFieldsContract, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, isValueInputPattern, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiEntriesOf, renderUiPatternTypesOf };
+export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, PROP_KINDS, SELF_OVERLAY_PATTERN_TYPES, buildRecommendationContext, collectRenderUiPatternTypes, component_mapping_default as componentMapping, event_contracts_default as eventContracts, eventKeyPropsOf, eventListPropsOf, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternFieldsContract, getPatternMetadata, getPatternMinUsableWidths, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, isValueInputPattern, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiEntriesOf, renderUiPatternTypesOf };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map