@almadar/patterns 2.5.0 → 2.6.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-03-10T17:18:23.379Z",
+  exportedAt: "2026-03-11T04:10:55.563Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -8860,18 +8860,6 @@ var patterns_registry_default = {
       ],
       typicalSize: "large",
       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"
@@ -8886,63 +8874,15 @@ var patterns_registry_default = {
         },
         error: {
           types: [
-            "object"
+            "error"
           ],
           description: "Error state"
         },
-        sortBy: {
-          types: [
-            "string"
-          ],
-          description: "Current sort field"
-        },
-        sortDirection: {
-          types: [
-            "string"
-          ],
-          description: "Current sort direction"
-        },
-        searchValue: {
-          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"
-        },
         tiles: {
           types: [
             "array"
           ],
-          description: "EntityDisplayProps provides: className, isLoading, error, entity,"
+          description: "--- Grid data ---"
         },
         units: {
           types: [
@@ -8990,19 +8930,19 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "eslint-disable-next-line almadar/organism-no-callback-props"
+          description: "onUnitClick prop"
         },
         onTileHover: {
           types: [
             "function"
           ],
-          description: "eslint-disable-next-line almadar/organism-no-callback-props"
+          description: "onTileHover prop"
         },
         onTileLeave: {
           types: [
             "function"
           ],
-          description: "eslint-disable-next-line almadar/organism-no-callback-props"
+          description: "onTileLeave prop"
         },
         tileClickEvent: {
           types: [
@@ -14383,7 +14323,7 @@ var patterns_registry_default = {
           types: [
             "platformerplayer"
           ],
-          description: "Player entity data"
+          description: "Player state data"
         },
         platforms: {
           types: [
@@ -14480,12 +14420,6 @@ var patterns_registry_default = {
             "string"
           ],
           description: "Additional CSS classes"
-        },
-        entity: {
-          types: [
-            "object"
-          ],
-          description: "Entity data (schema binding)"
         }
       }
     },
@@ -15533,191 +15467,1387 @@ var patterns_registry_default = {
         }
       }
     },
-    heading: {
-      type: "heading",
+    "action-button": {
+      type: "action-button",
       category: "component",
-      description: "Alias for typography \u2014 Typography Atom Component  Text elements following the KFlow design system with theme-aware styling.",
+      description: "ActionButton component",
       suggestedFor: [
-        "typography"
+        "action",
+        "button",
+        "action button"
       ],
       typicalSize: "small",
       propsSchema: {
-        variant: {
+        label: {
           types: [
-            "typographyvariant"
+            "string"
           ],
-          description: "Typography variant"
+          description: "Button label text",
+          required: true
         },
-        level: {
+        icon: {
+          types: [
+            "node"
+          ],
+          description: "Icon displayed before the label"
+        },
+        cooldown: {
           types: [
             "number"
           ],
-          description: "Heading level (1-6) - alternative to variant for headings"
+          description: "Cooldown progress from 0 (ready) to 1 (full cooldown)"
         },
-        color: {
+        disabled: {
           types: [
-            "string"
+            "boolean"
           ],
-          description: "Text color"
+          description: "Whether the button is disabled"
         },
-        align: {
+        hotkey: {
           types: [
             "string"
           ],
-          description: "Text alignment"
+          description: "Keyboard hotkey to display as a badge"
         },
-        weight: {
+        size: {
           types: [
             "string"
           ],
-          description: "Font weight override"
+          description: "Size variant"
         },
-        size: {
+        variant: {
           types: [
-            "typographysize"
+            "string"
           ],
-          description: "Font size override"
+          description: "Visual variant"
         },
-        truncate: {
+        onClick: {
           types: [
-            "boolean"
+            "function"
           ],
-          description: "Truncate with ellipsis (single line)"
+          description: "Click handler"
         },
-        overflow: {
+        className: {
           types: [
             "string"
           ],
-          description: "Overflow handling mode"
-        },
-        as: {
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "choice-button": {
+      type: "choice-button",
+      category: "component",
+      description: "ChoiceButton component",
+      suggestedFor: [
+        "choice",
+        "button",
+        "choice button"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        text: {
           types: [
-            "unknown"
+            "string"
           ],
-          description: "Custom HTML element"
+          description: "Choice text content",
+          required: true
         },
-        id: {
+        index: {
           types: [
-            "string"
+            "number"
           ],
-          description: "HTML id attribute"
+          description: "Choice index number (displayed as prefix)"
         },
-        className: {
+        disabled: {
           types: [
-            "string"
+            "boolean"
           ],
-          description: "Additional class names"
+          description: "Whether the choice is disabled"
         },
-        style: {
+        selected: {
           types: [
-            "object"
+            "boolean"
           ],
-          description: "Inline style"
+          description: "Whether the choice is currently selected"
         },
-        content: {
+        onClick: {
           types: [
-            "node"
+            "function"
           ],
-          description: "Text content (alternative to children)"
+          description: "Click handler"
         },
-        children: {
+        className: {
           types: [
-            "node"
+            "string"
           ],
-          description: "Children elements"
+          description: "Additional CSS classes"
         }
       }
     },
-    text: {
-      type: "text",
+    "combo-counter": {
+      type: "combo-counter",
       category: "component",
-      description: "Alias for typography \u2014 Typography Atom Component  Text elements following the KFlow design system with theme-aware styling.",
+      description: "ComboCounter component",
       suggestedFor: [
-        "typography"
+        "combo",
+        "counter",
+        "combo counter"
       ],
       typicalSize: "small",
       propsSchema: {
-        variant: {
+        combo: {
           types: [
-            "typographyvariant"
+            "number"
           ],
-          description: "Typography variant"
+          description: "Current combo count",
+          required: true
         },
-        level: {
+        multiplier: {
           types: [
             "number"
           ],
-          description: "Heading level (1-6) - alternative to variant for headings"
+          description: "Score multiplier"
         },
-        color: {
+        streak: {
+          types: [
+            "number"
+          ],
+          description: "Current streak"
+        },
+        size: {
           types: [
             "string"
           ],
-          description: "Text color"
+          description: "Size variant"
         },
-        align: {
+        className: {
           types: [
             "string"
           ],
-          description: "Text alignment"
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "damage-number": {
+      type: "damage-number",
+      category: "component",
+      description: "DamageNumber component",
+      suggestedFor: [
+        "damage",
+        "number",
+        "damage number"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        value: {
+          types: [
+            "number"
+          ],
+          description: "The damage/heal value to display",
+          required: true
         },
-        weight: {
+        type: {
           types: [
             "string"
           ],
-          description: "Font weight override"
+          description: "Type of number display"
         },
         size: {
           types: [
-            "typographysize"
+            "string"
           ],
-          description: "Font size override"
+          description: "Size variant"
         },
-        truncate: {
+        className: {
           types: [
-            "boolean"
+            "string"
           ],
-          description: "Truncate with ellipsis (single line)"
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "dialogue-bubble": {
+      type: "dialogue-bubble",
+      category: "game",
+      description: "DialogueBubble component",
+      suggestedFor: [
+        "dialogue",
+        "bubble",
+        "dialogue bubble"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        speaker: {
+          types: [
+            "string"
+          ],
+          description: "Speaker name displayed at the top"
         },
-        overflow: {
+        text: {
           types: [
             "string"
           ],
-          description: "Overflow handling mode"
+          description: "Dialogue text content",
+          required: true
         },
-        as: {
+        portrait: {
           types: [
-            "unknown"
+            "string"
           ],
-          description: "Custom HTML element"
+          description: "URL for the speaker portrait image"
         },
-        id: {
+        position: {
           types: [
             "string"
           ],
-          description: "HTML id attribute"
+          description: "Position of the bubble on screen"
         },
         className: {
           types: [
             "string"
           ],
-          description: "Additional class names"
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "item-slot": {
+      type: "item-slot",
+      category: "layout",
+      description: "ItemSlot component",
+      suggestedFor: [
+        "item",
+        "slot",
+        "item slot"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        icon: {
+          types: [
+            "node"
+          ],
+          description: "Icon component or emoji"
         },
-        style: {
+        label: {
           types: [
-            "object"
+            "string"
           ],
-          description: "Inline style"
+          description: "Item label"
         },
-        content: {
+        quantity: {
           types: [
-            "node"
+            "number"
           ],
-          description: "Text content (alternative to children)"
+          description: "Stack quantity"
         },
-        children: {
+        rarity: {
           types: [
-            "node"
+            "string"
+          ],
+          description: "Rarity tier affecting border color"
+        },
+        empty: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether the slot is empty"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size variant"
+        },
+        selected: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether the slot is selected"
+        },
+        onClick: {
+          types: [
+            "function"
+          ],
+          description: "Click handler"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "mini-map": {
+      type: "mini-map",
+      category: "component",
+      description: "MiniMap component",
+      suggestedFor: [
+        "mini",
+        "map",
+        "mini map"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Tile data: each tile renders as a 1px dot at (x,y) with the given color"
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Unit positions: each unit renders as a 2px dot"
+        },
+        width: {
+          types: [
+            "number"
+          ],
+          description: "Canvas display width in pixels"
+        },
+        height: {
+          types: [
+            "number"
+          ],
+          description: "Canvas display height in pixels"
+        },
+        mapWidth: {
+          types: [
+            "number"
+          ],
+          description: "Logical map width (for coordinate scaling)"
+        },
+        mapHeight: {
+          types: [
+            "number"
+          ],
+          description: "Logical map height (for coordinate scaling)"
+        },
+        viewportRect: {
+          types: [
+            "object"
+          ],
+          description: "Viewport rectangle outline"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "resource-counter": {
+      type: "resource-counter",
+      category: "component",
+      description: "ResourceCounter component",
+      suggestedFor: [
+        "resource",
+        "counter",
+        "resource counter"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        icon: {
+          types: [
+            "node"
+          ],
+          description: "Icon component or emoji"
+        },
+        label: {
+          types: [
+            "string"
+          ],
+          description: "Resource label",
+          required: true
+        },
+        value: {
+          types: [
+            "number"
+          ],
+          description: "Current value",
+          required: true
+        },
+        max: {
+          types: [
+            "number"
+          ],
+          description: "Maximum value"
+        },
+        color: {
+          types: [
+            "string"
+          ],
+          description: "Accent color class (e.g. 'text-yellow-400')"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size variant"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "status-effect": {
+      type: "status-effect",
+      category: "display",
+      description: "StatusEffect component",
+      suggestedFor: [
+        "status",
+        "effect",
+        "status effect"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        icon: {
+          types: [
+            "node"
+          ],
+          description: "Icon to display for the effect",
+          required: true
+        },
+        label: {
+          types: [
+            "string"
+          ],
+          description: "Label describing the effect"
+        },
+        duration: {
+          types: [
+            "number"
+          ],
+          description: "Remaining duration in seconds"
+        },
+        stacks: {
+          types: [
+            "number"
+          ],
+          description: "Number of stacks"
+        },
+        variant: {
+          types: [
+            "string"
+          ],
+          description: "Effect type"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size variant"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "timer-display": {
+      type: "timer-display",
+      category: "component",
+      description: "TimerDisplay component",
+      suggestedFor: [
+        "timer",
+        "display",
+        "timer display"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        seconds: {
+          types: [
+            "number"
+          ],
+          description: "Time in seconds",
+          required: true
+        },
+        running: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether the timer is running"
+        },
+        format: {
+          types: [
+            "string"
+          ],
+          description: "Display format"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size variant"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        },
+        lowThreshold: {
+          types: [
+            "number"
+          ],
+          description: "Seconds below which to pulse red"
+        }
+      }
+    },
+    "turn-indicator": {
+      type: "turn-indicator",
+      category: "component",
+      description: "TurnIndicator component",
+      suggestedFor: [
+        "turn",
+        "indicator",
+        "turn indicator"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        currentTurn: {
+          types: [
+            "number"
+          ],
+          description: "Current turn number",
+          required: true
+        },
+        maxTurns: {
+          types: [
+            "number"
+          ],
+          description: "Maximum number of turns"
+        },
+        activeTeam: {
+          types: [
+            "string"
+          ],
+          description: "Name of the active team"
+        },
+        phase: {
+          types: [
+            "string"
+          ],
+          description: "Current phase label"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size variant"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "waypoint-marker": {
+      type: "waypoint-marker",
+      category: "component",
+      description: "WaypointMarker component",
+      suggestedFor: [
+        "waypoint",
+        "marker",
+        "waypoint marker"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        label: {
+          types: [
+            "string"
+          ],
+          description: "Label text below the marker"
+        },
+        icon: {
+          types: [
+            "node"
+          ],
+          description: "Custom icon to render inside the marker"
+        },
+        active: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether this waypoint is currently active"
+        },
+        completed: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether this waypoint has been completed"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size variant"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "x-p-bar": {
+      type: "x-p-bar",
+      category: "component",
+      description: "XPBar component",
+      suggestedFor: [
+        "bar",
+        "x p bar"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        current: {
+          types: [
+            "number"
+          ],
+          description: "Current XP value",
+          required: true
+        },
+        max: {
+          types: [
+            "number"
+          ],
+          description: "XP needed for next level",
+          required: true
+        },
+        level: {
+          types: [
+            "number"
+          ],
+          description: "Current level"
+        },
+        showLabel: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether to show the XP label"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size variant"
+        },
+        animated: {
+          types: [
+            "boolean"
+          ],
+          description: "Animate the fill bar"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "crafting-recipe": {
+      type: "crafting-recipe",
+      category: "component",
+      description: "CraftingRecipe component",
+      suggestedFor: [
+        "crafting",
+        "recipe",
+        "crafting recipe"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        inputs: {
+          types: [
+            "array"
+          ],
+          description: "Input ingredients for the recipe",
+          required: true
+        },
+        output: {
+          types: [
+            "object"
+          ],
+          description: "Output item produced by the recipe",
+          required: true
+        },
+        canCraft: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether the player has enough ingredients to craft"
+        },
+        onCraft: {
+          types: [
+            "function"
+          ],
+          description: "Callback when the craft button is clicked"
+        },
+        craftEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event bus event name for crafting"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "enemy-plate": {
+      type: "enemy-plate",
+      category: "component",
+      description: "EnemyPlate component",
+      suggestedFor: [
+        "enemy",
+        "plate",
+        "enemy plate"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        name: {
+          types: [
+            "string"
+          ],
+          description: "Enemy name",
+          required: true
+        },
+        health: {
+          types: [
+            "number"
+          ],
+          description: "Current health",
+          required: true
+        },
+        maxHealth: {
+          types: [
+            "number"
+          ],
+          description: "Maximum health",
+          required: true
+        },
+        level: {
+          types: [
+            "number"
+          ],
+          description: "Enemy level"
+        },
+        effects: {
+          types: [
+            "array"
+          ],
+          description: "Active status effects"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "game-canvas2-d": {
+      type: "game-canvas2-d",
+      category: "game",
+      description: "GameCanvas2D component",
+      suggestedFor: [
+        "game",
+        "canvas2",
+        "game canvas2 d"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        width: {
+          types: [
+            "number"
+          ],
+          description: "Canvas width in pixels"
+        },
+        height: {
+          types: [
+            "number"
+          ],
+          description: "Canvas height in pixels"
+        },
+        onDraw: {
+          types: [
+            "function"
+          ],
+          description: "Called each frame with the 2D context and current frame count"
+        },
+        onTick: {
+          types: [
+            "function"
+          ],
+          description: "Called each tick with delta time in seconds"
+        },
+        fps: {
+          types: [
+            "number"
+          ],
+          description: "Target frames per second"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "health-panel": {
+      type: "health-panel",
+      category: "component",
+      description: "HealthPanel component",
+      suggestedFor: [
+        "health",
+        "panel",
+        "health panel"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        current: {
+          types: [
+            "number"
+          ],
+          description: "Current health value",
+          required: true
+        },
+        max: {
+          types: [
+            "number"
+          ],
+          description: "Maximum health value",
+          required: true
+        },
+        shield: {
+          types: [
+            "number"
+          ],
+          description: "Shield/armor points"
+        },
+        label: {
+          types: [
+            "string"
+          ],
+          description: "Label shown above the bar"
+        },
+        effects: {
+          types: [
+            "array"
+          ],
+          description: "Active status effects displayed as small badges"
+        },
+        showNumbers: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether to display numeric HP values"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size variant"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "inventory-grid": {
+      type: "inventory-grid",
+      category: "game",
+      description: "InventoryGrid component",
+      suggestedFor: [
+        "inventory",
+        "grid",
+        "inventory grid"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        items: {
+          types: [
+            "array"
+          ],
+          description: "Array of items to display in the grid",
+          required: true
+        },
+        columns: {
+          types: [
+            "number"
+          ],
+          description: "Number of columns in the grid"
+        },
+        totalSlots: {
+          types: [
+            "number"
+          ],
+          description: "Total number of slots (empty slots fill remaining space)"
+        },
+        selectedId: {
+          types: [
+            "string"
+          ],
+          description: "Currently selected item ID"
+        },
+        onSelect: {
+          types: [
+            "function"
+          ],
+          description: "Callback when an item is selected"
+        },
+        selectEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event bus event name for selection"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size variant for all item slots"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "powerup-slots": {
+      type: "powerup-slots",
+      category: "layout",
+      description: "PowerupSlots component",
+      suggestedFor: [
+        "powerup",
+        "slots",
+        "powerup slots"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        active: {
+          types: [
+            "array"
+          ],
+          description: "Array of active powerups",
+          required: true
+        },
+        maxSlots: {
+          types: [
+            "number"
+          ],
+          description: "Maximum number of powerup slots"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "quest-tracker": {
+      type: "quest-tracker",
+      category: "component",
+      description: "QuestTracker component",
+      suggestedFor: [
+        "quest",
+        "tracker",
+        "quest tracker"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        quests: {
+          types: [
+            "array"
+          ],
+          description: "Array of quests to display",
+          required: true
+        },
+        activeQuestId: {
+          types: [
+            "string"
+          ],
+          description: "ID of the currently active quest"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "resource-bar": {
+      type: "resource-bar",
+      category: "component",
+      description: "ResourceBar component",
+      suggestedFor: [
+        "resource",
+        "bar",
+        "resource bar"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        resources: {
+          types: [
+            "array"
+          ],
+          description: "Resources to display",
+          required: true
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size variant"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "score-board": {
+      type: "score-board",
+      category: "game",
+      description: "ScoreBoard component",
+      suggestedFor: [
+        "score",
+        "board",
+        "score board"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        score: {
+          types: [
+            "number"
+          ],
+          description: "Current score",
+          required: true
+        },
+        highScore: {
+          types: [
+            "number"
+          ],
+          description: "All-time high score"
+        },
+        combo: {
+          types: [
+            "number"
+          ],
+          description: "Current combo count"
+        },
+        multiplier: {
+          types: [
+            "number"
+          ],
+          description: "Score multiplier"
+        },
+        level: {
+          types: [
+            "number"
+          ],
+          description: "Current level"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "turn-panel": {
+      type: "turn-panel",
+      category: "component",
+      description: "TurnPanel component",
+      suggestedFor: [
+        "turn",
+        "panel",
+        "turn panel"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        currentTurn: {
+          types: [
+            "number"
+          ],
+          description: "Current turn number",
+          required: true
+        },
+        maxTurns: {
+          types: [
+            "number"
+          ],
+          description: "Maximum number of turns"
+        },
+        phase: {
+          types: [
+            "string"
+          ],
+          description: "Current phase label"
+        },
+        activeTeam: {
+          types: [
+            "string"
+          ],
+          description: "Active team name"
+        },
+        actions: {
+          types: [
+            "array"
+          ],
+          description: "Action buttons to display"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    "unit-command-bar": {
+      type: "unit-command-bar",
+      category: "component",
+      description: "UnitCommandBar component",
+      suggestedFor: [
+        "unit",
+        "command",
+        "bar",
+        "unit command bar"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        commands: {
+          types: [
+            "array"
+          ],
+          description: "Available commands",
+          required: true
+        },
+        selectedUnitId: {
+          types: [
+            "string"
+          ],
+          description: "ID of the currently selected unit"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        }
+      }
+    },
+    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"
+        },
+        style: {
+          types: [
+            "object"
+          ],
+          description: "Inline style"
+        },
+        content: {
+          types: [
+            "node"
+          ],
+          description: "Text content (alternative to children)"
+        },
+        children: {
+          types: [
+            "node"
           ],
           description: "Children elements"
         }
@@ -16349,7 +17479,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-03-10T17:18:23.379Z",
+  exportedAt: "2026-03-11T04:10:55.563Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -17439,6 +18569,126 @@ var component_mapping_default = {
       importPath: "@/components/molecules/SwipeableRow",
       category: "component"
     },
+    "action-button": {
+      component: "ActionButton",
+      importPath: "@/components/atoms/ActionButton",
+      category: "component"
+    },
+    "choice-button": {
+      component: "ChoiceButton",
+      importPath: "@/components/atoms/ChoiceButton",
+      category: "component"
+    },
+    "combo-counter": {
+      component: "ComboCounter",
+      importPath: "@/components/atoms/ComboCounter",
+      category: "component"
+    },
+    "damage-number": {
+      component: "DamageNumber",
+      importPath: "@/components/atoms/DamageNumber",
+      category: "component"
+    },
+    "dialogue-bubble": {
+      component: "DialogueBubble",
+      importPath: "@/components/atoms/DialogueBubble",
+      category: "game"
+    },
+    "item-slot": {
+      component: "ItemSlot",
+      importPath: "@/components/atoms/ItemSlot",
+      category: "layout"
+    },
+    "mini-map": {
+      component: "MiniMap",
+      importPath: "@/components/atoms/MiniMap",
+      category: "component"
+    },
+    "resource-counter": {
+      component: "ResourceCounter",
+      importPath: "@/components/atoms/ResourceCounter",
+      category: "component"
+    },
+    "status-effect": {
+      component: "StatusEffect",
+      importPath: "@/components/atoms/StatusEffect",
+      category: "display"
+    },
+    "timer-display": {
+      component: "TimerDisplay",
+      importPath: "@/components/atoms/TimerDisplay",
+      category: "component"
+    },
+    "turn-indicator": {
+      component: "TurnIndicator",
+      importPath: "@/components/atoms/TurnIndicator",
+      category: "component"
+    },
+    "waypoint-marker": {
+      component: "WaypointMarker",
+      importPath: "@/components/atoms/WaypointMarker",
+      category: "component"
+    },
+    "x-p-bar": {
+      component: "XPBar",
+      importPath: "@/components/atoms/XPBar",
+      category: "component"
+    },
+    "crafting-recipe": {
+      component: "CraftingRecipe",
+      importPath: "@/components/molecules/CraftingRecipe",
+      category: "component"
+    },
+    "enemy-plate": {
+      component: "EnemyPlate",
+      importPath: "@/components/molecules/EnemyPlate",
+      category: "component"
+    },
+    "game-canvas2-d": {
+      component: "GameCanvas2D",
+      importPath: "@/components/molecules/GameCanvas2D",
+      category: "game"
+    },
+    "health-panel": {
+      component: "HealthPanel",
+      importPath: "@/components/molecules/HealthPanel",
+      category: "component"
+    },
+    "inventory-grid": {
+      component: "InventoryGrid",
+      importPath: "@/components/molecules/InventoryGrid",
+      category: "game"
+    },
+    "powerup-slots": {
+      component: "PowerupSlots",
+      importPath: "@/components/molecules/PowerupSlots",
+      category: "layout"
+    },
+    "quest-tracker": {
+      component: "QuestTracker",
+      importPath: "@/components/molecules/QuestTracker",
+      category: "component"
+    },
+    "resource-bar": {
+      component: "ResourceBar",
+      importPath: "@/components/molecules/ResourceBar",
+      category: "component"
+    },
+    "score-board": {
+      component: "ScoreBoard",
+      importPath: "@/components/molecules/ScoreBoard",
+      category: "game"
+    },
+    "turn-panel": {
+      component: "TurnPanel",
+      importPath: "@/components/molecules/TurnPanel",
+      category: "component"
+    },
+    "unit-command-bar": {
+      component: "UnitCommandBar",
+      importPath: "@/components/molecules/UnitCommandBar",
+      category: "component"
+    },
     heading: {
       component: "Typography",
       importPath: "@/components/atoms/Typography",
@@ -17455,7 +18705,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-03-10T17:18:23.379Z",
+  exportedAt: "2026-03-11T04:10:55.563Z",
   contracts: {
     form: {
       emits: [
@@ -18587,7 +19837,7 @@ var event_contracts_default = {
         }
       ],
       requires: [],
-      entityAware: true
+      entityAware: false
     },
     "trait-slot": {
       emits: [