@almadar/core 10.28.0 → 10.29.0

package/dist/patterns/index.js

@@ -1,7 +1,7 @@
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-09T14:00:32.936Z",
+  exportedAt: "2026-07-13T15:27:57.365Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -10350,6 +10350,144 @@ var patterns_registry_default = {
       ],
       typicalSize: "medium",
       propsSchema: {
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        },
+        placeholder: {
+          types: [
+            "string"
+          ],
+          description: "Placeholder text"
+        },
+        value: {
+          types: [
+            "string",
+            "number"
+          ],
+          description: "Current value"
+        },
+        disabled: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether input is disabled"
+        },
+        action: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event name for trait dispatch",
+          kind: "event"
+        },
+        inputType: {
+          types: [
+            "string"
+          ],
+          description: "Input type - supports 'select' and 'textarea' in addition to standard types",
+          enumValues: [
+            "text",
+            "email",
+            "password",
+            "number",
+            "tel",
+            "url",
+            "search",
+            "date",
+            "datetime-local",
+            "time",
+            "checkbox",
+            "select",
+            "textarea"
+          ]
+        },
+        label: {
+          types: [
+            "string"
+          ],
+          description: "label prop"
+        },
+        helperText: {
+          types: [
+            "string"
+          ],
+          description: "helperText prop"
+        },
+        error: {
+          types: [
+            "string"
+          ],
+          description: "error prop"
+        },
+        leftIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "leftIcon prop"
+        },
+        rightIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "rightIcon prop"
+        },
+        clearable: {
+          types: [
+            "boolean"
+          ],
+          description: "Show clear button when input has value"
+        },
+        onClear: {
+          types: [
+            "function",
+            "string"
+          ],
+          description: "Callback or declarative event key when clear button is clicked"
+        },
+        options: {
+          types: [
+            "array"
+          ],
+          description: "Options for select type",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              value: {
+                types: [
+                  "string"
+                ]
+              },
+              label: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "value",
+              "label"
+            ]
+          }
+        },
+        rows: {
+          types: [
+            "number"
+          ],
+          description: "Rows for textarea type"
+        },
+        onChange: {
+          types: [
+            "function",
+            "string"
+          ],
+          description: "onChange handler or declarative event key for trait dispatch"
+        },
         leftAddon: {
           types: [
             "node",
@@ -10363,12 +10501,6 @@ var patterns_registry_default = {
             "icon"
           ],
           description: "Right addon (icon, button, or text)"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
         }
       }
     },
@@ -34893,7 +35025,159 @@ var patterns_registry_default = {
         "v stack"
       ],
       typicalSize: "small",
-      propsSchema: {}
+      propsSchema: {
+        gap: {
+          types: [
+            "string"
+          ],
+          description: "Gap between children",
+          enumValues: [
+            "none",
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl"
+          ],
+          default: "md"
+        },
+        align: {
+          types: [
+            "string"
+          ],
+          description: "Align items on the cross axis",
+          enumValues: [
+            "start",
+            "center",
+            "end",
+            "stretch",
+            "baseline"
+          ],
+          default: "stretch"
+        },
+        justify: {
+          types: [
+            "string"
+          ],
+          description: "Justify items on the main axis",
+          enumValues: [
+            "start",
+            "center",
+            "end",
+            "between",
+            "around",
+            "evenly"
+          ],
+          default: "start"
+        },
+        wrap: {
+          types: [
+            "boolean"
+          ],
+          description: "Allow items to wrap",
+          default: false
+        },
+        reverse: {
+          types: [
+            "boolean"
+          ],
+          description: "Reverse the order of children",
+          default: false
+        },
+        flex: {
+          types: [
+            "boolean"
+          ],
+          description: "Fill available space (flex: 1)",
+          default: false
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Custom class name"
+        },
+        style: {
+          types: [
+            "object"
+          ],
+          description: "Inline styles"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Children elements"
+        },
+        as: {
+          types: [
+            "component"
+          ],
+          description: "HTML element to render as"
+        },
+        onClick: {
+          types: [
+            "function"
+          ],
+          description: "Click handler",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "e",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        onKeyDown: {
+          types: [
+            "function"
+          ],
+          description: "Keyboard handler",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "e",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        role: {
+          types: [
+            "string"
+          ],
+          description: "Role for accessibility"
+        },
+        tabIndex: {
+          types: [
+            "number"
+          ],
+          description: "Tab index for focus management"
+        },
+        action: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          kind: "event"
+        },
+        actionPayload: {
+          types: [
+            "object"
+          ],
+          description: "Payload to include with the action event",
+          freeform: true
+        },
+        responsive: {
+          types: [
+            "boolean"
+          ],
+          description: "When true, horizontal stacks flip to vertical below the md breakpoint (768px)",
+          default: false
+        }
+      }
     },
     hstack: {
       type: "hstack",
@@ -34906,7 +35190,159 @@ var patterns_registry_default = {
         "h stack"
       ],
       typicalSize: "small",
-      propsSchema: {}
+      propsSchema: {
+        gap: {
+          types: [
+            "string"
+          ],
+          description: "Gap between children",
+          enumValues: [
+            "none",
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl"
+          ],
+          default: "md"
+        },
+        align: {
+          types: [
+            "string"
+          ],
+          description: "Align items on the cross axis",
+          enumValues: [
+            "start",
+            "center",
+            "end",
+            "stretch",
+            "baseline"
+          ],
+          default: "stretch"
+        },
+        justify: {
+          types: [
+            "string"
+          ],
+          description: "Justify items on the main axis",
+          enumValues: [
+            "start",
+            "center",
+            "end",
+            "between",
+            "around",
+            "evenly"
+          ],
+          default: "start"
+        },
+        wrap: {
+          types: [
+            "boolean"
+          ],
+          description: "Allow items to wrap",
+          default: false
+        },
+        reverse: {
+          types: [
+            "boolean"
+          ],
+          description: "Reverse the order of children",
+          default: false
+        },
+        flex: {
+          types: [
+            "boolean"
+          ],
+          description: "Fill available space (flex: 1)",
+          default: false
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Custom class name"
+        },
+        style: {
+          types: [
+            "object"
+          ],
+          description: "Inline styles"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Children elements"
+        },
+        as: {
+          types: [
+            "component"
+          ],
+          description: "HTML element to render as"
+        },
+        onClick: {
+          types: [
+            "function"
+          ],
+          description: "Click handler",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "e",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        onKeyDown: {
+          types: [
+            "function"
+          ],
+          description: "Keyboard handler",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "e",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        role: {
+          types: [
+            "string"
+          ],
+          description: "Role for accessibility"
+        },
+        tabIndex: {
+          types: [
+            "number"
+          ],
+          description: "Tab index for focus management"
+        },
+        action: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          kind: "event"
+        },
+        actionPayload: {
+          types: [
+            "object"
+          ],
+          description: "Payload to include with the action event",
+          freeform: true
+        },
+        responsive: {
+          types: [
+            "boolean"
+          ],
+          description: "When true, horizontal stacks flip to vertical below the md breakpoint (768px)",
+          default: false
+        }
+      }
     },
     "form-layout": {
       type: "form-layout",
@@ -38385,13 +38821,13 @@ var patterns_registry_default = {
           types: [
             "number"
           ],
-          description: "Draw width in px (2D) / world units (3D); omitted \u2192 resolved source width."
+          description: "Draw width in world units (fractions of `projector.tileWidth`); omitted \u2192 resolved source width in px."
         },
         height: {
           types: [
             "number"
           ],
-          description: "Draw height in px (2D) / world units (3D); omitted \u2192 resolved source height."
+          description: "Draw height in world units (fractions of `projector.tileWidth`); omitted \u2192 resolved source height in px."
         },
         frame: {
           types: [
@@ -38399,6 +38835,12 @@ var patterns_registry_default = {
           ],
           description: "Explicit atlas sub-rect override (px); omitted \u2192 resolved from `asset.atlas`/`asset.sprite`."
         },
+        animation: {
+          types: [
+            "string"
+          ],
+          description: "Named GLB animation clip to play (3D backend only; the 2D painter animates via `frame`). Matched case-insensitively against the model's clips."
+        },
         flipX: {
           types: [
             "boolean"
@@ -38876,6 +39318,11 @@ var patterns_registry_default = {
                   "object"
                 ]
               },
+              animation: {
+                types: [
+                  "string"
+                ]
+              },
               flipX: {
                 types: [
                   "boolean"
@@ -40002,7 +40449,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-09T14:00:32.936Z",
+  exportedAt: "2026-07-13T15:27:57.365Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -41357,7 +41804,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-09T14:00:32.936Z",
+  exportedAt: "2026-07-13T15:27:57.365Z",
   contracts: {
     form: {
       emits: [