@ant-design/agentic-ui 2.29.24 → 2.29.26

package/dist/Bubble/type.d.ts

@@ -6,17 +6,81 @@ import { BaseStyleProps, BubbleMetaData, MessageBubbleData, MultiClassNameProps,
 import type { UseSpeechAdapter } from './MessagesContent/VoiceButton';
 import { BubbleExtraProps } from './types/BubbleExtra';
 import { DocInfoListProps } from './types/DocInfo';
+/**
+ * 气泡命令式操作句柄
+ * @description 通过 bubbleRef 暴露给父组件的命令式方法
+ */
+export interface BubbleImperativeHandle {
+    /** 更新消息项数据 */
+    setMessageItem?: (id: string, data: Partial<MessageBubbleData>) => void;
+}
 /**
  * 基础样式属性
- * @deprecated 请使用 BaseStyleProps from '../Types'
+ * @deprecated @since 2.29.0 请使用 BaseStyleProps from '../Types'
  */
 export type BubbleStyleProps = BaseStyleProps;
+/**
+ * 气泡样式配置（简洁版）
+ * @description 推荐使用的气泡样式配置接口，属性名不带 bubble 前缀
+ */
+export interface BubbleSlotStyles {
+    /** 气泡根容器 */
+    root?: React.CSSProperties;
+    /** 头像标题区域 */
+    avatarTitle?: React.CSSProperties;
+    /** 主容器 */
+    container?: React.CSSProperties;
+    /** 加载图标 */
+    loadingIcon?: React.CSSProperties;
+    /** 名称区域 */
+    name?: React.CSSProperties;
+    /** 内容 */
+    content?: React.CSSProperties;
+    /** 内容前置区域 */
+    before?: React.CSSProperties;
+    /** 内容后置区域 */
+    after?: React.CSSProperties;
+    /** 标题 */
+    title?: React.CSSProperties;
+    /** 头像 */
+    avatar?: React.CSSProperties;
+    /** 额外内容 */
+    extra?: React.CSSProperties;
+}
+/**
+ * 气泡类名配置（简洁版）
+ * @description 推荐使用的气泡类名配置接口，属性名不带 bubble 前缀
+ */
+export interface BubbleSlotClassNames {
+    /** 气泡根容器 */
+    root?: string;
+    /** 头像标题区域 */
+    avatarTitle?: string;
+    /** 主容器 */
+    container?: string;
+    /** 加载图标 */
+    loadingIcon?: string;
+    /** 名称区域 */
+    name?: string;
+    /** 内容 */
+    content?: string;
+    /** 内容前置区域 */
+    before?: string;
+    /** 内容后置区域 */
+    after?: string;
+    /** 标题 */
+    title?: string;
+    /** 头像 */
+    avatar?: string;
+    /** 额外内容 */
+    extra?: string;
+}
 /**
  * 气泡样式配置
  * @description 气泡组件各部分的样式配置
+ * @deprecated @since 2.30.0 属性名带有冗余的 bubble 前缀，建议使用 BubbleSlotStyles 替代
  */
 export interface BubbleStyles {
-    [key: string]: React.CSSProperties | undefined;
     /**
      * 气泡根容器的自定义样式
      */
@@ -61,13 +125,25 @@ export interface BubbleStyles {
      * 额外内容的自定义样式
      */
     bubbleListItemExtraStyle?: React.CSSProperties;
+    /**
+     * 气泡列表项的自定义样式
+     */
+    bubbleListItemStyle?: React.CSSProperties;
+    /**
+     * 左侧气泡内容的自定义样式
+     */
+    bubbleListLeftItemContentStyle?: React.CSSProperties;
+    /**
+     * 右侧气泡内容的自定义样式
+     */
+    bubbleListRightItemContentStyle?: React.CSSProperties;
 }
 /**
  * 气泡类名配置
  * @description 气泡组件各部分的类名配置
+ * @deprecated @since 2.30.0 属性名带有冗余的 bubble 前缀，建议使用 BubbleSlotClassNames 替代
  */
 export interface BubbleClassNames {
-    [key: string]: string | undefined;
     /**
      * 气泡根容器的自定义类名
      */
@@ -112,6 +188,10 @@ export interface BubbleClassNames {
      * 额外内容的自定义类名
      */
     bubbleListItemExtraClassName?: string;
+    /**
+     * 气泡列表项的自定义类名
+     */
+    bubbleListItemClassName?: string;
 }
 /**
  * 气泡项样式属性
@@ -208,7 +288,7 @@ export interface BubbleProps<T = Record<string, any>> extends BubbleItemStylePro
     /**
      * 列表引用
      */
-    bubbleListRef?: any;
+    bubbleListRef?: React.RefObject<HTMLDivElement>;
     /**
      * 是否只读
      */
@@ -224,10 +304,10 @@ export interface BubbleProps<T = Record<string, any>> extends BubbleItemStylePro
     /**
      * 依赖项数组
      */
-    deps?: any[];
+    deps?: unknown[];
     /**
      * 不喜欢回调
-     * @deprecated 请使用 onDislike 替代（符合命名规范），但为保持兼容性暂时保留
+     * @deprecated @since 2.29.0 请使用 onDislike 替代（符合命名规范），但为保持兼容性暂时保留
      */
     onDisLike?: (bubble: MessageBubbleData<Record<string, any>>) => Promise<void> | void;
     /** 不喜欢回调 */
@@ -239,7 +319,7 @@ export interface BubbleProps<T = Record<string, any>> extends BubbleItemStylePro
     /**
      * 取消点赞的回调函数
      * @description 当用户点击取消点赞按钮时触发
-     * @deprecated 请使用 onLikeCancel 替代（符合命名规范），但为保持兼容性暂时保留
+     * @deprecated @since 2.29.0 请使用 onLikeCancel 替代（符合命名规范），但为保持兼容性暂时保留
      * @callback
      * @optional
      */
@@ -261,8 +341,9 @@ export interface BubbleProps<T = Record<string, any>> extends BubbleItemStylePro
     };
     /**
      * 气泡引用
+     * @description 支持命令式操作的气泡实例引用，包含 setMessageItem 等方法
      */
-    bubbleRef?: any;
+    bubbleRef?: React.MutableRefObject<BubbleImperativeHandle | null | undefined>;
     /**
      * 控制复制按钮的显示
      * @description 控制复制按钮是否显示的函数或布尔值
@@ -331,5 +412,12 @@ export interface BubbleProps<T = Record<string, any>> extends BubbleItemStylePro
         renderFileMoreAction?: React.ReactNode | ((file: AttachmentFile) => React.ReactNode) | (() => React.ReactNode) | (() => (file: AttachmentFile) => React.ReactNode);
     };
     userBubbleProps?: BubbleProps;
+    /**
+     * AI 气泡的属性配置
+     */
+    aiBubbleProps?: BubbleProps;
+    /**
+     * @deprecated @since 2.30.0 请使用 aiBubbleProps 替代（符合命名规范）
+     */
     aIBubbleProps?: BubbleProps;
 }

package/dist/Bubble/types/BubbleExtra.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { MessageBubbleData, WithFalse } from '../../Types';
 export interface SimpleBubbleProps<T = Record<string, any>> {
     originData?: T & MessageBubbleData;
-    [key: string]: any;
+    id?: string;
+    placement?: 'left' | 'right';
+    readonly?: boolean;
 }
 /**
  * 聊天项额外操作组件的属性接口
@@ -20,7 +22,7 @@ export type BubbleExtraProps = {
     /**
      * 点踩的回调函数
      * @description 当用户点击点踩按钮时触发
-     * @deprecated 请使用 onDislike 替代（符合命名规范），但为保持兼容性暂时保留
+     * @deprecated @since 2.29.0 请使用 onDislike 替代（符合命名规范），但为保持兼容性暂时保留
      * @callback
      * @optional
      */
@@ -37,7 +39,7 @@ export type BubbleExtraProps = {
     /**
      * 取消点赞的回调函数
      * @description 当用户点击取消点赞按钮时触发
-     * @deprecated 请使用 onLikeCancel 替代（符合命名规范），但为保持兼容性暂时保留
+     * @deprecated @since 2.29.0 请使用 onLikeCancel 替代（符合命名规范），但为保持兼容性暂时保留
      * @callback
      * @optional
      */
@@ -129,7 +131,7 @@ export type BubbleExtraProps = {
      * @param defaultDoms - 默认的操作按钮 DOM 节点
      * @returns 自定义的额外操作区域 React 节点
      * @optional
-     * @deprecated 此属性当前未被使用，extraRender 功能在 MessagesContent 层级处理
+     * @deprecated @since 2.29.0 此属性当前未被使用，extraRender 功能在 MessagesContent 层级处理
      */
     render?: WithFalse<(props: SimpleBubbleProps<Record<string, any>>, defaultDoms: React.ReactNode) => React.ReactNode>;
     pure?: boolean;

package/dist/ChatBootPage/ButtonTab.js

@@ -11,7 +11,7 @@ function _define_property(obj, key, value) {
     }
     return obj;
 }
-import classNames from "classnames";
+import classNames from "clsx";
 import React, { memo, useCallback } from "react";
 import { useStyle } from "./ButtonTabStyle";
 var ButtonTabComponent = function ButtonTabComponent(param) {

package/dist/ChatBootPage/CaseReply.js

@@ -46,7 +46,7 @@ function _unsupported_iterable_to_array(o, minLen) {
 }
 import { ArrowRight } from "@sofa-design/icons";
 import { ConfigProvider } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import React, { memo, useCallback, useContext, useState } from "react";
 import { useStyle } from "./CaseReplyStyle";
 var CaseReplyComponent = function CaseReplyComponent(param) {

package/dist/ChatBootPage/Title.js

@@ -1,5 +1,5 @@
 import { ConfigProvider } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import React, { memo, useContext } from "react";
 import { useStyle } from "./style";
 var TitleComponent = function TitleComponent(param) {

package/dist/ChatLayout/index.js

@@ -27,7 +27,7 @@ function _object_spread(target) {
     return target;
 }
 import { ConfigProvider } from "antd";
-import clsx from "classnames";
+import clsx from "clsx";
 import React, { forwardRef, memo, useContext, useImperativeHandle, useRef } from "react";
 import { LayoutHeader } from "../Components/LayoutHeader";
 import useAutoScroll from "../Hooks/useAutoScroll";

package/dist/Components/ActionIconBox/index.d.ts

@@ -11,7 +11,7 @@ export type ActionIconBoxProps = {
     className?: string;
     borderLess?: boolean;
     /**
-     * @deprecated 请使用 isLoading 代替
+     * @deprecated @since 2.29.0 请使用 isLoading 代替
      * @description 已废弃，将在未来版本移除
      */
     loading?: boolean;

package/dist/Components/ActionIconBox/index.js

@@ -226,8 +226,8 @@ function _ts_generator(thisArg, body) {
 }
 import { LoadingOutlined } from "@ant-design/icons";
 import { ConfigProvider, Tooltip } from "antd";
-import cx from "classnames";
-import { isFunction } from "lodash";
+import cx from "clsx";
+import { isFunction } from "lodash-es";
 import { useMergedState } from "rc-util";
 import React, { useContext, useEffect, useMemo, useState } from "react";
 import { useStyle } from "./style";

package/dist/Components/ActionItemBox/ActionItemBox.js

@@ -27,7 +27,7 @@ function _object_spread(target) {
     return target;
 }
 import { ConfigProvider } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import { motion } from "framer-motion";
 import React, { useContext, useEffect } from "react";
 import { useStyle } from "./style";

package/dist/Components/Button/IconButton/index.d.ts

@@ -8,7 +8,7 @@ export interface IconButtonProps {
     elevated?: boolean;
     size?: 'base' | 'sm' | 'xs';
     /**
-     * @deprecated 请使用 isLoading 代替
+     * @deprecated @since 2.29.0 请使用 isLoading 代替
      * @description 已废弃，将在未来版本移除
      */
     loading?: boolean;

package/dist/Components/Button/IconButton/index.js

@@ -12,7 +12,7 @@ function _define_property(obj, key, value) {
     return obj;
 }
 import { Button, ConfigProvider, Tooltip } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import React, { useContext } from "react";
 import { useStyle } from "./style";
 export var IconButton = function IconButton(param) {

package/dist/Components/Button/SwitchButton/index.js

@@ -187,7 +187,7 @@ function _ts_generator(thisArg, body) {
 }
 import { ChevronDown, ChevronUp } from "@sofa-design/icons";
 import { Button, ConfigProvider } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import React, { useContext, useEffect, useState } from "react";
 import { useStyle } from "./style";
 export var SwitchButton = function SwitchButton(param) {

package/dist/Components/Button/ToggleButton/index.js

@@ -12,7 +12,7 @@ function _define_property(obj, key, value) {
     return obj;
 }
 import { Button, ConfigProvider } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import React, { useContext } from "react";
 import { useStyle } from "./style";
 export var ToggleButton = function ToggleButton(param) {

package/dist/Components/GradientText/index.js

@@ -1,5 +1,5 @@
 import { ConfigProvider } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import React, { useContext } from "react";
 import { useGradientTextStyle } from "./style";
 export function GradientText(param) {

package/dist/Components/LayoutHeader/index.js

@@ -46,7 +46,7 @@ function _unsupported_iterable_to_array(o, minLen) {
 }
 import { LaptopMinimal, PanelLeftFill, PanelLeftFillFold, SquareArrowOutUpRight } from "@sofa-design/icons";
 import { Button, ConfigProvider } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import { useMergedState } from "rc-util";
 import React, { useContext } from "react";
 import { I18nContext } from "../../I18n";

package/dist/Components/Loading/Loading.js

@@ -27,8 +27,8 @@ function _object_spread(target) {
     return target;
 }
 import { ConfigProvider } from "antd";
-import classNames from "classnames";
-import { isString } from "lodash";
+import classNames from "clsx";
+import { isString } from "lodash-es";
 import React, { useContext } from "react";
 import { TextLoading } from "../lotties";
 import Indicator from "./Indicator";

package/dist/Components/Robot/index.js

@@ -26,7 +26,7 @@ function _object_spread(target) {
     }
     return target;
 }
-import classNames from "classnames";
+import classNames from "clsx";
 import { isString } from "lodash-es";
 import React from "react";
 import { DazingLottie, ThinkingLottie } from "./lotties";

package/dist/Components/SuggestionList/index.js

@@ -187,7 +187,7 @@ function _ts_generator(thisArg, body) {
 }
 import { RefreshCcw, SwapRight } from "@sofa-design/icons";
 import { ConfigProvider, Tooltip } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import React, { useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
 import { I18nContext } from "../../I18n";
 import { useStyle } from "./style";

package/dist/Components/TextAnimate/index.js

@@ -112,9 +112,9 @@ function _unsupported_iterable_to_array(o, minLen) {
     if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
 }
 import { ConfigProvider } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import { AnimatePresence, motion } from "framer-motion";
-import { isNumber, isObject, isString } from "lodash";
+import { isNumber, isObject, isString } from "lodash-es";
 import toArray from "rc-util/lib/Children/toArray";
 import React, { memo, useContext } from "react";
 import { useTextAnimateStyle } from "./style";

package/dist/Components/TypingAnimation/index.js

@@ -109,9 +109,9 @@ function _unsupported_iterable_to_array(o, minLen) {
     if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
 }
 import { ConfigProvider } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import { motion, useInView } from "framer-motion";
-import { isString } from "lodash";
+import { isString } from "lodash-es";
 import React, { useContext, useEffect, useMemo, useRef, useState } from "react";
 import { resolveSegments } from "../TextAnimate";
 import { useTypingAnimationStyle } from "./style";

package/dist/Components/VisualList/index.d.ts

@@ -31,7 +31,7 @@ export interface VisualListProps {
     /** 自定义列表项渲染函数 */
     renderItem?: (item: VisualListItem, index: number) => React.ReactNode;
     /**
-     * @deprecated 请使用 isLoading 代替
+     * @deprecated @since 2.29.0 请使用 isLoading 代替
      * @description 已废弃，将在未来版本移除
      */
     loading?: boolean;

package/dist/Components/VisualList/index.js

@@ -97,7 +97,7 @@ function _unsupported_iterable_to_array(o, minLen) {
     if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
 }
 import { SquareArrowUpRight } from "@sofa-design/icons";
-import classNames from "classnames";
+import classNames from "clsx";
 import React, { memo, useMemo, useState } from "react";
 import { useRefFunction } from "../../Hooks/useRefFunction";
 import { useStyle } from "./style";

package/dist/Components/lotties/TextLoading/index.js

@@ -27,7 +27,7 @@ function _object_spread(target) {
     return target;
 }
 import { ConfigProvider } from "antd";
-import cx from "classnames";
+import cx from "clsx";
 import React, { useContext } from "react";
 import { useStyle } from "./style";
 /**

package/dist/Components/lotties/bubble-actions/Abstract/index.js

@@ -27,7 +27,7 @@ function _object_spread(target) {
     return target;
 }
 import { ConfigProvider } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import Lottie from "lottie-react";
 import React, { useContext, useEffect, useRef } from "react";
 import { useStyle } from "./style";

package/dist/History/components/NewChatComponent.d.ts

@@ -39,7 +39,7 @@ interface HistoryNewChatProps {
  */
 export declare const HistoryNewChat: React.FC<HistoryNewChatProps>;
 /**
- * @deprecated 请使用 HistoryNewChat 替代
+ * @deprecated @since 2.29.0 请使用 HistoryNewChat 替代
  */
 export declare const NewChatComponent: React.FC<HistoryNewChatProps>;
 export {};

package/dist/History/components/NewChatComponent.js

@@ -275,5 +275,5 @@ import { useNewChatStyle } from "./NewChatComponent.style";
     }), (locale === null || locale === void 0 ? void 0 : locale['chat.history.newChat']) || '新对话'));
 };
 /**
- * @deprecated 请使用 HistoryNewChat 替代
+ * @deprecated @since 2.29.0 请使用 HistoryNewChat 替代
  */ export var NewChatComponent = HistoryNewChat;

package/dist/History/components/SearchComponent.d.ts

@@ -54,7 +54,7 @@ interface HistorySearchProps {
  */
 export declare const HistorySearch: React.FC<HistorySearchProps>;
 /**
- * @deprecated 请使用 HistorySearch 替代
+ * @deprecated @since 2.29.0 请使用 HistorySearch 替代
  */
 export declare const SearchComponent: React.FC<HistorySearchProps>;
 export {};

package/dist/History/components/SearchComponent.js

@@ -390,5 +390,5 @@ function SearchIcon(props) {
     }, /*#__PURE__*/ React.createElement(SearchIcon, null))));
 };
 /**
- * @deprecated 请使用 HistorySearch 替代
+ * @deprecated @since 2.29.0 请使用 HistorySearch 替代
  */ export var SearchComponent = HistorySearch;

package/dist/History/index.js

@@ -128,10 +128,10 @@ function _ts_generator(thisArg, body) {
 }
 import { HistoryOutlined } from "@ant-design/icons";
 import { ConfigProvider, Popover } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import React, { memo, useContext, useMemo, useRef } from "react";
 import useClickAway from "../Hooks/useClickAway";
-import { ActionIconBox, BubbleConfigContext } from "../index";
+import { ActionIconBox, I18nContext } from "../index";
 import { HistoryEmpty, HistoryLoadMore, HistoryNewChat, HistorySearch, generateHistoryItems } from "./components";
 import { useHistory } from "./hooks/useHistory";
 import GroupMenu from "./menu";
@@ -175,7 +175,7 @@ export * from "./utils";
     var _props_agent, _props_agent1, _props_agent2;
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     var menuPrefixCls = getPrefixCls('agentic-chat-history-menu');
-    var locale = (useContext(BubbleConfigContext) || {}).locale;
+    var locale = useContext(I18nContext).locale;
     var containerRef = useRef(null);
     // 注册样式
     var _useStyle = useStyle(menuPrefixCls), wrapSSR = _useStyle.wrapSSR, hashId = _useStyle.hashId;

package/dist/History/menu.js

@@ -63,7 +63,7 @@ function _object_without_properties_loose(source, excluded) {
     return target;
 }
 import { ConfigProvider, Spin } from "antd";
-import classNames from "classnames";
+import classNames from "clsx";
 import React, { useContext } from "react";
 import { useRefFunction } from "../Hooks/useRefFunction";
 import { useStyle } from "./style";

package/dist/History/types/index.d.ts

@@ -12,12 +12,12 @@ export interface HistoryProps {
     request: (params: {
         agentId: string;
     }) => Promise<HistoryDataType[]>;
-    /** @deprecated 请使用 onClick 替代 */
+    /** @deprecated @since 2.29.0 请使用 onClick 替代 */
     onSelected?: (item: HistoryDataType) => void;
     onClick?: (sessionId: string, item: HistoryDataType) => void;
     /**
      * 删除历史记录项时的回调函数
-     * @deprecated 建议使用 onDelete 替代（符合命名规范），但为保持兼容性暂时保留
+     * @deprecated @since 2.29.0 建议使用 onDelete 替代（符合命名规范），但为保持兼容性暂时保留
      */
     onDeleteItem?: (sessionId: string) => void;
     customDateFormatter?: (date: number | string | Date) => string;
@@ -66,7 +66,7 @@ export interface HistoryProps {
     /** 空状态渲染函数，当历史记录为空时显示 */
     emptyRender?: () => React.ReactNode;
     /**
-     * @deprecated 请使用 isLoading 代替
+     * @deprecated @since 2.29.0 请使用 isLoading 代替
      * @description 已废弃，将在未来版本移除
      */
     loading?: boolean;
@@ -102,9 +102,9 @@ export interface HistoryActionsBoxProps {
     onFavorite?: (sessionId: string, isFavorite: boolean) => void;
 }
 /**
- * @deprecated 请使用 HistoryActionsBoxProps 替代
+ * @deprecated @since 2.29.0 请使用 HistoryActionsBoxProps 替代
  */
 export interface ActionsBoxProps extends HistoryActionsBoxProps {
-    /** @deprecated 请使用 onClick 替代 */
+    /** @deprecated @since 2.29.0 请使用 onClick 替代 */
     onSelected?: (item: HistoryDataType) => void;
 }

package/dist/History/types/index.js

@@ -1,3 +1,3 @@
 /**
- * @deprecated 请使用 HistoryActionsBoxProps 替代
+ * @deprecated @since 2.29.0 请使用 HistoryActionsBoxProps 替代
  */ export { };

package/dist/Hooks/useLanguage.d.ts

@@ -390,6 +390,22 @@ export declare function useLanguage(): {
         'layout.header.title': string;
         theme: string;
         expandCollapse: string;
+        moreActions: string;
+        clickToRetry: string;
+        'table.insertColumnBefore': string;
+        'table.deleteColumn': string;
+        'table.insertColumnAfter': string;
+        'table.insertRowBefore': string;
+        'table.deleteRow': string;
+        'table.insertRowAfter': string;
+        'table.clickToShowActions': string;
+        'table.clickToSelectColumn': string;
+        'table.clickToSelectTable': string;
+        'comment.delete': string;
+        'comment.edit': string;
+        'comment.jumpTo': string;
+        'chart.renderFailed': string;
+        'chart.renderFailedSubTitle': string;
     };
     setLanguage: ((language: "zh-CN" | "en-US") => void) | undefined;
     toggleLanguage: () => void;

package/dist/I18n/index.d.ts

@@ -24,6 +24,7 @@ export declare function saveUserLanguage(language: 'zh-CN' | 'en-US'): void;
  * 国际化上下文
  *
  * 提供国际化功能的React Context，包含当前语言环境和设置语言的方法。
+ * 所有国际化文案应统一通过 I18nContext 获取，保证单一数据源。
  */
 export declare const I18nContext: React.Context<{
     locale: LocalKeys;
@@ -31,6 +32,15 @@ export declare const I18nContext: React.Context<{
     setLanguage?: ((language: 'zh-CN' | 'en-US') => void) | undefined;
     setLocale?: ((locale: LocalKeys) => void) | undefined;
 }>;
+/**
+ * 从 I18nContext 获取当前 locale，国际化统一入口
+ */
+export declare function useLocale(): LocalKeys;
+/**
+ * 获取合并后的 locale：以 I18nContext 为基准，用 override 覆盖部分 key
+ * 用于 Bubble 等支持 config 级文案覆盖的场景，仍以 I18nContext 为主
+ */
+export declare function useMergedLocale(override?: Partial<LocalKeys>): LocalKeys;
 /**
  * I18nProvide 组件 - 国际化提供者组件
  *