@almadar/core 10.81.0 → 10.82.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-03T03:26:05.097Z",
+  exportedAt: "2026-09-03T18:48:23.816Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -32711,6 +32711,20 @@ var patterns_registry_default = {
             "role",
             "category"
           ]
+        },
+        toggleEvent: {
+          types: [
+            "string"
+          ],
+          description: "Event dispatched via event bus on toggle, carrying the new muted state.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "muted",
+              type: "boolean",
+              required: true
+            }
+          ]
         }
       }
     },
@@ -37813,6 +37827,92 @@ var patterns_registry_default = {
             ]
           }
         },
+        editable: {
+          types: [
+            "boolean"
+          ],
+          description: "--- Scene-edit mode (a game studio selecting/dragging drawables). Purely",
+          default: false
+        },
+        selectedId: {
+          types: [
+            "string"
+          ],
+          description: "The currently-selected drawable id (controlled); `null`/undefined = none.",
+          default: null
+        },
+        onSelect: {
+          types: [
+            "function"
+          ],
+          description: "Fired on a click that changes selection \u2014 before `selectEvent`.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "id",
+              type: "string"
+            }
+          ]
+        },
+        onMove: {
+          types: [
+            "function"
+          ],
+          description: "Fired once per drag gesture, on drop \u2014 before `moveEvent`.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "id",
+              type: "string"
+            },
+            {
+              name: "x",
+              type: "number"
+            },
+            {
+              name: "y",
+              type: "number"
+            }
+          ]
+        },
+        selectEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative selection event, `UI:{selectEvent} { id }`.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "id",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        moveEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative move event, `UI:{moveEvent} { id, x, y }` \u2014 fired once on drop.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "id",
+              type: "string",
+              required: true
+            },
+            {
+              name: "x",
+              type: "number",
+              required: true
+            },
+            {
+              name: "y",
+              type: "number",
+              required: true
+            }
+          ]
+        },
         camera: {
           types: [
             "string"
@@ -38988,6 +39088,12 @@ var patterns_registry_default = {
           ],
           description: "Background color (default transparent)."
         },
+        fontFamily: {
+          types: [
+            "string"
+          ],
+          description: "Canvas text font family. Falls back to the theme's --font-family-body."
+        },
         shapes: {
           types: [
             "array"
@@ -39112,6 +39218,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -40484,6 +40595,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -41759,6 +41875,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -42235,6 +42356,12 @@ var patterns_registry_default = {
           description: "Base font size in px for all other canvas annotations (points, vectors, guides, curves, regions, angles, hops; default 12).",
           default: 12
         },
+        fontFamily: {
+          types: [
+            "string"
+          ],
+          description: 'Canvas text font family. Accepts a known game-font key (e.g. "future-narrow") or a CSS font-family string.'
+        },
         showCurveLabels: {
           types: [
             "boolean"
@@ -42812,6 +42939,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -44347,6 +44479,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -45556,6 +45693,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -48838,6 +48980,90 @@ var patterns_registry_default = {
             ]
           }
         },
+        editable: {
+          types: [
+            "boolean"
+          ],
+          description: "--- Scene-edit mode (a game studio selecting/dragging drawables). Purely"
+        },
+        selectedId: {
+          types: [
+            "string"
+          ],
+          description: "The currently-selected drawable id (controlled); `null`/undefined = none."
+        },
+        onSelect: {
+          types: [
+            "function"
+          ],
+          description: "Fired on a click that changes selection \u2014 before `selectEvent`.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "id",
+              type: "string"
+            }
+          ]
+        },
+        onMove: {
+          types: [
+            "function"
+          ],
+          description: "Fired once per drag gesture, on drop \u2014 before `moveEvent`.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "id",
+              type: "string"
+            },
+            {
+              name: "x",
+              type: "number"
+            },
+            {
+              name: "y",
+              type: "number"
+            }
+          ]
+        },
+        selectEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative selection event, `UI:{selectEvent} { id }`.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "id",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        moveEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative move event, `UI:{moveEvent} { id, x, y }` \u2014 fired once on drop.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "id",
+              type: "string",
+              required: true
+            },
+            {
+              name: "x",
+              type: "number",
+              required: true
+            },
+            {
+              name: "y",
+              type: "number",
+              required: true
+            }
+          ]
+        },
         children: {
           types: [
             "node"
@@ -50366,6 +50592,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -51682,6 +51913,11 @@ var patterns_registry_default = {
                 types: [
                   "boolean"
                 ]
+              },
+              testId: {
+                types: [
+                  "string"
+                ]
               }
             },
             required: [
@@ -51938,6 +52174,330 @@ var patterns_registry_default = {
           description: "secondarySidebarClassName prop"
         }
       }
+    },
+    "command-palette": {
+      type: "command-palette",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "CommandPalette component",
+      suggestedFor: [
+        "command",
+        "palette",
+        "command palette"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        open: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether the palette overlay is open",
+          required: true
+        },
+        onOpenChange: {
+          types: [
+            "function"
+          ],
+          description: "Called to open/close the overlay (Escape, overlay click, or a selection)",
+          required: true,
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "open",
+              type: "boolean"
+            }
+          ]
+        },
+        commands: {
+          types: [
+            "array"
+          ],
+          description: "Commands listed in the palette, filtered as the user types",
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              label: {
+                types: [
+                  "string"
+                ]
+              },
+              icon: {
+                types: [
+                  "icon",
+                  "string"
+                ]
+              },
+              shortcut: {
+                types: [
+                  "string"
+                ]
+              },
+              keywords: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "string"
+                  ]
+                }
+              },
+              group: {
+                types: [
+                  "string"
+                ]
+              },
+              disabled: {
+                types: [
+                  "boolean"
+                ]
+              },
+              event: {
+                types: [
+                  "string"
+                ]
+              },
+              action: {
+                types: [
+                  "string"
+                ]
+              },
+              actionPayload: {
+                types: [
+                  "object"
+                ],
+                freeform: true,
+                eventPayloadBrand: true
+              }
+            },
+            required: [
+              "id",
+              "label"
+            ]
+          }
+        },
+        onSelect: {
+          types: [
+            "function"
+          ],
+          description: "Called with the selected command (click, or Enter on the highlighted row)",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "command",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  id: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  label: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  icon: {
+                    types: [
+                      "icon",
+                      "string"
+                    ]
+                  },
+                  shortcut: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  keywords: {
+                    types: [
+                      "array"
+                    ],
+                    items: {
+                      types: [
+                        "string"
+                      ]
+                    }
+                  },
+                  group: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  disabled: {
+                    types: [
+                      "boolean"
+                    ]
+                  },
+                  event: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  action: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  actionPayload: {
+                    types: [
+                      "object"
+                    ],
+                    freeform: true,
+                    eventPayloadBrand: true
+                  }
+                },
+                required: [
+                  "id",
+                  "label"
+                ]
+              }
+            }
+          ]
+        },
+        placeholder: {
+          types: [
+            "string"
+          ],
+          description: "Search field placeholder. Consumers own i18n \u2014 plain string prop, no package-internal translation (matches FloatingToolbar's convention).",
+          default: "Type a command..."
+        },
+        emptyLabel: {
+          types: [
+            "string"
+          ],
+          description: "Label shown when no command matches the query",
+          default: "No matching commands"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes on the overlay's dialog"
+        }
+      }
+    },
+    "game-audio-cue": {
+      type: "game-audio-cue",
+      category: "game",
+      tier: "atoms",
+      family: "game",
+      description: "GameAudioCue component",
+      suggestedFor: [
+        "game",
+        "audio",
+        "cue",
+        "game audio cue"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        cue: {
+          types: [
+            "string"
+          ],
+          description: "Manifest key played as a one-shot SFX each time `cueSeq` advances."
+        },
+        cueSeq: {
+          types: [
+            "number"
+          ],
+          description: "Monotonically increasing counter \u2014 bumping it re-triggers `cue`."
+        },
+        music: {
+          types: [
+            "string"
+          ],
+          description: "Manifest key to crossfade to as looping background music; unset/empty stops music."
+        },
+        muted: {
+          types: [
+            "boolean"
+          ],
+          description: "Muted state, owned externally and mirrored into the hook."
+        },
+        volume: {
+          types: [
+            "number"
+          ],
+          description: "Master volume 0-1, owned externally and mirrored into the hook."
+        },
+        manifest: {
+          types: [
+            "object"
+          ],
+          description: "Sound manifest \u2014 keys mapped to sound definitions (path, volume, loop, ...).",
+          required: true,
+          mapValue: {
+            types: [
+              "object"
+            ],
+            properties: {
+              path: {
+                types: [
+                  "string",
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "string"
+                  ]
+                }
+              },
+              volume: {
+                types: [
+                  "number"
+                ]
+              },
+              loop: {
+                types: [
+                  "boolean"
+                ]
+              },
+              poolSize: {
+                types: [
+                  "number"
+                ]
+              },
+              autostart: {
+                types: [
+                  "boolean"
+                ]
+              },
+              crossfade: {
+                types: [
+                  "boolean"
+                ]
+              },
+              crossfadeDurationMs: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "path"
+            ]
+          }
+        },
+        baseUrl: {
+          types: [
+            "string"
+          ],
+          description: "Base URL prepended to every manifest path."
+        }
+      }
     }
   },
   categories: [
@@ -51963,7 +52523,7 @@ var patterns_registry_default = {
 // src/patterns/integrators-registry.json
 var integrators_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-03T08:33:38.850Z",
+  exportedAt: "2026-09-03T18:48:24.308Z",
   integrators: {
     github: {
       name: "github",
@@ -55481,7 +56041,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-03T03:26:05.097Z",
+  exportedAt: "2026-09-03T18:48:23.816Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -56904,6 +57464,16 @@ var component_mapping_default = {
       component: "DockLayout",
       importPath: "@/components/core/organisms/DockLayout",
       category: "layout"
+    },
+    "command-palette": {
+      component: "CommandPalette",
+      importPath: "@/components/core/molecules/CommandPalette",
+      category: "component"
+    },
+    "game-audio-cue": {
+      component: "GameAudioCue",
+      importPath: "@/components/game/atoms/GameAudioCue",
+      category: "game"
     }
   }
 };
@@ -56911,7 +57481,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-03T03:26:05.097Z",
+  exportedAt: "2026-09-03T18:48:23.816Z",
   contracts: {
     form: {
       emits: [
@@ -58126,6 +58696,7 @@ var PATTERN_TYPES = [
   "choice-button",
   "code-block",
   "code-runner-panel",
+  "command-palette",
   "community-links",
   "conditional-wrapper",
   "confetti-effect",
@@ -58196,6 +58767,7 @@ var PATTERN_TYPES = [
   "form-section",
   "form-section-header",
   "fx-overlay",
+  "game-audio-cue",
   "game-audio-toggle",
   "game-hud",
   "game-icon",