@almadar/core 10.81.0 → 10.83.0

package/dist/factory/index.js

@@ -17311,7 +17311,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: {
@@ -17600,6 +17600,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"
         }
       }
     },
@@ -27662,7 +27921,12 @@ var patterns_registry_default = {
             {
               name: "next",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "up",
+                "down",
+                "none"
+              ]
             }
           ]
         },
@@ -28130,7 +28394,12 @@ var patterns_registry_default = {
             {
               name: "vote",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "up",
+                "down",
+                "none"
+              ]
             }
           ]
         },
@@ -33618,6 +33887,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
+            }
+          ]
         }
       }
     },
@@ -37190,7 +37473,11 @@ var patterns_registry_default = {
             {
               name: "direction",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "asc",
+                "desc"
+              ]
             }
           ]
         },
@@ -38720,6 +39007,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"
@@ -39068,7 +39441,13 @@ var patterns_registry_default = {
             {
               name: "direction",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "up",
+                "down",
+                "left",
+                "right"
+              ]
             },
             {
               name: "pressed",
@@ -39895,6 +40274,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"
@@ -40019,6 +40404,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -40088,6 +40478,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -41391,6 +41782,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -41460,6 +41856,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -42666,6 +43063,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -42735,6 +43137,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -43142,6 +43545,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"
@@ -43200,6 +43609,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -43485,6 +43895,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -43719,6 +44130,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -43788,6 +44204,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -45254,6 +45671,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -45323,6 +45745,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -46463,6 +46886,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -46532,6 +46960,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -49745,6 +50174,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"
@@ -51273,6 +51786,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -51342,6 +51860,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -52589,6 +53108,11 @@ var patterns_registry_default = {
                 types: [
                   "boolean"
                 ]
+              },
+              testId: {
+                types: [
+                  "string"
+                ]
               }
             },
             required: [
@@ -52845,6 +53369,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."
+        }
+      }
     }
   }};
 var JsonValueSchema = z.lazy(
@@ -53206,6 +54054,16 @@ z.object({
 });
 var MANIFEST_ENTRY_KINDS = ["model", "image", "spritesheet", "audio", "json"];
 var ManifestEntryKindSchema = z.enum(MANIFEST_ENTRY_KINDS);
+var SoundEntrySchema = z.object({
+  path: z.union([z.string(), z.array(z.string())]),
+  volume: z.number().optional(),
+  loop: z.boolean().optional(),
+  poolSize: z.number().optional(),
+  autostart: z.boolean().optional(),
+  crossfade: z.boolean().optional(),
+  crossfadeDurationMs: z.number().optional()
+});
+z.record(z.string(), SoundEntrySchema);
 var MANIFEST_CANVAS_AFFINITIES = ["isometric", "hex", "flat", "side", "3d", "none"];
 var ManifestCanvasAffinitySchema = z.enum(MANIFEST_CANVAS_AFFINITIES);
 var MANIFEST_SOURCE_CATALOGS = ["kenny", "kekec-assets", "iram-assets", "trait-wars-assets", "kflow-assets"];