@ant-design/agentic-ui 2.11.1 → 2.12.0

package/dist/Utils/loadCSS.js

@@ -0,0 +1,264 @@
+/**
+ * @fileoverview CSS 异步加载工具
+ * 
+ * 提供动态加载 CSS 文件的功能，支持按需加载和缓存
+ */ 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 _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
+        };
+    }
+}
+var loadedCSS = new Set();
+/**
+ * 异步加载 CSS 文件
+ * 
+ * 对于 webpack 处理的 CSS 文件，应该使用动态 import 函数形式
+ * webpack 会自动处理 CSS 的提取和加载
+ * 
+ * @param cssPath - CSS 文件路径（推荐使用函数形式的动态 import）
+ * @returns Promise<void> 加载完成的 Promise
+ * 
+ * @example
+ * ```typescript
+ * // 推荐：使用动态 import 加载 CSS 模块（webpack 会自动处理）
+ * await loadCSS(() => import('./katex.min.css'));
+ * 
+ * // 不推荐：直接使用字符串路径（仅适用于外部 URL）
+ * await loadCSS('https://example.com/style.css');
+ * ```
+ */ export var loadCSS = /*#__PURE__*/ function() {
+    var _ref = _async_to_generator(function(cssPath) {
+        var pathKey, error, existingLink, link;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    if (typeof window === 'undefined') {
+                        return [
+                            2
+                        ];
+                    }
+                    if (!(typeof cssPath === 'function')) return [
+                        3,
+                        5
+                    ];
+                    pathKey = cssPath.toString();
+                    // 如果已经加载过，直接返回
+                    if (loadedCSS.has(pathKey)) {
+                        return [
+                            2
+                        ];
+                    }
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        3,
+                        ,
+                        4
+                    ]);
+                    // 执行动态 import，webpack 会自动处理 CSS
+                    return [
+                        4,
+                        cssPath()
+                    ];
+                case 2:
+                    _state.sent();
+                    loadedCSS.add(pathKey);
+                    return [
+                        3,
+                        4
+                    ];
+                case 3:
+                    error = _state.sent();
+                    console.warn('Failed to load CSS:', error);
+                    // 即使加载失败也标记为已加载，避免重复尝试
+                    loadedCSS.add(pathKey);
+                    return [
+                        3,
+                        4
+                    ];
+                case 4:
+                    return [
+                        2
+                    ];
+                case 5:
+                    // 处理字符串路径（仅适用于外部 URL）
+                    // 如果已经加载过，直接返回
+                    if (loadedCSS.has(cssPath)) {
+                        return [
+                            2
+                        ];
+                    }
+                    // 检查是否已经存在该 CSS 链接
+                    existingLink = document.querySelector('link[href*="'.concat(cssPath, '"]'));
+                    if (existingLink) {
+                        loadedCSS.add(cssPath);
+                        return [
+                            2
+                        ];
+                    }
+                    // 创建 link 元素（仅用于外部 URL）
+                    link = document.createElement('link');
+                    link.rel = 'stylesheet';
+                    link.type = 'text/css';
+                    link.href = cssPath;
+                    return [
+                        2,
+                        new Promise(function(resolve) {
+                            link.onload = function() {
+                                loadedCSS.add(cssPath);
+                                resolve();
+                            };
+                            link.onerror = function() {
+                                console.warn("Failed to load CSS: ".concat(cssPath));
+                                // 即使加载失败也标记为已加载，避免重复尝试
+                                loadedCSS.add(cssPath);
+                                resolve(); // 不 reject，避免阻塞
+                            };
+                            // 添加到 head
+                            document.head.appendChild(link);
+                        })
+                    ];
+            }
+        });
+    });
+    return function loadCSS(cssPath) {
+        return _ref.apply(this, arguments);
+    };
+}();
+/**
+ * 预加载 CSS 文件
+ * 使用低优先级加载，不阻塞当前执行
+ * 
+ * @param cssPath - CSS 文件路径
+ */ export var preloadCSS = function(cssPath) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    // 如果已经加载过，直接返回
+    if (typeof cssPath === 'string' && loadedCSS.has(cssPath)) {
+        return;
+    }
+    // 触发加载但不等待结果
+    loadCSS(cssPath).catch(function() {
+    // 静默处理错误，预加载失败不影响后续使用
+    });
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ant-design/agentic-ui",
-  "version": "2.11.1",
+  "version": "2.12.0",
   "description": "面向智能体的 UI 组件库，提供多步推理可视化、工具调用展示、任务执行协同等 Agentic UI 能力",
   "repository": "git@github.com:ant-design/agentic-ui.git",
   "license": "MIT",