@cgboiler/biz-basic 1.0.53 → 1.0.55

package/es/rich-text-editor/extensions/HashTag.js

@@ -0,0 +1,133 @@
+import Mention from "@tiptap/extension-mention";
+import {
+  checkConsumed,
+  markAsConsumed,
+  isSpaceKey,
+  checkLastCharIsSpace
+} from "../utils/triggerHelpers";
+const createHashTagExtension = (options) => {
+  const { emit, imeState, editorRef } = options;
+  return Mention.extend({
+    name: "hashTag",
+    parseHTML() {
+      return [{ tag: 'span[data-type="hashTag"]' }];
+    },
+    addAttributes() {
+      return {
+        id: {
+          default: null,
+          parseHTML: (element) => element.getAttribute("data-id"),
+          renderHTML: (attributes) => {
+            if (!attributes.id)
+              return {};
+            return { "data-id": attributes.id };
+          }
+        },
+        label: {
+          default: null,
+          parseHTML: (element) => element.getAttribute("data-label"),
+          renderHTML: (attributes) => {
+            if (!attributes.label)
+              return {};
+            return { "data-label": attributes.label };
+          }
+        },
+        type: {
+          default: null,
+          parseHTML: (element) => element.getAttribute("data-tag-type"),
+          renderHTML: (attributes) => {
+            if (!attributes.type)
+              return {};
+            return { "data-tag-type": attributes.type };
+          }
+        }
+      };
+    },
+    renderHTML({ node }) {
+      var _a, _b, _c, _d, _e, _f;
+      const id = (_b = (_a = node == null ? void 0 : node.attrs) == null ? void 0 : _a.id) != null ? _b : "";
+      const label = (_d = (_c = node == null ? void 0 : node.attrs) == null ? void 0 : _c.label) != null ? _d : "";
+      const type = (_f = (_e = node == null ? void 0 : node.attrs) == null ? void 0 : _e.type) != null ? _f : "";
+      return [
+        "span",
+        {
+          class: "hash-tag",
+          "data-type": "hashTag",
+          "data-id": id,
+          "data-label": label,
+          "data-tag-type": type,
+          "data-hash-tag": "#",
+          contenteditable: "false"
+        },
+        `#${label}`
+      ];
+    }
+  }).configure({
+    deleteTriggerWithBackspace: true,
+    suggestion: {
+      char: "#",
+      allowedPrefixes: null,
+      allowSpaces: false,
+      /**
+       * allow - 判断是否允许触发建议态
+       */
+      allow: ({ state, range }) => {
+        if (imeState.isComposing)
+          return true;
+        return !checkConsumed(state, range);
+      },
+      render() {
+        let activeRange = null;
+        let exitCause = "unknown";
+        return {
+          onStart({ editor, range, command, query }) {
+            activeRange = range;
+            editorRef.current = editor;
+            exitCause = "unknown";
+            emit("hashTag-triggered", (data) => {
+              try {
+                (editorRef.current || editor).chain().focus().deleteRange(activeRange || range).insertContentAt((activeRange || range).from, {
+                  type: "hashTag",
+                  attrs: { id: data.hashTagId, label: data.name, type: data.type }
+                }).setTextSelection((activeRange || range).from + 1).insertContent(" ").run();
+              } catch (e) {
+                command({ id: data.hashTagId, label: data.name, type: data.type });
+                (editorRef.current || editor).chain().focus().insertContent(" ").run();
+              }
+            });
+            emit("hashTag-input", query != null ? query : "");
+          },
+          onUpdate({ query, range, editor }) {
+            activeRange = range || activeRange;
+            editorRef.current = editor || editorRef.current;
+            emit("hashTag-input", query != null ? query : "");
+          },
+          onKeyDown({ event }) {
+            if (isSpaceKey(event)) {
+              exitCause = "space";
+            }
+            return false;
+          },
+          onExit({ editor, range }) {
+            if (imeState.isComposing) {
+              return;
+            }
+            if (checkLastCharIsSpace(editor)) {
+              exitCause = "space";
+            }
+            markAsConsumed(editor, range, "#");
+            activeRange = null;
+            editorRef.current = null;
+            emit("hashTag-exit", {
+              reason: exitCause,
+              nonContiguous: exitCause === "space"
+            });
+          }
+        };
+      }
+    }
+  });
+};
+export {
+  createHashTagExtension
+};

package/es/rich-text-editor/extensions/HorizontalRule.d.ts

@@ -0,0 +1,2 @@
+export declare const HorizontalRule: import("@tiptap/core").Node<import("@tiptap/extension-horizontal-rule").HorizontalRuleOptions, any>;
+export default HorizontalRule;

package/es/rich-text-editor/extensions/HorizontalRule.js

@@ -0,0 +1,16 @@
+import { mergeAttributes } from "@tiptap/core";
+import TiptapHorizontalRule from "@tiptap/extension-horizontal-rule";
+const HorizontalRule = TiptapHorizontalRule.extend({
+  renderHTML() {
+    return [
+      "div",
+      mergeAttributes(this.options.HTMLAttributes, { "data-type": this.name }),
+      ["hr"]
+    ];
+  }
+});
+var stdin_default = HorizontalRule;
+export {
+  HorizontalRule,
+  stdin_default as default
+};

package/es/rich-text-editor/extensions/IMEComposition.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 文件说明：
+ * - IME Composition 状态跟踪扩展
+ * - 功能：跟踪当前是否处于 IME 输入法组合输入状态（如中文拼音输入）
+ * - 作用：防止在 composition 期间误判为输入结束，导致建议提示框过早关闭
+ */
+import { Extension } from '@tiptap/core';
+export interface IMECompositionState {
+    isComposing: boolean;
+}
+/**
+ * 创建 IME Composition 跟踪扩展
+ * @param state - 共享状态对象
+ * @returns TipTap Extension
+ */
+export declare const createIMECompositionExtension: (state: IMECompositionState) => Extension<any, any>;

package/es/rich-text-editor/extensions/IMEComposition.js

@@ -0,0 +1,30 @@
+import { Extension } from "@tiptap/core";
+import { Plugin } from "@tiptap/pm/state";
+const createIMECompositionExtension = (state) => {
+  return Extension.create({
+    name: "imeCompositionTracker",
+    addProseMirrorPlugins() {
+      return [
+        new Plugin({
+          props: {
+            handleDOMEvents: {
+              compositionstart: () => {
+                state.isComposing = true;
+                return false;
+              },
+              compositionend: () => {
+                setTimeout(() => {
+                  state.isComposing = false;
+                }, 10);
+                return false;
+              }
+            }
+          }
+        })
+      ];
+    }
+  });
+};
+export {
+  createIMECompositionExtension
+};

package/es/rich-text-editor/extensions/ImageUpload.d.ts

@@ -0,0 +1,56 @@
+import { Node } from '@tiptap/vue-3';
+import type { NodeType } from '@tiptap/pm/model';
+export type UploadFunction = (file: File, onProgress?: (event: {
+    progress: number;
+}) => void, abortSignal?: AbortSignal) => Promise<string>;
+export interface ImageUploadNodeOptions {
+    /**
+     * The type of the node.
+     * @default 'image'
+     */
+    type?: string | NodeType | undefined;
+    /**
+     * Acceptable file types for upload.
+     * @default 'image/*'
+     */
+    accept?: string;
+    /**
+     * Maximum number of files that can be uploaded.
+     * @default 1
+     */
+    limit?: number;
+    /**
+     * Maximum file size in bytes (0 for unlimited).
+     * @default 0
+     */
+    maxSize?: number;
+    /**
+     * Function to handle the upload process.
+     */
+    upload?: UploadFunction;
+    /**
+     * Callback for upload errors.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Callback for successful uploads.
+     */
+    onSuccess?: (url: string) => void;
+    /**
+     * HTML attributes to add to the image element.
+     * @default {}
+     */
+    HTMLAttributes: Record<string, any>;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        imageUpload: {
+            setImageUploadNode: (options?: Partial<ImageUploadNodeOptions>) => ReturnType;
+        };
+    }
+}
+/**
+ * A Tiptap node extension that creates an image upload component.
+ */
+export declare const ImageUpload: Node<ImageUploadNodeOptions, any>;
+export default ImageUpload;

package/es/rich-text-editor/extensions/ImageUpload.js

@@ -0,0 +1,80 @@
+import { mergeAttributes, Node, VueNodeViewRenderer } from "@tiptap/vue-3";
+import { ImageUploadNodeView } from "../menu-system/components/image-upload-node";
+const ImageUpload = Node.create({
+  name: "imageUpload",
+  group: "block",
+  draggable: true,
+  selectable: true,
+  atom: true,
+  addOptions() {
+    return {
+      type: "image",
+      accept: "image/*",
+      limit: 1,
+      maxSize: 0,
+      upload: void 0,
+      onError: void 0,
+      onSuccess: void 0,
+      HTMLAttributes: {}
+    };
+  },
+  addAttributes() {
+    return {
+      accept: {
+        default: this.options.accept
+      },
+      limit: {
+        default: this.options.limit
+      },
+      maxSize: {
+        default: this.options.maxSize
+      }
+    };
+  },
+  parseHTML() {
+    return [{ tag: 'div[data-type="image-upload"]' }];
+  },
+  renderHTML({ HTMLAttributes }) {
+    return ["div", mergeAttributes({ "data-type": "image-upload" }, HTMLAttributes)];
+  },
+  addNodeView() {
+    return VueNodeViewRenderer(ImageUploadNodeView);
+  },
+  addCommands() {
+    return {
+      setImageUploadNode: (options) => ({ commands }) => {
+        return commands.insertContent({
+          type: this.name,
+          attrs: options
+        });
+      }
+    };
+  },
+  /**
+   * Adds Enter key handler to trigger the upload component when it's selected.
+   */
+  addKeyboardShortcuts() {
+    return {
+      Enter: ({ editor }) => {
+        const { selection } = editor.state;
+        const { nodeAfter } = selection.$from;
+        if (nodeAfter && nodeAfter.type.name === "imageUpload" && editor.isActive("imageUpload")) {
+          const nodeEl = editor.view.nodeDOM(selection.$from.pos);
+          if (nodeEl && nodeEl instanceof HTMLElement) {
+            const firstChild = nodeEl.firstChild;
+            if (firstChild && firstChild instanceof HTMLElement) {
+              firstChild.click();
+              return true;
+            }
+          }
+        }
+        return false;
+      }
+    };
+  }
+});
+var stdin_default = ImageUpload;
+export {
+  ImageUpload,
+  stdin_default as default
+};

package/es/rich-text-editor/extensions/MarkdownExtensions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 文件说明：
+ * - Markdown 相关扩展
+ * - 包括 Markdown 解析器和链接输入规则
+ */
+import { Extension } from '@tiptap/core';
+/**
+ * Markdown 解析器配置
+ */
+export declare const MarkdownExtension: Extension<import("tiptap-markdown").MarkdownOptions, import("tiptap-markdown").MarkdownStorage>;
+/**
+ * Markdown 链接输入规则扩展
+ * 语法：[text](url) + 空格
+ */
+export declare const MarkdownLinkInputRule: Extension<any, any>;

package/es/rich-text-editor/extensions/MarkdownExtensions.js

@@ -0,0 +1,35 @@
+import { Extension, InputRule } from "@tiptap/core";
+import { Markdown } from "tiptap-markdown";
+const MarkdownExtension = Markdown.configure({
+  html: true,
+  tightLists: true,
+  tightListClass: "tight",
+  bulletListMarker: "-",
+  linkify: true,
+  breaks: false,
+  transformPastedText: true,
+  transformCopiedText: true
+});
+const MarkdownLinkInputRule = Extension.create({
+  name: "markdownLinkInputRule",
+  addInputRules() {
+    return [
+      new InputRule({
+        find: /\[([^\]]+)\]\(([^\)]+)\)\s/,
+        handler: ({ range, match, commands }) => {
+          const [, text, href] = match;
+          commands.deleteRange({ from: range.from, to: range.to });
+          commands.insertContent({
+            type: "text",
+            text,
+            marks: [{ type: "link", attrs: { href } }]
+          });
+        }
+      })
+    ];
+  }
+});
+export {
+  MarkdownExtension,
+  MarkdownLinkInputRule
+};

package/es/rich-text-editor/extensions/MediaInputRules.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 文件说明：
+ * - 媒体输入规则扩展（视频和音频）
+ * - 支持通过特定语法快速插入视频和音频元素
+ * - 语法：!video(url) 和 !audio(url)
+ */
+import { Extension } from '@tiptap/core';
+/**
+ * 视频输入规则扩展
+ * 语法：!video(url) + 空格
+ */
+export declare const VideoInputRule: Extension<any, any>;
+/**
+ * 音频输入规则扩展
+ * 语法：!audio(url) + 空格
+ */
+export declare const AudioInputRule: Extension<any, any>;

package/es/rich-text-editor/extensions/MediaInputRules.js

@@ -0,0 +1,47 @@
+import { Extension, InputRule } from "@tiptap/core";
+const VideoInputRule = Extension.create({
+  name: "videoInputRule",
+  addInputRules() {
+    return [
+      new InputRule({
+        find: /!video\(([^)]+)\)\s/,
+        handler: ({ range, match, commands }) => {
+          const [, url] = match;
+          if (url) {
+            const html = `<video src="${url}" autoplay="" loop="" muted="" controls="" playsinline=""></video>`;
+            commands.deleteRange(range);
+            commands.insertContent({
+              type: "htmlBlock",
+              attrs: { html }
+            });
+          }
+        }
+      })
+    ];
+  }
+});
+const AudioInputRule = Extension.create({
+  name: "audioInputRule",
+  addInputRules() {
+    return [
+      new InputRule({
+        find: /!audio\(([^)]+)\)\s/,
+        handler: ({ range, match, commands }) => {
+          const [, url] = match;
+          if (url) {
+            const html = `<audio src="${url}" controls="" playsinline=""></audio>`;
+            commands.deleteRange(range);
+            commands.insertContent({
+              type: "htmlBlock",
+              attrs: { html }
+            });
+          }
+        }
+      })
+    ];
+  }
+});
+export {
+  AudioInputRule,
+  VideoInputRule
+};

package/es/rich-text-editor/extensions/MentionExtension.d.ts

@@ -0,0 +1,15 @@
+export interface MentionExtensionOptions {
+    emit: any;
+    imeState: {
+        isComposing: boolean;
+    };
+    editorRef: {
+        current: any;
+    };
+}
+/**
+ * 创建 Mention 扩展
+ * @param options - 配置选项
+ * @returns TipTap Extension
+ */
+export declare const createMentionExtension: (options: MentionExtensionOptions) => import("@tiptap/core").Node<import("@tiptap/extension-mention").MentionOptions<any, import("@tiptap/extension-mention").MentionNodeAttrs>, any>;

package/es/rich-text-editor/extensions/MentionExtension.js

@@ -0,0 +1,60 @@
+import Mention from "@tiptap/extension-mention";
+import { checkConsumed, markAsConsumed } from "../utils/triggerHelpers";
+const createMentionExtension = (options) => {
+  const { emit, imeState, editorRef } = options;
+  return Mention.configure({
+    HTMLAttributes: {
+      class: "mention"
+    },
+    deleteTriggerWithBackspace: true,
+    suggestion: {
+      char: "@",
+      allowedPrefixes: null,
+      allowSpaces: false,
+      allow: ({ state, range }) => {
+        if (imeState.isComposing)
+          return true;
+        if (checkConsumed(state, range))
+          return false;
+        const doc = state.doc;
+        const $from = doc.resolve(range.from);
+        const isAtStart = range.from === $from.start();
+        const prevChar = isAtStart ? "" : doc.textBetween(range.from - 1, range.from);
+        if (/[a-zA-Z0-9]/.test(prevChar))
+          return false;
+        const query = doc.textBetween(range.from + 1, range.to);
+        if (/[0-9]/.test(query))
+          return false;
+        return true;
+      },
+      render() {
+        return {
+          onStart({ editor, command, query }) {
+            editorRef.current = editor;
+            emit("mention-triggered", (data) => {
+              command({
+                id: data.userId,
+                label: data.name
+              });
+            });
+            emit("mention-input", query != null ? query : "");
+          },
+          onUpdate({ query, editor }) {
+            editorRef.current = editor;
+            emit("mention-input", query != null ? query : "");
+          },
+          onExit({ editor, range }) {
+            if (imeState.isComposing) {
+              return;
+            }
+            markAsConsumed(editor, range, "@");
+            emit("mention-exit");
+          }
+        };
+      }
+    }
+  });
+};
+export {
+  createMentionExtension
+};

package/es/rich-text-editor/extensions/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 文件说明：
+ * - 扩展模块统一导出入口
+ * - 方便外部引用和管理
+ */
+export { ConsumedTrigger } from './ConsumedTrigger';
+export { createIMECompositionExtension } from './IMEComposition';
+export type { IMECompositionState } from './IMEComposition';
+export { VideoInputRule, AudioInputRule } from './MediaInputRules';
+export { MarkdownExtension, MarkdownLinkInputRule } from './MarkdownExtensions';
+export { createHashTagExtension } from './HashTag';
+export type { HashTagOptions } from './HashTag';
+export { createMentionExtension } from './MentionExtension';
+export type { MentionExtensionOptions } from './MentionExtension';
+export { createCustomContentExtension } from './CustomContent';
+export { default as HtmlBlock } from './HtmlBlock';

package/es/rich-text-editor/extensions/index.js

@@ -0,0 +1,20 @@
+import { ConsumedTrigger } from "./ConsumedTrigger";
+import { createIMECompositionExtension } from "./IMEComposition";
+import { VideoInputRule, AudioInputRule } from "./MediaInputRules";
+import { MarkdownExtension, MarkdownLinkInputRule } from "./MarkdownExtensions";
+import { createHashTagExtension } from "./HashTag";
+import { createMentionExtension } from "./MentionExtension";
+import { createCustomContentExtension } from "./CustomContent";
+import { default as default2 } from "./HtmlBlock";
+export {
+  AudioInputRule,
+  ConsumedTrigger,
+  default2 as HtmlBlock,
+  MarkdownExtension,
+  MarkdownLinkInputRule,
+  VideoInputRule,
+  createCustomContentExtension,
+  createHashTagExtension,
+  createIMECompositionExtension,
+  createMentionExtension
+};

package/es/rich-text-editor/hooks/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 文件说明：
+ * - Hooks 统一导出入口
+ */
+export { useEditorHistory } from './useEditorHistory';
+export type { UseEditorHistoryOptions } from './useEditorHistory';

package/es/rich-text-editor/hooks/index.js

@@ -0,0 +1,4 @@
+import { useEditorHistory } from "./useEditorHistory";
+export {
+  useEditorHistory
+};

package/es/rich-text-editor/hooks/useEditorHistory.d.ts

@@ -0,0 +1,17 @@
+import type { Editor } from '@tiptap/vue-3';
+export interface UseEditorHistoryOptions {
+    editor: () => Editor | undefined;
+    enabled: boolean;
+    saveInterval?: number;
+}
+/**
+ * 编辑器历史记录管理 Hook
+ * @param options - 配置选项
+ * @returns 历史记录相关方法和状态
+ */
+export declare const useEditorHistory: (options: UseEditorHistoryOptions) => {
+    noteId: import("vue").Ref<string, string>;
+    historyStore: LocalForage;
+    startAutoSave: () => void;
+    stopAutoSave: () => void;
+};