@almadar/core 10.90.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-10T08:51:20.514Z",
+  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",
@@ -8467,9 +8483,7 @@ var patterns_registry_default = {
             "function",
             "string"
           ],
-          description: "Callback or declarative event key when clear button is clicked",
-          kind: "event-ref",
-          emitPayloadSchema: []
+          description: "Callback or declarative event key when clear button is clicked"
         },
         options: {
           types: [
@@ -8514,16 +8528,9 @@ var patterns_registry_default = {
           kind: "event-ref",
           emitPayloadSchema: [
             {
-              name: "value",
-              type: "string",
-              required: true,
-              typeWhen: [
-                {
-                  knob: "inputType",
-                  equals: "number",
-                  type: "number"
-                }
-              ]
+              name: "_payload",
+              type: "object",
+              required: false
             }
           ]
         }
@@ -8593,6 +8600,7 @@ var patterns_registry_default = {
     select: {
       type: "select",
       category: "component",
+      sourceFile: "components/core/atoms/Select.tsx",
       tier: "atoms",
       family: "core",
       description: "Dropdown select input",
@@ -8782,7 +8790,26 @@ var patterns_registry_default = {
             "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"
+                  ]
+                }
+              }
+            }
+          ]
         }
       }
     },
@@ -11337,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.",
@@ -11457,9 +11485,7 @@ var patterns_registry_default = {
             "function",
             "string"
           ],
-          description: "Callback or declarative event key when clear button is clicked",
-          kind: "event-ref",
-          emitPayloadSchema: []
+          description: "Callback or declarative event key when clear button is clicked"
         },
         options: {
           types: [
@@ -11503,16 +11529,9 @@ var patterns_registry_default = {
           kind: "event-ref",
           emitPayloadSchema: [
             {
-              name: "value",
-              type: "string",
-              required: true,
-              typeWhen: [
-                {
-                  knob: "inputType",
-                  equals: "number",
-                  type: "number"
-                }
-              ]
+              name: "_payload",
+              type: "object",
+              required: false
             }
           ]
         },
@@ -13812,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>',
@@ -13937,7 +13957,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -14032,7 +14055,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -28300,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",
@@ -28389,7 +28416,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -28479,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",
@@ -28554,7 +28585,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -28671,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",
@@ -28761,7 +28796,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -28832,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",
@@ -28980,7 +29019,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -29075,7 +29117,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -29110,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",
@@ -29185,7 +29231,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -29272,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",
@@ -29398,7 +29448,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -31668,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",
@@ -31758,7 +31812,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -31852,7 +31909,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -32009,7 +32069,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -32103,7 +32166,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -32292,7 +32358,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -32639,7 +32708,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -32680,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",
@@ -32755,7 +32828,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -32850,7 +32926,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -33376,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",
@@ -33507,7 +33587,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -33602,7 +33685,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -33651,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",
@@ -33763,7 +33850,10 @@ var patterns_registry_default = {
                     "1:1",
                     "16:9",
                     "5:7",
-                    "8:1"
+                    "8:1",
+                    "4:1",
+                    "5:3",
+                    "1:2"
                   ]
                 },
                 atlas: {
@@ -34006,7 +34096,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -34183,7 +34276,10 @@ var patterns_registry_default = {
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       atlas: {
@@ -34409,7 +34505,10 @@ var patterns_registry_default = {
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       atlas: {
@@ -34604,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.",
@@ -34714,7 +34814,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -34902,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.",
@@ -35114,7 +35218,10 @@ var patterns_registry_default = {
                     "1:1",
                     "16:9",
                     "5:7",
-                    "8:1"
+                    "8:1",
+                    "4:1",
+                    "5:3",
+                    "1:2"
                   ]
                 },
                 atlas: {
@@ -35277,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.",
@@ -35387,7 +35495,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -35615,7 +35726,10 @@ var patterns_registry_default = {
                           "1:1",
                           "16:9",
                           "5:7",
-                          "8:1"
+                          "8:1",
+                          "4:1",
+                          "5:3",
+                          "1:2"
                         ]
                       },
                       atlas: {
@@ -38664,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",
@@ -38810,7 +38925,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -39122,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",
@@ -39233,7 +39352,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -39462,7 +39584,10 @@ var patterns_registry_default = {
                   "1:1",
                   "16:9",
                   "5:7",
-                  "8:1"
+                  "8:1",
+                  "4:1",
+                  "5:3",
+                  "1:2"
                 ]
               },
               atlas: {
@@ -39533,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",
@@ -39608,7 +39734,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -47906,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",
@@ -48027,7 +48157,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -49011,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",
@@ -49153,7 +49287,10 @@ var patterns_registry_default = {
                       "1:1",
                       "16:9",
                       "5:7",
-                      "8:1"
+                      "8:1",
+                      "4:1",
+                      "5:3",
+                      "1:2"
                     ]
                   },
                   atlas: {
@@ -49459,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",
@@ -49698,7 +49836,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -52131,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",
@@ -52506,7 +52648,10 @@ var patterns_registry_default = {
                   "1:1",
                   "16:9",
                   "5:7",
-                  "8:1"
+                  "8:1",
+                  "4:1",
+                  "5:3",
+                  "1:2"
                 ]
               },
               atlas: {
@@ -53924,7 +54069,10 @@ var patterns_registry_default = {
                 "1:1",
                 "16:9",
                 "5:7",
-                "8:1"
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
               ]
             },
             atlas: {
@@ -54056,7 +54204,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "The skeleton (bind pose; FK chain via `parent` names).",
+          description: "The skeleton (bind pose; FK chain via `parent` names). Falls back to the rigbundle's `bones` when empty.",
           required: true,
           items: {
             types: [
@@ -54139,6 +54287,12 @@ var patterns_registry_default = {
             "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"
@@ -54206,7 +54360,7 @@ var patterns_registry_default = {
 // src/patterns/integrators-registry.json
 var integrators_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-10T08:46:50.227Z",
+  exportedAt: "2026-09-12T12:14:53.173Z",
   integrators: {
     github: {
       name: "github",
@@ -57815,9 +57969,9 @@ var integrators_registry_default = {
             },
             {
               name: "rig",
-              type: "string",
+              type: "object",
               required: true,
-              description: "Rig type to build (e.g. 'humanoid', 'quadruped')."
+              description: "The rig definition (parts, boxes, pivots, \u2026) as JSON."
             }
           ],
           responseShape: {
@@ -57840,9 +57994,9 @@ var integrators_registry_default = {
             },
             {
               name: "rig",
-              type: "string",
+              type: "object",
               required: true,
-              description: "Rig type."
+              description: "The rig definition (parts, boxes, pivots, \u2026) as JSON."
             },
             {
               name: "preset",
@@ -57855,9 +58009,201 @@ var integrators_registry_default = {
               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: {}
+          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"
+          }
         }
       ]
     }
@@ -57879,7 +58225,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-10T08:51:20.514Z",
+  exportedAt: "2026-09-12T07:27:39.835Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -59329,7 +59675,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-10T08:51:20.514Z",
+  exportedAt: "2026-09-12T07:27:39.835Z",
   contracts: {
     form: {
       emits: [