@slotted/react 0.0.0-stage → 0.1.0-beta.1

package/dist/types/upload/upload.d.ts

@@ -0,0 +1,19 @@
+
+import type { ReactNode } from 'react';
+import type { UploadProps } from './upload.types';
+/**
+ * Files, and what happens to them.
+ *
+ * One family for what `docs/component-features.md` §17 lists as three: a drop
+ * region, a file input, and the manager that shows what is being sent.
+ *
+ * **The trigger is the `<label>` and the region is not.** What the reader
+ * focuses is an `<input type="file">` clipped to one pixel inside the trigger,
+ * so the input's accessible name is the trigger's own text rather than every
+ * word in the box, and the guidance can be as long as the product needs.
+ *
+ * **The family calls an adapter and reports what it says.** It holds no URL, no
+ * method, no header and no credential.
+ */
+export declare function Upload({ accept, adapter: adapterProp, allowDrop: allowDropProp, allowPaste: allowPasteProp, autoUpload: autoUploadProp, capture, children, className, clickToBrowse: clickToBrowseProp, concurrency: concurrencyProp, defaultFiles, defaultViewing, description, directory, disabled, duplicates: duplicatesProp, fileKey: fileKeyProp, files, handleRef, id, invalid, label, layout: layoutProp, locale: localeProp, maxFiles, maxRows: maxRowsProp, maxSize, maxTotalSize, messages, minFiles, minSize, multiple, name, onChange, onDragEnter, onDragLeave, onDragOver, onDrop, onFilesChange, onPaste, onReject, onViewingChange, pendingBlocksSubmit: pendingProp, preventDocumentDrop: preventDocumentDropProp, preview: previewProp, readOnly, render, required, retries: retriesProp, retryDelay: retryDelayProp, size: sizeProp, stallAfter: stallAfterProp, style, transform, validate, variant: variantProp, view: viewProp, viewing, ...nativeProps }: UploadProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+//# sourceMappingURL=upload.d.ts.map

package/dist/types/upload/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/upload/upload.tsx"],"names":[],"mappings":"AAAA,OAAO,mCAAmC,CAAC;AAwB3C,OAAO,KAAK,EAA6B,SAAS,EAAE,MAAM,OAAO,CAAC;AASlE,OAAO,KAAK,EAAmC,WAAW,EAAmB,MAAM,gBAAgB,CAAC;AAEpG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,EACrB,MAAM,EACN,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,aAAa,EACxB,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,cAAc,EAC1B,OAAO,EACP,QAAQ,EACR,SAAS,EACT,aAAa,EAAE,iBAAiB,EAChC,WAAW,EAAE,eAAe,EAC5B,YAAY,EACZ,cAAqB,EACrB,WAAW,EACX,SAAiB,EACjB,QAAQ,EACR,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,WAAW,EACpB,KAAK,EACL,SAAS,EACT,EAAE,EACF,OAAO,EACP,KAAK,EACL,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,EAClB,QAAQ,EACR,OAAO,EAAE,WAAW,EACpB,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAgB,EAChB,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,MAAM,EACN,aAAa,EACb,OAAO,EACP,QAAQ,EACR,eAAe,EACf,mBAAmB,EAAE,WAAW,EAChC,mBAAmB,EAAE,uBAAuB,EAC5C,OAAO,EAAE,WAAW,EACpB,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,cAAc,EAC1B,KAAK,EACL,SAAS,EACT,QAAQ,EACR,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,QAAQ,EACd,OAAO,EACP,GAAG,WAAW,EACf,EAAE,WAAW,+TA0rBb"}

package/dist/types/upload/upload.types.d.ts

@@ -0,0 +1,151 @@
+import type { PartialMessages, UploadMessages } from '@slotted/core/i18n';
+import type { DuplicatePolicy, FileKind, UploadAdapterLike, UploadFile, UploadRejectionReason } from '@slotted/core/upload';
+import type { ChangeRequest } from '@slotted/core/state';
+import type { ComponentPropsWithRef, HTMLAttributes, ReactNode } from 'react';
+/** Which of the three shapes the consolidation names is drawn. */
+export type UploadVariant = 'dropzone' | 'button' | 'field';
+/** A column of rows, or a wall of pictures. The same rows, arranged. */
+export type UploadLayout = 'list' | 'grid';
+export type UploadSize = 'sm' | 'md' | 'lg';
+/** Whether a thumbnail is made for an image, and whether a file can be opened. */
+export type UploadPreview = 'auto' | 'none';
+export type UploadView = 'auto' | 'none';
+export type { DuplicatePolicy, FileKind, UploadFile, UploadRejectionReason };
+export type UploadFilesReason = 'select' | 'pointer' | 'keyboard' | 'remove' | 'clear' | 'programmatic';
+export type UploadViewingReason = 'pointer' | 'keyboard' | 'escape' | 'outsidePress' | 'dismiss' | 'programmatic';
+/** The two formatters a row, the summary and the viewer read, bound to one locale. */
+export interface UploadFormatters {
+    bytes(value: number): string;
+    duration(seconds: number): string;
+}
+export interface UploadDefaults {
+    variant: UploadVariant;
+    layout: UploadLayout;
+    size: UploadSize;
+    preview: UploadPreview;
+    view: UploadView;
+    duplicates: DuplicatePolicy;
+    clickToBrowse: boolean;
+    allowDrop: boolean;
+    allowPaste: boolean;
+    preventDocumentDrop: boolean;
+    autoUpload: boolean;
+    pendingBlocksSubmit: boolean;
+    adapter: UploadAdapterLike | undefined;
+    concurrency: number;
+    retries: number;
+    retryDelay: number;
+    stallAfter: number;
+    maxRows: number;
+    fileKey: ((file: File) => string) | undefined;
+}
+export interface UploadDefaultsProviderProps extends Partial<UploadDefaults> {
+    children?: ReactNode | undefined;
+}
+/**
+ * What `render` receives. Written against `HTMLAttributes<HTMLElement>` rather
+ * than the element the part renders by default, because that is what makes
+ * substitution real: a props object typed for a `div` cannot be spread onto a
+ * `section`.
+ */
+export interface UploadRootProps extends HTMLAttributes<HTMLElement> {
+    'data-complete'?: '' | undefined;
+    'data-disabled'?: '' | undefined;
+    'data-dragging'?: '' | undefined;
+    'data-invalid'?: '' | undefined;
+    'data-layout': UploadLayout;
+    'data-loading'?: '' | undefined;
+    'data-part': string;
+    'data-readonly'?: '' | undefined;
+    'data-required'?: '' | undefined;
+    'data-size': UploadSize;
+    'data-ui': string;
+    'data-variant': UploadVariant;
+}
+/** The five a consumer cannot express declaratively, and nothing more. */
+export interface UploadHandle {
+    /** Opens the picker, as though the trigger had been pressed. */
+    browse(): void;
+    /** Sends every file that is waiting for the reader. */
+    upload(): void;
+    retryAll(): void;
+    cancelAll(): void;
+    clear(): void;
+    /** Opens the viewer on a file, or closes it with `null`. */
+    view(key: string | null): void;
+}
+export interface UploadProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'onChange' | 'onPaste'> {
+    children?: ReactNode | undefined;
+    /** Present means the consumer owns the selection. */
+    files?: readonly UploadFile[] | undefined;
+    defaultFiles?: readonly UploadFile[] | undefined;
+    onFilesChange?: ((files: readonly UploadFile[], request: ChangeRequest<readonly UploadFile[]>) => void) | undefined;
+    /** Present means the consumer owns which file the viewer is open on. */
+    viewing?: string | null | undefined;
+    defaultViewing?: string | null | undefined;
+    onViewingChange?: ((key: string | null, request: ChangeRequest<string | null>) => void) | undefined;
+    /** Reported when a file is refused, before any message is written about it. */
+    onReject?: ((files: readonly UploadFile[]) => void) | undefined;
+    accept?: string | undefined;
+    multiple?: boolean | undefined;
+    directory?: boolean | undefined;
+    capture?: 'user' | 'environment' | undefined;
+    maxFiles?: number | undefined;
+    minFiles?: number | undefined;
+    maxSize?: number | undefined;
+    minSize?: number | undefined;
+    maxTotalSize?: number | undefined;
+    /** The consumer's own rule, run after the family's and before anything is kept. */
+    validate?: ((file: File) => UploadRejectionReason | null | undefined) | undefined;
+    /** Rewrites the selection before it is judged: compression, renaming, cropping. */
+    transform?: ((files: File[]) => File[] | Promise<File[]>) | undefined;
+    variant?: UploadVariant | undefined;
+    layout?: UploadLayout | undefined;
+    size?: UploadSize | undefined;
+    preview?: UploadPreview | undefined;
+    view?: UploadView | undefined;
+    duplicates?: DuplicatePolicy | undefined;
+    clickToBrowse?: boolean | undefined;
+    allowDrop?: boolean | undefined;
+    allowPaste?: boolean | undefined;
+    preventDocumentDrop?: boolean | undefined;
+    autoUpload?: boolean | undefined;
+    pendingBlocksSubmit?: boolean | undefined;
+    adapter?: UploadAdapterLike | undefined;
+    concurrency?: number | undefined;
+    retries?: number | undefined;
+    retryDelay?: number | undefined;
+    stallAfter?: number | undefined;
+    maxRows?: number | undefined;
+    /** What sizes and durations are written in. Absent, the language in force. */
+    locale?: string | undefined;
+    fileKey?: ((file: File) => string) | undefined;
+    /**
+     * Words laid over the catalog of the language in force, key by key: the
+     * controls, the word for each status and each kind, the sentences about the
+     * queue, and why a file was refused (`rejection.*`). Only the application
+     * knows whether a limit is a policy, a plan or a bug, so a refusal is worded
+     * here.
+     */
+    messages?: PartialMessages<UploadMessages> | undefined;
+    /** The family's own label, for an upload that is not inside a `field`. */
+    label?: ReactNode | undefined;
+    description?: ReactNode | undefined;
+    /** Unstated rather than `false`, so the control defers to its field. */
+    disabled?: boolean | undefined;
+    readOnly?: boolean | undefined;
+    invalid?: boolean | undefined;
+    required?: boolean | undefined;
+    name?: string | undefined;
+    id?: string | undefined;
+    /** The consumer's own handler runs first, and the family composes with it. */
+    onDrop?: ((event: React.DragEvent<HTMLDivElement>) => void) | undefined;
+    onDragEnter?: ((event: React.DragEvent<HTMLDivElement>) => void) | undefined;
+    onDragLeave?: ((event: React.DragEvent<HTMLDivElement>) => void) | undefined;
+    onDragOver?: ((event: React.DragEvent<HTMLDivElement>) => void) | undefined;
+    onPaste?: ((event: React.ClipboardEvent<HTMLDivElement>) => void) | undefined;
+    onChange?: ((event: React.ChangeEvent<HTMLInputElement>) => void) | undefined;
+    handleRef?: React.Ref<UploadHandle> | undefined;
+    render?: ((props: UploadRootProps) => ReactNode) | undefined;
+}
+//# sourceMappingURL=upload.types.d.ts.map

package/dist/types/upload/upload.types.d.ts.map

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

package/dist/types/visually-hidden/index.d.ts

@@ -0,0 +1,3 @@
+export { VisuallyHidden } from './visually-hidden';
+export type { VisuallyHiddenProps, VisuallyHiddenRootProps } from './visually-hidden.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/visually-hidden/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/visually-hidden/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/types/visually-hidden/visually-hidden.d.ts

@@ -0,0 +1,14 @@
+
+import type { VisuallyHiddenProps } from './visually-hidden.types';
+/**
+ * Content that assistive technology reaches and sight does not. The element is
+ * removed from view and left in the accessibility tree, and it takes no space:
+ * a control that gains an accessible name this way is the same size it was.
+ *
+ * The family paints nothing. `focusable` stops the hiding while focus is
+ * inside, and what appears is the consumer's own element, rendered as they
+ * wrote it — a skip link's appearance belongs to the link, not to a hiding
+ * rule.
+ */
+export declare function VisuallyHidden({ focusable, render, ...nativeProps }: VisuallyHiddenProps): string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+//# sourceMappingURL=visually-hidden.d.ts.map

package/dist/types/visually-hidden/visually-hidden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visually-hidden.d.ts","sourceRoot":"","sources":["../../../src/visually-hidden/visually-hidden.tsx"],"names":[],"mappings":"AAAA,OAAO,qDAAqD,CAAC;AAE7D,OAAO,KAAK,EAAE,mBAAmB,EAA2B,MAAM,yBAAyB,CAAC;AAE5F;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAAE,SAAiB,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,mBAAmB,+VAShG"}

package/dist/types/visually-hidden/visually-hidden.types.d.ts

@@ -0,0 +1,21 @@
+import type { ComponentPropsWithoutRef, HTMLAttributes, ReactNode } from 'react';
+export interface VisuallyHiddenRootProps extends HTMLAttributes<HTMLElement> {
+    /**
+     * Present only on the variant that reveals itself. The stylesheet stops
+     * matching while focus is inside it, rather than restoring each declaration
+     * in a second rule.
+     */
+    'data-focusable'?: '' | undefined;
+    'data-part': string;
+    'data-ui': string;
+}
+export interface VisuallyHiddenProps extends ComponentPropsWithoutRef<'span'> {
+    /**
+     * Reveals the content while focus is inside it. The case is a skip link: the
+     * sighted keyboard user who lands on it has to see where they are.
+     */
+    focusable?: boolean | undefined;
+    /** Renders the wiring into another element when a span is the wrong claim. */
+    render?: ((props: VisuallyHiddenRootProps) => ReactNode) | undefined;
+}
+//# sourceMappingURL=visually-hidden.types.d.ts.map

package/dist/types/visually-hidden/visually-hidden.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visually-hidden.types.d.ts","sourceRoot":"","sources":["../../../src/visually-hidden/visually-hidden.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjF,MAAM,WAAW,uBAAwB,SAAQ,cAAc,CAAC,WAAW,CAAC;IAC1E;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,wBAAwB,CAAC,MAAM,CAAC;IAC3E;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,uBAAuB,KAAK,SAAS,CAAC,GAAG,SAAS,CAAC;CACtE"}

package/dist/types/wizard/index.d.ts

@@ -0,0 +1,6 @@
+export { Wizard } from './wizard';
+export { useWizard, useWizardStep } from './wizard-context';
+export { WIZARD_FALLBACK, useWizardDefaults, WizardDefaultsProvider } from './wizard-defaults';
+export { WizardActions, WizardCancel, WizardComplete, WizardDraftStatus, WizardEdit, WizardNext, WizardPrevious, WizardSaveDraft, WizardSkip, WizardStep, } from './wizard-parts';
+export type { StepValues, WizardActionProps, WizardActionsProps, WizardAutosave, WizardCancelRequest, WizardCompleteProps, WizardContextValue, WizardDefaults, WizardDefaultsProviderProps, WizardDraftReason, WizardDraftRequest, WizardEditProps, WizardFailure, WizardHandle, WizardLevel, WizardPersistence, WizardProgress, WizardProgressOpenReason, WizardProps, WizardRootProps, WizardScroll, WizardSnapshot, WizardStepContextValue, WizardStepProps, WizardStepReason, WizardSubmitRequest, WizardValidate, WizardValidateContext, WizardValue, WizardValueReason, } from './wizard.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/wizard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wizard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EACL,aAAa,EACb,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,EAC3B,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,wBAAwB,EACxB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,WAAW,EACX,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/dist/types/wizard/wizard-context.d.ts

@@ -0,0 +1,12 @@
+import type { WizardContextValue, WizardStepContextValue } from './wizard.types';
+export declare const WizardContext: import("react").Context<WizardContextValue | undefined>;
+export declare const WizardStepContext: import("react").Context<WizardStepContextValue | undefined>;
+/**
+ * What the wizard around this part says, and the moves a custom footer or a
+ * review step makes. Outside a wizard it throws, because every part of the
+ * family is meaningless without one.
+ */
+export declare function useWizard(): WizardContextValue;
+/** What the step being rendered is told: its name and the answers to show. */
+export declare function useWizardStep(): WizardStepContextValue | undefined;
+//# sourceMappingURL=wizard-context.d.ts.map

package/dist/types/wizard/wizard-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-context.d.ts","sourceRoot":"","sources":["../../../src/wizard/wizard-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,eAAO,MAAM,aAAa,yDAA2D,CAAC;AACtF,eAAO,MAAM,iBAAiB,6DAA+D,CAAC;AAE9F;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAI9C;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,IAAI,sBAAsB,GAAG,SAAS,CAElE"}

package/dist/types/wizard/wizard-defaults.d.ts

@@ -0,0 +1,16 @@
+import type { WizardDefaults, WizardDefaultsProviderProps } from './wizard.types';
+/**
+ * `linear` is on: the wave's scope says direct navigation depends on the
+ * steps already completed. `delay` and `minDuration` are the loading-states
+ * pair, so a restore that answers in eighty milliseconds draws nothing.
+ */
+export declare const WIZARD_FALLBACK: WizardDefaults;
+/** What a wizard behaves like here, before it states anything of its own. */
+export declare function useWizardDefaults(): WizardDefaults;
+/**
+ * An application decides once how its wizards lay out. A wizard that states
+ * any of it itself still wins. Its words come from the language in force
+ * (`SlottedProvider`).
+ */
+export declare function WizardDefaultsProvider({ children, ...defaults }: WizardDefaultsProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=wizard-defaults.d.ts.map

package/dist/types/wizard/wizard-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-defaults.d.ts","sourceRoot":"","sources":["../../../src/wizard/wizard-defaults.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,cAO7B,CAAC;AAIF,6EAA6E;AAC7E,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,EAAE,2BAA2B,+BAI5F"}

package/dist/types/wizard/wizard-parts.d.ts

@@ -0,0 +1,47 @@
+import type { WizardActionProps, WizardActionsProps, WizardCompleteProps, WizardEditProps, WizardStepProps } from './wizard.types';
+/**
+ * One step. The wizard reads its props to lay out the flow and renders its
+ * children inside the step's `form`; rendered anywhere else it is only its
+ * children.
+ */
+export declare function WizardStep({ children }: WizardStepProps): import("react").JSX.Element;
+/**
+ * What stands in place of the step and the actions after an accepted
+ * submission. The wizard renders it as the `complete` part, lands its props
+ * there, and moves focus to it.
+ */
+export declare function WizardComplete(props: WizardCompleteProps): null;
+/**
+ * The row under the step: what leaves the flow at the start, what moves it at
+ * the end, the primary action last. Each group defaults to the actions the
+ * wizard can offer; a consumer that names its own arranges the parts below.
+ */
+export declare function WizardActions({ end, ref, start, ...nativeProps }: WizardActionsProps): import("react").JSX.Element;
+/**
+ * Submits the step's form from outside it, through the platform's `form`
+ * attribute, so `Enter` in a field and this button are one path. It reads
+ * "Next", "Save and return" after an edit from a review step, and the submit
+ * label on the step whose acceptance submits the flow.
+ */
+export declare function WizardNext({ children, onClick, render, ...props }: WizardActionProps): import("react").JSX.Element;
+/** One step back, keeping what was typed. Absent on the first step. */
+export declare function WizardPrevious({ children, onClick, render, ...props }: WizardActionProps): import("react").JSX.Element | null;
+/** Asks `onCancel`, with whether anything is unsubmitted. Absent without a handler. */
+export declare function WizardCancel({ children, onClick, render, ...props }: WizardActionProps): import("react").JSX.Element | null;
+/** Writes the draft. Absent unless the wizard has somewhere to write it. */
+export declare function WizardSaveDraft({ children, onClick, render, ...props }: WizardActionProps): import("react").JSX.Element | null;
+/** Accepts an optional step with no answers. Absent on a required step. */
+export declare function WizardSkip({ children, onClick, render, ...props }: WizardActionProps): import("react").JSX.Element | null;
+/**
+ * The polite status that says when the draft was saved. It is always in the
+ * DOM once the wizard can save, so the first announcement is heard; the
+ * stylesheet takes it out of the layout while it is empty.
+ */
+export declare function WizardDraftStatus(): import("react").JSX.Element | null;
+/**
+ * The control a review step puts beside each answer. It goes to the named step
+ * and sets the return point, so accepting that step comes back here. Its name
+ * is the label and the step's name: "Change shipping address".
+ */
+export declare function WizardEdit({ children, onClick, ref, step, ...nativeProps }: WizardEditProps): import("react").JSX.Element;
+//# sourceMappingURL=wizard-parts.d.ts.map

package/dist/types/wizard/wizard-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-parts.d.ts","sourceRoot":"","sources":["../../../src/wizard/wizard-parts.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,eAAe,+BAEvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,QAGxD;AA4BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,EAAE,kBAAkB,+BAuBpF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,+BAoBpF;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,sCAiBxF;AAED,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,sCAiBtF;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,sCAkBzF;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,sCAiBpF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,uCAqBhC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,EAAE,eAAe,+BAyB3F"}

package/dist/types/wizard/wizard.d.ts

@@ -0,0 +1,27 @@
+
+
+
+import type { ReactElement } from 'react';
+import type { WizardProps } from './wizard.types';
+/**
+ * A flow of steps that accumulates answers.
+ *
+ * **The steps are the ones the consumer renders.** A branch is a condition in
+ * JSX, `{business && <WizardStep name="company" … />}`, and the family reacts
+ * to the list changing under the reader by the eight rules of the design
+ * (§5.6): the current step is never moved because a step appeared before it,
+ * a current step that left the list gives way to the next one still present,
+ * and an absent step keeps its answers without submitting them.
+ *
+ * **Each step is a `form` of the form family.** `Enter` in a field submits
+ * it by the platform's implicit submission, constraint validation and the
+ * error summary are `form`'s, and the step's own `validate` runs after them.
+ * The next button stands outside the form and submits it through the
+ * platform's `form` attribute.
+ *
+ * **It holds accepted answers, not typed ones.** A step is complete exactly
+ * when its name is in `value`; what was typed and not accepted — going back,
+ * saving a draft — is kept per step and shown again, and never submitted.
+ */
+export declare function Wizard({ actions, autosave, children, defaultProgressOpen, defaultStep, defaultValue, delay, disabled, error, guardUnsaved, handle, level, linear, messages, minDuration, onCancel, onProgressOpenChange, onSaveDraft, onStepChange, onSubmit, onValueChange, persistence, progress, progressOpen, render, scroll, step, value, version, ...nativeProps }: WizardProps): string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/types/wizard/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../../src/wizard/wizard.tsx"],"names":[],"mappings":"AAAA,OAAO,mCAAmC,CAAC;AAC3C,OAAO,iCAAiC,CAAC;AACzC,OAAO,qDAAqD,CAAC;AAoC7D,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAYzD,OAAO,KAAK,EAKV,WAAW,EAKZ,MAAM,gBAAgB,CAAC;AA4CxB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,EACrB,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,KAAK,EACL,QAAgB,EAChB,KAAK,EACL,YAAoB,EACpB,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,MAAM,EACN,IAAI,EACJ,KAAK,EACL,OAAO,EACP,GAAG,WAAW,EACf,EAAE,WAAW,+UAs6Bb"}

package/dist/types/wizard/wizard.types.d.ts

@@ -0,0 +1,228 @@
+import type { FamilyTranslator, PartialMessages, WizardMessages } from '@slotted/core/i18n';
+import type { FormErrorInput } from '@slotted/core/form';
+import type { ChangeReason, ChangeRequest } from '@slotted/core/state';
+import type { StepValues, WizardPersistence, WizardSnapshot, WizardValue } from '@slotted/core/wizard';
+import type { ComponentPropsWithRef, ReactNode, Ref } from 'react';
+import type { ButtonProps } from '../button';
+export type { StepValues, WizardPersistence, WizardSnapshot, WizardValue };
+/** Where the list of steps stands: beside the step, above it, or nowhere. */
+export type WizardProgress = 'start' | 'top' | 'none';
+/** What scrolls: the page around the wizard, or the wizard's own step. */
+export type WizardScroll = 'ancestor' | 'self';
+/** When a draft is written without the reader asking. */
+export type WizardAutosave = 'none' | 'step';
+export type WizardLevel = 2 | 3 | 4;
+export type WizardStepReason = Extract<ChangeReason, 'pointer' | 'keyboard' | 'submit' | 'programmatic'>;
+export type WizardValueReason = Extract<ChangeReason, 'submit' | 'clear' | 'programmatic'>;
+export type WizardProgressOpenReason = Extract<ChangeReason, 'pointer' | 'keyboard' | 'select' | 'escape' | 'programmatic'>;
+export type WizardDraftReason = Extract<ChangeReason, 'pointer' | 'submit' | 'programmatic'>;
+/** What an application sets once for every wizard under it. */
+export interface WizardDefaults {
+    progress: WizardProgress;
+    linear: boolean;
+    level: WizardLevel;
+    scroll: WizardScroll;
+    /** How long an asynchronous restore may take before its skeleton is drawn. */
+    delay: number;
+    /** How long a drawn skeleton stays, so it does not flash. */
+    minDuration: number;
+}
+export interface WizardDefaultsProviderProps extends Partial<WizardDefaults> {
+    children?: ReactNode | undefined;
+}
+/**
+ * What a submission may answer instead of succeeding. `step` sends the reader
+ * back to the step whose answers the server refused, and `errors` are
+ * published to that step's form, keyed by control name.
+ */
+export interface WizardFailure {
+    message?: ReactNode | undefined;
+    step?: string | undefined;
+    errors?: FormErrorInput | undefined;
+}
+/** What a submission is given beside the values. */
+export interface WizardSubmitRequest {
+    reason: 'submit';
+    source: unknown;
+    /** Every accepted answer, including steps that are not present any more. */
+    value: WizardValue;
+}
+export interface WizardCancelRequest {
+    /** Whether anything typed or accepted has not been submitted. */
+    dirty: boolean;
+    source: unknown;
+}
+export interface WizardDraftRequest {
+    reason: WizardDraftReason;
+    source: unknown;
+}
+/** What a step's own validation is given beside the step's values. */
+export interface WizardValidateContext {
+    /** The answers accepted so far. */
+    value: WizardValue;
+    /** Aborted when the reader leaves the step before the answer arrives. */
+    signal: AbortSignal;
+}
+export type WizardValidate = (values: StepValues, context: WizardValidateContext) => FormErrorInput | void | Promise<FormErrorInput | void>;
+/** The actions a consumer cannot express by passing a value. */
+export interface WizardHandle {
+    /** Submits the current step, as the next button does. */
+    next(): void;
+    previous(): void;
+    /** Goes to a step: back freely, forward through a submission of this one. */
+    goTo(name: string): void;
+    /** Goes to a step and comes back here once it is accepted. */
+    edit(name: string): void;
+    /** Accepts an optional step with no answers. */
+    skip(): void;
+    /** Submits the current step; on the last one, the whole flow. */
+    submit(): void;
+    saveDraft(): void;
+    clearDraft(): void;
+    /** Back to the first step, with no answers, no draft and no error. */
+    reset(): void;
+    /** Moves focus to the current step's heading. */
+    focus(): void;
+}
+export interface WizardRootProps extends ComponentPropsWithRef<'div'> {
+    'data-complete'?: '' | undefined;
+    'data-disabled'?: '' | undefined;
+    'data-invalid'?: '' | undefined;
+    'data-loading'?: '' | undefined;
+    'data-part': 'root';
+    'data-progress': WizardProgress;
+    'data-scroll': WizardScroll;
+    'data-ui': 'wizard';
+}
+export interface WizardProps extends Omit<ComponentPropsWithRef<'div'>, 'defaultValue' | 'onSubmit'> {
+    /** Present means the consumer owns the step, for the life of the component. */
+    step?: string | undefined;
+    /** The step an uncontrolled wizard starts on, read once and clamped to one in reach. */
+    defaultStep?: string | undefined;
+    onStepChange?: ((step: string, request: ChangeRequest<string>) => void) | undefined;
+    /** Present means the consumer owns the accepted answers. */
+    value?: WizardValue | undefined;
+    defaultValue?: WizardValue | undefined;
+    onValueChange?: ((value: WizardValue, request: ChangeRequest<WizardValue>) => void) | undefined;
+    /** Whether the compact list of steps is open. */
+    progressOpen?: boolean | undefined;
+    defaultProgressOpen?: boolean | undefined;
+    onProgressOpenChange?: ((open: boolean, request: ChangeRequest<boolean>) => void) | undefined;
+    /** Called with the answers of the steps present, once the last step is accepted. */
+    onSubmit?: ((values: WizardValue, request: WizardSubmitRequest) => void | WizardFailure | Promise<void | WizardFailure>) | undefined;
+    /** Asked by the cancel action; the family closes nothing itself. */
+    onCancel?: ((request: WizardCancelRequest) => void) | undefined;
+    /** Called with the draft when one is saved, before `persistence` keeps it. */
+    onSaveDraft?: ((snapshot: WizardSnapshot, request: WizardDraftRequest) => void | Promise<void>) | undefined;
+    /** Where drafts are kept and restored from. */
+    persistence?: WizardPersistence | undefined;
+    /** The flow's version; a draft of another version is not restored. */
+    version?: string | number | undefined;
+    /** Defaults to `step` when `persistence` is given, `none` otherwise. */
+    autosave?: WizardAutosave | undefined;
+    /** Registers a `beforeunload` guard while anything is unsubmitted. */
+    guardUnsaved?: boolean | undefined;
+    /** An error of the consumer's own, shown above the step; it wins over a failed submission. */
+    error?: ReactNode | undefined;
+    disabled?: boolean | undefined;
+    progress?: WizardProgress | undefined;
+    scroll?: WizardScroll | undefined;
+    linear?: boolean | undefined;
+    level?: WizardLevel | undefined;
+    /**
+     * Words laid over the catalog of the language in force, key by key: the
+     * name of the list of steps (`progress`), the position, the actions, the
+     * draft status and the failures.
+     */
+    messages?: PartialMessages<WizardMessages> | undefined;
+    delay?: number | undefined;
+    minDuration?: number | undefined;
+    /** The row of actions. Defaults to `<WizardActions />`. */
+    actions?: ReactNode | undefined;
+    handle?: Ref<WizardHandle> | undefined;
+    render?: ((props: WizardRootProps) => ReactNode) | undefined;
+}
+export interface WizardStepProps {
+    /** The step's identity: the key of its answers, of a URL segment, of a draft. */
+    name: string;
+    label: ReactNode;
+    description?: ReactNode | undefined;
+    optional?: boolean | undefined;
+    disabled?: boolean | undefined;
+    /** Runs after the platform's own validation passes. */
+    validate?: WizardValidate | undefined;
+    /**
+     * The answers to accept instead of the form's `FormData`: typed values a
+     * consumer holds in its own state.
+     */
+    values?: StepValues | undefined;
+    children?: ReactNode;
+}
+export interface WizardCompleteProps extends ComponentPropsWithRef<'div'> {
+    children?: ReactNode;
+}
+/** What the wizard tells its parts, and what `useWizard` returns. */
+export interface WizardContextValue {
+    step: string | undefined;
+    /** The steps present, in order. */
+    steps: readonly {
+        name: string;
+        label: ReactNode;
+        optional: boolean;
+        disabled: boolean;
+    }[];
+    /** One-based position among the steps present. */
+    position: {
+        index: number;
+        count: number;
+    };
+    value: WizardValue;
+    phase: 'editing' | 'submitting' | 'complete';
+    /** Whether a step validation or a submission is pending. */
+    busy: boolean;
+    disabled: boolean;
+    isFirst: boolean;
+    /** Whether accepting the current step submits the flow. */
+    isFinal: boolean;
+    /** Whether an edit started from a review step is open. */
+    returning: boolean;
+    optional: boolean;
+    canSaveDraft: boolean;
+    canCancel: boolean;
+    draftState: 'idle' | 'saving' | 'saved' | 'failed';
+    savedAt: Date | undefined;
+    /** The family's words in the language in force, with this wizard's `messages` laid over them. */
+    t: FamilyTranslator<WizardMessages>;
+    formId: string;
+    next: (source?: unknown) => void;
+    previous: (source?: unknown) => void;
+    goTo: (name: string, reason?: WizardStepReason, source?: unknown) => void;
+    edit: (name: string, source?: unknown) => void;
+    skip: (source?: unknown) => void;
+    cancel: (source?: unknown) => void;
+    saveDraft: (reason?: WizardDraftReason, source?: unknown) => void;
+    reset: () => void;
+}
+/** What one step's content is told. */
+export interface WizardStepContextValue {
+    name: string;
+    /** The answers to show: typed and not yet accepted, else accepted, else none. */
+    values: StepValues;
+    complete: boolean;
+    optional: boolean;
+}
+export interface WizardActionsProps extends ComponentPropsWithRef<'div'> {
+    /** What leaves the flow. Defaults to cancel, save draft and the draft status. */
+    start?: ReactNode | undefined;
+    /** What moves it. Defaults to skip, previous and next. */
+    end?: ReactNode | undefined;
+}
+export type WizardActionProps = Omit<ButtonProps, 'children'> & {
+    children?: ReactNode;
+};
+export interface WizardEditProps extends Omit<ComponentPropsWithRef<'button'>, 'children'> {
+    /** The step to change. */
+    step: string;
+    children?: ReactNode;
+}
+//# sourceMappingURL=wizard.types.d.ts.map

package/dist/types/wizard/wizard.types.d.ts.map

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