@skdx/react 0.26.0 → 0.28.0

package/dist/tree-select/TreeSelectEmpty.d.cts

@@ -1,10 +1,8 @@
 import * as React from 'react';
 import type { TreeSelectEmptyProps } from './types.cjs';
 /**
- * Fallback shown in place of the tree when nothing is left to show — because
- * the filter matched no node, or because the `collection` itself is empty.
- * Renders a `<div role="presentation">`; renders nothing while at least one
- * node is visible.
+ * Fallback shown when no nodes match the filter or collection is empty.
+ * Renders nothing while at least one node is visible.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectEmpty.d.ts

@@ -1,10 +1,8 @@
 import * as React from 'react';
 import type { TreeSelectEmptyProps } from './types.js';
 /**
- * Fallback shown in place of the tree when nothing is left to show — because
- * the filter matched no node, or because the `collection` itself is empty.
- * Renders a `<div role="presentation">`; renders nothing while at least one
- * node is visible.
+ * Fallback shown when no nodes match the filter or collection is empty.
+ * Renders nothing while at least one node is visible.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectInput.d.cts

@@ -1,22 +1,11 @@
 import * as React from 'react';
 import type { TreeSelectInputProps } from './types.cjs';
 /**
- * Optional filter field inside {@link TreeSelectContent}. Renders an
- * `<input type="text">` that takes real DOM focus when the popup opens and
- * keeps it for the whole interaction, carrying `aria-controls` pointing at the
- * tree and `aria-activedescendant` naming the virtually-focused node — which
- * is why the trigger drops its own `aria-activedescendant` as soon as one of
- * these is mounted.
- *
- * It is a plain textbox rather than a second `role="combobox"`: the trigger
- * already owns that role, and two comboboxes for one popup would be announced
- * as two separate controls.
- *
- * Typing filters the tree. A match keeps its whole ancestor chain visible and
- * expands it *transiently* — clearing the field restores exactly the expansion
- * the user had before. Arrow keys, Home/End, Enter and Escape all behave as
- * they do on the trigger; Space is left alone, because here it is a character
- * the user is typing.
+ * Optional filter field inside {@link TreeSelectContent}. Plain textbox
+ * (not combobox) with `aria-controls` at the tree and `aria-activedescendant`
+ * at the focused node. Typing filters; matches expand transiently with
+ * ancestor chain visible. Arrow keys, Home/End, Enter, Escape behave as on
+ * trigger; Space stays as a character.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectInput.d.ts

@@ -1,22 +1,11 @@
 import * as React from 'react';
 import type { TreeSelectInputProps } from './types.js';
 /**
- * Optional filter field inside {@link TreeSelectContent}. Renders an
- * `<input type="text">` that takes real DOM focus when the popup opens and
- * keeps it for the whole interaction, carrying `aria-controls` pointing at the
- * tree and `aria-activedescendant` naming the virtually-focused node — which
- * is why the trigger drops its own `aria-activedescendant` as soon as one of
- * these is mounted.
- *
- * It is a plain textbox rather than a second `role="combobox"`: the trigger
- * already owns that role, and two comboboxes for one popup would be announced
- * as two separate controls.
- *
- * Typing filters the tree. A match keeps its whole ancestor chain visible and
- * expands it *transiently* — clearing the field restores exactly the expansion
- * the user had before. Arrow keys, Home/End, Enter and Escape all behave as
- * they do on the trigger; Space is left alone, because here it is a character
- * the user is typing.
+ * Optional filter field inside {@link TreeSelectContent}. Plain textbox
+ * (not combobox) with `aria-controls` at the tree and `aria-activedescendant`
+ * at the focused node. Typing filters; matches expand transiently with
+ * ancestor chain visible. Arrow keys, Home/End, Enter, Escape behave as on
+ * trigger; Space stays as a character.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectItem.d.cts

@@ -7,26 +7,14 @@ export declare const TreeSelectItemProvider: {
     displayName: string;
 }, useTreeSelectItemContext: (consumerName: string) => TreeSelectItemContextValue;
 /**
- * One node of a {@link TreeSelect}'s tree, normally rendered for you by
- * `TreeSelectTree`. Composes `TreeItem`, so it inherits `role="treeitem"`,
- * `aria-level`, `aria-selected`, `aria-expanded` and
- * `data-state="expanded" | "collapsed"` unchanged — and adds what a *checkable*
- * node needs on top:
+ * Checkable tree node composing TreeItem. Inherits role=treeitem, aria-level, aria-expanded.
  *
- * - `aria-checked` of `true` / `false` / `"mixed"` (only while the root is
- *   `multiple`), with `data-checked` of `"checked"` / `"unchecked"` /
- *   `"indeterminate"` as its styling hook.
- * - `aria-posinset` / `aria-setsize` measured against the node's *visible*
- *   siblings, so they stay truthful while a filter is on.
- * - `data-highlighted` on the virtually-focused node — the one the trigger's
- *   or input's `aria-activedescendant` names.
- * - `tabIndex={-1}` unconditionally: this tree is navigated by
- *   `aria-activedescendant`, and a roving tab stop inside it would put a
- *   second stop in the tab order.
+ * Adds: aria-checked (true/false/mixed) with data-checked (checked/unchecked/indeterminate).
+ * In multiple mode, aria-checked is the only selection attribute (Tree gets selectionMode=none).
+ * Single-select keeps aria-selected only. aria-posinset/aria-setsize respect visible siblings.
  *
- * Clicking it checks the node (cascading through the subtree under
- * `checkStrategy="cascade"`) instead of `TreeItem`'s default select-and-expand;
- * expansion stays on the chevron, i.e. on `TreeItemIndicator`.
+ * Clicking checks node (cascades under checkStrategy=cascade) instead of selecting+expanding.
+ * Expansion remains on chevron (TreeItemIndicator). tabIndex={-1}; navigated by aria-activedescendant.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectItem.d.ts

@@ -7,26 +7,14 @@ export declare const TreeSelectItemProvider: {
     displayName: string;
 }, useTreeSelectItemContext: (consumerName: string) => TreeSelectItemContextValue;
 /**
- * One node of a {@link TreeSelect}'s tree, normally rendered for you by
- * `TreeSelectTree`. Composes `TreeItem`, so it inherits `role="treeitem"`,
- * `aria-level`, `aria-selected`, `aria-expanded` and
- * `data-state="expanded" | "collapsed"` unchanged — and adds what a *checkable*
- * node needs on top:
+ * Checkable tree node composing TreeItem. Inherits role=treeitem, aria-level, aria-expanded.
  *
- * - `aria-checked` of `true` / `false` / `"mixed"` (only while the root is
- *   `multiple`), with `data-checked` of `"checked"` / `"unchecked"` /
- *   `"indeterminate"` as its styling hook.
- * - `aria-posinset` / `aria-setsize` measured against the node's *visible*
- *   siblings, so they stay truthful while a filter is on.
- * - `data-highlighted` on the virtually-focused node — the one the trigger's
- *   or input's `aria-activedescendant` names.
- * - `tabIndex={-1}` unconditionally: this tree is navigated by
- *   `aria-activedescendant`, and a roving tab stop inside it would put a
- *   second stop in the tab order.
+ * Adds: aria-checked (true/false/mixed) with data-checked (checked/unchecked/indeterminate).
+ * In multiple mode, aria-checked is the only selection attribute (Tree gets selectionMode=none).
+ * Single-select keeps aria-selected only. aria-posinset/aria-setsize respect visible siblings.
  *
- * Clicking it checks the node (cascading through the subtree under
- * `checkStrategy="cascade"`) instead of `TreeItem`'s default select-and-expand;
- * expansion stays on the chevron, i.e. on `TreeItemIndicator`.
+ * Clicking checks node (cascades under checkStrategy=cascade) instead of selecting+expanding.
+ * Expansion remains on chevron (TreeItemIndicator). tabIndex={-1}; navigated by aria-activedescendant.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectItemIndicator.d.cts

@@ -1,16 +1,13 @@
 import * as React from 'react';
 import type { TreeSelectItemIndicatorProps } from './types.cjs';
 /**
- * Marker shown inside a {@link TreeSelectItem} when the node is checked — or
- * *partially* checked, which is the case worth designing for: a branch whose
- * subtree is only half chosen renders this with
- * `data-state="indeterminate"`, and that is where a dash goes instead of a
- * tick. Renders an `aria-hidden` `<span>` with `data-state` of
- * `"checked"` / `"indeterminate"`; renders nothing while the node is
- * unchecked unless `forceMount` is set.
+ * Marker shown in a {@link TreeSelectItem} when checked or partially checked.
+ * Partially checked (half-chosen branch) shows `data-state="indeterminate"`
+ * for a dash instead of tick. Renders `aria-hidden` `<span>` with state
+ * attributes; nothing when unchecked unless `forceMount` is set.
  *
- * The check state itself is announced by the item's `aria-checked`, so this is
- * purely visual — hence `aria-hidden`.
+ * Check state is announced by the item's `aria-checked`, so this is purely
+ * visual.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectItemIndicator.d.ts

@@ -1,16 +1,13 @@
 import * as React from 'react';
 import type { TreeSelectItemIndicatorProps } from './types.js';
 /**
- * Marker shown inside a {@link TreeSelectItem} when the node is checked — or
- * *partially* checked, which is the case worth designing for: a branch whose
- * subtree is only half chosen renders this with
- * `data-state="indeterminate"`, and that is where a dash goes instead of a
- * tick. Renders an `aria-hidden` `<span>` with `data-state` of
- * `"checked"` / `"indeterminate"`; renders nothing while the node is
- * unchecked unless `forceMount` is set.
+ * Marker shown in a {@link TreeSelectItem} when checked or partially checked.
+ * Partially checked (half-chosen branch) shows `data-state="indeterminate"`
+ * for a dash instead of tick. Renders `aria-hidden` `<span>` with state
+ * attributes; nothing when unchecked unless `forceMount` is set.
  *
- * The check state itself is announced by the item's `aria-checked`, so this is
- * purely visual — hence `aria-hidden`.
+ * Check state is announced by the item's `aria-checked`, so this is purely
+ * visual.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectPortal.d.cts

@@ -1,9 +1,7 @@
 import type { TreeSelectPortalProps } from './types.cjs';
 /**
- * Teleports its children (typically {@link TreeSelectContent}) to
- * `document.body` (or `container`, via `PortalProps`) while the
- * {@link TreeSelect}'s popup is open, so it escapes clipping/overflow from
- * ancestors. Renders nothing while closed unless `forceMount` is set.
+ * Teleports its children to `document.body` or `container`, escaping
+ * clipping/overflow while open. Renders nothing while closed unless `forceMount` is set.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectPortal.d.ts

@@ -1,9 +1,7 @@
 import type { TreeSelectPortalProps } from './types.js';
 /**
- * Teleports its children (typically {@link TreeSelectContent}) to
- * `document.body` (or `container`, via `PortalProps`) while the
- * {@link TreeSelect}'s popup is open, so it escapes clipping/overflow from
- * ancestors. Renders nothing while closed unless `forceMount` is set.
+ * Teleports its children to `document.body` or `container`, escaping
+ * clipping/overflow while open. Renders nothing while closed unless `forceMount` is set.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectTree.d.cts

@@ -1,21 +1,15 @@
 import * as React from 'react';
 import type { TreeSelectTreeProps } from './types.cjs';
 /**
- * The `role="tree"` inside a {@link TreeSelect}'s popup: composes the `Tree`
- * family and renders one `TreeSelectItem` per *visible* collection node,
- * nesting each branch's children in a `TreeGroup`. Carries
- * `aria-multiselectable` while the root is `multiple`, `aria-readonly` while it
- * is `readOnly`, and the id the trigger's `aria-controls` points at.
+ * The `role="tree"` inside a {@link TreeSelect}'s popup: renders one `TreeSelectItem`
+ * per *visible* collection node, nesting branches in `TreeGroup`. Carries `aria-multiselectable`
+ * while root is `multiple`, `aria-readonly` while `readOnly`, and the id for `aria-controls`.
  *
- * Expansion is handed to `Tree` as a controlled set, so the chevron
- * (`TreeItemIndicator`) keeps working exactly as it does in a plain tree.
- * Selection is *not*: the root owns cascading check state, because it has to
- * be right for collapsed branches that `Tree` cannot see. Real DOM focus never
- * enters here — every node is `tabIndex={-1}` and the navigation lives on the
- * trigger or the filter input.
+ * Expansion is controlled via `Tree`; chevron (`TreeItemIndicator`) works like plain tree.
+ * Selection is not: root owns cascading check state for collapsed branches `Tree` cannot see.
+ * Real DOM focus never enters — every node is `tabIndex={-1}`, navigation on trigger or input.
  *
- * Give it an accessible name (`aria-label` or `aria-labelledby`): a tree with
- * no name announces as an unnamed group.
+ * Give it an accessible name (`aria-label` or `aria-labelledby`); unnamed trees announce as unnamed groups.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectTree.d.ts

@@ -1,21 +1,15 @@
 import * as React from 'react';
 import type { TreeSelectTreeProps } from './types.js';
 /**
- * The `role="tree"` inside a {@link TreeSelect}'s popup: composes the `Tree`
- * family and renders one `TreeSelectItem` per *visible* collection node,
- * nesting each branch's children in a `TreeGroup`. Carries
- * `aria-multiselectable` while the root is `multiple`, `aria-readonly` while it
- * is `readOnly`, and the id the trigger's `aria-controls` points at.
+ * The `role="tree"` inside a {@link TreeSelect}'s popup: renders one `TreeSelectItem`
+ * per *visible* collection node, nesting branches in `TreeGroup`. Carries `aria-multiselectable`
+ * while root is `multiple`, `aria-readonly` while `readOnly`, and the id for `aria-controls`.
  *
- * Expansion is handed to `Tree` as a controlled set, so the chevron
- * (`TreeItemIndicator`) keeps working exactly as it does in a plain tree.
- * Selection is *not*: the root owns cascading check state, because it has to
- * be right for collapsed branches that `Tree` cannot see. Real DOM focus never
- * enters here — every node is `tabIndex={-1}` and the navigation lives on the
- * trigger or the filter input.
+ * Expansion is controlled via `Tree`; chevron (`TreeItemIndicator`) works like plain tree.
+ * Selection is not: root owns cascading check state for collapsed branches `Tree` cannot see.
+ * Real DOM focus never enters — every node is `tabIndex={-1}`, navigation on trigger or input.
  *
- * Give it an accessible name (`aria-label` or `aria-labelledby`): a tree with
- * no name announces as an unnamed group.
+ * Give it an accessible name (`aria-label` or `aria-labelledby`); unnamed trees announce as unnamed groups.
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectTrigger.d.cts

@@ -1,20 +1,10 @@
 import * as React from 'react';
 import type { TreeSelectTriggerProps } from './types.cjs';
 /**
- * Opens the {@link TreeSelect}'s popup and displays the current selection, and
- * doubles as the popper anchor the popup positions against. Renders a
- * `<button type="button" role="combobox">` with `aria-haspopup="tree"`,
- * `aria-expanded`, `aria-controls` pointing at the tree, `data-state`,
- * `data-disabled`, `data-readonly`, `data-multiple`, and `data-placeholder`
- * while nothing is checked.
- *
- * It also carries `aria-activedescendant` for the virtually-focused node —
- * but only while no `TreeSelectInput` is mounted, since that input takes real
- * DOM focus (and with it the activedescendant) as soon as the popup opens.
- *
- * Click, Enter, Space or Arrow Up/Down opens the popup; once open the same
- * keys walk the tree (see {@link TreeSelect}), and printable characters run
- * typeahead over the visible nodes.
+ * Opens the popup and displays current selection. Renders
+ * `<button role="combobox">` with `aria-haspopup="tree"`, `aria-expanded`,
+ * `aria-controls`, and `aria-activedescendant` (unless `TreeSelectInput` is
+ * mounted).
  *
  * @example
  * ```tsx

package/dist/tree-select/TreeSelectTrigger.d.ts

@@ -1,20 +1,10 @@
 import * as React from 'react';
 import type { TreeSelectTriggerProps } from './types.js';
 /**
- * Opens the {@link TreeSelect}'s popup and displays the current selection, and
- * doubles as the popper anchor the popup positions against. Renders a
- * `<button type="button" role="combobox">` with `aria-haspopup="tree"`,
- * `aria-expanded`, `aria-controls` pointing at the tree, `data-state`,
- * `data-disabled`, `data-readonly`, `data-multiple`, and `data-placeholder`
- * while nothing is checked.
- *
- * It also carries `aria-activedescendant` for the virtually-focused node —
- * but only while no `TreeSelectInput` is mounted, since that input takes real
- * DOM focus (and with it the activedescendant) as soon as the popup opens.
- *
- * Click, Enter, Space or Arrow Up/Down opens the popup; once open the same
- * keys walk the tree (see {@link TreeSelect}), and printable characters run
- * typeahead over the visible nodes.
+ * Opens the popup and displays current selection. Renders
+ * `<button role="combobox">` with `aria-haspopup="tree"`, `aria-expanded`,
+ * `aria-controls`, and `aria-activedescendant` (unless `TreeSelectInput` is
+ * mounted).
  *
  * @example
  * ```tsx

package/dist/tree-select/collection.d.cts

@@ -1,13 +1,8 @@
 import type { TreeCheckedState } from '../tree/types.cjs';
-import type { TreeSelectNode, TreeSelectValueStrategy } from './types.cjs';
+import type { TreeSelectCheckStrategy, TreeSelectNode, TreeSelectValueStrategy } from './types.cjs';
 /**
- * The whole of `tree-select`'s hard part lives in this module, as plain
- * functions over plain data: cascading check state, the `valueStrategy`
- * projection, and the filter's ancestor-preservation rule. None of it touches
- * React or the DOM — which is deliberate, because all three answers must be
- * correct for *collapsed* branches, and a collapsed branch has no DOM at all.
- * (The `tree` family derives its own tri-state from rendered descendants and
- * therefore cannot see them; see `TreeSelect.md`.)
+ * Pure functions for cascading check state, value projection, and filtering.
+ * No React/DOM—must work for collapsed branches with no DOM.
  */
 /** @internal Everything derived once per collection about a single node. */
 export interface TreeSelectIndexEntry {
@@ -38,7 +33,11 @@ export interface TreeSelectFlatNode {
     parent: string | null;
     depth: number;
     disabled: boolean;
-    /** Whether it has at least one *visible* child, which is what decides `aria-expanded`. */
+    /**
+     * Whether it has at least one *visible* child — or declares itself a branch
+     * through `hasChildren` while its children are still unloaded — which is what
+     * decides `aria-expanded`.
+     */
     hasChildren: boolean;
     expanded: boolean;
     /** 1-based position among its visible siblings — `aria-posinset`. */
@@ -54,11 +53,21 @@ export declare function indexCollection(collection: readonly TreeSelectNode[]):
 /** @internal A node's ancestors, nearest first. */
 export declare function ancestorsOf(value: string, index: TreeSelectIndex): string[];
 /**
- * @internal A node's tri-state value. Without cascading it is plain
- * membership; with it, a branch is `true` only when every enabled leaf below
- * it is checked and `"mixed"` when only some are.
+ * @internal The value strategy that can still round-trip under `strategy`.
+ * `'leaf'` drops branches and needs the upward direction to rebuild them;
+ * `'shallowest'` drops descendants and needs the downward direction to rebuild
+ * those. Without the matching direction the projection would silently lose a
+ * selection, so it falls back to `'all'` — which is what `'independent'` has
+ * always done, generalised to the two one-directional strategies.
+ */
+export declare function effectiveValueStrategy(strategy: TreeSelectCheckStrategy, valueStrategy: TreeSelectValueStrategy): TreeSelectValueStrategy;
+/**
+ * @internal A node's tri-state value. Under `'independent'` it is plain
+ * membership; otherwise a branch is `true` when every enabled leaf below it is
+ * checked — or when it was checked directly, which is the only state a
+ * one-directional strategy can leave it in — and `"mixed"` when only some are.
  */
-export declare function checkStateOf(value: string, checked: ReadonlySet<string>, index: TreeSelectIndex, cascade: boolean): TreeCheckedState;
+export declare function checkStateOf(value: string, checked: ReadonlySet<string>, index: TreeSelectIndex, strategy: TreeSelectCheckStrategy): TreeCheckedState;
 /**
  * @internal Expands an emitted `value` back into the full checked set the
  * component reasons about. This is the inverse of {@link projectValue}, and
@@ -66,11 +75,11 @@ export declare function checkStateOf(value: string, checked: ReadonlySet<string>
  * its subtree, `'leaf'` emits leaves standing in for their parent, and both
  * must come back as the same set.
  */
-export declare function normalizeChecked(values: readonly string[], index: TreeSelectIndex, order: readonly string[], cascade: boolean): Set<string>;
+export declare function normalizeChecked(values: readonly string[], index: TreeSelectIndex, order: readonly string[], strategy: TreeSelectCheckStrategy): Set<string>;
 /** @internal Reduces the full checked set to the values a consumer actually receives. */
 export declare function projectValue(checked: ReadonlySet<string>, index: TreeSelectIndex, order: readonly string[], strategy: TreeSelectValueStrategy): string[];
 /** @internal The checked set after activating one node. */
-export declare function toggleChecked(value: string, checked: ReadonlySet<string>, index: TreeSelectIndex, cascade: boolean, multiple: boolean): Set<string>;
+export declare function toggleChecked(value: string, checked: ReadonlySet<string>, index: TreeSelectIndex, strategy: TreeSelectCheckStrategy, multiple: boolean): Set<string>;
 /**
  * @internal Which nodes survive the filter, and which branches have to open to
  * reveal them. A match drags its whole ancestor chain into visibility — a

package/dist/tree-select/collection.d.ts

@@ -1,13 +1,8 @@
 import type { TreeCheckedState } from '../tree/types.js';
-import type { TreeSelectNode, TreeSelectValueStrategy } from './types.js';
+import type { TreeSelectCheckStrategy, TreeSelectNode, TreeSelectValueStrategy } from './types.js';
 /**
- * The whole of `tree-select`'s hard part lives in this module, as plain
- * functions over plain data: cascading check state, the `valueStrategy`
- * projection, and the filter's ancestor-preservation rule. None of it touches
- * React or the DOM — which is deliberate, because all three answers must be
- * correct for *collapsed* branches, and a collapsed branch has no DOM at all.
- * (The `tree` family derives its own tri-state from rendered descendants and
- * therefore cannot see them; see `TreeSelect.md`.)
+ * Pure functions for cascading check state, value projection, and filtering.
+ * No React/DOM—must work for collapsed branches with no DOM.
  */
 /** @internal Everything derived once per collection about a single node. */
 export interface TreeSelectIndexEntry {
@@ -38,7 +33,11 @@ export interface TreeSelectFlatNode {
     parent: string | null;
     depth: number;
     disabled: boolean;
-    /** Whether it has at least one *visible* child, which is what decides `aria-expanded`. */
+    /**
+     * Whether it has at least one *visible* child — or declares itself a branch
+     * through `hasChildren` while its children are still unloaded — which is what
+     * decides `aria-expanded`.
+     */
     hasChildren: boolean;
     expanded: boolean;
     /** 1-based position among its visible siblings — `aria-posinset`. */
@@ -54,11 +53,21 @@ export declare function indexCollection(collection: readonly TreeSelectNode[]):
 /** @internal A node's ancestors, nearest first. */
 export declare function ancestorsOf(value: string, index: TreeSelectIndex): string[];
 /**
- * @internal A node's tri-state value. Without cascading it is plain
- * membership; with it, a branch is `true` only when every enabled leaf below
- * it is checked and `"mixed"` when only some are.
+ * @internal The value strategy that can still round-trip under `strategy`.
+ * `'leaf'` drops branches and needs the upward direction to rebuild them;
+ * `'shallowest'` drops descendants and needs the downward direction to rebuild
+ * those. Without the matching direction the projection would silently lose a
+ * selection, so it falls back to `'all'` — which is what `'independent'` has
+ * always done, generalised to the two one-directional strategies.
+ */
+export declare function effectiveValueStrategy(strategy: TreeSelectCheckStrategy, valueStrategy: TreeSelectValueStrategy): TreeSelectValueStrategy;
+/**
+ * @internal A node's tri-state value. Under `'independent'` it is plain
+ * membership; otherwise a branch is `true` when every enabled leaf below it is
+ * checked — or when it was checked directly, which is the only state a
+ * one-directional strategy can leave it in — and `"mixed"` when only some are.
  */
-export declare function checkStateOf(value: string, checked: ReadonlySet<string>, index: TreeSelectIndex, cascade: boolean): TreeCheckedState;
+export declare function checkStateOf(value: string, checked: ReadonlySet<string>, index: TreeSelectIndex, strategy: TreeSelectCheckStrategy): TreeCheckedState;
 /**
  * @internal Expands an emitted `value` back into the full checked set the
  * component reasons about. This is the inverse of {@link projectValue}, and
@@ -66,11 +75,11 @@ export declare function checkStateOf(value: string, checked: ReadonlySet<string>
  * its subtree, `'leaf'` emits leaves standing in for their parent, and both
  * must come back as the same set.
  */
-export declare function normalizeChecked(values: readonly string[], index: TreeSelectIndex, order: readonly string[], cascade: boolean): Set<string>;
+export declare function normalizeChecked(values: readonly string[], index: TreeSelectIndex, order: readonly string[], strategy: TreeSelectCheckStrategy): Set<string>;
 /** @internal Reduces the full checked set to the values a consumer actually receives. */
 export declare function projectValue(checked: ReadonlySet<string>, index: TreeSelectIndex, order: readonly string[], strategy: TreeSelectValueStrategy): string[];
 /** @internal The checked set after activating one node. */
-export declare function toggleChecked(value: string, checked: ReadonlySet<string>, index: TreeSelectIndex, cascade: boolean, multiple: boolean): Set<string>;
+export declare function toggleChecked(value: string, checked: ReadonlySet<string>, index: TreeSelectIndex, strategy: TreeSelectCheckStrategy, multiple: boolean): Set<string>;
 /**
  * @internal Which nodes survive the filter, and which branches have to open to
  * reveal them. A match drags its whole ancestor chain into visibility — a

package/dist/tree-select/index.d.cts

@@ -1,11 +1,2 @@
 export { TreeSelect, defaultTreeSelectFilter, defaultGetMatchCountLabel } from './TreeSelect.cjs';
-export { TreeSelectTrigger } from './TreeSelectTrigger.cjs';
-export { TreeSelectValue } from './TreeSelectValue.cjs';
-export { TreeSelectPortal } from './TreeSelectPortal.cjs';
-export { TreeSelectContent } from './TreeSelectContent.cjs';
-export { TreeSelectTree } from './TreeSelectTree.cjs';
-export { TreeSelectItem } from './TreeSelectItem.cjs';
-export { TreeSelectItemIndicator } from './TreeSelectItemIndicator.cjs';
-export { TreeSelectEmpty } from './TreeSelectEmpty.cjs';
-export { TreeSelectInput } from './TreeSelectInput.cjs';
-export type { TreeSelectNode, TreeSelectCheckStrategy, TreeSelectValueStrategy, TreeSelectFilter, TreeSelectProps, TreeSelectTriggerProps, TreeSelectValueProps, TreeSelectPortalProps, TreeSelectContentProps, TreeSelectTreeProps, TreeSelectItemProps, TreeSelectItemIndicatorProps, TreeSelectEmptyProps, TreeSelectInputProps, } from './types.cjs';
+export type { TreeSelectNode, TreeSelectCheckStrategy, TreeSelectValueStrategy, TreeSelectFilter, TreeSelectProps, } from './types.cjs';

package/dist/tree-select/index.d.ts

@@ -1,11 +1,2 @@
 export { TreeSelect, defaultTreeSelectFilter, defaultGetMatchCountLabel } from './TreeSelect.js';
-export { TreeSelectTrigger } from './TreeSelectTrigger.js';
-export { TreeSelectValue } from './TreeSelectValue.js';
-export { TreeSelectPortal } from './TreeSelectPortal.js';
-export { TreeSelectContent } from './TreeSelectContent.js';
-export { TreeSelectTree } from './TreeSelectTree.js';
-export { TreeSelectItem } from './TreeSelectItem.js';
-export { TreeSelectItemIndicator } from './TreeSelectItemIndicator.js';
-export { TreeSelectEmpty } from './TreeSelectEmpty.js';
-export { TreeSelectInput } from './TreeSelectInput.js';
-export type { TreeSelectNode, TreeSelectCheckStrategy, TreeSelectValueStrategy, TreeSelectFilter, TreeSelectProps, TreeSelectTriggerProps, TreeSelectValueProps, TreeSelectPortalProps, TreeSelectContentProps, TreeSelectTreeProps, TreeSelectItemProps, TreeSelectItemIndicatorProps, TreeSelectEmptyProps, TreeSelectInputProps, } from './types.js';
+export type { TreeSelectNode, TreeSelectCheckStrategy, TreeSelectValueStrategy, TreeSelectFilter, TreeSelectProps, } from './types.js';

package/dist/tree-select/primitives.d.cts

@@ -0,0 +1,31 @@
+/**
+ * Primitives for `TreeSelect` — manual composition escape hatch.
+ *
+ * @example
+ * ```tsx
+ * import { TreeSelect, TreeSelectTrigger, TreeSelectValue, TreeSelectPortal, TreeSelectContent, TreeSelectTree, TreeSelectEmpty } from '@skdx/react/primitives/tree-select';
+ *
+ * <TreeSelect collection={REGIONS}>
+ *   <TreeSelectTrigger aria-label="Regions">
+ *     <TreeSelectValue placeholder="Pick a region" />
+ *   </TreeSelectTrigger>
+ *   <TreeSelectPortal>
+ *     <TreeSelectContent>
+ *       <TreeSelectTree aria-label="Regions" />
+ *       <TreeSelectEmpty>No regions match</TreeSelectEmpty>
+ *     </TreeSelectContent>
+ *   </TreeSelectPortal>
+ * </TreeSelect>
+ * ```
+ */
+export { TreeSelect, defaultTreeSelectFilter, defaultGetMatchCountLabel } from './TreeSelect.cjs';
+export { TreeSelectTrigger } from './TreeSelectTrigger.cjs';
+export { TreeSelectValue } from './TreeSelectValue.cjs';
+export { TreeSelectPortal } from './TreeSelectPortal.cjs';
+export { TreeSelectContent } from './TreeSelectContent.cjs';
+export { TreeSelectTree } from './TreeSelectTree.cjs';
+export { TreeSelectItem } from './TreeSelectItem.cjs';
+export { TreeSelectItemIndicator } from './TreeSelectItemIndicator.cjs';
+export { TreeSelectEmpty } from './TreeSelectEmpty.cjs';
+export { TreeSelectInput } from './TreeSelectInput.cjs';
+export type { TreeSelectNode, TreeSelectCheckStrategy, TreeSelectValueStrategy, TreeSelectFilter, TreeSelectProps, TreeSelectTriggerProps, TreeSelectValueProps, TreeSelectPortalProps, TreeSelectContentProps, TreeSelectTreeProps, TreeSelectItemProps, TreeSelectItemIndicatorProps, TreeSelectEmptyProps, TreeSelectInputProps, } from './types.cjs';

package/dist/tree-select/primitives.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Primitives for `TreeSelect` — manual composition escape hatch.
+ *
+ * @example
+ * ```tsx
+ * import { TreeSelect, TreeSelectTrigger, TreeSelectValue, TreeSelectPortal, TreeSelectContent, TreeSelectTree, TreeSelectEmpty } from '@skdx/react/primitives/tree-select';
+ *
+ * <TreeSelect collection={REGIONS}>
+ *   <TreeSelectTrigger aria-label="Regions">
+ *     <TreeSelectValue placeholder="Pick a region" />
+ *   </TreeSelectTrigger>
+ *   <TreeSelectPortal>
+ *     <TreeSelectContent>
+ *       <TreeSelectTree aria-label="Regions" />
+ *       <TreeSelectEmpty>No regions match</TreeSelectEmpty>
+ *     </TreeSelectContent>
+ *   </TreeSelectPortal>
+ * </TreeSelect>
+ * ```
+ */
+export { TreeSelect, defaultTreeSelectFilter, defaultGetMatchCountLabel } from './TreeSelect.js';
+export { TreeSelectTrigger } from './TreeSelectTrigger.js';
+export { TreeSelectValue } from './TreeSelectValue.js';
+export { TreeSelectPortal } from './TreeSelectPortal.js';
+export { TreeSelectContent } from './TreeSelectContent.js';
+export { TreeSelectTree } from './TreeSelectTree.js';
+export { TreeSelectItem } from './TreeSelectItem.js';
+export { TreeSelectItemIndicator } from './TreeSelectItemIndicator.js';
+export { TreeSelectEmpty } from './TreeSelectEmpty.js';
+export { TreeSelectInput } from './TreeSelectInput.js';
+export type { TreeSelectNode, TreeSelectCheckStrategy, TreeSelectValueStrategy, TreeSelectFilter, TreeSelectProps, TreeSelectTriggerProps, TreeSelectValueProps, TreeSelectPortalProps, TreeSelectContentProps, TreeSelectTreeProps, TreeSelectItemProps, TreeSelectItemIndicatorProps, TreeSelectEmptyProps, TreeSelectInputProps, } from './types.js';