@ant-design/agentic-ui 2.0.0

package/dist/utils/formatTime.js

@@ -0,0 +1,19 @@
+// src/utils/formatTime.ts
+import dayjs from "dayjs";
+var formatTime = (time) => {
+  if (typeof process !== "undefined" && false) {
+    return "2024-02-27 17:20:00";
+  }
+  const now = dayjs();
+  const target = dayjs(time);
+  if (target.isSame(now, "day")) {
+    return target.format("HH:mm:ss");
+  } else if (target.isSame(now, "year")) {
+    return target.format("MM-DD HH:mm:ss");
+  } else {
+    return target.format("YYYY-MM-DD HH:mm:ss");
+  }
+};
+export {
+  formatTime
+};

package/dist/utils/getScroll.d.ts

@@ -0,0 +1,4 @@
+export declare function isWindow(obj: any): obj is Window;
+declare const getScroll: (target: HTMLElement | Window | Document | null) => number;
+export declare const getScrollRailHeight: (target: HTMLElement | Window | Document | null) => number;
+export default getScroll;

package/dist/utils/getScroll.js

@@ -0,0 +1,45 @@
+// src/utils/getScroll.ts
+function isWindow(obj) {
+  return obj !== null && obj !== void 0 && obj === obj.window;
+}
+var getScroll = (target) => {
+  var _a, _b;
+  if (typeof window === "undefined") {
+    return 0;
+  }
+  let result = 0;
+  if (isWindow(target)) {
+    result = target.pageYOffset;
+  } else if (target instanceof Document) {
+    result = target.documentElement.scrollTop;
+  } else if (target instanceof HTMLElement) {
+    result = target.scrollTop;
+  } else if (target) {
+    result = target["scrollTop"];
+  }
+  if (target && !isWindow(target) && typeof result !== "number") {
+    result = (_b = ((_a = target.ownerDocument) != null ? _a : target).documentElement) == null ? void 0 : _b.scrollTop;
+  }
+  return result;
+};
+var getScrollRailHeight = (target) => {
+  if (typeof window === "undefined") {
+    return 0;
+  }
+  if (isWindow(target)) {
+    return target.document.documentElement.scrollHeight - target.document.documentElement.clientHeight;
+  }
+  if (target instanceof Document) {
+    return target.documentElement.scrollHeight - target.documentElement.clientHeight;
+  }
+  if (target instanceof HTMLElement) {
+    return target.scrollHeight - target.offsetHeight;
+  }
+  return 0;
+};
+var getScroll_default = getScroll;
+export {
+  getScroll_default as default,
+  getScrollRailHeight,
+  isWindow
+};

package/dist/utils/language.d.ts

@@ -0,0 +1,220 @@
+/**
+ * 语言检测工具函数集合
+ *
+ * 提供完整的语言检测、判断和转换功能，支持多种检测方式：
+ * 1. 浏览器语言设置检测
+ * 2. Ant Design ConfigProvider 的 locale 检测
+ * 3. localStorage 中保存的用户选择检测
+ * 4. 语言代码转换和标准化
+ */
+export type LanguageType = 'zh-CN' | 'en-US';
+/**
+ * 支持的语言类型
+ */
+export declare const SUPPORTED_LANGUAGES: LanguageType[];
+/**
+ * 语言映射配置
+ */
+export declare const LANGUAGE_MAP: {
+    readonly 'zh-CN': {
+        readonly code: "zh-CN";
+        readonly name: "简体中文";
+        readonly nativeName: "简体中文";
+        readonly flag: "🇨🇳";
+        readonly antdLocale: "zh_CN";
+    };
+    readonly 'en-US': {
+        readonly code: "en-US";
+        readonly name: "English";
+        readonly nativeName: "English";
+        readonly flag: "🇺🇸";
+        readonly antdLocale: "en_US";
+    };
+};
+/**
+ * 检测浏览器语言设置
+ *
+ * @returns 检测到的语言代码，如果无法检测则返回 null
+ *
+ * @example
+ * ```ts
+ * const browserLang = detectBrowserLanguage();
+ * console.log(browserLang); // 'zh-CN' | 'en-US' | null
+ * ```
+ */
+export declare function detectBrowserLanguage(): LanguageType | null;
+/**
+ * 检测 Ant Design ConfigProvider 的 locale
+ *
+ * @returns 检测到的语言代码，如果无法检测则返回 null
+ *
+ * @example
+ * ```ts
+ * const antdLang = detectAntdLocale();
+ * console.log(antdLang); // 'zh-CN' | 'en-US' | null
+ * ```
+ */
+export declare function detectAntdLocale(): LanguageType | null;
+/**
+ * 从 localStorage 中获取用户保存的语言选择
+ *
+ * @param key - localStorage 中的键名，默认为 'md-editor-language'
+ * @returns 保存的语言代码，如果没有保存则返回 null
+ *
+ * @example
+ * ```ts
+ * const savedLang = getSavedLanguage();
+ * console.log(savedLang); // 'zh-CN' | 'en-US' | null
+ * ```
+ */
+export declare function getSavedLanguage(key?: string): LanguageType | null;
+/**
+ * 保存用户语言选择到 localStorage
+ *
+ * @param language - 要保存的语言代码
+ * @param key - localStorage 中的键名，默认为 'md-editor-language'
+ *
+ * @example
+ * ```ts
+ * saveLanguage('en-US');
+ * ```
+ */
+export declare function saveLanguage(language: LanguageType, key?: string): void;
+/**
+ * 智能语言检测
+ *
+ * 按优先级检测用户语言偏好：
+ * 1. localStorage 中保存的用户选择
+ * 2. Ant Design ConfigProvider 的 locale
+ * 3. 浏览器语言设置
+ * 4. 默认语言
+ *
+ * @param defaultLanguage - 默认语言，当所有检测方式都失败时使用
+ * @returns 检测到的语言代码
+ *
+ * @example
+ * ```ts
+ * const detectedLang = detectUserLanguage();
+ * console.log(detectedLang); // 'zh-CN' | 'en-US'
+ *
+ * // 指定默认语言
+ * const lang = detectUserLanguage('en-US');
+ * ```
+ */
+export declare function detectUserLanguage(defaultLanguage?: LanguageType): LanguageType;
+/**
+ * 验证语言代码是否有效
+ *
+ * @param language - 要验证的语言代码
+ * @returns 是否为有效的语言代码
+ *
+ * @example
+ * ```ts
+ * isValidLanguage('zh-CN'); // true
+ * isValidLanguage('fr-FR'); // false
+ * ```
+ */
+export declare function isValidLanguage(language: string): language is LanguageType;
+/**
+ * 标准化语言代码
+ *
+ * @param language - 输入的语言代码
+ * @param fallback - 当无法标准化时返回的默认值
+ * @returns 标准化后的语言代码
+ *
+ * @example
+ * ```ts
+ * normalizeLanguage('zh'); // 'zh-CN'
+ * normalizeLanguage('en'); // 'en-US'
+ * normalizeLanguage('fr'); // 'zh-CN' (fallback)
+ * ```
+ */
+export declare function normalizeLanguage(language: string, fallback?: LanguageType): LanguageType;
+/**
+ * 获取语言信息
+ *
+ * @param language - 语言代码
+ * @returns 语言信息对象
+ *
+ * @example
+ * ```ts
+ * const langInfo = getLanguageInfo('zh-CN');
+ * console.log(langInfo); // { code: 'zh-CN', name: '简体中文', flag: '🇨🇳', ... }
+ * ```
+ */
+export declare function getLanguageInfo(language: LanguageType): {
+    readonly code: "zh-CN";
+    readonly name: "简体中文";
+    readonly nativeName: "简体中文";
+    readonly flag: "🇨🇳";
+    readonly antdLocale: "zh_CN";
+} | {
+    readonly code: "en-US";
+    readonly name: "English";
+    readonly nativeName: "English";
+    readonly flag: "🇺🇸";
+    readonly antdLocale: "en_US";
+};
+/**
+ * 获取所有支持的语言信息
+ *
+ * @returns 所有支持的语言信息数组
+ *
+ * @example
+ * ```ts
+ * const allLanguages = getAllLanguages();
+ * console.log(allLanguages); // [{ code: 'zh-CN', name: '简体中文', ... }, ...]
+ * ```
+ */
+export declare function getAllLanguages(): ({
+    readonly code: "zh-CN";
+    readonly name: "简体中文";
+    readonly nativeName: "简体中文";
+    readonly flag: "🇨🇳";
+    readonly antdLocale: "zh_CN";
+} | {
+    readonly code: "en-US";
+    readonly name: "English";
+    readonly nativeName: "English";
+    readonly flag: "🇺🇸";
+    readonly antdLocale: "en_US";
+})[];
+/**
+ * 语言切换工具类
+ */
+export declare class LanguageManager {
+    private key;
+    private currentLanguage;
+    constructor(key?: string, defaultLanguage?: LanguageType);
+    /**
+     * 获取当前语言
+     */
+    getCurrentLanguage(): LanguageType;
+    /**
+     * 设置语言
+     */
+    setLanguage(language: LanguageType): void;
+    /**
+     * 切换语言
+     */
+    toggleLanguage(): LanguageType;
+    /**
+     * 检测并更新语言
+     */
+    detectAndUpdate(): LanguageType;
+}
+/**
+ * 创建语言管理器实例
+ *
+ * @param key - localStorage 键名
+ * @param defaultLanguage - 默认语言
+ * @returns 语言管理器实例
+ *
+ * @example
+ * ```ts
+ * const langManager = createLanguageManager();
+ * langManager.setLanguage('en-US');
+ * const current = langManager.getCurrentLanguage();
+ * ```
+ */
+export declare function createLanguageManager(key?: string, defaultLanguage?: LanguageType): LanguageManager;

package/dist/utils/language.js

@@ -0,0 +1,168 @@
+// src/utils/language.ts
+var SUPPORTED_LANGUAGES = ["zh-CN", "en-US"];
+var LANGUAGE_MAP = {
+  "zh-CN": {
+    code: "zh-CN",
+    name: "简体中文",
+    nativeName: "简体中文",
+    flag: "🇨🇳",
+    antdLocale: "zh_CN"
+  },
+  "en-US": {
+    code: "en-US",
+    name: "English",
+    nativeName: "English",
+    flag: "🇺🇸",
+    antdLocale: "en_US"
+  }
+};
+function detectBrowserLanguage() {
+  if (typeof navigator === "undefined") {
+    return null;
+  }
+  const browserLanguages = navigator.languages || [navigator.language];
+  for (const lang of browserLanguages) {
+    const langLower = lang.toLowerCase();
+    if (langLower.startsWith("zh")) {
+      return "zh-CN";
+    }
+    if (langLower.startsWith("en")) {
+      return "en-US";
+    }
+  }
+  return null;
+}
+function detectAntdLocale() {
+  var _a;
+  if (typeof document === "undefined") {
+    return null;
+  }
+  try {
+    const antdLocale = (_a = document.querySelector("[data-antd-locale]")) == null ? void 0 : _a.getAttribute("data-antd-locale");
+    if (antdLocale) {
+      const localeLower = antdLocale.toLowerCase();
+      if (localeLower.includes("zh")) {
+        return "zh-CN";
+      }
+      if (localeLower.includes("en")) {
+        return "en-US";
+      }
+    }
+  } catch (error) {
+  }
+  return null;
+}
+function getSavedLanguage(key = "md-editor-language") {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  try {
+    const savedLanguage = localStorage.getItem(key);
+    if (savedLanguage && SUPPORTED_LANGUAGES.includes(savedLanguage)) {
+      return savedLanguage;
+    }
+  } catch (error) {
+  }
+  return null;
+}
+function saveLanguage(language, key = "md-editor-language") {
+  if (typeof window === "undefined") {
+    return;
+  }
+  try {
+    localStorage.setItem(key, language);
+  } catch (error) {
+    console.warn("Failed to save language preference:", error);
+  }
+}
+function detectUserLanguage(defaultLanguage = "zh-CN") {
+  const savedLanguage = getSavedLanguage();
+  if (savedLanguage) {
+    return savedLanguage;
+  }
+  const antdLanguage = detectAntdLocale();
+  if (antdLanguage) {
+    return antdLanguage;
+  }
+  const browserLanguage = detectBrowserLanguage();
+  if (browserLanguage) {
+    return browserLanguage;
+  }
+  return defaultLanguage;
+}
+function isValidLanguage(language) {
+  return SUPPORTED_LANGUAGES.includes(language);
+}
+function normalizeLanguage(language, fallback = "zh-CN") {
+  const langLower = language.toLowerCase();
+  if (langLower.startsWith("zh")) {
+    return "zh-CN";
+  }
+  if (langLower.startsWith("en")) {
+    return "en-US";
+  }
+  return fallback;
+}
+function getLanguageInfo(language) {
+  return LANGUAGE_MAP[language];
+}
+function getAllLanguages() {
+  return SUPPORTED_LANGUAGES.map((lang) => getLanguageInfo(lang));
+}
+var LanguageManager = class {
+  constructor(key = "md-editor-language", defaultLanguage = "zh-CN") {
+    this.key = key;
+    this.currentLanguage = detectUserLanguage(defaultLanguage);
+  }
+  /**
+   * 获取当前语言
+   */
+  getCurrentLanguage() {
+    return this.currentLanguage;
+  }
+  /**
+   * 设置语言
+   */
+  setLanguage(language) {
+    if (isValidLanguage(language)) {
+      this.currentLanguage = language;
+      saveLanguage(language, this.key);
+    }
+  }
+  /**
+   * 切换语言
+   */
+  toggleLanguage() {
+    const newLanguage = this.currentLanguage === "zh-CN" ? "en-US" : "zh-CN";
+    this.setLanguage(newLanguage);
+    return newLanguage;
+  }
+  /**
+   * 检测并更新语言
+   */
+  detectAndUpdate() {
+    const detectedLanguage = detectUserLanguage(this.currentLanguage);
+    if (detectedLanguage !== this.currentLanguage) {
+      this.setLanguage(detectedLanguage);
+    }
+    return this.currentLanguage;
+  }
+};
+function createLanguageManager(key = "md-editor-language", defaultLanguage = "zh-CN") {
+  return new LanguageManager(key, defaultLanguage);
+}
+export {
+  LANGUAGE_MAP,
+  LanguageManager,
+  SUPPORTED_LANGUAGES,
+  createLanguageManager,
+  detectAntdLocale,
+  detectBrowserLanguage,
+  detectUserLanguage,
+  getAllLanguages,
+  getLanguageInfo,
+  getSavedLanguage,
+  isValidLanguage,
+  normalizeLanguage,
+  saveLanguage
+};

package/dist/utils/proxySandbox/ProxySandbox.d.ts

@@ -0,0 +1,164 @@
+/**
+ * 基于 Proxy 的沙箱实现
+ *
+ * 这个模块提供了一个安全的代码执行环境，通过 Proxy 劫持全局对象的访问，
+ * 防止恶意代码对宿主环境造成破坏，同时提供受控的 API 访问。
+ *
+ * 主要特性：
+ * - 全局对象隔离
+ * - API 访问控制
+ * - 内存管理
+ * - 错误捕获和处理
+ * - 执行超时控制
+ *
+ * @author md-editor
+ * @version 1.0.0
+ */
+/**
+ * 沙箱配置接口
+ */
+export interface SandboxConfig {
+    /** 允许访问的全局对象白名单 */
+    allowedGlobals?: string[];
+    /** 禁止访问的全局对象黑名单 */
+    forbiddenGlobals?: string[];
+    /** 是否允许访问 console API */
+    allowConsole?: boolean;
+    /** 是否允许访问 setTimeout/setInterval */
+    allowTimers?: boolean;
+    /** 代码执行超时时间（毫秒） */
+    timeout?: number;
+    /** 是否启用严格模式 */
+    strictMode?: boolean;
+    /** 自定义的全局变量 */
+    customGlobals?: Record<string, any>;
+    /** 是否允许访问 DOM API */
+    allowDOM?: boolean;
+    /** 最大内存使用限制（字节） */
+    maxMemoryUsage?: number;
+}
+/**
+ * 沙箱执行结果接口
+ */
+export interface SandboxResult {
+    /** 执行结果 */
+    result: any;
+    /** 是否执行成功 */
+    success: boolean;
+    /** 错误信息 */
+    error?: Error;
+    /** 执行时间（毫秒） */
+    executionTime: number;
+    /** 内存使用情况 */
+    memoryUsage?: number;
+}
+/**
+ * 基于 Proxy 的沙箱类
+ */
+export declare class ProxySandbox {
+    private config;
+    private globalProxy;
+    private sandboxGlobal;
+    private isActive;
+    private timeoutId;
+    private startTime;
+    constructor(config?: SandboxConfig);
+    /**
+     * 创建安全的 document 代理对象
+     * 允许访问 document 但限制敏感操作
+     */
+    private createSafeDocument;
+    /**
+     * 创建安全的 window 代理对象
+     * 允许访问 window 但限制敏感信息
+     */
+    private createSafeWindow;
+    /**
+     * 创建安全的沙箱全局对象
+     */
+    private createSandboxGlobal;
+    /**
+     * 创建安全的 console 对象
+     */
+    private createSafeConsole;
+    /**
+     * 创建安全的 setTimeout
+     */
+    private createSafeTimeout;
+    /**
+     * 创建安全的 setInterval
+     */
+    private createSafeInterval;
+    /**
+     * 创建全局对象的 Proxy
+     */
+    private createGlobalProxy;
+    /**
+     * 在沙箱中执行代码
+     */
+    execute(code: string, injectedParams?: Record<string, any>): Promise<SandboxResult>;
+    /**
+     * 检查是否是明显的死循环
+     */
+    private isObviousInfiniteLoop;
+    /**
+     * 带超时的普通执行
+     */
+    private executeWithTimeout;
+    /**
+     * 使用指令计数限制执行时间
+     */
+    private executeWithInstructionLimit;
+    /**
+     * 在代码中注入指令计数器
+     */
+    private instrumentCode;
+    /**
+     * 使用 Worker 执行代码以实现真正的超时控制
+     */
+    private executeWithWorker;
+    /**
+     * 执行代码的核心方法（同步版本）
+     */
+    private executeCode;
+    /**
+     * 验证代码安全性
+     */
+    private validateCode;
+    /**
+     * 获取内存使用情况
+     */
+    private getMemoryUsage;
+    /**
+     * 清理资源
+     */
+    private cleanup;
+    /**
+     * 销毁沙箱
+     */
+    destroy(): void;
+    /**
+     * 检查沙箱是否处于活动状态
+     */
+    isRunning(): boolean;
+    /**
+     * 添加自定义全局变量
+     */
+    addGlobal(name: string, value: any): void;
+    /**
+     * 移除自定义全局变量
+     */
+    removeGlobal(name: string): void;
+    /**
+     * 获取沙箱配置
+     */
+    getConfig(): Readonly<Required<SandboxConfig>>;
+}
+/**
+ * 创建沙箱实例的工厂函数
+ */
+export declare function createSandbox(config?: SandboxConfig): ProxySandbox;
+/**
+ * 快速执行代码的工具函数
+ */
+export declare function runInSandbox(code: string, config?: SandboxConfig, injectedParams?: Record<string, any>): Promise<SandboxResult>;