cursedbelt 0.0.0

package/dist/react/layoutEngine/SuggestPanel.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '../lib/cn';
+import { allWidgets } from './registry';
+// A palette of the widget types an app's registry offers, grouped by category and
+// added with a tap (a tap, not a fiddly drag, is the accessible + mobile-friendly add
+// gesture — the canvas owns the drag-to-arrange once a block exists). The widget
+// CONTENT is app-supplied via the registry; this is the generic chrome.
+const ORDER = ['Field', 'Aggregate', 'Decoration', 'Layout'];
+const HEADING = {
+    Field: 'Fields',
+    Aggregate: 'Summaries',
+    Decoration: 'Text & dividers',
+    Layout: 'Layout',
+};
+export function SuggestPanel({ widgets, onAdd, hideFallback = true, className, }) {
+    const defs = allWidgets(widgets).filter((d) => !(hideFallback && d.type === 'keyValue'));
+    const byCategory = new Map();
+    for (const d of defs) {
+        const list = byCategory.get(d.category) ?? [];
+        list.push(d);
+        byCategory.set(d.category, list);
+    }
+    return (_jsx("div", { className: cn('flex flex-col gap-4', className), children: ORDER.filter((c) => byCategory.has(c)).map((category) => (_jsxs("div", { className: 'flex flex-col gap-1.5', children: [_jsx("p", { className: 'text-[11px] font-semibold uppercase tracking-wide text-muted-foreground', children: HEADING[category] }), _jsx("div", { className: 'grid grid-cols-1 gap-1.5', children: (byCategory.get(category) ?? []).map((d) => (_jsxs("button", { type: 'button', onClick: () => onAdd(d), className: 'flex items-start gap-2 rounded-md border border-border bg-surface p-2 text-left transition hover:border-accent hover:bg-accent/5 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring', children: [d.icon && _jsx("span", { className: 'mt-0.5 shrink-0 text-muted-foreground', children: d.icon }), _jsxs("span", { className: 'min-w-0', children: [_jsx("span", { className: 'block truncate text-sm font-medium text-foreground', children: d.title }), _jsx("span", { className: 'block text-xs text-muted-foreground', children: d.description })] })] }, d.type))) })] }, category))) }));
+}
+//# sourceMappingURL=SuggestPanel.js.map

package/dist/react/layoutEngine/SuggestPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuggestPanel.js","sourceRoot":"","sources":["../../../src/react/layoutEngine/SuggestPanel.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,kFAAkF;AAClF,sFAAsF;AACtF,iFAAiF;AACjF,wEAAwE;AAExE,MAAM,KAAK,GAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AAC/E,MAAM,OAAO,GAAmC;IAC9C,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,iBAAiB;IAC7B,MAAM,EAAE,QAAQ;CACjB,CAAC;AAWF,MAAM,UAAU,YAAY,CAAsC,EAChE,OAAO,EACP,KAAK,EACL,YAAY,GAAG,IAAI,EACnB,SAAS,GACY;IACrB,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC;IACzF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAwC,CAAC;IACnE,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACb,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,CACL,cAAK,SAAS,EAAE,EAAE,CAAC,qBAAqB,EAAE,SAAS,CAAC,YACjD,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CACxD,eAAoB,SAAS,EAAC,uBAAuB,aACnD,YAAG,SAAS,EAAC,yEAAyE,YACnF,OAAO,CAAC,QAAQ,CAAC,GAChB,EACJ,cAAK,SAAS,EAAC,0BAA0B,YACtC,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAC3C,kBAEE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EACvB,SAAS,EAAC,0MAA0M,aAEnN,CAAC,CAAC,IAAI,IAAI,eAAM,SAAS,EAAC,uCAAuC,YAAE,CAAC,CAAC,IAAI,GAAQ,EAClF,gBAAM,SAAS,EAAC,SAAS,aACvB,eAAM,SAAS,EAAC,oDAAoD,YACjE,CAAC,CAAC,KAAK,GACH,EACP,eAAM,SAAS,EAAC,qCAAqC,YAAE,CAAC,CAAC,WAAW,GAAQ,IACvE,KAXF,CAAC,CAAC,IAAI,CAYJ,CACV,CAAC,GACE,KArBE,QAAQ,CAsBZ,CACP,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/react/layoutEngine/index.d.ts

@@ -0,0 +1,9 @@
+export * from './LayoutCanvas';
+export * from './LayoutConfigDialog';
+export * from './LayoutRenderer';
+export * from './NodeInspector';
+export * from './registry';
+export * from './SuggestPanel';
+export * from './types';
+export * from './useLayoutEditor';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/layoutEngine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/layoutEngine/index.ts"],"names":[],"mappings":"AAMA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC"}

package/dist/react/layoutEngine/index.js

@@ -0,0 +1,15 @@
+// cursedbelt layout engine (React) — the read-only renderer + the from-scratch
+// WYSIWYG drag editor (canvas, inspector, palette, dialog) for the
+// `cursedbelt/layout` model. Generic over the app's field type; the app supplies a
+// widget registry (how each node type renders) + optionally a custom binding
+// resolver. Built on the design-system primitives (Surface/Grid, Modal/Drawer,
+// Collapsible) and @dnd-kit. Exported as part of `cursedbelt/react`.
+export * from './LayoutCanvas';
+export * from './LayoutConfigDialog';
+export * from './LayoutRenderer';
+export * from './NodeInspector';
+export * from './registry';
+export * from './SuggestPanel';
+export * from './types';
+export * from './useLayoutEditor';
+//# sourceMappingURL=index.js.map

package/dist/react/layoutEngine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/layoutEngine/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mFAAmF;AACnF,6EAA6E;AAC7E,+EAA+E;AAC/E,qEAAqE;AACrE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC"}

package/dist/react/layoutEngine/registry.d.ts

@@ -0,0 +1,11 @@
+import type { LayoutField, LayoutNode } from '../../core/layout';
+import type { LayoutWidgetDef, WidgetRegistry } from './types';
+export declare const createWidgetRegistry: <F extends LayoutField>(defs: LayoutWidgetDef<F>[]) => WidgetRegistry<F>;
+export declare const allWidgets: <F extends LayoutField>(registry: WidgetRegistry<F>) => LayoutWidgetDef<F>[];
+export declare const widgetDef: <F extends LayoutField>(registry: WidgetRegistry<F>, type: string) => LayoutWidgetDef<F> | undefined;
+export declare const isContainerType: <F extends LayoutField>(registry: WidgetRegistry<F>, type: string) => boolean;
+export declare const compatibleWidgets: <F extends LayoutField>(registry: WidgetRegistry<F>, field?: F) => LayoutWidgetDef<F>[];
+export declare const newNodeId: (seed: string) => string;
+export declare const makeElementNode: <F extends LayoutField>(registry: WidgetRegistry<F>, type: string, content?: string) => LayoutNode;
+export declare const makeSectionNode: (title?: string) => LayoutNode;
+//# sourceMappingURL=registry.d.ts.map

package/dist/react/layoutEngine/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/react/layoutEngine/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK/D,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,WAAW,EACxD,MAAM,eAAe,CAAC,CAAC,CAAC,EAAE,KACzB,cAAc,CAAC,CAAC,CAAqD,CAAC;AAGzE,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,WAAW,EAC9C,UAAU,cAAc,CAAC,CAAC,CAAC,KAC1B,eAAe,CAAC,CAAC,CAAC,EAA6B,CAAC;AAInD,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,WAAW,EAC7C,UAAU,cAAc,CAAC,CAAC,CAAC,EAC3B,MAAM,MAAM,KACX,eAAe,CAAC,CAAC,CAAC,GAAG,SAAgD,CAAC;AAGzE,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,WAAW,EACnD,UAAU,cAAc,CAAC,CAAC,CAAC,EAC3B,MAAM,MAAM,KACX,OAA6C,CAAC;AAIjD,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,WAAW,EACrD,UAAU,cAAc,CAAC,CAAC,CAAC,EAC3B,QAAQ,CAAC,KACR,eAAe,CAAC,CAAC,CAAC,EAOpB,CAAC;AAIF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAKrC,CAAC;AAIL,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,WAAW,EACnD,UAAU,cAAc,CAAC,CAAC,CAAC,EAC3B,MAAM,MAAM,EACZ,UAAU,MAAM,KACf,UASF,CAAC;AAGF,eAAO,MAAM,eAAe,GAAI,cAAiB,KAAG,UAOlD,CAAC"}

package/dist/react/layoutEngine/registry.js

@@ -0,0 +1,46 @@
+// Build a widget registry from a flat list of definitions, keyed by `type` (last
+// wins on a duplicate type). The canonical way an app assembles its palette:
+// `const WIDGETS = createWidgetRegistry([keyValueDef, badgeDef, sectionDef, …])`.
+export const createWidgetRegistry = (defs) => Object.fromEntries(defs.map((d) => [d.type, d]));
+// Every widget in the registry, in declaration order — the palette/SuggestPanel list.
+export const allWidgets = (registry) => Object.values(registry);
+// Look up a widget def, falling back to the registry's `keyValue` entry (the type
+// the migration coerces unknown nodes to). Returns undefined if neither exists.
+export const widgetDef = (registry, type) => registry[type] ?? registry.keyValue;
+// Whether a node type is a container (renders children on a sub-grid).
+export const isContainerType = (registry, type) => Boolean(registry[type]?.container);
+// The widgets that can render a column of this type (drives the inspector's "Show
+// as" picker). Widgets with no `acceptsColumnTypes` accept any column type.
+export const compatibleWidgets = (registry, field) => {
+    const t = field?.type;
+    return Object.values(registry).filter((w) => w.acceptsBindingKinds.includes('column') &&
+        (!w.acceptsColumnTypes || (!!t && w.acceptsColumnTypes.includes(t))));
+};
+// A short, reasonably-unique node id seeded by the widget type — used when an
+// editor adds a node to the canvas.
+export const newNodeId = (seed) => `${seed}-${typeof crypto !== 'undefined' && crypto.randomUUID
+    ? crypto.randomUUID().slice(0, 8)
+    : Math.random().toString(36).slice(2, 10)}`;
+// Make a decoration node (heading/text/divider/spacer) — a `static` binding, no
+// data. `content` seeds the editable text for heading/text.
+export const makeElementNode = (registry, type, content) => {
+    const node = {
+        id: newNodeId(type),
+        type,
+        binding: { kind: 'static' },
+        width: registry[type]?.defaultWidth ?? 'full',
+    };
+    if (content !== undefined)
+        node.content = content;
+    return node;
+};
+// Make a section container node (one level of nesting; holds child nodes).
+export const makeSectionNode = (title = 'Section') => ({
+    id: newNodeId('section'),
+    type: 'section',
+    binding: { kind: 'static' },
+    width: 'full',
+    title,
+    children: [],
+});
+//# sourceMappingURL=registry.js.map

package/dist/react/layoutEngine/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/react/layoutEngine/registry.ts"],"names":[],"mappings":"AAGA,iFAAiF;AACjF,6EAA6E;AAC7E,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,IAA0B,EACP,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzE,sFAAsF;AACtF,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,QAA2B,EACL,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEnD,kFAAkF;AAClF,gFAAgF;AAChF,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,QAA2B,EAC3B,IAAY,EACoB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC;AAEzE,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAA2B,EAC3B,IAAY,EACH,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;AAEjD,kFAAkF;AAClF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,QAA2B,EAC3B,KAAS,EACa,EAAE;IACxB,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC;IACtB,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CACnC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxC,CAAC,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CACvE,CAAC;AACJ,CAAC,CAAC;AAEF,8EAA8E;AAC9E,oCAAoC;AACpC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE,CAChD,GAAG,IAAI,IACL,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU;IAChD,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAC5C,EAAE,CAAC;AAEL,gFAAgF;AAChF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAA2B,EAC3B,IAAY,EACZ,OAAgB,EACJ,EAAE;IACd,MAAM,IAAI,GAAe;QACvB,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC;QACnB,IAAI;QACJ,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,IAAI,MAAM;KAC9C,CAAC;IACF,IAAI,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,GAAG,SAAS,EAAc,EAAE,CAAC,CAAC;IACjE,EAAE,EAAE,SAAS,CAAC,SAAS,CAAC;IACxB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC3B,KAAK,EAAE,MAAM;IACb,KAAK;IACL,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC"}

package/dist/react/layoutEngine/types.d.ts

@@ -0,0 +1,81 @@
+import type { FC, ReactNode } from 'react';
+import type { LayoutBinding, LayoutField, LayoutNode, LayoutRow, LayoutSurface, ResolvedBinding } from '../../core/layout';
+export type WidgetCategory = 'Field' | 'Decoration' | 'Aggregate' | 'Layout';
+/**
+ * What a widget's {@link LayoutWidgetDef.render} receives: the node, its resolved
+ * binding, the surface, the ambient row/rows, and (for container widgets) the
+ * pre-rendered child grid. Also exported as {@link WidgetProps}.
+ */
+export type WidgetContext<F extends LayoutField = LayoutField> = {
+    node: LayoutNode;
+    resolved: ResolvedBinding<F>;
+    surface: LayoutSurface;
+    /** When false (editor preview, card list) interactive widgets render display-only. */
+    interactive: boolean;
+    /** Present for column/aggregate bindings. */
+    field?: F;
+    row?: LayoutRow;
+    rows?: LayoutRow[];
+    /** Pre-rendered child grid for container widgets (section/group). */
+    children?: ReactNode;
+    /** Optimistic cell write for interactive widgets (toggle); wired by the host. */
+    onPatchCell?: (key: string, value: unknown) => void;
+};
+/**
+ * The props an optional per-widget inspector panel receives. A widget that needs
+ * its own advanced controls (e.g. a chart's metric, a progress widget's goal)
+ * supplies a {@link LayoutWidgetDef.InspectorComponent}; the {@link NodeInspector}
+ * renders it under "More options" so it stays out of the non-technical primary flow.
+ */
+export type WidgetInspectorProps<F extends LayoutField = LayoutField> = {
+    node: LayoutNode;
+    /** The bound field, when the node binds a column/aggregate. */
+    field?: F;
+    /** Patch the selected node (merged shallowly). */
+    onChange: (patch: Partial<LayoutNode>) => void;
+};
+/**
+ * A widget registry entry: how to render it ({@link render}), what it binds to
+ * (palette gating), whether the renderer shows a field label above it, and an
+ * optional advanced inspector. Also exported as {@link WidgetDef}.
+ */
+export type LayoutWidgetDef<F extends LayoutField = LayoutField> = {
+    type: string;
+    /** Shown in the "add widget" palette + the inspector's "Show as" picker. */
+    title: string;
+    description: string;
+    icon?: ReactNode;
+    category: WidgetCategory;
+    defaultWidth?: LayoutNode['width'];
+    /** Which binding kinds this widget accepts (palette/inspector gating). */
+    acceptsBindingKinds: LayoutBinding['kind'][];
+    /** Column types this widget suits; omitted = any. Used to gate the palette. */
+    acceptsColumnTypes?: string[];
+    /** Per-column-type display variants offered in the inspector. */
+    variants?: (columnType?: string) => {
+        value: string;
+        label: string;
+    }[];
+    /** The renderer draws the field label above the widget (respecting node.hideLabel). */
+    labeled?: boolean;
+    /** Reads/writes a cell (must stopPropagation in a clickable card). */
+    interactive?: boolean;
+    /** A container widget (section/group) that lays its children out on a sub-grid. */
+    container?: boolean;
+    /** The widget's render function — its functional component body. */
+    render: (ctx: WidgetContext<F>) => ReactNode;
+    /** Optional advanced editor, rendered under "More options" in the inspector. */
+    InspectorComponent?: FC<WidgetInspectorProps<F>>;
+};
+/**
+ * An app's widget palette: a map of widget `type` → definition. The app owns this
+ * (it encodes the app's column types + how each renders); the engine reads through
+ * it. Conventionally includes a `keyValue` entry as the default fallback widget.
+ * Build one with {@link createWidgetRegistry}.
+ */
+export type WidgetRegistry<F extends LayoutField = LayoutField> = Record<string, LayoutWidgetDef<F>>;
+/** Spec alias for {@link LayoutWidgetDef}. */
+export type WidgetDef<F extends LayoutField = LayoutField> = LayoutWidgetDef<F>;
+/** Spec alias for {@link WidgetContext} — what a widget's render receives. */
+export type WidgetProps<F extends LayoutField = LayoutField> = WidgetContext<F>;
+//# sourceMappingURL=types.d.ts.map

package/dist/react/layoutEngine/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/react/layoutEngine/types.ts"],"names":[],"mappings":"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"}

package/dist/react/layoutEngine/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/react/layoutEngine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/react/layoutEngine/types.ts"],"names":[],"mappings":""}

package/dist/react/layoutEngine/useLayoutEditor.d.ts

@@ -0,0 +1,40 @@
+import { type LayoutNode, type LayoutView } from '../../core/layout';
+type Views = Record<string, LayoutView>;
+export type UseLayoutEditorOptions = {
+    /** Which view tab is active first; defaults to the first key of `initialViews`. */
+    initialTab?: string;
+    /** Max undo snapshots retained (default 50). */
+    historyLimit?: number;
+};
+export declare const useLayoutEditor: (initialViews: Views, opts?: UseLayoutEditorOptions) => {
+    tab: string;
+    tabs: string[];
+    selectTab: (next: string) => void;
+    view: LayoutView;
+    setEnabled: (enabled: boolean) => void;
+    applyViews: (next: Partial<Views>) => void;
+    addNode: (node: LayoutNode, containerId?: string | null) => void;
+    removeNode: (id: string) => void;
+    updateNode: (id: string, patch: Partial<LayoutNode>) => void;
+    reorder: (ids: string[], containerId?: string | null) => void;
+    moveNode: (id: string, toContainerId: string | null) => void;
+    moveNodeTo: (id: string, toContainerId: string | null, index: number) => void;
+    selectedId: string | null;
+    setSelectedId: (id: string | null) => void;
+    selectedNode: LayoutNode | null;
+    selectedContainer: string | null;
+    sections: LayoutNode[];
+    activeContainerId: string | null;
+    dirty: boolean;
+    /** Alias of `dirty` — true once the views differ from the opened/reset baseline. */
+    isDirty: boolean;
+    reset: (next: Views) => void;
+    undo: () => void;
+    redo: () => void;
+    canUndo: boolean;
+    canRedo: boolean;
+    payload: Views;
+};
+export type LayoutEditorState = ReturnType<typeof useLayoutEditor>;
+export {};
+//# sourceMappingURL=useLayoutEditor.d.ts.map

package/dist/react/layoutEngine/useLayoutEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLayoutEditor.d.ts","sourceRoot":"","sources":["../../../src/react/layoutEngine/useLayoutEditor.ts"],"names":[],"mappings":"AACA,OAAO,EAYL,KAAK,UAAU,EACf,KAAK,UAAU,EAMhB,MAAM,mBAAmB,CAAC;AAS3B,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAIxC,MAAM,MAAM,sBAAsB,GAAG;IACnC,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,cAAc,KAAK,EAAE,OAAM,sBAA2B;;;sBA+C3D,MAAM;;0BAKF,OAAO;uBAOV,OAAO,CAAC,KAAK,CAAC;oBAKjB,UAAU,gBAAe,MAAM,GAAG,IAAI;qBAIrC,MAAM;qBAIN,MAAM,SAAS,OAAO,CAAC,UAAU,CAAC;mBAEpC,MAAM,EAAE,gBAAe,MAAM,GAAG,IAAI;mBAGpC,MAAM,iBAAiB,MAAM,GAAG,IAAI;qBAGlC,MAAM,iBAAiB,MAAM,GAAG,IAAI,SAAS,MAAM;;wBA1EhD,MAAM,GAAG,IAAI;;;;;;IAyGtC,oFAAoF;;kBAvEjE,KAAK;;;;;;CAgF3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/react/layoutEngine/useLayoutEditor.js

@@ -0,0 +1,98 @@
+import { useRef, useState } from 'react';
+import { addInTree, containerOf, createUndoHistory, findInTree, historyCanRedo, historyCanUndo, historyPresent, historyPush, historyRedo, historyReset, historyUndo, moveInTree, moveToIndexInTree, removeInTree, reorderInContainer, updateInTree, } from '../../core/layout';
+const emptyView = () => ({ enabled: false, nodes: [] });
+export const useLayoutEditor = (initialViews, opts = {}) => {
+    const tabs = Object.keys(initialViews);
+    const [tab, setTab] = useState(opts.initialTab ?? tabs[0] ?? 'card');
+    const [selectedId, setSelectedIdState] = useState(null);
+    // A narrowed setter (not the raw Dispatch) so the hook's inferred return type is
+    // portable across a consumer that has its own @types/react.
+    const setSelectedId = (id) => setSelectedIdState(id);
+    const baseline = { ...initialViews };
+    // The snapshot the editor was opened/reset with — `dirty` compares against it.
+    const initialRef = useRef(baseline);
+    const [hist, setHist] = useState(() => createUndoHistory(baseline, { limit: opts.historyLimit ?? 50 }));
+    const views = historyPresent(hist);
+    const view = views[tab] ?? emptyView();
+    const dirty = views !== initialRef.current;
+    const canUndo = historyCanUndo(hist);
+    const canRedo = historyCanRedo(hist);
+    // Push a new snapshot; consecutive commits with the same `tag` coalesce.
+    const commit = (producer, tag = null) => setHist((h) => historyPush(h, producer(historyPresent(h)), tag));
+    const setActiveNodes = (fn, tag = null) => commit((cur) => ({
+        ...cur,
+        [tab]: { ...(cur[tab] ?? emptyView()), nodes: fn((cur[tab] ?? emptyView()).nodes) },
+    }), tag);
+    const undo = () => setHist(historyUndo);
+    const redo = () => setHist(historyRedo);
+    // Discard all history + selection and restart from `next` (the new dirty baseline).
+    // The SAME object becomes both the history's present snapshot and the dirty
+    // baseline, so `dirty` (a reference compare) reads false straight after a reset.
+    const reset = (next) => {
+        const fresh = { ...next };
+        initialRef.current = fresh;
+        setHist((h) => historyReset(h, fresh));
+        setSelectedId(null);
+    };
+    const selectTab = (next) => {
+        setTab(next);
+        setSelectedId(null);
+    };
+    const setEnabled = (enabled) => commit((cur) => ({ ...cur, [tab]: { ...(cur[tab] ?? emptyView()), enabled } }), `enabled:${tab}`);
+    // Replace one or more views at once (applying a suggested or saved design).
+    const applyViews = (next) => {
+        commit((cur) => ({ ...cur, ...next }));
+        setSelectedId(null);
+    };
+    const addNode = (node, containerId = null) => {
+        setActiveNodes((ns) => addInTree(ns, node, containerId));
+        setSelectedId(node.id);
+    };
+    const removeNode = (id) => {
+        setActiveNodes((ns) => removeInTree(ns, id));
+        setSelectedIdState((s) => (s === id ? null : s));
+    };
+    const updateNode = (id, patch) => setActiveNodes((ns) => updateInTree(ns, id, patch), `update:${id}`);
+    const reorder = (ids, containerId = null) => setActiveNodes((ns) => reorderInContainer(ns, ids, containerId));
+    // Move a node between the top level and a section (appended).
+    const moveNode = (id, toContainerId) => setActiveNodes((ns) => moveInTree(ns, id, toContainerId));
+    // Move a node to a container AND a precise index — what the drag canvas commits.
+    const moveNodeTo = (id, toContainerId, index) => setActiveNodes((ns) => moveToIndexInTree(ns, id, toContainerId, index));
+    const selectedNode = findInTree(view.nodes, selectedId ?? '');
+    const selectedContainer = containerOf(view.nodes, selectedId);
+    // Sections available as move targets / the "add into" container.
+    const sections = view.nodes.filter((n) => n.type === 'section');
+    // Adds go where you're working: the selected section, or the section holding the
+    // selected node, else top level.
+    const activeContainerId = selectedNode?.type === 'section' ? selectedNode.id : selectedContainer;
+    return {
+        tab,
+        tabs,
+        selectTab,
+        view,
+        setEnabled,
+        applyViews,
+        addNode,
+        removeNode,
+        updateNode,
+        reorder,
+        moveNode,
+        moveNodeTo,
+        selectedId,
+        setSelectedId,
+        selectedNode,
+        selectedContainer,
+        sections,
+        activeContainerId,
+        dirty,
+        /** Alias of `dirty` — true once the views differ from the opened/reset baseline. */
+        isDirty: dirty,
+        reset,
+        undo,
+        redo,
+        canUndo,
+        canRedo,
+        payload: views,
+    };
+};
+//# sourceMappingURL=useLayoutEditor.js.map

package/dist/react/layoutEngine/useLayoutEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLayoutEditor.js","sourceRoot":"","sources":["../../../src/react/layoutEngine/useLayoutEditor.ts"],"names":[],"mappings":"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"}

package/dist/react/lib/cn.d.ts

@@ -0,0 +1,4 @@
+import { type ClassValue } from 'clsx';
+/** Merge Tailwind class names, resolving conflicts (last wins). */
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=cn.d.ts.map

package/dist/react/lib/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../../src/react/lib/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C,mEAAmE;AACnE,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAElD"}

package/dist/react/lib/cn.js

@@ -0,0 +1,7 @@
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+/** Merge Tailwind class names, resolving conflicts (last wins). */
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+//# sourceMappingURL=cn.js.map

package/dist/react/lib/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../../src/react/lib/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,IAAI,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,mEAAmE;AACnE,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/react/lib/draftPersistence.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Best-effort localStorage draft persistence for the {@link Wizard} (and any long
+ * form that wants save/resume). Every helper is keyed by a caller-chosen `key` and
+ * namespaced under `wizard-draft-` so drafts never collide with other app storage.
+ *
+ * All three swallow their own failures: `localStorage` can throw (Safari private mode,
+ * a full quota, a disabled storage origin) and a draft is a convenience, never a
+ * correctness requirement — a form that can't persist its draft must still work.
+ *
+ * Key uniqueness is the CALLER's job: a draft key must be unique per record *type* AND
+ * per record *id* (e.g. `event-${eventId ?? 'new'}`) so a brand-new record's draft
+ * doesn't overwrite an in-progress edit of an existing one.
+ */
+export declare function persistDraft(key: string, values: unknown): void;
+/** Load a previously persisted draft, or `undefined` if none exists / is unreadable. */
+export declare function loadDraft<T>(key: string): Partial<T> | undefined;
+/** Remove a persisted draft (called after a successful submit). */
+export declare function clearDraft(key: string): void;
+//# sourceMappingURL=draftPersistence.d.ts.map

package/dist/react/lib/draftPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draftPersistence.d.ts","sourceRoot":"","sources":["../../../src/react/lib/draftPersistence.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAM/D;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAahE;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAM5C"}

package/dist/react/lib/draftPersistence.js

@@ -0,0 +1,50 @@
+const DRAFT_PREFIX = 'wizard-draft-';
+/**
+ * Best-effort localStorage draft persistence for the {@link Wizard} (and any long
+ * form that wants save/resume). Every helper is keyed by a caller-chosen `key` and
+ * namespaced under `wizard-draft-` so drafts never collide with other app storage.
+ *
+ * All three swallow their own failures: `localStorage` can throw (Safari private mode,
+ * a full quota, a disabled storage origin) and a draft is a convenience, never a
+ * correctness requirement — a form that can't persist its draft must still work.
+ *
+ * Key uniqueness is the CALLER's job: a draft key must be unique per record *type* AND
+ * per record *id* (e.g. `event-${eventId ?? 'new'}`) so a brand-new record's draft
+ * doesn't overwrite an in-progress edit of an existing one.
+ */
+export function persistDraft(key, values) {
+    try {
+        localStorage.setItem(`${DRAFT_PREFIX}${key}`, JSON.stringify(values));
+    }
+    catch {
+        /* storage unavailable / quota exceeded — a draft is best-effort, never required. */
+    }
+}
+/** Load a previously persisted draft, or `undefined` if none exists / is unreadable. */
+export function loadDraft(key) {
+    let raw;
+    try {
+        raw = localStorage.getItem(`${DRAFT_PREFIX}${key}`);
+    }
+    catch {
+        return undefined;
+    }
+    if (!raw)
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Remove a persisted draft (called after a successful submit). */
+export function clearDraft(key) {
+    try {
+        localStorage.removeItem(`${DRAFT_PREFIX}${key}`);
+    }
+    catch {
+        /* nothing to clean up if storage is unavailable. */
+    }
+}
+//# sourceMappingURL=draftPersistence.js.map

package/dist/react/lib/draftPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draftPersistence.js","sourceRoot":"","sources":["../../../src/react/lib/draftPersistence.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,eAAe,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,MAAe;IACvD,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,GAAG,GAAG,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,oFAAoF;IACtF,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAI,GAAW;IACtC,IAAI,GAAkB,CAAC;IACvB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,GAAG,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,GAAG,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;AACH,CAAC"}

package/dist/react/lib/field.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The single field-control class — driven ENTIRELY by the `--field-*` token layer
+ * (see theme.css), so restyling every form control app-wide is a one-block change.
+ * `text-base sm:text-sm` keeps the control text at 16px on mobile (preventing iOS
+ * auto-zoom-on-focus) and 14px from `sm:` up where touch-zoom never triggers. The
+ * `aria-[invalid=true]:*` rules paint the error state Field sets via `aria-invalid`.
+ * One source of truth for every input/select/textarea — replaces the divergent
+ * per-app FIELD_CLASS copies.
+ */
+export declare const FIELD_CLASS = "w-full rounded-field border border-field-border bg-field-bg px-3 py-2 text-base text-field-fg placeholder:text-field-placeholder sm:text-sm focus-visible:border-field-ring focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-field-ring/30 aria-[invalid=true]:border-field-error aria-[invalid=true]:ring-field-error/30 disabled:cursor-not-allowed disabled:opacity-50";
+/** Field class without the `w-full` (so a control can size to its own content). */
+export declare const FIELD_CLASS_AUTO: string;
+//# sourceMappingURL=field.d.ts.map

package/dist/react/lib/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../src/react/lib/field.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,gYACuW,CAAC;AAEhY,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,QAAqC,CAAC"}

package/dist/react/lib/field.js

@@ -0,0 +1,13 @@
+/**
+ * The single field-control class — driven ENTIRELY by the `--field-*` token layer
+ * (see theme.css), so restyling every form control app-wide is a one-block change.
+ * `text-base sm:text-sm` keeps the control text at 16px on mobile (preventing iOS
+ * auto-zoom-on-focus) and 14px from `sm:` up where touch-zoom never triggers. The
+ * `aria-[invalid=true]:*` rules paint the error state Field sets via `aria-invalid`.
+ * One source of truth for every input/select/textarea — replaces the divergent
+ * per-app FIELD_CLASS copies.
+ */
+export const FIELD_CLASS = 'w-full rounded-field border border-field-border bg-field-bg px-3 py-2 text-base text-field-fg placeholder:text-field-placeholder sm:text-sm focus-visible:border-field-ring focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-field-ring/30 aria-[invalid=true]:border-field-error aria-[invalid=true]:ring-field-error/30 disabled:cursor-not-allowed disabled:opacity-50';
+/** Field class without the `w-full` (so a control can size to its own content). */
+export const FIELD_CLASS_AUTO = FIELD_CLASS.replace('w-full ', '');
+//# sourceMappingURL=field.js.map

package/dist/react/lib/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../../src/react/lib/field.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GACtB,6XAA6X,CAAC;AAEhY,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC"}

package/dist/react/lib/floatingStyles.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared CSS class strings for floating surfaces (Tooltip, Popover, DropdownMenu,
+ * Select, HoverCard). All use the overlay elevation token from the design-token
+ * system so every floating panel reads as the same elevation in light + dark, and
+ * the open/close motion is consistent across the whole floating layer.
+ *
+ * These strings are JIT-scanned by Tailwind (this file lives under the `@source "."`
+ * glob in `src/styles.css`), so the utilities they name are generated into the
+ * consuming app's stylesheet. The `animate-in` / `slide-in-from-*` utilities come
+ * from `tw-animate-css`, which `src/styles.css` imports.
+ */
+/** Base surface for any floating panel: overlay elevation, popover tokens, ring-free. */
+export declare const FLOATING_CONTENT_BASE = "z-50 rounded-md border border-border bg-popover text-popover-foreground shadow-[var(--shadow-overlay)] outline-none";
+/** Base row for a selectable/actionable item inside a floating panel. */
+export declare const FLOATING_ITEM_BASE: string;
+/** Standard open/close + side-aware slide animation for Radix content panels. */
+export declare const FLOATING_ANIMATION: string;
+//# sourceMappingURL=floatingStyles.d.ts.map

package/dist/react/lib/floatingStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floatingStyles.d.ts","sourceRoot":"","sources":["../../../src/react/lib/floatingStyles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yFAAyF;AACzF,eAAO,MAAM,qBAAqB,wHACqF,CAAC;AAExH,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,QAGS,CAAC;AAEzC,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,QAKkD,CAAC"}

package/dist/react/lib/floatingStyles.js

@@ -0,0 +1,24 @@
+/**
+ * Shared CSS class strings for floating surfaces (Tooltip, Popover, DropdownMenu,
+ * Select, HoverCard). All use the overlay elevation token from the design-token
+ * system so every floating panel reads as the same elevation in light + dark, and
+ * the open/close motion is consistent across the whole floating layer.
+ *
+ * These strings are JIT-scanned by Tailwind (this file lives under the `@source "."`
+ * glob in `src/styles.css`), so the utilities they name are generated into the
+ * consuming app's stylesheet. The `animate-in` / `slide-in-from-*` utilities come
+ * from `tw-animate-css`, which `src/styles.css` imports.
+ */
+/** Base surface for any floating panel: overlay elevation, popover tokens, ring-free. */
+export const FLOATING_CONTENT_BASE = 'z-50 rounded-md border border-border bg-popover text-popover-foreground shadow-[var(--shadow-overlay)] outline-none';
+/** Base row for a selectable/actionable item inside a floating panel. */
+export const FLOATING_ITEM_BASE = 'relative flex cursor-default select-none items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none ' +
+    'data-[disabled]:pointer-events-none data-[disabled]:opacity-50 ' +
+    'focus:bg-accent/10 focus:text-accent';
+/** Standard open/close + side-aware slide animation for Radix content panels. */
+export const FLOATING_ANIMATION = 'data-[state=open]:animate-in data-[state=closed]:animate-out ' +
+    'data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 ' +
+    'data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 ' +
+    'data-[side=bottom]:slide-in-from-top-2 data-[side=top]:slide-in-from-bottom-2 ' +
+    'data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2';
+//# sourceMappingURL=floatingStyles.js.map

package/dist/react/lib/floatingStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"floatingStyles.js","sourceRoot":"","sources":["../../../src/react/lib/floatingStyles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yFAAyF;AACzF,MAAM,CAAC,MAAM,qBAAqB,GAChC,qHAAqH,CAAC;AAExH,yEAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAC7B,0GAA0G;IAC1G,iEAAiE;IACjE,sCAAsC,CAAC;AAEzC,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAC7B,+DAA+D;IAC/D,6DAA6D;IAC7D,+DAA+D;IAC/D,gFAAgF;IAChF,+EAA+E,CAAC"}

package/dist/react/lib/form.d.ts

@@ -0,0 +1,25 @@
+import type { FieldValues, UseFormProps } from 'react-hook-form';
+import type { z } from 'zod';
+/**
+ * The canonical react-hook-form config for every cursedbelt form (Wizard,
+ * RecordPanel, modal forms). One zod schema drives validation; the validation mode
+ * is the project standard **on-blur-then-live-clear**:
+ *
+ * - `mode: 'onBlur'` — a field validates only when the user leaves it, so an empty
+ *   required field doesn't scream the instant the form mounts.
+ * - `reValidateMode: 'onChange'` — once a field IS errored, it re-validates on every
+ *   keystroke, so a valid value clears the error immediately (no second blur needed).
+ *
+ * On a failed submit RHF marks every invalid field and focuses the first one
+ * (`shouldFocusError` defaults to true), so the inline {@link Field} error appears
+ * and the first bad input scrolls into view with no extra wiring.
+ *
+ * The form's value type comes from `defaults` (infer it from your schema with
+ * `z.infer<typeof schema>`); spread the result straight into `useForm`:
+ * ```ts
+ * type Values = z.infer<typeof schema>;
+ * const form = useForm<Values>(makeFormConfig(schema, { name: '', tags: [] }));
+ * ```
+ */
+export declare function makeFormConfig<TFieldValues extends FieldValues>(schema: z.ZodType, defaults: TFieldValues): UseFormProps<TFieldValues>;
+//# sourceMappingURL=form.d.ts.map

package/dist/react/lib/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../../src/react/lib/form.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,YAAY,SAAS,WAAW,EAC7D,MAAM,EAAE,CAAC,CAAC,OAAO,EACjB,QAAQ,EAAE,YAAY,GACrB,YAAY,CAAC,YAAY,CAAC,CAY5B"}