@almadar/patterns 1.0.13 → 1.0.15

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-02-09T10:45:55.417Z",
+  exportedAt: "2026-02-10T15:35:56.769Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -230,12 +230,6 @@ var patterns_registry_default = {
           ],
           description: "Data array - primary prop for data"
         },
-        type: {
-          types: [
-            "string"
-          ],
-          description: "Entity type name for display"
-        },
         isLoading: {
           types: [
             "boolean"
@@ -338,6 +332,12 @@ var patterns_registry_default = {
             "string"
           ],
           description: 'Query singleton binding for filter/sort state. When provided, syncs with the query singleton for filtering and sorting. Example: "@TaskQuery"'
+        },
+        entityType: {
+          types: [
+            "string"
+          ],
+          description: "Entity type name for display"
         }
       }
     },
@@ -882,62 +882,188 @@ var patterns_registry_default = {
     "form-section": {
       type: "form-section",
       category: "form",
-      description: "Group of related input fields",
+      description: "Alias for form \u2014 Complete form with fields and actions",
       suggestedFor: [
         "create forms",
         "edit forms",
-        "settings"
+        "data entry"
       ],
-      typicalSize: "small",
+      typicalSize: "medium",
       propsSchema: {
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Form fields (traditional React children)"
+        },
+        onSubmit: {
+          types: [
+            "function",
+            "string"
+          ],
+          description: "Submit handler - receives form data, or event name string for trait dispatch"
+        },
+        onCancel: {
+          types: [
+            "function",
+            "string"
+          ],
+          description: "Cancel handler - function or event name string for trait dispatch"
+        },
+        layout: {
+          types: [
+            "string"
+          ],
+          description: "Form layout"
+        },
+        gap: {
+          types: [
+            "string"
+          ],
+          description: "Gap between fields"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Schema-based props"
+        },
+        mode: {
+          types: [
+            "string"
+          ],
+          description: "Form mode - 'create' for new records, 'edit' for updating existing"
+        },
+        fields: {
+          types: [
+            "unknown"
+          ],
+          description: "Fields definition (schema format) - accepts readonly for generated const arrays"
+        },
+        initialData: {
+          types: [
+            "object",
+            "unknown"
+          ],
+          description: "Initial form data"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        submitLabel: {
+          types: [
+            "string"
+          ],
+          description: "Submit button label"
+        },
+        cancelLabel: {
+          types: [
+            "string"
+          ],
+          description: "Cancel button label (if provided, shows cancel button)"
+        },
+        showCancel: {
+          types: [
+            "boolean"
+          ],
+          description: "Show cancel button (defaults to true for schema forms)"
+        },
         title: {
           types: [
             "string"
           ],
-          description: "Section title"
+          description: "Form title (used by ModalSlot to extract title)"
         },
-        description: {
+        submitEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event dispatch props (for trait state machine integration)"
+        },
+        cancelEvent: {
           types: [
             "string"
           ],
-          description: "Section description"
+          description: "Event to dispatch on cancel (defaults to 'CANCEL')"
         },
-        children: {
+        relationsData: {
           types: [
-            "node"
+            "object"
           ],
-          description: "Form fields",
-          required: true
+          description: "Relation data props"
+        },
+        relationsLoading: {
+          types: [
+            "object"
+          ],
+          description: "Loading state for relation data: { fieldName: boolean }"
         },
-        collapsible: {
+        conditionalFields: {
           types: [
+            "object",
             "boolean"
           ],
-          description: "Collapsible"
+          description: "Inspection form extensions"
         },
-        defaultCollapsed: {
+        hiddenCalculations: {
           types: [
+            "array",
             "boolean"
           ],
-          description: "Default collapsed state"
+          description: "Hidden calculations that emit GLOBAL_VARIABLE_SET on field change (boolean true means enabled but config loaded separately)"
         },
-        card: {
+        violationTriggers: {
           types: [
+            "array",
             "boolean"
           ],
-          description: "Use card wrapper"
+          description: "Violation conditions that emit VIOLATION_DETECTED when met (boolean true means enabled but config loaded separately)"
         },
-        columns: {
+        evaluationContext: {
           types: [
-            "number"
+            "formevaluationcontext",
+            "object"
           ],
-          description: "Grid columns for fields"
+          description: "Context for S-expression evaluation - accepts flexible types from generated code"
         },
-        className: {
+        sections: {
+          types: [
+            "array"
+          ],
+          description: "Nested form sections with optional conditions"
+        },
+        onFieldChange: {
+          types: [
+            "function"
+          ],
+          description: "Callback when any field value changes"
+        },
+        configPath: {
           types: [
             "string"
           ],
-          description: "className prop"
+          description: "Config path for form configuration (schema-driven)"
+        },
+        repeatable: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether the form supports repeatable entries"
         }
       }
     },
@@ -2536,110 +2662,6 @@ var patterns_registry_default = {
         }
       }
     },
-    "game-canvas": {
-      type: "game-canvas",
-      category: "game",
-      description: "Main game rendering area (canvas)",
-      suggestedFor: [
-        "game page",
-        "main gameplay"
-      ],
-      typicalSize: "large",
-      propsSchema: {
-        renderEntities: {
-          types: [
-            "array"
-          ],
-          description: "Entity type names to render (optional filter)"
-        },
-        renderers: {
-          types: [
-            "object"
-          ],
-          description: "Rendering functions per entity type"
-        },
-        renderer: {
-          types: [
-            "string"
-          ],
-          description: "Renderer type hint from schema (e.g., 'phaser', 'canvas'). Currently ignored - component uses Canvas2D. Reserved for future multi-renderer support."
-        },
-        background: {
-          types: [
-            "string"
-          ],
-          description: "Background color or gradient"
-        },
-        width: {
-          types: [
-            "number",
-            "string"
-          ],
-          description: "Canvas width in pixels or 'full' for responsive"
-        },
-        height: {
-          types: [
-            "number",
-            "string"
-          ],
-          description: "Canvas height in pixels or 'auto' for aspect ratio"
-        },
-        aspectRatio: {
-          types: [
-            "string"
-          ],
-          description: "Aspect ratio (e.g., '16:9', '4:3')"
-        },
-        cameraOffset: {
-          types: [
-            "object"
-          ],
-          description: "Camera offset for scrolling"
-        },
-        debug: {
-          types: [
-            "boolean"
-          ],
-          description: "Debug mode shows hitboxes and entity info"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        },
-        onClick: {
-          types: [
-            "function"
-          ],
-          description: "Click handler for canvas"
-        },
-        enableInput: {
-          types: [
-            "boolean"
-          ],
-          description: "Enable keyboard input handling (updates Input entity)"
-        },
-        inputBindings: {
-          types: [
-            "array"
-          ],
-          description: "Custom input key bindings"
-        },
-        collisions: {
-          types: [
-            "array"
-          ],
-          description: "Collision definitions from schema"
-        },
-        eventBus: {
-          types: [
-            "object"
-          ],
-          description: "Event bus for emitting collision events"
-        }
-      }
-    },
     "game-hud": {
       type: "game-hud",
       category: "game",
@@ -2694,77 +2716,15 @@ var patterns_registry_default = {
         }
       }
     },
-    "game-controls": {
-      type: "game-controls",
+    "game-menu": {
+      type: "game-menu",
       category: "game",
-      description: "Touch/button controls for mobile/accessibility",
+      description: "Main menu with start, options, credits",
       suggestedFor: [
-        "mobile games",
-        "touch controls"
+        "main menu page",
+        "start screen"
       ],
-      typicalSize: "small",
-      propsSchema: {
-        layout: {
-          types: [
-            "string"
-          ],
-          description: "Control layout type",
-          required: true
-        },
-        position: {
-          types: [
-            "string"
-          ],
-          description: "Position on screen",
-          required: true
-        },
-        controls: {
-          types: [
-            "unknown"
-          ],
-          description: "Controls to display - accepts readonly for compatibility with generated const arrays"
-        },
-        onControl: {
-          types: [
-            "function"
-          ],
-          description: "Called when control is pressed/released"
-        },
-        size: {
-          types: [
-            "string"
-          ],
-          description: "Size variant"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        },
-        visible: {
-          types: [
-            "boolean"
-          ],
-          description: "Whether controls are visible"
-        },
-        opacity: {
-          types: [
-            "number"
-          ],
-          description: "Opacity when visible"
-        }
-      }
-    },
-    "game-menu": {
-      type: "game-menu",
-      category: "game",
-      description: "Main menu with start, options, credits",
-      suggestedFor: [
-        "main menu page",
-        "start screen"
-      ],
-      typicalSize: "medium",
+      typicalSize: "medium",
       propsSchema: {
         title: {
           types: [
@@ -2823,66 +2783,6 @@ var patterns_registry_default = {
         }
       }
     },
-    "game-pause-overlay": {
-      type: "game-pause-overlay",
-      category: "game",
-      description: "Pause menu that overlays the game",
-      suggestedFor: [
-        "pause screen",
-        "game overlay"
-      ],
-      typicalSize: "small",
-      propsSchema: {
-        options: {
-          types: [
-            "array"
-          ],
-          description: "Pause menu options"
-        },
-        menuItems: {
-          types: [
-            "array"
-          ],
-          description: "Alias for options (schema compatibility)"
-        },
-        onSelect: {
-          types: [
-            "function"
-          ],
-          description: "Called when an option is selected (legacy callback, prefer event bus)"
-        },
-        eventBus: {
-          types: [
-            "eventbuscontexttype"
-          ],
-          description: "Event bus for emitting UI events (optional, uses hook if not provided)"
-        },
-        title: {
-          types: [
-            "string"
-          ],
-          description: 'Title (default: "PAUSED")'
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        },
-        visible: {
-          types: [
-            "boolean"
-          ],
-          description: "Whether the pause menu is visible"
-        },
-        onDismiss: {
-          types: [
-            "function"
-          ],
-          description: "Called when clicking outside the menu"
-        }
-      }
-    },
     "game-over-screen": {
       type: "game-over-screen",
       category: "game",
@@ -2965,162 +2865,6 @@ var patterns_registry_default = {
         }
       }
     },
-    "level-select": {
-      type: "level-select",
-      category: "game",
-      description: "Grid or list of levels to choose from",
-      suggestedFor: [
-        "level selection",
-        "stage selection"
-      ],
-      typicalSize: "large",
-      propsSchema: {
-        levels: {
-          types: [
-            "array"
-          ],
-          description: "Level data"
-        },
-        entity: {
-          types: [
-            "string"
-          ],
-          description: "Entity name (schema config)"
-        },
-        layout: {
-          types: [
-            "string"
-          ],
-          description: "Layout variant"
-        },
-        fields: {
-          types: [
-            "array"
-          ],
-          description: "Fields to display per level"
-        },
-        selectEvent: {
-          types: [
-            "string"
-          ],
-          description: "Event to emit on selection (schema config)"
-        },
-        onSelect: {
-          types: [
-            "function"
-          ],
-          description: "Called when a level is selected"
-        },
-        navigatesTo: {
-          types: [
-            "string"
-          ],
-          description: "Path to navigate to on selection. Supports :id, :levelId, :number placeholders"
-        },
-        selectedId: {
-          types: [
-            "string"
-          ],
-          description: "Currently selected level ID"
-        },
-        maxStars: {
-          types: [
-            "number"
-          ],
-          description: "Maximum stars possible per level"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        },
-        title: {
-          types: [
-            "string"
-          ],
-          description: "Title above the level grid"
-        }
-      }
-    },
-    "tilemap-renderer": {
-      type: "tilemap-renderer",
-      category: "game",
-      description: "Renders tile-based level data from instances with camera following",
-      suggestedFor: [
-        "platformer levels",
-        "tile-based games",
-        "rpg maps"
-      ],
-      typicalSize: "large",
-      propsSchema: {
-        layers: {
-          types: [
-            "array"
-          ],
-          description: "Tile layers to render",
-          required: true
-        },
-        tileset: {
-          types: [
-            "tileset"
-          ],
-          description: "Tileset configuration",
-          required: true
-        },
-        camera: {
-          types: [
-            "object"
-          ],
-          description: "Camera position",
-          required: true
-        },
-        viewportWidth: {
-          types: [
-            "number"
-          ],
-          description: "Viewport width in pixels",
-          required: true
-        },
-        viewportHeight: {
-          types: [
-            "number"
-          ],
-          description: "Viewport height in pixels",
-          required: true
-        },
-        pixelArt: {
-          types: [
-            "boolean"
-          ],
-          description: "Enable pixel art rendering (no smoothing)"
-        },
-        parallaxLayers: {
-          types: [
-            "array"
-          ],
-          description: "Parallax configuration per layer"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Optional className"
-        },
-        scale: {
-          types: [
-            "number"
-          ],
-          description: "Scale factor for rendering"
-        },
-        debug: {
-          types: [
-            "boolean"
-          ],
-          description: "Show debug grid"
-        }
-      }
-    },
     "inventory-panel": {
       type: "inventory-panel",
       category: "game",
@@ -3254,133 +2998,65 @@ var patterns_registry_default = {
         }
       }
     },
-    "input-listener": {
-      type: "input-listener",
-      category: "game",
-      description: "Invisible component that captures keyboard/mouse input and emits events",
+    "runtime-debugger": {
+      type: "runtime-debugger",
+      category: "debug",
+      description: "Debug overlay showing FPS, entity states, event logs",
       suggestedFor: [
-        "games",
-        "interactive applications",
-        "keyboard shortcuts"
+        "development",
+        "debugging",
+        "testing"
       ],
-      typicalSize: "tiny",
+      typicalSize: "small",
       propsSchema: {
-        bindings: {
+        position: {
           types: [
-            "unknown"
+            "string"
           ],
-          description: "Key bindings configuration"
+          description: "Initial position"
         },
-        enabled: {
+        defaultCollapsed: {
           types: [
             "boolean"
           ],
-          description: "Whether input listening is enabled"
+          description: "Initial collapsed state"
         },
-        eventBus: {
+        className: {
           types: [
-            "eventbuscontexttype"
+            "string"
           ],
-          description: "Event bus for emitting events (optional, uses hook if not provided)"
+          description: "Additional CSS classes"
         }
       }
     },
-    "collision-detector": {
-      type: "collision-detector",
-      category: "game",
-      description: "Invisible component that runs collision detection and emits collision events",
+    button: {
+      type: "button",
+      category: "component",
+      description: "Clickable button that emits events",
       suggestedFor: [
-        "games",
-        "2D physics",
-        "spatial interactions"
+        "actions",
+        "form submission",
+        "navigation triggers"
       ],
       typicalSize: "tiny",
       propsSchema: {
-        algorithm: {
+        variant: {
           types: [
-            "string"
+            "buttonvariant"
           ],
-          description: "Collision detection algorithm"
+          description: "variant prop"
         },
-        rules: {
+        size: {
           types: [
-            "unknown"
+            "buttonsize"
           ],
-          description: "Collision rules to check"
+          description: "size prop"
         },
-        enabled: {
+        isLoading: {
           types: [
             "boolean"
           ],
-          description: "Whether collision detection is enabled"
-        },
-        eventBus: {
-          types: [
-            "eventbuscontexttype"
-          ],
-          description: "Event bus for emitting events (optional, uses hook if not provided)"
-        }
-      }
-    },
-    "runtime-debugger": {
-      type: "runtime-debugger",
-      category: "debug",
-      description: "Debug overlay showing FPS, entity states, event logs",
-      suggestedFor: [
-        "development",
-        "debugging",
-        "testing"
-      ],
-      typicalSize: "small",
-      propsSchema: {
-        position: {
-          types: [
-            "string"
-          ],
-          description: "Initial position"
-        },
-        defaultCollapsed: {
-          types: [
-            "boolean"
-          ],
-          description: "Initial collapsed state"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        }
-      }
-    },
-    button: {
-      type: "button",
-      category: "component",
-      description: "Clickable button that emits events",
-      suggestedFor: [
-        "actions",
-        "form submission",
-        "navigation triggers"
-      ],
-      typicalSize: "tiny",
-      propsSchema: {
-        variant: {
-          types: [
-            "buttonvariant"
-          ],
-          description: "variant prop"
-        },
-        size: {
-          types: [
-            "buttonsize"
-          ],
-          description: "size prop"
-        },
-        isLoading: {
-          types: [
-            "boolean"
-          ],
-          description: "isLoading prop"
+          description: "isLoading prop"
         },
         leftIcon: {
           types: [
@@ -3647,12 +3323,6 @@ var patterns_registry_default = {
           ],
           description: "Maximum value (for calculating percentage) @default 100"
         },
-        type: {
-          types: [
-            "progressbartype"
-          ],
-          description: "Type of the progress bar (linear, circular, stepped) @default 'linear'"
-        },
         variant: {
           types: [
             "progressbarvariant"
@@ -3700,6 +3370,12 @@ var patterns_registry_default = {
             "string"
           ],
           description: "Additional CSS classes"
+        },
+        progressType: {
+          types: [
+            "progressbartype"
+          ],
+          description: "Type of the progress bar (linear, circular, stepped) @default 'linear'"
         }
       }
     },
@@ -3732,12 +3408,6 @@ var patterns_registry_default = {
       ],
       typicalSize: "tiny",
       propsSchema: {
-        type: {
-          types: [
-            "string"
-          ],
-          description: "Input type - supports 'select' and 'textarea' in addition to standard types"
-        },
         error: {
           types: [
             "string"
@@ -3791,6 +3461,12 @@ var patterns_registry_default = {
             "react.changeeventhandler"
           ],
           description: "onChange handler - accepts events from input, select, or textarea"
+        },
+        inputType: {
+          types: [
+            "string"
+          ],
+          description: "Input type - supports 'select' and 'textarea' in addition to standard types"
         }
       }
     },
@@ -4706,13 +4382,6 @@ var patterns_registry_default = {
       ],
       typicalSize: "small",
       propsSchema: {
-        type: {
-          types: [
-            "highlighttype"
-          ],
-          description: "Type of highlight (determines color)",
-          required: true
-        },
         isActive: {
           types: [
             "boolean"
@@ -4755,6 +4424,13 @@ var patterns_registry_default = {
           ],
           description: "Highlighted text content",
           required: true
+        },
+        highlightType: {
+          types: [
+            "highlighttype"
+          ],
+          description: "Type of highlight (determines color)",
+          required: true
         }
       }
     },
@@ -7782,25 +7458,1694 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Application / game title shown in the HUD bar"
+          description: "Application / game title shown in the HUD bar"
+        },
+        hud: {
+          types: [
+            "node"
+          ],
+          description: "Optional HUD content rendered above the main area"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Extra class name on the root container"
+        },
+        showTopBar: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether to show the minimal top bar (default: true)"
+        }
+      }
+    },
+    chart: {
+      type: "chart",
+      category: "visualization",
+      description: "Data visualization chart supporting bar, line, pie, area, and donut types",
+      suggestedFor: [
+        "dashboards",
+        "analytics",
+        "data visualization",
+        "reporting"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        title: {
+          types: [
+            "string"
+          ],
+          description: "Chart title"
+        },
+        subtitle: {
+          types: [
+            "string"
+          ],
+          description: "Chart subtitle / description"
+        },
+        chartType: {
+          types: [
+            "charttype"
+          ],
+          description: "Chart type"
+        },
+        series: {
+          types: [
+            "unknown"
+          ],
+          description: "Data series"
+        },
+        data: {
+          types: [
+            "unknown"
+          ],
+          description: "Simple data (single series shorthand)"
+        },
+        height: {
+          types: [
+            "number"
+          ],
+          description: "Chart height in px"
+        },
+        showLegend: {
+          types: [
+            "boolean"
+          ],
+          description: "Show legend"
+        },
+        showValues: {
+          types: [
+            "boolean"
+          ],
+          description: "Show values on chart"
+        },
+        actions: {
+          types: [
+            "unknown"
+          ],
+          description: "Actions for chart interactions"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Entity name for schema-driven auto-fetch"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    meter: {
+      type: "meter",
+      category: "visualization",
+      description: "Gauge/meter component for displaying a value within a range with thresholds",
+      suggestedFor: [
+        "dashboards",
+        "progress tracking",
+        "credit/quota displays",
+        "KPI indicators"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        value: {
+          types: [
+            "number"
+          ],
+          description: "Current value",
+          required: true
+        },
+        min: {
+          types: [
+            "number"
+          ],
+          description: "Minimum value"
+        },
+        max: {
+          types: [
+            "number"
+          ],
+          description: "Maximum value"
+        },
+        label: {
+          types: [
+            "string"
+          ],
+          description: "Display label"
+        },
+        unit: {
+          types: [
+            "string"
+          ],
+          description: "Unit suffix (e.g., '%', 'MB', 'credits')"
+        },
+        variant: {
+          types: [
+            "metervariant"
+          ],
+          description: "Display variant"
+        },
+        thresholds: {
+          types: [
+            "unknown"
+          ],
+          description: "Color thresholds"
+        },
+        segments: {
+          types: [
+            "number"
+          ],
+          description: "Number of segments (for segmented variant)"
+        },
+        showValue: {
+          types: [
+            "boolean"
+          ],
+          description: "Show value text"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size (for radial variant)"
+        },
+        actions: {
+          types: [
+            "unknown"
+          ],
+          description: "Actions"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Entity name for schema-driven auto-fetch"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    timeline: {
+      type: "timeline",
+      category: "display",
+      description: "Vertical timeline for displaying chronological events with status indicators",
+      suggestedFor: [
+        "activity logs",
+        "process tracking",
+        "history views",
+        "workflow steps"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        title: {
+          types: [
+            "string"
+          ],
+          description: "Timeline title"
+        },
+        items: {
+          types: [
+            "unknown"
+          ],
+          description: "Timeline items"
+        },
+        data: {
+          types: [
+            "unknown"
+          ],
+          description: "Schema-driven data"
+        },
+        fields: {
+          types: [
+            "unknown"
+          ],
+          description: "Fields to display"
+        },
+        itemActions: {
+          types: [
+            "unknown"
+          ],
+          description: "Actions per item"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Entity name for schema-driven auto-fetch"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "media-gallery": {
+      type: "media-gallery",
+      category: "media",
+      description: "Grid gallery for images and media with lightbox, selection, and upload",
+      suggestedFor: [
+        "photo galleries",
+        "image management",
+        "media libraries",
+        "portfolio displays"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        title: {
+          types: [
+            "string"
+          ],
+          description: "Gallery title"
+        },
+        items: {
+          types: [
+            "unknown"
+          ],
+          description: "Media items"
+        },
+        data: {
+          types: [
+            "unknown"
+          ],
+          description: "Schema-driven data"
+        },
+        columns: {
+          types: [
+            "number"
+          ],
+          description: "Column count"
+        },
+        selectable: {
+          types: [
+            "boolean"
+          ],
+          description: "Enable item selection"
+        },
+        selectedItems: {
+          types: [
+            "unknown"
+          ],
+          description: "Selected item IDs"
+        },
+        onSelectionChange: {
+          types: [
+            "function"
+          ],
+          description: "Selection change callback"
+        },
+        showUpload: {
+          types: [
+            "boolean"
+          ],
+          description: "Show upload button"
+        },
+        actions: {
+          types: [
+            "unknown"
+          ],
+          description: "Actions"
+        },
+        aspectRatio: {
+          types: [
+            "string"
+          ],
+          description: "Aspect ratio for thumbnails"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Entity name for schema-driven auto-fetch"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "signature-pad": {
+      type: "signature-pad",
+      category: "form",
+      description: "Canvas-based signature capture pad with draw, clear, and confirm actions",
+      suggestedFor: [
+        "form signing",
+        "approval workflows",
+        "document signing",
+        "consent forms"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        label: {
+          types: [
+            "string"
+          ],
+          description: "Label above the pad"
+        },
+        helperText: {
+          types: [
+            "string"
+          ],
+          description: "Helper text"
+        },
+        strokeColor: {
+          types: [
+            "string"
+          ],
+          description: "Stroke color"
+        },
+        strokeWidth: {
+          types: [
+            "number"
+          ],
+          description: "Stroke width"
+        },
+        height: {
+          types: [
+            "number"
+          ],
+          description: "Pad height"
+        },
+        readOnly: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether the pad is read-only"
+        },
+        value: {
+          types: [
+            "string"
+          ],
+          description: "Existing signature image URL"
+        },
+        onChange: {
+          types: [
+            "function"
+          ],
+          description: "Callback when signature changes"
+        },
+        signEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event to emit on sign"
+        },
+        clearEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event to emit on clear"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Entity name for schema-driven context"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "document-viewer": {
+      type: "document-viewer",
+      category: "display",
+      description: "Document viewer for PDFs, text, HTML, and markdown with zoom and pagination",
+      suggestedFor: [
+        "document management",
+        "PDF viewing",
+        "content preview",
+        "report viewing"
+      ],
+      typicalSize: "large",
+      propsSchema: {
+        title: {
+          types: [
+            "string"
+          ],
+          description: "Document title"
+        },
+        src: {
+          types: [
+            "string"
+          ],
+          description: "Document URL (for PDF/external documents)"
+        },
+        content: {
+          types: [
+            "string"
+          ],
+          description: "Document content (for text/html/markdown)"
+        },
+        documentType: {
+          types: [
+            "documenttype"
+          ],
+          description: "Document type"
+        },
+        currentPage: {
+          types: [
+            "number"
+          ],
+          description: "Current page (for multi-page documents)"
+        },
+        totalPages: {
+          types: [
+            "number"
+          ],
+          description: "Total pages"
+        },
+        height: {
+          types: [
+            "number",
+            "string"
+          ],
+          description: "Viewer height"
+        },
+        showToolbar: {
+          types: [
+            "boolean"
+          ],
+          description: "Show toolbar"
+        },
+        showDownload: {
+          types: [
+            "boolean"
+          ],
+          description: "Show download button"
+        },
+        showPrint: {
+          types: [
+            "boolean"
+          ],
+          description: "Show print button"
+        },
+        actions: {
+          types: [
+            "unknown"
+          ],
+          description: "Actions"
+        },
+        documents: {
+          types: [
+            "unknown"
+          ],
+          description: "Multiple documents (tabbed view)"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Entity name for schema-driven auto-fetch"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "graph-canvas": {
+      type: "graph-canvas",
+      category: "visualization",
+      description: "Force-directed graph visualization for node-link data with interactive zoom, pan, and layout",
+      suggestedFor: [
+        "knowledge graphs",
+        "network visualization",
+        "relationship mapping",
+        "dependency graphs"
+      ],
+      typicalSize: "large",
+      propsSchema: {
+        title: {
+          types: [
+            "string"
+          ],
+          description: "Graph title"
+        },
+        nodes: {
+          types: [
+            "unknown"
+          ],
+          description: "Graph nodes"
+        },
+        edges: {
+          types: [
+            "unknown"
+          ],
+          description: "Graph edges"
+        },
+        height: {
+          types: [
+            "number"
+          ],
+          description: "Canvas height"
+        },
+        showLabels: {
+          types: [
+            "boolean"
+          ],
+          description: "Show node labels"
+        },
+        interactive: {
+          types: [
+            "boolean"
+          ],
+          description: "Enable zoom/pan"
+        },
+        draggable: {
+          types: [
+            "boolean"
+          ],
+          description: "Enable node dragging"
+        },
+        actions: {
+          types: [
+            "unknown"
+          ],
+          description: "Actions"
+        },
+        onNodeClick: {
+          types: [
+            "function"
+          ],
+          description: "On node click"
+        },
+        nodeClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Node click event"
+        },
+        layout: {
+          types: [
+            "string"
+          ],
+          description: "Layout algorithm"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Entity name for schema-driven auto-fetch"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "code-viewer": {
+      type: "code-viewer",
+      category: "display",
+      description: "Code and diff viewer with line numbers, copy, word-wrap, and multi-file tabs",
+      suggestedFor: [
+        "code display",
+        "diff viewing",
+        "schema inspection",
+        "log viewing"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        title: {
+          types: [
+            "string"
+          ],
+          description: "Viewer title"
+        },
+        code: {
+          types: [
+            "string"
+          ],
+          description: "Code content"
+        },
+        language: {
+          types: [
+            "string"
+          ],
+          description: "Language for display label"
+        },
+        diff: {
+          types: [
+            "unknown"
+          ],
+          description: "Diff lines (for diff mode)"
+        },
+        oldValue: {
+          types: [
+            "string"
+          ],
+          description: "Old value (for generating diff)"
+        },
+        newValue: {
+          types: [
+            "string"
+          ],
+          description: "New value (for generating diff)"
+        },
+        mode: {
+          types: [
+            "codeviewermode"
+          ],
+          description: "Display mode"
+        },
+        showLineNumbers: {
+          types: [
+            "boolean"
+          ],
+          description: "Show line numbers"
+        },
+        showCopy: {
+          types: [
+            "boolean"
+          ],
+          description: "Show copy button"
+        },
+        wordWrap: {
+          types: [
+            "boolean"
+          ],
+          description: "Enable word wrap"
+        },
+        maxHeight: {
+          types: [
+            "number",
+            "string"
+          ],
+          description: "Max height before scrolling"
+        },
+        files: {
+          types: [
+            "unknown"
+          ],
+          description: "Multiple files (tabbed view)"
+        },
+        actions: {
+          types: [
+            "unknown"
+          ],
+          description: "Actions"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Entity name for schema-driven auto-fetch"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "canvas-effect": {
+      type: "canvas-effect",
+      category: "game",
+      description: "CanvasEffect Component  Renders animated visual effects as DOM overlays on the canvas. Maps combat action types to particle/flash effects that play at a specified position and auto-dismiss.  Pattern: canvas-effect",
+      suggestedFor: [
+        "canvas",
+        "effect",
+        "canvas effect"
+      ],
+      typicalSize: "large",
+      propsSchema: {
+        actionType: {
+          types: [
+            "combatactiontype"
+          ],
+          description: "The type of combat action to visualise",
+          required: true
+        },
+        x: {
+          types: [
+            "number"
+          ],
+          description: "Screen-space X position (center of the effect)",
+          required: true
+        },
+        y: {
+          types: [
+            "number"
+          ],
+          description: "Screen-space Y position (center of the effect)",
+          required: true
+        },
+        duration: {
+          types: [
+            "number"
+          ],
+          description: "Duration in ms before auto-dismiss (default 2000 for canvas, 800 for emoji)"
+        },
+        intensity: {
+          types: [
+            "number"
+          ],
+          description: "Optional intensity multiplier (1 = normal, 2 = double size/brightness)"
+        },
+        onComplete: {
+          types: [
+            "function"
+          ],
+          description: "Callback when the effect animation completes"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state indicator"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        effectSpriteUrl: {
+          types: [
+            "string"
+          ],
+          description: "--- Remote asset loading ---"
+        },
+        assetBaseUrl: {
+          types: [
+            "string"
+          ],
+          description: "Base URL for remote assets. Prepended to relative effectSpriteUrl paths."
+        },
+        assetManifest: {
+          types: [
+            "effectassetmanifest"
+          ],
+          description: "Full effect asset manifest for the sprite particle engine. When provided, enables the canvas-based particle system."
+        },
+        width: {
+          types: [
+            "number"
+          ],
+          description: "Canvas width (default 400)"
+        },
+        height: {
+          types: [
+            "number"
+          ],
+          description: "Canvas height (default 300)"
+        }
+      }
+    },
+    "isometric-canvas": {
+      type: "isometric-canvas",
+      category: "game",
+      description: "IsometricCanvas  Core isometric game renderer. Maps to the `game-canvas` pattern. Adapted from projects/trait-wars/design-system/organisms/IsometricGameCanvas.tsx with full closed-circuit pattern compliance (className, isLoading, error, entity).  Architecture: - 2:1 diamond isometric projection - Painter's algorithm (tile \u2192 feature \u2192 unit depth sort) - Camera pan/zoom with lerp - Off-screen culling - Minimap on separate canvas - Sprite sheet animation via resolveUnitFrame - Event bus\u2013friendly handlers (onTileClick, onUnitClick, etc.)",
+      suggestedFor: [
+        "isometric",
+        "canvas",
+        "isometric canvas"
+      ],
+      typicalSize: "large",
+      propsSchema: {
+        className: {
+          types: [
+            "string"
+          ],
+          description: "--- Closed-circuit props (MANDATORY) ---"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state indicator"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Entity name for schema-driven auto-fetch"
+        },
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "--- Grid data ---"
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Array of units on the board"
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Array of features (resources, portals, buildings, etc.)"
+        },
+        selectedUnitId: {
+          types: [
+            "string"
+          ],
+          description: "--- Interaction state ---"
+        },
+        validMoves: {
+          types: [
+            "array"
+          ],
+          description: "Valid move positions (shown as pulsing green highlights)"
+        },
+        attackTargets: {
+          types: [
+            "array"
+          ],
+          description: "Attack target positions (shown as pulsing red highlights)"
+        },
+        hoveredTile: {
+          types: [
+            "object"
+          ],
+          description: "Hovered tile position"
+        },
+        onTileClick: {
+          types: [
+            "function"
+          ],
+          description: "--- Event handlers ---"
+        },
+        onUnitClick: {
+          types: [
+            "function"
+          ],
+          description: "Unit click handler"
+        },
+        onTileHover: {
+          types: [
+            "function"
+          ],
+          description: "Tile hover handler"
+        },
+        onTileLeave: {
+          types: [
+            "function"
+          ],
+          description: "Tile leave handler"
+        },
+        scale: {
+          types: [
+            "number"
+          ],
+          description: "--- Rendering options ---"
+        },
+        debug: {
+          types: [
+            "boolean"
+          ],
+          description: "Show debug grid lines and coordinates"
+        },
+        backgroundImage: {
+          types: [
+            "string"
+          ],
+          description: "Background image URL tiled behind the isometric grid"
+        },
+        showMinimap: {
+          types: [
+            "boolean"
+          ],
+          description: "Toggle minimap overlay"
+        },
+        enableCamera: {
+          types: [
+            "boolean"
+          ],
+          description: "Enable camera pan/zoom controls"
+        },
+        unitScale: {
+          types: [
+            "number"
+          ],
+          description: "Extra scale multiplier for unit draw size. 1 = default."
+        },
+        getTerrainSprite: {
+          types: [
+            "function"
+          ],
+          description: "--- Asset resolution (project-agnostic) ---"
+        },
+        getFeatureSprite: {
+          types: [
+            "function"
+          ],
+          description: "Resolve feature sprite URL from feature type key"
+        },
+        getUnitSprite: {
+          types: [
+            "function"
+          ],
+          description: "Resolve unit static sprite URL"
+        },
+        resolveUnitFrame: {
+          types: [
+            "function"
+          ],
+          description: "Resolve animated sprite sheet frame for a unit"
+        },
+        effectSpriteUrls: {
+          types: [
+            "array"
+          ],
+          description: "Additional sprite URLs to preload (e.g., effect sprites)"
+        },
+        onDrawEffects: {
+          types: [
+            "function"
+          ],
+          description: "Callback to draw canvas effects after units"
+        },
+        hasActiveEffects: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether there are active effects \u2014 keeps RAF loop alive"
+        },
+        assetBaseUrl: {
+          types: [
+            "string"
+          ],
+          description: "--- Remote asset loading ---"
+        },
+        assetManifest: {
+          types: [
+            "object"
+          ],
+          description: "Manifest mapping entity keys to relative sprite paths. Combined with assetBaseUrl to produce full URLs. Used as a fallback when inline URLs and callbacks don't resolve."
+        }
+      }
+    },
+    "battle-template": {
+      type: "battle-template",
+      category: "template",
+      description: "BattleTemplate  Generalized tactical battle template composing IsometricCanvas from almadar-ui. Provides turn-based phase management, movement animation, valid-move/attack-target calculation, screen shake/flash, and a game-over overlay.  Game-specific UI (combat log, trait viewer, damage popups, etc.) is injected via render-prop slots so this template remains project-agnostic.",
+      suggestedFor: [
+        "battle",
+        "template",
+        "battle template"
+      ],
+      typicalSize: "full",
+      propsSchema: {
+        initialUnits: {
+          types: [
+            "array"
+          ],
+          description: "Initial units for the battle",
+          required: true
+        },
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Isometric tiles (pre-resolved with terrainSprite)",
+          required: true
+        },
+        scale: {
+          types: [
+            "number"
+          ],
+          description: "Canvas render scale"
+        },
+        boardWidth: {
+          types: [
+            "number"
+          ],
+          description: "Board width for bounds checking"
+        },
+        boardHeight: {
+          types: [
+            "number"
+          ],
+          description: "Board height for bounds checking"
+        },
+        assetManifest: {
+          types: [
+            "object"
+          ],
+          description: "Asset manifest for IsometricCanvas"
+        },
+        backgroundImage: {
+          types: [
+            "string"
+          ],
+          description: "Background image URL for canvas"
+        },
+        unitScale: {
+          types: [
+            "number"
+          ],
+          description: "Unit draw-size multiplier"
+        },
+        header: {
+          types: [
+            "function"
+          ],
+          description: "-- Slots --"
+        },
+        sidebar: {
+          types: [
+            "function"
+          ],
+          description: "Sidebar content (combat log, unit roster, etc.)"
+        },
+        actions: {
+          types: [
+            "function"
+          ],
+          description: "Floating action buttons"
+        },
+        overlay: {
+          types: [
+            "function"
+          ],
+          description: "Floating overlays above the canvas (damage popups, tooltips)"
+        },
+        gameOverOverlay: {
+          types: [
+            "function"
+          ],
+          description: "Game-over screen overlay"
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "-- Obstacle features --"
+        },
+        onAttack: {
+          types: [
+            "function"
+          ],
+          description: "-- Callbacks --"
+        },
+        onGameEnd: {
+          types: [
+            "function"
+          ],
+          description: "Called when battle ends"
+        },
+        onUnitMove: {
+          types: [
+            "function"
+          ],
+          description: "Called after a unit moves"
+        },
+        calculateDamage: {
+          types: [
+            "function"
+          ],
+          description: "Custom combat damage calculator"
+        },
+        onDrawEffects: {
+          types: [
+            "function"
+          ],
+          description: "-- Canvas pass-through --"
+        },
+        hasActiveEffects: {
+          types: [
+            "boolean"
+          ],
+          description: "hasActiveEffects prop"
+        },
+        effectSpriteUrls: {
+          types: [
+            "array"
+          ],
+          description: "effectSpriteUrls prop"
+        },
+        resolveUnitFrame: {
+          types: [
+            "function"
+          ],
+          description: "resolveUnitFrame prop"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
+    },
+    "castle-template": {
+      type: "castle-template",
+      category: "template",
+      description: "CastleTemplate  Generalized castle / base-management template composing IsometricCanvas from almadar-ui. Renders an isometric courtyard/base view and exposes a side-panel area via slots for game-specific UI (building details, recruitment, garrison).",
+      suggestedFor: [
+        "castle",
+        "template",
+        "castle template"
+      ],
+      typicalSize: "full",
+      propsSchema: {
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Isometric tiles (pre-resolved with terrainSprite)",
+          required: true
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Building features rendered on the grid"
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Garrison / stationed units on the grid"
+        },
+        scale: {
+          types: [
+            "number"
+          ],
+          description: "Canvas render scale"
+        },
+        assetManifest: {
+          types: [
+            "object"
+          ],
+          description: "Asset manifest for IsometricCanvas"
+        },
+        backgroundImage: {
+          types: [
+            "string"
+          ],
+          description: "Background image URL"
+        },
+        header: {
+          types: [
+            "function"
+          ],
+          description: "-- Slots --"
+        },
+        sidePanel: {
+          types: [
+            "function"
+          ],
+          description: "Side panel content (buildings list, recruit tab, garrison tab)"
+        },
+        overlay: {
+          types: [
+            "function"
+          ],
+          description: "Canvas overlay (hover tooltips, etc.)"
+        },
+        footer: {
+          types: [
+            "function"
+          ],
+          description: "Bottom bar (income summary, etc.)"
+        },
+        onFeatureClick: {
+          types: [
+            "function"
+          ],
+          description: "-- Callbacks --"
+        },
+        onUnitClick: {
+          types: [
+            "function"
+          ],
+          description: "Called when a unit is clicked"
+        },
+        onTileClick: {
+          types: [
+            "function"
+          ],
+          description: "Called when any tile is clicked"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
+    },
+    "world-map-template": {
+      type: "world-map-template",
+      category: "template",
+      description: "WorldMapTemplate  Generalized strategic world-map template composing IsometricCanvas from almadar-ui. Renders an isometric hex/iso map with hero selection, movement animation, and encounter callbacks. Game-specific panels (hero detail, hero lists, resource bars) are injected via render-prop slots.",
+      suggestedFor: [
+        "world",
+        "map",
+        "template",
+        "world map template"
+      ],
+      typicalSize: "full",
+      propsSchema: {
+        hexes: {
+          types: [
+            "array"
+          ],
+          description: "All map hexes (with pre-resolved terrain sprites)",
+          required: true
+        },
+        heroes: {
+          types: [
+            "array"
+          ],
+          description: "Heroes on the map",
+          required: true
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Features rendered on tiles"
+        },
+        selectedHeroId: {
+          types: [
+            "string"
+          ],
+          description: "Currently selected hero ID"
+        },
+        scale: {
+          types: [
+            "number"
+          ],
+          description: "Canvas render scale"
+        },
+        unitScale: {
+          types: [
+            "number"
+          ],
+          description: "Unit draw-size multiplier"
+        },
+        assetManifest: {
+          types: [
+            "object"
+          ],
+          description: "Asset manifest for IsometricCanvas"
+        },
+        backgroundImage: {
+          types: [
+            "string"
+          ],
+          description: "Background image URL"
+        },
+        allowMoveAllHeroes: {
+          types: [
+            "boolean"
+          ],
+          description: "Allow selecting / moving ALL heroes (including enemy). For testing."
+        },
+        isInRange: {
+          types: [
+            "function"
+          ],
+          description: "Custom movement range validator"
+        },
+        header: {
+          types: [
+            "function"
+          ],
+          description: "-- Slots --"
+        },
+        sidePanel: {
+          types: [
+            "function"
+          ],
+          description: "Side panel (hero detail, hero lists, etc.)"
+        },
+        overlay: {
+          types: [
+            "function"
+          ],
+          description: "Canvas overlay (tooltips, popups)"
+        },
+        footer: {
+          types: [
+            "function"
+          ],
+          description: "Footer"
+        },
+        onHeroSelect: {
+          types: [
+            "function"
+          ],
+          description: "-- Callbacks --"
+        },
+        onHeroMove: {
+          types: [
+            "function"
+          ],
+          description: "onHeroMove prop"
+        },
+        onBattleEncounter: {
+          types: [
+            "function"
+          ],
+          description: "Called when hero clicks an enemy hero tile"
+        },
+        onFeatureEnter: {
+          types: [
+            "function"
+          ],
+          description: "Called when hero enters a feature hex (castle, resource, etc.)"
+        },
+        effectSpriteUrls: {
+          types: [
+            "array"
+          ],
+          description: "-- Canvas pass-through --"
+        },
+        resolveUnitFrame: {
+          types: [
+            "function"
+          ],
+          description: "resolveUnitFrame prop"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
+    },
+    heading: {
+      type: "heading",
+      category: "component",
+      description: "Alias for typography \u2014 Typography Atom Component  Text elements following the KFlow design system with theme-aware styling.",
+      suggestedFor: [
+        "typography"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        variant: {
+          types: [
+            "typographyvariant"
+          ],
+          description: "Typography variant"
+        },
+        level: {
+          types: [
+            "number"
+          ],
+          description: "Heading level (1-6) - alternative to variant for headings"
+        },
+        color: {
+          types: [
+            "string"
+          ],
+          description: "Text color"
+        },
+        align: {
+          types: [
+            "string"
+          ],
+          description: "Text alignment"
+        },
+        weight: {
+          types: [
+            "string"
+          ],
+          description: "Font weight override"
+        },
+        size: {
+          types: [
+            "typographysize"
+          ],
+          description: "Font size override"
+        },
+        truncate: {
+          types: [
+            "boolean"
+          ],
+          description: "Truncate with ellipsis (single line)"
+        },
+        overflow: {
+          types: [
+            "string"
+          ],
+          description: "Overflow handling mode"
+        },
+        as: {
+          types: [
+            "unknown"
+          ],
+          description: "Custom HTML element"
+        },
+        id: {
+          types: [
+            "string"
+          ],
+          description: "HTML id attribute"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional class names"
+        },
+        style: {
+          types: [
+            "object"
+          ],
+          description: "Inline style"
+        },
+        content: {
+          types: [
+            "node"
+          ],
+          description: "Text content (alternative to children)"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Children elements"
+        }
+      }
+    },
+    text: {
+      type: "text",
+      category: "component",
+      description: "Alias for typography \u2014 Typography Atom Component  Text elements following the KFlow design system with theme-aware styling.",
+      suggestedFor: [
+        "typography"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        variant: {
+          types: [
+            "typographyvariant"
+          ],
+          description: "Typography variant"
+        },
+        level: {
+          types: [
+            "number"
+          ],
+          description: "Heading level (1-6) - alternative to variant for headings"
+        },
+        color: {
+          types: [
+            "string"
+          ],
+          description: "Text color"
+        },
+        align: {
+          types: [
+            "string"
+          ],
+          description: "Text alignment"
+        },
+        weight: {
+          types: [
+            "string"
+          ],
+          description: "Font weight override"
+        },
+        size: {
+          types: [
+            "typographysize"
+          ],
+          description: "Font size override"
+        },
+        truncate: {
+          types: [
+            "boolean"
+          ],
+          description: "Truncate with ellipsis (single line)"
+        },
+        overflow: {
+          types: [
+            "string"
+          ],
+          description: "Overflow handling mode"
+        },
+        as: {
+          types: [
+            "unknown"
+          ],
+          description: "Custom HTML element"
+        },
+        id: {
+          types: [
+            "string"
+          ],
+          description: "HTML id attribute"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional class names"
         },
-        hud: {
+        style: {
           types: [
-            "node"
+            "object"
           ],
-          description: "Optional HUD content rendered above the main area"
+          description: "Inline style"
         },
-        className: {
+        content: {
           types: [
-            "string"
+            "node"
           ],
-          description: "Extra class name on the root container"
+          description: "Text content (alternative to children)"
         },
-        showTopBar: {
+        children: {
           types: [
-            "boolean"
+            "node"
           ],
-          description: "Whether to show the minimal top bar (default: true)"
+          description: "Children elements"
         }
       }
     }
@@ -7819,7 +9164,9 @@ var patterns_registry_default = {
     "debug",
     "meta",
     "component",
-    "template"
+    "template",
+    "visualization",
+    "media"
   ]
 };
 
@@ -8328,7 +9675,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-02-09T10:45:55.417Z",
+  exportedAt: "2026-02-10T15:35:56.769Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -8366,7 +9713,7 @@ var component_mapping_default = {
       category: "form"
     },
     "form-section": {
-      component: "FormSection",
+      component: "Form",
       importPath: "@/components/organisms/Form",
       category: "form"
     },
@@ -8465,46 +9812,21 @@ var component_mapping_default = {
       importPath: "@/components/organisms/layout/DashboardGrid",
       category: "layout"
     },
-    "game-canvas": {
-      component: "GameCanvas",
-      importPath: "@/components/organisms/game/GameCanvas",
-      category: "game"
-    },
     "game-hud": {
       component: "GameHud",
       importPath: "@/components/organisms/game/GameHud",
       category: "game"
     },
-    "game-controls": {
-      component: "GameControls",
-      importPath: "@/components/organisms/game/GameControls",
-      category: "game"
-    },
     "game-menu": {
       component: "GameMenu",
       importPath: "@/components/organisms/game/GameMenu",
       category: "game"
     },
-    "game-pause-overlay": {
-      component: "GamePauseOverlay",
-      importPath: "@/components/organisms/game/GamePauseOverlay",
-      category: "game"
-    },
     "game-over-screen": {
       component: "GameOverScreen",
       importPath: "@/components/organisms/game/GameOverScreen",
       category: "game"
     },
-    "level-select": {
-      component: "LevelSelect",
-      importPath: "@/components/organisms/game/LevelSelect",
-      category: "game"
-    },
-    "tilemap-renderer": {
-      component: "TilemapRenderer",
-      importPath: "@/components/organisms/game/TilemapRenderer",
-      category: "game"
-    },
     "inventory-panel": {
       component: "InventoryPanel",
       importPath: "@/components/organisms/game/InventoryPanel",
@@ -8515,16 +9837,6 @@ var component_mapping_default = {
       importPath: "@/components/organisms/game/DialogueBox",
       category: "game"
     },
-    "input-listener": {
-      component: "InputListener",
-      importPath: "@/components/organisms/game/InputListener",
-      category: "game"
-    },
-    "collision-detector": {
-      component: "CollisionDetector",
-      importPath: "@/components/organisms/game/CollisionDetector",
-      category: "game"
-    },
     "runtime-debugger": {
       component: "RuntimeDebugger",
       importPath: "@/components/organisms/debug/RuntimeDebugger",
@@ -8723,6 +10035,16 @@ var component_mapping_default = {
       importPath: "@/components/atoms/Stack",
       category: "component"
     },
+    vstack: {
+      component: "VStack",
+      importPath: "@/components/atoms/Stack",
+      category: "component"
+    },
+    hstack: {
+      component: "HStack",
+      importPath: "@/components/atoms/Stack",
+      category: "component"
+    },
     "text-highlight": {
       component: "TextHighlight",
       importPath: "@/components/atoms/TextHighlight",
@@ -8942,6 +10264,81 @@ var component_mapping_default = {
       component: "GameShell",
       importPath: "@/components/templates/GameShell",
       category: "template"
+    },
+    chart: {
+      component: "Chart",
+      importPath: "@almadar/ui",
+      category: "visualization"
+    },
+    meter: {
+      component: "Meter",
+      importPath: "@almadar/ui",
+      category: "visualization"
+    },
+    timeline: {
+      component: "Timeline",
+      importPath: "@almadar/ui",
+      category: "display"
+    },
+    "media-gallery": {
+      component: "MediaGallery",
+      importPath: "@almadar/ui",
+      category: "media"
+    },
+    "signature-pad": {
+      component: "SignaturePad",
+      importPath: "@almadar/ui",
+      category: "form"
+    },
+    "document-viewer": {
+      component: "DocumentViewer",
+      importPath: "@almadar/ui",
+      category: "display"
+    },
+    "graph-canvas": {
+      component: "GraphCanvas",
+      importPath: "@almadar/ui",
+      category: "visualization"
+    },
+    "code-viewer": {
+      component: "CodeViewer",
+      importPath: "@almadar/ui",
+      category: "display"
+    },
+    "canvas-effect": {
+      component: "CanvasEffect",
+      importPath: "@/components/organisms/CanvasEffect",
+      category: "game"
+    },
+    "isometric-canvas": {
+      component: "IsometricCanvas",
+      importPath: "@/components/organisms/IsometricCanvas",
+      category: "game"
+    },
+    "battle-template": {
+      component: "BattleTemplate",
+      importPath: "@/components/templates/BattleTemplate",
+      category: "template"
+    },
+    "castle-template": {
+      component: "CastleTemplate",
+      importPath: "@/components/templates/CastleTemplate",
+      category: "template"
+    },
+    "world-map-template": {
+      component: "WorldMapTemplate",
+      importPath: "@/components/templates/WorldMapTemplate",
+      category: "template"
+    },
+    heading: {
+      component: "Typography",
+      importPath: "@/components/atoms/Typography",
+      category: "component"
+    },
+    text: {
+      component: "Typography",
+      importPath: "@/components/atoms/Typography",
+      category: "component"
     }
   }
 };
@@ -8949,7 +10346,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-02-09T10:45:55.417Z",
+  exportedAt: "2026-02-10T15:35:56.769Z",
   contracts: {
     form: {
       emits: [
@@ -8991,17 +10388,31 @@ var event_contracts_default = {
     "form-section": {
       emits: [
         {
-          event: "SAVE",
-          trigger: "submit",
+          event: "GLOBAL_VARIABLE_SET",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "VIOLATION_DETECTED",
+          trigger: "action",
           payload: {
-            type: "FormData"
+            type: "object"
           }
         },
         {
-          event: "CANCEL",
-          trigger: "click",
+          event: "FIELD_CHANGED",
+          trigger: "action",
           payload: {
-            type: "void"
+            type: "object"
+          }
+        },
+        {
+          event: "CLOSE",
+          trigger: "action",
+          payload: {
+            type: "object"
           }
         }
       ],
@@ -9009,7 +10420,7 @@ var event_contracts_default = {
         "SAVE",
         "CANCEL"
       ],
-      entityAware: false
+      entityAware: true
     },
     "form-actions": {
       emits: [
@@ -9422,56 +10833,11 @@ var event_contracts_default = {
       requires: [],
       entityAware: false
     },
-    "game-canvas": {
-      emits: [
-        {
-          event: "MOVE_LEFT",
-          trigger: "keydown",
-          payload: {
-            type: "void"
-          },
-          optional: true
-        },
-        {
-          event: "MOVE_RIGHT",
-          trigger: "keydown",
-          payload: {
-            type: "void"
-          },
-          optional: true
-        },
-        {
-          event: "JUMP",
-          trigger: "keydown",
-          payload: {
-            type: "void"
-          },
-          optional: true
-        },
-        {
-          event: "PAUSE",
-          trigger: "keydown",
-          payload: {
-            type: "void"
-          },
-          optional: true
-        }
-      ],
-      requires: [],
-      entityAware: false,
-      configDriven: true
-    },
     "game-hud": {
       emits: [],
       requires: [],
       entityAware: false
     },
-    "game-controls": {
-      emits: [],
-      requires: [],
-      entityAware: false,
-      configDriven: true
-    },
     "game-menu": {
       emits: [
         {
@@ -9503,21 +10869,6 @@ var event_contracts_default = {
       entityAware: false,
       configDriven: true
     },
-    "game-pause-overlay": {
-      emits: [
-        {
-          event: "RESUME",
-          trigger: "action",
-          payload: {
-            type: "object"
-          }
-        }
-      ],
-      requires: [
-        "RESUME"
-      ],
-      entityAware: false
-    },
     "game-over-screen": {
       emits: [
         {
@@ -9541,24 +10892,6 @@ var event_contracts_default = {
       ],
       entityAware: false
     },
-    "level-select": {
-      emits: [
-        {
-          event: "SELECT_LEVEL",
-          trigger: "click",
-          payload: {
-            type: "EntityRow"
-          }
-        }
-      ],
-      requires: [],
-      entityAware: true
-    },
-    "tilemap-renderer": {
-      emits: [],
-      requires: [],
-      entityAware: false
-    },
     "inventory-panel": {
       emits: [
         {
@@ -9602,55 +10935,6 @@ var event_contracts_default = {
       requires: [],
       entityAware: false
     },
-    "input-listener": {
-      emits: [
-        {
-          event: "KEY_DOWN",
-          trigger: "keydown",
-          payload: {
-            type: "void"
-          }
-        },
-        {
-          event: "KEY_UP",
-          trigger: "keydown",
-          payload: {
-            type: "void"
-          }
-        }
-      ],
-      requires: [],
-      entityAware: false,
-      configDriven: true
-    },
-    "collision-detector": {
-      emits: [
-        {
-          event: "COLLISION_ENTER",
-          trigger: "action",
-          payload: {
-            type: "EntityRow"
-          }
-        },
-        {
-          event: "COLLISION_EXIT",
-          trigger: "action",
-          payload: {
-            type: "EntityRow"
-          }
-        },
-        {
-          event: "TRIGGER_ENTER",
-          trigger: "action",
-          payload: {
-            type: "EntityRow"
-          }
-        }
-      ],
-      requires: [],
-      entityAware: false,
-      configDriven: true
-    },
     "runtime-debugger": {
       emits: [],
       requires: [],
@@ -9928,6 +11212,66 @@ var event_contracts_default = {
       ],
       requires: [],
       entityAware: false
+    },
+    "code-viewer": {
+      emits: [
+        {
+          event: "CODE_COPY",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: true
+    },
+    "document-viewer": {
+      emits: [
+        {
+          event: "DOCUMENT_DOWNLOAD",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "DOCUMENT_PRINT",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "DOCUMENT_PAGE_CHANGE",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: true
+    },
+    "media-gallery": {
+      emits: [
+        {
+          event: "MEDIA_SELECT",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "MEDIA_UPLOAD",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        }
+      ],
+      requires: [],
+      entityAware: true
     }
   }
 };
@@ -9935,220 +11279,125 @@ var event_contracts_default = {
 // src/pattern-types.ts
 var PATTERN_TYPES = [
   "accordion",
-  "activation-block",
-  "admin-dashboard",
-  "agent-chat-panel",
-  "ai-analysis-panel",
+  "action-buttons",
   "alert",
-  "assessment-form",
+  "auth-layout",
   "avatar",
   "badge",
-  "bloom-quiz-block",
-  "board-grid",
-  "body-measurement-input",
+  "battle-template",
   "box",
   "breadcrumb",
   "button",
-  "button-group",
+  "button-pattern",
+  "canvas-effect",
   "card",
-  "card-deck",
-  "card-hand",
-  "card-selector",
-  "care-indicator",
+  "castle-template",
   "center",
+  "chart",
   "checkbox",
-  "checklist",
-  "checklist-item",
-  "code-block",
-  "collision-detector",
-  "companies-list",
-  "company-card",
-  "company-info-card",
-  "compliance-summary",
-  "concept-card",
-  "concept-meta-tags",
-  "conditional-field",
+  "code-viewer",
+  "conditional-wrapper",
   "confirm-dialog",
-  "connection-block",
-  "connections-view",
   "container",
-  "credit-expiration-alert",
-  "credit-meter",
-  "custom",
-  "daily-progress-input",
+  "control-button",
+  "counter-template",
+  "crud-template",
+  "custom-pattern",
+  "d-pad",
   "dashboard-grid",
+  "dashboard-layout",
   "detail-panel",
   "dialogue-box",
   "divider",
-  "document-preview",
+  "document-viewer",
   "drawer",
-  "drawer-container",
+  "drawer-slot",
   "empty-state",
   "entity-cards",
-  "entity-detail",
   "entity-list",
-  "entity-search",
   "entity-table",
   "error-state",
-  "evidence-gallery",
-  "evidence-thumbnail",
-  "exercise-video-link",
   "filter-group",
-  "flash-card",
-  "flash-card-stack",
-  "flash-cards-display",
-  "float-button",
-  "floating-action-menu",
-  "force-directed-graph",
+  "flex",
+  "floating-action-button",
   "form",
-  "form-fields",
+  "form-actions",
+  "form-field",
   "form-section",
-  "game-battle",
-  "game-building-slot",
-  "game-canvas",
-  "game-castle",
-  "game-combat-log",
-  "game-controls",
-  "game-damage-popup",
-  "game-debug-panel",
-  "game-hero-profile",
+  "form-section-header",
+  "form-template",
   "game-hud",
-  "game-isometric-canvas",
   "game-menu",
   "game-over-screen",
-  "game-pause-overlay",
-  "game-recruit-card",
-  "game-resource-bar",
-  "game-trait-slot",
-  "game-trait-viewer",
-  "game-world-map",
-  "garden-view",
-  "graph-intelligence",
-  "graph-legend",
+  "game-shell",
+  "game-template",
+  "generic-app-template",
+  "graph-canvas",
   "grid",
-  "group-session-card",
-  "growth-meter",
-  "harvest-card",
-  "heading",
-  "hstack",
+  "header",
+  "health-bar",
   "icon",
-  "icon-button",
-  "image",
-  "info-display",
   "input",
-  "input-listener",
-  "inspection-card",
-  "inspection-checklist",
-  "inspection-form-demo",
-  "inspection-process",
-  "inspection-summary",
-  "inspection-timeline",
-  "inspection-wizard",
-  "inspection-wizard-step",
-  "inspections-list",
-  "inspector-card",
-  "inspectors-list",
+  "input-group",
   "inventory-panel",
-  "invites-list",
-  "kinesiology-exam-form",
+  "isometric-canvas",
   "label",
-  "law-reference-badge",
-  "layer-navigator",
-  "learning-goal-display",
-  "level-select",
-  "lift-tracker",
-  "link",
+  "law-reference-tooltip",
+  "layout-pattern",
+  "list-template",
   "loading-state",
-  "markdown-content",
   "master-detail",
-  "match3-grid",
-  "meal-plan-card",
+  "media-gallery",
   "menu",
-  "mind-map-canvas",
-  "mind-map-connections",
-  "mind-map-header",
-  "mind-map-node",
+  "meter",
   "modal",
-  "modal-container",
-  "multi-select",
-  "note-content",
-  "note-list",
-  "note-list-item",
+  "modal-slot",
+  "navigation",
   "notification",
-  "nutrition-summary",
-  "objection-recorder",
+  "orbital-visualization",
+  "overlay",
   "page-header",
   "pagination",
-  "participant-list",
-  "pattern-proposal",
-  "phase-indicator",
-  "photo-attachment",
-  "plant-card",
   "popover",
   "progress-bar",
-  "progress-chart",
-  "progress-header",
-  "project-detail",
-  "projects-list",
-  "puzzle-board",
-  "quiz-block",
   "radio",
-  "reflection-block",
-  "relationship-garden",
+  "relation-select",
   "repeatable-form-section",
-  "rule-check-item",
   "runtime-debugger",
-  "schema-diff-viewer",
-  "search-bar",
+  "score-display",
   "search-input",
-  "season-indicator",
-  "seed-network",
-  "segment-renderer",
+  "section",
   "select",
-  "session-scheduler",
-  "shareable-link-generator",
-  "signature",
-  "signature-capture",
+  "settings-template",
+  "side-panel",
+  "sidebar",
+  "signature-pad",
   "simple-grid",
   "spacer",
-  "special-exercise-card",
   "spinner",
-  "split-layout",
+  "split",
+  "split-pane",
+  "sprite",
+  "stack",
+  "stat-badge",
   "stats",
-  "stats-grid",
-  "streaming-display",
-  "studio-home-web-template",
-  "studio-project-template",
-  "suggestions-list",
   "switch",
-  "tab-bar",
-  "tabbed-layout",
+  "tabbed-container",
+  "table",
   "tabs",
-  "team-detail",
-  "team-members-list",
-  "teams-list",
-  "text",
+  "text-highlight",
   "textarea",
-  "tilemap-renderer",
-  "title-only",
-  "todo-list",
+  "theme-toggle",
+  "timeline",
+  "toast-slot",
   "tooltip",
-  "trainee-card",
-  "trainee-comparison",
-  "trust-intelligence",
-  "trust-meter",
-  "turn-indicator",
-  "user-profile",
-  "users-list",
-  "violation-form",
-  "violation-list-item",
-  "vstack",
-  "weather-widget",
-  "weekly-calendar",
+  "typography",
+  "u-i-slot-renderer",
+  "violation-alert",
   "wizard-container",
   "wizard-navigation",
   "wizard-progress",
-  "workout-plan-card"
+  "world-map-template"
 ];
 function isValidPatternType(type) {
   return PATTERN_TYPES.includes(type);