@canvas-components/react-components 0.3.8 → 0.3.9

package/dist/index.d.cts

@@ -927,6 +927,11 @@ interface ReactSelectProps extends Omit<ReactInputProps, "value" | "onChange" |
  */
 declare const ReactSelect: react.ForwardRefExoticComponent<ReactSelectProps & react.RefAttributes<HTMLInputElement>>;
 
+/** 级联选择保留数字和字符串类型，不使用分隔符拼接路径。 */
+type CascaderPath = (string | number)[];
+/** 多选回填策略：优先完整父级，或仅回填末级。 */
+type CascaderCheckedStrategy = "SHOW_PARENT" | "SHOW_CHILD";
+
 /** 级联选择树节点；值保留原始字符串或数字类型。 */
 interface ReactCascaderOption {
     label: string;
@@ -939,19 +944,53 @@ interface ReactCascaderChangeInfo {
     trigger: "mouse" | "keyboard" | "clear";
     complete: boolean;
 }
-/** 单路径级联选择配置。 */
+/** 单选或多选级联选择配置。 */
 interface ReactCascaderProps extends Omit<ReactInputProps, "value" | "defaultValue" | "onChange" | "onPressEnter" | "displayRender"> {
-    value?: (string | number)[];
+    value?: CascaderPath | CascaderPath[];
+    /** 多选时使用二维路径数组，勾选不会关闭弹层。 */
+    multiple?: boolean;
+    /** 多选回填策略，默认 SHOW_PARENT。 */
+    showCheckedStrategy?: CascaderCheckedStrategy;
     options?: ReactCascaderOption[];
     showSearch?: boolean;
     changeOnSelect?: boolean;
     expandTrigger?: "click" | "hover";
     displayRender?: (labels: string[], selectedOptions: ReactCascaderOption[]) => string;
-    onChange?: (value: (string | number)[], selectedOptions: ReactCascaderOption[], info: ReactCascaderChangeInfo) => void;
+    onChange?: (value: CascaderPath | CascaderPath[], selectedOptions: ReactCascaderOption[] | ReactCascaderOption[][], info: ReactCascaderChangeInfo) => void;
 }
 /** 多列展开的级联选择器，复用现有输入框、浮层及主题。 */
 declare function ReactCascader(props: ReactCascaderProps): react.JSX.Element;
 
+/** 树选择节点；value 在整棵树中唯一，数字和字符串严格区分。 */
+interface TreeSelectNode {
+    title: string;
+    value: string | number;
+    key?: string | number;
+    disabled?: boolean;
+    selectable?: boolean;
+    children?: TreeSelectNode[];
+}
+
+/** 单选返回节点值，多选返回节点值数组；不是 Cascader 的路径数组。 */
+type ReactTreeSelectValue = string | number | (string | number)[] | null;
+/** 树选择变更来源，只有完成单选才自动关闭编辑。 */
+interface ReactTreeSelectChangeInfo {
+    trigger: "mouse" | "keyboard" | "clear";
+    complete: boolean;
+}
+/** AntD 风格树选择的基础单选与独立多选配置。 */
+interface ReactTreeSelectProps extends Omit<ReactInputProps, "value" | "defaultValue" | "onChange" | "onPressEnter"> {
+    value?: ReactTreeSelectValue;
+    treeData?: TreeSelectNode[];
+    multiple?: boolean;
+    showSearch?: boolean;
+    treeDefaultExpandAll?: boolean;
+    treeDefaultExpandedKeys?: (string | number)[];
+    onChange?: (value: ReactTreeSelectValue, selectedNodes: TreeSelectNode[], info: ReactTreeSelectChangeInfo) => void;
+}
+/** 树形下拉选择，复用现有输入框、清空图标与定位弹层。 */
+declare function ReactTreeSelect(props: ReactTreeSelectProps): react.JSX.Element;
+
 interface ReactAutoCompleteProps extends Omit<ReactSelectProps, "allowCustomValue" | "onChange" | "onInputValueChange" | "onPressEnter"> {
     /** 当前值。 */
     value?: string | number;
@@ -1316,4 +1355,4 @@ declare function useReactContentScale(): ReactContentScaleValue;
  */
 declare const REACT_COMPONENT_PREFIX = "canvas-react";
 
-export { REACT_COMPONENT_PREFIX, ReactAutoComplete, type ReactAutoCompleteProps, ReactButton, type ReactButtonProps, ReactCascader, type ReactCascaderChangeInfo, type ReactCascaderOption, type ReactCascaderProps, ReactCheckbox, type ReactCheckboxProps, type ReactCheckboxRef, ReactCol, type ReactColProps, ReactColorPicker, type ReactColorPickerProps, ReactContentScaleProvider, type ReactContentScaleValue, ReactDatePicker, type ReactDatePickerProps, ReactDateRangePicker, type ReactDateRangePickerProps, ReactDateTimePicker, type ReactDateTimePickerProps, ReactDateTimeRangePicker, type ReactDateTimeRangePickerProps, type ReactFilterConditionOperator, ReactFilterPanel, type ReactFilterPanelCondition, type ReactFilterPanelOption, type ReactFilterPanelRequest, type ReactFilterPanelTexts, type ReactFilterPanelValue, ReactFlex, type ReactFlexProps, ReactForm, type ReactFormInstance, type ReactFormItemProps, type ReactFormProps, type ReactFormRule, type ReactFormRuleConfig, type ReactFormValues, ReactImagePreview, type ReactImagePreviewProps, ReactInput, ReactInputNumber, type ReactInputNumberProps, type ReactInputProps, ReactInputRange, type ReactInputRangeProps, type ReactInputRangeValue, type ReactMessageType, ReactModal, type ReactModalButtonProps, type ReactModalCancelEvent, type ReactModalProps, ReactMonthPicker, type ReactMonthPickerProps, ReactNumberInput, type ReactNumberInputProps, ReactPagination, type ReactPaginationProps, type ReactPaginationStyles, ReactPopconfirm, type ReactPopconfirmButtonProps, type ReactPopconfirmPlacement, type ReactPopconfirmProps, ReactPopup, type ReactPopupProps, ReactQuarterPicker, type ReactQuarterPickerProps, ReactRadio, type ReactRadioGroupProps, type ReactRadioProps, type ReactResizablePanel, type ReactResizablePanelSizes, ReactResizablePanels, type ReactResizablePanelsDirection, type ReactResizablePanelsProps, type ReactResizablePanelsResizeInfo, ReactRow, type ReactRowProps, ReactSelect, type ReactSelectChangeInfo, type ReactSelectFilterOption, type ReactSelectOption, type ReactSelectProps, ReactTextArea, type ReactTextAreaProps, ReactTimePicker, type ReactTimePickerProps, ReactTimeRangePicker, type ReactTimeRangePickerProps, ReactTooltip, type ReactTooltipProps, ReactTransition, type ReactTransitionDuration, type ReactTransitionOptions, type ReactTransitionPhase, type ReactTransitionProps, type ReactTransitionState, ReactVirtualList, type ReactVirtualListProps, type ReactVirtualListRef, ReactYearPicker, type ReactYearPickerProps, reactMessage, resolveResizablePanelSizes, useReactContentScale, useReactForm, useReactFormWatch, useReactTransition };
+export { type CascaderCheckedStrategy, type CascaderPath, REACT_COMPONENT_PREFIX, ReactAutoComplete, type ReactAutoCompleteProps, ReactButton, type ReactButtonProps, ReactCascader, type ReactCascaderChangeInfo, type ReactCascaderOption, type ReactCascaderProps, ReactCheckbox, type ReactCheckboxProps, type ReactCheckboxRef, ReactCol, type ReactColProps, ReactColorPicker, type ReactColorPickerProps, ReactContentScaleProvider, type ReactContentScaleValue, ReactDatePicker, type ReactDatePickerProps, ReactDateRangePicker, type ReactDateRangePickerProps, ReactDateTimePicker, type ReactDateTimePickerProps, ReactDateTimeRangePicker, type ReactDateTimeRangePickerProps, type ReactFilterConditionOperator, ReactFilterPanel, type ReactFilterPanelCondition, type ReactFilterPanelOption, type ReactFilterPanelRequest, type ReactFilterPanelTexts, type ReactFilterPanelValue, ReactFlex, type ReactFlexProps, ReactForm, type ReactFormInstance, type ReactFormItemProps, type ReactFormProps, type ReactFormRule, type ReactFormRuleConfig, type ReactFormValues, ReactImagePreview, type ReactImagePreviewProps, ReactInput, ReactInputNumber, type ReactInputNumberProps, type ReactInputProps, ReactInputRange, type ReactInputRangeProps, type ReactInputRangeValue, type ReactMessageType, ReactModal, type ReactModalButtonProps, type ReactModalCancelEvent, type ReactModalProps, ReactMonthPicker, type ReactMonthPickerProps, ReactNumberInput, type ReactNumberInputProps, ReactPagination, type ReactPaginationProps, type ReactPaginationStyles, ReactPopconfirm, type ReactPopconfirmButtonProps, type ReactPopconfirmPlacement, type ReactPopconfirmProps, ReactPopup, type ReactPopupProps, ReactQuarterPicker, type ReactQuarterPickerProps, ReactRadio, type ReactRadioGroupProps, type ReactRadioProps, type ReactResizablePanel, type ReactResizablePanelSizes, ReactResizablePanels, type ReactResizablePanelsDirection, type ReactResizablePanelsProps, type ReactResizablePanelsResizeInfo, ReactRow, type ReactRowProps, ReactSelect, type ReactSelectChangeInfo, type ReactSelectFilterOption, type ReactSelectOption, type ReactSelectProps, ReactTextArea, type ReactTextAreaProps, ReactTimePicker, type ReactTimePickerProps, ReactTimeRangePicker, type ReactTimeRangePickerProps, ReactTooltip, type ReactTooltipProps, ReactTransition, type ReactTransitionDuration, type ReactTransitionOptions, type ReactTransitionPhase, type ReactTransitionProps, type ReactTransitionState, ReactTreeSelect, type ReactTreeSelectChangeInfo, type TreeSelectNode as ReactTreeSelectNode, type ReactTreeSelectProps, type ReactTreeSelectValue, ReactVirtualList, type ReactVirtualListProps, type ReactVirtualListRef, ReactYearPicker, type ReactYearPickerProps, reactMessage, resolveResizablePanelSizes, useReactContentScale, useReactForm, useReactFormWatch, useReactTransition };

package/dist/index.d.ts

@@ -927,6 +927,11 @@ interface ReactSelectProps extends Omit<ReactInputProps, "value" | "onChange" |
  */
 declare const ReactSelect: react.ForwardRefExoticComponent<ReactSelectProps & react.RefAttributes<HTMLInputElement>>;
 
+/** 级联选择保留数字和字符串类型，不使用分隔符拼接路径。 */
+type CascaderPath = (string | number)[];
+/** 多选回填策略：优先完整父级，或仅回填末级。 */
+type CascaderCheckedStrategy = "SHOW_PARENT" | "SHOW_CHILD";
+
 /** 级联选择树节点；值保留原始字符串或数字类型。 */
 interface ReactCascaderOption {
     label: string;
@@ -939,19 +944,53 @@ interface ReactCascaderChangeInfo {
     trigger: "mouse" | "keyboard" | "clear";
     complete: boolean;
 }
-/** 单路径级联选择配置。 */
+/** 单选或多选级联选择配置。 */
 interface ReactCascaderProps extends Omit<ReactInputProps, "value" | "defaultValue" | "onChange" | "onPressEnter" | "displayRender"> {
-    value?: (string | number)[];
+    value?: CascaderPath | CascaderPath[];
+    /** 多选时使用二维路径数组，勾选不会关闭弹层。 */
+    multiple?: boolean;
+    /** 多选回填策略，默认 SHOW_PARENT。 */
+    showCheckedStrategy?: CascaderCheckedStrategy;
     options?: ReactCascaderOption[];
     showSearch?: boolean;
     changeOnSelect?: boolean;
     expandTrigger?: "click" | "hover";
     displayRender?: (labels: string[], selectedOptions: ReactCascaderOption[]) => string;
-    onChange?: (value: (string | number)[], selectedOptions: ReactCascaderOption[], info: ReactCascaderChangeInfo) => void;
+    onChange?: (value: CascaderPath | CascaderPath[], selectedOptions: ReactCascaderOption[] | ReactCascaderOption[][], info: ReactCascaderChangeInfo) => void;
 }
 /** 多列展开的级联选择器，复用现有输入框、浮层及主题。 */
 declare function ReactCascader(props: ReactCascaderProps): react.JSX.Element;
 
+/** 树选择节点；value 在整棵树中唯一，数字和字符串严格区分。 */
+interface TreeSelectNode {
+    title: string;
+    value: string | number;
+    key?: string | number;
+    disabled?: boolean;
+    selectable?: boolean;
+    children?: TreeSelectNode[];
+}
+
+/** 单选返回节点值，多选返回节点值数组；不是 Cascader 的路径数组。 */
+type ReactTreeSelectValue = string | number | (string | number)[] | null;
+/** 树选择变更来源，只有完成单选才自动关闭编辑。 */
+interface ReactTreeSelectChangeInfo {
+    trigger: "mouse" | "keyboard" | "clear";
+    complete: boolean;
+}
+/** AntD 风格树选择的基础单选与独立多选配置。 */
+interface ReactTreeSelectProps extends Omit<ReactInputProps, "value" | "defaultValue" | "onChange" | "onPressEnter"> {
+    value?: ReactTreeSelectValue;
+    treeData?: TreeSelectNode[];
+    multiple?: boolean;
+    showSearch?: boolean;
+    treeDefaultExpandAll?: boolean;
+    treeDefaultExpandedKeys?: (string | number)[];
+    onChange?: (value: ReactTreeSelectValue, selectedNodes: TreeSelectNode[], info: ReactTreeSelectChangeInfo) => void;
+}
+/** 树形下拉选择，复用现有输入框、清空图标与定位弹层。 */
+declare function ReactTreeSelect(props: ReactTreeSelectProps): react.JSX.Element;
+
 interface ReactAutoCompleteProps extends Omit<ReactSelectProps, "allowCustomValue" | "onChange" | "onInputValueChange" | "onPressEnter"> {
     /** 当前值。 */
     value?: string | number;
@@ -1316,4 +1355,4 @@ declare function useReactContentScale(): ReactContentScaleValue;
  */
 declare const REACT_COMPONENT_PREFIX = "canvas-react";
 
-export { REACT_COMPONENT_PREFIX, ReactAutoComplete, type ReactAutoCompleteProps, ReactButton, type ReactButtonProps, ReactCascader, type ReactCascaderChangeInfo, type ReactCascaderOption, type ReactCascaderProps, ReactCheckbox, type ReactCheckboxProps, type ReactCheckboxRef, ReactCol, type ReactColProps, ReactColorPicker, type ReactColorPickerProps, ReactContentScaleProvider, type ReactContentScaleValue, ReactDatePicker, type ReactDatePickerProps, ReactDateRangePicker, type ReactDateRangePickerProps, ReactDateTimePicker, type ReactDateTimePickerProps, ReactDateTimeRangePicker, type ReactDateTimeRangePickerProps, type ReactFilterConditionOperator, ReactFilterPanel, type ReactFilterPanelCondition, type ReactFilterPanelOption, type ReactFilterPanelRequest, type ReactFilterPanelTexts, type ReactFilterPanelValue, ReactFlex, type ReactFlexProps, ReactForm, type ReactFormInstance, type ReactFormItemProps, type ReactFormProps, type ReactFormRule, type ReactFormRuleConfig, type ReactFormValues, ReactImagePreview, type ReactImagePreviewProps, ReactInput, ReactInputNumber, type ReactInputNumberProps, type ReactInputProps, ReactInputRange, type ReactInputRangeProps, type ReactInputRangeValue, type ReactMessageType, ReactModal, type ReactModalButtonProps, type ReactModalCancelEvent, type ReactModalProps, ReactMonthPicker, type ReactMonthPickerProps, ReactNumberInput, type ReactNumberInputProps, ReactPagination, type ReactPaginationProps, type ReactPaginationStyles, ReactPopconfirm, type ReactPopconfirmButtonProps, type ReactPopconfirmPlacement, type ReactPopconfirmProps, ReactPopup, type ReactPopupProps, ReactQuarterPicker, type ReactQuarterPickerProps, ReactRadio, type ReactRadioGroupProps, type ReactRadioProps, type ReactResizablePanel, type ReactResizablePanelSizes, ReactResizablePanels, type ReactResizablePanelsDirection, type ReactResizablePanelsProps, type ReactResizablePanelsResizeInfo, ReactRow, type ReactRowProps, ReactSelect, type ReactSelectChangeInfo, type ReactSelectFilterOption, type ReactSelectOption, type ReactSelectProps, ReactTextArea, type ReactTextAreaProps, ReactTimePicker, type ReactTimePickerProps, ReactTimeRangePicker, type ReactTimeRangePickerProps, ReactTooltip, type ReactTooltipProps, ReactTransition, type ReactTransitionDuration, type ReactTransitionOptions, type ReactTransitionPhase, type ReactTransitionProps, type ReactTransitionState, ReactVirtualList, type ReactVirtualListProps, type ReactVirtualListRef, ReactYearPicker, type ReactYearPickerProps, reactMessage, resolveResizablePanelSizes, useReactContentScale, useReactForm, useReactFormWatch, useReactTransition };
+export { type CascaderCheckedStrategy, type CascaderPath, REACT_COMPONENT_PREFIX, ReactAutoComplete, type ReactAutoCompleteProps, ReactButton, type ReactButtonProps, ReactCascader, type ReactCascaderChangeInfo, type ReactCascaderOption, type ReactCascaderProps, ReactCheckbox, type ReactCheckboxProps, type ReactCheckboxRef, ReactCol, type ReactColProps, ReactColorPicker, type ReactColorPickerProps, ReactContentScaleProvider, type ReactContentScaleValue, ReactDatePicker, type ReactDatePickerProps, ReactDateRangePicker, type ReactDateRangePickerProps, ReactDateTimePicker, type ReactDateTimePickerProps, ReactDateTimeRangePicker, type ReactDateTimeRangePickerProps, type ReactFilterConditionOperator, ReactFilterPanel, type ReactFilterPanelCondition, type ReactFilterPanelOption, type ReactFilterPanelRequest, type ReactFilterPanelTexts, type ReactFilterPanelValue, ReactFlex, type ReactFlexProps, ReactForm, type ReactFormInstance, type ReactFormItemProps, type ReactFormProps, type ReactFormRule, type ReactFormRuleConfig, type ReactFormValues, ReactImagePreview, type ReactImagePreviewProps, ReactInput, ReactInputNumber, type ReactInputNumberProps, type ReactInputProps, ReactInputRange, type ReactInputRangeProps, type ReactInputRangeValue, type ReactMessageType, ReactModal, type ReactModalButtonProps, type ReactModalCancelEvent, type ReactModalProps, ReactMonthPicker, type ReactMonthPickerProps, ReactNumberInput, type ReactNumberInputProps, ReactPagination, type ReactPaginationProps, type ReactPaginationStyles, ReactPopconfirm, type ReactPopconfirmButtonProps, type ReactPopconfirmPlacement, type ReactPopconfirmProps, ReactPopup, type ReactPopupProps, ReactQuarterPicker, type ReactQuarterPickerProps, ReactRadio, type ReactRadioGroupProps, type ReactRadioProps, type ReactResizablePanel, type ReactResizablePanelSizes, ReactResizablePanels, type ReactResizablePanelsDirection, type ReactResizablePanelsProps, type ReactResizablePanelsResizeInfo, ReactRow, type ReactRowProps, ReactSelect, type ReactSelectChangeInfo, type ReactSelectFilterOption, type ReactSelectOption, type ReactSelectProps, ReactTextArea, type ReactTextAreaProps, ReactTimePicker, type ReactTimePickerProps, ReactTimeRangePicker, type ReactTimeRangePickerProps, ReactTooltip, type ReactTooltipProps, ReactTransition, type ReactTransitionDuration, type ReactTransitionOptions, type ReactTransitionPhase, type ReactTransitionProps, type ReactTransitionState, ReactTreeSelect, type ReactTreeSelectChangeInfo, type TreeSelectNode as ReactTreeSelectNode, type ReactTreeSelectProps, type ReactTreeSelectValue, ReactVirtualList, type ReactVirtualListProps, type ReactVirtualListRef, ReactYearPicker, type ReactYearPickerProps, reactMessage, resolveResizablePanelSizes, useReactContentScale, useReactForm, useReactFormWatch, useReactTransition };