@almadar/core 10.80.0 → 10.82.0

package/dist/factory/index.js

@@ -27048,6 +27048,28 @@ var patterns_registry_default = {
           ],
           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"
@@ -33596,6 +33618,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
+            }
+          ]
         }
       }
     },
@@ -36067,6 +36103,19 @@ var patterns_registry_default = {
             "string"
           ],
           description: "Class for right/bottom pane"
+        },
+        onRatioChange: {
+          types: [
+            "function"
+          ],
+          description: "Called with the new ratio while dragging. Providing this makes `ratio` controlled \u2014 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"
+            }
+          ]
         }
       }
     },
@@ -38685,6 +38734,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"
@@ -39860,6 +39995,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"
@@ -39984,6 +40125,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -41356,6 +41502,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -42631,6 +42782,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -43093,6 +43249,26 @@ var patterns_registry_default = {
           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"
@@ -43670,6 +43846,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -45205,6 +45386,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -46414,6 +46600,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -49696,6 +49887,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"
@@ -51224,6 +51499,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              fontFamily: {
+                types: [
+                  "string"
+                ]
+              },
               align: {
                 types: [
                   "string"
@@ -52473,16 +52753,668 @@ var patterns_registry_default = {
           description: "className prop"
         }
       }
-    }
-  }};
-var JsonValueSchema = z.lazy(
-  () => z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(JsonValueSchema), z.record(JsonValueSchema)])
-);
-
-// src/patterns/helpers/prompt-helpers.ts
-function getAllPatternTypes() {
-  const patterns = patterns_registry_default.patterns || {};
-  return Object.keys(patterns);
+    },
+    "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 \u2014 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 \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(
+  () => z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(JsonValueSchema), z.record(JsonValueSchema)])
+);
+
+// src/patterns/helpers/prompt-helpers.ts
+function getAllPatternTypes() {
+  const patterns = patterns_registry_default.patterns || {};
+  return Object.keys(patterns);
 }
 var ID_PREFIXES = {
   orbital: "orb_",
@@ -52832,6 +53764,44 @@ z.object({
   azimuth: z.number().optional(),
   elevation: z.number().optional()
 });
+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"];
+var ManifestSourceCatalogSchema = z.enum(MANIFEST_SOURCE_CATALOGS);
+var MANIFEST_ASSET_LICENSES = ["CC0", "proprietary"];
+var ManifestAssetLicenseSchema = z.enum(MANIFEST_ASSET_LICENSES);
+var ManifestFrameSpecSchema = z.union([
+  z.object({ kind: z.literal("iso-tile"), w: z.number(), h: z.number() }),
+  z.object({ kind: z.literal("sprite-sheet"), frame: z.number(), cols: z.number(), rows: z.number() }),
+  z.string().min(1),
+  z.null()
+]);
+z.object({
+  url: z.string(),
+  name: z.string(),
+  category: z.string(),
+  kind: ManifestEntryKindSchema,
+  width: z.number(),
+  height: z.number(),
+  canvasAffinity: ManifestCanvasAffinitySchema,
+  genreAffinity: z.array(z.string()),
+  swapClass: z.string(),
+  sourceCatalog: ManifestSourceCatalogSchema,
+  frameSpec: ManifestFrameSpecSchema,
+  license: ManifestAssetLicenseSchema.optional()
+});
 var SExprDataSchema = z.lazy(
   () => z.union([SExprAtomSchema, z.array(SExprDataSchema)])
 );