@ant-design/agentic-ui 2.0.0

package/dist/hooks/useThrottleFn/index.js

@@ -0,0 +1,44 @@
+// src/hooks/useThrottleFn/index.ts
+import { useCallback, useEffect, useRef } from "react";
+function useThrottleFn(fn, interval = 100) {
+  const fnRef = useRef(fn);
+  const timeoutRef = useRef(null);
+  const lastArgsRef = useRef(null);
+  const lastThisRef = useRef(null);
+  const lastCallRef = useRef(0);
+  fnRef.current = fn;
+  const throttledFn = useCallback(
+    function(...args) {
+      const now = Date.now();
+      const remainingTime = interval - (now - lastCallRef.current);
+      lastArgsRef.current = args;
+      lastThisRef.current = this;
+      if (remainingTime <= 0) {
+        if (timeoutRef.current) {
+          clearTimeout(timeoutRef.current);
+          timeoutRef.current = null;
+        }
+        lastCallRef.current = now;
+        fnRef.current.apply(lastThisRef.current, lastArgsRef.current);
+      } else if (!timeoutRef.current) {
+        timeoutRef.current = setTimeout(() => {
+          lastCallRef.current = Date.now();
+          timeoutRef.current = null;
+          fnRef.current.apply(lastThisRef.current, lastArgsRef.current);
+        }, remainingTime);
+      }
+    },
+    [interval]
+  );
+  useEffect(() => {
+    return () => {
+      if (timeoutRef.current) {
+        clearTimeout(timeoutRef.current);
+      }
+    };
+  }, []);
+  return throttledFn;
+}
+export {
+  useThrottleFn
+};

package/dist/i18n/index.d.ts

@@ -0,0 +1,88 @@
+import React from 'react';
+import { cnLabels, enLabels } from './locales';
+export { cnLabels, enLabels };
+export type LocalKeys = typeof cnLabels;
+/**
+ * 语言检测工具函数
+ *
+ * 检测用户的语言偏好，支持多种检测方式：
+ * 1. 浏览器语言设置
+ * 2. Ant Design ConfigProvider 的 locale
+ * 3. localStorage 中保存的用户选择
+ * 4. 默认语言
+ */
+export declare function detectUserLanguage(): 'zh-CN' | 'en-US';
+/**
+ * 获取对应的语言标签对象
+ */
+export declare function getLocaleByLanguage(language: 'zh-CN' | 'en-US'): typeof cnLabels;
+/**
+ * 保存用户语言选择到 localStorage
+ */
+export declare function saveUserLanguage(language: 'zh-CN' | 'en-US'): void;
+/**
+ * 国际化上下文
+ *
+ * 提供国际化功能的React Context，包含当前语言环境和设置语言的方法。
+ */
+export declare const I18nContext: React.Context<{
+    locale: LocalKeys;
+    language: 'zh-CN' | 'en-US';
+    setLanguage?: ((language: 'zh-CN' | 'en-US') => void) | undefined;
+    setLocale?: ((locale: LocalKeys) => void) | undefined;
+}>;
+/**
+ * I18nProvide 组件 - 国际化提供者组件
+ *
+ * 该组件提供国际化功能，支持中英文切换，自动检测用户语言偏好。
+ * 集成Ant Design的ConfigProvider，提供完整的国际化支持。
+ *
+ * @component
+ * @description 国际化提供者组件，支持多语言切换
+ * @param {Object} props - 组件属性
+ * @param {React.ReactNode} props.children - 子组件
+ * @param {typeof cnLabels} [props.locale] - 自定义语言环境
+ * @param {'zh-CN' | 'en-US'} [props.defaultLanguage] - 默认语言
+ * @param {boolean} [props.autoDetect=true] - 是否自动检测语言
+ *
+ * @example
+ * ```tsx
+ * <I18nProvide defaultLanguage="en-US" autoDetect={true}>
+ *   <App />
+ * </I18nProvide>
+ * ```
+ *
+ * @returns {React.ReactElement} 渲染的国际化提供者组件
+ *
+ * @remarks
+ * - 支持中英文语言切换
+ * - 自动检测用户浏览器语言
+ * - 集成Ant Design国际化
+ * - 提供语言环境上下文
+ * - 支持自定义语言配置
+ * - 响应式语言切换
+ * - 提供模板字符串编译功能
+ * - 支持 localStorage 持久化语言选择
+ * - 支持 Ant Design ConfigProvider 同步
+ */
+export declare const I18nProvide: React.FC<{
+    children: React.ReactNode;
+    locale?: typeof cnLabels;
+    defaultLanguage?: 'zh-CN' | 'en-US';
+    autoDetect?: boolean;
+}>;
+/**
+ * 编译模板字符串，将其中的变量占位符替换为对应的值
+ *
+ * @param template - 包含变量占位符的模板字符串，格式为 ${variableName}
+ * @param variables - 变量名和对应值的键值对对象，默认为空对象
+ * @returns 替换变量后的字符串。如果变量在variables中不存在，则显示为[variableName]
+ *
+ * @example
+ * // 返回 "你好，世界！"
+ * compileTemplate("你好，${name}！", { name: "世界" });
+ *
+ * // 返回 "你好，[name]！"（当变量未提供时）
+ * compileTemplate("你好，${name}！");
+ */
+export declare function compileTemplate(template: string, variables?: Record<string, string>): string;

package/dist/i18n/index.js

@@ -0,0 +1,122 @@
+// src/i18n/index.tsx
+import { ConfigProvider } from "antd";
+import React, {
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useState
+} from "react";
+import { cnLabels, enLabels } from "./locales";
+function detectUserLanguage() {
+  var _a;
+  if (typeof window !== "undefined") {
+    const savedLanguage = localStorage.getItem("md-editor-language");
+    if (savedLanguage === "zh-CN" || savedLanguage === "en-US") {
+      return savedLanguage;
+    }
+  }
+  try {
+    const antdLocale = (_a = document.querySelector("[data-antd-locale]")) == null ? void 0 : _a.getAttribute("data-antd-locale");
+    if (antdLocale) {
+      if (antdLocale.toLowerCase().includes("zh")) {
+        return "zh-CN";
+      }
+      if (antdLocale.toLowerCase().includes("en")) {
+        return "en-US";
+      }
+    }
+  } catch (error) {
+  }
+  if (typeof navigator !== "undefined") {
+    const browserLanguages = navigator.languages || [navigator.language];
+    for (const lang of browserLanguages) {
+      const langLower = (lang == null ? void 0 : lang.toLowerCase()) || "zh-CN";
+      if (langLower.startsWith("zh")) {
+        return "zh-CN";
+      }
+      if (langLower.startsWith("en")) {
+        return "en-US";
+      }
+    }
+  }
+  if (typeof process !== "undefined" && false) {
+    return "en-US";
+  }
+  return "zh-CN";
+}
+function getLocaleByLanguage(language) {
+  return language === "zh-CN" ? cnLabels : enLabels;
+}
+function saveUserLanguage(language) {
+  if (typeof window !== "undefined") {
+    localStorage.setItem("md-editor-language", language);
+  }
+}
+var I18nContext = React.createContext({
+  locale: cnLabels,
+  language: "zh-CN"
+});
+var I18nProvide = (props) => {
+  const { autoDetect = true, defaultLanguage = "zh-CN" } = props;
+  const antdContext = useContext(ConfigProvider.ConfigContext);
+  const [language, setLanguageState] = useState(() => {
+    if (!autoDetect) {
+      return defaultLanguage;
+    }
+    return detectUserLanguage();
+  });
+  const locale = useMemo(() => {
+    return getLocaleByLanguage(language);
+  }, [language]);
+  useEffect(() => {
+    if (!autoDetect || !(antdContext == null ? void 0 : antdContext.locale)) {
+      return;
+    }
+    const antdLocale = antdContext.locale.locale;
+    if (antdLocale) {
+      const newLanguage = antdLocale.toLowerCase().includes("zh") ? "zh-CN" : "en-US";
+      if (newLanguage !== language) {
+        setLanguageState(newLanguage);
+        saveUserLanguage(newLanguage);
+      }
+    }
+  }, [antdContext == null ? void 0 : antdContext.locale, autoDetect, language]);
+  const setLanguage = useCallback((newLanguage) => {
+    setLanguageState(newLanguage);
+    saveUserLanguage(newLanguage);
+  }, []);
+  const setLocale = useCallback(
+    (newLocale) => {
+      const newLanguage = newLocale === cnLabels ? "zh-CN" : "en-US";
+      setLanguage(newLanguage);
+    },
+    [setLanguage]
+  );
+  const contextValue = useMemo(
+    () => ({
+      locale: props.locale || locale,
+      language,
+      setLanguage,
+      setLocale
+    }),
+    [props.locale, locale, language, setLanguage, setLocale]
+  );
+  return /* @__PURE__ */ React.createElement(I18nContext.Provider, { value: contextValue }, props.children);
+};
+function compileTemplate(template, variables = {}) {
+  return template.replace(/\$\{(\w+)\}/g, (_, varName) => {
+    var _a;
+    return (_a = variables[varName]) != null ? _a : `[${varName}]`;
+  });
+}
+export {
+  I18nContext,
+  I18nProvide,
+  cnLabels,
+  compileTemplate,
+  detectUserLanguage,
+  enLabels,
+  getLocaleByLanguage,
+  saveUserLanguage
+};

package/dist/i18n/locales.d.ts

@@ -0,0 +1,343 @@
+/**
+ * 中文标签映射对象
+ *
+ * 包含所有界面文本的中文翻译，用于国际化  dataTime: '数据时间',
+  columns: '列',
+  all: '全部',
+ * 提供完整的用户界面文本本地化。
+ */
+export declare const cnLabels: {
+    attachmentSingleMax: string;
+    table: string;
+    column: string;
+    quote: string;
+    code: string;
+    attachmentSupportedFormats: string;
+    localeImage: string;
+    'b-list': string;
+    'n-list': string;
+    't-list': string;
+    head1: string;
+    head2: string;
+    head3: string;
+    deleteMedia: string;
+    confirmDelete: string;
+    delete: string;
+    assignTo: string;
+    previewTable: string;
+    copy: string;
+    copySuccess: string;
+    uploadSuccess: string;
+    uploading: string;
+    uploadFailed: string;
+    pieChart: string;
+    donutChart: string;
+    radarChart: string;
+    scatterChart: string;
+    funnelChart: string;
+    configChart: string;
+    updateChart: string;
+    barChart: string;
+    lineChart: string;
+    columnChart: string;
+    areaChart: string;
+    descriptions: string;
+    dataTime: string;
+    columns: string;
+    all: string;
+    TableSql: string;
+    ToolCall: string;
+    RagRetrieval: string;
+    DeepThink: string;
+    WebSearch: string;
+    other: string;
+    preview: string;
+    expand: string;
+    bold: string;
+    italic: string;
+    strikethrough: string;
+    'inline-code': string;
+    'font-color': string;
+    collapse: string;
+    fullScreen: string;
+    taskFinished: string;
+    taskCost: string;
+    taskComplete: string;
+    taskAborted: string;
+    inProgressTask: string;
+    totalTimeUsed: string;
+    edit: string;
+    multipleKnowledgeBases: string;
+    multipleTables: string;
+    multipleTools: string;
+    multipleData: string;
+    executeSQL: string;
+    cancel: string;
+    retry: string;
+    executing: string;
+    queryResults: string;
+    queryFailed: string;
+    addComment: string;
+    searchResults: string;
+    thinking: string;
+    queryKeyWords: string;
+    executionResult: string;
+    deepThinkingInProgress: string;
+    taskExecutionFailed: string;
+    executionParameters: string;
+    apiCalling: string;
+    networkQuerying: string;
+    'think.deepThinking': string;
+    'think.deepThinkingInProgress': string;
+    switchLanguage: string;
+    insertLink: string;
+    clearFormatting: string;
+    undo: string;
+    redo: string;
+    thoughtChainTitle: string;
+    thoughtChainDescription: string;
+    requestBody: string;
+    urlParameters: string;
+    queryParameters: string;
+    searchKeywords: string;
+    toolDescription: string;
+    httpMethod: string;
+    toolName: string;
+    apiPath: string;
+    requestData: string;
+    requestParamsString: string;
+    responseBody: string;
+    responseStatus: string;
+    toolSetId: string;
+    toolSetVersion: string;
+    toolInstanceId: string;
+    errorMessage: string;
+    apiResponse: string;
+    documentChunks: string;
+    tableData: string;
+    columnNames: string;
+    documentPreview: string;
+    loading: string;
+    finished: string;
+    aborted: string;
+    timeUsed: string;
+    seconds: string;
+    minutes: string;
+    hours: string;
+    days: string;
+    inputPlaceholder: string;
+    emptyObjectConfig: string;
+    close: string;
+    runCode: string;
+    rerender: string;
+    download: string;
+    dragToMove: string;
+    format: string;
+    removeLink: string;
+    largeTitle: string;
+    paragraphTitle: string;
+    smallTitle: string;
+    bodyText: string;
+    leftAlign: string;
+    centerAlign: string;
+    rightAlign: string;
+    inlineImage: string;
+    blockImage: string;
+    quickSettings: string;
+    elements: string;
+    media: string;
+    list: string;
+    heading: string;
+    clickToPreview: string;
+    agentRunBar: {
+        running: string;
+        timeUsedPrefix: string;
+        calling: string;
+        taskCompleted: string;
+        taskStopped: string;
+        taskReplaying: string;
+        createNewTask: string;
+        replayTask: string;
+        newTask: string;
+        submitTask: string;
+        play: string;
+        pause: string;
+        stop: string;
+    };
+    'chat.history': string;
+    'chat.history.delete': string;
+    'chat.history.delete.popconfirm': string;
+    'chat.history.favorited': string;
+    'chat.history.favorite': string;
+    'chat.history.unfavorite': string;
+    'chat.history.search': string;
+    'chat.history.search.placeholder': string;
+    'chat.history.newChat': string;
+    'chat.history.loadMore': string;
+    'task.history.loadMore': string;
+    'chat.history.historyTasks': string;
+    'chat.history.historyChats': string;
+    'chat.task.search.placeholder': string;
+    'taskList.expand': string;
+    'taskList.collapse': string;
+    'taskList.taskList': string;
+    'taskList.taskComplete': string;
+    'taskList.taskAborted': string;
+    'taskList.taskInProgress': string;
+    'taskList.totalTimeUsed': string;
+    'chat.message.thinking': string;
+    'chat.message.referenceDocument': string;
+    'chat.message.viewOriginal': string;
+    'chat.message.generateFailed': string;
+    'chat.message.preview': string;
+    'workspace.file.fileName': string;
+    'workspace.file.fileSize': string;
+    'workspace.file.clickToDownload': string;
+    'workspace.file.cannotGetImagePreview': string;
+    'workspace.file.cannotGetVideoPreview': string;
+    'workspace.file.cannotGetAudioPreview': string;
+    'workspace.file.cannotGetPdfPreview': string;
+    'workspace.file.unknownFileType': string;
+    'workspace.file.generationTime': string;
+    'workspace.file.backToFileList': string;
+    'workspace.file.download': string;
+    'workspace.file.share': string;
+    'workspace.file.preview': string;
+    'workspace.file.linkCopied': string;
+    'workspace.file.copyFailed': string;
+    'markdownInput.fileSizeExceeded': string;
+    'markdownInput.maxFileCountExceeded': string;
+    'markdownInput.minFileCountRequired': string;
+    'docInfo.name': string;
+    'docInfo.updateTime': string;
+    'docInfo.type': string;
+    'docInfo.content': string;
+    'docInfo.referenceContent': string;
+    'docInfo.items': string;
+    'docInfo.expand': string;
+    'docInfo.collapse': string;
+    'task.default': string;
+    'error.unexpected': string;
+    'chat.message.aborted': string;
+    'chat.message.retrySend': string;
+    'chat.message.generating': string;
+    'chat.message.copy': string;
+    'chat.message.like': string;
+    'chat.message.cancel-like': string;
+    'chat.message.feedback-success': string;
+    'chat.message.dislike': string;
+    'chat.message.exception': string;
+    'chat.message.error': string;
+    'chat.message.error.retry': string;
+    'chat.message.timeout': string;
+    'chat.message.copy.success': string;
+    'chat.message.copy.error': string;
+    'chat.inputArea.placeholder': string;
+    'chat.inputArea.max_input_length': string;
+    'chat.list.helloMessage': string;
+    'chat.newsession.popconfirm': string;
+    'chat.newsession': string;
+    'chat.close': string;
+    'chat.helloMessage.pre_hello_text': string;
+    'htmlPreview.preview': string;
+    'htmlPreview.code': string;
+    'htmlPreview.renderFailed': string;
+    'workspace.realtimeFollow': string;
+    'workspace.browser': string;
+    'workspace.task': string;
+    'workspace.file': string;
+    'workspace.custom': string;
+    'workspace.terminalExecution': string;
+    'workspace.createHtmlFile': string;
+    'workspace.markdownContent': string;
+    'workspace.closeWorkspace': string;
+    'workspace.expand': string;
+    'workspace.collapse': string;
+    'workspace.group': string;
+    'workspace.loadingPreview': string;
+    'workspace.previewLoadFailed': string;
+    'workspace.previewError': string;
+    'workspace.processingFile': string;
+    'workspace.fileProcessFailed': string;
+    'workspace.loadingFileContent': string;
+    'workspace.textContentLoadFailed': string;
+    'workspace.fileProcessError': string;
+    'workspace.download': string;
+    'workspace.empty': string;
+    'workspace.title': string;
+    'workspace.searchPlaceholder': string;
+    'workspace.noResultsFor': string;
+    'toolbar.bold': string;
+    'toolbar.italic': string;
+    'toolbar.strikethrough': string;
+    'toolbar.inlineCode': string;
+    'toolbar.alignLeft': string;
+    'toolbar.alignCenter': string;
+    'toolbar.alignRight': string;
+    'schemaEditor.realtimePreview': string;
+    'schemaEditor.htmlTemplate': string;
+    'schemaEditor.schemaJson': string;
+    'schemaEditor.run': string;
+    'schemaEditor.copy': string;
+    'schemaEditor.copySuccess': string;
+    'schemaEditor.copyFailed': string;
+    'schemaEditor.noContentToCopy': string;
+    'schemaEditor.validationFailed': string;
+    'schemaEditor.schemaSerializationError': string;
+    'schemaEditor.schemaParseError': string;
+    'schemaEditor.previewLoadFailed': string;
+    'schemaEditor.checkSchemaFormat': string;
+    'schemaEditor.inputSchemaToPreview': string;
+    'schemaEditor.untitledSchema': string;
+    'webSearch.noResults': string;
+    'webSearch.searchFailed': string;
+    'webSearch.networkError': string;
+    'webSearch.timeout': string;
+    'webSearch.retry': string;
+    'chatFlow.collapseLeft': string;
+    'chatFlow.collapseRight': string;
+    'chatFlow.share': string;
+    'chatFlow.shareDialog': string;
+    'suggestion.area': string;
+    'suggestion.label': string;
+    'suggestion.searchMore': string;
+    'suggestion.select': string;
+    'suggestion.followUp': string;
+    'input.fileUpload': string;
+    'input.voiceInput': string;
+    'input.voiceInputting': string;
+    'input.placeholder': string;
+    'common.name': string;
+    'common.updateTime': string;
+    'common.type': string;
+    'common.content': string;
+    'common.understand': string;
+    'common.conversionRate': string;
+    'common.conversion': string;
+    'common.assignTo': string;
+    'common.searchFileName': string;
+    'common.fileProcessFailed': string;
+    'common.loadTextFailed': string;
+    'common.downloadFile': string;
+    'common.regenerate': string;
+    'common.user': string;
+    'common.assistant': string;
+    'common.save': string;
+    'common.image': string;
+    'common.document': string;
+    'common.audio': string;
+    'common.video': string;
+    'common.imageLink': string;
+    'common.textFile': string;
+    'common.compressedFile': string;
+    'common.configFile': string;
+    'upload.notConfigured': string;
+    'upload.failed': string;
+};
+/**
+ * 英文标签映射对象
+ *
+ * 包含所有界面文本的英文翻译，用于国际化支持。
+ * 提供完整的用户界面文本本地化。
+ */
+export declare const enLabels: typeof cnLabels;