@almadar/core 10.81.0 → 10.83.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-04T03:53:29.561Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -16404,7 +16404,7 @@ var patterns_registry_default = {
           types: [
             "object"
           ],
-          description: "GAP-80: line-level error/warning highlights for editable mode. Map of 1-based line number \u2192 severity. The overlay paints a colored background on each line: error = red, warning = yellow. Pass undefined (default) to disable. The consumer is responsible for computing the path \u2192 line map from the schema + validation results.",
+          description: "GAP-80: line-level error/warning highlights. Map of 1-based line number \u2192 severity. Paints a colored background on each line: error = red, warning = yellow. Honored by the editable overlay and (GAP-84) by viewer mode's non-diff highlight; pass undefined (default) to disable. The consumer is responsible for computing the path \u2192 line map from the schema + validation results.",
           nonAuthorable: true
         },
         title: {
@@ -16693,6 +16693,265 @@ var patterns_registry_default = {
             "boolean"
           ],
           description: "Show copy button (viewer alias for showCopyButton)"
+        },
+        editorId: {
+          types: [
+            "string"
+          ],
+          description: "Stable identity for the keyboard router / plugin host to target this editor. Unset = this instance never receives capability events.",
+          tier: "presentation"
+        },
+        onEditorFocus: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus emit fired when this editor gains focus.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            }
+          ],
+          default: "EDITOR_FOCUS",
+          tier: "presentation"
+        },
+        onEditorBlur: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus emit fired when this editor loses focus.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            }
+          ],
+          default: "EDITOR_BLUR",
+          tier: "presentation"
+        },
+        onMotion: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus listen: move the cursor per the vim-style motion vocabulary.",
+          kind: "event-listen",
+          listenPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "motion",
+              type: "string",
+              required: true,
+              enumValues: [
+                "left",
+                "right",
+                "up",
+                "down",
+                "word-forward",
+                "word-back",
+                "word-end",
+                "line-start",
+                "line-end",
+                "first-nonblank",
+                "doc-start",
+                "doc-end",
+                "paragraph-forward",
+                "paragraph-back",
+                "line",
+                "selection"
+              ]
+            },
+            {
+              name: "count",
+              type: "number",
+              required: true
+            }
+          ],
+          default: "MOTION",
+          tier: "presentation"
+        },
+        onOperate: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus listen: apply a text operator over a motion's range.",
+          kind: "event-listen",
+          listenPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "operator",
+              type: "string",
+              required: true,
+              enumValues: [
+                "delete",
+                "yank",
+                "change"
+              ]
+            },
+            {
+              name: "motion",
+              type: "string",
+              required: true,
+              enumValues: [
+                "left",
+                "right",
+                "up",
+                "down",
+                "word-forward",
+                "word-back",
+                "word-end",
+                "line-start",
+                "line-end",
+                "first-nonblank",
+                "doc-start",
+                "doc-end",
+                "paragraph-forward",
+                "paragraph-back",
+                "line",
+                "selection"
+              ]
+            },
+            {
+              name: "count",
+              type: "number",
+              required: true
+            }
+          ],
+          default: "OPERATE",
+          tier: "presentation"
+        },
+        onInsertText: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus listen: insert literal text at the cursor.",
+          kind: "event-listen",
+          listenPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "text",
+              type: "string",
+              required: true
+            }
+          ],
+          default: "INSERT_TEXT",
+          tier: "presentation"
+        },
+        onSetMode: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus listen: switch editor mode and caret style.",
+          kind: "event-listen",
+          listenPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "mode",
+              type: "string",
+              required: true
+            },
+            {
+              name: "caret",
+              type: "string",
+              required: true,
+              enumValues: [
+                "bar",
+                "block",
+                "underline"
+              ]
+            }
+          ],
+          default: "SET_MODE",
+          tier: "presentation"
+        },
+        motions: {
+          types: [
+            "array"
+          ],
+          description: "Motion vocabulary this editor accepts. Default: the full `EditorMotion` set.",
+          items: {
+            types: [
+              "string"
+            ],
+            enumValues: [
+              "left",
+              "right",
+              "up",
+              "down",
+              "word-forward",
+              "word-back",
+              "word-end",
+              "line-start",
+              "line-end",
+              "first-nonblank",
+              "doc-start",
+              "doc-end",
+              "paragraph-forward",
+              "paragraph-back",
+              "line",
+              "selection"
+            ]
+          },
+          default: [
+            "left",
+            "right",
+            "up",
+            "down",
+            "word-forward",
+            "word-back",
+            "word-end",
+            "line-start",
+            "line-end",
+            "first-nonblank",
+            "doc-start",
+            "doc-end",
+            "paragraph-forward",
+            "paragraph-back",
+            "line",
+            "selection"
+          ],
+          tier: "presentation"
+        },
+        operators: {
+          types: [
+            "array"
+          ],
+          description: "Operator vocabulary this editor accepts. Default: the full `EditorOperator` set.",
+          items: {
+            types: [
+              "string"
+            ],
+            enumValues: [
+              "delete",
+              "yank",
+              "change"
+            ]
+          },
+          default: [
+            "delete",
+            "yank",
+            "change"
+          ],
+          tier: "presentation"
         }
       }
     },
@@ -26755,7 +27014,12 @@ var patterns_registry_default = {
             {
               name: "next",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "up",
+                "down",
+                "none"
+              ]
             }
           ]
         },
@@ -27223,7 +27487,12 @@ var patterns_registry_default = {
             {
               name: "vote",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "up",
+                "down",
+                "none"
+              ]
             }
           ]
         },
@@ -32711,6 +32980,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
+            }
+          ]
         }
       }
     },
@@ -36283,7 +36566,11 @@ var patterns_registry_default = {
             {
               name: "direction",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "asc",
+                "desc"
+              ]
             }
           ]
         },
@@ -37813,6 +38100,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"
@@ -38161,7 +38534,13 @@ var patterns_registry_default = {
             {
               name: "direction",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "up",
+                "down",
+                "left",
+                "right"
+              ]
             },
             {
               name: "pressed",
@@ -38988,6 +39367,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 +39497,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -39181,6 +39571,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -40484,6 +40875,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -40553,6 +40949,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -41759,6 +42156,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -41828,6 +42230,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -42235,6 +42638,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"
@@ -42293,6 +42702,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -42578,6 +42988,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -42812,6 +43223,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -42881,6 +43297,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -44347,6 +44764,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -44416,6 +44838,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -45556,6 +45979,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -45625,6 +46053,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -48838,6 +49267,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 +50879,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -50435,6 +50953,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -51682,6 +52201,11 @@ var patterns_registry_default = {
                 types: [
                   "boolean"
                 ]
+              },
+              testId: {
+                types: [
+                  "string"
+                ]
               }
             },
             required: [
@@ -51938,6 +52462,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 +52811,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 +56329,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-04T03:53:29.561Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -56904,6 +57752,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 +57769,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-04T03:53:29.561Z",
   contracts: {
     form: {
       emits: [
@@ -57821,6 +58679,20 @@ var event_contracts_default = {
           payload: {
             type: "object"
           }
+        },
+        {
+          event: "EDITOR_FOCUS",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "EDITOR_BLUR",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
         }
       ],
       requires: [],
@@ -58126,6 +58998,7 @@ var PATTERN_TYPES = [
   "choice-button",
   "code-block",
   "code-runner-panel",
+  "command-palette",
   "community-links",
   "conditional-wrapper",
   "confetti-effect",
@@ -58196,6 +59069,7 @@ var PATTERN_TYPES = [
   "form-section",
   "form-section-header",
   "fx-overlay",
+  "game-audio-cue",
   "game-audio-toggle",
   "game-hud",
   "game-icon",