@appinternalleads/ui 0.2.0

package/dist/esm/widgets/02-03-Text.d.ts

@@ -0,0 +1,29 @@
+import type { Driven } from './driven';
+/**
+ * **02 · TextField** — `TEXT` → `string` + label + helper.
+ *
+ * 01 with the two things 01 leaves out. **The helper's height is reserved from first paint** —
+ * an error must never shift layout under a finger already moving toward the button. That is why
+ * the helper renders at `minHeight` even when it has nothing to say.
+ *
+ * Validation: on blur for a first entry, on every keystroke once already wrong, never on the
+ * first keystroke.
+ */
+export declare function TextFieldWidget({ value, onChange, prompt, onMenu, pill: pillLabel, title: cardTitle, label, hint, }: Driven & {
+    value?: string;
+    onChange?: (v: string) => void;
+}): import("react").JSX.Element;
+/**
+ * **03 · TextArea** — `TEXT` → multi-line `string`.
+ *
+ * **"Optional. Skipping is a valid answer."** is the footer copy, verbatim, and it is doing real
+ * work: every default is a working default, so a widget that only says what it wants and never
+ * that it can be left alone reads as required.
+ */
+export declare function TextAreaWidget({ value, onChange, limit, prompt, onMenu, pill: pillLabel, title: cardTitle, label, hint, }: Driven & {
+    value?: string;
+    onChange?: (v: string) => void;
+    limit?: number;
+}): import("react").JSX.Element;
+export declare const TEXTAREA_RADIUS: 14;
+//# sourceMappingURL=02-03-Text.d.ts.map

package/dist/esm/widgets/02-03-Text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"02-03-Text.d.ts","sourceRoot":"","sources":["../../../src/widgets/02-03-Text.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAOvC;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EACpC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,GAC/C,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3D,+BAwCA;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAU,EAAE,QAAQ,EAAE,KAAW,EAAE,MAAM,EAAE,MAAM,EACjD,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,GAC/C,EAAE,MAAM,GAAG;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC/D,+BA+CA;AAED,eAAO,MAAM,eAAe,IAAqB,CAAC"}

package/dist/esm/widgets/02-03-Text.js

@@ -0,0 +1,46 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Box, Text } from '../core';
+import { useDs } from '../tokens';
+import { WidgetCard } from './WidgetCard';
+import { WidgetInput } from './WidgetInput';
+import { widgetRadius } from './tokens';
+const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/**
+ * **02 · TextField** — `TEXT` → `string` + label + helper.
+ *
+ * 01 with the two things 01 leaves out. **The helper's height is reserved from first paint** —
+ * an error must never shift layout under a finger already moving toward the button. That is why
+ * the helper renders at `minHeight` even when it has nothing to say.
+ *
+ * Validation: on blur for a first entry, on every keystroke once already wrong, never on the
+ * first keystroke.
+ */
+export function TextFieldWidget({ value = '', onChange, prompt, onMenu, pill: pillLabel, title: cardTitle, label, hint, }) {
+    const [v, setV] = useState(value);
+    const [touched, setTouched] = useState(false);
+    const invalid = touched && v !== '' && !EMAIL.test(v);
+    return (_jsx(WidgetCard, { pill: pillLabel ?? 'TEXT', title: cardTitle ?? 'TextField', prompt: prompt ?? "Send the shortlist to my hiring manager when it's ready.", onMenu: onMenu, testID: "widget-02", children: _jsxs(Box, { style: { gap: 9 }, children: [label === '' ? null : (_jsx(Text, { style: { fontSize: 12.5, lineHeight: 12.5, fontWeight: '600' }, children: label ?? 'Manager email' })), _jsx(WidgetInput, { value: v, onChangeText: t => { setV(t); onChange?.(t); }, onBlur: () => setTouched(true), placeholder: "name@company.com", invalid: invalid, ariaLabel: label || cardTitle || 'Manager email', testID: "w02-input" }), _jsx(Box, { style: { minHeight: 17, justifyContent: 'center' }, children: _jsx(Text, { color: invalid ? 'status.error' : 'textSecondary', style: { fontSize: 12, lineHeight: 12 * 1.4 }, children: invalid
+                            ? 'That needs an @ and a domain.'
+                            : hint ?? 'They get a copy of the shortlist, nothing else.' }) })] }) }));
+}
+/**
+ * **03 · TextArea** — `TEXT` → multi-line `string`.
+ *
+ * **"Optional. Skipping is a valid answer."** is the footer copy, verbatim, and it is doing real
+ * work: every default is a working default, so a widget that only says what it wants and never
+ * that it can be left alone reads as required.
+ */
+export function TextAreaWidget({ value = '', onChange, limit = 400, prompt, onMenu, pill: pillLabel, title: cardTitle, label, hint, }) {
+    const { colors } = useDs();
+    const [v, setV] = useState(value);
+    const atLimit = v.length >= limit;
+    return (_jsx(WidgetCard, { pill: pillLabel ?? 'TEXT', title: cardTitle ?? 'TextArea', prompt: prompt ?? 'Draft the outreach note for the three I keep.', onMenu: onMenu, testID: "widget-03", children: _jsxs(Box, { style: { gap: 9 }, children: [label === '' ? null : (_jsx(Text, { style: { fontSize: 12.5, lineHeight: 12.5, fontWeight: '600' }, children: label ?? 'Anything the note must say' })), _jsx(WidgetInput, { value: v, onChangeText: t => { setV(t.slice(0, limit)); onChange?.(t.slice(0, limit)); }, placeholder: "Tone, deadline, links to include\u2026", multiline: true, minHeight: 92, ariaLabel: label || cardTitle || 'Anything the note must say', testID: "w03-input" }), _jsxs(Box, { row: true, align: "center", style: { gap: 11 }, children: [_jsx(Box, { flex: 1, children: _jsx(Text, { color: "textSecondary", style: { fontSize: 12, lineHeight: 12 * 1.4 }, children: hint ?? 'Optional. Skipping is a valid answer.' }) }), _jsx(Text, { mono: true, numeric: true, style: {
+                                fontSize: 11.5,
+                                lineHeight: 11.5,
+                                color: atLimit ? colors.accentInk : colors.textSecondary,
+                            }, children: `${v.length} / ${limit}` })] })] }) }));
+}
+export const TEXTAREA_RADIUS = widgetRadius.inset;
+//# sourceMappingURL=02-03-Text.js.map

package/dist/esm/widgets/02-03-Text.js.map

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

package/dist/esm/widgets/04-12-13-Choice.d.ts

@@ -0,0 +1,53 @@
+import { ListRowShell } from './parts';
+import { useSurface } from './useSurface';
+import { type Driven, type WidgetOptionEntry } from './driven';
+export declare const PIPELINES: string[];
+/**
+ * **04 · Dropdown** — `CHOICE` → `string` from a closed set.
+ *
+ * **Use past roughly eight options; below that use radio rows.** A menu that hides four items
+ * behind a tap is four items the user has to remember they can reach.
+ */
+export declare function DropdownWidget({ options, value, onChange, prompt, onMenu, pill: pillLabel, title: cardTitle, label, hint, }: Driven & {
+    options?: WidgetOptionEntry[];
+    value?: string;
+    onChange?: (v: string) => void;
+}): import("react").JSX.Element;
+export declare const SOURCES: string[];
+/**
+ * **12 · Radio Button** — `CHOICE` → single `string`.
+ *
+ * Two rules, and both are about not putting words in the user's mouth.
+ *
+ * **Nothing is pre-selected.** The run's guess may be shown, but pre-ticking it turns the ask
+ * into a confirmation and the user stops reading past the first row.
+ *
+ * **A required single-select carries "I don't know".** Forcing a choice from someone who has
+ * none produces a worse answer than admitting the gap, and the option renders muted until picked
+ * so it reads as an escape rather than a candidate.
+ */
+export declare function RadioWidget({ options, value, onChange, prompt, onMenu, pill: pillLabel, title: cardTitle, label, hint, }: Driven & {
+    options?: WidgetOptionEntry[];
+    value?: string;
+    onChange?: (v: string) => void;
+}): import("react").JSX.Element;
+export declare const CHANNELS: string[];
+/**
+ * **13 · Checkboxes** — `CHOICE` → `string[]`.
+ *
+ * **⚠ No equivalent in `question/1`.** `enum` is single-select and `list` is free entry, so an
+ * agent cannot currently ask for this at all. Either the schema grows a `multiple` flag or this
+ * widget is unreachable from JSON — recorded in `tasks/INPUT-WIDGETS.md`.
+ *
+ * At zero the counter states the consequence, not a count.
+ */
+export declare function CheckboxesWidget({ options, value, onChange, prompt, onMenu, counterText, counterEmpty, pill: pillLabel, title: cardTitle, label, hint, }: Driven & {
+    options?: WidgetOptionEntry[];
+    value?: string[];
+    onChange?: (v: string[]) => void;
+    /** `{n}` interpolates the count; `empty` states the consequence at zero. */
+    counterText?: string;
+    counterEmpty?: string;
+}): import("react").JSX.Element;
+export { ListRowShell, useSurface };
+//# sourceMappingURL=04-12-13-Choice.d.ts.map

package/dist/esm/widgets/04-12-13-Choice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"04-12-13-Choice.d.ts","sourceRoot":"","sources":["../../../src/widgets/04-12-13-Choice.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAe,YAAY,EAAE,MAAM,SAAS,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAkB,KAAK,MAAM,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG/E,eAAO,MAAM,SAAS,UAErB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAmB,EAAE,KAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EACzD,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,GAC/C,EAAE,MAAM,GAAG;IACV,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9E,+BAqFA;AAED,eAAO,MAAM,OAAO,UAEnB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAiB,EAAE,KAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EACvD,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,GAC/C,EAAE,MAAM,GAAG;IACV,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9E,+BAiEA;AAED,eAAO,MAAM,QAAQ,UAA0D,CAAC;AAEhF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,OAAkB,EAAE,KAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAC1F,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,GAC/C,EAAE,MAAM,GAAG;IACV,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAClF,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,+BA8DA;AAED,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/esm/widgets/04-12-13-Choice.js

@@ -0,0 +1,112 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Box, Icon, Pressable, Text } from '../core';
+import { useDs } from '../tokens';
+import { CounterLine, ListRowShell } from './parts';
+import { widget, widgetRadius } from './tokens';
+import { useSurface } from './useSurface';
+import { toWidgetOption } from './driven';
+import { WidgetCard } from './WidgetCard';
+export const PIPELINES = [
+    'Design hires — Q4', 'Growth team backfills', 'Contract pool', 'Talent bench (cold)',
+];
+/**
+ * **04 · Dropdown** — `CHOICE` → `string` from a closed set.
+ *
+ * **Use past roughly eight options; below that use radio rows.** A menu that hides four items
+ * behind a tap is four items the user has to remember they can reach.
+ */
+export function DropdownWidget({ options = PIPELINES, value = '', onChange, prompt, onMenu, pill: pillLabel, title: cardTitle, label, hint, }) {
+    const { colors } = useDs();
+    const opts = options.map(toWidgetOption);
+    const [open, setOpen] = useState(false);
+    const [v, setV] = useState(value);
+    return (_jsx(WidgetCard, { pill: pillLabel ?? 'CHOICE', title: cardTitle ?? 'Dropdown', prompt: prompt ?? 'Put the shortlist in one of my pipelines.', onMenu: onMenu, testID: "widget-04", children: _jsxs(Box, { style: { gap: 9 }, children: [label === '' ? null : (_jsx(Text, { style: { fontSize: 12.5, lineHeight: 12.5, fontWeight: '600' }, children: label ?? 'Pipeline' })), _jsxs(Pressable, { onPress: () => setOpen(o => !o), row: true, align: "center", justify: "space-between", px: "s4", "aria-label": label || cardTitle || 'Pipeline', minHeight: 46, style: {
+                        borderRadius: widgetRadius.inset,
+                        borderWidth: 1,
+                        borderColor: open ? colors.accentFill : colors.hairline,
+                        backgroundColor: colors.surface1,
+                    }, children: [_jsx(Box, { flex: 1, children: _jsx(Text, { numberOfLines: 1, color: v ? 'textPrimary' : 'textSecondary', style: { fontSize: 14.5, lineHeight: 14.5 }, children: opts.find(o => o.value === v)?.label || hint || 'Choose a pipeline' }) }), _jsx(Icon, { name: open ? 'chev-u' : 'chev-d', size: 13, color: colors.textSecondary })] }), open ? (_jsx(Box, { lift: 2, style: {
+                        borderRadius: widgetRadius.inset,
+                        borderWidth: 1,
+                        borderColor: colors.hairline,
+                        backgroundColor: colors.surface1,
+                        overflow: 'hidden',
+                    }, children: opts.map((o, i) => (_jsxs(Pressable, { onPress: () => { setV(o.value); onChange?.(o.value); setOpen(false); }, row: true, align: "center", justify: "space-between", px: "s4", py: "s3", "aria-label": o.label, minHeight: widget.hit, style: {
+                            borderTopWidth: i === 0 ? 0 : 1,
+                            borderTopColor: colors.hairline,
+                            backgroundColor: o.value === v ? colors.accentTint : undefined,
+                        }, children: [_jsx(Text, { color: o.value === v ? 'accentInk' : 'textPrimary', style: { fontSize: 14, lineHeight: 14 * 1.35 }, children: o.label }), o.value === v ? _jsx(Icon, { name: "tick", size: 12, color: colors.accentInk }) : null] }, o.value))) })) : null] }) }));
+}
+export const SOURCES = [
+    'Their portfolio site', 'LinkedIn profile', 'The CV they sent', "I don't know",
+];
+/**
+ * **12 · Radio Button** — `CHOICE` → single `string`.
+ *
+ * Two rules, and both are about not putting words in the user's mouth.
+ *
+ * **Nothing is pre-selected.** The run's guess may be shown, but pre-ticking it turns the ask
+ * into a confirmation and the user stops reading past the first row.
+ *
+ * **A required single-select carries "I don't know".** Forcing a choice from someone who has
+ * none produces a worse answer than admitting the gap, and the option renders muted until picked
+ * so it reads as an escape rather than a candidate.
+ */
+export function RadioWidget({ options = SOURCES, value = '', onChange, prompt, onMenu, pill: pillLabel, title: cardTitle, label, hint, }) {
+    const { colors } = useDs();
+    const opts = options.map(toWidgetOption);
+    const [v, setV] = useState(value);
+    return (_jsxs(WidgetCard, { pill: pillLabel ?? 'CHOICE', title: cardTitle ?? 'Radio Button', prompt: prompt ?? 'Which of these should I treat as the primary source?', onMenu: onMenu, rows: true, testID: "widget-12", children: [_jsx(Box, { children: opts.map((o, i) => {
+                    const on = o.value === v;
+                    /* The escape is a property now, not a sentence this file recognises — see
+                       `toWidgetOption`, which still honours the long-standing wording for bare strings. */
+                    const escape = o.escape === true;
+                    return (_jsxs(Pressable, { onPress: () => { setV(o.value); onChange?.(o.value); }, row: true, align: "center", justify: "flex-start", "aria-label": o.label, style: {
+                            minHeight: 54,
+                            paddingVertical: 11,
+                            paddingHorizontal: 2,
+                            gap: 11,
+                            borderTopWidth: i === 0 ? 0 : 1,
+                            borderTopColor: colors.hairline,
+                        }, children: [_jsx(Box, { width: 20, height: 20, radius: "pill", align: "center", justify: "center", style: { borderWidth: 2, borderColor: on ? colors.accentFill : colors.hairline }, children: on ? (_jsx(Box, { width: 9, height: 9, radius: "pill", style: { backgroundColor: colors.accentFill } })) : null }), _jsxs(Box, { flex: 1, style: { gap: 3 }, children: [_jsx(Text, { color: escape && !on ? 'textSecondary' : 'textPrimary', style: { fontSize: 14, lineHeight: 14 * 1.35, fontWeight: on ? '600' : '400' }, children: o.label }), o.note ? (_jsx(Text, { color: "textSecondary", style: { fontSize: 12, lineHeight: 12 * 1.4 }, children: o.note })) : null] })] }, o.value));
+                }) }), _jsx(CounterLine, { children: v ? 'Answered · editable' : 'Nothing pre-selected' })] }));
+}
+export const CHANNELS = ['Email', 'LinkedIn message', 'WhatsApp', 'Phone call'];
+/**
+ * **13 · Checkboxes** — `CHOICE` → `string[]`.
+ *
+ * **⚠ No equivalent in `question/1`.** `enum` is single-select and `list` is free entry, so an
+ * agent cannot currently ask for this at all. Either the schema grows a `multiple` flag or this
+ * widget is unreachable from JSON — recorded in `tasks/INPUT-WIDGETS.md`.
+ *
+ * At zero the counter states the consequence, not a count.
+ */
+export function CheckboxesWidget({ options = CHANNELS, value = ['Email'], onChange, prompt, onMenu, counterText, counterEmpty, pill: pillLabel, title: cardTitle, label, hint, }) {
+    const { colors } = useDs();
+    const opts = options.map(toWidgetOption);
+    const [on, setOn] = useState(value);
+    const toggle = (o) => {
+        const next = on.includes(o) ? on.filter(x => x !== o) : [...on, o];
+        setOn(next);
+        onChange?.(next);
+    };
+    return (_jsxs(WidgetCard, { pill: pillLabel ?? 'CHOICE', title: cardTitle ?? 'Checkboxes', prompt: prompt ?? 'Include whichever channels make sense.', onMenu: onMenu, rows: true, testID: "widget-13", children: [_jsx(Box, { children: opts.map((o, i) => {
+                    const checked = on.includes(o.value);
+                    return (_jsxs(Pressable, { onPress: () => toggle(o.value), row: true, align: "center", justify: "flex-start", "aria-label": o.label, style: {
+                            minHeight: 54, paddingVertical: 11, paddingHorizontal: 2, gap: 11,
+                            borderTopWidth: i === 0 ? 0 : 1,
+                            borderTopColor: colors.hairline,
+                        }, children: [_jsx(Box, { width: 21, height: 21, align: "center", justify: "center", style: {
+                                    borderRadius: widgetRadius.checkbox,
+                                    borderWidth: 2,
+                                    borderColor: checked ? colors.accentFill : colors.hairline,
+                                    backgroundColor: checked ? colors.accentFill : 'transparent',
+                                }, children: checked ? _jsx(Icon, { name: "tick", size: 11, color: colors.accentOnFill }) : null }), _jsx(Text, { style: { fontSize: 14, lineHeight: 14 * 1.35, fontWeight: checked ? '600' : '400' }, children: o.label })] }, o.value));
+                }) }), _jsx(CounterLine, { children: on.length === 0
+                    ? counterEmpty ?? 'No channels — outreach will not send'
+                    : (counterText ?? `{n} of ${options.length} channels on`).replace('{n}', String(on.length)) })] }));
+}
+export { ListRowShell, useSurface };
+//# sourceMappingURL=04-12-13-Choice.js.map

package/dist/esm/widgets/04-12-13-Choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"04-12-13-Choice.js","sourceRoot":"","sources":["../../../src/widgets/04-12-13-Choice.tsx"],"names":[],"mappings":"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"}

package/dist/esm/widgets/05-06-Action.d.ts

@@ -0,0 +1,59 @@
+import type { Driven } from './driven';
+/**
+ * **05 · Button** — `ACTION` → `void`, and firing it is the answer.
+ *
+ * Two things carry the weight here, and neither is the button.
+ *
+ * **The consequence sentence** says what pressing does and that nothing has happened yet. A row
+ * of verbs with no sentence above it asks the user to guess the blast radius.
+ *
+ * **The label carries the count, and the count matches what is visible.** `Send 3 emails` beside
+ * a list of three; after the press the same control states the outcome — `Sent to 3 people` —
+ * rather than reverting to a verb that now describes something already done.
+ */
+export declare function ButtonWidget({ count, onConfirm, onDismiss, prompt, onMenu, consequence, confirmLabel, doneLabel, dismissLabel, pill: pillLabel, title: cardTitle, label, hint, }: Driven & {
+    count?: number;
+    onConfirm?: () => void;
+    onDismiss?: () => void;
+    /** What pressing does, and that nothing has happened yet. Never omitted in a real ask. */
+    consequence?: string;
+    /** `{n}` interpolates the count — the label carries it, and it matches what is visible. */
+    confirmLabel?: string;
+    doneLabel?: string;
+    dismissLabel?: string;
+}): import("react").JSX.Element;
+export type BlockingOption = {
+    key: string;
+    label: string;
+    sub: string;
+};
+export declare const DUPLICATE_OPTIONS: BlockingOption[];
+/**
+ * **06 · Container** — `BLOCKING` → `accept · reject · cancel`. The widget that halts a run.
+ *
+ * Three rules, and all three are about honesty over time.
+ *
+ * **Blocked and offered never look alike.** Blocking takes the accent ring and the run visibly
+ * stops above it; a suggestion sits inline while the run keeps going. If a user cannot tell
+ * which one they are looking at, they cannot tell whether ignoring it costs anything.
+ *
+ * **An answered ask collapses** — into one row carrying the answer and a way back in, never into
+ * nothing. A question that vanishes on answer leaves no record of what was agreed.
+ *
+ * **The answer stays editable, and editing marks it superseded** (`nextState('answered', 'edit')`
+ * → `superseded`), because the run re-plans from that point rather than pretending the first
+ * answer never happened.
+ */
+export declare function ContainerWidget({ options, answered: answered0, onSubmit, prompt, onMenu, reason, question, submitLabel, pill: pillLabel, title: cardTitle, label, hint, }: Driven & {
+    options?: BlockingOption[];
+    answered?: boolean;
+    onSubmit?: (key: string) => void;
+    /**
+     * **Why the run stopped.** `question` is what is being asked; this is what went wrong. A halt
+     * with no stated cause reads as a bug rather than as a decision waiting on the user.
+     */
+    reason?: string;
+    question?: string;
+    submitLabel?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=05-06-Action.d.ts.map

package/dist/esm/widgets/05-06-Action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"05-06-Action.d.ts","sourceRoot":"","sources":["../../../src/widgets/05-06-Action.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAC/C,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAClD,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,GAC/C,EAAE,MAAM,GAAG;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/D,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,+BAsDA;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAG7C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAA2B,EAAE,QAAQ,EAAE,SAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAClF,MAAM,EAAE,QAAQ,EAAE,WAAW,EAC7B,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,GAC/C,EAAE,MAAM,GAAG;IACV,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,+BAoIA"}

package/dist/esm/widgets/05-06-Action.js

@@ -0,0 +1,87 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Box, Icon, Pressable, Text } from '../core';
+import { useDs } from '../tokens';
+import { widget, widgetRadius } from './tokens';
+import { useSurface } from './useSurface';
+import { WidgetCard } from './WidgetCard';
+/**
+ * **05 · Button** — `ACTION` → `void`, and firing it is the answer.
+ *
+ * Two things carry the weight here, and neither is the button.
+ *
+ * **The consequence sentence** says what pressing does and that nothing has happened yet. A row
+ * of verbs with no sentence above it asks the user to guess the blast radius.
+ *
+ * **The label carries the count, and the count matches what is visible.** `Send 3 emails` beside
+ * a list of three; after the press the same control states the outcome — `Sent to 3 people` —
+ * rather than reverting to a verb that now describes something already done.
+ */
+export function ButtonWidget({ count = 3, onConfirm, onDismiss, prompt, onMenu, consequence, confirmLabel, doneLabel, dismissLabel, pill: pillLabel, title: cardTitle, label, hint, }) {
+    const { colors } = useDs();
+    const [sent, setSent] = useState(false);
+    /* `{n}` is the count, and it is interpolated rather than concatenated so a label can put it
+       anywhere in the sentence — `Send {n} emails`, `Interview {n}`, `Archive all {n}`. */
+    const fill = (t) => t.replace('{n}', String(count));
+    const confirm = fill(confirmLabel ?? 'Send {n} emails');
+    const done = fill(doneLabel ?? 'Sent to {n} people');
+    return (_jsx(WidgetCard, { pill: pillLabel ?? 'ACTION', title: cardTitle ?? 'Button', prompt: prompt ?? 'Go ahead and reach out to all three.', onMenu: onMenu, testID: "widget-05", children: _jsxs(Box, { style: { gap: 12 }, children: [_jsx(Text, { color: "textSecondary", style: { fontSize: 13.5, lineHeight: 13.5 * 1.5 }, children: consequence
+                        ?? `${count === 3 ? 'Three' : count} outreach emails, sent from your connected `
+                            + 'mailbox. Nothing is sent until you press.' }), _jsxs(Box, { row: true, wrap: true, style: { gap: 9 }, children: [_jsx(Pressable, { onPress: () => { setSent(true); onConfirm?.(); }, radius: "pill", minHeight: 46, "aria-label": sent ? done : confirm, style: {
+                                paddingHorizontal: 20,
+                                backgroundColor: colors.accentFill,
+                                boxShadow: `0 6px 18px -10px ${colors.accentFill}`,
+                            }, children: _jsx(Text, { style: {
+                                    fontSize: 14.5, lineHeight: 14.5, fontWeight: '600', color: colors.accentOnFill,
+                                }, children: sent ? done : confirm }) }), _jsx(Pressable, { onPress: onDismiss, radius: "pill", minHeight: 46, "aria-label": dismissLabel ?? 'Not now', style: { paddingHorizontal: 18, borderWidth: 1, borderColor: colors.hairlineStrong }, children: _jsx(Text, { style: { fontSize: 14.5, lineHeight: 14.5, fontWeight: '600' }, children: dismissLabel ?? 'Not now' }) })] })] }) }));
+}
+export const DUPLICATE_OPTIONS = [
+    { key: 'maya', label: 'Maya Idris', sub: 'Portfolio updated 3 weeks ago · 14 shipped cases' },
+    { key: 'dup', label: 'M. Idris (dup)', sub: 'Same link, no case studies, dormant since 2023' },
+];
+/**
+ * **06 · Container** — `BLOCKING` → `accept · reject · cancel`. The widget that halts a run.
+ *
+ * Three rules, and all three are about honesty over time.
+ *
+ * **Blocked and offered never look alike.** Blocking takes the accent ring and the run visibly
+ * stops above it; a suggestion sits inline while the run keeps going. If a user cannot tell
+ * which one they are looking at, they cannot tell whether ignoring it costs anything.
+ *
+ * **An answered ask collapses** — into one row carrying the answer and a way back in, never into
+ * nothing. A question that vanishes on answer leaves no record of what was agreed.
+ *
+ * **The answer stays editable, and editing marks it superseded** (`nextState('answered', 'edit')`
+ * → `superseded`), because the run re-plans from that point rather than pretending the first
+ * answer never happened.
+ */
+export function ContainerWidget({ options = DUPLICATE_OPTIONS, answered: answered0 = false, onSubmit, prompt, onMenu, reason, question, submitLabel, pill: pillLabel, title: cardTitle, label, hint, }) {
+    const { colors } = useDs();
+    const surface = useSurface();
+    const [answered, setAnswered] = useState(answered0);
+    const [pick, setPick] = useState(undefined);
+    const chosen = options.find(o => o.key === pick);
+    if (answered) {
+        return (_jsx(WidgetCard, { pill: pillLabel ?? 'BLOCKING', title: cardTitle ?? 'Container', prompt: prompt ?? 'Run the whole thing end to end.', onMenu: onMenu, testID: "widget-06", children: _jsxs(Pressable, { onPress: () => setAnswered(false), row: true, align: "center", "aria-label": `Answered: ${chosen?.label ?? 'answered'}. Edit`, style: { gap: 11, paddingVertical: 14, paddingHorizontal: 15, marginVertical: -15, marginHorizontal: -15 }, children: [_jsx(Box, { width: 22, height: 22, radius: "pill", align: "center", justify: "center", style: { backgroundColor: colors.status.executed }, children: _jsx(Icon, { name: "tick", size: 11, color: colors.accentOnFill }) }), _jsx(Box, { flex: 1, children: _jsx(Text, { numberOfLines: 1, style: { fontSize: 13.5, lineHeight: 13.5 * 1.35 }, children: chosen?.label ?? 'Answered' }) }), _jsx(Icon, { name: "edit", size: 13, color: colors.textSecondary, label: "Edit" })] }) }));
+    }
+    return (_jsx(WidgetCard, { pill: pillLabel ?? 'BLOCKING', title: cardTitle ?? 'Container', prompt: prompt ?? 'Run the whole thing end to end.', onMenu: onMenu, blocked: true, testID: "widget-06", children: _jsxs(Box, { style: { gap: 12 }, children: [_jsxs(Box, { row: true, style: {
+                        gap: 8,
+                        paddingVertical: 12,
+                        paddingHorizontal: 13,
+                        borderRadius: widgetRadius.inset,
+                        backgroundColor: colors.accentTint,
+                    }, children: [_jsx(Box, { style: { paddingTop: 2 }, children: _jsx(Icon, { name: "spark", size: 13, color: colors.accentInk }) }), _jsx(Box, { flex: 1, children: _jsx(Text, { style: { fontSize: 13, lineHeight: 13 * 1.5 }, children: reason
+                                    ?? "The run has stopped here. Two candidates share the same portfolio link, so "
+                                        + "I can't tell them apart." }) })] }), _jsx(Text, { style: { fontSize: 12.5, lineHeight: 12.5, fontWeight: '600' }, children: question ?? label ?? 'Which one is the real profile?' }), _jsx(Box, { children: options.map((o, i) => {
+                        const on = o.key === pick;
+                        return (_jsxs(Pressable, { onPress: () => setPick(o.key), row: true, align: "center", justify: "flex-start", "aria-label": `${o.label}. ${o.sub}`, minHeight: 52, style: {
+                                paddingVertical: 11, paddingHorizontal: 2, gap: 11,
+                                borderTopWidth: i === 0 ? 0 : 1, borderTopColor: colors.hairline,
+                            }, children: [_jsx(Box, { width: 20, height: 20, radius: "pill", align: "center", justify: "center", style: { borderWidth: 2, borderColor: on ? colors.accentFill : colors.hairlineStrong }, children: on ? (_jsx(Box, { width: 9, height: 9, radius: "pill", style: { backgroundColor: colors.accentFill } })) : null }), _jsxs(Box, { flex: 1, style: { gap: 3 }, children: [_jsx(Text, { style: { fontSize: 14, lineHeight: 14 * 1.35, fontWeight: on ? '600' : '400' }, children: o.label }), _jsx(Text, { color: "textSecondary", style: { fontSize: 12, lineHeight: 12 * 1.4 }, children: o.sub })] })] }, o.key));
+                    }) }), _jsx(Pressable, { onPress: () => { if (pick) {
+                        setAnswered(true);
+                        onSubmit?.(pick);
+                    } }, radius: "pill", minHeight: widget.submit.height[surface], "aria-label": submitLabel ?? 'Continue the run', style: { alignSelf: 'stretch', backgroundColor: colors.accentFill }, children: _jsx(Text, { style: { fontSize: 14.5, lineHeight: 14.5, fontWeight: '600', color: colors.accentOnFill }, children: submitLabel ?? 'Continue the run' }) })] }) }));
+}
+//# sourceMappingURL=05-06-Action.js.map

package/dist/esm/widgets/05-06-Action.js.map

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

package/dist/esm/widgets/07-FileUpload.d.ts

@@ -0,0 +1,68 @@
+import type { Driven } from './driven';
+import { type FileUploadConfig, type SelectableFile, type UploadOperations } from './fileUploadEngine';
+export { useFileUploadEngine, validateFile, createMockUploadOperations, DEFAULT_FILE_UPLOAD_CONFIG, type FileUploadConfig, type FileItem, type FileItemState, type SelectableFile, type UploadOperations, type UploadResult, type UploadProgressEvent, } from './fileUploadEngine';
+/**
+ * **07 · File Upload** — `FILES` → `FileRef[]` · hue `sky` · **eight states, four of them
+ * failure.**
+ *
+ * > *"The only widget where the user hands over something irreversible at the moment they cannot
+ * > see whether it worked."*
+ *
+ * Two rules from `WIDGET-FLOWS-HANDOFF.md` §3.1 shape everything here:
+ *
+ * **Every state keeps the remove.** A file you cannot remove is a file the user abandons the
+ * whole run over.
+ *
+ * **Silent skipping is the risk.** If 3 of 47 fail and the run carries on, the user believes they
+ * shortlisted 47 people. **Name, count, and offer the retry in one breath** — which is why the
+ * batch summary is a state rather than a toast.
+ *
+ * **Two modes, not one rewritten in place — both real, neither a stand-in for the other:**
+ *
+ * 1. **Driven/controlled** (`files` prop, no `operations`) — unchanged from the original build.
+ *    A host that already owns the whole state machine (e.g. a `question/1`-driven replay, see
+ *    `fromSpec.tsx`) still just hands this widget a `FileRef[]` to draw. Pure render, as before.
+ * 2. **Engine-driven** (`operations` prop present) — this widget now owns validation, the
+ *    upload lifecycle, retry, cancel and race-safety itself, via `fileUploadEngine.ts`.
+ *    **Picking is still the host's job** (`onPick`, a native module or `<input type=file>`);
+ *    everything from "a file was picked" onward is this component's — validation, the upload
+ *    lifecycle, retry, cancel and race-safety, previously all host-owned across this widget family.
+ *
+ * Deliberately **not** built here: the much larger "Upload → Processing → Executing → Result"
+ * agent-run pipeline (parsing, scoring, drafting, a decision deck, backgrounding) documented in
+ * the same source bundle's `Upload Flow.dc.html` — that is a separate, app-level run/canvas
+ * system, not a file-upload component concern.
+ */
+export type FileState = 'selected' | 'uploading' | 'uploaded' | 'too-large' | 'wrong-type' | 'failed';
+export type FileRef = {
+    n: string;
+    /** Already formatted — `42 KB`. The widget does not own byte formatting. */
+    s: string;
+    ext: string;
+    state?: FileState;
+    /** 0–1. **Held, not reset, on failure** — retry resumes from where it stopped. */
+    progress?: number;
+};
+export declare const FILE_FIXTURES: FileRef[];
+export type FileUploadWidgetProps = Driven & {
+    files?: FileRef[];
+    max?: number;
+    onAdd?: () => void;
+    onRemove?: (name: string) => void;
+    onRetry?: (name: string) => void;
+    /** State 2 — the user confirms what was named back to them. */
+    onConfirm?: () => void;
+    onCancel?: () => void;
+    /** The replaceable data-operation boundary (upload). Presence of this prop is what switches
+        the widget from driven/controlled to owning its own lifecycle. */
+    operations?: UploadOperations;
+    /** Validation config (accept/maxSizeBytes/maxFiles). Defaults to the source's own defaults
+        (PDF/DOCX, 10 MB, 10 files) when `operations` is supplied and this is omitted. */
+    config?: FileUploadConfig;
+    /** The host's own picker (native module or `<input type=file>`) — "picking is the host's
+        job" is unchanged; this is the seam. Called when Add is pressed; its resolved files are
+        validated and queued by this widget. */
+    onPick?: () => Promise<SelectableFile[]>;
+};
+export declare function FileUploadWidget(props: FileUploadWidgetProps): import("react").JSX.Element;
+//# sourceMappingURL=07-FileUpload.d.ts.map

package/dist/esm/widgets/07-FileUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"07-FileUpload.d.ts","sourceRoot":"","sources":["../../../src/widgets/07-FileUpload.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAEL,KAAK,gBAAgB,EAAqC,KAAK,cAAc,EAC7E,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,mBAAmB,EAAE,YAAY,EAAE,0BAA0B,EAAE,0BAA0B,EACzF,KAAK,gBAAgB,EAAE,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAC7E,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,GACnE,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,WAAW,GACX,UAAU,GACV,WAAW,GACX,YAAY,GACZ,QAAQ,CAAC;AAEb,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,4EAA4E;IAC5E,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAAO,EAGlC,CAAC;AAiDF,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG;IAE3C,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAGtB;yEACqE;IACrE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;yFACqF;IACrF,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B;;+CAE2C;IAC3C,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC1C,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,+BAiC5D"}