@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/forms/TableInclusionChecklist.js

@@ -0,0 +1,119 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `table-inclusion-checklist` (annex §10) — scrollable toggleable table list:
+ * custom checkbox, mono name, human row counts, PII warning badges,
+ * suggested-dashboard tag chips, and an included/total header count.
+ * Evidence: Adminium Console, Auth & Onboarding, Connect Database.
+ *
+ * TWO EXPORTS, ONE IMPLEMENTATION (same split as `ConnectionStringField`):
+ *   · `TableInclusionChecklist` — the presentational list. The Studio connect
+ *     wizard (`apps/dashboard/src/studio/connect/steps/TablesStep.tsx`) renders
+ *     THIS component and keeps only what is wizard-specific around it (its
+ *     search box, its per-source row-count degradation, its explanatory notes).
+ *   · `TableInclusionChecklistWidget` — the registry binding over it.
+ * The inclusion RULES both sides obey live in the pure `forms-tables.ts`.
+ */
+import { Badge, Checkbox, EmptyState, MonoText, Tag, cn } from '@adminium/ui';
+import { ShieldAlert } from 'lucide-react';
+import { useState } from 'react';
+import { tableInclusionChecklistConfigSchema, tableInclusionChecklistDemoData } from './forms-config.js';
+import { booleanField, formatRows, numberField, recordRowsOf, stringField } from './forms-lib.js';
+import { bindingTargetOf } from './forms-state.js';
+import { defaultIncludedIds, inclusionCounts, isHighVolume } from './forms-tables.js';
+export { tableInclusionChecklistConfigSchema, tableInclusionChecklistDemoData };
+/**
+ * Project the §3 `record-list` payload onto includable tables (annex §10:
+ * "introspected tables {name, rowCount, pii?, tag?, included}").
+ *
+ * `pii` is read as a COUNT or a flag: an introspector that reports
+ * `pii: true` and one that reports `pii: 3` are both saying the table has PII,
+ * and a widget that understood only one of them would drop the badge — the one
+ * signal on this screen that exists to make someone stop and think.
+ */
+export function inclusionTablesOf(data, config) {
+    const rows = recordRowsOf(data);
+    const out = [];
+    for (const row of rows) {
+        const id = stringField(row, config.nameField);
+        if (id === undefined)
+            continue;
+        const rowEstimate = numberField(row, config.rowCountField) ?? null;
+        const piiCount = numberField(row, config.piiField);
+        const piiFlag = booleanField(row, config.piiField);
+        out.push({
+            id,
+            rowEstimate,
+            piiColumns: piiCount ?? (piiFlag === true ? 1 : 0),
+            highVolume: isHighVolume(rowEstimate),
+            preHidden: booleanField(row, config.hiddenField) === true,
+            tag: stringField(row, config.tagField),
+        });
+    }
+    return out;
+}
+/** The initial selection: an explicit `included` column wins over the default rule. */
+export function initialInclusion(data, config, tables) {
+    const rows = recordRowsOf(data);
+    const explicit = [];
+    let sawColumn = false;
+    for (const row of rows) {
+        if (!(config.includedField in row))
+            continue;
+        sawColumn = true;
+        const id = stringField(row, config.nameField);
+        if (id !== undefined && booleanField(row, config.includedField) === true)
+            explicit.push(id);
+    }
+    // No `included` column at all ⇒ nobody has chosen yet ⇒ apply the >100k rule.
+    // An `included` column that happens to be all-false is a real choice, and must
+    // NOT be overwritten by the default (05; M5-T02).
+    return new Set(sawColumn ? explicit : defaultIncludedIds(tables));
+}
+export function TableInclusionChecklist({ tables, selected, onToggle, renderRowMeta, piiDetection = true, maxHeight, countTemplate, piiLabel = 'PII', highVolumeLabel = 'high volume', a11yLabel, emptyContent, locale, className, 'data-testid': testId, }) {
+    // Join/system tables are never listed (annex §10). Filtering HERE, not at the
+    // call site, keeps the rule with the data: a caller that forgot would silently
+    // offer to build dashboards on a join table.
+    const visible = tables.filter((table) => !table.preHidden);
+    const counts = inclusionCounts(tables, selected);
+    return (_jsxs("div", { className: cn('flex min-h-0 flex-col gap-2', className), "data-widget": "table-inclusion-checklist", "data-testid": testId, children: [countTemplate !== undefined && (_jsxs("div", { className: "flex items-center justify-between gap-3", children: [_jsx("span", { className: "text-caption font-bold uppercase tracking-wide text-fg-subtle", children: a11yLabel }), _jsx(MonoText, { "data-part": "inclusion-count", className: "text-body-sm text-fg-muted", children: countTemplate.replace('{included}', String(counts.included)).replace('{total}', String(counts.total)) })] })), _jsxs("ul", { "aria-label": a11yLabel, "data-part": "table-list", className: cn('m-0 flex list-none flex-col divide-y divide-border overflow-auto rounded-lg border border-border bg-surface p-0', maxHeight === undefined ? 'min-h-0 flex-1' : 'max-h-[var(--adm-max-h)]'), ...(maxHeight === undefined ? {} : { style: { '--adm-max-h': `${maxHeight}px` } }), children: [visible.map((table) => {
+                        const checked = selected.has(table.id);
+                        return (_jsxs("li", { "data-part": "table-row", "data-table": table.id, "data-included": checked, className: "flex items-center gap-3 px-3.5 py-2.5", children: [_jsx(Checkbox, { checked: checked, onCheckedChange: (next) => onToggle(table.id, next === true), "aria-label": table.id }), _jsx(MonoText, { className: "min-w-0 flex-1 truncate text-body-sm text-fg", children: table.id }), piiDetection && table.piiColumns > 0 && (_jsxs(Badge, { tone: "warn", "data-part": "pii-badge", children: [_jsx(ShieldAlert, { "aria-hidden": "true", className: "size-3" }), `${piiLabel} · ${table.piiColumns}`] })), table.tag !== undefined && _jsx(Tag, { "data-part": "table-tag", children: table.tag }), table.highVolume && _jsx(Badge, { tone: "neutral", "data-part": "high-volume-badge", children: highVolumeLabel }), renderRowMeta !== undefined ? (renderRowMeta(table)) : (_jsx(MonoText, { "data-part": "row-count", className: "w-24 shrink-0 text-end text-body-sm text-fg-muted", children: formatRows(table.rowEstimate ?? undefined, locale) ?? '—' }))] }, table.id));
+                    }), visible.length === 0 && emptyContent !== undefined && (_jsx("li", { className: "px-3.5 py-6 text-center text-body-sm text-fg-muted", children: emptyContent }))] })] }));
+}
+/**
+ * The registry binding (annex §10). Binds the §3 `record-list` shape — an empty
+ * table list is genuinely empty, so the frame's empty state is the right answer
+ * and this widget does not fake one.
+ *
+ * WRITE MODEL: one `update` intent per toggle carrying the WHOLE inclusion set,
+ * not a delta. The stored value is a set (`settings.includedTables`), so sending
+ * the set is sending the new value; a delta would make the host reconstruct
+ * state it does not own.
+ */
+export function TableInclusionChecklistWidget({ config, data, onEvent }) {
+    const tables = inclusionTablesOf(data, config);
+    const [selected, setSelected] = useState(() => initialInclusion(data, config, tables));
+    const target = bindingTargetOf(config.binding);
+    if (tables.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: config.emptyTitle ?? 'No tables found', body: config.emptyBody ?? 'Connect a database and its tables will appear here.' }));
+    }
+    const toggle = (id, checked) => {
+        const next = new Set(selected);
+        if (checked)
+            next.add(id);
+        else
+            next.delete(id);
+        setSelected(next);
+        if (target === null)
+            return;
+        onEvent({
+            type: 'mutate',
+            intent: 'update',
+            connectionId: target.connectionId,
+            table: target.table,
+            values: { includedTables: [...next].sort() },
+        });
+    };
+    return (_jsx("div", { className: "flex h-full min-h-0 flex-col px-4 pb-4", children: _jsx(TableInclusionChecklist, { tables: tables, selected: selected, onToggle: toggle, piiDetection: config.piiDetection, maxHeight: config.maxHeight, countTemplate: "{included}/{total}", piiLabel: config.piiLabel ?? 'PII', highVolumeLabel: config.highVolumeLabel ?? 'high volume', a11yLabel: config.a11yLabel ?? config.title ?? 'Tables to include', locale: config.format?.locale, "data-testid": config.testId }) }));
+}
+//# sourceMappingURL=TableInclusionChecklist.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * `toggle-switch-list` (annex §10) — a card of rows: label + description
+ * (+ optional tone-tinted icon tile) + a switch bound to a `boolean-map`;
+ * instant-persist or dirty-tracking. Evidence: Settings, Profile Settings,
+ * Workspace Settings, Notification Settings, Survey Builder, Integrations.
+ *
+ * Binds the §3 `boolean-map` shape (annex §10: "boolean-map keyed by setting id
+ * + row metadata") — the VALUES come from the payload, the row LABELS from
+ * config, joined on the setting id.
+ *
+ * WRITE MODEL (04 §2.1): `optimistic` emits an `update` intent per toggle and
+ * rolls the switch back if the host rejects it; `save-bar` batches into one
+ * intent behind an explicit Save. Either way the widget never persists.
+ */
+import { DEFAULT_TOGGLE_ROWS, toggleSwitchListConfigSchema, toggleSwitchListDemoData } from './forms-config.js';
+import type { ToggleSwitchListConfig } from './forms-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { toggleSwitchListConfigSchema, toggleSwitchListDemoData, DEFAULT_TOGGLE_ROWS };
+export type { ToggleSwitchListConfig };
+export declare function ToggleSwitchListWidget({ config, data, instanceId, onEvent }: WidgetProps<ToggleSwitchListConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ToggleSwitchList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleSwitchList.d.ts","sourceRoot":"","sources":["../../../src/families/forms/ToggleSwitchList.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAChH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,CAAC;AACvF,YAAY,EAAE,sBAAsB,EAAE,CAAC;AAEvC,wBAAgB,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,sBAAsB,CAAC,+BAyGhH"}

package/dist/families/forms/ToggleSwitchList.js

@@ -0,0 +1,78 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `toggle-switch-list` (annex §10) — a card of rows: label + description
+ * (+ optional tone-tinted icon tile) + a switch bound to a `boolean-map`;
+ * instant-persist or dirty-tracking. Evidence: Settings, Profile Settings,
+ * Workspace Settings, Notification Settings, Survey Builder, Integrations.
+ *
+ * Binds the §3 `boolean-map` shape (annex §10: "boolean-map keyed by setting id
+ * + row metadata") — the VALUES come from the payload, the row LABELS from
+ * config, joined on the setting id.
+ *
+ * WRITE MODEL (04 §2.1): `optimistic` emits an `update` intent per toggle and
+ * rolls the switch back if the host rejects it; `save-bar` batches into one
+ * intent behind an explicit Save. Either way the widget never persists.
+ */
+import { Button, EmptyState, IconTile, Switch, cn } from '@adminium/ui';
+import { useState } from 'react';
+import { formIcon } from './forms-icons.js';
+import { booleanEntriesOf, uiToneOf } from './forms-lib.js';
+import { bindingTargetOf } from './forms-state.js';
+import { DEFAULT_TOGGLE_ROWS, toggleSwitchListConfigSchema, toggleSwitchListDemoData } from './forms-config.js';
+export { toggleSwitchListConfigSchema, toggleSwitchListDemoData, DEFAULT_TOGGLE_ROWS };
+export function ToggleSwitchListWidget({ config, data, instanceId, onEvent }) {
+    const bound = booleanEntriesOf(data);
+    const rows = config.rows ?? DEFAULT_TOGGLE_ROWS;
+    const [entries, setEntries] = useState(bound);
+    /**
+     * The last state the SERVER acknowledged. Rollback targets this rather than
+     * "the value before this toggle": in `save-bar` mode a rejected save must undo
+     * the whole batch, and using the pre-toggle value would only undo the last one.
+     */
+    const [saved, setSaved] = useState(bound);
+    const [dirty, setDirty] = useState(false);
+    const target = bindingTargetOf(config.binding);
+    if (rows.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: config.emptyTitle ?? 'No settings', body: config.emptyBody ?? 'Settings appear here once they are configured.' }));
+    }
+    const commit = async (next) => {
+        // Unbound (demo/story/palette): keep the local state, emit nothing.
+        if (target === null) {
+            setSaved(next);
+            setDirty(false);
+            return;
+        }
+        try {
+            await onEvent({
+                type: 'mutate',
+                intent: 'update',
+                connectionId: target.connectionId,
+                table: target.table,
+                values: next,
+            });
+            setSaved(next);
+            setDirty(false);
+        }
+        catch {
+            // The host rejected the write — roll back to the last acknowledged state
+            // so the UI never claims a setting is on when the server says otherwise.
+            setEntries(saved);
+            setDirty(false);
+        }
+    };
+    const toggle = (key, checked) => {
+        const next = { ...entries, [key]: checked };
+        setEntries(next);
+        if (config.persistMode === 'optimistic')
+            void commit(next);
+        else
+            setDirty(true);
+    };
+    return (_jsxs("div", { "data-widget": "toggle-switch-list", "data-persist-mode": config.persistMode, "data-testid": config.testId, className: "flex h-full flex-col gap-2 overflow-auto px-4 pb-4", children: [_jsx("ul", { className: "m-0 flex list-none flex-col gap-0.5 p-0", children: rows.map((row) => {
+                    const id = `${instanceId}-${row.key}`;
+                    const checked = entries[row.key] === true;
+                    const icon = config.iconTiles ? formIcon(row.icon) : undefined;
+                    return (_jsxs("li", { "data-part": "toggle-row", "data-key": row.key, className: "flex items-start gap-3 rounded-lg px-2.5 py-3 hover:bg-surface-2", children: [icon !== undefined && _jsx(IconTile, { size: "md", tone: uiToneOf(row.tone, 'accent'), icon: icon }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("label", { htmlFor: id, className: "block cursor-pointer text-body-sm font-bold text-fg", children: row.label ?? row.key }), row.description !== undefined && (_jsx("p", { className: cn('text-caption text-fg-muted'), children: row.description }))] }), _jsx(Switch, { id: id, checked: checked, onCheckedChange: (next) => toggle(row.key, next), className: "mt-0.5 shrink-0" })] }, row.key));
+                }) }), config.persistMode === 'save-bar' && dirty && (_jsxs("div", { "data-part": "save-bar", className: "flex items-center justify-between gap-3 rounded-lg bg-surface-2 px-3 py-2", children: [_jsx("span", { className: "text-caption text-fg-muted", children: config.dirtyLabel ?? 'You have unsaved changes' }), _jsx(Button, { size: "sm", "data-part": "save-button", onClick: () => void commit(entries), children: config.saveLabel ?? 'Save' })] }))] }));
+}
+//# sourceMappingURL=ToggleSwitchList.js.map

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

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

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

@@ -0,0 +1,35 @@
+/**
+ * `validation-issues-list` (annex §10) — severity-toned issue rows: an icon
+ * tile, the title, the resolution description, and an outcome count pill.
+ * Evidence: Import Wizard (the annex's import page always composes
+ * `upload-dropzone` + `column-mapping-table` + this + `progress-bar`).
+ *
+ * Composed from @adminium/ui's `IconTile` + `Badge`. Rows are ordered by
+ * SEVERITY, not by payload order — the reason is in `sortIssues` below.
+ */
+import type { IssueSeverity } from './forms-lib.js';
+import { validationIssuesListConfigSchema, validationIssuesListDemoData } from './forms-config.js';
+import type { ValidationIssuesListConfig } from './forms-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { validationIssuesListConfigSchema, validationIssuesListDemoData };
+export type { ValidationIssuesListConfig };
+export interface ValidationIssue {
+    key: string;
+    severity: IssueSeverity;
+    title: string;
+    desc?: string | undefined;
+    count?: number | undefined;
+}
+/** Project the §3 `record-list` payload onto issues. */
+export declare function issuesOf(data: unknown, config: ValidationIssuesListConfig): ValidationIssue[];
+/**
+ * Order errors → warnings → info, stably within each severity.
+ *
+ * The list is a triage surface: an import blocked by 12 invalid emails must not
+ * be reported below "Dates normalised to ISO" merely because the server happened
+ * to emit the notice first. Ties keep payload order, so the result stays
+ * deterministic for the same payload (04 §7.7).
+ */
+export declare function sortIssues(issues: readonly ValidationIssue[]): ValidationIssue[];
+export declare function ValidationIssuesListWidget({ config, data }: WidgetProps<ValidationIssuesListConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ValidationIssuesList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationIssuesList.d.ts","sourceRoot":"","sources":["../../../src/families/forms/ValidationIssuesList.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAoB,gCAAgC,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACrH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,gCAAgC,EAAE,4BAA4B,EAAE,CAAC;AAC1E,YAAY,EAAE,0BAA0B,EAAE,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,0BAA0B,GAAG,eAAe,EAAE,CAiB7F;AAID;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,eAAe,EAAE,CAEhF;AAOD,wBAAgB,0BAA0B,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,0BAA0B,CAAC,+BA+CnG"}

package/dist/families/forms/ValidationIssuesList.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `validation-issues-list` (annex §10) — severity-toned issue rows: an icon
+ * tile, the title, the resolution description, and an outcome count pill.
+ * Evidence: Import Wizard (the annex's import page always composes
+ * `upload-dropzone` + `column-mapping-table` + this + `progress-bar`).
+ *
+ * Composed from @adminium/ui's `IconTile` + `Badge`. Rows are ordered by
+ * SEVERITY, not by payload order — the reason is in `sortIssues` below.
+ */
+import { Badge, EmptyState, IconTile } from '@adminium/ui';
+import { severityIcon } from './forms-icons.js';
+import { DEFAULT_SEVERITY_TONE, formatCount, numberField, oneOf, recordRowsOf, stringField } from './forms-lib.js';
+import { ISSUE_SEVERITIES, validationIssuesListConfigSchema, validationIssuesListDemoData } from './forms-config.js';
+export { validationIssuesListConfigSchema, validationIssuesListDemoData };
+/** Project the §3 `record-list` payload onto issues. */
+export function issuesOf(data, config) {
+    const rows = recordRowsOf(data);
+    const out = [];
+    for (const [index, row] of rows.entries()) {
+        const title = stringField(row, config.titleField);
+        if (title === undefined)
+            continue;
+        out.push({
+            key: `${title}-${index}`,
+            // An unrecognised severity degrades to `info` rather than dropping the
+            // row: an unclassifiable issue is still an issue the user must see.
+            severity: oneOf(row[config.severityField], ISSUE_SEVERITIES, 'info'),
+            title,
+            desc: stringField(row, config.descField),
+            count: numberField(row, config.countField),
+        });
+    }
+    return sortIssues(out);
+}
+const SEVERITY_RANK = { error: 0, warn: 1, info: 2 };
+/**
+ * Order errors → warnings → info, stably within each severity.
+ *
+ * The list is a triage surface: an import blocked by 12 invalid emails must not
+ * be reported below "Dates normalised to ISO" merely because the server happened
+ * to emit the notice first. Ties keep payload order, so the result stays
+ * deterministic for the same payload (04 §7.7).
+ */
+export function sortIssues(issues) {
+    return [...issues].sort((a, b) => SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity]);
+}
+/** Config `severityMap` overrides the default severity→tone map (annex §10). */
+function toneOf(severity, map) {
+    return map?.[severity] ?? DEFAULT_SEVERITY_TONE[severity];
+}
+export function ValidationIssuesListWidget({ config, data }) {
+    const issues = issuesOf(data, config);
+    const locale = config.format?.locale;
+    if (issues.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "all-caught-up", title: config.emptyTitle ?? 'No issues found', body: config.emptyBody ?? 'Everything checks out — you are good to import.' }));
+    }
+    return (_jsx("ul", { "data-widget": "validation-issues-list", "data-testid": config.testId, className: "m-0 flex h-full list-none flex-col gap-0.5 overflow-auto p-2", children: issues.map((issue) => {
+            const tone = toneOf(issue.severity, config.severityMap);
+            const count = formatCount(issue.count, locale);
+            return (_jsxs("li", { "data-part": "issue-row", "data-severity": issue.severity, "data-tone": tone, className: "flex items-start gap-3 rounded-lg px-2.5 py-2.5 hover:bg-surface-2", children: [_jsx(IconTile, { size: "md", tone: tone, icon: severityIcon(issue.severity) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "truncate text-body-sm font-bold text-fg", children: issue.title }), issue.desc !== undefined && _jsx("p", { className: "text-caption text-fg-muted", children: issue.desc })] }), count !== undefined && (_jsx(Badge, { "data-part": "issue-count", tone: tone, className: "shrink-0", children: count }))] }, issue.key));
+        }) }));
+}
+//# sourceMappingURL=ValidationIssuesList.js.map

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

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

package/dist/families/forms/forms-builders.d.ts

@@ -0,0 +1,106 @@
+/**
+ * The closed vocabularies + pure logic behind the §10 BUILDER widgets —
+ * `rule-builder`, `flow-builder`, `question-builder`, `column-mapping-table` and
+ * `export-builder`. PURE module (React-free, JSX-free, copy-free), so
+ * `forms-config.ts` can reach it without dragging component code into the eager
+ * registry chunk (04 §2.3).
+ *
+ * WHY EVERY VOCABULARY HERE IS CLOSED: each of these widgets stores its output
+ * in a page manifest and the rule-builder's output is compiled to a SQL WHERE
+ * clause. A manifest that could name an arbitrary operator, node kind or
+ * question type would be naming a renderer — or a predicate — that does not
+ * exist. Config picks FROM these lists; it never extends them.
+ */
+/** The column types the field catalog classifies against (annex `operatorsByType`). */
+export declare const RULE_FIELD_TYPES: readonly ["string", "number", "boolean", "date", "enum"];
+export type RuleFieldType = (typeof RULE_FIELD_TYPES)[number];
+/** Every operator a condition may name — compiled to SQL WHERE by the host. */
+export declare const RULE_OPERATORS: readonly ["eq", "neq", "gt", "gte", "lt", "lte", "contains", "not-contains", "starts-with", "in", "before", "after", "is-null", "is-not-null"];
+export type RuleOperator = (typeof RULE_OPERATORS)[number];
+/** ALL/ANY — the pill dividers between condition chips (annex §10). */
+export declare const RULE_MATCH_MODES: readonly ["all", "any"];
+export type RuleMatchMode = (typeof RULE_MATCH_MODES)[number];
+/**
+ * The operators offered per column type. The annex's `operatorsByType` config
+ * overrides this map; this is what a generated rule-builder starts from.
+ */
+export declare const DEFAULT_OPERATORS_BY_TYPE: Record<RuleFieldType, readonly RuleOperator[]>;
+/**
+ * Whether an operator needs a value input. `is-null`/`is-not-null` are complete
+ * on their own — rendering a value box beside them would invite the user to type
+ * something the compiled WHERE clause then silently ignores.
+ */
+export declare function operatorTakesValue(operator: RuleOperator): boolean;
+/** The operators valid for a field type, honouring a config override. */
+export declare function operatorsForType(type: RuleFieldType, overrides: Record<string, readonly RuleOperator[]> | undefined): readonly RuleOperator[];
+/**
+ * A condition whose operator its field type does not support is REPAIRED to the
+ * type's first operator rather than dropped: a stored segment that survives a
+ * column's type change should keep the user's field and value and lose only the
+ * part that stopped making sense.
+ */
+export declare function repairOperator(operator: RuleOperator, type: RuleFieldType, overrides: Record<string, readonly RuleOperator[]> | undefined): RuleOperator;
+/** Typed workflow nodes — the annex fixes both the kinds and their tones. */
+export declare const FLOW_NODE_KINDS: readonly ["trigger", "condition", "action"];
+export type FlowNodeKind = (typeof FLOW_NODE_KINDS)[number];
+/** annex §10: "trigger=accent, condition=warn, action=pos". */
+export declare const FLOW_NODE_TONE: Record<FlowNodeKind, 'accent' | 'warn' | 'pos'>;
+/**
+ * Where a new node may be inserted. A flow reads top-down from ONE trigger, so a
+ * palette node of kind `trigger` may only replace/lead the flow — appending a
+ * second trigger halfway down would describe a workflow the engine cannot run.
+ */
+export declare function canAppendNode(kind: FlowNodeKind, existing: readonly {
+    kind: FlowNodeKind;
+}[]): boolean;
+/** The 8 addable question types (annex §10: "palette of 8 addable question types"). */
+export declare const QUESTION_KINDS: readonly ["single-choice", "multi-choice", "dropdown", "short-text", "long-text", "rating", "nps", "date"];
+export type QuestionKind = (typeof QUESTION_KINDS)[number];
+/** Which kinds carry an editable option list (the rest preview a fixed stub). */
+export declare function questionTakesOptions(kind: QuestionKind): boolean;
+/** The NPS chip row is 0–10 by definition (annex §10). */
+export declare const NPS_SCORES: readonly number[];
+/** A star rating previews 5 stars (annex §10 "star rating"). */
+export declare const RATING_STARS = 5;
+/**
+ * Move an item within an ordered list, returning a NEW array. Out-of-range
+ * moves are no-ops rather than errors — the first card's "up" button is a
+ * legitimate click, not a bug to throw on.
+ */
+export declare function moveItem<T>(items: readonly T[], from: number, to: number): T[];
+/**
+ * The target that means "Don't import" (annex §10). A reserved sentinel rather
+ * than `undefined`, because "the user explicitly skipped this column" and "the
+ * user has not decided yet" must not collapse into the same stored value.
+ */
+export declare const SKIP_TARGET = "__skip__";
+/** Name similarity, 0…1. Exact/prefix/substring short-circuit the bigram score. */
+export declare function nameSimilarity(a: string, b: string): number;
+/** Below this, a suggestion is a guess the user would have to undo. */
+export declare const AUTO_MATCH_THRESHOLD = 0.6;
+/**
+ * The best target for a source column by name similarity (annex §10 `autoMatch`),
+ * or `null` when nothing clears the threshold — leaving the picker unset, which
+ * is honest, rather than pre-filling a wrong mapping the user must notice to fix.
+ *
+ * Ties keep the FIRST target in catalog order (strict `>`), so the same schema
+ * always auto-matches the same way (04 §7.7).
+ */
+export declare function autoMatchTarget(source: string, targets: readonly {
+    key: string;
+    label?: string | undefined;
+}[]): string | null;
+/** The formats the annex's segmented picker offers. */
+export declare const EXPORT_FORMATS: readonly ["pdf", "csv", "xlsx"];
+export type ExportFormat = (typeof EXPORT_FORMATS)[number];
+/** The annex's `idle → running(%) → done(Download)` machine, plus failure. */
+export declare const EXPORT_PHASES: readonly ["idle", "running", "done", "failed"];
+export type ExportPhase = (typeof EXPORT_PHASES)[number];
+/**
+ * The phase to render. The PAYLOAD wins whenever it has moved off `idle`: the
+ * host owns the export job, so its status is the truth, and a widget that kept
+ * showing its own optimistic `running` after the host reported `failed` would be
+ * lying about a job the user is waiting on.
+ */
+export declare function exportPhaseOf(payloadPhase: ExportPhase, submitted: boolean): ExportPhase;
+//# sourceMappingURL=forms-builders.d.ts.map

package/dist/families/forms/forms-builders.d.ts.map

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