@hi-ui/cascader 4.0.0-alpha.6 → 4.0.0-beta.0

package/lib/types/index.d.ts

@@ -1,4 +1,3 @@
 import './styles/index.scss';
 export * from './Cascader';
 export { Cascader as default } from './Cascader';
-export * from './CascaderPanel';

package/lib/types/types.d.ts

@@ -1,17 +1,17 @@
 import React from 'react';
-export interface CascaderItem {
+export interface CascaderDataItem extends Record<string, any> {
     /**
      * 树节点唯一 id
      */
-    id: React.ReactText;
+    id?: React.ReactText;
     /**
      * 树节点标题
      */
-    title: React.ReactNode;
+    title?: React.ReactNode;
     /**
      * 该节点的子节点列表
      */
-    children?: CascaderItem[];
+    children?: CascaderDataItem[];
     /**
      * 是否为叶子节点
      */
@@ -24,19 +24,23 @@ export interface CascaderItem {
 export interface FlattedCascaderItemWithChildren extends FlattedCascaderItem {
     children: FlattedCascaderItem[];
 }
-export interface FlattedCascaderItem extends Required<Omit<CascaderItem, 'children'>> {
+export interface FlattedCascaderItem extends Required<Omit<CascaderDataItem, 'children'>> {
     /**
-     * 该节点的子节点列表
+     * 树节点唯一 id
      */
-    children?: FlattedCascaderItem[];
+    id: React.ReactText;
     /**
-     * 该节点的所有祖先节点列表
+     * 树节点标题
+     */
+    title: React.ReactNode;
+    /**
+     * 该节点的子节点列表
      */
-    ancestors?: FlattedCascaderItemWithChildren[];
+    children?: FlattedCascaderItem[];
     /**
      * 关联用户传入的原始节点
      */
-    raw: CascaderItem;
+    raw: CascaderDataItem;
     /**
      * 该节点的层级，从 0（顶层）开始
      */

package/lib/types/use-cascader.d.ts

@@ -1,291 +1,63 @@
 import React from 'react';
-import { FlattedCascaderItem, CascaderItemRequiredProps, CascaderItemEventData } from './types';
-import { CascaderProps } from './Cascader';
-export declare const useCascader: ({ defaultValue, value: valueProp, onChange: onChangeProp, data, disabled, changeOnSelect, flatted: flattedProp, upMatch, expandTrigger, emptyContent, placeholder, searchPlaceholder, onSelect, titleRender, displayRender, onLoadChildren, ...rest }: UseCascaderProps) => {
-    rootProps: {
-        searchable?: boolean | undefined;
-        clearable?: boolean | undefined;
-        popper?: import("packages/ui/popper/lib/types").PopperProps | undefined;
-        children?: React.ReactNode;
-        id?: string | undefined;
-        title?: string | undefined;
-        slot?: string | undefined;
-        style?: React.CSSProperties | undefined;
-        key?: React.Key | null | undefined;
-        defaultChecked?: boolean | undefined;
-        suppressContentEditableWarning?: boolean | undefined;
-        suppressHydrationWarning?: boolean | undefined;
-        accessKey?: string | undefined;
-        className?: string | undefined;
-        contentEditable?: "inherit" | (boolean | "true" | "false") | undefined;
-        contextMenu?: string | undefined;
-        dir?: string | undefined;
-        draggable?: (boolean | "true" | "false") | undefined;
-        hidden?: boolean | undefined;
-        lang?: string | undefined;
-        spellCheck?: (boolean | "true" | "false") | undefined;
-        tabIndex?: number | undefined;
-        translate?: "yes" | "no" | undefined;
-        radioGroup?: string | undefined;
-        role?: (React.AriaRole & string) | undefined;
-        about?: string | undefined;
-        datatype?: string | undefined;
-        inlist?: any;
-        prefix?: string | undefined;
-        property?: string | undefined;
-        resource?: string | undefined;
-        typeof?: string | undefined;
-        vocab?: string | undefined;
-        autoCapitalize?: string | undefined;
-        autoCorrect?: string | undefined;
-        autoSave?: string | undefined;
-        color?: string | undefined;
-        itemProp?: string | undefined;
-        itemScope?: boolean | undefined;
-        itemType?: string | undefined;
-        itemID?: string | undefined;
-        itemRef?: string | undefined;
-        results?: number | undefined;
-        security?: string | undefined;
-        unselectable?: "on" | "off" | undefined;
-        inputMode?: "text" | "none" | "search" | "tel" | "url" | "email" | "numeric" | "decimal" | undefined;
-        is?: string | undefined;
-        'aria-activedescendant'?: string | undefined;
-        'aria-atomic'?: boolean | "true" | "false" | undefined;
-        'aria-autocomplete'?: "list" | "none" | "inline" | "both" | undefined;
-        'aria-busy'?: boolean | "true" | "false" | undefined;
-        'aria-checked'?: boolean | "true" | "false" | "mixed" | undefined;
-        'aria-colcount'?: number | undefined;
-        'aria-colindex'?: number | undefined;
-        'aria-colspan'?: number | undefined;
-        'aria-controls'?: string | undefined;
-        'aria-current'?: boolean | "time" | "true" | "false" | "page" | "step" | "location" | "date" | undefined;
-        'aria-describedby'?: string | undefined;
-        'aria-details'?: string | undefined;
-        'aria-disabled'?: boolean | "true" | "false" | undefined;
-        'aria-dropeffect'?: "link" | "none" | "copy" | "execute" | "move" | "popup" | undefined;
-        'aria-errormessage'?: string | undefined;
-        'aria-expanded'?: boolean | "true" | "false" | undefined;
-        'aria-flowto'?: string | undefined;
-        'aria-grabbed'?: boolean | "true" | "false" | undefined;
-        'aria-haspopup'?: boolean | "dialog" | "menu" | "grid" | "listbox" | "tree" | "true" | "false" | undefined;
-        'aria-hidden'?: boolean | "true" | "false" | undefined;
-        'aria-invalid'?: boolean | "true" | "false" | "grammar" | "spelling" | undefined;
-        'aria-keyshortcuts'?: string | undefined;
-        'aria-label'?: string | undefined;
-        'aria-labelledby'?: string | undefined;
-        'aria-level'?: number | undefined;
-        'aria-live'?: "off" | "assertive" | "polite" | undefined;
-        'aria-modal'?: boolean | "true" | "false" | undefined;
-        'aria-multiline'?: boolean | "true" | "false" | undefined;
-        'aria-multiselectable'?: boolean | "true" | "false" | undefined;
-        'aria-orientation'?: "horizontal" | "vertical" | undefined;
-        'aria-owns'?: string | undefined;
-        'aria-placeholder'?: string | undefined;
-        'aria-posinset'?: number | undefined;
-        'aria-pressed'?: boolean | "true" | "false" | "mixed" | undefined;
-        'aria-readonly'?: boolean | "true" | "false" | undefined;
-        'aria-relevant'?: "text" | "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text additions" | "text removals" | undefined;
-        'aria-required'?: boolean | "true" | "false" | undefined;
-        'aria-roledescription'?: string | undefined;
-        'aria-rowcount'?: number | undefined;
-        'aria-rowindex'?: number | undefined;
-        'aria-rowspan'?: number | undefined;
-        'aria-selected'?: boolean | "true" | "false" | undefined;
-        'aria-setsize'?: number | undefined;
-        'aria-sort'?: "none" | "ascending" | "descending" | "other" | undefined;
-        'aria-valuemax'?: number | undefined;
-        'aria-valuemin'?: number | undefined;
-        'aria-valuenow'?: number | undefined;
-        'aria-valuetext'?: string | undefined;
-        dangerouslySetInnerHTML?: {
-            __html: string;
-        } | undefined;
-        onCopy?: React.ClipboardEventHandler<HTMLDivElement> | undefined;
-        onCopyCapture?: React.ClipboardEventHandler<HTMLDivElement> | undefined;
-        onCut?: React.ClipboardEventHandler<HTMLDivElement> | undefined;
-        onCutCapture?: React.ClipboardEventHandler<HTMLDivElement> | undefined;
-        onPaste?: React.ClipboardEventHandler<HTMLDivElement> | undefined;
-        onPasteCapture?: React.ClipboardEventHandler<HTMLDivElement> | undefined;
-        onCompositionEnd?: React.CompositionEventHandler<HTMLDivElement> | undefined;
-        onCompositionEndCapture?: React.CompositionEventHandler<HTMLDivElement> | undefined;
-        onCompositionStart?: React.CompositionEventHandler<HTMLDivElement> | undefined;
-        onCompositionStartCapture?: React.CompositionEventHandler<HTMLDivElement> | undefined;
-        onCompositionUpdate?: React.CompositionEventHandler<HTMLDivElement> | undefined;
-        onCompositionUpdateCapture?: React.CompositionEventHandler<HTMLDivElement> | undefined;
-        onFocus?: React.FocusEventHandler<HTMLDivElement> | undefined;
-        onFocusCapture?: React.FocusEventHandler<HTMLDivElement> | undefined;
-        onBlur?: React.FocusEventHandler<HTMLDivElement> | undefined;
-        onBlurCapture?: React.FocusEventHandler<HTMLDivElement> | undefined;
-        onChangeCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
-        onBeforeInput?: React.FormEventHandler<HTMLDivElement> | undefined;
-        onBeforeInputCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
-        onInput?: React.FormEventHandler<HTMLDivElement> | undefined;
-        onInputCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
-        onReset?: React.FormEventHandler<HTMLDivElement> | undefined;
-        onResetCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
-        onSubmit?: React.FormEventHandler<HTMLDivElement> | undefined;
-        onSubmitCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
-        onInvalid?: React.FormEventHandler<HTMLDivElement> | undefined;
-        onInvalidCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
-        onLoad?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onLoadCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onError?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onErrorCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onKeyDown?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
-        onKeyDownCapture?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
-        onKeyPress?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
-        onKeyPressCapture?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
-        onKeyUp?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
-        onKeyUpCapture?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
-        onAbort?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onAbortCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onCanPlay?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onCanPlayCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onCanPlayThrough?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onCanPlayThroughCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onDurationChange?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onDurationChangeCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onEmptied?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onEmptiedCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onEncrypted?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onEncryptedCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onEnded?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onEndedCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onLoadedData?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onLoadedDataCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onLoadedMetadata?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onLoadedMetadataCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onLoadStart?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onLoadStartCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onPause?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onPauseCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onPlay?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onPlayCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onPlaying?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onPlayingCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onProgress?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onProgressCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onRateChange?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onRateChangeCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onSeeked?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onSeekedCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onSeeking?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onSeekingCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onStalled?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onStalledCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onSuspend?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onSuspendCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onTimeUpdate?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onTimeUpdateCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onVolumeChange?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onVolumeChangeCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onWaiting?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onWaitingCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onAuxClick?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onAuxClickCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onClick?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onClickCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onContextMenu?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onContextMenuCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onDoubleClick?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onDoubleClickCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onDrag?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragEnd?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragEndCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragEnter?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragEnterCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragExit?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragExitCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragLeave?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragLeaveCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragOver?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragOverCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragStart?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDragStartCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDrop?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onDropCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
-        onMouseDown?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onMouseDownCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onMouseEnter?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onMouseLeave?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onMouseMove?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onMouseMoveCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onMouseOut?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onMouseOutCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onMouseOver?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onMouseOverCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onMouseUp?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onMouseUpCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
-        onSelectCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
-        onTouchCancel?: React.TouchEventHandler<HTMLDivElement> | undefined;
-        onTouchCancelCapture?: React.TouchEventHandler<HTMLDivElement> | undefined;
-        onTouchEnd?: React.TouchEventHandler<HTMLDivElement> | undefined;
-        onTouchEndCapture?: React.TouchEventHandler<HTMLDivElement> | undefined;
-        onTouchMove?: React.TouchEventHandler<HTMLDivElement> | undefined;
-        onTouchMoveCapture?: React.TouchEventHandler<HTMLDivElement> | undefined;
-        onTouchStart?: React.TouchEventHandler<HTMLDivElement> | undefined;
-        onTouchStartCapture?: React.TouchEventHandler<HTMLDivElement> | undefined;
-        onPointerDown?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerDownCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerMove?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerMoveCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerUp?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerUpCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerCancel?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerCancelCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerEnter?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerEnterCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerLeave?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerLeaveCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerOver?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerOverCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerOut?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onPointerOutCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onGotPointerCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onGotPointerCaptureCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onLostPointerCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onLostPointerCaptureCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
-        onScroll?: React.UIEventHandler<HTMLDivElement> | undefined;
-        onScrollCapture?: React.UIEventHandler<HTMLDivElement> | undefined;
-        onWheel?: React.WheelEventHandler<HTMLDivElement> | undefined;
-        onWheelCapture?: React.WheelEventHandler<HTMLDivElement> | undefined;
-        onAnimationStart?: React.AnimationEventHandler<HTMLDivElement> | undefined;
-        onAnimationStartCapture?: React.AnimationEventHandler<HTMLDivElement> | undefined;
-        onAnimationEnd?: React.AnimationEventHandler<HTMLDivElement> | undefined;
-        onAnimationEndCapture?: React.AnimationEventHandler<HTMLDivElement> | undefined;
-        onAnimationIteration?: React.AnimationEventHandler<HTMLDivElement> | undefined;
-        onAnimationIterationCapture?: React.AnimationEventHandler<HTMLDivElement> | undefined;
-        onTransitionEnd?: React.TransitionEventHandler<HTMLDivElement> | undefined;
-        onTransitionEndCapture?: React.TransitionEventHandler<HTMLDivElement> | undefined;
-        prefixCls?: string | undefined;
-    };
+import type { HiBaseFieldNames } from '@hi-ui/core';
+import { FlattedCascaderItem, CascaderItemRequiredProps, CascaderItemEventData, CascaderDataItem } from './types';
+export declare const useCascader: ({ defaultValue, value: valueProp, onChange: onChangeProp, data, disabled, changeOnSelect, flatted, onSelect: onSelectProp, onLoadChildren, cascaderData: cascaderDataProp, setCascaderData: setCascaderDataProp, flattedData: flattedDataProp, fieldNames, ...rest }: UseCascaderProps) => {
+    rootProps: {};
     reset: () => void;
-    flattedData: FlattedCascaderItem[];
-    value: string | number;
-    tryChangeValue: (newState: string | number, ...args: any[]) => void;
-    getCascaderItemRequiredProps: ({ id, depth }: FlattedCascaderItem) => CascaderItemRequiredProps;
-    expandTrigger: import("./types").ExpandTrigger;
+    flattedData: any;
+    value: React.ReactText[];
+    tryChangeValue: (stateOrFunction: React.SetStateAction<React.ReactText[]>, ...args: any[]) => void;
+    getItemRequiredProps: ({ id, depth }: FlattedCascaderItem) => CascaderItemRequiredProps;
     flatted: boolean;
     onItemClick: (node: CascaderItemEventData, onlyExpand?: any) => Promise<void>;
     onItemHover: (option: any) => void;
     changeOnSelect: boolean;
-    onLoadChildren: ((item: CascaderItemEventData) => void | Promise<void | import("./types").CascaderItem[]>) | undefined;
-    keyword: string;
+    onLoadChildren: ((item: CascaderItemEventData, idPaths: React.ReactText[]) => Promise<CascaderDataItem[] | void> | void) | undefined;
     disabled: boolean;
     menuList: FlattedCascaderItem[][];
-    isEmpty: boolean;
-    placeholder: string | undefined;
-    displayRender: ((checkedOption: FlattedCascaderItem, checkedOptions: FlattedCascaderItem[]) => React.ReactNode) | undefined;
-    titleRender: ((item: CascaderItemEventData, flatted: boolean) => React.ReactNode) | undefined;
-    emptyContent: boolean | React.ReactChild | React.ReactFragment | React.ReactPortal | null;
-    getSearchInputProps: () => {
-        placeholder: string | undefined;
-        value: string;
-        onChange: (evt: React.ChangeEvent<HTMLInputElement>) => void;
-    };
 };
-export interface UseCascaderProps extends CascaderProps {
+export interface UseCascaderProps {
+    /**
+     * 设置 data 中 id, title, disabled, children 对应的 key
+     */
+    fieldNames?: HiBaseFieldNames;
+    /**
+     * 设置选择项数据源
+     */
+    data: CascaderDataItem[];
+    /**
+     * 设置当前选中值
+     */
+    value?: React.ReactText[];
+    /**
+     * 设置当前选中值默认值
+     */
+    defaultValue?: React.ReactText[];
+    /**
+     * 选中值改变时的回调
+     */
+    onChange?: (value: React.ReactText[]) => void;
+    /**
+     * 选中选项时触发，仅供内部使用。暂不对外暴露
+     * @private
+     */
+    onSelect?: (value: React.ReactText, targetOption: CascaderItemEventData, optionPaths: FlattedCascaderItem[]) => void;
+    /**
+     * 是否禁止使用
+     */
+    disabled?: boolean;
+    /**
+     * 是否启用选择即改变功能
+     */
+    changeOnSelect?: boolean;
+    /**
+     * 将选项拍平展示，不支持 `onLoadChildren` 异步加载交互。暂不对外暴露
+     * @private
+     */
+    flatted?: boolean;
+    /**
+     * 异步请求更新数据
+     */
+    onLoadChildren?: (item: CascaderItemEventData, idPaths: React.ReactText[]) => Promise<CascaderDataItem[] | void> | void;
 }
 export declare type UseCascaderReturn = ReturnType<typeof useCascader>;

package/lib/types/utils/index.d.ts

@@ -1,13 +1,10 @@
 import React from 'react';
-import { CascaderItemRequiredProps, CascaderItemEventData, CascaderItem, FlattedCascaderItem } from '../types';
+import type { HiBaseFieldNames } from '@hi-ui/core';
+import { CascaderItemRequiredProps, CascaderItemEventData, CascaderDataItem, FlattedCascaderItem } from '../types';
 /**
  * 扁平化树数据结构，基于前序遍历
  */
-export declare const flattenTreeData: (treeData: CascaderItem[]) => FlattedCascaderItem[];
-/**
- * 获取自顶向下的祖先节点，包括自己
- */
-export declare const getTopDownAncestors: (node: FlattedCascaderItem) => FlattedCascaderItem[];
+export declare const flattenTreeData: (treeData: CascaderDataItem[], fieldNames?: HiBaseFieldNames | undefined) => FlattedCascaderItem[];
 /**
  * 获取选中节点的节点路径，包含选中节点
  */
@@ -18,4 +15,4 @@ export declare const getActiveNodePaths: (flattedData: FlattedCascaderItem[], se
 export declare const getActiveMenus: (flattedData: FlattedCascaderItem[], selectedId?: React.ReactText | undefined) => FlattedCascaderItem[][];
 export declare const getFlattedMenus: (data: FlattedCascaderItem[], filter: (option: FlattedCascaderItem) => boolean) => FlattedCascaderItem[][];
 export declare const checkCanLoadChildren: (node: FlattedCascaderItem, onLoadChildren?: any) => any;
-export declare function getCascaderItemEventData(node: FlattedCascaderItem, requiredProps: CascaderItemRequiredProps): CascaderItemEventData;
+export declare function getItemEventData(node: FlattedCascaderItem, requiredProps: CascaderItemRequiredProps): CascaderItemEventData;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hi-ui/cascader",
-  "version": "4.0.0-alpha.6",
+  "version": "4.0.0-beta.0",
   "description": "A sub-package for @hi-ui/hiui.",
   "keywords": [],
   "author": "HIUI <mi-hiui@xiaomi.com>",
@@ -43,26 +43,32 @@
     "url": "https://github.com/XiaoMi/hiui/issues"
   },
   "dependencies": {
-    "@hi-ui/classname": "^4.0.0-alpha.1",
-    "@hi-ui/core": "^4.0.0-alpha.2",
-    "@hi-ui/env": "^4.0.0-alpha.3",
-    "@hi-ui/icons": "^4.0.0-alpha.8",
-    "@hi-ui/input": "^4.0.0-alpha.10",
-    "@hi-ui/popper": "^4.0.0-alpha.4",
-    "@hi-ui/tree-utils": "^4.0.0-alpha.2",
-    "@hi-ui/type-assertion": "^4.0.0-alpha.5",
-    "@hi-ui/use-latest": "^4.0.0-alpha.2",
-    "@hi-ui/use-toggle": "^4.0.0-alpha.4",
-    "@hi-ui/use-uncontrolled-state": "^4.0.0-alpha.5"
+    "@hi-ui/classname": "^4.0.0-beta.0",
+    "@hi-ui/core": "^4.0.0-beta.0",
+    "@hi-ui/env": "^4.0.0-beta.0",
+    "@hi-ui/icons": "^4.0.0-beta.0",
+    "@hi-ui/input": "^4.0.0-beta.0",
+    "@hi-ui/locale-context": "^4.0.0-beta.0",
+    "@hi-ui/picker": "^4.0.0-beta.0",
+    "@hi-ui/popper": "^4.0.0-beta.0",
+    "@hi-ui/tree-utils": "^4.0.0-beta.0",
+    "@hi-ui/type-assertion": "^4.0.0-beta.0",
+    "@hi-ui/use-check-state": "^4.0.0-beta.0",
+    "@hi-ui/use-data-source": "^4.0.0-beta.0",
+    "@hi-ui/use-latest": "^4.0.0-beta.0",
+    "@hi-ui/use-search-mode": "^4.0.0-beta.0",
+    "@hi-ui/use-toggle": "^4.0.0-beta.0",
+    "@hi-ui/use-uncontrolled-state": "^4.0.0-beta.0",
+    "lodash": "^4.17.21"
   },
   "peerDependencies": {
-    "react": "^17.0.1",
-    "react-dom": "^17.0.1"
+    "react": ">=16.8.6",
+    "react-dom": ">=16.8.6"
   },
   "devDependencies": {
-    "@hi-ui/hi-build": "^4.0.0-alpha.2",
+    "@hi-ui/hi-build": "^4.0.0-beta.0",
     "react": "^17.0.1",
     "react-dom": "^17.0.1"
   },
-  "gitHead": "d2ea256c3b3726334a2091eba1de7321ed8d36e3"
+  "gitHead": "be106782f3ff72208ec6d4a2ec8acfe2a41fa1fe"
 }

package/lib/cjs/CascaderPanel.js

@@ -1,81 +0,0 @@
-/** @LICENSE
- * @hi-ui/cascader
- * https://github.com/XiaoMi/hiui/tree/master/packages/ui/cascader#readme
- *
- * Copyright (c) HIUI <mi-hiui@xiaomi.com>.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-'use strict';
-
-var _typeof = require("@babel/runtime/helpers/typeof");
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-});
-
-var tslib = require('tslib');
-
-var React = require('react');
-
-var classname = require('@hi-ui/classname');
-
-var env = require('@hi-ui/env');
-
-var context = require('./context.js');
-
-var useCascader = require('./use-cascader.js');
-
-var Cascader = require('./Cascader.js');
-
-function _interopDefaultLegacy(e) {
-  return e && _typeof(e) === 'object' && 'default' in e ? e : {
-    'default': e
-  };
-}
-
-var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
-
-var _role = 'cascader-panel';
-
-var _prefix = classname.getPrefixCls(_role);
-/**
- * TODO: What is CascaderPanel
- * MenuList + Search
- */
-
-
-var CascaderPanel = /*#__PURE__*/React.forwardRef(function (_a, ref) {
-  var _a$prefixCls = _a.prefixCls,
-      prefixCls = _a$prefixCls === void 0 ? _prefix : _a$prefixCls,
-      _a$role = _a.role,
-      role = _a$role === void 0 ? _role : _a$role,
-      className = _a.className,
-      _a$searchable = _a.searchable,
-      searchable = _a$searchable === void 0 ? true : _a$searchable,
-      rest = tslib.__rest(_a, ["prefixCls", "role", "className", "searchable"]);
-
-  var _b = useCascader.useCascader(rest),
-      rootProps = _b.rootProps,
-      context$1 = tslib.__rest(_b, ["rootProps"]);
-
-  var providedValue = React.useMemo(function () {
-    return context$1;
-  }, [context$1]);
-  var cls = classname.cx(prefixCls, className, context$1.flatted && prefixCls + "--flatted", context$1.changeOnSelect && prefixCls + "--selectchange");
-  return /*#__PURE__*/React__default['default'].createElement(context.CascaderProvider, {
-    value: providedValue
-  }, /*#__PURE__*/React__default['default'].createElement("div", Object.assign({
-    ref: ref,
-    role: role,
-    className: cls
-  }, rootProps), searchable ? /*#__PURE__*/React__default['default'].createElement(Cascader.CascaderSearch, null) : null, /*#__PURE__*/React__default['default'].createElement(Cascader.CascaderMenuList, null)));
-});
-
-if (env.__DEV__) {
-  CascaderPanel.displayName = 'CascaderPanel';
-}
-
-exports.CascaderPanel = CascaderPanel;
-//# sourceMappingURL=CascaderPanel.js.map

package/lib/cjs/CascaderPanel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CascaderPanel.js","sources":["../../src/CascaderPanel.tsx"],"sourcesContent":[null],"names":["_role","_prefix","getPrefixCls","CascaderPanel","forwardRef","_a","ref","prefixCls","role","className","searchable","rest","_b","useCascader","rootProps","context","providedValue","useMemo","cls","cx","flatted","changeOnSelect","React","CascaderProvider","value","CascaderSearch","CascaderMenuList","__DEV__","displayName"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,IAAMA,KAAK,GAAG,gBAAd;;AACA,IAAMC,OAAO,GAAGC,sBAAAA,CAAaF,KAAbE,CAAhB;AAEA;;;;;;IAIaC,aAAa,gBAAGC,gBAAAA,CAC3B,UAACC,EAAD,EAA+EC,GAA/E;wBAAGC;MAAAA,sCAAYN;mBAASO;MAAAA,4BAAOR;MAAOS,eAAAA;yBAAWC;MAAAA,wCAAa;MAASC,wBAAtE,YAAA,QAAA,aAAA,cAAA;;MACOC,KAA4BC,uBAAAA,CAAYF,IAAZE;MAA1BC,SAAF,KAAA,CAAEA;MAAcC,SAAhB,oBAAA,YAAA;;MAEAC,aAAa,GAAGC,aAAAA,CAAQ;WAAMF;AAAP,GAAPE,EAAuB,CAACF,SAAD,CAAvBE;MAEhBC,GAAG,GAAGC,YAAAA,CACVZ,SADUY,EAEVV,SAFUU,EAGVJ,SAAO,CAACK,OAARL,IAAsBR,SAAtB,cAHUY,EAIVJ,SAAO,CAACM,cAARN,IAA6BR,SAA7B,mBAJUY;sBAQVG,yBAAAA,cAAAA,CAACC,wBAADD;AAAkBE,IAAAA,KAAK,EAAER;GAAzBM,eACEA,yBAAAA,cAAAA,MAAAA;AAAKhB,IAAAA,GAAG,EAAEA;AAAKE,IAAAA,IAAI,EAAEA;AAAMC,IAAAA,SAAS,EAAES;KAASJ,UAA/CQ,EACGZ,UAAU,gBAAGY,yBAAAA,cAAAA,CAACG,uBAADH,MAAAA,CAAH,GAAwB,IADrCA,eAEEA,yBAAAA,cAAAA,CAACI,yBAADJ,MAAAA,CAFFA,CADFA;AAdiC,CAAVlB;;AAyG7B,IAAIuB,WAAJ,EAAa;AACXxB,EAAAA,aAAa,CAACyB,WAAdzB,GAA4B,eAA5BA;;;"}

package/lib/cjs/hooks/use-cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-cache.js","sources":["../../../src/hooks/use-cache.ts"],"sourcesContent":[null],"names":["useCache","data","useState","internalData","setInternalData","useEffect"],"mappings":";;;;;;;;;;;;;;;;AAEA;;;;;;;;IAMaA,QAAQ,GAAG,SAAXA,QAAW,CAAIC,IAAJ;kBACkBC,cAAAA,CAASD,IAATC;MAAjCC,YAAP;MAAqBC,eAArB;;AAEAC,EAAAA,eAAAA,CAAU;AACRD,IAAAA,eAAe,CAACH,IAAD,CAAfG;AADO,GAATC,EAEG,CAACJ,IAAD,CAFHI;SAIO,CAACF,YAAD,EAAeC,eAAf;;;"}