@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/forms/ExportBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportBuilder.js","sourceRoot":"","sources":["../../../src/families/forms/ExportBuilder.tsx"],"names":[],"mappings":"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"}

package/dist/families/forms/FilterChipBar.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `filter-chip-bar` (annex §10) — toggle chips with live mono count pills
+ * computed from the SIBLING list ("All 24 · Running 3 · Completed 21"); a
+ * single-select drives client/server filtering, with optional end-aligned
+ * "N of M" meta. Evidence: ~17 comps (AB Experiments, Payments, Audit Log,
+ * Ticket Queue, Notifications Center, Search Results, …).
+ *
+ * Built on @adminium/ui's `ChoiceChips` in SINGLE mode — not on `FilterChip`,
+ * despite the name: `FilterChip` is the removable `field · op · value` condition
+ * pill from the query builder, whereas this bar is a single-select facet picker,
+ * which is exactly `ChoiceChips`'s radiogroup (roving tabindex, ←→ moves and
+ * selects, RTL-mirrored).
+ *
+ * The counts are DERIVED from the bound `record-list` rather than configured —
+ * that is the whole point of the widget (annex §10: "live mono count pills
+ * computed from the sibling list"): a hard-coded count goes stale the moment a
+ * row changes.
+ */
+import type { FormTone } from './forms-lib.js';
+import { filterChipBarConfigSchema, filterChipBarDemoData } from './forms-config.js';
+import type { FilterChipBarConfig } from './forms-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { filterChipBarConfigSchema, filterChipBarDemoData };
+export type { FilterChipBarConfig };
+/**
+ * The sentinel value of the leading "All" chip. Prefixed so it can never
+ * collide with a real enum value read out of the data.
+ */
+export declare const ALL_KEY = "__all__";
+export interface Facet {
+    key: string;
+    label: string;
+    count: number;
+    tone?: FormTone | undefined;
+}
+/**
+ * Build the ordered facet list from the bound rows.
+ *
+ * Config `order` fixes the leading chips and their labels; facets the payload
+ * has but the order omits render AFTER, in first-seen order — a new enum value
+ * appearing in the data must never become invisible (and therefore
+ * unfilterable) just because the config predates it.
+ */
+export declare function facetsOf(data: unknown, config: FilterChipBarConfig): {
+    facets: Facet[];
+    total: number;
+};
+export declare function FilterChipBarWidget({ config, data, onEvent }: WidgetProps<FilterChipBarConfig>): import("react").JSX.Element;
+//# sourceMappingURL=FilterChipBar.d.ts.map

package/dist/families/forms/FilterChipBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterChipBar.d.ts","sourceRoot":"","sources":["../../../src/families/forms/FilterChipBar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,OAAO,YAAY,CAAC;AAEjC,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,GAAG;IAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAkBvG;AAED,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,mBAAmB,CAAC,+BAuD9F"}

package/dist/families/forms/FilterChipBar.js

@@ -0,0 +1,82 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `filter-chip-bar` (annex §10) — toggle chips with live mono count pills
+ * computed from the SIBLING list ("All 24 · Running 3 · Completed 21"); a
+ * single-select drives client/server filtering, with optional end-aligned
+ * "N of M" meta. Evidence: ~17 comps (AB Experiments, Payments, Audit Log,
+ * Ticket Queue, Notifications Center, Search Results, …).
+ *
+ * Built on @adminium/ui's `ChoiceChips` in SINGLE mode — not on `FilterChip`,
+ * despite the name: `FilterChip` is the removable `field · op · value` condition
+ * pill from the query builder, whereas this bar is a single-select facet picker,
+ * which is exactly `ChoiceChips`'s radiogroup (roving tabindex, ←→ moves and
+ * selects, RTL-mirrored).
+ *
+ * The counts are DERIVED from the bound `record-list` rather than configured —
+ * that is the whole point of the widget (annex §10: "live mono count pills
+ * computed from the sibling list"): a hard-coded count goes stale the moment a
+ * row changes.
+ */
+import { ChoiceChips, MonoText } from '@adminium/ui';
+import { useState } from 'react';
+import { facetCountsOf, formatCount, recordRowsOf } from './forms-lib.js';
+import { filterChipBarConfigSchema, filterChipBarDemoData } from './forms-config.js';
+export { filterChipBarConfigSchema, filterChipBarDemoData };
+/**
+ * The sentinel value of the leading "All" chip. Prefixed so it can never
+ * collide with a real enum value read out of the data.
+ */
+export const ALL_KEY = '__all__';
+/**
+ * Build the ordered facet list from the bound rows.
+ *
+ * Config `order` fixes the leading chips and their labels; facets the payload
+ * has but the order omits render AFTER, in first-seen order — a new enum value
+ * appearing in the data must never become invisible (and therefore
+ * unfilterable) just because the config predates it.
+ */
+export function facetsOf(data, config) {
+    const rows = recordRowsOf(data);
+    const counts = facetCountsOf(rows, config.facetField);
+    const ordered = config.order ?? [];
+    const orderedKeys = new Set(ordered.map((entry) => entry.key));
+    const facets = [];
+    for (const entry of ordered) {
+        // A configured facet with zero rows still renders — its "0" is meaningful
+        // ("Failed 0" is good news), unlike an undiscovered one.
+        facets.push({ key: entry.key, label: entry.label ?? entry.key, count: counts.get(entry.key) ?? 0, tone: entry.tone });
+    }
+    for (const [key, count] of counts) {
+        if (!orderedKeys.has(key))
+            facets.push({ key, label: key, count });
+    }
+    return { facets, total: rows.length };
+}
+export function FilterChipBarWidget({ config, data, onEvent }) {
+    const { facets, total } = facetsOf(data, config);
+    const [selected, setSelected] = useState(config.value ?? null);
+    const locale = config.format?.locale;
+    const shown = selected === null ? total : (facets.find((facet) => facet.key === selected)?.count ?? 0);
+    const meta = (config.metaTemplate ?? '{shown} of {total}')
+        .replace('{shown}', String(shown))
+        .replace('{total}', String(total));
+    const select = (key) => {
+        // `ALL_KEY` is the sentinel for "no facet" — ChoiceChips' single mode can
+        // return null on deselect, which means the same thing.
+        const next = key === ALL_KEY ? null : key;
+        setSelected(next);
+        // Filtering is a HOST concern: the sibling list re-queries. The widget
+        // reports the choice through a drill-through on its own href, which is the
+        // only event channel a read-only control has (04 §2.1).
+        if (config.href === undefined)
+            return;
+        const href = next === null ? config.href : `${config.href}?${config.facetField}=${encodeURIComponent(next)}`;
+        onEvent({ type: 'drill-through', href });
+    };
+    const label = (text, count) => config.showCounts ? (_jsxs(_Fragment, { children: [text, " ", _jsx(MonoText, { className: "text-[10.5px] opacity-70", children: formatCount(count, locale) })] })) : (text);
+    return (_jsxs("div", { "data-widget": "filter-chip-bar", "data-testid": config.testId, className: "flex h-full flex-wrap items-center gap-1.5 px-4 pb-4", children: [_jsx(ChoiceChips, { "data-part": "facet-chips", "aria-label": config.a11yLabel ?? config.title ?? 'Filter', value: selected ?? ALL_KEY, onValueChange: select, options: [
+                    { value: ALL_KEY, label: label(config.allLabel ?? 'All', total) },
+                    ...facets.map((facet) => ({ value: facet.key, label: label(facet.label, facet.count) })),
+                ] }), config.showMeta && (_jsx(MonoText, { "data-part": "facet-meta", className: "ms-auto text-caption text-fg-subtle", children: meta }))] }));
+}
+//# sourceMappingURL=FilterChipBar.js.map

package/dist/families/forms/FilterChipBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterChipBar.js","sourceRoot":"","sources":["../../../src/families/forms/FilterChipBar.tsx"],"names":[],"mappings":"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"}

package/dist/families/forms/FlowBuilder.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `flow-builder` (annex §10) — a vertical workflow canvas of typed nodes
+ * (trigger=accent, condition=warn, action=pos) joined by connectors, with live
+ * insert/remove, an action-palette popover (2-col grid of addable node types)
+ * and header run stats. Evidence: Automation Rules.
+ *
+ * PRESENTATIONAL: nodes live in local state; every change is a `mutate` intent.
+ * The widget never runs a flow and never persists one.
+ *
+ * Binds §3 `form-state` for the same reason as `rule-builder`: an empty canvas
+ * is a builder awaiting its trigger, not an empty widget, and must show the
+ * palette rather than the frame's "no data" state.
+ *
+ * REORDER/INSERT: nodes are added at the END and removed individually — there is
+ * no drag layer here. `@dnd-kit` is CONFINED to the `boards` family by the
+ * chunk-budget gate (04 §2.3), and pulling a drag engine into `forms` would put
+ * it in the chunk of every page that renders a settings toggle.
+ */
+import { flowBuilderConfigSchema, flowBuilderDemoData } from './forms-config.js';
+import type { FlowBuilderConfig } from './forms-config.js';
+import type { FlowNodeKind } from './forms-builders.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { flowBuilderConfigSchema, flowBuilderDemoData };
+export type { FlowBuilderConfig };
+export interface FlowNode {
+    id: string;
+    kind: FlowNodeKind;
+    icon?: string | undefined;
+    title: string;
+    sub?: string | undefined;
+}
+/** Project the §3 `form-state` payload onto ordered flow nodes. */
+export declare function flowNodesOf(data: unknown, config: FlowBuilderConfig): FlowNode[];
+/** Header run stats (annex §10), or `null` when the payload carries none. */
+export declare function flowStatsOf(data: unknown): {
+    runs: number;
+    successRate: number;
+} | null;
+export declare function FlowBuilderWidget({ config, data, onEvent }: WidgetProps<FlowBuilderConfig>): import("react").JSX.Element;
+//# sourceMappingURL=FlowBuilder.d.ts.map

package/dist/families/forms/FlowBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowBuilder.d.ts","sourceRoot":"","sources":["../../../src/families/forms/FlowBuilder.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,EAAwB,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACvG,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,mBAAmB,CAAC;AAE3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAID,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAG,QAAQ,EAAE,CAyBhF;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAMvF;AAED,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,iBAAiB,CAAC,+BA8J1F"}

package/dist/families/forms/FlowBuilder.js

@@ -0,0 +1,128 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `flow-builder` (annex §10) — a vertical workflow canvas of typed nodes
+ * (trigger=accent, condition=warn, action=pos) joined by connectors, with live
+ * insert/remove, an action-palette popover (2-col grid of addable node types)
+ * and header run stats. Evidence: Automation Rules.
+ *
+ * PRESENTATIONAL: nodes live in local state; every change is a `mutate` intent.
+ * The widget never runs a flow and never persists one.
+ *
+ * Binds §3 `form-state` for the same reason as `rule-builder`: an empty canvas
+ * is a builder awaiting its trigger, not an empty widget, and must show the
+ * palette rather than the frame's "no data" state.
+ *
+ * REORDER/INSERT: nodes are added at the END and removed individually — there is
+ * no drag layer here. `@dnd-kit` is CONFINED to the `boards` family by the
+ * chunk-budget gate (04 §2.3), and pulling a drag engine into `forms` would put
+ * it in the chunk of every page that renders a settings toggle.
+ */
+import { IconTile, Popover, PopoverClose, PopoverContent, PopoverTrigger, cn } from '@adminium/ui';
+import { Plus, X } from 'lucide-react';
+import { useState } from 'react';
+import { DEFAULT_FLOW_PALETTE, flowBuilderConfigSchema, flowBuilderDemoData } from './forms-config.js';
+import { FLOW_NODE_KINDS, FLOW_NODE_TONE, canAppendNode } from './forms-builders.js';
+import { formIcon } from './forms-icons.js';
+import { numberField, oneOf, stringField } from './forms-lib.js';
+import { bindingTargetOf, formValuesOf } from './forms-state.js';
+export { flowBuilderConfigSchema, flowBuilderDemoData };
+/** Project the §3 `form-state` payload onto ordered flow nodes. */
+export function flowNodesOf(data, config) {
+    const values = formValuesOf(data);
+    const raw = values['nodes'];
+    if (!Array.isArray(raw))
+        return [];
+    const kinds = config.nodeKinds ?? FLOW_NODE_KINDS;
+    const out = [];
+    for (const [index, entry] of raw.entries()) {
+        if (typeof entry !== 'object' || entry === null || Array.isArray(entry))
+            continue;
+        const row = entry;
+        const title = stringField(row, 'title');
+        if (title === undefined)
+            continue;
+        const kind = oneOf(row['kind'], FLOW_NODE_KINDS, 'action');
+        // A node whose kind this flow disables is dropped: it names a step the host
+        // was configured not to run, so rendering it would show a workflow that
+        // does something the flow cannot actually do.
+        if (!kinds.includes(kind))
+            continue;
+        out.push({
+            id: stringField(row, 'id') ?? `node-${index}`,
+            kind,
+            icon: stringField(row, 'icon'),
+            title,
+            sub: stringField(row, 'sub'),
+        });
+    }
+    return out;
+}
+/** Header run stats (annex §10), or `null` when the payload carries none. */
+export function flowStatsOf(data) {
+    const values = formValuesOf(data);
+    const runs = numberField(values, 'runs');
+    const successRate = numberField(values, 'successRate');
+    if (runs === undefined || successRate === undefined)
+        return null;
+    return { runs, successRate };
+}
+export function FlowBuilderWidget({ config, data, onEvent }) {
+    const [nodes, setNodes] = useState(() => flowNodesOf(data, config));
+    const [paletteOpen, setPaletteOpen] = useState(false);
+    const stats = flowStatsOf(data);
+    const target = bindingTargetOf(config.binding);
+    const enabledKinds = config.nodeKinds ?? FLOW_NODE_KINDS;
+    const palette = (config.palette ?? DEFAULT_FLOW_PALETTE).filter((node) => enabledKinds.includes(node.kind));
+    const commit = (next) => {
+        setNodes(next);
+        if (target === null)
+            return; // unbound (demo/story/palette)
+        onEvent({
+            type: 'mutate',
+            intent: 'update',
+            connectionId: target.connectionId,
+            table: target.table,
+            values: {
+                nodes: next.map((node) => ({
+                    id: node.id,
+                    kind: node.kind,
+                    ...(node.icon === undefined ? {} : { icon: node.icon }),
+                    title: node.title,
+                    ...(node.sub === undefined ? {} : { sub: node.sub }),
+                })),
+            },
+        });
+    };
+    const addNode = (entry) => {
+        if (nodes.length >= config.maxNodes || !canAppendNode(entry.kind, nodes))
+            return;
+        setPaletteOpen(false);
+        commit([
+            ...nodes,
+            {
+                // The palette id is the TYPE, not the instance — two "Send email" steps
+                // in one flow must not collide on a React key or on the stored node id.
+                id: `${entry.id}-${nodes.length}`,
+                kind: entry.kind,
+                icon: entry.icon,
+                title: entry.title ?? entry.id,
+                sub: entry.sub,
+            },
+        ]);
+    };
+    const atCapacity = nodes.length >= config.maxNodes;
+    return (_jsxs("div", { "data-widget": "flow-builder", "data-testid": config.testId, className: "flex h-full flex-col gap-2 overflow-auto px-4 pb-4", children: [stats !== null && (_jsx("p", { "data-part": "flow-stats", className: "text-caption text-fg-muted", children: (config.statsTemplate ?? '{runs} runs · {rate}% success')
+                    .replace('{runs}', String(stats.runs))
+                    .replace('{rate}', String(stats.successRate)) })), nodes.length === 0 && (_jsx("p", { "data-part": "flow-empty", className: "text-body-sm text-fg-muted", children: config.emptyBody ?? 'No steps yet — add a trigger to start this workflow.' })), _jsx("ol", { className: "m-0 flex list-none flex-col p-0", children: nodes.map((node, index) => {
+                    const tone = FLOW_NODE_TONE[node.kind];
+                    return (_jsxs("li", { "data-part": "flow-node", "data-kind": node.kind, "data-node": node.id, children: [index > 0 && (
+                            // The connector is a block-axis rule: `ms-5` keeps it under the
+                            // icon tile in BOTH directions (it mirrors with the row).
+                            _jsx("div", { "aria-hidden": "true", "data-part": "flow-connector", className: "ms-5 h-3 w-px bg-border-strong" })), _jsxs("div", { className: "flex items-start gap-3 rounded-lg border border-border bg-surface-2 px-2.5 py-2.5", children: [_jsx(IconTile, { size: "md", tone: tone, icon: formIcon(node.icon) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "truncate text-body-sm font-bold text-fg", children: node.title }), node.sub !== undefined && _jsx("p", { className: "truncate text-caption text-fg-muted", children: node.sub })] }), _jsx("button", { type: "button", "data-part": "flow-remove", "aria-label": `${config.removeLabel ?? 'Remove step'} — ${node.title}`, onClick: () => commit(nodes.filter((_, i) => i !== index)), className: 'rounded-md p-1 text-fg-subtle transition-colors duration-150 hover:bg-surface-3 hover:text-fg ' +
+                                            'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent', children: _jsx(X, { "aria-hidden": "true", className: "size-4" }) })] })] }, node.id));
+                }) }), nodes.length > 0 && _jsx("div", { "aria-hidden": "true", className: "ms-5 h-3 w-px bg-border-strong" }), _jsxs(Popover, { open: paletteOpen, onOpenChange: setPaletteOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs("button", { type: "button", "data-part": "add-node", disabled: atCapacity || palette.length === 0, className: cn('flex w-fit items-center gap-1.5 rounded-lg border border-dashed border-border-strong px-2.5 py-1.5', 'text-caption font-semibold text-fg-muted transition-colors duration-150', 'hover:border-accent hover:text-accent disabled:pointer-events-none disabled:opacity-40', 'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent'), children: [_jsx(Plus, { "aria-hidden": "true", className: "size-3.5" }), config.addLabel ?? 'Add step'] }) }), _jsxs(PopoverContent, { align: "start", "data-part": "palette", className: "w-[min(24rem,90vw)]", children: [_jsx("p", { className: "mb-2 text-caption font-bold uppercase tracking-wide text-fg-subtle", children: config.paletteTitle ?? 'Add a step' }), _jsx("div", { className: "grid grid-cols-2 gap-1.5", children: palette.map((entry) => {
+                                    const blocked = !canAppendNode(entry.kind, nodes);
+                                    return (_jsx(PopoverClose, { asChild: true, children: _jsxs("button", { type: "button", "data-part": "palette-node", "data-kind": entry.kind, "data-node": entry.id, disabled: blocked, onClick: () => addNode(entry), className: cn('flex items-start gap-2 rounded-md border border-border p-2 text-start transition-colors duration-150', 'hover:border-accent hover:bg-accent-soft disabled:pointer-events-none disabled:opacity-40', 'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent'), children: [_jsx(IconTile, { size: "sm", tone: FLOW_NODE_TONE[entry.kind], icon: formIcon(entry.icon) }), _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-caption font-bold text-fg", children: entry.title ?? entry.id }), entry.sub !== undefined && (_jsx("span", { className: "block truncate text-caption text-fg-muted", children: entry.sub }))] })] }) }, entry.id));
+                                }) })] })] })] }));
+}
+//# sourceMappingURL=FlowBuilder.js.map

package/dist/families/forms/FlowBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowBuilder.js","sourceRoot":"","sources":["../../../src/families/forms/FlowBuilder.tsx"],"names":[],"mappings":"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"}

package/dist/families/forms/FormFields.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The generated-field renderer shared by `modal-wizard` and `drawer-form`
+ * (annex §10 auto-instantiation: "column type → control (text/varchar→input,
+ * text long→textarea, enum→segmented-control or select, bool→switch,
+ * timestamp→date picker, numeric→number input with unit, email/url/phone via
+ * name+check heuristics)").
+ *
+ * Both form widgets render the SAME field set — only their chrome differs (a
+ * modal vs a drawer) — so the control mapping lives here once. A second copy
+ * would be a second place for the kind→control mapping to drift.
+ *
+ * ACCESSIBILITY: `FormField` injects `id` / `aria-describedby` / `aria-invalid` /
+ * `aria-required` into its SINGLE child through a Radix `Slot`, so each control
+ * is passed bare — wrapping one in a `<div>` would hand the div the id and
+ * silently unlink the label from the input.
+ */
+import type { FormFieldConfig } from './forms-config.js';
+export interface FormFieldsProps {
+    fields: readonly FormFieldConfig[];
+    values: Record<string, unknown>;
+    onChange: (name: string, value: unknown) => void;
+    /** Field names that failed the required check on submit. */
+    invalid?: readonly string[] | undefined;
+    requiredHint?: string | undefined;
+    idPrefix: string;
+}
+export declare function FormFields({ fields, values, onChange, invalid, requiredHint, idPrefix }: FormFieldsProps): import("react").JSX.Element;
+//# sourceMappingURL=FormFields.d.ts.map

package/dist/families/forms/FormFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFields.d.ts","sourceRoot":"","sources":["../../../src/families/forms/FormFields.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,4DAA4D;IAC5D,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AA4DD,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,eAAe,+BA6BxG"}

package/dist/families/forms/FormFields.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The generated-field renderer shared by `modal-wizard` and `drawer-form`
+ * (annex §10 auto-instantiation: "column type → control (text/varchar→input,
+ * text long→textarea, enum→segmented-control or select, bool→switch,
+ * timestamp→date picker, numeric→number input with unit, email/url/phone via
+ * name+check heuristics)").
+ *
+ * Both form widgets render the SAME field set — only their chrome differs (a
+ * modal vs a drawer) — so the control mapping lives here once. A second copy
+ * would be a second place for the kind→control mapping to drift.
+ *
+ * ACCESSIBILITY: `FormField` injects `id` / `aria-describedby` / `aria-invalid` /
+ * `aria-required` into its SINGLE child through a Radix `Slot`, so each control
+ * is passed bare — wrapping one in a `<div>` would hand the div the id and
+ * silently unlink the label from the input.
+ */
+import { DateInput, FormField, Input, Select, Switch, Tag, Textarea } from '@adminium/ui';
+function stringValue(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return '';
+}
+/** The control for one generated field (annex §10's column-type → control map). */
+function control(field, value, onChange) {
+    switch (field.kind) {
+        case 'textarea':
+            return (_jsx(Textarea, { rows: 3, value: stringValue(value), placeholder: field.placeholder ?? '', onChange: (event) => onChange(event.target.value) }));
+        case 'switch':
+            return _jsx(Switch, { checked: value === true, onCheckedChange: (checked) => onChange(checked) });
+        case 'select':
+            return (_jsx(Select, { value: stringValue(value), onChange: (event) => onChange(event.target.value), children: (field.options ?? []).map((option) => (_jsx("option", { value: option.value, children: option.label ?? option.value }, option.value))) }));
+        case 'date':
+            return _jsx(DateInput, { value: stringValue(value), onChange: (event) => onChange(event.target.value) });
+        case 'number':
+            return (_jsx(Input, { type: "number", mono: true, value: stringValue(value), placeholder: field.placeholder ?? '', 
+                // The RAW string stays in state: coercing per keystroke makes "1." and
+                // a lone "-" impossible to type. The host coerces on commit.
+                onChange: (event) => onChange(event.target.value) }));
+        default:
+            return (_jsx(Input
+            // email/url get the real input types: mobile keyboards and the
+            // browser's own validation both key off them.
+            , { 
+                // email/url get the real input types: mobile keyboards and the
+                // browser's own validation both key off them.
+                type: field.kind === 'email' ? 'email' : field.kind === 'url' ? 'url' : 'text', value: stringValue(value), placeholder: field.placeholder ?? '', onChange: (event) => onChange(event.target.value) }));
+    }
+}
+export function FormFields({ fields, values, onChange, invalid, requiredHint, idPrefix }) {
+    const invalidSet = new Set(invalid ?? []);
+    return (_jsx("div", { "data-part": "form-fields", className: "flex flex-col gap-3.5", children: fields.map((field) => {
+            const id = `${idPrefix}-${field.name}`;
+            const isInvalid = invalidSet.has(field.name);
+            return (_jsx(FormField, { controlId: id, "data-part": "form-field", "data-field": field.name, label: field.label ?? field.name, required: field.required, ...(isInvalid ? { error: requiredHint ?? 'This field is required.' } : {}), ...(!isInvalid && field.helpText !== undefined ? { helper: field.helpText } : {}), ...(field.unit === undefined ? {} : { tag: _jsx(Tag, { mono: true, children: field.unit }) }), children: control(field, values[field.name], (next) => onChange(field.name, next)) }, field.name));
+        }) }));
+}
+//# sourceMappingURL=FormFields.js.map

package/dist/families/forms/FormFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFields.js","sourceRoot":"","sources":["../../../src/families/forms/FormFields.tsx"],"names":[],"mappings":"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"}

package/dist/families/forms/InlineEditableField.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `inline-editable-field` (annex §10) — a text/number/select span rendered as a
+ * transparent input inside documents and canvases: click (or Enter/Space) to
+ * edit, Enter/blur to commit, Escape to cancel.
+ * Evidence: Invoice Builder, Email Templates, Report Builder, See It In Action.
+ *
+ * Binds §3 `record` — "a bound field path on a doc object" is one row plus a
+ * column name, which is exactly that shape.
+ *
+ * COMMIT, NOT DEBOUNCE. The annex describes "debounced dirty tracking", and this
+ * widget deliberately commits on an explicit action instead. A debounce timer
+ * would emit `mutate` intents the user never confirmed — each one an audited,
+ * undoable write — for text they were still in the middle of typing, and would
+ * make the widget's own tests depend on wall-clock time (04 §7.7 wants neither).
+ * Escape restoring the original value is only meaningful if nothing was written
+ * on the way there.
+ */
+import { inlineEditableFieldConfigSchema, inlineEditableFieldDemoData } from './forms-config.js';
+import type { InlineEditableFieldConfig } from './forms-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { inlineEditableFieldConfigSchema, inlineEditableFieldDemoData };
+export type { InlineEditableFieldConfig };
+/** The bound field's current value as display text (`''` when absent). */
+export declare function boundValueOf(data: unknown, config: InlineEditableFieldConfig): string;
+/** The record id a `mutate` intent targets, or `null` when the row has none. */
+export declare function boundRecordIdOf(data: unknown, config: InlineEditableFieldConfig): string | null;
+export declare function InlineEditableFieldWidget({ config, data, instanceId, onEvent }: WidgetProps<InlineEditableFieldConfig>): import("react").JSX.Element;
+//# sourceMappingURL=InlineEditableField.d.ts.map

package/dist/families/forms/InlineEditableField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineEditableField.d.ts","sourceRoot":"","sources":["../../../src/families/forms/InlineEditableField.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,CAAC;AACxE,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAE1C,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAIrF;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,yBAAyB,GAAG,MAAM,GAAG,IAAI,CAI/F;AAQD,wBAAgB,yBAAyB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,yBAAyB,CAAC,+BA6ItH"}

package/dist/families/forms/InlineEditableField.js

@@ -0,0 +1,130 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `inline-editable-field` (annex §10) — a text/number/select span rendered as a
+ * transparent input inside documents and canvases: click (or Enter/Space) to
+ * edit, Enter/blur to commit, Escape to cancel.
+ * Evidence: Invoice Builder, Email Templates, Report Builder, See It In Action.
+ *
+ * Binds §3 `record` — "a bound field path on a doc object" is one row plus a
+ * column name, which is exactly that shape.
+ *
+ * COMMIT, NOT DEBOUNCE. The annex describes "debounced dirty tracking", and this
+ * widget deliberately commits on an explicit action instead. A debounce timer
+ * would emit `mutate` intents the user never confirmed — each one an audited,
+ * undoable write — for text they were still in the middle of typing, and would
+ * make the widget's own tests depend on wall-clock time (04 §7.7 wants neither).
+ * Escape restoring the original value is only meaningful if nothing was written
+ * on the way there.
+ */
+import { Input, Select, Textarea, cn } from '@adminium/ui';
+import { useState } from 'react';
+import { inlineEditableFieldConfigSchema, inlineEditableFieldDemoData } from './forms-config.js';
+import { recordRowOf, stringField } from './forms-lib.js';
+import { bindingTargetOf } from './forms-state.js';
+export { inlineEditableFieldConfigSchema, inlineEditableFieldDemoData };
+/** The bound field's current value as display text (`''` when absent). */
+export function boundValueOf(data, config) {
+    const row = recordRowOf(data);
+    if (row === null)
+        return '';
+    return stringField(row, config.field) ?? '';
+}
+/** The record id a `mutate` intent targets, or `null` when the row has none. */
+export function boundRecordIdOf(data, config) {
+    const row = recordRowOf(data);
+    if (row === null)
+        return null;
+    return stringField(row, config.idField) ?? null;
+}
+/** The display label for a `select` value — its option label, else the raw value. */
+function displayValue(value, config) {
+    if (config.format !== 'select')
+        return value;
+    return config.options?.find((option) => option.value === value)?.label ?? value;
+}
+export function InlineEditableFieldWidget({ config, data, instanceId, onEvent }) {
+    const bound = boundValueOf(data, config);
+    /** The last COMMITTED value — what Escape restores and what dirty compares to. */
+    const [committed, setCommitted] = useState(bound);
+    const [draft, setDraft] = useState(bound);
+    const [editing, setEditing] = useState(false);
+    /*
+      RESYNC ON A NEW BOUND VALUE. `useState(bound)` seeds the initial render and
+      is ignored by React on every render after it, so without this the field
+      displays whatever the row said when it first mounted — forever. Two real
+      breaks: a master-detail page reuses ONE instance across row selections, so
+      the display would show the previous record's text while `boundRecordIdOf`
+      already resolves the new id (an edit then writes the new record with the old
+      record's value); and a refetch (`refreshInterval`, or another user's edit)
+      would never surface.
+  
+      A render-phase reset rather than an effect: React's own "adjusting state when
+      props change" pattern — it re-renders before committing to the DOM, so the
+      stale value is never painted (an effect would flash it first).
+    */
+    const [lastBound, setLastBound] = useState(bound);
+    if (bound !== lastBound) {
+        setLastBound(bound);
+        setCommitted(bound);
+        setDraft(bound);
+        // The incoming value is authoritative; keeping an open editor over a record
+        // that just changed underneath would commit the draft to the WRONG row.
+        setEditing(false);
+    }
+    const target = bindingTargetOf(config.binding);
+    const recordId = boundRecordIdOf(data, config);
+    const controlId = `${instanceId}-inline-field`;
+    const commit = () => {
+        setEditing(false);
+        // Nothing changed — no intent. An unchanged commit would still cost the host
+        // an audit entry and an undo slot for a write that changes nothing.
+        if (draft === committed)
+            return;
+        setCommitted(draft);
+        if (target === null)
+            return; // unbound (demo/story/palette)
+        onEvent({
+            type: 'mutate',
+            intent: 'update',
+            connectionId: target.connectionId,
+            table: target.table,
+            ...(recordId === null ? {} : { recordId }),
+            values: { [config.field]: draft },
+        });
+    };
+    const cancel = () => {
+        setDraft(committed);
+        setEditing(false);
+    };
+    const onKeyDown = (event) => {
+        if (event.key === 'Escape') {
+            event.preventDefault();
+            cancel();
+            return;
+        }
+        // Enter commits — except in a textarea, where it is a newline the user meant.
+        if (event.key === 'Enter' && !(config.format === 'text' && config.multiline)) {
+            event.preventDefault();
+            commit();
+        }
+    };
+    if (!editing) {
+        const text = displayValue(committed, config);
+        const empty = text.trim() === '';
+        return (_jsx("div", { className: "flex h-full items-center px-4 pb-4", "data-widget": "inline-editable-field", "data-testid": config.testId, children: _jsx("button", { type: "button", "data-part": "inline-display", "data-empty": empty, "aria-label": config.editLabel ?? config.label ?? config.title ?? 'Edit', onClick: () => setEditing(true), className: cn('w-full truncate rounded-md px-1.5 py-0.5 text-start text-body-sm transition-colors duration-150', 'hover:bg-surface-2 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent', empty ? 'text-fg-subtle italic' : 'text-fg'), children: empty ? (config.emptyValueLabel ?? 'Empty') : text }) }));
+    }
+    const shared = {
+        id: controlId,
+        autoFocus: true,
+        'aria-label': config.label ?? config.title ?? 'Value',
+        'data-part': 'inline-input',
+        onBlur: commit,
+        onKeyDown,
+    };
+    return (_jsx("div", { className: "flex h-full items-center px-4 pb-4", "data-widget": "inline-editable-field", "data-editing": true, "data-testid": config.testId, children: config.format === 'select' ? (_jsxs(Select, { ...shared, value: draft, onChange: (event) => setDraft(event.currentTarget.value), children: [_jsx("option", { value: "" }), (config.options ?? []).map((option) => (_jsx("option", { value: option.value, children: option.label ?? option.value }, option.value)))] })) : config.format === 'text' && config.multiline ? (_jsx(Textarea, { ...shared, autoResize: true, value: draft, placeholder: config.placeholder ?? '', onChange: (event) => setDraft(event.currentTarget.value) })) : (_jsx(Input, { ...shared, ...(config.format === 'number' ? { mono: true, inputMode: 'decimal' } : {}), value: draft, placeholder: config.placeholder ?? '', 
+            // The RAW string stays in state even for `number` — coercing per
+            // keystroke makes "1." and a lone "-" impossible to type. The host
+            // coerces on commit (same note as `FormFields`).
+            onChange: (event) => setDraft(event.currentTarget.value) })) }));
+}
+//# sourceMappingURL=InlineEditableField.js.map