@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/feeds/feeds-types.js

@@ -0,0 +1,12 @@
+/**
+ * Data-contract shapes for the `feeds` family (annex §4). Types only — erased
+ * at compile time, so both the pure `feeds-config` module (which the registry's
+ * eager metadata graph reaches) and the widget components can name them without
+ * either one importing the other. That keeps `feeds-config` free of component
+ * code (04 §2.3, acceptance #3) AND keeps the module graph acyclic, which
+ * `pnpm check-deps` enforces with `tsPreCompilationDeps`.
+ *
+ * The component files re-export these, so existing import points stay stable.
+ */
+export {};
+//# sourceMappingURL=feeds-types.js.map

package/dist/families/feeds/feeds-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeds-types.js","sourceRoot":"","sources":["../../../src/families/feeds/feeds-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/families/feeds/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `feeds` family public surface (annex §4) — standalone feed/list components
+ * plus the Track-F registry metadata. Component code is also reachable through
+ * each definition's `lazy()` ref, so the registry still emits one chunk per
+ * family (04 §2.3); this barrel is for direct template/story composition and
+ * tests. Registry metadata lives in `feeds-track-f.definitions.ts`.
+ */
+export { ActivityFeed, ActivityFeedWidget, activityFeedConfigSchema, activityFeedDemoData, type ActivityFeedConfig, type ActivityFeedProps, type ActivityItem, } from './ActivityFeed.js';
+export { NotificationFeed, NotificationFeedWidget, bucketOf, notificationFeedConfigSchema, notificationFeedDemoData, type NotificationAction, type NotificationFeedConfig, type NotificationFeedProps, type NotificationItem, } from './NotificationFeed.js';
+export { RealtimeFeed, RealtimeFeedWidget, pulseBuckets, realtimeFeedConfigSchema, realtimeFeedDemoData, type RealtimeFeedConfig, type RealtimeFeedProps, type StreamEvent, } from './RealtimeFeed.js';
+export { TimelineVertical, TimelineVerticalWidget, timelineVerticalConfigSchema, timelineVerticalDemoData, type TimelineEntry, type TimelineVerticalConfig, type TimelineVerticalProps, } from './TimelineVertical.js';
+export { UnreadBadge, UnreadBadgeWidget, formatCount, unreadBadgeConfigSchema, unreadBadgeDemoData, type UnreadBadgeConfig, type UnreadBadgeProps, } from './UnreadBadge.js';
+export { LoadOlderPaginator, LoadOlderPaginatorWidget, cursorStateOf, loadOlderPaginatorConfigSchema, loadOlderPaginatorDemoData, type LoadOlderPaginatorConfig, type LoadOlderPaginatorProps, } from './LoadOlderPaginator.js';
+export { MAX_VISIBLE_TOASTS, TOAST_ACTION_DURATION, ToastStackWidget, toastStackConfigSchema, toastStackDemoData, toastVariantOf, toastsOf, useToastQueue, type ToastEntry, type ToastStackConfig, } from './ToastStack.js';
+export { activityFeedDefinition, feedsTrackFDefinitions, loadOlderPaginatorDefinition, notificationFeedDefinition, realtimeFeedDefinition, timelineVerticalDefinition, toastStackDefinition, unreadBadgeDefinition, } from './feeds-track-f.definitions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/families/feeds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/families/feeds/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,QAAQ,EACR,4BAA4B,EAC5B,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,wBAAwB,EACxB,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,8BAA8B,EAC9B,0BAA0B,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,aAAa,EACb,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gCAAgC,CAAC"}

package/dist/families/feeds/index.js

@@ -0,0 +1,16 @@
+/**
+ * `feeds` family public surface (annex §4) — standalone feed/list components
+ * plus the Track-F registry metadata. Component code is also reachable through
+ * each definition's `lazy()` ref, so the registry still emits one chunk per
+ * family (04 §2.3); this barrel is for direct template/story composition and
+ * tests. Registry metadata lives in `feeds-track-f.definitions.ts`.
+ */
+export { ActivityFeed, ActivityFeedWidget, activityFeedConfigSchema, activityFeedDemoData, } from './ActivityFeed.js';
+export { NotificationFeed, NotificationFeedWidget, bucketOf, notificationFeedConfigSchema, notificationFeedDemoData, } from './NotificationFeed.js';
+export { RealtimeFeed, RealtimeFeedWidget, pulseBuckets, realtimeFeedConfigSchema, realtimeFeedDemoData, } from './RealtimeFeed.js';
+export { TimelineVertical, TimelineVerticalWidget, timelineVerticalConfigSchema, timelineVerticalDemoData, } from './TimelineVertical.js';
+export { UnreadBadge, UnreadBadgeWidget, formatCount, unreadBadgeConfigSchema, unreadBadgeDemoData, } from './UnreadBadge.js';
+export { LoadOlderPaginator, LoadOlderPaginatorWidget, cursorStateOf, loadOlderPaginatorConfigSchema, loadOlderPaginatorDemoData, } from './LoadOlderPaginator.js';
+export { MAX_VISIBLE_TOASTS, TOAST_ACTION_DURATION, ToastStackWidget, toastStackConfigSchema, toastStackDemoData, toastVariantOf, toastsOf, useToastQueue, } from './ToastStack.js';
+export { activityFeedDefinition, feedsTrackFDefinitions, loadOlderPaginatorDefinition, notificationFeedDefinition, realtimeFeedDefinition, timelineVerticalDefinition, toastStackDefinition, unreadBadgeDefinition, } from './feeds-track-f.definitions.js';
+//# sourceMappingURL=index.js.map

package/dist/families/feeds/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/families/feeds/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,GAIrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,QAAQ,EACR,4BAA4B,EAC5B,wBAAwB,GAKzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,wBAAwB,EACxB,oBAAoB,GAIrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,GAIzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,uBAAuB,EACvB,mBAAmB,GAGpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,8BAA8B,EAC9B,0BAA0B,GAG3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,aAAa,GAGd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gCAAgC,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * `column-mapping-table` (annex §10) — a 3-column grid mapping source columns →
+ * target fields, with sample values and a target picker per row (including
+ * "Don't import"). Evidence: Import Wizard — the page the annex says always
+ * composes `upload-dropzone` + this + `validation-issues-list` + `progress-bar`.
+ *
+ * PRESENTATIONAL: the mapping lives in local state and every change is a
+ * `mutate` intent (04 §2.1). The widget never imports a row.
+ *
+ * Binds §3 `record-list`: the ROWS are the source columns, so a payload with no
+ * columns really is an empty widget (unlike the builders, which start empty by
+ * design) and the frame's empty state is the right answer.
+ */
+import { columnMappingTableConfigSchema, columnMappingTableDemoData } from './forms-config.js';
+import type { ColumnMappingTableConfig } from './forms-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { columnMappingTableConfigSchema, columnMappingTableDemoData };
+export type { ColumnMappingTableConfig };
+export interface MappingRow {
+    key: string;
+    column: string;
+    sample?: string | undefined;
+    /** `''` = undecided, `SKIP_TARGET` = explicitly not imported. */
+    target: string;
+}
+/**
+ * Project the §3 `record-list` payload onto mapping rows, applying `autoMatch`
+ * to columns the payload leaves unmapped.
+ *
+ * An EXPLICIT target in the payload always wins over a suggestion — including
+ * `SKIP_TARGET`. That is the whole reason skip is a sentinel rather than an
+ * empty string: "the user said don't import this" must survive a re-render that
+ * auto-match would otherwise helpfully undo.
+ */
+export declare function mappingRowsOf(data: unknown, config: ColumnMappingTableConfig): MappingRow[];
+export declare function ColumnMappingTableWidget({ config, data, onEvent }: WidgetProps<ColumnMappingTableConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ColumnMappingTable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnMappingTable.d.ts","sourceRoot":"","sources":["../../../src/families/forms/ColumnMappingTable.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAA2B,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACxH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAIlE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,CAAC;AACtE,YAAY,EAAE,wBAAwB,EAAE,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,wBAAwB,GAAG,UAAU,EAAE,CAiB3F;AAED,wBAAgB,wBAAwB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,wBAAwB,CAAC,+BAmFxG"}

package/dist/families/forms/ColumnMappingTable.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `column-mapping-table` (annex §10) — a 3-column grid mapping source columns →
+ * target fields, with sample values and a target picker per row (including
+ * "Don't import"). Evidence: Import Wizard — the page the annex says always
+ * composes `upload-dropzone` + this + `validation-issues-list` + `progress-bar`.
+ *
+ * PRESENTATIONAL: the mapping lives in local state and every change is a
+ * `mutate` intent (04 §2.1). The widget never imports a row.
+ *
+ * Binds §3 `record-list`: the ROWS are the source columns, so a payload with no
+ * columns really is an empty widget (unlike the builders, which start empty by
+ * design) and the frame's empty state is the right answer.
+ */
+import { MonoText, Select, cn } from '@adminium/ui';
+import { useState } from 'react';
+import { DEFAULT_MAPPING_TARGETS, columnMappingTableConfigSchema, columnMappingTableDemoData } from './forms-config.js';
+import { SKIP_TARGET, autoMatchTarget } from './forms-builders.js';
+import { recordRowsOf, stringField } from './forms-lib.js';
+import { bindingTargetOf } from './forms-state.js';
+export { columnMappingTableConfigSchema, columnMappingTableDemoData };
+/**
+ * Project the §3 `record-list` payload onto mapping rows, applying `autoMatch`
+ * to columns the payload leaves unmapped.
+ *
+ * An EXPLICIT target in the payload always wins over a suggestion — including
+ * `SKIP_TARGET`. That is the whole reason skip is a sentinel rather than an
+ * empty string: "the user said don't import this" must survive a re-render that
+ * auto-match would otherwise helpfully undo.
+ */
+export function mappingRowsOf(data, config) {
+    const rows = recordRowsOf(data);
+    const targets = config.targets ?? DEFAULT_MAPPING_TARGETS;
+    const out = [];
+    for (const [index, row] of rows.entries()) {
+        const column = stringField(row, config.columnField);
+        if (column === undefined)
+            continue;
+        const explicit = stringField(row, config.targetField);
+        const suggested = config.autoMatch ? autoMatchTarget(column, targets) : null;
+        out.push({
+            key: `${column}-${index}`,
+            column,
+            sample: stringField(row, config.sampleField),
+            target: explicit ?? suggested ?? '',
+        });
+    }
+    return out;
+}
+export function ColumnMappingTableWidget({ config, data, onEvent }) {
+    const targets = config.targets ?? DEFAULT_MAPPING_TARGETS;
+    const [rows, setRows] = useState(() => mappingRowsOf(data, config));
+    const target = bindingTargetOf(config.binding);
+    const setTarget = (index, next) => {
+        const updated = rows.map((row, i) => (i === index ? { ...row, target: next } : row));
+        setRows(updated);
+        if (target === null)
+            return; // unbound (demo/story/palette)
+        const mapping = {};
+        for (const row of updated) {
+            // Undecided columns are omitted, not sent as `''`: the host's importer
+            // must be able to tell "skip this" from "nobody has said yet".
+            if (row.target !== '')
+                mapping[row.column] = row.target;
+        }
+        onEvent({
+            type: 'mutate',
+            intent: 'update',
+            connectionId: target.connectionId,
+            table: target.table,
+            values: { mapping },
+        });
+    };
+    return (_jsx("div", { "data-widget": "column-mapping-table", "data-testid": config.testId, className: "flex h-full flex-col overflow-auto px-4 pb-4", children: _jsxs("div", { role: "table", className: "min-w-full", children: [_jsxs("div", { role: "row", className: "grid grid-cols-[minmax(6rem,1fr)_minmax(6rem,1fr)_minmax(8rem,1fr)] gap-2 border-b border-border pb-1.5", children: [_jsx("span", { role: "columnheader", className: "text-caption font-bold uppercase tracking-wide text-fg-subtle", children: config.sourceHeader ?? 'Source column' }), _jsx("span", { role: "columnheader", className: "text-caption font-bold uppercase tracking-wide text-fg-subtle", children: config.sampleHeader ?? 'Sample' }), _jsx("span", { role: "columnheader", className: "text-caption font-bold uppercase tracking-wide text-fg-subtle", children: config.targetHeader ?? 'Target field' })] }), rows.map((row, index) => (_jsxs("div", { role: "row", "data-part": "mapping-row", "data-column": row.column, "data-target": row.target === '' ? undefined : row.target, className: "grid grid-cols-[minmax(6rem,1fr)_minmax(6rem,1fr)_minmax(8rem,1fr)] items-center gap-2 border-b border-border/50 py-1.5", children: [_jsx(MonoText, { role: "cell", className: "min-w-0 truncate text-body-sm text-fg", children: row.column }), _jsx(MonoText, { role: "cell", "data-part": "mapping-sample", className: "min-w-0 truncate text-caption text-fg-muted", children: row.sample ?? '—' }), _jsx("span", { role: "cell", className: "min-w-0", children: _jsxs(Select, { "aria-label": `${config.targetHeader ?? 'Target field'} — ${row.column}`, "data-part": "mapping-target", value: row.target, onChange: (event) => setTarget(index, event.currentTarget.value), className: cn(row.target === SKIP_TARGET && 'text-fg-subtle'), children: [_jsx("option", { value: "" }), targets.map((entry) => (_jsx("option", { value: entry.key, children: entry.label ?? entry.key }, entry.key))), _jsx("option", { value: SKIP_TARGET, children: config.skipLabel ?? "Don't import" })] }) })] }, row.key)))] }) }));
+}
+//# sourceMappingURL=ColumnMappingTable.js.map

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

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

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

@@ -0,0 +1,74 @@
+/**
+ * `connection-string-field` (annex §10) — mono DSN input with a database icon, a
+ * keyboard-shortcut badge, host parsing, provider quick-fill chips and an inline
+ * success/status line ("14 tables detected").
+ * Evidence: Adminium Console, Onboarding, See It In Action.
+ *
+ * TWO EXPORTS, ONE IMPLEMENTATION:
+ *   · `ConnectionStringField` — the presentational field. The Studio connect
+ *     wizard (`apps/dashboard/src/studio/connect/steps/SourceStep.tsx`) renders
+ *     THIS component; it used to carry its own copy of the field, and the DSN
+ *     grammar behind both now lives in the pure `forms-dsn.ts` (see that
+ *     module's header for why the wizard became the consumer).
+ *   · `ConnectionStringFieldWidget` — the registry binding over it.
+ *
+ * Composed from @adminium/ui's `InputGroup`, which already owns the leading-icon
+ * + `Kbd` chrome and moves the focus ring to the wrapper.
+ */
+import type { ReactNode } from 'react';
+import { connectionStringFieldConfigSchema, connectionStringFieldDemoData } from './forms-config.js';
+import type { ConnectionStringFieldConfig } from './forms-config.js';
+import type { DsnEngine, DsnProviderChip, DsnValidationCode } from './forms-dsn.js';
+import type { FormTone } from './forms-lib.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { connectionStringFieldConfigSchema, connectionStringFieldDemoData };
+export type { ConnectionStringFieldConfig };
+export interface ConnectionStringFieldProps {
+    value: string;
+    onValueChange: (dsn: string) => void;
+    /**
+     * Fired when the user finishes editing (Enter or blur), NOT on every
+     * keystroke — see the widget below for why a DSN is committed and not streamed.
+     */
+    onCommit?: ((dsn: string) => void) | undefined;
+    /** Annex §10 `protocols` — the engines the host can actually connect to. */
+    protocols?: readonly DsnEngine[] | undefined;
+    /** Whose example DSN to show until the value itself determines the engine. */
+    placeholderEngine?: DsnEngine | undefined;
+    label: ReactNode;
+    required?: boolean | undefined;
+    /** Shown only while there is no error — an error replaces the hint. */
+    helper?: ReactNode | undefined;
+    /** Translated copy per validation code. Widgets never translate (04 §2). */
+    errorText?: Partial<Record<DsnValidationCode, string>> | undefined;
+    /** Inline success/status line under the field (annex §10 `statusLine`). */
+    statusLine?: ReactNode | undefined;
+    statusTone?: FormTone | undefined;
+    /** Keyboard-shortcut badge rendered inside the field chrome (annex §10). */
+    shortcut?: string | undefined;
+    showQuickFill?: boolean | undefined;
+    quickFillLabel?: string | undefined;
+    /**
+     * What a quick-fill chip does. Defaults to filling the DSN; the wizard
+     * overrides it to move its engine picker in the same patch, so the chip cannot
+     * leave the picker pointing at a different engine than the DSN it just wrote.
+     */
+    onQuickFill?: ((chip: DsnProviderChip) => void) | undefined;
+    /** Copy for the parsed-host tag; `{host}` is substituted. */
+    hostLabel?: string | undefined;
+    className?: string | undefined;
+    'data-testid'?: string | undefined;
+}
+export declare function ConnectionStringField({ value, onValueChange, onCommit, protocols, placeholderEngine, label, required, helper, errorText, statusLine, statusTone, shortcut, showQuickFill, quickFillLabel, onQuickFill, hostLabel, className, 'data-testid': testId, }: ConnectionStringFieldProps): import("react").JSX.Element;
+/**
+ * The registry binding (annex §10). Binds the §3 `form-state` shape — the DSN is
+ * `values.dsn`, which is exactly "field defs + values" with one field.
+ *
+ * WRITE MODEL: the intent fires on COMMIT (Enter/blur), never per keystroke.
+ * Every other input in this family streams its changes, but a DSN carries a
+ * password: a keystroke-level intent would write a partial credential into the
+ * host's audit log on every character typed. One committed value is also all a
+ * connection test can use.
+ */
+export declare function ConnectionStringFieldWidget({ config, data, onEvent }: WidgetProps<ConnectionStringFieldConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ConnectionStringField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionStringField.d.ts","sourceRoot":"","sources":["../../../src/families/forms/ConnectionStringField.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,iCAAiC,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AASrE,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,iCAAiC,EAAE,6BAA6B,EAAE,CAAC;AAC5E,YAAY,EAAE,2BAA2B,EAAE,CAAC;AAwB5C,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC/C,4EAA4E;IAC5E,SAAS,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAC;IAC7C,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC1C,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,uEAAuE;IACvE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACnE,2EAA2E;IAC3E,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACnC,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5D,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EACL,aAAa,EACb,QAAQ,EACR,SAAuB,EACvB,iBAAiB,EACjB,KAAK,EACL,QAAgB,EAChB,MAAM,EACN,SAAS,EACT,UAAU,EACV,UAAkB,EAClB,QAAQ,EACR,aAAoB,EACpB,cAAc,EACd,WAAW,EACX,SAAS,EACT,SAAS,EACT,aAAa,EAAE,MAAM,GACtB,EAAE,0BAA0B,+BA0F5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,2BAA2B,CAAC,+BA2C9G"}

package/dist/families/forms/ConnectionStringField.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `connection-string-field` (annex §10) — mono DSN input with a database icon, a
+ * keyboard-shortcut badge, host parsing, provider quick-fill chips and an inline
+ * success/status line ("14 tables detected").
+ * Evidence: Adminium Console, Onboarding, See It In Action.
+ *
+ * TWO EXPORTS, ONE IMPLEMENTATION:
+ *   · `ConnectionStringField` — the presentational field. The Studio connect
+ *     wizard (`apps/dashboard/src/studio/connect/steps/SourceStep.tsx`) renders
+ *     THIS component; it used to carry its own copy of the field, and the DSN
+ *     grammar behind both now lives in the pure `forms-dsn.ts` (see that
+ *     module's header for why the wizard became the consumer).
+ *   · `ConnectionStringFieldWidget` — the registry binding over it.
+ *
+ * Composed from @adminium/ui's `InputGroup`, which already owns the leading-icon
+ * + `Kbd` chrome and moves the focus ring to the wrapper.
+ */
+import { FormField, InputGroup, Tag, cn } from '@adminium/ui';
+import { Database } from 'lucide-react';
+import { useState } from 'react';
+import { connectionStringFieldConfigSchema, connectionStringFieldDemoData } from './forms-config.js';
+import { DSN_ENGINES, dsnHost, dsnPlaceholder, dsnValidationCode, engineForDsn, providerChipsFor, } from './forms-dsn.js';
+import { bindingTargetOf, formValuesOf } from './forms-state.js';
+export { connectionStringFieldConfigSchema, connectionStringFieldDemoData };
+/**
+ * English developer fallbacks for the two validation codes. Deliberately
+ * GENERIC about which schemes are expected: the accepted set is `protocols`, so
+ * naming Postgres and MySQL here would be wrong for a field configured for
+ * Mongo. A caller that knows its own protocol list (the wizard does) passes
+ * precise copy through `errorText`.
+ */
+const DEFAULT_DSN_ERROR = {
+    'invalid-scheme': 'Unrecognized connection-string scheme.',
+    incomplete: 'Add a host and database to the connection string.',
+};
+/** Status-line tone → text colour. Tokens only — never a raw hex (04 §7.1). */
+const STATUS_TONE_CLASS = {
+    neutral: 'text-fg-muted',
+    accent: 'text-accent',
+    pos: 'text-pos',
+    warn: 'text-warn',
+    danger: 'text-danger',
+    info: 'text-info',
+};
+export function ConnectionStringField({ value, onValueChange, onCommit, protocols = DSN_ENGINES, placeholderEngine, label, required = false, helper, errorText, statusLine, statusTone = 'pos', shortcut, showQuickFill = true, quickFillLabel, onQuickFill, hostLabel, className, 'data-testid': testId, }) {
+    const detected = engineForDsn(value, protocols);
+    const code = dsnValidationCode(value, protocols);
+    const host = dsnHost(value);
+    // The DSN's own engine wins over the caller's hint: once the user has typed
+    // `mysql://`, a Postgres example placeholder is no longer the useful one.
+    const exampleEngine = detected ?? placeholderEngine ?? 'postgres';
+    const chips = showQuickFill ? providerChipsFor(exampleEngine, protocols) : [];
+    const error = code === null ? undefined : (errorText?.[code] ?? DEFAULT_DSN_ERROR[code]);
+    return (_jsxs("div", { className: cn('flex flex-col gap-3', className), "data-widget": "connection-string-field", "data-engine": detected ?? undefined, "data-testid": testId, children: [_jsx(FormField, { label: label, required: required, ...(error === undefined ? {} : { error }), ...(detected === null ? {} : { tag: _jsx(Tag, { mono: true, children: detected }) }), ...(error === undefined && helper !== undefined ? { helper } : {}), children: _jsx(InputGroup, { mono: true, iconLeading: _jsx(Database, {}), ...(shortcut === undefined ? {} : { kbd: shortcut }), error: error !== undefined, value: value, onChange: (event) => onValueChange(event.currentTarget.value), onBlur: () => onCommit?.(value), onKeyDown: (event) => {
+                        if (event.key === 'Enter')
+                            onCommit?.(value);
+                    }, placeholder: dsnPlaceholder(exampleEngine), autoComplete: "off", spellCheck: false, "data-part": "dsn-input" }) }), chips.length > 0 && (_jsxs("div", { className: "flex flex-wrap items-center gap-1.5", "data-part": "quick-fill", children: [quickFillLabel !== undefined && _jsx("span", { className: "text-caption text-fg-subtle", children: quickFillLabel }), chips.map((chip) => (_jsx("button", { type: "button", "data-part": "quick-fill-chip", "data-key": chip.key, onClick: () => {
+                            if (onQuickFill !== undefined)
+                                onQuickFill(chip);
+                            else {
+                                onValueChange(chip.dsn);
+                                onCommit?.(chip.dsn);
+                            }
+                        }, className: 'rounded-full border border-border-strong bg-surface px-2.5 py-0.5 text-caption font-semibold text-fg-muted ' +
+                            'transition-colors duration-150 hover:border-fg-subtle hover:text-fg ' +
+                            'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent', children: chip.label }, chip.key)))] })), (statusLine !== undefined || (host !== null && hostLabel !== undefined)) && (_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [host !== null && hostLabel !== undefined && (_jsx("span", { "data-part": "dsn-host", className: "text-caption text-fg-muted", children: hostLabel.replace('{host}', host) })), statusLine !== undefined && (_jsx("span", { "data-part": "status-line", className: cn('text-caption font-semibold', STATUS_TONE_CLASS[statusTone]), children: statusLine }))] }))] }));
+}
+/**
+ * The registry binding (annex §10). Binds the §3 `form-state` shape — the DSN is
+ * `values.dsn`, which is exactly "field defs + values" with one field.
+ *
+ * WRITE MODEL: the intent fires on COMMIT (Enter/blur), never per keystroke.
+ * Every other input in this family streams its changes, but a DSN carries a
+ * password: a keystroke-level intent would write a partial credential into the
+ * host's audit log on every character typed. One committed value is also all a
+ * connection test can use.
+ */
+export function ConnectionStringFieldWidget({ config, data, onEvent }) {
+    const values = formValuesOf(data);
+    const initial = typeof values['dsn'] === 'string' ? values['dsn'] : '';
+    const [dsn, setDsn] = useState(initial);
+    const target = bindingTargetOf(config.binding);
+    const errorText = {};
+    if (config.invalidSchemeText !== undefined)
+        errorText['invalid-scheme'] = config.invalidSchemeText;
+    if (config.incompleteText !== undefined)
+        errorText['incomplete'] = config.incompleteText;
+    return (_jsx("div", { className: "flex h-full flex-col justify-center px-4 pb-4", children: _jsx(ConnectionStringField, { value: dsn, onValueChange: setDsn, onCommit: (next) => {
+                // Unbound (demo/story/palette): keep the local value, emit nothing —
+                // there is nowhere to send the intent (04 §5).
+                if (target === null)
+                    return;
+                onEvent({
+                    type: 'mutate',
+                    intent: 'update',
+                    connectionId: target.connectionId,
+                    table: target.table,
+                    values: { dsn: next },
+                });
+            }, protocols: config.protocols ?? DSN_ENGINES, placeholderEngine: config.placeholderEngine, label: config.label ?? config.title ?? 'Connection string', required: config.required, helper: config.helpText, errorText: errorText, statusLine: config.statusLine, statusTone: config.statusTone ?? 'pos', shortcut: config.shortcut, showQuickFill: config.showQuickFill, quickFillLabel: config.quickFillLabel, hostLabel: config.hostLabel, "data-testid": config.testId }) }));
+}
+//# sourceMappingURL=ConnectionStringField.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * `drawer-form` (annex §10) — side-drawer create/edit flow with the full field
+ * set; appends the record on submit. The >5-field counterpart of `modal-wizard`
+ * (annex §10 auto-instantiation: "≤5 fields → modal-wizard, more → drawer-form
+ * or full page"). Evidence: Scheduled Reports.
+ *
+ * Wraps @adminium/ui's `Drawer` (Radix — focus trap, Esc/overlay close, the
+ * inline-end slide) and shares `FormFields` with `modal-wizard`.
+ *
+ * WRITE MODEL (04 §2.1): submit emits an `insert` INTENT and awaits the host's
+ * commit before closing, so a rejected write leaves the drawer open with the
+ * user's input intact rather than silently discarding it.
+ */
+import { drawerFormConfigSchema, drawerFormDemoData } from './forms-config.js';
+import type { DrawerFormConfig } from './forms-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { drawerFormConfigSchema, drawerFormDemoData };
+export type { DrawerFormConfig };
+export declare function DrawerFormWidget({ config, data, instanceId, onEvent }: WidgetProps<DrawerFormConfig>): import("react").JSX.Element;
+//# sourceMappingURL=DrawerForm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DrawerForm.d.ts","sourceRoot":"","sources":["../../../src/families/forms/DrawerForm.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,gBAAgB,CAAC,+BAsEpG"}

package/dist/families/forms/DrawerForm.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `drawer-form` (annex §10) — side-drawer create/edit flow with the full field
+ * set; appends the record on submit. The >5-field counterpart of `modal-wizard`
+ * (annex §10 auto-instantiation: "≤5 fields → modal-wizard, more → drawer-form
+ * or full page"). Evidence: Scheduled Reports.
+ *
+ * Wraps @adminium/ui's `Drawer` (Radix — focus trap, Esc/overlay close, the
+ * inline-end slide) and shares `FormFields` with `modal-wizard`.
+ *
+ * WRITE MODEL (04 §2.1): submit emits an `insert` INTENT and awaits the host's
+ * commit before closing, so a rejected write leaves the drawer open with the
+ * user's input intact rather than silently discarding it.
+ */
+import { Button, Drawer, DrawerBody, DrawerFooter, DrawerHeader } from '@adminium/ui';
+import { useState } from 'react';
+import { FormFields } from './FormFields.js';
+import { bindingTargetOf, initialValues, missingRequired, resolveFields } from './forms-state.js';
+import { drawerFormConfigSchema, drawerFormDemoData } from './forms-config.js';
+export { drawerFormConfigSchema, drawerFormDemoData };
+export function DrawerFormWidget({ config, data, instanceId, onEvent }) {
+    const fields = resolveFields(config.fields, data);
+    const [open, setOpen] = useState(false);
+    const [values, setValues] = useState(() => initialValues(fields, data));
+    const [invalid, setInvalid] = useState([]);
+    const [submitting, setSubmitting] = useState(false);
+    const target = bindingTargetOf(config.binding);
+    const submit = async () => {
+        const missing = missingRequired(fields, values);
+        setInvalid(missing);
+        if (missing.length > 0)
+            return;
+        if (target === null) {
+            setOpen(false);
+            return;
+        }
+        setSubmitting(true);
+        try {
+            await onEvent({
+                type: 'mutate',
+                intent: 'insert',
+                connectionId: target.connectionId,
+                table: target.table,
+                values,
+            });
+            setOpen(false);
+        }
+        catch {
+            // Host owns error surfacing; the drawer stays open with the input intact.
+        }
+        finally {
+            setSubmitting(false);
+        }
+    };
+    return (_jsxs("div", { className: "flex h-full items-center px-4 pb-4", "data-widget": "drawer-form", "data-testid": config.testId, children: [_jsx(Button, { size: "sm", "data-part": "drawer-trigger", onClick: () => setOpen(true), children: config.triggerLabel ?? config.title ?? 'New' }), _jsxs(Drawer, { open: open, onOpenChange: setOpen, size: config.width, children: [_jsx(DrawerHeader, { title: config.title ?? 'New record', ...(config.subtitleText === undefined ? {} : { subtitle: config.subtitleText }), closeLabel: config.cancelLabel ?? 'Close' }), _jsx(DrawerBody, { children: _jsx(FormFields, { fields: fields, values: values, invalid: invalid, idPrefix: instanceId, onChange: (name, value) => {
+                                setValues((previous) => ({ ...previous, [name]: value }));
+                                setInvalid((previous) => previous.filter((entry) => entry !== name));
+                            } }) }), _jsxs(DrawerFooter, { children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: () => setOpen(false), children: config.cancelLabel ?? 'Cancel' }), _jsx(Button, { size: "sm", "data-part": "drawer-submit", disabled: submitting, onClick: () => void submit(), children: config.submitLabel ?? 'Save' })] })] })] }));
+}
+//# sourceMappingURL=DrawerForm.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * `export-builder` (annex §10) — a config form (format segmented PDF/CSV/XLSX,
+ * date range, include-charts switch) driving an idle → running(%) → done
+ * (Download) state machine. Evidence: Adminium UI Kit, Metrics Dashboard,
+ * Payments, Time Tracking.
+ *
+ * PRESENTATIONAL: clicking Export emits an `insert` intent describing the JOB —
+ * the host queues it and reports progress back through the payload. The widget
+ * runs no export and owns no timer, which is also why the phase is derived
+ * (see `exportPhaseOf`) rather than animated locally.
+ *
+ * Binds §3 `form-state`: the payload is the export's config plus its progress.
+ */
+import { exportBuilderConfigSchema, exportBuilderDemoData } from './forms-config.js';
+import type { ExportBuilderConfig } from './forms-config.js';
+import type { ExportFormat } from './forms-builders.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { exportBuilderConfigSchema, exportBuilderDemoData };
+export type { ExportBuilderConfig };
+export interface ExportState {
+    format: ExportFormat;
+    from: string;
+    to: string;
+    includeCharts: boolean;
+    groupBy: string;
+    email: boolean;
+}
+/** Project the §3 `form-state` payload onto the form's initial values. */
+export declare function exportStateOf(data: unknown, config: ExportBuilderConfig): ExportState;
+export declare function ExportBuilderWidget({ config, data, onEvent }: WidgetProps<ExportBuilderConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ExportBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExportBuilder.d.ts","sourceRoot":"","sources":["../../../src/families/forms/ExportBuilder.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,qBAAqB,CAAC;AAGrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,GAAG,WAAW,CAerF;AAED,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,mBAAmB,CAAC,+BAyI9F"}

package/dist/families/forms/ExportBuilder.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `export-builder` (annex §10) — a config form (format segmented PDF/CSV/XLSX,
+ * date range, include-charts switch) driving an idle → running(%) → done
+ * (Download) state machine. Evidence: Adminium UI Kit, Metrics Dashboard,
+ * Payments, Time Tracking.
+ *
+ * PRESENTATIONAL: clicking Export emits an `insert` intent describing the JOB —
+ * the host queues it and reports progress back through the payload. The widget
+ * runs no export and owns no timer, which is also why the phase is derived
+ * (see `exportPhaseOf`) rather than animated locally.
+ *
+ * Binds §3 `form-state`: the payload is the export's config plus its progress.
+ */
+import { Button, DateInput, FormField, MonoText, ProgressBar, SegmentedControl, Select, Switch } from '@adminium/ui';
+import { Download } from 'lucide-react';
+import { useState } from 'react';
+import { exportBuilderConfigSchema, exportBuilderDemoData } from './forms-config.js';
+import { EXPORT_FORMATS, EXPORT_PHASES, exportPhaseOf } from './forms-builders.js';
+import { clampPct, numberField, oneOf, stringField } from './forms-lib.js';
+import { bindingTargetOf, formValuesOf } from './forms-state.js';
+export { exportBuilderConfigSchema, exportBuilderDemoData };
+/** Project the §3 `form-state` payload onto the form's initial values. */
+export function exportStateOf(data, config) {
+    const values = formValuesOf(data);
+    const formats = config.formats ?? EXPORT_FORMATS;
+    const fallback = formats[0] ?? 'csv';
+    const format = oneOf(values['format'], EXPORT_FORMATS, fallback);
+    return {
+        // A payload naming a format this instance disabled falls back rather than
+        // rendering a segmented control with no segment selected.
+        format: formats.includes(format) ? format : fallback,
+        from: stringField(values, 'from') ?? '',
+        to: stringField(values, 'to') ?? '',
+        includeCharts: values['includeCharts'] === true,
+        groupBy: stringField(values, 'groupBy') ?? '',
+        email: values['email'] === true,
+    };
+}
+export function ExportBuilderWidget({ config, data, onEvent }) {
+    const values = formValuesOf(data);
+    const formats = config.formats ?? EXPORT_FORMATS;
+    const [state, setState] = useState(() => exportStateOf(data, config));
+    const [submitted, setSubmitted] = useState(false);
+    const target = bindingTargetOf(config.binding);
+    const payloadPhase = oneOf(values['status'], EXPORT_PHASES, 'idle');
+    const phase = exportPhaseOf(payloadPhase, submitted);
+    const progress = clampPct(numberField(values, 'progress'));
+    const href = stringField(values, 'downloadHref') ?? config.href;
+    const patch = (partial) => setState((current) => ({ ...current, ...partial }));
+    const submit = () => {
+        setSubmitted(true);
+        if (target === null)
+            return; // unbound (demo/story/palette)
+        onEvent({
+            type: 'mutate',
+            intent: 'insert',
+            connectionId: target.connectionId,
+            table: target.table,
+            values: {
+                format: state.format,
+                from: state.from,
+                to: state.to,
+                ...(config.includeChartsOption ? { includeCharts: state.includeCharts } : {}),
+                ...(config.groupBy === undefined ? {} : { groupBy: state.groupBy }),
+                ...(config.emailOption ? { email: state.email } : {}),
+            },
+        });
+    };
+    return (_jsxs("div", { "data-widget": "export-builder", "data-phase": phase, "data-testid": config.testId, className: "flex h-full flex-col gap-3 overflow-auto px-4 pb-4", children: [_jsx(FormField, { label: config.formatLabel ?? 'Format', children: _jsx(SegmentedControl, { "aria-label": config.formatLabel ?? 'Format', "data-part": "export-format", value: state.format, onValueChange: (next) => patch({ format: oneOf(next, EXPORT_FORMATS, state.format) }), options: formats.map((format) => ({ value: format, label: format.toUpperCase() })) }) }), _jsxs("div", { className: "grid gap-3 sm:grid-cols-2", children: [_jsx(FormField, { label: config.fromLabel ?? 'From', children: _jsx(DateInput, { "data-part": "export-from", value: state.from, onChange: (event) => patch({ from: event.currentTarget.value }) }) }), _jsx(FormField, { label: config.toLabel ?? 'To', children: _jsx(DateInput, { "data-part": "export-to", value: state.to, onChange: (event) => patch({ to: event.currentTarget.value }) }) })] }), config.groupBy !== undefined && config.groupBy.length > 0 && (_jsx(FormField, { label: config.groupByLabel ?? 'Group by', children: _jsxs(Select, { "data-part": "export-group-by", value: state.groupBy, onChange: (event) => patch({ groupBy: event.currentTarget.value }), children: [_jsx("option", { value: "" }), config.groupBy.map((option) => (_jsx("option", { value: option.key, children: option.label ?? option.key }, option.key)))] }) })), config.includeChartsOption && (_jsxs("label", { className: "flex cursor-pointer items-center justify-between gap-3", children: [_jsx("span", { className: "text-body-sm text-fg", children: config.includeChartsLabel ?? 'Include charts' }), _jsx(Switch, { "data-part": "export-include-charts", checked: state.includeCharts, onCheckedChange: (next) => patch({ includeCharts: next }) })] })), config.emailOption && (_jsxs("label", { className: "flex cursor-pointer items-center justify-between gap-3", children: [_jsx("span", { className: "text-body-sm text-fg", children: config.emailLabel ?? 'Email me the export' }), _jsx(Switch, { "data-part": "export-email", checked: state.email, onCheckedChange: (next) => patch({ email: next }) })] })), phase === 'running' && (_jsxs("div", { "data-part": "export-progress", className: "flex flex-col gap-1.5", children: [_jsxs("div", { className: "flex items-center justify-between gap-2", children: [_jsx("span", { className: "text-caption text-fg-muted", children: config.runningLabel ?? 'Preparing your export…' }), _jsx(MonoText, { className: "text-caption tabular-nums text-fg-muted", children: `${progress}%` })] }), _jsx(ProgressBar, { value: progress, label: config.runningLabel ?? 'Preparing your export…' })] })), phase === 'failed' && (_jsx("p", { "data-part": "export-failed", className: "text-caption font-semibold text-danger", children: config.failedLabel ?? 'The export failed. Try again.' })), _jsxs("div", { className: "mt-auto flex items-center justify-end gap-2", children: [phase === 'done' && (_jsx("span", { "data-part": "export-done", className: "me-auto text-caption font-semibold text-pos", children: config.doneLabel ?? 'Export ready' })), phase === 'done' && href !== undefined ? (
+                    // Drill-through, not an <a download>: the host owns navigation and the
+                    // signed URL (04 §2.1). A Download button with no href would be a
+                    // control that does nothing, so it only renders once there IS one.
+                    _jsx(Button, { "data-part": "export-download", iconLeft: _jsx(Download, {}), onClick: () => onEvent({ type: 'drill-through', href }), children: config.downloadLabel ?? 'Download' })) : (_jsx(Button, { "data-part": "export-submit", loading: phase === 'running', disabled: phase === 'running', onClick: submit, children: config.submitLabel ?? 'Export' }))] })] }));
+}
+//# sourceMappingURL=ExportBuilder.js.map