@kedataindo/docflow-core 0.0.90 → 0.0.91

package/dist/index.cjs

@@ -36,6 +36,11 @@ __export(index_exports, {
   EditorContextExtension: () => EditorContextExtension,
   FontFamilyExtension: () => FontFamilyExtension,
   FontSizeExtension: () => FontSizeExtension,
+  INDENT_MAX_LEVEL: () => INDENT_MAX_LEVEL,
+  INDENT_STEP_PX: () => INDENT_STEP_PX,
+  INDENT_STEP_VAR: () => INDENT_STEP_VAR,
+  INDENT_STYLE_VAR: () => INDENT_STYLE_VAR,
+  IndentExtension: () => IndentExtension,
   LOCAL_STORAGE_KEY: () => LOCAL_STORAGE_KEY,
   PAGE_SIZES: () => PAGE_SIZES,
   PaginationPlus: () => PaginationPlus,
@@ -43,6 +48,7 @@ __export(index_exports, {
   SearchAndReplaceExtension: () => SearchAndReplaceExtension,
   SubdocumentProvider: () => SubdocumentProvider,
   buildAIPrompt: () => buildAIPrompt,
+  clampIndentLevel: () => clampIndentLevel,
   claudeProvider: () => claudeProvider,
   clearSearch: () => clearSearch,
   collaborationExtensions: () => collaborationExtensions,
@@ -56,6 +62,7 @@ __export(index_exports, {
   findMatches: () => findMatches,
   getSearchState: () => getSearchState,
   httpKeyStorage: () => httpKeyStorage,
+  indentLevelOf: () => indentLevelOf,
   localStorageKeyStorage: () => localStorageKeyStorage,
   memoryKeyStorage: () => memoryKeyStorage,
   normalizeClipboardHTML: () => normalizeClipboardHTML,
@@ -76,7 +83,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/Editor.ts
-var import_core6 = require("@tiptap/core");
+var import_core7 = require("@tiptap/core");
 var import_starter_kit = __toESM(require("@tiptap/starter-kit"), 1);
 var import_extension_text_style = __toESM(require("@tiptap/extension-text-style"), 1);
 
@@ -347,10 +354,173 @@ var EditorContextExtension = import_core2.Extension.create({
   }
 });
 
-// src/ManualColumnResize.ts
+// src/Indent.ts
 var import_core3 = require("@tiptap/core");
+var INDENT_STEP_PX = 48;
+var INDENT_MAX_LEVEL = 8;
+var INDENT_ATTR = "indent";
+var INDENT_DATA_ATTR = "data-indent";
+var INDENTABLE_NODES = ["paragraph", "heading"];
+var LIST_ITEM_NODES = ["listItem", "taskItem"];
+var CODE_BLOCK = "codeBlock";
+var ABSOLUTE_UNIT_PX = {
+  px: 1,
+  in: 96,
+  cm: 96 / 2.54,
+  mm: 96 / 25.4,
+  pt: 96 / 72,
+  pc: 16
+};
+function clampIndentLevel(level) {
+  if (!Number.isFinite(level)) return 0;
+  return Math.min(Math.max(Math.trunc(level), 0), INDENT_MAX_LEVEL);
+}
+function indentLevelOf(node) {
+  return clampIndentLevel(Number(node.attrs[INDENT_ATTR] ?? 0));
+}
+function parseIndentLevel(element) {
+  const raw = element.getAttribute(INDENT_DATA_ATTR);
+  if (raw !== null) return clampIndentLevel(Number.parseInt(raw, 10));
+  const px = marginLeftPx(element);
+  return Number.isFinite(px) && px > 0 ? clampIndentLevel(Math.round(px / INDENT_STEP_PX)) : 0;
+}
+function marginLeftPx(element) {
+  const raw = element.style?.marginLeft?.trim() ?? "";
+  if (!raw) return 0;
+  const match = /^(-?\d*\.?\d+)\s*([a-z%]*)$/i.exec(raw);
+  if (!match) return 0;
+  const value = Number.parseFloat(match[1]);
+  const unit = (match[2] || "px").toLowerCase();
+  const factor = ABSOLUTE_UNIT_PX[unit];
+  return factor === void 0 ? 0 : value * factor;
+}
+var INDENT_STYLE_VAR = "--docflow-indent";
+var INDENT_STEP_VAR = "--docflow-indent-step";
+function renderIndentAttributes(level) {
+  return {
+    [INDENT_DATA_ATTR]: String(level),
+    // Three representations on purpose: the custom properties let the
+    // stylesheet out-rank its own `!important` block-margin shorthands (see
+    // packages/vue/src/styles/index.css) and keep the step size in one place,
+    // while the inline `margin-left` still works for hosts that do not ship
+    // that stylesheet.
+    style: `${INDENT_STYLE_VAR}: ${level}; ${INDENT_STEP_VAR}: ${INDENT_STEP_PX}px; margin-left: ${level * INDENT_STEP_PX}px`
+  };
+}
+function shiftBlockIndent(props, delta) {
+  const { state, tr } = props;
+  const { from, to } = state.selection;
+  let changed = false;
+  state.doc.nodesBetween(from, to, (node, pos) => {
+    if (!INDENTABLE_NODES.includes(node.type.name)) return;
+    const current = indentLevelOf(node);
+    const next = clampIndentLevel(current + delta);
+    if (next === current) return;
+    tr.setNodeMarkup(pos, void 0, { ...node.attrs, [INDENT_ATTR]: next });
+    changed = true;
+  });
+  if (changed) props.dispatch?.();
+  return changed;
+}
+function coveredCodeLineStarts(state) {
+  const { $from, $to } = state.selection;
+  if ($from.parent.type.name !== CODE_BLOCK || !$from.sameParent($to)) return null;
+  const text = $from.parent.textContent;
+  const first = text.lastIndexOf("\n", Math.max($from.parentOffset - 1, 0)) + 1;
+  const breakAt = text.indexOf("\n", $to.parentOffset);
+  const end = breakAt === -1 ? text.length : breakAt;
+  const starts = [];
+  for (let at = first; at <= end; at++) {
+    if (at === first || text[at - 1] === "\n") starts.push(at);
+  }
+  return starts;
+}
+var LEADING_INDENT = /^(?:\t| {1,2})/;
+function shiftCodeBlockIndent(props, delta) {
+  const starts = coveredCodeLineStarts(props.state);
+  if (!starts) return false;
+  if (delta > 0 && props.state.selection.empty) {
+    props.tr.insertText("	");
+    props.dispatch?.();
+    return true;
+  }
+  const text = props.state.selection.$from.parent.textContent;
+  const blockStart = props.state.selection.$from.start();
+  const { tr } = props;
+  for (let i = starts.length - 1; i >= 0; i--) {
+    const at = blockStart + starts[i];
+    if (delta > 0) {
+      tr.insertText("	", at, at);
+      continue;
+    }
+    const leading = LEADING_INDENT.exec(text.slice(starts[i]))?.[0];
+    if (leading) tr.delete(at, at + leading.length);
+  }
+  const changed = delta > 0 || tr.docChanged;
+  if (changed) props.dispatch?.();
+  return changed;
+}
+function runIndent(props, delta) {
+  if (props.editor.isActive(CODE_BLOCK)) return shiftCodeBlockIndent(props, delta);
+  const listItem = LIST_ITEM_NODES.find((name) => props.editor.isActive(name));
+  if (listItem) {
+    const nested = delta > 0 ? props.commands.sinkListItem(listItem) : props.commands.liftListItem(listItem);
+    if (nested) return true;
+  }
+  return shiftBlockIndent(props, delta);
+}
+var IndentExtension = import_core3.Extension.create({
+  name: "indent",
+  priority: 50,
+  addGlobalAttributes() {
+    return [
+      {
+        types: [...INDENTABLE_NODES],
+        attributes: {
+          [INDENT_ATTR]: {
+            default: 0,
+            parseHTML: parseIndentLevel,
+            renderHTML: (attributes) => {
+              const level = clampIndentLevel(Number(attributes[INDENT_ATTR] ?? 0));
+              return level > 0 ? renderIndentAttributes(level) : {};
+            }
+          }
+        }
+      }
+    ];
+  },
+  addCommands() {
+    return {
+      indent: () => (props) => runIndent(props, 1),
+      outdent: () => (props) => runIndent(props, -1),
+      setIndent: (level) => ({ state, tr, dispatch }) => {
+        const target = clampIndentLevel(level);
+        const { from, to } = state.selection;
+        let changed = false;
+        state.doc.nodesBetween(from, to, (node, pos) => {
+          if (!INDENTABLE_NODES.includes(node.type.name)) return;
+          if (indentLevelOf(node) === target) return;
+          tr.setNodeMarkup(pos, void 0, { ...node.attrs, [INDENT_ATTR]: target });
+          changed = true;
+        });
+        if (changed) dispatch?.();
+        return changed;
+      },
+      unsetIndent: () => ({ commands }) => commands.setIndent(0)
+    };
+  },
+  addKeyboardShortcuts() {
+    return {
+      Tab: () => this.editor.commands.indent(),
+      "Shift-Tab": () => this.editor.commands.outdent()
+    };
+  }
+});
+
+// src/ManualColumnResize.ts
+var import_core4 = require("@tiptap/core");
 var import_state2 = require("@tiptap/pm/state");
-var ManualColumnResize = import_core3.Extension.create({
+var ManualColumnResize = import_core4.Extension.create({
   name: "manualColumnResize",
   addProseMirrorPlugins() {
     const key2 = new import_state2.PluginKey("manualColumnResize");
@@ -673,7 +843,7 @@ var ManualColumnResize = import_core3.Extension.create({
 });
 
 // src/SearchAndReplace.ts
-var import_core4 = require("@tiptap/core");
+var import_core5 = require("@tiptap/core");
 var import_state3 = require("@tiptap/pm/state");
 var import_view2 = require("@tiptap/pm/view");
 var searchAndReplaceKey = new import_state3.PluginKey("searchAndReplace");
@@ -733,7 +903,7 @@ var searchPlugin = new import_state3.Plugin({
     }
   }
 });
-var SearchAndReplaceExtension = import_core4.Extension.create({
+var SearchAndReplaceExtension = import_core5.Extension.create({
   name: "searchAndReplace",
   addProseMirrorPlugins() {
     return [searchPlugin];
@@ -791,7 +961,7 @@ function replaceAll(editor, replacement) {
 }
 
 // ../../node_modules/.pnpm/tiptap-pagination-plus@3.1.0_patch_hash=00858351959cd6e40e43520c066de1f40e312b64dcfd6be_bddb103a385fcb63b7133ac6ead3d2c8/node_modules/tiptap-pagination-plus/dist/PaginationPlus.js
-var import_core5 = require("@tiptap/core");
+var import_core6 = require("@tiptap/core");
 var import_state4 = require("@tiptap/pm/state");
 var import_transform = require("@tiptap/pm/transform");
 var import_view3 = require("@tiptap/pm/view");
@@ -1074,7 +1244,7 @@ var getPageConfigFromOptions = (_currentOptions) => {
   };
 };
 var paginationKey = new import_state4.PluginKey("pagination");
-var PaginationPlus = import_core5.Extension.create({
+var PaginationPlus = import_core6.Extension.create({
   name: "PaginationPlus",
   addOptions() {
     return defaultOptions;
@@ -1852,7 +2022,10 @@ var KEEP_ATTRS = {
   td: /* @__PURE__ */ new Set(["colspan", "rowspan", "style"]),
   th: /* @__PURE__ */ new Set(["colspan", "rowspan", "style"]),
   col: /* @__PURE__ */ new Set(["span"]),
-  "*": /* @__PURE__ */ new Set(["style"])
+  // `data-indent` carries the block indent (issue #189). Without it, copying an
+  // indented paragraph inside the editor and pasting it back would silently
+  // lose the level, because normalization runs on every paste.
+  "*": /* @__PURE__ */ new Set(["style", "data-indent"])
 };
 function detectClipboardSource(html) {
   if (/id\s*=\s*["']docs-internal/i.test(html)) return "google-docs";
@@ -2087,13 +2260,17 @@ function createTiptapEditor(options, plugins, collaborationSetup) {
     }),
     // Always present — find & replace decorations + state (core editing infra).
     SearchAndReplaceExtension,
+    // Always present — Tab/Shift-Tab block indent (issue #189). Declares
+    // priority 50 so list nesting, table cell navigation and the AI preview
+    // keep their own Tab bindings.
+    IndentExtension,
     ...pluginExtensions
   ];
   const content = options.collaboration ? void 0 : options.content;
   if (options.collaboration && collaborationSetup) {
     extensions = [...extensions, ...collaborationExtensions(collaborationSetup)];
   }
-  return new import_core6.Editor({
+  return new import_core7.Editor({
     element: options.target,
     content,
     extensions,
@@ -2191,7 +2368,7 @@ function sanitizeInlineHTML(html) {
 }
 
 // src/FontSize.ts
-var import_core7 = require("@tiptap/core");
+var import_core8 = require("@tiptap/core");
 function mergeFontSize(textStyleType, existing, fontSize) {
   if (fontSize === null) {
     const { fontSize: _removed, ...rest } = existing?.attrs ?? {};
@@ -2202,7 +2379,7 @@ function mergeFontSize(textStyleType, existing, fontSize) {
 function hasAttrs(mark) {
   return Object.values(mark.attrs).some((v) => v != null);
 }
-var FontSizeExtension = import_core7.Extension.create({
+var FontSizeExtension = import_core8.Extension.create({
   name: "fontSize",
   addGlobalAttributes() {
     return [
@@ -2300,7 +2477,7 @@ var FontSizeExtension = import_core7.Extension.create({
 });
 
 // src/FontFamily.ts
-var import_core8 = require("@tiptap/core");
+var import_core9 = require("@tiptap/core");
 function mergeFontFamily(textStyleType, existing, fontFamily) {
   if (fontFamily === null) {
     const { fontFamily: _removed, ...rest } = existing?.attrs ?? {};
@@ -2311,7 +2488,7 @@ function mergeFontFamily(textStyleType, existing, fontFamily) {
 function hasAttrs2(mark) {
   return Object.values(mark.attrs).some((v) => v != null);
 }
-var FontFamilyExtension = import_core8.Extension.create({
+var FontFamilyExtension = import_core9.Extension.create({
   name: "fontFamily",
   addGlobalAttributes() {
     return [
@@ -2928,6 +3105,11 @@ function claudeProvider(config) {
   EditorContextExtension,
   FontFamilyExtension,
   FontSizeExtension,
+  INDENT_MAX_LEVEL,
+  INDENT_STEP_PX,
+  INDENT_STEP_VAR,
+  INDENT_STYLE_VAR,
+  IndentExtension,
   LOCAL_STORAGE_KEY,
   PAGE_SIZES,
   PaginationPlus,
@@ -2935,6 +3117,7 @@ function claudeProvider(config) {
   SearchAndReplaceExtension,
   SubdocumentProvider,
   buildAIPrompt,
+  clampIndentLevel,
   claudeProvider,
   clearSearch,
   collaborationExtensions,
@@ -2948,6 +3131,7 @@ function claudeProvider(config) {
   findMatches,
   getSearchState,
   httpKeyStorage,
+  indentLevelOf,
   localStorageKeyStorage,
   memoryKeyStorage,
   normalizeClipboardHTML,

package/dist/index.d.cts

@@ -8,8 +8,8 @@ import { I as ImageUploadHandler, C as CitationPort, A as AIStreamFn, a as AIDra
 export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIDraftCitation, g as AIDraftEvent, h as AIProvider, i as AIProviderFactory, j as Auth, k as CONTEXT_CHAR_CAP, l as ClaudeConfig, m as CslDate, n as CslItemData, o as CslName, H as HttpKeyStorageUrls, p as ImageUploadResult, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, q as buildAIPrompt, r as claudeProvider, s as httpKeyStorage, t as localStorageKeyStorage, u as memoryKeyStorage, v as openaiCompatibleProvider, w as toAIStreamFn, x as trimContextAfter, y as trimContextBefore } from './index-DtcV-JK5.cjs';
 import { PaginationPlusOptions } from 'tiptap-pagination-plus';
 export { PAGE_SIZES, PageSize, PaginationPlus, PaginationPlusOptions } from 'tiptap-pagination-plus';
-import { PluginKey } from '@tiptap/pm/state';
 import { Node } from '@tiptap/pm/model';
+import { PluginKey } from '@tiptap/pm/state';
 
 interface ToolbarItem {
     id: string;
@@ -260,6 +260,49 @@ interface BlockAttributesOptions {
 }
 declare const BlockAttributesExtension: Extension<BlockAttributesOptions, any>;
 
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        indent: {
+            /** Shift the block(s) in the selection one level right (Tab). */
+            indent: () => ReturnType;
+            /** Shift the block(s) in the selection one level left (Shift-Tab). */
+            outdent: () => ReturnType;
+            /** Set an absolute block-indent level (clamped to INDENT_MAX_LEVEL). */
+            setIndent: (level: number) => ReturnType;
+            /** Reset the block indent of every block in the selection. */
+            unsetIndent: () => ReturnType;
+        };
+    }
+}
+/** One indent step — half an inch, matching Google Docs (48px at 96dpi). */
+declare const INDENT_STEP_PX = 48;
+/** Deepest block indent the commands accept (8 × 48px = 384px). */
+declare const INDENT_MAX_LEVEL = 8;
+/** Clamp any input to a valid indent level (0 … INDENT_MAX_LEVEL). */
+declare function clampIndentLevel(level: number): number;
+/** Indent level stored on a block node (`0` when the attribute is absent). */
+declare function indentLevelOf(node: Node): number;
+/** Custom property the editor stylesheet turns into `margin-left`. */
+declare const INDENT_STYLE_VAR = "--docflow-indent";
+/** Custom property carrying the step size, so the stylesheet has no 48px copy. */
+declare const INDENT_STEP_VAR = "--docflow-indent-step";
+/**
+ * IndentExtension — keyboard block indentation for the docs editor.
+ *
+ * Issue #189: Tab used to leave the editor because nothing bound it. The
+ * extension stores the level as a node attribute on paragraphs/headings,
+ * renders it as `data-indent` + `margin-left`, and exposes
+ * `indent` / `outdent` / `setIndent` / `unsetIndent` so the toolbar menu can
+ * offer the same commands as the keyboard.
+ *
+ * Priority is deliberately BELOW the 100 default: Tab is already claimed by
+ * richer contexts (`@tiptap/extension-list-item` nesting, table cell
+ * navigation, the AI suggestion preview) and those must keep precedence. This
+ * extension only runs once they have declined the key — paragraphs/headings,
+ * and the first item of a list that cannot nest any deeper.
+ */
+declare const IndentExtension: Extension<any, any>;
+
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         fontSize: {
@@ -434,4 +477,4 @@ declare class SubdocumentProvider {
     destroy(): void;
 }
 
-export { AIDraftFn, AIStreamFn, type AwarenessState, BlockAttributesExtension, CitationPort, type ClipboardSource, type CollaborationOptions, type CollaborationSetup, DOCUMENT_MODES, type DocsEditor, type DocsEditorPlugin, type DocumentMode, EditorContextExtension, type EditorContextOptions, type EditorOptions, FontFamilyExtension, FontSizeExtension, ImageUploadHandler, type MonitorMetric, PerformanceMonitor, type PerformanceMonitorOptions, SearchAndReplaceExtension, type SearchMatch, type SearchState, type SlashCommand, type SubdocState, SubdocumentProvider, type SubdocumentProviderOptions, type ToolbarItem, clearSearch, collaborationExtensions, collectExtensions, createActionMap, createCollaboration, createEditor, createPerformanceMonitor, definePlugin, detectClipboardSource, findMatches, getSearchState, normalizeClipboardHTML, replaceAll, replaceCurrent, resolveAction, sanitizeInlineHTML, sanitizePastedHTML, searchAndReplaceKey, searchNext, searchPrev, setSearchQuery };
+export { AIDraftFn, AIStreamFn, type AwarenessState, BlockAttributesExtension, CitationPort, type ClipboardSource, type CollaborationOptions, type CollaborationSetup, DOCUMENT_MODES, type DocsEditor, type DocsEditorPlugin, type DocumentMode, EditorContextExtension, type EditorContextOptions, type EditorOptions, FontFamilyExtension, FontSizeExtension, INDENT_MAX_LEVEL, INDENT_STEP_PX, INDENT_STEP_VAR, INDENT_STYLE_VAR, ImageUploadHandler, IndentExtension, type MonitorMetric, PerformanceMonitor, type PerformanceMonitorOptions, SearchAndReplaceExtension, type SearchMatch, type SearchState, type SlashCommand, type SubdocState, SubdocumentProvider, type SubdocumentProviderOptions, type ToolbarItem, clampIndentLevel, clearSearch, collaborationExtensions, collectExtensions, createActionMap, createCollaboration, createEditor, createPerformanceMonitor, definePlugin, detectClipboardSource, findMatches, getSearchState, indentLevelOf, normalizeClipboardHTML, replaceAll, replaceCurrent, resolveAction, sanitizeInlineHTML, sanitizePastedHTML, searchAndReplaceKey, searchNext, searchPrev, setSearchQuery };

package/dist/index.d.ts

@@ -8,8 +8,8 @@ import { I as ImageUploadHandler, C as CitationPort, A as AIStreamFn, a as AIDra
 export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIDraftCitation, g as AIDraftEvent, h as AIProvider, i as AIProviderFactory, j as Auth, k as CONTEXT_CHAR_CAP, l as ClaudeConfig, m as CslDate, n as CslItemData, o as CslName, H as HttpKeyStorageUrls, p as ImageUploadResult, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, q as buildAIPrompt, r as claudeProvider, s as httpKeyStorage, t as localStorageKeyStorage, u as memoryKeyStorage, v as openaiCompatibleProvider, w as toAIStreamFn, x as trimContextAfter, y as trimContextBefore } from './index-DtcV-JK5.js';
 import { PaginationPlusOptions } from 'tiptap-pagination-plus';
 export { PAGE_SIZES, PageSize, PaginationPlus, PaginationPlusOptions } from 'tiptap-pagination-plus';
-import { PluginKey } from '@tiptap/pm/state';
 import { Node } from '@tiptap/pm/model';
+import { PluginKey } from '@tiptap/pm/state';
 
 interface ToolbarItem {
     id: string;
@@ -260,6 +260,49 @@ interface BlockAttributesOptions {
 }
 declare const BlockAttributesExtension: Extension<BlockAttributesOptions, any>;
 
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        indent: {
+            /** Shift the block(s) in the selection one level right (Tab). */
+            indent: () => ReturnType;
+            /** Shift the block(s) in the selection one level left (Shift-Tab). */
+            outdent: () => ReturnType;
+            /** Set an absolute block-indent level (clamped to INDENT_MAX_LEVEL). */
+            setIndent: (level: number) => ReturnType;
+            /** Reset the block indent of every block in the selection. */
+            unsetIndent: () => ReturnType;
+        };
+    }
+}
+/** One indent step — half an inch, matching Google Docs (48px at 96dpi). */
+declare const INDENT_STEP_PX = 48;
+/** Deepest block indent the commands accept (8 × 48px = 384px). */
+declare const INDENT_MAX_LEVEL = 8;
+/** Clamp any input to a valid indent level (0 … INDENT_MAX_LEVEL). */
+declare function clampIndentLevel(level: number): number;
+/** Indent level stored on a block node (`0` when the attribute is absent). */
+declare function indentLevelOf(node: Node): number;
+/** Custom property the editor stylesheet turns into `margin-left`. */
+declare const INDENT_STYLE_VAR = "--docflow-indent";
+/** Custom property carrying the step size, so the stylesheet has no 48px copy. */
+declare const INDENT_STEP_VAR = "--docflow-indent-step";
+/**
+ * IndentExtension — keyboard block indentation for the docs editor.
+ *
+ * Issue #189: Tab used to leave the editor because nothing bound it. The
+ * extension stores the level as a node attribute on paragraphs/headings,
+ * renders it as `data-indent` + `margin-left`, and exposes
+ * `indent` / `outdent` / `setIndent` / `unsetIndent` so the toolbar menu can
+ * offer the same commands as the keyboard.
+ *
+ * Priority is deliberately BELOW the 100 default: Tab is already claimed by
+ * richer contexts (`@tiptap/extension-list-item` nesting, table cell
+ * navigation, the AI suggestion preview) and those must keep precedence. This
+ * extension only runs once they have declined the key — paragraphs/headings,
+ * and the first item of a list that cannot nest any deeper.
+ */
+declare const IndentExtension: Extension<any, any>;
+
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         fontSize: {
@@ -434,4 +477,4 @@ declare class SubdocumentProvider {
     destroy(): void;
 }
 
-export { AIDraftFn, AIStreamFn, type AwarenessState, BlockAttributesExtension, CitationPort, type ClipboardSource, type CollaborationOptions, type CollaborationSetup, DOCUMENT_MODES, type DocsEditor, type DocsEditorPlugin, type DocumentMode, EditorContextExtension, type EditorContextOptions, type EditorOptions, FontFamilyExtension, FontSizeExtension, ImageUploadHandler, type MonitorMetric, PerformanceMonitor, type PerformanceMonitorOptions, SearchAndReplaceExtension, type SearchMatch, type SearchState, type SlashCommand, type SubdocState, SubdocumentProvider, type SubdocumentProviderOptions, type ToolbarItem, clearSearch, collaborationExtensions, collectExtensions, createActionMap, createCollaboration, createEditor, createPerformanceMonitor, definePlugin, detectClipboardSource, findMatches, getSearchState, normalizeClipboardHTML, replaceAll, replaceCurrent, resolveAction, sanitizeInlineHTML, sanitizePastedHTML, searchAndReplaceKey, searchNext, searchPrev, setSearchQuery };
+export { AIDraftFn, AIStreamFn, type AwarenessState, BlockAttributesExtension, CitationPort, type ClipboardSource, type CollaborationOptions, type CollaborationSetup, DOCUMENT_MODES, type DocsEditor, type DocsEditorPlugin, type DocumentMode, EditorContextExtension, type EditorContextOptions, type EditorOptions, FontFamilyExtension, FontSizeExtension, INDENT_MAX_LEVEL, INDENT_STEP_PX, INDENT_STEP_VAR, INDENT_STYLE_VAR, ImageUploadHandler, IndentExtension, type MonitorMetric, PerformanceMonitor, type PerformanceMonitorOptions, SearchAndReplaceExtension, type SearchMatch, type SearchState, type SlashCommand, type SubdocState, SubdocumentProvider, type SubdocumentProviderOptions, type ToolbarItem, clampIndentLevel, clearSearch, collaborationExtensions, collectExtensions, createActionMap, createCollaboration, createEditor, createPerformanceMonitor, definePlugin, detectClipboardSource, findMatches, getSearchState, indentLevelOf, normalizeClipboardHTML, replaceAll, replaceCurrent, resolveAction, sanitizeInlineHTML, sanitizePastedHTML, searchAndReplaceKey, searchNext, searchPrev, setSearchQuery };

package/dist/index.js

@@ -284,10 +284,173 @@ var EditorContextExtension = Extension2.create({
   }
 });
 
-// src/ManualColumnResize.ts
+// src/Indent.ts
 import { Extension as Extension3 } from "@tiptap/core";
+var INDENT_STEP_PX = 48;
+var INDENT_MAX_LEVEL = 8;
+var INDENT_ATTR = "indent";
+var INDENT_DATA_ATTR = "data-indent";
+var INDENTABLE_NODES = ["paragraph", "heading"];
+var LIST_ITEM_NODES = ["listItem", "taskItem"];
+var CODE_BLOCK = "codeBlock";
+var ABSOLUTE_UNIT_PX = {
+  px: 1,
+  in: 96,
+  cm: 96 / 2.54,
+  mm: 96 / 25.4,
+  pt: 96 / 72,
+  pc: 16
+};
+function clampIndentLevel(level) {
+  if (!Number.isFinite(level)) return 0;
+  return Math.min(Math.max(Math.trunc(level), 0), INDENT_MAX_LEVEL);
+}
+function indentLevelOf(node) {
+  return clampIndentLevel(Number(node.attrs[INDENT_ATTR] ?? 0));
+}
+function parseIndentLevel(element) {
+  const raw = element.getAttribute(INDENT_DATA_ATTR);
+  if (raw !== null) return clampIndentLevel(Number.parseInt(raw, 10));
+  const px = marginLeftPx(element);
+  return Number.isFinite(px) && px > 0 ? clampIndentLevel(Math.round(px / INDENT_STEP_PX)) : 0;
+}
+function marginLeftPx(element) {
+  const raw = element.style?.marginLeft?.trim() ?? "";
+  if (!raw) return 0;
+  const match = /^(-?\d*\.?\d+)\s*([a-z%]*)$/i.exec(raw);
+  if (!match) return 0;
+  const value = Number.parseFloat(match[1]);
+  const unit = (match[2] || "px").toLowerCase();
+  const factor = ABSOLUTE_UNIT_PX[unit];
+  return factor === void 0 ? 0 : value * factor;
+}
+var INDENT_STYLE_VAR = "--docflow-indent";
+var INDENT_STEP_VAR = "--docflow-indent-step";
+function renderIndentAttributes(level) {
+  return {
+    [INDENT_DATA_ATTR]: String(level),
+    // Three representations on purpose: the custom properties let the
+    // stylesheet out-rank its own `!important` block-margin shorthands (see
+    // packages/vue/src/styles/index.css) and keep the step size in one place,
+    // while the inline `margin-left` still works for hosts that do not ship
+    // that stylesheet.
+    style: `${INDENT_STYLE_VAR}: ${level}; ${INDENT_STEP_VAR}: ${INDENT_STEP_PX}px; margin-left: ${level * INDENT_STEP_PX}px`
+  };
+}
+function shiftBlockIndent(props, delta) {
+  const { state, tr } = props;
+  const { from, to } = state.selection;
+  let changed = false;
+  state.doc.nodesBetween(from, to, (node, pos) => {
+    if (!INDENTABLE_NODES.includes(node.type.name)) return;
+    const current = indentLevelOf(node);
+    const next = clampIndentLevel(current + delta);
+    if (next === current) return;
+    tr.setNodeMarkup(pos, void 0, { ...node.attrs, [INDENT_ATTR]: next });
+    changed = true;
+  });
+  if (changed) props.dispatch?.();
+  return changed;
+}
+function coveredCodeLineStarts(state) {
+  const { $from, $to } = state.selection;
+  if ($from.parent.type.name !== CODE_BLOCK || !$from.sameParent($to)) return null;
+  const text = $from.parent.textContent;
+  const first = text.lastIndexOf("\n", Math.max($from.parentOffset - 1, 0)) + 1;
+  const breakAt = text.indexOf("\n", $to.parentOffset);
+  const end = breakAt === -1 ? text.length : breakAt;
+  const starts = [];
+  for (let at = first; at <= end; at++) {
+    if (at === first || text[at - 1] === "\n") starts.push(at);
+  }
+  return starts;
+}
+var LEADING_INDENT = /^(?:\t| {1,2})/;
+function shiftCodeBlockIndent(props, delta) {
+  const starts = coveredCodeLineStarts(props.state);
+  if (!starts) return false;
+  if (delta > 0 && props.state.selection.empty) {
+    props.tr.insertText("	");
+    props.dispatch?.();
+    return true;
+  }
+  const text = props.state.selection.$from.parent.textContent;
+  const blockStart = props.state.selection.$from.start();
+  const { tr } = props;
+  for (let i = starts.length - 1; i >= 0; i--) {
+    const at = blockStart + starts[i];
+    if (delta > 0) {
+      tr.insertText("	", at, at);
+      continue;
+    }
+    const leading = LEADING_INDENT.exec(text.slice(starts[i]))?.[0];
+    if (leading) tr.delete(at, at + leading.length);
+  }
+  const changed = delta > 0 || tr.docChanged;
+  if (changed) props.dispatch?.();
+  return changed;
+}
+function runIndent(props, delta) {
+  if (props.editor.isActive(CODE_BLOCK)) return shiftCodeBlockIndent(props, delta);
+  const listItem = LIST_ITEM_NODES.find((name) => props.editor.isActive(name));
+  if (listItem) {
+    const nested = delta > 0 ? props.commands.sinkListItem(listItem) : props.commands.liftListItem(listItem);
+    if (nested) return true;
+  }
+  return shiftBlockIndent(props, delta);
+}
+var IndentExtension = Extension3.create({
+  name: "indent",
+  priority: 50,
+  addGlobalAttributes() {
+    return [
+      {
+        types: [...INDENTABLE_NODES],
+        attributes: {
+          [INDENT_ATTR]: {
+            default: 0,
+            parseHTML: parseIndentLevel,
+            renderHTML: (attributes) => {
+              const level = clampIndentLevel(Number(attributes[INDENT_ATTR] ?? 0));
+              return level > 0 ? renderIndentAttributes(level) : {};
+            }
+          }
+        }
+      }
+    ];
+  },
+  addCommands() {
+    return {
+      indent: () => (props) => runIndent(props, 1),
+      outdent: () => (props) => runIndent(props, -1),
+      setIndent: (level) => ({ state, tr, dispatch }) => {
+        const target = clampIndentLevel(level);
+        const { from, to } = state.selection;
+        let changed = false;
+        state.doc.nodesBetween(from, to, (node, pos) => {
+          if (!INDENTABLE_NODES.includes(node.type.name)) return;
+          if (indentLevelOf(node) === target) return;
+          tr.setNodeMarkup(pos, void 0, { ...node.attrs, [INDENT_ATTR]: target });
+          changed = true;
+        });
+        if (changed) dispatch?.();
+        return changed;
+      },
+      unsetIndent: () => ({ commands }) => commands.setIndent(0)
+    };
+  },
+  addKeyboardShortcuts() {
+    return {
+      Tab: () => this.editor.commands.indent(),
+      "Shift-Tab": () => this.editor.commands.outdent()
+    };
+  }
+});
+
+// src/ManualColumnResize.ts
+import { Extension as Extension4 } from "@tiptap/core";
 import { Plugin as Plugin2, PluginKey as PluginKey2 } from "@tiptap/pm/state";
-var ManualColumnResize = Extension3.create({
+var ManualColumnResize = Extension4.create({
   name: "manualColumnResize",
   addProseMirrorPlugins() {
     const key2 = new PluginKey2("manualColumnResize");
@@ -610,7 +773,7 @@ var ManualColumnResize = Extension3.create({
 });
 
 // src/SearchAndReplace.ts
-import { Extension as Extension4 } from "@tiptap/core";
+import { Extension as Extension5 } from "@tiptap/core";
 import { Plugin as Plugin3, PluginKey as PluginKey3, TextSelection } from "@tiptap/pm/state";
 import { Decoration as Decoration2, DecorationSet as DecorationSet2 } from "@tiptap/pm/view";
 var searchAndReplaceKey = new PluginKey3("searchAndReplace");
@@ -670,7 +833,7 @@ var searchPlugin = new Plugin3({
     }
   }
 });
-var SearchAndReplaceExtension = Extension4.create({
+var SearchAndReplaceExtension = Extension5.create({
   name: "searchAndReplace",
   addProseMirrorPlugins() {
     return [searchPlugin];
@@ -728,7 +891,7 @@ function replaceAll(editor, replacement) {
 }
 
 // ../../node_modules/.pnpm/tiptap-pagination-plus@3.1.0_patch_hash=00858351959cd6e40e43520c066de1f40e312b64dcfd6be_bddb103a385fcb63b7133ac6ead3d2c8/node_modules/tiptap-pagination-plus/dist/PaginationPlus.js
-import { Extension as Extension5 } from "@tiptap/core";
+import { Extension as Extension6 } from "@tiptap/core";
 import { Plugin as Plugin4, PluginKey as PluginKey4 } from "@tiptap/pm/state";
 import { ReplaceStep, ReplaceAroundStep, AddMarkStep, RemoveMarkStep, RemoveNodeMarkStep, AttrStep } from "@tiptap/pm/transform";
 import { Decoration as Decoration3, DecorationSet as DecorationSet3 } from "@tiptap/pm/view";
@@ -1011,7 +1174,7 @@ var getPageConfigFromOptions = (_currentOptions) => {
   };
 };
 var paginationKey = new PluginKey4("pagination");
-var PaginationPlus = Extension5.create({
+var PaginationPlus = Extension6.create({
   name: "PaginationPlus",
   addOptions() {
     return defaultOptions;
@@ -1789,7 +1952,10 @@ var KEEP_ATTRS = {
   td: /* @__PURE__ */ new Set(["colspan", "rowspan", "style"]),
   th: /* @__PURE__ */ new Set(["colspan", "rowspan", "style"]),
   col: /* @__PURE__ */ new Set(["span"]),
-  "*": /* @__PURE__ */ new Set(["style"])
+  // `data-indent` carries the block indent (issue #189). Without it, copying an
+  // indented paragraph inside the editor and pasting it back would silently
+  // lose the level, because normalization runs on every paste.
+  "*": /* @__PURE__ */ new Set(["style", "data-indent"])
 };
 function detectClipboardSource(html) {
   if (/id\s*=\s*["']docs-internal/i.test(html)) return "google-docs";
@@ -2024,6 +2190,10 @@ function createTiptapEditor(options, plugins, collaborationSetup) {
     }),
     // Always present — find & replace decorations + state (core editing infra).
     SearchAndReplaceExtension,
+    // Always present — Tab/Shift-Tab block indent (issue #189). Declares
+    // priority 50 so list nesting, table cell navigation and the AI preview
+    // keep their own Tab bindings.
+    IndentExtension,
     ...pluginExtensions
   ];
   const content = options.collaboration ? void 0 : options.content;
@@ -2128,7 +2298,7 @@ function sanitizeInlineHTML(html) {
 }
 
 // src/FontSize.ts
-import { Extension as Extension6 } from "@tiptap/core";
+import { Extension as Extension7 } from "@tiptap/core";
 function mergeFontSize(textStyleType, existing, fontSize) {
   if (fontSize === null) {
     const { fontSize: _removed, ...rest } = existing?.attrs ?? {};
@@ -2139,7 +2309,7 @@ function mergeFontSize(textStyleType, existing, fontSize) {
 function hasAttrs(mark) {
   return Object.values(mark.attrs).some((v) => v != null);
 }
-var FontSizeExtension = Extension6.create({
+var FontSizeExtension = Extension7.create({
   name: "fontSize",
   addGlobalAttributes() {
     return [
@@ -2237,7 +2407,7 @@ var FontSizeExtension = Extension6.create({
 });
 
 // src/FontFamily.ts
-import { Extension as Extension7 } from "@tiptap/core";
+import { Extension as Extension8 } from "@tiptap/core";
 function mergeFontFamily(textStyleType, existing, fontFamily) {
   if (fontFamily === null) {
     const { fontFamily: _removed, ...rest } = existing?.attrs ?? {};
@@ -2248,7 +2418,7 @@ function mergeFontFamily(textStyleType, existing, fontFamily) {
 function hasAttrs2(mark) {
   return Object.values(mark.attrs).some((v) => v != null);
 }
-var FontFamilyExtension = Extension7.create({
+var FontFamilyExtension = Extension8.create({
   name: "fontFamily",
   addGlobalAttributes() {
     return [
@@ -2457,6 +2627,11 @@ export {
   EditorContextExtension,
   FontFamilyExtension,
   FontSizeExtension,
+  INDENT_MAX_LEVEL,
+  INDENT_STEP_PX,
+  INDENT_STEP_VAR,
+  INDENT_STYLE_VAR,
+  IndentExtension,
   LOCAL_STORAGE_KEY,
   PAGE_SIZES,
   PaginationPlus,
@@ -2464,6 +2639,7 @@ export {
   SearchAndReplaceExtension,
   SubdocumentProvider,
   buildAIPrompt,
+  clampIndentLevel,
   claudeProvider,
   clearSearch,
   collaborationExtensions,
@@ -2477,6 +2653,7 @@ export {
   findMatches,
   getSearchState,
   httpKeyStorage,
+  indentLevelOf,
   localStorageKeyStorage,
   memoryKeyStorage,
   normalizeClipboardHTML,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kedataindo/docflow-core",
   "license": "Apache-2.0",
-  "version": "0.0.90",
+  "version": "0.0.91",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",