@almadar/core 10.80.0 → 10.82.0

package/dist/patterns/patterns-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-09-02T20:03:03.703Z",
+  "exportedAt": "2026-09-03T18:48:23.816Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -26138,6 +26138,28 @@
           ],
           "description": "Accessible label/tooltip for the row hover action."
         },
+        "onNodeReorder": {
+          "types": [
+            "function"
+          ],
+          "description": "Called when a row is dropped onto another, in flat `items` mode; carries the moved node's id, its new parent id (`null` for a root drop), and its index within the new parent's children. Presence-gated: binding this prop is what turns on row dragging.",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "id",
+              "type": "string"
+            },
+            {
+              "name": "newParentId",
+              "type": "string"
+            },
+            {
+              "name": "index",
+              "type": "number"
+            }
+          ],
+          "default": ""
+        },
         "className": {
           "types": [
             "string"
@@ -32686,6 +32708,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
+            }
+          ]
         }
       }
     },
@@ -35157,6 +35193,19 @@
             "string"
           ],
           "description": "Class for right/bottom pane"
+        },
+        "onRatioChange": {
+          "types": [
+            "function"
+          ],
+          "description": "Called with the new ratio while dragging. Providing this makes `ratio` controlled — the rendered split always tracks the prop instead of internal state, mirroring a controlled input. Omit for uncontrolled (self-tracked) behavior.",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "ratio",
+              "type": "number"
+            }
+          ]
         }
       }
     },
@@ -37775,6 +37824,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"
@@ -38950,6 +39085,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"
@@ -39074,6 +39215,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -40446,6 +40592,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -41721,6 +41872,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -42183,6 +42339,26 @@
           "description": "Draw numeric labels on grid lines (default false).",
           "default": false
         },
+        "tickLabelFontSize": {
+          "types": [
+            "number"
+          ],
+          "description": "Font size in px for axis tick labels (default 10).",
+          "default": 10
+        },
+        "labelFontSize": {
+          "types": [
+            "number"
+          ],
+          "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"
@@ -42760,6 +42936,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -44295,6 +44476,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -45504,6 +45690,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -48786,6 +48977,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"
@@ -50314,6 +50589,11 @@
                   "number"
                 ]
               },
+              "fontFamily": {
+                "types": [
+                  "string"
+                ]
+              },
               "align": {
                 "types": [
                   "string"
@@ -51563,6 +51843,658 @@
           "description": "className prop"
         }
       }
+    },
+    "floating-toolbar": {
+      "type": "floating-toolbar",
+      "category": "component",
+      "tier": "molecules",
+      "family": "core",
+      "description": "FloatingToolbar component",
+      "suggestedFor": [
+        "floating",
+        "toolbar",
+        "floating toolbar"
+      ],
+      "typicalSize": "medium",
+      "propsSchema": {
+        "items": {
+          "types": [
+            "array"
+          ],
+          "description": "Tool items rendered as icon buttons",
+          "required": true,
+          "items": {
+            "types": [
+              "object"
+            ],
+            "properties": {
+              "id": {
+                "types": [
+                  "string"
+                ]
+              },
+              "icon": {
+                "types": [
+                  "icon",
+                  "string"
+                ]
+              },
+              "label": {
+                "types": [
+                  "string"
+                ]
+              },
+              "event": {
+                "types": [
+                  "string"
+                ]
+              },
+              "action": {
+                "types": [
+                  "string"
+                ]
+              },
+              "actionPayload": {
+                "types": [
+                  "object"
+                ],
+                "freeform": true,
+                "eventPayloadBrand": true
+              },
+              "active": {
+                "types": [
+                  "boolean"
+                ]
+              },
+              "disabled": {
+                "types": [
+                  "boolean"
+                ]
+              },
+              "testId": {
+                "types": [
+                  "string"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "icon",
+              "label"
+            ]
+          }
+        },
+        "position": {
+          "types": [
+            "string"
+          ],
+          "description": "Strip position within the app frame.",
+          "enumValues": [
+            "bottom-center",
+            "bottom-left",
+            "bottom-right"
+          ],
+          "default": "bottom-center"
+        },
+        "children": {
+          "types": [
+            "node"
+          ],
+          "description": "Custom cells appended after the items, separated by a divider"
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes on the positioned root"
+        }
+      }
+    },
+    "dock-layout": {
+      "type": "dock-layout",
+      "category": "layout",
+      "tier": "organisms",
+      "family": "core",
+      "description": "DockLayout component",
+      "suggestedFor": [
+        "dock",
+        "layout",
+        "dock layout"
+      ],
+      "typicalSize": "large",
+      "propsSchema": {
+        "rail": {
+          "types": [
+            "node"
+          ],
+          "description": "Fixed-width far-left vertical strip (e.g. an icon nav rail)."
+        },
+        "sidebar": {
+          "types": [
+            "node"
+          ],
+          "description": "Collapsible, resizable left sidebar."
+        },
+        "main": {
+          "types": [
+            "node"
+          ],
+          "description": "Required center region.",
+          "required": true
+        },
+        "bottomPanel": {
+          "types": [
+            "node"
+          ],
+          "description": "Collapsible, resizable-height bottom panel."
+        },
+        "statusBar": {
+          "types": [
+            "node"
+          ],
+          "description": "Slim strip pinned to the bottom of the frame, below the bottom panel."
+        },
+        "secondarySidebar": {
+          "types": [
+            "node"
+          ],
+          "description": "Collapsible right sidebar."
+        },
+        "railWidth": {
+          "types": [
+            "number"
+          ],
+          "description": "Width of `rail` in pixels. @default 56",
+          "default": 56
+        },
+        "secondarySidebarWidth": {
+          "types": [
+            "number"
+          ],
+          "description": "Width of `secondarySidebar` in pixels (fixed — not resizable). @default 280",
+          "default": 280
+        },
+        "sidebarCollapsed": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether `sidebar` is collapsed. @default false",
+          "default": false
+        },
+        "onSidebarCollapsedChange": {
+          "types": [
+            "function"
+          ],
+          "description": "onSidebarCollapsedChange prop",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "collapsed",
+              "type": "boolean"
+            }
+          ]
+        },
+        "sidebarWidth": {
+          "types": [
+            "number"
+          ],
+          "description": "Sidebar size as a SplitPane ratio (0-100, percentage of the sidebar/main split). @default 20",
+          "default": 20
+        },
+        "onSidebarWidthChange": {
+          "types": [
+            "function"
+          ],
+          "description": "onSidebarWidthChange prop",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "width",
+              "type": "number"
+            }
+          ]
+        },
+        "sidebarMinSize": {
+          "types": [
+            "number"
+          ],
+          "description": "Minimum sidebar size in pixels, forwarded to SplitPane's `minSize`. @default 160",
+          "default": 160
+        },
+        "bottomPanelCollapsed": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether `bottomPanel` is collapsed. @default false",
+          "default": false
+        },
+        "onBottomPanelCollapsedChange": {
+          "types": [
+            "function"
+          ],
+          "description": "onBottomPanelCollapsedChange prop",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "collapsed",
+              "type": "boolean"
+            }
+          ]
+        },
+        "bottomPanelHeight": {
+          "types": [
+            "number"
+          ],
+          "description": "Bottom panel size as a SplitPane ratio (0-100, percentage given to the panel). @default 30",
+          "default": 30
+        },
+        "onBottomPanelHeightChange": {
+          "types": [
+            "function"
+          ],
+          "description": "onBottomPanelHeightChange prop",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "height",
+              "type": "number"
+            }
+          ]
+        },
+        "bottomPanelMinSize": {
+          "types": [
+            "number"
+          ],
+          "description": "Minimum bottom panel size in pixels, forwarded to SplitPane's `minSize`. @default 120",
+          "default": 120
+        },
+        "secondarySidebarCollapsed": {
+          "types": [
+            "boolean"
+          ],
+          "description": "Whether `secondarySidebar` is collapsed. @default false",
+          "default": false
+        },
+        "onSecondarySidebarCollapsedChange": {
+          "types": [
+            "function"
+          ],
+          "description": "onSecondarySidebarCollapsedChange prop",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "collapsed",
+              "type": "boolean"
+            }
+          ]
+        },
+        "className": {
+          "types": [
+            "string"
+          ],
+          "description": "Additional CSS classes on the root frame."
+        },
+        "railClassName": {
+          "types": [
+            "string"
+          ],
+          "description": "railClassName prop"
+        },
+        "sidebarClassName": {
+          "types": [
+            "string"
+          ],
+          "description": "sidebarClassName prop"
+        },
+        "mainClassName": {
+          "types": [
+            "string"
+          ],
+          "description": "mainClassName prop"
+        },
+        "bottomPanelClassName": {
+          "types": [
+            "string"
+          ],
+          "description": "bottomPanelClassName prop"
+        },
+        "statusBarClassName": {
+          "types": [
+            "string"
+          ],
+          "description": "statusBarClassName prop"
+        },
+        "secondarySidebarClassName": {
+          "types": [
+            "string"
+          ],
+          "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": [