@4399ywkf/editor 0.1.0

package/dist/doc.js

@@ -0,0 +1,39 @@
+export { ArticleViewer, Audio, Button, CollabContext, CollabProvider, Column, Columns, DEFAULT_MAX_FILE_SIZES, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EditorConfigProvider, EditorContentArea, FileAttachment, FloatingElement, HIDE_FLOATING_META, LoadingSpinner, MAC_SYMBOLS, MAX_FILE_SIZE, MediaUploadButton, MediaUploadPlaceholder, NotionEditor, NotionEditorContent, EditorProvider as NotionEditorInner, PasteDropMedia, Popover, PopoverContent, PopoverTrigger, SR_ONLY, Separator, Spacer, Toolbar, ToolbarGroup, ToolbarSeparator, UiState, UserContext, UserProvider, Video, clamp, cn, defaultUiState, detectMediaKind, findNodeAtPosition, findNodePosition, findSelectionPosition, focusNextNode, formatShortcutKey, getAvatar, getElementOverflowPosition, getNodeDisplayName, getSelectedBlockNodes, getSelectedNodesOfType, getSelectionBoundingRect, getUrlParam, handleImageUpload, hasContentAbove, isAllowedUri, isExtensionAvailable, isMac, isMarkInSchema, isNodeInSchema, isNodeTypeSelected, isSelectionValid, isTextSelectionValid, isValidPosition, markHideFloatingOnNext, parseShortcutKeys, pickFile, removeEmptyParagraphs, resolveMaxSize, runMediaUpload, sanitizeUrl, selectCurrentBlockContent, selectNodeAndHideFloating, selectionWithinConvertibleTypes, updateNodesAttr, useCollab, useCollaboration, useComposedRef, useCursorVisibility, useEditorConfig, useElementRect, useFloatingElement, useFloatingToolbarVisibility, useIsBreakpoint, useIsomorphicLayoutEffect, useMenuNavigation, useOnClickOutside, useThrottledCallback, useTiptapEditor, useUiEditorState, use_ui_editor_state_default as useUiEditorStateDefault, useUnmount, useUser, useWindowSize } from './chunk-G6WM2PSU.js';
+import { useState, useEffect } from 'react';
+
+function useScrolling(target, options = {}) {
+  const { debounce = 150, fallbackToDocument = true } = options;
+  const [isScrolling, setIsScrolling] = useState(false);
+  useEffect(() => {
+    const element = target && typeof Window !== "undefined" && target instanceof Window ? target : target?.current ?? window;
+    const eventTarget = fallbackToDocument && element === window && typeof document !== "undefined" ? document : element;
+    const on = (el, event, handler) => el.addEventListener(event, handler, true);
+    const off = (el, event, handler) => el.removeEventListener(event, handler);
+    let timeout;
+    const supportsScrollEnd = element === window && "onscrollend" in window;
+    const handleScroll = () => {
+      if (!isScrolling) setIsScrolling(true);
+      if (!supportsScrollEnd) {
+        clearTimeout(timeout);
+        timeout = setTimeout(() => setIsScrolling(false), debounce);
+      }
+    };
+    const handleScrollEnd = () => setIsScrolling(false);
+    on(eventTarget, "scroll", handleScroll);
+    if (supportsScrollEnd) {
+      on(eventTarget, "scrollend", handleScrollEnd);
+    }
+    return () => {
+      off(eventTarget, "scroll", handleScroll);
+      if (supportsScrollEnd) {
+        off(eventTarget, "scrollend", handleScrollEnd);
+      }
+      clearTimeout(timeout);
+    };
+  }, [target, debounce, fallbackToDocument, isScrolling]);
+  return isScrolling;
+}
+
+export { useScrolling };
+//# sourceMappingURL=doc.js.map
+//# sourceMappingURL=doc.js.map

package/dist/doc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/use-scrolling.ts"],"names":[],"mappings":";;;AAWO,SAAS,YAAA,CACd,MAAA,EACA,OAAA,GAA+B,EAAC,EACvB;AACT,EAAA,MAAM,EAAE,QAAA,GAAW,GAAA,EAAK,kBAAA,GAAqB,MAAK,GAAI,OAAA;AACtD,EAAA,MAAM,CAAC,WAAA,EAAa,cAAc,CAAA,GAAI,SAAS,KAAK,CAAA;AAEpD,EAAA,SAAA,CAAU,MAAM;AAEd,IAAA,MAAM,OAAA,GACJ,UAAU,OAAO,MAAA,KAAW,eAAe,MAAA,YAAkB,MAAA,GACzD,MAAA,GACE,MAAA,EAAmC,OAAA,IAAW,MAAA;AAGtD,IAAA,MAAM,cACJ,kBAAA,IACA,OAAA,KAAY,UACZ,OAAO,QAAA,KAAa,cAChB,QAAA,GACA,OAAA;AAEN,IAAA,MAAM,EAAA,GAAK,CACT,EAAA,EACA,KAAA,EACA,YACG,EAAA,CAAG,gBAAA,CAAiB,KAAA,EAAO,OAAA,EAAS,IAAI,CAAA;AAE7C,IAAA,MAAM,GAAA,GAAM,CACV,EAAA,EACA,KAAA,EACA,YACG,EAAA,CAAG,mBAAA,CAAoB,OAAO,OAAO,CAAA;AAE1C,IAAA,IAAI,OAAA;AACJ,IAAA,MAAM,iBAAA,GAAoB,OAAA,KAAY,MAAA,IAAU,aAAA,IAAiB,MAAA;AAEjE,IAAA,MAAM,eAA8B,MAAM;AACxC,MAAA,IAAI,CAAC,WAAA,EAAa,cAAA,CAAe,IAAI,CAAA;AAErC,MAAA,IAAI,CAAC,iBAAA,EAAmB;AACtB,QAAA,YAAA,CAAa,OAAO,CAAA;AACpB,QAAA,OAAA,GAAU,UAAA,CAAW,MAAM,cAAA,CAAe,KAAK,GAAG,QAAQ,CAAA;AAAA,MAC5D;AAAA,IACF,CAAA;AAEA,IAAA,MAAM,eAAA,GAAiC,MAAM,cAAA,CAAe,KAAK,CAAA;AAEjE,IAAA,EAAA,CAAG,WAAA,EAAa,UAAU,YAAY,CAAA;AACtC,IAAA,IAAI,iBAAA,EAAmB;AACrB,MAAA,EAAA,CAAG,WAAA,EAAa,aAAa,eAAe,CAAA;AAAA,IAC9C;AAEA,IAAA,OAAO,MAAM;AACX,MAAA,GAAA,CAAI,WAAA,EAAa,UAAU,YAAY,CAAA;AACvC,MAAA,IAAI,iBAAA,EAAmB;AACrB,QAAA,GAAA,CAAI,WAAA,EAAa,aAAa,eAAe,CAAA;AAAA,MAC/C;AACA,MAAA,YAAA,CAAa,OAAO,CAAA;AAAA,IACtB,CAAA;AAAA,EACF,GAAG,CAAC,MAAA,EAAQ,QAAA,EAAU,kBAAA,EAAoB,WAAW,CAAC,CAAA;AAEtD,EAAA,OAAO,WAAA;AACT","file":"doc.js","sourcesContent":["import type { RefObject } from \"react\"\nimport { useEffect, useState } from \"react\"\n\ntype ScrollTarget = RefObject<HTMLElement> | Window | null | undefined\ntype EventTargetWithScroll = Window | HTMLElement | Document\n\ninterface UseScrollingOptions {\n  debounce?: number\n  fallbackToDocument?: boolean\n}\n\nexport function useScrolling(\n  target?: ScrollTarget,\n  options: UseScrollingOptions = {}\n): boolean {\n  const { debounce = 150, fallbackToDocument = true } = options\n  const [isScrolling, setIsScrolling] = useState(false)\n\n  useEffect(() => {\n    // Resolve element or window\n    const element: EventTargetWithScroll =\n      target && typeof Window !== \"undefined\" && target instanceof Window\n        ? target\n        : ((target as RefObject<HTMLElement>)?.current ?? window)\n\n    // Mobile: fallback to document when using window\n    const eventTarget: EventTargetWithScroll =\n      fallbackToDocument &&\n      element === window &&\n      typeof document !== \"undefined\"\n        ? document\n        : element\n\n    const on = (\n      el: EventTargetWithScroll,\n      event: string,\n      handler: EventListener\n    ) => el.addEventListener(event, handler, true)\n\n    const off = (\n      el: EventTargetWithScroll,\n      event: string,\n      handler: EventListener\n    ) => el.removeEventListener(event, handler)\n\n    let timeout: ReturnType<typeof setTimeout>\n    const supportsScrollEnd = element === window && \"onscrollend\" in window\n\n    const handleScroll: EventListener = () => {\n      if (!isScrolling) setIsScrolling(true)\n\n      if (!supportsScrollEnd) {\n        clearTimeout(timeout)\n        timeout = setTimeout(() => setIsScrolling(false), debounce)\n      }\n    }\n\n    const handleScrollEnd: EventListener = () => setIsScrolling(false)\n\n    on(eventTarget, \"scroll\", handleScroll)\n    if (supportsScrollEnd) {\n      on(eventTarget, \"scrollend\", handleScrollEnd)\n    }\n\n    return () => {\n      off(eventTarget, \"scroll\", handleScroll)\n      if (supportsScrollEnd) {\n        off(eventTarget, \"scrollend\", handleScrollEnd)\n      }\n      clearTimeout(timeout)\n    }\n  }, [target, debounce, fallbackToDocument, isScrolling])\n\n  return isScrolling\n}\n"]}

package/dist/docx.d.ts

@@ -0,0 +1,184 @@
+import { Node, Extension, JSONContent } from '@tiptap/core';
+
+declare const DocxField: Node<any, any>;
+
+declare const DocxInk: Node<any, any>;
+
+/**
+ * OOXML → tiptap JSONContent。
+ *
+ * 同构：解压和 XML 解析都由调用方注入，所以浏览器（fflate + 原生 DOMParser）
+ * 和 Node（任意 zip 库 + @xmldom/xmldom）共用这一份实现，不存在两份真相。
+ *
+ * 覆盖范围刻意窄 —— 只做「通用转换器会丢、而我们在意」的那几类：
+ *   · 样式定义里的字符格式（大多数 Word 文档的视觉身份住在这里，不在 run 上）
+ *   · 域（保代码 + 缓存值）
+ *   · 墨迹（保位图回退 + 矢量引用 + 浮动定位）
+ *   · 浮动锚定的几何信息
+ *
+ * 常规内容（段落/标题/列表/表格/图片）本来就有成熟方案，这里做的是最小可用版本。
+ */
+interface DocxEntries {
+    /** 读取 docx 包内某个条目；不存在返回 null */
+    read(entryPath: string): Uint8Array | null;
+}
+interface ParseDocxOptions {
+    /** 浏览器传原生 DOMParser，Node 传 @xmldom/xmldom 的 */
+    DOMParser: {
+        new (): {
+            parseFromString(s: string, t: string): Document;
+        };
+    };
+    /**
+     * 把包内的图片交给宿主落盘/上传，返回可访问的 URL。
+     * 不提供则退化成 data: URI（小文档可以，大文档会撑爆）。
+     */
+    resolveMedia?: (bytes: Uint8Array, entryPath: string) => string;
+    /**
+     * 重命名导入产出的节点类型，对齐官方 `prosemirrorNodes`。
+     * 例：`{ image: 'customImage' }` —— 宿主 schema 里叫别的名字时用。
+     */
+    prosemirrorNodes?: Record<string, string>;
+    /** 重命名产出的标记类型，对齐官方 `prosemirrorMarks` */
+    prosemirrorMarks?: Record<string, string>;
+    /** 抽取文档默认样式为 CSS 字符串，对齐官方 `cssStyles` */
+    cssStyles?: boolean;
+}
+interface ParseDocxResult {
+    doc: Record<string, unknown>;
+    /** 各类恢复项的计数，用于量化「补这一层救回了多少」 */
+    recovered: Record<string, number>;
+    warnings: string[];
+    /** `cssStyles: true` 时给出的文档默认样式 */
+    css?: string;
+}
+declare function parseDocx(entries: DocxEntries, opts: ParseDocxOptions): ParseDocxResult;
+
+/**
+ * tiptap JSONContent → .docx（OOXML）。
+ *
+ * 和 parse.ts 对称：同构、纯函数、不碰 DOM。zip 由调用方注入，
+ * 所以浏览器（fflate）和 Node（任意 zip 库）共用同一份。
+ *
+ * 往返是这里的主要价值：`docxField` 写回真正的 `w:fldSimple`（域代码 + 缓存值），
+ * `docxInk` 写回 `w14:contentPart` + 位图回退 —— 这两样在导入时被保住，
+ * 导出时才有东西可写。
+ */
+interface SerializeOptions {
+    /** 把图片 src 换成字节。返回 null 则该图片跳过并记警告 */
+    resolveImage?: (src: string) => Uint8Array | null;
+    /** 文档级样式覆盖，对齐官方 styleOverrides */
+    styleOverrides?: {
+        defaultFont?: string;
+        defaultSizePt?: number;
+    };
+    /** 逐段落覆盖，对齐官方 paragraphOverrides */
+    paragraphOverrides?: (node: Node_) => Record<string, string> | undefined;
+}
+interface SerializeResult {
+    /** docx 包内的所有条目，交给 zip 打包 */
+    files: Record<string, Uint8Array>;
+    warnings: string[];
+    stats: Record<string, number>;
+}
+type Node_ = Record<string, any>;
+declare function serializeDocx(doc: Node_, opts?: SerializeOptions): SerializeResult;
+
+type ExportType = 'blob' | 'buffer' | 'string';
+interface ExportDocxOptions extends SerializeOptions {
+    onCompleteExport: ((result: Blob | Uint8Array | string) => void) | null;
+    exportType: ExportType;
+    /** 诊断级别，同导入侧 */
+    verbose: number;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        exportDocx: {
+            exportDocx: (options?: Partial<ExportDocxOptions>) => ReturnType;
+        };
+    }
+}
+/** 纯函数：tiptap JSON → .docx 字节。不依赖 editor，服务端 / 测试可直接用。 */
+declare function docxFromJSON(doc: Record<string, unknown>, opts?: SerializeOptions): {
+    bytes: Uint8Array;
+    warnings: string[];
+    stats: Record<string, number>;
+};
+declare const ExportDocx: Extension<ExportDocxOptions, any>;
+/** 便捷方法：导出并触发浏览器下载 */
+declare function downloadDocx(editor: {
+    getJSON: () => unknown;
+}, filename?: string, opts?: SerializeOptions): void;
+
+interface ImageUploadConfig {
+    /** 上传端点 */
+    url: string;
+    headers?: HeadersInit;
+    method?: string;
+    queryParams?: Record<string, string>;
+    /**
+     * 从上传响应里取出可访问 URL。默认依次尝试 `url` / `data.url` / `src`，
+     * 响应是纯文本时直接当 URL 用。
+     */
+    extractUrl?: (response: unknown) => string;
+}
+interface ImportDocxOptions {
+    /** 图片上传配置，对齐官方 `imageUploadConfig` */
+    imageUploadConfig: ImageUploadConfig | null;
+    /**
+     * 函数式逃生舱：直接把字节换成 URL（同步）。
+     * 和 imageUploadConfig 二选一，两者都给时以本项优先。
+     */
+    resolveMedia: ((bytes: Uint8Array, entryPath: string) => string) | null;
+    /** 重命名产出的节点类型，对齐官方 `prosemirrorNodes` */
+    prosemirrorNodes: Record<string, string> | null;
+    /** 重命名产出的标记类型，对齐官方 `prosemirrorMarks` */
+    prosemirrorMarks: Record<string, string> | null;
+    /** 抽取文档默认样式为 CSS，对齐官方 `cssStyles` */
+    cssStyles: boolean;
+    /** 诊断输出级别，对齐官方 `verbose`。0=静默 1=汇总 2=逐条警告 */
+    verbose: number;
+    /**
+     * 保留 ProseMirror schema 本来表达不了的 OOXML 结构（域 / 墨迹 / 浮动定位）。
+     * 这是本扩展相对官方的增量 —— 官方能力矩阵里这几项是 ✕。
+     * 关掉则域降级成纯文本、墨迹降级成普通图片。
+     */
+    preserveUnsupported: boolean;
+    /** 是否注入浮动定位所需样式，默认 true */
+    injectStyles: boolean;
+}
+/** onImport 回调拿到的上下文，字段对齐官方 */
+interface ImportDocxContext {
+    error?: Error;
+    /** 转换出来的 tiptap JSON */
+    content: JSONContent | null;
+    /** 把内容写进编辑器 */
+    setEditorContent: (content?: JSONContent) => void;
+    /** 各类恢复项计数（本扩展独有，用于量化保真度） */
+    recovered: Record<string, number>;
+    warnings: string[];
+    /** cssStyles:true 时的文档默认样式 */
+    css?: string;
+    header: JSONContent | null;
+    footer: JSONContent | null;
+    footnotes: Record<string, JSONContent>;
+    endnotes: Record<string, JSONContent>;
+}
+interface ImportDocxCommandArgs {
+    /** .docx 内容。File / Blob / ArrayBuffer / Uint8Array 都收 */
+    file: File | Blob | ArrayBuffer | Uint8Array;
+    /** 不传则直接替换编辑器内容；传了则由你决定怎么落 */
+    onImport?: (context: ImportDocxContext) => void;
+    /** 对齐官方：false 时不插入占位内容。本地解析是同步的，占位意义不大 */
+    placeholders?: boolean;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        importDocx: {
+            importDocx: (args: ImportDocxCommandArgs) => ReturnType;
+        };
+    }
+}
+declare const ImportDocx: Extension<ImportDocxOptions, any>;
+
+export { type DocxEntries, DocxField, DocxInk, ExportDocx, type ExportDocxOptions, type ExportType, type ImageUploadConfig, ImportDocx, type ImportDocxCommandArgs, type ImportDocxContext, type ImportDocxOptions, type ParseDocxOptions, type ParseDocxResult, type SerializeOptions, type SerializeResult, docxFromJSON, downloadDocx, parseDocx, serializeDocx };