@kedataindo/docflow-core 0.0.71 → 0.0.73

package/dist/index.js

@@ -10,10 +10,14 @@ import {
   trimContextAfter,
   trimContextBefore
 } from "./chunk-HMOWKFPE.js";
+import {
+  collaborationExtensions,
+  createCollaboration
+} from "./chunk-XJG72F7M.js";
 
 // src/Editor.ts
-import { Extension as Extension5, Editor as TiptapEditor } from "@tiptap/core";
-import { Plugin as Plugin4, PluginKey as PluginKey4 } from "@tiptap/pm/state";
+import { Extension as Extension6, Editor as TiptapEditor } from "@tiptap/core";
+import { Plugin as Plugin5, PluginKey as PluginKey5 } from "@tiptap/pm/state";
 import StarterKit from "@tiptap/starter-kit";
 import TextStyle from "@tiptap/extension-text-style";
 
@@ -64,143 +68,6 @@ function createActionMap(editor, plugins) {
   return map;
 }
 
-// src/Collaboration.ts
-import { Collaboration } from "@tiptap/extension-collaboration";
-import { CollaborationCursor } from "@tiptap/extension-collaboration-cursor";
-import { Awareness } from "y-protocols/awareness";
-import { IndexeddbPersistence } from "y-indexeddb";
-import { WebrtcProvider } from "y-webrtc";
-import { WebsocketProvider } from "y-websocket";
-import * as Y from "yjs";
-var LOCAL_SIGNALING = ["ws://localhost:4444"];
-var warnedLocalSignaling = false;
-function resolveSignalingUrls(signaling) {
-  if (signaling && signaling.length > 0) return signaling;
-  if (!warnedLocalSignaling) {
-    warnedLocalSignaling = true;
-    console.warn(
-      '[docflow] webrtc provider has no `signaling` configured \u2014 falling back to localhost-only sync (ws://localhost:4444 + same-browser tabs). For production self-host, run your own signaling server and pass `signaling`, or use `provider: "websocket"` with your own websocketUrl.'
-    );
-  }
-  return LOCAL_SIGNALING;
-}
-var LOCAL_PRESENT_DEFAULT = true;
-function createAwarenessStates(awareness) {
-  const states = [];
-  awareness.getStates().forEach((state, clientId) => {
-    const raw = state;
-    states.push({
-      clientId,
-      user: raw.user ?? { name: "", color: "" },
-      cursor: raw.cursor ?? null,
-      // `present` defaults to true for backwards compat (legacy states
-      // don't set it) and for the local user (always considered present
-      // until PR2 toggles it off).
-      present: raw.present ?? LOCAL_PRESENT_DEFAULT
-    });
-  });
-  return states;
-}
-function createCollaboration(options) {
-  const ydoc = new Y.Doc();
-  if (options.initialStorageState) {
-    Y.applyUpdate(ydoc, options.initialStorageState);
-  }
-  let persistence;
-  if (options.offline) {
-    persistence = new IndexeddbPersistence(`docflow-${options.room}`, ydoc);
-  }
-  let provider = null;
-  if (options.provider === "webrtc") {
-    provider = new WebrtcProvider(options.room, ydoc, {
-      signaling: resolveSignalingUrls(options.signaling)
-    });
-  } else if (options.provider === "websocket") {
-    if (!options.websocketUrl) {
-      throw new Error('[Collaboration] websocketUrl is required when provider is "websocket"');
-    }
-    provider = new WebsocketProvider(options.websocketUrl, options.room, ydoc);
-  }
-  const awareness = provider?.awareness ?? new Awareness(ydoc);
-  awareness.setLocalStateField("user", options.user);
-  let emitCursor = options.emitCursor ?? true;
-  const setLocalCursorEnabled = (enabled) => {
-    if (emitCursor === enabled) return;
-    emitCursor = enabled;
-    if (!enabled) {
-      awareness.setLocalStateField("cursor", null);
-    }
-    awareness.setLocalStateField("emitCursor", enabled);
-  };
-  awareness.setLocalStateField("present", true);
-  awareness.setLocalStateField("emitCursor", emitCursor);
-  let awarenessHandler;
-  if (options.onAwarenessChange) {
-    const notify = () => {
-      options.onAwarenessChange?.(createAwarenessStates(awareness));
-    };
-    awarenessHandler = notify;
-    awareness.on("change", notify);
-    notify();
-  }
-  const readyParts = [];
-  if (persistence) {
-    readyParts.push(
-      persistence.whenSynced.then(
-        () => void 0,
-        () => void 0
-      )
-    );
-  }
-  if (provider && options.provider === "websocket") {
-    const ws = provider;
-    readyParts.push(
-      new Promise((resolve) => {
-        let settled = false;
-        const done = () => {
-          if (settled) return;
-          settled = true;
-          resolve();
-        };
-        if (ws.synced) {
-          done();
-          return;
-        }
-        ws.once("sync", done);
-        ws.once("synced", done);
-        setTimeout(done, 5e3);
-      })
-    );
-  }
-  const whenReady = readyParts.length === 0 ? Promise.resolve() : Promise.all(readyParts).then(() => void 0);
-  const destroy = () => {
-    if (awarenessHandler) {
-      awareness.off("change", awarenessHandler);
-    }
-    awareness.setLocalState(null);
-    provider?.destroy?.();
-    awareness.destroy?.();
-    void persistence?.destroy();
-    ydoc.destroy();
-  };
-  return { ydoc, provider, awareness, persistence, whenReady, destroy, setLocalCursorEnabled };
-}
-function collaborationExtensions(options) {
-  const setup = "ydoc" in options ? options : createCollaboration(options);
-  const extensions = [
-    Collaboration.configure({ document: setup.ydoc })
-  ];
-  if (setup.provider) {
-    extensions.push(
-      CollaborationCursor.configure({
-        provider: setup.provider,
-        user: setup.awareness.getLocalState()?.user ?? { name: "", color: "" }
-      })
-    );
-  }
-  return extensions;
-}
-
 // src/BlockAttributes.ts
 import { Extension } from "@tiptap/core";
 import { Plugin, PluginKey } from "@tiptap/pm/state";
@@ -262,6 +129,42 @@ var BlockAttributesExtension = Extension.create({
   }
 });
 
+// src/collab/seedEmptyFragment.ts
+import * as Y from "yjs";
+var PROVISIONAL_SEED_ORIGIN = "docflow:provisional-seed";
+function isPristineEmptyParagraph(element) {
+  return element.length === 0 && Object.keys(element.getAttributes()).length === 0;
+}
+function seedEmptyFragment(doc, field = "default") {
+  const fragment = doc.getXmlFragment(field);
+  const paragraph = new Y.XmlElement("paragraph");
+  const observer = (_events, transaction) => {
+    if (transaction.origin === PROVISIONAL_SEED_ORIGIN) return;
+    if (paragraph.parent !== fragment) return;
+    if (!isPristineEmptyParagraph(paragraph)) return;
+    if (fragment.length < 2) return;
+    const index = fragment.toArray().indexOf(paragraph);
+    if (index === -1) return;
+    doc.transact(() => {
+      fragment.delete(index);
+    }, PROVISIONAL_SEED_ORIGIN);
+  };
+  let disposed = false;
+  const dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    fragment.unobserveDeep(observer);
+  };
+  if (fragment.length > 0) {
+    return { seeded: false, dispose };
+  }
+  fragment.observeDeep(observer);
+  doc.transact(() => {
+    fragment.insert(0, [paragraph]);
+  }, PROVISIONAL_SEED_ORIGIN);
+  return { seeded: true, dispose };
+}
+
 // src/EditorContext.ts
 import { Extension as Extension2 } from "@tiptap/core";
 var EditorContextExtension = Extension2.create({
@@ -1212,6 +1115,94 @@ var PaginationPlus = Extension4.create({
   }
 });
 
+// src/pagination/PaginationCaretFix.ts
+import { Extension as Extension5 } from "@tiptap/core";
+import { Plugin as Plugin4, PluginKey as PluginKey4, TextSelection as TextSelection2 } from "@tiptap/pm/state";
+var PAGINATION_CLASS = "rm-with-pagination";
+var PAGINATION_DISABLED_ATTR = "rm-pagination-disabled";
+var dragStates = /* @__PURE__ */ new WeakMap();
+var isPaginationActive = (view) => {
+  const dom = view.dom;
+  return dom.classList.contains(PAGINATION_CLASS) && dom.getAttribute(PAGINATION_DISABLED_ATTR) === null;
+};
+var isEditable = (view) => view.dom.getAttribute("contenteditable") !== "false";
+var isPlainSingleLeftClick = (event) => event.button === 0 && event.detail === 1 && !event.shiftKey && !event.altKey && !event.ctrlKey && !event.metaKey;
+function posFromTextOffset(view, textNode, offset) {
+  if (textNode.nodeType !== Node.TEXT_NODE || !view.dom.contains(textNode)) return null;
+  const text = textNode;
+  const clamped = Math.min(Math.max(0, offset), text.length);
+  const parent = text.parentElement;
+  if (parent?.closest?.('[contenteditable="false"]')) return null;
+  let pos = view.posAtDOM(text, clamped, -1);
+  if (pos < 0) pos = view.posAtDOM(text, clamped, 1);
+  if (pos < 0) return null;
+  return view.state.doc.resolve(pos).parent.isTextblock ? pos : null;
+}
+function resolvePosFromNativePoint(view, clientX, clientY) {
+  const doc = view.dom.ownerDocument;
+  if (typeof doc.caretRangeFromPoint !== "function") return null;
+  const range = doc.caretRangeFromPoint(clientX, clientY);
+  if (!range) return null;
+  return posFromTextOffset(view, range.startContainer, range.startOffset);
+}
+function stopDrag(view) {
+  const drag = dragStates.get(view);
+  if (!drag) return;
+  dragStates.delete(view);
+  const doc = view.dom.ownerDocument;
+  doc.removeEventListener("mousemove", drag.onMouseMove);
+  doc.removeEventListener("mouseup", drag.onMouseUp);
+}
+function beginDrag(view, anchorPos) {
+  stopDrag(view);
+  const doc = view.dom.ownerDocument;
+  const onMouseMove = (event) => {
+    const drag = dragStates.get(view);
+    if (!drag) return;
+    const pos = resolvePosFromNativePoint(view, event.clientX, event.clientY);
+    if (pos === null) return;
+    const from = Math.min(drag.anchorPos, pos);
+    const to = Math.max(drag.anchorPos, pos);
+    view.dispatch(view.state.tr.setSelection(TextSelection2.create(view.state.doc, from, to)));
+  };
+  const onMouseUp = () => {
+    stopDrag(view);
+  };
+  dragStates.set(view, { anchorPos, onMouseMove, onMouseUp });
+  doc.addEventListener("mousemove", onMouseMove);
+  doc.addEventListener("mouseup", onMouseUp);
+}
+function interceptPaginationMouseDown(view, event) {
+  if (!isPaginationActive(view) || !isPlainSingleLeftClick(event) || !isEditable(view)) return false;
+  const pos = resolvePosFromNativePoint(view, event.clientX, event.clientY);
+  if (pos === null) return false;
+  view.focus();
+  view.dispatch(view.state.tr.setSelection(TextSelection2.create(view.state.doc, pos)));
+  beginDrag(view, pos);
+  return true;
+}
+var PaginationCaretFix = Extension5.create({
+  name: "paginationCaretFix",
+  addProseMirrorPlugins() {
+    return [
+      new Plugin4({
+        key: new PluginKey4("paginationCaretFix"),
+        props: {
+          handleDOMEvents: {
+            mousedown: (view, event) => {
+              try {
+                return interceptPaginationMouseDown(view, event);
+              } catch {
+                return false;
+              }
+            }
+          }
+        }
+      })
+    ];
+  }
+});
+
 // src/PerformanceMonitor.ts
 var TARGET_FRAME_MS = 1e3 / 60;
 var formatMb = (bytes) => `${Math.round(bytes / 1024 / 1024)}MB`;
@@ -1579,7 +1570,7 @@ function createEditor(options = {}) {
     content: options.content ? migrateContent(options.content) : options.content
   };
   const plugins = migratedOptions.plugins ?? [];
-  const collaborationSetup = !migratedOptions.collaboration ? void 0 : "ydoc" in migratedOptions.collaboration ? migratedOptions.collaboration : createCollaboration(migratedOptions.collaboration);
+  const collaborationSetup = migratedOptions.collaboration;
   const performanceMonitor = migratedOptions.debug ? createPerformanceMonitor() : void 0;
   let tiptapEditor = createTiptapEditor(migratedOptions, plugins, collaborationSetup);
   let pluginActions = createActionMap(tiptapEditor, plugins);
@@ -1640,11 +1631,11 @@ function createTiptapEditor(options, plugins, collaborationSetup) {
   const pluginExtensions = collectExtensions(plugins);
   const blockAttrs = options.getPageMap ? BlockAttributesExtension.configure({ pageMap: options.getPageMap }) : BlockAttributesExtension;
   const paginationExt = options.paginationOptions ? PaginationPlus.configure(options.paginationOptions) : PaginationPlus;
-  const ManualColumnResize = Extension5.create({
+  const ManualColumnResize = Extension6.create({
     name: "manualColumnResize",
     addProseMirrorPlugins() {
-      const key2 = new PluginKey4("manualColumnResize");
-      return [new Plugin4({
+      const key2 = new PluginKey5("manualColumnResize");
+      return [new Plugin5({
         key: key2,
         view(view) {
           function pauseObserver() {
@@ -1966,6 +1957,10 @@ function createTiptapEditor(options, plugins, collaborationSetup) {
     TextStyle,
     blockAttrs,
     paginationExt,
+    // Always present — fixes caret-on-click misplacement caused by the
+    // pagination DOM (header/footer/gap widgets breaking linear coordinates).
+    // No-op (gated at runtime) when pagination is off or disabled.
+    PaginationCaretFix,
     // Always present — carries host-injected ports (onImageUpload, citation, …)
     // in storage so plugin commands can reach them through the editor instance.
     EditorContextExtension.configure({
@@ -1980,9 +1975,18 @@ function createTiptapEditor(options, plugins, collaborationSetup) {
   ];
   const content = options.collaboration ? void 0 : options.content;
   if (options.collaboration && collaborationSetup) {
+    const seed = seedEmptyFragment(collaborationSetup.ydoc);
+    if (seed.seeded) {
+      extensions.push(
+        Extension6.create({
+          name: "provisionalSeedCleanup",
+          onDestroy: () => seed.dispose()
+        })
+      );
+    }
     extensions = [...extensions, ...collaborationExtensions(collaborationSetup)];
   }
-  return new TiptapEditor({
+  const tiptapEditor = new TiptapEditor({
     element: options.target,
     content,
     extensions,
@@ -1997,10 +2001,11 @@ function createTiptapEditor(options, plugins, collaborationSetup) {
       transformPastedHTML: sanitizePastedHTML
     }
   });
+  return tiptapEditor;
 }
 
 // src/FontSize.ts
-import { Extension as Extension6 } from "@tiptap/core";
+import { Extension as Extension7 } from "@tiptap/core";
 function mergeFontSize(textStyleType, existing, fontSize) {
   if (fontSize === null) {
     const { fontSize: _removed, ...rest } = existing?.attrs ?? {};
@@ -2011,7 +2016,7 @@ function mergeFontSize(textStyleType, existing, fontSize) {
 function hasAttrs(mark) {
   return Object.values(mark.attrs).some((v) => v != null);
 }
-var FontSizeExtension = Extension6.create({
+var FontSizeExtension = Extension7.create({
   name: "fontSize",
   addGlobalAttributes() {
     return [
@@ -2108,113 +2113,6 @@ var FontSizeExtension = Extension6.create({
     };
   }
 });
-
-// src/SubdocumentProvider.ts
-import { Awareness as AwarenessClass } from "y-protocols/awareness";
-import { WebsocketProvider as WebsocketProvider2 } from "y-websocket";
-import * as Y2 from "yjs";
-var SubdocumentProvider = class {
-  parentDoc;
-  subdocs;
-  awareness;
-  options;
-  states = /* @__PURE__ */ new Map();
-  activeQueue = [];
-  parentProvider = null;
-  constructor(options) {
-    this.options = {
-      maxActive: options.maxActive ?? 5,
-      onStateChange: options.onStateChange ?? (() => {
-      }),
-      ...options
-    };
-    this.parentDoc = new Y2.Doc();
-    this.subdocs = this.parentDoc.getMap("subdocs");
-    this.awareness = new AwarenessClass(this.parentDoc);
-    this.awareness.setLocalStateField("user", this.options.user);
-    this.parentProvider = new WebsocketProvider2(
-      this.options.websocketUrl,
-      `${this.options.roomPrefix}/_parent`,
-      this.parentDoc
-    );
-  }
-  /** Create a new subdocument. Does NOT activate it. */
-  createSubdoc(id, initialState) {
-    if (this.states.has(id)) return this.states.get(id).doc;
-    const doc = new Y2.Doc();
-    if (initialState) Y2.applyUpdate(doc, initialState);
-    doc.getXmlFragment("default");
-    this.subdocs.set(id, doc);
-    this.states.set(id, {
-      id,
-      doc,
-      provider: null,
-      active: false
-    });
-    this.options.onStateChange(this.getAllStates());
-    return doc;
-  }
-  /** Activate a subdocument — connects it to the network for live sync. */
-  activate(id) {
-    const state = this.states.get(id);
-    if (!state || state.active) return;
-    if (this.activeQueue.length >= this.options.maxActive) {
-      const oldest = this.activeQueue.shift();
-      if (oldest) this.deactivate(oldest);
-    }
-    const doc = state.doc;
-    const roomName = `${this.options.roomPrefix}/${id}`;
-    const provider = new WebsocketProvider2(
-      this.options.websocketUrl,
-      roomName,
-      doc
-    );
-    provider.awareness.setLocalStateField("user", this.options.user);
-    state.provider = provider;
-    state.active = true;
-    this.activeQueue.push(id);
-    this.options.onStateChange(this.getAllStates());
-  }
-  /** Deactivate a subdocument — disconnects it from the network. */
-  deactivate(id) {
-    const state = this.states.get(id);
-    if (!state || !state.active) return;
-    state.provider?.destroy();
-    state.provider = null;
-    state.active = false;
-    const idx = this.activeQueue.indexOf(id);
-    if (idx >= 0) this.activeQueue.splice(idx, 1);
-    this.options.onStateChange(this.getAllStates());
-  }
-  /** Get the Y.XmlFragment for a subdocument. */
-  getFragment(id) {
-    const doc = this.states.get(id)?.doc ?? this.subdocs.get(id);
-    if (!doc) return null;
-    return doc.getXmlFragment("default");
-  }
-  /** Check if a subdocument is currently active (syncing). */
-  isActive(id) {
-    return this.states.get(id)?.active ?? false;
-  }
-  /** Get all subdocument states. */
-  getAllStates() {
-    return Array.from(this.states.values());
-  }
-  /** Get IDs of all active subdocuments. */
-  getActiveIds() {
-    return [...this.activeQueue];
-  }
-  /** Destroy all subdocuments and providers. */
-  destroy() {
-    for (const [id] of this.states) {
-      this.deactivate(id);
-    }
-    this.parentProvider?.destroy();
-    this.parentDoc.destroy();
-    this.states.clear();
-    this.activeQueue.length = 0;
-  }
-};
 export {
   BlockAttributesExtension,
   CONTEXT_CHAR_CAP,
@@ -2225,7 +2123,6 @@ export {
   PaginationPlus,
   PerformanceMonitor,
   SearchAndReplaceExtension,
-  SubdocumentProvider,
   buildAIPrompt,
   clearSearch,
   collaborationExtensions,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kedataindo/docflow-core",
   "license": "UNLICENSED",
-  "version": "0.0.71",
+  "version": "0.0.73",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -16,6 +16,11 @@
       "types": "./dist/ai/index.d.ts",
       "import": "./dist/ai/index.js",
       "require": "./dist/ai/index.cjs"
+    },
+    "./collab": {
+      "types": "./dist/collab/index.d.ts",
+      "import": "./dist/collab/index.js",
+      "require": "./dist/collab/index.cjs"
     }
   },
   "publishConfig": {