asterui 0.12.22 → 0.12.24

package/dist/components/Cascader.d.ts

@@ -1,19 +1,69 @@
 import { default as React } from 'react';
 export interface CascaderOption {
-    value: string | number;
+    value: string;
     label: React.ReactNode;
     disabled?: boolean;
     children?: CascaderOption[];
+    isLeaf?: boolean;
 }
+export type CascaderColor = 'primary' | 'secondary' | 'accent' | 'info' | 'success' | 'warning' | 'error';
+export type CascaderSize = 'xs' | 'sm' | 'md' | 'lg';
 export interface CascaderProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Hierarchical options data */
     options: CascaderOption[];
-    value?: (string | number)[];
-    onChange?: (value: (string | number)[], selectedOptions: CascaderOption[]) => void;
+    /** Controlled selected value path */
+    value?: string[];
+    /** Default selected value path (uncontrolled) */
+    defaultValue?: string[];
+    /** Callback when selection changes */
+    onChange?: (value: string[], selectedOptions: CascaderOption[]) => void;
+    /** Placeholder text */
     placeholder?: string;
+    /** Disable the cascader */
     disabled?: boolean;
+    /** Show clear button */
     allowClear?: boolean;
+    /** How to expand sub-menus */
     expandTrigger?: 'click' | 'hover';
+    /** Allow selection of any level, not just leaf nodes */
+    changeOnSelect?: boolean;
+    /** Custom display render function */
     displayRender?: (labels: React.ReactNode[], selectedOptions: CascaderOption[]) => React.ReactNode;
-    size?: 'xs' | 'sm' | 'md' | 'lg';
+    /** Input size */
+    size?: CascaderSize;
+    /** Focus ring color */
+    color?: CascaderColor;
+    /** Validation status */
+    status?: 'error' | 'warning';
+    /** Enable search/filter functionality */
+    showSearch?: boolean | {
+        filter?: (inputValue: string, path: CascaderOption[]) => boolean;
+        render?: (inputValue: string, path: CascaderOption[]) => React.ReactNode;
+        matchInputWidth?: boolean;
+    };
+    /** Content when no results found */
+    notFoundContent?: React.ReactNode;
+    /** Async data loading function */
+    loadData?: (selectedOptions: CascaderOption[]) => Promise<void>;
+    /** Custom field names for data mapping */
+    fieldNames?: {
+        label?: string;
+        value?: string;
+        children?: string;
+    };
+    /** Controlled open state */
+    open?: boolean;
+    /** Callback when dropdown visibility changes */
+    onDropdownVisibleChange?: (open: boolean) => void;
+    /** Class name for dropdown */
+    popupClassName?: string;
+    /** Custom dropdown render wrapper */
+    dropdownRender?: (menu: React.ReactNode) => React.ReactNode;
+    /** Multiple selection mode */
+    multiple?: boolean;
+    /** Max tags to show in multiple mode */
+    maxTagCount?: number | 'responsive';
+    /** Accessible label */
+    'aria-label'?: string;
 }
-export declare function Cascader({ options, value, onChange, placeholder, disabled, allowClear, expandTrigger, displayRender, size, className, ...rest }: CascaderProps): import("react/jsx-runtime").JSX.Element;
+export declare const Cascader: React.ForwardRefExoticComponent<CascaderProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/Tree.d.ts

@@ -1,4 +1,6 @@
 import { default as React } from 'react';
+export type TreeColor = 'primary' | 'secondary' | 'accent' | 'neutral' | 'info' | 'success' | 'warning' | 'error';
+export type TreeSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 export interface TreeDataNode {
     key: string;
     title: React.ReactNode;
@@ -11,30 +13,104 @@ export interface TreeDataNode {
     isLeaf?: boolean;
 }
 export interface TreeProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
-    treeData: TreeDataNode[];
+    /** Tree data structure (alternative to compound pattern) */
+    treeData?: TreeDataNode[] | undefined;
+    /** Children for compound pattern */
+    children?: React.ReactNode;
+    /** Show checkbox for each node */
     checkable?: boolean;
+    /** Checkbox color (DaisyUI) */
+    checkboxColor?: TreeColor;
+    /** Checkbox size (DaisyUI) */
+    checkboxSize?: TreeSize;
+    /** Enable node selection */
     selectable?: boolean;
+    /** Allow multiple selection */
     multiple?: boolean;
+    /** Expand all nodes by default */
     defaultExpandAll?: boolean;
+    /** Default expanded keys */
     defaultExpandedKeys?: string[];
+    /** Controlled expanded keys */
     expandedKeys?: string[];
+    /** Default selected keys */
     defaultSelectedKeys?: string[];
+    /** Controlled selected keys */
     selectedKeys?: string[];
+    /** Default checked keys */
     defaultCheckedKeys?: string[];
+    /** Controlled checked keys */
     checkedKeys?: string[];
+    /** Callback when node is expanded */
     onExpand?: (expandedKeys: string[], info: {
         node: TreeDataNode;
         expanded: boolean;
     }) => void;
+    /** Callback when node is selected */
     onSelect?: (selectedKeys: string[], info: {
         node: TreeDataNode;
         selected: boolean;
     }) => void;
+    /** Callback when node is checked */
     onCheck?: (checkedKeys: string[], info: {
         node: TreeDataNode;
         checked: boolean;
     }) => void;
+    /** Show connecting lines */
     showLine?: boolean;
+    /** Show node icons */
     showIcon?: boolean;
+    /** Decouple parent-child checkbox relationship */
+    checkStrictly?: boolean;
+    /** Auto expand parent nodes when expandedKeys change */
+    autoExpandParent?: boolean;
+    /** Make node fill remaining horizontal space */
+    blockNode?: boolean;
+    /** Custom expand/collapse icon */
+    switcherIcon?: React.ReactNode | ((expanded: boolean) => React.ReactNode);
+    /** Custom title render function */
+    titleRender?: (node: TreeDataNode) => React.ReactNode;
+    /** Filter function for highlighting nodes */
+    filterTreeNode?: (node: TreeDataNode) => boolean;
+    /** Async data loading */
+    loadData?: (node: TreeDataNode) => Promise<void>;
+    /** Right click handler */
+    onRightClick?: (info: {
+        event: React.MouseEvent;
+        node: TreeDataNode;
+    }) => void;
+    /** Custom field names for data mapping */
+    fieldNames?: {
+        key?: string;
+        title?: string;
+        children?: string;
+    };
+}
+export interface TreeNodeProps {
+    /** Unique key for the node (uses React's key prop) */
+    key: string;
+    /** Display title */
+    title: React.ReactNode;
+    /** Custom icon */
+    icon?: React.ReactNode;
+    /** Disable the node */
+    disabled?: boolean;
+    /** Disable checkbox for this node */
+    disableCheckbox?: boolean;
+    /** Whether node can be selected */
+    selectable?: boolean;
+    /** Whether node shows checkbox */
+    checkable?: boolean;
+    /** Force node to be a leaf */
+    isLeaf?: boolean;
+    /** Child nodes */
+    children?: React.ReactNode;
+}
+declare function TreeNode(_props: TreeNodeProps): null;
+declare namespace TreeNode {
+    var displayName: string;
 }
-export declare function Tree({ treeData, checkable, selectable, multiple, defaultExpandAll, defaultExpandedKeys, expandedKeys: controlledExpandedKeys, defaultSelectedKeys, selectedKeys: controlledSelectedKeys, defaultCheckedKeys, checkedKeys: controlledCheckedKeys, onExpand, onSelect, onCheck, showLine, showIcon, className, ...rest }: TreeProps): import("react/jsx-runtime").JSX.Element;
+export declare const Tree: React.ForwardRefExoticComponent<TreeProps & React.RefAttributes<HTMLDivElement>> & {
+    Node: typeof TreeNode;
+};
+export {};

package/dist/components/TreeSelect.d.ts

@@ -1,5 +1,14 @@
 import { default as React } from 'react';
 import { TreeDataNode } from './Tree';
+export type TreeSelectSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+export type TreeSelectColor = 'primary' | 'secondary' | 'accent' | 'info' | 'success' | 'warning' | 'error';
+export type TreeSelectStatus = 'error' | 'warning';
+export type ShowCheckedStrategy = 'SHOW_ALL' | 'SHOW_PARENT' | 'SHOW_CHILD';
+export interface TreeSelectFieldNames {
+    label?: string;
+    value?: string;
+    children?: string;
+}
 export interface TreeSelectProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
     treeData: TreeDataNode[];
     value?: string | string[];
@@ -7,7 +16,12 @@ export interface TreeSelectProps extends Omit<React.HTMLAttributes<HTMLDivElemen
     onChange?: (value: string | string[], labels: React.ReactNode[]) => void;
     multiple?: boolean;
     treeCheckable?: boolean;
+    treeCheckStrictly?: boolean;
+    showCheckedStrategy?: ShowCheckedStrategy;
     showSearch?: boolean;
+    searchValue?: string;
+    onSearch?: (value: string) => void;
+    filterTreeNode?: (searchValue: string, node: TreeDataNode) => boolean;
     placeholder?: string;
     allowClear?: boolean;
     disabled?: boolean;
@@ -15,6 +29,25 @@ export interface TreeSelectProps extends Omit<React.HTMLAttributes<HTMLDivElemen
     treeDefaultExpandedKeys?: string[];
     treeExpandedKeys?: string[];
     onTreeExpand?: (expandedKeys: string[]) => void;
-    size?: 'xs' | 'sm' | 'md' | 'lg';
+    size?: TreeSelectSize;
+    color?: TreeSelectColor;
+    status?: TreeSelectStatus;
+    maxTagCount?: number | 'responsive';
+    maxTagPlaceholder?: React.ReactNode | ((omittedValues: string[]) => React.ReactNode);
+    labelInValue?: boolean;
+    treeLine?: boolean;
+    treeIcon?: boolean;
+    loadData?: (node: TreeDataNode) => Promise<void>;
+    fieldNames?: TreeSelectFieldNames;
+    open?: boolean;
+    onDropdownVisibleChange?: (open: boolean) => void;
+    suffixIcon?: React.ReactNode;
+    switcherIcon?: React.ReactNode | ((props: {
+        expanded: boolean;
+    }) => React.ReactNode);
+    notFoundContent?: React.ReactNode;
+    dropdownRender?: (menu: React.ReactNode) => React.ReactNode;
+    popupClassName?: string;
+    'data-testid'?: string;
 }
-export declare function TreeSelect({ treeData, value: controlledValue, defaultValue, onChange, multiple, treeCheckable, showSearch, placeholder, allowClear, disabled, treeDefaultExpandAll, treeDefaultExpandedKeys, treeExpandedKeys: controlledExpandedKeys, onTreeExpand, size, className, ...rest }: TreeSelectProps): import("react/jsx-runtime").JSX.Element;
+export declare const TreeSelect: React.ForwardRefExoticComponent<TreeSelectProps & React.RefAttributes<HTMLDivElement>>;

package/dist/index.d.ts

@@ -183,7 +183,7 @@ export type { TransferProps, TransferItem } from './components/Transfer';
 export { Tree } from './components/Tree';
 export type { TreeProps, TreeDataNode } from './components/Tree';
 export { TreeSelect } from './components/TreeSelect';
-export type { TreeSelectProps } from './components/TreeSelect';
+export type { TreeSelectProps, TreeSelectSize, TreeSelectColor, TreeSelectStatus, TreeSelectFieldNames, ShowCheckedStrategy, } from './components/TreeSelect';
 export { Typography } from './components/Typography';
 export type { TypographyProps, TitleProps, ParagraphProps, TextProps, TypographyLinkProps, TypographySize, TitleLevel, } from './components/Typography';
 export { Upload } from './components/Upload';