@salt-ds/lab 1.0.0-alpha.92 → 1.0.0-alpha.94

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

@@ -1,77 +0,0 @@
-import { type Dispatch, type ReactNode, type Ref, type RefObject, type SetStateAction, type SyntheticEvent } from "react";
-import type { TreeModel, TreeNodeMeta } from "./useTree";
-export interface TreeContextValue {
-    expandedState: Set<string>;
-    /** Toggle a node expansion state */
-    toggleExpanded: (event: SyntheticEvent, value: string) => void;
-    /** Selected node values */
-    selectedState: string[];
-    /** Selected node values as Set for O(1) lookups */
-    selectedSet: Set<string>;
-    /** Set selected state directly */
-    setSelectedState: Dispatch<SetStateAction<string[]>>;
-    /** Set selected state without expanding selection through hidden descendants */
-    setVisibleSelectionState: (selected: string[]) => void;
-    /** Select node */
-    select: (event: SyntheticEvent, value: string) => void;
-    /** Whether multiselect mode with checkboxes is enabled */
-    multiselect: boolean;
-    /** Disabled state of the tree */
-    disabled: boolean;
-    /** Set of disabled node IDs */
-    disabledIdsSet: Set<string>;
-    /** Tree model for traversal */
-    treeModel: TreeModel;
-    /** Get node metadata from tree model */
-    getNodeMeta: (value: string) => TreeNodeMeta | undefined;
-    /** Get parent of a node */
-    getParent: (value: string) => string | undefined;
-    /** Get children of a node */
-    getChildren: (value: string) => string[];
-    /** Get all descendants of a node */
-    getDescendants: (value: string) => string[];
-    /** Get all ancestors of a node */
-    getAncestors: (value: string) => string[];
-    /** Memoized visible (navigable) nodes in tree order */
-    visibleNodes: string[];
-    /** Memoized tabbable node ID for roving tabindex (computed once at tree level) */
-    tabbableNodeId: string | undefined;
-    /** Register a DOM element for focus management */
-    registerElement: (value: string, element: HTMLElement) => () => void;
-    /** Get DOM element for a node (if mounted) */
-    getElement: (value: string) => HTMLElement | undefined;
-    /** Active node value */
-    activeNode: string | undefined;
-    /** Set the active node */
-    setActiveNode: Dispatch<SetStateAction<string | undefined>>;
-    /** Set of indeterminate (partially selected) node IDs */
-    indeterminateState: Set<string>;
-}
-export declare const TreeProvider: import("react").Provider<TreeContextValue | undefined>;
-export declare function useTreeContext(): TreeContextValue;
-export interface TreeNodeContextValue {
-    /** Current node value */
-    value: string;
-    /** Current depth level */
-    level: number;
-    /** Whether node has children */
-    hasChildren: boolean;
-    /** Whether node is expanded */
-    expanded: boolean;
-    /** Whether node is disabled */
-    disabled: boolean;
-    /** Node id for the li element */
-    id: string;
-    /** Ref for the li element rendered by TreeNodeTrigger */
-    nodeRef: RefObject<HTMLLIElement>;
-    /** Callback ref that connects TreeNode's forwarded ref to the li element */
-    setNodeRef: Ref<HTMLLIElement> | null;
-    /** Whether node is selected */
-    selected: boolean;
-    /** Whether node is in indeterminate state (partially selected children) */
-    indeterminate: boolean;
-    /** Child TreeNode elements to be rendered inside the group */
-    nodeChildren: ReactNode;
-}
-export declare const TreeNodeProvider: import("react").Provider<TreeNodeContextValue | undefined>;
-export declare function useTreeNodeContext(): TreeNodeContextValue | undefined;

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

@@ -1,25 +0,0 @@
-import type { IconProps } from "@salt-ds/icons";
-import { type ComponentType, type ReactNode } from "react";
-export interface TreeNodeProps {
-    /**
-     * Unique value representing this node within the tree
-     */
-    value: string;
-    /**
-     * Label for the node. When provided, TreeNode automatically renders a TreeNodeTrigger.
-     */
-    label?: ReactNode;
-    /**
-     * Optional icon to display before the label
-     */
-    icon?: ComponentType<IconProps>;
-    /**
-     * Whether the node is disabled.
-     */
-    disabled?: boolean;
-    /**
-     * Child nodes or content.
-     */
-    children?: ReactNode;
-}
-export declare const TreeNode: import("react").ForwardRefExoticComponent<TreeNodeProps & import("react").RefAttributes<HTMLLIElement>>;

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

@@ -1,4 +0,0 @@
-import { type ComponentPropsWithoutRef } from "react";
-export interface TreeNodeExpansionIconProps extends ComponentPropsWithoutRef<"span"> {
-}
-export declare const TreeNodeExpansionIcon: import("react").ForwardRefExoticComponent<TreeNodeExpansionIconProps & import("react").RefAttributes<HTMLSpanElement>>;

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

@@ -1,4 +0,0 @@
-import { type ComponentPropsWithoutRef } from "react";
-export interface TreeNodeLabelProps extends ComponentPropsWithoutRef<"span"> {
-}
-export declare const TreeNodeLabel: import("react").ForwardRefExoticComponent<TreeNodeLabelProps & import("react").RefAttributes<HTMLSpanElement>>;

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

@@ -1,8 +0,0 @@
-import { type ComponentPropsWithoutRef } from "react";
-export interface TreeNodeTriggerProps extends ComponentPropsWithoutRef<"li"> {
-}
-/**
- * The forwarded ref points to the inner trigger content span (for tooltip positioning),
- * while the <li> handles focus, ARIA, and event handling.
- */
-export declare const TreeNodeTrigger: import("react").ForwardRefExoticComponent<TreeNodeTriggerProps & import("react").RefAttributes<HTMLSpanElement>>;

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

@@ -1,4 +0,0 @@
-export * from "./Tree";
-export * from "./TreeNode";
-export * from "./TreeNodeLabel";
-export * from "./TreeNodeTrigger";

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

@@ -1,24 +0,0 @@
-import { type ReactElement, type ReactNode } from "react";
-export interface TreeNodeMeta {
-    value: string;
-    parentValue: string | undefined;
-    hasChildren: boolean;
-    disabled: boolean;
-}
-export interface TreeModel {
-    /** All nodes indexed by value */
-    nodes: Map<string, TreeNodeMeta>;
-    /** Ordered list of root node values */
-    rootValues: string[];
-    /** Maps parent value to ordered list of child values */
-    childrenOf: Map<string, string[]>;
-}
-interface TreeNodeElementProps {
-    value: string;
-    disabled?: boolean;
-    children?: ReactNode;
-}
-export declare function isTreeNodeElement(child: ReactNode): child is ReactElement<TreeNodeElementProps>;
-export declare function flattenTreeNodeChildren(children: ReactNode): ReactNode[];
-export declare function buildTreeModel(children: ReactNode): TreeModel;
-export {};

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

@@ -1,68 +0,0 @@
-import { type ReactNode, type SyntheticEvent } from "react";
-import { type TreeModel, type TreeNodeMeta } from "./treeModel";
-export type { TreeModel, TreeNodeMeta } from "./treeModel";
-export interface UseTreeProps {
-    /**
-     * Default expanded nodes (uncontrolled)
-     */
-    defaultExpanded?: string[];
-    /**
-     * Expanded nodes (controlled)
-     */
-    expanded?: string[];
-    /**
-     * Callback on expanded nodes change
-     */
-    onExpandedChange?: (event: SyntheticEvent, expanded: string[]) => void;
-    /**
-     * Default selected nodes (uncontrolled)
-     */
-    defaultSelected?: string[];
-    /**
-     * Selected nodes
-     */
-    selected?: string[];
-    /**
-     * Callback on selected nodes change
-     */
-    onSelectionChange?: (event: SyntheticEvent, selected: string[]) => void;
-    /**
-     * Sets multiselect mode with checkboxes and allows for multiple node selection
-     */
-    multiselect?: boolean;
-    /**
-     * Sets tree to disabled state, preventing all interaction
-     */
-    disabled?: boolean;
-    /**
-     * Tree children used to build the tree model for traversal an state management
-     */
-    children?: ReactNode;
-}
-export declare function useTree(props: UseTreeProps): {
-    expandedArray: string[];
-    setExpandedArray: import("react").Dispatch<import("react").SetStateAction<string[]>>;
-    expandedState: Set<string>;
-    toggleExpanded: (event: SyntheticEvent, value: string) => void;
-    selectedState: string[];
-    selectedSet: Set<string>;
-    setSelectedState: import("react").Dispatch<import("react").SetStateAction<string[]>>;
-    setVisibleSelectionState: (selection: string[]) => void;
-    select: (event: SyntheticEvent, value: string) => void;
-    multiselect: boolean;
-    disabled: boolean;
-    disabledIdsSet: Set<string>;
-    treeModel: TreeModel;
-    getNodeMeta: (value: string) => TreeNodeMeta | undefined;
-    getParent: (value: string) => string | undefined;
-    getChildren: (parentValue: string) => string[];
-    getDescendants: (value: string) => string[];
-    getAncestors: (value: string) => string[];
-    visibleNodes: string[];
-    tabbableNodeId: string | undefined;
-    registerElement: (value: string, element: HTMLElement) => () => void;
-    getElement: (value: string) => HTMLElement | undefined;
-    activeNode: string | undefined;
-    setActiveNode: import("react").Dispatch<import("react").SetStateAction<string | undefined>>;
-    indeterminateState: Set<string>;
-};