@kedataindo/docflow-core 0.0.2

package/dist/index.cjs

@@ -0,0 +1,491 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BlockAttributesExtension: () => BlockAttributesExtension,
+  FontSizeExtension: () => FontSizeExtension,
+  PAGE_SIZES: () => import_tiptap_pagination_plus2.PAGE_SIZES,
+  PaginationPlus: () => import_tiptap_pagination_plus2.PaginationPlus,
+  collaborationExtensions: () => collaborationExtensions,
+  collectExtensions: () => collectExtensions,
+  createActionMap: () => createActionMap,
+  createCollaboration: () => createCollaboration,
+  createEditor: () => createEditor,
+  definePlugin: () => definePlugin,
+  resolveAction: () => resolveAction
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/Editor.ts
+var import_core2 = 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);
+var import_y_prosemirror = require("y-prosemirror");
+
+// src/PluginSystem.ts
+function definePlugin(plugin) {
+  return plugin;
+}
+function collectExtensions(plugins) {
+  const extensions = [];
+  for (const plugin of plugins) {
+    if (plugin.tiptapExtensions) {
+      extensions.push(...plugin.tiptapExtensions);
+    }
+  }
+  return extensions;
+}
+function resolveAction(editor, action, ...args) {
+  const commands = editor.commands;
+  const command = commands[action];
+  if (typeof command !== "function") {
+    return false;
+  }
+  const result = command(...args);
+  return result === true;
+}
+function createActionMap(editor, plugins) {
+  const map = {};
+  for (const plugin of plugins) {
+    for (const item of plugin.toolbar ?? []) {
+      const custom = plugin.commands?.[item.action];
+      map[item.action] = (...args) => {
+        if (typeof custom === "function") {
+          return custom(editor, ...args);
+        }
+        return resolveAction(editor, item.action, ...args);
+      };
+    }
+    for (const slash of plugin.slashCommands ?? []) {
+      const custom = plugin.commands?.[slash.command];
+      map[slash.command] = (...args) => {
+        if (typeof custom === "function") {
+          return custom(editor, ...args);
+        }
+        return resolveAction(editor, slash.command, ...args);
+      };
+    }
+  }
+  return map;
+}
+
+// src/Collaboration.ts
+var import_extension_collaboration = require("@tiptap/extension-collaboration");
+var import_extension_collaboration_cursor = require("@tiptap/extension-collaboration-cursor");
+var import_awareness = require("y-protocols/awareness");
+var import_y_webrtc = require("y-webrtc");
+var import_y_websocket = require("y-websocket");
+var Y = __toESM(require("yjs"), 1);
+function createAwarenessStates(awareness) {
+  const states = [];
+  awareness.getStates().forEach((state, clientId) => {
+    const raw = state;
+    states.push({
+      clientId,
+      user: raw.user ?? { name: "", color: "" },
+      cursor: raw.cursor ?? null
+    });
+  });
+  return states;
+}
+function createCollaboration(options) {
+  const ydoc = new Y.Doc();
+  if (options.initialStorageState) {
+    Y.applyUpdate(ydoc, options.initialStorageState);
+  }
+  let provider = null;
+  if (options.provider === "webrtc") {
+    provider = new import_y_webrtc.WebrtcProvider(options.room, ydoc, {
+      signaling: options.signaling || [
+        "ws://localhost:4444",
+        "wss://signaling.yjs.dev",
+        "wss://y-webrtc-eu.fly.dev"
+      ]
+    });
+  } else if (options.provider === "websocket") {
+    if (!options.websocketUrl) {
+      throw new Error('[Collaboration] websocketUrl is required when provider is "websocket"');
+    }
+    provider = new import_y_websocket.WebsocketProvider(options.websocketUrl, options.room, ydoc);
+  }
+  const awareness = provider?.awareness ?? new import_awareness.Awareness(ydoc);
+  awareness.setLocalStateField("user", options.user);
+  let awarenessHandler;
+  if (options.onAwarenessChange) {
+    const notify = () => {
+      options.onAwarenessChange?.(createAwarenessStates(awareness));
+    };
+    awarenessHandler = notify;
+    awareness.on("change", notify);
+    notify();
+  }
+  const destroy = () => {
+    if (awarenessHandler) {
+      awareness.off("change", awarenessHandler);
+    }
+    awareness.setLocalState(null);
+    provider?.destroy?.();
+    awareness.destroy?.();
+    ydoc.destroy();
+  };
+  return { ydoc, provider, awareness, destroy };
+}
+function collaborationExtensions(options) {
+  const setup = "ydoc" in options ? options : createCollaboration(options);
+  const extensions = [
+    import_extension_collaboration.Collaboration.configure({ document: setup.ydoc })
+  ];
+  if (setup.provider) {
+    extensions.push(
+      import_extension_collaboration_cursor.CollaborationCursor.configure({
+        provider: setup.provider,
+        user: setup.awareness.getLocalState()?.user ?? { name: "", color: "" }
+      })
+    );
+  }
+  return extensions;
+}
+
+// src/BlockAttributes.ts
+var import_core = require("@tiptap/core");
+var import_state = require("@tiptap/pm/state");
+var import_view = require("@tiptap/pm/view");
+var BlockAttributesExtension = import_core.Extension.create({
+  name: "blockAttributes",
+  addOptions() {
+    return {
+      pageMap: () => /* @__PURE__ */ new Map()
+    };
+  },
+  addProseMirrorPlugins() {
+    const getPageMap = this.options.pageMap;
+    return [
+      new import_state.Plugin({
+        key: new import_state.PluginKey("blockAttributes"),
+        props: {
+          decorations(state) {
+            const decorations = [];
+            const pageMap = getPageMap();
+            if (pageMap.size === 0) return import_view.DecorationSet.create(state.doc, decorations);
+            const maxIdxPerPage = /* @__PURE__ */ new Map();
+            pageMap.forEach((info) => {
+              const cur = maxIdxPerPage.get(info.page) ?? -1;
+              if (info.blockIndex > cur) maxIdxPerPage.set(info.page, info.blockIndex);
+            });
+            state.doc.descendants((node, pos) => {
+              if (!node.isBlock) return;
+              const attrs = {
+                "data-from": String(pos),
+                "data-to": String(pos + node.nodeSize),
+                "data-node-type": node.type.name
+              };
+              const pageInfo = pageMap.get(pos);
+              if (pageInfo) {
+                attrs["data-page"] = String(pageInfo.page);
+                attrs["data-page-block-index"] = String(pageInfo.blockIndex);
+                const maxIdx = maxIdxPerPage.get(pageInfo.page);
+                const styleParts = [];
+                if (pageInfo.page > 1 && pageInfo.blockIndex === 0) {
+                  styleParts.push("margin-top:72px");
+                }
+                if (maxIdx !== void 0 && pageInfo.blockIndex === maxIdx) {
+                  styleParts.push("margin-bottom:72px");
+                }
+                if (styleParts.length > 0) {
+                  attrs.style = styleParts.join(";");
+                }
+              }
+              decorations.push(
+                import_view.Decoration.node(pos, pos + node.nodeSize, attrs)
+              );
+            });
+            return import_view.DecorationSet.create(state.doc, decorations);
+          }
+        }
+      })
+    ];
+  }
+});
+
+// src/Editor.ts
+var import_tiptap_pagination_plus = require("tiptap-pagination-plus");
+function migrateContent(content) {
+  if (!content) return content;
+  if (typeof content === "string") {
+    try {
+      const parsed = JSON.parse(content);
+      return JSON.stringify(migrateContent(parsed));
+    } catch {
+      return content;
+    }
+  }
+  if (typeof content !== "object" || content === null) return content;
+  const obj = content;
+  if (obj.type === "doc" && Array.isArray(obj.content)) {
+    const newContentList = [];
+    for (const child of obj.content) {
+      const childObj = child;
+      if (childObj && childObj.type === "page" && Array.isArray(childObj.content)) {
+        newContentList.push(...childObj.content);
+      } else {
+        newContentList.push(child);
+      }
+    }
+    return { ...obj, content: newContentList };
+  }
+  if (obj.type === "tabbed-doc" && Array.isArray(obj.tabs)) {
+    return {
+      ...obj,
+      tabs: obj.tabs.map((tab) => ({
+        ...tab,
+        content: migrateContent(tab.content)
+      }))
+    };
+  }
+  return content;
+}
+function createEditor(options = {}) {
+  const migratedOptions = {
+    ...options,
+    content: options.content ? migrateContent(options.content) : options.content
+  };
+  const plugins = migratedOptions.plugins ?? [];
+  const collaborationSetup = migratedOptions.collaboration ? createCollaboration(migratedOptions.collaboration) : void 0;
+  let tiptapEditor = createTiptapEditor(migratedOptions, plugins, collaborationSetup);
+  let pluginActions = createActionMap(tiptapEditor, plugins);
+  for (const plugin of plugins) {
+    plugin.hooks?.onInit?.(tiptapEditor);
+  }
+  const rebuildEditor = () => {
+    const currentJSON = tiptapEditor.getJSON();
+    const selection = tiptapEditor.state.selection;
+    const target = migratedOptions.target;
+    tiptapEditor.destroy();
+    tiptapEditor = createTiptapEditor(
+      { ...migratedOptions, content: currentJSON },
+      plugins,
+      collaborationSetup
+    );
+    try {
+      const { from, to } = selection;
+      if (from >= 0 && to >= from && to <= tiptapEditor.state.doc.content.size) {
+        tiptapEditor.commands.setTextSelection({ from, to });
+      }
+    } catch {
+    }
+    if (target) {
+      tiptapEditor.commands.focus();
+    }
+    pluginActions = createActionMap(tiptapEditor, plugins);
+  };
+  const editor = {
+    get editor() {
+      return tiptapEditor;
+    },
+    collab: collaborationSetup,
+    getJSON: () => tiptapEditor.getJSON(),
+    getHTML: () => tiptapEditor.getHTML(),
+    destroy: () => {
+      for (const plugin of plugins) {
+        plugin.hooks?.onDestroy?.(tiptapEditor);
+      }
+      tiptapEditor.destroy();
+      collaborationSetup?.destroy();
+    },
+    use: (plugin) => {
+      plugins.push(plugin);
+      rebuildEditor();
+      plugin.hooks?.onInit?.(tiptapEditor);
+    },
+    get pluginActions() {
+      return pluginActions;
+    }
+  };
+  return editor;
+}
+function createTiptapEditor(options, plugins, collaborationSetup) {
+  const baseStarterKit = options.collaboration ? import_starter_kit.default.configure({ history: false }) : import_starter_kit.default;
+  const pluginExtensions = collectExtensions(plugins);
+  const blockAttrs = options.getPageMap ? BlockAttributesExtension.configure({ pageMap: options.getPageMap }) : BlockAttributesExtension;
+  const paginationExt = options.paginationOptions ? import_tiptap_pagination_plus.PaginationPlus.configure(options.paginationOptions) : import_tiptap_pagination_plus.PaginationPlus;
+  let extensions = [
+    baseStarterKit,
+    import_extension_text_style.default,
+    blockAttrs,
+    paginationExt,
+    ...pluginExtensions
+  ];
+  const content = options.collaboration ? void 0 : options.content;
+  if (options.collaboration && collaborationSetup) {
+    const fragment = collaborationSetup.ydoc.getXmlFragment("default");
+    if (fragment.length === 0 && options.content && typeof options.content === "object") {
+      const schema = (0, import_core2.getSchema)([baseStarterKit, import_extension_text_style.default, blockAttrs, paginationExt, ...pluginExtensions]);
+      (0, import_y_prosemirror.prosemirrorJSONToYXmlFragment)(schema, options.content, fragment);
+    }
+    extensions = [...extensions, ...collaborationExtensions(collaborationSetup)];
+  }
+  return new import_core2.Editor({
+    element: options.target,
+    content,
+    extensions,
+    editable: options.editable ?? true,
+    onUpdate: ({ editor }) => {
+      options.onUpdate?.(editor.getJSON());
+    }
+  });
+}
+
+// src/FontSize.ts
+var import_core3 = require("@tiptap/core");
+function mergeFontSize(textStyleType, existing, fontSize) {
+  if (fontSize === null) {
+    const { fontSize: _removed, ...rest } = existing?.attrs ?? {};
+    return textStyleType.create(rest);
+  }
+  return textStyleType.create({ ...existing?.attrs, fontSize });
+}
+function hasAttrs(mark) {
+  return Object.values(mark.attrs).some((v) => v != null);
+}
+var FontSizeExtension = import_core3.Extension.create({
+  name: "fontSize",
+  addGlobalAttributes() {
+    return [
+      {
+        types: ["textStyle"],
+        attributes: {
+          fontSize: {
+            default: null,
+            parseHTML: (el) => el.style.fontSize || null,
+            renderHTML: (attrs) => {
+              if (!attrs.fontSize) return {};
+              return { style: `font-size: ${attrs.fontSize}` };
+            }
+          }
+        }
+      }
+    ];
+  },
+  addCommands() {
+    return {
+      setFontSize: (fontSize) => ({ tr, state, dispatch }) => {
+        console.log("[FontSizeExt] setFontSize called, fontSize:", fontSize, "empty:", state.selection.empty);
+        const textStyleType = state.schema.marks.textStyle;
+        const { from, to, empty } = state.selection;
+        if (empty) {
+          const stored = tr.storedMarks ? [...tr.storedMarks] : [...state.storedMarks ?? []];
+          const idx = stored.findIndex((m) => m.type === textStyleType);
+          const existing = idx >= 0 ? stored[idx] : void 0;
+          const merged = mergeFontSize(textStyleType, existing, fontSize);
+          if (idx >= 0) {
+            if (hasAttrs(merged)) {
+              stored[idx] = merged;
+            } else {
+              stored.splice(idx, 1);
+            }
+          } else {
+            stored.push(merged);
+          }
+          tr.setStoredMarks(stored);
+        } else {
+          state.doc.nodesBetween(from, to, (node, pos) => {
+            if (!node.isText) return;
+            const fromPos = Math.max(pos, from);
+            const toPos = Math.min(pos + node.nodeSize, to);
+            const existingTextStyle = node.marks.find(
+              (m) => m.type === textStyleType
+            );
+            const merged = mergeFontSize(textStyleType, existingTextStyle, fontSize);
+            if (hasAttrs(merged)) {
+              tr.addMark(fromPos, toPos, merged);
+            } else if (existingTextStyle) {
+              tr.removeMark(fromPos, toPos, existingTextStyle);
+            }
+          });
+        }
+        if (dispatch) dispatch(tr);
+        return true;
+      },
+      unsetFontSize: () => ({ tr, state, dispatch }) => {
+        const textStyleType = state.schema.marks.textStyle;
+        const { from, to, empty } = state.selection;
+        if (empty) {
+          const stored = tr.storedMarks ? [...tr.storedMarks] : [...state.storedMarks ?? []];
+          const idx = stored.findIndex((m) => m.type === textStyleType);
+          if (idx >= 0) {
+            const merged = mergeFontSize(textStyleType, stored[idx], null);
+            if (hasAttrs(merged)) {
+              stored[idx] = merged;
+            } else {
+              stored.splice(idx, 1);
+            }
+            tr.setStoredMarks(stored);
+          }
+        } else {
+          state.doc.nodesBetween(from, to, (node, pos) => {
+            if (!node.isText) return;
+            const fromPos = Math.max(pos, from);
+            const toPos = Math.min(pos + node.nodeSize, to);
+            const existingTextStyle = node.marks.find(
+              (m) => m.type === textStyleType
+            );
+            if (!existingTextStyle) return;
+            const merged = mergeFontSize(textStyleType, existingTextStyle, null);
+            if (hasAttrs(merged)) {
+              tr.addMark(fromPos, toPos, merged);
+            } else {
+              tr.removeMark(fromPos, toPos, existingTextStyle);
+            }
+          });
+        }
+        if (dispatch) dispatch(tr);
+        return true;
+      }
+    };
+  }
+});
+
+// src/index.ts
+var import_tiptap_pagination_plus2 = require("tiptap-pagination-plus");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BlockAttributesExtension,
+  FontSizeExtension,
+  PAGE_SIZES,
+  PaginationPlus,
+  collaborationExtensions,
+  collectExtensions,
+  createActionMap,
+  createCollaboration,
+  createEditor,
+  definePlugin,
+  resolveAction
+});

package/dist/index.d.cts

@@ -0,0 +1,122 @@
+import { AnyExtension, Editor, Extension } from '@tiptap/core';
+import { Awareness } from 'y-protocols/awareness';
+import { WebrtcProvider } from 'y-webrtc';
+import { WebsocketProvider } from 'y-websocket';
+import * as Y from 'yjs';
+import { PaginationPlusOptions } from 'tiptap-pagination-plus';
+export { PAGE_SIZES, PageSize, PaginationPlus, PaginationPlusOptions } from 'tiptap-pagination-plus';
+
+interface ToolbarItem {
+    id: string;
+    icon?: string;
+    iconComponent?: string;
+    label?: string;
+    action: string;
+    args?: unknown[];
+}
+interface SlashCommand {
+    name: string;
+    description?: string;
+    command: string;
+}
+interface DocsEditorPlugin {
+    id: string;
+    tiptapExtensions?: AnyExtension[];
+    toolbar?: ToolbarItem[];
+    slashCommands?: SlashCommand[];
+    commands?: Record<string, (editor: Editor, ...args: unknown[]) => boolean>;
+    hooks?: {
+        onInit?: (editor: Editor) => void;
+        onDestroy?: (editor: Editor) => void;
+    };
+}
+declare function definePlugin(plugin: DocsEditorPlugin): DocsEditorPlugin;
+declare function collectExtensions(plugins: DocsEditorPlugin[]): AnyExtension[];
+declare function resolveAction(editor: Editor, action: string, ...args: unknown[]): boolean;
+declare function createActionMap(editor: Editor, plugins: DocsEditorPlugin[]): Record<string, (...args: unknown[]) => boolean>;
+
+interface AwarenessState {
+    clientId: number;
+    user: {
+        name: string;
+        color: string;
+    };
+    cursor?: {
+        from: number;
+        to: number;
+    } | null;
+}
+interface CollaborationOptions {
+    room: string;
+    provider?: 'webrtc' | 'websocket';
+    websocketUrl?: string;
+    signaling?: string[];
+    user: {
+        name: string;
+        color: string;
+    };
+    onAwarenessChange?: (states: AwarenessState[]) => void;
+    initialStorageState?: Uint8Array;
+}
+interface CollaborationSetup {
+    ydoc: Y.Doc;
+    provider: WebrtcProvider | WebsocketProvider | null;
+    awareness: Awareness;
+    destroy: () => void;
+}
+declare function createCollaboration(options: CollaborationOptions): CollaborationSetup;
+declare function collaborationExtensions(options: CollaborationOptions | CollaborationSetup): AnyExtension[];
+
+interface EditorOptions {
+    target?: HTMLElement;
+    content?: object | string;
+    plugins?: DocsEditorPlugin[];
+    editable?: boolean;
+    onUpdate?: (json: object) => void;
+    collaboration?: CollaborationOptions;
+    getPageMap?: () => Map<number, {
+        page: number;
+        blockIndex: number;
+    }>;
+    paginationOptions?: PaginationPlusOptions;
+}
+interface DocsEditor {
+    editor: Editor;
+    collab?: CollaborationSetup;
+    getJSON: () => object;
+    getHTML: () => string;
+    destroy: () => void;
+    use: (plugin: DocsEditorPlugin) => void;
+    pluginActions: Record<string, (...args: unknown[]) => boolean>;
+}
+declare function createEditor(options?: EditorOptions): DocsEditor;
+
+interface BlockAttributesOptions {
+    pageMap?: () => Map<number, {
+        page: number;
+        blockIndex: number;
+    }>;
+}
+declare const BlockAttributesExtension: Extension<BlockAttributesOptions, any>;
+
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        fontSize: {
+            /** Set font size on the current selection, e.g. '12px'. */
+            setFontSize: (fontSize: string) => ReturnType;
+            /** Remove font size from the current selection. */
+            unsetFontSize: () => ReturnType;
+        };
+    }
+}
+/**
+ * FontSizeExtension — adds a `fontSize` attribute onto TextStyle marks.
+ * Requires TextStyle to be registered separately (done in Editor.ts).
+ *
+ * Uses direct transaction manipulation (tr.addMark / tr.addStoredMark) to:
+ * 1. Avoid chaining conflicts when called from toolbar via chain().setFontSize()
+ * 2. Properly merge font-size with existing textStyle attributes (color, etc.)
+ */
+declare const FontSizeExtension: Extension<any, any>;
+
+export { type AwarenessState, BlockAttributesExtension, type CollaborationOptions, type CollaborationSetup, type DocsEditor, type DocsEditorPlugin, type EditorOptions, FontSizeExtension, type SlashCommand, type ToolbarItem, collaborationExtensions, collectExtensions, createActionMap, createCollaboration, createEditor, definePlugin, resolveAction };

package/dist/index.d.ts

@@ -0,0 +1,122 @@
+import { AnyExtension, Editor, Extension } from '@tiptap/core';
+import { Awareness } from 'y-protocols/awareness';
+import { WebrtcProvider } from 'y-webrtc';
+import { WebsocketProvider } from 'y-websocket';
+import * as Y from 'yjs';
+import { PaginationPlusOptions } from 'tiptap-pagination-plus';
+export { PAGE_SIZES, PageSize, PaginationPlus, PaginationPlusOptions } from 'tiptap-pagination-plus';
+
+interface ToolbarItem {
+    id: string;
+    icon?: string;
+    iconComponent?: string;
+    label?: string;
+    action: string;
+    args?: unknown[];
+}
+interface SlashCommand {
+    name: string;
+    description?: string;
+    command: string;
+}
+interface DocsEditorPlugin {
+    id: string;
+    tiptapExtensions?: AnyExtension[];
+    toolbar?: ToolbarItem[];
+    slashCommands?: SlashCommand[];
+    commands?: Record<string, (editor: Editor, ...args: unknown[]) => boolean>;
+    hooks?: {
+        onInit?: (editor: Editor) => void;
+        onDestroy?: (editor: Editor) => void;
+    };
+}
+declare function definePlugin(plugin: DocsEditorPlugin): DocsEditorPlugin;
+declare function collectExtensions(plugins: DocsEditorPlugin[]): AnyExtension[];
+declare function resolveAction(editor: Editor, action: string, ...args: unknown[]): boolean;
+declare function createActionMap(editor: Editor, plugins: DocsEditorPlugin[]): Record<string, (...args: unknown[]) => boolean>;
+
+interface AwarenessState {
+    clientId: number;
+    user: {
+        name: string;
+        color: string;
+    };
+    cursor?: {
+        from: number;
+        to: number;
+    } | null;
+}
+interface CollaborationOptions {
+    room: string;
+    provider?: 'webrtc' | 'websocket';
+    websocketUrl?: string;
+    signaling?: string[];
+    user: {
+        name: string;
+        color: string;
+    };
+    onAwarenessChange?: (states: AwarenessState[]) => void;
+    initialStorageState?: Uint8Array;
+}
+interface CollaborationSetup {
+    ydoc: Y.Doc;
+    provider: WebrtcProvider | WebsocketProvider | null;
+    awareness: Awareness;
+    destroy: () => void;
+}
+declare function createCollaboration(options: CollaborationOptions): CollaborationSetup;
+declare function collaborationExtensions(options: CollaborationOptions | CollaborationSetup): AnyExtension[];
+
+interface EditorOptions {
+    target?: HTMLElement;
+    content?: object | string;
+    plugins?: DocsEditorPlugin[];
+    editable?: boolean;
+    onUpdate?: (json: object) => void;
+    collaboration?: CollaborationOptions;
+    getPageMap?: () => Map<number, {
+        page: number;
+        blockIndex: number;
+    }>;
+    paginationOptions?: PaginationPlusOptions;
+}
+interface DocsEditor {
+    editor: Editor;
+    collab?: CollaborationSetup;
+    getJSON: () => object;
+    getHTML: () => string;
+    destroy: () => void;
+    use: (plugin: DocsEditorPlugin) => void;
+    pluginActions: Record<string, (...args: unknown[]) => boolean>;
+}
+declare function createEditor(options?: EditorOptions): DocsEditor;
+
+interface BlockAttributesOptions {
+    pageMap?: () => Map<number, {
+        page: number;
+        blockIndex: number;
+    }>;
+}
+declare const BlockAttributesExtension: Extension<BlockAttributesOptions, any>;
+
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        fontSize: {
+            /** Set font size on the current selection, e.g. '12px'. */
+            setFontSize: (fontSize: string) => ReturnType;
+            /** Remove font size from the current selection. */
+            unsetFontSize: () => ReturnType;
+        };
+    }
+}
+/**
+ * FontSizeExtension — adds a `fontSize` attribute onto TextStyle marks.
+ * Requires TextStyle to be registered separately (done in Editor.ts).
+ *
+ * Uses direct transaction manipulation (tr.addMark / tr.addStoredMark) to:
+ * 1. Avoid chaining conflicts when called from toolbar via chain().setFontSize()
+ * 2. Properly merge font-size with existing textStyle attributes (color, etc.)
+ */
+declare const FontSizeExtension: Extension<any, any>;
+
+export { type AwarenessState, BlockAttributesExtension, type CollaborationOptions, type CollaborationSetup, type DocsEditor, type DocsEditorPlugin, type EditorOptions, FontSizeExtension, type SlashCommand, type ToolbarItem, collaborationExtensions, collectExtensions, createActionMap, createCollaboration, createEditor, definePlugin, resolveAction };

package/dist/index.js

@@ -0,0 +1,444 @@
+// src/Editor.ts
+import { Editor as TiptapEditor, getSchema } from "@tiptap/core";
+import StarterKit from "@tiptap/starter-kit";
+import TextStyle from "@tiptap/extension-text-style";
+import { prosemirrorJSONToYXmlFragment } from "y-prosemirror";
+
+// src/PluginSystem.ts
+function definePlugin(plugin) {
+  return plugin;
+}
+function collectExtensions(plugins) {
+  const extensions = [];
+  for (const plugin of plugins) {
+    if (plugin.tiptapExtensions) {
+      extensions.push(...plugin.tiptapExtensions);
+    }
+  }
+  return extensions;
+}
+function resolveAction(editor, action, ...args) {
+  const commands = editor.commands;
+  const command = commands[action];
+  if (typeof command !== "function") {
+    return false;
+  }
+  const result = command(...args);
+  return result === true;
+}
+function createActionMap(editor, plugins) {
+  const map = {};
+  for (const plugin of plugins) {
+    for (const item of plugin.toolbar ?? []) {
+      const custom = plugin.commands?.[item.action];
+      map[item.action] = (...args) => {
+        if (typeof custom === "function") {
+          return custom(editor, ...args);
+        }
+        return resolveAction(editor, item.action, ...args);
+      };
+    }
+    for (const slash of plugin.slashCommands ?? []) {
+      const custom = plugin.commands?.[slash.command];
+      map[slash.command] = (...args) => {
+        if (typeof custom === "function") {
+          return custom(editor, ...args);
+        }
+        return resolveAction(editor, slash.command, ...args);
+      };
+    }
+  }
+  return map;
+}
+
+// src/Collaboration.ts
+import { Collaboration } from "@tiptap/extension-collaboration";
+import { CollaborationCursor } from "@tiptap/extension-collaboration-cursor";
+import { Awareness } from "y-protocols/awareness";
+import { WebrtcProvider } from "y-webrtc";
+import { WebsocketProvider } from "y-websocket";
+import * as Y from "yjs";
+function createAwarenessStates(awareness) {
+  const states = [];
+  awareness.getStates().forEach((state, clientId) => {
+    const raw = state;
+    states.push({
+      clientId,
+      user: raw.user ?? { name: "", color: "" },
+      cursor: raw.cursor ?? null
+    });
+  });
+  return states;
+}
+function createCollaboration(options) {
+  const ydoc = new Y.Doc();
+  if (options.initialStorageState) {
+    Y.applyUpdate(ydoc, options.initialStorageState);
+  }
+  let provider = null;
+  if (options.provider === "webrtc") {
+    provider = new WebrtcProvider(options.room, ydoc, {
+      signaling: options.signaling || [
+        "ws://localhost:4444",
+        "wss://signaling.yjs.dev",
+        "wss://y-webrtc-eu.fly.dev"
+      ]
+    });
+  } else if (options.provider === "websocket") {
+    if (!options.websocketUrl) {
+      throw new Error('[Collaboration] websocketUrl is required when provider is "websocket"');
+    }
+    provider = new WebsocketProvider(options.websocketUrl, options.room, ydoc);
+  }
+  const awareness = provider?.awareness ?? new Awareness(ydoc);
+  awareness.setLocalStateField("user", options.user);
+  let awarenessHandler;
+  if (options.onAwarenessChange) {
+    const notify = () => {
+      options.onAwarenessChange?.(createAwarenessStates(awareness));
+    };
+    awarenessHandler = notify;
+    awareness.on("change", notify);
+    notify();
+  }
+  const destroy = () => {
+    if (awarenessHandler) {
+      awareness.off("change", awarenessHandler);
+    }
+    awareness.setLocalState(null);
+    provider?.destroy?.();
+    awareness.destroy?.();
+    ydoc.destroy();
+  };
+  return { ydoc, provider, awareness, destroy };
+}
+function collaborationExtensions(options) {
+  const setup = "ydoc" in options ? options : createCollaboration(options);
+  const extensions = [
+    Collaboration.configure({ document: setup.ydoc })
+  ];
+  if (setup.provider) {
+    extensions.push(
+      CollaborationCursor.configure({
+        provider: setup.provider,
+        user: setup.awareness.getLocalState()?.user ?? { name: "", color: "" }
+      })
+    );
+  }
+  return extensions;
+}
+
+// src/BlockAttributes.ts
+import { Extension } from "@tiptap/core";
+import { Plugin, PluginKey } from "@tiptap/pm/state";
+import { Decoration, DecorationSet } from "@tiptap/pm/view";
+var BlockAttributesExtension = Extension.create({
+  name: "blockAttributes",
+  addOptions() {
+    return {
+      pageMap: () => /* @__PURE__ */ new Map()
+    };
+  },
+  addProseMirrorPlugins() {
+    const getPageMap = this.options.pageMap;
+    return [
+      new Plugin({
+        key: new PluginKey("blockAttributes"),
+        props: {
+          decorations(state) {
+            const decorations = [];
+            const pageMap = getPageMap();
+            if (pageMap.size === 0) return DecorationSet.create(state.doc, decorations);
+            const maxIdxPerPage = /* @__PURE__ */ new Map();
+            pageMap.forEach((info) => {
+              const cur = maxIdxPerPage.get(info.page) ?? -1;
+              if (info.blockIndex > cur) maxIdxPerPage.set(info.page, info.blockIndex);
+            });
+            state.doc.descendants((node, pos) => {
+              if (!node.isBlock) return;
+              const attrs = {
+                "data-from": String(pos),
+                "data-to": String(pos + node.nodeSize),
+                "data-node-type": node.type.name
+              };
+              const pageInfo = pageMap.get(pos);
+              if (pageInfo) {
+                attrs["data-page"] = String(pageInfo.page);
+                attrs["data-page-block-index"] = String(pageInfo.blockIndex);
+                const maxIdx = maxIdxPerPage.get(pageInfo.page);
+                const styleParts = [];
+                if (pageInfo.page > 1 && pageInfo.blockIndex === 0) {
+                  styleParts.push("margin-top:72px");
+                }
+                if (maxIdx !== void 0 && pageInfo.blockIndex === maxIdx) {
+                  styleParts.push("margin-bottom:72px");
+                }
+                if (styleParts.length > 0) {
+                  attrs.style = styleParts.join(";");
+                }
+              }
+              decorations.push(
+                Decoration.node(pos, pos + node.nodeSize, attrs)
+              );
+            });
+            return DecorationSet.create(state.doc, decorations);
+          }
+        }
+      })
+    ];
+  }
+});
+
+// src/Editor.ts
+import { PaginationPlus } from "tiptap-pagination-plus";
+function migrateContent(content) {
+  if (!content) return content;
+  if (typeof content === "string") {
+    try {
+      const parsed = JSON.parse(content);
+      return JSON.stringify(migrateContent(parsed));
+    } catch {
+      return content;
+    }
+  }
+  if (typeof content !== "object" || content === null) return content;
+  const obj = content;
+  if (obj.type === "doc" && Array.isArray(obj.content)) {
+    const newContentList = [];
+    for (const child of obj.content) {
+      const childObj = child;
+      if (childObj && childObj.type === "page" && Array.isArray(childObj.content)) {
+        newContentList.push(...childObj.content);
+      } else {
+        newContentList.push(child);
+      }
+    }
+    return { ...obj, content: newContentList };
+  }
+  if (obj.type === "tabbed-doc" && Array.isArray(obj.tabs)) {
+    return {
+      ...obj,
+      tabs: obj.tabs.map((tab) => ({
+        ...tab,
+        content: migrateContent(tab.content)
+      }))
+    };
+  }
+  return content;
+}
+function createEditor(options = {}) {
+  const migratedOptions = {
+    ...options,
+    content: options.content ? migrateContent(options.content) : options.content
+  };
+  const plugins = migratedOptions.plugins ?? [];
+  const collaborationSetup = migratedOptions.collaboration ? createCollaboration(migratedOptions.collaboration) : void 0;
+  let tiptapEditor = createTiptapEditor(migratedOptions, plugins, collaborationSetup);
+  let pluginActions = createActionMap(tiptapEditor, plugins);
+  for (const plugin of plugins) {
+    plugin.hooks?.onInit?.(tiptapEditor);
+  }
+  const rebuildEditor = () => {
+    const currentJSON = tiptapEditor.getJSON();
+    const selection = tiptapEditor.state.selection;
+    const target = migratedOptions.target;
+    tiptapEditor.destroy();
+    tiptapEditor = createTiptapEditor(
+      { ...migratedOptions, content: currentJSON },
+      plugins,
+      collaborationSetup
+    );
+    try {
+      const { from, to } = selection;
+      if (from >= 0 && to >= from && to <= tiptapEditor.state.doc.content.size) {
+        tiptapEditor.commands.setTextSelection({ from, to });
+      }
+    } catch {
+    }
+    if (target) {
+      tiptapEditor.commands.focus();
+    }
+    pluginActions = createActionMap(tiptapEditor, plugins);
+  };
+  const editor = {
+    get editor() {
+      return tiptapEditor;
+    },
+    collab: collaborationSetup,
+    getJSON: () => tiptapEditor.getJSON(),
+    getHTML: () => tiptapEditor.getHTML(),
+    destroy: () => {
+      for (const plugin of plugins) {
+        plugin.hooks?.onDestroy?.(tiptapEditor);
+      }
+      tiptapEditor.destroy();
+      collaborationSetup?.destroy();
+    },
+    use: (plugin) => {
+      plugins.push(plugin);
+      rebuildEditor();
+      plugin.hooks?.onInit?.(tiptapEditor);
+    },
+    get pluginActions() {
+      return pluginActions;
+    }
+  };
+  return editor;
+}
+function createTiptapEditor(options, plugins, collaborationSetup) {
+  const baseStarterKit = options.collaboration ? StarterKit.configure({ history: false }) : StarterKit;
+  const pluginExtensions = collectExtensions(plugins);
+  const blockAttrs = options.getPageMap ? BlockAttributesExtension.configure({ pageMap: options.getPageMap }) : BlockAttributesExtension;
+  const paginationExt = options.paginationOptions ? PaginationPlus.configure(options.paginationOptions) : PaginationPlus;
+  let extensions = [
+    baseStarterKit,
+    TextStyle,
+    blockAttrs,
+    paginationExt,
+    ...pluginExtensions
+  ];
+  const content = options.collaboration ? void 0 : options.content;
+  if (options.collaboration && collaborationSetup) {
+    const fragment = collaborationSetup.ydoc.getXmlFragment("default");
+    if (fragment.length === 0 && options.content && typeof options.content === "object") {
+      const schema = getSchema([baseStarterKit, TextStyle, blockAttrs, paginationExt, ...pluginExtensions]);
+      prosemirrorJSONToYXmlFragment(schema, options.content, fragment);
+    }
+    extensions = [...extensions, ...collaborationExtensions(collaborationSetup)];
+  }
+  return new TiptapEditor({
+    element: options.target,
+    content,
+    extensions,
+    editable: options.editable ?? true,
+    onUpdate: ({ editor }) => {
+      options.onUpdate?.(editor.getJSON());
+    }
+  });
+}
+
+// src/FontSize.ts
+import { Extension as Extension2 } from "@tiptap/core";
+function mergeFontSize(textStyleType, existing, fontSize) {
+  if (fontSize === null) {
+    const { fontSize: _removed, ...rest } = existing?.attrs ?? {};
+    return textStyleType.create(rest);
+  }
+  return textStyleType.create({ ...existing?.attrs, fontSize });
+}
+function hasAttrs(mark) {
+  return Object.values(mark.attrs).some((v) => v != null);
+}
+var FontSizeExtension = Extension2.create({
+  name: "fontSize",
+  addGlobalAttributes() {
+    return [
+      {
+        types: ["textStyle"],
+        attributes: {
+          fontSize: {
+            default: null,
+            parseHTML: (el) => el.style.fontSize || null,
+            renderHTML: (attrs) => {
+              if (!attrs.fontSize) return {};
+              return { style: `font-size: ${attrs.fontSize}` };
+            }
+          }
+        }
+      }
+    ];
+  },
+  addCommands() {
+    return {
+      setFontSize: (fontSize) => ({ tr, state, dispatch }) => {
+        console.log("[FontSizeExt] setFontSize called, fontSize:", fontSize, "empty:", state.selection.empty);
+        const textStyleType = state.schema.marks.textStyle;
+        const { from, to, empty } = state.selection;
+        if (empty) {
+          const stored = tr.storedMarks ? [...tr.storedMarks] : [...state.storedMarks ?? []];
+          const idx = stored.findIndex((m) => m.type === textStyleType);
+          const existing = idx >= 0 ? stored[idx] : void 0;
+          const merged = mergeFontSize(textStyleType, existing, fontSize);
+          if (idx >= 0) {
+            if (hasAttrs(merged)) {
+              stored[idx] = merged;
+            } else {
+              stored.splice(idx, 1);
+            }
+          } else {
+            stored.push(merged);
+          }
+          tr.setStoredMarks(stored);
+        } else {
+          state.doc.nodesBetween(from, to, (node, pos) => {
+            if (!node.isText) return;
+            const fromPos = Math.max(pos, from);
+            const toPos = Math.min(pos + node.nodeSize, to);
+            const existingTextStyle = node.marks.find(
+              (m) => m.type === textStyleType
+            );
+            const merged = mergeFontSize(textStyleType, existingTextStyle, fontSize);
+            if (hasAttrs(merged)) {
+              tr.addMark(fromPos, toPos, merged);
+            } else if (existingTextStyle) {
+              tr.removeMark(fromPos, toPos, existingTextStyle);
+            }
+          });
+        }
+        if (dispatch) dispatch(tr);
+        return true;
+      },
+      unsetFontSize: () => ({ tr, state, dispatch }) => {
+        const textStyleType = state.schema.marks.textStyle;
+        const { from, to, empty } = state.selection;
+        if (empty) {
+          const stored = tr.storedMarks ? [...tr.storedMarks] : [...state.storedMarks ?? []];
+          const idx = stored.findIndex((m) => m.type === textStyleType);
+          if (idx >= 0) {
+            const merged = mergeFontSize(textStyleType, stored[idx], null);
+            if (hasAttrs(merged)) {
+              stored[idx] = merged;
+            } else {
+              stored.splice(idx, 1);
+            }
+            tr.setStoredMarks(stored);
+          }
+        } else {
+          state.doc.nodesBetween(from, to, (node, pos) => {
+            if (!node.isText) return;
+            const fromPos = Math.max(pos, from);
+            const toPos = Math.min(pos + node.nodeSize, to);
+            const existingTextStyle = node.marks.find(
+              (m) => m.type === textStyleType
+            );
+            if (!existingTextStyle) return;
+            const merged = mergeFontSize(textStyleType, existingTextStyle, null);
+            if (hasAttrs(merged)) {
+              tr.addMark(fromPos, toPos, merged);
+            } else {
+              tr.removeMark(fromPos, toPos, existingTextStyle);
+            }
+          });
+        }
+        if (dispatch) dispatch(tr);
+        return true;
+      }
+    };
+  }
+});
+
+// src/index.ts
+import { PaginationPlus as PaginationPlus2, PAGE_SIZES } from "tiptap-pagination-plus";
+export {
+  BlockAttributesExtension,
+  FontSizeExtension,
+  PAGE_SIZES,
+  PaginationPlus2 as PaginationPlus,
+  collaborationExtensions,
+  collectExtensions,
+  createActionMap,
+  createCollaboration,
+  createEditor,
+  definePlugin,
+  resolveAction
+};

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@kedataindo/docflow-core",
+  "version": "0.0.2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@tiptap/core": "^2.11.0",
+    "@tiptap/extension-collaboration": "^2.27.2",
+    "@tiptap/extension-collaboration-cursor": "^2.26.2",
+    "@tiptap/extension-text-style": "^2.11.0",
+    "@tiptap/pm": "^2.11.0",
+    "@tiptap/starter-kit": "^2.11.0",
+    "tiptap-pagination-plus": "3.1.0",
+    "y-prosemirror": "^1.2.12",
+    "y-protocols": "^1.0.7",
+    "yjs": "^13.6.20"
+  },
+  "peerDependencies": {
+    "@tiptap/core": "^2.11.0",
+    "@tiptap/extension-collaboration": "^2.27.2",
+    "@tiptap/extension-collaboration-cursor": "^2.26.2",
+    "@tiptap/extension-text-style": "^2.11.0",
+    "@tiptap/starter-kit": "^2.11.0",
+    "tiptap-pagination-plus": "3.1.0",
+    "y-prosemirror": "^1.2.12",
+    "y-webrtc": "^10.3.0",
+    "y-websocket": "^2.0.4",
+    "yjs": "^13.6.20"
+  },
+  "peerDependenciesMeta": {
+    "@tiptap/extension-collaboration": {
+      "optional": true
+    },
+    "@tiptap/extension-collaboration-cursor": {
+      "optional": true
+    },
+    "y-webrtc": {
+      "optional": true
+    },
+    "y-websocket": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.3",
+    "happy-dom": "^20.10.6",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.3"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "typecheck": "tsc --noEmit",
+    "test:unit": "vitest run"
+  }
+}