@kedataindo/docflow-plugins 0.0.103 → 0.0.105

package/dist/citations.cjs

@@ -36,6 +36,7 @@ __export(citations_exports, {
   DEFAULT_CSL_STYLE: () => DEFAULT_CSL_STYLE,
   buildCitationNodes: () => buildCitationNodes,
   nextCitationId: () => nextCitationId,
+  resolveCslStyles: () => resolveCslStyles,
   sanitizeCiteprocHtml: () => sanitizeCiteprocHtml
 });
 module.exports = __toCommonJS(citations_exports);
@@ -958,6 +959,19 @@ var DEFAULT_CSL_STYLE = "chicago-notes-bibliography";
 var CSL_LOCALE_EN_US = localesEnUS_default;
 
 // src/citeEngine.ts
+function resolveCslStyles(extra) {
+  const merged = { ...CSL_STYLES };
+  for (const style of extra ?? []) {
+    const id = typeof style?.id === "string" ? style.id.trim() : "";
+    if (!id || typeof style?.xml !== "string" || style.xml.trim() === "") {
+      throw new Error(
+        `resolveCslStyles: every style needs a non-empty id and CSL xml (got id=${JSON.stringify(style?.id)}, xml=${style?.xml === void 0 ? "undefined" : `${typeof style.xml === "string" ? style.xml.length : typeof style.xml} chars`})`
+      );
+    }
+    merged[id] = { ...style, id };
+  }
+  return merged;
+}
 var clusterSeq = 0;
 function nextCitationId() {
   clusterSeq += 1;
@@ -970,21 +984,28 @@ function sanitizeCiteprocHtml(html) {
 var CiteEngine = class {
   sources = /* @__PURE__ */ new Map();
   style;
+  /** Bundled styles + whatever the host injected (issue #180). */
+  styles;
   clusters = /* @__PURE__ */ new Map();
   order = [];
   rendered = /* @__PURE__ */ new Map();
   bibliography = [];
   listeners = /* @__PURE__ */ new Set();
   constructor(options = {}) {
-    this.style = options.style && CSL_STYLES[options.style] ? options.style : DEFAULT_CSL_STYLE;
+    this.styles = resolveCslStyles(options.styles);
+    this.style = options.style && this.styles[options.style] ? options.style : DEFAULT_CSL_STYLE;
     this.updateSources(options.sources ?? [], false);
   }
   getStyle() {
     return this.style;
   }
+  /** Every style this engine can render with, bundled + host-injected. */
+  getAvailableStyles() {
+    return Object.values(this.styles).sort((a, b) => a.id.localeCompare(b.id));
+  }
   /** 'note' styles (Chicago notes-bib) cite via footnotes; 'in-text' cite inline. */
   isNoteStyle() {
-    return CSL_STYLES[this.style]?.category === "note";
+    return this.styles[this.style]?.category === "note";
   }
   getSource(id) {
     return this.sources.get(id);
@@ -1001,7 +1022,7 @@ var CiteEngine = class {
   }
   /** Live style switch: reload the CSL, recompute everything, repaint (6A-7). */
   setStyle(styleId) {
-    if (!CSL_STYLES[styleId] || styleId === this.style) return;
+    if (!this.styles[styleId] || styleId === this.style) return;
     this.style = styleId;
     this.recompute();
     this.emitChange();
@@ -1054,7 +1075,7 @@ var CiteEngine = class {
    * any edit — the same derived-view pattern used for pagination/collab.
    */
   recompute() {
-    const styleInfo = CSL_STYLES[this.style];
+    const styleInfo = this.styles[this.style];
     const engine = new import_citeproc.default.Engine(
       {
         retrieveLocale: () => CSL_LOCALE_EN_US,
@@ -1134,5 +1155,6 @@ function buildCitationNodes(engine, attrs) {
   DEFAULT_CSL_STYLE,
   buildCitationNodes,
   nextCitationId,
+  resolveCslStyles,
   sanitizeCiteprocHtml
 });

package/dist/citations.d.cts

@@ -1,5 +1,18 @@
-import { CslItemData } from '@kedataindo/docflow-core';
+import { CslItemData, CslStyleInfo } from '@kedataindo/docflow-core';
+export { CslStyleInfo } from '@kedataindo/docflow-core';
 
+/**
+ * Merge the bundled styles with the ones a host injected (issue #180) — the
+ * single place that decides what this engine can render with.
+ *
+ * Bundled styles stay available unless the host overrides one by id, so a host
+ * that passes nothing (or an empty array) behaves exactly as before and nothing
+ * has to be fetched at runtime for the defaults to work offline.
+ *
+ * A malformed entry fails loudly here rather than inside citeproc, where the
+ * error would arrive as an empty citation with no clue which style caused it.
+ */
+declare function resolveCslStyles(extra?: CslStyleInfo[]): Record<string, CslStyleInfo>;
 type CitationMode = 'normal' | 'author-only' | 'suppress-author';
 /**
  * Structured citation attributes stored on citation/footnote nodes. Nodes
@@ -17,6 +30,14 @@ interface CitationAttrs {
 interface CiteEngineOptions {
     sources?: CslItemData[];
     style?: string;
+    /**
+     * Extra CSL styles for this engine (issue #180). A style whose `id` matches a
+     * bundled one **overrides** it; every other id is added alongside the four
+     * defaults. Omitting this keeps the previous behaviour exactly (offline
+     * bundled styles), and an unknown `style` id always falls back to
+     * `DEFAULT_CSL_STYLE` instead of throwing.
+     */
+    styles?: CslStyleInfo[];
 }
 interface CitationCluster {
     citationId: string;
@@ -39,6 +60,8 @@ declare function sanitizeCiteprocHtml(html: string): string;
 declare class CiteEngine {
     private sources;
     private style;
+    /** Bundled styles + whatever the host injected (issue #180). */
+    private styles;
     private clusters;
     private order;
     private rendered;
@@ -46,6 +69,8 @@ declare class CiteEngine {
     private listeners;
     constructor(options?: CiteEngineOptions);
     getStyle(): string;
+    /** Every style this engine can render with, bundled + host-injected. */
+    getAvailableStyles(): CslStyleInfo[];
     /** 'note' styles (Chicago notes-bib) cite via footnotes; 'in-text' cite inline. */
     isNoteStyle(): boolean;
     getSource(id: string): CslItemData | undefined;
@@ -112,22 +137,17 @@ declare function buildCitationNodes(engine: CiteEngine, attrs: {
     locator?: string;
 }): CitationNodeSpec;
 
-interface CslStyleInfo {
-    id: string;
-    name: string;
-    /** 'note' styles render citations as footnotes; 'in-text' render inline. */
-    category: 'note' | 'in-text';
-    xml: string;
-}
 /**
  * CSL styles bundled with the citation engine. Bundling (instead of runtime
  * fetch) keeps the editor standalone/offline-capable — the same guarantee the
- * embedded source snapshot provides (see phase-6 plan §2 decision 5).
+ * embedded source snapshot provides (see phase-6 plan §2 decision 5). These are
+ * the *default* set: a host can add or override styles through
+ * `CitationPort.styles` / `CiteEngineOptions.styles` (see `resolveCslStyles`).
  */
 declare const CSL_STYLES: Record<string, CslStyleInfo>;
 declare const DEFAULT_CSL_STYLE = "chicago-notes-bibliography";
 /** The single bundled locale. Multi-locale rendering is deferred (phase 6 §7). */
 declare const CSL_LOCALE_EN_US: string;
 
-export { CSL_LOCALE_EN_US, CSL_STYLES, CiteEngine, DEFAULT_CSL_STYLE, buildCitationNodes, nextCitationId, sanitizeCiteprocHtml };
-export type { CitationAttrs, CitationCluster, CitationMode, CiteEngineOptions, CslStyleInfo };
+export { CSL_LOCALE_EN_US, CSL_STYLES, CiteEngine, DEFAULT_CSL_STYLE, buildCitationNodes, nextCitationId, resolveCslStyles, sanitizeCiteprocHtml };
+export type { CitationAttrs, CitationCluster, CitationMode, CiteEngineOptions };

package/dist/citations.d.ts

@@ -1,5 +1,18 @@
-import { CslItemData } from '@kedataindo/docflow-core';
+import { CslItemData, CslStyleInfo } from '@kedataindo/docflow-core';
+export { CslStyleInfo } from '@kedataindo/docflow-core';
 
+/**
+ * Merge the bundled styles with the ones a host injected (issue #180) — the
+ * single place that decides what this engine can render with.
+ *
+ * Bundled styles stay available unless the host overrides one by id, so a host
+ * that passes nothing (or an empty array) behaves exactly as before and nothing
+ * has to be fetched at runtime for the defaults to work offline.
+ *
+ * A malformed entry fails loudly here rather than inside citeproc, where the
+ * error would arrive as an empty citation with no clue which style caused it.
+ */
+declare function resolveCslStyles(extra?: CslStyleInfo[]): Record<string, CslStyleInfo>;
 type CitationMode = 'normal' | 'author-only' | 'suppress-author';
 /**
  * Structured citation attributes stored on citation/footnote nodes. Nodes
@@ -17,6 +30,14 @@ interface CitationAttrs {
 interface CiteEngineOptions {
     sources?: CslItemData[];
     style?: string;
+    /**
+     * Extra CSL styles for this engine (issue #180). A style whose `id` matches a
+     * bundled one **overrides** it; every other id is added alongside the four
+     * defaults. Omitting this keeps the previous behaviour exactly (offline
+     * bundled styles), and an unknown `style` id always falls back to
+     * `DEFAULT_CSL_STYLE` instead of throwing.
+     */
+    styles?: CslStyleInfo[];
 }
 interface CitationCluster {
     citationId: string;
@@ -39,6 +60,8 @@ declare function sanitizeCiteprocHtml(html: string): string;
 declare class CiteEngine {
     private sources;
     private style;
+    /** Bundled styles + whatever the host injected (issue #180). */
+    private styles;
     private clusters;
     private order;
     private rendered;
@@ -46,6 +69,8 @@ declare class CiteEngine {
     private listeners;
     constructor(options?: CiteEngineOptions);
     getStyle(): string;
+    /** Every style this engine can render with, bundled + host-injected. */
+    getAvailableStyles(): CslStyleInfo[];
     /** 'note' styles (Chicago notes-bib) cite via footnotes; 'in-text' cite inline. */
     isNoteStyle(): boolean;
     getSource(id: string): CslItemData | undefined;
@@ -112,22 +137,17 @@ declare function buildCitationNodes(engine: CiteEngine, attrs: {
     locator?: string;
 }): CitationNodeSpec;
 
-interface CslStyleInfo {
-    id: string;
-    name: string;
-    /** 'note' styles render citations as footnotes; 'in-text' render inline. */
-    category: 'note' | 'in-text';
-    xml: string;
-}
 /**
  * CSL styles bundled with the citation engine. Bundling (instead of runtime
  * fetch) keeps the editor standalone/offline-capable — the same guarantee the
- * embedded source snapshot provides (see phase-6 plan §2 decision 5).
+ * embedded source snapshot provides (see phase-6 plan §2 decision 5). These are
+ * the *default* set: a host can add or override styles through
+ * `CitationPort.styles` / `CiteEngineOptions.styles` (see `resolveCslStyles`).
  */
 declare const CSL_STYLES: Record<string, CslStyleInfo>;
 declare const DEFAULT_CSL_STYLE = "chicago-notes-bibliography";
 /** The single bundled locale. Multi-locale rendering is deferred (phase 6 §7). */
 declare const CSL_LOCALE_EN_US: string;
 
-export { CSL_LOCALE_EN_US, CSL_STYLES, CiteEngine, DEFAULT_CSL_STYLE, buildCitationNodes, nextCitationId, sanitizeCiteprocHtml };
-export type { CitationAttrs, CitationCluster, CitationMode, CiteEngineOptions, CslStyleInfo };
+export { CSL_LOCALE_EN_US, CSL_STYLES, CiteEngine, DEFAULT_CSL_STYLE, buildCitationNodes, nextCitationId, resolveCslStyles, sanitizeCiteprocHtml };
+export type { CitationAttrs, CitationCluster, CitationMode, CiteEngineOptions };

package/dist/citations.js

@@ -916,6 +916,19 @@ var DEFAULT_CSL_STYLE = "chicago-notes-bibliography";
 var CSL_LOCALE_EN_US = localesEnUS_default;
 
 // src/citeEngine.ts
+function resolveCslStyles(extra) {
+  const merged = { ...CSL_STYLES };
+  for (const style of extra ?? []) {
+    const id = typeof style?.id === "string" ? style.id.trim() : "";
+    if (!id || typeof style?.xml !== "string" || style.xml.trim() === "") {
+      throw new Error(
+        `resolveCslStyles: every style needs a non-empty id and CSL xml (got id=${JSON.stringify(style?.id)}, xml=${style?.xml === void 0 ? "undefined" : `${typeof style.xml === "string" ? style.xml.length : typeof style.xml} chars`})`
+      );
+    }
+    merged[id] = { ...style, id };
+  }
+  return merged;
+}
 var clusterSeq = 0;
 function nextCitationId() {
   clusterSeq += 1;
@@ -928,21 +941,28 @@ function sanitizeCiteprocHtml(html) {
 var CiteEngine = class {
   sources = /* @__PURE__ */ new Map();
   style;
+  /** Bundled styles + whatever the host injected (issue #180). */
+  styles;
   clusters = /* @__PURE__ */ new Map();
   order = [];
   rendered = /* @__PURE__ */ new Map();
   bibliography = [];
   listeners = /* @__PURE__ */ new Set();
   constructor(options = {}) {
-    this.style = options.style && CSL_STYLES[options.style] ? options.style : DEFAULT_CSL_STYLE;
+    this.styles = resolveCslStyles(options.styles);
+    this.style = options.style && this.styles[options.style] ? options.style : DEFAULT_CSL_STYLE;
     this.updateSources(options.sources ?? [], false);
   }
   getStyle() {
     return this.style;
   }
+  /** Every style this engine can render with, bundled + host-injected. */
+  getAvailableStyles() {
+    return Object.values(this.styles).sort((a, b) => a.id.localeCompare(b.id));
+  }
   /** 'note' styles (Chicago notes-bib) cite via footnotes; 'in-text' cite inline. */
   isNoteStyle() {
-    return CSL_STYLES[this.style]?.category === "note";
+    return this.styles[this.style]?.category === "note";
   }
   getSource(id) {
     return this.sources.get(id);
@@ -959,7 +979,7 @@ var CiteEngine = class {
   }
   /** Live style switch: reload the CSL, recompute everything, repaint (6A-7). */
   setStyle(styleId) {
-    if (!CSL_STYLES[styleId] || styleId === this.style) return;
+    if (!this.styles[styleId] || styleId === this.style) return;
     this.style = styleId;
     this.recompute();
     this.emitChange();
@@ -1012,7 +1032,7 @@ var CiteEngine = class {
    * any edit — the same derived-view pattern used for pagination/collab.
    */
   recompute() {
-    const styleInfo = CSL_STYLES[this.style];
+    const styleInfo = this.styles[this.style];
     const engine = new CSL.Engine(
       {
         retrieveLocale: () => CSL_LOCALE_EN_US,
@@ -1091,5 +1111,6 @@ export {
   DEFAULT_CSL_STYLE,
   buildCitationNodes,
   nextCitationId,
+  resolveCslStyles,
   sanitizeCiteprocHtml
 };

package/dist/index.cjs

@@ -93,6 +93,7 @@ __export(index_exports, {
   registerSlashCommands: () => registerSlashCommands,
   rejectAllSuggestions: () => rejectAllSuggestions,
   rejectSuggestion: () => rejectSuggestion,
+  resolveCslStyles: () => resolveCslStyles,
   sanitizeCiteprocHtml: () => sanitizeCiteprocHtml,
   scrollEditorToPos: () => scrollEditorToPos,
   setDocumentMode: () => setDocumentMode,
@@ -110,10 +111,10 @@ module.exports = __toCommonJS(index_exports);
 
 // src/formatting.ts
 var import_docflow_core = require("@kedataindo/docflow-core");
-var import_extension_underline = __toESM(require("@tiptap/extension-underline"), 1);
+var import_extension_underline = require("@tiptap/extension-underline");
 var formattingPlugin = (0, import_docflow_core.definePlugin)({
   id: "formatting",
-  tiptapExtensions: [import_extension_underline.default],
+  tiptapExtensions: [import_extension_underline.Underline],
   toolbar: [
     { id: "bold", label: "Bold", action: "toggleBold", iconComponent: "Bold" },
     { id: "italic", label: "Italic", action: "toggleItalic", iconComponent: "Italic" },
@@ -157,11 +158,10 @@ var headingsPlugin = (0, import_docflow_core2.definePlugin)({
 
 // src/lists.ts
 var import_docflow_core3 = require("@kedataindo/docflow-core");
-var import_extension_task_list = __toESM(require("@tiptap/extension-task-list"), 1);
-var import_extension_task_item = __toESM(require("@tiptap/extension-task-item"), 1);
+var import_extension_list = require("@tiptap/extension-list");
 var listsPlugin = (0, import_docflow_core3.definePlugin)({
   id: "lists",
-  tiptapExtensions: [import_extension_task_list.default, import_extension_task_item.default.configure({ nested: true })],
+  tiptapExtensions: [import_extension_list.TaskList, import_extension_list.TaskItem.configure({ nested: true })],
   toolbar: [
     { id: "bullet-list", label: "Bullet List", action: "toggleBulletList", iconComponent: "List" },
     { id: "ordered-list", label: "Ordered List", action: "toggleOrderedList", iconComponent: "ListOrdered" },
@@ -176,14 +176,14 @@ var listsPlugin = (0, import_docflow_core3.definePlugin)({
 
 // src/alignment.ts
 var import_docflow_core4 = require("@kedataindo/docflow-core");
-var import_extension_text_align = __toESM(require("@tiptap/extension-text-align"), 1);
+var import_extension_text_align = require("@tiptap/extension-text-align");
 function setAlign(alignment) {
   return (editor) => editor.commands.setTextAlign(alignment);
 }
 var alignmentPlugin = (0, import_docflow_core4.definePlugin)({
   id: "alignment",
   tiptapExtensions: [
-    import_extension_text_align.default.configure({ types: ["heading", "paragraph"] })
+    import_extension_text_align.TextAlign.configure({ types: ["heading", "paragraph"] })
   ],
   toolbar: [
     { id: "align-left", label: "Align Left", action: "alignLeft", iconComponent: "AlignLeft" },
@@ -201,10 +201,10 @@ var alignmentPlugin = (0, import_docflow_core4.definePlugin)({
 
 // src/link.ts
 var import_docflow_core5 = require("@kedataindo/docflow-core");
-var import_extension_link = __toESM(require("@tiptap/extension-link"), 1);
+var import_extension_link = require("@tiptap/extension-link");
 var linkPlugin = (0, import_docflow_core5.definePlugin)({
   id: "link",
-  tiptapExtensions: [import_extension_link.default.configure({ openOnClick: true })],
+  tiptapExtensions: [import_extension_link.Link.configure({ openOnClick: true })],
   toolbar: [
     { id: "set-link", label: "Link", action: "setLink", iconComponent: "Link" }
   ],
@@ -226,7 +226,7 @@ var linkPlugin = (0, import_docflow_core5.definePlugin)({
 
 // src/image.ts
 var import_docflow_core6 = require("@kedataindo/docflow-core");
-var import_extension_image = __toESM(require("@tiptap/extension-image"), 1);
+var import_extension_image = require("@tiptap/extension-image");
 function pickImageFile() {
   if (typeof document === "undefined") return Promise.resolve(null);
   return new Promise((resolve) => {
@@ -249,7 +249,7 @@ function pickImageFile() {
 }
 var imagePlugin = (0, import_docflow_core6.definePlugin)({
   id: "image",
-  tiptapExtensions: [import_extension_image.default],
+  tiptapExtensions: [import_extension_image.Image],
   toolbar: [{ id: "insert-image", label: "Image", action: "insertImage", iconComponent: "Image" }],
   slashCommands: [{ name: "Image", command: "insertImage" }],
   commands: {
@@ -287,12 +287,9 @@ var imagePlugin = (0, import_docflow_core6.definePlugin)({
 // src/table.ts
 var import_docflow_core7 = require("@kedataindo/docflow-core");
 var import_core = require("@tiptap/core");
-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_extension_table = require("@tiptap/extension-table");
 var import_state = require("@tiptap/pm/state");
-var CustomTable = import_extension_table.default.extend({
+var CustomTable = import_extension_table.Table.extend({
   addAttributes() {
     return {
       ...this.parent?.(),
@@ -388,7 +385,7 @@ var CustomTable = import_extension_table.default.extend({
     ];
   }
 });
-var CustomTableCell = import_extension_table_cell.default.extend({
+var CustomTableCell = import_extension_table.TableCell.extend({
   addAttributes() {
     return {
       ...this.parent?.(),
@@ -422,7 +419,7 @@ var CustomTableCell = import_extension_table_cell.default.extend({
     };
   }
 });
-var CustomTableHeader = import_extension_table_header.default.extend({
+var CustomTableHeader = import_extension_table.TableHeader.extend({
   addAttributes() {
     return {
       ...this.parent?.(),
@@ -459,8 +456,14 @@ var CustomTableHeader = import_extension_table_header.default.extend({
 var tablePlugin = (0, import_docflow_core7.definePlugin)({
   id: "table",
   tiptapExtensions: [
-    CustomTable.configure({ resizable: false }),
-    import_extension_table_row.default,
+    // v3 ships a `TableView` node view by default (`View: TableView`), which rebuilds
+    // the <table> element itself and drops whatever our `renderHTML` put on it —
+    // `data-tps-splittable`/`data-colwidth` disappear and the inline `!important`
+    // width is rewritten. Column resizing in docflow is handled by
+    // `ManualColumnResize`, so the node view buys nothing here; `View: null` makes
+    // v3 fall back to our `renderHTML` and keeps the rendered DOM identical to v2.
+    CustomTable.configure({ resizable: false, View: null }),
+    import_extension_table.TableRow,
     CustomTableCell,
     CustomTableHeader
   ],
@@ -488,12 +491,12 @@ var codeBlockPlugin = (0, import_docflow_core9.definePlugin)({
 
 // src/placeholder.ts
 var import_docflow_core10 = require("@kedataindo/docflow-core");
-var import_extension_placeholder = __toESM(require("@tiptap/extension-placeholder"), 1);
+var import_extensions = require("@tiptap/extensions");
 function createPlaceholderPlugin(options = {}) {
   return (0, import_docflow_core10.definePlugin)({
     id: "placeholder",
     tiptapExtensions: [
-      import_extension_placeholder.default.configure({
+      import_extensions.Placeholder.configure({
         placeholder: options.placeholder ?? "Start writing\u2026"
       })
     ]
@@ -974,10 +977,10 @@ var fontFamilyPlugin = (0, import_docflow_core15.definePlugin)({
 
 // src/textColor.ts
 var import_docflow_core16 = require("@kedataindo/docflow-core");
-var import_extension_color = __toESM(require("@tiptap/extension-color"), 1);
+var import_extension_color = require("@tiptap/extension-color");
 var textColorPlugin = (0, import_docflow_core16.definePlugin)({
   id: "text-color",
-  tiptapExtensions: [import_extension_color.default],
+  tiptapExtensions: [import_extension_color.Color],
   toolbar: [
     { id: "text-color", label: "Text Color", action: "setTextColor", iconComponent: "Palette" }
   ],
@@ -995,9 +998,9 @@ var textColorPlugin = (0, import_docflow_core16.definePlugin)({
 
 // src/highlight.ts
 var import_docflow_core17 = require("@kedataindo/docflow-core");
-var import_extension_highlight = __toESM(require("@tiptap/extension-highlight"), 1);
+var import_extension_highlight = require("@tiptap/extension-highlight");
 var import_core5 = require("@tiptap/core");
-var GoogleDocsHighlight = import_extension_highlight.default.extend({
+var GoogleDocsHighlight = import_extension_highlight.Highlight.extend({
   parseHTML() {
     return [
       // Standard <mark> tag (default TipTap behavior)
@@ -1970,6 +1973,19 @@ var DEFAULT_CSL_STYLE = "chicago-notes-bibliography";
 var CSL_LOCALE_EN_US = localesEnUS_default;
 
 // src/citeEngine.ts
+function resolveCslStyles(extra) {
+  const merged = { ...CSL_STYLES };
+  for (const style of extra ?? []) {
+    const id = typeof style?.id === "string" ? style.id.trim() : "";
+    if (!id || typeof style?.xml !== "string" || style.xml.trim() === "") {
+      throw new Error(
+        `resolveCslStyles: every style needs a non-empty id and CSL xml (got id=${JSON.stringify(style?.id)}, xml=${style?.xml === void 0 ? "undefined" : `${typeof style.xml === "string" ? style.xml.length : typeof style.xml} chars`})`
+      );
+    }
+    merged[id] = { ...style, id };
+  }
+  return merged;
+}
 var clusterSeq = 0;
 function nextCitationId() {
   clusterSeq += 1;
@@ -1982,21 +1998,28 @@ function sanitizeCiteprocHtml(html) {
 var CiteEngine = class {
   sources = /* @__PURE__ */ new Map();
   style;
+  /** Bundled styles + whatever the host injected (issue #180). */
+  styles;
   clusters = /* @__PURE__ */ new Map();
   order = [];
   rendered = /* @__PURE__ */ new Map();
   bibliography = [];
   listeners = /* @__PURE__ */ new Set();
   constructor(options = {}) {
-    this.style = options.style && CSL_STYLES[options.style] ? options.style : DEFAULT_CSL_STYLE;
+    this.styles = resolveCslStyles(options.styles);
+    this.style = options.style && this.styles[options.style] ? options.style : DEFAULT_CSL_STYLE;
     this.updateSources(options.sources ?? [], false);
   }
   getStyle() {
     return this.style;
   }
+  /** Every style this engine can render with, bundled + host-injected. */
+  getAvailableStyles() {
+    return Object.values(this.styles).sort((a, b) => a.id.localeCompare(b.id));
+  }
   /** 'note' styles (Chicago notes-bib) cite via footnotes; 'in-text' cite inline. */
   isNoteStyle() {
-    return CSL_STYLES[this.style]?.category === "note";
+    return this.styles[this.style]?.category === "note";
   }
   getSource(id) {
     return this.sources.get(id);
@@ -2013,7 +2036,7 @@ var CiteEngine = class {
   }
   /** Live style switch: reload the CSL, recompute everything, repaint (6A-7). */
   setStyle(styleId) {
-    if (!CSL_STYLES[styleId] || styleId === this.style) return;
+    if (!this.styles[styleId] || styleId === this.style) return;
     this.style = styleId;
     this.recompute();
     this.emitChange();
@@ -2066,7 +2089,7 @@ var CiteEngine = class {
    * any edit — the same derived-view pattern used for pagination/collab.
    */
   recompute() {
-    const styleInfo = CSL_STYLES[this.style];
+    const styleInfo = this.styles[this.style];
     const engine = new import_citeproc.default.Engine(
       {
         retrieveLocale: () => CSL_LOCALE_EN_US,
@@ -2254,7 +2277,6 @@ var CitationEngineExtension = import_core7.Extension.create({
           tr.setNodeMarkup(pos, void 0, { ...attrs, citationId: nextCitationId() });
         }
         editor.view.dispatch(tr);
-        return;
       }
     }
     const ordered = [];
@@ -2461,7 +2483,7 @@ var citationPlugin = (0, import_docflow_core18.definePlugin)({
       const citation = port?.citation;
       if (!citation) return;
       const sources = typeof citation.sources === "function" ? citation.sources() : citation.sources;
-      const engine = new CiteEngine({ sources, style: citation.style });
+      const engine = new CiteEngine({ sources, style: citation.style, styles: citation.styles });
       editor.storage.citationEngine.engine = engine;
     },
     onDestroy(editor) {
@@ -3398,7 +3420,7 @@ var DateChipNode = import_core12.Node.create({
   addNodeView() {
     return (props) => {
       let currentNode = props.node;
-      const getPos = props.getPos;
+      const getPos = () => typeof props.getPos === "function" ? props.getPos() : void 0;
       const view = props.view;
       const dom = document.createElement("span");
       dom.className = "docs-chip docs-chip--date";
@@ -3606,7 +3628,7 @@ var DropdownChipNode = import_core12.Node.create({
   addNodeView() {
     return (props) => {
       let currentNode = props.node;
-      const getPos = props.getPos;
+      const getPos = () => typeof props.getPos === "function" ? props.getPos() : void 0;
       const view = props.view;
       const dom = document.createElement("span");
       dom.className = "docs-chip docs-chip--dropdown";
@@ -4266,6 +4288,7 @@ var defaultPlugins = [
   registerSlashCommands,
   rejectAllSuggestions,
   rejectSuggestion,
+  resolveCslStyles,
   sanitizeCiteprocHtml,
   scrollEditorToPos,
   setDocumentMode,

package/dist/index.d.cts

@@ -1,9 +1,9 @@
 import * as _kedata_indonesia_docflow_core from '@kedataindo/docflow-core';
 import { AIAction, DocsEditorPlugin, DocumentMode } from '@kedataindo/docflow-core';
-export { DocsEditorPlugin, FontFamilyExtension, FontSizeExtension, SlashCommand, ToolbarItem } from '@kedataindo/docflow-core';
+export { CslStyleInfo, 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';
+export { CSL_LOCALE_EN_US, CSL_STYLES, CitationAttrs, CitationCluster, CitationMode, CiteEngineOptions, DEFAULT_CSL_STYLE, buildCitationNodes, nextCitationId, resolveCslStyles, sanitizeCiteprocHtml } from './citations.cjs';
 import { PluginKey } from '@tiptap/pm/state';
 import { Fragment } from '@tiptap/pm/model';
 import { EditorView } from '@tiptap/pm/view';

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as _kedata_indonesia_docflow_core from '@kedataindo/docflow-core';
 import { AIAction, DocsEditorPlugin, DocumentMode } from '@kedataindo/docflow-core';
-export { DocsEditorPlugin, FontFamilyExtension, FontSizeExtension, SlashCommand, ToolbarItem } from '@kedataindo/docflow-core';
+export { CslStyleInfo, 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';
+export { CSL_LOCALE_EN_US, CSL_STYLES, CitationAttrs, CitationCluster, CitationMode, CiteEngineOptions, DEFAULT_CSL_STYLE, buildCitationNodes, nextCitationId, resolveCslStyles, sanitizeCiteprocHtml } from './citations.js';
 import { PluginKey } from '@tiptap/pm/state';
 import { Fragment } from '@tiptap/pm/model';
 import { EditorView } from '@tiptap/pm/view';

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/formatting.ts
 import { definePlugin } from "@kedataindo/docflow-core";
-import Underline from "@tiptap/extension-underline";
+import { Underline } from "@tiptap/extension-underline";
 var formattingPlugin = definePlugin({
   id: "formatting",
   tiptapExtensions: [Underline],
@@ -47,8 +47,7 @@ var headingsPlugin = definePlugin2({
 
 // src/lists.ts
 import { definePlugin as definePlugin3 } from "@kedataindo/docflow-core";
-import TaskList from "@tiptap/extension-task-list";
-import TaskItem from "@tiptap/extension-task-item";
+import { TaskItem, TaskList } from "@tiptap/extension-list";
 var listsPlugin = definePlugin3({
   id: "lists",
   tiptapExtensions: [TaskList, TaskItem.configure({ nested: true })],
@@ -66,7 +65,7 @@ var listsPlugin = definePlugin3({
 
 // src/alignment.ts
 import { definePlugin as definePlugin4 } from "@kedataindo/docflow-core";
-import TextAlign from "@tiptap/extension-text-align";
+import { TextAlign } from "@tiptap/extension-text-align";
 function setAlign(alignment) {
   return (editor) => editor.commands.setTextAlign(alignment);
 }
@@ -91,7 +90,7 @@ var alignmentPlugin = definePlugin4({
 
 // src/link.ts
 import { definePlugin as definePlugin5 } from "@kedataindo/docflow-core";
-import Link from "@tiptap/extension-link";
+import { Link } from "@tiptap/extension-link";
 var linkPlugin = definePlugin5({
   id: "link",
   tiptapExtensions: [Link.configure({ openOnClick: true })],
@@ -116,7 +115,7 @@ var linkPlugin = definePlugin5({
 
 // src/image.ts
 import { definePlugin as definePlugin6 } from "@kedataindo/docflow-core";
-import Image from "@tiptap/extension-image";
+import { Image } from "@tiptap/extension-image";
 function pickImageFile() {
   if (typeof document === "undefined") return Promise.resolve(null);
   return new Promise((resolve) => {
@@ -177,10 +176,7 @@ var imagePlugin = definePlugin6({
 // src/table.ts
 import { definePlugin as definePlugin7 } from "@kedataindo/docflow-core";
 import { mergeAttributes } from "@tiptap/core";
-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 { Table, TableCell, TableHeader, TableRow } from "@tiptap/extension-table";
 import { Plugin, TextSelection } from "@tiptap/pm/state";
 var CustomTable = Table.extend({
   addAttributes() {
@@ -349,7 +345,13 @@ var CustomTableHeader = TableHeader.extend({
 var tablePlugin = definePlugin7({
   id: "table",
   tiptapExtensions: [
-    CustomTable.configure({ resizable: false }),
+    // v3 ships a `TableView` node view by default (`View: TableView`), which rebuilds
+    // the <table> element itself and drops whatever our `renderHTML` put on it —
+    // `data-tps-splittable`/`data-colwidth` disappear and the inline `!important`
+    // width is rewritten. Column resizing in docflow is handled by
+    // `ManualColumnResize`, so the node view buys nothing here; `View: null` makes
+    // v3 fall back to our `renderHTML` and keeps the rendered DOM identical to v2.
+    CustomTable.configure({ resizable: false, View: null }),
     TableRow,
     CustomTableCell,
     CustomTableHeader
@@ -378,7 +380,7 @@ var codeBlockPlugin = definePlugin9({
 
 // src/placeholder.ts
 import { definePlugin as definePlugin10 } from "@kedataindo/docflow-core";
-import Placeholder from "@tiptap/extension-placeholder";
+import { Placeholder } from "@tiptap/extensions";
 function createPlaceholderPlugin(options = {}) {
   return definePlugin10({
     id: "placeholder",
@@ -864,7 +866,7 @@ var fontFamilyPlugin = definePlugin15({
 
 // src/textColor.ts
 import { definePlugin as definePlugin16 } from "@kedataindo/docflow-core";
-import Color from "@tiptap/extension-color";
+import { Color } from "@tiptap/extension-color";
 var textColorPlugin = definePlugin16({
   id: "text-color",
   tiptapExtensions: [Color],
@@ -885,7 +887,7 @@ var textColorPlugin = definePlugin16({
 
 // src/highlight.ts
 import { definePlugin as definePlugin17 } from "@kedataindo/docflow-core";
-import Highlight from "@tiptap/extension-highlight";
+import { Highlight } from "@tiptap/extension-highlight";
 import { mergeAttributes as mergeAttributes5 } from "@tiptap/core";
 var GoogleDocsHighlight = Highlight.extend({
   parseHTML() {
@@ -1860,6 +1862,19 @@ var DEFAULT_CSL_STYLE = "chicago-notes-bibliography";
 var CSL_LOCALE_EN_US = localesEnUS_default;
 
 // src/citeEngine.ts
+function resolveCslStyles(extra) {
+  const merged = { ...CSL_STYLES };
+  for (const style of extra ?? []) {
+    const id = typeof style?.id === "string" ? style.id.trim() : "";
+    if (!id || typeof style?.xml !== "string" || style.xml.trim() === "") {
+      throw new Error(
+        `resolveCslStyles: every style needs a non-empty id and CSL xml (got id=${JSON.stringify(style?.id)}, xml=${style?.xml === void 0 ? "undefined" : `${typeof style.xml === "string" ? style.xml.length : typeof style.xml} chars`})`
+      );
+    }
+    merged[id] = { ...style, id };
+  }
+  return merged;
+}
 var clusterSeq = 0;
 function nextCitationId() {
   clusterSeq += 1;
@@ -1872,21 +1887,28 @@ function sanitizeCiteprocHtml(html) {
 var CiteEngine = class {
   sources = /* @__PURE__ */ new Map();
   style;
+  /** Bundled styles + whatever the host injected (issue #180). */
+  styles;
   clusters = /* @__PURE__ */ new Map();
   order = [];
   rendered = /* @__PURE__ */ new Map();
   bibliography = [];
   listeners = /* @__PURE__ */ new Set();
   constructor(options = {}) {
-    this.style = options.style && CSL_STYLES[options.style] ? options.style : DEFAULT_CSL_STYLE;
+    this.styles = resolveCslStyles(options.styles);
+    this.style = options.style && this.styles[options.style] ? options.style : DEFAULT_CSL_STYLE;
     this.updateSources(options.sources ?? [], false);
   }
   getStyle() {
     return this.style;
   }
+  /** Every style this engine can render with, bundled + host-injected. */
+  getAvailableStyles() {
+    return Object.values(this.styles).sort((a, b) => a.id.localeCompare(b.id));
+  }
   /** 'note' styles (Chicago notes-bib) cite via footnotes; 'in-text' cite inline. */
   isNoteStyle() {
-    return CSL_STYLES[this.style]?.category === "note";
+    return this.styles[this.style]?.category === "note";
   }
   getSource(id) {
     return this.sources.get(id);
@@ -1903,7 +1925,7 @@ var CiteEngine = class {
   }
   /** Live style switch: reload the CSL, recompute everything, repaint (6A-7). */
   setStyle(styleId) {
-    if (!CSL_STYLES[styleId] || styleId === this.style) return;
+    if (!this.styles[styleId] || styleId === this.style) return;
     this.style = styleId;
     this.recompute();
     this.emitChange();
@@ -1956,7 +1978,7 @@ var CiteEngine = class {
    * any edit — the same derived-view pattern used for pagination/collab.
    */
   recompute() {
-    const styleInfo = CSL_STYLES[this.style];
+    const styleInfo = this.styles[this.style];
     const engine = new CSL.Engine(
       {
         retrieveLocale: () => CSL_LOCALE_EN_US,
@@ -2144,7 +2166,6 @@ var CitationEngineExtension = Extension2.create({
           tr.setNodeMarkup(pos, void 0, { ...attrs, citationId: nextCitationId() });
         }
         editor.view.dispatch(tr);
-        return;
       }
     }
     const ordered = [];
@@ -2351,7 +2372,7 @@ var citationPlugin = definePlugin18({
       const citation = port?.citation;
       if (!citation) return;
       const sources = typeof citation.sources === "function" ? citation.sources() : citation.sources;
-      const engine = new CiteEngine({ sources, style: citation.style });
+      const engine = new CiteEngine({ sources, style: citation.style, styles: citation.styles });
       editor.storage.citationEngine.engine = engine;
     },
     onDestroy(editor) {
@@ -3288,7 +3309,7 @@ var DateChipNode = Node7.create({
   addNodeView() {
     return (props) => {
       let currentNode = props.node;
-      const getPos = props.getPos;
+      const getPos = () => typeof props.getPos === "function" ? props.getPos() : void 0;
       const view = props.view;
       const dom = document.createElement("span");
       dom.className = "docs-chip docs-chip--date";
@@ -3496,7 +3517,7 @@ var DropdownChipNode = Node7.create({
   addNodeView() {
     return (props) => {
       let currentNode = props.node;
-      const getPos = props.getPos;
+      const getPos = () => typeof props.getPos === "function" ? props.getPos() : void 0;
       const view = props.view;
       const dom = document.createElement("span");
       dom.className = "docs-chip docs-chip--dropdown";
@@ -4155,6 +4176,7 @@ export {
   registerSlashCommands,
   rejectAllSuggestions,
   rejectSuggestion,
+  resolveCslStyles,
   sanitizeCiteprocHtml,
   scrollEditorToPos,
   setDocumentMode,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kedataindo/docflow-plugins",
   "license": "Apache-2.0",
-  "version": "0.0.103",
+  "version": "0.0.105",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -27,29 +27,31 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@tiptap/extension-color": "^2.27.3",
-    "@tiptap/extension-highlight": "^2.27.3",
-    "@tiptap/pm": "^2.27.3",
+    "@tiptap/extension-color": "^3.32.0",
+    "@tiptap/extension-highlight": "^3.32.0",
+    "@tiptap/extension-list": "^3.32.0",
+    "@tiptap/extensions": "^3.32.0",
+    "@tiptap/pm": "^3.32.0",
     "citeproc": "^2.4.63",
-    "tiptap-markdown": "0.8.10",
-    "@kedataindo/docflow-core": "0.0.96"
+    "tiptap-markdown": "0.9.0",
+    "@kedataindo/docflow-core": "0.0.98"
   },
   "peerDependencies": {
-    "@tiptap/core": "^2.11.0",
-    "@tiptap/extension-color": "^2.11.0",
-    "@tiptap/extension-highlight": "^2.11.0",
-    "@tiptap/extension-image": "^2.11.0",
-    "@tiptap/extension-link": "^2.11.0",
-    "@tiptap/extension-placeholder": "^2.11.0",
-    "@tiptap/extension-strike": "^2.11.0",
-    "@tiptap/extension-table": "^2.11.0",
-    "@tiptap/extension-table-cell": "^2.11.0",
-    "@tiptap/extension-table-header": "^2.11.0",
-    "@tiptap/extension-table-row": "^2.11.0",
-    "@tiptap/extension-task-item": "^2.11.0",
-    "@tiptap/extension-task-list": "^2.11.0",
-    "@tiptap/extension-text-align": "^2.11.0",
-    "@tiptap/extension-underline": "^2.11.0"
+    "@tiptap/core": "^3.32.0",
+    "@tiptap/extension-color": "^3.32.0",
+    "@tiptap/extension-highlight": "^3.32.0",
+    "@tiptap/extension-image": "^3.32.0",
+    "@tiptap/extension-link": "^3.32.0",
+    "@tiptap/extension-placeholder": "^3.32.0",
+    "@tiptap/extension-strike": "^3.32.0",
+    "@tiptap/extension-table": "^3.32.0",
+    "@tiptap/extension-table-cell": "^3.32.0",
+    "@tiptap/extension-table-header": "^3.32.0",
+    "@tiptap/extension-table-row": "^3.32.0",
+    "@tiptap/extension-task-item": "^3.32.0",
+    "@tiptap/extension-task-list": "^3.32.0",
+    "@tiptap/extension-text-align": "^3.32.0",
+    "@tiptap/extension-underline": "^3.32.0"
   },
   "peerDependenciesMeta": {
     "@tiptap/extension-image": {