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

package/dist/types/app-shell/app-shell.types.d.ts

@@ -0,0 +1,312 @@
+import type { AppShellMessages, FamilyTranslator, PartialMessages } from '@slotted/core/i18n';
+import type { ChangeRequest } from '@slotted/core/state';
+import type { ComponentPropsWithRef, HTMLAttributes, ReactNode, RefObject } from 'react';
+import type { ProgressBarProps } from '../progress-indicator';
+/**
+ * Which region reaches the corner of the screen. `banner` spans the full width
+ * and the navigation starts below it; `nav` spans the full height and the
+ * banner starts beside it; `main` spans the navigation the full height as well
+ * and puts the banner in the plane of the content, inside the card that holds
+ * it. The grid changes where a region is drawn and never where it is written,
+ * so the focus order is the same under all three.
+ */
+export type AppShellPrimary = 'banner' | 'nav' | 'main';
+/**
+ * Which surface carries which plane, for every region at once. `inset` paints
+ * the frame with the sunken ground and makes the content a raised card;
+ * `flush` runs every region edge to edge, separated at its seams; `floating`
+ * makes the navigation a card as well as the content; `panel` holds the
+ * navigation, the content and the pane in one card, the banner on the frame
+ * above it.
+ */
+export type AppShellCanvas = 'inset' | 'flush' | 'floating' | 'panel';
+/**
+ * What draws a seam where two regions touch without a gutter. `rule` is a
+ * line; `tone` is a ground of its own on the chrome regions, 0.036 OKLab L
+ * from the surface, with the subtle tones inside them recomputed from it.
+ */
+export type AppShellSeparation = 'rule' | 'tone';
+/**
+ * How the navigation region occupies space. `inline` makes it a column of the
+ * grid, `overlay` takes it out of the grid and over the content as a
+ * dismissable layer, and `auto` is `inline` at or above the shell's own
+ * `overlayAt` inline size and `overlay` below it.
+ */
+export type AppShellNavMode = 'inline' | 'overlay' | 'auto';
+/**
+ * How the secondary pane occupies space: the navigation's pair, resolved on the
+ * same width. A detail pane at 1280 pixels is a column and at 600 is a layer.
+ */
+export type AppShellAsideMode = 'inline' | 'overlay' | 'auto';
+/** Which end of the line the navigation region sits at. Logical, so the layout mirrors. */
+export type AppShellNavSide = 'start' | 'end';
+/**
+ * What a closed inline navigation leaves behind. `rail` keeps a strip the width
+ * of a target, which keeps the destinations reachable and the region in the tab
+ * order; `hidden` takes the region out of the layout and out of the tab order.
+ */
+export type AppShellCollapsedTo = 'rail' | 'hidden';
+/** A step on the region's own width scale. A theme retunes a step; it cannot retune `240px`. */
+export type AppShellSize = 'sm' | 'md' | 'lg';
+/**
+ * Who scrolls. `content` makes the shell the height it was given and lets only
+ * the content column scroll; `document` lets the shell grow and the document
+ * scroll, and the banner travels with it.
+ */
+export type AppShellScroll = 'content' | 'document';
+/** Whether a dismissal source closes the overlaid navigation. */
+export type AppShellDismissPolicy = 'close' | 'none';
+/** Why the navigation region opened or closed. */
+export type AppShellOpenReason = 'pointer' | 'keyboard' | 'escape' | 'outsidePress' | 'back' | 'select' | 'resize' | 'programmatic';
+/** Why the secondary pane opened or closed. No `select`: a pane has no destinations. */
+export type AppShellAsideOpenReason = Exclude<AppShellOpenReason, 'select'>;
+/** Why the pane's extent moved. */
+export type AppShellAsideExtentReason = 'pointer' | 'keyboard' | 'programmatic';
+/** What an application sets once for every shell under it. */
+export interface AppShellDefaults {
+    asideMode: AppShellAsideMode;
+    asideSize: AppShellSize;
+    canvas: AppShellCanvas;
+    closeOnNavigate: boolean;
+    collapsedTo: AppShellCollapsedTo;
+    separation: AppShellSeparation;
+    escape: AppShellDismissPolicy;
+    /** The platform's way back — a phone's gesture, a browser's button — closes a modal layer. */
+    back: AppShellDismissPolicy;
+    modal: boolean;
+    navMode: AppShellNavMode;
+    navSide: AppShellNavSide;
+    navSize: AppShellSize;
+    outsidePress: AppShellDismissPolicy;
+    primary: AppShellPrimary;
+    scroll: AppShellScroll;
+}
+export interface AppShellDefaultsProviderProps extends Partial<AppShellDefaults> {
+    children?: ReactNode | undefined;
+}
+/**
+ * The request the shell makes before the navigation region moves. Cancel it and
+ * nothing commits; read `reason` to tell the reader's own choice from the one
+ * the layout forced.
+ */
+export interface AppShellOpenRequest extends Omit<ChangeRequest<boolean>, 'reason'> {
+    reason: AppShellOpenReason;
+}
+/** The request the shell makes before the secondary pane moves. */
+export interface AppShellAsideOpenRequest extends Omit<ChangeRequest<boolean>, 'reason'> {
+    reason: AppShellAsideOpenReason;
+}
+/**
+ * The request the shell makes before the pane's extent moves. `undefined` is
+ * the pane back on the measure its size step gives it.
+ */
+export interface AppShellAsideExtentRequest extends Omit<ChangeRequest<number | undefined>, 'reason'> {
+    reason: AppShellAsideExtentReason;
+}
+/** The imperative actions a consumer cannot express declaratively. */
+export interface AppShellHandle {
+    /** Asks to show the navigation region, with the reason `programmatic`. */
+    openNav: () => void;
+    /** Asks to hide it, with the reason `programmatic`. */
+    closeNav: () => void;
+    /** Asks to show the secondary pane, with the reason `programmatic`. */
+    openAside: () => void;
+    /** Asks to hide it, with the reason `programmatic`. */
+    closeAside: () => void;
+    /** Moves focus into the content region, which is where a skip link sends it. */
+    focusMain: () => void;
+    /** The root element, once it is in the document. */
+    readonly root: HTMLElement | null;
+}
+/** What every part of the family reads from the shell around it. */
+export interface AppShellContextValue {
+    /** The resolved pane mode, which is `auto` answered against the shell's own width. */
+    asideMode: Exclude<AppShellAsideMode, 'auto'> | undefined;
+    asideOpen: boolean;
+    asideSize: AppShellSize;
+    /** The pane's measure as a fraction of the shell, or `undefined` while the size step decides. */
+    asideExtent: number | undefined;
+    minAsideExtent: number;
+    maxAsideExtent: number;
+    /** Whether a pointer is moving the pane's edge, which the root reports as `data-dragging`. */
+    asideDragging: boolean;
+    canvas: AppShellCanvas;
+    closeOnNavigate: boolean;
+    collapsedTo: AppShellCollapsedTo;
+    separation: AppShellSeparation;
+    escape: AppShellDismissPolicy;
+    /** The platform's way back — a phone's gesture, a browser's button — closes a modal layer. */
+    back: AppShellDismissPolicy;
+    /** The family's words in the language in force, with this shell's `messages` laid over them. */
+    t: FamilyTranslator<AppShellMessages>;
+    modal: boolean;
+    /** The resolved mode, which is `auto` answered against the shell's own width. */
+    navMode: Exclude<AppShellNavMode, 'auto'> | undefined;
+    navSide: AppShellNavSide;
+    navSize: AppShellSize;
+    open: boolean;
+    outsidePress: AppShellDismissPolicy;
+    primary: AppShellPrimary;
+    scroll: AppShellScroll;
+    /** The ids the toggles and the regions use to point at each other. */
+    navId: string;
+    toggleId: string;
+    mainId: string;
+    asideId: string;
+    asideToggleId: string;
+    /** Asks to move the navigation region. A consumer's own handler runs first and may cancel. */
+    setOpen: (next: boolean, reason: AppShellOpenReason, source?: unknown) => void;
+    /** Asks to move the secondary pane. */
+    setAsideOpen: (next: boolean, reason: AppShellAsideOpenReason, source?: unknown) => void;
+    /** Asks to move the pane's extent, held inside the limits. */
+    setAsideExtent: (next: number | undefined, reason: AppShellAsideExtentReason, source?: unknown) => void;
+    setAsideDragging: (dragging: boolean) => void;
+    /** The root, which the pane's extent is a fraction of. */
+    root: HTMLElement | null;
+    /** A region says it exists, so a skip link is never written to a target nobody rendered. */
+    register: (region: 'nav' | 'main' | 'aside') => () => void;
+    /** Whether the bar on the content's edge is painted, which `main` reports as `aria-busy`. */
+    busy: boolean;
+    /** The progress part says when its bar is painted and when it is withdrawn. */
+    setBusy: (busy: boolean) => void;
+    /** The nodes the layer and the focus scope need, and nothing else reads. */
+    nodes: {
+        aside: HTMLElement | null;
+        asideToggle: HTMLElement | null;
+        banner: HTMLElement | null;
+        footer: HTMLElement | null;
+        main: HTMLElement | null;
+        nav: HTMLElement | null;
+        toggle: HTMLElement | null;
+    };
+}
+/** What `render` receives for the root. */
+export interface AppShellRootProps extends HTMLAttributes<HTMLElement> {
+    'data-aside-mode'?: 'inline' | 'overlay' | undefined;
+    'data-aside-size': AppShellSize;
+    'data-canvas': AppShellCanvas;
+    'data-collapsed-to': AppShellCollapsedTo;
+    'data-dragging'?: '' | undefined;
+    'data-nav-mode'?: 'inline' | 'overlay' | undefined;
+    'data-nav-side': AppShellNavSide;
+    'data-nav-size': AppShellSize;
+    'data-open'?: '' | undefined;
+    'data-part': string;
+    'data-primary': AppShellPrimary;
+    'data-scroll': AppShellScroll;
+    'data-separation': AppShellSeparation;
+    'data-ui': 'app-shell';
+}
+type Native<T extends keyof HTMLElementTagNameMap> = Omit<ComponentPropsWithRef<T>, 'children' | 'className' | 'style'>;
+interface Common {
+    children?: ReactNode | undefined;
+    className?: string | undefined;
+    style?: React.CSSProperties | undefined;
+}
+export interface AppShellProps extends Omit<Native<'div'>, 'ref'>, Common {
+    /**
+     * How much of the shell's inline size the pane takes as a column, in
+     * `[0, 1]`. Unset means `asideSize` decides. Passing anything but
+     * `undefined` puts the extent in controlled mode.
+     */
+    asideExtent?: number | undefined;
+    asideMode?: AppShellAsideMode | undefined;
+    /** The controlled value of the secondary pane. */
+    asideOpen?: boolean | undefined;
+    asideSize?: AppShellSize | undefined;
+    canvas?: AppShellCanvas | undefined;
+    /** A click on an `a[href]` inside the overlaid region asks to close, with the reason `select`. */
+    closeOnNavigate?: boolean | undefined;
+    collapsedTo?: AppShellCollapsedTo | undefined;
+    /** The uncontrolled starting extent of the pane, read once. */
+    defaultAsideExtent?: number | undefined;
+    /** The uncontrolled starting value of the pane, read once. */
+    defaultAsideOpen?: boolean | undefined;
+    /** The uncontrolled starting value, read once. */
+    defaultNavOpen?: boolean | undefined;
+    escape?: AppShellDismissPolicy | undefined;
+    /**
+     * The platform's way back — a phone's gesture, a browser's button — closes
+     * a modal layer instead of leaving the page. Defaults to the provider, then `close`.
+     */
+    back?: AppShellDismissPolicy | undefined;
+    /**
+     * Words laid over the catalog of the language in force, key by key: the
+     * landmarks' names, the toggles and the skip links. A native `aria-label` on
+     * a part still wins.
+     */
+    messages?: PartialMessages<AppShellMessages> | undefined;
+    /** The largest extent the reader may give the pane. Defaults to `0.6`. */
+    maxAsideExtent?: number | undefined;
+    /** The smallest extent the reader may give the pane. Defaults to `0.16`. */
+    minAsideExtent?: number | undefined;
+    /** Whether the overlaid region contains focus and makes the rest of the shell `inert`. */
+    modal?: boolean | undefined;
+    /** The controlled value. Passing anything but `undefined` puts the shell in controlled mode. */
+    navOpen?: boolean | undefined;
+    navMode?: AppShellNavMode | undefined;
+    navSide?: AppShellNavSide | undefined;
+    navSize?: AppShellSize | undefined;
+    onAsideExtentChange?: ((extent: number | undefined, request: AppShellAsideExtentRequest) => void) | undefined;
+    onAsideOpenChange?: ((open: boolean, request: AppShellAsideOpenRequest) => void) | undefined;
+    onNavOpenChange?: ((open: boolean, request: AppShellOpenRequest) => void) | undefined;
+    outsidePress?: AppShellDismissPolicy | undefined;
+    primary?: AppShellPrimary | undefined;
+    ref?: RefObject<AppShellHandle | null> | ((handle: AppShellHandle | null) => void) | undefined;
+    /** Substitutes the rendered element, keeping every attribute and listener. */
+    render?: ((props: AppShellRootProps) => ReactNode) | undefined;
+    scroll?: AppShellScroll | undefined;
+    /** What draws a seam where two regions touch without a gutter. Defaults to the provider, then `rule`. */
+    separation?: AppShellSeparation | undefined;
+}
+export interface AppShellBannerProps extends Native<'header'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export interface AppShellBrandProps extends Native<'div'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export interface AppShellActionsProps extends Native<'div'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export interface AppShellCentreProps extends Native<'div'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export interface AppShellNavProps extends Native<'nav'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export interface AppShellNavSectionProps extends Native<'div'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+/**
+ * The bar's own props, less the placement the shell decides. `size` defaults
+ * to `sm`, `delay` to 200 and `minDuration` to 400 milliseconds; a value set
+ * here, then one set through `ProgressIndicatorDefaultsProvider`, wins.
+ */
+export type AppShellProgressProps = Omit<ProgressBarProps, 'placement'>;
+export interface AppShellMainProps extends Native<'main'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export interface AppShellAsideProps extends Native<'aside'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export interface AppShellAsideSectionProps extends Native<'div'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export interface AppShellAsideBodyProps extends AppShellAsideSectionProps {
+    /** `none` drops the body's own padding, for content that brings its own inset. */
+    inset?: 'none' | undefined;
+}
+export interface AppShellAsideResizerProps extends Native<'div'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export interface AppShellAsideToggleProps extends Native<'button'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export interface AppShellFooterProps extends Native<'footer'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export interface AppShellNavToggleProps extends Native<'button'>, Common {
+    render?: ((props: HTMLAttributes<HTMLElement>) => ReactNode) | undefined;
+}
+export {};
+//# sourceMappingURL=app-shell.types.d.ts.map

package/dist/types/app-shell/app-shell.types.d.ts.map

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

package/dist/types/app-shell/index.d.ts

@@ -0,0 +1,5 @@
+export { APP_SHELL_OVERLAY_AT, AppShell, useAppShell, useAppShellIfPresent } from './app-shell';
+export { AppShellActions, AppShellAside, AppShellAsideBody, AppShellAsideFooter, AppShellAsideHeader, AppShellAsideResizer, AppShellAsideToggle, AppShellBanner, AppShellBrand, AppShellCentre, AppShellFooter, AppShellMain, AppShellNav, AppShellNavBody, AppShellNavFooter, AppShellNavHeader, AppShellNavRail, AppShellNavToggle, AppShellProgress, } from './app-shell-parts';
+export { AppShellDefaultsProvider, useAppShellDefaults } from './app-shell-defaults';
+export type { AppShellActionsProps, AppShellAsideBodyProps, AppShellAsideExtentReason, AppShellAsideExtentRequest, AppShellAsideMode, AppShellAsideOpenReason, AppShellAsideOpenRequest, AppShellAsideProps, AppShellAsideResizerProps, AppShellAsideSectionProps, AppShellAsideToggleProps, AppShellBannerProps, AppShellBrandProps, AppShellCanvas, AppShellCentreProps, AppShellCollapsedTo, AppShellContextValue, AppShellDefaults, AppShellDefaultsProviderProps, AppShellDismissPolicy, AppShellFooterProps, AppShellHandle, AppShellMainProps, AppShellNavMode, AppShellNavProps, AppShellNavSectionProps, AppShellNavSide, AppShellNavToggleProps, AppShellOpenReason, AppShellOpenRequest, AppShellPrimary, AppShellProgressProps, AppShellProps, AppShellRootProps, AppShellScroll, AppShellSeparation, AppShellSize, } from './app-shell.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/app-shell/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/app-shell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACrF,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,6BAA6B,EAC7B,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC"}

package/dist/types/aspect-ratio/aspect-ratio.d.ts

@@ -0,0 +1,25 @@
+
+import type { AspectRatioAttribute, AspectRatioProps, AspectRatioValue } from './aspect-ratio.types';
+/**
+ * The attribute the stylesheet keys on, and the token the instance writes
+ * when the ratio is a number rather than a name. A pair is written as it was
+ * given, `16 / 9`, so the DOM says what the consumer said; a number is its
+ * own quotient. A name writes no token: the stylesheet holds the five.
+ */
+export declare function resolveAspectRatio(ratio: AspectRatioValue): {
+    attribute: AspectRatioAttribute;
+    token: string | undefined;
+};
+/**
+ * A box that is a stated proportion of its own width before anything is in
+ * it, so a picture, a map or an embedded player arrives into room already
+ * held for it and moves nothing below.
+ *
+ * It is the platform's `aspect-ratio`, not the padding hack, and the
+ * difference is what happens to content taller than the box: the frame keeps
+ * the ratio while the content fits and grows when it does not. Nothing is
+ * clipped and nothing escapes. The frame reserves; the crop is `Image`'s
+ * decision.
+ */
+export declare function AspectRatio({ children, ratio, render, style, ...nativeProps }: AspectRatioProps): 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=aspect-ratio.d.ts.map

package/dist/types/aspect-ratio/aspect-ratio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aspect-ratio.d.ts","sourceRoot":"","sources":["../../../src/aspect-ratio/aspect-ratio.tsx"],"names":[],"mappings":"AAAA,OAAO,+CAA+C,CAAC;AAIvD,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAEhB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAI9B;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG;IAC3D,SAAS,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CASA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,EAAE,gBAAgB,+VAiB/F"}

package/dist/types/aspect-ratio/aspect-ratio.types.d.ts

@@ -0,0 +1,35 @@
+import type { ComponentPropsWithRef, HTMLAttributes, ReactNode } from 'react';
+/**
+ * The five ratios a product decides once, named for what they hold rather
+ * than for their numbers, so the decision reads in the DOM.
+ */
+export type AspectRatioName = 'square' | 'landscape' | 'portrait' | 'video' | 'wide';
+/**
+ * A name, a number (`16 / 9`), or the pair the number came from (`[16, 9]`).
+ * The pair is written into the stylesheet exactly, where a number would be
+ * written as its quotient.
+ */
+export type AspectRatioValue = AspectRatioName | number | readonly [number, number];
+/** What the DOM says the ratio is: one of the names, or `custom` for a number. */
+export type AspectRatioAttribute = AspectRatioName | 'custom';
+/**
+ * What `render` receives. Written against `HTMLAttributes<HTMLElement>` so it
+ * can be spread onto any element, which is what makes the substitution real.
+ */
+export interface AspectRatioRootProps extends HTMLAttributes<HTMLElement> {
+    children?: ReactNode | undefined;
+    'data-part': string;
+    'data-ratio': AspectRatioAttribute;
+    'data-ui': string;
+}
+export interface AspectRatioProps extends ComponentPropsWithRef<'div'> {
+    /**
+     * The proportion the box holds before anything is in it. Required: the
+     * ratio is the consumer's decision, and a frame that named none is a frame
+     * nobody thought about.
+     */
+    ratio: AspectRatioValue;
+    /** Renders the frame into another element — a `figure`, an `li`. */
+    render?: ((props: AspectRatioRootProps) => ReactNode) | undefined;
+}
+//# sourceMappingURL=aspect-ratio.types.d.ts.map

package/dist/types/aspect-ratio/aspect-ratio.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aspect-ratio.types.d.ts","sourceRoot":"","sources":["../../../src/aspect-ratio/aspect-ratio.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAErF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpF,kFAAkF;AAClF,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG,QAAQ,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACvE,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,oBAAoB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,qBAAqB,CAAC,KAAK,CAAC;IACpE;;;;OAIG;IACH,KAAK,EAAE,gBAAgB,CAAC;IACxB,oEAAoE;IACpE,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,oBAAoB,KAAK,SAAS,CAAC,GAAG,SAAS,CAAC;CACnE"}

package/dist/types/aspect-ratio/index.d.ts

@@ -0,0 +1,3 @@
+export { AspectRatio, resolveAspectRatio } from './aspect-ratio';
+export type { AspectRatioAttribute, AspectRatioName, AspectRatioProps, AspectRatioRootProps, AspectRatioValue, } from './aspect-ratio.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/aspect-ratio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/aspect-ratio/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { AttachmentDefaults, AttachmentDefaultsProviderProps } from './attachment.types';
+/** What an attachment renders as here, before its group or itself states anything. */
+export declare function useAttachmentDefaults(): AttachmentDefaults;
+/**
+ * An application decides once how large its attachments are and how a set of
+ * them is arranged. A group or an attachment that states either still wins.
+ * Their words and the locale that writes their sizes come from the language
+ * in force (`SlottedProvider`).
+ */
+export declare function AttachmentDefaultsProvider({ children, ...defaults }: AttachmentDefaultsProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=attachment-defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-defaults.d.ts","sourceRoot":"","sources":["../../../src/attachment/attachment-defaults.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAU9F,sFAAsF;AACtF,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,GAAG,QAAQ,EACZ,EAAE,+BAA+B,+BAcjC"}

package/dist/types/attachment/attachment-kinds.d.ts

@@ -0,0 +1,21 @@
+import type { GlyphName } from '@slotted/core/glyph';
+import type { FileKind } from '@slotted/core/upload';
+/**
+ * The mark knocked out of each kind's tile. It is the map `upload` draws its
+ * rows with, restated here because that one is private to `upload`; the
+ * contract test reads both contracts' `kinds` and refuses a drift, so a PDF
+ * never has two marks.
+ */
+export declare const ATTACHMENT_KIND_GLYPH: Readonly<Record<FileKind, GlyphName>>;
+/**
+ * The controls `removal-focus` counts. An attachment in a set holds the same
+ * controls as its neighbours, so the position focus had among them is the
+ * position of the same control on the attachment that took its place.
+ */
+export declare const ATTACHMENT_CONTROL_SELECTOR = "[data-part=\"trigger\"], [data-part=\"action\"], [data-part=\"remove\"]";
+/**
+ * The extension as the card writes it: `PDF`, or the catalog's `noExtension`
+ * word when the name has none.
+ */
+export declare function extensionLabel(extension: string, none: string): string;
+//# sourceMappingURL=attachment-kinds.d.ts.map

package/dist/types/attachment/attachment-kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-kinds.d.ts","sourceRoot":"","sources":["../../../src/attachment/attachment-kinds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAUvE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,4EAC6B,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE"}

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

@@ -0,0 +1,67 @@
+import type { AttachmentActionProps, AttachmentFilenameProps, AttachmentLinkProps, AttachmentPartProps, AttachmentPreviewProps, AttachmentProgressProps, AttachmentTextProps, AttachmentTriggerProps } from './attachment.types';
+/**
+ * The kind's tile with the kind's mark knocked out of it, or the thumbnail
+ * the page gives. A thumbnail that fails to load returns to the tile: the
+ * failure is this part's own state, not a state of the file.
+ *
+ * Hidden from assistive technology, because the file name already says what
+ * the file is and the tile would say it a second time.
+ */
+export declare function AttachmentPreview({ children, render, src, ...nativeProps }: AttachmentPreviewProps): 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 text column, and the one box in the attachment that may shrink. */
+export declare function AttachmentBody({ render, ...nativeProps }: AttachmentPartProps): 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 file name as two runs — the stem, which shrinks to an ellipsis, and the
+ * extension, which does not — laid out in the name's own direction.
+ */
+export declare function AttachmentFilename({ children, render, ...nativeProps }: AttachmentFilenameProps): 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 file's target when the page opens it itself — a viewer, a preview
+ * dialog. A real `button`: `disabled` while the file is loading or
+ * unavailable, which also refuses the duplicate open. Its name is the file
+ * name, and its description the detail and the message.
+ */
+export declare function AttachmentTrigger({ 'aria-describedby': ariaDescribedBy, children, render, type, ...nativeProps }: AttachmentTriggerProps): 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 file's target when it has an address. A real `a`, so `href`,
+ * `download` and the modified click a browser gives a link stay the
+ * platform's. While the file is loading or unavailable it takes
+ * `aria-disabled="true"`, keeps its destination and refuses the activation —
+ * perceivable, not operable — which is `list-item`'s rule for a link row.
+ */
+export declare function AttachmentLink({ 'aria-describedby': ariaDescribedBy, children, onClick, render, ...nativeProps }: AttachmentLinkProps): 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 name. Absent children, it writes the size with
+ * `formatBytes` in the language in force; anything the page writes replaces
+ * it — a date, a sender, `Uploading · 62%`.
+ */
+export declare function AttachmentDetail({ children, id, render, ...nativeProps }: AttachmentTextProps): 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;
+/** Why the file failed, or anything longer than a line the page must say about it. */
+export declare function AttachmentMessage({ id, render, ...nativeProps }: AttachmentTextProps): 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 transfer, as the attachment's bottom edge: `progress-indicator`'s bar,
+ * named by the file so a reader hears `claim-form.pdf, 62%`. Without a
+ * `value` the bar is indeterminate — a scan, a conversion, a wait the page
+ * cannot measure.
+ */
+export declare function AttachmentProgress({ render, value, ...nativeProps }: AttachmentProgressProps): 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 the application offers on the file, beside the trigger and
+ * above its stretched target: interactive content may not nest inside `a`
+ * or `button`.
+ */
+export declare function AttachmentActions({ render, ...nativeProps }: AttachmentPartProps): 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;
+/**
+ * One icon control of the application's own — download, share, reply with.
+ * It is an inner control: no frame at rest, a state layer under the pointer.
+ * It needs an `aria-label`, because it holds only a glyph. `render` puts it on
+ * an `a` with `download`; an unavailable attachment disables it.
+ */
+export declare function AttachmentAction({ render, type, ...nativeProps }: AttachmentActionProps): 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;
+/**
+ * Asks to take the attachment out of its list. It renders only when the
+ * attachment has `onRemove`, so a read-only thread never shows a control that
+ * does nothing. Its name is the word and the file, `Remove claim-form.pdf`.
+ */
+export declare function AttachmentRemove({ 'aria-label': ariaLabel, children, onClick, render, type, ...nativeProps }: AttachmentActionProps): 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=attachment-parts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-parts.d.ts","sourceRoot":"","sources":["../../../src/attachment/attachment-parts.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,qBAAqB,EAErB,uBAAuB,EACvB,mBAAmB,EAEnB,mBAAmB,EAEnB,sBAAsB,EAEtB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EAEvB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,MAAM,EACN,GAAG,EACH,GAAG,WAAW,EACf,EAAE,sBAAsB,+VAuBxB;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,mBAAmB,+VAG7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,uBAAuB,+VAgB/F;AAqBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,kBAAkB,EAAE,eAAe,EACnC,QAAQ,EACR,MAAM,EACN,IAAe,EACf,GAAG,WAAW,EACf,EAAE,sBAAsB,+VAcxB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,kBAAkB,EAAE,eAAe,EACnC,QAAQ,EACR,OAAO,EACP,MAAM,EACN,GAAG,WAAW,EACf,EAAE,mBAAmB,+VAoBrB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,mBAAmB,+VAa7F;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,mBAAmB,+VAUpF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,EAAE,uBAAuB,+VAkB5F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,mBAAmB,+VAGhF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,IAAe,EACf,GAAG,WAAW,EACf,EAAE,qBAAqB,+VAWvB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,YAAY,EAAE,SAAS,EACvB,QAAQ,EACR,OAAO,EACP,MAAM,EACN,IAAe,EACf,GAAG,WAAW,EACf,EAAE,qBAAqB,+VAuBvB"}

package/dist/types/attachment/attachment.d.ts

@@ -0,0 +1,41 @@
+
+import type { AttachmentContextValue, AttachmentGroupProps, AttachmentProps } from './attachment.types';
+/**
+ * What the attachment around a part knows. A part outside one is a mistake
+ * the page can see at once, so it throws rather than drawing an empty tile.
+ */
+export declare function useAttachment(): AttachmentContextValue;
+/**
+ * A set of attachments: a native list, arranged as a column, a wrapping grid
+ * or one line that scrolls. It hands its size and orientation to every
+ * attachment that does not state its own.
+ *
+ * It keeps the keyboard where it was when an attachment leaves: focus goes to
+ * the control that took the removed one's place, then to the last one, then
+ * to the list itself — which is why the list takes `tabIndex={-1}`.
+ * `removal-focus` observes the DOM, so it is right however the consumer
+ * removed the file.
+ */
+export declare function AttachmentGroup({ layout, orientation, ref, render, size, ...nativeProps }: AttachmentGroupProps): import("react").JSX.Element;
+/**
+ * One file that already belongs to something — a message, a record, a tray.
+ * The parts inside it read the file from here: the tile its kind, the trigger
+ * its name, the detail its size.
+ *
+ * It renders an `li` inside an `AttachmentGroup` and a `div` alone, because a
+ * list item outside a list is an error a reader hears.
+ *
+ * **Removal is a request.** `onRemove` is what makes the attachment removable:
+ * `AttachmentRemove` renders, and `Backspace` and `Delete` answer anywhere
+ * inside the attachment. A repeat of a held key is ignored, because it would
+ * remove the attachment focus has just landed on.
+ */
+export declare function Attachment({ disabled, file, invalid, loading, messages, onKeyDown, onRemove, orientation, render, size, ...nativeProps }: AttachmentProps): import("react").JSX.Element;
+/**
+ * Registers a describing part with the attachment for as long as it is on the
+ * page, so the trigger's `aria-describedby` names only what exists. It runs
+ * after the first paint, so the server's markup and the client's first render
+ * agree and the description arrives with the effect.
+ */
+export declare function useDescribes(part: 'detail' | 'message', own: string | undefined): string;
+//# sourceMappingURL=attachment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../../src/attachment/attachment.tsx"],"names":[],"mappings":"AAAA,OAAO,2CAA2C,CAAC;AAoBnD,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EAIpB,eAAe,EAIhB,MAAM,oBAAoB,CAAC;AAW5B;;;GAGG;AACH,wBAAgB,aAAa,IAAI,sBAAsB,CAItD;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,WAAW,EACX,GAAG,EACH,MAAM,EACN,IAAI,EACJ,GAAG,WAAW,EACf,EAAE,oBAAoB,+BAyCtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAgB,EAChB,IAAI,EACJ,OAAe,EACf,OAAe,EACf,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,WAAW,EACX,MAAM,EACN,IAAI,EACJ,GAAG,WAAW,EACf,EAAE,eAAe,+BAgFjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQxF"}