@mxmweb/aichat 2.1.4 → 2.1.6

package/components/AiChat.d.ts

@@ -1,5 +1,7 @@
+import { default as React } from 'react';
 import { ConversationData } from './AiChat.types';
 import { Styles } from '@mxmweb/zui';
+import { AIChatLocale, AIChatMessages } from '../i18n';
 export interface ListItemType {
     label: string;
     sessionId: string;
@@ -33,6 +35,8 @@ export interface AppStatusManager {
     app: 'ready' | 'initializing' | 'error';
 }
 export interface SenderConfig {
+    /** 输入框 placeholder，用于 i18n；未传时使用 AIChat messages.sender.placeholder */
+    placeholder?: string;
     upload_size_limit?: number;
     upload_number_limit?: number;
     upload_file_type_limit?: string[];
@@ -81,6 +85,8 @@ interface AiChatProps {
         title?: string;
         tools?: React.ReactNode;
     };
+    locale?: AIChatLocale;
+    messages?: Partial<AIChatMessages>;
 }
-export default function AiChat({ chatData, sidebar, eventsEmit, status, CustomComponents, recommandQuestions, styles, senderConfig, fileUploadStatus, onSenderConfigChange, activeSessionId, scrollOld, rightbarInitialCollapsed, rightbarWidth, onRightbarChange, disclaimer, chatHeader, }: AiChatProps): import("react/jsx-runtime").JSX.Element;
+export default function AiChat({ chatData, sidebar, eventsEmit, status, CustomComponents, recommandQuestions, styles, senderConfig, fileUploadStatus, onSenderConfigChange, activeSessionId, scrollOld, rightbarInitialCollapsed, rightbarWidth, onRightbarChange, disclaimer, chatHeader, locale, messages: messagesOverride, }: AiChatProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/i18n/context.d.ts

@@ -0,0 +1,20 @@
+import { default as React } from 'react';
+import { AIChatLocale, AIChatMessages } from './types';
+export interface AIChatI18nContextValue {
+    locale: AIChatLocale;
+    messages: AIChatMessages;
+    /** 取文案，支持点路径如 'sender.placeholder' */
+    t: (key: string) => string;
+}
+declare const AIChatI18nContext: React.Context<AIChatI18nContextValue>;
+export { AIChatI18nContext };
+export declare function useAIChatI18n(): AIChatI18nContextValue;
+export interface AIChatI18nProviderProps {
+    locale?: AIChatLocale;
+    messages?: Partial<AIChatMessages>;
+    children: React.ReactNode;
+}
+/**
+ * AIChat 根组件内使用的 i18n Provider，提供 locale 与合并后的 messages
+ */
+export declare function AIChatI18nProvider({ locale, messages: overrides, children, }: AIChatI18nProviderProps): import("react/jsx-runtime").JSX.Element;

package/i18n/index.d.ts

@@ -0,0 +1,3 @@
+export type { AIChatLocale, AIChatMessages } from './types';
+export { messagesZh, messagesEn, messagesJa, getMessages, interpolate } from './messages';
+export { AIChatI18nContext, AIChatI18nProvider, useAIChatI18n, type AIChatI18nContextValue, type AIChatI18nProviderProps, } from './context';

package/i18n/messages.d.ts

@@ -0,0 +1,17 @@
+import { AIChatMessages } from './types';
+/** 中文文案（默认） */
+export declare const messagesZh: AIChatMessages;
+/** 英文文案 */
+export declare const messagesEn: AIChatMessages;
+/** 日语文案 */
+export declare const messagesJa: AIChatMessages;
+/**
+ * 根据 locale 与可选覆盖得到合并后的 messages
+ * @param locale 语言
+ * @param overrides 部分覆盖的文案（与内置合并）
+ */
+export declare function getMessages(locale: 'zh' | 'en' | 'ja', overrides?: Partial<AIChatMessages>): AIChatMessages;
+/**
+ * 替换文案中的 {{key}} 占位符
+ */
+export declare function interpolate(template: string, params: Record<string, string | number>): string;

package/i18n/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * AIChat 组件 i18n 文案键类型定义
+ * 用于中/英/日三语及业务自定义覆盖
+ */
+export type AIChatLocale = 'zh' | 'en' | 'ja';
+export interface AIChatMessages {
+    sender: {
+        placeholder: string;
+        clearTip: string;
+        send: string;
+        stop: string;
+        uploadHint: string;
+        selectPlaceholder: string;
+    };
+    fileStatus: {
+        pending: string;
+        uploading: string;
+        parsing: string;
+        done: string;
+        error: string;
+        unknown: string;
+    };
+    file: {
+        scrollLeft: string;
+        scrollRight: string;
+        remove: string;
+    };
+    welcome: {
+        title: string;
+        description: string;
+    };
+    app: {
+        loading: string;
+        error: string;
+    };
+    display: {
+        loading: string;
+        error: string;
+    };
+    aiChatBox: {
+        copy: string;
+        like: string;
+        likeShort: string;
+        dislike: string;
+        dislikeShort: string;
+    };
+    validation: {
+        fileCountExceeded: string;
+        fileTypeNotAllowed: string;
+        totalSizeExceeded: string;
+        totalSizeExceededWithExisting: string;
+    };
+}