@almadar/patterns 1.0.13 → 1.0.14

package/dist/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-02-09T10:45:55.417Z",
+  "exportedAt": "2026-02-10T05:45:36.769Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -229,12 +229,6 @@
           ],
           "description": "Data array - primary prop for data"
         },
-        "type": {
-          "types": [
-            "string"
-          ],
-          "description": "Entity type name for display"
-        },
         "isLoading": {
           "types": [
             "boolean"
@@ -337,6 +331,12 @@
             "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"
         }
       }
     },
@@ -2535,110 +2535,6 @@
         }
       }
     },
-    "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",
@@ -2693,68 +2589,6 @@
         }
       }
     },
-    "game-controls": {
-      "type": "game-controls",
-      "category": "game",
-      "description": "Touch/button controls for mobile/accessibility",
-      "suggestedFor": [
-        "mobile games",
-        "touch controls"
-      ],
-      "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",
@@ -2822,66 +2656,6 @@
         }
       }
     },
-    "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",
@@ -2964,255 +2738,99 @@
         }
       }
     },
-    "level-select": {
-      "type": "level-select",
+    "inventory-panel": {
+      "type": "inventory-panel",
       "category": "game",
-      "description": "Grid or list of levels to choose from",
+      "description": "Grid-based inventory UI for items, equipment, or resources",
       "suggestedFor": [
-        "level selection",
-        "stage selection"
+        "rpg inventory",
+        "item management",
+        "crafting"
       ],
-      "typicalSize": "large",
+      "typicalSize": "medium",
       "propsSchema": {
-        "levels": {
+        "items": {
           "types": [
             "array"
           ],
-          "description": "Level data"
-        },
-        "entity": {
-          "types": [
-            "string"
-          ],
-          "description": "Entity name (schema config)"
+          "description": "Array of items in inventory",
+          "required": true
         },
-        "layout": {
+        "slots": {
           "types": [
-            "string"
+            "number"
           ],
-          "description": "Layout variant"
+          "description": "Total number of slots",
+          "required": true
         },
-        "fields": {
+        "columns": {
           "types": [
-            "array"
+            "number"
           ],
-          "description": "Fields to display per level"
+          "description": "Number of columns in grid",
+          "required": true
         },
-        "selectEvent": {
+        "selectedSlot": {
           "types": [
-            "string"
+            "number"
           ],
-          "description": "Event to emit on selection (schema config)"
+          "description": "Currently selected slot index"
         },
-        "onSelect": {
+        "onSelectSlot": {
           "types": [
             "function"
           ],
-          "description": "Called when a level is selected"
+          "description": "Called when a slot is selected",
+          "required": true
         },
-        "navigatesTo": {
+        "onUseItem": {
           "types": [
-            "string"
+            "function"
           ],
-          "description": "Path to navigate to on selection. Supports :id, :levelId, :number placeholders"
+          "description": "Called when an item is used (double-click or Enter)"
         },
-        "selectedId": {
+        "onDropItem": {
           "types": [
-            "string"
+            "function"
           ],
-          "description": "Currently selected level ID"
+          "description": "Called when an item is dropped"
         },
-        "maxStars": {
+        "showTooltips": {
           "types": [
-            "number"
+            "boolean"
           ],
-          "description": "Maximum stars possible per level"
+          "description": "Show item tooltips on hover"
         },
         "className": {
           "types": [
             "string"
           ],
-          "description": "Additional CSS classes"
+          "description": "Optional className"
         },
-        "title": {
+        "slotSize": {
           "types": [
-            "string"
+            "number"
           ],
-          "description": "Title above the level grid"
+          "description": "Slot size in pixels"
         }
       }
     },
-    "tilemap-renderer": {
-      "type": "tilemap-renderer",
+    "dialogue-box": {
+      "type": "dialogue-box",
       "category": "game",
-      "description": "Renders tile-based level data from instances with camera following",
+      "description": "RPG-style dialogue box with speaker, portrait, and choices",
       "suggestedFor": [
-        "platformer levels",
-        "tile-based games",
-        "rpg maps"
+        "npc dialogue",
+        "story sequences",
+        "tutorials"
       ],
-      "typicalSize": "large",
+      "typicalSize": "small",
       "propsSchema": {
-        "layers": {
+        "dialogue": {
           "types": [
-            "array"
+            "dialoguenode"
           ],
-          "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",
-      "description": "Grid-based inventory UI for items, equipment, or resources",
-      "suggestedFor": [
-        "rpg inventory",
-        "item management",
-        "crafting"
-      ],
-      "typicalSize": "medium",
-      "propsSchema": {
-        "items": {
-          "types": [
-            "array"
-          ],
-          "description": "Array of items in inventory",
-          "required": true
-        },
-        "slots": {
-          "types": [
-            "number"
-          ],
-          "description": "Total number of slots",
-          "required": true
-        },
-        "columns": {
-          "types": [
-            "number"
-          ],
-          "description": "Number of columns in grid",
-          "required": true
-        },
-        "selectedSlot": {
-          "types": [
-            "number"
-          ],
-          "description": "Currently selected slot index"
-        },
-        "onSelectSlot": {
-          "types": [
-            "function"
-          ],
-          "description": "Called when a slot is selected",
-          "required": true
-        },
-        "onUseItem": {
-          "types": [
-            "function"
-          ],
-          "description": "Called when an item is used (double-click or Enter)"
-        },
-        "onDropItem": {
-          "types": [
-            "function"
-          ],
-          "description": "Called when an item is dropped"
-        },
-        "showTooltips": {
-          "types": [
-            "boolean"
-          ],
-          "description": "Show item tooltips on hover"
-        },
-        "className": {
-          "types": [
-            "string"
-          ],
-          "description": "Optional className"
-        },
-        "slotSize": {
-          "types": [
-            "number"
-          ],
-          "description": "Slot size in pixels"
-        }
-      }
-    },
-    "dialogue-box": {
-      "type": "dialogue-box",
-      "category": "game",
-      "description": "RPG-style dialogue box with speaker, portrait, and choices",
-      "suggestedFor": [
-        "npc dialogue",
-        "story sequences",
-        "tutorials"
-      ],
-      "typicalSize": "small",
-      "propsSchema": {
-        "dialogue": {
-          "types": [
-            "dialoguenode"
-          ],
-          "description": "Current dialogue node to display",
+          "description": "Current dialogue node to display",
           "required": true
         },
         "typewriterSpeed": {
@@ -3253,74 +2871,6 @@
         }
       }
     },
-    "input-listener": {
-      "type": "input-listener",
-      "category": "game",
-      "description": "Invisible component that captures keyboard/mouse input and emits events",
-      "suggestedFor": [
-        "games",
-        "interactive applications",
-        "keyboard shortcuts"
-      ],
-      "typicalSize": "tiny",
-      "propsSchema": {
-        "bindings": {
-          "types": [
-            "unknown"
-          ],
-          "description": "Key bindings configuration"
-        },
-        "enabled": {
-          "types": [
-            "boolean"
-          ],
-          "description": "Whether input listening is enabled"
-        },
-        "eventBus": {
-          "types": [
-            "eventbuscontexttype"
-          ],
-          "description": "Event bus for emitting events (optional, uses hook if not provided)"
-        }
-      }
-    },
-    "collision-detector": {
-      "type": "collision-detector",
-      "category": "game",
-      "description": "Invisible component that runs collision detection and emits collision events",
-      "suggestedFor": [
-        "games",
-        "2D physics",
-        "spatial interactions"
-      ],
-      "typicalSize": "tiny",
-      "propsSchema": {
-        "algorithm": {
-          "types": [
-            "string"
-          ],
-          "description": "Collision detection algorithm"
-        },
-        "rules": {
-          "types": [
-            "unknown"
-          ],
-          "description": "Collision rules to check"
-        },
-        "enabled": {
-          "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",
@@ -3646,12 +3196,6 @@
           ],
           "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"
@@ -3699,6 +3243,12 @@
             "string"
           ],
           "description": "Additional CSS classes"
+        },
+        "progressType": {
+          "types": [
+            "progressbartype"
+          ],
+          "description": "Type of the progress bar (linear, circular, stepped) @default 'linear'"
         }
       }
     },
@@ -3731,12 +3281,6 @@
       ],
       "typicalSize": "tiny",
       "propsSchema": {
-        "type": {
-          "types": [
-            "string"
-          ],
-          "description": "Input type - supports 'select' and 'textarea' in addition to standard types"
-        },
         "error": {
           "types": [
             "string"
@@ -3790,6 +3334,12 @@
             "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"
         }
       }
     },
@@ -4705,13 +4255,6 @@
       ],
       "typicalSize": "small",
       "propsSchema": {
-        "type": {
-          "types": [
-            "highlighttype"
-          ],
-          "description": "Type of highlight (determines color)",
-          "required": true
-        },
         "isActive": {
           "types": [
             "boolean"
@@ -4754,6 +4297,13 @@
           ],
           "description": "Highlighted text content",
           "required": true
+        },
+        "highlightType": {
+          "types": [
+            "highlighttype"
+          ],
+          "description": "Type of highlight (determines color)",
+          "required": true
         }
       }
     },
@@ -7802,6 +7352,1074 @@
           "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 800)"
+        },
+        "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."
+        }
+      }
+    },
+    "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 → feature → unit depth sort) - Camera pan/zoom with lerp - Off-screen culling - Minimap on separate canvas - Sprite sheet animation via resolveUnitFrame - Event bus–friendly 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 — 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."
+        }
+      }
     }
   },
   "categories": [
@@ -7818,6 +8436,8 @@
     "debug",
     "meta",
     "component",
-    "template"
+    "template",
+    "visualization",
+    "media"
   ]
 }