@kedataindo/docflow-core 0.0.71 → 0.0.72

package/dist/collab/index.d.cts

@@ -0,0 +1,71 @@
+import { Awareness } from 'y-protocols/awareness';
+import { WebsocketProvider } from 'y-websocket';
+import * as Y from 'yjs';
+export { A as AwarenessState, C as CollaborationOptions, a as CollaborationSetup, c as collaborationExtensions, b as createCollaboration } from '../Collaboration-CGv9OZlB.cjs';
+import '@tiptap/core';
+import 'y-indexeddb';
+import 'y-webrtc';
+
+interface SubdocState {
+    id: string;
+    doc: Y.Doc;
+    provider: WebsocketProvider | null;
+    active: boolean;
+}
+interface SubdocumentProviderOptions {
+    /** WebSocket URL for the collaboration server. */
+    websocketUrl: string;
+    /** Room prefix — subdocuments use `${roomPrefix}/${id}` as room name. */
+    roomPrefix: string;
+    /** User info for awareness. */
+    user: {
+        name: string;
+        color: string;
+    };
+    /** Number of subdocuments to keep active (buffer around visible viewport). */
+    maxActive?: number;
+    /** Called when subdocument state changes (active/deactivated). */
+    onStateChange?: (states: SubdocState[]) => void;
+}
+/**
+ * Manages multiple Y.Doc subdocuments under a parent document.
+ *
+ * Use case: large documents (100+ pages) split into per-section subdocuments.
+ * Only active (visible) subdocuments are connected to the network via
+ * WebSocketProvider; inactive ones keep local state but stop syncing.
+ *
+ * Usage:
+ *   const provider = new SubdocumentProvider({ websocketUrl, roomPrefix, user })
+ *   provider.createSubdoc('section-1')
+ *   provider.activate('section-1')     // starts syncing
+ *   provider.deactivate('section-1')   // stops syncing
+ *   const frag = provider.getFragment('section-1') // Y.XmlFragment for editor
+ */
+declare class SubdocumentProvider {
+    readonly parentDoc: Y.Doc;
+    readonly subdocs: Y.Map<Y.Doc>;
+    readonly awareness: Awareness;
+    private readonly options;
+    private readonly states;
+    private readonly activeQueue;
+    private readonly parentProvider;
+    constructor(options: SubdocumentProviderOptions);
+    /** Create a new subdocument. Does NOT activate it. */
+    createSubdoc(id: string, initialState?: Uint8Array): Y.Doc;
+    /** Activate a subdocument — connects it to the network for live sync. */
+    activate(id: string): void;
+    /** Deactivate a subdocument — disconnects it from the network. */
+    deactivate(id: string): void;
+    /** Get the Y.XmlFragment for a subdocument. */
+    getFragment(id: string): Y.XmlFragment | null;
+    /** Check if a subdocument is currently active (syncing). */
+    isActive(id: string): boolean;
+    /** Get all subdocument states. */
+    getAllStates(): SubdocState[];
+    /** Get IDs of all active subdocuments. */
+    getActiveIds(): string[];
+    /** Destroy all subdocuments and providers. */
+    destroy(): void;
+}
+
+export { type SubdocState, SubdocumentProvider, type SubdocumentProviderOptions };

package/dist/collab/index.d.ts

@@ -0,0 +1,71 @@
+import { Awareness } from 'y-protocols/awareness';
+import { WebsocketProvider } from 'y-websocket';
+import * as Y from 'yjs';
+export { A as AwarenessState, C as CollaborationOptions, a as CollaborationSetup, c as collaborationExtensions, b as createCollaboration } from '../Collaboration-CGv9OZlB.js';
+import '@tiptap/core';
+import 'y-indexeddb';
+import 'y-webrtc';
+
+interface SubdocState {
+    id: string;
+    doc: Y.Doc;
+    provider: WebsocketProvider | null;
+    active: boolean;
+}
+interface SubdocumentProviderOptions {
+    /** WebSocket URL for the collaboration server. */
+    websocketUrl: string;
+    /** Room prefix — subdocuments use `${roomPrefix}/${id}` as room name. */
+    roomPrefix: string;
+    /** User info for awareness. */
+    user: {
+        name: string;
+        color: string;
+    };
+    /** Number of subdocuments to keep active (buffer around visible viewport). */
+    maxActive?: number;
+    /** Called when subdocument state changes (active/deactivated). */
+    onStateChange?: (states: SubdocState[]) => void;
+}
+/**
+ * Manages multiple Y.Doc subdocuments under a parent document.
+ *
+ * Use case: large documents (100+ pages) split into per-section subdocuments.
+ * Only active (visible) subdocuments are connected to the network via
+ * WebSocketProvider; inactive ones keep local state but stop syncing.
+ *
+ * Usage:
+ *   const provider = new SubdocumentProvider({ websocketUrl, roomPrefix, user })
+ *   provider.createSubdoc('section-1')
+ *   provider.activate('section-1')     // starts syncing
+ *   provider.deactivate('section-1')   // stops syncing
+ *   const frag = provider.getFragment('section-1') // Y.XmlFragment for editor
+ */
+declare class SubdocumentProvider {
+    readonly parentDoc: Y.Doc;
+    readonly subdocs: Y.Map<Y.Doc>;
+    readonly awareness: Awareness;
+    private readonly options;
+    private readonly states;
+    private readonly activeQueue;
+    private readonly parentProvider;
+    constructor(options: SubdocumentProviderOptions);
+    /** Create a new subdocument. Does NOT activate it. */
+    createSubdoc(id: string, initialState?: Uint8Array): Y.Doc;
+    /** Activate a subdocument — connects it to the network for live sync. */
+    activate(id: string): void;
+    /** Deactivate a subdocument — disconnects it from the network. */
+    deactivate(id: string): void;
+    /** Get the Y.XmlFragment for a subdocument. */
+    getFragment(id: string): Y.XmlFragment | null;
+    /** Check if a subdocument is currently active (syncing). */
+    isActive(id: string): boolean;
+    /** Get all subdocument states. */
+    getAllStates(): SubdocState[];
+    /** Get IDs of all active subdocuments. */
+    getActiveIds(): string[];
+    /** Destroy all subdocuments and providers. */
+    destroy(): void;
+}
+
+export { type SubdocState, SubdocumentProvider, type SubdocumentProviderOptions };

package/dist/collab/index.js

@@ -0,0 +1,116 @@
+import {
+  collaborationExtensions,
+  createCollaboration
+} from "../chunk-XJG72F7M.js";
+
+// src/SubdocumentProvider.ts
+import { Awareness as AwarenessClass } from "y-protocols/awareness";
+import { WebsocketProvider } from "y-websocket";
+import * as Y 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 Y.Doc();
+    this.subdocs = this.parentDoc.getMap("subdocs");
+    this.awareness = new AwarenessClass(this.parentDoc);
+    this.awareness.setLocalStateField("user", this.options.user);
+    this.parentProvider = new WebsocketProvider(
+      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 Y.Doc();
+    if (initialState) Y.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 WebsocketProvider(
+      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 {
+  SubdocumentProvider,
+  collaborationExtensions,
+  createCollaboration
+};

package/dist/index.cjs

@@ -39,7 +39,6 @@ __export(index_exports, {
   PaginationPlus: () => PaginationPlus,
   PerformanceMonitor: () => PerformanceMonitor,
   SearchAndReplaceExtension: () => SearchAndReplaceExtension,
-  SubdocumentProvider: () => SubdocumentProvider,
   buildAIPrompt: () => buildAIPrompt,
   clearSearch: () => clearSearch,
   collaborationExtensions: () => collaborationExtensions,
@@ -128,9 +127,6 @@ function createActionMap(editor, plugins) {
 var import_extension_collaboration = require("@tiptap/extension-collaboration");
 var import_extension_collaboration_cursor = require("@tiptap/extension-collaboration-cursor");
 var import_awareness = require("y-protocols/awareness");
-var import_y_indexeddb = require("y-indexeddb");
-var import_y_webrtc = require("y-webrtc");
-var import_y_websocket = require("y-websocket");
 var Y = __toESM(require("yjs"), 1);
 var LOCAL_SIGNALING = ["ws://localhost:4444"];
 var warnedLocalSignaling = false;
@@ -161,25 +157,28 @@ function createAwarenessStates(awareness) {
   });
   return states;
 }
-function createCollaboration(options) {
+async function createCollaboration(options) {
   const ydoc = new Y.Doc();
   if (options.initialStorageState) {
     Y.applyUpdate(ydoc, options.initialStorageState);
   }
   let persistence;
   if (options.offline) {
-    persistence = new import_y_indexeddb.IndexeddbPersistence(`docflow-${options.room}`, ydoc);
+    const { IndexeddbPersistence } = await import("y-indexeddb");
+    persistence = new IndexeddbPersistence(`docflow-${options.room}`, ydoc);
   }
   let provider = null;
   if (options.provider === "webrtc") {
-    provider = new import_y_webrtc.WebrtcProvider(options.room, ydoc, {
+    const { WebrtcProvider } = await import("y-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 import_y_websocket.WebsocketProvider(options.websocketUrl, options.room, ydoc);
+    const { WebsocketProvider } = await import("y-websocket");
+    provider = new WebsocketProvider(options.websocketUrl, options.room, ydoc);
   }
   const awareness = provider?.awareness ?? new import_awareness.Awareness(ydoc);
   awareness.setLocalStateField("user", options.user);
@@ -245,8 +244,7 @@ function createCollaboration(options) {
   };
   return { ydoc, provider, awareness, persistence, whenReady, destroy, setLocalCursorEnabled };
 }
-function collaborationExtensions(options) {
-  const setup = "ydoc" in options ? options : createCollaboration(options);
+function collaborationExtensions(setup) {
   const extensions = [
     import_extension_collaboration.Collaboration.configure({ document: setup.ydoc })
   ];
@@ -322,6 +320,42 @@ var BlockAttributesExtension = import_core.Extension.create({
   }
 });
 
+// src/collab/seedEmptyFragment.ts
+var Y2 = __toESM(require("yjs"), 1);
+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 Y2.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
 var import_core2 = require("@tiptap/core");
 var EditorContextExtension = import_core2.Extension.create({
@@ -1639,7 +1673,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);
@@ -2040,9 +2074,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(
+        import_core5.Extension.create({
+          name: "provisionalSeedCleanup",
+          onDestroy: () => seed.dispose()
+        })
+      );
+    }
     extensions = [...extensions, ...collaborationExtensions(collaborationSetup)];
   }
-  return new import_core5.Editor({
+  const tiptapEditor = new import_core5.Editor({
     element: options.target,
     content,
     extensions,
@@ -2057,6 +2100,7 @@ function createTiptapEditor(options, plugins, collaborationSetup) {
       transformPastedHTML: sanitizePastedHTML
     }
   });
+  return tiptapEditor;
 }
 
 // src/FontSize.ts
@@ -2169,113 +2213,6 @@ var FontSizeExtension = import_core6.Extension.create({
   }
 });
 
-// src/SubdocumentProvider.ts
-var import_awareness2 = require("y-protocols/awareness");
-var import_y_websocket2 = require("y-websocket");
-var Y2 = __toESM(require("yjs"), 1);
-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 import_awareness2.Awareness(this.parentDoc);
-    this.awareness.setLocalStateField("user", this.options.user);
-    this.parentProvider = new import_y_websocket2.WebsocketProvider(
-      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 import_y_websocket2.WebsocketProvider(
-      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;
-  }
-};
-
 // src/ai/prompts.ts
 var CONTEXT_CHAR_CAP = 1500;
 var ONLY_RESULT = "Return ONLY the resulting text \u2014 no preamble, no explanation, no commentary, no markdown fences.";
@@ -2549,7 +2486,6 @@ function openaiCompatibleProvider(config) {
   PaginationPlus,
   PerformanceMonitor,
   SearchAndReplaceExtension,
-  SubdocumentProvider,
   buildAIPrompt,
   clearSearch,
   collaborationExtensions,