@almadar/patterns 2.44.0 → 2.46.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-16T19:32:31.111Z",
+  exportedAt: "2026-06-17T02:56:15.601Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -14052,6 +14052,323 @@ var patterns_registry_default = {
           ],
           description: "Unit draw-size multiplier",
           default: 1
+        },
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Direct tile data \u2014 forwarded to BattleBoard; takes priority over entity.",
+          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"
+            ]
+          }
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Direct unit data \u2014 forwarded to BattleBoard; takes priority over entity.",
+          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"
+            ]
+          }
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Direct feature data \u2014 forwarded to BattleBoard; takes priority over entity.",
+          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"
+            ]
+          }
+        },
+        assetManifest: {
+          types: [
+            "string"
+          ],
+          description: "Direct asset manifest \u2014 forwarded to BattleBoard; takes priority over entity."
         }
       }
     },
@@ -14087,6 +14404,323 @@ var patterns_registry_default = {
           ],
           description: "Canvas render scale",
           default: 0.45
+        },
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Direct tile data \u2014 forwarded to CastleBoard; takes priority over entity.",
+          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"
+            ]
+          }
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Direct unit data \u2014 forwarded to CastleBoard; takes priority over entity.",
+          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"
+            ]
+          }
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Direct feature data \u2014 forwarded to CastleBoard; takes priority over entity.",
+          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"
+            ]
+          }
+        },
+        assetManifest: {
+          types: [
+            "string"
+          ],
+          description: "Direct asset manifest \u2014 forwarded to CastleBoard; takes priority over entity."
         }
       }
     },
@@ -14143,6 +14777,323 @@ var patterns_registry_default = {
           ],
           description: "Allow selecting / moving ALL heroes (including enemy). For testing.",
           default: false
+        },
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Direct tile data \u2014 forwarded to WorldMapBoard; takes priority over entity.",
+          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"
+            ]
+          }
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Direct unit data \u2014 forwarded to WorldMapBoard; takes priority over entity.",
+          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"
+            ]
+          }
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Direct feature data \u2014 forwarded to WorldMapBoard; takes priority over entity.",
+          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"
+            ]
+          }
+        },
+        assetManifest: {
+          types: [
+            "string"
+          ],
+          description: "Direct asset manifest \u2014 forwarded to WorldMapBoard; takes priority over entity."
         }
       }
     },
@@ -24073,7 +25024,7 @@ var patterns_registry_default = {
             "asset"
           ],
           description: "URL for the speaker portrait image",
-          default: "https://almadar-kflow-assets.web.app/shared/characters/archetypes/00_base_model.png"
+          default: "https://almadar-kflow-assets.web.app/shared/characters/archetypes/04_hero.png"
         },
         position: {
           types: [
@@ -28126,14 +29077,15 @@ var patterns_registry_default = {
           types: [
             "asset"
           ],
-          description: "Background image URL"
+          description: "Background image URL",
+          default: "https://almadar-kflow-assets.web.app/shared/scenes/resonators.jpeg"
         },
         assetBaseUrl: {
           types: [
             "asset"
           ],
           description: "Base URL prefix for asset URLs",
-          default: ""
+          default: "https://almadar-kflow-assets.web.app/shared/"
         },
         className: {
           types: [
@@ -29874,7 +30826,8 @@ var patterns_registry_default = {
           types: [
             "asset"
           ],
-          description: "Background image URL tiled behind the isometric grid"
+          description: "Background image URL tiled behind the isometric grid",
+          default: "https://almadar-kflow-assets.web.app/shared/scenes/court.png"
         },
         showMinimap: {
           types: [
@@ -30186,7 +31139,8 @@ var patterns_registry_default = {
           types: [
             "asset"
           ],
-          description: "--- Remote asset loading ---"
+          description: "--- Remote asset loading ---",
+          default: "https://almadar-kflow-assets.web.app/shared/"
         },
         assetManifest: {
           types: [
@@ -30399,7 +31353,8 @@ var patterns_registry_default = {
           types: [
             "asset"
           ],
-          description: "Player sprite image URL"
+          description: "Player sprite image URL",
+          default: "https://almadar-kflow-assets.web.app/shared/platformer/characters/platformChar_idle.png"
         },
         tileSprites: {
           types: [
@@ -30416,14 +31371,15 @@ var patterns_registry_default = {
           types: [
             "asset"
           ],
-          description: "Background image URL"
+          description: "Background image URL",
+          default: "https://almadar-kflow-assets.web.app/shared/scenes/court.png"
         },
         assetBaseUrl: {
           types: [
             "asset"
           ],
           description: "Base URL prefix for asset URLs",
-          default: ""
+          default: "https://almadar-kflow-assets.web.app/shared/platformer/"
         },
         leftEvent: {
           types: [
@@ -31545,6 +32501,370 @@ var patterns_registry_default = {
           kind: "entity",
           cardinality: "collection"
         },
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Direct tile data \u2014 takes priority over entity-derived tiles.",
+          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"
+            ]
+          }
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Direct unit data \u2014 takes priority over entity-derived units.",
+          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: [
+                  "asset"
+                ]
+              },
+              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"
+            ]
+          }
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Direct feature data \u2014 takes priority over entity-derived features.",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              y: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              },
+              type: {
+                types: [
+                  "string"
+                ]
+              },
+              sprite: {
+                types: [
+                  "asset"
+                ]
+              },
+              assetUrl: {
+                types: [
+                  "asset"
+                ]
+              },
+              color: {
+                types: [
+                  "string"
+                ]
+              },
+              elevation: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "x",
+              "y",
+              "type"
+            ]
+          }
+        },
+        assetManifest: {
+          types: [
+            "object"
+          ],
+          description: "Direct asset manifest \u2014 takes priority over entity-derived manifest.",
+          properties: {
+            baseUrl: {
+              types: [
+                "asset"
+              ]
+            },
+            terrains: {
+              types: [
+                "object"
+              ],
+              mapValue: {
+                types: [
+                  "asset"
+                ]
+              }
+            },
+            units: {
+              types: [
+                "object"
+              ],
+              mapValue: {
+                types: [
+                  "asset"
+                ]
+              }
+            },
+            features: {
+              types: [
+                "object"
+              ],
+              mapValue: {
+                types: [
+                  "asset"
+                ]
+              }
+            },
+            effects: {
+              types: [
+                "object"
+              ],
+              mapValue: {
+                types: [
+                  "asset"
+                ]
+              }
+            }
+          }
+        },
         scale: {
           types: [
             "number"
@@ -32572,13 +33892,15 @@ var patterns_registry_default = {
           types: [
             "asset"
           ],
-          description: "--- Remote asset loading ---"
+          description: "--- Remote asset loading ---",
+          default: "https://almadar-kflow-assets.web.app/shared/effects/gas/gas00.png"
         },
         assetBaseUrl: {
           types: [
             "asset"
           ],
-          description: "Base URL for remote assets. Prepended to relative effectSpriteUrl paths."
+          description: "Base URL for remote assets. Prepended to relative effectSpriteUrl paths.",
+          default: "https://almadar-kflow-assets.web.app/shared/effects/"
         },
         assetManifest: {
           types: [
@@ -32873,6 +34195,360 @@ var patterns_registry_default = {
           kind: "entity",
           cardinality: "collection"
         },
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Direct tile data \u2014 takes priority over entity-derived tiles.",
+          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"
+            ]
+          }
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Direct unit data \u2014 takes priority over entity-derived units.",
+          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: [
+                  "asset"
+                ]
+              },
+              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"
+            ]
+          }
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Direct feature data \u2014 takes priority over entity-derived features.",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              y: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              },
+              type: {
+                types: [
+                  "string"
+                ]
+              },
+              sprite: {
+                types: [
+                  "asset"
+                ]
+              },
+              assetUrl: {
+                types: [
+                  "asset"
+                ]
+              },
+              color: {
+                types: [
+                  "string"
+                ]
+              },
+              elevation: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "x",
+              "y",
+              "type"
+            ]
+          }
+        },
+        assetManifest: {
+          types: [
+            "object"
+          ],
+          description: "Direct asset manifest \u2014 takes priority over entity-derived manifest.",
+          properties: {
+            baseUrl: {
+              types: [
+                "asset"
+              ]
+            },
+            terrains: {
+              types: [
+                "object"
+              ],
+              mapValue: {
+                types: [
+                  "asset"
+                ]
+              }
+            },
+            units: {
+              types: [
+                "object"
+              ],
+              mapValue: {
+                types: [
+                  "asset"
+                ]
+              }
+            },
+            features: {
+              types: [
+                "object"
+              ],
+              mapValue: {
+                types: [
+                  "asset"
+                ]
+              }
+            }
+          }
+        },
         scale: {
           types: [
             "number"
@@ -35558,107 +37234,424 @@ var patterns_registry_default = {
             }
           ]
         },
-        stateStyles: {
+        stateStyles: {
+          types: [
+            "object"
+          ],
+          description: "Custom state styles passed to StateIndicator",
+          mapValue: {
+            types: [
+              "object"
+            ],
+            properties: {
+              icon: {
+                types: [
+                  "icon",
+                  "string"
+                ]
+              },
+              bgClass: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "icon",
+              "bgClass"
+            ]
+          }
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state"
+        },
+        error: {
+          types: [
+            "object"
+          ],
+          description: "Error state",
+          properties: {
+            message: {
+              types: [
+                "string"
+              ]
+            },
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            code: {
+              types: [
+                "string"
+              ]
+            },
+            stack: {
+              types: [
+                "string"
+              ]
+            }
+          },
+          propertyRequired: [
+            "message"
+          ]
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Entity name for schema-driven auto-fetch"
+        }
+      }
+    },
+    "uncontrolled-battle-board": {
+      type: "uncontrolled-battle-board",
+      category: "game",
+      tier: "organisms",
+      family: "game",
+      description: "UncontrolledBattleBoard  Thin wrapper that composes `useBattleState` + `BattleBoard` for self-managing game state.  Accepts `initialUnits` instead of the controlled-mode fields and manages units, phase, turn, gameResult, and selectedUnitId internally via the hook.  Use this component when you want the BattleBoard to manage its own game logic (e.g. in Storybook, prototypes, or simple integrations). For Orbital trait integration, use `BattleBoard` directly in controlled mode.",
+      suggestedFor: [
+        "uncontrolled",
+        "battle",
+        "board",
+        "uncontrolled battle board"
+      ],
+      typicalSize: "large",
+      propsSchema: {
+        entity: {
+          types: [
+            "object",
+            "array"
+          ],
+          description: "Single board-state entity row (or array). The internal `useBattleState`",
+          kind: "entity",
+          cardinality: "collection"
+        },
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Direct tile data \u2014 takes priority over entity-derived tiles.",
+          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"
+            ]
+          }
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Direct unit data \u2014 takes priority over entity-derived units.",
+          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"
+            ]
+          }
+        },
+        features: {
           types: [
-            "object"
+            "array"
           ],
-          description: "Custom state styles passed to StateIndicator",
-          mapValue: {
+          description: "Direct feature data \u2014 takes priority over entity-derived features.",
+          items: {
             types: [
               "object"
             ],
             properties: {
-              icon: {
+              id: {
                 types: [
-                  "icon",
                   "string"
                 ]
               },
-              bgClass: {
+              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: [
-              "icon",
-              "bgClass"
+              "x",
+              "y",
+              "type"
             ]
           }
         },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        },
-        isLoading: {
-          types: [
-            "boolean"
-          ],
-          description: "Loading state"
-        },
-        error: {
-          types: [
-            "object"
-          ],
-          description: "Error state",
-          properties: {
-            message: {
-              types: [
-                "string"
-              ]
-            },
-            name: {
-              types: [
-                "string"
-              ]
-            },
-            code: {
-              types: [
-                "string"
-              ]
-            },
-            stack: {
-              types: [
-                "string"
-              ]
-            }
-          },
-          propertyRequired: [
-            "message"
-          ]
-        },
-        entity: {
+        assetManifest: {
           types: [
             "string"
           ],
-          description: "Entity name for schema-driven auto-fetch"
-        }
-      }
-    },
-    "uncontrolled-battle-board": {
-      type: "uncontrolled-battle-board",
-      category: "game",
-      tier: "organisms",
-      family: "game",
-      description: "UncontrolledBattleBoard  Thin wrapper that composes `useBattleState` + `BattleBoard` for self-managing game state.  Accepts `initialUnits` instead of the controlled-mode fields and manages units, phase, turn, gameResult, and selectedUnitId internally via the hook.  Use this component when you want the BattleBoard to manage its own game logic (e.g. in Storybook, prototypes, or simple integrations). For Orbital trait integration, use `BattleBoard` directly in controlled mode.",
-      suggestedFor: [
-        "uncontrolled",
-        "battle",
-        "board",
-        "uncontrolled battle board"
-      ],
-      typicalSize: "large",
-      propsSchema: {
-        entity: {
-          types: [
-            "object",
-            "array"
-          ],
-          description: "Single board-state entity row (or array). The internal `useBattleState`",
-          kind: "entity",
-          cardinality: "collection"
+          description: "Direct asset manifest \u2014 takes priority over entity-derived manifest."
         }
       }
     },
@@ -35728,6 +37721,360 @@ var patterns_registry_default = {
           kind: "entity",
           cardinality: "collection"
         },
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Direct tile data \u2014 takes priority over entity-derived tiles.",
+          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"
+            ]
+          }
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Direct unit data \u2014 takes priority over entity-derived units.",
+          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: [
+                  "asset"
+                ]
+              },
+              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"
+            ]
+          }
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Direct feature data \u2014 takes priority over entity-derived features.",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              y: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              },
+              type: {
+                types: [
+                  "string"
+                ]
+              },
+              sprite: {
+                types: [
+                  "asset"
+                ]
+              },
+              assetUrl: {
+                types: [
+                  "asset"
+                ]
+              },
+              color: {
+                types: [
+                  "string"
+                ]
+              },
+              elevation: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "x",
+              "y",
+              "type"
+            ]
+          }
+        },
+        assetManifest: {
+          types: [
+            "object"
+          ],
+          description: "Direct asset manifest \u2014 takes priority over entity-derived manifest.",
+          properties: {
+            baseUrl: {
+              types: [
+                "asset"
+              ]
+            },
+            terrains: {
+              types: [
+                "object"
+              ],
+              mapValue: {
+                types: [
+                  "asset"
+                ]
+              }
+            },
+            units: {
+              types: [
+                "object"
+              ],
+              mapValue: {
+                types: [
+                  "asset"
+                ]
+              }
+            },
+            features: {
+              types: [
+                "object"
+              ],
+              mapValue: {
+                types: [
+                  "asset"
+                ]
+              }
+            }
+          }
+        },
         scale: {
           types: [
             "number"
@@ -41952,7 +44299,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-16T19:32:31.111Z",
+  exportedAt: "2026-06-17T02:56:15.601Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -43457,7 +45804,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-06-16T19:32:31.111Z",
+  exportedAt: "2026-06-17T02:56:15.601Z",
   contracts: {
     form: {
       emits: [