@12-apps/ui 6.77.1 → 6.78.0

package/dist/types/components/feedback/SequenceResolver/SequenceResolver.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { SequenceItem, SequenceResolverProps } from './SequenceResolver.types';
+/**
+ * Resolve a queue of problems one at a time, in ONE dialog whose body is
+ * replaced step by step: a header with "‹ Back", the step's label and close,
+ * a progress bar, the host's step, and an end screen (FUT-3671).
+ *
+ * A centred `Dialog` from the `sm` breakpoint up; the `Dialog` inset
+ * bottom-sheet variant below it, never taller than 95% of the viewport. Either
+ * way the paper scrolls inside the viewport, so a long step is never cut off.
+ *
+ * The component owns the run — which step is on screen, what was answered or
+ * skipped, where Back returns to — and nothing about the domain: every step
+ * body, every word and every server call is the host's.
+ */
+export declare function SequenceResolver<I extends SequenceItem, R = unknown>(props: SequenceResolverProps<I, R>): React.JSX.Element;
+//# sourceMappingURL=SequenceResolver.d.ts.map

package/dist/types/components/feedback/SequenceResolver/SequenceResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SequenceResolver.d.ts","sourceRoot":"","sources":["../../../../../src/components/feedback/SequenceResolver/SequenceResolver.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAO1D,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAmB,MAAM,0BAA0B,CAAC;AAiFrG;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,GAAG,OAAO,EAClE,KAAK,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,GACjC,KAAK,CAAC,GAAG,CAAC,OAAO,CAsEnB"}

package/dist/types/components/feedback/SequenceResolver/SequenceResolver.metrics.d.ts

@@ -0,0 +1,33 @@
+/**
+ * THE RESOLVER'S NUMBERS — the approved prototype's, in px. The web reads
+ * them through `rem`/`sxRem` so a density mode scales them (FUT-3671).
+ */
+export declare const SEQUENCE_METRICS: {
+    /** Below this width the dialog is the inset bottom sheet, and targets are 44px+. */
+    readonly sheetBreakpoint: "sm";
+    /** The sheet never grows past this share of the viewport; the paper scrolls inside it. */
+    readonly sheetMaxHeightPercent: 95;
+    /** The smallest a control may be below the sheet breakpoint, and the end screen's button everywhere. */
+    readonly touchTarget: 44;
+    /** The intro's "all in sequence" button, at least. */
+    readonly startAllHeight: 48;
+    /** Header icon button: 40px on a pointer, 44px on a phone. */
+    readonly closeSize: {
+        readonly pointer: 40;
+        readonly touch: 44;
+    };
+    /** The drag handle — decoration only, the sheet does not drag. */
+    readonly handle: {
+        readonly width: 40;
+        readonly height: 4;
+    };
+    readonly title: 22;
+    readonly stepLabel: 13;
+    readonly categoryDescription: 13;
+    readonly categoryMinHeight: 56;
+    readonly countBadge: 32;
+    readonly listRadius: 12;
+    readonly doneIcon: 44;
+    readonly doneTitle: 20;
+};
+//# sourceMappingURL=SequenceResolver.metrics.d.ts.map

package/dist/types/components/feedback/SequenceResolver/SequenceResolver.metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SequenceResolver.metrics.d.ts","sourceRoot":"","sources":["../../../../../src/components/feedback/SequenceResolver/SequenceResolver.metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B,oFAAoF;;IAEpF,0FAA0F;;IAE1F,wGAAwG;;IAExG,sDAAsD;;IAEtD,8DAA8D;;;;;IAE9D,kEAAkE;;;;;;;;;;;;;CAU1D,CAAC"}

package/dist/types/components/feedback/SequenceResolver/SequenceResolver.parts.d.ts

@@ -0,0 +1,61 @@
+import React from 'react';
+import type { SequenceAction, SequenceDone, SequenceIntro, SequenceStep } from './SequenceResolver.types';
+interface HeaderProps {
+    touch: boolean;
+    label: string;
+    /** Absent: no back button (intro, first step, or the host turned it off). */
+    back?: {
+        label: string;
+        accessible?: string;
+        onClick: () => void;
+        disabled: boolean;
+    };
+    closeLabel: string;
+    onClose: () => void;
+    progress: number;
+    progressLabel: string;
+    testId: string;
+}
+/** The drag handle (phone), the header row and the progress bar. */
+export declare function SequenceHeader(props: HeaderProps): React.JSX.Element;
+/**
+ * Moves focus to `target` (else `fallback`) whenever `screenKey` changes — and
+ * on mount, which happens inside the dialog's portal, before MUI's focus trap
+ * looks: finding focus already inside, the trap and `focusDialogOnEntered`
+ * both leave it there.
+ */
+export declare function useFocusOnScreen(screenKey: string, target: React.RefObject<HTMLElement | null>, fallback: React.RefObject<HTMLElement | null>): void;
+interface IntroProps {
+    intro: SequenceIntro;
+    titleId: string;
+    testId: string;
+    screenKey: string;
+}
+/** The kinds with their counts, and "resolve them all". */
+export declare function SequenceIntroBody({ intro, titleId, testId, screenKey }: IntroProps): React.JSX.Element;
+interface StepProps {
+    step: SequenceStep;
+    /** The default secondary: skip. */
+    skip: SequenceAction;
+    busy: boolean;
+    error: string | null;
+    touch: boolean;
+    testId: string;
+    screenKey: string;
+    titleRef: React.RefObject<HTMLElement | null>;
+}
+/** The host's body, its error, the tertiary text button and the footer. */
+export declare function SequenceStepBody(props: StepProps): React.JSX.Element;
+interface DoneProps {
+    done: SequenceDone;
+    titleId: string;
+    error: string | null;
+    touch: boolean;
+    onConfirm: () => void;
+    testId: string;
+    screenKey: string;
+}
+/** The end screen: a check, the host's title and sentence, one button that closes. */
+export declare function SequenceDoneBody({ done, titleId, error, touch, onConfirm, testId, screenKey }: DoneProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=SequenceResolver.parts.d.ts.map

package/dist/types/components/feedback/SequenceResolver/SequenceResolver.parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SequenceResolver.parts.d.ts","sourceRoot":"","sources":["../../../../../src/components/feedback/SequenceResolver/SequenceResolver.parts.tsx"],"names":[],"mappings":"AAQA,OAAO,KAA4B,MAAM,OAAO,CAAC;AA2BjD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE1G,UAAU,WAAW;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IACtF,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAwCpE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAC3C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAC5C,IAAI,CAIN;AAqBD,UAAU,UAAU;IAClB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAuDtG;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,mCAAmC;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC/C;AA8BD,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA8BpE;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA8B5H"}

package/dist/types/components/feedback/SequenceResolver/SequenceResolver.styles.d.ts

@@ -0,0 +1,51 @@
+import type { SxProps, Theme } from '@mui/material/styles/index.js';
+/**
+ * The paper's column: chrome (handle, header, progress) on top, the screen's
+ * body below — one gap, as the prototype draws it. The body is the ONLY scroll
+ * region, so Back, the step label, close and the progress never scroll away
+ * with a long step. A title focused by script (`tabIndex={-1}`, the host's
+ * included) is not a control and draws no focus ring.
+ */
+export declare const columnSx: SxProps<Theme>;
+/** The chrome above the body: never shrinks, never scrolls. */
+export declare const chromeSx: SxProps<Theme>;
+/** The screen's body: takes what the paper has left and scrolls inside it. */
+export declare const scrollBodySx: SxProps<Theme>;
+/**
+ * The paper stops scrolling itself and lets its one child (the Dialog's padded
+ * body box around `columnSx`) shrink, so the height cap reaches the body.
+ * Below the sheet breakpoint the paper is also capped at 95% of the viewport.
+ */
+export declare function paperSx(touch: boolean): SxProps<Theme>;
+/** The end screen's button: a step down from the sentence, at the touch-target height on a phone. */
+export declare function doneConfirmSx(): SxProps<Theme>;
+/** "All in sequence": the prototype's 48px, and taller when a long label wraps. */
+export declare const startAllSx: SxProps<Theme>;
+/** A button at the touch-target height below the sheet breakpoint; its own size above it. */
+export declare function actionSx(touch: boolean): SxProps<Theme>;
+export declare const handleSx: SxProps<Theme>;
+export declare const headerSx: SxProps<Theme>;
+/** Back and the label; on a narrow sheet the label takes its own row rather than squeeze. */
+export declare const headerStartSx: SxProps<Theme>;
+export declare const stepLabelSx: SxProps<Theme>;
+export declare function closeButtonSx(touch: boolean): SxProps<Theme>;
+export declare function backButtonSx(touch: boolean): SxProps<Theme>;
+export declare const titleSx: SxProps<Theme>;
+export declare const introListSx: SxProps<Theme>;
+export declare function categoryRowSx(last: boolean): SxProps<Theme>;
+export declare const countBadgeSx: SxProps<Theme>;
+export declare const categoryTextSx: SxProps<Theme>;
+export declare const categoryDescriptionSx: SxProps<Theme>;
+/**
+ * The step's footer, as the prototype draws each kind:
+ * - phone: the actions share the row (a label that does not fit takes a full
+ *   row), no hairline;
+ * - pointer, `'split'`: two equal full-width columns, no hairline (limits, a purchase);
+ * - pointer, `'end'`: auto-width actions, right-aligned, over a hairline (restock).
+ */
+export declare function footerSx(touch: boolean, layout: 'end' | 'split'): SxProps<Theme>;
+export declare function tertiarySx(touch: boolean): SxProps<Theme>;
+export declare const doneSx: SxProps<Theme>;
+export declare const doneIconSx: SxProps<Theme>;
+export declare const doneTitleSx: SxProps<Theme>;
+//# sourceMappingURL=SequenceResolver.styles.d.ts.map

package/dist/types/components/feedback/SequenceResolver/SequenceResolver.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SequenceResolver.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/feedback/SequenceResolver/SequenceResolver.styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAMpE;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,KAAK,CAOnC,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAyE,CAAC;AAE9G,8EAA8E;AAC9E,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,KAAK,CAkBvC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAYtD;AAED,qGAAqG;AACrG,wBAAgB,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC,CAE9C;AAED,mFAAmF;AACnF,eAAO,MAAM,UAAU,EAAE,OAAO,CAAC,KAAK,CAAyE,CAAC;AAEhH,6FAA6F;AAC7F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAQvD;AAED,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,KAAK,CAOnC,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,KAAK,CAKnC,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,KAAK,CAMxC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,KAAK,CAKtC,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAG5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAE3D;AAED,eAAO,MAAM,OAAO,EAAE,OAAO,CAAC,KAAK,CAKlC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,KAAK,CAUtC,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAgB3D;AAED,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,KAAK,CActC,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,KAAK,CAMzC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,KAAK,CAGhD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAehF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAEzD;AAED,eAAO,MAAM,MAAM,EAAE,OAAO,CAAC,KAAK,CAOjC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,OAAO,CAAC,KAAK,CAGrC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,KAAK,CAItC,CAAC"}

package/dist/types/components/feedback/SequenceResolver/SequenceResolver.types.d.ts

@@ -0,0 +1,175 @@
+import type * as React from 'react';
+/**
+ * One entry of the queue a {@link SequenceResolverProps} walks through.
+ *
+ * Extend it with whatever the host's step needs (`item.payload`, an id, the
+ * row it came from): the component only reads `key` and `kindLabel`, and hands
+ * the WHOLE item back to `renderStep` and `onBack`.
+ */
+export interface SequenceItem {
+    /** Stable identity across re-renders and refetches — what the run tracks. */
+    key: string;
+    /** The kind word the header shows next to the position ("Purchase"). */
+    kindLabel: string;
+}
+/** Where the run stands, handed to the end screen, `onClose` and `labels.step`. */
+export interface SequenceSummary {
+    /** Steps answered with `resolve`. */
+    resolved: number;
+    /** Steps passed over with `skip`. */
+    skipped: number;
+    /** Every step of the run so far: answered + skipped + still ahead. */
+    total: number;
+    /**
+     * Problems the host reported as resolved TOGETHER with an answered step
+     * (`api.resolve(result, { alsoResolved })` — "apply to every sibling"),
+     * which never became steps. `resolved + alsoResolved` is what a close toast
+     * counts; the end screen's "N of M" counts steps.
+     */
+    alsoResolved: number;
+}
+/** What an answer can say besides its result. */
+export interface SequenceResolveOptions {
+    /** How many OTHER problems this answer resolved too (siblings that never became steps). */
+    alsoResolved?: number;
+}
+/** A button a step puts in the resolver's footer. */
+export interface SequenceAction {
+    label: string;
+    onClick: () => void;
+    /** Disabled on top of the resolver's own `busy`. */
+    disabled?: boolean;
+}
+/** What `renderStep` gets: the run's verbs and its state. */
+export interface SequenceStepApi<R> {
+    /**
+     * Answer this step and move to the next one. Pass the result itself, or the
+     * PROMISE of it (the host's server write): the step stays on screen and
+     * `busy` until it settles; a rejection keeps it and shows the rejection's
+     * message. The result is what `onBack` receives if the reader returns.
+     */
+    resolve: (result: R | PromiseLike<R>, options?: SequenceResolveOptions) => void;
+    /** Leave this step unanswered and move on. */
+    skip: () => void;
+    /** Return to the previous step (the header's back button does the same). */
+    back: () => void;
+    /** True while a `resolve` promise or an `onBack` is pending — disable the step's own answers. */
+    busy: boolean;
+    /**
+     * Spread on the step's TITLE — the item's name, first and large. It names
+     * the dialog (`aria-labelledby`) and takes focus on every advance.
+     */
+    titleProps: {
+        id: string;
+        tabIndex: -1;
+        ref: React.RefCallback<HTMLElement>;
+    };
+}
+/** What a step renders: its body and, at most, two footer actions plus one tertiary. */
+export interface SequenceStep {
+    /** The body: item name (spread `titleProps` on it), question, facts, inputs. */
+    content: React.ReactNode;
+    /** The step's verb ("Save limits"). Omit for a step answered from its body (a list of reasons). */
+    primary?: SequenceAction;
+    /**
+     * The secondary action. Omitted, it is SKIP with `labels.skip`; pass one to
+     * reword it ("Not bought yet") or to replace it (a split mode's "One reason
+     * only"); `false` removes it.
+     */
+    secondary?: SequenceAction | false;
+    /** One text button above the footer ("It was a stock count, not a loss"). */
+    tertiary?: SequenceAction;
+    /**
+     * How the footer lays its actions out on a pointer: `'end'` (default) —
+     * auto-width, right-aligned, over a hairline; `'split'` — two equal
+     * full-width columns, no hairline (a form step: limits, a purchase). On a
+     * phone the actions always share the row, with no hairline.
+     */
+    footer?: 'end' | 'split';
+}
+/** One kind on the intro screen. */
+export interface SequenceCategory {
+    label: string;
+    description?: string;
+    /** How many problems of this kind there are. A kind at zero should not be listed. */
+    count: number;
+    /** Resolve only this kind: set the queue to it and drop `intro`. */
+    onPick: () => void;
+}
+/** The screen before the run: the kinds with their counts, and "resolve them all". */
+export interface SequenceIntro {
+    title: string;
+    description?: string;
+    categories: SequenceCategory[];
+    startAllLabel: string;
+    /** Resolve every kind: set the queue to all of them and drop `intro`. */
+    onStartAll: () => void;
+}
+/** The end screen's words. */
+export interface SequenceDone {
+    title: string;
+    description?: string;
+    /** The one button there; it closes the resolver. */
+    confirmLabel: string;
+}
+/** The chrome's words. The package ships none: every one is the host's. */
+export interface SequenceResolverLabels {
+    /** The back button's visible word ("Back"); a chevron icon precedes it. */
+    back: string;
+    /** The back button's accessible name, when it says more ("Back to the previous problem"). Must contain `back`. */
+    backAccessible?: string;
+    /** The close button's accessible name. */
+    close: string;
+    /** The default secondary action: leave the step unanswered. */
+    skip: string;
+    /** The header label on a step: `"Problem 3 of 13 · Purchase"`. `position` is 1-based. */
+    step: (position: number, total: number, item: SequenceItem) => string;
+    /** The header label on the intro screen. */
+    introStep: string;
+    /** The header label on the end screen. */
+    doneStep: string;
+    /** The progress bar's accessible name. */
+    progress: string;
+    /** Shown when `onBack` / a `resolve` promise rejects with no message of its own. */
+    failed: string;
+}
+export interface SequenceResolverProps<I extends SequenceItem = SequenceItem, R = unknown> {
+    open: boolean;
+    /**
+     * The close button, Esc, and the end screen's button. Gets where the run
+     * stood, for the host's "N resolved · Undo" toast.
+     */
+    onClose: (summary: SequenceSummary) => void;
+    /**
+     * While given, the intro screen shows instead of the run. The host drops it
+     * (and sets `queue`) in the same update as a category's `onPick` / `onStartAll`.
+     */
+    intro?: SequenceIntro;
+    /**
+     * The problems to walk, in order. The host's live data: it may shrink while
+     * the run goes (an answer that resolves siblings too) or grow; the run keeps
+     * pointing at the next unresolved key and never runs past the end.
+     */
+    queue: readonly I[];
+    /** The body and actions of the current step. */
+    renderStep: (item: I, api: SequenceStepApi<R>) => SequenceStep;
+    /**
+     * Undo the previous answer before showing its step again — the host's server
+     * inverse. Called only when the step being returned to was RESOLVED (a skipped
+     * one has nothing to undo). A rejection keeps the current step and shows its message.
+     */
+    onBack?: (item: I, result: R) => Promise<void> | void;
+    /** Offer the back button at all (default `true`). It shows only once a previous step exists. */
+    canGoBack?: boolean;
+    /** The end screen's words, from the run's summary. */
+    done: SequenceDone | ((summary: SequenceSummary) => SequenceDone);
+    labels: SequenceResolverLabels;
+    /**
+     * Base test id (default `sequence-resolver`). Parts get `${id}-back`,
+     * `${id}-close`, `${id}-step-label`, `${id}-progress`, `${id}-category-${index}`,
+     * `${id}-start-all`, `${id}-primary`, `${id}-secondary`, `${id}-tertiary`,
+     * `${id}-error`, `${id}-done`, `${id}-done-confirm`.
+     */
+    dataTestId?: string;
+}
+//# sourceMappingURL=SequenceResolver.types.d.ts.map

package/dist/types/components/feedback/SequenceResolver/SequenceResolver.types.d.ts.map

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

package/dist/types/components/feedback/SequenceResolver/index.d.ts

@@ -0,0 +1,3 @@
+export { SequenceResolver } from './SequenceResolver';
+export type { SequenceAction, SequenceCategory, SequenceDone, SequenceIntro, SequenceItem, SequenceResolverLabels, SequenceResolveOptions, SequenceResolverProps, SequenceStep, SequenceStepApi, SequenceSummary, } from './SequenceResolver.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/feedback/SequenceResolver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/feedback/SequenceResolver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,0BAA0B,CAAC"}

package/dist/types/components/feedback/SequenceResolver/sequence-model.d.ts

@@ -0,0 +1,85 @@
+import type { SequenceItem, SequenceSummary } from './SequenceResolver.types';
+/**
+ * THE RUN, as pure data: what was answered or passed over, and what is ahead.
+ *
+ * The queue is the host's live data, not a snapshot. An answer can resolve
+ * other entries with it (one limit saved for every sibling of a product), a
+ * refetch can drop the entry just answered, and a realtime push can add one —
+ * so the run is NOT an index into the queue. It keeps the visited steps in the
+ * order they were visited, and the steps still ahead in the order the queue
+ * gave them; `syncRun` reconciles the second list with each new queue.
+ */
+/** How a visited step was left. */
+export type Visit<I extends SequenceItem, R> = {
+    item: I;
+    outcome: 'resolved';
+    result: R;
+    alsoResolved?: number;
+} | {
+    item: I;
+    outcome: 'skipped';
+};
+export interface RunState<I extends SequenceItem, R> {
+    /** Every step left behind, oldest first. Back pops the last one. */
+    visits: Visit<I, R>[];
+    /** The steps still ahead; the first is on screen. Empty means the end screen. */
+    ahead: I[];
+    /**
+     * The step whose answer is being written, kept ahead even while the queue
+     * lacks it (the host's refetch may drop it before the write returns).
+     * Cleared when the run leaves it.
+     */
+    pinned?: string;
+    /**
+     * The steps Back returned to, kept ahead while the queue lacks them (the
+     * host's inverse ran, its refetch has not put the entry back yet). A SET:
+     * two Backs before one refetch hold both. A key leaves it when the queue
+     * confirms the entry or the run leaves the step.
+     */
+    held: readonly string[];
+}
+/** A fresh run over `queue` (a repeated key counts once). */
+export declare function startRun<I extends SequenceItem, R>(queue: readonly I[]): RunState<I, R>;
+/**
+ * The run against a new queue.
+ *
+ * - A step ahead that the queue no longer has is dropped — it was resolved
+ *   elsewhere (siblings answered together, another device) — unless it is
+ *   `pinned` or `held`.
+ * - A held key the queue has again is released: the host confirmed it.
+ * - A queue entry the run has not seen is appended, in queue order.
+ * - The entries kept are refreshed from the queue (same key, newer data).
+ * - Visited steps are history and never change.
+ */
+export declare function syncRun<I extends SequenceItem, R>(state: RunState<I, R>, queue: readonly I[]): RunState<I, R>;
+/** Keep `key` ahead whatever the queue says, until the run moves on (see {@link RunState.pinned}). */
+export declare function pinRun<I extends SequenceItem, R>(state: RunState<I, R>, key: string): RunState<I, R>;
+/** The step on screen, or `undefined` at the end. */
+export declare function currentOf<I extends SequenceItem, R>(state: RunState<I, R>): I | undefined;
+/**
+ * Answer `item` — the step that was on screen when the answer began (a pending
+ * write keeps it there, see {@link RunState.pinned}). An item no longer ahead
+ * was already answered (a double call): a no-op, as at the end.
+ */
+export declare function resolveRun<I extends SequenceItem, R>(state: RunState<I, R>, result: R, item?: I | undefined, alsoResolved?: number): RunState<I, R>;
+/**
+ * Pass over the step on screen. Given the `key` that was on screen when the
+ * skip began, a step that has moved on since (a double call) is left alone. At
+ * the end it is a no-op.
+ */
+export declare function skipRun<I extends SequenceItem, R>(state: RunState<I, R>, key?: string): RunState<I, R>;
+/** The step Back would return to, or `undefined` on the first one. */
+export declare function previousOf<I extends SequenceItem, R>(state: RunState<I, R>): Visit<I, R> | undefined;
+/**
+ * Return to the previous step: it is on screen again, ahead of the rest, and
+ * held until the queue confirms it. Given the `key` Back began from, a step
+ * already returned to (a double call) is left alone.
+ */
+export declare function backRun<I extends SequenceItem, R>(state: RunState<I, R>, key?: string): RunState<I, R>;
+/** Where the run stands. */
+export declare function summaryOf<I extends SequenceItem, R>(state: RunState<I, R>): SequenceSummary;
+/** 1-based position of the step on screen (`total + 1` never happens: at the end it is `total`). */
+export declare function positionOf<I extends SequenceItem, R>(state: RunState<I, R>): number;
+/** How far along, 0..100. An empty run is complete. */
+export declare function progressOf<I extends SequenceItem, R>(state: RunState<I, R>): number;
+//# sourceMappingURL=sequence-model.d.ts.map

package/dist/types/components/feedback/SequenceResolver/sequence-model.d.ts.map

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

package/dist/types/components/feedback/SequenceResolver/useSequenceRun.d.ts

@@ -0,0 +1,24 @@
+import { type RunState } from './sequence-model';
+import type { SequenceItem, SequenceResolveOptions } from './SequenceResolver.types';
+interface RunInputs<I extends SequenceItem, R> {
+    /** The resolver is open. Opening it, intro or not, starts a fresh run. */
+    open: boolean;
+    /** True while the run is on screen: open, and past the intro. */
+    active: boolean;
+    queue: readonly I[];
+    onBack?: (item: I, result: R) => Promise<void> | void;
+    /** The message for a rejection that carries none. */
+    failed: string;
+}
+export interface SequenceRun<I extends SequenceItem, R> {
+    run: RunState<I, R>;
+    busy: boolean;
+    error: string | null;
+    resolve: (result: R | PromiseLike<R>, options?: SequenceResolveOptions) => void;
+    skip: () => void;
+    back: () => void;
+}
+/** The run's state and its verbs — the index/back/skip/done logic, once (FUT-3671). */
+export declare function useSequenceRun<I extends SequenceItem, R>(inputs: RunInputs<I, R>): SequenceRun<I, R>;
+export {};
+//# sourceMappingURL=useSequenceRun.d.ts.map

package/dist/types/components/feedback/SequenceResolver/useSequenceRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSequenceRun.d.ts","sourceRoot":"","sources":["../../../../../src/components/feedback/SequenceResolver/useSequenceRun.ts"],"names":[],"mappings":"AAEA,OAAO,EASL,KAAK,QAAQ,EACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAErF,UAAU,SAAS,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC;IAC3C,0EAA0E;IAC1E,IAAI,EAAE,OAAO,CAAC;IACd,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC;IACpD,GAAG,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAChF,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AA6HD,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CA6CpG"}

package/dist/types/components/feedback/index.d.ts

@@ -2,6 +2,7 @@ export * from './ConfirmAction';
 export * from './Dialog';
 export * from './Modal';
 export * from './NotificationStatusNotice';
+export * from './SequenceResolver';
 export * from './Sonner';
 export * from './StackedModal';
 export * from './Toast';

package/dist/types/components/feedback/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/feedback/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/feedback/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC"}

package/dist/types/components/form/Button/Button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Button/Button.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,gBAAgB,CAAC;AAmMnE;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAiB,eAAe,CAAC"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Button/Button.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,gBAAgB,CAAC;AAkOnE;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAiB,eAAe,CAAC"}

package/dist/types/components/form/Button/Button.native.loading.d.ts

@@ -0,0 +1,36 @@
+import * as React from 'react';
+import type { TextStyle } from 'react-native';
+/**
+ * The native Button's loading state (FUT-3646): the label and icon stay laid
+ * out under the spinner — so the button keeps its width and shape — and the
+ * button keeps its name. Split from `Button.native.tsx` to keep that file
+ * under the line ceiling.
+ */
+/**
+ * The spinner over the label while loading, across the whole button; `role`
+ * comes from react-native's ActivityIndicator. It used to REPLACE the label, so
+ * a loading button had no accessible name (FUT-3646).
+ */
+export declare function Spinner({ color, testID }: {
+    color: string;
+    testID: string;
+}): React.JSX.Element;
+/**
+ * The button's name while loading: its text label, said outright. The label
+ * stays laid out (transparent) so the width holds, but a screen reader may skip
+ * a view at opacity 0 — VoiceOver does — so the name cannot ride on it alone.
+ * A caller's own `aria-label` still wins, being spread after this.
+ */
+export declare const loadingName: (loading: boolean | undefined, children: React.ReactNode) => string | undefined;
+/** Laid out but unseen under the spinner while loading, so the width holds. */
+export declare const hiddenWhile: (loading: boolean | undefined) => {
+    opacity: number;
+} | null;
+/** The text label; while loading, kept laid out but unseen under the spinner. */
+export declare function Label({ loading, label, testID, children, }: {
+    loading: boolean | undefined;
+    label: TextStyle;
+    testID: string;
+    children: React.ReactNode;
+}): React.ReactNode;
+//# sourceMappingURL=Button.native.loading.d.ts.map

package/dist/types/components/form/Button/Button.native.loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.native.loading.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Button/Button.native.loading.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C;;;;;GAKG;AAEH;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAW/F;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,OAAO,GAAG,SAAS,EAAE,UAAU,KAAK,CAAC,SAAS,KAAG,MAAM,GAAG,SACvD,CAAC;AAazC,+EAA+E;AAC/E,eAAO,MAAM,WAAW,GAAI,SAAS,OAAO,GAAG,SAAS;;QAAqC,CAAC;AAE9F,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,EACpB,OAAO,EACP,KAAK,EACL,MAAM,EACN,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,GAAG,KAAK,CAAC,SAAS,CASlB"}

package/dist/types-native/components/form/Button/Button.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.native.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Button/Button.native.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAOL,IAAI,EACJ,KAAK,qBAAqB,EAE1B,KAAK,SAAS,EAEd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAmRtB,eAAO,MAAM,MAAM;;;;;;8BA6CjB,CAAC"}
+{"version":3,"file":"Button.native.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Button/Button.native.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAML,IAAI,EACJ,KAAK,qBAAqB,EAE1B,KAAK,SAAS,EAEd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAuQtB,eAAO,MAAM,MAAM;;;;;;8BAgDjB,CAAC"}

package/dist/types-native/components/form/Button/Button.native.loading.d.ts

@@ -0,0 +1,36 @@
+import * as React from 'react';
+import type { TextStyle } from 'react-native';
+/**
+ * The native Button's loading state (FUT-3646): the label and icon stay laid
+ * out under the spinner — so the button keeps its width and shape — and the
+ * button keeps its name. Split from `Button.native.tsx` to keep that file
+ * under the line ceiling.
+ */
+/**
+ * The spinner over the label while loading, across the whole button; `role`
+ * comes from react-native's ActivityIndicator. It used to REPLACE the label, so
+ * a loading button had no accessible name (FUT-3646).
+ */
+export declare function Spinner({ color, testID }: {
+    color: string;
+    testID: string;
+}): React.JSX.Element;
+/**
+ * The button's name while loading: its text label, said outright. The label
+ * stays laid out (transparent) so the width holds, but a screen reader may skip
+ * a view at opacity 0 — VoiceOver does — so the name cannot ride on it alone.
+ * A caller's own `aria-label` still wins, being spread after this.
+ */
+export declare const loadingName: (loading: boolean | undefined, children: React.ReactNode) => string | undefined;
+/** Laid out but unseen under the spinner while loading, so the width holds. */
+export declare const hiddenWhile: (loading: boolean | undefined) => {
+    opacity: number;
+} | null;
+/** The text label; while loading, kept laid out but unseen under the spinner. */
+export declare function Label({ loading, label, testID, children, }: {
+    loading: boolean | undefined;
+    label: TextStyle;
+    testID: string;
+    children: React.ReactNode;
+}): React.ReactNode;
+//# sourceMappingURL=Button.native.loading.d.ts.map

package/dist/types-native/components/form/Button/Button.native.loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.native.loading.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Button/Button.native.loading.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C;;;;;GAKG;AAEH;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAW/F;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,OAAO,GAAG,SAAS,EAAE,UAAU,KAAK,CAAC,SAAS,KAAG,MAAM,GAAG,SACvD,CAAC;AAazC,+EAA+E;AAC/E,eAAO,MAAM,WAAW,GAAI,SAAS,OAAO,GAAG,SAAS;;QAAqC,CAAC;AAE9F,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,EACpB,OAAO,EACP,KAAK,EACL,MAAM,EACN,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,GAAG,KAAK,CAAC,SAAS,CASlB"}