@almadar/core 10.81.0 → 10.83.0

package/dist/patterns/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-09-03T03:26:05.097Z",
+  "exportedAt": "2026-09-04T03:53:29.561Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -16401,7 +16401,7 @@
           "types": [
             "object"
           ],
-          "description": "GAP-80: line-level error/warning highlights for editable mode. Map of 1-based line number → 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 → line map from the schema + validation results.",
+          "description": "GAP-80: line-level error/warning highlights. Map of 1-based line number → 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 → line map from the schema + validation results.",
           "nonAuthorable": true
         },
         "title": {
@@ -16690,6 +16690,265 @@
             "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"
         }
       }
     },
@@ -26752,7 +27011,12 @@
             {
               "name": "next",
               "type": "string",
-              "required": true
+              "required": true,
+              "enumValues": [
+                "up",
+                "down",
+                "none"
+              ]
             }
           ]
         },
@@ -27220,7 +27484,12 @@
             {
               "name": "vote",
               "type": "string",
-              "required": true
+              "required": true,
+              "enumValues": [
+                "up",
+                "down",
+                "none"
+              ]
             }
           ]
         },
@@ -32708,6 +32977,20 @@
             "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
+            }
+          ]
         }
       }
     },
@@ -36280,7 +36563,11 @@
             {
               "name": "direction",
               "type": "string",
-              "required": true
+              "required": true,
+              "enumValues": [
+                "asc",
+                "desc"
+              ]
             }
           ]
         },
@@ -37810,6 +38097,92 @@
             ]
           }
         },
+        "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 — before `selectEvent`.",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "id",
+              "type": "string"
+            }
+          ]
+        },
+        "onMove": {
+          "types": [
+            "function"
+          ],
+          "description": "Fired once per drag gesture, on drop — 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 }` — 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"
@@ -38158,7 +38531,13 @@
             {
               "name": "direction",
               "type": "string",
-              "required": true
+              "required": true,
+              "enumValues": [
+                "up",
+                "down",
+                "left",
+                "right"
+              ]
             },
             {
               "name": "pressed",
@@ -38985,6 +39364,12 @@
           ],
           "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"
@@ -39109,6 +39494,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -39178,6 +39568,7 @@
                   "string"
                 ],
                 "enumValues": [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -40481,6 +40872,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -40550,6 +40946,7 @@
                   "string"
                 ],
                 "enumValues": [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -41756,6 +42153,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -41825,6 +42227,7 @@
                   "string"
                 ],
                 "enumValues": [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -42232,6 +42635,12 @@
           "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"
@@ -42290,6 +42699,7 @@
                   "string"
                 ],
                 "enumValues": [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -42575,6 +42985,7 @@
                   "string"
                 ],
                 "enumValues": [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -42809,6 +43220,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -42878,6 +43294,7 @@
                   "string"
                 ],
                 "enumValues": [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -44344,6 +44761,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -44413,6 +44835,7 @@
                   "string"
                 ],
                 "enumValues": [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -45553,6 +45976,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -45622,6 +46050,7 @@
                   "string"
                 ],
                 "enumValues": [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -48835,6 +49264,90 @@
             ]
           }
         },
+        "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 — before `selectEvent`.",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "id",
+              "type": "string"
+            }
+          ]
+        },
+        "onMove": {
+          "types": [
+            "function"
+          ],
+          "description": "Fired once per drag gesture, on drop — 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 }` — 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"
@@ -50363,6 +50876,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -50432,6 +50950,7 @@
                   "string"
                 ],
                 "enumValues": [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -51679,6 +52198,11 @@
                 "types": [
                   "boolean"
                 ]
+              },
+              "testId": {
+                "types": [
+                  "string"
+                ]
               }
             },
             "required": [
@@ -51935,6 +52459,330 @@
           "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 — 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 — 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 — 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": [