@yqg/slimfit 0.0.1 → 0.0.2

package/lib/esm/form-mode/readonly-renderers.js

@@ -0,0 +1,328 @@
+import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
+import _typeof from "@babel/runtime/helpers/esm/typeof";
+import { Typography } from 'antd';
+import React from 'react';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var Text = Typography.Text;
+
+// 获取国际化文本的工具函数
+var getLocaleText = function getLocaleText(locale, key, defaultValue) {
+  if (!locale) return defaultValue;
+
+  // 尝试从不同的 locale 路径获取文本
+  var paths = ["global.".concat(key), "Empty.".concat(key), "Select.".concat(key), "Upload.".concat(key), key];
+  for (var _i = 0, _paths = paths; _i < _paths.length; _i++) {
+    var path = _paths[_i];
+    var value = path.split('.').reduce(function (obj, k) {
+      return obj === null || obj === void 0 ? void 0 : obj[k];
+    }, locale);
+    if (value) return value;
+  }
+  return defaultValue;
+};
+
+// 基础文本渲染器
+export var TextReadonlyRenderer = function TextReadonlyRenderer(_ref) {
+  var value = _ref.value,
+    config = _ref.config,
+    locale = _ref.locale;
+  if (value == null || value === '') {
+    return config.showEmptyValue !== false ? /*#__PURE__*/_jsx(Text, {
+      type: "secondary",
+      children: getLocaleText(locale, 'placeholder', '-')
+    }) : null;
+  }
+  return /*#__PURE__*/_jsx(Text, {
+    children: String(value)
+  });
+};
+
+// Select 渲染器
+export var SelectReadonlyRenderer = function SelectReadonlyRenderer(_ref2) {
+  var value = _ref2.value,
+    originalProps = _ref2.originalProps,
+    config = _ref2.config,
+    locale = _ref2.locale;
+  if (value == null) {
+    return config.showEmptyValue !== false ? /*#__PURE__*/_jsx(Text, {
+      type: "secondary",
+      children: getLocaleText(locale, 'placeholder', '-')
+    }) : null;
+  }
+  var options = originalProps.options,
+    children = originalProps.children;
+  var displayText = value;
+  if (options) {
+    var option = options.find(function (opt) {
+      return opt.value === value;
+    });
+    displayText = (option === null || option === void 0 ? void 0 : option.label) || (option === null || option === void 0 ? void 0 : option.children) || value;
+  } else if (children) {
+    var _matchChild$props;
+    var childArray = React.Children.toArray(children);
+    var matchChild = childArray.find(function (child) {
+      var _child$props;
+      return /*#__PURE__*/React.isValidElement(child) && ((_child$props = child.props) === null || _child$props === void 0 ? void 0 : _child$props.value) === value;
+    });
+    displayText = /*#__PURE__*/React.isValidElement(matchChild) ? ((_matchChild$props = matchChild.props) === null || _matchChild$props === void 0 ? void 0 : _matchChild$props.children) || value : value;
+  }
+  return /*#__PURE__*/_jsx(Text, {
+    children: String(displayText)
+  });
+};
+
+// TreeSelect 渲染器
+export var TreeSelectReadonlyRenderer = function TreeSelectReadonlyRenderer(_ref3) {
+  var value = _ref3.value,
+    originalProps = _ref3.originalProps,
+    config = _ref3.config,
+    locale = _ref3.locale;
+  if (value == null) {
+    return config.showEmptyValue !== false ? /*#__PURE__*/_jsx(Text, {
+      type: "secondary",
+      children: getLocaleText(locale, 'placeholder', '-')
+    }) : null;
+  }
+  var treeData = originalProps.treeData,
+    children = originalProps.children;
+  var displayText = value;
+  if (treeData) {
+    var nodeDataMap = {};
+    var valueSet = new Set(Array.isArray(value) ? value : [value]);
+    var findNodeData = function findNodeData(nodeList) {
+      nodeList.forEach(function (node) {
+        if (valueSet.has(node.value)) {
+          nodeDataMap[node.value] = node;
+          return;
+        }
+        if (node.children) {
+          findNodeData(node.children);
+        }
+      });
+    };
+    findNodeData(treeData);
+    displayText = Array.from(valueSet).map(function (v) {
+      var _nodeDataMap$v, _nodeDataMap$v2, _nodeDataMap$v3;
+      return ((_nodeDataMap$v = nodeDataMap[v]) === null || _nodeDataMap$v === void 0 ? void 0 : _nodeDataMap$v.label) || ((_nodeDataMap$v2 = nodeDataMap[v]) === null || _nodeDataMap$v2 === void 0 ? void 0 : _nodeDataMap$v2.title) || ((_nodeDataMap$v3 = nodeDataMap[v]) === null || _nodeDataMap$v3 === void 0 ? void 0 : _nodeDataMap$v3.children) || v;
+    }).join(' ');
+  } else if (children) {
+    var _matchChild$props2;
+    var childArray = React.Children.toArray(children);
+    var matchChild = childArray.find(function (child) {
+      var _child$props2;
+      return /*#__PURE__*/React.isValidElement(child) && ((_child$props2 = child.props) === null || _child$props2 === void 0 ? void 0 : _child$props2.value) === value;
+    });
+    displayText = /*#__PURE__*/React.isValidElement(matchChild) ? ((_matchChild$props2 = matchChild.props) === null || _matchChild$props2 === void 0 ? void 0 : _matchChild$props2.children) || value : value;
+  }
+  return /*#__PURE__*/_jsx(Text, {
+    children: String(displayText)
+  });
+};
+
+// Radio/Checkbox 渲染器
+export var RadioReadonlyRenderer = function RadioReadonlyRenderer(_ref4) {
+  var value = _ref4.value,
+    originalProps = _ref4.originalProps,
+    config = _ref4.config,
+    componentType = _ref4.componentType,
+    locale = _ref4.locale;
+  if (value == null) {
+    return config.showEmptyValue !== false ? /*#__PURE__*/_jsx(Text, {
+      type: "secondary",
+      children: getLocaleText(locale, 'placeholder', '-')
+    }) : null;
+  }
+  if (componentType === 'radio-group' || componentType === 'checkbox-group') {
+    var options = originalProps.options,
+      children = originalProps.children;
+    var displayText = value;
+    if (options) {
+      var option = options.find(function (opt) {
+        return opt.value === value;
+      });
+      displayText = (option === null || option === void 0 ? void 0 : option.label) || value;
+    } else if (children) {
+      var _matchChild$props3;
+      var childArray = React.Children.toArray(children);
+      var matchChild = childArray.find(function (child) {
+        var _child$props3;
+        return /*#__PURE__*/React.isValidElement(child) && ((_child$props3 = child.props) === null || _child$props3 === void 0 ? void 0 : _child$props3.value) === value;
+      });
+      displayText = /*#__PURE__*/React.isValidElement(matchChild) ? ((_matchChild$props3 = matchChild.props) === null || _matchChild$props3 === void 0 ? void 0 : _matchChild$props3.children) || value : value;
+    }
+    return /*#__PURE__*/_jsx(Text, {
+      children: String(displayText)
+    });
+  }
+
+  // 单个 radio/checkbox 显示选中状态
+  return /*#__PURE__*/_jsx(Text, {
+    children: value ? 'Yes' : 'No'
+  });
+};
+
+// Switch 渲染器
+export var SwitchReadonlyRenderer = function SwitchReadonlyRenderer(_ref5) {
+  var value = _ref5.value,
+    originalProps = _ref5.originalProps,
+    config = _ref5.config,
+    locale = _ref5.locale;
+  if (value == null) {
+    return config.showEmptyValue !== false ? /*#__PURE__*/_jsx(Text, {
+      type: "secondary",
+      children: getLocaleText(locale, 'placeholder', '-')
+    }) : null;
+  }
+  var _originalProps$checke = originalProps.checkedChildren,
+    checkedChildren = _originalProps$checke === void 0 ? 'On' : _originalProps$checke,
+    _originalProps$unChec = originalProps.unCheckedChildren,
+    unCheckedChildren = _originalProps$unChec === void 0 ? 'Off' : _originalProps$unChec;
+  return /*#__PURE__*/_jsx(Text, {
+    children: value ? checkedChildren : unCheckedChildren
+  });
+};
+
+// Upload 渲染器
+export var UploadReadonlyRenderer = function UploadReadonlyRenderer(_ref6) {
+  var value = _ref6.value,
+    originalProps = _ref6.originalProps,
+    config = _ref6.config,
+    locale = _ref6.locale;
+  if (!value || Array.isArray(value) && value.length === 0) {
+    return config.showEmptyValue !== false ? /*#__PURE__*/_jsx(Text, {
+      type: "secondary",
+      children: getLocaleText(locale, 'description', 'No files')
+    }) : null;
+  }
+  var fileList = Array.isArray(value) ? value : [value];
+  return /*#__PURE__*/_jsx("div", {
+    className: "readonly-file-list",
+    children: fileList.map(function (file, index) {
+      return /*#__PURE__*/_jsx("div", {
+        className: "readonly-file-item",
+        children: /*#__PURE__*/_jsxs(Text, {
+          children: [file.name || file.fileName || "File ".concat(index + 1), file.url && /*#__PURE__*/_jsx("a", {
+            href: file.url,
+            target: "_blank",
+            rel: "noopener noreferrer",
+            className: "readonly-file-link",
+            children: ' (View)'
+          })]
+        })
+      }, index);
+    })
+  });
+};
+
+// DatePicker 渲染器
+export var DatePickerReadonlyRenderer = function DatePickerReadonlyRenderer(_ref7) {
+  var value = _ref7.value,
+    config = _ref7.config,
+    locale = _ref7.locale;
+  if (!value) {
+    return config.showEmptyValue !== false ? /*#__PURE__*/_jsx(Text, {
+      type: "secondary",
+      children: getLocaleText(locale, 'placeholder', '-')
+    }) : null;
+  }
+
+  // 处理不同的日期格式
+  var displayText = value;
+
+  // 检查是否为 moment 或 dayjs 对象
+  if (value && _typeof(value) === 'object' && typeof value.format === 'function') {
+    try {
+      // 对于日期对象，尝试格式化
+      displayText = value.format('YYYY-MM-DD');
+    } catch (error) {
+      // 如果格式化失败，使用原始值
+      displayText = String(value);
+    }
+  } else if (value instanceof Date) {
+    // 原生 Date 对象
+    displayText = value.toLocaleDateString();
+  } else if (typeof value === 'string') {
+    // 字符串直接显示
+    displayText = value;
+  } else {
+    // 其他类型转换为字符串
+    displayText = String(value);
+  }
+  return /*#__PURE__*/_jsx(Text, {
+    children: String(displayText)
+  });
+};
+
+// 范围选择器渲染器
+export var RangePickerReadonlyRenderer = function RangePickerReadonlyRenderer(_ref8) {
+  var value = _ref8.value,
+    config = _ref8.config,
+    locale = _ref8.locale;
+  if (!value || !Array.isArray(value) || value.length !== 2) {
+    return config.showEmptyValue !== false ? /*#__PURE__*/_jsx(Text, {
+      type: "secondary",
+      children: getLocaleText(locale, 'placeholder', '-')
+    }) : null;
+  }
+  var _value = _slicedToArray(value, 2),
+    start = _value[0],
+    end = _value[1];
+  var startText = start;
+  var endText = end;
+
+  // 处理日期格式
+  if (start && _typeof(start) === 'object' && typeof start.format === 'function') {
+    try {
+      startText = start.format('YYYY-MM-DD');
+    } catch (error) {
+      startText = String(start);
+    }
+  } else if (typeof start === 'string') {
+    startText = start;
+  } else {
+    startText = String(start);
+  }
+  if (end && _typeof(end) === 'object' && typeof end.format === 'function') {
+    try {
+      endText = end.format('YYYY-MM-DD');
+    } catch (error) {
+      endText = String(end);
+    }
+  } else if (typeof end === 'string') {
+    endText = end;
+  } else {
+    endText = String(end);
+  }
+  return /*#__PURE__*/_jsx(Text, {
+    children: "".concat(startText, " ~ ").concat(endText)
+  });
+};
+
+// 渲染器映射
+var rendererMap = {
+  input: TextReadonlyRenderer,
+  textarea: TextReadonlyRenderer,
+  'input-password': TextReadonlyRenderer,
+  'input-number': TextReadonlyRenderer,
+  select: SelectReadonlyRenderer,
+  'tree-select': TreeSelectReadonlyRenderer,
+  cascader: SelectReadonlyRenderer,
+  'date-picker': DatePickerReadonlyRenderer,
+  'time-picker': TextReadonlyRenderer,
+  'range-picker': RangePickerReadonlyRenderer,
+  radio: RadioReadonlyRenderer,
+  'radio-group': RadioReadonlyRenderer,
+  checkbox: RadioReadonlyRenderer,
+  'checkbox-group': RadioReadonlyRenderer,
+  switch: SwitchReadonlyRenderer,
+  upload: UploadReadonlyRenderer
+};
+export function getReadonlyRenderer(componentType) {
+  return rendererMap[componentType] || TextReadonlyRenderer;
+}
+
+// 注册自定义渲染器
+export function registerReadonlyRenderer(componentType, renderer) {
+  rendererMap[componentType] = renderer;
+}

package/lib/esm/form-mode/style.css

@@ -0,0 +1,69 @@
+/* Form Mode 只读样式 */
+.ant-slimfit-form-readonly {
+  min-height: 32px;
+  display: flex;
+  align-items: center;
+  padding: 4px 11px;
+  line-height: 1.5715;
+  color: var(--color-text-base);
+}
+
+.ant-slimfit-form-readonly-input,
+.ant-slimfit-form-readonly-textarea {
+  border: 1px solid transparent;
+  border-radius: 6px;
+  background: transparent;
+}
+
+.ant-slimfit-form-readonly-select,
+.ant-slimfit-form-readonly-cascader,
+.ant-slimfit-form-readonly-tree-select {
+  min-width: 100px;
+}
+
+.ant-slimfit-form-readonly-upload .readonly-file-list {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.ant-slimfit-form-readonly-upload .readonly-file-item {
+  display: flex;
+  align-items: center;
+}
+
+.ant-slimfit-form-readonly-upload .readonly-file-link {
+  color: var(--color-link);
+  text-decoration: none;
+  margin-left: 4px;
+}
+
+.ant-slimfit-form-readonly-upload .readonly-file-link:hover {
+  text-decoration: underline;
+}
+
+/* 保持布局一致性 */
+.ant-slimfit-form-readonly-preserve-layout {
+  border: 1px solid var(--color-text-secondary);
+  border-radius: 6px;
+  background-color: var(--color-bg-elevated);
+  opacity: 0.7;
+}
+
+/* 空值显示样式 */
+.ant-slimfit-form-readonly .ant-typography {
+  margin: 0;
+}
+
+/* 成功/错误状态颜色 */
+.ant-slimfit-form-readonly-success {
+  color: var(--color-success);
+}
+
+.ant-slimfit-form-readonly-error {
+  color: var(--color-error);
+}
+
+.ant-slimfit-form-readonly-warning {
+  color: var(--color-warning);
+}

package/lib/esm/form-mode/types.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="react" />
+export type FormMode = 'edit' | 'read';
+export interface FormModeConfig {
+    mode?: FormMode;
+    readonlyRender?: (value: any, props: any) => React.ReactNode;
+    showEmptyValue?: boolean;
+    preserveLayout?: boolean;
+}
+export interface WithFormModeProps {
+    formMode?: FormMode;
+    formModeConfig?: Omit<FormModeConfig, 'mode'>;
+}
+export interface FormModeContextValue {
+    mode: FormMode;
+    config: FormModeConfig;
+    locale?: any;
+}
+export interface ReadonlyRendererProps {
+    value: any;
+    originalProps: any;
+    config: FormModeConfig;
+    componentType: string;
+    locale?: any;
+}

package/lib/esm/form-mode/types.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/form-mode/with-form-mode.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import './style.css';
+import type { FormModeConfig, WithFormModeProps } from './types';
+export declare function withFormMode<P extends Record<string, any>>(WrappedComponent: React.ComponentType<P>, componentType: string, defaultConfig?: Partial<FormModeConfig>): React.ForwardRefExoticComponent<React.PropsWithoutRef<P & WithFormModeProps> & React.RefAttributes<any>>;

package/lib/esm/form-mode/with-form-mode.js

@@ -0,0 +1,66 @@
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+var _excluded = ["formMode", "formModeConfig"];
+import { ConfigProvider } from 'antd';
+import React, { useContext } from 'react';
+import { useFormModeContext } from "../form/form-mode-context";
+import { getReadonlyRenderer } from "./readonly-renderers";
+import "./style.css";
+import { jsx as _jsx } from "react/jsx-runtime";
+var ConfigContext = ConfigProvider.ConfigContext;
+export function withFormMode(WrappedComponent, componentType, defaultConfig) {
+  var WithFormModeComponent = /*#__PURE__*/React.forwardRef(function (props, ref) {
+    var propFormMode = props.formMode,
+      formModeConfig = props.formModeConfig,
+      restProps = _objectWithoutProperties(props, _excluded);
+    var formModeContext = useFormModeContext();
+    var _useContext = useContext(ConfigContext),
+      getPrefixCls = _useContext.getPrefixCls,
+      locale = _useContext.locale;
+
+    // 优先级：props.formMode > form context mode > 'edit'
+    var finalMode = propFormMode || (formModeContext === null || formModeContext === void 0 ? void 0 : formModeContext.mode) || 'edit';
+    var finalConfig = _objectSpread(_objectSpread(_objectSpread(_objectSpread({
+      showEmptyValue: true,
+      preserveLayout: true
+    }, defaultConfig), formModeContext === null || formModeContext === void 0 ? void 0 : formModeContext.config), formModeConfig), {}, {
+      mode: finalMode
+    });
+
+    // edit 模式直接渲染原组件
+    if (finalMode === 'edit') {
+      return /*#__PURE__*/_jsx(WrappedComponent, _objectSpread(_objectSpread({}, restProps), {}, {
+        ref: ref
+      }));
+    }
+
+    // read 模式渲染只读版本
+    var prefixCls = getPrefixCls('slimfit-form-readonly');
+
+    // 获取实际的值，优先级：props.value > props.defaultValue > undefined
+    var actualValue = restProps.value !== undefined ? restProps.value : restProps.defaultValue;
+
+    // 如果有自定义渲染器，优先使用
+    if (finalConfig.readonlyRender) {
+      return /*#__PURE__*/_jsx("div", {
+        ref: ref,
+        className: "".concat(prefixCls, " ").concat(prefixCls, "-").concat(componentType, " ").concat(finalConfig.preserveLayout ? "".concat(prefixCls, "-preserve-layout") : ''),
+        children: finalConfig.readonlyRender(actualValue, restProps)
+      });
+    }
+    var ReadonlyRenderer = getReadonlyRenderer(componentType);
+    return /*#__PURE__*/_jsx("div", {
+      ref: ref,
+      className: "".concat(prefixCls, " ").concat(prefixCls, "-").concat(componentType, " ").concat(finalConfig.preserveLayout ? "".concat(prefixCls, "-preserve-layout") : ''),
+      children: /*#__PURE__*/_jsx(ReadonlyRenderer, {
+        value: actualValue,
+        originalProps: restProps,
+        config: finalConfig,
+        componentType: componentType,
+        locale: locale
+      })
+    });
+  });
+  WithFormModeComponent.displayName = "withFormMode(".concat(WrappedComponent.displayName || WrappedComponent.name, ")");
+  return WithFormModeComponent;
+}

package/lib/esm/hooks/index.d.ts

@@ -0,0 +1,10 @@
+export { useCopyToClipboard } from './useCopyToClipboard';
+export type { CopyResult } from './useCopyToClipboard';
+export { useLocale } from './useLocale';
+export { default as withCustomClassName } from './withCustomClassName';
+export { customClearIcon, processAllowClear, withCustomClearIcon, } from './withCustomClearIcon';
+export { withCustomSelect } from './withCustomSelect';
+export { default as withCustomerLoading } from './withCustomerLoading';
+export type { CustomerLoadingOptions, LoadingPosition, WithCustomerLoadingProps, } from './withCustomerLoading';
+export { default as withDisabledClass } from './withDisabledClass';
+export type { DisabledClassOptions } from './withDisabledClass';

package/lib/esm/hooks/index.js

@@ -0,0 +1,7 @@
+export { useCopyToClipboard } from "./useCopyToClipboard";
+export { useLocale } from "./useLocale";
+export { default as withCustomClassName } from "./withCustomClassName";
+export { customClearIcon, processAllowClear, withCustomClearIcon } from "./withCustomClearIcon";
+export { withCustomSelect } from "./withCustomSelect";
+export { default as withCustomerLoading } from "./withCustomerLoading";
+export { default as withDisabledClass } from "./withDisabledClass";

package/lib/esm/hooks/useCopyToClipboard.d.ts

@@ -0,0 +1,10 @@
+export interface CopyResult {
+    success: boolean;
+    error?: string;
+}
+export declare const useCopyToClipboard: () => {
+    copyToClipboard: (text: string) => Promise<CopyResult>;
+    copiedText: string | null;
+    isLoading: boolean;
+    isCopied: (text: string) => boolean;
+};

package/lib/esm/hooks/useCopyToClipboard.js

@@ -0,0 +1,72 @@
+import _regeneratorRuntime from "@babel/runtime/helpers/esm/regeneratorRuntime";
+import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
+import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
+import { copyToClipboard as beetleCopyToClipboard } from '@yqg/beetle';
+import { useCallback, useState } from 'react';
+export var useCopyToClipboard = function useCopyToClipboard() {
+  var _useState = useState(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    copiedText = _useState2[0],
+    setCopiedText = _useState2[1];
+  var _useState3 = useState(false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    isLoading = _useState4[0],
+    setIsLoading = _useState4[1];
+  var copyToClipboard = useCallback( /*#__PURE__*/function () {
+    var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(text) {
+      return _regeneratorRuntime().wrap(function _callee$(_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            if (text) {
+              _context.next = 2;
+              break;
+            }
+            return _context.abrupt("return", {
+              success: false,
+              error: '复制内容不能为空'
+            });
+          case 2:
+            setIsLoading(true);
+            return _context.abrupt("return", new Promise(function (resolve) {
+              beetleCopyToClipboard(text, {
+                onSuccess: function onSuccess() {
+                  setCopiedText(text);
+                  setIsLoading(false);
+
+                  // 2秒后清除复制状态
+                  setTimeout(function () {
+                    setCopiedText(null);
+                  }, 2000);
+                  resolve({
+                    success: true
+                  });
+                },
+                onError: function onError(error) {
+                  setIsLoading(false);
+                  console.error('复制失败:', error);
+                  resolve({
+                    success: false,
+                    error: error.message || '复制失败'
+                  });
+                }
+              });
+            }));
+          case 4:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    }));
+    return function (_x) {
+      return _ref.apply(this, arguments);
+    };
+  }(), []);
+  return {
+    copyToClipboard: copyToClipboard,
+    copiedText: copiedText,
+    isLoading: isLoading,
+    isCopied: function isCopied(text) {
+      return copiedText === text;
+    }
+  };
+};

package/lib/esm/hooks/useLocale.d.ts

@@ -0,0 +1 @@
+export declare function useLocale(): import("i18next").i18n;

package/lib/esm/hooks/useLocale.js

@@ -0,0 +1,21 @@
+import { ConfigContext } from 'antd/es/config-provider';
+import { useContext, useEffect } from 'react';
+import { useTranslation } from 'react-i18next';
+import i18n from "../locale";
+export function useLocale() {
+  var _useContext = useContext(ConfigContext),
+    antdLocale = _useContext.locale;
+  var _useTranslation = useTranslation('translation', {
+      i18n: i18n
+    }),
+    i18nInstance = _useTranslation.i18n;
+
+  // 同步 antd locale 到 i18next
+  useEffect(function () {
+    var localeKey = (antdLocale === null || antdLocale === void 0 ? void 0 : antdLocale.locale) || 'en';
+    if (i18n.isInitialized && i18n.language !== localeKey) {
+      i18n.changeLanguage(localeKey);
+    }
+  }, [antdLocale]);
+  return i18nInstance;
+}

package/lib/esm/hooks/withCustomClassName.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+export declare function withCustomClassName<P extends {
+    className?: string;
+}>(Component: React.ComponentType<P>, customClassName: string): React.ForwardRefExoticComponent<React.PropsWithoutRef<P> & React.RefAttributes<any>>;
+export default withCustomClassName;

package/lib/esm/hooks/withCustomClassName.js

@@ -0,0 +1,36 @@
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+var _excluded = ["className"];
+import classNames from 'classnames';
+import React from 'react';
+
+/**
+ * HOC：为组件添加自定义类名
+ *
+ * @param Component 要包装的组件
+ * @param customClassName 自定义类名（例如：'slimfit-radio'、'slimfit-pagination'）
+ * @returns 包装后的组件，支持 ref 转发
+ *
+ * @example
+ *
+ * 为组件添加 slimfit-radio 类名
+ * const RadioWithClassName = withCustomClassName(RadioComponent, 'slimfit-radio');
+ * 使用时支持额外的 className
+ * <Radio className="my-custom-class" />
+ * 最终渲染：class="slimfit-radio my-custom-class"
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+export function withCustomClassName(Component, customClassName) {
+  var WrappedComponent = /*#__PURE__*/React.forwardRef(function (props, ref) {
+    var className = props.className,
+      restProps = _objectWithoutProperties(props, _excluded);
+    return /*#__PURE__*/_jsx(Component, _objectSpread(_objectSpread({
+      ref: ref
+    }, restProps), {}, {
+      className: classNames(customClassName, className)
+    }));
+  });
+  WrappedComponent.displayName = "withCustomClassName(".concat(Component.displayName || Component.name || 'Component', ")");
+  return WrappedComponent;
+}
+export default withCustomClassName;

package/lib/esm/hooks/withCustomClearIcon.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+export declare const CLEAR_ICON_CLASS = "slimfit-with-clear";
+export declare const customClearIcon: import("react/jsx-runtime").JSX.Element;
+export declare const processAllowClear: (allowClear: any) => any;
+export declare function withCustomClearIcon<P extends {
+    allowClear?: any;
+    className?: string;
+}>(Component: React.ComponentType<P>, displayName: string): React.ForwardRefExoticComponent<React.PropsWithoutRef<P> & React.RefAttributes<any>>;