themelia-ui 1.0.3 → 2.0.0

package/dist/components/base/popover-menu/index.d.ts

@@ -1,3 +1,3 @@
-export { PopoverMenu, type PopoverMenuProps } from './popover-menu.js';
+export { PopoverMenu, PopoverMenuPanel, type PopoverMenuPanelProps, type PopoverMenuProps, } from './popover-menu.js';
 export type { PopoverMenuItem } from './popover-menu.types.js';
 export { defaultPopoverMenuStrings, type PopoverMenuStrings } from './popover-menu.strings.js';

package/dist/components/base/popover-menu/popover-menu.d.cts

@@ -1,4 +1,4 @@
-import { ComponentProps, ReactElement, ReactNode } from 'react';
+import { ComponentProps, ReactElement, ReactNode, Ref } from 'react';
 import { PopoverContent } from '../popover/index.cjs';
 import { PopoverMenuStrings } from './popover-menu.strings.cjs';
 import { PopoverMenuItem } from './popover-menu.types.cjs';
@@ -13,34 +13,100 @@ export interface PopoverMenuProps<T = unknown> {
     search?: boolean;
     /**
      * Controlled search value. Supplying `onSearchChange` also hands filtering to the
-     * caller — the local matcher steps aside rather than filtering an already-filtered
-     * list, which is how a server-side search ends up showing nothing.
+     * caller: the local matcher turns off.
      */
     searchValue?: string;
     onSearchChange?: (value: string) => void;
+    /**
+     * Characters (trimmed) the search needs before rows show. Defaults to 0. An empty field
+     * still shows `items`; below the minimum, `strings.formatTypeToSearch` shows instead.
+     */
+    minSearchLength?: number;
     loading?: boolean;
+    /**
+     * The items could not be loaded: `true` shows `strings.error`, any other node is the
+     * message. Replaces the rows and the empty state; `loading` takes precedence.
+     */
+    error?: ReactNode;
+    /** Adds a retry control under the error. */
+    onRetry?: () => void;
     /** Band above the search field. */
     header?: ReactNode;
     /** Band below the list — confirm and clear buttons. */
     footer?: ReactNode;
-    /** Replaces the default no-results copy. */
+    /**
+     * Closes the popover after a row is chosen and returns focus to the trigger. Defaults
+     * to true unless a `footer` is present (the multi-pick shape).
+     */
+    closeOnSelect?: boolean;
     /** A rendered empty state. For plain copy, use `strings.empty`. */
     empty?: ReactNode;
     /** Replaces the default spinner strip. */
     loadingSlot?: ReactNode;
-    /** Overrides this menu's own copy — the filter placeholder and the loading row. */
+    /** Overrides this menu's own copy — the filter placeholder, the loading, empty and error rows. */
     strings?: Partial<PopoverMenuStrings>;
     /** Full control over a row. */
     renderItem?: (item: PopoverMenuItem<T>) => ReactNode;
     align?: ComponentProps<typeof PopoverContent>["align"];
     sideOffset?: ComponentProps<typeof PopoverContent>["sideOffset"];
+    /** Accessible name for the list. Most needed with `search={false}`, where focus lands on the list. */
+    label?: string;
+    className?: string;
+}
+/**
+ * A "trigger → optional header → search → list" picker: filter facets, operator selects,
+ * assignee menus. For other shapes compose `Popover` and `Command`; inside a surface
+ * something else owns, render `PopoverMenuPanel`.
+ */
+export declare function PopoverMenu<T = unknown>({ trigger, items, onSelect, open, onOpenChange, search, searchValue, onSearchChange, minSearchLength, loading, error, onRetry, header, footer, closeOnSelect, empty, loadingSlot, strings, renderItem, align, sideOffset, label, className, }: PopoverMenuProps<T>): import("react").JSX.Element;
+export interface PopoverMenuPanelProps<T = unknown> {
+    items: readonly PopoverMenuItem<T>[];
+    /** A row was chosen. The panel neither tracks selection nor closes; its host decides both. */
+    onSelect: (item: PopoverMenuItem<T>) => void;
+    /** Shows the search field above the list. Defaults to true. */
+    search?: boolean;
+    /**
+     * Controlled search value. Supplying `onSearchChange` also hands filtering to the
+     * caller: the local matcher turns off.
+     */
+    searchValue?: string;
+    onSearchChange?: (value: string) => void;
+    /**
+     * Characters (trimmed) the search needs before rows show. Defaults to 0. An empty field
+     * still shows `items`; below the minimum, `strings.formatTypeToSearch` shows instead.
+     */
+    minSearchLength?: number;
+    loading?: boolean;
+    /**
+     * The items could not be loaded: `true` shows `strings.error`, any other node is the
+     * message. Replaces the rows and the empty state; `loading` takes precedence.
+     */
+    error?: ReactNode;
+    /** Adds a retry control under the error. */
+    onRetry?: () => void;
+    /** Band above the search field. */
+    header?: ReactNode;
+    /** Band below the list — confirm and clear buttons. */
+    footer?: ReactNode;
+    /** A rendered empty state. For plain copy, use `strings.empty`. */
+    empty?: ReactNode;
+    /** Replaces the default spinner strip. */
+    loadingSlot?: ReactNode;
+    /** Overrides the panel's own copy — the filter placeholder, the loading, empty and error rows. */
+    strings?: Partial<PopoverMenuStrings>;
+    /** Full control over a row. */
+    renderItem?: (item: PopoverMenuItem<T>) => ReactNode;
+    /** Accessible name for the list. Most needed with `search={false}`, where focus lands on the list. */
+    label?: string;
+    /**
+     * The list element. Without a search field it is the tab stop, and what a host's
+     * `initialFocus` should target.
+     */
+    ref?: Ref<HTMLDivElement>;
     className?: string;
 }
 /**
- * The recurring "trigger → optional header → search → list" picker: filter facets,
- * operator selects, assignee menus.
- *
- * For anything outside that shape, compose `Popover` and `Command` directly — this is a
- * bounded convenience over them, not a replacement.
+ * The body of a `PopoverMenu` (header, search, rows, footer) without the popover, for a
+ * surface something else owns: one step of a two-step popup, a sheet on a phone.
  */
-export declare function PopoverMenu<T = unknown>({ trigger, items, onSelect, open, onOpenChange, search, searchValue, onSearchChange, loading, header, footer, empty, loadingSlot, strings, renderItem, align, sideOffset, className, }: PopoverMenuProps<T>): import("react").JSX.Element;
+export declare function PopoverMenuPanel<T = unknown>({ items, onSelect, search, searchValue, onSearchChange, minSearchLength, loading, error, onRetry, header, footer, empty, loadingSlot, strings, renderItem, label, ref, className, }: PopoverMenuPanelProps<T>): import("react").JSX.Element;

package/dist/components/base/popover-menu/popover-menu.d.ts

@@ -1,4 +1,4 @@
-import { ComponentProps, ReactElement, ReactNode } from 'react';
+import { ComponentProps, ReactElement, ReactNode, Ref } from 'react';
 import { PopoverContent } from '../popover/index.js';
 import { PopoverMenuStrings } from './popover-menu.strings.js';
 import { PopoverMenuItem } from './popover-menu.types.js';
@@ -13,34 +13,100 @@ export interface PopoverMenuProps<T = unknown> {
     search?: boolean;
     /**
      * Controlled search value. Supplying `onSearchChange` also hands filtering to the
-     * caller — the local matcher steps aside rather than filtering an already-filtered
-     * list, which is how a server-side search ends up showing nothing.
+     * caller: the local matcher turns off.
      */
     searchValue?: string;
     onSearchChange?: (value: string) => void;
+    /**
+     * Characters (trimmed) the search needs before rows show. Defaults to 0. An empty field
+     * still shows `items`; below the minimum, `strings.formatTypeToSearch` shows instead.
+     */
+    minSearchLength?: number;
     loading?: boolean;
+    /**
+     * The items could not be loaded: `true` shows `strings.error`, any other node is the
+     * message. Replaces the rows and the empty state; `loading` takes precedence.
+     */
+    error?: ReactNode;
+    /** Adds a retry control under the error. */
+    onRetry?: () => void;
     /** Band above the search field. */
     header?: ReactNode;
     /** Band below the list — confirm and clear buttons. */
     footer?: ReactNode;
-    /** Replaces the default no-results copy. */
+    /**
+     * Closes the popover after a row is chosen and returns focus to the trigger. Defaults
+     * to true unless a `footer` is present (the multi-pick shape).
+     */
+    closeOnSelect?: boolean;
     /** A rendered empty state. For plain copy, use `strings.empty`. */
     empty?: ReactNode;
     /** Replaces the default spinner strip. */
     loadingSlot?: ReactNode;
-    /** Overrides this menu's own copy — the filter placeholder and the loading row. */
+    /** Overrides this menu's own copy — the filter placeholder, the loading, empty and error rows. */
     strings?: Partial<PopoverMenuStrings>;
     /** Full control over a row. */
     renderItem?: (item: PopoverMenuItem<T>) => ReactNode;
     align?: ComponentProps<typeof PopoverContent>["align"];
     sideOffset?: ComponentProps<typeof PopoverContent>["sideOffset"];
+    /** Accessible name for the list. Most needed with `search={false}`, where focus lands on the list. */
+    label?: string;
+    className?: string;
+}
+/**
+ * A "trigger → optional header → search → list" picker: filter facets, operator selects,
+ * assignee menus. For other shapes compose `Popover` and `Command`; inside a surface
+ * something else owns, render `PopoverMenuPanel`.
+ */
+export declare function PopoverMenu<T = unknown>({ trigger, items, onSelect, open, onOpenChange, search, searchValue, onSearchChange, minSearchLength, loading, error, onRetry, header, footer, closeOnSelect, empty, loadingSlot, strings, renderItem, align, sideOffset, label, className, }: PopoverMenuProps<T>): import("react").JSX.Element;
+export interface PopoverMenuPanelProps<T = unknown> {
+    items: readonly PopoverMenuItem<T>[];
+    /** A row was chosen. The panel neither tracks selection nor closes; its host decides both. */
+    onSelect: (item: PopoverMenuItem<T>) => void;
+    /** Shows the search field above the list. Defaults to true. */
+    search?: boolean;
+    /**
+     * Controlled search value. Supplying `onSearchChange` also hands filtering to the
+     * caller: the local matcher turns off.
+     */
+    searchValue?: string;
+    onSearchChange?: (value: string) => void;
+    /**
+     * Characters (trimmed) the search needs before rows show. Defaults to 0. An empty field
+     * still shows `items`; below the minimum, `strings.formatTypeToSearch` shows instead.
+     */
+    minSearchLength?: number;
+    loading?: boolean;
+    /**
+     * The items could not be loaded: `true` shows `strings.error`, any other node is the
+     * message. Replaces the rows and the empty state; `loading` takes precedence.
+     */
+    error?: ReactNode;
+    /** Adds a retry control under the error. */
+    onRetry?: () => void;
+    /** Band above the search field. */
+    header?: ReactNode;
+    /** Band below the list — confirm and clear buttons. */
+    footer?: ReactNode;
+    /** A rendered empty state. For plain copy, use `strings.empty`. */
+    empty?: ReactNode;
+    /** Replaces the default spinner strip. */
+    loadingSlot?: ReactNode;
+    /** Overrides the panel's own copy — the filter placeholder, the loading, empty and error rows. */
+    strings?: Partial<PopoverMenuStrings>;
+    /** Full control over a row. */
+    renderItem?: (item: PopoverMenuItem<T>) => ReactNode;
+    /** Accessible name for the list. Most needed with `search={false}`, where focus lands on the list. */
+    label?: string;
+    /**
+     * The list element. Without a search field it is the tab stop, and what a host's
+     * `initialFocus` should target.
+     */
+    ref?: Ref<HTMLDivElement>;
     className?: string;
 }
 /**
- * The recurring "trigger → optional header → search → list" picker: filter facets,
- * operator selects, assignee menus.
- *
- * For anything outside that shape, compose `Popover` and `Command` directly — this is a
- * bounded convenience over them, not a replacement.
+ * The body of a `PopoverMenu` (header, search, rows, footer) without the popover, for a
+ * surface something else owns: one step of a two-step popup, a sheet on a phone.
  */
-export declare function PopoverMenu<T = unknown>({ trigger, items, onSelect, open, onOpenChange, search, searchValue, onSearchChange, loading, header, footer, empty, loadingSlot, strings, renderItem, align, sideOffset, className, }: PopoverMenuProps<T>): import("react").JSX.Element;
+export declare function PopoverMenuPanel<T = unknown>({ items, onSelect, search, searchValue, onSearchChange, minSearchLength, loading, error, onRetry, header, footer, empty, loadingSlot, strings, renderItem, label, ref, className, }: PopoverMenuPanelProps<T>): import("react").JSX.Element;

package/dist/components/base/popover-menu/popover-menu.strings.d.cts

@@ -5,5 +5,11 @@ export interface PopoverMenuStrings {
     searchPlaceholder: string;
     /** Shown when the filter matches nothing. */
     empty: string;
+    /** Shown in place of the rows when `error` is `true`. */
+    error?: string;
+    /** The control beside the error, when `onRetry` is wired. */
+    retry?: string;
+    /** Shown in place of the rows while the search is shorter than `minSearchLength`. */
+    formatTypeToSearch?: (minimum: number) => string;
 }
 export declare const defaultPopoverMenuStrings: PopoverMenuStrings;

package/dist/components/base/popover-menu/popover-menu.strings.d.ts

@@ -5,5 +5,11 @@ export interface PopoverMenuStrings {
     searchPlaceholder: string;
     /** Shown when the filter matches nothing. */
     empty: string;
+    /** Shown in place of the rows when `error` is `true`. */
+    error?: string;
+    /** The control beside the error, when `onRetry` is wired. */
+    retry?: string;
+    /** Shown in place of the rows while the search is shorter than `minSearchLength`. */
+    formatTypeToSearch?: (minimum: number) => string;
 }
 export declare const defaultPopoverMenuStrings: PopoverMenuStrings;

package/dist/components/base/qr-code/qr-code.d.cts

@@ -2,10 +2,8 @@ import { QRCodeStrings } from './qr-code.strings.cjs';
 import { ComponentProps } from 'react';
 import * as React from "react";
 /**
- * How much of the symbol can be obscured and still decode: L ≈ 7%, M ≈ 15%, Q ≈ 25%,
- * H ≈ 30%. Higher costs density — the same payload needs a larger grid.
- *
- * Named for the source kit's prop rather than the encoder's `errorCorrectionLevel`.
+ * Error correction (the encoder's `errorCorrectionLevel`): how much of the symbol can be
+ * obscured and still decode — L ≈ 7%, M ≈ 15%, Q ≈ 25%, H ≈ 30%. Higher needs a larger grid.
  */
 export type QRRobustness = "L" | "M" | "Q" | "H";
 export interface QRCodeProps extends Omit<ComponentProps<"div">, "children"> {
@@ -20,11 +18,7 @@ export interface QRCodeProps extends Omit<ComponentProps<"div">, "children"> {
     placeholder?: string;
     /** Overrides this code's own copy — the two placeholder states and its name. */
     strings?: Partial<QRCodeStrings>;
-    /**
-     * Shown when `value` is empty. Defaults to rendering nothing, because an empty value
-     * usually means the thing being encoded does not exist yet — a placeholder there
-     * claims something is loading when nothing is.
-     */
+    /** Shown when `value` is empty. Defaults to rendering nothing (it is not a loading state). */
     emptyState?: React.ReactNode;
     /** Announced in place of the symbol, which is meaningless to a screen reader. */
     label?: string;

package/dist/components/base/qr-code/qr-code.d.ts

@@ -2,10 +2,8 @@ import { QRCodeStrings } from './qr-code.strings.js';
 import { ComponentProps } from 'react';
 import * as React from "react";
 /**
- * How much of the symbol can be obscured and still decode: L ≈ 7%, M ≈ 15%, Q ≈ 25%,
- * H ≈ 30%. Higher costs density — the same payload needs a larger grid.
- *
- * Named for the source kit's prop rather than the encoder's `errorCorrectionLevel`.
+ * Error correction (the encoder's `errorCorrectionLevel`): how much of the symbol can be
+ * obscured and still decode — L ≈ 7%, M ≈ 15%, Q ≈ 25%, H ≈ 30%. Higher needs a larger grid.
  */
 export type QRRobustness = "L" | "M" | "Q" | "H";
 export interface QRCodeProps extends Omit<ComponentProps<"div">, "children"> {
@@ -20,11 +18,7 @@ export interface QRCodeProps extends Omit<ComponentProps<"div">, "children"> {
     placeholder?: string;
     /** Overrides this code's own copy — the two placeholder states and its name. */
     strings?: Partial<QRCodeStrings>;
-    /**
-     * Shown when `value` is empty. Defaults to rendering nothing, because an empty value
-     * usually means the thing being encoded does not exist yet — a placeholder there
-     * claims something is loading when nothing is.
-     */
+    /** Shown when `value` is empty. Defaults to rendering nothing (it is not a loading state). */
     emptyState?: React.ReactNode;
     /** Announced in place of the symbol, which is meaningless to a screen reader. */
     label?: string;

package/dist/components/base/qr-code/qr-code.strings.d.cts

@@ -1,10 +1,4 @@
-/**
- * What a QR code says while it has nothing to show.
- *
- * Both states were English literals: the placeholder as a default parameter, the failure
- * as a string inside a ternary — which is why one of them was invisible to a scanner
- * looking for text between tags.
- */
+/** A QR code's copy: its pending and failed states, and the symbol's accessible name. */
 export interface QRCodeStrings {
     /** While the symbol is being generated. */
     generating: string;

package/dist/components/base/qr-code/qr-code.strings.d.ts

@@ -1,10 +1,4 @@
-/**
- * What a QR code says while it has nothing to show.
- *
- * Both states were English literals: the placeholder as a default parameter, the failure
- * as a string inside a ternary — which is why one of them was invisible to a scanner
- * looking for text between tags.
- */
+/** A QR code's copy: its pending and failed states, and the symbol's accessible name. */
 export interface QRCodeStrings {
     /** While the symbol is being generated. */
     generating: string;

package/dist/components/base/repeaters/localized-fields.d.cts

@@ -19,9 +19,13 @@ export interface LocalizedStringFieldProps {
     /** Marks locales that must be filled, so the switcher can flag what is missing. */
     requiredLocales?: string[];
     className?: string;
+    /** The field's name; `FormField` supplies the `aria-*` wiring below. */
     "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
+    "aria-invalid"?: boolean | "true" | "false";
 }
-export declare function LocalizedStringField({ locales, value, onValueChange, multiline, placeholder, disabled, invalid, requiredLocales, className, "aria-label": ariaLabel, }: LocalizedStringFieldProps): import("react").JSX.Element;
+export declare function LocalizedStringField({ locales, value, onValueChange, multiline, placeholder, disabled, invalid, requiredLocales, className, "aria-label": ariaLabel, "aria-labelledby": labelledBy, "aria-describedby": describedBy, "aria-invalid": ariaInvalid, }: LocalizedStringFieldProps): import("react").JSX.Element;
 export interface LocalizedObjectFieldDefinition {
     /** Key in each locale's object. */
     name: string;

package/dist/components/base/repeaters/localized-fields.d.ts

@@ -19,9 +19,13 @@ export interface LocalizedStringFieldProps {
     /** Marks locales that must be filled, so the switcher can flag what is missing. */
     requiredLocales?: string[];
     className?: string;
+    /** The field's name; `FormField` supplies the `aria-*` wiring below. */
     "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
+    "aria-invalid"?: boolean | "true" | "false";
 }
-export declare function LocalizedStringField({ locales, value, onValueChange, multiline, placeholder, disabled, invalid, requiredLocales, className, "aria-label": ariaLabel, }: LocalizedStringFieldProps): import("react").JSX.Element;
+export declare function LocalizedStringField({ locales, value, onValueChange, multiline, placeholder, disabled, invalid, requiredLocales, className, "aria-label": ariaLabel, "aria-labelledby": labelledBy, "aria-describedby": describedBy, "aria-invalid": ariaInvalid, }: LocalizedStringFieldProps): import("react").JSX.Element;
 export interface LocalizedObjectFieldDefinition {
     /** Key in each locale's object. */
     name: string;

package/dist/components/base/repeaters/object-repeater.d.cts

@@ -27,10 +27,7 @@ export interface ObjectRepeaterProps {
     value: ObjectRow[];
     onValueChange: (value: ObjectRow[]) => void;
     fields: ObjectFieldDef[];
-    /**
-     * Prefixes the generated field paths, so they match the shape a form library expects.
-     * Purely a naming aid — this component reads and writes the array it is given.
-     */
+    /** Prefixes the generated field paths (`items.2.email`) to match a form library. Naming only. */
     name?: string;
     emptyState?: ReactNode;
     maxItems?: number;

package/dist/components/base/repeaters/object-repeater.d.ts

@@ -27,10 +27,7 @@ export interface ObjectRepeaterProps {
     value: ObjectRow[];
     onValueChange: (value: ObjectRow[]) => void;
     fields: ObjectFieldDef[];
-    /**
-     * Prefixes the generated field paths, so they match the shape a form library expects.
-     * Purely a naming aid — this component reads and writes the array it is given.
-     */
+    /** Prefixes the generated field paths (`items.2.email`) to match a form library. Naming only. */
     name?: string;
     emptyState?: ReactNode;
     maxItems?: number;

package/dist/components/base/repeaters/repeaters.strings.d.cts

@@ -2,31 +2,25 @@ export interface RepeaterStrings {
     /** The control that appends a row. */
     add: string;
     /**
-     * Names the row's remove control, by the row it removes.
-     *
-     * A function rather than a bare label, because every remove button in a list saying
-     * the same thing is a column of controls a screen reader cannot tell apart — and
-     * because "Remove item 3" does not reorder cleanly into every language.
+     * Announced after a keyboard move. Optional so older complete strings objects still
+     * type-check.
      */
+    moved?: (position: number, total: number) => string;
+    /** Names each row's remove control, by its row. */
     remove: (index: number) => string;
+    /** Names the drag handle, including how to move it by keyboard. */
+    reorder: (index: number) => string;
     /**
-     * Names the drag handle, and says how to use it without a pointer.
-     *
-     * The instruction is part of the sentence rather than a separate key, because a
-     * language that puts it first has no way to reassemble two halves in the right order.
+     * Shown when the list is empty; the `emptyState` prop replaces it. Optional so older
+     * complete strings objects still type-check.
      */
-    reorder: (index: number) => string;
+    emptyState?: string;
 }
 export declare const defaultRepeaterStrings: RepeaterStrings;
 export interface KeyValueEditorStrings extends RepeaterStrings {
     keyPlaceholder: string;
     valuePlaceholder: string;
-    /**
-     * Names each field by its row, so a column of them can be told apart.
-     *
-     * The placeholder cannot do this job: it names the KIND of field, and every row's is
-     * identical. A screen reader moving down the column heard "Key" eleven times.
-     */
+    /** Names each field by its row (the placeholder is identical on every row). */
     keyLabel: (index: number) => string;
     valueLabel: (index: number) => string;
 }

package/dist/components/base/repeaters/repeaters.strings.d.ts

@@ -2,31 +2,25 @@ export interface RepeaterStrings {
     /** The control that appends a row. */
     add: string;
     /**
-     * Names the row's remove control, by the row it removes.
-     *
-     * A function rather than a bare label, because every remove button in a list saying
-     * the same thing is a column of controls a screen reader cannot tell apart — and
-     * because "Remove item 3" does not reorder cleanly into every language.
+     * Announced after a keyboard move. Optional so older complete strings objects still
+     * type-check.
      */
+    moved?: (position: number, total: number) => string;
+    /** Names each row's remove control, by its row. */
     remove: (index: number) => string;
+    /** Names the drag handle, including how to move it by keyboard. */
+    reorder: (index: number) => string;
     /**
-     * Names the drag handle, and says how to use it without a pointer.
-     *
-     * The instruction is part of the sentence rather than a separate key, because a
-     * language that puts it first has no way to reassemble two halves in the right order.
+     * Shown when the list is empty; the `emptyState` prop replaces it. Optional so older
+     * complete strings objects still type-check.
      */
-    reorder: (index: number) => string;
+    emptyState?: string;
 }
 export declare const defaultRepeaterStrings: RepeaterStrings;
 export interface KeyValueEditorStrings extends RepeaterStrings {
     keyPlaceholder: string;
     valuePlaceholder: string;
-    /**
-     * Names each field by its row, so a column of them can be told apart.
-     *
-     * The placeholder cannot do this job: it names the KIND of field, and every row's is
-     * identical. A screen reader moving down the column heard "Key" eleven times.
-     */
+    /** Names each field by its row (the placeholder is identical on every row). */
     keyLabel: (index: number) => string;
     valueLabel: (index: number) => string;
 }

package/dist/components/base/resizable/resizable.d.cts

@@ -1,12 +1,6 @@
 /**
- * Resizable — split panes the reader can drag.
- *
- * The handle is a real separator with `role="separator"` and arrow-key support from the
- * library, which is what makes this different from a div with a mousedown listener: a
- * split someone can only adjust with a pointer is a split half the readers cannot adjust.
- *
- * Persist sizes in application state with onLayoutChanged and restore defaultLayout.
- * The wrapper forwards the current react-resizable-panels GroupProps contract.
+ * Resizable — split panes on react-resizable-panels; the handle is a keyboard-operable
+ * `role="separator"`. Persist sizes with `onLayoutChanged` and restore via `defaultLayout`.
  */
 import * as ResizablePrimitive from "react-resizable-panels";
 export interface ResizablePanelGroupProps extends ResizablePrimitive.GroupProps {
@@ -16,13 +10,7 @@ export interface ResizablePanelProps extends ResizablePrimitive.PanelProps {
 }
 export declare function ResizablePanel({ className, ...props }: ResizablePanelProps): import("react").JSX.Element;
 export interface ResizableHandleProps extends ResizablePrimitive.SeparatorProps {
-    /**
-     * Draws a grip on the line.
-     *
-     * Off by default: a 1px rule between two panes is the quiet version, and the hit area
-     * is wider than the line either way. On for a split where the reader has no other cue
-     * that the boundary moves.
-     */
+    /** Draws a grip on the line, for a split with no other cue that it moves. Defaults to false. */
     withHandle?: boolean;
 }
 export declare function ResizableHandle({ withHandle, className, ...props }: ResizableHandleProps): import("react").JSX.Element;

package/dist/components/base/resizable/resizable.d.ts

@@ -1,12 +1,6 @@
 /**
- * Resizable — split panes the reader can drag.
- *
- * The handle is a real separator with `role="separator"` and arrow-key support from the
- * library, which is what makes this different from a div with a mousedown listener: a
- * split someone can only adjust with a pointer is a split half the readers cannot adjust.
- *
- * Persist sizes in application state with onLayoutChanged and restore defaultLayout.
- * The wrapper forwards the current react-resizable-panels GroupProps contract.
+ * Resizable — split panes on react-resizable-panels; the handle is a keyboard-operable
+ * `role="separator"`. Persist sizes with `onLayoutChanged` and restore via `defaultLayout`.
  */
 import * as ResizablePrimitive from "react-resizable-panels";
 export interface ResizablePanelGroupProps extends ResizablePrimitive.GroupProps {
@@ -16,13 +10,7 @@ export interface ResizablePanelProps extends ResizablePrimitive.PanelProps {
 }
 export declare function ResizablePanel({ className, ...props }: ResizablePanelProps): import("react").JSX.Element;
 export interface ResizableHandleProps extends ResizablePrimitive.SeparatorProps {
-    /**
-     * Draws a grip on the line.
-     *
-     * Off by default: a 1px rule between two panes is the quiet version, and the hit area
-     * is wider than the line either way. On for a split where the reader has no other cue
-     * that the boundary moves.
-     */
+    /** Draws a grip on the line, for a split with no other cue that it moves. Defaults to false. */
     withHandle?: boolean;
 }
 export declare function ResizableHandle({ withHandle, className, ...props }: ResizableHandleProps): import("react").JSX.Element;

package/dist/components/base/sheet/index.d.cts

@@ -1 +1 @@
-export { Sheet, SheetTrigger, SheetClose, SheetContent, SheetHeader, SheetBody, SheetFooter, SheetTitle, SheetDescription, type SheetSide, type SheetContentProps, } from './sheet.cjs';
+export { SheetContent, type SheetSide, type SheetContentProps, } from './sheet.cjs';

package/dist/components/base/sheet/index.d.ts

@@ -1 +1 @@
-export { Sheet, SheetTrigger, SheetClose, SheetContent, SheetHeader, SheetBody, SheetFooter, SheetTitle, SheetDescription, type SheetSide, type SheetContentProps, } from './sheet.js';
+export { SheetContent, type SheetSide, type SheetContentProps, } from './sheet.js';

package/dist/components/base/sheet/sheet.d.cts

@@ -1,24 +1,14 @@
-import { Overlay, OverlayClose, OverlayTrigger, OverlayContentProps } from '../overlay/index.cjs';
+import { OverlayContentProps } from '../overlay/index.cjs';
 import { SheetSide } from './sheet.types.cjs';
 /**
- * Sheet — an edge-anchored modal panel.
- *
- * The same primitive as Dialog with an edge `placement`. It also exposes `modality`,
- * because a side panel is the case where non-modal genuinely matters: an inspector or a
- * live filter rail exists to sit beside the app while you keep working in it.
+ * Sheet — an edge-anchored Overlay. `SheetContent` names the edge `side` and applies a
+ * default shape; the other parts are Overlay's own (`base/overlay`). `modality` suits an
+ * inspector that sits beside the app.
  */
 import * as React from "react";
 export type { SheetSide };
-export declare const Sheet: typeof Overlay;
-export declare const SheetTrigger: typeof OverlayTrigger;
-export declare const SheetClose: typeof OverlayClose;
-export declare const SheetBody: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export declare const SheetTitle: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
-export declare const SheetDescription: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
 export interface SheetContentProps extends Omit<OverlayContentProps, "placement">, Omit<React.ComponentProps<"dialog">, "children" | "className" | "title"> {
     /** The edge it enters from. */
     side?: SheetSide;
 }
 export declare function SheetContent({ side, size, length, inset, className, ...props }: SheetContentProps): React.JSX.Element;
-export declare function SheetHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
-export declare function SheetFooter({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;

package/dist/components/base/sheet/sheet.d.ts

@@ -1,24 +1,14 @@
-import { Overlay, OverlayClose, OverlayTrigger, OverlayContentProps } from '../overlay/index.js';
+import { OverlayContentProps } from '../overlay/index.js';
 import { SheetSide } from './sheet.types.js';
 /**
- * Sheet — an edge-anchored modal panel.
- *
- * The same primitive as Dialog with an edge `placement`. It also exposes `modality`,
- * because a side panel is the case where non-modal genuinely matters: an inspector or a
- * live filter rail exists to sit beside the app while you keep working in it.
+ * Sheet — an edge-anchored Overlay. `SheetContent` names the edge `side` and applies a
+ * default shape; the other parts are Overlay's own (`base/overlay`). `modality` suits an
+ * inspector that sits beside the app.
  */
 import * as React from "react";
 export type { SheetSide };
-export declare const Sheet: typeof Overlay;
-export declare const SheetTrigger: typeof OverlayTrigger;
-export declare const SheetClose: typeof OverlayClose;
-export declare const SheetBody: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export declare const SheetTitle: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
-export declare const SheetDescription: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
 export interface SheetContentProps extends Omit<OverlayContentProps, "placement">, Omit<React.ComponentProps<"dialog">, "children" | "className" | "title"> {
     /** The edge it enters from. */
     side?: SheetSide;
 }
 export declare function SheetContent({ side, size, length, inset, className, ...props }: SheetContentProps): React.JSX.Element;
-export declare function SheetHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
-export declare function SheetFooter({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;