@almadar/patterns 2.17.2 → 2.18.2

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-04-22T03:26:00.903Z",
+  exportedAt: "2026-04-25T12:02:50.943Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -700,12 +700,6 @@ var patterns_registry_default = {
           ],
           description: "Panel width (CSS value, e.g., '400px', '50%')"
         },
-        entityId: {
-          types: [
-            "string"
-          ],
-          description: "Entity ID for fetching specific entity"
-        },
         displayFields: {
           types: [
             "array"
@@ -896,11 +890,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Form mode - 'create' for new records, 'edit' for updating existing",
-          enumValues: [
-            "create",
-            "edit"
-          ]
+          description: "Form mode \u2014 'create' for new records, 'edit' for updating existing. Accepts `string` so schema-driven callers (whose `config.mode` is typed as `string` per the trait's declared config block) compile cleanly. The runtime treats anything other than 'edit' as 'create'."
         },
         fields: {
           types: [
@@ -966,12 +956,6 @@ var patterns_registry_default = {
           description: "Event to dispatch on cancel (defaults to 'CANCEL')",
           kind: "event"
         },
-        entityId: {
-          types: [
-            "string"
-          ],
-          description: "Entity ID binding for edit mode (triggers initialData from selectedEntity in compiled code)"
-        },
         relationsData: {
           types: [
             "object"
@@ -1106,11 +1090,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Form mode - 'create' for new records, 'edit' for updating existing",
-          enumValues: [
-            "create",
-            "edit"
-          ]
+          description: "Form mode \u2014 'create' for new records, 'edit' for updating existing. Accepts `string` so schema-driven callers (whose `config.mode` is typed as `string` per the trait's declared config block) compile cleanly. The runtime treats anything other than 'edit' as 'create'."
         },
         fields: {
           types: [
@@ -1176,12 +1156,6 @@ var patterns_registry_default = {
           description: "Event to dispatch on cancel (defaults to 'CANCEL')",
           kind: "event"
         },
-        entityId: {
-          types: [
-            "string"
-          ],
-          description: "Entity ID binding for edit mode (triggers initialData from selectedEntity in compiled code)"
-        },
         relationsData: {
           types: [
             "object"
@@ -2110,188 +2084,36 @@ var patterns_registry_default = {
       ],
       typicalSize: "small",
       propsSchema: {
-        entity: {
-          types: [
-            "string"
-          ],
-          description: "Entity name for schema-driven integration"
-        },
-        data: {
-          types: [
-            "array"
-          ],
-          description: "Data array provided by the trait via render-ui"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        },
-        isLoading: {
-          types: [
-            "boolean"
-          ],
-          description: "Loading state indicator"
-        },
-        error: {
-          types: [
-            "object"
-          ],
-          description: "Error state"
-        },
-        sortBy: {
-          types: [
-            "string"
-          ],
-          description: "Current sort field"
-        },
-        sortDirection: {
-          types: [
-            "string"
-          ],
-          description: "Current sort direction"
-        },
-        searchValue: {
+        value: {
           types: [
             "string"
           ],
-          description: "Current search query value"
-        },
-        page: {
-          types: [
-            "number"
-          ],
-          description: "Current page number"
-        },
-        pageSize: {
-          types: [
-            "number"
-          ],
-          description: "Number of items per page"
-        },
-        totalCount: {
-          types: [
-            "number"
-          ],
-          description: "Total number of items"
-        },
-        activeFilters: {
-          types: [
-            "object"
-          ],
-          description: "Active filters"
-        },
-        selectedIds: {
-          types: [
-            "array"
-          ],
-          description: "Currently selected item IDs"
+          description: "The stat value to display prominently",
+          required: true
         },
         label: {
           types: [
             "string"
           ],
-          description: "Main label"
-        },
-        title: {
-          types: [
-            "string"
-          ],
-          description: "Title (alias for label)"
-        },
-        value: {
-          types: [
-            "string",
-            "number",
-            "array",
-            "unknown"
-          ],
-          description: "Primary value - accepts array/unknown from generated code (will use first element or length)"
-        },
-        previousValue: {
-          types: [
-            "number"
-          ],
-          description: "Previous value for comparison"
-        },
-        currentValue: {
-          types: [
-            "number"
-          ],
-          description: "Current value as number for trend calculation"
-        },
-        trend: {
-          types: [
-            "number"
-          ],
-          description: "Manual trend percentage (overrides calculation)"
+          description: "Label describing the value",
+          required: true
         },
-        trendDirection: {
+        size: {
           types: [
             "string"
           ],
-          description: "Trend direction (overrides calculation)",
+          description: "Size of the value text",
           enumValues: [
-            "up",
-            "down",
-            "neutral"
+            "sm",
+            "md",
+            "lg"
           ]
         },
-        invertTrend: {
-          types: [
-            "boolean"
-          ],
-          description: "Whether up is good (green) or bad (red)"
-        },
-        icon: {
-          types: [
-            "icon",
-            "string"
-          ],
-          description: "Icon to display (Lucide component or icon name string)"
-        },
-        iconBg: {
-          types: [
-            "string"
-          ],
-          description: "Icon background color"
-        },
-        iconColor: {
-          types: [
-            "string"
-          ],
-          description: "Icon color"
-        },
-        subtitle: {
+        className: {
           types: [
             "string"
           ],
-          description: "Subtitle or description"
-        },
-        action: {
-          types: [
-            "object"
-          ],
-          description: "Action button"
-        },
-        metrics: {
-          types: [
-            "array"
-          ],
-          description: "Metrics to display (schema format) - accepts readonly for compatibility with generated const arrays"
-        },
-        compact: {
-          types: [
-            "boolean"
-          ],
-          description: "Compact display mode"
-        },
-        sparklineData: {
-          types: [
-            "array"
-          ],
-          description: "Sparkline data points for an inline trend chart"
+          description: "Additional class names"
         }
       }
     },
@@ -4108,90 +3930,53 @@ var patterns_registry_default = {
       ],
       typicalSize: "small",
       propsSchema: {
-        title: {
-          types: [
-            "string"
-          ],
-          description: "Card title"
-        },
-        subtitle: {
-          types: [
-            "string"
-          ],
-          description: "Card subtitle or description"
-        },
-        image: {
+        variant: {
           types: [
             "string"
           ],
-          description: "Image URL to display at top of card"
-        },
-        actions: {
-          types: [
-            "array"
-          ],
-          description: "Action buttons to display in card footer"
-        },
-        children: {
-          types: [
-            "node"
-          ],
-          description: "Card content"
-        },
-        onClick: {
-          types: [
-            "function"
-          ],
-          description: "Click handler for the entire card"
+          description: "variant prop",
+          enumValues: [
+            "default",
+            "bordered",
+            "elevated",
+            "interactive"
+          ]
         },
-        className: {
+        padding: {
           types: [
             "string"
           ],
-          description: "Additional CSS classes"
+          description: "padding prop",
+          enumValues: [
+            "none",
+            "sm",
+            "md",
+            "lg"
+          ]
         },
-        action: {
+        title: {
           types: [
             "string"
           ],
-          description: "Declarative event name \u2014 emits UI:{action} via eventBus on card click",
-          kind: "event"
+          description: "Card title - renders in header if provided"
         },
-        isSelected: {
-          types: [
-            "boolean"
-          ],
-          description: "Whether the card is selected (highlighted state)"
-        },
-        name: {
+        subtitle: {
           types: [
             "string"
           ],
-          description: "Card name (alias for title)"
-        },
-        level: {
-          types: [
-            "number"
-          ],
-          description: "Level indicator"
+          description: "Card subtitle - renders below title"
         },
-        maxLevel: {
-          types: [
-            "number"
-          ],
-          description: "Maximum level"
-        },
-        longPressEvent: {
+        shadow: {
           types: [
             "string"
           ],
-          description: "Event emitted on long press: UI:{longPressEvent}"
-        },
-        longPressPayload: {
-          types: [
-            "object"
-          ],
-          description: "Additional payload for long-press events"
+          description: "Shadow size override",
+          enumValues: [
+            "none",
+            "sm",
+            "md",
+            "lg"
+          ]
         }
       }
     },
@@ -6352,34 +6137,41 @@ var patterns_registry_default = {
       typicalSize: "medium",
       propsSchema: {
         action: {
+          types: [
+            "string"
+          ],
+          description: 'Declarative event name. When set, clicking the FAB emits `UI:{action}` via the event bus and (if also provided) calls `onClick`. Mirrors the Button atom\'s `action` prop so schemas can write `{ type: "floating-action-button", action: "INIT" }` uniformly.',
+          kind: "event"
+        },
+        actionPayload: {
           types: [
             "object"
           ],
-          description: "Single action (if only one action, button will directly trigger onClick)"
+          description: "Payload to include with the dispatched action event."
         },
         actions: {
           types: [
             "array"
           ],
-          description: "Multiple actions (if provided, button will expand to show all actions)"
+          description: "Multiple actions. When provided, the button expands to show all of them."
         },
         icon: {
           types: [
             "string"
           ],
-          description: "Icon name (simplified API for pattern compatibility)"
+          description: "Icon name (resolves to a Lucide icon by PascalCase / kebab-case lookup)."
         },
         onClick: {
           types: [
             "function"
           ],
-          description: "Click handler (simplified API for pattern compatibility)"
+          description: "Optional direct click handler. Runs after the action emit when both are present."
         },
         variant: {
           types: [
             "string"
           ],
-          description: "Variant (simplified API for pattern compatibility)",
+          description: "Visual variant.",
           enumValues: [
             "primary",
             "secondary",
@@ -6388,6 +6180,12 @@ var patterns_registry_default = {
             "warning"
           ]
         },
+        label: {
+          types: [
+            "string"
+          ],
+          description: "Optional label shown via `aria-label` (visually hidden in single-action mode; rendered as a tooltip beside expanded actions in multi-action mode)."
+        },
         position: {
           types: [
             "string"
@@ -7000,78 +6798,29 @@ var patterns_registry_default = {
       ],
       typicalSize: "large",
       propsSchema: {
-        label: {
-          types: [
-            "string"
-          ],
-          description: "label prop",
-          required: true
-        },
-        variant: {
-          types: [
-            "string"
-          ],
-          description: "variant prop",
-          enumValues: [
-            "primary",
-            "secondary",
-            "ghost",
-            "danger",
-            "success",
-            "warning",
-            "default"
-          ]
-        },
-        size: {
-          types: [
-            "string"
-          ],
-          description: "size prop",
-          enumValues: [
-            "sm",
-            "md",
-            "lg"
-          ]
-        },
-        disabled: {
-          types: [
-            "boolean"
-          ],
-          description: "disabled prop"
-        },
         onClick: {
           types: [
             "string"
           ],
-          description: "onClick prop"
+          description: "Legacy alias for {@link ButtonProps.action} (string event name).",
+          kind: "event"
         },
         event: {
           types: [
             "string"
           ],
-          description: "event prop"
-        },
-        icon: {
-          types: [
-            "string"
-          ],
-          description: "icon prop"
+          description: "Legacy alias for {@link ButtonProps.action}.",
+          kind: "event"
         },
         iconPosition: {
           types: [
             "string"
           ],
-          description: "iconPosition prop",
+          description: "Icon placement \u2014 maps to Button's `icon` (left) or `iconRight` (right).",
           enumValues: [
             "left",
             "right"
           ]
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "className prop"
         }
       }
     },
@@ -8880,12 +8629,6 @@ var patterns_registry_default = {
           ],
           description: "Actions"
         },
-        entity: {
-          types: [
-            "string"
-          ],
-          description: "Entity name for schema-driven auto-fetch"
-        },
         isLoading: {
           types: [
             "boolean"
@@ -13516,10 +13259,10 @@ var patterns_registry_default = {
       propsSchema: {
         entity: {
           types: [
-            "unknown",
+            "object",
             "array"
           ],
-          description: "Entity data array",
+          description: "Schema entity data \u2014 single record or collection, typed against `@almadar/core`'s `EntityRow` so the narrow type declared on the emitting trait's `Event { data : [X] }` flows through to the prop without widening. The generic `T` lets consumers pass a narrower entity (e.g. `CartItem`) and have the `children` render function receive cards typed to that exact shape.",
           required: true
         },
         fields: {
@@ -13628,7 +13371,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored."
+          description: "Render prop for custom per-card content, typed to the grid's entity shape `T`. When provided, `fields` and `itemActions` are ignored."
         },
         renderItem: {
           types: [
@@ -13657,10 +13400,10 @@ var patterns_registry_default = {
       propsSchema: {
         entity: {
           types: [
-            "unknown",
+            "object",
             "array"
           ],
-          description: "Entity data array",
+          description: "Schema entity data \u2014 single record or collection, typed against `@almadar/core`'s `EntityRow` so the narrow type declared on the emitting trait's `Event { data : [X] }` flows through to the prop without widening. The generic `T` lets consumers pass a narrower entity (e.g. `CartItem`) and have the `children` render function receive items of that exact shape.",
           required: true
         },
         fields: {
@@ -14557,23 +14300,29 @@ var patterns_registry_default = {
       propsSchema: {
         value: {
           types: [
+            "number",
             "string"
           ],
-          description: 'Target value to count to (e.g. "500+", "99.9%", "3x")',
+          description: 'The target value to animate to. Strings are parsed numerically (e.g. "500", "99.9").',
           required: true
         },
-        label: {
+        duration: {
+          types: [
+            "number"
+          ],
+          description: "Animation duration in milliseconds"
+        },
+        prefix: {
           types: [
             "string"
           ],
-          description: "Label displayed below the number",
-          required: true
+          description: "Text to display before the number"
         },
-        duration: {
+        suffix: {
           types: [
-            "number"
+            "string"
           ],
-          description: "Animation duration in ms"
+          description: "Text to display after the number"
         },
         className: {
           types: [
@@ -24724,7 +24473,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-04-22T03:26:00.903Z",
+  exportedAt: "2026-04-25T12:02:50.943Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -26535,7 +26284,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-04-22T03:26:00.903Z",
+  exportedAt: "2026-04-25T12:02:50.943Z",
   contracts: {
     form: {
       emits: [
@@ -27065,7 +26814,7 @@ var event_contracts_default = {
     stats: {
       emits: [],
       requires: [],
-      entityAware: true
+      entityAware: false
     },
     card: {
       emits: [
@@ -27844,132 +27593,382 @@ var event_contracts_default = {
       ],
       requires: [],
       entityAware: false
+    },
+    "ui-slot-renderer": {
+      emits: [
+        {
+          event: "CLOSE",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "CANCEL",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: true
     }
   }
 };
 
 // src/pattern-types.ts
 var PATTERN_TYPES = [
+  "about-page-template",
   "accordion",
+  "action-button",
   "action-buttons",
+  "action-palette",
+  "action-tile",
   "alert",
+  "animated-counter",
+  "animated-graphic",
+  "animated-reveal",
+  "article-section",
   "auth-layout",
   "avatar",
+  "avl-3d-application-scene",
+  "avl-3d-cross-wire",
+  "avl-3d-effects",
+  "avl-3d-entity-core",
+  "avl-3d-expr-tree",
+  "avl-3d-label",
+  "avl-3d-orbital-node",
+  "avl-3d-orbital-scene",
+  "avl-3d-state-node",
+  "avl-3d-tooltip",
+  "avl-3d-trait-scene",
+  "avl-3d-transition-arc",
+  "avl-3d-transition-scene",
+  "avl-3d-viewer",
+  "avl-application",
+  "avl-behavior-glyph",
+  "avl-binding",
+  "avl-binding-ref",
+  "avl-click-target",
+  "avl-closed-circuit",
+  "avl-cosmic-zoom",
+  "avl-effect",
+  "avl-emit-listen",
+  "avl-entity",
+  "avl-event",
+  "avl-expr-tree",
+  "avl-field",
+  "avl-field-type",
+  "avl-guard",
+  "avl-legend",
+  "avl-literal",
+  "avl-operator",
+  "avl-orbital",
+  "avl-orbital-unit",
+  "avl-orbitals-cosmic-zoom",
+  "avl-page",
+  "avl-persistence",
+  "avl-s-expr",
+  "avl-slot-map",
+  "avl-state",
+  "avl-state-machine",
+  "avl-swim-lane",
+  "avl-trait",
+  "avl-trait-scene",
+  "avl-transition",
+  "avl-transition-lane",
+  "avl-transition-scene",
   "badge",
+  "battle-board",
   "battle-template",
+  "behavior-view",
+  "book-chapter-view",
+  "book-cover-page",
+  "book-nav-bar",
+  "book-table-of-contents",
+  "book-viewer",
   "box",
   "breadcrumb",
+  "builder-board",
   "button",
   "button-pattern",
+  "calendar-grid",
+  "camera-3d",
+  "canvas-3d-error-boundary",
+  "canvas-3d-loading-state",
   "canvas-effect",
   "card",
+  "carousel",
+  "case-study-card",
+  "case-study-organism",
+  "castle-board",
   "castle-template",
   "center",
   "chart",
+  "chart-legend",
   "checkbox",
+  "choice-button",
+  "classifier-board",
+  "code-block",
+  "code-example",
+  "code-view",
   "code-viewer",
+  "collapsible-section",
+  "combat-log",
+  "combo-counter",
+  "community-links",
   "conditional-wrapper",
+  "confetti-effect",
   "confirm-dialog",
   "container",
+  "content-renderer",
+  "content-section",
   "control-button",
   "counter-template",
-  "crud-template",
+  "crafting-recipe",
+  "cta-banner",
   "custom-pattern",
   "d-pad",
+  "damage-number",
   "dashboard-grid",
   "dashboard-layout",
+  "data-grid",
+  "data-list",
+  "date-range-selector",
+  "day-cell",
+  "debugger-board",
   "detail-panel",
+  "detail-view",
   "dialogue-box",
+  "dialogue-bubble",
   "divider",
+  "doc-breadcrumb",
+  "doc-code-block",
+  "doc-pagination",
+  "doc-search",
+  "doc-sidebar",
+  "doc-toc",
   "document-viewer",
   "drawer",
   "drawer-slot",
+  "edge-decoration",
   "empty-state",
+  "enemy-plate",
   "entity-cards",
   "entity-list",
   "entity-table",
+  "error-boundary",
   "error-state",
+  "event-handler-board",
+  "event-log",
+  "feature-card",
+  "feature-detail-page-template",
+  "feature-grid",
+  "feature-grid-organism",
+  "feature-renderer",
+  "feature-renderer-3d",
+  "file-tree",
   "filter-group",
   "flex",
+  "flip-card",
+  "flip-container",
   "floating-action-button",
+  "flow-canvas",
   "form",
   "form-actions",
   "form-field",
   "form-section",
   "form-section-header",
-  "form-template",
+  "game-audio-provider",
+  "game-audio-toggle",
+  "game-canvas-2d",
+  "game-canvas-3d",
+  "game-canvas-3d-battle-template",
+  "game-canvas-3d-castle-template",
+  "game-canvas-3d-world-map-template",
   "game-hud",
   "game-menu",
   "game-over-screen",
   "game-shell",
   "game-template",
   "generic-app-template",
+  "geometric-pattern",
+  "gradient-divider",
   "graph-canvas",
+  "graph-view",
   "grid",
   "header",
+  "heading",
   "health-bar",
+  "health-panel",
+  "hero-organism",
+  "hero-section",
   "icon",
+  "infinite-scroll-sentinel",
   "input",
   "input-group",
+  "install-box",
+  "inventory-grid",
   "inventory-panel",
   "isometric-canvas",
+  "item-slot",
+  "jazari-state-machine",
   "label",
+  "landing-page-template",
   "law-reference-tooltip",
   "layout-pattern",
-  "list-template",
+  "lightbox",
+  "lighting-3d",
+  "line-chart",
   "loading-state",
+  "map-view",
+  "markdown-content",
+  "marketing-footer",
   "master-detail",
   "media-gallery",
   "menu",
   "meter",
+  "mini-map",
+  "mini-state-machine",
   "modal",
   "modal-slot",
+  "model-loader",
+  "module-card",
   "navigation",
+  "negotiator-board",
   "notification",
+  "number-stepper",
+  "object-rule-panel",
+  "orb-inspector",
   "orbital-visualization",
   "overlay",
   "page-header",
   "pagination",
+  "pattern-tile",
+  "physics-object-3d",
+  "platformer-canvas",
   "popover",
+  "powerup-slots",
+  "pricing-card",
+  "pricing-grid",
+  "pricing-organism",
+  "pricing-page-template",
   "progress-bar",
+  "progress-dots",
+  "pull-quote",
+  "pull-to-refresh",
+  "quest-tracker",
+  "quiz-block",
   "radio",
+  "range-slider",
   "relation-select",
   "repeatable-form-section",
+  "resource-bar",
+  "resource-counter",
+  "rule-editor",
   "runtime-debugger",
+  "scaled-diagram",
+  "scene-3d",
+  "score-board",
   "score-display",
   "search-input",
   "section",
+  "section-header",
   "select",
-  "settings-template",
+  "sequence-bar",
+  "sequencer-board",
+  "service-catalog",
+  "showcase-card",
+  "showcase-organism",
   "side-panel",
   "sidebar",
   "signature-pad",
   "simple-grid",
+  "simulation-canvas",
+  "simulation-controls",
+  "simulation-graph",
+  "simulator-board",
+  "skeleton",
+  "social-proof",
+  "sortable-list",
   "spacer",
   "spinner",
   "split",
   "split-pane",
+  "split-section",
   "sprite",
   "stack",
+  "star-rating",
   "stat-badge",
+  "stat-display",
+  "state-architect-board",
+  "state-indicator",
+  "state-machine-view",
+  "state-node",
   "stats",
+  "stats-grid",
+  "stats-organism",
+  "status-dot",
+  "status-effect",
+  "step-flow-organism",
+  "step-item",
+  "svg-branch",
+  "svg-connection",
+  "svg-flow",
+  "svg-grid",
+  "svg-lobe",
+  "svg-mesh",
+  "svg-morph",
+  "svg-node",
+  "svg-pulse",
+  "svg-ring",
+  "svg-shield",
+  "svg-stack",
+  "swipeable-row",
   "switch",
+  "system-node",
   "tabbed-container",
   "table",
   "tabs",
+  "tag-cloud",
+  "team-card",
+  "team-organism",
+  "text",
   "text-highlight",
   "textarea",
   "theme-toggle",
+  "tile-renderer",
+  "time-slot-cell",
   "timeline",
+  "timer-display",
   "toast-slot",
   "tooltip",
+  "trait-frame",
+  "trait-slot",
+  "trait-state-viewer",
+  "transition-arrow",
+  "trend-indicator",
+  "turn-indicator",
+  "turn-panel",
+  "typewriter-text",
   "typography",
-  "u-i-slot-renderer",
+  "ui-slot-renderer",
+  "uncontrolled-battle-board",
+  "unit-command-bar",
+  "unit-renderer",
+  "upload-drop-zone",
+  "variable-panel",
   "violation-alert",
+  "waypoint-marker",
   "wizard-container",
   "wizard-navigation",
   "wizard-progress",
-  "world-map-template"
+  "world-map-board",
+  "world-map-template",
+  "xp-bar",
+  "zoom-breadcrumb",
+  "zoom-legend"
 ];
 function isValidPatternType(type) {
   return PATTERN_TYPES.includes(type);