@tiny-codes/react-easy 1.6.3 → 1.6.5

package/CHANGELOG.md

@@ -2,9 +2,29 @@
 
 # Changelog
 
+## 1.6.5
+
+2026-2-4
+
+### Features
+
+- **useValidatorBuilder**
+  - ✨ Improve `useValidatorBuilder` for better format of special characters in validation messages.
+- **OverflowTags**
+  - ✨ Enhance `tagProps` and `ellipsisTagProps` to provide more context in the function parameters.
+  - ✨ Support any data types
+
+## 1.6.4
+
+2026-1-15
+
+### Features
+
+- 🛠️ improve `easy-full-height-table` class styles
+
 ## 1.6.3
 
-2026-1-2
+2026-1-7
 
 ### Features
 
@@ -16,6 +36,15 @@
 
   - 🐞 Fix Tooltip not accepting custom `ellipsis.tooltip` props issue.
 
+## 1.6.2
+
+2026-1-2
+
+### Features
+
+- **withEllipsisTypography**
+  - 🛠️ accept custom `ellipsis.tooltip` props.
+
 ## 1.6.1
 
 2026-1-1

package/es/components/ConfigProvider/index.js

@@ -33,9 +33,10 @@ var ConfigProvider = function ConfigProvider(props) {
     restProps = _objectWithoutProperties(props, _excluded);
   var langInProps = restProps.lang;
   var _useContext = useContext(ReactConfigProvider.ConfigContext),
-    getPrefixCls = _useContext.getPrefixCls;
+    getPrefixCls = _useContext.getPrefixCls,
+    rootPrefixCls = _useContext.rootPrefixCls;
   var prefixCls = getPrefixCls('react-easy', prefixClsInProps);
-  var _useStyle = useStyle(prefixCls),
+  var _useStyle = useStyle(prefixCls, rootPrefixCls),
     _useStyle2 = _slicedToArray(_useStyle, 3),
     wrapCSSVar = _useStyle2[0],
     hashId = _useStyle2[1],

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

@@ -1 +1 @@
-{"version":3,"names":["useContext","useEffect","ConfigProvider","ReactConfigProvider","classNames","locales","langs","resources","ReactEasyContext","useStyle","jsx","_jsx","props","children","userLocales","prefixClsInProps","prefixCls","className","style","restProps","_objectWithoutProperties","_excluded","langInProps","lang","_useContext","ConfigContext","getPrefixCls","_useStyle","_useStyle2","_slicedToArray","wrapCSSVar","hashId","cssVarCls","includes","removeResourceBundle","addResourceBundle","_objectSpread","translation","en","changeLanguage","Provider","value","displayName"],"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 } = useContext(ReactConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('react-easy', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\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":";;;;;;;;;;;;;;;AACA,SAASA,UAAU,EAAEC,SAAS,QAAQ,OAAO;AAC7C,SAASC,cAAc,IAAIC,mBAAmB,QAAQ,MAAM;AAC5D,OAAOC,UAAU,MAAM,YAAY;AACnC,OAAOC,OAAO,IAAIC,KAAK,EAAEC,SAAS;AAElC,OAAOC,gBAAgB;AACvB,OAAOC,QAAQ;AAAgB,SAAAC,GAAA,IAAAC,IAAA;AAe/B;AACA;AACA;AACA;AACA,IAAMT,cAAuC,GAAG,SAA1CA,cAAuCA,CAAIU,KAAK,EAAK;EACzD,IAAQC,QAAQ,GAAwFD,KAAK,CAArGC,QAAQ;IAAWC,WAAW,GAAkEF,KAAK,CAA3FP,OAAO;IAA0BU,gBAAgB,GAAqCH,KAAK,CAArEI,SAAS;IAAoBC,SAAS,GAA0BL,KAAK,CAAxCK,SAAS;IAAEC,KAAK,GAAmBN,KAAK,CAA7BM,KAAK;IAAKC,SAAS,GAAAC,wBAAA,CAAKR,KAAK,EAAAS,SAAA;EAC7G,IAAcC,WAAW,GAAKH,SAAS,CAA/BI,IAAI;EACZ,IAAAC,WAAA,GAAyBxB,UAAU,CAACG,mBAAmB,CAACsB,aAAa,CAAC;IAA9DC,YAAY,GAAAF,WAAA,CAAZE,YAAY;EACpB,IAAMV,SAAS,GAAGU,YAAY,CAAC,YAAY,EAAEX,gBAAgB,CAAC;EAC9D,IAAAY,SAAA,GAAwClB,QAAQ,CAACO,SAAS,CAAC;IAAAY,UAAA,GAAAC,cAAA,CAAAF,SAAA;IAApDG,UAAU,GAAAF,UAAA;IAAEG,MAAM,GAAAH,UAAA;IAAEI,SAAS,GAAAJ,UAAA;EAEpC3B,SAAS,CAAC,YAAM;IACd;IACA,IAAIa,WAAW,EAAE;MACf,IAAMS,IAAI,GAAGD,WAAW,IAAI,IAAI;MAChC,IAAIC,IAAI,IAAIjB,KAAK,CAAC2B,QAAQ,CAACV,IAAI,CAAC,EAAE;QAChClB,OAAO,CAAC6B,oBAAoB,CAACX,IAAI,EAAE,aAAa,CAAC;QACjDlB,OAAO,CAAC8B,iBAAiB,CAACZ,IAAI,EAAE,aAAa,EAAAa,aAAA,CAAAA,aAAA,KAAO7B,SAAS,CAACgB,IAAI,CAAC,CAACc,WAAW,GAAKvB,WAAW,CAAE,CAAC;MACpG,CAAC,MAAM;QACLT,OAAO,CAAC8B,iBAAiB,CAACZ,IAAI,EAAE,aAAa,EAAAa,aAAA,CAAAA,aAAA,KAAO7B,SAAS,CAAC+B,EAAE,CAACD,WAAW,GAAKvB,WAAW,CAAE,CAAC;MACjG;IACF;EACF,CAAC,EAAE,CAACQ,WAAW,EAAER,WAAW,CAAC,CAAC;EAE9Bb,SAAS,CAAC,YAAM;IACd;IACAI,OAAO,CAACkC,cAAc,CAACjB,WAAW,IAAI,IAAI,CAAC;EAC7C,CAAC,EAAE,CAACA,WAAW,CAAC,CAAC;EAEjB,OAAOQ,UAAU,eACfnB,IAAA,CAACH,gBAAgB,CAACgC,QAAQ;IAACC,KAAK,EAAEtB,SAAU;IAAAN,QAAA,eAC1CF,IAAA;MAAKM,SAAS,EAAEb,UAAU,CAAC2B,MAAM,EAAEC,SAAS,EAAEhB,SAAS,EAAEC,SAAS,CAAE;MAACC,KAAK,EAAEA,KAAM;MAAAL,QAAA,EAC/EA;IAAQ,CACN;EAAC,CACmB,CAC7B,CAAC;AACH,CAAC;AACDX,cAAc,CAACwC,WAAW,GAAG,yBAAyB;AAEtD,eAAexC,cAAc"}
+{"version":3,"names":["useContext","useEffect","ConfigProvider","ReactConfigProvider","classNames","locales","langs","resources","ReactEasyContext","useStyle","jsx","_jsx","props","children","userLocales","prefixClsInProps","prefixCls","className","style","restProps","_objectWithoutProperties","_excluded","langInProps","lang","_useContext","ConfigContext","getPrefixCls","rootPrefixCls","_useStyle","_useStyle2","_slicedToArray","wrapCSSVar","hashId","cssVarCls","includes","removeResourceBundle","addResourceBundle","_objectSpread","translation","en","changeLanguage","Provider","value","displayName"],"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":";;;;;;;;;;;;;;;AACA,SAASA,UAAU,EAAEC,SAAS,QAAQ,OAAO;AAC7C,SAASC,cAAc,IAAIC,mBAAmB,QAAQ,MAAM;AAC5D,OAAOC,UAAU,MAAM,YAAY;AACnC,OAAOC,OAAO,IAAIC,KAAK,EAAEC,SAAS;AAElC,OAAOC,gBAAgB;AACvB,OAAOC,QAAQ;AAAgB,SAAAC,GAAA,IAAAC,IAAA;AAe/B;AACA;AACA;AACA;AACA,IAAMT,cAAuC,GAAG,SAA1CA,cAAuCA,CAAIU,KAAK,EAAK;EACzD,IAAQC,QAAQ,GAAwFD,KAAK,CAArGC,QAAQ;IAAWC,WAAW,GAAkEF,KAAK,CAA3FP,OAAO;IAA0BU,gBAAgB,GAAqCH,KAAK,CAArEI,SAAS;IAAoBC,SAAS,GAA0BL,KAAK,CAAxCK,SAAS;IAAEC,KAAK,GAAmBN,KAAK,CAA7BM,KAAK;IAAKC,SAAS,GAAAC,wBAAA,CAAKR,KAAK,EAAAS,SAAA;EAC7G,IAAcC,WAAW,GAAKH,SAAS,CAA/BI,IAAI;EACZ,IAAAC,WAAA,GAAwCxB,UAAU,CAACG,mBAAmB,CAACsB,aAAa,CAAC;IAA7EC,YAAY,GAAAF,WAAA,CAAZE,YAAY;IAAEC,aAAa,GAAAH,WAAA,CAAbG,aAAa;EACnC,IAAMX,SAAS,GAAGU,YAAY,CAAC,YAAY,EAAEX,gBAAgB,CAAC;EAC9D,IAAAa,SAAA,GAAwCnB,QAAQ,CAACO,SAAS,EAAEW,aAAa,CAAC;IAAAE,UAAA,GAAAC,cAAA,CAAAF,SAAA;IAAnEG,UAAU,GAAAF,UAAA;IAAEG,MAAM,GAAAH,UAAA;IAAEI,SAAS,GAAAJ,UAAA;EAEpC5B,SAAS,CAAC,YAAM;IACd;IACA,IAAIa,WAAW,EAAE;MACf,IAAMS,IAAI,GAAGD,WAAW,IAAI,IAAI;MAChC,IAAIC,IAAI,IAAIjB,KAAK,CAAC4B,QAAQ,CAACX,IAAI,CAAC,EAAE;QAChClB,OAAO,CAAC8B,oBAAoB,CAACZ,IAAI,EAAE,aAAa,CAAC;QACjDlB,OAAO,CAAC+B,iBAAiB,CAACb,IAAI,EAAE,aAAa,EAAAc,aAAA,CAAAA,aAAA,KAAO9B,SAAS,CAACgB,IAAI,CAAC,CAACe,WAAW,GAAKxB,WAAW,CAAE,CAAC;MACpG,CAAC,MAAM;QACLT,OAAO,CAAC+B,iBAAiB,CAACb,IAAI,EAAE,aAAa,EAAAc,aAAA,CAAAA,aAAA,KAAO9B,SAAS,CAACgC,EAAE,CAACD,WAAW,GAAKxB,WAAW,CAAE,CAAC;MACjG;IACF;EACF,CAAC,EAAE,CAACQ,WAAW,EAAER,WAAW,CAAC,CAAC;EAE9Bb,SAAS,CAAC,YAAM;IACd;IACAI,OAAO,CAACmC,cAAc,CAAClB,WAAW,IAAI,IAAI,CAAC;EAC7C,CAAC,EAAE,CAACA,WAAW,CAAC,CAAC;EAEjB,OAAOS,UAAU,eACfpB,IAAA,CAACH,gBAAgB,CAACiC,QAAQ;IAACC,KAAK,EAAEvB,SAAU;IAAAN,QAAA,eAC1CF,IAAA;MAAKM,SAAS,EAAEb,UAAU,CAAC4B,MAAM,EAAEC,SAAS,EAAEjB,SAAS,EAAEC,SAAS,CAAE;MAACC,KAAK,EAAEA,KAAM;MAAAL,QAAA,EAC/EA;IAAQ,CACN;EAAC,CACmB,CAC7B,CAAC;AACH,CAAC;AACDX,cAAc,CAACyC,WAAW,GAAG,yBAAyB;AAEtD,eAAezC,cAAc"}

package/es/components/ConfigProvider/style/index.js

@@ -3,73 +3,6 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { genStyleHooks } from 'antd/es/theme/internal';
-// .full-height-table(@fullHeight:true, @depth: 1) when(@depth <= 2) {
-//   /* stylelint-disable-next-line function-no-unknown */
-//   height: if((@fullHeight = true), 100%, auto);
-
-//   .@{ant-prefix}-spin-nested-loading {
-//     /* stylelint-disable-next-line function-no-unknown */
-//     height: if((@fullHeight = true), 100%, auto);
-
-//     .@{ant-prefix}-spin-container {
-//       /* stylelint-disable-next-line function-no-unknown */
-//       display: if((@fullHeight = true), flex, block);
-//       flex-direction: column;
-//       /* stylelint-disable-next-line function-no-unknown */
-//       height: if((@fullHeight = true), 100%, auto);
-
-//       .@{ant-prefix}-table:not(.@{ant-prefix}-table-empty) {
-//         display: flex;
-//         flex: auto;
-//         flex-direction: column;
-//         width: 100%;
-//         min-height: 0;
-
-//         .@{ant-prefix}-table-container {
-//           flex: auto;
-//           min-height: 0;
-
-//           .@{ant-prefix}-table-content {
-//             /* stylelint-disable-next-line function-no-unknown */
-//             max-height: if((@fullHeight = true), 100%, auto);
-//             // 把容器再多撑高1px，否则会始终显示纵向滚动条
-//             padding-bottom: 1px;
-//             // 自动显示纵向滚动条
-//             // stylelint-disable-next-line declaration-no-important
-//             overflow: auto !important;
-
-//             & > table {
-//               /* stylelint-disable-next-line function-no-unknown */
-//               height: if((@fullHeight = true), 100%, auto);
-
-//               .@{ant-prefix}-table-thead {
-//                 position: sticky;
-//                 top: 0;
-//                 z-index: 10;
-//               }
-
-//               td {
-//                 // 当嵌套表格时，还原所有full-height样式，防止子表格受影响
-//                 .full-height-table(false, @depth + 1);
-//               }
-//             }
-//           }
-//         }
-//       }
-
-//       & > .@{ant-prefix}-table-pagination {
-//         flex: none;
-//         margin-bottom: 0;
-//       }
-//     }
-//   }
-// }
-
-// .full-height-table-container {
-//   .@{ant-prefix}-table-wrapper {
-//     .full-height-table();
-//   }
-// }
 var genStyle = function genStyle(token) {
   var componentCls = token.componentCls;
   return _defineProperty({}, componentCls, {
@@ -80,22 +13,24 @@ var genStyle = function genStyle(token) {
     minHeight: 0,
     '.easy-full-height-table': _defineProperty({
       height: '100%'
-    }, "".concat(token.antCls, "-spin-nested-loading"), _defineProperty({
+    }, "& > ".concat(token.antCls, "-spin-nested-loading"), _defineProperty(_defineProperty({
       height: '100%'
-    }, "".concat(token.antCls, "-spin-container"), _defineProperty(_defineProperty({
+    }, "& > div > ".concat(token.antCls, "-spin"), {
+      maxHeight: '100%'
+    }), "& > ".concat(token.antCls, "-spin-container"), _defineProperty(_defineProperty(_defineProperty({
       display: 'flex',
       flexDirection: 'column',
       height: '100%'
-    }, "".concat(token.antCls, "-table:not(").concat(token.antCls, "-table-empty)"), _defineProperty({
+    }, "& > ".concat(token.antCls, "-table"), _defineProperty({
       display: 'flex',
       flex: 'auto',
       flexDirection: 'column',
       width: '100%',
       minHeight: 0
-    }, "".concat(token.antCls, "-table-container"), _defineProperty({
+    }, "& > ".concat(token.antCls, "-table-container"), _defineProperty({
       flex: 'auto',
       minHeight: 0
-    }, "".concat(token.antCls, "-table-content"), {
+    }, "& > ".concat(token.antCls, "-table-content"), {
       maxHeight: '100%',
       // 把容器再多撑高1px，否则会始终显示纵向滚动条
       paddingBottom: 1,
@@ -114,6 +49,8 @@ var genStyle = function genStyle(token) {
           height: 'auto'
         }
       })
+    }))), "& > ".concat(token.antCls, "-table").concat(token.antCls, "-table-empty"), _defineProperty({}, "& > ".concat(token.antCls, "-table-container"), _defineProperty({}, "& > ".concat(token.antCls, "-table-content"), {
+      height: '100%'
     }))), "& > ".concat(token.antCls, "-table-pagination"), {
       flex: 'none',
       marginBottom: 0

package/es/components/ConfigProvider/style/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["genStyleHooks","genStyle","token","componentCls","_defineProperty","width","height","flex","minWidth","minHeight","concat","antCls","display","flexDirection","maxHeight","paddingBottom","overflow","position","top","zIndex","marginBottom"],"sources":["../../../../src/components/ConfigProvider/style/index.ts"],"sourcesContent":["import { genStyleHooks } from 'antd/es/theme/internal';\nimport type { AliasToken, GenerateStyle } from 'antd/es/theme/internal';\nimport type { CSSObject } from '@ant-design/cssinjs';\nimport type { FullToken } from '@ant-design/cssinjs-utils';\n\ntype OverflowTagsToken = FullToken<{ ''?: object }, AliasToken, ''>;\n\n// .full-height-table(@fullHeight:true, @depth: 1) when(@depth <= 2) {\n//   /* stylelint-disable-next-line function-no-unknown */\n//   height: if((@fullHeight = true), 100%, auto);\n\n//   .@{ant-prefix}-spin-nested-loading {\n//     /* stylelint-disable-next-line function-no-unknown */\n//     height: if((@fullHeight = true), 100%, auto);\n\n//     .@{ant-prefix}-spin-container {\n//       /* stylelint-disable-next-line function-no-unknown */\n//       display: if((@fullHeight = true), flex, block);\n//       flex-direction: column;\n//       /* stylelint-disable-next-line function-no-unknown */\n//       height: if((@fullHeight = true), 100%, auto);\n\n//       .@{ant-prefix}-table:not(.@{ant-prefix}-table-empty) {\n//         display: flex;\n//         flex: auto;\n//         flex-direction: column;\n//         width: 100%;\n//         min-height: 0;\n\n//         .@{ant-prefix}-table-container {\n//           flex: auto;\n//           min-height: 0;\n\n//           .@{ant-prefix}-table-content {\n//             /* stylelint-disable-next-line function-no-unknown */\n//             max-height: if((@fullHeight = true), 100%, auto);\n//             // 把容器再多撑高1px，否则会始终显示纵向滚动条\n//             padding-bottom: 1px;\n//             // 自动显示纵向滚动条\n//             // stylelint-disable-next-line declaration-no-important\n//             overflow: auto !important;\n\n//             & > table {\n//               /* stylelint-disable-next-line function-no-unknown */\n//               height: if((@fullHeight = true), 100%, auto);\n\n//               .@{ant-prefix}-table-thead {\n//                 position: sticky;\n//                 top: 0;\n//                 z-index: 10;\n//               }\n\n//               td {\n//                 // 当嵌套表格时，还原所有full-height样式，防止子表格受影响\n//                 .full-height-table(false, @depth + 1);\n//               }\n//             }\n//           }\n//         }\n//       }\n\n//       & > .@{ant-prefix}-table-pagination {\n//         flex: none;\n//         margin-bottom: 0;\n//       }\n//     }\n//   }\n// }\n\n// .full-height-table-container {\n//   .@{ant-prefix}-table-wrapper {\n//     .full-height-table();\n//   }\n// }\nconst genStyle: GenerateStyle<OverflowTagsToken> = (token): CSSObject => {\n  const { componentCls } = token;\n  return {\n    [componentCls]: {\n      width: '100%',\n      height: '100%',\n      flex: 'auto',\n      minWidth: 0,\n      minHeight: 0,\n\n      '.easy-full-height-table': {\n        height: '100%',\n\n        [`${token.antCls}-spin-nested-loading`]: {\n          height: '100%',\n\n          [`${token.antCls}-spin-container`]: {\n            display: 'flex',\n            flexDirection: 'column',\n            height: '100%',\n\n            [`${token.antCls}-table:not(${token.antCls}-table-empty)`]: {\n              display: 'flex',\n              flex: 'auto',\n              flexDirection: 'column',\n              width: '100%',\n              minHeight: 0,\n\n              [`${token.antCls}-table-container`]: {\n                flex: 'auto',\n                minHeight: 0,\n\n                [`${token.antCls}-table-content`]: {\n                  maxHeight: '100%',\n                  // 把容器再多撑高1px，否则会始终显示纵向滚动条\n                  paddingBottom: 1,\n                  // 自动显示纵向滚动条\n                  // stylelint-disable-next-line declaration-no-important\n                  overflow: 'auto !important',\n\n                  '& > table': {\n                    height: '100%',\n\n                    [`${token.antCls}-table-thead`]: {\n                      position: 'sticky',\n                      top: 0,\n                      zIndex: 10,\n                    },\n\n                    td: {\n                      // 当嵌套表格时，还原所有full-height样式，防止子表格受影响\n                      '.easy-full-height-table': {\n                        height: 'auto',\n                      },\n                    },\n                  },\n                },\n              },\n            },\n            [`& > ${token.antCls}-table-pagination`]: {\n              flex: 'none',\n              marginBottom: 0,\n            },\n          },\n        },\n      },\n    },\n  };\n};\n\nexport default genStyleHooks('EasyConfigProvider' as never, genStyle);\n"],"mappings":";;;;AAAA,SAASA,aAAa,QAAQ,wBAAwB;AAOtD;AACA;AACA;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA,IAAMC,QAA0C,GAAG,SAA7CA,QAA0CA,CAAIC,KAAK,EAAgB;EACvE,IAAQC,YAAY,GAAKD,KAAK,CAAtBC,YAAY;EACpB,OAAAC,eAAA,KACGD,YAAY,EAAG;IACdE,KAAK,EAAE,MAAM;IACbC,MAAM,EAAE,MAAM;IACdC,IAAI,EAAE,MAAM;IACZC,QAAQ,EAAE,CAAC;IACXC,SAAS,EAAE,CAAC;IAEZ,yBAAyB,EAAAL,eAAA;MACvBE,MAAM,EAAE;IAAM,MAAAI,MAAA,CAEVR,KAAK,CAACS,MAAM,2BAAAP,eAAA;MACdE,MAAM,EAAE;IAAM,MAAAI,MAAA,CAEVR,KAAK,CAACS,MAAM,sBAAAP,eAAA,CAAAA,eAAA;MACdQ,OAAO,EAAE,MAAM;MACfC,aAAa,EAAE,QAAQ;MACvBP,MAAM,EAAE;IAAM,MAAAI,MAAA,CAEVR,KAAK,CAACS,MAAM,iBAAAD,MAAA,CAAcR,KAAK,CAACS,MAAM,oBAAAP,eAAA;MACxCQ,OAAO,EAAE,MAAM;MACfL,IAAI,EAAE,MAAM;MACZM,aAAa,EAAE,QAAQ;MACvBR,KAAK,EAAE,MAAM;MACbI,SAAS,EAAE;IAAC,MAAAC,MAAA,CAERR,KAAK,CAACS,MAAM,uBAAAP,eAAA;MACdG,IAAI,EAAE,MAAM;MACZE,SAAS,EAAE;IAAC,MAAAC,MAAA,CAERR,KAAK,CAACS,MAAM,qBAAmB;MACjCG,SAAS,EAAE,MAAM;MACjB;MACAC,aAAa,EAAE,CAAC;MAChB;MACA;MACAC,QAAQ,EAAE,iBAAiB;MAE3B,WAAW,EAAAZ,eAAA,CAAAA,eAAA;QACTE,MAAM,EAAE;MAAM,MAAAI,MAAA,CAEVR,KAAK,CAACS,MAAM,mBAAiB;QAC/BM,QAAQ,EAAE,QAAQ;QAClBC,GAAG,EAAE,CAAC;QACNC,MAAM,EAAE;MACV,CAAC,SAEG;QACF;QACA,yBAAyB,EAAE;UACzBb,MAAM,EAAE;QACV;MACF,CAAC;IAEL,CAAC,YAAAI,MAAA,CAGGR,KAAK,CAACS,MAAM,wBAAsB;MACxCJ,IAAI,EAAE,MAAM;MACZa,YAAY,EAAE;IAChB,CAAC;EAIT,CAAC;AAEL,CAAC;AAED,eAAepB,aAAa,CAAC,oBAAoB,EAAWC,QAAQ,CAAC"}
+{"version":3,"names":["genStyleHooks","genStyle","token","componentCls","_defineProperty","width","height","flex","minWidth","minHeight","concat","antCls","maxHeight","display","flexDirection","paddingBottom","overflow","position","top","zIndex","marginBottom"],"sources":["../../../../src/components/ConfigProvider/style/index.ts"],"sourcesContent":["import { genStyleHooks } from 'antd/es/theme/internal';\nimport type { AliasToken, GenerateStyle } from 'antd/es/theme/internal';\nimport type { CSSObject } from '@ant-design/cssinjs';\nimport type { FullToken } from '@ant-design/cssinjs-utils';\n\ntype OverflowTagsToken = FullToken<{ ''?: object }, AliasToken, ''>;\n\nconst genStyle: GenerateStyle<OverflowTagsToken> = (token): CSSObject => {\n  const { componentCls } = token;\n  return {\n    [componentCls]: {\n      width: '100%',\n      height: '100%',\n      flex: 'auto',\n      minWidth: 0,\n      minHeight: 0,\n\n      '.easy-full-height-table': {\n        height: '100%',\n\n        [`& > ${token.antCls}-spin-nested-loading`]: {\n          height: '100%',\n\n          [`& > div > ${token.antCls}-spin`]: {\n            maxHeight: '100%',\n          },\n\n          [`& > ${token.antCls}-spin-container`]: {\n            display: 'flex',\n            flexDirection: 'column',\n            height: '100%',\n\n            [`& > ${token.antCls}-table`]: {\n              display: 'flex',\n              flex: 'auto',\n              flexDirection: 'column',\n              width: '100%',\n              minHeight: 0,\n\n              [`& > ${token.antCls}-table-container`]: {\n                flex: 'auto',\n                minHeight: 0,\n\n                [`& > ${token.antCls}-table-content`]: {\n                  maxHeight: '100%',\n                  // 把容器再多撑高1px，否则会始终显示纵向滚动条\n                  paddingBottom: 1,\n                  // 自动显示纵向滚动条\n                  // stylelint-disable-next-line declaration-no-important\n                  overflow: 'auto !important',\n\n                  '& > table': {\n                    height: '100%',\n\n                    [`${token.antCls}-table-thead`]: {\n                      position: 'sticky',\n                      top: 0,\n                      zIndex: 10,\n                    },\n\n                    td: {\n                      // 当嵌套表格时，还原所有full-height样式，防止子表格受影响\n                      '.easy-full-height-table': {\n                        height: 'auto',\n                      },\n                    },\n                  },\n                },\n              },\n            },\n            [`& > ${token.antCls}-table${token.antCls}-table-empty`]: {\n              [`& > ${token.antCls}-table-container`]: {\n                [`& > ${token.antCls}-table-content`]: {\n                  height: '100%',\n                },\n              },\n            },\n\n            [`& > ${token.antCls}-table-pagination`]: {\n              flex: 'none',\n              marginBottom: 0,\n            },\n          },\n        },\n      },\n    },\n  };\n};\n\nexport default genStyleHooks('EasyConfigProvider' as never, genStyle);\n"],"mappings":";;;;AAAA,SAASA,aAAa,QAAQ,wBAAwB;AAOtD,IAAMC,QAA0C,GAAG,SAA7CA,QAA0CA,CAAIC,KAAK,EAAgB;EACvE,IAAQC,YAAY,GAAKD,KAAK,CAAtBC,YAAY;EACpB,OAAAC,eAAA,KACGD,YAAY,EAAG;IACdE,KAAK,EAAE,MAAM;IACbC,MAAM,EAAE,MAAM;IACdC,IAAI,EAAE,MAAM;IACZC,QAAQ,EAAE,CAAC;IACXC,SAAS,EAAE,CAAC;IAEZ,yBAAyB,EAAAL,eAAA;MACvBE,MAAM,EAAE;IAAM,UAAAI,MAAA,CAENR,KAAK,CAACS,MAAM,2BAAAP,eAAA,CAAAA,eAAA;MAClBE,MAAM,EAAE;IAAM,gBAAAI,MAAA,CAEAR,KAAK,CAACS,MAAM,YAAU;MAClCC,SAAS,EAAE;IACb,CAAC,UAAAF,MAAA,CAEOR,KAAK,CAACS,MAAM,sBAAAP,eAAA,CAAAA,eAAA,CAAAA,eAAA;MAClBS,OAAO,EAAE,MAAM;MACfC,aAAa,EAAE,QAAQ;MACvBR,MAAM,EAAE;IAAM,UAAAI,MAAA,CAENR,KAAK,CAACS,MAAM,aAAAP,eAAA;MAClBS,OAAO,EAAE,MAAM;MACfN,IAAI,EAAE,MAAM;MACZO,aAAa,EAAE,QAAQ;MACvBT,KAAK,EAAE,MAAM;MACbI,SAAS,EAAE;IAAC,UAAAC,MAAA,CAEJR,KAAK,CAACS,MAAM,uBAAAP,eAAA;MAClBG,IAAI,EAAE,MAAM;MACZE,SAAS,EAAE;IAAC,UAAAC,MAAA,CAEJR,KAAK,CAACS,MAAM,qBAAmB;MACrCC,SAAS,EAAE,MAAM;MACjB;MACAG,aAAa,EAAE,CAAC;MAChB;MACA;MACAC,QAAQ,EAAE,iBAAiB;MAE3B,WAAW,EAAAZ,eAAA,CAAAA,eAAA;QACTE,MAAM,EAAE;MAAM,MAAAI,MAAA,CAEVR,KAAK,CAACS,MAAM,mBAAiB;QAC/BM,QAAQ,EAAE,QAAQ;QAClBC,GAAG,EAAE,CAAC;QACNC,MAAM,EAAE;MACV,CAAC,SAEG;QACF;QACA,yBAAyB,EAAE;UACzBb,MAAM,EAAE;QACV;MACF,CAAC;IAEL,CAAC,YAAAI,MAAA,CAGGR,KAAK,CAACS,MAAM,YAAAD,MAAA,CAASR,KAAK,CAACS,MAAM,mBAAAP,eAAA,YAAAM,MAAA,CAC/BR,KAAK,CAACS,MAAM,uBAAAP,eAAA,YAAAM,MAAA,CACVR,KAAK,CAACS,MAAM,qBAAmB;MACrCL,MAAM,EAAE;IACV,CAAC,YAAAI,MAAA,CAIGR,KAAK,CAACS,MAAM,wBAAsB;MACxCJ,IAAI,EAAE,MAAM;MACZa,YAAY,EAAE;IAChB,CAAC;EAIT,CAAC;AAEL,CAAC;AAED,eAAepB,aAAa,CAAC,oBAAoB,EAAWC,QAAQ,CAAC"}

package/es/components/OverflowTags/index.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react';
 import type { TagProps } from 'antd';
 import type { OverflowProps } from 'rc-overflow';
-export interface OverflowTagsProps<T extends Record<string, unknown> = Record<string, unknown>> extends Omit<OverflowProps<T>, 'renderItem'> {
+export interface OverflowTagsProps<T> extends Omit<OverflowProps<T>, 'renderItem'> {
     /**
      * **CN**: 标签集合的数据
      *
@@ -27,25 +27,23 @@ export interface OverflowTagsProps<T extends Record<string, unknown> = Record<st
      */
     renderTag?: OverflowProps<T>['renderItem'];
     /**
-     * **EN**: Custom properties for the default tag rendering function, returning `TagProps`
+     * **EN**: Custom properties for the tag component
      *
-     * **CN**: 对于默认的标签渲染函数，自定义标签的属性，返回`TagProps`
+     * **CN**: 自定义标签的组件属性
      */
-    getTagProps?: (tag: T, tags: T[]) => TagProps;
-    /**
-     * **EN**: Custom properties for the tag component, if `renderTag` is also specified, the latter
-     * will override the former
-     *
-     * **CN**: 自定义标签的组件属性，如果同时指定了`renderTag`，则后者会覆盖前者
-     */
-    tagProps?: TagProps;
+    tagProps?: TagProps | ((tag: T, options: {
+        tags: T[];
+    }) => TagProps);
     /**
      * **EN**: When the number of tags exceeds the maximum display count, an ellipsis tag will be
      * shown. This property is used to set the style of the ellipsis tag.
      *
      * **CN**: 当标签数量超过最大显示数量时，会显示省略号的标签，此属性用于设置省略号标签的样式
      */
-    ellipsisTagProps?: TagProps;
+    ellipsisTagProps?: TagProps | ((tag: T, options: {
+        omittedItems: T[];
+        allTags: T[];
+    }) => TagProps);
     /**
      * **EN**: Whether to use random colors, default is `false`. Note that the tag object can also
      * contain a `color` property to specify the color, and the latter takes precedence.
@@ -70,5 +68,5 @@ export interface OverflowTagsProps<T extends Record<string, unknown> = Record<st
  *     ellipsisTagProps={{ color: 'grey' }}
  *   />;
  */
-declare const OverflowTags: <T extends Record<string, any>>(props: OverflowTagsProps<T>) => import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+declare const OverflowTags: <T>(props: OverflowTagsProps<T>) => import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
 export default OverflowTags;

package/es/components/OverflowTags/index.js

@@ -1,10 +1,10 @@
-function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-var _excluded = ["tags", "randomColors", "getTagName", "getTagKey", "getTagProps", "tagProps", "ellipsisTagProps", "className", "prefixCls"];
+var _excluded = ["tags", "randomColors", "getTagName", "getTagKey", "tagProps", "ellipsisTagProps", "className", "prefixCls"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
@@ -45,7 +45,6 @@ var OverflowTags = function OverflowTags(props) {
     randomColors = props.randomColors,
     getTagNameInProps = props.getTagName,
     getTagKey = props.getTagKey,
-    getTagPropsInProps = props.getTagProps,
     tagProps = props.tagProps,
     ellipsisTagProps = props.ellipsisTagProps,
     className = props.className,
@@ -68,17 +67,25 @@ var OverflowTags = function OverflowTags(props) {
       return token["".concat(color, "-3")];
     });
   }, [token]);
+  var getValue = useCallback(function (tag, field) {
+    if (tag != null && _typeof(tag) === 'object') {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      var record = tag;
+      return record[field];
+    }
+    return undefined;
+  }, []);
   var getTagName = useCallback(function (tag) {
-    var _tag$label;
-    return getTagNameInProps ? getTagNameInProps(tag) : (_tag$label = tag.label) !== null && _tag$label !== void 0 ? _tag$label : tag.name;
-  }, [getTagNameInProps]);
+    var _ref, _getValue;
+    return getTagNameInProps ? getTagNameInProps(tag) : (_ref = (_getValue = getValue(tag, 'label')) !== null && _getValue !== void 0 ? _getValue : getValue(tag, 'name')) !== null && _ref !== void 0 ? _ref : tag === null || tag === void 0 ? void 0 : tag.toString();
+  }, [getTagNameInProps, getValue]);
   var renderTag = function renderTag(item) {
-    var _item$color;
-    var customProps = getTagPropsInProps === null || getTagPropsInProps === void 0 ? void 0 : getTagPropsInProps(item, tags);
-    return /*#__PURE__*/_jsx(Tag, _objectSpread(_objectSpread(_objectSpread({}, tagProps), {}, {
-      icon: item.icon,
-      color: randomColors ? colors[random(0, colors.length - 1)] : (_item$color = item.color) !== null && _item$color !== void 0 ? _item$color : 'default'
-    }, customProps), {}, {
+    return /*#__PURE__*/_jsx(Tag, _objectSpread(_objectSpread({
+      icon: getValue(item, 'icon'),
+      color: randomColors ? colors[random(0, colors.length - 1)] : getValue(item, 'color') || 'default'
+    }, typeof tagProps === 'function' ? tagProps(item, {
+      tags: tags
+    }) : tagProps), {}, {
       children: getTagName(item)
     }));
   };
@@ -91,15 +98,18 @@ var OverflowTags = function OverflowTags(props) {
       return /*#__PURE__*/_jsx(Dropdown, {
         menu: {
           items: omittedItems.map(function (tag) {
-            var _ref, _tag$value;
+            var _ref2, _getValue2;
             return {
               type: 'item',
-              key: getTagKey ? getTagKey(tag) : (_ref = (_tag$value = tag.value) !== null && _tag$value !== void 0 ? _tag$value : tag.id) !== null && _ref !== void 0 ? _ref : getTagName(tag),
+              key: getTagKey ? getTagKey(tag) : (_ref2 = (_getValue2 = getValue(tag, 'value')) !== null && _getValue2 !== void 0 ? _getValue2 : getValue(tag, 'id')) !== null && _ref2 !== void 0 ? _ref2 : getTagName(tag),
               label: getTagName(tag)
             };
           })
         },
-        children: /*#__PURE__*/_jsxs(Tag, _objectSpread(_objectSpread({}, ellipsisTagProps), {}, {
+        children: /*#__PURE__*/_jsxs(Tag, _objectSpread(_objectSpread({}, typeof ellipsisTagProps === 'function' ? ellipsisTagProps(omittedItems[0], {
+          omittedItems: omittedItems,
+          allTags: tags
+        }) : ellipsisTagProps), {}, {
           children: ["+ ", omittedItems.length, "..."]
         }))
       });

package/es/components/OverflowTags/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useContext","useMemo","ConfigProvider","Dropdown","Tag","theme","PresetColors","classNames","Overflow","random","useStyle","jsx","_jsx","jsxs","_jsxs","OverflowTags","props","_props$tags","tags","randomColors","getTagNameInProps","getTagName","getTagKey","getTagPropsInProps","getTagProps","tagProps","ellipsisTagProps","className","prefixClsInProps","prefixCls","restProps","_objectWithoutProperties","_excluded","_theme$useToken","useToken","token","_useContext","ConfigContext","getPrefixCls","_useStyle","_useStyle2","_slicedToArray","wrapCSSVar","hashId","cssVarCls","colors","filter","c","includes","map","color","concat","tag","_tag$label","label","name","renderTag","item","_item$color","customProps","_objectSpread","icon","length","children","data","maxCount","renderItem","renderRest","omittedItems","menu","items","_ref","_tag$value","type","key","value","id"],"sources":["../../../src/components/OverflowTags/index.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport { useCallback, useContext, useMemo } from 'react';\nimport type { TagProps } from 'antd';\nimport { ConfigProvider, Dropdown, Tag, theme } from 'antd';\nimport { PresetColors } from 'antd/es/theme/internal';\nimport classNames from 'classnames';\nimport type { OverflowProps } from 'rc-overflow';\nimport Overflow from 'rc-overflow';\nimport { random } from '../../utils/math';\nimport useStyle from './style';\n\nexport interface OverflowTagsProps<T extends Record<string, unknown> = Record<string, unknown>>\n  extends Omit<OverflowProps<T>, 'renderItem'> {\n  /**\n   * **CN**: 标签集合的数据\n   *\n   * **EN**: Data collection of tags\n   */\n  tags: T[] | undefined;\n  /**\n   * **EN**: Function to get the tag name, default is `tag.label` or `tag.name`\n   *\n   * **CN**: 获取标签名称的函数，默认取`tag.label`或`tag.name`\n   */\n  getTagName?: (tag: T) => ReactNode;\n  /**\n   * **EN**: Function to get the unique identifier of the tag, default is `tag.value` or `tag.id`\n   *\n   * **CN**: 获取标签唯一标识的函数，默认取`tag.value`或`tag.id`\n   */\n  getTagKey?: (tag: T) => React.Key;\n\n  /**\n   * **EN**: Custom tag rendering function\n   *\n   * **CN**: 标签渲染函数\n   */\n  renderTag?: OverflowProps<T>['renderItem'];\n  /**\n   * **EN**: Custom properties for the default tag rendering function, returning `TagProps`\n   *\n   * **CN**: 对于默认的标签渲染函数，自定义标签的属性，返回`TagProps`\n   */\n  getTagProps?: (tag: T, tags: T[]) => TagProps;\n  /**\n   * **EN**: Custom properties for the tag component, if `renderTag` is also specified, the latter\n   * will override the former\n   *\n   * **CN**: 自定义标签的组件属性，如果同时指定了`renderTag`，则后者会覆盖前者\n   */\n  tagProps?: TagProps;\n  /**\n   * **EN**: When the number of tags exceeds the maximum display count, an ellipsis tag will be\n   * shown. This property is used to set the style of the ellipsis tag.\n   *\n   * **CN**: 当标签数量超过最大显示数量时，会显示省略号的标签，此属性用于设置省略号标签的样式\n   */\n  ellipsisTagProps?: TagProps;\n  /**\n   * **EN**: Whether to use random colors, default is `false`. Note that the tag object can also\n   * contain a `color` property to specify the color, and the latter takes precedence.\n   *\n   * **CN**: 是否使用随机颜色，默认`false`。注意，tag对象还可以包含`color`属性来指定颜色，而且后者优先级更高。\n   */\n  randomColors?: boolean;\n}\n\n/**\n * - **EN:** Overflow tags component, used to display a collection of tags that can overflow and be\n *   truncated. It supports displaying tags in a dropdown when the number of tags exceeds the\n *   maximum display count. It also supports custom tag rendering and properties.\n * - **CN:** 溢出标签组件，用于显示一组可以溢出和截断的标签集合。当标签数量超过最大显示数量时，支持在下拉菜单中显示标签。还支持自定义标签渲染和属性。\n *\n * @example\n *   <OverflowTags\n *     tags={[\n *       { value: 1, label: 'Tag1', icon: <Icon1 /> },\n *       { value: 2, label: 'Tag2', icon: <Icon2 /> },\n *     ]}\n *     tagProps={{ color: 'blue' }}\n *     ellipsisTagProps={{ color: 'grey' }}\n *   />;\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst OverflowTags = <T extends Record<string, any>>(props: OverflowTagsProps<T>) => {\n  const {\n    tags = [],\n    randomColors,\n    getTagName: getTagNameInProps,\n    getTagKey,\n    getTagProps: getTagPropsInProps,\n    tagProps,\n    ellipsisTagProps,\n    className,\n    prefixCls: prefixClsInProps,\n    ...restProps\n  } = props;\n  const { token } = theme.useToken();\n  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('easy-overflow-tags', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\n\n  const colors = useMemo(\n    () => PresetColors.filter((c) => !['lime', 'yellow', 'magenta'].includes(c)).map((color) => token[`${color}-3`]),\n    [token]\n  );\n  const getTagName = useCallback(\n    (tag: T) => {\n      return getTagNameInProps ? getTagNameInProps(tag) : (tag.label ?? tag.name);\n    },\n    [getTagNameInProps]\n  );\n  const renderTag = (item: T) => {\n    const customProps = getTagPropsInProps?.(item, tags);\n    return (\n      <Tag\n        {...tagProps}\n        icon={item.icon}\n        color={randomColors ? colors[random(0, colors.length - 1)] : (item.color ?? 'default')}\n        {...customProps}\n      >\n        {getTagName(item)}\n      </Tag>\n    );\n  };\n\n  return wrapCSSVar(\n    <Overflow<T>\n      className={classNames(hashId, cssVarCls, prefixCls, className)}\n      data={tags}\n      maxCount=\"responsive\"\n      renderItem={renderTag}\n      renderRest={(omittedItems) => (\n        <Dropdown\n          menu={{\n            items: omittedItems.map((tag) => ({\n              type: 'item',\n              key: getTagKey ? getTagKey(tag) : (tag.value ?? tag.id ?? getTagName(tag)),\n              label: getTagName(tag),\n            })),\n          }}\n        >\n          <Tag {...ellipsisTagProps}>+ {omittedItems.length}...</Tag>\n        </Dropdown>\n      )}\n      {...restProps}\n    />\n  );\n};\n\nexport default OverflowTags;\n"],"mappings":"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"}
+{"version":3,"names":["useCallback","useContext","useMemo","ConfigProvider","Dropdown","Tag","theme","PresetColors","classNames","Overflow","random","useStyle","jsx","_jsx","jsxs","_jsxs","OverflowTags","props","_props$tags","tags","randomColors","getTagNameInProps","getTagName","getTagKey","tagProps","ellipsisTagProps","className","prefixClsInProps","prefixCls","restProps","_objectWithoutProperties","_excluded","_theme$useToken","useToken","token","_useContext","ConfigContext","getPrefixCls","_useStyle","_useStyle2","_slicedToArray","wrapCSSVar","hashId","cssVarCls","colors","filter","c","includes","map","color","concat","getValue","tag","field","_typeof","record","undefined","_ref","_getValue","toString","renderTag","item","_objectSpread","icon","length","children","data","maxCount","renderItem","renderRest","omittedItems","menu","items","_ref2","_getValue2","type","key","label","allTags"],"sources":["../../../src/components/OverflowTags/index.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport { useCallback, useContext, useMemo } from 'react';\nimport type { TagProps } from 'antd';\nimport { ConfigProvider, Dropdown, Tag, theme } from 'antd';\nimport { PresetColors } from 'antd/es/theme/internal';\nimport classNames from 'classnames';\nimport type { OverflowProps } from 'rc-overflow';\nimport Overflow from 'rc-overflow';\nimport { random } from '../../utils/math';\nimport useStyle from './style';\n\nexport interface OverflowTagsProps<T> extends Omit<OverflowProps<T>, 'renderItem'> {\n  /**\n   * **CN**: 标签集合的数据\n   *\n   * **EN**: Data collection of tags\n   */\n  tags: T[] | undefined;\n  /**\n   * **EN**: Function to get the tag name, default is `tag.label` or `tag.name`\n   *\n   * **CN**: 获取标签名称的函数，默认取`tag.label`或`tag.name`\n   */\n  getTagName?: (tag: T) => ReactNode;\n  /**\n   * **EN**: Function to get the unique identifier of the tag, default is `tag.value` or `tag.id`\n   *\n   * **CN**: 获取标签唯一标识的函数，默认取`tag.value`或`tag.id`\n   */\n  getTagKey?: (tag: T) => React.Key;\n\n  /**\n   * **EN**: Custom tag rendering function\n   *\n   * **CN**: 标签渲染函数\n   */\n  renderTag?: OverflowProps<T>['renderItem'];\n  /**\n   * **EN**: Custom properties for the tag component\n   *\n   * **CN**: 自定义标签的组件属性\n   */\n  tagProps?: TagProps | ((tag: T, options: { tags: T[] }) => TagProps);\n  /**\n   * **EN**: When the number of tags exceeds the maximum display count, an ellipsis tag will be\n   * shown. This property is used to set the style of the ellipsis tag.\n   *\n   * **CN**: 当标签数量超过最大显示数量时，会显示省略号的标签，此属性用于设置省略号标签的样式\n   */\n  ellipsisTagProps?: TagProps | ((tag: T, options: { omittedItems: T[]; allTags: T[] }) => TagProps);\n  /**\n   * **EN**: Whether to use random colors, default is `false`. Note that the tag object can also\n   * contain a `color` property to specify the color, and the latter takes precedence.\n   *\n   * **CN**: 是否使用随机颜色，默认`false`。注意，tag对象还可以包含`color`属性来指定颜色，而且后者优先级更高。\n   */\n  randomColors?: boolean;\n}\n\n/**\n * - **EN:** Overflow tags component, used to display a collection of tags that can overflow and be\n *   truncated. It supports displaying tags in a dropdown when the number of tags exceeds the\n *   maximum display count. It also supports custom tag rendering and properties.\n * - **CN:** 溢出标签组件，用于显示一组可以溢出和截断的标签集合。当标签数量超过最大显示数量时，支持在下拉菜单中显示标签。还支持自定义标签渲染和属性。\n *\n * @example\n *   <OverflowTags\n *     tags={[\n *       { value: 1, label: 'Tag1', icon: <Icon1 /> },\n *       { value: 2, label: 'Tag2', icon: <Icon2 /> },\n *     ]}\n *     tagProps={{ color: 'blue' }}\n *     ellipsisTagProps={{ color: 'grey' }}\n *   />;\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst OverflowTags = <T,>(props: OverflowTagsProps<T>) => {\n  const {\n    tags = [],\n    randomColors,\n    getTagName: getTagNameInProps,\n    getTagKey,\n    tagProps,\n    ellipsisTagProps,\n    className,\n    prefixCls: prefixClsInProps,\n    ...restProps\n  } = props;\n  const { token } = theme.useToken();\n  const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);\n  const prefixCls = getPrefixCls('easy-overflow-tags', prefixClsInProps);\n  const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls);\n\n  const colors = useMemo(\n    () => PresetColors.filter((c) => !['lime', 'yellow', 'magenta'].includes(c)).map((color) => token[`${color}-3`]),\n    [token]\n  );\n  const getValue = useCallback((tag: T | undefined, field: string) => {\n    if (tag != null && typeof tag === 'object') {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const record = tag as Record<string, any>;\n      return record[field];\n    }\n    return undefined;\n  }, []);\n  const getTagName = useCallback(\n    (tag: T) => {\n      return getTagNameInProps\n        ? getTagNameInProps(tag)\n        : (getValue(tag, 'label') ?? getValue(tag, 'name') ?? tag?.toString());\n    },\n    [getTagNameInProps, getValue]\n  );\n  const renderTag = (item: T) => {\n    return (\n      <Tag\n        icon={getValue(item, 'icon')}\n        color={randomColors ? colors[random(0, colors.length - 1)] : getValue(item, 'color') || 'default'}\n        {...(typeof tagProps === 'function' ? tagProps(item, { tags }) : tagProps)}\n      >\n        {getTagName(item)}\n      </Tag>\n    );\n  };\n\n  return wrapCSSVar(\n    <Overflow<T>\n      className={classNames(hashId, cssVarCls, prefixCls, className)}\n      data={tags}\n      maxCount=\"responsive\"\n      renderItem={renderTag}\n      renderRest={(omittedItems) => (\n        <Dropdown\n          menu={{\n            items: omittedItems.map((tag) => ({\n              type: 'item',\n              key: getTagKey ? getTagKey(tag) : (getValue(tag, 'value') ?? getValue(tag, 'id') ?? getTagName(tag)),\n              label: getTagName(tag),\n            })),\n          }}\n        >\n          <Tag\n            {...(typeof ellipsisTagProps === 'function'\n              ? ellipsisTagProps(omittedItems[0], { omittedItems, allTags: tags })\n              : ellipsisTagProps)}\n          >\n            + {omittedItems.length}...\n          </Tag>\n        </Dropdown>\n      )}\n      {...restProps}\n    />\n  );\n};\n\nexport default OverflowTags;\n"],"mappings":"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"}

package/es/hooks/useValidatorBuilder.js

@@ -155,7 +155,9 @@ function buildRuleMeta(options) {
       return !excludeSpecials.includes(v);
     });
     symbols.push(escape(specials.join('')));
-    messages.push(specials.join(t(nameSeparator)));
+    messages.push(t('validation.rule.buildRule.token.specialChars', {
+      value: specials.join(t('validation.rule.buildRule.token.delimiter'))
+    }));
   }
   return {
     symbols: symbols,

package/es/hooks/useValidatorBuilder.js.map

@@ -1 +1 @@
-{"version":3,"names":["useMemo","escape","useT","nameSeparator","useValidatorBuilder","t","props","buildRule","_objectSpread","options","allowed","startsWith","flags","Object","values","some","v","Error","symbols","messages","push","meta","buildRuleMeta","concat","join","prefix","_allowed$min","_allowed$max","min","max","cMin","cMax","length","unshift","message","slice","pattern","RegExp","content","allowedOptions","startsWithOptions","chineseCharacter","chinesePunctuation","letter","lowerLetter","upperLetter","number","excludeSpecials","hyphen","underscore","special","specials","filter","includes"],"sources":["../../src/hooks/useValidatorBuilder.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport escape from 'escape-string-regexp';\nimport useT from './useT';\n\nconst nameSeparator = 'validation.rule.buildRule.token.separator';\n\n/**\n * - **EN:** Get a validation rule builder to build validation rules\n * - **CN:** 获取一个校验规则生成器，用来构建校验规则\n */\nconst useValidatorBuilder = () => {\n  const t = useT();\n  return useMemo(() => (props: BuilderOptions) => buildRule({ ...props, t }), [t]);\n};\n\n/**\n * - **EN:** Build regular expression rules dynamically, compatible with ant-design rules\n * - **CN:** 动态构建正则表达式规则，与 ant-design 的规则兼容\n */\nfunction buildRule(\n  options: BuilderOptions & {\n    /**\n     * - **EN:** Internationalization function\n     * - **CN:** 国际化函数\n     */\n    t: ReturnType<typeof useT>;\n  }\n): ValidatorRule {\n  const { allowed, startsWith, flags, t } = options;\n  if (!Object.values(allowed).some((v) => v === true)) {\n    throw new Error(t('validation.rule.buildRule.includeMandatory'));\n  }\n\n  const symbols: string[] = [];\n  const messages: string[] = [];\n  symbols.push(`^`);\n\n  //  Process startsWith rules\n  if (startsWith) {\n    const meta = buildRuleMeta({\n      flags: startsWith,\n      t,\n    });\n    symbols.push(`[${meta.symbols.join('')}]`);\n    messages.push(\n      t('validation.rule.buildRule.startsWithFormat', {\n        prefix: meta.messages.join(t(nameSeparator)),\n      })\n    );\n  }\n\n  // Process allowed rules\n  {\n    const meta = buildRuleMeta({ flags: allowed, t });\n\n    const min = allowed.min ?? 0;\n    const max = allowed.max ?? 0; // 0 means unlimited\n\n    // If there is startWith in the regular expression, the limited data amount needs to be reduced by 1\n    const cMin = min && startsWith ? min - 1 : min;\n    const cMax = max && startsWith ? max - 1 : max;\n\n    symbols.push(`[${meta.symbols.join('')}]{${cMin},${cMax || ''}}`);\n    if (meta.messages.length === 0) {\n      messages.unshift(``);\n    } else if (meta.messages.length === 1) {\n      messages.unshift(`${meta.messages.join(t(nameSeparator))}`);\n    } else {\n      messages.unshift(`${meta.messages.join(t(nameSeparator))}`);\n    }\n    if (min && max) {\n      messages.push(\n        t('validation.rule.buildRule.rangeLength', {\n          min,\n          max,\n        })\n      );\n    } else {\n      if (min > 1) {\n        messages.push(t('validation.rule.buildRule.minLength', { min }));\n      }\n      if (max) {\n        messages.push(t('validation.rule.buildRule.maxLength', { max }));\n      }\n    }\n  }\n  symbols.push(`$`);\n\n  let message = messages.join('');\n  if (message.startsWith(t(nameSeparator))) {\n    message = message.slice(1);\n  }\n  return {\n    pattern: new RegExp(symbols.join(''), flags),\n    message: t('validation.rule.buildRule.messageFormat', { content: message }),\n    allowedOptions: allowed,\n    startsWithOptions: startsWith,\n    flags,\n  };\n}\n\nfunction buildRuleMeta(options: { flags: RuleRegExpFlags; t: ReturnType<typeof useT> }): RuleMeta {\n  const { flags, t } = options;\n  const symbols: string[] = [];\n  const messages: string[] = [];\n  if (flags.chineseCharacter) {\n    // Chinese characters\n    symbols.push(`\\u4e00-\\u9fa5`);\n    messages.push(t('validation.rule.buildRule.token.chinese'));\n  }\n  if (flags.chinesePunctuation) {\n    // Chinese punctuation\n    symbols.push(`\\u3000-\\u301e`);\n    symbols.push(`\\u3021-\\u303f`);\n    symbols.push(`\\uff00-\\uffef`);\n    messages.push(t('validation.rule.buildRule.token.chinesePunctuation'));\n  }\n  if (flags.letter) {\n    symbols.push(`a-zA-Z`);\n    messages.push(t('validation.rule.buildRule.token.letter'));\n  } else if (flags.lowerLetter) {\n    symbols.push(`a-z`);\n    messages.push(t('validation.rule.buildRule.token.lowerLetter'));\n  } else if (flags.upperLetter) {\n    symbols.push(`A-Z`);\n    messages.push(t('validation.rule.buildRule.token.upperLetter'));\n  }\n  if (flags.number) {\n    symbols.push(`0-9`);\n    messages.push(t('validation.rule.buildRule.token.number'));\n  }\n  const excludeSpecials: string[] = [];\n  if (flags.hyphen) {\n    symbols.push(`\\\\-`);\n    messages.push(`-`);\n    excludeSpecials.push('-');\n  }\n  if (flags.underscore) {\n    symbols.push(`_`);\n    messages.push(`_`);\n    excludeSpecials.push('_');\n  }\n  if (flags.special) {\n    const specials = flags.special.filter((v) => !excludeSpecials.includes(v));\n    symbols.push(escape(specials.join('')));\n    messages.push(specials.join(t(nameSeparator)));\n  }\n  return {\n    symbols,\n    messages,\n  };\n}\n\nexport interface BuilderOptions {\n  /**\n   * - **EN:** The rule of allowed characters\n   * - **CN:** 允许字符的规则\n   */\n  allowed: RuleRegExpFlags;\n  /**\n   * - **EN:** The rule of the starting character\n   * - **CN:** 开头字符的规则\n   */\n  startsWith?: Omit<RuleRegExpFlags, 'min' | 'max'>;\n  /**\n   * - **EN:** Regular expression flags\n   * - **CN:** 正则表达式的标志\n   */\n  flags?: string;\n}\n\nexport interface RuleRegExpFlags {\n  /**\n   * - **EN:** Include lowercase and uppercase Latin characters. If set to true, `lowerLetter` and\n   *   `upperLetter` option are not effective\n   * - **CN:**: 包含大小写拉丁字符。如果设置为true，则`lowerLetter`和`upperLetter`属性不生效\n   */\n\n  letter?: boolean;\n  /**\n   * - **EN:** Include lowercase English letters\n   * - **CN:**: 包含小写英文字符\n   */\n  lowerLetter?: boolean;\n  /**\n   * - **EN:** Include uppercase English letters\n   * - **CN:**: 包含大写英文字符\n   */\n  upperLetter?: boolean;\n  /**\n   * - **EN:** Include Chinese characters\n   * - **CN:** 包含中文字符\n   */\n  chineseCharacter?: boolean;\n  /**\n   * - **EN:** Include Chinese (full-width) punctuation\n   * - **CN:** 包含中文（全角）标点符号\n   */\n  chinesePunctuation?: boolean;\n  /**\n   * - **EN:** Include numbers\n   * - **CN:** 包含数字\n   */\n  number?: boolean;\n  /**\n   * - **EN:** Include hyphens (-)\n   * - **CN:** 包含连字符(-)\n   */\n  hyphen?: boolean;\n  /**\n   * - **EN:** Include underscores (_)\n   * - **CN:** 包含下划线(_)\n   */\n  underscore?: boolean;\n  /**\n   * - **EN:** Include specified special characters\n   * - **CN:** 包含指定的特殊字符\n   */\n  special?: string[];\n  /**\n   * - **EN:** Minimum number of characters\n   * - **CN:** 最小字符数量\n   *\n   * @default 1\n   */\n  min?: number;\n  /**\n   * - **EN:** Maximum number of characters\n   * - **CN:** 最大字符数量\n   */\n  max?: number;\n}\n\nexport type StartsWithRegExpFlags = RuleRegExpFlags;\n\nexport interface ValidatorRule extends Validator {\n  /**\n   * - **EN:** The options of allowed characters\n   * - **CN:** 允许字符的规则设置\n   */\n  allowedOptions: RuleRegExpFlags;\n  /**\n   * - **EN:** The options of the starting character\n   * - **CN:** 开头字符的规则设置\n   */\n  startsWithOptions?: StartsWithRegExpFlags;\n  /**\n   * - **EN:** Regular expression flags\n   * - **CN:** 正则表达式的标志\n   */\n  flags?: string;\n}\n\ninterface RuleMeta {\n  symbols: string[];\n  messages: string[];\n}\n\nexport interface Validator {\n  /**\n   * - **EN:** Regular expression for verification\n   * - **CN:** 校验正则表达式\n   */\n  pattern: RegExp;\n  /**\n   * - **EN:** Prompt message when verification fails\n   * - **CN:** 校验失败时的提示信息\n   */\n  message: string;\n}\n\nexport default useValidatorBuilder;\n"],"mappings":"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"}
+{"version":3,"names":["useMemo","escape","useT","nameSeparator","useValidatorBuilder","t","props","buildRule","_objectSpread","options","allowed","startsWith","flags","Object","values","some","v","Error","symbols","messages","push","meta","buildRuleMeta","concat","join","prefix","_allowed$min","_allowed$max","min","max","cMin","cMax","length","unshift","message","slice","pattern","RegExp","content","allowedOptions","startsWithOptions","chineseCharacter","chinesePunctuation","letter","lowerLetter","upperLetter","number","excludeSpecials","hyphen","underscore","special","specials","filter","includes","value"],"sources":["../../src/hooks/useValidatorBuilder.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport escape from 'escape-string-regexp';\nimport useT from './useT';\n\nconst nameSeparator = 'validation.rule.buildRule.token.separator';\n\n/**\n * - **EN:** Get a validation rule builder to build validation rules\n * - **CN:** 获取一个校验规则生成器，用来构建校验规则\n */\nconst useValidatorBuilder = () => {\n  const t = useT();\n  return useMemo(() => (props: BuilderOptions) => buildRule({ ...props, t }), [t]);\n};\n\n/**\n * - **EN:** Build regular expression rules dynamically, compatible with ant-design rules\n * - **CN:** 动态构建正则表达式规则，与 ant-design 的规则兼容\n */\nfunction buildRule(\n  options: BuilderOptions & {\n    /**\n     * - **EN:** Internationalization function\n     * - **CN:** 国际化函数\n     */\n    t: ReturnType<typeof useT>;\n  }\n): ValidatorRule {\n  const { allowed, startsWith, flags, t } = options;\n  if (!Object.values(allowed).some((v) => v === true)) {\n    throw new Error(t('validation.rule.buildRule.includeMandatory'));\n  }\n\n  const symbols: string[] = [];\n  const messages: string[] = [];\n  symbols.push(`^`);\n\n  //  Process startsWith rules\n  if (startsWith) {\n    const meta = buildRuleMeta({\n      flags: startsWith,\n      t,\n    });\n    symbols.push(`[${meta.symbols.join('')}]`);\n    messages.push(\n      t('validation.rule.buildRule.startsWithFormat', {\n        prefix: meta.messages.join(t(nameSeparator)),\n      })\n    );\n  }\n\n  // Process allowed rules\n  {\n    const meta = buildRuleMeta({ flags: allowed, t });\n\n    const min = allowed.min ?? 0;\n    const max = allowed.max ?? 0; // 0 means unlimited\n\n    // If there is startWith in the regular expression, the limited data amount needs to be reduced by 1\n    const cMin = min && startsWith ? min - 1 : min;\n    const cMax = max && startsWith ? max - 1 : max;\n\n    symbols.push(`[${meta.symbols.join('')}]{${cMin},${cMax || ''}}`);\n    if (meta.messages.length === 0) {\n      messages.unshift(``);\n    } else if (meta.messages.length === 1) {\n      messages.unshift(`${meta.messages.join(t(nameSeparator))}`);\n    } else {\n      messages.unshift(`${meta.messages.join(t(nameSeparator))}`);\n    }\n    if (min && max) {\n      messages.push(\n        t('validation.rule.buildRule.rangeLength', {\n          min,\n          max,\n        })\n      );\n    } else {\n      if (min > 1) {\n        messages.push(t('validation.rule.buildRule.minLength', { min }));\n      }\n      if (max) {\n        messages.push(t('validation.rule.buildRule.maxLength', { max }));\n      }\n    }\n  }\n  symbols.push(`$`);\n\n  let message = messages.join('');\n  if (message.startsWith(t(nameSeparator))) {\n    message = message.slice(1);\n  }\n  return {\n    pattern: new RegExp(symbols.join(''), flags),\n    message: t('validation.rule.buildRule.messageFormat', { content: message }),\n    allowedOptions: allowed,\n    startsWithOptions: startsWith,\n    flags,\n  };\n}\n\nfunction buildRuleMeta(options: { flags: RuleRegExpFlags; t: ReturnType<typeof useT> }): RuleMeta {\n  const { flags, t } = options;\n  const symbols: string[] = [];\n  const messages: string[] = [];\n  if (flags.chineseCharacter) {\n    // Chinese characters\n    symbols.push(`\\u4e00-\\u9fa5`);\n    messages.push(t('validation.rule.buildRule.token.chinese'));\n  }\n  if (flags.chinesePunctuation) {\n    // Chinese punctuation\n    symbols.push(`\\u3000-\\u301e`);\n    symbols.push(`\\u3021-\\u303f`);\n    symbols.push(`\\uff00-\\uffef`);\n    messages.push(t('validation.rule.buildRule.token.chinesePunctuation'));\n  }\n  if (flags.letter) {\n    symbols.push(`a-zA-Z`);\n    messages.push(t('validation.rule.buildRule.token.letter'));\n  } else if (flags.lowerLetter) {\n    symbols.push(`a-z`);\n    messages.push(t('validation.rule.buildRule.token.lowerLetter'));\n  } else if (flags.upperLetter) {\n    symbols.push(`A-Z`);\n    messages.push(t('validation.rule.buildRule.token.upperLetter'));\n  }\n  if (flags.number) {\n    symbols.push(`0-9`);\n    messages.push(t('validation.rule.buildRule.token.number'));\n  }\n  const excludeSpecials: string[] = [];\n  if (flags.hyphen) {\n    symbols.push(`\\\\-`);\n    messages.push(`-`);\n    excludeSpecials.push('-');\n  }\n  if (flags.underscore) {\n    symbols.push(`_`);\n    messages.push(`_`);\n    excludeSpecials.push('_');\n  }\n  if (flags.special) {\n    const specials = flags.special.filter((v) => !excludeSpecials.includes(v));\n    symbols.push(escape(specials.join('')));\n    messages.push(\n      t('validation.rule.buildRule.token.specialChars', {\n        value: specials.join(t('validation.rule.buildRule.token.delimiter')),\n      })\n    );\n  }\n  return {\n    symbols,\n    messages,\n  };\n}\n\nexport interface BuilderOptions {\n  /**\n   * - **EN:** The rule of allowed characters\n   * - **CN:** 允许字符的规则\n   */\n  allowed: RuleRegExpFlags;\n  /**\n   * - **EN:** The rule of the starting character\n   * - **CN:** 开头字符的规则\n   */\n  startsWith?: Omit<RuleRegExpFlags, 'min' | 'max'>;\n  /**\n   * - **EN:** Regular expression flags\n   * - **CN:** 正则表达式的标志\n   */\n  flags?: string;\n}\n\nexport interface RuleRegExpFlags {\n  /**\n   * - **EN:** Include lowercase and uppercase Latin characters. If set to true, `lowerLetter` and\n   *   `upperLetter` option are not effective\n   * - **CN:**: 包含大小写拉丁字符。如果设置为true，则`lowerLetter`和`upperLetter`属性不生效\n   */\n\n  letter?: boolean;\n  /**\n   * - **EN:** Include lowercase English letters\n   * - **CN:**: 包含小写英文字符\n   */\n  lowerLetter?: boolean;\n  /**\n   * - **EN:** Include uppercase English letters\n   * - **CN:**: 包含大写英文字符\n   */\n  upperLetter?: boolean;\n  /**\n   * - **EN:** Include Chinese characters\n   * - **CN:** 包含中文字符\n   */\n  chineseCharacter?: boolean;\n  /**\n   * - **EN:** Include Chinese (full-width) punctuation\n   * - **CN:** 包含中文（全角）标点符号\n   */\n  chinesePunctuation?: boolean;\n  /**\n   * - **EN:** Include numbers\n   * - **CN:** 包含数字\n   */\n  number?: boolean;\n  /**\n   * - **EN:** Include hyphens (-)\n   * - **CN:** 包含连字符(-)\n   */\n  hyphen?: boolean;\n  /**\n   * - **EN:** Include underscores (_)\n   * - **CN:** 包含下划线(_)\n   */\n  underscore?: boolean;\n  /**\n   * - **EN:** Include specified special characters\n   * - **CN:** 包含指定的特殊字符\n   */\n  special?: string[];\n  /**\n   * - **EN:** Minimum number of characters\n   * - **CN:** 最小字符数量\n   *\n   * @default 1\n   */\n  min?: number;\n  /**\n   * - **EN:** Maximum number of characters\n   * - **CN:** 最大字符数量\n   */\n  max?: number;\n}\n\nexport type StartsWithRegExpFlags = RuleRegExpFlags;\n\nexport interface ValidatorRule extends Validator {\n  /**\n   * - **EN:** The options of allowed characters\n   * - **CN:** 允许字符的规则设置\n   */\n  allowedOptions: RuleRegExpFlags;\n  /**\n   * - **EN:** The options of the starting character\n   * - **CN:** 开头字符的规则设置\n   */\n  startsWithOptions?: StartsWithRegExpFlags;\n  /**\n   * - **EN:** Regular expression flags\n   * - **CN:** 正则表达式的标志\n   */\n  flags?: string;\n}\n\ninterface RuleMeta {\n  symbols: string[];\n  messages: string[];\n}\n\nexport interface Validator {\n  /**\n   * - **EN:** Regular expression for verification\n   * - **CN:** 校验正则表达式\n   */\n  pattern: RegExp;\n  /**\n   * - **EN:** Prompt message when verification fails\n   * - **CN:** 校验失败时的提示信息\n   */\n  message: string;\n}\n\nexport default useValidatorBuilder;\n"],"mappings":"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"}

package/es/locales/index.d.ts

@@ -25,12 +25,14 @@ export declare const resources: {
             readonly 'validation.rule.buildRule.maxLength': ", up to {{max}} characters";
             readonly 'validation.rule.buildRule.rangeLength': ", {{min}}~{{max}} characters";
             readonly 'validation.rule.buildRule.token.separator': ", ";
+            readonly 'validation.rule.buildRule.token.delimiter': "";
             readonly 'validation.rule.buildRule.token.chinese': "Chinese characters";
             readonly 'validation.rule.buildRule.token.chinesePunctuation': "Chinese punctuation";
             readonly 'validation.rule.buildRule.token.letter': "letter";
             readonly 'validation.rule.buildRule.token.lowerLetter': "lowercase letter";
             readonly 'validation.rule.buildRule.token.upperLetter': "uppercase letter";
             readonly 'validation.rule.buildRule.token.number': "number";
+            readonly 'validation.rule.buildRule.token.specialChars': "special characters ({{-value}})";
             readonly 'hooks.useUserMedia.microphone': "Microphone";
             readonly 'hooks.useUserMedia.camera': "Camera";
             readonly 'hooks.featureName.microphone': "Speech";
@@ -75,12 +77,14 @@ export declare const resources: {
             readonly 'validation.rule.buildRule.maxLength': ", up to {{max}} characters";
             readonly 'validation.rule.buildRule.rangeLength': ", {{min}}~{{max}} characters";
             readonly 'validation.rule.buildRule.token.separator': ", ";
+            readonly 'validation.rule.buildRule.token.delimiter': "";
             readonly 'validation.rule.buildRule.token.chinese': "Chinese characters";
             readonly 'validation.rule.buildRule.token.chinesePunctuation': "Chinese punctuation";
             readonly 'validation.rule.buildRule.token.letter': "letter";
             readonly 'validation.rule.buildRule.token.lowerLetter': "lowercase letter";
             readonly 'validation.rule.buildRule.token.upperLetter': "uppercase letter";
             readonly 'validation.rule.buildRule.token.number': "number";
+            readonly 'validation.rule.buildRule.token.specialChars': "special characters ({{-value}})";
             readonly 'hooks.useUserMedia.microphone': "Microphone";
             readonly 'hooks.useUserMedia.camera': "Camera";
             readonly 'hooks.featureName.microphone': "Speech";
@@ -125,12 +129,14 @@ export declare const resources: {
             readonly 'validation.rule.buildRule.maxLength': "，{{max}}字符以内";
             readonly 'validation.rule.buildRule.rangeLength': "，{{min}}~{{max}}个字符";
             readonly 'validation.rule.buildRule.token.separator': "、";
+            readonly 'validation.rule.buildRule.token.delimiter': "";
             readonly 'validation.rule.buildRule.token.chinese': "汉字";
             readonly 'validation.rule.buildRule.token.chinesePunctuation': "中文标点";
             readonly 'validation.rule.buildRule.token.letter': "字母";
             readonly 'validation.rule.buildRule.token.lowerLetter': "小写字母";
             readonly 'validation.rule.buildRule.token.upperLetter': "大写字母";
             readonly 'validation.rule.buildRule.token.number': "数字";
+            readonly 'validation.rule.buildRule.token.specialChars': "特殊字符{{-value}}";
             readonly 'hooks.useUserMedia.microphone': "麦克风";
             readonly 'hooks.useUserMedia.camera': "摄像头";
             readonly 'hooks.featureName.microphone': "语音";

package/es/locales/langs/en-US.d.ts

@@ -20,12 +20,14 @@ declare const enUS: {
     readonly 'validation.rule.buildRule.maxLength': ", up to {{max}} characters";
     readonly 'validation.rule.buildRule.rangeLength': ", {{min}}~{{max}} characters";
     readonly 'validation.rule.buildRule.token.separator': ", ";
+    readonly 'validation.rule.buildRule.token.delimiter': "";
     readonly 'validation.rule.buildRule.token.chinese': "Chinese characters";
     readonly 'validation.rule.buildRule.token.chinesePunctuation': "Chinese punctuation";
     readonly 'validation.rule.buildRule.token.letter': "letter";
     readonly 'validation.rule.buildRule.token.lowerLetter': "lowercase letter";
     readonly 'validation.rule.buildRule.token.upperLetter': "uppercase letter";
     readonly 'validation.rule.buildRule.token.number': "number";
+    readonly 'validation.rule.buildRule.token.specialChars': "special characters ({{-value}})";
     readonly 'hooks.useUserMedia.microphone': "Microphone";
     readonly 'hooks.useUserMedia.camera': "Camera";
     readonly 'hooks.featureName.microphone': "Speech";

package/es/locales/langs/en-US.js

@@ -20,12 +20,14 @@ var enUS = {
   'validation.rule.buildRule.maxLength': ", up to {{max}} characters",
   'validation.rule.buildRule.rangeLength': ", {{min}}~{{max}} characters",
   'validation.rule.buildRule.token.separator': ', ',
+  'validation.rule.buildRule.token.delimiter': '',
   'validation.rule.buildRule.token.chinese': 'Chinese characters',
   'validation.rule.buildRule.token.chinesePunctuation': 'Chinese punctuation',
   'validation.rule.buildRule.token.letter': 'letter',
   'validation.rule.buildRule.token.lowerLetter': 'lowercase letter',
   'validation.rule.buildRule.token.upperLetter': 'uppercase letter',
   'validation.rule.buildRule.token.number': 'number',
+  'validation.rule.buildRule.token.specialChars': 'special characters ({{-value}})',
   'hooks.useUserMedia.microphone': 'Microphone',
   'hooks.useUserMedia.camera': 'Camera',
   'hooks.featureName.microphone': 'Speech',