@ant-design/agentic-ui 2.11.2 → 2.12.0

package/dist/Plugins/code/components/AceEditor.js

@@ -10,7 +10,44 @@
  * - 与 Slate 编辑器的集成
  *
  * @see {@link https://ace.c9.io/} Ace Editor 官方文档
- */ function _define_property(obj, key, value) {
+ */ function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _define_property(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -23,6 +60,33 @@
     }
     return obj;
 }
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
 function _object_spread(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
@@ -65,17 +129,121 @@ function _object_without_properties_loose(source, excluded) {
     }
     return target;
 }
-import ace from "ace-builds";
-import "ace-builds/src-noconflict/theme-chaos";
-import "ace-builds/src-noconflict/theme-github";
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, g, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    };
+    return g = {
+        next: verb(0),
+        "throw": verb(1),
+        "return": verb(2)
+    }, typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+        return this;
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(_)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
 import isHotkey from "is-hotkey";
-import { useCallback, useEffect, useRef } from "react";
+import { startTransition, useCallback, useEffect, useRef, useState } from "react";
 import { Editor, Path, Transforms } from "slate";
 import { useRefFunction } from "../../../Hooks/useRefFunction";
 import partialParse from "../../../MarkdownEditor/editor/parser/json-parse";
 import { useEditorStore } from "../../../MarkdownEditor/editor/store";
-import { aceLangs, modeMap } from "../../../MarkdownEditor/editor/utils/ace";
+import { getAceLangs, modeMap } from "../../../MarkdownEditor/editor/utils/ace";
 import { EditorUtils } from "../../../MarkdownEditor/editor/utils/editorUtils";
+import { loadAceEditor, loadAceTheme } from "../loadAceEditor";
 /**
  * AceEditor 组件
  *
@@ -111,7 +279,7 @@ import { EditorUtils } from "../../../MarkdownEditor/editor/utils/editorUtils";
         "isSelected",
         "onSelectionChange"
     ]);
-    var _editorProps_codeProps;
+    var _editorProps_codeProps, _editorProps_codeProps1;
     var _useEditorStore = useEditorStore(), store = _useEditorStore.store, editorProps = _useEditorStore.editorProps, readonly = _useEditorStore.readonly;
     // 各种引用
     var codeRef = useRef(element.value || '');
@@ -124,12 +292,77 @@ import { EditorUtils } from "../../../MarkdownEditor/editor/utils/editorUtils";
     var debounceTimer = useRef(0);
     var editorRef = useRef();
     var dom = useRef(null);
+    // Ace Editor 异步加载状态
+    var _useState = _sliced_to_array(useState(false), 2), aceLoaded = _useState[0], setAceLoaded = _useState[1];
+    var aceModuleRef = useRef(null);
     // 更新路径引用
     useEffect(function() {
         pathRef.current = path;
     }, [
         path
     ]);
+    // 异步加载 Ace Editor 库
+    useEffect(function() {
+        if (process.env.NODE_ENV === 'test') {
+            // 测试环境跳过加载
+            setAceLoaded(true);
+            return;
+        }
+        // 使用 startTransition 标记为非紧急更新
+        startTransition(function() {
+            // 异步加载在 startTransition 外部执行
+            _async_to_generator(function() {
+                var _editorProps_codeProps, aceModule, theme, error;
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            _state.trys.push([
+                                0,
+                                3,
+                                ,
+                                4
+                            ]);
+                            return [
+                                4,
+                                loadAceEditor()
+                            ];
+                        case 1:
+                            aceModule = _state.sent();
+                            aceModuleRef.current = aceModule;
+                            // 加载主题
+                            theme = ((_editorProps_codeProps = editorProps.codeProps) === null || _editorProps_codeProps === void 0 ? void 0 : _editorProps_codeProps.theme) || props.theme || 'github';
+                            return [
+                                4,
+                                loadAceTheme(theme)
+                            ];
+                        case 2:
+                            _state.sent();
+                            setAceLoaded(true);
+                            return [
+                                3,
+                                4
+                            ];
+                        case 3:
+                            error = _state.sent();
+                            console.error('Failed to load Ace Editor:', error);
+                            // 即使加载失败也设置 loaded，避免无限加载
+                            setAceLoaded(true);
+                            return [
+                                3,
+                                4
+                            ];
+                        case 4:
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        });
+    }, [
+        (_editorProps_codeProps = editorProps.codeProps) === null || _editorProps_codeProps === void 0 ? void 0 : _editorProps_codeProps.theme,
+        props.theme
+    ]);
     // 键盘事件处理
     var handleKeyDown = useRefFunction(function(e) {
         // 删除空代码块
@@ -247,17 +480,21 @@ import { EditorUtils } from "../../../MarkdownEditor/editor/utils/editorUtils";
         readonly,
         handleKeyDown
     ]);
-    // 初始化 Ace 编辑器
+    // 初始化 Ace 编辑器（仅在库加载完成后）
     useEffect(function() {
         var _editorProps_codeProps;
         if (process.env.NODE_ENV === 'test') return;
-        if (!dom.current) return;
+        if (!aceLoaded || !aceModuleRef.current || !dom.current) return;
         var value = element.value || '';
         if (element.language === 'json') {
             try {
                 value = JSON.stringify(partialParse(value), null, 2);
             } catch (e) {}
         }
+        // ace-builds 模块的默认导出就是 ace 对象
+        // 使用类型断言确保类型正确
+        var aceModule = aceModuleRef.current;
+        var ace = aceModule.default || aceModule;
         var codeEditor = ace.edit(dom.current, _object_spread({
             useWorker: false,
             value: value,
@@ -276,22 +513,45 @@ import { EditorUtils } from "../../../MarkdownEditor/editor/utils/editorUtils";
         var theme = ((_editorProps_codeProps = editorProps.codeProps) === null || _editorProps_codeProps === void 0 ? void 0 : _editorProps_codeProps.theme) || props.theme || 'github';
         codeEditor.setTheme("ace/theme/".concat(theme));
         // 设置语法高亮
-        setTimeout(function() {
-            var lang = element.language;
-            if (modeMap.has(lang)) {
-                lang = modeMap.get(lang);
-            }
-            if (aceLangs.has(lang)) {
-                codeEditor.session.setMode("ace/mode/".concat(lang));
-            }
-        }, 16);
+        setTimeout(/*#__PURE__*/ _async_to_generator(function() {
+            var lang, aceLangs;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        lang = element.language;
+                        if (modeMap.has(lang)) {
+                            lang = modeMap.get(lang);
+                        }
+                        return [
+                            4,
+                            getAceLangs()
+                        ];
+                    case 1:
+                        aceLangs = _state.sent();
+                        if (aceLangs.has(lang)) {
+                            codeEditor.session.setMode("ace/mode/".concat(lang));
+                        }
+                        return [
+                            2
+                        ];
+                }
+            });
+        }), 16);
         if (readonly) return;
         // 配置编辑器事件
         setupEditorEvents(codeEditor);
         return function() {
             codeEditor.destroy();
         };
-    }, []);
+    }, [
+        aceLoaded,
+        element.value,
+        element.language,
+        readonly,
+        editorProps.codeProps,
+        props.theme,
+        setupEditorEvents
+    ]);
     // 监听外部值变化
     useEffect(function() {
         var value = element.value || '';
@@ -311,32 +571,94 @@ import { EditorUtils } from "../../../MarkdownEditor/editor/utils/editorUtils";
     // 监听主题变化
     useEffect(function() {
         var _editorProps_codeProps;
-        if (!editorRef.current) return;
+        if (!editorRef.current || !aceLoaded) return;
         var theme = ((_editorProps_codeProps = editorProps.codeProps) === null || _editorProps_codeProps === void 0 ? void 0 : _editorProps_codeProps.theme) || props.theme || 'github';
-        editorRef.current.setTheme("ace/theme/".concat(theme));
+        // 异步加载新主题
+        startTransition(function() {
+            _async_to_generator(function() {
+                var _editorRef_current, error, // 尝试使用默认主题
+                _editorRef_current1;
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            _state.trys.push([
+                                0,
+                                2,
+                                ,
+                                3
+                            ]);
+                            return [
+                                4,
+                                loadAceTheme(theme)
+                            ];
+                        case 1:
+                            _state.sent();
+                            (_editorRef_current = editorRef.current) === null || _editorRef_current === void 0 ? void 0 : _editorRef_current.setTheme("ace/theme/".concat(theme));
+                            return [
+                                3,
+                                3
+                            ];
+                        case 2:
+                            error = _state.sent();
+                            console.warn("Failed to load theme: ".concat(theme), error);
+                            (_editorRef_current1 = editorRef.current) === null || _editorRef_current1 === void 0 ? void 0 : _editorRef_current1.setTheme("ace/theme/github");
+                            return [
+                                3,
+                                3
+                            ];
+                        case 3:
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        });
     }, [
-        (_editorProps_codeProps = editorProps.codeProps) === null || _editorProps_codeProps === void 0 ? void 0 : _editorProps_codeProps.theme,
-        props.theme
+        (_editorProps_codeProps1 = editorProps.codeProps) === null || _editorProps_codeProps1 === void 0 ? void 0 : _editorProps_codeProps1.theme,
+        props.theme,
+        aceLoaded
     ]);
     // 暴露设置语言的方法
-    var setLanguage = useCallback(function(changeLang) {
-        var _element_language;
-        var lang = changeLang.toLowerCase();
-        if (((_element_language = element.language) === null || _element_language === void 0 ? void 0 : _element_language.toLowerCase()) === lang) return;
-        onUpdate({
-            language: lang
+    var setLanguage = useCallback(/*#__PURE__*/ function() {
+        var _ref = _async_to_generator(function(changeLang) {
+            var _element_language, lang, aceLangs, _editorRef_current, _editorRef_current1;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        lang = changeLang.toLowerCase();
+                        if (((_element_language = element.language) === null || _element_language === void 0 ? void 0 : _element_language.toLowerCase()) === lang) return [
+                            2
+                        ];
+                        onUpdate({
+                            language: lang
+                        });
+                        if (modeMap.has(lang)) {
+                            lang = modeMap.get(lang);
+                        }
+                        return [
+                            4,
+                            getAceLangs()
+                        ];
+                    case 1:
+                        aceLangs = _state.sent();
+                        if (aceLangs.has(lang)) {
+                            ;
+                            (_editorRef_current = editorRef.current) === null || _editorRef_current === void 0 ? void 0 : _editorRef_current.session.setMode("ace/mode/".concat(lang));
+                        } else {
+                            ;
+                            (_editorRef_current1 = editorRef.current) === null || _editorRef_current1 === void 0 ? void 0 : _editorRef_current1.session.setMode("ace/mode/text");
+                        }
+                        return [
+                            2
+                        ];
+                }
+            });
         });
-        if (modeMap.has(lang)) {
-            lang = modeMap.get(lang);
-        }
-        if (aceLangs.has(lang)) {
-            var _editorRef_current;
-            (_editorRef_current = editorRef.current) === null || _editorRef_current === void 0 ? void 0 : _editorRef_current.session.setMode("ace/mode/".concat(lang));
-        } else {
-            var _editorRef_current1;
-            (_editorRef_current1 = editorRef.current) === null || _editorRef_current1 === void 0 ? void 0 : _editorRef_current1.session.setMode("ace/mode/text");
-        }
-    }, [
+        return function(changeLang) {
+            return _ref.apply(this, arguments);
+        };
+    }(), [
         element,
         onUpdate
     ]);

package/dist/Plugins/code/loadAceEditor.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Ace Editor 异步加载器
+ *
+ * 使用单例模式确保 ace-builds 库只加载一次
+ * 支持动态导入主题和语言模式，实现代码分割
+ * CSS 文件也会异步加载
+ */
+/// <reference types="ace-builds" />
+type AceEditorModule = typeof import('ace-builds');
+/**
+ * 加载 Ace Editor 核心库
+ * 使用单例模式确保只加载一次
+ */
+export declare const loadAceEditor: () => Promise<AceEditorModule>;
+/**
+ * 加载 Ace Editor 主题
+ * 支持按需加载主题和对应的 CSS，减少初始 bundle 大小
+ */
+export declare const loadAceTheme: (themeName: string) => Promise<void>;
+/**
+ * 预加载 Ace Editor 资源
+ * 使用动态 import 提前开始加载，但不阻塞当前执行
+ * 可以在用户可能使用代码编辑器之前调用此函数
+ */
+export declare const preloadAceEditor: () => void;
+export {};