@tiny-codes/react-easy 1.7.4 → 1.7.6

package/es/utils/math.js

@@ -1,21 +1,37 @@
 /**
- * **EN**: Generate a random number within a specified range (inclusive on both ends)
+ * **EN**: Generate a random decimal number between 0 and 1
  *
- * **CN**: 生成指定范围（两端包含）内的随机数
+ * **CN**: 生成一个0~1之间的小数
+ *
+ * @returns The generated random number | 生成的随机数
+ */
+
+/**
+ * **EN**: Generate a random integer within a specified range (inclusive on both ends)
+ *
+ * **CN**: 生成指定范围（两端包含）内的随机整数
  *
  * @param min The minimum value (inclusive) | 最小值（包含）
  * @param max The maximum value (inclusive) | 最大值（包含）
  *
- * @returns The generated random number | 生成的随机数
+ * @returns The generated random integer | 生成的随机整数
  */
+
 export function random(min, max) {
   var _process$versions, _nodeCrypto, _nodeCrypto2;
+  if (min == null && max == null) {
+    return randomLikeMath();
+  }
+  if (min == null || max == null) {
+    throw new TypeError('Both min and max must be provided');
+  }
   if (!Number.isFinite(min) || !Number.isFinite(max)) {
     throw new TypeError('min and max must be finite numbers');
   }
   if (Math.floor(min) !== min || Math.floor(max) !== max) {
     throw new TypeError('min and max must be integers');
   }
+  var globalThat = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : {};
   if (min > max) {
     var _ref = [max, min];
     min = _ref[0];
@@ -29,7 +45,7 @@ export function random(min, max) {
     try {
       // eslint-disable-next-line @typescript-eslint/no-var-requires
       nodeCrypto = require('crypto');
-    } catch (_unused) {
+    } catch (error) {
       // ignore
     }
   }
@@ -41,12 +57,12 @@ export function random(min, max) {
 
   // 2. Web Crypto (Browsers or Node 19+ webcrypto)
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  var webCrypto = globalThis.crypto || ((_nodeCrypto2 = nodeCrypto) === null || _nodeCrypto2 === void 0 ? void 0 : _nodeCrypto2.webcrypto);
+  var webCrypto = globalThat.crypto || ((_nodeCrypto2 = nodeCrypto) === null || _nodeCrypto2 === void 0 ? void 0 : _nodeCrypto2.webcrypto);
   if (webCrypto !== null && webCrypto !== void 0 && webCrypto.getRandomValues) {
     var range = max - min + 1;
     if (range <= 0) return min;
 
-    // 使用拒绝采样避免 (2^32 % range) 造成的微小偏差
+    // Use rejection sampling to avoid the slight bias caused by (2^32 % range).
     var maxUint32 = 0xffffffff;
     var limit = Math.floor((maxUint32 + 1) / range) * range;
     var arr = new Uint32Array(1);
@@ -58,8 +74,45 @@ export function random(min, max) {
     return min + v % range;
   }
 
-  // 3. Fallback, should not be used for cryptographic purposes
-  var _math = Math;
-  return Math.floor(_math.random() * (max - min + 1)) + min;
+  // 3. Fallback
+  return randomLikeMath();
+}
+function randomLikeMath() {
+  var _process$versions2;
+  var globalThat = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : {};
+  // Browser / Node(with webcrypto)
+  var cryptoObj = globalThat.crypto;
+  if (cryptoObj !== null && cryptoObj !== void 0 && cryptoObj.getRandomValues) {
+    var buf = new Uint32Array(2);
+    cryptoObj.getRandomValues(buf);
+
+    // 53-bit precision, mapped to [0, 1)
+    var high = buf[0] >>> 5; // 27 bits
+    var low = buf[1] >>> 6; // 26 bits
+    return (high * 67108864 + low) / 9007199254740992; // 2^53
+  }
+
+  // Old Node fallback (No webcrypto)
+  // Use eval('require') to avoid "require is not defined" error during browser bundling
+  var req = typeof process !== 'undefined' && (_process$versions2 = process.versions) !== null && _process$versions2 !== void 0 && _process$versions2.node && typeof globalThat.require === 'function' ? globalThat.require : function () {
+    try {
+      // eslint-disable-next-line no-eval
+      return eval('require');
+    } catch (error) {
+      return undefined;
+    }
+  }();
+  if (!req) {
+    throw new Error('No secure random source available in this environment');
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-var-requires
+  var nodeCrypto = req('crypto');
+  if (typeof nodeCrypto.randomBytes !== 'function') {
+    throw new Error('No secure random source available in this environment');
+  }
+  var b = nodeCrypto.randomBytes(7); // 56 bits
+  var x = (b[0] & 0x1f) * Math.pow(2, 48) + b[1] * Math.pow(2, 40) + b[2] * Math.pow(2, 32) + b[3] * Math.pow(2, 24) + b[4] * Math.pow(2, 16) + b[5] * Math.pow(2, 8) + b[6];
+  return x / 9007199254740992; // 2^53 => [0,1)
 }
 //# sourceMappingURL=math.js.map

package/es/utils/math.js.map

@@ -1 +1 @@
-{"version":3,"names":["random","min","max","_process$versions","_nodeCrypto","_nodeCrypto2","Number","isFinite","TypeError","Math","floor","_ref","nodeCrypto","process","versions","node","require","_unused","randomInt","webCrypto","globalThis","crypto","webcrypto","getRandomValues","range","maxUint32","limit","arr","Uint32Array","v","_math"],"sources":["../../src/utils/math.ts"],"sourcesContent":["/**\n * **EN**: Generate a random number within a specified range (inclusive on both ends)\n *\n * **CN**: 生成指定范围（两端包含）内的随机数\n *\n * @param min The minimum value (inclusive) | 最小值（包含）\n * @param max The maximum value (inclusive) | 最大值（包含）\n *\n * @returns The generated random number | 生成的随机数\n */\nexport function random(min: number, max: number): number {\n  if (!Number.isFinite(min) || !Number.isFinite(max)) {\n    throw new TypeError('min and max must be finite numbers');\n  }\n  if (Math.floor(min) !== min || Math.floor(max) !== max) {\n    throw new TypeError('min and max must be integers');\n  }\n  if (min > max) {\n    [min, max] = [max, min];\n  }\n\n  // Try to require Node.js crypto\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let nodeCrypto: any;\n  if (typeof process !== 'undefined' && process.versions?.node) {\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      nodeCrypto = require('crypto');\n    } catch {\n      // ignore\n    }\n  }\n\n  // 1. Node.js crypto.randomInt\n  if (nodeCrypto?.randomInt) {\n    return nodeCrypto.randomInt(min, max + 1);\n  }\n\n  // 2. Web Crypto (Browsers or Node 19+ webcrypto)\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const webCrypto: Crypto | undefined = (globalThis as any).crypto || nodeCrypto?.webcrypto;\n\n  if (webCrypto?.getRandomValues) {\n    const range = max - min + 1;\n    if (range <= 0) return min;\n\n    // 使用拒绝采样避免 (2^32 % range) 造成的微小偏差\n    const maxUint32 = 0xffffffff;\n    const limit = Math.floor((maxUint32 + 1) / range) * range;\n    const arr = new Uint32Array(1);\n    let v: number;\n    do {\n      webCrypto.getRandomValues(arr);\n      v = arr[0];\n    } while (v >= limit);\n    return min + (v % range);\n  }\n\n  // 3. Fallback, should not be used for cryptographic purposes\n  const _math = Math;\n  return Math.floor(_math.random() * (max - min + 1)) + min;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,MAAMA,CAACC,GAAW,EAAEC,GAAW,EAAU;EAAA,IAAAC,iBAAA,EAAAC,WAAA,EAAAC,YAAA;EACvD,IAAI,CAACC,MAAM,CAACC,QAAQ,CAACN,GAAG,CAAC,IAAI,CAACK,MAAM,CAACC,QAAQ,CAACL,GAAG,CAAC,EAAE;IAClD,MAAM,IAAIM,SAAS,CAAC,oCAAoC,CAAC;EAC3D;EACA,IAAIC,IAAI,CAACC,KAAK,CAACT,GAAG,CAAC,KAAKA,GAAG,IAAIQ,IAAI,CAACC,KAAK,CAACR,GAAG,CAAC,KAAKA,GAAG,EAAE;IACtD,MAAM,IAAIM,SAAS,CAAC,8BAA8B,CAAC;EACrD;EACA,IAAIP,GAAG,GAAGC,GAAG,EAAE;IAAA,IAAAS,IAAA,GACA,CAACT,GAAG,EAAED,GAAG,CAAC;IAAtBA,GAAG,GAAAU,IAAA;IAAET,GAAG,GAAAS,IAAA;EACX;;EAEA;EACA;EACA,IAAIC,UAAe;EACnB,IAAI,OAAOC,OAAO,KAAK,WAAW,KAAAV,iBAAA,GAAIU,OAAO,CAACC,QAAQ,cAAAX,iBAAA,eAAhBA,iBAAA,CAAkBY,IAAI,EAAE;IAC5D,IAAI;MACF;MACAH,UAAU,GAAGI,OAAO,CAAC,QAAQ,CAAC;IAChC,CAAC,CAAC,OAAAC,OAAA,EAAM;MACN;IAAA;EAEJ;;EAEA;EACA,KAAAb,WAAA,GAAIQ,UAAU,cAAAR,WAAA,eAAVA,WAAA,CAAYc,SAAS,EAAE;IACzB,OAAON,UAAU,CAACM,SAAS,CAACjB,GAAG,EAAEC,GAAG,GAAG,CAAC,CAAC;EAC3C;;EAEA;EACA;EACA,IAAMiB,SAA6B,GAAIC,UAAU,CAASC,MAAM,MAAAhB,YAAA,GAAIO,UAAU,cAAAP,YAAA,uBAAVA,YAAA,CAAYiB,SAAS;EAEzF,IAAIH,SAAS,aAATA,SAAS,eAATA,SAAS,CAAEI,eAAe,EAAE;IAC9B,IAAMC,KAAK,GAAGtB,GAAG,GAAGD,GAAG,GAAG,CAAC;IAC3B,IAAIuB,KAAK,IAAI,CAAC,EAAE,OAAOvB,GAAG;;IAE1B;IACA,IAAMwB,SAAS,GAAG,UAAU;IAC5B,IAAMC,KAAK,GAAGjB,IAAI,CAACC,KAAK,CAAC,CAACe,SAAS,GAAG,CAAC,IAAID,KAAK,CAAC,GAAGA,KAAK;IACzD,IAAMG,GAAG,GAAG,IAAIC,WAAW,CAAC,CAAC,CAAC;IAC9B,IAAIC,CAAS;IACb,GAAG;MACDV,SAAS,CAACI,eAAe,CAACI,GAAG,CAAC;MAC9BE,CAAC,GAAGF,GAAG,CAAC,CAAC,CAAC;IACZ,CAAC,QAAQE,CAAC,IAAIH,KAAK;IACnB,OAAOzB,GAAG,GAAI4B,CAAC,GAAGL,KAAM;EAC1B;;EAEA;EACA,IAAMM,KAAK,GAAGrB,IAAI;EAClB,OAAOA,IAAI,CAACC,KAAK,CAACoB,KAAK,CAAC9B,MAAM,CAAC,CAAC,IAAIE,GAAG,GAAGD,GAAG,GAAG,CAAC,CAAC,CAAC,GAAGA,GAAG;AAC3D"}
+{"version":3,"names":["random","min","max","_process$versions","_nodeCrypto","_nodeCrypto2","randomLikeMath","TypeError","Number","isFinite","Math","floor","globalThat","globalThis","window","global","_ref","nodeCrypto","process","versions","node","require","error","randomInt","webCrypto","crypto","webcrypto","getRandomValues","range","maxUint32","limit","arr","Uint32Array","v","_process$versions2","cryptoObj","buf","high","low","req","eval","undefined","Error","randomBytes","b","x","pow"],"sources":["../../src/utils/math.ts"],"sourcesContent":["/**\n * **EN**: Generate a random decimal number between 0 and 1\n *\n * **CN**: 生成一个0~1之间的小数\n *\n * @returns The generated random number | 生成的随机数\n */\nexport function random(): number;\n/**\n * **EN**: Generate a random integer within a specified range (inclusive on both ends)\n *\n * **CN**: 生成指定范围（两端包含）内的随机整数\n *\n * @param min The minimum value (inclusive) | 最小值（包含）\n * @param max The maximum value (inclusive) | 最大值（包含）\n *\n * @returns The generated random integer | 生成的随机整数\n */\nexport function random(min: number, max: number): number;\nexport function random(min?: number, max?: number): number {\n  if (min == null && max == null) {\n    return randomLikeMath();\n  }\n  if (min == null || max == null) {\n    throw new TypeError('Both min and max must be provided');\n  }\n  if (!Number.isFinite(min) || !Number.isFinite(max)) {\n    throw new TypeError('min and max must be finite numbers');\n  }\n  if (Math.floor(min) !== min || Math.floor(max) !== max) {\n    throw new TypeError('min and max must be integers');\n  }\n  const globalThat =\n    typeof globalThis !== 'undefined'\n      ? globalThis\n      : typeof window !== 'undefined'\n        ? window\n        : typeof global !== 'undefined'\n          ? global\n          : ({} as typeof globalThis);\n  if (min > max) {\n    [min, max] = [max, min];\n  }\n\n  // Try to require Node.js crypto\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let nodeCrypto: any;\n  if (typeof process !== 'undefined' && process.versions?.node) {\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      nodeCrypto = require('crypto');\n    } catch (error) {\n      // ignore\n    }\n  }\n\n  // 1. Node.js crypto.randomInt\n  if (nodeCrypto?.randomInt) {\n    return nodeCrypto.randomInt(min, max + 1);\n  }\n\n  // 2. Web Crypto (Browsers or Node 19+ webcrypto)\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const webCrypto: Crypto | undefined = globalThat.crypto || nodeCrypto?.webcrypto;\n\n  if (webCrypto?.getRandomValues) {\n    const range = max - min + 1;\n    if (range <= 0) return min;\n\n    // Use rejection sampling to avoid the slight bias caused by (2^32 % range).\n    const maxUint32 = 0xffffffff;\n    const limit = Math.floor((maxUint32 + 1) / range) * range;\n    const arr = new Uint32Array(1);\n    let v: number;\n    do {\n      webCrypto.getRandomValues(arr);\n      v = arr[0];\n    } while (v >= limit);\n    return min + (v % range);\n  }\n\n  // 3. Fallback\n  return randomLikeMath();\n}\n\nfunction randomLikeMath(): number {\n  const globalThat =\n    typeof globalThis !== 'undefined'\n      ? globalThis\n      : typeof window !== 'undefined'\n        ? window\n        : typeof global !== 'undefined'\n          ? global\n          : ({} as typeof globalThis);\n  // Browser / Node(with webcrypto)\n  const cryptoObj = globalThat.crypto;\n  if (cryptoObj?.getRandomValues) {\n    const buf = new Uint32Array(2);\n    cryptoObj.getRandomValues(buf);\n\n    // 53-bit precision, mapped to [0, 1)\n    const high = buf[0] >>> 5; // 27 bits\n    const low = buf[1] >>> 6; // 26 bits\n    return (high * 67108864 + low) / 9007199254740992; // 2^53\n  }\n\n  // Old Node fallback (No webcrypto)\n  // Use eval('require') to avoid \"require is not defined\" error during browser bundling\n  const req: NodeRequire | undefined =\n    typeof process !== 'undefined' &&\n    process.versions?.node &&\n    typeof (globalThat as unknown as { require?: unknown }).require === 'function'\n      ? (globalThat as unknown as { require: NodeRequire }).require\n      : (() => {\n          try {\n            // eslint-disable-next-line no-eval\n            return eval('require') as NodeRequire;\n          } catch (error) {\n            return undefined;\n          }\n        })();\n\n  if (!req) {\n    throw new Error('No secure random source available in this environment');\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-var-requires\n  const nodeCrypto = req('crypto') as { randomBytes?: (size: number) => Uint8Array };\n  if (typeof nodeCrypto.randomBytes !== 'function') {\n    throw new Error('No secure random source available in this environment');\n  }\n\n  const b = nodeCrypto.randomBytes(7); // 56 bits\n  const x =\n    (b[0] & 0x1f) * 2 ** 48 + b[1] * 2 ** 40 + b[2] * 2 ** 32 + b[3] * 2 ** 24 + b[4] * 2 ** 16 + b[5] * 2 ** 8 + b[6];\n\n  return x / 9007199254740992; // 2^53 => [0,1)\n}\n"],"mappings":"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"}

package/lib/components/Animation/Pulse/index.d.ts

@@ -1,12 +1,28 @@
 import type { CSSProperties, FC } from 'react';
 export interface PulseAnimationProps {
+    /**
+     * - **EN:** Custom class name for the root element
+     * - **CN:** 根元素的自定义类名
+     */
     className?: string;
+    /**
+     * - **EN:** Custom styles for the root element
+     * - **CN:** 根元素的自定义样式
+     */
     style?: CSSProperties;
+    /**
+     * - **EN:** Custom styles for the pulse bars
+     * - **CN:** 心跳条的自定义样式
+     */
     barStyle?: CSSProperties;
+    /**
+     * - **EN:** Custom prefix for the component's CSS class.
+     * - **CN:** 组件的自定义 CSS 类前缀。
+     */
     prefixCls?: string;
     /**
      * - **EN:** Number of bars, default is `24`
-     * - **CN:** 心跳柱子数量，默认`24`
+     * - **CN:** 心跳条数量，默认`24`
      */
     bars?: number;
     /**
@@ -48,5 +64,5 @@ export interface PulseAnimationProps {
  *
  * > 使用 `token.AnimationPulse` 来全局配置 `barMinSize` 和 `barMaxSize` 属性
  */
-export declare const PulseAnimation: FC<PulseAnimationProps>;
+declare const PulseAnimation: FC<PulseAnimationProps>;
 export default PulseAnimation;

package/lib/components/Animation/Pulse/index.js

@@ -29,7 +29,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/components/Animation/Pulse/index.tsx
 var Pulse_exports = {};
 __export(Pulse_exports, {
-  PulseAnimation: () => PulseAnimation,
   default: () => Pulse_default
 });
 module.exports = __toCommonJS(Pulse_exports);
@@ -81,8 +80,4 @@ var PulseAnimation = (props) => {
   );
 };
 var Pulse_default = PulseAnimation;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  PulseAnimation
-});
 //# sourceMappingURL=index.js.map

package/lib/components/Animation/Pulse/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/components/Animation/Pulse/index.tsx"],
-  "sourcesContent": ["import type { CSSProperties, FC } from 'react';\nimport { useContext, useMemo } from 'react';\nimport { ConfigProvider } from 'antd';\nimport classNames from 'classnames';\nimport useStyle from './style';\n\nexport interface PulseAnimationProps {\n  className?: string;\n  style?: CSSProperties;\n  barStyle?: CSSProperties;\n  prefixCls?: string;\n  /**\n   * - **EN:** Number of bars, default is `24`\n   * - **CN:** 心跳柱子数量，默认`24`\n   */\n\n  bars?: number;\n  /**\n   * - **EN:** Gap between bars, default is `4px`\n   * - **CN:** 心跳柱子间隙，默认`4px`\n   */\n  barGap?: CSSProperties['gap'];\n  /**\n   * - **EN:** Background color of the bars, default is theme's `colorFillSecondary`\n   * - **CN:** 心跳柱子背景色，默认主题的 `colorFillSecondary`\n   */\n  barColor?: CSSProperties['backgroundColor'];\n  /**\n   * - **EN:** Minimum height of the bar, default is `10%`\n   * - **CN:** 心跳柱子最小高度，默认`10%`\n   */\n  // barMinSize?: CSSProperties['height'];\n  /**\n   * - **EN:** Maximum height of the bar, default is `90%`\n   * - **CN:** 心跳柱子最大高度，默认`90%`\n   */\n  // barMaxSize?: CSSProperties['height'];\n  /**\n   * - **EN:** Animation duration in seconds, default is `1.6` seconds\n   * - **CN:** 动画持续时间，单位秒，默认`1.6`秒\n   */\n  duration?: number;\n  /**\n   * - **EN:** Animation delay rate, the delay between bars is calculated based on `{bars *\n   *   delayRate}`, default is `0.09`\n   * - **CN:** 动画延迟的百分比，根据 `{bars * delayRate}` 计算柱子之间的延迟，默认 `0.09`\n   */\n  delayRate?: number;\n}\n\n/**\n * - **EN:** Pulse animation component, used to indicate loading or processing state\n *\n * > Use `token.AnimationPulse` to globally configure `barMinSize` and `barMaxSize` properties\n *\n * - **CN:** 脉动动画组件，用于表示加载或处理状态\n *\n * > 使用 `token.AnimationPulse` 来全局配置 `barMinSize` 和 `barMaxSize` 属性\n */\nexport const PulseAnimation: FC<PulseAnimationProps> = (props) => {\n  const {\n    bars = 8,\n    barGap,\n    barColor,\n    duration,\n    delayRate = 0.09,\n    prefixCls: prefixClsInProps,\n    className,\n    style,\n    barStyle,\n  } = props;\n  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('animation-pulse', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\n  const array = useMemo(() => Array.from({ length: bars }), [bars]);\n\n  return wrapCSSVar(\n    <div\n      className={classNames(prefixCls, hashId, cssVarCls, className)}\n      style={{\n        gridTemplateColumns: `repeat(${array.length}, 1fr)`,\n        gap: barGap,\n        ...style,\n      }}\n    >\n      {array.map((_, i) => (\n        <div\n          // eslint-disable-next-line react/no-array-index-key\n          key={i}\n          className={`${prefixCls}-bar`}\n          style={{\n            animationDuration: duration != null ? `${duration}s` : undefined,\n            animationDelay: `${(i % array.length) * delayRate}s`,\n            backgroundColor: barColor != null ? barColor : undefined,\n            ...barStyle,\n          }}\n        />\n      ))}\n    </div>\n  );\n};\n\nexport default PulseAnimation;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAoC;AACpC,kBAA+B;AAC/B,wBAAuB;AACvB,mBAAqB;AAuDd,IAAM,iBAA0C,CAAC,UAAU;AAChE,QAAM;AAAA,IACJ,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY;AAAA,IACZ,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AACJ,QAAM,EAAE,aAAa,QAAI,yBAAW,2BAAe,aAAa;AAChE,QAAM,YAAY,aAAa,mBAAmB,gBAAgB;AAClE,QAAM,CAAC,YAAY,QAAQ,SAAS,QAAI,aAAAA,SAAS,SAAS;AAC1D,QAAM,YAAQ,sBAAQ,MAAM,MAAM,KAAK,EAAE,QAAQ,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;AAEhE,SAAO;AAAA,IACL;AAAA,MAAC;AAAA;AAAA,QACC,eAAW,kBAAAC,SAAW,WAAW,QAAQ,WAAW,SAAS;AAAA,QAC7D,OAAO;AAAA,UACL,qBAAqB,UAAU,MAAM;AAAA,UACrC,KAAK;AAAA,UACL,GAAG;AAAA,QACL;AAAA;AAAA,MAEC,MAAM,IAAI,CAAC,GAAG,MACb;AAAA,QAAC;AAAA;AAAA,UAEC,KAAK;AAAA,UACL,WAAW,GAAG;AAAA,UACd,OAAO;AAAA,YACL,mBAAmB,YAAY,OAAO,GAAG,cAAc;AAAA,YACvD,gBAAgB,GAAI,IAAI,MAAM,SAAU;AAAA,YACxC,iBAAiB,YAAY,OAAO,WAAW;AAAA,YAC/C,GAAG;AAAA,UACL;AAAA;AAAA,MACF,CACD;AAAA,IACH;AAAA,EACF;AACF;AAEA,IAAO,gBAAQ;",
+  "sourcesContent": ["import type { CSSProperties, FC } from 'react';\nimport { useContext, useMemo } from 'react';\nimport { ConfigProvider } from 'antd';\nimport classNames from 'classnames';\nimport useStyle from './style';\n\nexport interface PulseAnimationProps {\n  /**\n   * - **EN:** Custom class name for the root element\n   * - **CN:** 根元素的自定义类名\n   */\n  className?: string;\n  /**\n   * - **EN:** Custom styles for the root element\n   * - **CN:** 根元素的自定义样式\n   */\n  style?: CSSProperties;\n  /**\n   * - **EN:** Custom styles for the pulse bars\n   * - **CN:** 心跳条的自定义样式\n   */\n  barStyle?: CSSProperties;\n  /**\n   * - **EN:** Custom prefix for the component's CSS class.\n   * - **CN:** 组件的自定义 CSS 类前缀。\n   */\n  prefixCls?: string;\n  /**\n   * - **EN:** Number of bars, default is `24`\n   * - **CN:** 心跳条数量，默认`24`\n   */\n\n  bars?: number;\n  /**\n   * - **EN:** Gap between bars, default is `4px`\n   * - **CN:** 心跳柱子间隙，默认`4px`\n   */\n  barGap?: CSSProperties['gap'];\n  /**\n   * - **EN:** Background color of the bars, default is theme's `colorFillSecondary`\n   * - **CN:** 心跳柱子背景色，默认主题的 `colorFillSecondary`\n   */\n  barColor?: CSSProperties['backgroundColor'];\n  /**\n   * - **EN:** Minimum height of the bar, default is `10%`\n   * - **CN:** 心跳柱子最小高度，默认`10%`\n   */\n  // barMinSize?: CSSProperties['height'];\n  /**\n   * - **EN:** Maximum height of the bar, default is `90%`\n   * - **CN:** 心跳柱子最大高度，默认`90%`\n   */\n  // barMaxSize?: CSSProperties['height'];\n  /**\n   * - **EN:** Animation duration in seconds, default is `1.6` seconds\n   * - **CN:** 动画持续时间，单位秒，默认`1.6`秒\n   */\n  duration?: number;\n  /**\n   * - **EN:** Animation delay rate, the delay between bars is calculated based on `{bars *\n   *   delayRate}`, default is `0.09`\n   * - **CN:** 动画延迟的百分比，根据 `{bars * delayRate}` 计算柱子之间的延迟，默认 `0.09`\n   */\n  delayRate?: number;\n}\n\n/**\n * - **EN:** Pulse animation component, used to indicate loading or processing state\n *\n * > Use `token.AnimationPulse` to globally configure `barMinSize` and `barMaxSize` properties\n *\n * - **CN:** 脉动动画组件，用于表示加载或处理状态\n *\n * > 使用 `token.AnimationPulse` 来全局配置 `barMinSize` 和 `barMaxSize` 属性\n */\nconst PulseAnimation: FC<PulseAnimationProps> = (props) => {\n  const {\n    bars = 8,\n    barGap,\n    barColor,\n    duration,\n    delayRate = 0.09,\n    prefixCls: prefixClsInProps,\n    className,\n    style,\n    barStyle,\n  } = props;\n  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('animation-pulse', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\n  const array = useMemo(() => Array.from({ length: bars }), [bars]);\n\n  return wrapCSSVar(\n    <div\n      className={classNames(prefixCls, hashId, cssVarCls, className)}\n      style={{\n        gridTemplateColumns: `repeat(${array.length}, 1fr)`,\n        gap: barGap,\n        ...style,\n      }}\n    >\n      {array.map((_, i) => (\n        <div\n          // eslint-disable-next-line react/no-array-index-key\n          key={i}\n          className={`${prefixCls}-bar`}\n          style={{\n            animationDuration: duration != null ? `${duration}s` : undefined,\n            animationDelay: `${(i % array.length) * delayRate}s`,\n            backgroundColor: barColor != null ? barColor : undefined,\n            ...barStyle,\n          }}\n        />\n      ))}\n    </div>\n  );\n};\n\nexport default PulseAnimation;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAoC;AACpC,kBAA+B;AAC/B,wBAAuB;AACvB,mBAAqB;AAuErB,IAAM,iBAA0C,CAAC,UAAU;AACzD,QAAM;AAAA,IACJ,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY;AAAA,IACZ,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AACJ,QAAM,EAAE,aAAa,QAAI,yBAAW,2BAAe,aAAa;AAChE,QAAM,YAAY,aAAa,mBAAmB,gBAAgB;AAClE,QAAM,CAAC,YAAY,QAAQ,SAAS,QAAI,aAAAA,SAAS,SAAS;AAC1D,QAAM,YAAQ,sBAAQ,MAAM,MAAM,KAAK,EAAE,QAAQ,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;AAEhE,SAAO;AAAA,IACL;AAAA,MAAC;AAAA;AAAA,QACC,eAAW,kBAAAC,SAAW,WAAW,QAAQ,WAAW,SAAS;AAAA,QAC7D,OAAO;AAAA,UACL,qBAAqB,UAAU,MAAM;AAAA,UACrC,KAAK;AAAA,UACL,GAAG;AAAA,QACL;AAAA;AAAA,MAEC,MAAM,IAAI,CAAC,GAAG,MACb;AAAA,QAAC;AAAA;AAAA,UAEC,KAAK;AAAA,UACL,WAAW,GAAG;AAAA,UACd,OAAO;AAAA,YACL,mBAAmB,YAAY,OAAO,GAAG,cAAc;AAAA,YACvD,gBAAgB,GAAI,IAAI,MAAM,SAAU;AAAA,YACxC,iBAAiB,YAAY,OAAO,WAAW;AAAA,YAC/C,GAAG;AAAA,UACL;AAAA;AAAA,MACF,CACD;AAAA,IACH;AAAA,EACF;AACF;AAEA,IAAO,gBAAQ;",
   "names": ["useStyle", "classNames"]
 }

package/lib/components/BreakLines/index.d.ts

@@ -6,26 +6,26 @@ export interface BreakLinesProps {
      */
     value: string | undefined;
     /**
-     * - **EN:** Whether to enable line breaking
-     * - **CN:** 是否启用换行功能
+     * - **EN:** Whether the line break conversion is enabled
+     * - **CN:** 是否启用换行转换
      *
      * @default true
      */
     enabled?: boolean;
     /**
-     * - **EN:** Line break character
-     * - **CN:** 换行符
+     * - **EN:** The end-of-line character to use for splitting lines
+     * - **CN:** 用于分割行的行结束字符
      *
      * @default '\n'
      */
     EOL?: string;
     /**
-     * - **CN:** 渲染dom节点的标签名
-     * - **EN:** Render the tag name of the DOM node
+     * - **EN:** The HTML tag to use for rendering the content
+     * - **CN:** 用于渲染内容的 HTML 标签
      *
      * @default false
      */
-    tagName?: 'span' | 'div' | 'i' | 'pre' | (string & {}) | false;
+    tagName?: false | 'span' | 'div' | 'i' | 'pre' | (string & {});
     /**
      * - **EN:** The CSS class name of the dom node, if `tagName` is set to false, this property is
      *   invalid

package/lib/components/BreakLines/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/components/BreakLines/index.tsx"],
-  "sourcesContent": ["import { createElement, type FC, Fragment, type ReactNode } from 'react';\n\nexport interface BreakLinesProps {\n  /**\n   * - **EN:** Text content\n   * - **CN:** 文本内容\n   */\n  value: string | undefined;\n  /**\n   * - **EN:** Whether to enable line breaking\n   * - **CN:** 是否启用换行功能\n   *\n   * @default true\n   */\n  enabled?: boolean;\n  /**\n   * - **EN:** Line break character\n   * - **CN:** 换行符\n   *\n   * @default '\\n'\n   */\n  EOL?: string;\n  /**\n   * - **CN:** 渲染dom节点的标签名\n   * - **EN:** Render the tag name of the DOM node\n   *\n   * @default false\n   */\n  // eslint-disable-next-line @typescript-eslint/ban-types\n  tagName?: 'span' | 'div' | 'i' | 'pre' | (string & {}) | false;\n  /**\n   * - **EN:** The CSS class name of the dom node, if `tagName` is set to false, this property is\n   *   invalid\n   * - **CN:** dom节点的css类名，如果`tagName`设置为false，则此属性无效\n   */\n  className?: string;\n}\n\n/**\n * - **EN:** Output a piece of text, keeping line breaks\n * - **CN:** 输出一段文本，保留换行符\n *\n * @example\n *   <BreakLines value=\"hello \\n world\" />;\n *   // hello <br/> world\n */\nconst BreakLines: FC<BreakLinesProps> = (props) => {\n  const { value, className, tagName = false, enabled = true, EOL = '\\n' } = props;\n\n  let content: ReactNode;\n  if (value) {\n    if (enabled) {\n      if (value.includes(EOL)) {\n        const segments = value?.split(EOL);\n        content = segments.map((str, i) => (\n          // eslint-disable-next-line react/no-array-index-key\n          <Fragment key={`${str}:${i}`}>\n            {str}\n            {i !== segments.length - 1 && <br />}\n          </Fragment>\n        ));\n      } else {\n        content = value;\n      }\n    } else {\n      content = value;\n    }\n  } else {\n    content = value;\n  }\n\n  if (tagName) {\n    return createElement(tagName, { className }, content);\n  } else {\n    return <>{content}</>;\n  }\n};\n\nexport default BreakLines;\n"],
+  "sourcesContent": ["import { createElement, type FC, Fragment, type ReactNode } from 'react';\n\nexport interface BreakLinesProps {\n  /**\n   * - **EN:** Text content\n   * - **CN:** 文本内容\n   */\n  value: string | undefined;\n  /**\n   * - **EN:** Whether the line break conversion is enabled\n   * - **CN:** 是否启用换行转换\n   *\n   * @default true\n   */\n  enabled?: boolean;\n  /**\n   * - **EN:** The end-of-line character to use for splitting lines\n   * - **CN:** 用于分割行的行结束字符\n   *\n   * @default '\\n'\n   */\n  EOL?: string;\n  /**\n   * - **EN:** The HTML tag to use for rendering the content\n   * - **CN:** 用于渲染内容的 HTML 标签\n   *\n   * @default false\n   */\n  // eslint-disable-next-line @typescript-eslint/ban-types\n  tagName?: false | 'span' | 'div' | 'i' | 'pre' | (string & {});\n  /**\n   * - **EN:** The CSS class name of the dom node, if `tagName` is set to false, this property is\n   *   invalid\n   * - **CN:** dom节点的css类名，如果`tagName`设置为false，则此属性无效\n   */\n  className?: string;\n}\n\n/**\n * - **EN:** Output a piece of text, keeping line breaks\n * - **CN:** 输出一段文本，保留换行符\n *\n * @example\n *   <BreakLines value=\"hello \\n world\" />;\n *   // hello <br/> world\n */\nconst BreakLines: FC<BreakLinesProps> = (props) => {\n  const { value, className, tagName = false, enabled = true, EOL = '\\n' } = props;\n\n  let content: ReactNode;\n  if (value) {\n    if (enabled) {\n      if (value.includes(EOL)) {\n        const segments = value?.split(EOL);\n        content = segments.map((str, i) => (\n          // eslint-disable-next-line react/no-array-index-key\n          <Fragment key={`${str}:${i}`}>\n            {str}\n            {i !== segments.length - 1 && <br />}\n          </Fragment>\n        ));\n      } else {\n        content = value;\n      }\n    } else {\n      content = value;\n    }\n  } else {\n    content = value;\n  }\n\n  if (tagName) {\n    return createElement(tagName, { className }, content);\n  } else {\n    return <>{content}</>;\n  }\n};\n\nexport default BreakLines;\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAiE;AA8CjE,IAAM,aAAkC,CAAC,UAAU;AACjD,QAAM,EAAE,OAAO,WAAW,UAAU,OAAO,UAAU,MAAM,MAAM,KAAK,IAAI;AAE1E,MAAI;AACJ,MAAI,OAAO;AACT,QAAI,SAAS;AACX,UAAI,MAAM,SAAS,GAAG,GAAG;AACvB,cAAM,WAAW,+BAAO,MAAM;AAC9B,kBAAU,SAAS,IAAI,CAAC,KAAK;AAAA;AAAA,UAE3B,oCAAC,yBAAS,KAAK,GAAG,OAAO,OACtB,KACA,MAAM,SAAS,SAAS,KAAK,oCAAC,UAAG,CACpC;AAAA,SACD;AAAA,MACH,OAAO;AACL,kBAAU;AAAA,MACZ;AAAA,IACF,OAAO;AACL,gBAAU;AAAA,IACZ;AAAA,EACF,OAAO;AACL,cAAU;AAAA,EACZ;AAEA,MAAI,SAAS;AACX,eAAO,4BAAc,SAAS,EAAE,UAAU,GAAG,OAAO;AAAA,EACtD,OAAO;AACL,WAAO,0DAAG,OAAQ;AAAA,EACpB;AACF;AAEA,IAAO,qBAAQ;",
   "names": []
 }

package/lib/components/ColumnSetting/index.d.ts

@@ -13,8 +13,9 @@ export interface ColumnSettingProps<T extends ColumnSettingItem = ColumnSettingI
      */
     onChange?: (nextColumns: T[]) => void;
     /**
-     * - **EN:** Local storage key for persisting column settings.
-     * - **CN:** 用于持久化列设置的本地存储键。
+     * - **EN:** Set a local storage key for persisting column settings. If not set, local storage is
+     *   not enabled.
+     * - **CN:** 设置一个本地存储的键值，用于持久化保存列设置。如果未设置，则不启用本地存储。
      */
     storageKey?: string;
     /**
@@ -47,6 +48,10 @@ export interface ColumnSettingProps<T extends ColumnSettingItem = ColumnSettingI
      * - **CN:** “重置”按钮的属性。
      */
     resetProps?: ButtonProps;
+    /**
+     * - **EN:** Custom prefix for the component's CSS class.
+     * - **CN:** 组件的自定义 CSS 类前缀。
+     */
     prefixCls?: string;
 }
 /**

package/lib/components/ColumnSetting/index.js

@@ -35,9 +35,9 @@ module.exports = __toCommonJS(ColumnSetting_exports);
 var import_react = require("react");
 var import_antd = require("antd");
 var import_classnames = __toESM(require("classnames"));
-var import_react_use = require("react-use");
 var import_icons = require("@ant-design/icons");
 var import_hooks = require("../../hooks");
+var import_useLocalStorage = __toESM(require("../../hooks/useLocalStorage"));
 var import_useT = __toESM(require("../../hooks/useT"));
 var import_style = __toESM(require("./style"));
 function ColumnSetting(props) {
@@ -56,19 +56,16 @@ function ColumnSetting(props) {
   const { getPrefixCls } = (0, import_react.useContext)(import_antd.ConfigProvider.ConfigContext);
   const prefixCls = getPrefixCls("column-setting", prefixClsInProps);
   const [wrapCSSVar, hashId, cssVarCls] = (0, import_style.default)(prefixCls);
-  const initialSelectedRef = (0, import_react.useRef)(normalizeToSelectedKeys(columns));
   const [open, setOpen] = (0, import_react.useState)(false);
-  const [selectedKeys, setSelectedKeys] = (0, import_react.useState)(initialSelectedRef.current);
   const t = (0, import_useT.default)();
-  const [selectedKeysFromStorage, setSelectedKeysFromStorage] = (0, import_react_use.useLocalStorage)(
-    storageKey ?? "",
-    initialSelectedRef.current
-  );
+  const [selectedKeysFromStorage, setSelectedKeysFromStorage] = (0, import_useLocalStorage.default)(storageKey, []);
+  const [initialKeys, setInitialKeys] = (0, import_react.useState)(selectedKeysFromStorage ?? []);
+  const [selectedKeys, setSelectedKeys] = (0, import_react.useState)(initialKeys);
   const storageRef = (0, import_hooks.useRefValue)(storageKey);
   const selectedKeysFromStorageRef = (0, import_hooks.useRefValue)(selectedKeysFromStorage);
   const hasChange = (0, import_react.useMemo)(() => {
-    return [...selectedKeys].sort().join(",") !== initialSelectedRef.current.join(",");
-  }, [selectedKeys]);
+    return [...selectedKeys].sort().join(",") !== initialKeys.join(",");
+  }, [selectedKeys, initialKeys]);
   const keys = (0, import_react.useMemo)(() => columns.map((c, i) => String(getColKey(c, i))), [columns]);
   const allSelectableKeys = (0, import_react.useMemo)(
     () => columns.map((c, i) => ({ k: String(getColKey(c, i)), disabled: !!c.disabled })).filter((x) => !x.disabled).map((x) => x.k),
@@ -108,19 +105,26 @@ function ColumnSetting(props) {
     change(ensured, true);
   };
   const handleReset = () => {
-    const next = initialSelectedRef.current.length > 0 ? initialSelectedRef.current : [keys[0]];
+    const next = initialKeys.length > 0 ? initialKeys : [keys[0]];
     change(next, true);
   };
+  const handleOpenChange = (nextOpen) => {
+    setOpen(nextOpen);
+    if (nextOpen) {
+      setInitialKeys(normalizeToSelectedKeys(columns));
+    } else {
+      setInitialKeys([]);
+    }
+  };
   (0, import_react.useEffect)(() => {
     const next = normalizeToSelectedKeys(columns);
-    initialSelectedRef.current = next;
     change(next, false);
   }, [columns]);
   (0, import_react.useEffect)(() => {
-    if (storageRef.current && selectedKeysFromStorageRef.current && selectedKeysFromStorageRef.current.join(",") !== initialSelectedRef.current.join(",")) {
+    if (storageRef.current && selectedKeysFromStorageRef.current && selectedKeysFromStorageRef.current.join(",") !== initialKeys.join(",")) {
       change(selectedKeysFromStorageRef.current, true);
     }
-  }, []);
+  }, [initialKeys]);
   const dropdownRender = () => /* @__PURE__ */ React.createElement(
     "div",
     {
@@ -188,7 +192,7 @@ function ColumnSetting(props) {
       import_antd.Dropdown,
       {
         open,
-        onOpenChange: setOpen,
+        onOpenChange: handleOpenChange,
         trigger: ["click"],
         dropdownRender,
         popupRender: dropdownRender,

package/lib/components/ColumnSetting/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/components/ColumnSetting/index.tsx"],
-  "sourcesContent": ["import { useContext, useEffect, useMemo, useRef, useState } from 'react';\nimport { Button, Checkbox, ConfigProvider, Divider, Dropdown, Space, Typography } from 'antd';\nimport type { ButtonProps, DropdownProps } from 'antd';\nimport type { ColumnType } from 'antd/es/table';\nimport classNames from 'classnames';\nimport { useLocalStorage } from 'react-use';\nimport { ReloadOutlined, SettingOutlined } from '@ant-design/icons';\nimport { useRefFunction, useRefValue } from '../../hooks';\nimport useT from '../../hooks/useT';\nimport useStyle from './style';\n\nexport interface ColumnSettingProps<T extends ColumnSettingItem = ColumnSettingItem> {\n  /**\n   * - **EN:** The columns to be displayed in the column setting.\n   * - **CN:** 列设置中要显示的列。\n   */\n  columns: T[];\n  /**\n   * - **EN:** Callback function triggered when the selected columns change.\n   * - **CN:** 选中列变化时触发的回调函数。\n   */\n  onChange?: (nextColumns: T[]) => void;\n  /**\n   * - **EN:** Local storage key for persisting column settings.\n   * - **CN:** 用于持久化列设置的本地存储键。\n   */\n  storageKey?: string;\n  /**\n   * - **EN:** Function to render custom column titles.\n   * - **CN:** 自定义列标题的渲染函数。\n   */\n  renderColumnTitle?: (col: ColumnSettingItem, index: number) => React.ReactNode;\n  /**\n   * - **EN:** Props for the button that triggers the dropdown.\n   * - **CN:** 触发下拉菜单的按钮属性。\n   */\n  triggerProps?: ButtonProps;\n  /**\n   * - **EN:** Props for the dropdown component.\n   * - **CN:** 下拉菜单组件的属性。\n   */\n  dropdownProps?: DropdownProps;\n  /**\n   * - **EN:** Props for the dropdown popup container.\n   * - **CN:** 下拉菜单弹出层容器的属性。\n   */\n  popupProps?: React.HTMLAttributes<HTMLDivElement>;\n  /**\n   * - **EN:** Props for the \"Check All\" button.\n   * - **CN:** “全选”按钮的属性。\n   */\n  checkAllProps?: ButtonProps;\n  /**\n   * - **EN:** Props for the \"Reset\" button.\n   * - **CN:** “重置”按钮的属性。\n   */\n  resetProps?: ButtonProps;\n  prefixCls?: string;\n}\n\n/**\n * - **EN:** A component for configuring table column visibility.\n * - **CN:** 用于配置表格列可见性的组件。\n */\nfunction ColumnSetting<T extends ColumnSettingItem = ColumnSettingItem>(props: ColumnSettingProps<T>) {\n  const {\n    columns,\n    storageKey,\n    triggerProps,\n    dropdownProps,\n    popupProps,\n    prefixCls: prefixClsInProps,\n    checkAllProps,\n    resetProps,\n    onChange,\n    renderColumnTitle,\n  } = props;\n  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('column-setting', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\n  const initialSelectedRef = useRef<string[]>(normalizeToSelectedKeys(columns));\n  const [open, setOpen] = useState(false);\n  const [selectedKeys, setSelectedKeys] = useState<string[]>(initialSelectedRef.current);\n  const t = useT();\n  const [selectedKeysFromStorage, setSelectedKeysFromStorage] = useLocalStorage<string[]>(\n    storageKey ?? '',\n    initialSelectedRef.current\n  );\n  const storageRef = useRefValue(storageKey);\n  const selectedKeysFromStorageRef = useRefValue(selectedKeysFromStorage);\n  const hasChange = useMemo(() => {\n    return [...selectedKeys].sort().join(',') !== initialSelectedRef.current.join(',');\n  }, [selectedKeys]);\n\n  // Compute keys and selectable keys\n  const keys = useMemo(() => columns.map((c, i) => String(getColKey(c, i))), [columns]);\n  const allSelectableKeys = useMemo(\n    () =>\n      columns\n        .map((c, i) => ({ k: String(getColKey(c, i)), disabled: !!c.disabled }))\n        .filter((x) => !x.disabled)\n        .map((x) => x.k),\n    [columns]\n  );\n  const isAllChecked = allSelectableKeys.length > 0 && allSelectableKeys.every((k) => selectedKeys.includes(k));\n  const isIndeterminate = selectedKeys.length > 0 && !isAllChecked;\n\n  // Fire change event when selectedKeysFromStorage changes\n  const change = useRefFunction((nextSelected: string[], fireEvent?: boolean) => {\n    setSelectedKeys(nextSelected);\n    if (storageKey) {\n      setSelectedKeysFromStorage(nextSelected);\n    }\n    if (fireEvent) {\n      const next = columns.map((col, i) => {\n        const k = String(getColKey(col, i));\n        const visible = nextSelected.includes(k);\n        return { ...col, hidden: !visible } as T;\n      });\n      onChange?.(next as T[]);\n    }\n  });\n\n  // Toggle one column change\n  const toggleOne = (key: string, checked: boolean) => {\n    const next = new Set(selectedKeys);\n    if (checked) {\n      next.add(key);\n    } else {\n      // Keep at least one visible column\n      if (selectedKeys.length <= 1) return;\n      next.delete(key);\n    }\n    const nextArr = Array.from(next);\n    change(nextArr, true);\n  };\n\n  // Toggle all columns change\n  const handleCheckAll = (checked: boolean) => {\n    const nextArr = checked\n      ? Array.from(new Set([...selectedKeys, ...allSelectableKeys]))\n      : selectedKeys.filter((k) => !allSelectableKeys.includes(k)).slice(0, 1);\n    const ensured = checked ? nextArr : nextArr.length > 0 ? nextArr : [keys[0]];\n    change(ensured, true);\n  };\n\n  // Reset to initial selected columns\n  const handleReset = () => {\n    const next = initialSelectedRef.current.length > 0 ? initialSelectedRef.current : [keys[0]];\n    change(next, true);\n  };\n\n  // Sync when columns change\n  useEffect(() => {\n    const next = normalizeToSelectedKeys(columns);\n    initialSelectedRef.current = next;\n    change(next, false);\n  }, [columns]);\n\n  // Fire change on mount if storage exists and differs from initial values\n  useEffect(() => {\n    if (\n      storageRef.current &&\n      selectedKeysFromStorageRef.current &&\n      selectedKeysFromStorageRef.current.join(',') !== initialSelectedRef.current.join(',')\n    ) {\n      change(selectedKeysFromStorageRef.current, true);\n    }\n  }, []);\n\n  const dropdownRender = () => (\n    <div\n      {...popupProps}\n      className={classNames(`${prefixCls}-popup`, popupProps?.className)}\n      onClick={(e) => {\n        e.stopPropagation();\n        popupProps?.onClick?.(e);\n      }}\n    >\n      <Typography.Text className={`${prefixCls}-popup-title`}>{t('components.ColumnSetting.title')}</Typography.Text>\n      <Space direction=\"vertical\" className={`${prefixCls}-column-list`} size={12}>\n        {columns.map((col, idx) => {\n          const k = String(getColKey(col, idx));\n          const label = col.title ?? col.dataIndex ?? k;\n          const checked = selectedKeys.includes(k);\n          const disabled = !!col.disabled;\n          const disableUncheck = !disabled && checked && selectedKeys.length <= 1; // 禁止取消最后一个\n          return (\n            <Checkbox\n              key={k}\n              className={`${prefixCls}-column-item`}\n              disabled={disabled || disableUncheck}\n              checked={checked}\n              onChange={(e) => toggleOne(k, e.target.checked)}\n            >\n              <span className={`${prefixCls}-column-item-title`}>{renderColumnTitle?.(col, idx) ?? label}</span>\n            </Checkbox>\n          );\n        })}\n      </Space>\n      <Divider className={`${prefixCls}-divider`} />\n      <div className={`${prefixCls}-footer`}>\n        <Button\n          type=\"text\"\n          {...checkAllProps}\n          className={classNames(`${prefixCls}-select-all`, checkAllProps?.className)}\n          onClick={(e) => {\n            handleCheckAll(!isAllChecked);\n            checkAllProps?.onClick?.(e);\n          }}\n        >\n          <Checkbox checked={isAllChecked} indeterminate={isIndeterminate}></Checkbox>\n          {t('components.ColumnSetting.selectAll')}\n        </Button>\n        <Button\n          type=\"text\"\n          icon={<ReloadOutlined />}\n          disabled={!hasChange}\n          {...resetProps}\n          className={classNames(`${prefixCls}-reset`, resetProps?.className)}\n          onClick={(e) => {\n            handleReset();\n            resetProps?.onClick?.(e);\n          }}\n        >\n          {t('components.ColumnSetting.reset')}\n        </Button>\n      </div>\n    </div>\n  );\n\n  return wrapCSSVar(\n    <Dropdown\n      open={open}\n      onOpenChange={setOpen}\n      trigger={['click']}\n      dropdownRender={dropdownRender}\n      popupRender={dropdownRender}\n      placement=\"bottomRight\"\n      {...dropdownProps}\n      rootClassName={classNames(hashId, cssVarCls, prefixCls, `${prefixCls}-dropdown`, dropdownProps?.className)}\n    >\n      <Button\n        icon={<SettingOutlined />}\n        {...triggerProps}\n        className={classNames(hashId, cssVarCls, prefixCls, `${prefixCls}-trigger`, triggerProps?.className)}\n      />\n    </Dropdown>\n  );\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface ColumnSettingItem<T = any> extends ColumnType<T> {\n  /**\n   * - **EN:** Disable toggling visibility for this column.\n   * - **CN:** 禁止切换此列的可见性。\n   */\n  disabled?: boolean;\n}\n\nfunction getColKey(col: ColumnType, idx: number): React.Key {\n  return col.key ?? (col.dataIndex as string) ?? idx;\n}\n\nfunction normalizeToSelectedKeys(cols: ColumnType[]): string[] {\n  return cols\n    .map((c, i) => ({ key: String(getColKey(c, i)), hidden: !!c.hidden }))\n    .filter((c) => !c.hidden)\n    .map((c) => c.key)\n    .sort();\n}\n\nexport default ColumnSetting;\n"],
-  "mappings": "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",
-  "names": ["useStyle", "useT", "classNames"]
+  "sourcesContent": ["import { useContext, useEffect, useMemo, useState } from 'react';\nimport { Button, Checkbox, ConfigProvider, Divider, Dropdown, Space, Typography } from 'antd';\nimport type { ButtonProps, DropdownProps } from 'antd';\nimport type { ColumnType } from 'antd/es/table';\nimport classNames from 'classnames';\nimport { ReloadOutlined, SettingOutlined } from '@ant-design/icons';\nimport { useRefFunction, useRefValue } from '../../hooks';\nimport useLocalStorage from '../../hooks/useLocalStorage';\nimport useT from '../../hooks/useT';\nimport useStyle from './style';\n\nexport interface ColumnSettingProps<T extends ColumnSettingItem = ColumnSettingItem> {\n  /**\n   * - **EN:** The columns to be displayed in the column setting.\n   * - **CN:** 列设置中要显示的列。\n   */\n  columns: T[];\n  /**\n   * - **EN:** Callback function triggered when the selected columns change.\n   * - **CN:** 选中列变化时触发的回调函数。\n   */\n  onChange?: (nextColumns: T[]) => void;\n  /**\n   * - **EN:** Set a local storage key for persisting column settings. If not set, local storage is\n   *   not enabled.\n   * - **CN:** 设置一个本地存储的键值，用于持久化保存列设置。如果未设置，则不启用本地存储。\n   */\n  storageKey?: string;\n  /**\n   * - **EN:** Function to render custom column titles.\n   * - **CN:** 自定义列标题的渲染函数。\n   */\n  renderColumnTitle?: (col: ColumnSettingItem, index: number) => React.ReactNode;\n  /**\n   * - **EN:** Props for the button that triggers the dropdown.\n   * - **CN:** 触发下拉菜单的按钮属性。\n   */\n  triggerProps?: ButtonProps;\n  /**\n   * - **EN:** Props for the dropdown component.\n   * - **CN:** 下拉菜单组件的属性。\n   */\n  dropdownProps?: DropdownProps;\n  /**\n   * - **EN:** Props for the dropdown popup container.\n   * - **CN:** 下拉菜单弹出层容器的属性。\n   */\n  popupProps?: React.HTMLAttributes<HTMLDivElement>;\n  /**\n   * - **EN:** Props for the \"Check All\" button.\n   * - **CN:** “全选”按钮的属性。\n   */\n  checkAllProps?: ButtonProps;\n  /**\n   * - **EN:** Props for the \"Reset\" button.\n   * - **CN:** “重置”按钮的属性。\n   */\n  resetProps?: ButtonProps;\n  /**\n   * - **EN:** Custom prefix for the component's CSS class.\n   * - **CN:** 组件的自定义 CSS 类前缀。\n   */\n  prefixCls?: string;\n}\n\n/**\n * - **EN:** A component for configuring table column visibility.\n * - **CN:** 用于配置表格列可见性的组件。\n */\nfunction ColumnSetting<T extends ColumnSettingItem = ColumnSettingItem>(props: ColumnSettingProps<T>) {\n  const {\n    columns,\n    storageKey,\n    triggerProps,\n    dropdownProps,\n    popupProps,\n    prefixCls: prefixClsInProps,\n    checkAllProps,\n    resetProps,\n    onChange,\n    renderColumnTitle,\n  } = props;\n  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('column-setting', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\n  const [open, setOpen] = useState(false);\n  const t = useT();\n  const [selectedKeysFromStorage, setSelectedKeysFromStorage] = useLocalStorage<string[]>(storageKey, []);\n  const [initialKeys, setInitialKeys] = useState<string[]>(selectedKeysFromStorage ?? []);\n  const [selectedKeys, setSelectedKeys] = useState<string[]>(initialKeys);\n  const storageRef = useRefValue(storageKey);\n  const selectedKeysFromStorageRef = useRefValue(selectedKeysFromStorage);\n  const hasChange = useMemo(() => {\n    return [...selectedKeys].sort().join(',') !== initialKeys.join(',');\n  }, [selectedKeys, initialKeys]);\n\n  // Compute keys and selectable keys\n  const keys = useMemo(() => columns.map((c, i) => String(getColKey(c, i))), [columns]);\n  const allSelectableKeys = useMemo(\n    () =>\n      columns\n        .map((c, i) => ({ k: String(getColKey(c, i)), disabled: !!c.disabled }))\n        .filter((x) => !x.disabled)\n        .map((x) => x.k),\n    [columns]\n  );\n  const isAllChecked = allSelectableKeys.length > 0 && allSelectableKeys.every((k) => selectedKeys.includes(k));\n  const isIndeterminate = selectedKeys.length > 0 && !isAllChecked;\n\n  // Fire change event when selectedKeysFromStorage changes\n  const change = useRefFunction((nextSelected: string[], fireEvent?: boolean) => {\n    setSelectedKeys(nextSelected);\n    if (storageKey) {\n      setSelectedKeysFromStorage(nextSelected);\n    }\n    if (fireEvent) {\n      const next = columns.map((col, i) => {\n        const k = String(getColKey(col, i));\n        const visible = nextSelected.includes(k);\n        return { ...col, hidden: !visible } as T;\n      });\n      onChange?.(next as T[]);\n    }\n  });\n\n  // Toggle one column change\n  const toggleOne = (key: string, checked: boolean) => {\n    const next = new Set(selectedKeys);\n    if (checked) {\n      next.add(key);\n    } else {\n      // Keep at least one visible column\n      if (selectedKeys.length <= 1) return;\n      next.delete(key);\n    }\n    const nextArr = Array.from(next);\n    change(nextArr, true);\n  };\n\n  // Toggle all columns change\n  const handleCheckAll = (checked: boolean) => {\n    const nextArr = checked\n      ? Array.from(new Set([...selectedKeys, ...allSelectableKeys]))\n      : selectedKeys.filter((k) => !allSelectableKeys.includes(k)).slice(0, 1);\n    const ensured = checked ? nextArr : nextArr.length > 0 ? nextArr : [keys[0]];\n    change(ensured, true);\n  };\n\n  // Reset to initial selected columns\n  const handleReset = () => {\n    const next = initialKeys.length > 0 ? initialKeys : [keys[0]];\n    change(next, true);\n  };\n\n  const handleOpenChange = (nextOpen: boolean) => {\n    setOpen(nextOpen);\n    if (nextOpen) {\n      setInitialKeys(normalizeToSelectedKeys(columns));\n    } else {\n      setInitialKeys([]);\n    }\n  };\n\n  // Sync when columns change\n  useEffect(() => {\n    const next = normalizeToSelectedKeys(columns);\n    change(next, false);\n  }, [columns]);\n\n  // Fire change on mount if storage exists and differs from initial values\n  useEffect(() => {\n    if (\n      storageRef.current &&\n      selectedKeysFromStorageRef.current &&\n      selectedKeysFromStorageRef.current.join(',') !== initialKeys.join(',')\n    ) {\n      change(selectedKeysFromStorageRef.current, true);\n    }\n  }, [initialKeys]);\n\n  const dropdownRender = () => (\n    <div\n      {...popupProps}\n      className={classNames(`${prefixCls}-popup`, popupProps?.className)}\n      onClick={(e) => {\n        e.stopPropagation();\n        popupProps?.onClick?.(e);\n      }}\n    >\n      <Typography.Text className={`${prefixCls}-popup-title`}>{t('components.ColumnSetting.title')}</Typography.Text>\n      <Space direction=\"vertical\" className={`${prefixCls}-column-list`} size={12}>\n        {columns.map((col, idx) => {\n          const k = String(getColKey(col, idx));\n          const label = col.title ?? col.dataIndex ?? k;\n          const checked = selectedKeys.includes(k);\n          const disabled = !!col.disabled;\n          const disableUncheck = !disabled && checked && selectedKeys.length <= 1; // 禁止取消最后一个\n          return (\n            <Checkbox\n              key={k}\n              className={`${prefixCls}-column-item`}\n              disabled={disabled || disableUncheck}\n              checked={checked}\n              onChange={(e) => toggleOne(k, e.target.checked)}\n            >\n              <span className={`${prefixCls}-column-item-title`}>{renderColumnTitle?.(col, idx) ?? label}</span>\n            </Checkbox>\n          );\n        })}\n      </Space>\n      <Divider className={`${prefixCls}-divider`} />\n      <div className={`${prefixCls}-footer`}>\n        <Button\n          type=\"text\"\n          {...checkAllProps}\n          className={classNames(`${prefixCls}-select-all`, checkAllProps?.className)}\n          onClick={(e) => {\n            handleCheckAll(!isAllChecked);\n            checkAllProps?.onClick?.(e);\n          }}\n        >\n          <Checkbox checked={isAllChecked} indeterminate={isIndeterminate}></Checkbox>\n          {t('components.ColumnSetting.selectAll')}\n        </Button>\n        <Button\n          type=\"text\"\n          icon={<ReloadOutlined />}\n          disabled={!hasChange}\n          {...resetProps}\n          className={classNames(`${prefixCls}-reset`, resetProps?.className)}\n          onClick={(e) => {\n            handleReset();\n            resetProps?.onClick?.(e);\n          }}\n        >\n          {t('components.ColumnSetting.reset')}\n        </Button>\n      </div>\n    </div>\n  );\n\n  return wrapCSSVar(\n    <Dropdown\n      open={open}\n      onOpenChange={handleOpenChange}\n      trigger={['click']}\n      dropdownRender={dropdownRender} // To be compatible with lower versions of antd\n      popupRender={dropdownRender}\n      placement=\"bottomRight\"\n      {...dropdownProps}\n      rootClassName={classNames(hashId, cssVarCls, prefixCls, `${prefixCls}-dropdown`, dropdownProps?.className)}\n    >\n      <Button\n        icon={<SettingOutlined />}\n        {...triggerProps}\n        className={classNames(hashId, cssVarCls, prefixCls, `${prefixCls}-trigger`, triggerProps?.className)}\n      />\n    </Dropdown>\n  );\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface ColumnSettingItem<T = any> extends ColumnType<T> {\n  /**\n   * - **EN:** Disable toggling visibility for this column.\n   * - **CN:** 禁止切换此列的可见性。\n   */\n  disabled?: boolean;\n}\n\nfunction getColKey(col: ColumnType, idx: number): React.Key {\n  return col.key ?? (col.dataIndex as string) ?? idx;\n}\n\nfunction normalizeToSelectedKeys(cols: ColumnType[]): string[] {\n  return cols\n    .map((c, i) => ({ key: String(getColKey(c, i)), hidden: !!c.hidden }))\n    .filter((c) => !c.hidden)\n    .map((c) => c.key)\n    .sort();\n}\n\nexport default ColumnSetting;\n"],
+  "mappings": "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",
+  "names": ["useStyle", "useT", "useLocalStorage", "classNames"]
 }

package/lib/components/ConfigProvider/context.d.ts

@@ -6,6 +6,8 @@ export interface ReactEasyContextProps {
     /**
      * - **EN:** Language of the component, used for global configuration, can be 'en-US' or 'zh-CN'
      * - **CN:** 组件的语言，用于全局配置，可以是'en-US'或'zh-CN'
+     *
+     * @default 'en-US'
      */
     lang?: Langs;
     /**

package/lib/components/ConfigProvider/context.js

@@ -25,7 +25,7 @@ __export(context_exports, {
 module.exports = __toCommonJS(context_exports);
 var import_react = require("react");
 var defaultContextValue = {
-  lang: "en"
+  lang: "en-US"
 };
 var ReactEasyContext = (0, import_react.createContext)(defaultContextValue);
 var context_default = ReactEasyContext;

package/lib/components/ConfigProvider/context.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/components/ConfigProvider/context.tsx"],
-  "sourcesContent": ["import { createContext, type ReactNode } from 'react';\nimport type { Langs } from '../../locales';\nimport type { ConfirmActionProps } from '../ConfirmAction';\nimport type { ModalActionProps } from '../ModalAction';\n\nexport interface ReactEasyContextProps {\n  /**\n   * - **EN:** Language of the component, used for global configuration, can be 'en-US' or 'zh-CN'\n   * - **CN:** 组件的语言，用于全局配置，可以是'en-US'或'zh-CN'\n   */\n  lang?: Langs;\n  /**\n   * - **EN:** Get localized text\n   * - **CN:** 获取本地化文本\n   *\n   * @param key Normal text or key of local resource | 普通文本或本地资源的键值\n   * @param args Parameters of the localized text | 本地化文本的参数\n   *\n   * @returns Localized text | 本地化文本\n   */\n  localize?: <T>(key: T, args?: Record<string, unknown>) => ReactNode;\n\n  /**\n   * - **EN:** Global configuration for `ConfirmAction` component, which can be used to set default\n   *   modal title and content for all `ConfirmAction` components in the application.\n   * - **CN:** `ConfirmAction`组件的全局配置，可以用来设置应用中所有`ConfirmAction`组件的默认模态框标题和内容。\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ConfirmAction?: ConfirmActionProps<any, never>;\n  /** @deprecated Use `ConfirmAction.title` instead */\n  defaultConfirmTitle?: ReactNode;\n  /** @deprecated Use `ConfirmAction.content` instead */\n  defaultConfirmContent?: ReactNode;\n\n  /**\n   * - **EN:** Global configuration for `DeleteConfirmAction` component, which can be used to set\n   *   default modal title and content for all `DeleteConfirmAction` components in the application.\n   * - **CN:** `DeleteConfirmAction`组件的全局配置，可以用来设置应用中所有`DeleteConfirmAction`组件的默认模态框标题和内容。\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  DeletionConfirmAction?: ConfirmActionProps<any, never>;\n  /** @deprecated Use `DeletionConfirmAction.title` instead */\n  defaultDeletionConfirmTitle?: ReactNode;\n  /** @deprecated Use `DeletionConfirmAction.content` instead */\n  defaultDeletionConfirmContent?: ReactNode;\n\n  /**\n   * - **EN:** Global configuration for `ModalAction` component, which can be used to set default\n   *   modal title and content for all `ModalAction` components in the application.\n   * - **CN:** `ModalAction`组件的全局配置，可以用来设置应用中所有`ModalAction`组件的默认模态框标题和内容。\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ModalAction?: Partial<ModalActionProps<any, any, any, any, any>>;\n}\n\nexport const defaultContextValue: ReactEasyContextProps = {\n  lang: 'en',\n};\n\nconst ReactEasyContext = createContext<ReactEasyContextProps>(defaultContextValue);\n\nexport default ReactEasyContext;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA8C;AAuDvC,IAAM,sBAA6C;AAAA,EACxD,MAAM;AACR;AAEA,IAAM,uBAAmB,4BAAqC,mBAAmB;AAEjF,IAAO,kBAAQ;",
+  "sourcesContent": ["import { createContext, type ReactNode } from 'react';\nimport type { Langs } from '../../locales';\nimport type { ConfirmActionProps } from '../ConfirmAction';\nimport type { ModalActionProps } from '../ModalAction';\n\nexport interface ReactEasyContextProps {\n  /**\n   * - **EN:** Language of the component, used for global configuration, can be 'en-US' or 'zh-CN'\n   * - **CN:** 组件的语言，用于全局配置，可以是'en-US'或'zh-CN'\n   *\n   * @default 'en-US'\n   */\n  lang?: Langs;\n  /**\n   * - **EN:** Get localized text\n   * - **CN:** 获取本地化文本\n   *\n   * @param key Normal text or key of local resource | 普通文本或本地资源的键值\n   * @param args Parameters of the localized text | 本地化文本的参数\n   *\n   * @returns Localized text | 本地化文本\n   */\n  localize?: <T>(key: T, args?: Record<string, unknown>) => ReactNode;\n\n  /**\n   * - **EN:** Global configuration for `ConfirmAction` component, which can be used to set default\n   *   modal title and content for all `ConfirmAction` components in the application.\n   * - **CN:** `ConfirmAction`组件的全局配置，可以用来设置应用中所有`ConfirmAction`组件的默认模态框标题和内容。\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ConfirmAction?: ConfirmActionProps<any, never>;\n  /** @deprecated Use `ConfirmAction.title` instead */\n  defaultConfirmTitle?: ReactNode;\n  /** @deprecated Use `ConfirmAction.content` instead */\n  defaultConfirmContent?: ReactNode;\n\n  /**\n   * - **EN:** Global configuration for `DeleteConfirmAction` component, which can be used to set\n   *   default modal title and content for all `DeleteConfirmAction` components in the application.\n   * - **CN:** `DeleteConfirmAction`组件的全局配置，可以用来设置应用中所有`DeleteConfirmAction`组件的默认模态框标题和内容。\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  DeletionConfirmAction?: ConfirmActionProps<any, never>;\n  /** @deprecated Use `DeletionConfirmAction.title` instead */\n  defaultDeletionConfirmTitle?: ReactNode;\n  /** @deprecated Use `DeletionConfirmAction.content` instead */\n  defaultDeletionConfirmContent?: ReactNode;\n\n  /**\n   * - **EN:** Global configuration for `ModalAction` component, which can be used to set default\n   *   modal title and content for all `ModalAction` components in the application.\n   * - **CN:** `ModalAction`组件的全局配置，可以用来设置应用中所有`ModalAction`组件的默认模态框标题和内容。\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ModalAction?: Partial<ModalActionProps<any, any, any, any, any>>;\n}\n\nexport const defaultContextValue: ReactEasyContextProps = {\n  lang: 'en-US',\n};\n\nconst ReactEasyContext = createContext<ReactEasyContextProps>(defaultContextValue);\n\nexport default ReactEasyContext;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA8C;AAyDvC,IAAM,sBAA6C;AAAA,EACxD,MAAM;AACR;AAEA,IAAM,uBAAmB,4BAAqC,mBAAmB;AAEjF,IAAO,kBAAQ;",
   "names": []
 }

package/lib/components/ConfigProvider/index.d.ts

@@ -2,8 +2,25 @@ import type { CSSProperties, FC, ReactNode } from 'react';
 import type localesEn from '../../locales/langs/en';
 import { type ReactEasyContextProps } from './context';
 export interface ConfigProviderProps extends ReactEasyContextProps {
+    /**
+     * - **EN:** Child elements of the ConfigProvider
+     * - **CN:** ConfigProvider 的子元素
+     */
+    children: ReactNode;
+    /**
+     * - **EN:** Custom prefix for the component's CSS class.
+     * - **CN:** 组件的自定义 CSS 类前缀。
+     */
     prefixCls?: string;
+    /**
+     * - **EN:** Custom class name for the root element
+     * - **CN:** 根元素的自定义类名
+     */
     className?: string;
+    /**
+     * - **EN:** Custom styles for the root element
+     * - **CN:** 根元素的自定义样式
+     */
     style?: CSSProperties;
     /**
      * - **EN:** Custom localization resources, if `lang` exists, it will override the localization
@@ -11,7 +28,6 @@ export interface ConfigProviderProps extends ReactEasyContextProps {
      * - **CN:** 自定义本地化资源，如果`lang`存在，则会覆盖该语言的本地化资源，否则，会添加一种新的语言
      */
     locales?: Partial<typeof localesEn>;
-    children: ReactNode;
 }
 /**
  * - **EN:** Provide global configuration for AntdHelper

package/lib/components/ConfigProvider/index.js

@@ -44,22 +44,29 @@ var ConfigProvider = (props) => {
   const { getPrefixCls, rootPrefixCls } = (0, import_react.useContext)(import_antd.ConfigProvider.ConfigContext);
   const prefixCls = getPrefixCls("react-easy", prefixClsInProps);
   const [wrapCSSVar, hashId, cssVarCls] = (0, import_style.default)(prefixCls, rootPrefixCls);
+  const contextValue = (0, import_react.useMemo)(
+    () => {
+      if (langInProps !== import_locales.default.language) {
+        import_locales.default.changeLanguage(langInProps || "en-US");
+      }
+      return restProps;
+    },
+    // eslint-disable-next-line @tiny-codes/react-hooks/exhaustive-deps
+    [langInProps, ...Object.values(restProps)]
+  );
   (0, import_react.useEffect)(() => {
     if (userLocales) {
-      const lang = langInProps || "en";
+      const lang = langInProps || "en-US";
       if (lang && import_locales.langs.includes(lang)) {
         import_locales.default.removeResourceBundle(lang, "translation");
         import_locales.default.addResourceBundle(lang, "translation", { ...import_locales.resources[lang].translation, ...userLocales });
       } else {
-        import_locales.default.addResourceBundle(lang, "translation", { ...import_locales.resources.en.translation, ...userLocales });
+        import_locales.default.addResourceBundle(lang, "translation", { ...import_locales.resources["en-US"].translation, ...userLocales });
       }
     }
   }, [langInProps, userLocales]);
-  (0, import_react.useEffect)(() => {
-    import_locales.default.changeLanguage(langInProps || "en");
-  }, [langInProps]);
   return wrapCSSVar(
-    /* @__PURE__ */ React.createElement(import_context.default.Provider, { value: restProps }, /* @__PURE__ */ React.createElement("div", { className: (0, import_classnames.default)(hashId, cssVarCls, prefixCls, className), style }, children))
+    /* @__PURE__ */ React.createElement(import_context.default.Provider, { value: contextValue }, /* @__PURE__ */ React.createElement("div", { className: (0, import_classnames.default)(hashId, cssVarCls, prefixCls, className), style }, children))
   );
 };
 ConfigProvider.displayName = "ReactEasyConfigProvider";

package/lib/components/ConfigProvider/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/components/ConfigProvider/index.tsx"],
-  "sourcesContent": ["import type { CSSProperties, FC, ReactNode } from 'react';\nimport { useContext, useEffect } from 'react';\nimport { ConfigProvider as ReactConfigProvider } from 'antd';\nimport classNames from 'classnames';\nimport locales, { langs, resources } from '../../locales';\nimport type localesEn from '../../locales/langs/en';\nimport ReactEasyContext, { type ReactEasyContextProps } from './context';\nimport useStyle from './style';\n\nexport interface ConfigProviderProps extends ReactEasyContextProps {\n  prefixCls?: string;\n  className?: string;\n  style?: CSSProperties;\n  /**\n   * - **EN:** Custom localization resources, if `lang` exists, it will override the localization\n   *   resources of that language, otherwise, it will add a new language\n   * - **CN:** 自定义本地化资源，如果`lang`存在，则会覆盖该语言的本地化资源，否则，会添加一种新的语言\n   */\n  locales?: Partial<typeof localesEn>;\n  children: ReactNode;\n}\n\n/**\n * - **EN:** Provide global configuration for AntdHelper\n * - **CN:** 提供AntdHelper的全局配置\n */\nconst ConfigProvider: FC<ConfigProviderProps> = (props) => {\n  const { children, locales: userLocales, prefixCls: prefixClsInProps, className, style, ...restProps } = props;\n  const { lang: langInProps } = restProps;\n  const { getPrefixCls, rootPrefixCls } = useContext(ReactConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('react-easy', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls, rootPrefixCls);\n\n  useEffect(() => {\n    // Dynamically add language pack\n    if (userLocales) {\n      const lang = langInProps || 'en';\n      if (lang && langs.includes(lang)) {\n        locales.removeResourceBundle(lang, 'translation');\n        locales.addResourceBundle(lang, 'translation', { ...resources[lang].translation, ...userLocales });\n      } else {\n        locales.addResourceBundle(lang, 'translation', { ...resources.en.translation, ...userLocales });\n      }\n    }\n  }, [langInProps, userLocales]);\n\n  useEffect(() => {\n    // Set the language of the component\n    locales.changeLanguage(langInProps || 'en');\n  }, [langInProps]);\n\n  return wrapCSSVar(\n    <ReactEasyContext.Provider value={restProps}>\n      <div className={classNames(hashId, cssVarCls, prefixCls, className)} style={style}>\n        {children}\n      </div>\n    </ReactEasyContext.Provider>\n  );\n};\nConfigProvider.displayName = 'ReactEasyConfigProvider';\n\nexport default ConfigProvider;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAsC;AACtC,kBAAsD;AACtD,wBAAuB;AACvB,qBAA0C;AAE1C,qBAA6D;AAC7D,mBAAqB;AAmBrB,IAAM,iBAA0C,CAAC,UAAU;AACzD,QAAM,EAAE,UAAU,SAAS,aAAa,WAAW,kBAAkB,WAAW,OAAO,GAAG,UAAU,IAAI;AACxG,QAAM,EAAE,MAAM,YAAY,IAAI;AAC9B,QAAM,EAAE,cAAc,cAAc,QAAI,yBAAW,YAAAA,eAAoB,aAAa;AACpF,QAAM,YAAY,aAAa,cAAc,gBAAgB;AAC7D,QAAM,CAAC,YAAY,QAAQ,SAAS,QAAI,aAAAC,SAAS,WAAW,aAAa;AAEzE,8BAAU,MAAM;AAEd,QAAI,aAAa;AACf,YAAM,OAAO,eAAe;AAC5B,UAAI,QAAQ,qBAAM,SAAS,IAAI,GAAG;AAChC,uBAAAC,QAAQ,qBAAqB,MAAM,aAAa;AAChD,uBAAAA,QAAQ,kBAAkB,MAAM,eAAe,EAAE,GAAG,yBAAU,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;AAAA,MACnG,OAAO;AACL,uBAAAA,QAAQ,kBAAkB,MAAM,eAAe,EAAE,GAAG,yBAAU,GAAG,aAAa,GAAG,YAAY,CAAC;AAAA,MAChG;AAAA,IACF;AAAA,EACF,GAAG,CAAC,aAAa,WAAW,CAAC;AAE7B,8BAAU,MAAM;AAEd,mBAAAA,QAAQ,eAAe,eAAe,IAAI;AAAA,EAC5C,GAAG,CAAC,WAAW,CAAC;AAEhB,SAAO;AAAA,IACL,oCAAC,eAAAC,QAAiB,UAAjB,EAA0B,OAAO,aAChC,oCAAC,SAAI,eAAW,kBAAAC,SAAW,QAAQ,WAAW,WAAW,SAAS,GAAG,SAClE,QACH,CACF;AAAA,EACF;AACF;AACA,eAAe,cAAc;AAE7B,IAAO,yBAAQ;",
+  "sourcesContent": ["import type { CSSProperties, FC, ReactNode } from 'react';\nimport { useContext, useEffect, useMemo } from 'react';\nimport { ConfigProvider as ReactConfigProvider } from 'antd';\nimport classNames from 'classnames';\nimport locales, { langs, resources } from '../../locales';\nimport type localesEn from '../../locales/langs/en';\nimport ReactEasyContext, { type ReactEasyContextProps } from './context';\nimport useStyle from './style';\n\nexport interface ConfigProviderProps extends ReactEasyContextProps {\n  /**\n   * - **EN:** Child elements of the ConfigProvider\n   * - **CN:** ConfigProvider 的子元素\n   */\n  children: ReactNode;\n  /**\n   * - **EN:** Custom prefix for the component's CSS class.\n   * - **CN:** 组件的自定义 CSS 类前缀。\n   */\n  prefixCls?: string;\n  /**\n   * - **EN:** Custom class name for the root element\n   * - **CN:** 根元素的自定义类名\n   */\n  className?: string;\n  /**\n   * - **EN:** Custom styles for the root element\n   * - **CN:** 根元素的自定义样式\n   */\n  style?: CSSProperties;\n  /**\n   * - **EN:** Custom localization resources, if `lang` exists, it will override the localization\n   *   resources of that language, otherwise, it will add a new language\n   * - **CN:** 自定义本地化资源，如果`lang`存在，则会覆盖该语言的本地化资源，否则，会添加一种新的语言\n   */\n  locales?: Partial<typeof localesEn>;\n}\n\n/**\n * - **EN:** Provide global configuration for AntdHelper\n * - **CN:** 提供AntdHelper的全局配置\n */\nconst ConfigProvider: FC<ConfigProviderProps> = (props) => {\n  const { children, locales: userLocales, prefixCls: prefixClsInProps, className, style, ...restProps } = props;\n  const { lang: langInProps } = restProps;\n  const { getPrefixCls, rootPrefixCls } = useContext(ReactConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('react-easy', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls, rootPrefixCls);\n  const contextValue = useMemo(\n    () => {\n      if (langInProps !== locales.language) {\n        locales.changeLanguage(langInProps || 'en-US');\n      }\n      return restProps;\n    },\n    // eslint-disable-next-line @tiny-codes/react-hooks/exhaustive-deps\n    [langInProps, ...Object.values(restProps)]\n  );\n\n  useEffect(() => {\n    // Dynamically add language pack\n    if (userLocales) {\n      const lang = langInProps || 'en-US';\n      if (lang && langs.includes(lang)) {\n        locales.removeResourceBundle(lang, 'translation');\n        locales.addResourceBundle(lang, 'translation', { ...resources[lang].translation, ...userLocales });\n      } else {\n        locales.addResourceBundle(lang, 'translation', { ...resources['en-US'].translation, ...userLocales });\n      }\n    }\n  }, [langInProps, userLocales]);\n\n  return wrapCSSVar(\n    <ReactEasyContext.Provider value={contextValue}>\n      <div className={classNames(hashId, cssVarCls, prefixCls, className)} style={style}>\n        {children}\n      </div>\n    </ReactEasyContext.Provider>\n  );\n};\nConfigProvider.displayName = 'ReactEasyConfigProvider';\n\nexport default ConfigProvider;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAA+C;AAC/C,kBAAsD;AACtD,wBAAuB;AACvB,qBAA0C;AAE1C,qBAA6D;AAC7D,mBAAqB;AAmCrB,IAAM,iBAA0C,CAAC,UAAU;AACzD,QAAM,EAAE,UAAU,SAAS,aAAa,WAAW,kBAAkB,WAAW,OAAO,GAAG,UAAU,IAAI;AACxG,QAAM,EAAE,MAAM,YAAY,IAAI;AAC9B,QAAM,EAAE,cAAc,cAAc,QAAI,yBAAW,YAAAA,eAAoB,aAAa;AACpF,QAAM,YAAY,aAAa,cAAc,gBAAgB;AAC7D,QAAM,CAAC,YAAY,QAAQ,SAAS,QAAI,aAAAC,SAAS,WAAW,aAAa;AACzE,QAAM,mBAAe;AAAA,IACnB,MAAM;AACJ,UAAI,gBAAgB,eAAAC,QAAQ,UAAU;AACpC,uBAAAA,QAAQ,eAAe,eAAe,OAAO;AAAA,MAC/C;AACA,aAAO;AAAA,IACT;AAAA;AAAA,IAEA,CAAC,aAAa,GAAG,OAAO,OAAO,SAAS,CAAC;AAAA,EAC3C;AAEA,8BAAU,MAAM;AAEd,QAAI,aAAa;AACf,YAAM,OAAO,eAAe;AAC5B,UAAI,QAAQ,qBAAM,SAAS,IAAI,GAAG;AAChC,uBAAAA,QAAQ,qBAAqB,MAAM,aAAa;AAChD,uBAAAA,QAAQ,kBAAkB,MAAM,eAAe,EAAE,GAAG,yBAAU,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;AAAA,MACnG,OAAO;AACL,uBAAAA,QAAQ,kBAAkB,MAAM,eAAe,EAAE,GAAG,yBAAU,OAAO,EAAE,aAAa,GAAG,YAAY,CAAC;AAAA,MACtG;AAAA,IACF;AAAA,EACF,GAAG,CAAC,aAAa,WAAW,CAAC;AAE7B,SAAO;AAAA,IACL,oCAAC,eAAAC,QAAiB,UAAjB,EAA0B,OAAO,gBAChC,oCAAC,SAAI,eAAW,kBAAAC,SAAW,QAAQ,WAAW,WAAW,SAAS,GAAG,SAClE,QACH,CACF;AAAA,EACF;AACF;AACA,eAAe,cAAc;AAE7B,IAAO,yBAAQ;",
   "names": ["ReactConfigProvider", "useStyle", "locales", "ReactEasyContext", "classNames"]
 }