@tiptap/extension-unique-id 3.5.3 → 3.6.0

package/dist/index.cjs

@@ -21,7 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   UniqueID: () => UniqueID,
-  default: () => index_default
+  default: () => index_default,
+  generateUniqueIds: () => generateUniqueIds
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -268,10 +269,35 @@ var UniqueID = import_core.Extension.create({
   }
 });
 
+// src/generate-unique-ids.ts
+var import_core2 = require("@tiptap/core");
+var import_model2 = require("@tiptap/pm/model");
+var import_state2 = require("@tiptap/pm/state");
+function generateUniqueIds(doc, extensions) {
+  const uniqueIDExtension = extensions.find((ext) => ext.name === "uniqueID");
+  if (!uniqueIDExtension) {
+    throw new Error("UniqueID extension not found in the extensions array");
+  }
+  const { types, attributeName, generateID } = uniqueIDExtension.options;
+  const schema = (0, import_core2.getSchema)([...extensions.filter((ext) => ext.name !== "uniqueID"), uniqueIDExtension]);
+  const contentNode = import_model2.Node.fromJSON(schema, doc);
+  const nodesWithoutId = (0, import_core2.findChildren)(contentNode, (node) => {
+    return !node.attrs[attributeName] && types.includes(node.type.name);
+  });
+  let tr = import_state2.EditorState.create({
+    doc: contentNode
+  }).tr;
+  for (const { node, pos } of nodesWithoutId) {
+    tr = tr.setNodeAttribute(pos, attributeName, generateID({ node, pos }));
+  }
+  return tr.doc.toJSON();
+}
+
 // src/index.ts
 var index_default = UniqueID;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  UniqueID
+  UniqueID,
+  generateUniqueIds
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/unique-id.ts","../src/helpers/removeDuplicates.ts","../src/helpers/findDuplicates.ts"],"sourcesContent":["import { UniqueID } from './unique-id.js'\n\nexport * from './unique-id.js'\n\nexport default UniqueID\n","import { combineTransactionSteps, Extension, findChildren, findChildrenInRange, getChangedRanges } from '@tiptap/core'\nimport type { Node as ProseMirrorNode } from '@tiptap/pm/model'\nimport { Fragment, Slice } from '@tiptap/pm/model'\nimport type { Transaction } from '@tiptap/pm/state'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\nimport { v4 as uuidv4 } from 'uuid'\n\nimport { findDuplicates } from './helpers/findDuplicates.js'\n\nexport type UniqueIDGenerationContext = {\n  node: ProseMirrorNode\n  pos: number\n}\n\nexport interface UniqueIDOptions {\n  attributeName: string\n  types: string[]\n  generateID: (ctx: UniqueIDGenerationContext) => any\n  filterTransaction: ((transaction: Transaction) => boolean) | null\n}\n\nexport const UniqueID = Extension.create<UniqueIDOptions>({\n  name: 'uniqueID',\n\n  // we’ll set a very high priority to make sure this runs first\n  // and is compatible with `appendTransaction` hooks of other extensions\n  priority: 10000,\n\n  addOptions() {\n    return {\n      attributeName: 'id',\n      types: [],\n      generateID: () => uuidv4(),\n      filterTransaction: null,\n    }\n  },\n\n  addGlobalAttributes() {\n    return [\n      {\n        types: this.options.types,\n        attributes: {\n          [this.options.attributeName]: {\n            default: null,\n            parseHTML: element => element.getAttribute(`data-${this.options.attributeName}`),\n            renderHTML: attributes => {\n              if (!attributes[this.options.attributeName]) {\n                return {}\n              }\n\n              return {\n                [`data-${this.options.attributeName}`]: attributes[this.options.attributeName],\n              }\n            },\n          },\n        },\n      },\n    ]\n  },\n\n  // check initial content for missing ids\n  onCreate() {\n    const collaboration = this.editor.extensionManager.extensions.find(ext => ext.name === 'collaboration')\n    const collaborationCaret = this.editor.extensionManager.extensions.find(ext => ext.name === 'collaborationCaret')\n\n    const collabExtensions = [collaboration, collaborationCaret].filter(Boolean)\n    const collab = collabExtensions.find(ext => ext?.options?.provider)\n    const provider = collab?.options?.provider\n\n    const createIds = () => {\n      const { view, state } = this.editor\n      const { tr, doc } = state\n      const { types, attributeName, generateID } = this.options\n      const nodesWithoutId = findChildren(doc, node => {\n        return types.includes(node.type.name) && node.attrs[attributeName] === null\n      })\n\n      nodesWithoutId.forEach(({ node, pos }) => {\n        tr.setNodeMarkup(pos, undefined, {\n          ...node.attrs,\n          [attributeName]: generateID({ node, pos }),\n        })\n      })\n\n      tr.setMeta('addToHistory', false)\n\n      view.dispatch(tr)\n\n      if (provider) {\n        provider.off('synced', createIds)\n      }\n    }\n\n    /**\n     * We need to handle collaboration a bit different here\n     * because we can't automatically add IDs when the provider is not yet synced\n     * otherwise we end up with empty paragraphs\n     */\n    if (collab) {\n      if (!provider) {\n        return createIds()\n      }\n\n      provider.on('synced', createIds)\n    } else {\n      return createIds()\n    }\n  },\n\n  addProseMirrorPlugins() {\n    let dragSourceElement: Element | null = null\n    let transformPasted = false\n\n    return [\n      new Plugin({\n        key: new PluginKey('uniqueID'),\n\n        appendTransaction: (transactions, oldState, newState) => {\n          const hasDocChanges =\n            transactions.some(transaction => transaction.docChanged) && !oldState.doc.eq(newState.doc)\n          const filterTransactions =\n            this.options.filterTransaction && transactions.some(tr => !this.options.filterTransaction?.(tr))\n\n          const isCollabTransaction = transactions.find(tr => tr.getMeta('y-sync$'))\n\n          if (isCollabTransaction) {\n            return\n          }\n\n          if (!hasDocChanges || filterTransactions) {\n            return\n          }\n\n          const { tr } = newState\n\n          const { types, attributeName, generateID } = this.options\n          const transform = combineTransactionSteps(oldState.doc, transactions as Transaction[])\n          const { mapping } = transform\n\n          // get changed ranges based on the old state\n          const changes = getChangedRanges(transform)\n\n          changes.forEach(({ newRange }) => {\n            const newNodes = findChildrenInRange(newState.doc, newRange, node => {\n              return types.includes(node.type.name)\n            })\n\n            const newIds = newNodes.map(({ node }) => node.attrs[attributeName]).filter(id => id !== null)\n\n            newNodes.forEach(({ node, pos }, i) => {\n              // instead of checking `node.attrs[attributeName]` directly\n              // we look at the current state of the node within `tr.doc`.\n              // this helps to prevent adding new ids to the same node\n              // if the node changed multiple times within one transaction\n              const id = tr.doc.nodeAt(pos)?.attrs[attributeName]\n\n              if (id === null) {\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generateID({ node, pos }),\n                })\n\n                return\n              }\n\n              const nextNode = newNodes[i + 1]\n\n              if (nextNode && node.content.size === 0) {\n                tr.setNodeMarkup(nextNode.pos, undefined, {\n                  ...nextNode.node.attrs,\n                  [attributeName]: id,\n                })\n                newIds[i + 1] = id\n\n                if (nextNode.node.attrs[attributeName]) {\n                  return\n                }\n\n                const generatedId = generateID({ node, pos })\n\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generatedId,\n                })\n                newIds[i] = generatedId\n\n                return tr\n              }\n\n              const duplicatedNewIds = findDuplicates(newIds)\n\n              // check if the node doesn’t exist in the old state\n              const { deleted } = mapping.invert().mapResult(pos)\n\n              const newNode = deleted && duplicatedNewIds.includes(id)\n\n              if (newNode) {\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generateID({ node, pos }),\n                })\n              }\n            })\n          })\n\n          if (!tr.steps.length) {\n            return\n          }\n\n          // `tr.setNodeMarkup` resets the stored marks\n          // so we’ll restore them if they exist\n          tr.setStoredMarks(newState.tr.storedMarks)\n\n          return tr\n        },\n\n        // we register a global drag handler to track the current drag source element\n        view(view) {\n          const handleDragstart = (event: DragEvent) => {\n            dragSourceElement = view.dom.parentElement?.contains(event.target as Element)\n              ? view.dom.parentElement\n              : null\n          }\n\n          window.addEventListener('dragstart', handleDragstart)\n\n          return {\n            destroy() {\n              window.removeEventListener('dragstart', handleDragstart)\n            },\n          }\n        },\n\n        props: {\n          // `handleDOMEvents` is called before `transformPasted`\n          // so we can do some checks before\n          handleDOMEvents: {\n            // only create new ids for dropped content\n            // or dropped content while holding `alt`\n            // or content is dragged from another editor\n            drop: (view, event) => {\n              if (\n                dragSourceElement !== view.dom.parentElement ||\n                event.dataTransfer?.effectAllowed === 'copyMove' ||\n                event.dataTransfer?.effectAllowed === 'copy'\n              ) {\n                dragSourceElement = null\n                transformPasted = true\n              }\n\n              return false\n            },\n            // always create new ids on pasted content\n            paste: () => {\n              transformPasted = true\n\n              return false\n            },\n          },\n\n          // we’ll remove ids for every pasted node\n          // so we can create a new one within `appendTransaction`\n          transformPasted: slice => {\n            if (!transformPasted) {\n              return slice\n            }\n\n            const { types, attributeName } = this.options\n            const removeId = (fragment: Fragment): Fragment => {\n              const list: ProseMirrorNode[] = []\n\n              fragment.forEach(node => {\n                // don’t touch text nodes\n                if (node.isText) {\n                  list.push(node)\n\n                  return\n                }\n\n                // check for any other child nodes\n                if (!types.includes(node.type.name)) {\n                  list.push(node.copy(removeId(node.content)))\n\n                  return\n                }\n\n                // remove id\n                const nodeWithoutId = node.type.create(\n                  {\n                    ...node.attrs,\n                    [attributeName]: null,\n                  },\n                  removeId(node.content),\n                  node.marks,\n                )\n\n                list.push(nodeWithoutId)\n              })\n\n              return Fragment.from(list)\n            }\n\n            // reset check\n            transformPasted = false\n\n            return new Slice(removeId(slice.content), slice.openStart, slice.openEnd)\n          },\n        },\n      }),\n    ]\n  },\n})\n","/**\n * Removes duplicated values within an array.\n * Supports numbers, strings and objects.\n */\nexport function removeDuplicates<T>(array: T[], by = JSON.stringify): T[] {\n  const seen: Record<any, any> = {}\n\n  return array.filter(item => {\n    const key = by(item)\n\n    return Object.prototype.hasOwnProperty.call(seen, key) ? false : (seen[key] = true)\n  })\n}\n","import { removeDuplicates } from './removeDuplicates.js'\n\n/**\n * Returns a list of duplicated items within an array.\n */\nexport function findDuplicates(items: any[]): any[] {\n  const filtered = items.filter((el, index) => items.indexOf(el) !== index)\n  const duplicates = removeDuplicates(filtered)\n\n  return duplicates\n}\n"],"mappings":"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","names":["uuidv4","_a","tr"]}
+{"version":3,"sources":["../src/index.ts","../src/unique-id.ts","../src/helpers/removeDuplicates.ts","../src/helpers/findDuplicates.ts","../src/generate-unique-ids.ts"],"sourcesContent":["import { UniqueID } from './unique-id.js'\n\nexport * from './generate-unique-ids.js'\nexport * from './unique-id.js'\n\nexport default UniqueID\n","import { combineTransactionSteps, Extension, findChildren, findChildrenInRange, getChangedRanges } from '@tiptap/core'\nimport type { Node as ProseMirrorNode } from '@tiptap/pm/model'\nimport { Fragment, Slice } from '@tiptap/pm/model'\nimport type { Transaction } from '@tiptap/pm/state'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\nimport { v4 as uuidv4 } from 'uuid'\n\nimport { findDuplicates } from './helpers/findDuplicates.js'\n\nexport type UniqueIDGenerationContext = {\n  node: ProseMirrorNode\n  pos: number\n}\n\nexport interface UniqueIDOptions {\n  /**\n   * The name of the attribute to add the unique ID to.\n   * @default \"id\"\n   */\n  attributeName: string\n  /**\n   * The types of nodes to add unique IDs to.\n   * @default []\n   */\n  types: string[]\n  /**\n   * The function that generates the unique ID. By default, a UUID v4 is\n   * generated. However, you can provide your own function to generate the\n   * unique ID based on the node type and the position.\n   */\n  generateID: (ctx: UniqueIDGenerationContext) => any\n  /**\n   * Ignore some mutations, for example applied from other users through the collaboration plugin.\n   *\n   * @default null\n   */\n  filterTransaction: ((transaction: Transaction) => boolean) | null\n}\n\nexport const UniqueID = Extension.create<UniqueIDOptions>({\n  name: 'uniqueID',\n\n  // we’ll set a very high priority to make sure this runs first\n  // and is compatible with `appendTransaction` hooks of other extensions\n  priority: 10000,\n\n  addOptions() {\n    return {\n      attributeName: 'id',\n      types: [],\n      generateID: () => uuidv4(),\n      filterTransaction: null,\n    }\n  },\n\n  addGlobalAttributes() {\n    return [\n      {\n        types: this.options.types,\n        attributes: {\n          [this.options.attributeName]: {\n            default: null,\n            parseHTML: element => element.getAttribute(`data-${this.options.attributeName}`),\n            renderHTML: attributes => {\n              if (!attributes[this.options.attributeName]) {\n                return {}\n              }\n\n              return {\n                [`data-${this.options.attributeName}`]: attributes[this.options.attributeName],\n              }\n            },\n          },\n        },\n      },\n    ]\n  },\n\n  // check initial content for missing ids\n  onCreate() {\n    const collaboration = this.editor.extensionManager.extensions.find(ext => ext.name === 'collaboration')\n    const collaborationCaret = this.editor.extensionManager.extensions.find(ext => ext.name === 'collaborationCaret')\n\n    const collabExtensions = [collaboration, collaborationCaret].filter(Boolean)\n    const collab = collabExtensions.find(ext => ext?.options?.provider)\n    const provider = collab?.options?.provider\n\n    const createIds = () => {\n      const { view, state } = this.editor\n      const { tr, doc } = state\n      const { types, attributeName, generateID } = this.options\n      const nodesWithoutId = findChildren(doc, node => {\n        return types.includes(node.type.name) && node.attrs[attributeName] === null\n      })\n\n      nodesWithoutId.forEach(({ node, pos }) => {\n        tr.setNodeMarkup(pos, undefined, {\n          ...node.attrs,\n          [attributeName]: generateID({ node, pos }),\n        })\n      })\n\n      tr.setMeta('addToHistory', false)\n\n      view.dispatch(tr)\n\n      if (provider) {\n        provider.off('synced', createIds)\n      }\n    }\n\n    /**\n     * We need to handle collaboration a bit different here\n     * because we can't automatically add IDs when the provider is not yet synced\n     * otherwise we end up with empty paragraphs\n     */\n    if (collab) {\n      if (!provider) {\n        return createIds()\n      }\n\n      provider.on('synced', createIds)\n    } else {\n      return createIds()\n    }\n  },\n\n  addProseMirrorPlugins() {\n    let dragSourceElement: Element | null = null\n    let transformPasted = false\n\n    return [\n      new Plugin({\n        key: new PluginKey('uniqueID'),\n\n        appendTransaction: (transactions, oldState, newState) => {\n          const hasDocChanges =\n            transactions.some(transaction => transaction.docChanged) && !oldState.doc.eq(newState.doc)\n          const filterTransactions =\n            this.options.filterTransaction && transactions.some(tr => !this.options.filterTransaction?.(tr))\n\n          const isCollabTransaction = transactions.find(tr => tr.getMeta('y-sync$'))\n\n          if (isCollabTransaction) {\n            return\n          }\n\n          if (!hasDocChanges || filterTransactions) {\n            return\n          }\n\n          const { tr } = newState\n\n          const { types, attributeName, generateID } = this.options\n          const transform = combineTransactionSteps(oldState.doc, transactions as Transaction[])\n          const { mapping } = transform\n\n          // get changed ranges based on the old state\n          const changes = getChangedRanges(transform)\n\n          changes.forEach(({ newRange }) => {\n            const newNodes = findChildrenInRange(newState.doc, newRange, node => {\n              return types.includes(node.type.name)\n            })\n\n            const newIds = newNodes.map(({ node }) => node.attrs[attributeName]).filter(id => id !== null)\n\n            newNodes.forEach(({ node, pos }, i) => {\n              // instead of checking `node.attrs[attributeName]` directly\n              // we look at the current state of the node within `tr.doc`.\n              // this helps to prevent adding new ids to the same node\n              // if the node changed multiple times within one transaction\n              const id = tr.doc.nodeAt(pos)?.attrs[attributeName]\n\n              if (id === null) {\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generateID({ node, pos }),\n                })\n\n                return\n              }\n\n              const nextNode = newNodes[i + 1]\n\n              if (nextNode && node.content.size === 0) {\n                tr.setNodeMarkup(nextNode.pos, undefined, {\n                  ...nextNode.node.attrs,\n                  [attributeName]: id,\n                })\n                newIds[i + 1] = id\n\n                if (nextNode.node.attrs[attributeName]) {\n                  return\n                }\n\n                const generatedId = generateID({ node, pos })\n\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generatedId,\n                })\n                newIds[i] = generatedId\n\n                return tr\n              }\n\n              const duplicatedNewIds = findDuplicates(newIds)\n\n              // check if the node doesn’t exist in the old state\n              const { deleted } = mapping.invert().mapResult(pos)\n\n              const newNode = deleted && duplicatedNewIds.includes(id)\n\n              if (newNode) {\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generateID({ node, pos }),\n                })\n              }\n            })\n          })\n\n          if (!tr.steps.length) {\n            return\n          }\n\n          // `tr.setNodeMarkup` resets the stored marks\n          // so we’ll restore them if they exist\n          tr.setStoredMarks(newState.tr.storedMarks)\n\n          return tr\n        },\n\n        // we register a global drag handler to track the current drag source element\n        view(view) {\n          const handleDragstart = (event: DragEvent) => {\n            dragSourceElement = view.dom.parentElement?.contains(event.target as Element)\n              ? view.dom.parentElement\n              : null\n          }\n\n          window.addEventListener('dragstart', handleDragstart)\n\n          return {\n            destroy() {\n              window.removeEventListener('dragstart', handleDragstart)\n            },\n          }\n        },\n\n        props: {\n          // `handleDOMEvents` is called before `transformPasted`\n          // so we can do some checks before\n          handleDOMEvents: {\n            // only create new ids for dropped content\n            // or dropped content while holding `alt`\n            // or content is dragged from another editor\n            drop: (view, event) => {\n              if (\n                dragSourceElement !== view.dom.parentElement ||\n                event.dataTransfer?.effectAllowed === 'copyMove' ||\n                event.dataTransfer?.effectAllowed === 'copy'\n              ) {\n                dragSourceElement = null\n                transformPasted = true\n              }\n\n              return false\n            },\n            // always create new ids on pasted content\n            paste: () => {\n              transformPasted = true\n\n              return false\n            },\n          },\n\n          // we’ll remove ids for every pasted node\n          // so we can create a new one within `appendTransaction`\n          transformPasted: slice => {\n            if (!transformPasted) {\n              return slice\n            }\n\n            const { types, attributeName } = this.options\n            const removeId = (fragment: Fragment): Fragment => {\n              const list: ProseMirrorNode[] = []\n\n              fragment.forEach(node => {\n                // don’t touch text nodes\n                if (node.isText) {\n                  list.push(node)\n\n                  return\n                }\n\n                // check for any other child nodes\n                if (!types.includes(node.type.name)) {\n                  list.push(node.copy(removeId(node.content)))\n\n                  return\n                }\n\n                // remove id\n                const nodeWithoutId = node.type.create(\n                  {\n                    ...node.attrs,\n                    [attributeName]: null,\n                  },\n                  removeId(node.content),\n                  node.marks,\n                )\n\n                list.push(nodeWithoutId)\n              })\n\n              return Fragment.from(list)\n            }\n\n            // reset check\n            transformPasted = false\n\n            return new Slice(removeId(slice.content), slice.openStart, slice.openEnd)\n          },\n        },\n      }),\n    ]\n  },\n})\n","/**\n * Removes duplicated values within an array.\n * Supports numbers, strings and objects.\n */\nexport function removeDuplicates<T>(array: T[], by = JSON.stringify): T[] {\n  const seen: Record<any, any> = {}\n\n  return array.filter(item => {\n    const key = by(item)\n\n    return Object.prototype.hasOwnProperty.call(seen, key) ? false : (seen[key] = true)\n  })\n}\n","import { removeDuplicates } from './removeDuplicates.js'\n\n/**\n * Returns a list of duplicated items within an array.\n */\nexport function findDuplicates(items: any[]): any[] {\n  const filtered = items.filter((el, index) => items.indexOf(el) !== index)\n  const duplicates = removeDuplicates(filtered)\n\n  return duplicates\n}\n","import type { Extensions, JSONContent } from '@tiptap/core'\nimport { findChildren, getSchema } from '@tiptap/core'\nimport { Node } from '@tiptap/pm/model'\nimport { EditorState } from '@tiptap/pm/state'\n\nimport type { UniqueID } from './unique-id.js'\n\n/**\n * Creates a new document with unique IDs added to the nodes. Does the same\n * thing as the UniqueID extension, but without the need to create an `Editor`\n * instance. This lets you add unique IDs to the document in the server.\n *\n * When you call it, include the `UniqueID` extension in the `extensions` array.\n * The configuration from the `UniqueID` extension will be picked up\n * automatically, including its configuration options like `types` and\n * `attributeName`.\n *\n * @see `UniqueID` extension for more information.\n *\n * @throws {Error} If the `UniqueID` extension is not found in the extensions array.\n *\n * @example\n * const doc = {\n *   type: 'doc',\n *   content: [\n *     { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }] }\n *   ]\n * }\n * const newDoc = addUniqueIds(doc, [StarterKit, UniqueID.configure({ types: ['paragraph', 'heading'] })])\n * console.log(newDoc)\n * // Result:\n * // {\n * //   type: 'doc',\n * //   content: [\n * //     { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }], id: '123' }\n * //   ]\n * // }\n *\n * @param doc - A Tiptap JSON document to add unique IDs to.\n * @param extensions - The extensions to use. Must include the `UniqueID` extension.\n * @returns The updated Tiptap JSON document, with the unique IDs added to the nodes.\n */\nexport function generateUniqueIds(doc: JSONContent, extensions: Extensions): JSONContent {\n  // Find the UniqueID extension in the extensions array. If it's not found, throw an error.\n  const uniqueIDExtension = extensions.find(ext => ext.name === 'uniqueID') as typeof UniqueID | undefined\n  if (!uniqueIDExtension) {\n    throw new Error('UniqueID extension not found in the extensions array')\n  }\n  const { types, attributeName, generateID } = uniqueIDExtension.options\n\n  // Convert the JSON content to a ProseMirror node\n  const schema = getSchema([...extensions.filter(ext => ext.name !== 'uniqueID'), uniqueIDExtension])\n  const contentNode = Node.fromJSON(schema, doc)\n\n  // Find nodes that don't have a unique ID\n  const nodesWithoutId = findChildren(contentNode, node => {\n    return !node.attrs[attributeName] && types.includes(node.type.name)\n  })\n\n  // Edit the document to add unique IDs to the nodes that don't have a unique ID\n  let tr = EditorState.create({\n    doc: contentNode,\n  }).tr\n  // eslint-disable-next-line no-restricted-syntax\n  for (const { node, pos } of nodesWithoutId) {\n    tr = tr.setNodeAttribute(pos, attributeName, generateID({ node, pos }))\n  }\n\n  // Return the updated document\n  return tr.doc.toJSON()\n}\n"],"mappings":"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","names":["uuidv4","_a","tr","import_core","import_model","import_state"]}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Extension } from '@tiptap/core';
+import { Extension, JSONContent, Extensions } from '@tiptap/core';
 import { Node } from '@tiptap/pm/model';
 import { Transaction } from '@tiptap/pm/state';
 
@@ -7,11 +7,66 @@ type UniqueIDGenerationContext = {
     pos: number;
 };
 interface UniqueIDOptions {
+    /**
+     * The name of the attribute to add the unique ID to.
+     * @default "id"
+     */
     attributeName: string;
+    /**
+     * The types of nodes to add unique IDs to.
+     * @default []
+     */
     types: string[];
+    /**
+     * The function that generates the unique ID. By default, a UUID v4 is
+     * generated. However, you can provide your own function to generate the
+     * unique ID based on the node type and the position.
+     */
     generateID: (ctx: UniqueIDGenerationContext) => any;
+    /**
+     * Ignore some mutations, for example applied from other users through the collaboration plugin.
+     *
+     * @default null
+     */
     filterTransaction: ((transaction: Transaction) => boolean) | null;
 }
 declare const UniqueID: Extension<UniqueIDOptions, any>;
 
-export { UniqueID, type UniqueIDGenerationContext, type UniqueIDOptions, UniqueID as default };
+/**
+ * Creates a new document with unique IDs added to the nodes. Does the same
+ * thing as the UniqueID extension, but without the need to create an `Editor`
+ * instance. This lets you add unique IDs to the document in the server.
+ *
+ * When you call it, include the `UniqueID` extension in the `extensions` array.
+ * The configuration from the `UniqueID` extension will be picked up
+ * automatically, including its configuration options like `types` and
+ * `attributeName`.
+ *
+ * @see `UniqueID` extension for more information.
+ *
+ * @throws {Error} If the `UniqueID` extension is not found in the extensions array.
+ *
+ * @example
+ * const doc = {
+ *   type: 'doc',
+ *   content: [
+ *     { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }] }
+ *   ]
+ * }
+ * const newDoc = addUniqueIds(doc, [StarterKit, UniqueID.configure({ types: ['paragraph', 'heading'] })])
+ * console.log(newDoc)
+ * // Result:
+ * // {
+ * //   type: 'doc',
+ * //   content: [
+ * //     { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }], id: '123' }
+ * //   ]
+ * // }
+ *
+ * @param doc - A Tiptap JSON document to add unique IDs to.
+ * @param extensions - The extensions to use. Must include the `UniqueID` extension.
+ * @returns The updated Tiptap JSON document, with the unique IDs added to the nodes.
+ */
+declare function generateUniqueIds(doc: JSONContent, extensions: Extensions): JSONContent;
+
+export { UniqueID, type UniqueIDGenerationContext, type UniqueIDOptions, UniqueID as default, generateUniqueIds };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Extension } from '@tiptap/core';
+import { Extension, JSONContent, Extensions } from '@tiptap/core';
 import { Node } from '@tiptap/pm/model';
 import { Transaction } from '@tiptap/pm/state';
 
@@ -7,11 +7,66 @@ type UniqueIDGenerationContext = {
     pos: number;
 };
 interface UniqueIDOptions {
+    /**
+     * The name of the attribute to add the unique ID to.
+     * @default "id"
+     */
     attributeName: string;
+    /**
+     * The types of nodes to add unique IDs to.
+     * @default []
+     */
     types: string[];
+    /**
+     * The function that generates the unique ID. By default, a UUID v4 is
+     * generated. However, you can provide your own function to generate the
+     * unique ID based on the node type and the position.
+     */
     generateID: (ctx: UniqueIDGenerationContext) => any;
+    /**
+     * Ignore some mutations, for example applied from other users through the collaboration plugin.
+     *
+     * @default null
+     */
     filterTransaction: ((transaction: Transaction) => boolean) | null;
 }
 declare const UniqueID: Extension<UniqueIDOptions, any>;
 
-export { UniqueID, type UniqueIDGenerationContext, type UniqueIDOptions, UniqueID as default };
+/**
+ * Creates a new document with unique IDs added to the nodes. Does the same
+ * thing as the UniqueID extension, but without the need to create an `Editor`
+ * instance. This lets you add unique IDs to the document in the server.
+ *
+ * When you call it, include the `UniqueID` extension in the `extensions` array.
+ * The configuration from the `UniqueID` extension will be picked up
+ * automatically, including its configuration options like `types` and
+ * `attributeName`.
+ *
+ * @see `UniqueID` extension for more information.
+ *
+ * @throws {Error} If the `UniqueID` extension is not found in the extensions array.
+ *
+ * @example
+ * const doc = {
+ *   type: 'doc',
+ *   content: [
+ *     { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }] }
+ *   ]
+ * }
+ * const newDoc = addUniqueIds(doc, [StarterKit, UniqueID.configure({ types: ['paragraph', 'heading'] })])
+ * console.log(newDoc)
+ * // Result:
+ * // {
+ * //   type: 'doc',
+ * //   content: [
+ * //     { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }], id: '123' }
+ * //   ]
+ * // }
+ *
+ * @param doc - A Tiptap JSON document to add unique IDs to.
+ * @param extensions - The extensions to use. Must include the `UniqueID` extension.
+ * @returns The updated Tiptap JSON document, with the unique IDs added to the nodes.
+ */
+declare function generateUniqueIds(doc: JSONContent, extensions: Extensions): JSONContent;
+
+export { UniqueID, type UniqueIDGenerationContext, type UniqueIDOptions, UniqueID as default, generateUniqueIds };

package/dist/index.js

@@ -241,10 +241,35 @@ var UniqueID = Extension.create({
   }
 });
 
+// src/generate-unique-ids.ts
+import { findChildren as findChildren2, getSchema } from "@tiptap/core";
+import { Node } from "@tiptap/pm/model";
+import { EditorState } from "@tiptap/pm/state";
+function generateUniqueIds(doc, extensions) {
+  const uniqueIDExtension = extensions.find((ext) => ext.name === "uniqueID");
+  if (!uniqueIDExtension) {
+    throw new Error("UniqueID extension not found in the extensions array");
+  }
+  const { types, attributeName, generateID } = uniqueIDExtension.options;
+  const schema = getSchema([...extensions.filter((ext) => ext.name !== "uniqueID"), uniqueIDExtension]);
+  const contentNode = Node.fromJSON(schema, doc);
+  const nodesWithoutId = findChildren2(contentNode, (node) => {
+    return !node.attrs[attributeName] && types.includes(node.type.name);
+  });
+  let tr = EditorState.create({
+    doc: contentNode
+  }).tr;
+  for (const { node, pos } of nodesWithoutId) {
+    tr = tr.setNodeAttribute(pos, attributeName, generateID({ node, pos }));
+  }
+  return tr.doc.toJSON();
+}
+
 // src/index.ts
 var index_default = UniqueID;
 export {
   UniqueID,
-  index_default as default
+  index_default as default,
+  generateUniqueIds
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/unique-id.ts","../src/helpers/removeDuplicates.ts","../src/helpers/findDuplicates.ts","../src/index.ts"],"sourcesContent":["import { combineTransactionSteps, Extension, findChildren, findChildrenInRange, getChangedRanges } from '@tiptap/core'\nimport type { Node as ProseMirrorNode } from '@tiptap/pm/model'\nimport { Fragment, Slice } from '@tiptap/pm/model'\nimport type { Transaction } from '@tiptap/pm/state'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\nimport { v4 as uuidv4 } from 'uuid'\n\nimport { findDuplicates } from './helpers/findDuplicates.js'\n\nexport type UniqueIDGenerationContext = {\n  node: ProseMirrorNode\n  pos: number\n}\n\nexport interface UniqueIDOptions {\n  attributeName: string\n  types: string[]\n  generateID: (ctx: UniqueIDGenerationContext) => any\n  filterTransaction: ((transaction: Transaction) => boolean) | null\n}\n\nexport const UniqueID = Extension.create<UniqueIDOptions>({\n  name: 'uniqueID',\n\n  // we’ll set a very high priority to make sure this runs first\n  // and is compatible with `appendTransaction` hooks of other extensions\n  priority: 10000,\n\n  addOptions() {\n    return {\n      attributeName: 'id',\n      types: [],\n      generateID: () => uuidv4(),\n      filterTransaction: null,\n    }\n  },\n\n  addGlobalAttributes() {\n    return [\n      {\n        types: this.options.types,\n        attributes: {\n          [this.options.attributeName]: {\n            default: null,\n            parseHTML: element => element.getAttribute(`data-${this.options.attributeName}`),\n            renderHTML: attributes => {\n              if (!attributes[this.options.attributeName]) {\n                return {}\n              }\n\n              return {\n                [`data-${this.options.attributeName}`]: attributes[this.options.attributeName],\n              }\n            },\n          },\n        },\n      },\n    ]\n  },\n\n  // check initial content for missing ids\n  onCreate() {\n    const collaboration = this.editor.extensionManager.extensions.find(ext => ext.name === 'collaboration')\n    const collaborationCaret = this.editor.extensionManager.extensions.find(ext => ext.name === 'collaborationCaret')\n\n    const collabExtensions = [collaboration, collaborationCaret].filter(Boolean)\n    const collab = collabExtensions.find(ext => ext?.options?.provider)\n    const provider = collab?.options?.provider\n\n    const createIds = () => {\n      const { view, state } = this.editor\n      const { tr, doc } = state\n      const { types, attributeName, generateID } = this.options\n      const nodesWithoutId = findChildren(doc, node => {\n        return types.includes(node.type.name) && node.attrs[attributeName] === null\n      })\n\n      nodesWithoutId.forEach(({ node, pos }) => {\n        tr.setNodeMarkup(pos, undefined, {\n          ...node.attrs,\n          [attributeName]: generateID({ node, pos }),\n        })\n      })\n\n      tr.setMeta('addToHistory', false)\n\n      view.dispatch(tr)\n\n      if (provider) {\n        provider.off('synced', createIds)\n      }\n    }\n\n    /**\n     * We need to handle collaboration a bit different here\n     * because we can't automatically add IDs when the provider is not yet synced\n     * otherwise we end up with empty paragraphs\n     */\n    if (collab) {\n      if (!provider) {\n        return createIds()\n      }\n\n      provider.on('synced', createIds)\n    } else {\n      return createIds()\n    }\n  },\n\n  addProseMirrorPlugins() {\n    let dragSourceElement: Element | null = null\n    let transformPasted = false\n\n    return [\n      new Plugin({\n        key: new PluginKey('uniqueID'),\n\n        appendTransaction: (transactions, oldState, newState) => {\n          const hasDocChanges =\n            transactions.some(transaction => transaction.docChanged) && !oldState.doc.eq(newState.doc)\n          const filterTransactions =\n            this.options.filterTransaction && transactions.some(tr => !this.options.filterTransaction?.(tr))\n\n          const isCollabTransaction = transactions.find(tr => tr.getMeta('y-sync$'))\n\n          if (isCollabTransaction) {\n            return\n          }\n\n          if (!hasDocChanges || filterTransactions) {\n            return\n          }\n\n          const { tr } = newState\n\n          const { types, attributeName, generateID } = this.options\n          const transform = combineTransactionSteps(oldState.doc, transactions as Transaction[])\n          const { mapping } = transform\n\n          // get changed ranges based on the old state\n          const changes = getChangedRanges(transform)\n\n          changes.forEach(({ newRange }) => {\n            const newNodes = findChildrenInRange(newState.doc, newRange, node => {\n              return types.includes(node.type.name)\n            })\n\n            const newIds = newNodes.map(({ node }) => node.attrs[attributeName]).filter(id => id !== null)\n\n            newNodes.forEach(({ node, pos }, i) => {\n              // instead of checking `node.attrs[attributeName]` directly\n              // we look at the current state of the node within `tr.doc`.\n              // this helps to prevent adding new ids to the same node\n              // if the node changed multiple times within one transaction\n              const id = tr.doc.nodeAt(pos)?.attrs[attributeName]\n\n              if (id === null) {\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generateID({ node, pos }),\n                })\n\n                return\n              }\n\n              const nextNode = newNodes[i + 1]\n\n              if (nextNode && node.content.size === 0) {\n                tr.setNodeMarkup(nextNode.pos, undefined, {\n                  ...nextNode.node.attrs,\n                  [attributeName]: id,\n                })\n                newIds[i + 1] = id\n\n                if (nextNode.node.attrs[attributeName]) {\n                  return\n                }\n\n                const generatedId = generateID({ node, pos })\n\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generatedId,\n                })\n                newIds[i] = generatedId\n\n                return tr\n              }\n\n              const duplicatedNewIds = findDuplicates(newIds)\n\n              // check if the node doesn’t exist in the old state\n              const { deleted } = mapping.invert().mapResult(pos)\n\n              const newNode = deleted && duplicatedNewIds.includes(id)\n\n              if (newNode) {\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generateID({ node, pos }),\n                })\n              }\n            })\n          })\n\n          if (!tr.steps.length) {\n            return\n          }\n\n          // `tr.setNodeMarkup` resets the stored marks\n          // so we’ll restore them if they exist\n          tr.setStoredMarks(newState.tr.storedMarks)\n\n          return tr\n        },\n\n        // we register a global drag handler to track the current drag source element\n        view(view) {\n          const handleDragstart = (event: DragEvent) => {\n            dragSourceElement = view.dom.parentElement?.contains(event.target as Element)\n              ? view.dom.parentElement\n              : null\n          }\n\n          window.addEventListener('dragstart', handleDragstart)\n\n          return {\n            destroy() {\n              window.removeEventListener('dragstart', handleDragstart)\n            },\n          }\n        },\n\n        props: {\n          // `handleDOMEvents` is called before `transformPasted`\n          // so we can do some checks before\n          handleDOMEvents: {\n            // only create new ids for dropped content\n            // or dropped content while holding `alt`\n            // or content is dragged from another editor\n            drop: (view, event) => {\n              if (\n                dragSourceElement !== view.dom.parentElement ||\n                event.dataTransfer?.effectAllowed === 'copyMove' ||\n                event.dataTransfer?.effectAllowed === 'copy'\n              ) {\n                dragSourceElement = null\n                transformPasted = true\n              }\n\n              return false\n            },\n            // always create new ids on pasted content\n            paste: () => {\n              transformPasted = true\n\n              return false\n            },\n          },\n\n          // we’ll remove ids for every pasted node\n          // so we can create a new one within `appendTransaction`\n          transformPasted: slice => {\n            if (!transformPasted) {\n              return slice\n            }\n\n            const { types, attributeName } = this.options\n            const removeId = (fragment: Fragment): Fragment => {\n              const list: ProseMirrorNode[] = []\n\n              fragment.forEach(node => {\n                // don’t touch text nodes\n                if (node.isText) {\n                  list.push(node)\n\n                  return\n                }\n\n                // check for any other child nodes\n                if (!types.includes(node.type.name)) {\n                  list.push(node.copy(removeId(node.content)))\n\n                  return\n                }\n\n                // remove id\n                const nodeWithoutId = node.type.create(\n                  {\n                    ...node.attrs,\n                    [attributeName]: null,\n                  },\n                  removeId(node.content),\n                  node.marks,\n                )\n\n                list.push(nodeWithoutId)\n              })\n\n              return Fragment.from(list)\n            }\n\n            // reset check\n            transformPasted = false\n\n            return new Slice(removeId(slice.content), slice.openStart, slice.openEnd)\n          },\n        },\n      }),\n    ]\n  },\n})\n","/**\n * Removes duplicated values within an array.\n * Supports numbers, strings and objects.\n */\nexport function removeDuplicates<T>(array: T[], by = JSON.stringify): T[] {\n  const seen: Record<any, any> = {}\n\n  return array.filter(item => {\n    const key = by(item)\n\n    return Object.prototype.hasOwnProperty.call(seen, key) ? false : (seen[key] = true)\n  })\n}\n","import { removeDuplicates } from './removeDuplicates.js'\n\n/**\n * Returns a list of duplicated items within an array.\n */\nexport function findDuplicates(items: any[]): any[] {\n  const filtered = items.filter((el, index) => items.indexOf(el) !== index)\n  const duplicates = removeDuplicates(filtered)\n\n  return duplicates\n}\n","import { UniqueID } from './unique-id.js'\n\nexport * from './unique-id.js'\n\nexport default UniqueID\n"],"mappings":"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","names":["_a","tr"]}
+{"version":3,"sources":["../src/unique-id.ts","../src/helpers/removeDuplicates.ts","../src/helpers/findDuplicates.ts","../src/generate-unique-ids.ts","../src/index.ts"],"sourcesContent":["import { combineTransactionSteps, Extension, findChildren, findChildrenInRange, getChangedRanges } from '@tiptap/core'\nimport type { Node as ProseMirrorNode } from '@tiptap/pm/model'\nimport { Fragment, Slice } from '@tiptap/pm/model'\nimport type { Transaction } from '@tiptap/pm/state'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\nimport { v4 as uuidv4 } from 'uuid'\n\nimport { findDuplicates } from './helpers/findDuplicates.js'\n\nexport type UniqueIDGenerationContext = {\n  node: ProseMirrorNode\n  pos: number\n}\n\nexport interface UniqueIDOptions {\n  /**\n   * The name of the attribute to add the unique ID to.\n   * @default \"id\"\n   */\n  attributeName: string\n  /**\n   * The types of nodes to add unique IDs to.\n   * @default []\n   */\n  types: string[]\n  /**\n   * The function that generates the unique ID. By default, a UUID v4 is\n   * generated. However, you can provide your own function to generate the\n   * unique ID based on the node type and the position.\n   */\n  generateID: (ctx: UniqueIDGenerationContext) => any\n  /**\n   * Ignore some mutations, for example applied from other users through the collaboration plugin.\n   *\n   * @default null\n   */\n  filterTransaction: ((transaction: Transaction) => boolean) | null\n}\n\nexport const UniqueID = Extension.create<UniqueIDOptions>({\n  name: 'uniqueID',\n\n  // we’ll set a very high priority to make sure this runs first\n  // and is compatible with `appendTransaction` hooks of other extensions\n  priority: 10000,\n\n  addOptions() {\n    return {\n      attributeName: 'id',\n      types: [],\n      generateID: () => uuidv4(),\n      filterTransaction: null,\n    }\n  },\n\n  addGlobalAttributes() {\n    return [\n      {\n        types: this.options.types,\n        attributes: {\n          [this.options.attributeName]: {\n            default: null,\n            parseHTML: element => element.getAttribute(`data-${this.options.attributeName}`),\n            renderHTML: attributes => {\n              if (!attributes[this.options.attributeName]) {\n                return {}\n              }\n\n              return {\n                [`data-${this.options.attributeName}`]: attributes[this.options.attributeName],\n              }\n            },\n          },\n        },\n      },\n    ]\n  },\n\n  // check initial content for missing ids\n  onCreate() {\n    const collaboration = this.editor.extensionManager.extensions.find(ext => ext.name === 'collaboration')\n    const collaborationCaret = this.editor.extensionManager.extensions.find(ext => ext.name === 'collaborationCaret')\n\n    const collabExtensions = [collaboration, collaborationCaret].filter(Boolean)\n    const collab = collabExtensions.find(ext => ext?.options?.provider)\n    const provider = collab?.options?.provider\n\n    const createIds = () => {\n      const { view, state } = this.editor\n      const { tr, doc } = state\n      const { types, attributeName, generateID } = this.options\n      const nodesWithoutId = findChildren(doc, node => {\n        return types.includes(node.type.name) && node.attrs[attributeName] === null\n      })\n\n      nodesWithoutId.forEach(({ node, pos }) => {\n        tr.setNodeMarkup(pos, undefined, {\n          ...node.attrs,\n          [attributeName]: generateID({ node, pos }),\n        })\n      })\n\n      tr.setMeta('addToHistory', false)\n\n      view.dispatch(tr)\n\n      if (provider) {\n        provider.off('synced', createIds)\n      }\n    }\n\n    /**\n     * We need to handle collaboration a bit different here\n     * because we can't automatically add IDs when the provider is not yet synced\n     * otherwise we end up with empty paragraphs\n     */\n    if (collab) {\n      if (!provider) {\n        return createIds()\n      }\n\n      provider.on('synced', createIds)\n    } else {\n      return createIds()\n    }\n  },\n\n  addProseMirrorPlugins() {\n    let dragSourceElement: Element | null = null\n    let transformPasted = false\n\n    return [\n      new Plugin({\n        key: new PluginKey('uniqueID'),\n\n        appendTransaction: (transactions, oldState, newState) => {\n          const hasDocChanges =\n            transactions.some(transaction => transaction.docChanged) && !oldState.doc.eq(newState.doc)\n          const filterTransactions =\n            this.options.filterTransaction && transactions.some(tr => !this.options.filterTransaction?.(tr))\n\n          const isCollabTransaction = transactions.find(tr => tr.getMeta('y-sync$'))\n\n          if (isCollabTransaction) {\n            return\n          }\n\n          if (!hasDocChanges || filterTransactions) {\n            return\n          }\n\n          const { tr } = newState\n\n          const { types, attributeName, generateID } = this.options\n          const transform = combineTransactionSteps(oldState.doc, transactions as Transaction[])\n          const { mapping } = transform\n\n          // get changed ranges based on the old state\n          const changes = getChangedRanges(transform)\n\n          changes.forEach(({ newRange }) => {\n            const newNodes = findChildrenInRange(newState.doc, newRange, node => {\n              return types.includes(node.type.name)\n            })\n\n            const newIds = newNodes.map(({ node }) => node.attrs[attributeName]).filter(id => id !== null)\n\n            newNodes.forEach(({ node, pos }, i) => {\n              // instead of checking `node.attrs[attributeName]` directly\n              // we look at the current state of the node within `tr.doc`.\n              // this helps to prevent adding new ids to the same node\n              // if the node changed multiple times within one transaction\n              const id = tr.doc.nodeAt(pos)?.attrs[attributeName]\n\n              if (id === null) {\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generateID({ node, pos }),\n                })\n\n                return\n              }\n\n              const nextNode = newNodes[i + 1]\n\n              if (nextNode && node.content.size === 0) {\n                tr.setNodeMarkup(nextNode.pos, undefined, {\n                  ...nextNode.node.attrs,\n                  [attributeName]: id,\n                })\n                newIds[i + 1] = id\n\n                if (nextNode.node.attrs[attributeName]) {\n                  return\n                }\n\n                const generatedId = generateID({ node, pos })\n\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generatedId,\n                })\n                newIds[i] = generatedId\n\n                return tr\n              }\n\n              const duplicatedNewIds = findDuplicates(newIds)\n\n              // check if the node doesn’t exist in the old state\n              const { deleted } = mapping.invert().mapResult(pos)\n\n              const newNode = deleted && duplicatedNewIds.includes(id)\n\n              if (newNode) {\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generateID({ node, pos }),\n                })\n              }\n            })\n          })\n\n          if (!tr.steps.length) {\n            return\n          }\n\n          // `tr.setNodeMarkup` resets the stored marks\n          // so we’ll restore them if they exist\n          tr.setStoredMarks(newState.tr.storedMarks)\n\n          return tr\n        },\n\n        // we register a global drag handler to track the current drag source element\n        view(view) {\n          const handleDragstart = (event: DragEvent) => {\n            dragSourceElement = view.dom.parentElement?.contains(event.target as Element)\n              ? view.dom.parentElement\n              : null\n          }\n\n          window.addEventListener('dragstart', handleDragstart)\n\n          return {\n            destroy() {\n              window.removeEventListener('dragstart', handleDragstart)\n            },\n          }\n        },\n\n        props: {\n          // `handleDOMEvents` is called before `transformPasted`\n          // so we can do some checks before\n          handleDOMEvents: {\n            // only create new ids for dropped content\n            // or dropped content while holding `alt`\n            // or content is dragged from another editor\n            drop: (view, event) => {\n              if (\n                dragSourceElement !== view.dom.parentElement ||\n                event.dataTransfer?.effectAllowed === 'copyMove' ||\n                event.dataTransfer?.effectAllowed === 'copy'\n              ) {\n                dragSourceElement = null\n                transformPasted = true\n              }\n\n              return false\n            },\n            // always create new ids on pasted content\n            paste: () => {\n              transformPasted = true\n\n              return false\n            },\n          },\n\n          // we’ll remove ids for every pasted node\n          // so we can create a new one within `appendTransaction`\n          transformPasted: slice => {\n            if (!transformPasted) {\n              return slice\n            }\n\n            const { types, attributeName } = this.options\n            const removeId = (fragment: Fragment): Fragment => {\n              const list: ProseMirrorNode[] = []\n\n              fragment.forEach(node => {\n                // don’t touch text nodes\n                if (node.isText) {\n                  list.push(node)\n\n                  return\n                }\n\n                // check for any other child nodes\n                if (!types.includes(node.type.name)) {\n                  list.push(node.copy(removeId(node.content)))\n\n                  return\n                }\n\n                // remove id\n                const nodeWithoutId = node.type.create(\n                  {\n                    ...node.attrs,\n                    [attributeName]: null,\n                  },\n                  removeId(node.content),\n                  node.marks,\n                )\n\n                list.push(nodeWithoutId)\n              })\n\n              return Fragment.from(list)\n            }\n\n            // reset check\n            transformPasted = false\n\n            return new Slice(removeId(slice.content), slice.openStart, slice.openEnd)\n          },\n        },\n      }),\n    ]\n  },\n})\n","/**\n * Removes duplicated values within an array.\n * Supports numbers, strings and objects.\n */\nexport function removeDuplicates<T>(array: T[], by = JSON.stringify): T[] {\n  const seen: Record<any, any> = {}\n\n  return array.filter(item => {\n    const key = by(item)\n\n    return Object.prototype.hasOwnProperty.call(seen, key) ? false : (seen[key] = true)\n  })\n}\n","import { removeDuplicates } from './removeDuplicates.js'\n\n/**\n * Returns a list of duplicated items within an array.\n */\nexport function findDuplicates(items: any[]): any[] {\n  const filtered = items.filter((el, index) => items.indexOf(el) !== index)\n  const duplicates = removeDuplicates(filtered)\n\n  return duplicates\n}\n","import type { Extensions, JSONContent } from '@tiptap/core'\nimport { findChildren, getSchema } from '@tiptap/core'\nimport { Node } from '@tiptap/pm/model'\nimport { EditorState } from '@tiptap/pm/state'\n\nimport type { UniqueID } from './unique-id.js'\n\n/**\n * Creates a new document with unique IDs added to the nodes. Does the same\n * thing as the UniqueID extension, but without the need to create an `Editor`\n * instance. This lets you add unique IDs to the document in the server.\n *\n * When you call it, include the `UniqueID` extension in the `extensions` array.\n * The configuration from the `UniqueID` extension will be picked up\n * automatically, including its configuration options like `types` and\n * `attributeName`.\n *\n * @see `UniqueID` extension for more information.\n *\n * @throws {Error} If the `UniqueID` extension is not found in the extensions array.\n *\n * @example\n * const doc = {\n *   type: 'doc',\n *   content: [\n *     { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }] }\n *   ]\n * }\n * const newDoc = addUniqueIds(doc, [StarterKit, UniqueID.configure({ types: ['paragraph', 'heading'] })])\n * console.log(newDoc)\n * // Result:\n * // {\n * //   type: 'doc',\n * //   content: [\n * //     { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }], id: '123' }\n * //   ]\n * // }\n *\n * @param doc - A Tiptap JSON document to add unique IDs to.\n * @param extensions - The extensions to use. Must include the `UniqueID` extension.\n * @returns The updated Tiptap JSON document, with the unique IDs added to the nodes.\n */\nexport function generateUniqueIds(doc: JSONContent, extensions: Extensions): JSONContent {\n  // Find the UniqueID extension in the extensions array. If it's not found, throw an error.\n  const uniqueIDExtension = extensions.find(ext => ext.name === 'uniqueID') as typeof UniqueID | undefined\n  if (!uniqueIDExtension) {\n    throw new Error('UniqueID extension not found in the extensions array')\n  }\n  const { types, attributeName, generateID } = uniqueIDExtension.options\n\n  // Convert the JSON content to a ProseMirror node\n  const schema = getSchema([...extensions.filter(ext => ext.name !== 'uniqueID'), uniqueIDExtension])\n  const contentNode = Node.fromJSON(schema, doc)\n\n  // Find nodes that don't have a unique ID\n  const nodesWithoutId = findChildren(contentNode, node => {\n    return !node.attrs[attributeName] && types.includes(node.type.name)\n  })\n\n  // Edit the document to add unique IDs to the nodes that don't have a unique ID\n  let tr = EditorState.create({\n    doc: contentNode,\n  }).tr\n  // eslint-disable-next-line no-restricted-syntax\n  for (const { node, pos } of nodesWithoutId) {\n    tr = tr.setNodeAttribute(pos, attributeName, generateID({ node, pos }))\n  }\n\n  // Return the updated document\n  return tr.doc.toJSON()\n}\n","import { UniqueID } from './unique-id.js'\n\nexport * from './generate-unique-ids.js'\nexport * from './unique-id.js'\n\nexport default UniqueID\n"],"mappings":"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","names":["_a","tr","findChildren"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tiptap/extension-unique-id",
   "description": "unique id extension for tiptap",
-  "version": "3.5.3",
+  "version": "3.6.0",
   "homepage": "https://tiptap.dev/api/extensions/unique-id",
   "keywords": [
     "tiptap",
@@ -31,16 +31,16 @@
     "dist"
   ],
   "peerDependencies": {
-    "@tiptap/core": "^3.5.3",
-    "@tiptap/pm": "^3.5.3"
+    "@tiptap/core": "^3.6.0",
+    "@tiptap/pm": "^3.6.0"
   },
   "dependencies": {
     "uuid": "^10.0.0"
   },
   "devDependencies": {
     "@types/uuid": "^10.0.0",
-    "@tiptap/core": "^3.5.3",
-    "@tiptap/pm": "^3.5.3"
+    "@tiptap/core": "^3.6.0",
+    "@tiptap/pm": "^3.6.0"
   },
   "repository": {
     "type": "git",

package/src/generate-unique-ids.ts

@@ -0,0 +1,71 @@
+import type { Extensions, JSONContent } from '@tiptap/core'
+import { findChildren, getSchema } from '@tiptap/core'
+import { Node } from '@tiptap/pm/model'
+import { EditorState } from '@tiptap/pm/state'
+
+import type { UniqueID } from './unique-id.js'
+
+/**
+ * Creates a new document with unique IDs added to the nodes. Does the same
+ * thing as the UniqueID extension, but without the need to create an `Editor`
+ * instance. This lets you add unique IDs to the document in the server.
+ *
+ * When you call it, include the `UniqueID` extension in the `extensions` array.
+ * The configuration from the `UniqueID` extension will be picked up
+ * automatically, including its configuration options like `types` and
+ * `attributeName`.
+ *
+ * @see `UniqueID` extension for more information.
+ *
+ * @throws {Error} If the `UniqueID` extension is not found in the extensions array.
+ *
+ * @example
+ * const doc = {
+ *   type: 'doc',
+ *   content: [
+ *     { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }] }
+ *   ]
+ * }
+ * const newDoc = addUniqueIds(doc, [StarterKit, UniqueID.configure({ types: ['paragraph', 'heading'] })])
+ * console.log(newDoc)
+ * // Result:
+ * // {
+ * //   type: 'doc',
+ * //   content: [
+ * //     { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }], id: '123' }
+ * //   ]
+ * // }
+ *
+ * @param doc - A Tiptap JSON document to add unique IDs to.
+ * @param extensions - The extensions to use. Must include the `UniqueID` extension.
+ * @returns The updated Tiptap JSON document, with the unique IDs added to the nodes.
+ */
+export function generateUniqueIds(doc: JSONContent, extensions: Extensions): JSONContent {
+  // Find the UniqueID extension in the extensions array. If it's not found, throw an error.
+  const uniqueIDExtension = extensions.find(ext => ext.name === 'uniqueID') as typeof UniqueID | undefined
+  if (!uniqueIDExtension) {
+    throw new Error('UniqueID extension not found in the extensions array')
+  }
+  const { types, attributeName, generateID } = uniqueIDExtension.options
+
+  // Convert the JSON content to a ProseMirror node
+  const schema = getSchema([...extensions.filter(ext => ext.name !== 'uniqueID'), uniqueIDExtension])
+  const contentNode = Node.fromJSON(schema, doc)
+
+  // Find nodes that don't have a unique ID
+  const nodesWithoutId = findChildren(contentNode, node => {
+    return !node.attrs[attributeName] && types.includes(node.type.name)
+  })
+
+  // Edit the document to add unique IDs to the nodes that don't have a unique ID
+  let tr = EditorState.create({
+    doc: contentNode,
+  }).tr
+  // eslint-disable-next-line no-restricted-syntax
+  for (const { node, pos } of nodesWithoutId) {
+    tr = tr.setNodeAttribute(pos, attributeName, generateID({ node, pos }))
+  }
+
+  // Return the updated document
+  return tr.doc.toJSON()
+}

package/src/index.ts

@@ -1,5 +1,6 @@
 import { UniqueID } from './unique-id.js'
 
+export * from './generate-unique-ids.js'
 export * from './unique-id.js'
 
 export default UniqueID

package/src/unique-id.ts

@@ -13,9 +13,27 @@ export type UniqueIDGenerationContext = {
 }
 
 export interface UniqueIDOptions {
+  /**
+   * The name of the attribute to add the unique ID to.
+   * @default "id"
+   */
   attributeName: string
+  /**
+   * The types of nodes to add unique IDs to.
+   * @default []
+   */
   types: string[]
+  /**
+   * The function that generates the unique ID. By default, a UUID v4 is
+   * generated. However, you can provide your own function to generate the
+   * unique ID based on the node type and the position.
+   */
   generateID: (ctx: UniqueIDGenerationContext) => any
+  /**
+   * Ignore some mutations, for example applied from other users through the collaboration plugin.
+   *
+   * @default null
+   */
   filterTransaction: ((transaction: Transaction) => boolean) | null
 }