@ant-design/agentic-ui 2.8.0 → 2.9.0

package/dist/MarkdownEditor/editor/utils/useLocalState.js

@@ -1,40 +1,99 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropSymbols = Object.getOwnPropertySymbols;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __propIsEnum = Object.prototype.propertyIsEnumerable;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues = (a, b) => {
-  for (var prop in b || (b = {}))
-    if (__hasOwnProp.call(b, prop))
-      __defNormalProp(a, prop, b[prop]);
-  if (__getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(b)) {
-      if (__propIsEnum.call(b, prop))
-        __defNormalProp(a, prop, b[prop]);
-    }
-  return a;
-};
-
-// src/MarkdownEditor/editor/utils/useLocalState.ts
-import { useCallback, useRef, useState } from "react";
-var useLocalState = (data) => {
-  const initialData = data instanceof Function ? data() : data;
-  const [state, setReactState] = useState(initialData);
-  const stateRef = useRef(state);
-  stateRef.current = state;
-  const setState = useCallback((update) => {
-    if (update instanceof Function) {
-      setReactState((prevState) => {
-        const newState = __spreadValues({}, prevState);
-        update(newState);
-        return newState;
-      });
+/* eslint-disable @typescript-eslint/ban-types */ 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 _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
     } else {
-      setReactState((prevState) => __spreadValues(__spreadValues({}, prevState), update));
+        obj[key] = value;
     }
-  }, []);
-  return [state, setState];
-};
-export {
-  useLocalState
+    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] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+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);
+}
+import { useCallback, useRef, useState } from "react";
+export var useLocalState = function(data) {
+    var initialData = data instanceof Function ? data() : data;
+    var _useState = _sliced_to_array(useState(initialData), 2), state = _useState[0], setReactState = _useState[1];
+    // Use ref to ensure we always have the latest state in our setter
+    var stateRef = useRef(state);
+    stateRef.current = state;
+    var setState = useCallback(function(update) {
+        if (update instanceof Function) {
+            setReactState(function(prevState) {
+                var newState = _object_spread({}, prevState);
+                update(newState);
+                return newState;
+            });
+        } else {
+            setReactState(function(prevState) {
+                return _object_spread({}, prevState, update);
+            });
+        }
+    }, []);
+    return [
+        state,
+        setState
+    ];
 };

package/dist/MarkdownEditor/el.js

@@ -0,0 +1 @@
+export { };

package/dist/MarkdownEditor/hooks/editor.js

@@ -1,4 +1,49 @@
-// src/MarkdownEditor/hooks/editor.ts
+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 _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 _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);
+}
 import { useCallback } from "react";
 import { Path, Transforms } from "slate";
 import { ReactEditor, useSlate } from "slate-react";
@@ -7,46 +52,83 @@ import { useEditorStore } from "../editor/store";
 import { useGetSetState } from "../editor/utils";
 import { EditorUtils } from "../editor/utils/editorUtils";
 import { useSubject } from "./subscribe";
-var useMEditor = (el) => {
-  const editor = useSlate();
-  const update = useCallback(
-    (props, current) => {
-      Transforms.setNodes(editor, props, {
-        at: ReactEditor.findPath(editor, current || el)
-      });
-    },
-    [editor, el]
-  );
-  return [editor, update];
-};
-var useSelStatus = (element) => {
-  const editor = useSlate();
-  const { store, markdownEditorRef } = useEditorStore();
-  const [state, setState] = useGetSetState({
-    selected: ReactEditor.isFocused(editor),
-    path: EditorUtils.findPath(editor, element)
-  });
-  useSubject(
-    selChange$,
-    (ctx) => {
-      var _a;
-      const path = EditorUtils.findPath(markdownEditorRef.current, element);
-      if (!ctx) {
-        return setState({
-          selected: false,
-          path
+/**
+ * 自定义钩子 `useMEditor` 用于管理 Slate 编辑器中的节点更新和删除操作。
+ *
+ * @param el - 基础元素，用于确定操作的目标节点。
+ * @returns 包含编辑器实例、更新函数和删除函数的元组。
+ *
+ * @example
+ * ```typescript
+ * const [editor, update, remove] = useMEditor(element);
+ *
+ * // 更新节点属性
+ * update({ key: 'value' }, currentElement);
+ *
+ * // 删除节点
+ * remove(currentElement);
+ * ```
+ *
+ * @function
+ * @name useMEditor
+ * @param {BaseElement} el - 基础元素，用于确定操作的目标节点。
+ * @returns {[Editor, (props: Record<string, any>, current?: BaseElement) => void, (current?: BaseElement) => void]}
+ *          包含编辑器实例、更新函数和删除函数的元组。
+ */ export var useMEditor = function(el) {
+    var editor = useSlate();
+    var update = useCallback(function(props, current) {
+        Transforms.setNodes(editor, props, {
+            at: ReactEditor.findPath(editor, current || el)
         });
-      }
-      setState({
-        path,
-        selected: Path.equals(path, ((_a = ctx.node) == null ? void 0 : _a[1]) || [])
-      });
-    },
-    [element]
-  );
-  return [state().selected, state().path, store];
+    }, [
+        editor,
+        el
+    ]);
+    return [
+        editor,
+        update
+    ];
 };
-export {
-  useMEditor,
-  useSelStatus
+/**
+ * 自定义 Hook，用于获取编辑器中元素的选中状态和路径。
+ *
+ * @param element - 需要检查的元素。
+ * @returns 一个包含选中状态、路径和编辑器存储的数组。
+ *
+ * @remarks
+ * 该 Hook 使用 `useEditorStore` 获取编辑器存储，并使用 `useGetSetState` 管理组件状态。
+ * 它通过 `useSubject` 订阅 `selChange$` 主题，以响应选中状态的变化。
+ *
+ * @example
+ * ```typescript
+ * const [isSelected, elementPath, editorStore] = useSelStatus(someElement);
+ * ```
+ */ export var useSelStatus = function(element) {
+    var editor = useSlate();
+    var _useEditorStore = useEditorStore(), store = _useEditorStore.store, markdownEditorRef = _useEditorStore.markdownEditorRef;
+    var _useGetSetState = _sliced_to_array(useGetSetState({
+        selected: ReactEditor.isFocused(editor),
+        path: EditorUtils.findPath(editor, element)
+    }), 2), state = _useGetSetState[0], setState = _useGetSetState[1];
+    useSubject(selChange$, function(ctx) {
+        var _ctx_node;
+        var path = EditorUtils.findPath(markdownEditorRef.current, element);
+        if (!ctx) {
+            return setState({
+                selected: false,
+                path: path
+            });
+        }
+        setState({
+            path: path,
+            selected: Path.equals(path, ((_ctx_node = ctx.node) === null || _ctx_node === void 0 ? void 0 : _ctx_node[1]) || [])
+        });
+    }, [
+        element
+    ]);
+    return [
+        state().selected,
+        state().path,
+        store
+    ];
 };

package/dist/MarkdownEditor/hooks/subscribe.js

@@ -1,17 +1,20 @@
-// src/MarkdownEditor/hooks/subscribe.ts
 import { useLayoutEffect } from "react";
-var useSubject = (subject, fn, deps = []) => {
-  useLayoutEffect(() => {
-    var _a;
-    if (!subject)
-      return;
-    const cancel = (_a = subject == null ? void 0 : subject.subscribe) == null ? void 0 : _a.call(subject, fn);
-    return () => {
-      var _a2;
-      return (_a2 = cancel == null ? void 0 : cancel.unsubscribe) == null ? void 0 : _a2.call(cancel);
-    };
-  }, deps);
-};
-export {
-  useSubject
+/**
+ * 订阅一个 `Subject` 或 `Observable`，并在值变化时调用指定的回调函数。
+ *
+ * @template T - `Subject` 或 `Observable` 中值的类型。
+ * @param {Subject<T> | Observable<T>} subject - 要订阅的 `Subject` 或 `Observable`。
+ * @param {(value: T) => void} fn - 当 `subject` 发出新值时调用的回调函数。
+ * @param {any[]} [deps=[]] - 依赖项数组，当依赖项变化时重新订阅 `subject`。
+ */ export var useSubject = function(subject, fn) {
+    var deps = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : [];
+    useLayoutEffect(function() {
+        var _subject_subscribe;
+        if (!subject) return;
+        var cancel = subject === null || subject === void 0 ? void 0 : (_subject_subscribe = subject.subscribe) === null || _subject_subscribe === void 0 ? void 0 : _subject_subscribe.call(subject, fn);
+        return function() {
+            var _cancel_unsubscribe;
+            return cancel === null || cancel === void 0 ? void 0 : (_cancel_unsubscribe = cancel.unsubscribe) === null || _cancel_unsubscribe === void 0 ? void 0 : _cancel_unsubscribe.call(cancel);
+        };
+    }, deps);
 };

package/dist/MarkdownEditor/index.js

@@ -1,36 +1,124 @@
-var __defProp = Object.defineProperty;
-var __defProps = Object.defineProperties;
-var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
-var __getOwnPropSymbols = Object.getOwnPropertySymbols;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __propIsEnum = Object.prototype.propertyIsEnumerable;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues = (a, b) => {
-  for (var prop in b || (b = {}))
-    if (__hasOwnProp.call(b, prop))
-      __defNormalProp(a, prop, b[prop]);
-  if (__getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(b)) {
-      if (__propIsEnum.call(b, prop))
-        __defNormalProp(a, prop, b[prop]);
+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_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
     }
-  return a;
-};
-var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-
-// src/MarkdownEditor/index.tsx
+    return obj;
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread 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] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+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);
+}
 import React from "react";
 import { standardPlugins } from "../Plugins/defaultPlugins";
 import { BaseMarkdownEditor } from "./BaseMarkdownEditor";
 export * from "./BaseMarkdownEditor";
-var MarkdownEditor = (props) => {
-  return /* @__PURE__ */ React.createElement(
-    BaseMarkdownEditor,
-    __spreadProps(__spreadValues({}, props), {
-      plugins: [...standardPlugins || [], ...(props == null ? void 0 : props.plugins) || []]
-    })
-  );
-};
-export {
-  MarkdownEditor
+/**
+ * MarkdownEditor 组件 - Markdown编辑器组件
+ *
+ * 该组件是一个功能完整的Markdown编辑器，基于BaseMarkdownEditor构建，
+ * 集成了标准插件集合，提供开箱即用的Markdown编辑功能。
+ *
+ * @component
+ * @description Markdown编辑器组件，提供完整的Markdown编辑功能
+ * @param {MarkdownEditorProps} props - 组件属性
+ * @param {string} [props.initValue] - 初始值
+ * @param {(value: string) => void} [props.onChange] - 内容变化回调
+ * @param {React.RefObject} [props.editorRef] - 编辑器引用
+ * @param {boolean} [props.readonly] - 是否只读模式
+ * @param {Plugin[]} [props.plugins] - 自定义插件列表
+ * @param {MarkdownRenderConfig} [props.markdownRenderConfig] - Markdown渲染配置
+ * @param {string} [props.className] - 自定义CSS类名
+ * @param {React.CSSProperties} [props.style] - 自定义样式
+ *
+ * @example
+ * ```tsx
+ * <MarkdownEditor
+ *   initValue="# Hello World"
+ *   onChange={(value) => console.log('内容变化:', value)}
+ *   editorRef={editorRef}
+ *   readonly={false}
+ * />
+ * ```
+ *
+ * @returns {React.ReactElement} 渲染的Markdown编辑器组件
+ *
+ * @remarks
+ * - 基于BaseMarkdownEditor构建
+ * - 集成标准插件集合
+ * - 支持自定义插件扩展
+ * - 提供完整的Markdown编辑功能
+ * - 支持只读模式
+ * - 支持内容变化监听
+ * - 提供编辑器引用
+ */ export var MarkdownEditor = function(props) {
+    return /*#__PURE__*/ React.createElement(BaseMarkdownEditor, _object_spread_props(_object_spread({}, props), {
+        plugins: _to_consumable_array(standardPlugins || []).concat(_to_consumable_array((props === null || props === void 0 ? void 0 : props.plugins) || []))
+    }));
 };

package/dist/MarkdownEditor/plugin.js

@@ -1,6 +1,3 @@
-// src/MarkdownEditor/plugin.ts
 import React from "react";
-var PluginContext = React.createContext([]);
-export {
-  PluginContext
-};
+// 使用 Context 传递插件配置
+export var PluginContext = React.createContext([]);