@almadar/core 10.89.0 → 10.91.0

package/dist/patterns/index.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-08T23:56:00.442Z",
+  exportedAt: "2026-09-12T07:27:39.835Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -4304,7 +4304,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -4464,7 +4467,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -7498,6 +7504,7 @@ var patterns_registry_default = {
     button: {
       type: "button",
       category: "component",
+      sourceFile: "components/core/atoms/Button.tsx",
       tier: "atoms",
       family: "core",
       description: "Clickable button that emits events",
@@ -7642,7 +7649,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -7684,7 +7694,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         label: {
           types: [
@@ -7709,6 +7720,7 @@ var patterns_registry_default = {
     badge: {
       type: "badge",
       category: "component",
+      sourceFile: "components/core/atoms/Badge.tsx",
       tier: "atoms",
       family: "core",
       description: "Small label for status or count",
@@ -7840,7 +7852,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -8340,6 +8355,7 @@ var patterns_registry_default = {
     input: {
       type: "input",
       category: "component",
+      sourceFile: "components/core/atoms/Input.tsx",
       tier: "atoms",
       family: "core",
       description: "Text input field",
@@ -8508,7 +8524,15 @@ var patterns_registry_default = {
             "function",
             "string"
           ],
-          description: "onChange handler or declarative event key for trait dispatch"
+          description: "onChange handler or declarative event key for trait dispatch",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "_payload",
+              type: "object",
+              required: false
+            }
+          ]
         }
       }
     },
@@ -8561,13 +8585,22 @@ var patterns_registry_default = {
             "function",
             "string"
           ],
-          description: "onChange handler or declarative event key for trait dispatch"
+          description: "onChange handler or declarative event key for trait dispatch",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "value",
+              type: "string",
+              required: true
+            }
+          ]
         }
       }
     },
     select: {
       type: "select",
       category: "component",
+      sourceFile: "components/core/atoms/Select.tsx",
       tier: "atoms",
       family: "core",
       description: "Dropdown select input",
@@ -8731,14 +8764,52 @@ var patterns_registry_default = {
             "function",
             "string"
           ],
-          description: "onChange handler (native ChangeEvent) or declarative event key for trait dispatch"
+          description: "onChange handler (native ChangeEvent) or declarative event key for trait dispatch",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "value",
+              type: "string",
+              required: true,
+              schema: {
+                types: [
+                  "string",
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "string"
+                  ]
+                }
+              }
+            }
+          ]
         },
         onValueChange: {
           types: [
             "function",
             "string"
           ],
-          description: "Value-based change: a React callback (internal use) OR a declarative event key that emits `{ value }` on the bus (render-ui / lolo authoring). Mirrors the `onChange` handler|event convention so it's an event-emitting prop, not a bare callback."
+          description: "Value-based change: a React callback (internal use) OR a declarative event key that emits `{ value }` on the bus (render-ui / lolo authoring). Mirrors the `onChange` handler|event convention so it's an event-emitting prop, not a bare callback.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "value",
+              type: "string",
+              required: true,
+              schema: {
+                types: [
+                  "string",
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "string"
+                  ]
+                }
+              }
+            }
+          ]
         }
       }
     },
@@ -8784,7 +8855,15 @@ var patterns_registry_default = {
             "function",
             "string"
           ],
-          description: "onChange handler or declarative event key for trait dispatch"
+          description: "onChange handler or declarative event key for trait dispatch",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "checked",
+              type: "boolean",
+              required: true
+            }
+          ]
         }
       }
     },
@@ -11285,6 +11364,7 @@ var patterns_registry_default = {
     "input-group": {
       type: "input-group",
       category: "form",
+      sourceFile: "components/core/molecules/InputGroup.tsx",
       tier: "molecules",
       family: "core",
       description: "InputGroup Molecule Component  A component for grouping input with addons (icons, buttons, text). Uses Input, Button, Icon, and Typography atoms.",
@@ -11445,7 +11525,15 @@ var patterns_registry_default = {
             "function",
             "string"
           ],
-          description: "onChange handler or declarative event key for trait dispatch"
+          description: "onChange handler or declarative event key for trait dispatch",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "_payload",
+              type: "object",
+              required: false
+            }
+          ]
         },
         leftAddon: {
           types: [
@@ -13743,6 +13831,7 @@ var patterns_registry_default = {
     "game-shell": {
       type: "game-shell",
       category: "game",
+      sourceFile: "components/game/templates/GameShell.tsx",
       tier: "templates",
       family: "game",
       description: 'GameShell  A full-screen layout wrapper for game applications. Replaces DashboardLayout for game clients \u2014 no sidebar nav, just full-viewport rendering with an optional HUD overlay bar.  Used as a React Router layout route element: <Route element={<GameShell appName="TraitWars" />}> <Route index element={<WorldMapPage />} /> ... </Route>',
@@ -13868,7 +13957,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -13963,7 +14055,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -28231,6 +28326,7 @@ var patterns_registry_default = {
     "choice-button": {
       type: "choice-button",
       category: "game",
+      sourceFile: "components/game/atoms/ChoiceButton.tsx",
       tier: "atoms",
       family: "game",
       description: "ChoiceButton component",
@@ -28320,7 +28416,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -28410,6 +28509,7 @@ var patterns_registry_default = {
     "control-button": {
       type: "control-button",
       category: "game",
+      sourceFile: "components/game/atoms/ControlButton.tsx",
       tier: "atoms",
       family: "game",
       description: "ControlButton component",
@@ -28485,7 +28585,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -28602,6 +28705,7 @@ var patterns_registry_default = {
     "dialogue-bubble": {
       type: "dialogue-bubble",
       category: "game",
+      sourceFile: "components/game/atoms/DialogueBubble.tsx",
       tier: "atoms",
       family: "game",
       description: "DialogueBubble component",
@@ -28692,7 +28796,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -28763,6 +28870,7 @@ var patterns_registry_default = {
     "health-bar": {
       type: "health-bar",
       category: "game",
+      sourceFile: "components/game/atoms/HealthBar.tsx",
       tier: "atoms",
       family: "game",
       description: "HealthBar component",
@@ -28911,7 +29019,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -29006,7 +29117,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -29041,6 +29155,7 @@ var patterns_registry_default = {
     "score-display": {
       type: "score-display",
       category: "game",
+      sourceFile: "components/game/atoms/ScoreDisplay.tsx",
       tier: "atoms",
       family: "game",
       description: "ScoreDisplay component",
@@ -29116,7 +29231,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -29203,6 +29321,7 @@ var patterns_registry_default = {
     "timer-display": {
       type: "timer-display",
       category: "game",
+      sourceFile: "components/game/atoms/TimerDisplay.tsx",
       tier: "atoms",
       family: "game",
       description: "TimerDisplay component",
@@ -29329,7 +29448,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -31599,6 +31721,7 @@ var patterns_registry_default = {
     "game-hud": {
       type: "game-hud",
       category: "game",
+      sourceFile: "components/game/molecules/GameHud.tsx",
       tier: "molecules",
       family: "game",
       description: "GameHud component",
@@ -31689,7 +31812,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -31783,7 +31909,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -31940,7 +32069,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -32034,7 +32166,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -32223,7 +32358,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -32570,7 +32708,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -32611,6 +32752,7 @@ var patterns_registry_default = {
     "stat-badge": {
       type: "stat-badge",
       category: "game",
+      sourceFile: "components/game/molecules/StatBadge.tsx",
       tier: "molecules",
       family: "game",
       description: "StatBadge component",
@@ -32686,7 +32828,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -32781,7 +32926,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -33307,6 +33455,7 @@ var patterns_registry_default = {
     "game-audio-toggle": {
       type: "game-audio-toggle",
       category: "game",
+      sourceFile: "components/game/atoms/GameAudioToggle.tsx",
       tier: "atoms",
       family: "game",
       description: "GameAudioToggle component",
@@ -33438,7 +33587,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -33533,7 +33685,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -33582,6 +33737,7 @@ var patterns_registry_default = {
     "trait-slot": {
       type: "trait-slot",
       category: "game",
+      sourceFile: "components/game/molecules/TraitSlot.tsx",
       tier: "molecules",
       family: "game",
       description: "Event Contract: Emits: UI:CLICK Emits: UI:REMOVE",
@@ -33694,7 +33850,10 @@ var patterns_registry_default = {
                     "1:1",
                     "16:9",
                     "5:7",
-                    "8:1"
+                    "8:1",
+                    "4:1",
+                    "5:3",
+                    "1:2"
                   ]
                 },
                 atlas: {
@@ -33937,7 +34096,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -34114,7 +34276,10 @@ var patterns_registry_default = {
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       atlas: {
@@ -34340,7 +34505,10 @@ var patterns_registry_default = {
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       atlas: {
@@ -34535,6 +34703,7 @@ var patterns_registry_default = {
     "action-palette": {
       type: "action-palette",
       category: "game",
+      sourceFile: "components/game/molecules/ActionPalette.tsx",
       tier: "molecules",
       family: "game",
       description: "ActionPalette Component  Grid of draggable ActionTile components for the Sequencer tier. Kids pick from these to build their sequence.",
@@ -34645,7 +34814,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -34833,6 +35005,7 @@ var patterns_registry_default = {
     "action-tile": {
       type: "action-tile",
       category: "game",
+      sourceFile: "components/game/molecules/ActionTile.tsx",
       tier: "molecules",
       family: "game",
       description: "ActionTile Component  A draggable action tile for the Sequencer tier (ages 5-8). Kids drag these from the ActionPalette into SequenceBar slots. Sets SlotItemData on dataTransfer for TraitSlot compatibility.",
@@ -35045,7 +35218,10 @@ var patterns_registry_default = {
                     "1:1",
                     "16:9",
                     "5:7",
-                    "8:1"
+                    "8:1",
+                    "4:1",
+                    "5:3",
+                    "1:2"
                   ]
                 },
                 atlas: {
@@ -35208,6 +35384,7 @@ var patterns_registry_default = {
     "sequence-bar": {
       type: "sequence-bar",
       category: "game",
+      sourceFile: "components/game/molecules/SequenceBar.tsx",
       tier: "molecules",
       family: "game",
       description: "SequenceBar Component  A row of TraitSlot components forming the action sequence for the Sequencer tier (ages 5-8). Kids drag ActionTiles from the palette into these slots to build their sequence.",
@@ -35318,7 +35495,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -35546,7 +35726,10 @@ var patterns_registry_default = {
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       atlas: {
@@ -38595,6 +38778,7 @@ var patterns_registry_default = {
     "canvas-2d": {
       type: "canvas-2d",
       category: "game",
+      sourceFile: "components/game/molecules/Canvas2D.tsx",
       tier: "molecules",
       family: "game",
       description: "Canvas2D component",
@@ -38741,7 +38925,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -39053,6 +39240,7 @@ var patterns_registry_default = {
     "control-grid": {
       type: "control-grid",
       category: "game",
+      sourceFile: "components/game/molecules/ControlGrid.tsx",
       tier: "molecules",
       family: "game",
       description: "ControlGrid component",
@@ -39164,7 +39352,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -39393,7 +39584,10 @@ var patterns_registry_default = {
                   "1:1",
                   "16:9",
                   "5:7",
-                  "8:1"
+                  "8:1",
+                  "4:1",
+                  "5:3",
+                  "1:2"
                 ]
               },
               atlas: {
@@ -39464,6 +39658,7 @@ var patterns_registry_default = {
     "game-icon": {
       type: "game-icon",
       category: "game",
+      sourceFile: "components/core/atoms/GameIcon.tsx",
       tier: "atoms",
       family: "core",
       description: "GameIcon component",
@@ -39539,7 +39734,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -47837,6 +48035,7 @@ var patterns_registry_default = {
     "draw-sprite": {
       type: "draw-sprite",
       category: "game",
+      sourceFile: "components/game/atoms/DrawSprite.tsx",
       tier: "atoms",
       family: "game",
       description: "DrawSprite component",
@@ -47958,7 +48157,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -48942,6 +49144,7 @@ var patterns_registry_default = {
     "draw-sprite-layer": {
       type: "draw-sprite-layer",
       category: "game",
+      sourceFile: "components/game/molecules/DrawSpriteLayer.tsx",
       tier: "molecules",
       family: "game",
       description: "DrawSpriteLayer component",
@@ -49084,7 +49287,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -49390,6 +49596,7 @@ var patterns_registry_default = {
     canvas: {
       type: "canvas",
       category: "game",
+      sourceFile: "components/game/molecules/Canvas.tsx",
       tier: "molecules",
       family: "game",
       description: "Canvas component",
@@ -49629,7 +49836,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -52062,6 +52272,7 @@ var patterns_registry_default = {
     "draw-fx-layer": {
       type: "draw-fx-layer",
       category: "game",
+      sourceFile: "components/game/molecules/DrawFxLayer.tsx",
       tier: "molecules",
       family: "game",
       description: "DrawFxLayer component",
@@ -52437,7 +52648,10 @@ var patterns_registry_default = {
                   "1:1",
                   "16:9",
                   "5:7",
-                  "8:1"
+                  "8:1",
+                  "4:1",
+                  "5:3",
+                  "1:2"
                 ]
               },
               atlas: {
@@ -53728,6 +53942,399 @@ var patterns_registry_default = {
           default: "replace"
         }
       }
+    },
+    "draw-skinned-mesh": {
+      type: "draw-skinned-mesh",
+      category: "game",
+      sourceFile: "components/game/atoms/DrawSkinnedMesh.tsx",
+      tier: "atoms",
+      family: "game",
+      description: "DrawSkinnedMesh component",
+      suggestedFor: [
+        "draw",
+        "skinned",
+        "mesh",
+        "draw skinned mesh"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        id: {
+          types: [
+            "string"
+          ],
+          description: "Optional source-tagged hit-test handle \u2014 the host indexes the drawable's ScenePos\u2192id so a pointer/raycast at that cell resolves to this id (unit/entity click). No id \u2192 the host emits only the coordinate (tile click)."
+        },
+        type: {
+          types: [
+            "string"
+          ],
+          description: "type prop",
+          required: true,
+          enumValues: [
+            "draw-skinned-mesh"
+          ]
+        },
+        position: {
+          types: [
+            "object"
+          ],
+          description: "Logical scene position; mesh local coords are world units relative to its projected top-left.",
+          required: true,
+          properties: {
+            x: {
+              types: [
+                "number"
+              ]
+            },
+            y: {
+              types: [
+                "number"
+              ]
+            },
+            z: {
+              types: [
+                "number"
+              ]
+            }
+          },
+          propertyRequired: [
+            "x",
+            "y"
+          ],
+          scenePos: true
+        },
+        asset: {
+          types: [
+            "object"
+          ],
+          description: "The texture the mesh UVs cut into.",
+          required: true,
+          properties: {
+            url: {
+              types: [
+                "asset"
+              ]
+            },
+            role: {
+              types: [
+                "string"
+              ]
+            },
+            category: {
+              types: [
+                "string"
+              ]
+            },
+            animations: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            style: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "pixel",
+                "vector",
+                "hd",
+                "1-bit",
+                "isometric"
+              ]
+            },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
+            dimension: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "2d",
+                "3d"
+              ]
+            },
+            aspect: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "1:1",
+                "16:9",
+                "5:7",
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
+              ]
+            },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            thumbnailUrl: {
+              types: [
+                "string"
+              ]
+            }
+          },
+          propertyRequired: [
+            "url",
+            "role",
+            "category"
+          ]
+        },
+        mesh: {
+          types: [
+            "object"
+          ],
+          description: "Inline bind mesh; wins over `meshUrl`.",
+          properties: {
+            vertices: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  x: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  y: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  u: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  v: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  weights: {
+                    types: [
+                      "array"
+                    ],
+                    items: {
+                      types: [
+                        "object"
+                      ],
+                      properties: {
+                        bone: {
+                          types: [
+                            "number"
+                          ]
+                        },
+                        w: {
+                          types: [
+                            "number"
+                          ]
+                        }
+                      },
+                      required: [
+                        "bone",
+                        "w"
+                      ]
+                    }
+                  }
+                },
+                required: [
+                  "x",
+                  "y",
+                  "u",
+                  "v",
+                  "weights"
+                ]
+              }
+            },
+            triangles: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "number"
+                  ]
+                }
+              }
+            }
+          },
+          propertyRequired: [
+            "vertices",
+            "triangles"
+          ]
+        },
+        meshUrl: {
+          types: [
+            "string"
+          ],
+          description: "URL of a JSON `SkinMesh` (fetched + cached); used when `mesh` is absent."
+        },
+        bones: {
+          types: [
+            "array"
+          ],
+          description: "The skeleton (bind pose; FK chain via `parent` names). Falls back to the rigbundle's `bones` when empty.",
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              name: {
+                types: [
+                  "string"
+                ]
+              },
+              parent: {
+                types: [
+                  "string"
+                ]
+              },
+              pivot: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "number"
+                  ]
+                }
+              },
+              tip: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "number"
+                  ]
+                }
+              }
+            },
+            required: [
+              "name",
+              "parent",
+              "pivot",
+              "tip"
+            ]
+          }
+        },
+        pose: {
+          types: [
+            "object"
+          ],
+          description: "Static pose (bone name \u2192 degrees relative to bind). Overridden by `clip` + `frame`.",
+          mapValue: {
+            types: [
+              "number"
+            ]
+          }
+        },
+        clip: {
+          types: [
+            "object"
+          ],
+          description: "Pose animation clip; with `frame`, pose = `frames[frame % frames.length]`.",
+          properties: {
+            frames: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ],
+                mapValue: {
+                  types: [
+                    "number"
+                  ]
+                }
+              }
+            }
+          },
+          propertyRequired: [
+            "frames"
+          ]
+        },
+        clipName: {
+          types: [
+            "string"
+          ],
+          description: "Named clip inside the rigbundle at `meshUrl` (`clips[clipName].frames`); used when `clip` is absent. Empty/unknown = no clip."
+        },
+        frame: {
+          types: [
+            "number"
+          ],
+          description: "Clip frame counter (host-driven paint clock frame)."
+        },
+        opacity: {
+          types: [
+            "number"
+          ],
+          description: "0..1 opacity."
+        },
+        weightsOverlay: {
+          types: [
+            "boolean"
+          ],
+          description: "Paint per-triangle dominant-bone colors instead of the texture (rig inspection)."
+        },
+        ghost: {
+          types: [
+            "object"
+          ],
+          description: "Onion skin: render the mesh at this clip frame underneath, at this opacity.",
+          properties: {
+            frame: {
+              types: [
+                "number"
+              ]
+            },
+            opacity: {
+              types: [
+                "number"
+              ]
+            }
+          },
+          propertyRequired: [
+            "frame",
+            "opacity"
+          ]
+        }
+      },
+      drawable: true
     }
   },
   categories: [
@@ -53753,7 +54360,7 @@ var patterns_registry_default = {
 // src/patterns/integrators-registry.json
 var integrators_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-07T01:58:57.916Z",
+  exportedAt: "2026-09-12T12:14:53.173Z",
   integrators: {
     github: {
       name: "github",
@@ -57336,6 +57943,269 @@ var integrators_registry_default = {
           }
         }
       ]
+    },
+    rigger: {
+      name: "rigger",
+      description: "Local rigger service (FastAPI) \u2014 mesh rigging build + render",
+      category: "media",
+      actions: [
+        {
+          name: "health",
+          description: "Liveness probe of the local rigger service.",
+          params: [],
+          responseShape: {
+            ok: "boolean"
+          }
+        },
+        {
+          name: "buildMesh",
+          description: "Build a rigged mesh bundle from a source image via the local rigger service.",
+          params: [
+            {
+              name: "imagePath",
+              type: "string",
+              required: true,
+              description: "Path to the source image."
+            },
+            {
+              name: "rig",
+              type: "object",
+              required: true,
+              description: "The rig definition (parts, boxes, pivots, \u2026) as JSON."
+            }
+          ],
+          responseShape: {
+            bundlePath: "string",
+            boneCount: "number",
+            vertexCount: "number",
+            triangleCount: "number",
+            clips: "string[]"
+          }
+        },
+        {
+          name: "render",
+          description: "Render a rigged mesh bundle to output files via the local rigger service.",
+          params: [
+            {
+              name: "imagePath",
+              type: "string",
+              required: true,
+              description: "Path to the source image."
+            },
+            {
+              name: "rig",
+              type: "object",
+              required: true,
+              description: "The rig definition (parts, boxes, pivots, \u2026) as JSON."
+            },
+            {
+              name: "preset",
+              type: "string",
+              required: true,
+              description: "Render preset name."
+            },
+            {
+              name: "outDir",
+              type: "string",
+              required: true,
+              description: "Output directory for rendered files."
+            },
+            {
+              name: "mode",
+              type: "string",
+              required: false,
+              description: "Render path: 'mesh' (skinned, deforming) or 'cutout' (rigid per-part layers). Defaults to 'mesh'."
+            },
+            {
+              name: "supersample",
+              type: "number",
+              required: false,
+              description: "Supersampling factor for the cutout path. Defaults to 1."
+            }
+          ],
+          responseShape: {
+            outdir: "string",
+            frames: "number",
+            framePaths: "string[]",
+            sheet: "string",
+            gif: "string",
+            atlas: "string"
+          }
+        },
+        {
+          name: "listPresets",
+          description: "List the available animation presets (name, fps, frame count, bone roles) from the local rigger service.",
+          params: [],
+          responseShape: {
+            presets: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  name: {
+                    type: "string",
+                    required: true
+                  },
+                  path: {
+                    type: "string",
+                    required: true
+                  },
+                  fps: {
+                    type: "number",
+                    required: true
+                  },
+                  frames: {
+                    type: "number",
+                    required: true
+                  },
+                  bones: {
+                    type: "object[]",
+                    required: true
+                  }
+                }
+              }
+            }
+          }
+        },
+        {
+          name: "loadRig",
+          description: "Load a rig file, resolving `cloneOf` parts to concrete box/pivot geometry.",
+          params: [
+            {
+              name: "rigPath",
+              type: "string",
+              required: true,
+              description: "Path to the rig JSON file."
+            }
+          ],
+          responseShape: {
+            rig: "object",
+            resolved: "object"
+          }
+        },
+        {
+          name: "saveRig",
+          description: "Save a rig file; the server validates it and rejects a malformed part.",
+          params: [
+            {
+              name: "rigPath",
+              type: "string",
+              required: true,
+              description: "Path to write the rig JSON file."
+            },
+            {
+              name: "rig",
+              type: "object",
+              required: true,
+              description: "The rig definition (parts, boxes, pivots, \u2026) as JSON."
+            }
+          ],
+          responseShape: {
+            rigPath: "string",
+            parts: "number"
+          }
+        },
+        {
+          name: "ownership",
+          description: "Render the per-part pixel ownership map for a rig over a source image.",
+          params: [
+            {
+              name: "imagePath",
+              type: "string",
+              required: true,
+              description: "Path to the source image."
+            },
+            {
+              name: "rig",
+              type: "object",
+              required: true,
+              description: "The rig definition (parts, boxes, pivots, \u2026) as JSON."
+            },
+            {
+              name: "outPath",
+              type: "string",
+              required: true,
+              description: "Path to write the ownership-map PNG."
+            }
+          ],
+          responseShape: {
+            outPath: "string",
+            legend: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  name: {
+                    type: "string",
+                    required: true
+                  },
+                  color: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            }
+          }
+        },
+        {
+          name: "generate",
+          description: "Generate one image on the local image server (text-to-image, or a Kontext edit conditioned on `sourcePath`).",
+          params: [
+            {
+              name: "model",
+              type: "'z-image-turbo' | 'kontext'",
+              required: true,
+              description: "Generation model: 'z-image-turbo' (text-to-image) or 'kontext' (edit; requires sourcePath)."
+            },
+            {
+              name: "prompt",
+              type: "string",
+              required: true,
+              description: "The generation/edit prompt."
+            },
+            {
+              name: "seed",
+              type: "number",
+              required: false,
+              description: "Random seed; omit for a fresh one each call."
+            },
+            {
+              name: "size",
+              type: "string",
+              required: false,
+              description: "Output image size, e.g. '1024x1024'. Defaults to '1024x1024'."
+            },
+            {
+              name: "steps",
+              type: "number",
+              required: false,
+              description: "Diffusion step count."
+            },
+            {
+              name: "sourcePath",
+              type: "string",
+              required: false,
+              description: "Path to the source image to edit; REQUIRED for 'kontext'."
+            },
+            {
+              name: "outDir",
+              type: "string",
+              required: true,
+              description: "Output directory the generated PNG is written under."
+            }
+          ],
+          responseShape: {
+            outPath: "string",
+            model: "string",
+            prompt: "string",
+            seed: "number | null",
+            size: "string",
+            sourcePath: "string | null",
+            elapsedMs: "number"
+          }
+        }
+      ]
     }
   },
   categories: [
@@ -57355,7 +58225,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-08T23:56:00.442Z",
+  exportedAt: "2026-09-12T07:27:39.835Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -58674,6 +59544,11 @@ var component_mapping_default = {
       importPath: "@/components/game/atoms/DrawSprite",
       category: "game"
     },
+    "draw-skinned-mesh": {
+      component: "DrawSkinnedMesh",
+      importPath: "@/components/game/atoms/DrawSkinnedMesh",
+      category: "game"
+    },
     "draw-text": {
       component: "DrawText",
       importPath: "@/components/game/atoms/DrawText",
@@ -58800,7 +59675,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-08T23:56:00.442Z",
+  exportedAt: "2026-09-12T07:27:39.835Z",
   contracts: {
     form: {
       emits: [
@@ -60067,6 +60942,7 @@ var PATTERN_TYPES = [
   "draw-mesh",
   "draw-shape",
   "draw-shape-layer",
+  "draw-skinned-mesh",
   "draw-sprite",
   "draw-sprite-layer",
   "draw-text",
@@ -60283,6 +61159,9 @@ function isMainSlotRenderUi(effect) {
   return Array.isArray(effect) && effect[0] === "render-ui" && effect[1] === "main";
 }
 
+// src/patterns/self-overlay.ts
+var SELF_OVERLAY_PATTERN_TYPES = /* @__PURE__ */ new Set(["modal", "confirm-dialog"]);
+
 // src/patterns/helpers/prompt-helpers.ts
 function getPatternsGroupedByCategory() {
   const patterns = patterns_registry_default.patterns || {};
@@ -60780,6 +61659,6 @@ function propHostsDrawables(schema) {
   return false;
 }
 
-export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, buildRecommendationContext, collectRenderUiPatternTypes, component_mapping_default as componentMapping, event_contracts_default as eventContracts, eventKeyPropsOf, eventListPropsOf, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternFieldsContract, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, isValueInputPattern, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
+export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, SELF_OVERLAY_PATTERN_TYPES, buildRecommendationContext, collectRenderUiPatternTypes, component_mapping_default as componentMapping, event_contracts_default as eventContracts, eventKeyPropsOf, eventListPropsOf, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternFieldsContract, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, isValueInputPattern, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map