@ant-design/pro-components 3.1.11-0 → 3.1.13-0

package/lib/provider/locale/vi_VN.d.ts

@@ -1,72 +1,3 @@
-declare const _default: {
-    moneySymbol: string;
-    form: {
-        lightFilter: {
-            more: string;
-            clear: string;
-            confirm: string;
-            itemUnit: string;
-        };
-    };
-    tableForm: {
-        search: string;
-        reset: string;
-        submit: string;
-        collapsed: string;
-        expand: string;
-        inputPlaceholder: string;
-        selectPlaceholder: string;
-    };
-    alert: {
-        clear: string;
-        selected: string;
-        item: string;
-    };
-    pagination: {
-        total: {
-            range: string;
-            total: string;
-            item: string;
-        };
-    };
-    tableToolBar: {
-        leftPin: string;
-        rightPin: string;
-        noPin: string;
-        leftFixedTitle: string;
-        rightFixedTitle: string;
-        noFixedTitle: string;
-        reset: string;
-        columnDisplay: string;
-        columnSetting: string;
-        fullScreen: string;
-        exitFullScreen: string;
-        reload: string;
-        density: string;
-        densityDefault: string;
-        densityLarger: string;
-        densityMiddle: string;
-        densitySmall: string;
-    };
-    stepsForm: {
-        next: string;
-        prev: string;
-        submit: string;
-    };
-    loginForm: {
-        submitText: string;
-    };
-    editableTable: {
-        action: {
-            save: string;
-            cancel: string;
-            delete: string;
-            add: string;
-        };
-    };
-    switch: {
-        open: string;
-        close: string;
-    };
-};
-export default _default;
+import type { ProLocale } from './zh_CN';
+declare const viVN: ProLocale;
+export default viVN;

package/lib/provider/locale/vi_VN.js

@@ -4,12 +4,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _default = exports.default = {
+const viVN = {
   moneySymbol: '₫',
+  deleteThisLine: 'Xóa dòng này',
+  copyThisLine: 'Sao chép dòng này',
   form: {
     lightFilter: {
       more: 'Nhiều hơn',
-      clear: 'Trong',
+      clear: 'Xóa',
       confirm: 'Xác nhận',
       itemUnit: 'Mục'
     }
@@ -50,7 +52,7 @@ var _default = exports.default = {
     reload: 'Làm mới',
     density: 'Mật độ hiển thị',
     densityDefault: 'Mặc định',
-    densityLarger: 'Mặc định',
+    densityLarger: 'Lớn hơn',
     densityMiddle: 'Trung bình',
     densitySmall: 'Chật'
   },
@@ -63,8 +65,10 @@ var _default = exports.default = {
     submitText: 'Đăng nhập'
   },
   editableTable: {
+    onlyOneLineEditor: 'Chỉ có thể chỉnh sửa một dòng cùng lúc',
+    onlyAddOneLine: 'Chỉ có thể thêm một dòng cùng lúc',
     action: {
-      save: 'Cứu',
+      save: 'Lưu',
       cancel: 'Hủy',
       delete: 'Xóa',
       add: 'thêm một hàng dữ liệu'
@@ -74,4 +78,5 @@ var _default = exports.default = {
     open: 'mở',
     close: 'đóng'
   }
-};
+};
+var _default = exports.default = viVN;

package/lib/provider/locale/zh_CN.d.ts

@@ -1,75 +1,89 @@
-declare const _default: {
-    moneySymbol: string;
-    deleteThisLine: string;
-    copyThisLine: string;
-    form: {
-        lightFilter: {
-            more: string;
-            clear: string;
-            confirm: string;
-            itemUnit: string;
+/**
+ * zh-CN 是所有 locale 的**基准**：
+ * - 其他 32 个 locale 文件通过 `import type { ProLocale } from './zh_CN'` 复用本文件推断出的类型
+ * - 任何一个 locale 缺字段时，TS 会在编译期直接报错（而不是运行时静默 fallback）
+ *
+ * 新增文案的流程：先在此处加 key，再在各语言文件里补翻译，TS 会全程提示哪些文件还没补。
+ */
+declare const zhCN: {
+    readonly moneySymbol: "¥";
+    readonly deleteThisLine: "删除此项";
+    readonly copyThisLine: "复制此项";
+    readonly form: {
+        readonly lightFilter: {
+            readonly more: "更多筛选";
+            readonly clear: "清除";
+            readonly confirm: "确认";
+            readonly itemUnit: "项";
         };
     };
-    tableForm: {
-        search: string;
-        reset: string;
-        submit: string;
-        collapsed: string;
-        expand: string;
-        inputPlaceholder: string;
-        selectPlaceholder: string;
+    readonly tableForm: {
+        readonly search: "查询";
+        readonly reset: "重置";
+        readonly submit: "提交";
+        readonly collapsed: "展开";
+        readonly expand: "收起";
+        readonly inputPlaceholder: "请输入";
+        readonly selectPlaceholder: "请选择";
     };
-    alert: {
-        clear: string;
-        selected: string;
-        item: string;
+    readonly alert: {
+        readonly clear: "取消选择";
+        readonly selected: "已选择";
+        readonly item: "项";
     };
-    pagination: {
-        total: {
-            range: string;
-            total: string;
-            item: string;
+    readonly pagination: {
+        readonly total: {
+            readonly range: "第";
+            readonly total: "条/总共";
+            readonly item: "条";
         };
     };
-    tableToolBar: {
-        leftPin: string;
-        rightPin: string;
-        noPin: string;
-        leftFixedTitle: string;
-        rightFixedTitle: string;
-        noFixedTitle: string;
-        reset: string;
-        columnDisplay: string;
-        columnSetting: string;
-        fullScreen: string;
-        exitFullScreen: string;
-        reload: string;
-        density: string;
-        densityDefault: string;
-        densityLarger: string;
-        densityMiddle: string;
-        densitySmall: string;
+    readonly tableToolBar: {
+        readonly leftPin: "固定在列首";
+        readonly rightPin: "固定在列尾";
+        readonly noPin: "不固定";
+        readonly leftFixedTitle: "固定在左侧";
+        readonly rightFixedTitle: "固定在右侧";
+        readonly noFixedTitle: "不固定";
+        readonly reset: "重置";
+        readonly columnDisplay: "列展示";
+        readonly columnSetting: "列设置";
+        readonly fullScreen: "全屏";
+        readonly exitFullScreen: "退出全屏";
+        readonly reload: "刷新";
+        readonly density: "密度";
+        readonly densityDefault: "正常";
+        readonly densityLarger: "宽松";
+        readonly densityMiddle: "中等";
+        readonly densitySmall: "紧凑";
     };
-    stepsForm: {
-        next: string;
-        prev: string;
-        submit: string;
+    readonly stepsForm: {
+        readonly next: "下一步";
+        readonly prev: "上一步";
+        readonly submit: "提交";
     };
-    loginForm: {
-        submitText: string;
+    readonly loginForm: {
+        readonly submitText: "登录";
     };
-    editableTable: {
-        onlyOneLineEditor: string;
-        action: {
-            save: string;
-            cancel: string;
-            delete: string;
-            add: string;
+    readonly editableTable: {
+        readonly onlyOneLineEditor: "只能同时编辑一行";
+        readonly onlyAddOneLine: "只能同时新增一行";
+        readonly action: {
+            readonly save: "保存";
+            readonly cancel: "取消";
+            readonly delete: "删除";
+            readonly add: "添加一行数据";
         };
     };
-    switch: {
-        open: string;
-        close: string;
+    readonly switch: {
+        readonly open: "打开";
+        readonly close: "关闭";
     };
 };
-export default _default;
+/** 所有 locale 共享的基准类型，由 zh-CN 推断得出。 */
+export type ProLocale = {
+    -readonly [K in keyof typeof zhCN]: typeof zhCN[K] extends Record<string, any> ? {
+        -readonly [P in keyof typeof zhCN[K]]: any;
+    } : string;
+};
+export default zhCN;

package/lib/provider/locale/zh_CN.js

@@ -4,7 +4,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _default = exports.default = {
+/**
+ * zh-CN 是所有 locale 的**基准**：
+ * - 其他 32 个 locale 文件通过 `import type { ProLocale } from './zh_CN'` 复用本文件推断出的类型
+ * - 任何一个 locale 缺字段时，TS 会在编译期直接报错（而不是运行时静默 fallback）
+ *
+ * 新增文案的流程：先在此处加 key，再在各语言文件里补翻译，TS 会全程提示哪些文件还没补。
+ */
+const zhCN = {
   moneySymbol: '¥',
   deleteThisLine: '删除此项',
   copyThisLine: '复制此项',
@@ -66,6 +73,7 @@ var _default = exports.default = {
   },
   editableTable: {
     onlyOneLineEditor: '只能同时编辑一行',
+    onlyAddOneLine: '只能同时新增一行',
     action: {
       save: '保存',
       cancel: '取消',
@@ -77,4 +85,7 @@ var _default = exports.default = {
     open: '打开',
     close: '关闭'
   }
-};
+};
+
+/** 所有 locale 共享的基准类型，由 zh-CN 推断得出。 */
+var _default = exports.default = zhCN;

package/lib/provider/locale/zh_HK.d.ts

@@ -1,75 +1,3 @@
-declare const _default: {
-    moneySymbol: string;
-    deleteThisLine: string;
-    copyThisLine: string;
-    form: {
-        lightFilter: {
-            more: string;
-            clear: string;
-            confirm: string;
-            itemUnit: string;
-        };
-    };
-    tableForm: {
-        search: string;
-        reset: string;
-        submit: string;
-        collapsed: string;
-        expand: string;
-        inputPlaceholder: string;
-        selectPlaceholder: string;
-    };
-    alert: {
-        clear: string;
-        selected: string;
-        item: string;
-    };
-    pagination: {
-        total: {
-            range: string;
-            total: string;
-            item: string;
-        };
-    };
-    tableToolBar: {
-        leftPin: string;
-        rightPin: string;
-        noPin: string;
-        leftFixedTitle: string;
-        rightFixedTitle: string;
-        noFixedTitle: string;
-        reset: string;
-        columnDisplay: string;
-        columnSetting: string;
-        fullScreen: string;
-        exitFullScreen: string;
-        reload: string;
-        density: string;
-        densityDefault: string;
-        densityLarger: string;
-        densityMiddle: string;
-        densitySmall: string;
-    };
-    stepsForm: {
-        next: string;
-        prev: string;
-        submit: string;
-    };
-    loginForm: {
-        submitText: string;
-    };
-    editableTable: {
-        onlyOneLineEditor: string;
-        action: {
-            save: string;
-            cancel: string;
-            delete: string;
-            add: string;
-        };
-    };
-    switch: {
-        open: string;
-        close: string;
-    };
-};
-export default _default;
+import type { ProLocale } from './zh_CN';
+declare const zhHK: ProLocale;
+export default zhHK;

package/lib/provider/locale/zh_HK.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _default = exports.default = {
+const zhHK = {
   moneySymbol: 'HK$',
   deleteThisLine: '刪除此項',
   copyThisLine: '複製此項',
@@ -75,6 +75,7 @@ var _default = exports.default = {
   },
   editableTable: {
     onlyOneLineEditor: '只能同時編輯一行',
+    onlyAddOneLine: '只能同時新增一行',
     action: {
       save: '保存',
       cancel: '取消',
@@ -86,4 +87,5 @@ var _default = exports.default = {
     open: '打開',
     close: '關閉'
   }
-};
+};
+var _default = exports.default = zhHK;

package/lib/provider/locale/zh_TW.d.ts

@@ -1,75 +1,3 @@
-declare const _default: {
-    moneySymbol: string;
-    deleteThisLine: string;
-    copyThisLine: string;
-    form: {
-        lightFilter: {
-            more: string;
-            clear: string;
-            confirm: string;
-            itemUnit: string;
-        };
-    };
-    tableForm: {
-        search: string;
-        reset: string;
-        submit: string;
-        collapsed: string;
-        expand: string;
-        inputPlaceholder: string;
-        selectPlaceholder: string;
-    };
-    alert: {
-        clear: string;
-        selected: string;
-        item: string;
-    };
-    pagination: {
-        total: {
-            range: string;
-            total: string;
-            item: string;
-        };
-    };
-    tableToolBar: {
-        leftPin: string;
-        rightPin: string;
-        noPin: string;
-        leftFixedTitle: string;
-        rightFixedTitle: string;
-        noFixedTitle: string;
-        reset: string;
-        columnDisplay: string;
-        columnSetting: string;
-        fullScreen: string;
-        exitFullScreen: string;
-        reload: string;
-        density: string;
-        densityDefault: string;
-        densityLarger: string;
-        densityMiddle: string;
-        densitySmall: string;
-    };
-    stepsForm: {
-        next: string;
-        prev: string;
-        submit: string;
-    };
-    loginForm: {
-        submitText: string;
-    };
-    editableTable: {
-        onlyOneLineEditor: string;
-        action: {
-            save: string;
-            cancel: string;
-            delete: string;
-            add: string;
-        };
-    };
-    switch: {
-        open: string;
-        close: string;
-    };
-};
-export default _default;
+import type { ProLocale } from './zh_CN';
+declare const zhTW: ProLocale;
+export default zhTW;

package/lib/provider/locale/zh_TW.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _default = exports.default = {
+const zhTW = {
   moneySymbol: 'NT$',
   deleteThisLine: '刪除此项',
   copyThisLine: '複製此项',
@@ -66,6 +66,7 @@ var _default = exports.default = {
   },
   editableTable: {
     onlyOneLineEditor: '只能同時編輯一行',
+    onlyAddOneLine: '只能同時新增一行',
     action: {
       save: '保存',
       cancel: '取消',
@@ -77,4 +78,5 @@ var _default = exports.default = {
     open: '打開',
     close: '關閉'
   }
-};
+};
+var _default = exports.default = zhTW;

package/lib/provider/typing/layoutToken.js

@@ -13,7 +13,6 @@ const getLayoutDesignToken = (designTokens, antdToken) => {
   return {
     bgLayout: `linear-gradient(${antdToken.colorBgContainer}, ${antdToken.colorBgLayout} 28%)`,
     colorTextAppListIcon: antdToken.colorTextSecondary,
-    appListIconHoverBgColor: finalDesignTokens?.sider?.colorBgMenuItemSelected,
     colorBgAppListIconHover: (0, _useStyle.setAlpha)(antdToken.colorTextBase, 0.04),
     colorTextAppListIconHover: antdToken.colorTextBase,
     ...finalDesignTokens,

package/lib/provider/useStyle/index.d.ts

@@ -48,6 +48,11 @@ export declare const operationUnit: (token: ProAliasToken) => CSSObject;
  * @returns UseStyleResult
  */
 export declare function useStyle(componentName: string, styleFn: (token: ProAliasToken) => CSSInterpolation): {
+    /**
+     * @deprecated v2 起样式通过 `useStyleRegister` 以副作用方式注入，
+     * SSR 由 antd 的 `extractStyle` 接管。本函数已退化为身份函数，仅为兼容现存调用点，
+     * 下个大版本会从返回值中移除。新代码直接 `return <div className={hashId}>...</div>` 即可。
+     */
     wrapSSR: (node: React.ReactElement) => React.ReactElement<any, string | React.JSXElementConstructor<any>>;
     hashId: string;
 };

package/lib/provider/useStyle/index.js

@@ -61,6 +61,23 @@ const operationUnit = token => ({
     color: token.colorLinkActive
   }
 });
+exports.operationUnit = operationUnit;
+const hashString = input => {
+  let hash = 5381;
+  for (let i = 0; i < input.length; i += 1) {
+    hash = hash * 33 ^ input.charCodeAt(i);
+  }
+  return (hash >>> 0).toString(36);
+};
+const getProTokenKey = token => {
+  try {
+    // ProProvider exposes finalToken instead of useCacheToken token,
+    // so build a stable key from Pro token payload directly.
+    return hashString(JSON.stringify(token));
+  } catch {
+    return '';
+  }
+};
 
 /**
  * 封装了一下 antd 的 useStyle
@@ -68,7 +85,6 @@ const operationUnit = token => ({
  * @param styleFn {GenerateStyle} 生成样式的函数
  * @returns UseStyleResult
  */
-exports.operationUnit = operationUnit;
 function useStyle(componentName, styleFn) {
   let {
     token = {},
@@ -94,19 +110,52 @@ function useStyle(componentName, styleFn) {
   token.antCls = `.${getPrefixCls()}`;
 
   // Register styles (side effect only in v2)
+  // Keep path sensitive to both antd theme and Pro token updates.
+  const proTokenKey = (0, _react.useMemo)(() => {
+    return getProTokenKey(token);
+  }, [token]);
+
+  // 让 style path 对 "dark -> light 切回旧 key" 保持单调递增，
+  // 避免回到历史 key 时触发 antd cssinjs 的样式顺序错乱。
+  const styleKey = [hashId, theme.id, token.themeId, proTokenKey].filter(Boolean).join('-');
+  const styleVersion = useMonotonicVersion(styleKey);
+  const stylePath = [componentName, styleKey, styleVersion].filter(Boolean);
   (0, _cssinjs.useStyleRegister)({
     theme: theme,
     token,
-    path: [componentName],
+    path: stylePath,
     nonce: csp?.nonce,
     layer: {
       name: 'antd-pro'
     }
   }, () => styleFn(token));
-
-  // Return identity wrapper and hashId
   return {
+    /**
+     * @deprecated v2 起样式通过 `useStyleRegister` 以副作用方式注入，
+     * SSR 由 antd 的 `extractStyle` 接管。本函数已退化为身份函数，仅为兼容现存调用点，
+     * 下个大版本会从返回值中移除。新代码直接 `return <div className={hashId}>...</div>` 即可。
+     */
     wrapSSR: node => node,
     hashId: hashed ? hashId : ''
   };
+}
+
+/**
+ * 返回一个只增不减的版本号；每当输入 `key` 变化时递增。
+ *
+ * 为什么不直接在渲染阶段写 ref：React 并发模式下单次提交可能经历多次渲染，
+ * 直接在渲染阶段写 ref 会把版本号推得比预期大。因此这里渲染阶段只读、
+ * 把持久化推迟到 commit 阶段的 `useEffect` 里完成。
+ */
+function useMonotonicVersion(key) {
+  const lastKeyRef = (0, _react.useRef)('');
+  const versionRef = (0, _react.useRef)(0);
+  // 渲染阶段：只在 key 变化时临时 +1，便于当次渲染拿到新路径。
+  if (lastKeyRef.current !== key) {
+    versionRef.current += 1;
+  }
+  (0, _react.useEffect)(() => {
+    lastKeyRef.current = key;
+  }, [key]);
+  return versionRef.current;
 }

package/lib/provider/utils/merge.d.ts

@@ -1 +1,22 @@
-export declare const merge: <T extends Record<string, any>>(...rest: any[]) => T;
+/**
+ * 只合并一层深的对象合并工具。
+ *
+ * 与 lodash.merge 的区别：仅对**顶层同名的普通对象**做一次 `{...a, ...b}` 展开，
+ * 再深一层的嵌套对象会被整体覆盖而不是继续递归合并。数组一律走覆盖语义。
+ *
+ * 在 ProProvider 里用来合并 token 时足够了，因为 layout token 的深合并已经
+ * 在 `getLayoutDesignToken` 里提前做过。
+ *
+ * @example
+ *   shallowMergeOneLevel({ a: { x: 1 } }, { a: { y: 2 } })
+ *   // => { a: { x: 1, y: 2 } }  ← 顶层对象合并
+ *
+ *   shallowMergeOneLevel({ a: { b: { x: 1 } } }, { a: { b: { y: 2 } } })
+ *   // => { a: { b: { y: 2 } } } ← 二层对象被覆盖，不会深合并
+ */
+export declare const shallowMergeOneLevel: <T extends Record<string, any>>(...sources: any[]) => T;
+/**
+ * @deprecated 名字误导（会被误以为是 lodash.merge 的递归深合并）。
+ * 请改用语义更明确的 `shallowMergeOneLevel`。本别名仅为兼容老调用点，下个大版本移除。
+ */
+export declare const merge: <T extends Record<string, any>>(...sources: any[]) => T;