@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/forms/QuestionBuilder.js

@@ -0,0 +1,133 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `question-builder` (annex §10) — the survey editor pair: a palette rail of the
+ * 8 addable question types beside reorderable question cards with type-specific
+ * answer previews (radio/checkbox rows, dropdown stub, short/long text, star
+ * rating, NPS 0–10 chips, date stub) and a required toggle.
+ * Evidence: Survey Builder.
+ *
+ * PRESENTATIONAL: the question list lives in local state; every change is a
+ * `mutate` intent (04 §2.1). The widget never persists a survey.
+ *
+ * Binds §3 `form-state` — like the other builders, an empty canvas is a builder
+ * awaiting its first question, not an empty widget.
+ *
+ * REORDERING IS BUTTONS, NOT DRAG. `@dnd-kit` is confined to the `boards` family
+ * by the chunk-budget gate (04 §2.3), so a drag layer here would ship a drag
+ * engine to every page with a settings toggle. Move-up/move-down is also the
+ * affordance a pointer-only drag never has: it works from the keyboard.
+ */
+import { EmptyState, IconTile, Input, MonoText, Switch, cn } from '@adminium/ui';
+import { ChevronDown, ChevronUp, Plus, Star, X } from 'lucide-react';
+import { useState } from 'react';
+import { DEFAULT_QUESTION_KIND_LABELS, questionBuilderConfigSchema, questionBuilderDemoData, } from './forms-config.js';
+import { NPS_SCORES, QUESTION_KINDS, RATING_STARS, moveItem, questionTakesOptions } from './forms-builders.js';
+import { questionKindIcon } from './forms-icons.js';
+import { booleanField, oneOf, stringField } from './forms-lib.js';
+import { bindingTargetOf, formValuesOf } from './forms-state.js';
+export { questionBuilderConfigSchema, questionBuilderDemoData };
+/** Project the §3 `form-state` payload onto survey questions. */
+export function questionsOf(data, config) {
+    const values = formValuesOf(data);
+    const raw = values['questions'];
+    if (!Array.isArray(raw))
+        return [];
+    const kinds = config.kinds ?? QUESTION_KINDS;
+    const out = [];
+    for (const [index, entry] of raw.entries()) {
+        if (typeof entry !== 'object' || entry === null || Array.isArray(entry))
+            continue;
+        const row = entry;
+        const kind = oneOf(row['kind'], QUESTION_KINDS, 'short-text');
+        // A question of a kind this survey disabled is dropped rather than coerced:
+        // silently turning a disabled NPS question into a short-text box would
+        // change what the survey asks respondents.
+        if (!kinds.includes(kind))
+            continue;
+        const opts = Array.isArray(row['opts']) ? row['opts'].filter((o) => typeof o === 'string') : [];
+        out.push({
+            id: stringField(row, 'id') ?? `q-${index}`,
+            kind,
+            q: stringField(row, 'q') ?? '',
+            required: booleanField(row, 'required') === true,
+            opts,
+        });
+    }
+    return out;
+}
+export function QuestionBuilderWidget({ config, data, onEvent }) {
+    const [questions, setQuestions] = useState(() => questionsOf(data, config));
+    const target = bindingTargetOf(config.binding);
+    const kinds = config.kinds ?? QUESTION_KINDS;
+    const commit = (next) => {
+        setQuestions(next);
+        if (target === null)
+            return; // unbound (demo/story/palette)
+        onEvent({
+            type: 'mutate',
+            intent: 'update',
+            connectionId: target.connectionId,
+            table: target.table,
+            values: {
+                questions: next.map((question) => ({
+                    id: question.id,
+                    kind: question.kind,
+                    q: question.q,
+                    required: question.required,
+                    // Only the kinds that HAVE options carry them: an NPS question with a
+                    // leftover `opts` array from before a kind switch would describe a
+                    // scale with choices, which is not a thing.
+                    ...(questionTakesOptions(question.kind) ? { opts: question.opts } : {}),
+                })),
+            },
+        });
+    };
+    const addQuestion = (kind) => {
+        if (questions.length >= config.maxQuestions)
+            return;
+        commit([
+            ...questions,
+            {
+                id: `${kind}-${questions.length}`,
+                kind,
+                q: '',
+                required: false,
+                opts: questionTakesOptions(kind) ? ['Option 1', 'Option 2'] : [],
+            },
+        ]);
+    };
+    const patch = (index, partial) => commit(questions.map((question, i) => (i === index ? { ...question, ...partial } : question)));
+    const atCapacity = questions.length >= config.maxQuestions;
+    const kindLabel = (kind) => config.kindLabels?.[kind] ?? DEFAULT_QUESTION_KIND_LABELS[kind] ?? kind;
+    return (_jsxs("div", { "data-widget": "question-builder", "data-testid": config.testId, className: "flex h-full gap-3 overflow-hidden px-4 pb-4", children: [_jsxs("div", { "data-part": "question-palette", className: "hidden w-40 shrink-0 flex-col gap-1 overflow-auto sm:flex", children: [_jsx("p", { className: "text-caption font-bold uppercase tracking-wide text-fg-subtle", children: config.paletteTitle ?? 'Add a question' }), kinds.map((kind) => (_jsxs("button", { type: "button", "data-part": "palette-kind", "data-kind": kind, disabled: atCapacity, onClick: () => addQuestion(kind), className: cn('flex items-center gap-2 rounded-md border border-border px-2 py-1.5 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("span", { className: "text-fg-muted [&_svg]:size-3.5", children: questionKindIcon(kind) }), _jsx("span", { className: "min-w-0 truncate text-caption font-semibold text-fg", children: kindLabel(kind) })] }, kind)))] }), _jsxs("div", { "data-part": "question-canvas", className: "flex min-w-0 flex-1 flex-col gap-2 overflow-auto", children: [questions.length === 0 ? (_jsx(EmptyState, { compact: true, preset: "no-data", title: config.emptyTitle ?? 'No questions yet', body: config.emptyBody ?? 'Pick a question type to start building your survey.' })) : (questions.map((question, index) => (_jsxs("div", { "data-part": "question-card", "data-kind": question.kind, "data-question": question.id, "data-required": question.required, className: "flex flex-col gap-2 rounded-lg border border-border bg-surface-2 px-2.5 py-2.5", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(IconTile, { size: "sm", tone: "accent", icon: questionKindIcon(question.kind) }), _jsx(MonoText, { className: "shrink-0 text-caption text-fg-subtle", children: kindLabel(question.kind) }), _jsxs("div", { className: "ms-auto flex items-center gap-0.5", children: [_jsx(RailButton, { label: `${config.moveUpLabel ?? 'Move up'} — ${index + 1}`, part: "question-up", disabled: index === 0, onClick: () => commit(moveItem(questions, index, index - 1)), children: _jsx(ChevronUp, { "aria-hidden": "true", className: "size-4" }) }), _jsx(RailButton, { label: `${config.moveDownLabel ?? 'Move down'} — ${index + 1}`, part: "question-down", disabled: index === questions.length - 1, onClick: () => commit(moveItem(questions, index, index + 1)), children: _jsx(ChevronDown, { "aria-hidden": "true", className: "size-4" }) }), _jsx(RailButton, { label: `${config.removeLabel ?? 'Remove question'} — ${index + 1}`, part: "question-remove", onClick: () => commit(questions.filter((_, i) => i !== index)), children: _jsx(X, { "aria-hidden": "true", className: "size-4" }) })] })] }), _jsx(Input, { "aria-label": `${config.questionPlaceholder ?? 'Question'} ${index + 1}`, "data-part": "question-text", value: question.q, placeholder: config.questionPlaceholder ?? 'Ask a question…', onChange: (event) => patch(index, { q: event.currentTarget.value }) }), _jsx(AnswerPreview, { kind: question.kind, opts: question.opts }), _jsxs("label", { className: "flex cursor-pointer items-center gap-2 self-end", children: [_jsx("span", { className: "text-caption text-fg-muted", children: config.requiredLabel ?? 'Required' }), _jsx(Switch, { "data-part": "question-required", checked: question.required, onCheckedChange: (next) => patch(index, { required: next }) })] })] }, question.id)))), _jsxs("button", { type: "button", "data-part": "add-question", disabled: atCapacity || kinds.length === 0, onClick: () => {
+                            const first = kinds[0];
+                            if (first !== undefined)
+                                addQuestion(first);
+                        }, className: cn('flex w-fit items-center gap-1.5 rounded-lg border border-dashed border-border-strong px-2.5 py-1.5 sm:hidden', '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 question'] })] })] }));
+}
+function RailButton({ label, part, disabled = false, onClick, children, }) {
+    return (_jsx("button", { type: "button", "aria-label": label, "data-part": part, disabled: disabled, onClick: onClick, className: 'rounded-md p-1 text-fg-subtle transition-colors duration-150 hover:bg-surface-3 hover:text-fg ' +
+            'disabled:pointer-events-none disabled:opacity-30 ' +
+            'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent', children: children }));
+}
+/**
+ * The type-specific answer preview (annex §10). Inert by design: these are the
+ * SHAPES the respondent will see, rendered for the author to recognise — a
+ * working radio group here would invite the author to "answer" their own draft.
+ */
+function AnswerPreview({ kind, opts }) {
+    if (kind === 'single-choice' || kind === 'multi-choice') {
+        return (_jsx("ul", { "aria-hidden": "true", "data-part": "answer-preview", "data-kind": kind, className: "m-0 flex list-none flex-col gap-1 p-0", children: opts.map((option, index) => (_jsxs("li", { className: "flex items-center gap-2 text-caption text-fg-muted", children: [_jsx("span", { className: cn('size-3.5 shrink-0 border border-border-strong', kind === 'single-choice' ? 'rounded-full' : 'rounded-xs') }), option] }, `${option}-${index}`))) }));
+    }
+    if (kind === 'dropdown') {
+        return (_jsxs("div", { "aria-hidden": "true", "data-part": "answer-preview", "data-kind": kind, className: "flex h-8 items-center justify-between rounded-md border border-border-strong bg-surface px-2 text-caption text-fg-subtle", children: [opts[0] ?? 'Choose…', _jsx(ChevronDown, { className: "size-3.5" })] }));
+    }
+    if (kind === 'rating') {
+        return (_jsx("div", { "aria-hidden": "true", "data-part": "answer-preview", "data-kind": kind, className: "flex gap-1", children: Array.from({ length: RATING_STARS }, (_, index) => (_jsx(Star, { className: "size-4 text-fg-subtle" }, index))) }));
+    }
+    if (kind === 'nps') {
+        return (_jsx("div", { "aria-hidden": "true", "data-part": "answer-preview", "data-kind": kind, className: "flex flex-wrap gap-1", children: NPS_SCORES.map((score) => (_jsx(MonoText, { className: "rounded-sm border border-border-strong px-1.5 py-0.5 text-caption text-fg-subtle", children: score }, score))) }));
+    }
+    return (_jsx("div", { "aria-hidden": "true", "data-part": "answer-preview", "data-kind": kind, className: cn('rounded-md border border-border-strong bg-surface', kind === 'long-text' ? 'h-12' : 'h-8') }));
+}
+//# sourceMappingURL=QuestionBuilder.js.map

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * `rule-builder` (annex §10) — condition rows (field, operator, accent value)
+ * joined by ALL/ANY pill dividers, removable, with a dashed add button; feeds
+ * segment/filter definitions. Evidence: Audience Segments.
+ *
+ * PRESENTATIONAL: the condition list lives in local state and every change is
+ * reported as a `mutate` intent (04 §2.1). The widget never compiles the rule to
+ * SQL and never persists it — the host owns both, because a WHERE clause built
+ * in the browser is a WHERE clause the server must re-derive anyway.
+ *
+ * Binds the §3 `form-state` shape. Not `record-list`, even though the payload
+ * carries a list: an EMPTY rule-builder is not an empty widget — it is a builder
+ * waiting for its first condition, and it must show the dashed add button rather
+ * than the frame's "no data" state (`form-state` is never empty by §3).
+ */
+import { ruleBuilderConfigSchema, ruleBuilderDemoData } from './forms-config.js';
+import type { RuleBuilderConfig } from './forms-config.js';
+import type { RuleMatchMode, RuleOperator } from './forms-builders.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { ruleBuilderConfigSchema, ruleBuilderDemoData };
+export type { RuleBuilderConfig };
+export interface RuleCondition {
+    key: string;
+    field: string;
+    op: RuleOperator;
+    value: string;
+}
+/**
+ * Project the §3 `form-state` payload onto conditions.
+ *
+ * A condition naming a column the catalog no longer has is KEPT (typed as
+ * `string`, the most permissive operator set), not dropped. Dropping it would
+ * silently widen the rule: a saved segment that read "plan is pro AND region is
+ * EU" would quietly become "plan is pro" the first time someone renamed the
+ * region column, and the next save would persist the wider rule as if the user
+ * had asked for it.
+ */
+export declare function conditionsOf(data: unknown, config: RuleBuilderConfig): RuleCondition[];
+/** Config's `matchMode` is the generated default; the payload's `match` overrides it. */
+export declare function matchModeOf(data: unknown, config: RuleBuilderConfig): RuleMatchMode;
+export declare function RuleBuilderWidget({ config, data, onEvent }: WidgetProps<RuleBuilderConfig>): import("react").JSX.Element;
+//# sourceMappingURL=RuleBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RuleBuilder.d.ts","sourceRoot":"","sources":["../../../src/families/forms/RuleBuilder.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAgD,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC/H,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,mBAAmB,CAAC;AAQ5E,OAAO,KAAK,EAAiB,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGtF,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,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AASD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAG,aAAa,EAAE,CAoBtF;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAGnF;AAED,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,iBAAiB,CAAC,+BAmL1F"}

package/dist/families/forms/RuleBuilder.js

@@ -0,0 +1,150 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `rule-builder` (annex §10) — condition rows (field, operator, accent value)
+ * joined by ALL/ANY pill dividers, removable, with a dashed add button; feeds
+ * segment/filter definitions. Evidence: Audience Segments.
+ *
+ * PRESENTATIONAL: the condition list lives in local state and every change is
+ * reported as a `mutate` intent (04 §2.1). The widget never compiles the rule to
+ * SQL and never persists it — the host owns both, because a WHERE clause built
+ * in the browser is a WHERE clause the server must re-derive anyway.
+ *
+ * Binds the §3 `form-state` shape. Not `record-list`, even though the payload
+ * carries a list: an EMPTY rule-builder is not an empty widget — it is a builder
+ * waiting for its first condition, and it must show the dashed add button rather
+ * than the frame's "no data" state (`form-state` is never empty by §3).
+ */
+import { DateInput, IconButton, Input, Select, cn } from '@adminium/ui';
+import { Plus, X } from 'lucide-react';
+import { useState } from 'react';
+import { DEFAULT_RULE_FIELDS, DEFAULT_OPERATOR_LABELS, ruleBuilderConfigSchema, ruleBuilderDemoData } from './forms-config.js';
+import { RULE_MATCH_MODES, RULE_OPERATORS, operatorTakesValue, operatorsForType, repairOperator, } from './forms-builders.js';
+import { oneOf, stringField } from './forms-lib.js';
+import { bindingTargetOf, formValuesOf } from './forms-state.js';
+export { ruleBuilderConfigSchema, ruleBuilderDemoData };
+/** The field def for a condition, or `null` when the catalog has no such column. */
+function fieldDefOf(catalog, name) {
+    return catalog.find((field) => field.name === name) ?? null;
+}
+/**
+ * Project the §3 `form-state` payload onto conditions.
+ *
+ * A condition naming a column the catalog no longer has is KEPT (typed as
+ * `string`, the most permissive operator set), not dropped. Dropping it would
+ * silently widen the rule: a saved segment that read "plan is pro AND region is
+ * EU" would quietly become "plan is pro" the first time someone renamed the
+ * region column, and the next save would persist the wider rule as if the user
+ * had asked for it.
+ */
+export function conditionsOf(data, config) {
+    const values = formValuesOf(data);
+    const raw = values['conditions'];
+    if (!Array.isArray(raw))
+        return [];
+    const catalog = config.fieldCatalog ?? DEFAULT_RULE_FIELDS;
+    const out = [];
+    for (const [index, entry] of raw.entries()) {
+        if (typeof entry !== 'object' || entry === null || Array.isArray(entry))
+            continue;
+        const row = entry;
+        const field = stringField(row, 'field');
+        if (field === undefined)
+            continue;
+        const type = fieldDefOf(catalog, field)?.type ?? 'string';
+        out.push({
+            key: `${field}-${index}`,
+            field,
+            op: repairOperator(oneOf(row['op'], RULE_OPERATORS, 'eq'), type, config.operatorsByType),
+            value: stringField(row, 'value') ?? '',
+        });
+    }
+    return out;
+}
+/** Config's `matchMode` is the generated default; the payload's `match` overrides it. */
+export function matchModeOf(data, config) {
+    const values = formValuesOf(data);
+    return oneOf(values['match'], RULE_MATCH_MODES, config.matchMode);
+}
+export function RuleBuilderWidget({ config, data, onEvent }) {
+    const catalog = config.fieldCatalog ?? DEFAULT_RULE_FIELDS;
+    const [conditions, setConditions] = useState(() => conditionsOf(data, config));
+    const [match, setMatch] = useState(() => matchModeOf(data, config));
+    const target = bindingTargetOf(config.binding);
+    const emit = (nextConditions, nextMatch) => {
+        if (target === null)
+            return; // unbound (demo/story/palette) — nowhere to send it
+        onEvent({
+            type: 'mutate',
+            intent: 'update',
+            connectionId: target.connectionId,
+            table: target.table,
+            values: {
+                conditions: nextConditions.map((condition) => ({
+                    field: condition.field,
+                    op: condition.op,
+                    // A value-less operator carries no value: sending the stale text the
+                    // user typed before switching to "is empty" would compile into the
+                    // WHERE clause as a condition they cannot see.
+                    ...(operatorTakesValue(condition.op) ? { value: condition.value } : {}),
+                })),
+                match: nextMatch,
+            },
+        });
+    };
+    const commit = (next) => {
+        setConditions(next);
+        emit(next, match);
+    };
+    const patch = (index, partial) => {
+        commit(conditions.map((condition, i) => (i === index ? { ...condition, ...partial } : condition)));
+    };
+    const onFieldChange = (index, name) => {
+        const current = conditions[index];
+        if (current === undefined)
+            return;
+        const type = fieldDefOf(catalog, name)?.type ?? 'string';
+        // Re-point the operator at one the NEW column's type supports, and drop a
+        // value that belonged to the old column — `mrr >= 500` must not survive a
+        // switch to `country` as `country >= 500`.
+        patch(index, { field: name, op: repairOperator(current.op, type, config.operatorsByType), value: '' });
+    };
+    const addCondition = () => {
+        const first = catalog[0];
+        if (first === undefined || conditions.length >= config.maxConditions)
+            return;
+        const allowed = operatorsForType(first.type, config.operatorsByType);
+        commit([
+            ...conditions,
+            { key: `new-${conditions.length}-${first.name}`, field: first.name, op: allowed[0] ?? 'eq', value: '' },
+        ]);
+    };
+    const toggleMatch = () => {
+        const next = match === 'all' ? 'any' : 'all';
+        setMatch(next);
+        emit(conditions, next);
+    };
+    const matchLabel = match === 'all' ? (config.allLabel ?? 'ALL') : (config.anyLabel ?? 'ANY');
+    return (_jsxs("div", { "data-widget": "rule-builder", "data-match": match, "data-testid": config.testId, className: "flex h-full flex-col gap-2 overflow-auto px-4 pb-4", children: [conditions.length === 0 && (_jsx("p", { className: "text-body-sm text-fg-muted", "data-part": "rule-empty", children: config.emptyBody ?? 'No conditions yet — add one to define this segment.' })), conditions.map((condition, index) => {
+                const def = fieldDefOf(catalog, condition.field);
+                const type = def?.type ?? 'string';
+                const operators = operatorsForType(type, config.operatorsByType);
+                const unknownField = def === null;
+                return (_jsxs("div", { className: "flex flex-col gap-2", children: [index > 0 && (_jsx("button", { type: "button", "data-part": "match-divider", onClick: toggleMatch, "aria-label": matchLabel, className: 'w-fit rounded-full border border-accent bg-accent-soft px-2.5 py-0.5 text-caption font-bold text-accent ' +
+                                'transition-colors duration-150 hover:bg-accent hover:text-accent-fg ' +
+                                'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent', children: matchLabel })), _jsxs("div", { "data-part": "condition-row", "data-field": condition.field, "data-op": condition.op, className: "flex flex-wrap items-center gap-2 rounded-lg border border-border bg-surface-2 px-2.5 py-2", children: [_jsxs(Select, { "aria-label": config.fieldLabel ?? 'Field', "data-part": "condition-field", mono: true, value: condition.field, onChange: (event) => onFieldChange(index, event.currentTarget.value), wrapperClassName: "w-auto min-w-[8rem]", children: [catalog.map((field) => (_jsx("option", { value: field.name, children: field.label ?? field.name }, field.name))), unknownField && _jsx("option", { value: condition.field, children: condition.field })] }), _jsx(Select, { "aria-label": config.operatorLabel ?? 'Operator', "data-part": "condition-operator", value: condition.op, onChange: (event) => patch(index, { op: oneOf(event.currentTarget.value, RULE_OPERATORS, 'eq') }), wrapperClassName: "w-auto min-w-[8rem]", children: operators.map((operator) => (_jsx("option", { value: operator, children: config.operatorLabels?.[operator] ?? DEFAULT_OPERATOR_LABELS[operator] ?? operator }, operator))) }), operatorTakesValue(condition.op) && (_jsx(ValueControl, { type: type, def: def, value: condition.value, label: config.valueLabel ?? 'Value', placeholder: config.valuePlaceholder ?? '', onChange: (next) => patch(index, { value: next }) })), _jsx(IconButton, { label: `${config.removeLabel ?? 'Remove condition'} — ${condition.field}`, "data-part": "condition-remove", variant: "ghost", size: "sm", className: "ms-auto", onClick: () => commit(conditions.filter((_, i) => i !== index)), children: _jsx(X, { className: "size-4" }) })] })] }, condition.key));
+            }), _jsxs("button", { type: "button", "data-part": "add-condition", onClick: addCondition, disabled: conditions.length >= config.maxConditions || catalog.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 condition'] })] }));
+}
+/** The value control for a condition, chosen by the field's column type. */
+function ValueControl({ type, def, value, label, placeholder, onChange, }) {
+    if (type === 'enum' && def?.options !== undefined && def.options.length > 0) {
+        return (_jsxs(Select, { "aria-label": label, "data-part": "condition-value", value: value, onChange: (event) => onChange(event.currentTarget.value), wrapperClassName: "w-auto min-w-[8rem]", children: [_jsx("option", { value: "" }), def.options.map((option) => (_jsx("option", { value: option.value, children: option.label ?? option.value }, option.value)))] }));
+    }
+    if (type === 'boolean') {
+        return (_jsxs(Select, { "aria-label": label, "data-part": "condition-value", value: value, onChange: (event) => onChange(event.currentTarget.value), wrapperClassName: "w-auto min-w-[6rem]", children: [_jsx("option", { value: "true", children: "true" }), _jsx("option", { value: "false", children: "false" })] }));
+    }
+    if (type === 'date') {
+        return (_jsx(DateInput, { "aria-label": label, "data-part": "condition-value", value: value, onChange: (event) => onChange(event.currentTarget.value), className: "w-auto" }));
+    }
+    return (_jsx(Input, { "aria-label": label, "data-part": "condition-value", mono: true, ...(type === 'number' ? { inputMode: 'decimal' } : {}), value: value, placeholder: placeholder, onChange: (event) => onChange(event.currentTarget.value), className: "w-auto min-w-[8rem] flex-1 text-accent" }));
+}
+//# sourceMappingURL=RuleBuilder.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * `stepper` (annex §10) — progress stepper, horizontal or vertical: numbered /
+ * spinner / check circles, connector lines filling accent on completion,
+ * clickable navigation, label + sub per step. Evidence: Auth & Onboarding,
+ * Connect Database, Import Wizard, Onboarding (vertical), Project Overview.
+ *
+ * Wraps @adminium/ui's `Stepper`, which owns the circles, connectors and the
+ * `ol` semantics; this file adds the `record-list` binding, the per-step state
+ * derivation, and routes step clicks through `onEvent`.
+ */
+import type { StepState } from './forms-lib.js';
+import { stepperConfigSchema, stepperDemoData } from './forms-config.js';
+import type { StepperConfig } from './forms-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { stepperConfigSchema, stepperDemoData };
+export type { StepperConfig };
+export interface StepDef {
+    key: string;
+    label: string;
+    description?: string | undefined;
+    state?: StepState | undefined;
+}
+/**
+ * Project the §3 `record-list` payload onto step defs.
+ *
+ * A row's explicit `state` wins; where the payload carries none, the state is
+ * DERIVED from the row's position relative to `activeIndex` — so a plain
+ * `{label}` list still renders a correct done/active/pending run rather than an
+ * all-pending one.
+ */
+export declare function stepsOf(data: unknown, config: StepperConfig): StepDef[];
+export declare function StepperWidget({ config, data, onEvent }: WidgetProps<StepperConfig>): import("react").JSX.Element | null;
+//# sourceMappingURL=StepperWidget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StepperWidget.d.ts","sourceRoot":"","sources":["../../../src/families/forms/StepperWidget.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAe,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,EAAE,CAuBvE;AAED,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,aAAa,CAAC,sCAkClF"}

package/dist/families/forms/StepperWidget.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * `stepper` (annex §10) — progress stepper, horizontal or vertical: numbered /
+ * spinner / check circles, connector lines filling accent on completion,
+ * clickable navigation, label + sub per step. Evidence: Auth & Onboarding,
+ * Connect Database, Import Wizard, Onboarding (vertical), Project Overview.
+ *
+ * Wraps @adminium/ui's `Stepper`, which owns the circles, connectors and the
+ * `ol` semantics; this file adds the `record-list` binding, the per-step state
+ * derivation, and routes step clicks through `onEvent`.
+ */
+import { Stepper } from '@adminium/ui';
+import { oneOf, recordRowsOf, stringField } from './forms-lib.js';
+import { STEP_STATES, stepperConfigSchema, stepperDemoData } from './forms-config.js';
+export { stepperConfigSchema, stepperDemoData };
+/**
+ * Project the §3 `record-list` payload onto step defs.
+ *
+ * A row's explicit `state` wins; where the payload carries none, the state is
+ * DERIVED from the row's position relative to `activeIndex` — so a plain
+ * `{label}` list still renders a correct done/active/pending run rather than an
+ * all-pending one.
+ */
+export function stepsOf(data, config) {
+    const rows = recordRowsOf(data);
+    const out = [];
+    for (const [index, row] of rows.entries()) {
+        const label = stringField(row, config.labelField);
+        if (label === undefined)
+            continue;
+        const raw = row[config.stateField];
+        const state = raw === undefined
+            ? index < config.activeIndex
+                ? 'done'
+                : index === config.activeIndex
+                    ? 'active'
+                    : 'pending'
+            : oneOf(raw, STEP_STATES, 'pending');
+        out.push({
+            key: stringField(row, config.keyField) ?? `step-${index}`,
+            label,
+            description: config.showDescriptions ? stringField(row, config.descField) : undefined,
+            state,
+        });
+    }
+    return out;
+}
+export function StepperWidget({ config, data, onEvent }) {
+    const steps = stepsOf(data, config);
+    if (steps.length === 0)
+        return null;
+    // The active index the UI component highlights: an explicitly-`active` row
+    // wins over the config index, so a payload-driven run stays authoritative.
+    const activeFromRows = steps.findIndex((step) => step.state === 'active');
+    const activeIndex = activeFromRows === -1 ? config.activeIndex : activeFromRows;
+    return (_jsx("div", { className: "flex h-full items-center px-4 pb-4", "data-widget": "stepper", "data-testid": config.testId, children: _jsx(Stepper, { className: "w-full", label: config.a11yLabel ?? config.title ?? 'Progress', orientation: config.orientation, activeIndex: activeIndex, steps: steps.map((step) => ({
+                id: step.key,
+                label: step.label,
+                ...(step.description === undefined ? {} : { description: step.description }),
+                ...(step.state === undefined ? {} : { state: step.state }),
+            })), ...(config.clickable && config.href !== undefined
+                ? {
+                    // Step navigation is a host concern: the widget reports the intent
+                    // and the host routes it (04 §2.1). Without an href there is
+                    // nowhere to go, so the stepper stays read-only.
+                    onStepClick: (index) => onEvent({ type: 'drill-through', href: `${config.href}?step=${steps[index]?.key ?? index}` }),
+                }
+                : {}) }) }));
+}
+//# sourceMappingURL=StepperWidget.js.map

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * `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 type { ReactNode } from 'react';
+import { tableInclusionChecklistConfigSchema, tableInclusionChecklistDemoData } from './forms-config.js';
+import type { TableInclusionChecklistConfig } from './forms-config.js';
+import type { InclusionTable } from './forms-tables.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { tableInclusionChecklistConfigSchema, tableInclusionChecklistDemoData };
+export type { TableInclusionChecklistConfig };
+/**
+ * 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 declare function inclusionTablesOf(data: unknown, config: TableInclusionChecklistConfig): InclusionTable[];
+/** The initial selection: an explicit `included` column wins over the default rule. */
+export declare function initialInclusion(data: unknown, config: TableInclusionChecklistConfig, tables: readonly InclusionTable[]): Set<string>;
+export interface TableInclusionChecklistProps {
+    tables: readonly InclusionTable[];
+    selected: ReadonlySet<string>;
+    onToggle: (id: string, checked: boolean) => void;
+    /**
+     * Replaces the default row-count cell. The wizard passes one so it can degrade
+     * counts per source (`—` for a schema file, `≈` for MySQL estimates) — a
+     * concern the widget has no way to know about and must not guess at.
+     */
+    renderRowMeta?: ((table: InclusionTable) => ReactNode) | undefined;
+    /** Annex §10 `piiDetection`. */
+    piiDetection?: boolean | undefined;
+    /** Annex §10 `maxHeight`, in px. */
+    maxHeight?: number | undefined;
+    /** `{included}` / `{total}` are substituted. Omit to hide the header count. */
+    countTemplate?: string | undefined;
+    piiLabel?: string | undefined;
+    highVolumeLabel?: string | undefined;
+    a11yLabel?: string | undefined;
+    /** Rendered in place of the rows when there are none (the caller's copy). */
+    emptyContent?: ReactNode | undefined;
+    locale?: string | undefined;
+    className?: string | undefined;
+    'data-testid'?: string | undefined;
+}
+export declare function TableInclusionChecklist({ tables, selected, onToggle, renderRowMeta, piiDetection, maxHeight, countTemplate, piiLabel, highVolumeLabel, a11yLabel, emptyContent, locale, className, 'data-testid': testId, }: TableInclusionChecklistProps): import("react").JSX.Element;
+/**
+ * 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 declare function TableInclusionChecklistWidget({ config, data, onEvent }: WidgetProps<TableInclusionChecklistConfig>): import("react").JSX.Element;
+//# sourceMappingURL=TableInclusionChecklist.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TableInclusionChecklist.d.ts","sourceRoot":"","sources":["../../../src/families/forms/TableInclusionChecklist.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,mCAAmC,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAIvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,mCAAmC,EAAE,+BAA+B,EAAE,CAAC;AAChF,YAAY,EAAE,6BAA6B,EAAE,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,6BAA6B,GAAG,cAAc,EAAE,CAmBxG;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,6BAA6B,EAAE,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAcrI;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,SAAS,CAAC,GAAG,SAAS,CAAC;IACnE,gCAAgC;IAChC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,wBAAgB,uBAAuB,CAAC,EACtC,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,YAAmB,EACnB,SAAS,EACT,aAAa,EACb,QAAgB,EAChB,eAA+B,EAC/B,SAAS,EACT,YAAY,EACZ,MAAM,EACN,SAAS,EACT,aAAa,EAAE,MAAM,GACtB,EAAE,4BAA4B,+BAuE9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,6BAA6B,CAAC,+BAgDlH"}