@skdx/react 0.28.0 → 0.29.0

package/dist/command/CommandEmpty.d.cts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { CommandEmptyProps } from './types.cjs';
 /**
  * Renders when no `CommandItem`s are mounted inside `CommandList` and the
@@ -12,4 +12,7 @@ import type { CommandEmptyProps } from './types.cjs';
  * </CommandList>
  * ```
  */
-export declare const CommandEmpty: React.ForwardRefExoticComponent<Omit<CommandEmptyProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandEmpty: {
+    ({ ref: forwardedRef, ...props }: CommandEmptyProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandEmpty.d.ts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { CommandEmptyProps } from './types.js';
 /**
  * Renders when no `CommandItem`s are mounted inside `CommandList` and the
@@ -12,4 +12,7 @@ import type { CommandEmptyProps } from './types.js';
  * </CommandList>
  * ```
  */
-export declare const CommandEmpty: React.ForwardRefExoticComponent<Omit<CommandEmptyProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandEmpty: {
+    ({ ref: forwardedRef, ...props }: CommandEmptyProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandGroup.d.cts

@@ -1,9 +1,7 @@
 import * as React from 'react';
 import type { CommandGroupProps } from './types.cjs';
 /**
- * Labelled cluster of `CommandItem`s. Renders `<div role="group">` named by
- * its `heading` (`role="presentation"` so it's not an arrow-key option).
- * `aria-labelledby` emitted only when `heading` is given.
+ * Labelled cluster of `CommandItem`s, rendering `<div role="group">` named by its `heading`.
  *
  * @example
  * ```tsx
@@ -13,4 +11,7 @@ import type { CommandGroupProps } from './types.cjs';
  * </CommandGroup>
  * ```
  */
-export declare const CommandGroup: React.ForwardRefExoticComponent<Omit<CommandGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandGroup: {
+    ({ heading, children, ref: forwardedRef, ...props }: CommandGroupProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandGroup.d.ts

@@ -1,9 +1,7 @@
 import * as React from 'react';
 import type { CommandGroupProps } from './types.js';
 /**
- * Labelled cluster of `CommandItem`s. Renders `<div role="group">` named by
- * its `heading` (`role="presentation"` so it's not an arrow-key option).
- * `aria-labelledby` emitted only when `heading` is given.
+ * Labelled cluster of `CommandItem`s, rendering `<div role="group">` named by its `heading`.
  *
  * @example
  * ```tsx
@@ -13,4 +11,7 @@ import type { CommandGroupProps } from './types.js';
  * </CommandGroup>
  * ```
  */
-export declare const CommandGroup: React.ForwardRefExoticComponent<Omit<CommandGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandGroup: {
+    ({ heading, children, ref: forwardedRef, ...props }: CommandGroupProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandInput.d.cts

@@ -1,14 +1,14 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { CommandInputProps } from './types.cjs';
 /**
- * Search/filter field wired to list via `aria-controls` and active item via `aria-activedescendant`.
- * Arrow Up/Down moves virtual highlight (loops if root sets `loop`).
- * Home/End jump first/last item; Enter invokes selection.
- * Real DOM focus stays here; keystrokes write to root's `search`.
+ * Search/filter field wired to the list via `aria-controls` and the active item via `aria-activedescendant`.
  *
  * @example
  * ```tsx
  * <CommandInput placeholder="Search…" />
  * ```
  */
-export declare const CommandInput: React.ForwardRefExoticComponent<Omit<CommandInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
+export declare const CommandInput: {
+    ({ ref: forwardedRef, ...props }: CommandInputProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandInput.d.ts

@@ -1,14 +1,14 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { CommandInputProps } from './types.js';
 /**
- * Search/filter field wired to list via `aria-controls` and active item via `aria-activedescendant`.
- * Arrow Up/Down moves virtual highlight (loops if root sets `loop`).
- * Home/End jump first/last item; Enter invokes selection.
- * Real DOM focus stays here; keystrokes write to root's `search`.
+ * Search/filter field wired to the list via `aria-controls` and the active item via `aria-activedescendant`.
  *
  * @example
  * ```tsx
  * <CommandInput placeholder="Search…" />
  * ```
  */
-export declare const CommandInput: React.ForwardRefExoticComponent<Omit<CommandInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
+export declare const CommandInput: {
+    ({ ref: forwardedRef, ...props }: CommandInputProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandItem.d.cts

@@ -1,12 +1,7 @@
 import * as React from 'react';
 import type { CommandItemProps } from './types.cjs';
 /**
- * A single selectable result: `role="option"` with `aria-selected`,
- * `data-highlighted`, and `aria-disabled`. Registers on mount, unregisters on
- * unmount. Pointer-enter highlights; click or Enter fires `onSelect` (unless
- * `disablePointerSelection`). Set `disabled` to exclude from navigation. Renders
- * nothing when filtered; `data-value` lets root highlight by value. `keywords`
- * adds search aliases; `forceMount` pins the item.
+ * A single selectable result: `role="option"` with `aria-selected`, `data-highlighted`, and `aria-disabled`. Renders nothing when filtered out.
  *
  * @example
  * ```tsx
@@ -15,4 +10,7 @@ import type { CommandItemProps } from './types.cjs';
  * </CommandItem>
  * ```
  */
-export declare const CommandItem: React.ForwardRefExoticComponent<Omit<CommandItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandItem: {
+    ({ value, disabled, onSelect, keywords, forceMount, ref: forwardedRef, ...props }: CommandItemProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandItem.d.ts

@@ -1,12 +1,7 @@
 import * as React from 'react';
 import type { CommandItemProps } from './types.js';
 /**
- * A single selectable result: `role="option"` with `aria-selected`,
- * `data-highlighted`, and `aria-disabled`. Registers on mount, unregisters on
- * unmount. Pointer-enter highlights; click or Enter fires `onSelect` (unless
- * `disablePointerSelection`). Set `disabled` to exclude from navigation. Renders
- * nothing when filtered; `data-value` lets root highlight by value. `keywords`
- * adds search aliases; `forceMount` pins the item.
+ * A single selectable result: `role="option"` with `aria-selected`, `data-highlighted`, and `aria-disabled`. Renders nothing when filtered out.
  *
  * @example
  * ```tsx
@@ -15,4 +10,7 @@ import type { CommandItemProps } from './types.js';
  * </CommandItem>
  * ```
  */
-export declare const CommandItem: React.ForwardRefExoticComponent<Omit<CommandItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandItem: {
+    ({ value, disabled, onSelect, keywords, forceMount, ref: forwardedRef, ...props }: CommandItemProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandList.d.cts

@@ -1,7 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { CommandListProps } from './types.cjs';
 /**
- * Listbox container for `CommandItem`s and `CommandGroup`s. **Must have `aria-label` or `aria-labelledby`** — `role="listbox"` takes no implicit name, and `CommandInput` (a `role="combobox"` sibling) names itself, not the list.
+ * Listbox container for `CommandItem`s and `CommandGroup`s. Requires `aria-label` or `aria-labelledby`: `role="listbox"` takes no implicit name.
  *
  * @example
  * ```tsx
@@ -13,4 +13,7 @@ import type { CommandListProps } from './types.cjs';
  * </CommandList>
  * ```
  */
-export declare const CommandList: React.ForwardRefExoticComponent<Omit<CommandListProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandList: {
+    ({ ref: forwardedRef, ...props }: CommandListProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandList.d.ts

@@ -1,7 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { CommandListProps } from './types.js';
 /**
- * Listbox container for `CommandItem`s and `CommandGroup`s. **Must have `aria-label` or `aria-labelledby`** — `role="listbox"` takes no implicit name, and `CommandInput` (a `role="combobox"` sibling) names itself, not the list.
+ * Listbox container for `CommandItem`s and `CommandGroup`s. Requires `aria-label` or `aria-labelledby`: `role="listbox"` takes no implicit name.
  *
  * @example
  * ```tsx
@@ -13,4 +13,7 @@ import type { CommandListProps } from './types.js';
  * </CommandList>
  * ```
  */
-export declare const CommandList: React.ForwardRefExoticComponent<Omit<CommandListProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandList: {
+    ({ ref: forwardedRef, ...props }: CommandListProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandLoading.d.cts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { CommandLoadingProps } from './types.cjs';
 /**
  * Shown while `loading` is set. Rendered as a polite live region to announce searches without stealing focus.
@@ -14,4 +14,7 @@ import type { CommandLoadingProps } from './types.cjs';
  * </Command>
  * ```
  */
-export declare const CommandLoading: React.ForwardRefExoticComponent<Omit<CommandLoadingProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandLoading: {
+    ({ ref: forwardedRef, ...props }: CommandLoadingProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandLoading.d.ts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { CommandLoadingProps } from './types.js';
 /**
  * Shown while `loading` is set. Rendered as a polite live region to announce searches without stealing focus.
@@ -14,4 +14,7 @@ import type { CommandLoadingProps } from './types.js';
  * </Command>
  * ```
  */
-export declare const CommandLoading: React.ForwardRefExoticComponent<Omit<CommandLoadingProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandLoading: {
+    ({ ref: forwardedRef, ...props }: CommandLoadingProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandSeparator.d.cts

@@ -1,8 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { CommandSeparatorProps } from './types.cjs';
 /**
- * Visual divider between items or groups: renders a
- * `<div role="separator" aria-orientation="horizontal">`.
+ * Visual divider between items or groups, rendering `<div role="separator" aria-orientation="horizontal">`.
  *
  * @example
  * ```tsx
@@ -11,4 +10,7 @@ import type { CommandSeparatorProps } from './types.cjs';
  * <CommandGroup heading="Settings">…</CommandGroup>
  * ```
  */
-export declare const CommandSeparator: React.ForwardRefExoticComponent<Omit<CommandSeparatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandSeparator: {
+    ({ ref: forwardedRef, ...props }: CommandSeparatorProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/CommandSeparator.d.ts

@@ -1,8 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { CommandSeparatorProps } from './types.js';
 /**
- * Visual divider between items or groups: renders a
- * `<div role="separator" aria-orientation="horizontal">`.
+ * Visual divider between items or groups, rendering `<div role="separator" aria-orientation="horizontal">`.
  *
  * @example
  * ```tsx
@@ -11,4 +10,7 @@ import type { CommandSeparatorProps } from './types.js';
  * <CommandGroup heading="Settings">…</CommandGroup>
  * ```
  */
-export declare const CommandSeparator: React.ForwardRefExoticComponent<Omit<CommandSeparatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const CommandSeparator: {
+    ({ ref: forwardedRef, ...props }: CommandSeparatorProps): React.ReactNode;
+    displayName: string;
+};

package/dist/command/types.d.cts

@@ -1,19 +1,15 @@
 import type * as React from 'react';
 import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
 /**
- * Decides which items survive search: a predicate over `value` and `keywords`,
- * or `'manual'` to let the consumer mount only matches. Return a number to rank
- * items by score (0 = exclude, positive = keep, sorted descending); a boolean
- * is the two-point case. Keywords are passed through so a custom filter can
- * honour them; `undefined` when the item declares none.
+ * Decides which items survive search: a predicate over `value` and `keywords`, or `'manual'` to let the consumer mount only matches; a numeric return also ranks (0 excludes, positive keeps, sorted descending).
  */
 export type CommandFilter = 'manual' | ((itemValue: string, search: string, keywords?: readonly string[]) => boolean | number);
 /** @internal Per-item metadata stored in Command's internal ref map, keyed by item id. */
 export interface CommandItemMeta {
     value: string;
-    disabled?: boolean;
-    onSelect?: (value: string) => void;
-    keywords?: readonly string[];
+    disabled?: boolean | undefined;
+    onSelect?: ((value: string) => void) | undefined;
+    keywords?: readonly string[] | undefined;
 }
 /** @internal Context shape distributed from Command to its parts. */
 export interface CommandContextValue {
@@ -23,7 +19,7 @@ export interface CommandContextValue {
     /** Rank each currently-visible item's CSS `order` should carry when `filter` also scores it; `null` leaves order untouched. */
     itemOrder: ReadonlyMap<string, number> | null;
     setActiveId: (id: string | null) => void;
-    itemMetaRef: React.RefObject<Map<string, CommandItemMeta>>;
+    itemMeta: Map<string, CommandItemMeta>;
     registerItem: (id: string) => void;
     unregisterItem: (id: string) => void;
     itemCount: number;
@@ -48,35 +44,30 @@ export interface CommandItem {
      * Identifier passed to `onSelect` and matched as the highlighted item.
      * @default undefined — the item's `label`.
      */
-    value?: string;
+    value?: string | undefined;
     /**
      * Extra strings the filter matches against alongside `value`, so "Toggle theme" is findable by typing "dark mode".
      * @default undefined — the item matches on its value alone.
      */
-    keywords?: string[];
+    keywords?: string[] | undefined;
     /**
      * Excludes the item from keyboard navigation, pointer highlighting and Enter selection.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Called when this item is activated, before Command's own `onSelect`. Both fire.
      * @default undefined
      */
-    onSelect?: () => void;
+    onSelect?: (() => void) | undefined;
 }
-/**
- * One group of {@link CommandProps.groups} — grouping is expressed in the
- * data, never by a wrapper component. A group with no `label` renders its
- * items straight into the list, which is how a flat palette is written:
- * `groups={[{ items }]}`.
- */
+/** One group of {@link CommandProps.groups}; a group with no `label` renders its items straight into the list. */
 export interface CommandGroup {
     /**
      * Heading rendered above the group's items, and the group's accessible name.
      * @default undefined — the items are rendered ungrouped.
      */
-    label?: string;
+    label?: string | undefined;
     /** The group's commands. */
     items: CommandItem[];
 }
@@ -87,93 +78,88 @@ export interface CommandProps extends Omit<PrimitivePropsWithRef<'div'>, 'defaul
      * `children` is given, which switches to full manual composition.
      * @default undefined — an empty palette.
      */
-    groups?: CommandGroup[];
+    groups?: CommandGroup[] | undefined;
     /**
      * Placeholder for the derived search input. Doubles as the derived list's
      * accessible name, which a `role="listbox"` takes from nothing else here.
      * @default undefined — no placeholder, and an unnamed list.
      */
-    placeholder?: string;
+    placeholder?: string | undefined;
     /**
      * Text for the derived `CommandEmpty` part, shown when the search has no matches
      * (not shown while `loading`).
      * @default undefined
      */
-    emptyMessage?: string;
+    emptyMessage?: string | undefined;
     /**
      * Text for the derived `CommandLoading` part, announced by its live region while
      * `loading` is set.
      * @default undefined — no loading state is derived.
      */
-    loadingMessage?: string;
+    loadingMessage?: string | undefined;
     /**
      * Fires with the command that was activated. The command's own `onSelect`
      * fires first; both run, and neither cancels the other.
      * @default undefined — no-op if omitted.
      */
-    onSelect?: (item: CommandItem) => void;
+    onSelect?: ((item: CommandItem) => void) | undefined;
     /**
      * Renders item contents in place of the label; the element's role, id,
      * `data-*`, keyboard wiring and disabled state are still managed by the library.
      * @default undefined
      */
-    renderItem?: (item: CommandItem) => React.ReactNode;
+    renderItem?: ((item: CommandItem) => React.ReactNode) | undefined;
     /**
      * Value of the highlighted item, for controlled usage. Pair with
      * `onValueChange`.
      * @default undefined — uncontrolled, the palette keeps the top match highlighted.
      */
-    value?: string;
+    value?: string | undefined;
     /**
      * Value of the initially highlighted item, for uncontrolled usage.
      * @default undefined — the first mounted item.
      */
-    defaultValue?: string;
+    defaultValue?: string | undefined;
     /**
      * Fires with the highlighted item's value whenever the highlight moves —
      * typing, arrow keys, or pointer.
      * @default undefined — no-op.
      */
-    onValueChange?: (value: string) => void;
+    onValueChange?: ((value: string) => void) | undefined;
     /**
      * Current search text, for controlled usage. `CommandInput` writes into this
      * as the user types.
      * @default undefined — uncontrolled, the root tracks the search internally.
      */
-    search?: string;
+    search?: string | undefined;
     /**
      * Initial search text, for uncontrolled usage.
      * @default ''
      */
-    defaultSearch?: string;
+    defaultSearch?: string | undefined;
     /**
      * Fires with the new search text whenever `CommandInput` changes.
      * @default undefined — no-op.
      */
-    onSearchChange?: (search: string) => void;
+    onSearchChange?: ((search: string) => void) | undefined;
     /**
-     * Replaces the built-in matcher (case-insensitive substring on the item's
-     * `value`) — return `true` to keep an item mounted for this search — or
-     * `'manual'` to filter nothing, when the consumer already mounts only the
-     * matching items. Return a number instead of a boolean to also rank: `0`
-     * excludes, any positive score keeps, and surviving items reorder by score,
-     * descending.
+     * Replaces the built-in matcher (case-insensitive substring on `value`), or `'manual'` to filter nothing.
      * @default undefined — the built-in matcher.
      */
-    filter?: CommandFilter;
+    filter?: CommandFilter | undefined;
     /**
      * Wraps arrow navigation around the ends: Arrow Down from the last item
      * highlights the first, Arrow Up from the first highlights the last.
      * @default false
      */
-    loop?: boolean;
+    loop?: boolean | undefined;
     /**
      * Stops pointer-enter from moving the highlight. Use when the palette is
      * keyboard-driven but the pointer rests over the list — otherwise a motionless
      * mouse steals the highlight from arrow keys.
      * @default false
      */
-    disablePointerSelection?: boolean;
+    disablePointerSelection?: boolean | undefined;
     /**
      * Marks results as in flight: `data-loading` on the root and
      * `aria-busy`/`data-loading` on `CommandList`, mounts `CommandLoading`, and
@@ -181,7 +167,7 @@ export interface CommandProps extends Omit<PrimitivePropsWithRef<'div'>, 'defaul
      * "No results".
      * @default false
      */
-    loading?: boolean;
+    loading?: boolean | undefined;
 }
 /** Props for {@link CommandInput}, the search/filter text field that drives virtual focus. */
 export interface CommandInputProps extends PrimitivePropsWithRef<'input'> {
@@ -198,7 +184,7 @@ export interface CommandGroupProps extends PrimitivePropsWithRef<'div'> {
      * Non-interactive heading rendered above the group's items.
      * @default undefined — no heading rendered.
      */
-    heading?: React.ReactNode;
+    heading?: string | undefined;
 }
 /** Props for a single {@link CommandItem}. */
 export interface CommandItemProps extends Omit<PrimitivePropsWithRef<'div'>, 'onSelect'> {
@@ -208,34 +194,22 @@ export interface CommandItemProps extends Omit<PrimitivePropsWithRef<'div'>, 'on
      * Excludes the item from keyboard navigation, pointer highlighting, and Enter selection.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Extra strings the root's filter matches against, alongside `value`.
-     *
-     * A command labelled "Toggle theme" that users search for as "dark mode" is
-     * the case this exists for: the alias never appears on screen, and matching
-     * only the visible text makes the command unfindable by the word most people
-     * would reach for. Passed through to a custom `filter` as its third argument.
      * @default undefined — the item matches on its `value` alone.
      */
-    keywords?: string[];
+    keywords?: string[] | undefined;
     /**
-     * Keeps the item mounted whatever the search, instead of unmounting when the
-     * filter rejects it.
-     *
-     * For the action that must always be reachable — "Create new…", "Open
-     * settings" — which otherwise has no way to survive a search at all: a
-     * rejected item here is unmounted outright, not merely hidden, so it leaves
-     * the option count, the highlight order and `CommandEmpty` as if it were
-     * never written.
+     * Keeps the item mounted whatever the search, instead of unmounting when the filter rejects it.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
     /**
      * Called with `value` when the item is activated (click, Enter, or pointer + Enter).
      * @default undefined — no-op if omitted.
      */
-    onSelect?: (value: string) => void;
+    onSelect?: ((value: string) => void) | undefined;
 }
 /** Props for {@link CommandLoading}, shown only while the root's `loading` is set. */
 export interface CommandLoadingProps extends PrimitivePropsWithRef<'div'> {