@almadar/core 10.111.0 → 10.112.0

package/dist/factory/index.js

@@ -1376,6 +1376,12 @@ var patterns_registry_default = {
                 types: [
                   "function"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -1491,6 +1497,12 @@ var patterns_registry_default = {
                   "string"
                 ],
                 kind: "event"
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -1811,6 +1823,12 @@ var patterns_registry_default = {
                 types: [
                   "function"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -2308,6 +2326,12 @@ var patterns_registry_default = {
                 types: [
                   "string"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -2645,6 +2669,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -2702,6 +2732,12 @@ var patterns_registry_default = {
                 "ghost",
                 "danger"
               ]
+            },
+            when: {
+              types: [
+                "sexpr",
+                "function"
+              ]
             }
           },
           propertyRequired: [
@@ -2915,6 +2951,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",
@@ -5002,6 +5045,7 @@ var patterns_registry_default = {
       tier: "molecules",
       family: "core",
       description: "Search input with events",
+      minUsableWidth: 160,
       suggestedFor: [
         "search functionality",
         "quick filters"
@@ -7513,6 +7557,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
         }
       }
     },
@@ -7537,6 +7588,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"
@@ -7646,6 +7712,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"
@@ -15592,6 +15666,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"
@@ -18919,6 +19006,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"
@@ -20199,6 +20332,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",
@@ -20254,6 +20388,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",
@@ -20444,6 +20619,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -20707,6 +20888,7 @@ var patterns_registry_default = {
       family: "core",
       description: "DataList component",
       fieldsContract: "display",
+      minUsableWidth: 200,
       suggestedFor: [
         "data",
         "list",
@@ -20763,6 +20945,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",
@@ -20928,6 +21151,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -22952,14 +23181,19 @@ var patterns_registry_default = {
                 ],
                 eventPayloadBrand: true,
                 payloadFor: "event"
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
               "label",
               "event"
             ]
-          },
-          default: []
+          }
         },
         rightActions: {
           types: [
@@ -23007,14 +23241,19 @@ var patterns_registry_default = {
                 ],
                 eventPayloadBrand: true,
                 payloadFor: "event"
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
               "label",
               "event"
             ]
-          },
-          default: []
+          }
         },
         threshold: {
           types: [
@@ -24051,6 +24290,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."
         }
       }
     },
@@ -34562,6 +34807,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",
@@ -34617,6 +34863,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",
@@ -34846,6 +35133,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -47929,6 +48222,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"
@@ -47969,7 +48293,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: {
@@ -51506,9 +51830,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: [
@@ -52758,14 +53083,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: {
@@ -53189,6 +53515,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"