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

package/es/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/es/provider/locale/zh_HK.js

@@ -1,4 +1,4 @@
-export default {
+const zhHK = {
   moneySymbol: 'HK$',
   deleteThisLine: '刪除此項',
   copyThisLine: '複製此項',
@@ -69,6 +69,7 @@ export default {
   },
   editableTable: {
     onlyOneLineEditor: '只能同時編輯一行',
+    onlyAddOneLine: '只能同時新增一行',
     action: {
       save: '保存',
       cancel: '取消',
@@ -80,4 +81,5 @@ export default {
     open: '打開',
     close: '關閉'
   }
-};
+};
+export default zhHK;

package/es/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/es/provider/locale/zh_TW.js

@@ -1,4 +1,4 @@
-export default {
+const zhTW = {
   moneySymbol: 'NT$',
   deleteThisLine: '刪除此项',
   copyThisLine: '複製此项',
@@ -60,6 +60,7 @@ export default {
   },
   editableTable: {
     onlyOneLineEditor: '只能同時編輯一行',
+    onlyAddOneLine: '只能同時新增一行',
     action: {
       save: '保存',
       cancel: '取消',
@@ -71,4 +72,5 @@ export default {
     open: '打開',
     close: '關閉'
   }
-};
+};
+export default zhTW;

package/es/provider/typing/layoutToken.js

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

package/es/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/es/provider/useStyle/index.js

@@ -1,7 +1,7 @@
 import { useStyleRegister } from '@ant-design/cssinjs';
 import { TinyColor } from '@ctrl/tinycolor';
 import { ConfigProvider as AntdConfigProvider, theme as antdTheme } from 'antd';
-import { useContext, useMemo, useRef } from 'react';
+import { useContext, useEffect, useMemo, useRef } from 'react';
 import { ProProvider } from "../index";
 /**
  * 把一个颜色设置一下透明度
@@ -104,16 +104,11 @@ export function useStyle(componentName, styleFn) {
     return getProTokenKey(token);
   }, [token]);
 
-  // Keep path monotonic across toggles to avoid style order issues
-  // when switching dark -> light (back to an old key).
+  // 让 style path 对 "dark -> light 切回旧 key" 保持单调递增，
+  // 避免回到历史 key 时触发 antd cssinjs 的样式顺序错乱。
   const styleKey = [hashId, theme.id, token.themeId, proTokenKey].filter(Boolean).join('-');
-  const lastStyleKeyRef = useRef('');
-  const styleVersionRef = useRef(0);
-  if (lastStyleKeyRef.current !== styleKey) {
-    styleVersionRef.current += 1;
-    lastStyleKeyRef.current = styleKey;
-  }
-  const stylePath = [componentName, styleKey, styleVersionRef.current].filter(Boolean);
+  const styleVersion = useMonotonicVersion(styleKey);
+  const stylePath = [componentName, styleKey, styleVersion].filter(Boolean);
   useStyleRegister({
     theme: theme,
     token,
@@ -124,7 +119,32 @@ export function useStyle(componentName, styleFn) {
     }
   }, () => styleFn(token));
   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 = useRef('');
+  const versionRef = useRef(0);
+  // 渲染阶段：只在 key 变化时临时 +1，便于当次渲染拿到新路径。
+  if (lastKeyRef.current !== key) {
+    versionRef.current += 1;
+  }
+  useEffect(() => {
+    lastKeyRef.current = key;
+  }, [key]);
+  return versionRef.current;
 }

package/es/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;

package/es/provider/utils/merge.js

@@ -1,21 +1,40 @@
-export const merge = (...rest) => {
-  const obj = {};
-  const il = rest.length;
-  let key;
-  let i = 0;
-  for (; i < il; i += 1) {
-    for (key in rest[i]) {
-      if (rest[i].hasOwnProperty(key)) {
-        if (typeof obj[key] === 'object' && typeof rest[i][key] === 'object' && obj[key] !== undefined && obj[key] !== null && !Array.isArray(obj[key]) && !Array.isArray(rest[i][key])) {
-          obj[key] = {
-            ...obj[key],
-            ...rest[i][key]
-          };
-        } else {
-          obj[key] = rest[i][key];
-        }
-      }
+/**
+ * 只合并一层深的对象合并工具。
+ *
+ * 与 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 const shallowMergeOneLevel = (...sources) => {
+  const result = {};
+  for (let i = 0; i < sources.length; i += 1) {
+    const source = sources[i];
+    if (!source) continue;
+    for (const key in source) {
+      if (!Object.prototype.hasOwnProperty.call(source, key)) continue;
+      const prev = result[key];
+      const next = source[key];
+      const canMerge = typeof prev === 'object' && typeof next === 'object' && prev !== null && next !== null && !Array.isArray(prev) && !Array.isArray(next);
+      result[key] = canMerge ? {
+        ...prev,
+        ...next
+      } : next;
     }
   }
-  return obj;
-};
+  return result;
+};
+
+/**
+ * @deprecated 名字误导（会被误以为是 lodash.merge 的递归深合并）。
+ * 请改用语义更明确的 `shallowMergeOneLevel`。本别名仅为兼容老调用点，下个大版本移除。
+ */
+export const merge = shallowMergeOneLevel;

package/es/skeleton/components/Descriptions/index.d.ts

@@ -12,7 +12,7 @@ export type DescriptionsPageSkeletonProps = {
 export declare const TableItemSkeleton: ({ active, header, }: {
     active: boolean;
     header?: boolean | undefined;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => React.JSX.Element;
 /**
  * Table 骨架屏
  *
@@ -24,6 +24,6 @@ export declare const TableSkeleton: React.FC<{
 }>;
 export declare const DescriptionsSkeleton: ({ active }: {
     active: boolean;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => React.JSX.Element;
 declare const DescriptionsPageSkeleton: React.FC<DescriptionsPageSkeletonProps>;
 export default DescriptionsPageSkeleton;

package/es/skeleton/components/List/index.d.ts

@@ -2,7 +2,7 @@ import React from 'react';
 /** 一条分割线 */
 export declare const Line: ({ padding }: {
     padding?: string | number | undefined;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => React.JSX.Element;
 export declare const MediaQueryKeyEnum: {
     xs: number;
     sm: number;
@@ -28,7 +28,7 @@ export declare const ListSkeleton: React.FC<{
  */
 export declare const PageHeaderSkeleton: ({ active }: {
     active: boolean;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => React.JSX.Element;
 export type ListPageSkeletonProps = {
     active?: boolean;
     pageHeader?: false;
@@ -44,6 +44,6 @@ export type ListPageSkeletonProps = {
  */
 export declare const ListToolbarSkeleton: ({ active }: {
     active: boolean;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => React.JSX.Element;
 declare const ListPageSkeleton: React.FC<ListPageSkeletonProps>;
 export default ListPageSkeleton;

package/es/table/Store/Provide.d.ts

@@ -20,46 +20,53 @@ export type UseContainerProps<T = any> = {
     columnsState?: ProTableProps<any, any, any>['columnsState'];
 };
 declare function useContainer(props?: UseContainerProps): {
-    action: ActionType | undefined;
     setAction: (newAction?: ActionType) => void;
-    sortKeyColumns: string[];
     setSortKeyColumns: (keys: string[]) => void;
     propsRef: import("react").MutableRefObject<ProTableProps<any, any, any> | undefined>;
     columnsMap: Record<string, ColumnsState>;
     keyWords: string | undefined;
-    setKeyWords: (k: string | undefined) => void;
+    setKeyWords: import("react").Dispatch<import("react").SetStateAction<string | undefined>>;
     setTableSize: (updater: DensitySize | ((prev: DensitySize) => DensitySize)) => void;
     tableSize: DensitySize;
-    prefixName: any;
     setPrefixName: (name: any) => void;
     setColumnsMap: (updater: Record<string, ColumnsState> | ((prev: Record<string, ColumnsState>) => Record<string, ColumnsState>)) => void;
-    columns: ProTableColumn<any>[] | ProColumns<any, any>[] | undefined;
     rootDomRef: import("react").RefObject<HTMLDivElement>;
     clearPersistenceStorage: () => void;
     defaultColumnKeyMap: Record<string, any>;
+    readonly action: ActionType | undefined;
+    readonly prefixName: string;
+    readonly sortKeyColumns: string[];
 };
 declare const TableContext: import("react").Context<{
-    action: ActionType | undefined;
     setAction: (newAction?: ActionType) => void;
-    sortKeyColumns: string[];
     setSortKeyColumns: (keys: string[]) => void;
     propsRef: import("react").MutableRefObject<ProTableProps<any, any, any> | undefined>;
     columnsMap: Record<string, ColumnsState>;
     keyWords: string | undefined;
-    setKeyWords: (k: string | undefined) => void;
+    setKeyWords: import("react").Dispatch<import("react").SetStateAction<string | undefined>>;
     setTableSize: (updater: DensitySize | ((prev: DensitySize) => DensitySize)) => void;
     tableSize: DensitySize;
-    prefixName: any;
     setPrefixName: (name: any) => void;
     setColumnsMap: (updater: Record<string, ColumnsState> | ((prev: Record<string, ColumnsState>) => Record<string, ColumnsState>)) => void;
-    columns: ProTableColumn<any>[] | ProColumns<any, any>[] | undefined;
     rootDomRef: import("react").RefObject<HTMLDivElement>;
     clearPersistenceStorage: () => void;
     defaultColumnKeyMap: Record<string, any>;
+    readonly action: ActionType | undefined;
+    readonly prefixName: string;
+    readonly sortKeyColumns: string[];
 }>;
 export type ContainerType = typeof useContainer;
-declare const Container: React.FC<{
+declare const TableProvider: React.FC<{
     initValue: UseContainerProps<any>;
     children: React.ReactNode;
 }>;
-export { Container, TableContext };
+/**
+ * @deprecated 使用 `TableProvider` 替代。`Container` 命名过于通用，与
+ * antd Card.Container / 各种 IoC Container 重名严重，已重命名为 `TableProvider`。
+ * 本别名仅用于向后兼容，将在后续主版本中移除。
+ */
+declare const Container: import("react").FC<{
+    initValue: UseContainerProps<any>;
+    children: React.ReactNode;
+}>;
+export { Container, TableContext, TableProvider };