@appinternalleads/ui 0.2.0

package/dist/cjs/fields/NumberField.js

@@ -0,0 +1,55 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NumberField = NumberField;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const core_1 = require("../core");
+const tokens_1 = require("../tokens");
+const FieldShell_1 = require("./FieldShell");
+const control_1 = require("./control");
+const clamp = (n, min, max) => Math.min(max ?? Number.POSITIVE_INFINITY, Math.max(min ?? Number.NEGATIVE_INFINITY, n));
+/**
+ * **Module scope, and that is a correctness requirement rather than a style preference.**
+ *
+ * Defined inside `NumberField` this is a NEW component type on every render, so React unmounts
+ * and remounts the `Pressable` whenever any state changes. In a browser that swallowed the first
+ * press after focus left a text field: blurring re-rendered the parent, the button was replaced
+ * mid-gesture, and the press landed on an element that no longer existed. The second press
+ * worked, which is what made it look like a flake.
+ *
+ * The unit tests never caught it because they pressed the stepper without a preceding focus
+ * change — there was no re-render between mount and press.
+ *
+ * A control at its bound is disabled, not hidden. A button that vanishes at the limit moves the
+ * one beside it under the thumb already reaching for it.
+ */
+function Step({ dir, disabled, label, onPress, }) {
+    const { colors } = (0, tokens_1.useDs)();
+    return ((0, jsx_runtime_1.jsx)(core_1.Pressable, { onPress: onPress, disabled: disabled, hit: 44, radius: "control", "aria-label": `${dir === 1 ? 'Increase' : 'Decrease'} ${label}`, children: (0, jsx_runtime_1.jsx)(core_1.Icon, { name: dir === 1 ? 'plus' : 'minus', size: 16, color: disabled ? colors.textDisabled : colors.textPrimary }) }));
+}
+/**
+ * `number`, in the `stepper` and `single` controls.
+ *
+ * **The value is set in the sans face, not mono.** The rule is *a number a human typed is
+ * Switzer; a number the system computed is mono* — a stepper's value is the user's own answer,
+ * so it is prose about a quantity rather than a machine reading. Mono here would make an input
+ * look like output. It is `numeric` all the same, so the field does not twitch as the value
+ * crosses a digit width.
+ */
+function NumberField({ field, value, onChange, error, onBlur, }) {
+    const { min, max, step = 1 } = field.constraints ?? {};
+    const control = (0, control_1.controlOf)(field);
+    const current = value ?? field.default ?? min ?? 0;
+    if (control === 'slider') {
+        /* A slider without bounds is a scrollbar for an unknown range. `min`/`max` default only so
+           the control still draws while a spec is being written; a real one declares both. */
+        return ((0, jsx_runtime_1.jsx)(FieldShell_1.FieldShell, { field: field, error: error, children: (0, jsx_runtime_1.jsxs)(core_1.Box, { row: true, align: "center", gap: "s3", children: [(0, jsx_runtime_1.jsx)(core_1.Slider, { value: current, onChange: onChange, min: min ?? 0, max: max ?? 100, step: step, "aria-label": field.label, testID: `${field.key}-slider` }), (0, jsx_runtime_1.jsx)(core_1.Text, { numeric: true, color: "textSecondary", children: current })] }) }));
+    }
+    if (control !== 'stepper') {
+        return ((0, jsx_runtime_1.jsx)(FieldShell_1.FieldShell, { field: field, error: error, children: (0, jsx_runtime_1.jsx)(core_1.Input, { value: value === undefined ? '' : String(value), onChangeText: t => onChange(t === '' ? undefined : Number(t)), onBlur: onBlur, placeholder: field.example, numeric: true, error: Boolean(error), "aria-required": field.required, "aria-invalid": Boolean(error), "aria-labelledby": `${field.key}-label` }) }));
+    }
+    const atMin = min !== undefined && current <= min;
+    const atMax = max !== undefined && current >= max;
+    return ((0, jsx_runtime_1.jsx)(FieldShell_1.FieldShell, { field: field, error: error, children: (0, jsx_runtime_1.jsxs)(core_1.Box, { row: true, align: "center", justify: "space-between", px: "s1", radius: "field", bg: "surface1", edge: error ? 'fieldError' : 'field', children: [(0, jsx_runtime_1.jsx)(Step, { dir: -1, disabled: atMin, label: field.label, onPress: () => onChange(clamp(current - step, min, max)) }), (0, jsx_runtime_1.jsx)(core_1.Text, { numeric: true, "aria-labelledby": `${field.key}-label`, children: current }), (0, jsx_runtime_1.jsx)(Step, { dir: 1, disabled: atMax, label: field.label, onPress: () => onChange(clamp(current + step, min, max)) })] }) }));
+}
+//# sourceMappingURL=NumberField.js.map

package/dist/cjs/fields/NumberField.js.map

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

package/dist/cjs/fields/QuestionBlock.js

@@ -0,0 +1,76 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuestionBlock = QuestionBlock;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const core_1 = require("../core");
+const FieldRenderer_1 = require("./FieldRenderer");
+const control_1 = require("./control");
+/**
+ * Renders one question block from its JSON.
+ *
+ * **Errors surface on blur, not on keystroke.** Validating as someone types tells them their
+ * half-written email address is invalid, which they already know; the field they have left is
+ * the first moment the answer is a claim rather than a work in progress. Once a field has
+ * errored it revalidates live, because at that point the user is fixing something and silence
+ * until the next blur would hide the fix.
+ */
+function QuestionBlock({ block, answers, onChange, errors: hostErrors, options, }) {
+    const [own, setOwn] = (0, react_1.useState)(() => (0, control_1.initialAnswers)(block));
+    const [blurred, setBlurred] = (0, react_1.useState)({});
+    const current = answers ?? own;
+    /**
+     * ⚠ **The freshest answers, for a blur that arrives in the same tick as its own change.**
+     *
+     * `DatePicker` commits by calling `onChange(next)` and then `onBlur()` synchronously — correctly,
+     * because a picker has no blur of its own and the value IS the discrete choice. But `blur` closes
+     * over `current`, which React has not updated yet, so it validated the value the field held
+     * BEFORE the pick and wrote "required" onto a field that had just been filled.
+     *
+     * Measured 2026-09-07 on a device: picking 15 September put `2026-09-15T11:30` in the field, the
+     * counter moved to "2 filled in", and the field showed a red ring reading *"Date and Time is
+     * required."* — the two halves of the same component disagreeing about whether it had an answer.
+     *
+     * A ref rather than reordering the two calls, because the ordering is the picker's business and
+     * every other control that ever commits-then-blurs would hit this the same way.
+     */
+    const latest = (0, react_1.useRef)(current);
+    latest.current = current;
+    const errors = (0, react_1.useMemo)(() => ({ ...blurred, ...hostErrors }), [blurred, hostErrors]);
+    const visible = (0, react_1.useMemo)(() => block.fields.filter(f => (0, control_1.isVisible)(f, current)), [block, current]);
+    const set = (0, react_1.useCallback)((field, value) => {
+        const next = { ...current, [field.key]: value };
+        /* Before any state update, so a blur firing later in this same tick sees the new value. */
+        latest.current = next;
+        if (answers === undefined)
+            setOwn(next);
+        onChange?.(next);
+        setBlurred(prev => {
+            if (!prev[field.key])
+                return prev;
+            const e = (0, control_1.validateField)(field, value, options?.[field.key]);
+            const { [field.key]: _drop, ...rest } = prev;
+            return e ? { ...rest, [field.key]: e } : rest;
+        });
+    }, [answers, current, onChange, options]);
+    const blur = (0, react_1.useCallback)((field) => {
+        const e = (0, control_1.validateField)(field, latest.current[field.key], options?.[field.key]);
+        setBlurred(prev => {
+            if (!e) {
+                const { [field.key]: _drop, ...rest } = prev;
+                return rest;
+            }
+            return { ...prev, [field.key]: e };
+        });
+    }, [options]);
+    return ((0, jsx_runtime_1.jsxs)(core_1.Box, { gap: "s5", role: "form", testID: `question-${block.slug}`, children: [(0, jsx_runtime_1.jsxs)(core_1.Box, { gap: "s1", children: [block.step ? ((0, jsx_runtime_1.jsx)(core_1.Text, { variant: "eyebrow", color: "textTertiary", uppercase: true, children: `Step ${block.step.index} · ${block.step.label}` })) : null, (0, jsx_runtime_1.jsx)(core_1.Text, { variant: "heading", role: "heading", children: block.question })] }), (0, jsx_runtime_1.jsx)(core_1.Box, { gap: "s4", children: visible.map(field => ((0, jsx_runtime_1.jsx)(FieldRenderer_1.FieldRenderer, { field: field, path: field.key, value: current[field.key], onChange: v => set(field, v), onBlur: () => blur(field), errors: errors, options: options }, field.key))) })] }));
+}
+/**
+ * Every error in the block, for a host driving submission from its own button.
+ *
+ * Attached to the component rather than only exported loose so a host that has the component
+ * already does not have to find a second import to validate what it is rendering.
+ */
+QuestionBlock.validate = control_1.validateBlock;
+//# sourceMappingURL=QuestionBlock.js.map

package/dist/cjs/fields/QuestionBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuestionBlock.js","sourceRoot":"","sources":["../../../src/fields/QuestionBlock.tsx"],"names":[],"mappings":";;AAwCA,sCAuFC;;AA/HD,iCAA+D;AAC/D,kCAAoC;AACpC,mDAAgD;AAChD,uCAAoF;AA4BpF;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,EAC5B,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAClC;IACnB,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,IAAA,gBAAQ,EAAU,GAAG,EAAE,CAAC,IAAA,wBAAc,EAAC,KAAK,CAAC,CAAC,CAAC;IACrE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAc,EAAE,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG,OAAO,IAAI,GAAG,CAAC;IAC/B;;;;;;;;;;;;;;OAcG;IACH,MAAM,MAAM,GAAG,IAAA,cAAM,EAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,MAAM,MAAM,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAA,mBAAS,EAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAEjG,MAAM,GAAG,GAAG,IAAA,mBAAW,EACrB,CAAC,KAAgB,EAAE,KAAc,EAAE,EAAE;QACnC,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;QAChD,2FAA2F;QAC3F,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;QACjB,UAAU,CAAC,IAAI,CAAC,EAAE;YAChB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YAClC,MAAM,CAAC,GAAG,IAAA,uBAAa,EAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5D,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;YAC7C,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,EACD,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CACtC,CAAC;IAEF,MAAM,IAAI,GAAG,IAAA,mBAAW,EACtB,CAAC,KAAgB,EAAE,EAAE;QACnB,MAAM,CAAC,GAAG,IAAA,uBAAa,EAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAChF,UAAU,CAAC,IAAI,CAAC,EAAE;YAChB,IAAI,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;gBAC7C,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,CACL,wBAAC,UAAG,IAAC,GAAG,EAAC,IAAI,EAAC,IAAI,EAAC,MAAM,EAAC,MAAM,EAAE,YAAY,KAAK,CAAC,IAAI,EAAE,aACxD,wBAAC,UAAG,IAAC,GAAG,EAAC,IAAI,aACV,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CACZ,uBAAC,WAAI,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAC,cAAc,EAAC,SAAS,kBACnD,QAAQ,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAC5C,CACR,CAAC,CAAC,CAAC,IAAI,EACR,uBAAC,WAAI,IAAC,OAAO,EAAC,SAAS,EAAC,IAAI,EAAC,SAAS,YACnC,KAAK,CAAC,QAAQ,GACV,IACH,EAEN,uBAAC,UAAG,IAAC,GAAG,EAAC,IAAI,YACV,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CACpB,uBAAC,6BAAa,IAEZ,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,KAAK,CAAC,GAAG,EACf,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EACzB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAC5B,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,IAPX,KAAK,CAAC,GAAG,CAQd,CACH,CAAC,GACE,IACF,CACP,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,aAAa,CAAC,QAAQ,GAAG,uBAAa,CAAC"}

package/dist/cjs/fields/TextInputField.js

@@ -0,0 +1,23 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextInputField = TextInputField;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const core_1 = require("../core");
+const tokens_1 = require("../tokens");
+const FieldShell_1 = require("./FieldShell");
+const control_1 = require("./control");
+/**
+ * `text` and `email`, in both controls.
+ *
+ * The well, its three hairline states and Android's M3 treatment all live in `Input` — this
+ * file decides only which of them apply, which is the whole reason the primitive layer exists.
+ */
+function TextInputField({ field, value, onChange, error, onBlur, }) {
+    const multi = (0, control_1.controlOf)(field) === 'multi';
+    return ((0, jsx_runtime_1.jsx)(FieldShell_1.FieldShell, { field: field, error: error, children: (0, jsx_runtime_1.jsx)(core_1.Input, { value: value ?? '', onChangeText: onChange, onBlur: onBlur, placeholder: field.example, multiline: multi, maxLength: field.constraints?.maxLength, email: field.type === 'email', error: Boolean(error), 
+            /* Four lines of room. A textarea that starts at one line and grows hides how much the
+               field expects; one that starts tall says "a paragraph". */
+            minHeight: multi ? tokens_1.space.s14 * 2 : undefined, "aria-required": field.required, "aria-invalid": Boolean(error), "aria-labelledby": `${field.key}-label`, "aria-describedby": error ? `${field.key}-error` : field.hint ? `${field.key}-hint` : undefined }) }));
+}
+//# sourceMappingURL=TextInputField.js.map

package/dist/cjs/fields/TextInputField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextInputField.js","sourceRoot":"","sources":["../../../src/fields/TextInputField.tsx"],"names":[],"mappings":";;AAYA,wCAsCC;;AAlDD,kCAAgC;AAChC,sCAAkC;AAClC,6CAA0C;AAC1C,uCAAsC;AAGtC;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,KAAK,EACL,QAAQ,EACR,KAAK,EACL,MAAM,GAOP;IACC,MAAM,KAAK,GAAG,IAAA,mBAAS,EAAC,KAAK,CAAC,KAAK,OAAO,CAAC;IAE3C,OAAO,CACL,uBAAC,uBAAU,IAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YACpC,uBAAC,YAAK,IACJ,KAAK,EAAE,KAAK,IAAI,EAAE,EAClB,YAAY,EAAE,QAAQ,EACtB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,KAAK,CAAC,OAAO,EAC1B,SAAS,EAAE,KAAK,EAChB,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE,SAAS,EACvC,KAAK,EAAE,KAAK,CAAC,IAAI,KAAK,OAAO,EAC7B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;YACrB;yEAC6D;YAC7D,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,cAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,mBAC7B,KAAK,CAAC,QAAQ,kBACf,OAAO,CAAC,KAAK,CAAC,qBACX,GAAG,KAAK,CAAC,GAAG,QAAQ,sBAEnC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,GAE7E,GACS,CACd,CAAC;AACJ,CAAC"}

package/dist/cjs/fields/ToggleField.js

@@ -0,0 +1,27 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToggleField = ToggleField;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const core_1 = require("../core");
+const tokens_1 = require("../tokens");
+const control_1 = require("./control");
+const control_2 = require("./control");
+/**
+ * `toggle`, as a switch or a checkbox.
+ *
+ * **This is the one field type whose label sits BESIDE the control, not above it**, so it does
+ * not use `FieldShell`. A switch under a label reads as a heading with an orphaned control; the
+ * label is the thing being switched, and putting it on the same line says so. The hint still
+ * goes underneath, where every other field puts it.
+ */
+function ToggleField({ field, value, onChange, error, }) {
+    const { colors } = (0, tokens_1.useDs)();
+    const on = value ?? field.default ?? false;
+    const hint = (0, control_1.resolveHint)(field);
+    const checkbox = (0, control_2.controlOf)(field) === 'checkbox';
+    return ((0, jsx_runtime_1.jsxs)(core_1.Box, { gap: "s2", children: [(0, jsx_runtime_1.jsxs)(core_1.Box, { row: true, align: "center", justify: "space-between", gap: "s4", children: [(0, jsx_runtime_1.jsx)(core_1.Text, { variant: "label", nativeID: `${field.key}-label`, children: field.label }), checkbox ? ((0, jsx_runtime_1.jsx)(core_1.Pressable, { onPress: () => onChange(!on), hit: 44, "aria-label": field.label, 
+                        /* The box is 22pt inside a 44pt target. The target is padding, not the mark. */
+                        style: { alignItems: 'flex-end' }, children: (0, jsx_runtime_1.jsx)(core_1.Box, { width: 22, height: 22, align: "center", justify: "center", radius: "part.skeleton", bg: on ? 'accentFill' : 'surface1', edge: on ? undefined : 'field', children: on ? (0, jsx_runtime_1.jsx)(core_1.Icon, { name: "tick", size: 14, color: colors.accentOnFill }) : null }) })) : ((0, jsx_runtime_1.jsx)(core_1.Switch, { value: on, onChange: onChange, "aria-label": field.label }))] }), error ? ((0, jsx_runtime_1.jsx)(core_1.Text, { variant: "caption", color: "status.error", accessibilityLiveRegion: "polite", children: error })) : hint ? ((0, jsx_runtime_1.jsx)(core_1.Text, { variant: "caption", color: "textSecondary", children: hint })) : null] }));
+}
+//# sourceMappingURL=ToggleField.js.map

package/dist/cjs/fields/ToggleField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleField.js","sourceRoot":"","sources":["../../../src/fields/ToggleField.tsx"],"names":[],"mappings":";;AAcA,kCAyDC;;AAvED,kCAA6D;AAC7D,sCAAkC;AAClC,uCAAwC;AACxC,uCAAsC;AAGtC;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,KAAK,EACL,QAAQ,EACR,KAAK,GAMN;IACC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,cAAK,GAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,KAAK,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAA,qBAAW,EAAC,KAAK,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAA,mBAAS,EAAC,KAAK,CAAC,KAAK,UAAU,CAAC;IAEjD,OAAO,CACL,wBAAC,UAAG,IAAC,GAAG,EAAC,IAAI,aACX,wBAAC,UAAG,IAAC,GAAG,QAAC,KAAK,EAAC,QAAQ,EAAC,OAAO,EAAC,eAAe,EAAC,GAAG,EAAC,IAAI,aACtD,uBAAC,WAAI,IAAC,OAAO,EAAC,OAAO,EAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,GAAG,QAAQ,YACjD,KAAK,CAAC,KAAK,GACP,EAEN,QAAQ,CAAC,CAAC,CAAC,CACV,uBAAC,gBAAS,IACR,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC5B,GAAG,EAAE,EAAE,gBACK,KAAK,CAAC,KAAK;wBACvB,gFAAgF;wBAChF,KAAK,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,YACjC,uBAAC,UAAG,IACF,KAAK,EAAE,EAAE,EACT,MAAM,EAAE,EAAE,EACV,KAAK,EAAC,QAAQ,EACd,OAAO,EAAC,QAAQ,EAChB,MAAM,EAAC,eAAe,EACtB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,EAClC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,YAC7B,EAAE,CAAC,CAAC,CAAC,uBAAC,WAAI,IAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,GAAI,CAAC,CAAC,CAAC,IAAI,GACnE,GACI,CACb,CAAC,CAAC,CAAC,CACF,uBAAC,aAAM,IAAC,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,gBAAc,KAAK,CAAC,KAAK,GAAI,CACnE,IACG,EAEL,KAAK,CAAC,CAAC,CAAC,CACP,uBAAC,WAAI,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAC,cAAc,EAAC,uBAAuB,EAAC,QAAQ,YAC1E,KAAK,GACD,CACR,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACT,uBAAC,WAAI,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAC,eAAe,YAC1C,IAAI,GACA,CACR,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC"}

package/dist/cjs/fields/VariantField.js

@@ -0,0 +1,52 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VariantField = VariantField;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const core_1 = require("../core");
+const tokens_1 = require("../tokens");
+const FieldRenderer_1 = require("./FieldRenderer");
+const control_1 = require("./control");
+/**
+ * `variant` — pick one branch, fill in that branch.
+ *
+ * **Each branch keeps its own answer when you switch away and back.** Discarding it would punish
+ * a user for looking at the other option, and looking is the entire point of a control that
+ * offers two. The tag alone moves; the payloads stay in a draft map.
+ *
+ * Only the selected branch is validated — the others are answers the user did not give, not
+ * answers they gave badly.
+ */
+function VariantField({ field, value, onChange, error, errors, path, options, }) {
+    const { colors } = (0, tokens_1.useDs)();
+    const current = value ?? field.default;
+    const selected = field.children.find(c => c.key === current?.variant) ?? field.children[0];
+    const [drafts, setDrafts] = (0, react_1.useState)(() => current?.variant ? { [current.variant]: current.value } : {});
+    const [open, setOpen] = (0, react_1.useState)(false);
+    const hint = (0, control_1.resolveHint)(field);
+    if (!selected)
+        return null;
+    /**
+     * **A branch selector is named for the CHOICE, not the branch.** Unqualified, the tab and the
+     * field it reveals carry the same name — a screen reader reads "Email button" and then "Email
+     * textbox", and nothing says the first one switches and the second one collects.
+     */
+    const tabLabel = (label) => `${field.label}: ${label}`;
+    const pick = (key) => {
+        setOpen(false);
+        onChange({ variant: key, value: drafts[key] });
+    };
+    const setBranchValue = (next) => {
+        setDrafts(d => ({ ...d, [selected.key]: next }));
+        onChange({ variant: selected.key, value: next });
+    };
+    return ((0, jsx_runtime_1.jsxs)(core_1.Box, { gap: "s3", role: "group", "aria-label": field.label, children: [(0, jsx_runtime_1.jsxs)(core_1.Box, { gap: "s1", children: [(0, jsx_runtime_1.jsx)(core_1.Text, { variant: "eyebrow", color: "textTertiary", uppercase: true, children: field.label }), error ? ((0, jsx_runtime_1.jsx)(core_1.Text, { variant: "caption", color: "status.error", children: error })) : hint ? ((0, jsx_runtime_1.jsx)(core_1.Text, { variant: "caption", color: "textSecondary", children: hint })) : null] }), (0, control_1.controlOf)(field) === 'select' ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(core_1.Pressable, { onPress: () => setOpen(true), row: true, align: "center", justify: "space-between", px: "s3", py: "s3", radius: "field", bg: "surface1", "aria-label": field.label, style: { minHeight: 44 }, children: [(0, jsx_runtime_1.jsx)(core_1.Text, { children: selected.label }), (0, jsx_runtime_1.jsx)(core_1.Icon, { name: "caretDown", size: 14, color: colors.textTertiary })] }), (0, jsx_runtime_1.jsxs)(core_1.Sheet, { visible: open, onDismiss: () => setOpen(false), testID: `${field.key}-sheet`, children: [(0, jsx_runtime_1.jsx)(core_1.Text, { variant: "heading", children: field.label }), (0, jsx_runtime_1.jsx)(core_1.Scroll, { gap: "s1", children: field.children.map(c => ((0, jsx_runtime_1.jsx)(core_1.Pressable, { onPress: () => pick(c.key), row: true, align: "center", justify: "flex-start", py: "s3", px: "s3", radius: "row", bg: c.key === selected.key ? 'accentTint' : undefined, "aria-label": tabLabel(c.label), style: { minHeight: 44 }, children: (0, jsx_runtime_1.jsx)(core_1.Text, { color: c.key === selected.key ? 'accentInk' : 'textPrimary', children: c.label }) }, c.key))) })] })] })) : (
+            /* Tabs. Visually a segmented control, but it switches a form SECTION rather than
+               picking a value — which is why it is not `EnumField`'s control reused. */
+            (0, jsx_runtime_1.jsx)(core_1.Box, { row: true, p: "s1", gap: "s1", radius: "field", bg: "surfaceSunken", role: "group", children: field.children.map(c => {
+                    const on = c.key === selected.key;
+                    return ((0, jsx_runtime_1.jsx)(core_1.Pressable, { onPress: () => pick(c.key), py: "s2", px: "s3", radius: "chip", bg: on ? 'surface1' : undefined, "aria-label": tabLabel(c.label), style: { flex: 1 }, children: (0, jsx_runtime_1.jsx)(core_1.Text, { variant: "caption", color: on ? 'accentInk' : 'textSecondary', numberOfLines: 1, children: c.label }) }, c.key));
+                }) })), (0, jsx_runtime_1.jsx)(FieldRenderer_1.FieldRenderer, { field: selected, path: `${path}.${selected.key}`, value: drafts[selected.key], onChange: setBranchValue, errors: errors, options: options })] }));
+}
+//# sourceMappingURL=VariantField.js.map

package/dist/cjs/fields/VariantField.js.map

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

package/dist/cjs/fields/answer.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.answerBlock = answerBlock;
+exports.overrode = overrode;
+exports.supersede = supersede;
+/**
+ * **Assemble the `answer/1` envelope.**
+ *
+ * Always the envelope, never a bare value (decision Q8b): an agent that cannot tell *skipped*
+ * from *never answered* will re-ask, or proceed as though it had an answer. It travels alone
+ * (Q9a) — the block is not echoed back, because whoever asked still has it.
+ *
+ * This is a helper, not a policy. The host decides when an ask is answered, skipped or failed;
+ * nothing here watches a widget and decides for it (Q7a).
+ */
+function answerBlock(block, answers, opts = {}) {
+    return {
+        schema: 'answer/1',
+        slug: block.slug,
+        at: opts.at ?? new Date().toISOString(),
+        state: opts.state ?? 'answered',
+        /* An `action` has no value — firing it IS the answer, and it lives in `outcome`. */
+        answers,
+        outcome: opts.outcome ?? 'accept',
+        ...(opts.rejection ? { rejection: opts.rejection } : {}),
+        ...(opts.overrode ? { overrode: opts.overrode } : {}),
+        ...(opts.degraded === undefined ? {} : { degraded: opts.degraded }),
+        ...(opts.superseded === undefined ? {} : { superseded: opts.superseded }),
+    };
+}
+/**
+ * The user chose against a scored recommendation.
+ *
+ * Worth recording precisely because the system was wrong — a run that never learns which of its
+ * rankings get overturned keeps making the same one.
+ */
+function overrode(chose, over, score) {
+    return score === undefined ? { chose, over } : { chose, over, score };
+}
+/**
+ * **Re-opening an answered ask.**
+ *
+ * ⚠ This sets a flag. **What it means is the host's obligation, not this library's** — on
+ * `superseded: true` the host must treat every downstream step derived from that answer as
+ * invalid, re-plan from this ask rather than resuming after it, and keep the previous answer
+ * because *what changed* is often the useful part. Nothing here can enforce any of that; see
+ * `spec/QUESTION-SCHEMA.md` §12.
+ */
+function supersede(previous) {
+    return { ...previous, state: 'superseded', superseded: true, at: new Date().toISOString() };
+}
+//# sourceMappingURL=answer.js.map

package/dist/cjs/fields/answer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer.js","sourceRoot":"","sources":["../../../src/fields/answer.ts"],"names":[],"mappings":";;AAYA,kCAkBC;AAQD,4BAMC;AAWD,8BAEC;AAvDD;;;;;;;;;GASG;AACH,SAAgB,WAAW,CACzB,KAAwB,EACxB,OAAgB,EAChB,OAAkE,EAAE;IAEpE,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACvC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,UAAU;QAC/B,oFAAoF;QACpF,OAAO;QACP,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,QAAQ;QACjC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CACtB,KAAa,EACb,IAAY,EACZ,KAAc;IAEd,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACxE,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,SAAS,CAAC,QAAqB;IAC7C,OAAO,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AAC9F,CAAC"}