@almadar/patterns 2.46.0 → 2.47.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-17T02:56:15.601Z",
+  exportedAt: "2026-06-17T08:23:54.917Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -41919,7 +41919,7 @@ var patterns_registry_default = {
     "feature-renderer": {
       type: "feature-renderer",
       category: "game",
-      tier: "organisms",
+      tier: "molecules",
       family: "game",
       description: "FeatureRenderer component",
       suggestedFor: [
@@ -43242,434 +43242,2236 @@ var patterns_registry_default = {
             ]
           }
         },
-        fields: {
+        fields: {
+          types: [
+            "array"
+          ],
+          description: "Alias for `columns`.",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              key: {
+                types: [
+                  "string"
+                ]
+              },
+              field: {
+                types: [
+                  "string"
+                ]
+              },
+              header: {
+                types: [
+                  "string"
+                ]
+              },
+              label: {
+                types: [
+                  "string"
+                ]
+              },
+              width: {
+                types: [
+                  "string"
+                ]
+              },
+              align: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "left",
+                  "center",
+                  "right"
+                ]
+              },
+              className: {
+                types: [
+                  "string"
+                ]
+              },
+              weight: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "normal",
+                  "medium",
+                  "semibold"
+                ]
+              },
+              format: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "badge",
+                  "date",
+                  "currency",
+                  "number",
+                  "percent",
+                  "boolean"
+                ]
+              },
+              icon: {
+                types: [
+                  "icon",
+                  "string"
+                ]
+              },
+              sortable: {
+                types: [
+                  "boolean"
+                ]
+              }
+            },
+            required: [
+              "key"
+            ]
+          }
+        },
+        itemActions: {
+          types: [
+            "array"
+          ],
+          description: "Per-row action buttons (trailing column).",
+          kind: "event-list",
+          eventField: "event",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              label: {
+                types: [
+                  "string"
+                ]
+              },
+              event: {
+                types: [
+                  "string"
+                ]
+              },
+              icon: {
+                types: [
+                  "icon",
+                  "string"
+                ]
+              },
+              variant: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "primary",
+                  "secondary",
+                  "ghost",
+                  "danger"
+                ]
+              }
+            },
+            required: [
+              "label",
+              "event"
+            ]
+          }
+        },
+        maxInlineActions: {
+          types: [
+            "number"
+          ],
+          description: 'Max inline action buttons before the rest collapse into a "\u22EF" overflow menu. Omit = all inline.'
+        },
+        selectable: {
+          types: [
+            "boolean"
+          ],
+          description: "Render a leading checkbox column. Selection changes emit `selectEvent`.",
+          default: false
+        },
+        selectEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event emitted on selection change: UI:{selectEvent} with { ids, rows }.",
+          kind: "event"
+        },
+        selectedIds: {
+          types: [
+            "array"
+          ],
+          description: "Currently-selected ids (controlled). Falls back to local state when omitted.",
+          items: {
+            types: [
+              "string"
+            ]
+          }
+        },
+        sortEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event emitted on sortable-header click: UI:{sortEvent} with { column, direction }.",
+          kind: "event"
+        },
+        sortColumn: {
+          types: [
+            "string"
+          ],
+          description: "Current sort column (display hint for the active header arrow)."
+        },
+        sortDirection: {
+          types: [
+            "string"
+          ],
+          description: "Current sort direction (display hint).",
+          enumValues: [
+            "asc",
+            "desc"
+          ]
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes applied to the table root."
+        },
+        emptyMessage: {
+          types: [
+            "string"
+          ],
+          description: "Message shown when there are no rows."
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state.",
+          default: false
+        },
+        error: {
+          types: [
+            "object"
+          ],
+          description: "Error state.",
+          properties: {
+            message: {
+              types: [
+                "string"
+              ]
+            },
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            code: {
+              types: [
+                "string"
+              ]
+            },
+            stack: {
+              types: [
+                "string"
+              ]
+            }
+          },
+          propertyRequired: [
+            "message"
+          ],
+          default: null
+        },
+        groupBy: {
+          types: [
+            "string"
+          ],
+          description: "Group rows under section headers by a field value."
+        },
+        pageSize: {
+          types: [
+            "number"
+          ],
+          description: 'Max rows before a "Show More" button. Defaults to 0 (show all).',
+          default: 0
+        },
+        children: {
+          types: [
+            "function"
+          ],
+          description: "Custom per-row render. When provided, the whole row content is delegated to this function (columns are ignored for the body; the header still renders). Mirrors DataList's children render prop.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "item",
+              type: "object"
+            },
+            {
+              name: "index",
+              type: "number"
+            }
+          ],
+          renderCallback: true
+        },
+        renderItem: {
+          types: [
+            "function"
+          ],
+          description: 'Per-row render function (schema alias). In .orb: ["fn","item",{...}]. The compiler converts this to the children render prop.',
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "item",
+              type: "object"
+            },
+            {
+              name: "index",
+              type: "number"
+            }
+          ],
+          renderCallback: true
+        },
+        look: {
+          types: [
+            "string"
+          ],
+          description: "Layer 2 visual treatment \u2014 mirrors the data-list / entity-table look enum so authors share one knob name across row renderers.",
+          enumValues: [
+            "dense",
+            "spacious",
+            "striped",
+            "borderless",
+            "bordered"
+          ],
+          default: "dense"
+        }
+      }
+    },
+    "step-flow": {
+      type: "step-flow",
+      category: "component",
+      tier: "molecules",
+      family: "marketing",
+      description: "StepFlow component",
+      suggestedFor: [
+        "step",
+        "flow",
+        "step flow"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        steps: {
+          types: [
+            "array"
+          ],
+          description: "steps prop",
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              number: {
+                types: [
+                  "number"
+                ]
+              },
+              title: {
+                types: [
+                  "string"
+                ]
+              },
+              description: {
+                types: [
+                  "string"
+                ]
+              },
+              icon: {
+                types: [
+                  "icon",
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "title",
+              "description"
+            ]
+          }
+        },
+        orientation: {
+          types: [
+            "string"
+          ],
+          description: "orientation prop",
+          enumValues: [
+            "horizontal",
+            "vertical"
+          ],
+          default: "horizontal"
+        },
+        showConnectors: {
+          types: [
+            "boolean"
+          ],
+          description: "showConnectors prop",
+          default: true
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
+    },
+    "stat-card": {
+      type: "stat-card",
+      category: "display",
+      tier: "atoms",
+      family: "marketing",
+      description: "StatCard component",
+      suggestedFor: [
+        "stat",
+        "card",
+        "stat card"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        value: {
+          types: [
+            "string"
+          ],
+          description: "The stat value to display prominently",
+          required: true
+        },
+        label: {
+          types: [
+            "string"
+          ],
+          description: "Label describing the value",
+          required: true
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Size of the value text",
+          enumValues: [
+            "sm",
+            "md",
+            "lg"
+          ],
+          default: "md"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional class names"
+        }
+      }
+    },
+    "game-canvas-3d": {
+      type: "game-canvas-3d",
+      category: "game",
+      tier: "molecules",
+      family: "game",
+      description: "Props for GameCanvas3D component",
+      suggestedFor: [
+        "game",
+        "canvas3",
+        "game canvas3 d"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        className: {
+          types: [
+            "string"
+          ],
+          description: "--- Closed-circuit props (MANDATORY) ---"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Children to render inside the 3D canvas (e.g., physics objects, custom meshes)"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state indicator"
+        },
+        error: {
+          types: [
+            "string"
+          ],
+          description: "Error state"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Entity name for schema-driven auto-fetch"
+        },
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Array of tiles to render",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              y: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              },
+              terrain: {
+                types: [
+                  "string"
+                ]
+              },
+              type: {
+                types: [
+                  "string"
+                ]
+              },
+              terrainSprite: {
+                types: [
+                  "asset"
+                ]
+              },
+              passable: {
+                types: [
+                  "boolean"
+                ]
+              },
+              movementCost: {
+                types: [
+                  "number"
+                ]
+              },
+              tileType: {
+                types: [
+                  "string"
+                ]
+              },
+              elevation: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "x",
+              "y"
+            ]
+          },
+          default: []
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Array of units to render",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              position: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  x: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  y: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "x",
+                  "y"
+                ]
+              },
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              y: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              },
+              sprite: {
+                types: [
+                  "object"
+                ]
+              },
+              unitType: {
+                types: [
+                  "string"
+                ]
+              },
+              heroId: {
+                types: [
+                  "string"
+                ]
+              },
+              name: {
+                types: [
+                  "string"
+                ]
+              },
+              team: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "player",
+                  "enemy",
+                  "neutral"
+                ]
+              },
+              faction: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "player",
+                  "enemy",
+                  "neutral"
+                ]
+              },
+              health: {
+                types: [
+                  "number"
+                ]
+              },
+              maxHealth: {
+                types: [
+                  "number"
+                ]
+              },
+              traits: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "object"
+                  ],
+                  properties: {
+                    name: {
+                      types: [
+                        "string"
+                      ]
+                    },
+                    currentState: {
+                      types: [
+                        "string"
+                      ]
+                    },
+                    states: {
+                      types: [
+                        "array"
+                      ],
+                      items: {
+                        types: [
+                          "string"
+                        ]
+                      }
+                    },
+                    cooldown: {
+                      types: [
+                        "number"
+                      ]
+                    }
+                  },
+                  required: [
+                    "name",
+                    "currentState",
+                    "states",
+                    "cooldown"
+                  ]
+                }
+              },
+              previousPosition: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  x: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  y: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "x",
+                  "y"
+                ]
+              },
+              elevation: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "id"
+            ]
+          },
+          default: []
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Array of features to render",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              y: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              },
+              type: {
+                types: [
+                  "string"
+                ]
+              },
+              sprite: {
+                types: [
+                  "object"
+                ]
+              },
+              assetUrl: {
+                types: [
+                  "object"
+                ]
+              },
+              color: {
+                types: [
+                  "string"
+                ]
+              },
+              elevation: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "x",
+              "y",
+              "type"
+            ]
+          },
+          default: []
+        },
+        events: {
+          types: [
+            "array"
+          ],
+          description: "Array of events to display",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              type: {
+                types: [
+                  "string"
+                ]
+              },
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              },
+              y: {
+                types: [
+                  "number"
+                ]
+              },
+              message: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "id",
+              "type",
+              "x"
+            ]
+          },
+          default: []
+        },
+        fogOfWar: {
+          types: [
+            "array"
+          ],
+          description: "Fog of war data",
+          items: {
+            types: [
+              "array"
+            ],
+            items: {
+              types: [
+                "boolean"
+              ]
+            }
+          }
+        },
+        orientation: {
+          types: [
+            "string"
+          ],
+          description: "Map orientation",
+          enumValues: [
+            "standard",
+            "rotated"
+          ],
+          default: "standard"
+        },
+        cameraMode: {
+          types: [
+            "string"
+          ],
+          description: "Camera mode",
+          enumValues: [
+            "isometric",
+            "perspective",
+            "top-down"
+          ],
+          default: "isometric"
+        },
+        showGrid: {
+          types: [
+            "boolean"
+          ],
+          description: "Show grid",
+          default: true
+        },
+        showCoordinates: {
+          types: [
+            "boolean"
+          ],
+          description: "Show coordinates overlay",
+          default: false
+        },
+        showTileInfo: {
+          types: [
+            "boolean"
+          ],
+          description: "Show tile information",
+          default: false
+        },
+        overlay: {
+          types: [
+            "string"
+          ],
+          description: "Overlay control mode",
+          enumValues: [
+            "default",
+            "hidden",
+            "minimap"
+          ],
+          default: "default"
+        },
+        shadows: {
+          types: [
+            "boolean"
+          ],
+          description: "Enable shadows",
+          default: true
+        },
+        backgroundColor: {
+          types: [
+            "string"
+          ],
+          description: "Background color",
+          default: "#1a1a2e"
+        },
+        onTileClick: {
+          types: [
+            "function"
+          ],
+          description: "Callback when a tile is clicked",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "tile",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  id: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  x: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  y: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  z: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  terrain: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  type: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  terrainSprite: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  passable: {
+                    types: [
+                      "boolean"
+                    ]
+                  },
+                  movementCost: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  tileType: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  elevation: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "x",
+                  "y"
+                ]
+              }
+            },
+            {
+              name: "event",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        onUnitClick: {
+          types: [
+            "function"
+          ],
+          description: "Callback when a unit is clicked",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "unit",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  id: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  position: {
+                    types: [
+                      "object"
+                    ],
+                    properties: {
+                      x: {
+                        types: [
+                          "number"
+                        ]
+                      },
+                      y: {
+                        types: [
+                          "number"
+                        ]
+                      }
+                    },
+                    required: [
+                      "x",
+                      "y"
+                    ]
+                  },
+                  x: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  y: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  z: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "object"
+                    ]
+                  },
+                  unitType: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  heroId: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  name: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  team: {
+                    types: [
+                      "string"
+                    ],
+                    enumValues: [
+                      "player",
+                      "enemy",
+                      "neutral"
+                    ]
+                  },
+                  faction: {
+                    types: [
+                      "string"
+                    ],
+                    enumValues: [
+                      "player",
+                      "enemy",
+                      "neutral"
+                    ]
+                  },
+                  health: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  maxHealth: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  traits: {
+                    types: [
+                      "array"
+                    ],
+                    items: {
+                      types: [
+                        "object"
+                      ],
+                      properties: {
+                        name: {
+                          types: [
+                            "string"
+                          ]
+                        },
+                        currentState: {
+                          types: [
+                            "string"
+                          ]
+                        },
+                        states: {
+                          types: [
+                            "array"
+                          ],
+                          items: {
+                            types: [
+                              "string"
+                            ]
+                          }
+                        },
+                        cooldown: {
+                          types: [
+                            "number"
+                          ]
+                        }
+                      },
+                      required: [
+                        "name",
+                        "currentState",
+                        "states",
+                        "cooldown"
+                      ]
+                    }
+                  },
+                  previousPosition: {
+                    types: [
+                      "object"
+                    ],
+                    properties: {
+                      x: {
+                        types: [
+                          "number"
+                        ]
+                      },
+                      y: {
+                        types: [
+                          "number"
+                        ]
+                      }
+                    },
+                    required: [
+                      "x",
+                      "y"
+                    ]
+                  },
+                  elevation: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "id"
+                ]
+              }
+            },
+            {
+              name: "event",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        onFeatureClick: {
+          types: [
+            "function"
+          ],
+          description: "Callback when a feature is clicked",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "feature",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  id: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  x: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  y: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  z: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  type: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  sprite: {
+                    types: [
+                      "object"
+                    ]
+                  },
+                  assetUrl: {
+                    types: [
+                      "object"
+                    ]
+                  },
+                  color: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  elevation: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "x",
+                  "y",
+                  "type"
+                ]
+              }
+            },
+            {
+              name: "event",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        onCanvasClick: {
+          types: [
+            "function"
+          ],
+          description: "Callback when canvas is clicked (background)",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "event",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        onTileHover: {
+          types: [
+            "function"
+          ],
+          description: "Callback when mouse moves over a tile",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "tile",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  id: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  x: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  y: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  z: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  terrain: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  type: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  terrainSprite: {
+                    types: [
+                      "asset"
+                    ]
+                  },
+                  passable: {
+                    types: [
+                      "boolean"
+                    ]
+                  },
+                  movementCost: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  tileType: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  elevation: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "x",
+                  "y"
+                ]
+              }
+            },
+            {
+              name: "event",
+              type: "object"
+            }
+          ],
+          nonEmittable: true
+        },
+        onUnitAnimation: {
+          types: [
+            "function"
+          ],
+          description: "Callback for unit animation state change",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "unitId",
+              type: "string"
+            },
+            {
+              name: "state",
+              type: "string"
+            }
+          ]
+        },
+        assetLoader: {
+          types: [
+            "object"
+          ],
+          description: "Asset loader instance (uses global singleton if not provided)"
+        },
+        tileRenderer: {
+          types: [
+            "object"
+          ],
+          description: "Custom tile renderer component"
+        },
+        unitRenderer: {
+          types: [
+            "object"
+          ],
+          description: "Custom unit renderer component"
+        },
+        featureRenderer: {
+          types: [
+            "object"
+          ],
+          description: "Custom feature renderer component"
+        },
+        preloadAssets: {
+          types: [
+            "array"
+          ],
+          description: "URLs to preload",
+          items: {
+            types: [
+              "string"
+            ]
+          },
+          default: []
+        },
+        tileClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event: tile click",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "tileId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "x",
+              type: "number",
+              required: true
+            },
+            {
+              name: "z",
+              type: "number",
+              required: true
+            },
+            {
+              name: "type",
+              type: "string",
+              required: false
+            },
+            {
+              name: "terrain",
+              type: "string",
+              required: false
+            },
+            {
+              name: "elevation",
+              type: "number",
+              required: false
+            }
+          ]
+        },
+        unitClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event: unit click",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "unitId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "x",
+              type: "number",
+              required: true
+            },
+            {
+              name: "z",
+              type: "number",
+              required: true
+            },
+            {
+              name: "unitType",
+              type: "string",
+              required: false
+            },
+            {
+              name: "name",
+              type: "string",
+              required: false
+            },
+            {
+              name: "team",
+              type: "string",
+              required: false
+            },
+            {
+              name: "faction",
+              type: "string",
+              required: false
+            },
+            {
+              name: "health",
+              type: "number",
+              required: false
+            },
+            {
+              name: "maxHealth",
+              type: "number",
+              required: false
+            }
+          ]
+        },
+        featureClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event: feature click",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "featureId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "x",
+              type: "number",
+              required: true
+            },
+            {
+              name: "z",
+              type: "number",
+              required: true
+            },
+            {
+              name: "type",
+              type: "string",
+              required: false
+            },
+            {
+              name: "elevation",
+              type: "number",
+              required: false
+            }
+          ]
+        },
+        canvasClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event: canvas click",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "clientX",
+              type: "number",
+              required: true
+            },
+            {
+              name: "clientY",
+              type: "number",
+              required: true
+            },
+            {
+              name: "button",
+              type: "number",
+              required: true
+            }
+          ]
+        },
+        tileHoverEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event: tile hover",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "tileId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "x",
+              type: "number",
+              required: true
+            },
+            {
+              name: "z",
+              type: "number",
+              required: true
+            },
+            {
+              name: "type",
+              type: "string",
+              required: false
+            }
+          ]
+        },
+        tileLeaveEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event: tile leave",
+          kind: "event-ref",
+          emitPayloadSchema: []
+        },
+        unitAnimationEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event: unit animation",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "unitId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "state",
+              type: "string",
+              required: true
+            },
+            {
+              name: "timestamp",
+              type: "number",
+              required: true
+            }
+          ]
+        },
+        cameraChangeEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event: camera change",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "position",
+              type: "object",
+              required: true
+            },
+            {
+              name: "timestamp",
+              type: "number",
+              required: true
+            }
+          ]
+        },
+        loadingMessage: {
+          types: [
+            "string"
+          ],
+          description: "Loading message",
+          default: "Loading 3D Scene..."
+        },
+        useInstancing: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether to use instancing for tiles",
+          default: true
+        },
+        validMoves: {
+          types: [
+            "array"
+          ],
+          description: "Valid move positions",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "x",
+              "z"
+            ]
+          },
+          default: []
+        },
+        attackTargets: {
+          types: [
+            "array"
+          ],
+          description: "Attack target positions",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "x",
+              "z"
+            ]
+          },
+          default: []
+        },
+        selectedTileIds: {
+          types: [
+            "array"
+          ],
+          description: "Selected tile IDs",
+          items: {
+            types: [
+              "string"
+            ]
+          },
+          default: []
+        },
+        selectedUnitId: {
+          types: [
+            "string"
+          ],
+          description: "Selected unit ID",
+          default: null
+        }
+      }
+    },
+    "game-canvas-3d-battle-template": {
+      type: "game-canvas-3d-battle-template",
+      category: "game",
+      tier: "templates",
+      family: "game",
+      description: "GameCanvas3DBattleTemplate  Pure declarative template wrapper for 3D battle scenes. Optimized for tactical combat view with turn indicators.  Page: Battle3DPage Entity: Battle3D ViewType: detail  Events Emitted: - TILE_SELECTED - When a tile is clicked - UNIT_SELECTED - When a unit is clicked - UNIT_ATTACK - When attacking a unit - UNIT_MOVE - When moving a unit - END_TURN - When ending turn - EXIT_BATTLE - When exiting battle",
+      suggestedFor: [
+        "game",
+        "canvas3",
+        "battle",
+        "template",
+        "game canvas3 d battle template"
+      ],
+      typicalSize: "full",
+      propsSchema: {
+        entity: {
+          types: [
+            "object"
+          ],
+          description: "Entity data, the sole source of runtime state",
+          required: true
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "External styling override"
+        },
+        cameraMode: {
+          types: [
+            "string"
+          ],
+          description: "3D camera mode - defaults to perspective for dramatic effect",
+          enumValues: [
+            "isometric",
+            "perspective",
+            "top-down"
+          ],
+          default: "perspective"
+        },
+        showGrid: {
+          types: [
+            "boolean"
+          ],
+          description: "Show grid helper",
+          default: true
+        },
+        shadows: {
+          types: [
+            "boolean"
+          ],
+          description: "Enable shadows",
+          default: true
+        },
+        backgroundColor: {
+          types: [
+            "string"
+          ],
+          description: "Background color - darker for battle atmosphere",
+          default: "#2a1a1a"
+        },
+        tileClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for tile clicks"
+        },
+        unitClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for unit clicks"
+        },
+        unitAttackEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for unit attack"
+        },
+        unitMoveEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for unit move"
+        },
+        endTurnEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for ending turn"
+        },
+        exitEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for exiting battle"
+        },
+        selectedUnitId: {
+          types: [
+            "string"
+          ],
+          description: "Currently selected unit ID"
+        },
+        validMoves: {
           types: [
             "array"
           ],
-          description: "Alias for `columns`.",
+          description: "Valid move positions",
           items: {
             types: [
               "object"
             ],
             properties: {
-              key: {
-                types: [
-                  "string"
-                ]
-              },
-              field: {
-                types: [
-                  "string"
-                ]
-              },
-              header: {
-                types: [
-                  "string"
-                ]
-              },
-              label: {
-                types: [
-                  "string"
-                ]
-              },
-              width: {
-                types: [
-                  "string"
-                ]
-              },
-              align: {
-                types: [
-                  "string"
-                ],
-                enumValues: [
-                  "left",
-                  "center",
-                  "right"
-                ]
-              },
-              className: {
-                types: [
-                  "string"
-                ]
-              },
-              weight: {
-                types: [
-                  "string"
-                ],
-                enumValues: [
-                  "normal",
-                  "medium",
-                  "semibold"
-                ]
-              },
-              format: {
-                types: [
-                  "string"
-                ],
-                enumValues: [
-                  "badge",
-                  "date",
-                  "currency",
-                  "number",
-                  "percent",
-                  "boolean"
-                ]
-              },
-              icon: {
+              x: {
                 types: [
-                  "icon",
-                  "string"
+                  "number"
                 ]
               },
-              sortable: {
+              z: {
                 types: [
-                  "boolean"
+                  "number"
                 ]
               }
             },
             required: [
-              "key"
+              "x",
+              "z"
             ]
           }
         },
-        itemActions: {
+        attackTargets: {
           types: [
             "array"
           ],
-          description: "Per-row action buttons (trailing column).",
-          kind: "event-list",
-          eventField: "event",
+          description: "Valid attack targets",
           items: {
             types: [
               "object"
             ],
             properties: {
-              label: {
-                types: [
-                  "string"
-                ]
-              },
-              event: {
-                types: [
-                  "string"
-                ]
-              },
-              icon: {
+              x: {
                 types: [
-                  "icon",
-                  "string"
+                  "number"
                 ]
               },
-              variant: {
+              z: {
                 types: [
-                  "string"
-                ],
-                enumValues: [
-                  "primary",
-                  "secondary",
-                  "ghost",
-                  "danger"
+                  "number"
                 ]
               }
             },
             required: [
-              "label",
-              "event"
+              "x",
+              "z"
             ]
           }
         },
-        maxInlineActions: {
-          types: [
-            "number"
-          ],
-          description: 'Max inline action buttons before the rest collapse into a "\u22EF" overflow menu. Omit = all inline.'
-        },
-        selectable: {
+        showTurnIndicator: {
           types: [
             "boolean"
           ],
-          description: "Render a leading checkbox column. Selection changes emit `selectEvent`.",
-          default: false
-        },
-        selectEvent: {
-          types: [
-            "string"
-          ],
-          description: "Event emitted on selection change: UI:{selectEvent} with { ids, rows }.",
-          kind: "event"
-        },
-        selectedIds: {
-          types: [
-            "array"
-          ],
-          description: "Currently-selected ids (controlled). Falls back to local state when omitted.",
-          items: {
-            types: [
-              "string"
-            ]
-          }
-        },
-        sortEvent: {
+          description: "Show turn indicator overlay"
+        }
+      }
+    },
+    "game-canvas-3d-castle-template": {
+      type: "game-canvas-3d-castle-template",
+      category: "game",
+      tier: "templates",
+      family: "game",
+      description: "GameCanvas3DCastleTemplate  Pure declarative template wrapper for 3D castle/settlement view. Shows castle layout with buildings and garrisoned units.  Page: Castle3DPage, Settlement3DPage Entity: Castle3D, Settlement3D ViewType: detail  Events Emitted: - BUILDING_SELECTED - When a building is clicked - UNIT_SELECTED - When a garrison unit is clicked - BUILD - When building/upgrading - RECRUIT - When recruiting units - EXIT - When exiting castle view",
+      suggestedFor: [
+        "game",
+        "canvas3",
+        "castle",
+        "template",
+        "game canvas3 d castle template"
+      ],
+      typicalSize: "full",
+      propsSchema: {
+        entity: {
           types: [
-            "string"
+            "object"
           ],
-          description: "Event emitted on sortable-header click: UI:{sortEvent} with { column, direction }.",
-          kind: "event"
+          description: "Entity data, the sole source of runtime state",
+          required: true
         },
-        sortColumn: {
+        className: {
           types: [
             "string"
           ],
-          description: "Current sort column (display hint for the active header arrow)."
+          description: "External styling override"
         },
-        sortDirection: {
+        cameraMode: {
           types: [
             "string"
           ],
-          description: "Current sort direction (display hint).",
+          description: "3D camera mode",
           enumValues: [
-            "asc",
-            "desc"
-          ]
-        },
-        className: {
-          types: [
-            "string"
+            "isometric",
+            "perspective",
+            "top-down"
           ],
-          description: "Additional CSS classes applied to the table root."
+          default: "isometric"
         },
-        emptyMessage: {
+        showGrid: {
           types: [
-            "string"
+            "boolean"
           ],
-          description: "Message shown when there are no rows."
+          description: "Show grid helper",
+          default: true
         },
-        isLoading: {
+        shadows: {
           types: [
             "boolean"
           ],
-          description: "Loading state.",
-          default: false
+          description: "Enable shadows",
+          default: true
         },
-        error: {
+        backgroundColor: {
           types: [
-            "object"
-          ],
-          description: "Error state.",
-          properties: {
-            message: {
-              types: [
-                "string"
-              ]
-            },
-            name: {
-              types: [
-                "string"
-              ]
-            },
-            code: {
-              types: [
-                "string"
-              ]
-            },
-            stack: {
-              types: [
-                "string"
-              ]
-            }
-          },
-          propertyRequired: [
-            "message"
+            "string"
           ],
-          default: null
+          description: "Background color",
+          default: "#1e1e2e"
         },
-        groupBy: {
+        buildingClickEvent: {
           types: [
             "string"
           ],
-          description: "Group rows under section headers by a field value."
+          description: "Event name for building clicks"
         },
-        pageSize: {
+        unitClickEvent: {
           types: [
-            "number"
+            "string"
           ],
-          description: 'Max rows before a "Show More" button. Defaults to 0 (show all).',
-          default: 0
+          description: "Event name for unit clicks"
         },
-        children: {
+        buildEvent: {
           types: [
-            "function"
-          ],
-          description: "Custom per-row render. When provided, the whole row content is delegated to this function (columns are ignored for the body; the header still renders). Mirrors DataList's children render prop.",
-          kind: "callback",
-          callbackArgs: [
-            {
-              name: "item",
-              type: "object"
-            },
-            {
-              name: "index",
-              type: "number"
-            }
+            "string"
           ],
-          renderCallback: true
+          description: "Event name for build action"
         },
-        renderItem: {
+        recruitEvent: {
           types: [
-            "function"
-          ],
-          description: 'Per-row render function (schema alias). In .orb: ["fn","item",{...}]. The compiler converts this to the children render prop.',
-          kind: "callback",
-          callbackArgs: [
-            {
-              name: "item",
-              type: "object"
-            },
-            {
-              name: "index",
-              type: "number"
-            }
+            "string"
           ],
-          renderCallback: true
+          description: "Event name for recruit action"
         },
-        look: {
+        exitEvent: {
           types: [
             "string"
           ],
-          description: "Layer 2 visual treatment \u2014 mirrors the data-list / entity-table look enum so authors share one knob name across row renderers.",
-          enumValues: [
-            "dense",
-            "spacious",
-            "striped",
-            "borderless",
-            "bordered"
+          description: "Event name for exit"
+        },
+        selectedBuildingId: {
+          types: [
+            "string"
           ],
-          default: "dense"
-        }
-      }
-    },
-    "step-flow": {
-      type: "step-flow",
-      category: "component",
-      tier: "molecules",
-      family: "marketing",
-      description: "StepFlow component",
-      suggestedFor: [
-        "step",
-        "flow",
-        "step flow"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
-        steps: {
+          description: "Currently selected building ID"
+        },
+        availableBuildSites: {
           types: [
             "array"
           ],
-          description: "steps prop",
-          required: true,
+          description: "Available build positions",
           items: {
             types: [
               "object"
             ],
             properties: {
-              number: {
+              x: {
                 types: [
                   "number"
                 ]
               },
-              title: {
-                types: [
-                  "string"
-                ]
-              },
-              description: {
-                types: [
-                  "string"
-                ]
-              },
-              icon: {
+              z: {
                 types: [
-                  "icon",
-                  "string"
+                  "number"
                 ]
               }
             },
             required: [
-              "title",
-              "description"
+              "x",
+              "z"
             ]
           }
         },
-        orientation: {
-          types: [
-            "string"
-          ],
-          description: "orientation prop",
-          enumValues: [
-            "horizontal",
-            "vertical"
-          ],
-          default: "horizontal"
-        },
-        showConnectors: {
+        showHeader: {
           types: [
             "boolean"
           ],
-          description: "showConnectors prop",
+          description: "Show castle name header",
           default: true
         },
-        className: {
+        selectedTileIds: {
           types: [
-            "string"
+            "array"
           ],
-          description: "className prop"
+          description: "Pre-computed selected tile IDs array",
+          items: {
+            types: [
+              "string"
+            ]
+          },
+          default: []
         }
       }
     },
-    "stat-card": {
-      type: "stat-card",
-      category: "display",
-      tier: "atoms",
-      family: "marketing",
-      description: "StatCard component",
+    "game-canvas-3d-world-map-template": {
+      type: "game-canvas-3d-world-map-template",
+      category: "game",
+      tier: "templates",
+      family: "game",
+      description: "GameCanvas3DWorldMapTemplate  Pure declarative template wrapper for 3D world map. No hooks, no callbacks, no local state -- just entity data and config props.  Page: WorldMap3DPage Entity: WorldMap3D ViewType: detail  Events Emitted: - TILE_SELECTED - When a tile is clicked ({ tileId, x, z, type }) - UNIT_SELECTED - When a unit is clicked ({ unitId, x, z, name }) - FEATURE_SELECTED - When a feature is clicked ({ featureId, x, z, type }) - TILE_HOVERED - When hovering over a tile ({ tileId, x, z }) - TILE_LEAVE - When leaving a tile ({}) - CAMERA_CHANGED - When camera position changes ({ position })",
       suggestedFor: [
-        "stat",
-        "card",
-        "stat card"
+        "game",
+        "canvas3",
+        "world",
+        "map",
+        "template",
+        "game canvas3 d world map template"
       ],
-      typicalSize: "small",
+      typicalSize: "full",
       propsSchema: {
-        value: {
+        entity: {
           types: [
-            "string"
+            "object"
           ],
-          description: "The stat value to display prominently",
+          description: "Entity data, the sole source of runtime state",
           required: true
         },
-        label: {
+        className: {
           types: [
             "string"
           ],
-          description: "Label describing the value",
-          required: true
+          description: "External styling override"
         },
-        size: {
+        cameraMode: {
           types: [
             "string"
           ],
-          description: "Size of the value text",
+          description: "3D camera mode",
           enumValues: [
-            "sm",
-            "md",
-            "lg"
+            "isometric",
+            "perspective",
+            "top-down"
           ],
-          default: "md"
+          default: "isometric"
         },
-        className: {
+        showGrid: {
+          types: [
+            "boolean"
+          ],
+          description: "Show grid helper",
+          default: true
+        },
+        showCoordinates: {
+          types: [
+            "boolean"
+          ],
+          description: "Show coordinate overlay",
+          default: true
+        },
+        showTileInfo: {
+          types: [
+            "boolean"
+          ],
+          description: "Show tile info on hover",
+          default: true
+        },
+        shadows: {
+          types: [
+            "boolean"
+          ],
+          description: "Enable shadows",
+          default: true
+        },
+        backgroundColor: {
           types: [
             "string"
           ],
-          description: "Additional class names"
+          description: "Background color",
+          default: "#1a1a2e"
+        },
+        tileClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for tile clicks"
+        },
+        unitClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for unit clicks"
+        },
+        featureClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for feature clicks"
+        },
+        tileHoverEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for tile hover"
+        },
+        tileLeaveEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for tile leave"
+        },
+        cameraChangeEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event name for camera changes"
+        },
+        exitEvent: {
+          types: [
+            "string"
+          ],
+          description: "Exit/back event name"
+        },
+        selectedUnitId: {
+          types: [
+            "string"
+          ],
+          description: "Currently selected unit ID"
+        },
+        validMoves: {
+          types: [
+            "array"
+          ],
+          description: "Valid move positions for selected unit",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "x",
+              "z"
+            ]
+          }
+        },
+        attackTargets: {
+          types: [
+            "array"
+          ],
+          description: "Attack target positions",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "x",
+              "z"
+            ]
+          }
         }
       }
     }
@@ -44299,7 +46101,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-17T02:56:15.601Z",
+  exportedAt: "2026-06-17T08:23:54.917Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -45730,7 +47532,7 @@ var component_mapping_default = {
     },
     "feature-renderer": {
       component: "FeatureRenderer",
-      importPath: "@/components/organisms/FeatureRenderer",
+      importPath: "@/components/molecules/FeatureRenderer",
       category: "game"
     },
     "dashboard-grid": {
@@ -45797,6 +47599,26 @@ var component_mapping_default = {
       component: "StatCard",
       importPath: "@/components/atoms/StatCard",
       category: "display"
+    },
+    "game-canvas-3d": {
+      component: "GameCanvas3D",
+      importPath: "@almadar/ui/components/organisms/game/three",
+      category: "game"
+    },
+    "game-canvas-3d-battle-template": {
+      component: "GameCanvas3DBattleTemplate",
+      importPath: "@/components/templates/GameCanvas3DBattleTemplate",
+      category: "game"
+    },
+    "game-canvas-3d-castle-template": {
+      component: "GameCanvas3DCastleTemplate",
+      importPath: "@/components/templates/GameCanvas3DCastleTemplate",
+      category: "game"
+    },
+    "game-canvas-3d-world-map-template": {
+      component: "GameCanvas3DWorldMapTemplate",
+      importPath: "@/components/templates/GameCanvas3DWorldMapTemplate",
+      category: "game"
     }
   }
 };
@@ -45804,7 +47626,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-17T02:56:15.601Z",
+  exportedAt: "2026-06-17T08:23:54.917Z",
   contracts: {
     form: {
       emits: [