one-design-next 0.0.4-alpha.100

package/dist/cascader/CascaderOptionContent.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+interface CascaderOptionContentProps {
+    /** 显示的内容 */
+    content: React.ReactNode;
+    /** 用户自定义的 popover 内容 */
+    customPopover?: React.ReactNode;
+    /** Popover 的额外属性 */
+    optionPopoverProps?: Record<string, unknown>;
+    /** 是否强制显示 Popover（用于调试） */
+    forceShow?: boolean;
+}
+/**
+ * Cascader 选项内容组件
+ * 智能判断是否需要显示 Popover：
+ * 1. 当用户传入了自定义 popover 内容时，始终显示
+ * 2. 当用户没有传入时，检测文本是否被截断，只有被截断时才显示 Popover
+ * 优化：hover 时计算截断状态，避免初始渲染时的性能问题
+ */
+declare const CascaderOptionContent: React.FC<CascaderOptionContentProps>;
+export default CascaderOptionContent;

package/dist/cascader/CascaderOptionContent.js

@@ -0,0 +1,85 @@
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import React, { useCallback, useRef, useState } from 'react';
+import Popover from "../popover";
+/**
+ * Cascader 选项内容组件
+ * 智能判断是否需要显示 Popover：
+ * 1. 当用户传入了自定义 popover 内容时，始终显示
+ * 2. 当用户没有传入时，检测文本是否被截断，只有被截断时才显示 Popover
+ * 优化：hover 时计算截断状态，避免初始渲染时的性能问题
+ */
+var CascaderOptionContent = function CascaderOptionContent(_ref) {
+  var content = _ref.content,
+    customPopover = _ref.customPopover,
+    optionPopoverProps = _ref.optionPopoverProps,
+    _ref$forceShow = _ref.forceShow,
+    forceShow = _ref$forceShow === void 0 ? false : _ref$forceShow;
+  var contentRef = useRef(null);
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    shouldShowPopover = _useState2[0],
+    setShouldShowPopover = _useState2[1];
+
+  // hover 事件处理：每次 hover 时都计算截断状态
+  var handleMouseEnter = useCallback(function () {
+    if (contentRef.current) {
+      var element = contentRef.current;
+      // 检查是否有省略号（文本被截断）
+      var isTextTruncated = element.scrollWidth > element.clientWidth;
+
+      // 决定是否显示 Popover：
+      // 1. 用户传入了自定义 popover 内容
+      // 2. 或者文本被截断且没有自定义内容
+      var shouldShow = !!customPopover || isTextTruncated && !customPopover;
+
+      // 只有状态真正改变时才更新，避免不必要的重新渲染
+      setShouldShowPopover(function (prev) {
+        return prev !== shouldShow ? shouldShow : prev;
+      });
+    }
+  }, [customPopover]);
+
+  // 内容容器元素
+  var contentElement = /*#__PURE__*/React.createElement("div", {
+    ref: contentRef,
+    style: {
+      display: 'inline-block'
+    },
+    onMouseEnter: handleMouseEnter
+  }, content);
+
+  // 如果有自定义 popover 或强制显示，始终显示 Popover
+  if (customPopover || forceShow) {
+    var popoverContent = customPopover || content;
+    return /*#__PURE__*/React.createElement(Popover, _extends({
+      popup: /*#__PURE__*/React.createElement("div", {
+        onMouseDown: function onMouseDown(e) {
+          e.stopPropagation();
+        }
+      }, popoverContent),
+      zIndex: "var(--odn-z-index-message)",
+      placement: "right",
+      mouseEnterDelay: 0.3
+    }, optionPopoverProps), contentElement);
+  }
+
+  // 统一使用 Popover，通过 visible 属性控制显示
+  return /*#__PURE__*/React.createElement(Popover, _extends({
+    popup: /*#__PURE__*/React.createElement("div", {
+      onMouseDown: function onMouseDown(e) {
+        e.stopPropagation();
+      }
+    }, content),
+    zIndex: "var(--odn-z-index-message)",
+    placement: "right",
+    mouseEnterDelay: 0.3,
+    visible: shouldShowPopover ? undefined : false
+  }, optionPopoverProps), contentElement);
+};
+export default CascaderOptionContent;

package/dist/cascader/Panel.d.ts

@@ -0,0 +1,53 @@
+import type { DefaultOptionType } from 'rc-cascader';
+import React from 'react';
+import { type FieldNames } from './utils';
+declare const SHOW_PARENT: "SHOW_PARENT", SHOW_CHILD: "SHOW_CHILD";
+export interface BaseCascaderPanelProps {
+    /** 选项数据 */
+    options?: DefaultOptionType[];
+    /** 是否支持多选 */
+    checkable?: boolean;
+    /** 样式前缀 */
+    prefixCls?: string;
+    /** 展开图标 */
+    expandIcon?: React.ReactNode;
+    /** 加载图标 */
+    loadingIcon?: React.ReactNode;
+    /** 占位符文本 */
+    placeholder?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 展开触发方式 */
+    expandTrigger?: 'click' | 'hover';
+    /** 是否在选择后改变选项 */
+    changeOnSelect?: boolean;
+    /** 字段名映射 */
+    fieldNames?: FieldNames;
+    /** 显示选中策略 */
+    showCheckedStrategy?: typeof SHOW_PARENT | typeof SHOW_CHILD;
+    /** 异步加载数据 */
+    loadData?: (selectedOptions: DefaultOptionType[]) => void;
+    /** 布局方向 */
+    direction?: 'ltr' | 'rtl';
+    /** 无数据时显示的内容 */
+    notFoundContent?: React.ReactNode;
+    /** 是否自动设置列的最大宽度，基于 options 的深度 */
+    autoMaxWidth?: boolean;
+    /** 选项 popover 的额外属性 */
+    optionPopoverProps?: Record<string, unknown>;
+}
+export type CascaderPanelProps<V = (string | number)[] | null> = BaseCascaderPanelProps & {
+    mode?: 'single' | 'multiple';
+    value?: V;
+    defaultValue?: V;
+    onChange?: (value: V, selectOptions: DefaultOptionType[]) => void;
+};
+export interface CascaderPanelComponent {
+    <V = (string | number)[] | null>(props: CascaderPanelProps<V>): React.ReactElement | null;
+}
+declare const PanelComponent: CascaderPanelComponent;
+export default PanelComponent;

package/dist/cascader/Panel.js

@@ -0,0 +1,131 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _excluded = ["value", "defaultValue", "onChange", "mode", "checkable", "prefixCls", "expandIcon", "loadingIcon", "options", "style", "autoMaxWidth", "fieldNames", "optionPopoverProps"];
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import RcCascader from 'rc-cascader';
+import React from 'react';
+import Icon from "../icon";
+import { calculateOptionsDepth, DEFAULT_FIELD_NAMES, generateCommonStyle, processOptions } from "./utils";
+var SHOW_PARENT = RcCascader.SHOW_PARENT,
+  SHOW_CHILD = RcCascader.SHOW_CHILD;
+function CascaderPanel(_ref) {
+  var value = _ref.value,
+    defaultValue = _ref.defaultValue,
+    onChange = _ref.onChange,
+    _ref$mode = _ref.mode,
+    mode = _ref$mode === void 0 ? 'single' : _ref$mode,
+    checkable = _ref.checkable,
+    _ref$prefixCls = _ref.prefixCls,
+    prefixCls = _ref$prefixCls === void 0 ? 'odn-cascader' : _ref$prefixCls,
+    _ref$expandIcon = _ref.expandIcon,
+    expandIcon = _ref$expandIcon === void 0 ? /*#__PURE__*/React.createElement(Icon, {
+      name: "right"
+    }) : _ref$expandIcon,
+    loadingIcon = _ref.loadingIcon,
+    options = _ref.options,
+    style = _ref.style,
+    _ref$autoMaxWidth = _ref.autoMaxWidth,
+    autoMaxWidth = _ref$autoMaxWidth === void 0 ? false : _ref$autoMaxWidth,
+    fieldNames = _ref.fieldNames,
+    optionPopoverProps = _ref.optionPopoverProps,
+    restProps = _objectWithoutProperties(_ref, _excluded);
+  // 默认 fieldNames.label 为 labelWithPopover，与 Cascader 一致
+  var mergedFieldNames = React.useMemo(function () {
+    return _objectSpread(_objectSpread({}, DEFAULT_FIELD_NAMES), fieldNames);
+  }, [fieldNames]);
+
+  // 处理 options，确保每个 option 都有 title 字段
+  var processedOptions = React.useMemo(function () {
+    return processOptions(options, mergedFieldNames, optionPopoverProps);
+  }, [options, mergedFieldNames, optionPopoverProps]);
+
+  // 计算 options 的最大深度，用于列宽设置
+  var depth = React.useMemo(function () {
+    return calculateOptionsDepth(processedOptions, mergedFieldNames);
+  }, [processedOptions, mergedFieldNames]);
+
+  // 根据 mode 自动设置 checkable
+  var isCheckable = checkable !== undefined ? checkable : mode === 'multiple';
+  var handleChange = function handleChange(rcValue, selectOptions) {
+    // 如果 value 是 undefined，传递 null
+    if (rcValue === undefined) {
+      onChange === null || onChange === void 0 || onChange(null, selectOptions || []);
+      return;
+    }
+    if (mode === 'multiple') {
+      // 多选模式：处理二维数组
+      if (Array.isArray(rcValue)) {
+        // 空数组直接返回空数组
+        if (rcValue.length === 0) {
+          onChange === null || onChange === void 0 || onChange([], selectOptions || []);
+          return;
+        }
+        // 非空数组且第一个元素是数组，处理二维数组
+        if (Array.isArray(rcValue[0])) {
+          var filteredValue = rcValue.map(function (item) {
+            return item.filter(function (v) {
+              return v !== null && (typeof v === 'string' || typeof v === 'number');
+            });
+          });
+          onChange === null || onChange === void 0 || onChange(filteredValue, selectOptions || []);
+        } else {
+          onChange === null || onChange === void 0 || onChange(null, selectOptions || []);
+        }
+      } else {
+        onChange === null || onChange === void 0 || onChange(null, selectOptions || []);
+      }
+    } else {
+      // 单选模式：处理一维数组
+      if (Array.isArray(rcValue) && !Array.isArray(rcValue[0])) {
+        var _filteredValue = rcValue.filter(function (v) {
+          return v !== null && (typeof v === 'string' || typeof v === 'number');
+        });
+        onChange === null || onChange === void 0 || onChange(_filteredValue, selectOptions || []);
+      } else {
+        onChange === null || onChange === void 0 || onChange(null, selectOptions || []);
+      }
+    }
+  };
+
+  // 转换 value 类型以兼容 rc-cascader
+  var rcValue = value === null ? undefined : value;
+  var rcDefaultValue = defaultValue === null ? undefined : value;
+
+  // 生成公共样式
+  var commonStyle = generateCommonStyle(depth, autoMaxWidth, style);
+
+  // 提取共同的 props
+  var commonProps = _objectSpread({
+    prefixCls: prefixCls,
+    expandIcon: expandIcon,
+    loadingIcon: loadingIcon,
+    onChange: handleChange,
+    options: processedOptions,
+    style: commonStyle,
+    fieldNames: mergedFieldNames
+  }, restProps);
+  if (mode === 'multiple') {
+    return /*#__PURE__*/React.createElement(RcCascader.Panel, _extends({}, commonProps, {
+      value: rcValue,
+      defaultValue: rcDefaultValue
+      // @ts-ignore
+      ,
+      checkable: /*#__PURE__*/React.createElement("span", {
+        className: "odn-cascader-checkbox-inner"
+      })
+    }));
+  }
+  return /*#__PURE__*/React.createElement(RcCascader.Panel, _extends({}, commonProps, {
+    value: rcValue,
+    defaultValue: rcDefaultValue,
+    checkable: false
+  }));
+}
+var PanelComponent = CascaderPanel;
+export default PanelComponent;

package/dist/cascader/index.d.ts

@@ -0,0 +1,59 @@
+import type { DefaultOptionType, CascaderProps as RcCascaderProps } from 'rc-cascader';
+import React from 'react';
+import '../select/style';
+import CascaderPanel from './Panel';
+import './style';
+export interface BaseCascaderProps extends Omit<RcCascaderProps<DefaultOptionType, 'value', false>, 'prefixCls' | 'onChange' | 'value' | 'defaultValue' | 'showCheckedStrategy'> {
+    /** 组件尺寸 */
+    size?: 'small' | 'medium' | 'large';
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 占位符文本 */
+    placeholder?: string;
+    /** 是否支持清除 */
+    allowClear?: boolean;
+    /** 是否支持搜索 */
+    showSearch?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 是否为浅色主题 */
+    light?: boolean;
+    visible?: RcCascaderProps<DefaultOptionType, 'value', false>['open'];
+    onVisibleChange?: RcCascaderProps<DefaultOptionType, 'value', false>['onOpenChange'];
+    options?: DefaultOptionType[];
+    optionPopoverProps?: Record<string, unknown>;
+    /** 是否显示下拉框内的搜索输入框 */
+    showInnerSearch?: boolean;
+    /** 搜索值 */
+    searchValue?: string;
+    /** 搜索回调 */
+    onSearch?: (value: string) => void;
+    /** 选择后是否自动清空搜索值 */
+    autoClearSearchValue?: boolean;
+    /** 搜索过滤函数 */
+    searchFilter?: (inputValue: string, path: DefaultOptionType[]) => boolean;
+    /** 搜索渲染函数 */
+    searchRender?: (inputValue: string, path: DefaultOptionType[], prefixCls: string) => React.ReactNode;
+    /** 搜索结果限制数量 */
+    searchLimit?: number;
+    showCheckedStrategy?: 'child' | 'parent';
+    dropdownClassName?: RcCascaderProps<DefaultOptionType, 'value', false>['dropdownClassName'];
+    /** 分隔符，会同时影响显示与搜索筛选的结果 */
+    separator?: string;
+    /** 自定义下拉列表中每一项的渲染（rc-cascader 原生支持） */
+    optionRender?: (option: DefaultOptionType) => React.ReactNode;
+}
+export type CascaderProps<V = (string | number)[] | null> = BaseCascaderProps & {
+    mode?: 'single' | 'multiple';
+    value?: V;
+    defaultValue?: V;
+    onChange?: (value: V, selectOptions: DefaultOptionType[], e?: React.MouseEvent) => void;
+};
+export interface CascaderComponent {
+    <V = (string | number)[] | null>(props: CascaderProps<V>): React.ReactElement | null;
+    Panel: typeof CascaderPanel;
+}
+declare const Cascader: CascaderComponent;
+export default Cascader;