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

package/dist/types/column-manager/column-manager.types.d.ts

@@ -0,0 +1,78 @@
+import type { GridColumn, GridColumnState, GridColumnStateChange, GridOutOfSpace } from '@slotted/core/grid';
+import type { ColumnManagerMessages, PartialMessages } from '@slotted/core/i18n';
+import type { ChangeReason, ChangeRequest } from '@slotted/core/state';
+import type { ComponentPropsWithRef, ReactNode, Ref, RefObject } from 'react';
+/** Where the panel stands: a popover on the trigger, a drawer at the end, or in place. */
+export type ColumnManagerPresentation = 'popover' | 'drawer' | 'inline';
+/** Whether every action asks at once, or edits a draft that Apply asks for once. */
+export type ColumnManagerApply = 'live' | 'confirm';
+export type ColumnManagerColumnReason = Extract<ChangeReason, 'pointer' | 'keyboard' | 'clear' | 'submit' | 'programmatic'>;
+export type ColumnManagerOpenReason = Extract<ChangeReason, 'pointer' | 'keyboard' | 'escape' | 'outsidePress' | 'back' | 'programmatic'>;
+/**
+ * The column request: `data-grid`'s, with every key that moved beside the
+ * first. `change` is `changes[0]`.
+ */
+export interface ColumnManagerRequest extends ChangeRequest<GridColumnState> {
+    readonly reason: ColumnManagerColumnReason;
+    readonly change: GridColumnStateChange;
+    readonly changes: readonly GridColumnStateChange[];
+}
+export interface ColumnManagerOpenRequest extends ChangeRequest<boolean> {
+    readonly reason: ColumnManagerOpenReason;
+}
+/** What an application sets once for every manager under it. */
+export interface ColumnManagerDefaults {
+    presentation: ColumnManagerPresentation;
+    apply: ColumnManagerApply;
+}
+export interface ColumnManagerProviderProps {
+    presentation?: ColumnManagerPresentation | undefined;
+    apply?: ColumnManagerApply | undefined;
+    children?: ReactNode | undefined;
+}
+/** The imperative actions a consumer cannot express declaratively. */
+export interface ColumnManagerHandle {
+    show: () => void;
+    hide: () => void;
+    toggle: () => void;
+    /** The root while it is rendered. */
+    readonly element: HTMLDivElement | null;
+}
+export interface ColumnManagerProps<Row = unknown> extends Omit<ComponentPropsWithRef<'div'>, 'ref' | 'children' | 'defaultValue'> {
+    /** The grid's columns, as the grid is given them. */
+    columns: readonly GridColumn<Row>[];
+    /** Present means the consumer owns the state, for the life of the component. */
+    columnState?: GridColumnState | undefined;
+    /** The uncontrolled start, and the target of Restore defaults in both modes. */
+    defaultColumnState?: Partial<GridColumnState> | undefined;
+    onColumnStateChange?: ((state: GridColumnState, request: ColumnManagerRequest) => void) | undefined;
+    /**
+     * The columns the grid took out for room — the grid's `onOutOfSpaceChange`
+     * or `handle.getOutOfSpace()`: listed with a status, never written to the
+     * state.
+     */
+    outOfSpace?: GridOutOfSpace | undefined;
+    presentation?: ColumnManagerPresentation | undefined;
+    apply?: ColumnManagerApply | undefined;
+    open?: boolean | undefined;
+    defaultOpen?: boolean | undefined;
+    onOpenChange?: ((open: boolean, request: ColumnManagerOpenRequest) => void) | undefined;
+    /** Words laid over the catalog of the language in force, key by key. */
+    messages?: PartialMessages<ColumnManagerMessages> | undefined;
+    ref?: Ref<ColumnManagerHandle> | undefined;
+}
+/** What `render` receives for the trigger. */
+export type ColumnManagerTriggerRootProps = ComponentPropsWithRef<'button'> & {
+    'data-part': 'trigger';
+    'data-column-manager-trigger': '';
+};
+export interface ColumnManagerTriggerProps extends ComponentPropsWithRef<'button'> {
+    /**
+     * The manager this trigger opens. Unset, the trigger reads the one a
+     * `ColumnManagerRoot` around both provides.
+     */
+    manager?: RefObject<ColumnManagerHandle | null> | undefined;
+    /** Replaces the rendered element; the family's own `Button` otherwise. */
+    render?: ((props: ColumnManagerTriggerRootProps) => ReactNode) | undefined;
+}
+//# sourceMappingURL=column-manager.types.d.ts.map

package/dist/types/column-manager/column-manager.types.d.ts.map

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

package/dist/types/column-manager/index.d.ts

@@ -0,0 +1,4 @@
+export { ColumnManager, ColumnManagerRoot, ColumnManagerTrigger } from './column-manager';
+export { ColumnManagerProvider, useColumnManagerDefaults } from './column-manager-defaults';
+export type { ColumnManagerApply, ColumnManagerColumnReason, ColumnManagerDefaults, ColumnManagerHandle, ColumnManagerOpenReason, ColumnManagerOpenRequest, ColumnManagerPresentation, ColumnManagerProps, ColumnManagerProviderProps, ColumnManagerRequest, ColumnManagerTriggerProps, ColumnManagerTriggerRootProps, } from './column-manager.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/column-manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/column-manager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC5F,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC"}

package/dist/types/combobox/combobox-collection.d.ts

@@ -0,0 +1,33 @@
+import type { MoveIntent } from '@slotted/core/collection';
+import type { ComboboxOptionValue } from './combobox.types';
+/**
+ * The collection, read from the DOM of the open popup — and here that is more
+ * than a convenience. The options a combobox holds are the ones that survived
+ * the filter, each one having judged itself, so the rendered list *is* the
+ * result set. Nothing else in the family knows what matched.
+ *
+ * The same shape `select` uses, deliberately: the two families are a pair, and
+ * a reader who has read one should recognise the other. `moveIndex` in
+ * `packages/core/src/collection` does the arithmetic; this module only says
+ * what the arithmetic is about.
+ */
+export declare const OPTION_SELECTOR = "[data-part='item']";
+export declare function options(content: HTMLElement | null): HTMLElement[];
+export declare const valueOf: (option: HTMLElement) => ComboboxOptionValue;
+export declare const isEnabled: (option: HTMLElement) => boolean;
+export declare const labelOf: (option: HTMLElement) => string;
+/**
+ * The value the highlight moves to, or `null` when nothing is reachable. An
+ * empty result set, a list still loading and a list whose every option is
+ * disabled all answer the same way, and the caller writes no
+ * `aria-activedescendant` for all three.
+ */
+export declare function moveHighlight(content: HTMLElement | null, from: ComboboxOptionValue | null, intent: MoveIntent, loop: boolean): ComboboxOptionValue | null;
+/** Where the highlight lands when the popup opens, given what was committed. */
+export declare function entryHighlight(content: HTMLElement | null, value: ComboboxOptionValue | null, entry: 'selected' | 'first' | 'last' | 'none', loop: boolean): ComboboxOptionValue | null;
+/** The label of the first option that survived the filter, for the completion. */
+export declare function firstMatch(content: HTMLElement | null): string | null;
+/** The value behind a label, so a completion the reader accepted becomes a key. */
+export declare function valueForLabel(content: HTMLElement | null, label: string): string | null;
+export declare function revealOption(content: HTMLElement | null, value: ComboboxOptionValue | null): void;
+//# sourceMappingURL=combobox-collection.d.ts.map

package/dist/types/combobox/combobox-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox-collection.d.ts","sourceRoot":"","sources":["../../../src/combobox/combobox-collection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD,wBAAgB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,WAAW,EAAE,CAElE;AAED,eAAO,MAAM,OAAO,GAAI,QAAQ,WAAW,KAAG,mBAAoD,CAAC;AAEnG,eAAO,MAAM,SAAS,GAAI,QAAQ,WAAW,YAA6C,CAAC;AAE3F,eAAO,MAAM,OAAO,GAAI,QAAQ,WAAW,KAAG,MAI1C,CAAC;AAEL;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,WAAW,GAAG,IAAI,EAC3B,IAAI,EAAE,mBAAmB,GAAG,IAAI,EAChC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,OAAO,GACZ,mBAAmB,GAAG,IAAI,CAW5B;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,GAAG,IAAI,EAC3B,KAAK,EAAE,mBAAmB,GAAG,IAAI,EACjC,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EAC7C,IAAI,EAAE,OAAO,GACZ,mBAAmB,GAAG,IAAI,CAU5B;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAGrE;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,iBAGvE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI,QAO1F"}

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

@@ -0,0 +1,35 @@
+import type { ComboboxDefaults, ComboboxDefaultsProviderProps } from './combobox.types';
+/**
+ * The numbers, and why they are these numbers.
+ *
+ * `autocomplete` is `list` — the popup shows what matches — rather than `both`,
+ * whose completion string writes into the input as the reader types. `both` is
+ * the only value with a visible artefact and it is also the one that surprises:
+ * a reader typing `ma` into a list of names sees `Mark` appear under their
+ * caret. It is one word away and it is not the default.
+ *
+ * `openOn` is `input`: the popup appears once there is something to filter, or
+ * when the reader presses the input, which is what a reader typing or pointing
+ * expects and what `focus` gets wrong for a form a reader is tabbing through.
+ *
+ * `autoHighlight` is `false`. Highlighting the first match means `Enter`
+ * commits an option the reader never looked at, and the pattern is explicit
+ * that a highlight and a selection are different things.
+ *
+ * `clearable` is `true` where `select`'s is `false`. A select holds one of its
+ * own options once a reader has chosen; a combobox holds whatever was typed,
+ * and taking it back is the commonest thing a reader does to one.
+ *
+ * `loop` is `false`, as `select`'s is: a filtered list of two hundred that
+ * jumps from the last option to the first loses the reader's place.
+ */
+export declare const COMBOBOX_FALLBACK: ComboboxDefaults;
+/** The defaults in force here. A combobox reads it; a consumer rarely needs to. */
+export declare function useComboboxDefaults(): ComboboxDefaults;
+/**
+ * The decisions an application takes once, in its bootstrap, rather than on
+ * every combobox it renders. Its words come from the language in force
+ * (`SlottedProvider`).
+ */
+export declare function ComboboxDefaultsProvider({ children, container, ...overrides }: ComboboxDefaultsProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=combobox-defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"combobox-defaults.d.ts","sourceRoot":"","sources":["../../../src/combobox/combobox-defaults.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAExF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBA+B/B,CAAC;AAIF,mFAAmF;AACnF,wBAAgB,mBAAmB,IAAI,gBAAgB,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,SAAS,EACT,GAAG,SAAS,EACb,EAAE,6BAA6B,+BA6C/B"}

package/dist/types/combobox/combobox-items.d.ts

@@ -0,0 +1,29 @@
+import type { Ref } from 'react';
+import type { ComboboxGroupProps, ComboboxItemProps } from './combobox.types';
+/**
+ * One option, and the one that decides whether it belongs in the results.
+ *
+ * **Each option filters itself.** The family holds the query and the
+ * comparison; the option holds its own label, which is the only place the two
+ * meet without the consumer having to hand the whole collection over twice. An
+ * option that does not match renders nothing, so the popup's DOM *is* the
+ * result set — which is what makes the count, the keyboard and the empty row
+ * all read the same answer.
+ *
+ * The text it filters on is `textValue`, or its children when they are a
+ * string. Children that are elements cannot be compared, so such an option is
+ * always shown and `textValue` is how a consumer says what it reads as.
+ */
+export declare function ComboboxItem({ children, description, disabled, icon, position, ref, textValue, value, ...nativeProps }: ComboboxItemProps): import("react").JSX.Element | null;
+/**
+ * A set of options under a heading, named by `aria-labelledby` pointing at its
+ * own label — which the listbox pattern requires of every option group.
+ *
+ * A group whose every option was filtered away renders nothing at all: a
+ * heading with no options under it says a category matched when none did.
+ */
+export declare function ComboboxGroup({ children, label, ...nativeProps }: ComboboxGroupProps): import("react").JSX.Element;
+export declare function ComboboxSeparator(props: {
+    ref?: Ref<HTMLDivElement>;
+}): import("react").JSX.Element;
+//# sourceMappingURL=combobox-items.d.ts.map

package/dist/types/combobox/combobox-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox-items.d.ts","sourceRoot":"","sources":["../../../src/combobox/combobox-items.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAuC,GAAG,EAAE,MAAM,OAAO,CAAC;AAKtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE9E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,WAAW,EACX,QAAgB,EAChB,IAAI,EACJ,QAAQ,EACR,GAAG,EACH,SAAS,EACT,KAAK,EACL,GAAG,WAAW,EACf,EAAE,iBAAiB,sCAkGnB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,EAAE,kBAAkB,+BAsCpF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAA;CAAE,+BAErE"}

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

@@ -0,0 +1,25 @@
+import type { ComboboxContentProps, ComboboxInputProps } from './combobox.types';
+/**
+ * The frame, the input, the clear button and the trigger.
+ *
+ * The input is a real `input`, so every text-editing key, the caret, the
+ * selection, IME and autofill stay the browser's — the pattern's own IMPORTANT
+ * note asks that script not capture the keys a browser uses to edit text, and
+ * the key handler below binds none of them.
+ *
+ * The trigger carries `tabindex="-1"`: the pattern's Keyboard Interaction note
+ * excludes the popup indicator from the page tab sequence by name, so a reader
+ * tabbing through a form meets the input once and not twice.
+ */
+export declare function ComboboxInput({ ref, render, ...nativeProps }: ComboboxInputProps): 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 layer, the surface it paints, and the two rows that speak for it.
+ *
+ * `status` is the live region as well as the loading row: a reader who cannot
+ * see the list still hears how many options answered their query, which is what
+ * `docs/component-features.md` §6 asks for by name.
+ */
+export declare function ComboboxContent({ children, empty, ref, render, status: statusMessage, ...nativeProps }: ComboboxContentProps): 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 completion string, for `autocomplete="both"`. */
+export declare function completionFor(content: HTMLElement | null, typed: string): string | null;
+//# sourceMappingURL=combobox-parts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"combobox-parts.d.ts","sourceRoot":"","sources":["../../../src/combobox/combobox-parts.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAGnB,MAAM,kBAAkB,CAAC;AAmB1B;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,kBAAkB,+VA6UhF;AASD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,KAAK,EACL,GAAG,EACH,MAAM,EACN,MAAM,EAAE,aAAa,EACrB,GAAG,WAAW,EACf,EAAE,oBAAoB,+VA+TtB;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvF"}

package/dist/types/combobox/combobox.d.ts

@@ -0,0 +1,105 @@
+
+import { type ComboboxMessages, type FamilyTranslator } from '@slotted/core/i18n';
+import type { MutableRefObject } from 'react';
+import type { ComboboxAlign, ComboboxAutocomplete, ComboboxHighlightReason, ComboboxInputReason, ComboboxMount, ComboboxOpenOn, ComboboxOpenReason, ComboboxOptionValue, ComboboxProps, ComboboxSide, ComboboxSize, ComboboxStrategy, ComboboxValueReason, ComboboxVariant, ComboboxWidth } from './combobox.types';
+/** Where the highlight goes when the popup opens. */
+export type ComboboxEntry = 'selected' | 'first' | 'last' | 'none';
+export interface ComboboxContextValue {
+    align: ComboboxAlign;
+    alignOffset: number;
+    allowsCustomValue: boolean;
+    autocomplete: ComboboxAutocomplete;
+    autoHighlight: boolean;
+    clear: (reason: ComboboxValueReason, source?: unknown) => void;
+    clearable: boolean;
+    closeOnEscape: boolean;
+    closeOnOutsidePress: boolean;
+    closeOnSelect: boolean;
+    collisionPadding: number;
+    /**
+     * The completion string `autocomplete="both"` shows: the rest of the first
+     * match, or `null`. It is **state and not a DOM write**, because the input is
+     * controlled — the first version of this wrote the value straight onto the
+     * element in a layout effect, and React put it back on the very next render.
+     * It is part of what the input renders; `inputValue` stays what was typed.
+     */
+    completion: string | null;
+    contentId: string;
+    contentNode: HTMLElement | null;
+    disabled: boolean;
+    entry: MutableRefObject<ComboboxEntry>;
+    flip: boolean;
+    form: string | undefined;
+    fullWidth: boolean;
+    hideWhenDetached: boolean;
+    highlighted: ComboboxOptionValue | null;
+    highlightMatch: boolean;
+    inputId: string;
+    inputValue: string;
+    invalid: boolean;
+    labelFor: (value: ComboboxOptionValue) => string | undefined;
+    /** Whether the consumer will take a value the collection does not hold (CB8). */
+    canCreate: boolean;
+    /** Reports the query the reader asked to add. The collection is the consumer's. */
+    create: (query: string, reason: ComboboxValueReason, source?: unknown) => void;
+    /** Settles the typed text against the collection, which `blur` is the moment for. */
+    settleInput: (source?: unknown) => void;
+    loading: boolean;
+    /** The locale the default filter compares in: the `locale` prop, or the language in force. */
+    locale: string;
+    loop: boolean;
+    matches: (label: string) => boolean;
+    mount: ComboboxMount;
+    name: string | undefined;
+    onLoadMore: (() => void) | undefined;
+    open: boolean;
+    openOn: ComboboxOpenOn;
+    optionId: (value: ComboboxOptionValue) => string;
+    portal: boolean;
+    query: string;
+    readOnly: boolean;
+    registerLabel: (value: ComboboxOptionValue, label: string) => void;
+    required: boolean;
+    seen: boolean;
+    select: (value: ComboboxOptionValue | null, reason: ComboboxValueReason, source?: unknown) => void;
+    setContentNode: (node: HTMLElement | null) => void;
+    setHighlighted: (value: ComboboxOptionValue | null, reason: ComboboxHighlightReason, source?: unknown) => void;
+    setCompletion: (completion: string | null) => void;
+    setInputNode: (node: HTMLInputElement | null) => void;
+    wantsCompletion: MutableRefObject<boolean>;
+    setInputValue: (value: string, reason: ComboboxInputReason, source?: unknown) => void;
+    setOpen: (next: boolean, reason: ComboboxOpenReason, source?: unknown) => void;
+    shift: boolean;
+    side: ComboboxSide;
+    sideOffset: number;
+    size: ComboboxSize;
+    strategy: ComboboxStrategy;
+    /** The family's words in the language in force, with this combobox's `messages` laid over them. */
+    t: FamilyTranslator<ComboboxMessages>;
+    total: number | undefined;
+    inputNode: HTMLInputElement | null;
+    value: ComboboxOptionValue | null;
+    variant: ComboboxVariant;
+    width: ComboboxWidth;
+}
+export declare function useCombobox(): ComboboxContextValue;
+/**
+ * A text input with a listbox of options filtered by what was typed.
+ *
+ * This component owns the state and **renders nothing**. `ComboboxInput`
+ * renders the frame, the input and the two buttons; `ComboboxContent` renders
+ * the layer and the list.
+ *
+ * **The typed text and the chosen key are two contracts, not one.**
+ * `docs/component-features.md` §6 asks for it in those words, and the reason is
+ * a list whose labels are not unique: a family that held one value and derived
+ * the other would resolve `Paris` to whichever Paris came first. Each transition
+ * emits exactly one request — typing emits `onInputValueChange` with reason
+ * `keyboard`; committing an option emits both, each with reason `select`.
+ *
+ * **Filtering is an adapter.** The default is a locale-sensitive `contains`
+ * from `packages/core/src/collection`, `filter` replaces it, and `filter={null}`
+ * turns it off for a list a server has already filtered.
+ */
+export declare function Combobox({ align, alignOffset, allowsCustomValue, autocomplete, autoHighlight, children, clearable, closeOnEscape, closeOnOutsidePress, closeOnSelect, collisionPadding, onCreate, defaultHighlightedValue, defaultInputValue, defaultOpen, defaultValue, disabled, filter, flip, form, fullWidth, hideWhenDetached, highlightedValue, highlightMatch, inputValue, invalid, items, loading, locale: localeProp, loop, messages, mount, name, onHighlightedValueChange, onInputValueChange, onInputReset, onLoadMore, onOpenChange, onValueChange, open, openOn, portal, readOnly, ref, required, shift, side, sideOffset, size, strategy, total, value, variant, width, }: ComboboxProps): import("react").JSX.Element;
+//# sourceMappingURL=combobox.d.ts.map

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

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

package/dist/types/combobox/combobox.types.d.ts

@@ -0,0 +1,211 @@
+import type { ComboboxMessages, PartialMessages } from '@slotted/core/i18n';
+import type { ChangeRequest } from '@slotted/core/state';
+import type { ComponentPropsWithRef, HTMLAttributes, ReactNode, Ref } from 'react';
+export type ComboboxSize = 'sm' | 'md' | 'lg';
+export type ComboboxVariant = 'outline' | 'subtle' | 'plain';
+export type ComboboxSide = 'bottom' | 'top' | 'inline-start' | 'inline-end' | 'left' | 'right';
+export type ComboboxAlign = 'start' | 'center' | 'end';
+export type ComboboxWidth = 'anchor' | 'content';
+export type ComboboxMount = 'active' | 'lazy' | 'eager';
+export type ComboboxStrategy = 'absolute' | 'fixed';
+/** The pattern's own three values for `aria-autocomplete`. */
+export type ComboboxAutocomplete = 'none' | 'list' | 'both';
+/**
+ * When the popup opens on its own: as the reader types or presses the input, on
+ * every focus and press, or never.
+ */
+export type ComboboxOpenOn = 'input' | 'focus' | 'manual';
+/** An option's key. The reasoning is `select`'s, and it is the same reasoning. */
+export type ComboboxOptionValue = string;
+export type ComboboxOpenReason = 'pointer' | 'keyboard' | 'escape' | 'outsidePress' | 'select' | 'dismiss' | 'blur' | 'programmatic';
+export type ComboboxValueReason = 'pointer' | 'keyboard' | 'clear' | 'select' | 'blur' | 'programmatic';
+export type ComboboxInputReason = 'keyboard' | 'select' | 'clear' | 'blur' | 'programmatic';
+export type ComboboxHighlightReason = 'pointer' | 'keyboard' | 'programmatic';
+/**
+ * Whether an option answers a query.
+ *
+ * `null` turns filtering off entirely, which is what a list the consumer has
+ * already filtered on a server needs: the family then renders exactly the
+ * window it was given and decides nothing. `docs/component-features.md` §6
+ * refuses a combobox that assumes `contains`, so the default is an adapter like
+ * any other and it is stated in `COMBOBOX_FALLBACK`.
+ */
+export type ComboboxFilter = ((label: string, query: string) => boolean) | null;
+export interface ComboboxOption {
+    value: ComboboxOptionValue;
+    label: string;
+    disabled?: boolean;
+}
+export interface ComboboxOptionGroup {
+    label: string;
+    options: readonly ComboboxOption[];
+}
+export type ComboboxItems = readonly (ComboboxOption | ComboboxOptionGroup)[];
+export interface ComboboxDefaults {
+    align: ComboboxAlign;
+    alignOffset: number;
+    allowsCustomValue: boolean;
+    autocomplete: ComboboxAutocomplete;
+    autoHighlight: boolean;
+    clearable: boolean;
+    closeOnEscape: boolean;
+    closeOnOutsidePress: boolean;
+    closeOnSelect: boolean;
+    collisionPadding: number;
+    disabled: boolean;
+    flip: boolean;
+    fullWidth: boolean;
+    hideWhenDetached: boolean;
+    highlightMatch: boolean;
+    invalid: boolean;
+    loading: boolean;
+    loop: boolean;
+    mount: ComboboxMount;
+    openOn: ComboboxOpenOn;
+    portal: boolean;
+    readOnly: boolean;
+    required: boolean;
+    shift: boolean;
+    side: ComboboxSide;
+    sideOffset: number;
+    size: ComboboxSize;
+    strategy: ComboboxStrategy;
+    variant: ComboboxVariant;
+    width: ComboboxWidth;
+}
+export interface ComboboxDefaultsProviderProps extends Partial<ComboboxDefaults> {
+    children?: ReactNode;
+    container?: Element | null;
+}
+export interface ComboboxHandle {
+    close: () => void;
+    focus: () => void;
+    open: () => void;
+    scrollToKey: (value: ComboboxOptionValue) => void;
+}
+export interface ComboboxProps {
+    align?: ComboboxAlign;
+    alignOffset?: number;
+    allowsCustomValue?: boolean;
+    autocomplete?: ComboboxAutocomplete;
+    /** Whether the first match is highlighted as soon as the popup opens. */
+    autoHighlight?: boolean;
+    children?: ReactNode;
+    clearable?: boolean;
+    /** Called with the query the reader asked to add. The collection is the consumer's. */
+    onCreate?: (query: string, details: {
+        reason: ComboboxValueReason;
+        source?: unknown;
+    }) => void;
+    /** Called with the text the field refused when it settled, and why (CB7). */
+    onInputReset?: (rejected: string, details: {
+        reason: 'blur';
+        source?: unknown;
+    }) => void;
+    closeOnEscape?: boolean;
+    closeOnOutsidePress?: boolean;
+    closeOnSelect?: boolean;
+    collisionPadding?: number;
+    defaultHighlightedValue?: ComboboxOptionValue | null;
+    defaultInputValue?: string;
+    defaultOpen?: boolean;
+    defaultValue?: ComboboxOptionValue | null;
+    disabled?: boolean;
+    filter?: ComboboxFilter;
+    flip?: boolean;
+    form?: string;
+    fullWidth?: boolean;
+    hideWhenDetached?: boolean;
+    highlightedValue?: ComboboxOptionValue | null;
+    highlightMatch?: boolean;
+    inputValue?: string;
+    invalid?: boolean;
+    items?: ComboboxItems;
+    loading?: boolean;
+    /** BCP 47, for the comparison the default filter makes. The language in force when absent. */
+    locale?: string;
+    loop?: boolean;
+    /**
+     * Words laid over the catalog of the language in force, key by key: the
+     * clear and trigger buttons, the offer to create, the empty, loading and
+     * count sentences.
+     */
+    messages?: PartialMessages<ComboboxMessages> | undefined;
+    mount?: ComboboxMount;
+    name?: string;
+    onHighlightedValueChange?: (value: ComboboxOptionValue | null, request: ChangeRequest<ComboboxOptionValue | null>) => void;
+    onInputValueChange?: (value: string, request: ChangeRequest<string>) => void;
+    /** The last option came into view; the consumer fetches the next page. */
+    onLoadMore?: () => void;
+    onOpenChange?: (open: boolean, request: ChangeRequest<boolean>) => void;
+    onValueChange?: (value: ComboboxOptionValue | null, request: ChangeRequest<ComboboxOptionValue | null>) => void;
+    open?: boolean;
+    openOn?: ComboboxOpenOn;
+    portal?: boolean;
+    readOnly?: boolean;
+    ref?: Ref<ComboboxHandle>;
+    required?: boolean;
+    shift?: boolean;
+    side?: ComboboxSide;
+    sideOffset?: number;
+    size?: ComboboxSize;
+    strategy?: ComboboxStrategy;
+    total?: number;
+    value?: ComboboxOptionValue | null;
+    variant?: ComboboxVariant;
+    width?: ComboboxWidth;
+}
+/** What `render` receives for the frame around the control. */
+export interface ComboboxInputRootProps extends HTMLAttributes<HTMLElement> {
+    children?: ReactNode;
+    'data-disabled'?: '' | undefined;
+    'data-full-width'?: '' | undefined;
+    'data-invalid'?: '' | undefined;
+    'data-loading'?: '' | undefined;
+    'data-open'?: '' | undefined;
+    'data-part': string;
+    'data-readonly'?: '' | undefined;
+    'data-required'?: '' | undefined;
+    'data-size': ComboboxSize;
+    'data-ui': string;
+    'data-variant': ComboboxVariant;
+    ref?: Ref<HTMLDivElement> | undefined;
+}
+export interface ComboboxInputProps extends Omit<ComponentPropsWithRef<'input'>, 'value' | 'defaultValue'> {
+    ref?: Ref<HTMLInputElement>;
+    /** Replaces the frame around the control, not the control itself. */
+    render?: (props: ComboboxInputRootProps) => ReactNode;
+}
+/** What `render` receives for the layer the positioner writes on. */
+export interface ComboboxPositionerProps extends HTMLAttributes<HTMLElement> {
+    children?: ReactNode;
+    'data-align': ComboboxAlign;
+    'data-open'?: '' | undefined;
+    'data-part': string;
+    'data-size': ComboboxSize;
+    'data-ui': string;
+    'data-width': ComboboxWidth;
+    inert?: boolean | undefined;
+    ref?: Ref<HTMLDivElement> | undefined;
+}
+export interface ComboboxContentProps extends ComponentPropsWithRef<'div'> {
+    empty?: ReactNode;
+    ref?: Ref<HTMLDivElement>;
+    render?: (props: ComboboxPositionerProps) => ReactNode;
+    status?: ReactNode;
+}
+export interface ComboboxItemProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {
+    children?: ReactNode;
+    description?: ReactNode;
+    disabled?: boolean;
+    icon?: ReactNode;
+    position?: number;
+    ref?: Ref<HTMLDivElement>;
+    /** What the filter compares and what typeahead matches, for rich children. */
+    textValue?: string;
+    value: ComboboxOptionValue;
+}
+export interface ComboboxGroupProps extends ComponentPropsWithRef<'div'> {
+    label?: ReactNode;
+}
+//# sourceMappingURL=combobox.types.d.ts.map

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

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

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

@@ -0,0 +1,7 @@
+export { Combobox, useCombobox } from './combobox';
+export type { ComboboxContextValue, ComboboxEntry } from './combobox';
+export { COMBOBOX_FALLBACK, ComboboxDefaultsProvider, useComboboxDefaults, } from './combobox-defaults';
+export { ComboboxContent, ComboboxInput } from './combobox-parts';
+export { ComboboxGroup, ComboboxItem, ComboboxSeparator } from './combobox-items';
+export type { ComboboxAlign, ComboboxAutocomplete, ComboboxContentProps, ComboboxDefaults, ComboboxDefaultsProviderProps, ComboboxFilter, ComboboxGroupProps, ComboboxHandle, ComboboxHighlightReason, ComboboxInputProps, ComboboxInputReason, ComboboxInputRootProps, ComboboxItemProps, ComboboxItems, ComboboxMount, ComboboxOpenOn, ComboboxOpenReason, ComboboxOption, ComboboxOptionGroup, ComboboxOptionValue, ComboboxPositionerProps, ComboboxProps, ComboboxSide, ComboboxSize, ComboboxStrategy, ComboboxValueReason, ComboboxVariant, ComboboxWidth, } from './combobox.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/combobox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAClF,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/types/command-palette/command-palette-defaults.d.ts

@@ -0,0 +1,30 @@
+import type { CommandPaletteDefaults, CommandPaletteDefaultsProviderProps } from './command-palette.types';
+/**
+ * The numbers, and why they are these numbers.
+ *
+ * `loop` is `true`, as `menu`'s is and unlike `combobox`'s: a palette is a
+ * short list of commands, and wrapping from the last to the first is the
+ * gesture a reader holding ArrowDown expects.
+ *
+ * `autoHighlight` is `true`, unlike `combobox`'s: the first result is what
+ * `Enter` runs, which is the whole speed of a palette. A combobox commits a
+ * value into a form and cannot afford a highlight nobody looked at; a palette
+ * runs a command the reader can see.
+ *
+ * `hotkey` is `mod+k`, the chord Linear, Slack, GitHub and Vercel answer and
+ * Mantine's default. Firefox uses it for its search bar; the family calls
+ * `preventDefault` when it matches.
+ *
+ * `recentLimit` is five: enough to hold what a reader keeps coming back to,
+ * and few enough that the recents do not push the first group off the screen.
+ */
+export declare const COMMAND_PALETTE_FALLBACK: CommandPaletteDefaults;
+/** The defaults in force here. A palette reads it; a consumer rarely needs to. */
+export declare function useCommandPaletteDefaults(): CommandPaletteDefaults;
+/**
+ * The decisions an application takes once — the hotkey, the measure and the
+ * behaviour. The sentences the family speaks come from the language in force
+ * (`SlottedProvider`).
+ */
+export declare function CommandPaletteDefaultsProvider({ children, ...overrides }: CommandPaletteDefaultsProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=command-palette-defaults.d.ts.map

package/dist/types/command-palette/command-palette-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-palette-defaults.d.ts","sourceRoot":"","sources":["../../../src/command-palette/command-palette-defaults.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EACtB,mCAAmC,EACpC,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,wBAAwB,EAAE,sBAWtC,CAAC;AAKF,kFAAkF;AAClF,wBAAgB,yBAAyB,IAAI,sBAAsB,CAElE;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,EAC7C,QAAQ,EACR,GAAG,SAAS,EACb,EAAE,mCAAmC,+BAYrC"}