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

package/dist/types/rating/rating.types.d.ts

@@ -0,0 +1,172 @@
+import type { PartialMessages, RatingMessages } from '@slotted/core/i18n';
+import type { RatingInsight, RatingInsightThresholds } from '@slotted/core/rating';
+import type { ChangeRequest } from '@slotted/core/state';
+import type { ComponentPropsWithRef, HTMLAttributes, ReactNode, Ref } from 'react';
+/** The step the symbols and the text beside them sit at. */
+export type RatingSize = 'sm' | 'md' | 'lg';
+/**
+ * The colour a lit symbol takes. `secondary` is not among them: its solid step
+ * is a ground, and a star lit in it reads as an unlit one.
+ */
+export type RatingTone = 'accent' | 'success' | 'warning' | 'danger';
+/** The smallest move of the input member: a whole symbol, or half of one. */
+export type RatingStep = 1 | 0.5;
+/** How the display member draws a value: every symbol, or one beside the number. */
+export type RatingDisplayVariant = 'full' | 'compact' | 'histogram';
+/** How the summary draws a distribution: one bar per level, or columns over an axis. */
+export type RatingSummaryVariant = 'bars' | 'spectrum';
+/** Why the value moved. The input member produces exactly these three. */
+export type RatingChangeReason = Extract<ChangeRequest<number | null>['reason'], 'pointer' | 'keyboard' | 'clear'>;
+/** The request the input member emits. `null` is no rating, and `clear` asks for it. */
+export type RatingChangeRequest = ChangeRequest<number | null>;
+/** The request the summary emits when a level is pressed. */
+export type RatingLevelsChangeRequest = ChangeRequest<readonly number[]>;
+/** What an application sets once for every rating under it. */
+export interface RatingDefaults {
+    size: RatingSize;
+    tone: RatingTone;
+    max: number;
+    clearable: boolean;
+    insightThresholds: RatingInsightThresholds;
+}
+export interface RatingProviderProps {
+    children?: ReactNode | undefined;
+    size?: RatingSize | undefined;
+    tone?: RatingTone | undefined;
+    max?: number | undefined;
+    clearable?: boolean | undefined;
+    /** Merged over the inherited thresholds, key by key. */
+    insightThresholds?: Partial<RatingInsightThresholds> | undefined;
+}
+/** What `renderSymbol` receives for each symbol. */
+export interface RatingSymbolState {
+    /** The symbol's position, from nought. */
+    index: number;
+    /** How much of the symbol the current value lights, from nought to one. */
+    fill: number;
+}
+/** What a function `caption` receives. */
+export interface RatingCaptionState {
+    /** The value the group holds. */
+    value: number | null;
+    /** The value under the pointer, or `null`. */
+    preview: number | null;
+}
+/** The imperative action a declarative prop cannot express. */
+export interface RatingHandle {
+    /** Moves focus to the checked radio, or to the first when the value is empty. */
+    focus(): void;
+}
+/** What `render` receives for a root. */
+export interface RatingRootProps extends HTMLAttributes<HTMLElement> {
+    'data-disabled'?: '' | undefined;
+    'data-dragging'?: '' | undefined;
+    'data-invalid'?: '' | undefined;
+    'data-max'?: number | undefined;
+    'data-part': string;
+    'data-readonly'?: '' | undefined;
+    'data-size': RatingSize;
+    'data-step'?: RatingStep | undefined;
+    'data-tone': RatingTone;
+    'data-ui': string;
+    'data-variant'?: string | undefined;
+}
+export interface RatingProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'defaultValue'> {
+    /**
+     * A word for the value, in the `value` part. A function receives the value
+     * held and the value under the pointer, so the word can follow the pointer.
+     */
+    caption?: ReactNode | ((state: RatingCaptionState) => ReactNode) | undefined;
+    /** Unstated, the provider's, then `true`. Pressing the checked radio empties the value. */
+    clearable?: boolean | undefined;
+    /** The value an uncontrolled rating starts from, read once. `null` is no rating. */
+    defaultValue?: number | null | undefined;
+    /** Unstated rather than `false`, so the rating defers to the field around it. */
+    disabled?: boolean | undefined;
+    /** The form the radios submit with, when it is not the one around them. */
+    form?: string | undefined;
+    /** Reaches `focus()`. `ref` reaches the root. */
+    handle?: Ref<RatingHandle> | undefined;
+    /** Unstated rather than `false`. Writes `aria-invalid` and `data-invalid`. */
+    invalid?: boolean | undefined;
+    /** The locale numbers are written in. Unstated, the language in force. */
+    locale?: string | undefined;
+    /** How many symbols. Unstated, the provider's, then 5. */
+    max?: number | undefined;
+    /** Words laid over the catalog of the language in force, key by key. */
+    messages?: PartialMessages<RatingMessages> | undefined;
+    /** The submission name the radios share. Generated when it is not written. */
+    name?: string | undefined;
+    /** The value under the pointer, or `null` when the pointer leaves. Changes nothing. */
+    onPreviewChange?: ((value: number | null) => void) | undefined;
+    /** Called before the value moves, with the request that carries the reason. */
+    onValueChange?: ((value: number | null, request: RatingChangeRequest) => void) | undefined;
+    /** Unstated rather than `false`. Every change is refused and `aria-readonly` is written. */
+    readOnly?: boolean | undefined;
+    /** Renders the root into another element. */
+    render?: ((props: RatingRootProps) => ReactNode) | undefined;
+    /** Replaces the star drawn in each symbol and in its fill. */
+    renderSymbol?: ((state: RatingSymbolState) => ReactNode) | undefined;
+    /** Unstated rather than `false`. Writes `aria-required` on the group. */
+    required?: boolean | undefined;
+    /** Unstated, the field's, then the provider's, then `md`. */
+    size?: RatingSize | undefined;
+    /** A whole symbol or half of one. Defaults to 1. */
+    step?: RatingStep | undefined;
+    /** Unstated, the provider's, then `warning`. */
+    tone?: RatingTone | undefined;
+    /** Present means controlled, for the life of the component; `null` is a controlled empty value. */
+    value?: number | null | undefined;
+}
+export interface RatingDisplayProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {
+    /** How many ratings the value is made of. Present, it is written and named. */
+    count?: number | undefined;
+    /** Counts per level, lowest first, drawn by the `histogram` variant. */
+    distribution?: readonly number[] | undefined;
+    locale?: string | undefined;
+    /** How many symbols the scale has. Unstated, the provider's, then 5. */
+    max?: number | undefined;
+    /** Words laid over the catalog of the language in force, key by key. */
+    messages?: PartialMessages<RatingMessages> | undefined;
+    /** Renders the root into another element. */
+    render?: ((props: RatingRootProps) => ReactNode) | undefined;
+    /** Replaces the star drawn in each symbol and in its fill. */
+    renderSymbol?: ((state: RatingSymbolState) => ReactNode) | undefined;
+    /** Whether the number is written beside the symbols. Defaults to `true`. */
+    showValue?: boolean | undefined;
+    size?: RatingSize | undefined;
+    tone?: RatingTone | undefined;
+    /** The value reported, any fraction; clamped to the scale. */
+    value: number;
+    /** Defaults to `full`. */
+    variant?: RatingDisplayVariant | undefined;
+}
+export interface RatingSummaryProps extends Omit<ComponentPropsWithRef<'section'>, 'children'> {
+    /** How many ratings each level holds, lowest level first. */
+    counts: readonly number[];
+    /** The levels an uncontrolled summary starts pressed, read once. */
+    defaultSelectedLevels?: readonly number[] | undefined;
+    /** Whether each level is a button that filters. Defaults to `false`. */
+    filterable?: boolean | undefined;
+    /** Merged over the provider's thresholds, key by key. */
+    insightThresholds?: Partial<RatingInsightThresholds> | undefined;
+    locale?: string | undefined;
+    /** How many levels the scale has. Unstated, the provider's, then 5. */
+    max?: number | undefined;
+    /** Words laid over the catalog of the language in force, key by key. */
+    messages?: PartialMessages<RatingMessages> | undefined;
+    /** Called before the pressed levels move, with the request that carries the reason. */
+    onSelectedLevelsChange?: ((levels: readonly number[], request: RatingLevelsChangeRequest) => void) | undefined;
+    /** Renders the root into another element. */
+    render?: ((props: RatingRootProps) => ReactNode) | undefined;
+    /** Present means controlled, for the life of the component. */
+    selectedLevels?: readonly number[] | undefined;
+    /** Whether the spectrum writes its conclusion. Defaults to `true`. */
+    showInsight?: boolean | undefined;
+    size?: RatingSize | undefined;
+    tone?: RatingTone | undefined;
+    /** Defaults to `bars`. */
+    variant?: RatingSummaryVariant | undefined;
+}
+export type { RatingInsight, RatingInsightThresholds };
+//# sourceMappingURL=rating.types.d.ts.map

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

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

package/dist/types/result-state/index.d.ts

@@ -0,0 +1,5 @@
+export { ResultState } from './result-state';
+export { ResultStateDefaultsProvider, useResultStateDefaults } from './result-state-defaults';
+export { ResultStateActions, ResultStateContent, ResultStateDescription, ResultStateFooter, ResultStateTitle, } from './result-state-parts';
+export type { ResultStateActionsProps, ResultStateAlign, ResultStateContentProps, ResultStateDefaults, ResultStateDefaultsProviderProps, ResultStateDescriptionProps, ResultStateFooterProps, ResultStateIllustration, ResultStateLive, ResultStatePartProps, ResultStateProps, ResultStateReach, ResultStateRootProps, ResultStateStatus, ResultStateTitleProps, } from './result-state.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/result-state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/result-state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,gCAAgC,EAChC,2BAA2B,EAC3B,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/types/result-state/result-state-defaults.d.ts

@@ -0,0 +1,15 @@
+import type { ResultStateDefaults, ResultStateDefaultsProviderProps } from './result-state.types';
+/** What a result state renders as here, before it states anything of its own. */
+export declare function useResultStateDefaults(): ResultStateDefaults;
+/**
+ * An application decides once how its empty and error regions are drawn, and —
+ * the one that matters most — whether they announce. A data-dense product sets
+ * `reach="inline"` and `align="start"` for a whole screen of tables rather than
+ * repeating the two props on every one of them.
+ *
+ * A region that states any of them itself still wins: an explicit prop is never
+ * overridden by context. Of the seven surveyed implementations only Ant has an
+ * equivalent, it reaches `Empty`'s image alone, and it ships one binding.
+ */
+export declare function ResultStateDefaultsProvider({ children, ...defaults }: ResultStateDefaultsProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=result-state-defaults.d.ts.map

package/dist/types/result-state/result-state-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-state-defaults.d.ts","sourceRoot":"","sources":["../../../src/result-state/result-state-defaults.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAYlG,iFAAiF;AACjF,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,QAAQ,EACR,GAAG,QAAQ,EACZ,EAAE,gCAAgC,+BAgBlC"}

package/dist/types/result-state/result-state-demo.d.ts

@@ -0,0 +1,37 @@
+import type { ReactNode } from 'react';
+/**
+ * One demonstration: what it is called, what to look at, and the stage that
+ * owns the distance between the examples on it. Every story composes this
+ * rather than laying itself out, so no two examples can end up against each
+ * other and no story reaches for an inline style.
+ */
+export declare function Scene({ children, label, layout, note, }: {
+    children: ReactNode;
+    label: string;
+    /**
+     * `block` by default: this family declares `container-type: inline-size`, so
+     * it has no intrinsic width and a stage that shrink-wraps its children would
+     * resolve it to nothing. `specs/story-layout.test.mjs` refuses the pairing.
+     */
+    layout?: 'block' | 'row' | 'stack' | 'prose';
+    note: ReactNode;
+}): import("react").JSX.Element;
+export declare function Grid({ children, columns }: {
+    children: ReactNode;
+    columns: 1 | 2 | 3;
+}): import("react").JSX.Element;
+/**
+ * A frame standing in for the table, card or panel a result state usually
+ * replaces the contents of. It is the workbench's own sunken surface rather
+ * than a border this file invents, so it answers the scheme switch.
+ */
+export declare function Panel({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Artwork a page might supply instead of the status's own mark, for the one
+ * demonstration about that. Every colour in it is a foundation token, so it
+ * follows the scheme the way the family does.
+ */
+export declare function BoardIllustration(): import("react").JSX.Element;
+//# sourceMappingURL=result-state-demo.d.ts.map

package/dist/types/result-state/result-state-demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-state-demo.d.ts","sourceRoot":"","sources":["../../../src/result-state/result-state-demo.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,EACpB,QAAQ,EACR,KAAK,EACL,MAAgB,EAChB,IAAI,GACL,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C,IAAI,EAAE,SAAS,CAAC;CACjB,+BAYA;AAED,wBAAgB,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAAE,+BAMtF;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAM1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,gCA+BhC"}

package/dist/types/result-state/result-state-parts.d.ts

@@ -0,0 +1,61 @@
+import type { ResultStateActionsProps, ResultStateContentProps, ResultStateDescriptionProps, ResultStateFooterProps, ResultStateLive, ResultStateTitleProps } from './result-state.types';
+/**
+ * What the box tells the parts inside it: which role the announcing region
+ * carries, and the identifier the title falls back to so the box can be named
+ * by it.
+ *
+ * `registerTitle` carries the identifier rather than a boolean, because the
+ * title's own is not always the family's: a page that writes `id` on the title
+ * — to link a skip target at it, say — keeps that identifier, and the box has
+ * to point at the one that is actually in the DOM. Reporting only presence is
+ * how the first draft came to name the region by an identifier no element had.
+ *
+ * The APG's region landmark practice states that "a region landmark must have
+ * a label", so a `section` whose `aria-labelledby` points at nothing is a
+ * `section` with no accessible name and no landmark either.
+ */
+export interface ResultStateContextValue {
+    live: ResultStateLive;
+    titleId: string;
+    registerTitle: (id: string | null) => void;
+}
+export declare const ResultStateProvider: import("react").Provider<ResultStateContextValue | undefined>;
+/**
+ * The message itself, and the only part that announces.
+ *
+ * MDN's `alert` role reference states that the role "should only be used for
+ * text content, not interactive elements such as links or buttons", and this
+ * family has a row of buttons in it. So the region holds the title and the
+ * description, and the mark, the actions and the footer are its siblings.
+ *
+ * None of the seven surveyed implementations writes a live role of any kind,
+ * while WCAG 2.2's Understanding document for SC 4.1.3 names "No results
+ * returned" as its own example of a status message.
+ */
+export declare function ResultStateContent({ render, ...nativeProps }: ResultStateContentProps): 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;
+/**
+ * The message's name, and the box's. It renders a `div`: a heading puts the
+ * region in the document outline, which is right for a full-page 404 and wrong
+ * for the empty state of one card in a grid of twelve, and only the page knows
+ * which. `render` is how a page that wants one says so.
+ *
+ * Atlassian's `headingLevel`, one to six, is the field's answer. A numeric prop
+ * invites a skipped level, which the guide's section 10 forbids.
+ */
+export declare function ResultStateTitle({ render, ...nativeProps }: ResultStateTitleProps): 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;
+/** The message. A `p`, because that is what a paragraph of prose is. */
+export declare function ResultStateDescription({ render, ...nativeProps }: ResultStateDescriptionProps): 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;
+/**
+ * The controls that get the reader out of the situation, outside the region
+ * that announces. What goes in is the consumer's own `Button`s, because
+ * `button` already owns what a button is — including `loading`, which is what a
+ * retry in flight is.
+ */
+export declare function ResultStateActions({ render, ...nativeProps }: ResultStateActionsProps): 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;
+/**
+ * The line under the actions: the documentation link that is not a call to
+ * action. Polaris calls it `footerContent` and Atlassian a `tertiaryAction`,
+ * and both are right that it is neither of the buttons above it.
+ */
+export declare function ResultStateFooter({ render, ...nativeProps }: ResultStateFooterProps): 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=result-state-parts.d.ts.map

package/dist/types/result-state/result-state-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-state-parts.d.ts","sourceRoot":"","sources":["../../../src/result-state/result-state-parts.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,EAEf,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5C;AAID,eAAO,MAAM,mBAAmB,+DAA8B,CAAC;AAqB/D;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,uBAAuB,+VAWrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,qBAAqB,+VAgBjF;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,2BAA2B,+VAI7F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,uBAAuB,+VAIrF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,sBAAsB,+VAInF"}

package/dist/types/result-state/result-state.d.ts

@@ -0,0 +1,5 @@
+
+import type { ReactNode } from 'react';
+import type { ResultStateProps } from './result-state.types';
+export declare function ResultState({ align, children, illustration, live, media, reach, ref, render, status, ...nativeProps }: ResultStateProps): 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=result-state.d.ts.map

package/dist/types/result-state/result-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-state.d.ts","sourceRoot":"","sources":["../../../src/result-state/result-state.tsx"],"names":[],"mappings":"AAAA,OAAO,+CAA+C,CAAC;AAGvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,sBAAsB,CAAC;AAqDnF,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,KAAK,EACL,KAAK,EACL,GAAG,EACH,MAAM,EACN,MAAM,EACN,GAAG,WAAW,EACf,EAAE,gBAAgB,+TA2ClB"}

package/dist/types/result-state/result-state.types.d.ts

@@ -0,0 +1,115 @@
+import type { ComponentPropsWithRef, ReactNode } from 'react';
+/**
+ * What the region is reporting. Seven values rather than one component per
+ * semantic, which is what the guide's section 17 asks of `empty-state` and
+ * `error-state`.
+ *
+ * It is not a tone. Two pairs share one — `empty`, `no-results` and
+ * `not-found` are all secondary, `forbidden` and `offline` are both warning —
+ * so naming the axis `tone` would have made `forbidden` and `offline` one
+ * value.
+ */
+export type ResultStateStatus = 'empty' | 'no-results' | 'not-found' | 'error' | 'forbidden' | 'offline' | 'success';
+/**
+ * Which scope the message applies to, which is the axis `alert` already
+ * speaks: a row inside a cell, a panel inside a card, the whole route. The
+ * geometry follows from the scope; a size axis would say the same message can
+ * be drawn large or small, which is not the choice a consumer is making.
+ */
+export type ResultStateReach = 'inline' | 'section' | 'page';
+/** Whether the region reads centred or from the inline edge. */
+export type ResultStateAlign = 'center' | 'start';
+/**
+ * The picture the family draws around the page's glyph: a framed tile, three
+ * layers leaning back, or a stack of cards, all in the neutral surface and
+ * border roles. `none` draws nothing of the family's own, and `inline` reach
+ * draws none of them.
+ */
+export type ResultStateIllustration = 'none' | 'tile' | 'stack' | 'cards';
+/**
+ * Whether the text announces itself, and how loudly. The default is `polite`,
+ * where `alert`'s is `off`: WCAG 2.2's Understanding document for SC 4.1.3
+ * names this family's own text as its example of a status message, and a
+ * result state is by definition the outcome of an operation.
+ */
+export type ResultStateLive = 'off' | 'polite' | 'assertive';
+/** What an application sets once for every result state under it. */
+export interface ResultStateDefaults {
+    align: ResultStateAlign;
+    illustration: ResultStateIllustration;
+    live: ResultStateLive;
+    reach: ResultStateReach;
+    status: ResultStateStatus;
+}
+export interface ResultStateDefaultsProviderProps extends Partial<ResultStateDefaults> {
+    children?: ReactNode | undefined;
+}
+/** Props the family writes on whichever element `render` returns for a part. */
+export interface ResultStatePartProps extends ComponentPropsWithRef<'div'> {
+    'data-part': string;
+}
+export interface ResultStateRootProps extends ComponentPropsWithRef<'section'> {
+    'data-align': ResultStateAlign;
+    'data-illustration': ResultStateIllustration;
+    'data-live': ResultStateLive;
+    'data-part': string;
+    'data-reach': ResultStateReach;
+    'data-status': ResultStateStatus;
+    'data-ui': string;
+}
+export interface ResultStateContentProps extends ComponentPropsWithRef<'div'> {
+    /** Renders the announcing region into another element. */
+    render?: ((props: ResultStatePartProps) => ReactNode) | undefined;
+}
+export interface ResultStateTitleProps extends ComponentPropsWithRef<'div'> {
+    /**
+     * Renders the title into the element the page means. A heading puts the
+     * region in the document outline, which is right for a full-page 404 and
+     * wrong for the empty state of one card in a grid of twelve — only the page
+     * knows which.
+     */
+    render?: ((props: ResultStatePartProps) => ReactNode) | undefined;
+}
+export interface ResultStateDescriptionProps extends ComponentPropsWithRef<'p'> {
+    render?: ((props: ResultStatePartProps & ComponentPropsWithRef<'p'>) => ReactNode) | undefined;
+}
+export interface ResultStateActionsProps extends ComponentPropsWithRef<'div'> {
+    render?: ((props: ResultStatePartProps) => ReactNode) | undefined;
+}
+export interface ResultStateFooterProps extends ComponentPropsWithRef<'div'> {
+    render?: ((props: ResultStatePartProps) => ReactNode) | undefined;
+}
+export interface ResultStateProps extends Omit<ComponentPropsWithRef<'section'>, 'children'> {
+    children?: ReactNode | undefined;
+    /** Defaults to the provider, then to `empty`. */
+    status?: ResultStateStatus | undefined;
+    /** Defaults to the provider, then to `section`. */
+    reach?: ResultStateReach | undefined;
+    /** Defaults to the provider, then to `center`. */
+    align?: ResultStateAlign | undefined;
+    /** Defaults to the provider, then to `polite`. */
+    live?: ResultStateLive | undefined;
+    /**
+     * The drawing made around `media`. Defaults to the provider, then to `none`.
+     * `tile` and `stack` frame a glyph and draw nothing without one; `cards`
+     * puts the glyph where a row's thumbnail would be and draws its two lines
+     * with or without it.
+     */
+    illustration?: ResultStateIllustration | undefined;
+    /**
+     * The page's glyph, or its own illustration. It is projected into the box
+     * the family draws, so it keeps the height the reach gives it — which is
+     * what stops an illustration that has not loaded from moving the title and
+     * the actions when it arrives. With `illustration` set, a glyph here is what
+     * the drawing is made around. Unstated with `illustration="none"`, the box is
+     * withdrawn by the stylesheet and the region is a title, a description and an
+     * action (RS1).
+     */
+    media?: ReactNode | undefined;
+    /**
+     * Renders the box into another element — a `div` inside a table cell, a
+     * `main` for a route that is nothing but this region.
+     */
+    render?: ((props: ResultStateRootProps) => ReactNode) | undefined;
+}
+//# sourceMappingURL=result-state.types.d.ts.map

package/dist/types/result-state/result-state.types.d.ts.map

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

package/dist/types/saved-views/index.d.ts

@@ -0,0 +1,4 @@
+export { newSavedViewId, SavedViews } from './saved-views';
+export { usePersistedSavedViews } from './use-persisted-saved-views';
+export type { PersistedSavedViews, SavedViewsAction, SavedViewsHandle, SavedViewsOpenReason, SavedViewsProps, SavedViewsReason, SavedViewsRequest, UsePersistedSavedViewsOptions, } from './saved-views.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/saved-views/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/saved-views/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC"}

package/dist/types/saved-views/saved-views-demo.d.ts

@@ -0,0 +1,36 @@
+import { type GridColumn, type GridView, type GridViewStorage, type SavedViewsState } from '@slotted/core/grid';
+import type { SavedViewsProps } from './saved-views.types';
+export interface Order {
+    id: string;
+    customer: string;
+    region: string;
+    status: string;
+    total: number;
+    due: string;
+}
+export declare const ORDERS: Order[];
+export declare const COLUMNS: GridColumn<Order>[];
+/** The application's defaults: every column, sorted by order number. */
+export declare const BUILT_IN: GridView;
+export declare const LATE: GridView;
+export declare const REGION: GridView;
+export declare const HIGH: GridView;
+export declare const VIEWS: SavedViewsState;
+/** What the reader changes on the grid, as one press: the sort on the total. */
+export declare function sortedByTotal(view: GridView): GridView;
+/**
+ * The control over a stand-in for the grid: the current view as the line of
+ * text it is kept as, and one press that changes it. Every scene without a
+ * grid is this, so each one shows the request and the view it produced.
+ */
+export declare function ViewsBar({ initialView, ...props }: Partial<SavedViewsProps> & {
+    initialView?: GridView;
+}): import("react").JSX.Element;
+/** A store in memory that says what it holds, so a scene shows the entry written. */
+export declare function useMemoryStore(initial?: Record<string, string>): {
+    data: Record<string, string>;
+    storage: GridViewStorage;
+};
+/** The whole desk: the saved views above a grid, both kept in one store. */
+export declare function OrdersDesk(): import("react").JSX.Element;
+//# sourceMappingURL=saved-views-demo.d.ts.map

package/dist/types/saved-views/saved-views-demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saved-views-demo.d.ts","sourceRoot":"","sources":["../../../src/saved-views/saved-views-demo.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAW5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,MAAM,EAAE,KAAK,EAiEzB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAgCtC,CAAC;AAIF,wEAAwE;AACxE,eAAO,MAAM,QAAQ,EAAE,QAGtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,QAGlB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,QAIpB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,QAIlB,CAAC;AAIF,eAAO,MAAM,KAAK,EAAE,eAQnB,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAUtD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EACvB,WAAkB,EAClB,GAAG,KAAK,EACT,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,QAAQ,CAAA;CAAE,+BAmCvD;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;;;EAiBlE;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,gCAsCzB"}

package/dist/types/saved-views/saved-views.d.ts

@@ -0,0 +1,12 @@
+import type { SavedViewsProps } from './saved-views.types';
+/** `crypto.randomUUID()` where the platform has it, and a counter otherwise. */
+export declare function newSavedViewId(): string;
+/**
+ * The named views of a grid, and the one in use: a trigger naming it, a mark
+ * and a revert while the grid differs from it, and a popover listing every
+ * view with its actions. The family applies nothing to a grid — it asks with
+ * a state request and hands the consumer the view to write, through
+ * `onViewApply`.
+ */
+export declare function SavedViews({ builtIn, columns, current, defaultOpen, defaultState, messages, onOpenChange, onStateChange, onViewApply, open: openProp, ref, state: stateProp, ...rest }: SavedViewsProps): import("react").JSX.Element;
+//# sourceMappingURL=saved-views.d.ts.map

package/dist/types/saved-views/saved-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saved-views.d.ts","sourceRoot":"","sources":["../../../src/saved-views/saved-views.tsx"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAGV,eAAe,EAGhB,MAAM,qBAAqB,CAAC;AAa7B,gFAAgF;AAChF,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAMD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,OAAO,EACP,OAAO,EACP,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACX,IAAI,EAAE,QAAQ,EACd,GAAG,EACH,KAAK,EAAE,SAAS,EAChB,GAAG,IAAI,EACR,EAAE,eAAe,+BA6cjB"}

package/dist/types/saved-views/saved-views.types.d.ts

@@ -0,0 +1,83 @@
+import type { GridColumn, GridView, GridViewStorage, SavedViewsState } from '@slotted/core/grid';
+import type { PartialMessages, SavedViewsMessages } from '@slotted/core/i18n';
+import type { ChangeRequest } from '@slotted/core/state';
+import type { ComponentPropsWithRef, Ref } from 'react';
+/** What the reader did. One state object answers seven different presses. */
+export type SavedViewsAction = 'apply' | 'save' | 'create' | 'rename' | 'delete' | 'default' | 'revert';
+/** Why the views moved. `submit` is a form; `remove` a confirmed delete. */
+export type SavedViewsReason = Extract<ChangeRequest<unknown>['reason'], 'pointer' | 'keyboard' | 'submit' | 'remove' | 'programmatic'>;
+/** Why the layer opened or closed: the popover's own reasons. */
+export type SavedViewsOpenReason = Extract<ChangeRequest<boolean>['reason'], 'pointer' | 'keyboard' | 'escape' | 'outsidePress' | 'dismiss' | 'programmatic'>;
+/**
+ * The request every change carries: the state asked for, the one it
+ * replaces, the reason, what the reader did, the originating event, and a
+ * refusal that stops the change before anything commits.
+ */
+export interface SavedViewsRequest {
+    readonly value: SavedViewsState;
+    readonly previous: SavedViewsState;
+    readonly reason: SavedViewsReason;
+    readonly action: SavedViewsAction;
+    /** The originating event, when one exists. */
+    readonly source?: unknown;
+    readonly cancelled: boolean;
+    /** Refuses the request. Nothing commits and no view is applied. */
+    cancel(): void;
+}
+/** The imperative actions a consumer cannot express declaratively. */
+export interface SavedViewsHandle {
+    /** The root element. */
+    readonly element: HTMLDivElement | null;
+    /** Moves focus to the trigger. */
+    focus: () => void;
+    /** Opens the layer, carrying `programmatic`. */
+    open: () => void;
+    /** Closes the layer, carrying `programmatic`. */
+    close: () => void;
+    /** Applies a view by id — `null` is the built-in view — carrying `programmatic`. */
+    apply: (id: string | null) => void;
+}
+export interface SavedViewsProps extends Omit<ComponentPropsWithRef<'div'>, 'ref' | 'defaultValue' | 'onChange'> {
+    /** The view the grid shows now. */
+    current: GridView;
+    /** The built-in view: the application's defaults. */
+    builtIn: GridView;
+    /** The model, so a view is serialized and compared against the columns it names. */
+    columns?: readonly GridColumn<never>[] | undefined;
+    /** Present means the consumer owns the views, for the life of the component. */
+    state?: SavedViewsState | undefined;
+    /** The views an uncontrolled instance starts from, read once. */
+    defaultState?: SavedViewsState | undefined;
+    onStateChange?: ((state: SavedViewsState, request: SavedViewsRequest) => void) | undefined;
+    /** After apply and revert: the view to write into the grid. */
+    onViewApply?: ((view: GridView, request: SavedViewsRequest) => void) | undefined;
+    open?: boolean | undefined;
+    defaultOpen?: boolean | undefined;
+    onOpenChange?: ((open: boolean, request: ChangeRequest<boolean>) => void) | undefined;
+    /**
+     * Words laid over the catalog of the language in force, key by key: the
+     * group's and the panel's name (`label`), the controls, the forms and the
+     * announcements. A native `aria-label` names both instead.
+     */
+    messages?: PartialMessages<SavedViewsMessages> | undefined;
+    ref?: Ref<SavedViewsHandle> | undefined;
+}
+export interface UsePersistedSavedViewsOptions {
+    /** The entry the views are kept under. */
+    readonly key: string;
+    /** Default `window.localStorage`; `null` keeps the views in memory only. */
+    readonly storage?: GridViewStorage | null | undefined;
+    /** The model, so the default view a visit opens on is parsed against it. */
+    readonly columns?: readonly GridColumn<never>[] | undefined;
+}
+export interface PersistedSavedViews {
+    readonly state: SavedViewsState;
+    readonly onStateChange: (state: SavedViewsState) => void;
+    /**
+     * The default view this visit opened on, when the store held no view in use
+     * and a default: the state already names it as active, and the grid still
+     * has to be given it once. `null` otherwise.
+     */
+    readonly openedDefault: GridView | null;
+}
+//# sourceMappingURL=saved-views.types.d.ts.map

package/dist/types/saved-views/saved-views.types.d.ts.map

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