@kedataindo/docflow-plugins 0.0.77 → 0.0.79

package/dist/index.cjs

@@ -2074,8 +2074,8 @@ var BibliographyNode = import_core6.Node.create({
       dom.setAttribute("data-node-type", "bibliography");
       let attrs = props.node?.attrs ?? {};
       const render = () => {
-        const engine2 = getEngine(editor);
-        const items = engine2?.getBibliography() ?? [];
+        const engine = getEngine(editor);
+        const items = engine?.getBibliography() ?? [];
         const showHeading = !isHeadingHidden(attrs.showHeading);
         const headingText = headingLabel(attrs.headingText);
         dom.innerHTML = "";
@@ -2104,8 +2104,19 @@ var BibliographyNode = import_core6.Node.create({
         dom.appendChild(list);
       };
       render();
-      const engine = getEngine(editor);
-      const unsubscribe = engine?.onChange(render);
+      let unsubscribe = null;
+      let bound = null;
+      const syncEngine = () => {
+        const engine = getEngine(editor);
+        if (engine === bound) return;
+        unsubscribe?.();
+        bound = engine;
+        unsubscribe = engine ? engine.onChange(render) : null;
+        render();
+      };
+      syncEngine();
+      editor.on("create", syncEngine);
+      editor.on("citationEngineReady", syncEngine);
       return {
         dom,
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -2118,6 +2129,8 @@ var BibliographyNode = import_core6.Node.create({
           return true;
         },
         destroy() {
+          editor.off("create", syncEngine);
+          editor.off("citationEngineReady", syncEngine);
           unsubscribe?.();
         }
       };
@@ -2158,83 +2171,91 @@ var CitationEngineExtension = import_core7.Extension.create({
    * recomputes only when the ordered signature changed, so plain typing
    * costs one cheap walk and no citeproc work.
    */
+  /**
+   * Keep the engine's cluster registry in sync with the document — see
+   * `syncCitationClusters`. The engine recomputes only when the ordered
+   * signature changed, so plain typing costs one cheap walk and no citeproc
+   * work.
+   */
   onUpdate() {
-    const editor = this.editor;
-    const engine = getCitationEngine(editor);
-    if (!engine) return;
-    {
-      const seen = /* @__PURE__ */ new Set();
-      const repairs = [];
-      editor.state.doc.descendants((node, pos) => {
-        if (node.type.name === "citation" || node.type.name === "footnote" && node.attrs.sourceId) {
-          const id = node.attrs.citationId;
-          if (id) {
-            if (seen.has(id)) {
-              repairs.push({ pos, attrs: { ...node.attrs } });
-            } else {
-              seen.add(id);
-            }
-          }
-        }
-        return true;
-      });
-      if (repairs.length > 0) {
-        const tr = editor.state.tr;
-        for (const { pos, attrs } of repairs) {
-          tr.setNodeMarkup(pos, void 0, { ...attrs, citationId: nextCitationId() });
-        }
-        editor.view.dispatch(tr);
-        return;
-      }
-    }
-    const ordered = [];
+    syncCitationClusters(this.editor);
+  }
+});
+function syncCitationClusters(editor) {
+  const engine = getCitationEngine(editor);
+  if (!engine) return;
+  {
+    const seen = /* @__PURE__ */ new Set();
+    const repairs = [];
     editor.state.doc.descendants((node, pos) => {
       if (node.type.name === "citation" || node.type.name === "footnote" && node.attrs.sourceId) {
-        ordered.push({
-          citationId: node.attrs.citationId ?? `anon-${pos}`,
-          attrs: {
-            sourceId: node.attrs.sourceId ?? null,
-            locator: node.attrs.locator || "",
-            label: node.attrs.label || "page",
-            mode: node.attrs.mode || "normal",
-            prefix: node.attrs.prefix || "",
-            suffix: node.attrs.suffix || ""
+        const id = node.attrs.citationId;
+        if (id) {
+          if (seen.has(id)) {
+            repairs.push({ pos, attrs: { ...node.attrs } });
+          } else {
+            seen.add(id);
           }
-        });
+        }
       }
       return true;
     });
-    const changed = engine.syncCitations(ordered);
-    if (changed) {
-      const port = editor.storage.editorContext;
-      port?.citation?.onSourcesChange?.(engine.getCitedSourceIds());
+    if (repairs.length > 0) {
+      const tr = editor.state.tr;
+      for (const { pos, attrs } of repairs) {
+        tr.setNodeMarkup(pos, void 0, { ...attrs, citationId: nextCitationId() });
+      }
+      editor.view.dispatch(tr);
+      return;
     }
-    {
-      const updates = [];
-      editor.state.doc.descendants((node, pos) => {
-        if (node.type.name === "footnote" && node.attrs.sourceId) {
-          const id = node.attrs.citationId;
-          if (!id) return true;
-          const text = engine.renderCluster(id);
-          if (text && text !== node.attrs.content) {
-            updates.push({ pos, content: text });
-          }
+  }
+  const ordered = [];
+  editor.state.doc.descendants((node, pos) => {
+    if (node.type.name === "citation" || node.type.name === "footnote" && node.attrs.sourceId) {
+      ordered.push({
+        citationId: node.attrs.citationId ?? `anon-${pos}`,
+        attrs: {
+          sourceId: node.attrs.sourceId ?? null,
+          locator: node.attrs.locator || "",
+          label: node.attrs.label || "page",
+          mode: node.attrs.mode || "normal",
+          prefix: node.attrs.prefix || "",
+          suffix: node.attrs.suffix || ""
         }
-        return true;
       });
-      if (updates.length > 0) {
-        const tr = editor.state.tr;
-        for (const { pos, content } of updates) {
-          const node = editor.state.doc.nodeAt(pos);
-          if (node) {
-            tr.setNodeMarkup(pos, void 0, { ...node.attrs, content });
-          }
+    }
+    return true;
+  });
+  const changed = engine.syncCitations(ordered);
+  if (changed) {
+    const port = editor.storage.editorContext;
+    port?.citation?.onSourcesChange?.(engine.getCitedSourceIds());
+  }
+  {
+    const updates = [];
+    editor.state.doc.descendants((node, pos) => {
+      if (node.type.name === "footnote" && node.attrs.sourceId) {
+        const id = node.attrs.citationId;
+        if (!id) return true;
+        const text = engine.renderCluster(id);
+        if (text && text !== node.attrs.content) {
+          updates.push({ pos, content: text });
+        }
+      }
+      return true;
+    });
+    if (updates.length > 0) {
+      const tr = editor.state.tr;
+      for (const { pos, content } of updates) {
+        const node = editor.state.doc.nodeAt(pos);
+        if (node) {
+          tr.setNodeMarkup(pos, void 0, { ...node.attrs, content });
         }
-        editor.view.dispatch(tr);
       }
+      editor.view.dispatch(tr);
     }
   }
-});
+}
 var CitationNode = import_core7.Node.create({
   name: "citation",
   group: "inline",
@@ -2297,9 +2318,9 @@ var CitationNode = import_core7.Node.create({
       dom.className = "docs-citation";
       dom.setAttribute("data-node-type", "citation");
       const render = () => {
-        const engine2 = getCitationEngine(editor);
+        const engine = getCitationEngine(editor);
         const citationId = node.attrs.citationId;
-        const text = engine2 && citationId ? engine2.renderCluster(citationId) : "";
+        const text = engine && citationId ? engine.renderCluster(citationId) : "";
         if (text) {
           dom.innerHTML = text;
           dom.classList.remove("docs-citation--missing");
@@ -2311,8 +2332,19 @@ var CitationNode = import_core7.Node.create({
         dom.setAttribute("data-citation-source-id", String(node.attrs.sourceId ?? ""));
       };
       render();
-      const engine = getCitationEngine(editor);
-      const unsubscribe = engine?.onChange(render);
+      let unsubscribe = null;
+      let bound = null;
+      const syncEngine = () => {
+        const engine = getCitationEngine(editor);
+        if (engine === bound) return;
+        unsubscribe?.();
+        bound = engine;
+        unsubscribe = engine ? engine.onChange(render) : null;
+        render();
+      };
+      syncEngine();
+      editor.on("create", syncEngine);
+      editor.on("citationEngineReady", syncEngine);
       return {
         dom,
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -2326,6 +2358,8 @@ var CitationNode = import_core7.Node.create({
           return true;
         },
         destroy() {
+          editor.off("create", syncEngine);
+          editor.off("citationEngineReady", syncEngine);
           unsubscribe?.();
         }
       };
@@ -2397,6 +2431,8 @@ var citationPlugin = (0, import_docflow_core17.definePlugin)({
       const sources = typeof citation.sources === "function" ? citation.sources() : citation.sources;
       const engine = new CiteEngine({ sources, style: citation.style });
       editor.storage.citationEngine.engine = engine;
+      editor.emit("citationEngineReady", { editor });
+      syncCitationClusters(editor);
     },
     onDestroy(editor) {
       ;

package/dist/index.d.cts

@@ -100,6 +100,19 @@ declare const textColorPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
 declare const highlightPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
+declare module '@tiptap/core' {
+    interface EditorEvents {
+        /**
+         * Emitted once the document-scoped CiteEngine exists. It is created by
+         * `citationPlugin.hooks.onInit`, i.e. AFTER the editor view (and therefore
+         * after the node views for the already-loaded document), so node views
+         * cannot rely on the engine being there when they are constructed.
+         */
+        citationEngineReady: {
+            editor: Editor;
+        };
+    }
+}
 declare function getCitationEngine(editor: Editor): CiteEngine | null;
 /**
  * Carries the document-scoped CiteEngine in editor storage. The engine is

package/dist/index.d.ts

@@ -100,6 +100,19 @@ declare const textColorPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
 declare const highlightPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
+declare module '@tiptap/core' {
+    interface EditorEvents {
+        /**
+         * Emitted once the document-scoped CiteEngine exists. It is created by
+         * `citationPlugin.hooks.onInit`, i.e. AFTER the editor view (and therefore
+         * after the node views for the already-loaded document), so node views
+         * cannot rely on the engine being there when they are constructed.
+         */
+        citationEngineReady: {
+            editor: Editor;
+        };
+    }
+}
 declare function getCitationEngine(editor: Editor): CiteEngine | null;
 /**
  * Carries the document-scoped CiteEngine in editor storage. The engine is

package/dist/index.js

@@ -1981,8 +1981,8 @@ var BibliographyNode = Node5.create({
       dom.setAttribute("data-node-type", "bibliography");
       let attrs = props.node?.attrs ?? {};
       const render = () => {
-        const engine2 = getEngine(editor);
-        const items = engine2?.getBibliography() ?? [];
+        const engine = getEngine(editor);
+        const items = engine?.getBibliography() ?? [];
         const showHeading = !isHeadingHidden(attrs.showHeading);
         const headingText = headingLabel(attrs.headingText);
         dom.innerHTML = "";
@@ -2011,8 +2011,19 @@ var BibliographyNode = Node5.create({
         dom.appendChild(list);
       };
       render();
-      const engine = getEngine(editor);
-      const unsubscribe = engine?.onChange(render);
+      let unsubscribe = null;
+      let bound = null;
+      const syncEngine = () => {
+        const engine = getEngine(editor);
+        if (engine === bound) return;
+        unsubscribe?.();
+        bound = engine;
+        unsubscribe = engine ? engine.onChange(render) : null;
+        render();
+      };
+      syncEngine();
+      editor.on("create", syncEngine);
+      editor.on("citationEngineReady", syncEngine);
       return {
         dom,
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -2025,6 +2036,8 @@ var BibliographyNode = Node5.create({
           return true;
         },
         destroy() {
+          editor.off("create", syncEngine);
+          editor.off("citationEngineReady", syncEngine);
           unsubscribe?.();
         }
       };
@@ -2065,83 +2078,91 @@ var CitationEngineExtension = Extension2.create({
    * recomputes only when the ordered signature changed, so plain typing
    * costs one cheap walk and no citeproc work.
    */
+  /**
+   * Keep the engine's cluster registry in sync with the document — see
+   * `syncCitationClusters`. The engine recomputes only when the ordered
+   * signature changed, so plain typing costs one cheap walk and no citeproc
+   * work.
+   */
   onUpdate() {
-    const editor = this.editor;
-    const engine = getCitationEngine(editor);
-    if (!engine) return;
-    {
-      const seen = /* @__PURE__ */ new Set();
-      const repairs = [];
-      editor.state.doc.descendants((node, pos) => {
-        if (node.type.name === "citation" || node.type.name === "footnote" && node.attrs.sourceId) {
-          const id = node.attrs.citationId;
-          if (id) {
-            if (seen.has(id)) {
-              repairs.push({ pos, attrs: { ...node.attrs } });
-            } else {
-              seen.add(id);
-            }
-          }
-        }
-        return true;
-      });
-      if (repairs.length > 0) {
-        const tr = editor.state.tr;
-        for (const { pos, attrs } of repairs) {
-          tr.setNodeMarkup(pos, void 0, { ...attrs, citationId: nextCitationId() });
-        }
-        editor.view.dispatch(tr);
-        return;
-      }
-    }
-    const ordered = [];
+    syncCitationClusters(this.editor);
+  }
+});
+function syncCitationClusters(editor) {
+  const engine = getCitationEngine(editor);
+  if (!engine) return;
+  {
+    const seen = /* @__PURE__ */ new Set();
+    const repairs = [];
     editor.state.doc.descendants((node, pos) => {
       if (node.type.name === "citation" || node.type.name === "footnote" && node.attrs.sourceId) {
-        ordered.push({
-          citationId: node.attrs.citationId ?? `anon-${pos}`,
-          attrs: {
-            sourceId: node.attrs.sourceId ?? null,
-            locator: node.attrs.locator || "",
-            label: node.attrs.label || "page",
-            mode: node.attrs.mode || "normal",
-            prefix: node.attrs.prefix || "",
-            suffix: node.attrs.suffix || ""
+        const id = node.attrs.citationId;
+        if (id) {
+          if (seen.has(id)) {
+            repairs.push({ pos, attrs: { ...node.attrs } });
+          } else {
+            seen.add(id);
           }
-        });
+        }
       }
       return true;
     });
-    const changed = engine.syncCitations(ordered);
-    if (changed) {
-      const port = editor.storage.editorContext;
-      port?.citation?.onSourcesChange?.(engine.getCitedSourceIds());
+    if (repairs.length > 0) {
+      const tr = editor.state.tr;
+      for (const { pos, attrs } of repairs) {
+        tr.setNodeMarkup(pos, void 0, { ...attrs, citationId: nextCitationId() });
+      }
+      editor.view.dispatch(tr);
+      return;
     }
-    {
-      const updates = [];
-      editor.state.doc.descendants((node, pos) => {
-        if (node.type.name === "footnote" && node.attrs.sourceId) {
-          const id = node.attrs.citationId;
-          if (!id) return true;
-          const text = engine.renderCluster(id);
-          if (text && text !== node.attrs.content) {
-            updates.push({ pos, content: text });
-          }
+  }
+  const ordered = [];
+  editor.state.doc.descendants((node, pos) => {
+    if (node.type.name === "citation" || node.type.name === "footnote" && node.attrs.sourceId) {
+      ordered.push({
+        citationId: node.attrs.citationId ?? `anon-${pos}`,
+        attrs: {
+          sourceId: node.attrs.sourceId ?? null,
+          locator: node.attrs.locator || "",
+          label: node.attrs.label || "page",
+          mode: node.attrs.mode || "normal",
+          prefix: node.attrs.prefix || "",
+          suffix: node.attrs.suffix || ""
         }
-        return true;
       });
-      if (updates.length > 0) {
-        const tr = editor.state.tr;
-        for (const { pos, content } of updates) {
-          const node = editor.state.doc.nodeAt(pos);
-          if (node) {
-            tr.setNodeMarkup(pos, void 0, { ...node.attrs, content });
-          }
+    }
+    return true;
+  });
+  const changed = engine.syncCitations(ordered);
+  if (changed) {
+    const port = editor.storage.editorContext;
+    port?.citation?.onSourcesChange?.(engine.getCitedSourceIds());
+  }
+  {
+    const updates = [];
+    editor.state.doc.descendants((node, pos) => {
+      if (node.type.name === "footnote" && node.attrs.sourceId) {
+        const id = node.attrs.citationId;
+        if (!id) return true;
+        const text = engine.renderCluster(id);
+        if (text && text !== node.attrs.content) {
+          updates.push({ pos, content: text });
+        }
+      }
+      return true;
+    });
+    if (updates.length > 0) {
+      const tr = editor.state.tr;
+      for (const { pos, content } of updates) {
+        const node = editor.state.doc.nodeAt(pos);
+        if (node) {
+          tr.setNodeMarkup(pos, void 0, { ...node.attrs, content });
         }
-        editor.view.dispatch(tr);
       }
+      editor.view.dispatch(tr);
     }
   }
-});
+}
 var CitationNode = Node6.create({
   name: "citation",
   group: "inline",
@@ -2204,9 +2225,9 @@ var CitationNode = Node6.create({
       dom.className = "docs-citation";
       dom.setAttribute("data-node-type", "citation");
       const render = () => {
-        const engine2 = getCitationEngine(editor);
+        const engine = getCitationEngine(editor);
         const citationId = node.attrs.citationId;
-        const text = engine2 && citationId ? engine2.renderCluster(citationId) : "";
+        const text = engine && citationId ? engine.renderCluster(citationId) : "";
         if (text) {
           dom.innerHTML = text;
           dom.classList.remove("docs-citation--missing");
@@ -2218,8 +2239,19 @@ var CitationNode = Node6.create({
         dom.setAttribute("data-citation-source-id", String(node.attrs.sourceId ?? ""));
       };
       render();
-      const engine = getCitationEngine(editor);
-      const unsubscribe = engine?.onChange(render);
+      let unsubscribe = null;
+      let bound = null;
+      const syncEngine = () => {
+        const engine = getCitationEngine(editor);
+        if (engine === bound) return;
+        unsubscribe?.();
+        bound = engine;
+        unsubscribe = engine ? engine.onChange(render) : null;
+        render();
+      };
+      syncEngine();
+      editor.on("create", syncEngine);
+      editor.on("citationEngineReady", syncEngine);
       return {
         dom,
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -2233,6 +2265,8 @@ var CitationNode = Node6.create({
           return true;
         },
         destroy() {
+          editor.off("create", syncEngine);
+          editor.off("citationEngineReady", syncEngine);
           unsubscribe?.();
         }
       };
@@ -2304,6 +2338,8 @@ var citationPlugin = definePlugin17({
       const sources = typeof citation.sources === "function" ? citation.sources() : citation.sources;
       const engine = new CiteEngine({ sources, style: citation.style });
       editor.storage.citationEngine.engine = engine;
+      editor.emit("citationEngineReady", { editor });
+      syncCitationClusters(editor);
     },
     onDestroy(editor) {
       ;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kedataindo/docflow-plugins",
   "license": "UNLICENSED",
-  "version": "0.0.77",
+  "version": "0.0.79",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -31,7 +31,7 @@
     "@tiptap/pm": "^2.11.0",
     "citeproc": "^2.4.63",
     "tiptap-markdown": "0.8.10",
-    "@kedataindo/docflow-core": "0.0.75"
+    "@kedataindo/docflow-core": "0.0.77"
   },
   "peerDependencies": {
     "@tiptap/core": "^2.11.0",