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

package/dist/types/tour/tour.types.d.ts

@@ -0,0 +1,232 @@
+import type { FamilyTranslator, PartialMessages, TourMessages } from '@slotted/core/i18n';
+import type { ChangeRequest } from '@slotted/core/state';
+import type { TourMissing, TourOutcome, TourTarget } from '@slotted/core/tour';
+import type { ComponentPropsWithRef, HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+export type { TourMissing, TourOutcome, TourTarget };
+export type TourSize = 'sm' | 'md' | 'lg';
+export type TourSide = 'top' | 'bottom' | 'inline-start' | 'inline-end' | 'left' | 'right';
+export type TourAlign = 'start' | 'center' | 'end';
+/** `auto` follows the viewport's size class; the other two decide it. */
+export type TourLayout = 'auto' | 'compact' | 'regular';
+export type TourFocusTarget = Element | {
+    current: Element | null;
+} | string;
+/** Why the tour opened or closed. */
+export type TourOpenReason = Extract<ChangeRequest<boolean>['reason'], 'pointer' | 'keyboard' | 'dismiss' | 'escape' | 'outsidePress' | 'back' | 'programmatic'>;
+/** Why the current step moved. */
+export type TourStepReason = Extract<ChangeRequest<string>['reason'], 'pointer' | 'keyboard' | 'programmatic'>;
+/**
+ * The request the family emits before the tour opens or closes. A close
+ * carries the outcome — what the product stores to decide whether to offer
+ * the tour again — on the request itself, as `dialog` carries its `result`.
+ */
+export interface TourOpenRequest extends ChangeRequest<boolean> {
+    readonly reason: TourOpenReason;
+    readonly outcome?: TourOutcome | undefined;
+}
+export interface TourStepRequest extends ChangeRequest<string | null> {
+    readonly reason: TourStepReason;
+}
+/** The words a step may say in place of the tour's: "Start tour", "Got it". */
+export type TourStepMessages = PartialMessages<Pick<TourMessages, 'next' | 'prev' | 'skip' | 'done'>>;
+/** Which of the card's own actions a step shows. Unstated ones follow the rule in the docs. */
+export interface TourStepActions {
+    prev?: boolean | undefined;
+    next?: boolean | undefined;
+    skip?: boolean | undefined;
+    close?: boolean | undefined;
+}
+export interface TourStep {
+    /** Unique in the tour. It is the value of `step`. */
+    id: string;
+    /** An element, a ref, a selector or a function. Absent for a centred step. */
+    target?: TourTarget;
+    title: ReactNode;
+    description?: ReactNode | undefined;
+    /** The step's own content, in the body — the only part that scrolls. */
+    content?: ReactNode | undefined;
+    /** An image or a video above the header. */
+    media?: ReactNode | undefined;
+    side?: TourSide | undefined;
+    align?: TourAlign | undefined;
+    /** Read each time navigation reaches the step; `false` passes over it. */
+    when?: (() => boolean) | undefined;
+    /** Awaited before the target is looked for. It may render the target. */
+    prepare?: ((signal: AbortSignal) => void | Promise<void>) | undefined;
+    /** The target stays operable, and the step is non-modal. */
+    interactive?: boolean | undefined;
+    /** A DOM event on the target that goes to the next step — `'click'`, usually. */
+    advanceOn?: string | undefined;
+    /** Overrides the tour's `spotlight` for this step. */
+    spotlight?: boolean | undefined;
+    /** Laid over the tour's words for this step: "Start tour", "Got it". */
+    messages?: TourStepMessages | undefined;
+    actions?: TourStepActions | undefined;
+    /** Read aloud when the step arrives while focus is elsewhere. Defaults to the title's text. */
+    announcement?: string | undefined;
+}
+export interface TourDefaults {
+    align: TourAlign;
+    alignOffset: number;
+    arrow: boolean;
+    arrowPadding: number;
+    autoFocus: boolean;
+    closeOnEscape: boolean;
+    closeOnOutsidePress: boolean;
+    collisionPadding: number;
+    keyboardNavigation: boolean;
+    layout: TourLayout;
+    missing: TourMissing;
+    modal: boolean;
+    scrollIntoView: boolean;
+    side: TourSide;
+    sideOffset: number;
+    size: TourSize;
+    spotlight: boolean;
+    targetTimeout: number;
+}
+export interface TourDefaultsProviderProps extends Partial<TourDefaults> {
+    children?: ReactNode | undefined;
+    /** Where every tour's layer is portalled, instead of the end of the body. */
+    container?: Element | null | undefined;
+}
+export interface TourHandle {
+    /** Opens the tour at a step, or at the first available one. */
+    start: (id?: string) => void;
+    next: () => void;
+    prev: () => void;
+    goTo: (id: string) => void;
+    close: (outcome?: TourOutcome) => void;
+    /** Measures the target and the card again, after the page moved without scrolling. */
+    reposition: () => void;
+}
+/** What a part reads, and what `useTour()` hands a consumer's own composition. */
+export interface TourState<Step extends TourStep = TourStep> {
+    readonly step: Step;
+    readonly position: number;
+    readonly total: number;
+    readonly first: boolean;
+    readonly last: boolean;
+    /** The next step is preparing, or its target has not arrived. */
+    readonly pending: boolean;
+    /** The step named a target that could not be found; it is shown centred. */
+    readonly missing: boolean;
+    readonly target: Element | null;
+    /** The family's words in the language in force, with the tour's and the step's `messages` laid over them. */
+    readonly t: FamilyTranslator<TourMessages>;
+    next: (source?: unknown) => void;
+    prev: (source?: unknown) => void;
+    goTo: (id: string) => void;
+    close: (outcome: TourOutcome, source?: unknown) => void;
+}
+export interface TourContextValue extends TourState {
+    readonly modal: boolean;
+    readonly titleId: string;
+    readonly descriptionId: string;
+    readonly hasTitle: boolean;
+    readonly hasDescription: boolean;
+    readonly setHasTitle: (present: boolean) => void;
+    readonly setHasDescription: (present: boolean) => void;
+    readonly setContentNode: (node: HTMLElement | null) => void;
+    readonly setTitleNode: (node: HTMLElement | null) => void;
+    readonly onKeyDown: (event: KeyboardEvent) => void;
+    readonly press: (event: {
+        detail: number;
+        nativeEvent: Event;
+    }) => 'pointer' | 'keyboard';
+}
+export interface TourProps<Step extends TourStep = TourStep> {
+    steps: readonly Step[];
+    open?: boolean | undefined;
+    defaultOpen?: boolean | undefined;
+    onOpenChange?: ((open: boolean, request: TourOpenRequest) => void) | undefined;
+    /** The current step's id. */
+    step?: string | null | undefined;
+    defaultStep?: string | null | undefined;
+    onStepChange?: ((step: string | null, request: TourStepRequest) => void) | undefined;
+    /** The consumer's own composition of the card. The whole anatomy when absent. */
+    children?: ReactNode | undefined;
+    ref?: Ref<TourHandle> | undefined;
+    size?: TourSize | undefined;
+    /**
+     * The phone composition — lateral sides turned vertical, the card as wide
+     * as the viewport allows — under `compact`, or never under `regular`.
+     * `auto` takes it below 600 pixels of viewport.
+     */
+    layout?: TourLayout | undefined;
+    side?: TourSide | undefined;
+    align?: TourAlign | undefined;
+    sideOffset?: number | undefined;
+    alignOffset?: number | undefined;
+    collisionPadding?: number | undefined;
+    arrowPadding?: number | undefined;
+    arrow?: boolean | undefined;
+    /** The page is inert and focus stays in the card. A step marked `interactive` is not modal. */
+    modal?: boolean | undefined;
+    /** Cut the target out of the scrim. */
+    spotlight?: boolean | undefined;
+    autoFocus?: boolean | undefined;
+    closeOnEscape?: boolean | undefined;
+    closeOnOutsidePress?: boolean | undefined;
+    scrollIntoView?: boolean | undefined;
+    missing?: TourMissing | undefined;
+    keyboardNavigation?: boolean | undefined;
+    /** How long to wait for a target that is not in the document yet, in milliseconds. */
+    targetTimeout?: number | undefined;
+    /** Words laid over the catalog of the language in force, key by key. */
+    messages?: PartialMessages<TourMessages> | undefined;
+    /** Where focus goes when the tour closes, instead of where it was when the tour opened. */
+    finalFocus?: TourFocusTarget | undefined;
+}
+type PartRender<P> = ((props: P) => ReactNode) | undefined;
+/**
+ * The ref a part hands to `render` is a callback, so it attaches to whatever
+ * element the consumer renders — an `h3` for a title — and carries theirs too.
+ */
+type PartRootProps = HTMLAttributes<HTMLElement> & {
+    ref?: ((node: HTMLElement | null) => void) | undefined;
+};
+export interface TourContentRootProps extends PartRootProps {
+    'aria-describedby'?: string | undefined;
+    'aria-labelledby'?: string | undefined;
+    'aria-modal'?: boolean | 'true' | 'false' | undefined;
+    'data-part': 'content';
+    role: string;
+    tabIndex: -1;
+}
+export interface TourContentProps extends ComponentPropsWithRef<'div'> {
+    render?: PartRender<TourContentRootProps>;
+}
+export interface TourMediaProps extends ComponentPropsWithRef<'div'> {
+    render?: PartRender<PartRootProps>;
+}
+export interface TourHeaderProps extends ComponentPropsWithRef<'div'> {
+    render?: PartRender<PartRootProps>;
+}
+export interface TourProgressProps extends ComponentPropsWithRef<'p'> {
+    render?: PartRender<PartRootProps>;
+}
+export interface TourTitleProps extends ComponentPropsWithRef<'h2'> {
+    render?: PartRender<PartRootProps & {
+        id: string;
+    }>;
+}
+export interface TourDescriptionProps extends ComponentPropsWithRef<'p'> {
+    render?: PartRender<PartRootProps & {
+        id: string;
+    }>;
+}
+export interface TourBodyProps extends ComponentPropsWithRef<'div'> {
+    render?: PartRender<PartRootProps>;
+}
+export interface TourFooterProps extends ComponentPropsWithRef<'div'> {
+    render?: PartRender<PartRootProps>;
+}
+export interface TourCloseProps extends ComponentPropsWithRef<'button'> {
+    render?: PartRender<PartRootProps>;
+}
+export interface TourActionProps extends Omit<ComponentPropsWithRef<'button'>, 'type'> {
+    /** Receives the `button` family's own props, with the part's `data-part`. */
+    render?: ((props: PartRootProps) => ReactElement) | undefined;
+}
+//# sourceMappingURL=tour.types.d.ts.map

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

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

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

@@ -0,0 +1,4 @@
+export { Transfer } from './transfer';
+export { TransferDefaultsProvider, useTransferDefaults } from './transfer-defaults';
+export type { TransferDefaults, TransferDefaultsProviderProps, TransferDirection, TransferHandle, TransferItem, TransferItemContext, TransferLayout, TransferMoveReason, TransferMoveRequest, TransferPaneReason, TransferPaneRequest, TransferProps, TransferQueryReason, TransferQueryRequest, TransferRootProps, TransferSelectionReason, TransferSelectionRequest, TransferSide, TransferSize, } from './transfer.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transfer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACpF,YAAY,EACV,gBAAgB,EAChB,6BAA6B,EAC7B,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { TransferDefaults, TransferDefaultsProviderProps } from './transfer.types';
+/** What a transfer renders as here, before it states anything of its own. */
+export declare function useTransferDefaults(): TransferDefaults;
+/**
+ * An application decides once how its transfers look. A transfer that states
+ * any of it itself still wins, and a nested provider overrides only what it
+ * names. The words come from the language in force (`SlottedProvider`).
+ */
+export declare function TransferDefaultsProvider({ children, ...rest }: TransferDefaultsProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=transfer-defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-defaults.d.ts","sourceRoot":"","sources":["../../../src/transfer/transfer-defaults.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAaxF,6EAA6E;AAC7E,wBAAgB,mBAAmB,IAAI,gBAAgB,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,6BAA6B,+BAgB5F"}

package/dist/types/transfer/transfer.d.ts

@@ -0,0 +1,5 @@
+
+import { type ReactNode } from 'react';
+import type { TransferItem, TransferProps } from './transfer.types';
+export declare function Transfer<T = TransferItem>({ items, getKey, getLabel, getDescription, isItemDisabled, renderItem, targetKeys: targetKeysProp, defaultTargetKeys, onTargetKeysChange, selectedKeys: selectedKeysProp, defaultSelectedKeys, onSelectedKeysChange, sourceQuery: sourceQueryProp, defaultSourceQuery, onSourceQueryChange, targetQuery: targetQueryProp, defaultTargetQuery, onTargetQueryChange, pane: paneProp, defaultPane, onPaneChange, filter, size: sizeProp, layout: layoutProp, searchable: searchableProp, selectAll: selectAllProp, reorderable: reorderableProp, rows: rowsProp, virtual, itemSize, overscan, disabled, readOnly, required, invalid, loading, hasMore, onLoadMore, name, messages, renderFooter, handleRef, render, ref, style, ...nativeProps }: TransferProps<T>): 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=transfer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../../src/transfer/transfer.tsx"],"names":[],"mappings":"AAAA,OAAO,uCAAuC,CAAC;AAgB/C,OAAO,EAYL,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAmBf,OAAO,KAAK,EACV,YAAY,EAGZ,aAAa,EAId,MAAM,kBAAkB,CAAC;AA0F1B,wBAAgB,QAAQ,CAAC,CAAC,GAAG,YAAY,EAAE,EACzC,KAAK,EACL,MAAsB,EACtB,QAA0B,EAC1B,cAAsC,EACtC,cAAkC,EAClC,UAAU,EACV,UAAU,EAAE,cAAc,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EAAE,gBAAgB,EAC9B,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EAAE,eAAe,EAC5B,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EAAE,eAAe,EAC5B,kBAAkB,EAClB,mBAAmB,EACnB,IAAI,EAAE,QAAQ,EACd,WAAW,EACX,YAAY,EACZ,MAAM,EACN,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,aAAa,EACxB,WAAW,EAAE,eAAe,EAC5B,IAAI,EAAE,QAAQ,EACd,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,EACP,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,MAAM,EACN,GAAG,EACH,KAAK,EACL,GAAG,WAAW,EACf,EAAE,aAAa,CAAC,CAAC,CAAC,+TA20BlB"}

package/dist/types/transfer/transfer.types.d.ts

@@ -0,0 +1,157 @@
+import type { PartialMessages, TransferMessages } from '@slotted/core/i18n';
+import type { TransferDirection, TransferSide } from '@slotted/core/transfer';
+import type { ChangeReason, ChangeRequest } from '@slotted/core/state';
+import type { ComponentPropsWithRef, HTMLAttributes, ReactNode, Ref } from 'react';
+export type { TransferDirection, TransferSide };
+/** The type step of the lists, the search fields and the move buttons. */
+export type TransferSize = 'sm' | 'md' | 'lg';
+/**
+ * How the two panes are laid out. `auto` answers the root's own inline size:
+ * two columns from 36rem, one pane at a time below it. `columns` and `steps`
+ * fix the answer.
+ */
+export type TransferLayout = 'auto' | 'columns' | 'steps';
+export type TransferMoveReason = Extract<ChangeReason, 'pointer' | 'keyboard' | 'programmatic'>;
+export type TransferSelectionReason = Extract<ChangeReason, 'pointer' | 'keyboard' | 'select' | 'programmatic'>;
+export type TransferQueryReason = Extract<ChangeReason, 'keyboard' | 'clear' | 'programmatic'>;
+export type TransferPaneReason = Extract<ChangeReason, 'pointer' | 'keyboard' | 'programmatic'>;
+/**
+ * A move asks once, with what moved and which way. `keys` are in the order
+ * they joined; `direction` is `reorder` when they stayed in the target.
+ */
+export interface TransferMoveRequest extends ChangeRequest<readonly string[]> {
+    readonly reason: TransferMoveReason;
+    readonly direction: TransferDirection;
+    readonly keys: readonly string[];
+}
+export interface TransferSelectionRequest extends ChangeRequest<readonly string[]> {
+    readonly reason: TransferSelectionReason;
+}
+export interface TransferQueryRequest extends ChangeRequest<string> {
+    readonly reason: TransferQueryReason;
+}
+export interface TransferPaneRequest extends ChangeRequest<TransferSide> {
+    readonly reason: TransferPaneReason;
+}
+/** The shape the family reads without accessors. */
+export interface TransferItem {
+    key: string;
+    label: string;
+    description?: string | undefined;
+    disabled?: boolean | undefined;
+}
+/** What an application sets once for every transfer under it. */
+export interface TransferDefaults {
+    size: TransferSize;
+    layout: TransferLayout;
+    searchable: boolean;
+    selectAll: boolean;
+    reorderable: boolean;
+    rows: number;
+}
+export interface TransferDefaultsProviderProps extends Partial<TransferDefaults> {
+    children?: ReactNode | undefined;
+}
+/** The imperative actions a consumer cannot express declaratively. */
+export interface TransferHandle {
+    /** Moves focus into a pane's list; the source's when no side is named. */
+    focus: (side?: TransferSide) => void;
+    /** Reveals an item in whichever pane holds it. */
+    scrollToKey: (key: string) => void;
+    /** The root element. */
+    readonly element: HTMLDivElement | null;
+}
+/** What `render` receives for the root. */
+export interface TransferRootProps extends HTMLAttributes<HTMLElement> {
+    'data-disabled'?: '' | undefined;
+    'data-invalid'?: '' | undefined;
+    'data-layout': TransferLayout;
+    'data-loading'?: '' | undefined;
+    'data-pane': TransferSide;
+    'data-part': string;
+    'data-readonly'?: '' | undefined;
+    'data-required'?: '' | undefined;
+    'data-size': TransferSize;
+    'data-ui': string;
+    /**
+     * The root's ref, which the drag and the focus rules measure against. A
+     * substituted element attaches it beside its own.
+     */
+    ref: Ref<HTMLDivElement>;
+}
+/** What a pane's content is told about where it is drawn. */
+export interface TransferItemContext {
+    side: TransferSide;
+    /** Whether the collection holds the key; `false` draws the key itself. */
+    resolved: boolean;
+}
+export interface TransferProps<T = TransferItem> extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'defaultValue' | 'onChange'> {
+    /** The whole collection, both sides. */
+    items: readonly T[];
+    getKey?: ((item: T) => string) | undefined;
+    getLabel?: ((item: T) => string) | undefined;
+    getDescription?: ((item: T) => string | undefined) | undefined;
+    isItemDisabled?: ((item: T) => boolean) | undefined;
+    /**
+     * The content of one option, inside the option the listbox draws. The check
+     * is drawn around it; return the label, and a description or a meta beside
+     * it, with the listbox family's parts.
+     */
+    renderItem?: ((item: T, context: TransferItemContext) => ReactNode) | undefined;
+    /** The keys in the target. Present means controlled. */
+    targetKeys?: readonly string[] | undefined;
+    defaultTargetKeys?: readonly string[] | undefined;
+    onTargetKeysChange?: ((targetKeys: readonly string[], request: TransferMoveRequest) => void) | undefined;
+    /** The selection across both panes. Present means controlled. */
+    selectedKeys?: readonly string[] | undefined;
+    defaultSelectedKeys?: readonly string[] | undefined;
+    onSelectedKeysChange?: ((selectedKeys: readonly string[], request: TransferSelectionRequest) => void) | undefined;
+    sourceQuery?: string | undefined;
+    defaultSourceQuery?: string | undefined;
+    onSourceQueryChange?: ((query: string, request: TransferQueryRequest) => void) | undefined;
+    targetQuery?: string | undefined;
+    defaultTargetQuery?: string | undefined;
+    onTargetQueryChange?: ((query: string, request: TransferQueryRequest) => void) | undefined;
+    /** The pane shown in steps. Present means controlled. */
+    pane?: TransferSide | undefined;
+    defaultPane?: TransferSide | undefined;
+    onPaneChange?: ((pane: TransferSide, request: TransferPaneRequest) => void) | undefined;
+    /**
+     * Whether an item answers a query. Defaults to a locale-aware `contains`
+     * over the label and the description.
+     */
+    filter?: ((item: T, query: string, side: TransferSide) => boolean) | undefined;
+    size?: TransferSize | undefined;
+    layout?: TransferLayout | undefined;
+    searchable?: boolean | undefined;
+    selectAll?: boolean | undefined;
+    reorderable?: boolean | undefined;
+    /** How many options tall each list is. */
+    rows?: number | undefined;
+    /** Windows both lists. Requires `itemSize`. */
+    virtual?: boolean | undefined;
+    itemSize?: number | undefined;
+    /** Options rendered either side of a windowed viewport. */
+    overscan?: number | undefined;
+    disabled?: boolean | undefined;
+    readOnly?: boolean | undefined;
+    required?: boolean | undefined;
+    invalid?: boolean | undefined;
+    /** Whether the source is still arriving. */
+    loading?: boolean | undefined;
+    /** Whether the consumer has more source items to give. */
+    hasMore?: boolean | undefined;
+    onLoadMore?: (() => void) | undefined;
+    /** Submits one hidden input per target key. */
+    name?: string | undefined;
+    /**
+     * Words laid over the catalog of the language in force, key by key: the
+     * panes' names, the controls, the counts and the announcements.
+     */
+    messages?: PartialMessages<TransferMessages> | undefined;
+    /** Content under a pane's list. */
+    renderFooter?: ((side: TransferSide) => ReactNode) | undefined;
+    handleRef?: Ref<TransferHandle> | undefined;
+    render?: ((props: TransferRootProps) => ReactNode) | undefined;
+}
+//# sourceMappingURL=transfer.types.d.ts.map

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

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

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

@@ -0,0 +1,6 @@
+export { Tree } from './tree';
+export { useTree, useTreeDepth } from './tree-context';
+export { TreeDefaultsProvider, useTreeDefaults } from './tree-defaults';
+export { TreeDescription, TreeEmpty, TreeGroup, TreeIcon, TreeLabel, TreeMeta, TreeNode, } from './tree-parts';
+export type { TreeActiveReason, TreeActiveRequest, TreeAlignment, TreeChangeRequest, TreeContextValue, TreeDefaults, TreeDefaultsProviderProps, TreeExpandOn, TreeExpansionReason, TreeExpansionRequest, TreeFocusMode, TreeGroupProps, TreeHandle, TreeMessageProps, TreeNodeProps, TreeNodeRootProps, TreePartProps, TreeProps, TreeRootProps, TreeSelectionBehavior, TreeSelectionCascade, TreeSelectionIndicator, TreeSelectionMode, TreeSelectionReason, TreeSize, TreeStructure, TreeValue, TreeVariant, } from './tree.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tree/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EACL,eAAe,EACf,SAAS,EACT,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,GACT,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,yBAAyB,EACzB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,SAAS,EACT,WAAW,GACZ,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,19 @@
+import type { TreeContextValue } from './tree.types';
+export declare const TreeContext: import("react").Context<TreeContextValue | undefined>;
+/**
+ * What the tree around this part says. A part outside one has no hierarchy to
+ * belong to and no key to be chosen by, so this throws rather than rendering
+ * something that looks right and answers nothing.
+ */
+export declare function useTree(): TreeContextValue;
+/**
+ * How deep the node being rendered sits, counted by the nodes above it rather
+ * than stated by the consumer.
+ *
+ * A depth a consumer writes is a depth a consumer can get wrong, and it would
+ * have to be rewritten every time a branch moves. Each node raises it by one
+ * for the nodes inside it, so the number is a fact about the markup.
+ */
+export declare const TreeDepthContext: import("react").Context<number>;
+export declare function useTreeDepth(): number;
+//# sourceMappingURL=tree-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree-context.d.ts","sourceRoot":"","sources":["../../../src/tree/tree-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,eAAO,MAAM,WAAW,uDAAyD,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,gBAAgB,CAM1C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,iCAAmB,CAAC;AAEjD,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

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

@@ -0,0 +1,10 @@
+import type { TreeDefaults, TreeDefaultsProviderProps } from './tree.types';
+/** What a tree renders as here, before it states anything of its own. */
+export declare function useTreeDefaults(): TreeDefaults;
+/**
+ * An application decides once how its trees behave, rather than repeating
+ * twenty props on every hierarchy in a product. A tree that states any of them
+ * itself still wins: an explicit value is never overridden by context.
+ */
+export declare function TreeDefaultsProvider({ children, ...defaults }: TreeDefaultsProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=tree-defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree-defaults.d.ts","sourceRoot":"","sources":["../../../src/tree/tree-defaults.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AA4C5E,yEAAyE;AACzE,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,EAAE,yBAAyB,+BAiCxF"}

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

@@ -0,0 +1,28 @@
+import type { TreeGroupProps, TreeMessageProps, TreeNodeProps, TreePartProps } from './tree.types';
+/** The selector the root reads its visible rows through, in DOM order. */
+export declare const NODE_SELECTOR = "[data-part='node']";
+/**
+ * One node, and the facts the root reads back off it.
+ *
+ * The visible collection is read from the DOM rather than from a registry, as
+ * `listbox` and `menu` already do: document order is reading order, a collapsed
+ * branch renders no group and therefore contributes no rows, and nothing has to
+ * be registered, unregistered or ordered by mount time. The flattening a tree
+ * would otherwise need is the browser's own.
+ *
+ * `aria-disabled` and never the native attribute: the pattern needs a disabled
+ * node to keep its place in the set, and `navigateDisabled` is what decides
+ * whether the arrows land on it.
+ */
+export declare function TreeNode({ actions, children, depth: statedDepth, description, disabled, hasChildren, icon, label, loading, match, meta, offset, onClick, pinned, render, textValue, value, ...nativeProps }: TreeNodeProps): 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;
+/**
+ * A group written by hand, for a consumer that renders its own `li` elements
+ * rather than using `Tree.Node`. `Tree.Node` renders its own.
+ */
+export declare function TreeGroup({ children, ...nativeProps }: TreeGroupProps): import("react").JSX.Element;
+export declare function TreeLabel({ children, ...nativeProps }: TreePartProps): import("react").JSX.Element;
+export declare function TreeDescription({ children, ...nativeProps }: TreePartProps): import("react").JSX.Element;
+export declare function TreeMeta({ children, ...nativeProps }: TreePartProps): import("react").JSX.Element;
+export declare function TreeIcon({ children, ...nativeProps }: TreePartProps): import("react").JSX.Element;
+export declare function TreeEmpty({ children, ...nativeProps }: TreeMessageProps): import("react").JSX.Element;
+//# sourceMappingURL=tree-parts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree-parts.d.ts","sourceRoot":"","sources":["../../../src/tree/tree-parts.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,aAAa,EAEb,aAAa,EACd,MAAM,cAAc,CAAC;AAEtB,0EAA0E;AAC1E,eAAO,MAAM,aAAa,uBAAuB,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,QAAQ,EACR,KAAK,EAAE,WAAW,EAClB,WAAW,EACX,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,KAAK,EACL,OAAO,EACP,KAAK,EACL,IAAI,EACJ,MAAM,EACN,OAAO,EACP,MAAM,EACN,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,WAAW,EACf,EAAE,aAAa,+VAsIf;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,EAAE,cAAc,+BAOrE;AAED,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,EAAE,aAAa,+BAMpE;AAED,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,EAAE,aAAa,+BAM1E;AAED,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,EAAE,aAAa,+BAMnE;AAED,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,EAAE,aAAa,+BAMnE;AAED,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,EAAE,gBAAgB,+BAMvE"}

package/dist/types/tree/tree.d.ts

@@ -0,0 +1,24 @@
+
+
+import type { ReactNode } from 'react';
+import type { TreeProps } from './tree.types';
+/**
+ * A node the tree holds, and the selection, expansion and position a reader
+ * moves through it.
+ *
+ * ── Where the visible list comes from ───────────────────────────────────
+ *
+ * From the DOM, in document order, which is the flattening a tree would
+ * otherwise have to keep in step with the expanded set. A collapsed branch
+ * renders no group and therefore contributes no rows, so what the keyboard
+ * counts and what the reader sees cannot disagree. `listbox` and `menu` read
+ * their collections the same way and for the same reason.
+ *
+ * `nodes` is a second thing and not a replacement: it is the hierarchy the tree
+ * holds, and it answers the three questions the DOM cannot — what is under a
+ * branch that is closed, which is what a cascade needs; what every branch is,
+ * which is what `expandAll` opens; and what matches a query, which is what the
+ * filter keeps the ancestors of.
+ */
+export declare function Tree<T = unknown>({ activeKey, children, defaultActiveKey, defaultExpandedKeys, defaultValue, disabled, disallowEmptySelection, disallowSelectAll, emptyContent, expandOn, expandedKeys, focusMode, getChildren, getChildrenCount, getKey, getLabel, getLevel, guides, handleRef, hasChildren, invalid, isNodeDisabled, isNodeLoading, itemSize, loading, loop, name, navigateDisabled, nodes, onActiveKeyChange, onExpandedKeysChange, onNodeActivate, onValueChange, overscan, pageSize, query, readOnly, ref, render, renderNode, required, selectOnFocus, selectionBehavior, selectionCascade, selectionIndicator, selectionMode, size, structure, typeahead, typeaheadTimeout, value, variant, virtual, ...nativeProps }: TreeProps<T>): 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=tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/tree/tree.tsx"],"names":[],"mappings":"AAAA,OAAO,+BAA+B,CAAC;AACvC,OAAO,yCAAyC,CAAC;AA8BjD,OAAO,KAAK,EAAwD,SAAS,EAAE,MAAM,OAAO,CAAC;AAK7F,OAAO,KAAK,EAOV,SAAS,EAMV,MAAM,cAAc,CAAC;AAqBtB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,EAChC,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EACR,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,SAAS,EACT,WAAW,EACX,OAAO,EACP,cAAc,EACd,aAAa,EACb,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,gBAAgB,EAChB,KAAK,EACL,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,GAAG,EACH,MAAM,EACN,UAAU,EACV,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,IAAI,EACJ,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,KAAK,EACL,OAAO,EACP,OAAO,EACP,GAAG,WAAW,EACf,EAAE,SAAS,CAAC,CAAC,CAAC,+TA06Bd"}