@kedataindo/docflow-plugins 0.0.32 → 0.0.34

package/dist/index.cjs

@@ -70,8 +70,10 @@ __export(index_exports, {
   headingsPlugin: () => headingsPlugin,
   highlightPlugin: () => highlightPlugin,
   imagePlugin: () => imagePlugin,
+  insertMarkdownBlock: () => insertMarkdownBlock,
   linkPlugin: () => linkPlugin,
   listsPlugin: () => listsPlugin,
+  markdownToFragment: () => markdownToFragment,
   nextCitationId: () => nextCitationId,
   onSlashStateChange: () => onSlashStateChange,
   pageBreakPlugin: () => pageBreakPlugin,
@@ -2332,11 +2334,95 @@ var citationPlugin = (0, import_docflow_core17.definePlugin)({
 });
 
 // src/ai.ts
-var import_core8 = require("@tiptap/core");
-var import_state = require("@tiptap/pm/state");
+var import_core9 = require("@tiptap/core");
+var import_state2 = 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 aiPluginKey = new import_state.PluginKey("docflow-ai");
+
+// 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_transform = require("@tiptap/pm/transform");
+function mdParser(editor) {
+  const storage = editor.storage.markdown;
+  if (!storage || typeof storage !== "object") return void 0;
+  const parser = storage.parser;
+  if (!parser || typeof parser !== "object" || !("parse" in parser)) return void 0;
+  return parser;
+}
+function markdownToFragment(editor, markdown, opts) {
+  const parser = mdParser(editor);
+  if (!parser) return null;
+  let html;
+  try {
+    html = parser.parse(markdown, { inline: opts.inline });
+  } catch {
+    return null;
+  }
+  if (typeof html !== "string") return null;
+  const content = (0, import_core8.createNodeFromContent)(html, editor.schema, {
+    slice: true,
+    parseOptions: { preserveWhitespace: "full" }
+  });
+  if (content instanceof import_model.Fragment) return content;
+  return import_model.Fragment.from(content);
+}
+function selectionToInsertionEnd(tr, startLen, bias) {
+  const last = tr.steps.length - 1;
+  if (last < startLen) return;
+  const step = tr.steps[last];
+  if (!(step instanceof import_transform.ReplaceStep || step instanceof import_transform.ReplaceAroundStep)) return;
+  const map = tr.mapping.maps[last];
+  let end = 0;
+  map.forEach((_from, _to, _newFrom, newTo) => {
+    if (end === 0) end = newTo;
+  });
+  tr.setSelection(import_state.Selection.near(tr.doc.resolve(end), bias));
+}
+function insertMarkdownBlock(editor, view, from, to, markdown) {
+  const fragment = markdownToFragment(editor, markdown, { inline: false });
+  if (!fragment) {
+    view.dispatch(view.state.tr.insertText(markdown, from, to));
+    return;
+  }
+  const tr = view.state.tr;
+  let f = from;
+  let t = to;
+  if (f === t) {
+    let onlyBlock = true;
+    fragment.forEach((n) => {
+      if (!n.isBlock) onlyBlock = false;
+    });
+    if (onlyBlock) {
+      const $pos = tr.doc.resolve(f);
+      const parent = $pos.parent;
+      if (parent.isTextblock && !parent.type.spec.code && !parent.childCount) {
+        f -= 1;
+        t += 1;
+      }
+    }
+  }
+  let onlyText = true;
+  fragment.forEach((n) => {
+    if (!n.isText || n.marks.length > 0) onlyText = false;
+  });
+  if (onlyText) {
+    let text = "";
+    fragment.forEach((n) => {
+      if (n.isText) text += n.text ?? "";
+    });
+    tr.insertText(text, f, t);
+  } else {
+    tr.replaceWith(f, t, fragment);
+  }
+  selectionToInsertionEnd(tr, 0, -1);
+  view.dispatch(tr);
+}
+
+// src/ai.ts
+var aiPluginKey = new import_state2.PluginKey("docflow-ai");
 var CONTEXT_CHARS = 1500;
 function getAIPreview(editor) {
   return editor.storage.ai ? editor.storage.ai.preview ?? null : null;
@@ -2377,7 +2463,7 @@ function stopStream(editor) {
   storage.abort?.abort();
   storage.abort = null;
 }
-var AIExtension = import_core8.Extension.create({
+var AIExtension = import_core9.Extension.create({
   name: "ai",
   addStorage() {
     return {
@@ -2473,7 +2559,12 @@ var AIExtension = import_core8.Extension.create({
         if (!dispatch) return true;
         const tr = state.tr;
         if (preview.text.trim()) {
-          tr.replaceWith(preview.from, preview.to, state.schema.text(preview.text));
+          const fragment = markdownToFragment(editor, preview.text, { inline: true });
+          if (fragment) {
+            tr.replaceWith(preview.from, preview.to, fragment);
+          } else {
+            tr.replaceWith(preview.from, preview.to, state.schema.text(preview.text));
+          }
         }
         tr.setMeta(aiPluginKey, { type: "clear" });
         dispatch(tr);
@@ -2567,7 +2658,7 @@ var AIExtension = import_core8.Extension.create({
       };
     }
     return [
-      new import_state.Plugin({
+      new import_state2.Plugin({
         key: aiPluginKey,
         state: {
           init: () => null,
@@ -2685,13 +2776,21 @@ var AIExtension = import_core8.Extension.create({
 });
 var aiPlugin = (0, import_docflow_core18.definePlugin)({
   id: "ai",
-  tiptapExtensions: [AIExtension],
+  // The `tiptap-markdown` `Markdown` extension is registered alongside AI so
+  // that `editor.storage.markdown.parser` is available on every editor that
+  // can stream AI content. It adds a schema-aware markdown↔HTML bridge
+  // (markdown-it under the hood) used by the AI Insert/accept paths to turn
+  // streamed `| col | col |` tables / `# headings` / `**bold**` into real
+  // nodes instead of literal pipe/asterisk text. Its `insertContentAt` /
+  // `setContent` command overrides are intentionally NOT used by the AI
+  // paths (they force `inline:true`); see `markdownInsert.ts`.
+  tiptapExtensions: [AIExtension, import_tiptap_markdown.Markdown.configure({ html: true, linkify: true, breaks: false })],
   slashCommands: [{ name: "AI", description: "Generate text with AI", command: "aiGenerate" }]
 });
 
 // src/comment.ts
-var import_core9 = require("@tiptap/core");
-var CommentMark = import_core9.Mark.create({
+var import_core10 = require("@tiptap/core");
+var CommentMark = import_core10.Mark.create({
   name: "comment",
   // Comments are inclusive (typing inside an existing comment extends
   // the mark range — that's the typical inline-comment UX). Excluding
@@ -2730,7 +2829,7 @@ var commentPlugin = {
 };
 
 // src/smartElements.ts
-var import_core10 = require("@tiptap/core");
+var import_core11 = require("@tiptap/core");
 var import_docflow_core19 = require("@kedataindo/docflow-core");
 function todayISO() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
@@ -2748,7 +2847,7 @@ var DEFAULT_STATUSES = ["To Do", "In Progress", "Review", "Approved"];
 function slugify(s) {
   return s.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
 }
-var DateChipNode = import_core10.Node.create({
+var DateChipNode = import_core11.Node.create({
   name: "dateChip",
   group: "inline",
   inline: true,
@@ -2768,7 +2867,7 @@ var DateChipNode = import_core10.Node.create({
     return [{ tag: 'span[data-node-type="date-chip"]' }];
   },
   renderHTML({ node, HTMLAttributes }) {
-    return ["span", (0, import_core10.mergeAttributes)(HTMLAttributes, {
+    return ["span", (0, import_core11.mergeAttributes)(HTMLAttributes, {
       "data-node-type": "date-chip",
       class: "docs-chip docs-chip--date"
     }), formatDate(node.attrs.date)];
@@ -2821,7 +2920,7 @@ var DateChipNode = import_core10.Node.create({
     };
   }
 });
-var PeopleChipNode = import_core10.Node.create({
+var PeopleChipNode = import_core11.Node.create({
   name: "peopleChip",
   group: "inline",
   inline: true,
@@ -2846,7 +2945,7 @@ var PeopleChipNode = import_core10.Node.create({
     return [{ tag: 'span[data-node-type="people-chip"]' }];
   },
   renderHTML({ node, HTMLAttributes }) {
-    return ["span", (0, import_core10.mergeAttributes)(HTMLAttributes, {
+    return ["span", (0, import_core11.mergeAttributes)(HTMLAttributes, {
       "data-node-type": "people-chip",
       class: "docs-chip docs-chip--people"
     }), `@${node.attrs.name || "user"}`];
@@ -2883,7 +2982,7 @@ var PeopleChipNode = import_core10.Node.create({
     };
   }
 });
-var FileChipNode = import_core10.Node.create({
+var FileChipNode = import_core11.Node.create({
   name: "fileChip",
   group: "inline",
   inline: true,
@@ -2908,7 +3007,7 @@ var FileChipNode = import_core10.Node.create({
     return [{ tag: 'span[data-node-type="file-chip"]' }];
   },
   renderHTML({ node, HTMLAttributes }) {
-    return ["span", (0, import_core10.mergeAttributes)(HTMLAttributes, {
+    return ["span", (0, import_core11.mergeAttributes)(HTMLAttributes, {
       "data-node-type": "file-chip",
       class: "docs-chip docs-chip--file"
     }), node.attrs.name || "file"];
@@ -2945,7 +3044,7 @@ var FileChipNode = import_core10.Node.create({
     };
   }
 });
-var DropdownChipNode = import_core10.Node.create({
+var DropdownChipNode = import_core11.Node.create({
   name: "dropdownChip",
   group: "inline",
   inline: true,
@@ -2976,7 +3075,7 @@ var DropdownChipNode = import_core10.Node.create({
     return [{ tag: 'span[data-node-type="dropdown-chip"]' }];
   },
   renderHTML({ node, HTMLAttributes }) {
-    return ["span", (0, import_core10.mergeAttributes)(HTMLAttributes, {
+    return ["span", (0, import_core11.mergeAttributes)(HTMLAttributes, {
       "data-node-type": "dropdown-chip",
       class: "docs-chip docs-chip--dropdown"
     }), node.attrs.selected || ""];
@@ -3028,7 +3127,7 @@ var DropdownChipNode = import_core10.Node.create({
     };
   }
 });
-var LocationChipNode = import_core10.Node.create({
+var LocationChipNode = import_core11.Node.create({
   name: "locationChip",
   group: "inline",
   inline: true,
@@ -3064,7 +3163,7 @@ var LocationChipNode = import_core10.Node.create({
     return [{ tag: 'span[data-node-type="location-chip"]' }];
   },
   renderHTML({ node, HTMLAttributes }) {
-    return ["span", (0, import_core10.mergeAttributes)(HTMLAttributes, {
+    return ["span", (0, import_core11.mergeAttributes)(HTMLAttributes, {
       "data-node-type": "location-chip",
       class: "docs-chip docs-chip--location"
     }), node.attrs.label || ""];
@@ -3160,8 +3259,8 @@ var smartElementsPlugin = (0, import_docflow_core19.definePlugin)({
 });
 
 // src/slashMenu.ts
-var import_core11 = require("@tiptap/core");
-var import_state2 = require("@tiptap/pm/state");
+var import_core12 = require("@tiptap/core");
+var import_state3 = require("@tiptap/pm/state");
 var import_docflow_core20 = require("@kedataindo/docflow-core");
 var slashState = {
   open: false,
@@ -3216,12 +3315,12 @@ function getRegisteredCommands() {
     return true;
   });
 }
-var SlashMenuExtension = import_core11.Extension.create({
+var SlashMenuExtension = import_core12.Extension.create({
   name: "slashMenu",
   addProseMirrorPlugins() {
     return [
-      new import_state2.Plugin({
-        key: new import_state2.PluginKey("slashMenu"),
+      new import_state3.Plugin({
+        key: new import_state3.PluginKey("slashMenu"),
         props: {
           handleTextInput(view, from, _to, text) {
             if (text === "/") {
@@ -3383,8 +3482,10 @@ var defaultPlugins = [
   headingsPlugin,
   highlightPlugin,
   imagePlugin,
+  insertMarkdownBlock,
   linkPlugin,
   listsPlugin,
+  markdownToFragment,
   nextCitationId,
   onSlashStateChange,
   pageBreakPlugin,

package/dist/index.d.cts

@@ -5,6 +5,8 @@ import { Extension, Node, Editor, 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';
 import { PluginKey } from '@tiptap/pm/state';
+import { Fragment } from '@tiptap/pm/model';
+import { EditorView } from '@tiptap/pm/view';
 
 declare function getCitationEngine(editor: Editor): CiteEngine | null;
 /**
@@ -174,6 +176,46 @@ declare module '@tiptap/core' {
 declare const AIExtension: Extension<any, any>;
 declare const aiPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
+/**
+ * Parse a markdown string into a ProseMirror `Fragment` using the editor's
+ * live schema.
+ *
+ * - `inline: false` keeps BLOCK structure (tables, lists, headings) — for the
+ *   chat sidebar Insert, where a streamed answer may contain a table.
+ * - `inline: true` unwraps the leading paragraph so the result is inline
+ *   content — for the inline `/ai` transform, which replaces an in-paragraph
+ *   selection range.
+ *
+ * Returns `null` when the `tiptap-markdown` `Markdown` extension isn't
+ * registered; callers MUST fall back to `schema.text(md)` to keep the
+ * pre-markdown behavior.
+ */
+declare function markdownToFragment(editor: Editor, markdown: string, opts: {
+    inline: boolean;
+}): Fragment | null;
+/**
+ * Insert BLOCK markdown at the range `[from, to)` in ONE dispatch, dispatching
+ * directly on `view` (NOT via `editor.commands`) so the Markdown extension's
+ * forced-inline `insertContentAt` override is bypassed and a table survives.
+ *
+ * Mirrors TipTap's native `insertContentAt` for HTML strings:
+ *   1. parse markdown → HTML → schema Fragment (block-preserving),
+ *   2. if the range is collapsed inside an EMPTY paragraph AND the fragment is
+ *      all block nodes, expand the range by one on each side so the empty
+ *      paragraph is REPLACED by the block content (no nested-in-paragraph
+ *      block, no leftover empty line),
+ *   3. plain-text fast path keeps current marks (rare for markdown, but
+ *      matches `insertText` semantics for pure-prose turns),
+ *   4. `tr.replaceWith` (ProseMirror's `replaceStep` splits the parent as
+ *      needed so a block fits at an inline position),
+ *   5. move the selection to the end of the inserted content.
+ *
+ * Falls back to `tr.insertText(md, from, to)` when the Markdown extension
+ * isn't registered — preserving the pre-markdown plain-text Insert so the
+ * feature degrades gracefully.
+ */
+declare function insertMarkdownBlock(editor: Editor, view: EditorView, from: number, to: number, markdown: string): void;
+
 /**
  * Phase 9 P9-4 — comment plugin.
  *
@@ -264,4 +306,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, SlashMenuExtension, TocEntryNode, TocNode, TocPageNumNode, aiPlugin, aiPluginKey, alignmentPlugin, blockquotePlugin, citationPlugin, codeBlockPlugin, collectHeadings, commentPlugin, createPlaceholderPlugin, defaultPlugins, fontSizePlugin, footnotePlugin, formattingPlugin, getAIPreview, getCitationEngine, headingsPlugin, highlightPlugin, imagePlugin, linkPlugin, listsPlugin, onSlashStateChange, pageBreakPlugin, placeholderPlugin, regenerateToc, registerSlashCommands, slashMenuPlugin, slashState, smartElementsPlugin, 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, SlashMenuExtension, TocEntryNode, TocNode, TocPageNumNode, aiPlugin, aiPluginKey, alignmentPlugin, blockquotePlugin, citationPlugin, codeBlockPlugin, collectHeadings, commentPlugin, createPlaceholderPlugin, defaultPlugins, fontSizePlugin, footnotePlugin, formattingPlugin, getAIPreview, getCitationEngine, headingsPlugin, highlightPlugin, imagePlugin, insertMarkdownBlock, linkPlugin, listsPlugin, markdownToFragment, onSlashStateChange, pageBreakPlugin, placeholderPlugin, regenerateToc, registerSlashCommands, slashMenuPlugin, slashState, smartElementsPlugin, tablePlugin, textColorPlugin, tocPlugin };

package/dist/index.d.ts

@@ -5,6 +5,8 @@ import { Extension, Node, Editor, 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';
 import { PluginKey } from '@tiptap/pm/state';
+import { Fragment } from '@tiptap/pm/model';
+import { EditorView } from '@tiptap/pm/view';
 
 declare function getCitationEngine(editor: Editor): CiteEngine | null;
 /**
@@ -174,6 +176,46 @@ declare module '@tiptap/core' {
 declare const AIExtension: Extension<any, any>;
 declare const aiPlugin: _kedata_indonesia_docflow_core.DocsEditorPlugin;
 
+/**
+ * Parse a markdown string into a ProseMirror `Fragment` using the editor's
+ * live schema.
+ *
+ * - `inline: false` keeps BLOCK structure (tables, lists, headings) — for the
+ *   chat sidebar Insert, where a streamed answer may contain a table.
+ * - `inline: true` unwraps the leading paragraph so the result is inline
+ *   content — for the inline `/ai` transform, which replaces an in-paragraph
+ *   selection range.
+ *
+ * Returns `null` when the `tiptap-markdown` `Markdown` extension isn't
+ * registered; callers MUST fall back to `schema.text(md)` to keep the
+ * pre-markdown behavior.
+ */
+declare function markdownToFragment(editor: Editor, markdown: string, opts: {
+    inline: boolean;
+}): Fragment | null;
+/**
+ * Insert BLOCK markdown at the range `[from, to)` in ONE dispatch, dispatching
+ * directly on `view` (NOT via `editor.commands`) so the Markdown extension's
+ * forced-inline `insertContentAt` override is bypassed and a table survives.
+ *
+ * Mirrors TipTap's native `insertContentAt` for HTML strings:
+ *   1. parse markdown → HTML → schema Fragment (block-preserving),
+ *   2. if the range is collapsed inside an EMPTY paragraph AND the fragment is
+ *      all block nodes, expand the range by one on each side so the empty
+ *      paragraph is REPLACED by the block content (no nested-in-paragraph
+ *      block, no leftover empty line),
+ *   3. plain-text fast path keeps current marks (rare for markdown, but
+ *      matches `insertText` semantics for pure-prose turns),
+ *   4. `tr.replaceWith` (ProseMirror's `replaceStep` splits the parent as
+ *      needed so a block fits at an inline position),
+ *   5. move the selection to the end of the inserted content.
+ *
+ * Falls back to `tr.insertText(md, from, to)` when the Markdown extension
+ * isn't registered — preserving the pre-markdown plain-text Insert so the
+ * feature degrades gracefully.
+ */
+declare function insertMarkdownBlock(editor: Editor, view: EditorView, from: number, to: number, markdown: string): void;
+
 /**
  * Phase 9 P9-4 — comment plugin.
  *
@@ -264,4 +306,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, SlashMenuExtension, TocEntryNode, TocNode, TocPageNumNode, aiPlugin, aiPluginKey, alignmentPlugin, blockquotePlugin, citationPlugin, codeBlockPlugin, collectHeadings, commentPlugin, createPlaceholderPlugin, defaultPlugins, fontSizePlugin, footnotePlugin, formattingPlugin, getAIPreview, getCitationEngine, headingsPlugin, highlightPlugin, imagePlugin, linkPlugin, listsPlugin, onSlashStateChange, pageBreakPlugin, placeholderPlugin, regenerateToc, registerSlashCommands, slashMenuPlugin, slashState, smartElementsPlugin, 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, SlashMenuExtension, TocEntryNode, TocNode, TocPageNumNode, aiPlugin, aiPluginKey, alignmentPlugin, blockquotePlugin, citationPlugin, codeBlockPlugin, collectHeadings, commentPlugin, createPlaceholderPlugin, defaultPlugins, fontSizePlugin, footnotePlugin, formattingPlugin, getAIPreview, getCitationEngine, headingsPlugin, highlightPlugin, imagePlugin, insertMarkdownBlock, linkPlugin, listsPlugin, markdownToFragment, onSlashStateChange, pageBreakPlugin, placeholderPlugin, regenerateToc, registerSlashCommands, slashMenuPlugin, slashState, smartElementsPlugin, tablePlugin, textColorPlugin, tocPlugin };

package/dist/index.js

@@ -853,7 +853,91 @@ var highlightPlugin = definePlugin16({
 import { Extension as Extension2 } from "@tiptap/core";
 import { Plugin, PluginKey } from "@tiptap/pm/state";
 import { Decoration, DecorationSet } from "@tiptap/pm/view";
+import { Markdown } from "tiptap-markdown";
 import { definePlugin as definePlugin17 } from "@kedataindo/docflow-core";
+
+// src/markdownInsert.ts
+import { createNodeFromContent } from "@tiptap/core";
+import { Fragment } from "@tiptap/pm/model";
+import { Selection } from "@tiptap/pm/state";
+import { ReplaceAroundStep, ReplaceStep } from "@tiptap/pm/transform";
+function mdParser(editor) {
+  const storage = editor.storage.markdown;
+  if (!storage || typeof storage !== "object") return void 0;
+  const parser = storage.parser;
+  if (!parser || typeof parser !== "object" || !("parse" in parser)) return void 0;
+  return parser;
+}
+function markdownToFragment(editor, markdown, opts) {
+  const parser = mdParser(editor);
+  if (!parser) return null;
+  let html;
+  try {
+    html = parser.parse(markdown, { inline: opts.inline });
+  } catch {
+    return null;
+  }
+  if (typeof html !== "string") return null;
+  const content = createNodeFromContent(html, editor.schema, {
+    slice: true,
+    parseOptions: { preserveWhitespace: "full" }
+  });
+  if (content instanceof Fragment) return content;
+  return Fragment.from(content);
+}
+function selectionToInsertionEnd(tr, startLen, bias) {
+  const last = tr.steps.length - 1;
+  if (last < startLen) return;
+  const step = tr.steps[last];
+  if (!(step instanceof ReplaceStep || step instanceof ReplaceAroundStep)) return;
+  const map = tr.mapping.maps[last];
+  let end = 0;
+  map.forEach((_from, _to, _newFrom, newTo) => {
+    if (end === 0) end = newTo;
+  });
+  tr.setSelection(Selection.near(tr.doc.resolve(end), bias));
+}
+function insertMarkdownBlock(editor, view, from, to, markdown) {
+  const fragment = markdownToFragment(editor, markdown, { inline: false });
+  if (!fragment) {
+    view.dispatch(view.state.tr.insertText(markdown, from, to));
+    return;
+  }
+  const tr = view.state.tr;
+  let f = from;
+  let t = to;
+  if (f === t) {
+    let onlyBlock = true;
+    fragment.forEach((n) => {
+      if (!n.isBlock) onlyBlock = false;
+    });
+    if (onlyBlock) {
+      const $pos = tr.doc.resolve(f);
+      const parent = $pos.parent;
+      if (parent.isTextblock && !parent.type.spec.code && !parent.childCount) {
+        f -= 1;
+        t += 1;
+      }
+    }
+  }
+  let onlyText = true;
+  fragment.forEach((n) => {
+    if (!n.isText || n.marks.length > 0) onlyText = false;
+  });
+  if (onlyText) {
+    let text = "";
+    fragment.forEach((n) => {
+      if (n.isText) text += n.text ?? "";
+    });
+    tr.insertText(text, f, t);
+  } else {
+    tr.replaceWith(f, t, fragment);
+  }
+  selectionToInsertionEnd(tr, 0, -1);
+  view.dispatch(tr);
+}
+
+// src/ai.ts
 var aiPluginKey = new PluginKey("docflow-ai");
 var CONTEXT_CHARS = 1500;
 function getAIPreview(editor) {
@@ -991,7 +1075,12 @@ var AIExtension = Extension2.create({
         if (!dispatch) return true;
         const tr = state.tr;
         if (preview.text.trim()) {
-          tr.replaceWith(preview.from, preview.to, state.schema.text(preview.text));
+          const fragment = markdownToFragment(editor, preview.text, { inline: true });
+          if (fragment) {
+            tr.replaceWith(preview.from, preview.to, fragment);
+          } else {
+            tr.replaceWith(preview.from, preview.to, state.schema.text(preview.text));
+          }
         }
         tr.setMeta(aiPluginKey, { type: "clear" });
         dispatch(tr);
@@ -1203,7 +1292,15 @@ var AIExtension = Extension2.create({
 });
 var aiPlugin = definePlugin17({
   id: "ai",
-  tiptapExtensions: [AIExtension],
+  // The `tiptap-markdown` `Markdown` extension is registered alongside AI so
+  // that `editor.storage.markdown.parser` is available on every editor that
+  // can stream AI content. It adds a schema-aware markdown↔HTML bridge
+  // (markdown-it under the hood) used by the AI Insert/accept paths to turn
+  // streamed `| col | col |` tables / `# headings` / `**bold**` into real
+  // nodes instead of literal pipe/asterisk text. Its `insertContentAt` /
+  // `setContent` command overrides are intentionally NOT used by the AI
+  // paths (they force `inline:true`); see `markdownInsert.ts`.
+  tiptapExtensions: [AIExtension, Markdown.configure({ html: true, linkify: true, breaks: false })],
   slashCommands: [{ name: "AI", description: "Generate text with AI", command: "aiGenerate" }]
 });
 
@@ -1900,8 +1997,10 @@ export {
   headingsPlugin,
   highlightPlugin,
   imagePlugin,
+  insertMarkdownBlock,
   linkPlugin,
   listsPlugin,
+  markdownToFragment,
   nextCitationId,
   onSlashStateChange,
   pageBreakPlugin,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kedataindo/docflow-plugins",
   "license": "UNLICENSED",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -30,7 +30,8 @@
     "@tiptap/extension-highlight": "^2.27.2",
     "@tiptap/pm": "^2.11.0",
     "citeproc": "^2.4.63",
-    "@kedataindo/docflow-core": "0.0.30"
+    "tiptap-markdown": "0.8.10",
+    "@kedataindo/docflow-core": "0.0.32"
   },
   "peerDependencies": {
     "@tiptap/core": "^2.11.0",