@appinternalleads/ui 0.2.0

package/dist/esm/components/onboarding/shared/mock.d.ts

@@ -0,0 +1,80 @@
+/**
+ * **Every timer in the onboarding components lives here** — the prototypes' placeholder timings,
+ * and the deterministic mock operations built on them. Same constraints as ThresholdFlow's mock:
+ * latency is a number or a function of the call, failure is a predicate of the call, and there is
+ * no `Math.random` and no `Date.now`, so a test can prove a superseded attempt is discarded.
+ */
+export declare const ONBOARDING_TIMING: {
+    /** Calendar Sync: one connect. */
+    readonly connect: 1200;
+    /** Brand Kit, Budget, Dashboard: save. Export: export. */
+    readonly save: 1400;
+    /** Calendar Sync and Carousel: Continue → Done. */
+    readonly finish: 900;
+    /** Retry from the load-error state: loading, then ready. */
+    readonly reload: 900;
+    /** Upload and import progress: one tick. */
+    readonly tick: 160;
+    /** Export Format: "Copied" before it reverts. */
+    readonly copied: 1600;
+    /** Achievement: claim. ID Verification: submit. */
+    readonly claim: 1200;
+    /** Password Expiry: change. Payment Alert: retry payment. */
+    readonly change: 1300;
+    /** File Shared: one download. Queue Status: one job. */
+    readonly download: 1400;
+    /** ID Verification: one upload tick of 15%. */
+    readonly uploadTick: 180;
+    /** ID Verification: the quality checks. */
+    readonly checks: 900;
+    /** Floating: a toast without an action, before it dismisses itself. */
+    readonly toast: 6000;
+    /** Receipt Printer: the host's print. Shorter than the paper's feed, so a failure lands mid-feed. */
+    readonly print: 900;
+};
+export type OnboardingOutcome = {
+    ok: true;
+} | {
+    ok: false;
+    message?: string;
+};
+/** One boundary operation: a request in, an outcome out, abortable. */
+export type OnboardingOperation<Req> = (req: Req, ctx: {
+    signal: AbortSignal;
+}) => Promise<OnboardingOutcome>;
+export type MockOperationOptions<Req> = {
+    latencyMs?: number | ((req: Req, callIndex: number) => number);
+    /** Fail this call. Deterministic by construction — a function of the call. */
+    fail?: (req: Req, callIndex: number) => boolean | string;
+    onCall?: (req: Req, callIndex: number) => void;
+};
+/** A deterministic mock of one operation. `fail` returning a string makes that the message. */
+export declare function createMockOperation<Req>(opts?: MockOperationOptions<Req>): OnboardingOperation<Req>;
+/**
+ * **A progress stream** — upload or import. `onProgress(fraction)` is called every `tickMs` with a
+ * step of `step`, then the outcome resolves. Deterministic: the same options always produce the
+ * same sequence.
+ */
+export type ProgressOperation<Req> = (req: Req, ctx: {
+    signal: AbortSignal;
+    onProgress: (fraction: number) => void;
+}) => Promise<OnboardingOutcome>;
+export declare function createMockProgressOperation<Req>(opts?: {
+    tickMs?: number;
+    step?: number;
+    fail?: (req: Req, callIndex: number) => boolean | string;
+    /** Where a failing run stops (0–1). Default 1: it runs to the end, then fails — the prototype. */
+    failAt?: number;
+    onCall?: (req: Req, callIndex: number) => void;
+}): ProgressOperation<Req>;
+/** The load that Retry runs from the load-error state — resolves after `reload`. */
+export declare const mockReload: OnboardingOperation<void>;
+/**
+ * **An operation that never settles** — it only ends when aborted. For a preview or a visual test
+ * that must hold an in-flight scene (Saving…, Connecting…, Importing… 64%) still, rather than race
+ * a timer to the screenshot.
+ */
+export declare function holdOperation<Req = unknown, Res = OnboardingOutcome>(): (req: Req, ctx: {
+    signal: AbortSignal;
+}) => Promise<Res>;
+//# sourceMappingURL=mock.d.ts.map

package/dist/esm/components/onboarding/shared/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/mock.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;IAC5B,kCAAkC;;IAElC,0DAA0D;;IAE1D,mDAAmD;;IAEnD,4DAA4D;;IAE5D,4CAA4C;;IAE5C,iDAAiD;;IAGjD,mDAAmD;;IAEnD,6DAA6D;;IAE7D,wDAAwD;;IAExD,+CAA+C;;IAE/C,2CAA2C;;IAE3C,uEAAuE;;IAEvE,qGAAqG;;CAE7F,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,uEAAuE;AACvE,MAAM,MAAM,mBAAmB,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE9G,MAAM,MAAM,oBAAoB,CAAC,GAAG,IAAI;IACtC,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAC/D,8EAA8E;IAC9E,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAAC;IACzD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF,+FAA+F;AAC/F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,IAAI,GAAE,oBAAoB,CAAC,GAAG,CAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CASvG;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,GAAG,IAAI,CACnC,GAAG,EAAE,GAAG,EACR,GAAG,EAAE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,KACjE,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEhC,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,IAAI,GAAE;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAAC;IACzD,kGAAkG;IAClG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAgB9B;AAED,oFAAoF;AACpF,eAAO,MAAM,UAAU,2BAAqE,CAAC;AAE7F;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAG,OAAO,EAAE,GAAG,GAAG,iBAAiB,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAIhI"}

package/dist/esm/components/onboarding/shared/mock.js

@@ -0,0 +1,78 @@
+import { abortableDelay, resolveLatency } from '../../../runtime/operations';
+/**
+ * **Every timer in the onboarding components lives here** — the prototypes' placeholder timings,
+ * and the deterministic mock operations built on them. Same constraints as ThresholdFlow's mock:
+ * latency is a number or a function of the call, failure is a predicate of the call, and there is
+ * no `Math.random` and no `Date.now`, so a test can prove a superseded attempt is discarded.
+ */
+export const ONBOARDING_TIMING = {
+    /** Calendar Sync: one connect. */
+    connect: 1200,
+    /** Brand Kit, Budget, Dashboard: save. Export: export. */
+    save: 1400,
+    /** Calendar Sync and Carousel: Continue → Done. */
+    finish: 900,
+    /** Retry from the load-error state: loading, then ready. */
+    reload: 900,
+    /** Upload and import progress: one tick. */
+    tick: 160,
+    /** Export Format: "Copied" before it reverts. */
+    copied: 1600,
+    /* Batch 3 (notification + verification) — the handoff's placeholder timings, verbatim. */
+    /** Achievement: claim. ID Verification: submit. */
+    claim: 1200,
+    /** Password Expiry: change. Payment Alert: retry payment. */
+    change: 1300,
+    /** File Shared: one download. Queue Status: one job. */
+    download: 1400,
+    /** ID Verification: one upload tick of 15%. */
+    uploadTick: 180,
+    /** ID Verification: the quality checks. */
+    checks: 900,
+    /** Floating: a toast without an action, before it dismisses itself. */
+    toast: 6000,
+    /** Receipt Printer: the host's print. Shorter than the paper's feed, so a failure lands mid-feed. */
+    print: 900,
+};
+/** A deterministic mock of one operation. `fail` returning a string makes that the message. */
+export function createMockOperation(opts = {}) {
+    let calls = 0;
+    return async (req, { signal }) => {
+        const callIndex = calls++;
+        opts.onCall?.(req, callIndex);
+        await abortableDelay(resolveLatency(opts.latencyMs, req, callIndex), signal);
+        const failed = opts.fail?.(req, callIndex);
+        return failed ? { ok: false, ...(typeof failed === 'string' ? { message: failed } : {}) } : { ok: true };
+    };
+}
+export function createMockProgressOperation(opts = {}) {
+    let calls = 0;
+    return async (req, { signal, onProgress }) => {
+        const callIndex = calls++;
+        opts.onCall?.(req, callIndex);
+        const step = opts.step ?? 0.09;
+        let p = 0;
+        while (p < 1) {
+            await abortableDelay(opts.tickMs ?? ONBOARDING_TIMING.tick, signal);
+            p = Math.min(1, p + step);
+            const failed = opts.fail?.(req, callIndex);
+            if (failed && p >= (opts.failAt ?? 1))
+                return { ok: false, ...(typeof failed === 'string' ? { message: failed } : {}) };
+            onProgress(p);
+        }
+        return { ok: true };
+    };
+}
+/** The load that Retry runs from the load-error state — resolves after `reload`. */
+export const mockReload = createMockOperation({ latencyMs: ONBOARDING_TIMING.reload });
+/**
+ * **An operation that never settles** — it only ends when aborted. For a preview or a visual test
+ * that must hold an in-flight scene (Saving…, Connecting…, Importing… 64%) still, rather than race
+ * a timer to the screenshot.
+ */
+export function holdOperation() {
+    return (_req, { signal }) => new Promise((_, reject) => {
+        signal.addEventListener('abort', () => reject(new DOMException('Aborted', 'AbortError')), { once: true });
+    });
+}
+//# sourceMappingURL=mock.js.map

package/dist/esm/components/onboarding/shared/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/mock.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/onboarding/shared/parts.d.ts

@@ -0,0 +1,128 @@
+import { type ReactNode } from 'react';
+import { type ViewProps } from 'react-native';
+import { type IconName } from '../../../core';
+import { type DataType } from '../../../tokens';
+/**
+ * **Row parts the onboarding components share** — each is a composition of existing blocks, named
+ * once so fifteen components draw them the same way.
+ */
+/**
+ * A ghost action with the M8 lifecycle: "Configure" → "Configuring…" (busy: `aria-busy`, the well
+ * ground, scale .98). The accessible name says which row it belongs to.
+ */
+export declare function BusyGhost({ label, busyLabel, busy, onPress, name, disabled, }: {
+    label: string;
+    busyLabel: string;
+    busy?: boolean;
+    onPress: () => void;
+    name: string;
+    disabled?: boolean;
+}): import("react").JSX.Element;
+/** A mint check in a circle — "tried", "verified". Decorative: the words beside it carry the state. */
+export declare function MintCheck({ size }: {
+    size?: number;
+}): import("react").JSX.Element;
+/** A plain D1 chip — ink on line-soft. "New", "Popular", "Current", a count. Never coloured. */
+export declare function PlainChip({ children, height, dashed }: {
+    children: string;
+    height?: number;
+    dashed?: boolean;
+}): import("react").JSX.Element;
+/** M4: one slot whose content cross-fades when `slotKey` changes; the layout never holds two. */
+export declare function Slot({ slotKey, children, minWidth, align }: {
+    slotKey: string;
+    children: ReactNode;
+    minWidth?: number;
+    align?: 'flex-start' | 'flex-end';
+}): import("react").JSX.Element;
+/** Visually hidden text — still read by a screen reader ("(opens in a new tab)"). */
+export declare function Hidden({ children }: {
+    children: string;
+}): import("react").JSX.Element;
+/**
+ * **M5 for words as well as numbers** — "On", "2,410", "$29": the old value fades out while the new
+ * one fades in, in one cell; only the current value is read. Reduced motion: it simply changes.
+ */
+export declare function CrossFadeText({ value, style }: {
+    value: string;
+    style?: object;
+}): import("react").JSX.Element;
+/**
+ * **A row whose actions appear on hover or focus-within** — so a keyboard user sees them the moment
+ * focus reaches the row. Touch has no hover, so on native they are always shown. `force` keeps them
+ * shown (a menu open from the row). The children receive whether to show them.
+ */
+export declare function RevealRow({ children, style, force, role }: {
+    children: (reveal: boolean) => ReactNode;
+    style?: ViewProps['style'];
+    force?: boolean;
+    role?: 'listitem';
+}): import("react").JSX.Element;
+/**
+ * **The handoff's spinner — a 16px arc turning every 900ms.** It stops under reduced motion (the
+ * glyph stays, still). `label` makes it a named `status` ("Downloading Brief.pdf"); without one it
+ * is decoration beside its own words.
+ */
+export declare function Spinner({ size, color, label }: {
+    size?: number;
+    color?: string;
+    label?: string;
+}): import("react").JSX.Element;
+/**
+ * **An icon tile in one of the handoff's grounds** — the hue of a data type (the default), or muted
+ * (`#F1EFE7` / muted ink: a locked hero, an "Up next" tile), or apricot / mint (a failed toast, a
+ * done step). `round` is the 50% circle a status mark uses. Always decoration: its row names it.
+ */
+export declare function HueTile({ icon, size, type, tone, round, glyph, }: {
+    icon: IconName;
+    size?: number;
+    type?: DataType;
+    tone?: 'hue' | 'muted' | 'apricot' | 'mint';
+    round?: boolean;
+    glyph?: number;
+}): import("react").JSX.Element;
+/** A status mark in a 24px circle — the mint check, the apricot "!". Decoration: the row says it in words. */
+export declare function StatusMark({ tone, size }: {
+    tone: 'mint' | 'apricot';
+    size?: number;
+}): import("react").JSX.Element;
+/**
+ * **The read-only copy field (C7 of batch 3)** — a label, then a well with a real read-only input
+ * (focusable, selectable), an `aria-live` "Copied" (mint deep, 1600ms) and a 32px copy button. The
+ * coral ring sits on the wrapper while the input has focus (`:focus-within`). `onCopy` is the host's
+ * clipboard; on the web the browser's is used when it exists. A refused clipboard is not "Copied".
+ */
+export declare function CopyField({ label, value, copyLabel, mono, onCopy, nativeID, }: {
+    label: string;
+    value: string;
+    copyLabel: string;
+    mono?: boolean;
+    onCopy?: (value: string) => void | Promise<void>;
+    nativeID: string;
+}): import("react").JSX.Element;
+/**
+ * **M3 expand / M14 collapse for a region that stays mounted** — the height eases between 0 and
+ * its measured size while the opacity follows (and `lift` px of travel, for a list row leaving);
+ * reduced motion jumps. Closed, it is `aria-hidden` and `inert` on the web, so nothing inside is
+ * focusable or read — a filtered-out row, a collapsed payment panel.
+ */
+export declare function ExpandRegion({ open, children, nativeID, role, label, labelledBy, lift, }: {
+    open: boolean;
+    children: ReactNode;
+    nativeID?: string;
+    role?: 'region' | 'listitem';
+    label?: string;
+    labelledBy?: string;
+    /** Travel while closing — M14's −6px. */
+    lift?: number;
+}): import("react").JSX.Element;
+/**
+ * **The 8px ink unread dot** — it fades out when the row is read: at `--motion-state` (160ms) in a
+ * filtered list, at `--motion-list` (240ms, M14) in an inbox. Opacity only, so reduced motion keeps
+ * the fade. Decoration: the row's name says "unread".
+ */
+export declare function UnreadDot({ on, speed }: {
+    on: boolean;
+    speed?: 'state' | 'list';
+}): import("react").JSX.Element;
+//# sourceMappingURL=parts.d.ts.map

package/dist/esm/components/onboarding/shared/parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/parts.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/onboarding/shared/parts.js

@@ -0,0 +1,178 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { Animated, Platform, View } from 'react-native';
+import { Box, Icon, Input, MotionView, Text, easingFor, useBlockMotion, useLoop, useSwap, useTick, useTween } from '../../../core';
+import { Button, COPIED_MS, IconButton } from '../../../ds';
+import { HUE, blockRadii, focusRingFor, hueForType, useDs } from '../../../tokens';
+/**
+ * **Row parts the onboarding components share** — each is a composition of existing blocks, named
+ * once so fifteen components draw them the same way.
+ */
+/**
+ * A ghost action with the M8 lifecycle: "Configure" → "Configuring…" (busy: `aria-busy`, the well
+ * ground, scale .98). The accessible name says which row it belongs to.
+ */
+export function BusyGhost({ label, busyLabel, busy = false, onPress, name, disabled, }) {
+    const { colors } = useDs();
+    return (_jsx(Button, { variant: "secondary", size: "small", busy: busy, disabled: disabled, onPress: onPress, "aria-label": `${busy ? busyLabel : label}: ${name}`, style: busy ? { backgroundColor: colors.surfaceSunken, transform: [{ scale: 0.98 }] } : undefined, children: busy ? busyLabel : label }));
+}
+/** A mint check in a circle — "tried", "verified". Decorative: the words beside it carry the state. */
+export function MintCheck({ size = 24 }) {
+    const { colors } = useDs();
+    return (_jsx(Box, { width: size, height: size, radius: "pill", align: "center", justify: "center", "aria-hidden": true, style: { backgroundColor: colors.statusBg.executed }, children: _jsx(Icon, { name: "tick", size: Math.round(size * 0.55), color: colors.status.executed }) }));
+}
+/** A plain D1 chip — ink on line-soft. "New", "Popular", "Current", a count. Never coloured. */
+export function PlainChip({ children, height = 24, dashed = false }) {
+    const { colors } = useDs();
+    return (_jsx(Box, { row: true, align: "center", alignSelf: "flex-start", height: height, radius: "pill", style: {
+            paddingHorizontal: height < 24 ? 8 : 10,
+            backgroundColor: dashed ? colors.surface1 : colors.band,
+            ...(dashed ? { borderWidth: 1, borderStyle: 'dashed', borderColor: colors.hairlineStrong } : null),
+        }, children: _jsx(Text, { variant: "caption", numeric: true, numberOfLines: 1, style: { fontSize: height < 24 ? 11 : 12, fontWeight: '600', color: dashed ? colors.textSecondary : colors.textPrimary }, children: children }) }));
+}
+/** M4: one slot whose content cross-fades when `slotKey` changes; the layout never holds two. */
+export function Slot({ slotKey, children, minWidth, align = 'flex-end' }) {
+    const fade = useSwap(slotKey);
+    return (_jsx(MotionView, { style: { opacity: fade, minWidth, flexDirection: 'row', alignItems: 'center', justifyContent: align, gap: 8, flexWrap: 'wrap' }, children: children }));
+}
+/** Visually hidden text — still read by a screen reader ("(opens in a new tab)"). */
+export function Hidden({ children }) {
+    return (_jsx(Box, { style: { position: 'absolute', width: 1, height: 1, overflow: 'hidden', left: -10000 }, children: _jsx(Text, { children: children }) }));
+}
+/**
+ * **M5 for words as well as numbers** — "On", "2,410", "$29": the old value fades out while the new
+ * one fades in, in one cell; only the current value is read. Reduced motion: it simply changes.
+ */
+export function CrossFadeText({ value, style }) {
+    const { previous, progress } = useTick(value);
+    return (_jsxs(Box, { style: { alignSelf: 'flex-start' }, children: [_jsx(MotionView, { style: { opacity: progress }, children: _jsx(Text, { numeric: true, style: style, children: value }) }), previous !== null ? (_jsx(MotionView, { "aria-hidden": true, style: { position: 'absolute', left: 0, top: 0, opacity: progress.interpolate({ inputRange: [0, 1], outputRange: [1, 0] }) }, children: _jsx(Text, { numeric: true, style: style, children: previous }) })) : null] }));
+}
+const RevealView = View;
+/**
+ * **A row whose actions appear on hover or focus-within** — so a keyboard user sees them the moment
+ * focus reaches the row. Touch has no hover, so on native they are always shown. `force` keeps them
+ * shown (a menu open from the row). The children receive whether to show them.
+ */
+export function RevealRow({ children, style, force = false, role }) {
+    const [hover, setHover] = useState(false);
+    const [focus, setFocus] = useState(false);
+    const reveal = Platform.OS !== 'web' || hover || focus || force;
+    return (_jsx(RevealView, { role: role, onMouseEnter: () => setHover(true), onMouseLeave: () => setHover(false), onFocus: () => setFocus(true), onBlur: () => setFocus(false), style: style, children: children(reveal) }));
+}
+/* ── Batch 3 (notification + verification) ─────────────────────────────────────────────── */
+/**
+ * **The handoff's spinner — a 16px arc turning every 900ms.** It stops under reduced motion (the
+ * glyph stays, still). `label` makes it a named `status` ("Downloading Brief.pdf"); without one it
+ * is decoration beside its own words.
+ */
+export function Spinner({ size = 16, color, label }) {
+    const { colors } = useDs();
+    const turn = useLoop({ duration: 900 });
+    return (_jsx(MotionView, { role: label ? 'status' : undefined, "aria-label": label, "aria-hidden": label ? undefined : true, style: { width: size, height: size, transform: [{ rotate: turn.interpolate({ inputRange: [0, 1], outputRange: ['0deg', '360deg'] }) }] }, children: _jsx(Icon, { name: "spinner", size: size, color: color ?? colors.textPrimary }) }));
+}
+/**
+ * **An icon tile in one of the handoff's grounds** — the hue of a data type (the default), or muted
+ * (`#F1EFE7` / muted ink: a locked hero, an "Up next" tile), or apricot / mint (a failed toast, a
+ * done step). `round` is the 50% circle a status mark uses. Always decoration: its row names it.
+ */
+export function HueTile({ icon, size = 32, type, tone = 'hue', round = false, glyph, }) {
+    const { colors } = useDs();
+    const hue = HUE[hueForType(type)];
+    const skin = tone === 'muted' ? { bg: colors.band, ink: colors.textSecondary }
+        : tone === 'apricot' ? { bg: colors.statusBg.needsUser, ink: colors.status.needsUser }
+            : tone === 'mint' ? { bg: colors.statusBg.executed, ink: colors.status.executed }
+                : { bg: hue.hs, ink: hue.hd };
+    return (_jsx(Box, { width: size, height: size, align: "center", justify: "center", "aria-hidden": true, style: { flexShrink: 0, backgroundColor: skin.bg, borderRadius: round ? size / 2 : blockRadii.tile }, children: _jsx(Icon, { name: icon, size: glyph ?? (size >= 48 ? 22 : size <= 24 ? 13 : 17), color: skin.ink }) }));
+}
+/** A status mark in a 24px circle — the mint check, the apricot "!". Decoration: the row says it in words. */
+export function StatusMark({ tone, size = 24 }) {
+    return _jsx(HueTile, { icon: tone === 'mint' ? 'tick' : 'exclamation', tone: tone, size: size, round: true, glyph: Math.round(size * 0.55) });
+}
+/**
+ * **The read-only copy field (C7 of batch 3)** — a label, then a well with a real read-only input
+ * (focusable, selectable), an `aria-live` "Copied" (mint deep, 1600ms) and a 32px copy button. The
+ * coral ring sits on the wrapper while the input has focus (`:focus-within`). `onCopy` is the host's
+ * clipboard; on the web the browser's is used when it exists. A refused clipboard is not "Copied".
+ */
+export function CopyField({ label, value, copyLabel, mono = false, onCopy, nativeID, }) {
+    const { colors, density, fonts } = useDs();
+    const [focused, setFocused] = useState(false);
+    const [copied, setCopied] = useState(false);
+    const timer = useRef(null);
+    useEffect(() => () => { if (timer.current)
+        clearTimeout(timer.current); }, []);
+    const copy = async () => {
+        const clip = globalThis.navigator?.clipboard;
+        try {
+            if (onCopy)
+                await onCopy(value);
+            else
+                await clip?.writeText(value);
+        }
+        catch {
+            return;
+        }
+        setCopied(true);
+        if (timer.current)
+            clearTimeout(timer.current);
+        timer.current = setTimeout(() => setCopied(false), COPIED_MS);
+    };
+    return (_jsxs(Box, { gap: "s1", children: [_jsx(Text, { nativeID: `${nativeID}-label`, variant: "caption", color: "textPrimary", style: { fontSize: 12, fontWeight: '600' }, children: label }), _jsxs(Box, { row: true, align: "center", gap: "s1", style: {
+                    height: density.controlH, paddingLeft: 12, paddingRight: 2, borderRadius: blockRadii.inset, borderWidth: 1,
+                    borderColor: focused ? colors.accentFill : colors.hairlineStrong, backgroundColor: colors.surfaceSunken,
+                    boxShadow: focused ? focusRingFor(colors) : 'none',
+                }, children: [_jsx(Box, { flex: 1, style: { minWidth: 0 }, children: _jsx(Input, { nativeID: nativeID, value: value, onChangeText: () => { }, readOnly: true, "aria-labelledby": `${nativeID}-label`, onFocus: () => setFocused(true), onBlur: () => setFocused(false), 
+                            /* The wrapper draws the focus ring (`:focus-within`); the field's own ring is switched off. */
+                            style: {
+                                boxShadow: 'none', backgroundColor: 'transparent', paddingHorizontal: 0, paddingVertical: 0, borderRadius: 0,
+                                fontSize: 13, fontFamily: mono ? fonts.mono : fonts.sans, letterSpacing: mono ? 0.52 : 0,
+                            } }) }), _jsx(Box, { role: "status", "aria-live": "polite", children: _jsx(Text, { variant: "caption", style: { fontSize: 12, color: colors.status.executed }, children: copied ? 'Copied' : '' }) }), _jsx(IconButton, { icon: "copy", label: copyLabel, onPress: () => { void copy(); } })] })] }));
+}
+/**
+ * **M3 expand / M14 collapse for a region that stays mounted** — the height eases between 0 and
+ * its measured size while the opacity follows (and `lift` px of travel, for a list row leaving);
+ * reduced motion jumps. Closed, it is `aria-hidden` and `inert` on the web, so nothing inside is
+ * focusable or read — a filtered-out row, a collapsed payment panel.
+ */
+export function ExpandRegion({ open, children, nativeID, role, label, labelledBy, lift = 0, }) {
+    const t = useTween(open ? 1 : 0);
+    const [height, setHeight] = useState(null);
+    const body = useRef(null);
+    useEffect(() => {
+        const el = body.current;
+        if (!el?.setAttribute)
+            return;
+        if (open)
+            el.removeAttribute?.('inert');
+        else
+            el.setAttribute('inert', '');
+    }, [open]);
+    return (_jsx(MotionView, { nativeID: nativeID, role: role, "aria-label": label, "aria-labelledby": labelledBy, "aria-hidden": !open || undefined, style: {
+            overflow: 'hidden',
+            opacity: t,
+            height: height === null ? (open ? undefined : 0) : t.interpolate({ inputRange: [0, 1], outputRange: [0, height] }),
+            ...(lift ? { transform: [{ translateY: t.interpolate({ inputRange: [0, 1], outputRange: [-lift, 0] }) }] } : null),
+        }, children: _jsx(View, { ref: body, style: { pointerEvents: open ? 'auto' : 'none' }, onLayout: e => {
+                const h = e.nativeEvent.layout.height;
+                if (h > 0 && h !== height)
+                    setHeight(h);
+            }, children: children }) }));
+}
+/**
+ * **The 8px ink unread dot** — it fades out when the row is read: at `--motion-state` (160ms) in a
+ * filtered list, at `--motion-list` (240ms, M14) in an inbox. Opacity only, so reduced motion keeps
+ * the fade. Decoration: the row's name says "unread".
+ */
+export function UnreadDot({ on, speed = 'state' }) {
+    const { colors } = useDs();
+    const m = useBlockMotion();
+    const v = useRef(new Animated.Value(on ? 1 : 0)).current;
+    useEffect(() => {
+        const a = Animated.timing(v, { toValue: on ? 1 : 0, duration: m[speed], easing: easingFor(m), useNativeDriver: false });
+        a.start();
+        return () => a.stop();
+    }, [on]);
+    return _jsx(MotionView, { "aria-hidden": true, style: { width: 8, height: 8, borderRadius: 4, backgroundColor: colors.textPrimary, opacity: v } });
+}
+//# sourceMappingURL=parts.js.map

package/dist/esm/components/onboarding/shared/parts.js.map

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

package/dist/esm/components/onboarding/shared/runtime.d.ts

@@ -0,0 +1,43 @@
+import { type OperationRunner } from '../../../runtime/operations';
+import type { PatternStatus } from './contract';
+import { type OnboardingOperation } from './mock';
+/**
+ * **The pattern status (S1) as runtime state.** The host says where the step starts — `ready`,
+ * `loading`, `empty`, `error` — and the component owns what happens next: Retry from `error` goes
+ * to `loading`, runs the host's `reload`, and lands on `ready` (or back on `error`). The same for
+ * the empty state's action when it is a refresh. A new `status` from the host always wins.
+ */
+export declare function usePatternStatus(status: PatternStatus, reload?: OnboardingOperation<void>): {
+    status: PatternStatus;
+    retry: () => void;
+    set: import("react").Dispatch<import("react").SetStateAction<PatternStatus>>;
+};
+/**
+ * Run one boundary operation and route its outcome — a business refusal (`{ ok: false }`) and a
+ * thrown transport error both land in `fail`, with the message when there is one. An abort (an
+ * unmount, a superseded attempt) lands nowhere.
+ */
+export declare function runOutcome<Req>(runner: OperationRunner, id: string, op: OnboardingOperation<Req>, req: Req, on: {
+    ok: () => void;
+    fail: (message?: string) => void;
+}): void;
+/**
+ * Report the component's scene whenever it changes — the README's optional `onScene` (analytics,
+ * a demo board following along). Never drives anything.
+ */
+export declare function useSceneReport(scene: string, onScene?: (scene: string) => void): void;
+/**
+ * **A reducer seeded from the config, reseeded when the config (or seed) genuinely changes** — the
+ * rule every onboarding runtime follows: a parent re-rendering with an equal config must not wipe
+ * the person's work, and a preset switch must start over. Returns the state, a dispatch, and a
+ * ref that always holds the latest state (for operation callbacks).
+ */
+export declare function useSeededReducer<S, A>(reduce: (s: S, a: A) => S, seed: () => S, key: string, onReseed?: () => void): [S, (a: A) => void, {
+    current: S;
+}];
+/**
+ * The host's operation, or — without one — the prototype's placeholder: `latencyMs`, then success,
+ * or failure when `fail` says so (the README's `result` contract).
+ */
+export declare function useDefaultOperation<Req>(op: OnboardingOperation<Req> | undefined, latencyMs: number, fail: (req: Req, callIndex: number) => boolean): OnboardingOperation<Req>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/esm/components/onboarding/shared/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAmC,KAAK,mBAAmB,EAA0B,MAAM,QAAQ,CAAC;AAE3G;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,GAAE,mBAAmB,CAAC,IAAI,CAAc;;;;EAYrG;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAC5B,MAAM,EAAE,eAAe,EACvB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAC5B,GAAG,EAAE,GAAG,EACR,EAAE,EAAE;IAAE,EAAE,EAAE,MAAM,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,QAMzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,QAO9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,CAAC,EACnC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,EACzB,IAAI,EAAE,MAAM,CAAC,EACb,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,IAAI,GACpB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC,CAiBrC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EACrC,EAAE,EAAE,mBAAmB,CAAC,GAAG,CAAC,GAAG,SAAS,EACxC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,GAC7C,mBAAmB,CAAC,GAAG,CAAC,CAO1B"}

package/dist/esm/components/onboarding/shared/runtime.js

@@ -0,0 +1,77 @@
+'use client';
+import { useCallback, useEffect, useMemo, useReducer, useRef, useState } from 'react';
+import { useOperationRunner } from '../../../runtime/operations';
+import { createMockOperation, mockReload } from './mock';
+/**
+ * **The pattern status (S1) as runtime state.** The host says where the step starts — `ready`,
+ * `loading`, `empty`, `error` — and the component owns what happens next: Retry from `error` goes
+ * to `loading`, runs the host's `reload`, and lands on `ready` (or back on `error`). The same for
+ * the empty state's action when it is a refresh. A new `status` from the host always wins.
+ */
+export function usePatternStatus(status, reload = mockReload) {
+    const [current, setCurrent] = useState(status);
+    useEffect(() => setCurrent(status), [status]);
+    const runner = useOperationRunner();
+    const retry = useCallback(() => {
+        setCurrent('loading');
+        runner.run('reload', ctx => reload(undefined, { signal: ctx.signal }), {
+            onOk: r => setCurrent(r.ok ? 'ready' : 'error'),
+            onError: () => setCurrent('error'),
+        });
+    }, [runner, reload]);
+    return { status: current, retry, set: setCurrent };
+}
+/**
+ * Run one boundary operation and route its outcome — a business refusal (`{ ok: false }`) and a
+ * thrown transport error both land in `fail`, with the message when there is one. An abort (an
+ * unmount, a superseded attempt) lands nowhere.
+ */
+export function runOutcome(runner, id, op, req, on) {
+    runner.run(id, ctx => op(req, { signal: ctx.signal }), {
+        onOk: (r) => (r.ok ? on.ok() : on.fail(r.message)),
+        onError: e => on.fail(e.message),
+    });
+}
+/**
+ * Report the component's scene whenever it changes — the README's optional `onScene` (analytics,
+ * a demo board following along). Never drives anything.
+ */
+export function useSceneReport(scene, onScene) {
+    const last = useRef(null);
+    useEffect(() => {
+        if (last.current === scene)
+            return;
+        last.current = scene;
+        onScene?.(scene);
+    }, [scene, onScene]);
+}
+/**
+ * **A reducer seeded from the config, reseeded when the config (or seed) genuinely changes** — the
+ * rule every onboarding runtime follows: a parent re-rendering with an equal config must not wipe
+ * the person's work, and a preset switch must start over. Returns the state, a dispatch, and a
+ * ref that always holds the latest state (for operation callbacks).
+ */
+export function useSeededReducer(reduce, seed, key, onReseed) {
+    const [state, send] = useReducer((s, a) => (a.type === '__reset' ? a.state : reduce(s, a)), undefined, seed);
+    const ref = useRef(state);
+    ref.current = state;
+    const seeded = useRef(key);
+    useEffect(() => {
+        if (seeded.current === key)
+            return;
+        seeded.current = key;
+        onReseed?.();
+        send({ type: '__reset', state: seed() });
+    });
+    return [state, send, ref];
+}
+/**
+ * The host's operation, or — without one — the prototype's placeholder: `latencyMs`, then success,
+ * or failure when `fail` says so (the README's `result` contract).
+ */
+export function useDefaultOperation(op, latencyMs, fail) {
+    const failRef = useRef(fail);
+    failRef.current = fail;
+    return useMemo(() => op ?? createMockOperation({ latencyMs, fail: (r, i) => failRef.current(r, i) }), [op, latencyMs]);
+}
+//# sourceMappingURL=runtime.js.map