@kedataindo/docflow-plugins 0.0.90 → 0.0.92

package/dist/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
   DateChipNode: () => DateChipNode,
   DropdownChipNode: () => DropdownChipNode,
   FileChipNode: () => FileChipNode,
+  FontFamilyExtension: () => import_docflow_core15.FontFamilyExtension,
   FontSizeExtension: () => import_docflow_core14.FontSizeExtension,
   FootnoteNode: () => FootnoteNode,
   LocationChipNode: () => LocationChipNode,
@@ -70,6 +71,7 @@ __export(index_exports, {
   commentPlugin: () => commentPlugin,
   createPlaceholderPlugin: () => createPlaceholderPlugin,
   defaultPlugins: () => defaultPlugins,
+  fontFamilyPlugin: () => fontFamilyPlugin,
   fontSizePlugin: () => fontSizePlugin,
   footnotePlugin: () => footnotePlugin,
   formattingPlugin: () => formattingPlugin,
@@ -92,6 +94,7 @@ __export(index_exports, {
   rejectAllSuggestions: () => rejectAllSuggestions,
   rejectSuggestion: () => rejectSuggestion,
   sanitizeCiteprocHtml: () => sanitizeCiteprocHtml,
+  scrollEditorToPos: () => scrollEditorToPos,
   setDocumentMode: () => setDocumentMode,
   setSuggestionAuthor: () => setSuggestionAuthor,
   slashMenuPlugin: () => slashMenuPlugin,
@@ -288,6 +291,7 @@ var import_extension_table = __toESM(require("@tiptap/extension-table"), 1);
 var import_extension_table_row = __toESM(require("@tiptap/extension-table-row"), 1);
 var import_extension_table_cell = __toESM(require("@tiptap/extension-table-cell"), 1);
 var import_extension_table_header = __toESM(require("@tiptap/extension-table-header"), 1);
+var import_state = require("@tiptap/pm/state");
 var CustomTable = import_extension_table.default.extend({
   addAttributes() {
     return {
@@ -357,6 +361,31 @@ var CustomTable = import_extension_table.default.extend({
       ["colgroup", ...cols],
       ["tbody", 0]
     ];
+  },
+  // #139: double-clicking an EMPTY cell resolved the caret to a neighbouring
+  // cell — ProseMirror's default dblclick word-selection has no text to land on
+  // in a cell whose only content is a trailing <br>. When the resolved position
+  // is not inside the cell under the pointer, place the caret at that cell's
+  // start instead. Non-empty cells keep the default (select the word).
+  addProseMirrorPlugins() {
+    const parent = this.parent?.() ?? [];
+    return [
+      ...parent,
+      new import_state.Plugin({
+        props: {
+          handleDoubleClick(view, pos, event) {
+            const cell = event.target?.closest?.("td, th") ?? null;
+            if (!cell) return false;
+            if ((cell.textContent ?? "").trim() !== "") return false;
+            void pos;
+            const cellPos = view.posAtDOM(cell, 0);
+            const selection = import_state.TextSelection.near(view.state.doc.resolve(cellPos), 1);
+            view.dispatch(view.state.tr.setSelection(selection));
+            return true;
+          }
+        }
+      })
+    ];
   }
 });
 var CustomTableCell = import_extension_table_cell.default.extend({
@@ -639,6 +668,44 @@ var footnotePlugin = (0, import_docflow_core12.definePlugin)({
 // src/toc.ts
 var import_core4 = require("@tiptap/core");
 var import_docflow_core13 = require("@kedataindo/docflow-core");
+
+// src/editorScroll.ts
+var import_state2 = require("@tiptap/pm/state");
+function scrollEditorToPos(editor, pos, options = {}) {
+  const { state, view } = editor;
+  const clamped = Math.min(Math.max(0, pos), state.doc.content.size);
+  let anchor = clamped;
+  if (options.focus !== false) {
+    const selection = import_state2.TextSelection.near(state.doc.resolve(clamped), 1);
+    if (!state.selection.eq(selection)) {
+      view.dispatch(state.tr.setSelection(selection));
+    }
+    editor.commands.focus();
+    anchor = view.state.selection.from;
+  }
+  const editorDom = view.dom;
+  const scrollEl = editorDom.closest?.(".docs-editor-scroll") ?? null;
+  let coords = null;
+  try {
+    coords = view.coordsAtPos(anchor);
+  } catch {
+    coords = null;
+  }
+  if (!scrollEl || !coords) {
+    editorDom.scrollIntoView?.({ block: "start" });
+    return;
+  }
+  const scrollRect = scrollEl.getBoundingClientRect();
+  const top = scrollEl.scrollTop + (coords.top - scrollRect.top) - scrollEl.clientHeight / 3;
+  const target = Math.max(0, top);
+  try {
+    scrollEl.scrollTo({ top: target, behavior: "smooth" });
+  } catch {
+    scrollEl.scrollTop = target;
+  }
+}
+
+// src/toc.ts
 function collectHeadingsFromDoc(doc) {
   const headings = [];
   doc.descendants((node, pos) => {
@@ -846,8 +913,7 @@ var TocNode = import_core4.Node.create({
         const entry = event.target?.closest?.("[data-toc-entry]");
         if (!entry) return;
         const pos = Number(entry.getAttribute("data-pos") ?? 0);
-        const clamped = Math.min(Math.max(0, pos), editor.state.doc.content.size);
-        editor.chain().focus().setTextSelection(clamped).scrollIntoView().run();
+        scrollEditorToPos(editor, pos);
       };
       refresh.addEventListener("click", onRefresh);
       dom.addEventListener("click", onEntryClick);
@@ -895,10 +961,29 @@ var fontSizePlugin = (0, import_docflow_core14.definePlugin)({
   }
 });
 
-// src/textColor.ts
+// src/fontFamily.ts
 var import_docflow_core15 = require("@kedataindo/docflow-core");
+var fontFamilyPlugin = (0, import_docflow_core15.definePlugin)({
+  id: "font-family",
+  tiptapExtensions: [import_docflow_core15.FontFamilyExtension],
+  commands: {
+    setFontFamily: (editor, ...args) => {
+      const family = args[0] || "";
+      if (family) {
+        editor.commands.setFontFamily(family);
+      } else {
+        editor.commands.unsetFontFamily();
+      }
+      editor.commands.focus();
+      return true;
+    }
+  }
+});
+
+// src/textColor.ts
+var import_docflow_core16 = require("@kedataindo/docflow-core");
 var import_extension_color = __toESM(require("@tiptap/extension-color"), 1);
-var textColorPlugin = (0, import_docflow_core15.definePlugin)({
+var textColorPlugin = (0, import_docflow_core16.definePlugin)({
   id: "text-color",
   tiptapExtensions: [import_extension_color.default],
   toolbar: [
@@ -917,7 +1002,7 @@ var textColorPlugin = (0, import_docflow_core15.definePlugin)({
 });
 
 // src/highlight.ts
-var import_docflow_core16 = require("@kedataindo/docflow-core");
+var import_docflow_core17 = require("@kedataindo/docflow-core");
 var import_extension_highlight = __toESM(require("@tiptap/extension-highlight"), 1);
 var import_core5 = require("@tiptap/core");
 var GoogleDocsHighlight = import_extension_highlight.default.extend({
@@ -947,7 +1032,7 @@ var GoogleDocsHighlight = import_extension_highlight.default.extend({
     return ["mark", (0, import_core5.mergeAttributes)(this.options.HTMLAttributes, HTMLAttributes), 0];
   }
 });
-var highlightPlugin = (0, import_docflow_core16.definePlugin)({
+var highlightPlugin = (0, import_docflow_core17.definePlugin)({
   id: "highlight",
   tiptapExtensions: [
     GoogleDocsHighlight.configure({
@@ -973,7 +1058,7 @@ var highlightPlugin = (0, import_docflow_core16.definePlugin)({
 
 // src/citation.ts
 var import_core7 = require("@tiptap/core");
-var import_docflow_core17 = require("@kedataindo/docflow-core");
+var import_docflow_core18 = require("@kedataindo/docflow-core");
 
 // src/citeEngine.ts
 var import_citeproc = __toESM(require("citeproc"), 1);
@@ -2334,7 +2419,7 @@ function insertCitationWithSource(editor, engine, attrs) {
   if (spec.type === "footnote" && !editor.schema.nodes["footnote"]) return false;
   return editor.chain().focus().insertContent({ type: spec.type, attrs: spec.attrs }).run();
 }
-var citationPlugin = (0, import_docflow_core17.definePlugin)({
+var citationPlugin = (0, import_docflow_core18.definePlugin)({
   id: "citation",
   tiptapExtensions: [CitationEngineExtension, CitationNode, BibliographyNode],
   toolbar: [{ id: "insert-citation", label: "Citation", action: "insertCitation", iconComponent: "Quote" }],
@@ -2404,15 +2489,15 @@ var citationPlugin = (0, import_docflow_core17.definePlugin)({
 
 // src/ai.ts
 var import_core9 = require("@tiptap/core");
-var import_state2 = require("@tiptap/pm/state");
+var import_state4 = require("@tiptap/pm/state");
 var import_view = require("@tiptap/pm/view");
 var import_tiptap_markdown = require("tiptap-markdown");
-var import_docflow_core18 = require("@kedataindo/docflow-core");
+var import_docflow_core19 = require("@kedataindo/docflow-core");
 
 // src/markdownInsert.ts
 var import_core8 = require("@tiptap/core");
 var import_model = require("@tiptap/pm/model");
-var import_state = require("@tiptap/pm/state");
+var import_state3 = require("@tiptap/pm/state");
 var import_transform = require("@tiptap/pm/transform");
 function mdParser(editor) {
   const storage = editor.storage.markdown;
@@ -2448,7 +2533,7 @@ function selectionToInsertionEnd(tr, startLen, bias) {
   map.forEach((_from, _to, _newFrom, newTo) => {
     if (end === 0) end = newTo;
   });
-  tr.setSelection(import_state.Selection.near(tr.doc.resolve(end), bias));
+  tr.setSelection(import_state3.Selection.near(tr.doc.resolve(end), bias));
 }
 function insertMarkdownBlock(editor, view, from, to, markdown) {
   const fragment = markdownToFragment(editor, markdown, { inline: false });
@@ -2491,7 +2576,7 @@ function insertMarkdownBlock(editor, view, from, to, markdown) {
 }
 
 // src/ai.ts
-var aiPluginKey = new import_state2.PluginKey("docflow-ai");
+var aiPluginKey = new import_state4.PluginKey("docflow-ai");
 var CONTEXT_CHARS = 1500;
 function getAIPreview(editor) {
   return editor.storage.ai ? editor.storage.ai.preview ?? null : null;
@@ -2727,7 +2812,7 @@ var AIExtension = import_core9.Extension.create({
       };
     }
     return [
-      new import_state2.Plugin({
+      new import_state4.Plugin({
         key: aiPluginKey,
         state: {
           init: () => null,
@@ -2843,7 +2928,7 @@ var AIExtension = import_core9.Extension.create({
     storage.preview = null;
   }
 });
-var aiPlugin = (0, import_docflow_core18.definePlugin)({
+var aiPlugin = (0, import_docflow_core19.definePlugin)({
   id: "ai",
   // The `tiptap-markdown` `Markdown` extension is registered alongside AI so
   // that `editor.storage.markdown.parser` is available on every editor that
@@ -2899,15 +2984,15 @@ var commentPlugin = {
 
 // src/suggestChanges.ts
 var import_core11 = require("@tiptap/core");
-var import_state3 = require("@tiptap/pm/state");
+var import_state5 = require("@tiptap/pm/state");
 var import_transform2 = require("@tiptap/pm/transform");
-var import_docflow_core19 = require("@kedataindo/docflow-core");
+var import_docflow_core20 = require("@kedataindo/docflow-core");
 var SUGGESTION_INSERT = "suggestionInsert";
 var SUGGESTION_DELETE = "suggestionDelete";
 var SUGGESTION_FORMAT = "suggestionFormat";
 var FORMAT_MARKS = /* @__PURE__ */ new Set(["bold", "italic", "underline", "strike", "highlight"]);
 var SUGGEST_APPLIED_META = "suggestChanges:applied";
-var suggestChangesKey = new import_state3.PluginKey("suggestChanges");
+var suggestChangesKey = new import_state5.PluginKey("suggestChanges");
 var suggestionAttributes = () => ({
   suggestionId: {
     default: null,
@@ -3029,7 +3114,7 @@ var SuggestChanges = import_core11.Extension.create({
       if (storage) storage.suggestions = getSuggestions(editor);
     };
     return [
-      new import_state3.Plugin({
+      new import_state5.Plugin({
         key: suggestChangesKey,
         state: {
           init: () => ({ mode: "editing", author: {} }),
@@ -3117,7 +3202,7 @@ var SuggestChanges = import_core11.Extension.create({
             const id = adjacentRunId(view.state, from, SUGGESTION_DELETE) ?? newSuggestionId();
             const tr = view.state.tr.addMark(from, to, del.create(markAttrs(id, current.author)));
             if (event.key === "Backspace" && selection.empty) {
-              tr.setSelection(import_state3.TextSelection.create(tr.doc, from));
+              tr.setSelection(import_state5.TextSelection.create(tr.doc, from));
             }
             view.dispatch(tr);
             return true;
@@ -3269,7 +3354,7 @@ var acceptSuggestion = (editor, id) => resolveSuggestions(editor, true, id);
 var rejectSuggestion = (editor, id) => resolveSuggestions(editor, false, id);
 var acceptAllSuggestions = (editor) => resolveSuggestions(editor, true);
 var rejectAllSuggestions = (editor) => resolveSuggestions(editor, false);
-var suggestChangesPlugin = (0, import_docflow_core19.definePlugin)({
+var suggestChangesPlugin = (0, import_docflow_core20.definePlugin)({
   id: "suggestChanges",
   tiptapExtensions: [SuggestionInsertMark, SuggestionDeleteMark, SuggestionFormatMark, SuggestChanges],
   commands: {
@@ -3284,7 +3369,7 @@ var suggestChangesPlugin = (0, import_docflow_core19.definePlugin)({
 
 // src/smartElements.ts
 var import_core12 = require("@tiptap/core");
-var import_docflow_core20 = require("@kedataindo/docflow-core");
+var import_docflow_core21 = require("@kedataindo/docflow-core");
 function todayISO() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 }
@@ -3654,7 +3739,7 @@ var LocationChipNode = import_core12.Node.create({
     };
   }
 });
-var smartElementsPlugin = (0, import_docflow_core20.definePlugin)({
+var smartElementsPlugin = (0, import_docflow_core21.definePlugin)({
   id: "smart-elements",
   tiptapExtensions: [
     DateChipNode,
@@ -3713,10 +3798,10 @@ var smartElementsPlugin = (0, import_docflow_core20.definePlugin)({
 });
 
 // src/tablePageSplit.ts
-var import_docflow_core21 = require("@kedataindo/docflow-core");
+var import_docflow_core22 = require("@kedataindo/docflow-core");
 var import_core13 = require("@tiptap/core");
-var import_state4 = require("@tiptap/pm/state");
-var PLUGIN_KEY = new import_state4.PluginKey("docflow/table-page-split");
+var import_state6 = require("@tiptap/pm/state");
+var PLUGIN_KEY = new import_state6.PluginKey("docflow/table-page-split");
 var SPLIT_MARK = "head";
 var MAX_SPLIT_DEPTH = 16;
 function readPageContentHeightPx(view, editor) {
@@ -3902,7 +3987,7 @@ var TablePageSplitExtension = import_core13.Extension.create({
     const ext = this;
     const editorRef = ext.editor ?? null;
     return [
-      new import_state4.Plugin({
+      new import_state6.Plugin({
         key: PLUGIN_KEY,
         view(_editorView) {
           viewRef = _editorView;
@@ -3934,15 +4019,15 @@ var TablePageSplitExtension = import_core13.Extension.create({
     ];
   }
 });
-var tablePageSplitPlugin = (0, import_docflow_core21.definePlugin)({
+var tablePageSplitPlugin = (0, import_docflow_core22.definePlugin)({
   id: "tablePageSplit",
   tiptapExtensions: [TablePageSplitExtension]
 });
 
 // src/slashMenu.ts
 var import_core14 = require("@tiptap/core");
-var import_state5 = require("@tiptap/pm/state");
-var import_docflow_core22 = require("@kedataindo/docflow-core");
+var import_state7 = require("@tiptap/pm/state");
+var import_docflow_core23 = require("@kedataindo/docflow-core");
 var slashState = {
   open: false,
   query: "",
@@ -4000,8 +4085,8 @@ var SlashMenuExtension = import_core14.Extension.create({
   name: "slashMenu",
   addProseMirrorPlugins() {
     return [
-      new import_state5.Plugin({
-        key: new import_state5.PluginKey("slashMenu"),
+      new import_state7.Plugin({
+        key: new import_state7.PluginKey("slashMenu"),
         props: {
           handleTextInput(view, from, _to, text) {
             if (text === "/") {
@@ -4087,7 +4172,7 @@ var SlashMenuExtension = import_core14.Extension.create({
     ];
   }
 });
-var slashMenuPlugin = (0, import_docflow_core22.definePlugin)({
+var slashMenuPlugin = (0, import_docflow_core23.definePlugin)({
   id: "slash-menu",
   tiptapExtensions: [SlashMenuExtension],
   hooks: {
@@ -4115,6 +4200,7 @@ var defaultPlugins = [
   footnotePlugin,
   tocPlugin,
   fontSizePlugin,
+  fontFamilyPlugin,
   textColorPlugin,
   highlightPlugin,
   citationPlugin,
@@ -4137,6 +4223,7 @@ var defaultPlugins = [
   DateChipNode,
   DropdownChipNode,
   FileChipNode,
+  FontFamilyExtension,
   FontSizeExtension,
   FootnoteNode,
   LocationChipNode,
@@ -4165,6 +4252,7 @@ var defaultPlugins = [
   commentPlugin,
   createPlaceholderPlugin,
   defaultPlugins,
+  fontFamilyPlugin,
   fontSizePlugin,
   footnotePlugin,
   formattingPlugin,
@@ -4187,6 +4275,7 @@ var defaultPlugins = [
   rejectAllSuggestions,
   rejectSuggestion,
   sanitizeCiteprocHtml,
+  scrollEditorToPos,
   setDocumentMode,
   setSuggestionAuthor,
   slashMenuPlugin,

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as _kedata_indonesia_docflow_core from '@kedataindo/docflow-core';
 import { AIAction, DocsEditorPlugin, DocumentMode } from '@kedataindo/docflow-core';
-export { DocsEditorPlugin, FontSizeExtension, SlashCommand, ToolbarItem } from '@kedataindo/docflow-core';
+export { DocsEditorPlugin, FontFamilyExtension, FontSizeExtension, SlashCommand, ToolbarItem } from '@kedataindo/docflow-core';
 import { Node, Editor, Extension, Mark } from '@tiptap/core';
 import { CiteEngine } from './citations.cjs';
 export { CSL_LOCALE_EN_US, CSL_STYLES, CitationAttrs, CitationCluster, CitationMode, CiteEngineOptions, CslStyleInfo, DEFAULT_CSL_STYLE, buildCitationNodes, nextCitationId, sanitizeCiteprocHtml } from './citations.cjs';
@@ -96,6 +96,16 @@ declare const tocPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
  */
 declare const fontSizePlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
+/**
+ * fontFamilyPlugin — provides the `setFontFamily` command action for toolbar
+ * use, backed by FontFamilyExtension (a `fontFamily` attribute on the TextStyle
+ * mark). Registered through the plugin system so the extension is added once.
+ *
+ * The toolbar passes a full CSS font stack (e.g. `Georgia, serif`) so the
+ * applied family is explicit and survives round-trips.
+ */
+declare const fontFamilyPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
+
 declare const textColorPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
 declare const highlightPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
@@ -216,6 +226,26 @@ declare function markdownToFragment(editor: Editor, markdown: string, opts: {
  */
 declare function insertMarkdownBlock(editor: Editor, view: EditorView, from: number, to: number, markdown: string): void;
 
+/**
+ * Scroll the editor so document position `pos` is visible.
+ *
+ * Works with the paginated surface: the scrollable element is the
+ * `.docs-editor-scroll` wrapper (DocsEditor), NOT the window — a plain
+ * `scrollIntoView()` on the geo-point lands on the wrong page once
+ * PaginationPlus has cloned/offset the page frames. We resolve the target from
+ * `coordsAtPos` and move the container's scrollTop instead, which is correct in
+ * both paginated and pageless mode.
+ *
+ * Falls back to the native `scrollIntoView` on the editor element when there is
+ * no scroll container (bare editor / non-DOM environments such as tests).
+ *
+ * @param options.focus move the caret to `pos` (default true). Set false when
+ *   the caller has already placed the selection.
+ */
+declare function scrollEditorToPos(editor: Editor, pos: number, options?: {
+    focus?: boolean;
+}): void;
+
 /**
  * Phase 9 P9-4 — comment plugin.
  *
@@ -360,4 +390,4 @@ declare const slashMenuPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
 declare const defaultPlugins: _kedata_indonesia_docflow_core.DocsEditorPlugin[];
 
-export { AIExtension, type AIPreviewState, BibliographyNode, CitationEngineExtension, CitationNode, CiteEngine, type CommentMarkAttrs, CommentMark as CommentMarkExtension, DateChipNode, DropdownChipNode, FileChipNode, FootnoteNode, LocationChipNode, PageBreak, PeopleChipNode, type PlaceholderPluginOptions, SUGGESTION_DELETE, SUGGESTION_FORMAT, SUGGESTION_INSERT, SlashMenuExtension, type SuggestionAuthor, SuggestionDeleteMark, SuggestionFormatMark, SuggestionInsertMark, type SuggestionSummary, TocEntryNode, TocNode, TocPageNumNode, acceptAllSuggestions, acceptSuggestion, aiPlugin, aiPluginKey, alignmentPlugin, blockquotePlugin, citationPlugin, codeBlockPlugin, collectHeadings, commentPlugin, createPlaceholderPlugin, defaultPlugins, fontSizePlugin, footnotePlugin, formattingPlugin, getAIPreview, getCitationEngine, getSuggestions, headingsPlugin, highlightPlugin, imagePlugin, insertMarkdownBlock, linkPlugin, listsPlugin, markdownToFragment, onSlashStateChange, pageBreakPlugin, placeholderPlugin, regenerateToc, registerSlashCommands, rejectAllSuggestions, rejectSuggestion, setDocumentMode, setSuggestionAuthor, slashMenuPlugin, slashState, smartElementsPlugin, suggestChangesPlugin, tablePageSplitPlugin, tablePlugin, textColorPlugin, tocPlugin };
+export { AIExtension, type AIPreviewState, BibliographyNode, CitationEngineExtension, CitationNode, CiteEngine, type CommentMarkAttrs, CommentMark as CommentMarkExtension, DateChipNode, DropdownChipNode, FileChipNode, FootnoteNode, LocationChipNode, PageBreak, PeopleChipNode, type PlaceholderPluginOptions, SUGGESTION_DELETE, SUGGESTION_FORMAT, SUGGESTION_INSERT, SlashMenuExtension, type SuggestionAuthor, SuggestionDeleteMark, SuggestionFormatMark, SuggestionInsertMark, type SuggestionSummary, TocEntryNode, TocNode, TocPageNumNode, acceptAllSuggestions, acceptSuggestion, aiPlugin, aiPluginKey, alignmentPlugin, blockquotePlugin, citationPlugin, codeBlockPlugin, collectHeadings, commentPlugin, createPlaceholderPlugin, defaultPlugins, fontFamilyPlugin, fontSizePlugin, footnotePlugin, formattingPlugin, getAIPreview, getCitationEngine, getSuggestions, headingsPlugin, highlightPlugin, imagePlugin, insertMarkdownBlock, linkPlugin, listsPlugin, markdownToFragment, onSlashStateChange, pageBreakPlugin, placeholderPlugin, regenerateToc, registerSlashCommands, rejectAllSuggestions, rejectSuggestion, scrollEditorToPos, setDocumentMode, setSuggestionAuthor, slashMenuPlugin, slashState, smartElementsPlugin, suggestChangesPlugin, tablePageSplitPlugin, tablePlugin, textColorPlugin, tocPlugin };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _kedata_indonesia_docflow_core from '@kedataindo/docflow-core';
 import { AIAction, DocsEditorPlugin, DocumentMode } from '@kedataindo/docflow-core';
-export { DocsEditorPlugin, FontSizeExtension, SlashCommand, ToolbarItem } from '@kedataindo/docflow-core';
+export { DocsEditorPlugin, FontFamilyExtension, FontSizeExtension, SlashCommand, ToolbarItem } from '@kedataindo/docflow-core';
 import { Node, Editor, Extension, Mark } from '@tiptap/core';
 import { CiteEngine } from './citations.js';
 export { CSL_LOCALE_EN_US, CSL_STYLES, CitationAttrs, CitationCluster, CitationMode, CiteEngineOptions, CslStyleInfo, DEFAULT_CSL_STYLE, buildCitationNodes, nextCitationId, sanitizeCiteprocHtml } from './citations.js';
@@ -96,6 +96,16 @@ declare const tocPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
  */
 declare const fontSizePlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
+/**
+ * fontFamilyPlugin — provides the `setFontFamily` command action for toolbar
+ * use, backed by FontFamilyExtension (a `fontFamily` attribute on the TextStyle
+ * mark). Registered through the plugin system so the extension is added once.
+ *
+ * The toolbar passes a full CSS font stack (e.g. `Georgia, serif`) so the
+ * applied family is explicit and survives round-trips.
+ */
+declare const fontFamilyPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
+
 declare const textColorPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
 declare const highlightPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
@@ -216,6 +226,26 @@ declare function markdownToFragment(editor: Editor, markdown: string, opts: {
  */
 declare function insertMarkdownBlock(editor: Editor, view: EditorView, from: number, to: number, markdown: string): void;
 
+/**
+ * Scroll the editor so document position `pos` is visible.
+ *
+ * Works with the paginated surface: the scrollable element is the
+ * `.docs-editor-scroll` wrapper (DocsEditor), NOT the window — a plain
+ * `scrollIntoView()` on the geo-point lands on the wrong page once
+ * PaginationPlus has cloned/offset the page frames. We resolve the target from
+ * `coordsAtPos` and move the container's scrollTop instead, which is correct in
+ * both paginated and pageless mode.
+ *
+ * Falls back to the native `scrollIntoView` on the editor element when there is
+ * no scroll container (bare editor / non-DOM environments such as tests).
+ *
+ * @param options.focus move the caret to `pos` (default true). Set false when
+ *   the caller has already placed the selection.
+ */
+declare function scrollEditorToPos(editor: Editor, pos: number, options?: {
+    focus?: boolean;
+}): void;
+
 /**
  * Phase 9 P9-4 — comment plugin.
  *
@@ -360,4 +390,4 @@ declare const slashMenuPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
 declare const defaultPlugins: _kedata_indonesia_docflow_core.DocsEditorPlugin[];
 
-export { AIExtension, type AIPreviewState, BibliographyNode, CitationEngineExtension, CitationNode, CiteEngine, type CommentMarkAttrs, CommentMark as CommentMarkExtension, DateChipNode, DropdownChipNode, FileChipNode, FootnoteNode, LocationChipNode, PageBreak, PeopleChipNode, type PlaceholderPluginOptions, SUGGESTION_DELETE, SUGGESTION_FORMAT, SUGGESTION_INSERT, SlashMenuExtension, type SuggestionAuthor, SuggestionDeleteMark, SuggestionFormatMark, SuggestionInsertMark, type SuggestionSummary, TocEntryNode, TocNode, TocPageNumNode, acceptAllSuggestions, acceptSuggestion, aiPlugin, aiPluginKey, alignmentPlugin, blockquotePlugin, citationPlugin, codeBlockPlugin, collectHeadings, commentPlugin, createPlaceholderPlugin, defaultPlugins, fontSizePlugin, footnotePlugin, formattingPlugin, getAIPreview, getCitationEngine, getSuggestions, headingsPlugin, highlightPlugin, imagePlugin, insertMarkdownBlock, linkPlugin, listsPlugin, markdownToFragment, onSlashStateChange, pageBreakPlugin, placeholderPlugin, regenerateToc, registerSlashCommands, rejectAllSuggestions, rejectSuggestion, setDocumentMode, setSuggestionAuthor, slashMenuPlugin, slashState, smartElementsPlugin, suggestChangesPlugin, tablePageSplitPlugin, tablePlugin, textColorPlugin, tocPlugin };
+export { AIExtension, type AIPreviewState, BibliographyNode, CitationEngineExtension, CitationNode, CiteEngine, type CommentMarkAttrs, CommentMark as CommentMarkExtension, DateChipNode, DropdownChipNode, FileChipNode, FootnoteNode, LocationChipNode, PageBreak, PeopleChipNode, type PlaceholderPluginOptions, SUGGESTION_DELETE, SUGGESTION_FORMAT, SUGGESTION_INSERT, SlashMenuExtension, type SuggestionAuthor, SuggestionDeleteMark, SuggestionFormatMark, SuggestionInsertMark, type SuggestionSummary, TocEntryNode, TocNode, TocPageNumNode, acceptAllSuggestions, acceptSuggestion, aiPlugin, aiPluginKey, alignmentPlugin, blockquotePlugin, citationPlugin, codeBlockPlugin, collectHeadings, commentPlugin, createPlaceholderPlugin, defaultPlugins, fontFamilyPlugin, fontSizePlugin, footnotePlugin, formattingPlugin, getAIPreview, getCitationEngine, getSuggestions, headingsPlugin, highlightPlugin, imagePlugin, insertMarkdownBlock, linkPlugin, listsPlugin, markdownToFragment, onSlashStateChange, pageBreakPlugin, placeholderPlugin, regenerateToc, registerSlashCommands, rejectAllSuggestions, rejectSuggestion, scrollEditorToPos, setDocumentMode, setSuggestionAuthor, slashMenuPlugin, slashState, smartElementsPlugin, suggestChangesPlugin, tablePageSplitPlugin, tablePlugin, textColorPlugin, tocPlugin };

package/dist/index.js

@@ -181,6 +181,7 @@ import Table from "@tiptap/extension-table";
 import TableRow from "@tiptap/extension-table-row";
 import TableCell from "@tiptap/extension-table-cell";
 import TableHeader from "@tiptap/extension-table-header";
+import { Plugin, TextSelection } from "@tiptap/pm/state";
 var CustomTable = Table.extend({
   addAttributes() {
     return {
@@ -250,6 +251,31 @@ var CustomTable = Table.extend({
       ["colgroup", ...cols],
       ["tbody", 0]
     ];
+  },
+  // #139: double-clicking an EMPTY cell resolved the caret to a neighbouring
+  // cell — ProseMirror's default dblclick word-selection has no text to land on
+  // in a cell whose only content is a trailing <br>. When the resolved position
+  // is not inside the cell under the pointer, place the caret at that cell's
+  // start instead. Non-empty cells keep the default (select the word).
+  addProseMirrorPlugins() {
+    const parent = this.parent?.() ?? [];
+    return [
+      ...parent,
+      new Plugin({
+        props: {
+          handleDoubleClick(view, pos, event) {
+            const cell = event.target?.closest?.("td, th") ?? null;
+            if (!cell) return false;
+            if ((cell.textContent ?? "").trim() !== "") return false;
+            void pos;
+            const cellPos = view.posAtDOM(cell, 0);
+            const selection = TextSelection.near(view.state.doc.resolve(cellPos), 1);
+            view.dispatch(view.state.tr.setSelection(selection));
+            return true;
+          }
+        }
+      })
+    ];
   }
 });
 var CustomTableCell = TableCell.extend({
@@ -532,6 +558,44 @@ var footnotePlugin = definePlugin12({
 // src/toc.ts
 import { Extension, Node as Node4, mergeAttributes as mergeAttributes4 } from "@tiptap/core";
 import { definePlugin as definePlugin13 } from "@kedataindo/docflow-core";
+
+// src/editorScroll.ts
+import { TextSelection as TextSelection2 } from "@tiptap/pm/state";
+function scrollEditorToPos(editor, pos, options = {}) {
+  const { state, view } = editor;
+  const clamped = Math.min(Math.max(0, pos), state.doc.content.size);
+  let anchor = clamped;
+  if (options.focus !== false) {
+    const selection = TextSelection2.near(state.doc.resolve(clamped), 1);
+    if (!state.selection.eq(selection)) {
+      view.dispatch(state.tr.setSelection(selection));
+    }
+    editor.commands.focus();
+    anchor = view.state.selection.from;
+  }
+  const editorDom = view.dom;
+  const scrollEl = editorDom.closest?.(".docs-editor-scroll") ?? null;
+  let coords = null;
+  try {
+    coords = view.coordsAtPos(anchor);
+  } catch {
+    coords = null;
+  }
+  if (!scrollEl || !coords) {
+    editorDom.scrollIntoView?.({ block: "start" });
+    return;
+  }
+  const scrollRect = scrollEl.getBoundingClientRect();
+  const top = scrollEl.scrollTop + (coords.top - scrollRect.top) - scrollEl.clientHeight / 3;
+  const target = Math.max(0, top);
+  try {
+    scrollEl.scrollTo({ top: target, behavior: "smooth" });
+  } catch {
+    scrollEl.scrollTop = target;
+  }
+}
+
+// src/toc.ts
 function collectHeadingsFromDoc(doc) {
   const headings = [];
   doc.descendants((node, pos) => {
@@ -739,8 +803,7 @@ var TocNode = Node4.create({
         const entry = event.target?.closest?.("[data-toc-entry]");
         if (!entry) return;
         const pos = Number(entry.getAttribute("data-pos") ?? 0);
-        const clamped = Math.min(Math.max(0, pos), editor.state.doc.content.size);
-        editor.chain().focus().setTextSelection(clamped).scrollIntoView().run();
+        scrollEditorToPos(editor, pos);
       };
       refresh.addEventListener("click", onRefresh);
       dom.addEventListener("click", onEntryClick);
@@ -788,10 +851,29 @@ var fontSizePlugin = definePlugin14({
   }
 });
 
+// src/fontFamily.ts
+import { definePlugin as definePlugin15, FontFamilyExtension } from "@kedataindo/docflow-core";
+var fontFamilyPlugin = definePlugin15({
+  id: "font-family",
+  tiptapExtensions: [FontFamilyExtension],
+  commands: {
+    setFontFamily: (editor, ...args) => {
+      const family = args[0] || "";
+      if (family) {
+        editor.commands.setFontFamily(family);
+      } else {
+        editor.commands.unsetFontFamily();
+      }
+      editor.commands.focus();
+      return true;
+    }
+  }
+});
+
 // src/textColor.ts
-import { definePlugin as definePlugin15 } from "@kedataindo/docflow-core";
+import { definePlugin as definePlugin16 } from "@kedataindo/docflow-core";
 import Color from "@tiptap/extension-color";
-var textColorPlugin = definePlugin15({
+var textColorPlugin = definePlugin16({
   id: "text-color",
   tiptapExtensions: [Color],
   toolbar: [
@@ -810,7 +892,7 @@ var textColorPlugin = definePlugin15({
 });
 
 // src/highlight.ts
-import { definePlugin as definePlugin16 } from "@kedataindo/docflow-core";
+import { definePlugin as definePlugin17 } from "@kedataindo/docflow-core";
 import Highlight from "@tiptap/extension-highlight";
 import { mergeAttributes as mergeAttributes5 } from "@tiptap/core";
 var GoogleDocsHighlight = Highlight.extend({
@@ -840,7 +922,7 @@ var GoogleDocsHighlight = Highlight.extend({
     return ["mark", mergeAttributes5(this.options.HTMLAttributes, HTMLAttributes), 0];
   }
 });
-var highlightPlugin = definePlugin16({
+var highlightPlugin = definePlugin17({
   id: "highlight",
   tiptapExtensions: [
     GoogleDocsHighlight.configure({
@@ -866,7 +948,7 @@ var highlightPlugin = definePlugin16({
 
 // src/citation.ts
 import { Extension as Extension2, Node as Node6, mergeAttributes as mergeAttributes7 } from "@tiptap/core";
-import { definePlugin as definePlugin17 } from "@kedataindo/docflow-core";
+import { definePlugin as definePlugin18 } from "@kedataindo/docflow-core";
 
 // src/citeEngine.ts
 import CSL from "citeproc";
@@ -2227,7 +2309,7 @@ function insertCitationWithSource(editor, engine, attrs) {
   if (spec.type === "footnote" && !editor.schema.nodes["footnote"]) return false;
   return editor.chain().focus().insertContent({ type: spec.type, attrs: spec.attrs }).run();
 }
-var citationPlugin = definePlugin17({
+var citationPlugin = definePlugin18({
   id: "citation",
   tiptapExtensions: [CitationEngineExtension, CitationNode, BibliographyNode],
   toolbar: [{ id: "insert-citation", label: "Citation", action: "insertCitation", iconComponent: "Quote" }],
@@ -2297,10 +2379,10 @@ var citationPlugin = definePlugin17({
 
 // src/ai.ts
 import { Extension as Extension3 } from "@tiptap/core";
-import { Plugin, PluginKey } from "@tiptap/pm/state";
+import { Plugin as Plugin2, PluginKey } from "@tiptap/pm/state";
 import { Decoration, DecorationSet } from "@tiptap/pm/view";
 import { Markdown } from "tiptap-markdown";
-import { definePlugin as definePlugin18 } from "@kedataindo/docflow-core";
+import { definePlugin as definePlugin19 } from "@kedataindo/docflow-core";
 
 // src/markdownInsert.ts
 import { createNodeFromContent } from "@tiptap/core";
@@ -2620,7 +2702,7 @@ var AIExtension = Extension3.create({
       };
     }
     return [
-      new Plugin({
+      new Plugin2({
         key: aiPluginKey,
         state: {
           init: () => null,
@@ -2736,7 +2818,7 @@ var AIExtension = Extension3.create({
     storage.preview = null;
   }
 });
-var aiPlugin = definePlugin18({
+var aiPlugin = definePlugin19({
   id: "ai",
   // The `tiptap-markdown` `Markdown` extension is registered alongside AI so
   // that `editor.storage.markdown.parser` is available on every editor that
@@ -2792,9 +2874,9 @@ var commentPlugin = {
 
 // src/suggestChanges.ts
 import { Extension as Extension4, Mark as Mark2, mergeAttributes as mergeAttributes8 } from "@tiptap/core";
-import { Plugin as Plugin2, PluginKey as PluginKey2, TextSelection } from "@tiptap/pm/state";
+import { Plugin as Plugin3, PluginKey as PluginKey2, TextSelection as TextSelection3 } from "@tiptap/pm/state";
 import { AddMarkStep, RemoveMarkStep } from "@tiptap/pm/transform";
-import { definePlugin as definePlugin19 } from "@kedataindo/docflow-core";
+import { definePlugin as definePlugin20 } from "@kedataindo/docflow-core";
 var SUGGESTION_INSERT = "suggestionInsert";
 var SUGGESTION_DELETE = "suggestionDelete";
 var SUGGESTION_FORMAT = "suggestionFormat";
@@ -2922,7 +3004,7 @@ var SuggestChanges = Extension4.create({
       if (storage) storage.suggestions = getSuggestions(editor);
     };
     return [
-      new Plugin2({
+      new Plugin3({
         key: suggestChangesKey,
         state: {
           init: () => ({ mode: "editing", author: {} }),
@@ -3010,7 +3092,7 @@ var SuggestChanges = Extension4.create({
             const id = adjacentRunId(view.state, from, SUGGESTION_DELETE) ?? newSuggestionId();
             const tr = view.state.tr.addMark(from, to, del.create(markAttrs(id, current.author)));
             if (event.key === "Backspace" && selection.empty) {
-              tr.setSelection(TextSelection.create(tr.doc, from));
+              tr.setSelection(TextSelection3.create(tr.doc, from));
             }
             view.dispatch(tr);
             return true;
@@ -3162,7 +3244,7 @@ var acceptSuggestion = (editor, id) => resolveSuggestions(editor, true, id);
 var rejectSuggestion = (editor, id) => resolveSuggestions(editor, false, id);
 var acceptAllSuggestions = (editor) => resolveSuggestions(editor, true);
 var rejectAllSuggestions = (editor) => resolveSuggestions(editor, false);
-var suggestChangesPlugin = definePlugin19({
+var suggestChangesPlugin = definePlugin20({
   id: "suggestChanges",
   tiptapExtensions: [SuggestionInsertMark, SuggestionDeleteMark, SuggestionFormatMark, SuggestChanges],
   commands: {
@@ -3177,7 +3259,7 @@ var suggestChangesPlugin = definePlugin19({
 
 // src/smartElements.ts
 import { Node as Node7, mergeAttributes as mergeAttributes9 } from "@tiptap/core";
-import { definePlugin as definePlugin20 } from "@kedataindo/docflow-core";
+import { definePlugin as definePlugin21 } from "@kedataindo/docflow-core";
 function todayISO() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 }
@@ -3547,7 +3629,7 @@ var LocationChipNode = Node7.create({
     };
   }
 });
-var smartElementsPlugin = definePlugin20({
+var smartElementsPlugin = definePlugin21({
   id: "smart-elements",
   tiptapExtensions: [
     DateChipNode,
@@ -3606,9 +3688,9 @@ var smartElementsPlugin = definePlugin20({
 });
 
 // src/tablePageSplit.ts
-import { definePlugin as definePlugin21 } from "@kedataindo/docflow-core";
+import { definePlugin as definePlugin22 } from "@kedataindo/docflow-core";
 import { Extension as Extension5 } from "@tiptap/core";
-import { Plugin as Plugin3, PluginKey as PluginKey3 } from "@tiptap/pm/state";
+import { Plugin as Plugin4, PluginKey as PluginKey3 } from "@tiptap/pm/state";
 var PLUGIN_KEY = new PluginKey3("docflow/table-page-split");
 var SPLIT_MARK = "head";
 var MAX_SPLIT_DEPTH = 16;
@@ -3795,7 +3877,7 @@ var TablePageSplitExtension = Extension5.create({
     const ext = this;
     const editorRef = ext.editor ?? null;
     return [
-      new Plugin3({
+      new Plugin4({
         key: PLUGIN_KEY,
         view(_editorView) {
           viewRef = _editorView;
@@ -3827,15 +3909,15 @@ var TablePageSplitExtension = Extension5.create({
     ];
   }
 });
-var tablePageSplitPlugin = definePlugin21({
+var tablePageSplitPlugin = definePlugin22({
   id: "tablePageSplit",
   tiptapExtensions: [TablePageSplitExtension]
 });
 
 // src/slashMenu.ts
 import { Extension as Extension6 } from "@tiptap/core";
-import { Plugin as Plugin4, PluginKey as PluginKey4 } from "@tiptap/pm/state";
-import { definePlugin as definePlugin22 } from "@kedataindo/docflow-core";
+import { Plugin as Plugin5, PluginKey as PluginKey4 } from "@tiptap/pm/state";
+import { definePlugin as definePlugin23 } from "@kedataindo/docflow-core";
 var slashState = {
   open: false,
   query: "",
@@ -3893,7 +3975,7 @@ var SlashMenuExtension = Extension6.create({
   name: "slashMenu",
   addProseMirrorPlugins() {
     return [
-      new Plugin4({
+      new Plugin5({
         key: new PluginKey4("slashMenu"),
         props: {
           handleTextInput(view, from, _to, text) {
@@ -3980,7 +4062,7 @@ var SlashMenuExtension = Extension6.create({
     ];
   }
 });
-var slashMenuPlugin = definePlugin22({
+var slashMenuPlugin = definePlugin23({
   id: "slash-menu",
   tiptapExtensions: [SlashMenuExtension],
   hooks: {
@@ -4008,6 +4090,7 @@ var defaultPlugins = [
   footnotePlugin,
   tocPlugin,
   fontSizePlugin,
+  fontFamilyPlugin,
   textColorPlugin,
   highlightPlugin,
   citationPlugin,
@@ -4029,6 +4112,7 @@ export {
   DateChipNode,
   DropdownChipNode,
   FileChipNode,
+  FontFamilyExtension,
   FontSizeExtension,
   FootnoteNode,
   LocationChipNode,
@@ -4057,6 +4141,7 @@ export {
   commentPlugin,
   createPlaceholderPlugin,
   defaultPlugins,
+  fontFamilyPlugin,
   fontSizePlugin,
   footnotePlugin,
   formattingPlugin,
@@ -4079,6 +4164,7 @@ export {
   rejectAllSuggestions,
   rejectSuggestion,
   sanitizeCiteprocHtml,
+  scrollEditorToPos,
   setDocumentMode,
   setSuggestionAuthor,
   slashMenuPlugin,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kedataindo/docflow-plugins",
   "license": "Apache-2.0",
-  "version": "0.0.90",
+  "version": "0.0.92",
   "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.86"
+    "@kedataindo/docflow-core": "0.0.87"
   },
   "peerDependencies": {
     "@tiptap/core": "^2.11.0",