@tiptap/extension-unique-id 2.0.0-beta.1

package/dist/tiptap-extension-unique-id.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiptap-extension-unique-id.umd.js","sources":["../src/helpers/combineTransactionSteps.ts","../src/helpers/removeDuplicates.ts","../src/helpers/getChangedRanges.ts","../src/helpers/findDuplicates.ts","../src/unique-id.ts"],"sourcesContent":["import { Node as ProseMirrorNode } from 'prosemirror-model'\nimport { Transaction } from 'prosemirror-state'\nimport { Transform } from 'prosemirror-transform'\n\n/**\n * Returns a new `Transform` based on all steps of the passed transactions.\n */\nexport default function combineTransactionSteps(oldDoc: ProseMirrorNode, transactions: Transaction[]): Transform {\n  const transform = new Transform(oldDoc)\n\n  transactions.forEach(transaction => {\n    transaction.steps.forEach(step => {\n      transform.step(step)\n    })\n  })\n\n  return transform\n}\n","/**\n * Removes duplicated values within an array.\n * Supports numbers, strings and objects.\n */\nexport default 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)\n      ? false\n      : (seen[key] = true)\n  })\n}\n","import { Transform, Step } from 'prosemirror-transform'\nimport removeDuplicates from './removeDuplicates'\n\nexport type ChangedRange = {\n  oldStart: number,\n  oldEnd: number,\n  newStart: number,\n  newEnd: number,\n}\n\n/**\n * Removes duplicated ranges and ranges that are\n * fully captured by other ranges.\n */\nfunction simplifyChangedRanges(changes: ChangedRange[]): ChangedRange[] {\n  const uniqueChanges = removeDuplicates(changes)\n\n  return uniqueChanges.length === 1\n    ? uniqueChanges\n    : uniqueChanges.filter((change, index) => {\n      const rest = uniqueChanges.filter((_, i) => i !== index)\n\n      return !rest.some(otherChange => {\n        return change.oldStart >= otherChange.oldStart\n          && change.oldEnd <= otherChange.oldEnd\n          && change.newStart >= otherChange.newStart\n          && change.newEnd <= otherChange.newEnd\n      })\n    })\n}\n\n/**\n * Returns a list of changed ranges\n * based on the first and last state of all steps.\n */\nexport default function getChangedRanges(transform: Transform): ChangedRange[] {\n  const { mapping, steps } = transform\n  const changes: ChangedRange[] = []\n\n  mapping.maps.forEach((stepMap, index) => {\n    // This accounts for step changes where no range was actually altered\n    // e.g. when setting a mark, node attribute, etc.\n    // @ts-ignore\n    if (!stepMap.ranges.length) {\n      const step = steps[index] as Step & {\n        from?: number,\n        to?: number,\n      }\n\n      if (step.from === undefined || step.to === undefined) {\n        return\n      }\n\n      changes.push({\n        oldStart: step.from,\n        oldEnd: step.to,\n        newStart: step.from,\n        newEnd: step.to,\n      })\n    } else {\n      stepMap.forEach((from, to) => {\n        const newStart = mapping.slice(index).map(from, -1)\n        const newEnd = mapping.slice(index).map(to)\n        const oldStart = mapping.invert().map(newStart, -1)\n        const oldEnd = mapping.invert().map(newEnd)\n\n        changes.push({\n          oldStart,\n          oldEnd,\n          newStart,\n          newEnd,\n        })\n      })\n    }\n  })\n\n  return simplifyChangedRanges(changes)\n}\n","import removeDuplicates from './removeDuplicates'\n\n/**\n * Returns a list of duplicated items within an array.\n */\nexport default 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 { Extension, findChildren, findChildrenInRange } from '@tiptap/core'\nimport { Plugin, PluginKey, Transaction } from 'prosemirror-state'\nimport { Slice, Fragment, Node as ProseMirrorNode } from 'prosemirror-model'\nimport { v4 as uuidv4 } from 'uuid'\nimport combineTransactionSteps from './helpers/combineTransactionSteps'\nimport getChangedRanges from './helpers/getChangedRanges'\nimport findDuplicates from './helpers/findDuplicates'\n\nexport interface UniqueIdOptions {\n  attributeName: string,\n  types: string[],\n  generateId: () => 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  defaultOptions: {\n    attributeName: 'id',\n    types: [],\n    generateId: () => uuidv4(),\n    filterTransaction: null,\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 { 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)\n        && node.attrs[attributeName] === null\n    })\n\n    nodesWithoutId.forEach(({ node, pos }) => {\n      tr.setNodeMarkup(pos, undefined, {\n        ...node.attrs,\n        [attributeName]: generateId(),\n      })\n    })\n\n    view.dispatch(tr)\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 docChanges = transactions.some(transaction => transaction.docChanged)\n            && !oldState.doc.eq(newState.doc)\n          const filterTransactions = this.options.filterTransaction\n            && transactions.some(tr => !this.options.filterTransaction?.(tr))\n\n          if (!docChanges || filterTransactions) {\n            return\n          }\n\n          const { tr } = newState\n          const { types, attributeName, generateId } = this.options\n          const transform = combineTransactionSteps(oldState.doc, transactions)\n          const { mapping } = transform\n\n          // get changed ranges based on the old state\n          const changes = getChangedRanges(transform)\n\n          changes.forEach(change => {\n            const newRange = {\n              from: change.newStart,\n              to: change.newEnd,\n            }\n\n            const newNodes = findChildrenInRange(newState.doc, newRange, node => {\n              return types.includes(node.type.name)\n            })\n\n            const newIds = newNodes\n              .map(({ node }) => node.attrs[attributeName])\n              .filter(id => id !== null)\n\n            const duplicatedNewIds = findDuplicates(newIds)\n\n            newNodes.forEach(({ node, pos }) => {\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(),\n                })\n\n                return\n              }\n\n              // check if the node doesn’t exist in the old state\n              const { deleted } = mapping.invert().mapResult(pos)\n              const newNode = deleted && duplicatedNewIds.includes(id)\n\n              if (newNode) {\n                tr.setNodeMarkup(pos, undefined, {\n                  ...node.attrs,\n                  [attributeName]: generateId(),\n                })\n              }\n            })\n\n          })\n\n          if (!tr.steps.length) {\n            return\n          }\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 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 === '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                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"],"names":["Transform","Extension","uuidv4","findChildren","Plugin","PluginKey","findChildrenInRange","Fragment","Slice"],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@tiptap/extension-unique-id",
+  "description": "unique id extension for tiptap",
+  "version": "2.0.0-beta.1",
+  "homepage": "https://tiptap.dev",
+  "keywords": [
+    "tiptap",
+    "tiptap extension"
+  ],
+  "license": "MIT",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/ueberdosis"
+  },
+  "main": "dist/tiptap-extension-unique-id.cjs.js",
+  "umd": "dist/tiptap-extension-unique-id.umd.js",
+  "module": "dist/tiptap-extension-unique-id.esm.js",
+  "types": "dist/packages/extension-unique-id/src/index.d.ts",
+  "files": [
+    "src",
+    "dist"
+  ],
+  "peerDependencies": {
+    "@tiptap/core": "^2.0.0-beta.1"
+  },
+  "dependencies": {
+    "@types/uuid": "^8.3.1",
+    "prosemirror-model": "^1.14.3",
+    "prosemirror-state": "^1.3.4",
+    "prosemirror-transform": "^1.3.2",
+    "uuid": "^8.3.2"
+  },
+  "gitHead": "23420cec8b845a4f13d75da37c451c43d0c4b66c"
+}

package/src/helpers/arrayDifference.ts

@@ -0,0 +1,35 @@
+import removeDuplicates from './removeDuplicates'
+
+export interface ArrayDifference {
+  added: any[],
+  removed: any[],
+  common: any[],
+}
+
+/**
+ * Checks for added, removed and common items between two arrays.
+ */
+export default function arrayDifference(array1: any[], array2: any[]): ArrayDifference {
+  const uniqueCombinedArray = removeDuplicates([...array1, ...array2])
+  const data: ArrayDifference = {
+    added: [],
+    removed: [],
+    common: [],
+  }
+
+  uniqueCombinedArray.forEach(item => {
+    if (!array1.includes(item) && array2.includes(item)) {
+      data.added.push(item)
+    }
+
+    if (array1.includes(item) && !array2.includes(item)) {
+      data.removed.push(item)
+    }
+
+    if (array1.includes(item) && array2.includes(item)) {
+      data.common.push(item)
+    }
+  })
+
+  return data
+}

package/src/helpers/combineTransactionSteps.ts

@@ -0,0 +1,18 @@
+import { Node as ProseMirrorNode } from 'prosemirror-model'
+import { Transaction } from 'prosemirror-state'
+import { Transform } from 'prosemirror-transform'
+
+/**
+ * Returns a new `Transform` based on all steps of the passed transactions.
+ */
+export default function combineTransactionSteps(oldDoc: ProseMirrorNode, transactions: Transaction[]): Transform {
+  const transform = new Transform(oldDoc)
+
+  transactions.forEach(transaction => {
+    transaction.steps.forEach(step => {
+      transform.step(step)
+    })
+  })
+
+  return transform
+}

package/src/helpers/findDuplicates.ts

@@ -0,0 +1,11 @@
+import removeDuplicates from './removeDuplicates'
+
+/**
+ * Returns a list of duplicated items within an array.
+ */
+export default function findDuplicates(items: any[]): any[] {
+  const filtered = items.filter((el, index) => items.indexOf(el) !== index)
+  const duplicates = removeDuplicates(filtered)
+
+  return duplicates
+}

package/src/helpers/getChangedRanges.ts

@@ -0,0 +1,78 @@
+import { Transform, Step } from 'prosemirror-transform'
+import removeDuplicates from './removeDuplicates'
+
+export type ChangedRange = {
+  oldStart: number,
+  oldEnd: number,
+  newStart: number,
+  newEnd: number,
+}
+
+/**
+ * Removes duplicated ranges and ranges that are
+ * fully captured by other ranges.
+ */
+function simplifyChangedRanges(changes: ChangedRange[]): ChangedRange[] {
+  const uniqueChanges = removeDuplicates(changes)
+
+  return uniqueChanges.length === 1
+    ? uniqueChanges
+    : uniqueChanges.filter((change, index) => {
+      const rest = uniqueChanges.filter((_, i) => i !== index)
+
+      return !rest.some(otherChange => {
+        return change.oldStart >= otherChange.oldStart
+          && change.oldEnd <= otherChange.oldEnd
+          && change.newStart >= otherChange.newStart
+          && change.newEnd <= otherChange.newEnd
+      })
+    })
+}
+
+/**
+ * Returns a list of changed ranges
+ * based on the first and last state of all steps.
+ */
+export default function getChangedRanges(transform: Transform): ChangedRange[] {
+  const { mapping, steps } = transform
+  const changes: ChangedRange[] = []
+
+  mapping.maps.forEach((stepMap, index) => {
+    // This accounts for step changes where no range was actually altered
+    // e.g. when setting a mark, node attribute, etc.
+    // @ts-ignore
+    if (!stepMap.ranges.length) {
+      const step = steps[index] as Step & {
+        from?: number,
+        to?: number,
+      }
+
+      if (step.from === undefined || step.to === undefined) {
+        return
+      }
+
+      changes.push({
+        oldStart: step.from,
+        oldEnd: step.to,
+        newStart: step.from,
+        newEnd: step.to,
+      })
+    } else {
+      stepMap.forEach((from, to) => {
+        const newStart = mapping.slice(index).map(from, -1)
+        const newEnd = mapping.slice(index).map(to)
+        const oldStart = mapping.invert().map(newStart, -1)
+        const oldEnd = mapping.invert().map(newEnd)
+
+        changes.push({
+          oldStart,
+          oldEnd,
+          newStart,
+          newEnd,
+        })
+      })
+    }
+  })
+
+  return simplifyChangedRanges(changes)
+}

package/src/helpers/removeDuplicates.ts

@@ -0,0 +1,15 @@
+/**
+ * Removes duplicated values within an array.
+ * Supports numbers, strings and objects.
+ */
+export default function removeDuplicates<T>(array: T[], by = JSON.stringify): T[] {
+  const seen: Record<any, any> = {}
+
+  return array.filter(item => {
+    const key = by(item)
+
+    return Object.prototype.hasOwnProperty.call(seen, key)
+      ? false
+      : (seen[key] = true)
+  })
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+import { UniqueId } from './unique-id'
+
+export * from './unique-id'
+
+export default UniqueId

package/src/unique-id.ts

@@ -0,0 +1,245 @@
+import { Extension, findChildren, findChildrenInRange } from '@tiptap/core'
+import { Plugin, PluginKey, Transaction } from 'prosemirror-state'
+import { Slice, Fragment, Node as ProseMirrorNode } from 'prosemirror-model'
+import { v4 as uuidv4 } from 'uuid'
+import combineTransactionSteps from './helpers/combineTransactionSteps'
+import getChangedRanges from './helpers/getChangedRanges'
+import findDuplicates from './helpers/findDuplicates'
+
+export interface UniqueIdOptions {
+  attributeName: string,
+  types: string[],
+  generateId: () => any,
+  filterTransaction: ((transaction: Transaction) => boolean) | null,
+}
+
+export const UniqueId = Extension.create<UniqueIdOptions>({
+  name: 'uniqueId',
+
+  // we’ll set a very high priority to make sure this runs first
+  // and is compatible with `appendTransaction` hooks of other extensions
+  priority: 10000,
+
+  defaultOptions: {
+    attributeName: 'id',
+    types: [],
+    generateId: () => uuidv4(),
+    filterTransaction: null,
+  },
+
+  addGlobalAttributes() {
+    return [
+      {
+        types: this.options.types,
+        attributes: {
+          [this.options.attributeName]: {
+            default: null,
+            parseHTML: element => element.getAttribute(`data-${this.options.attributeName}`),
+            renderHTML: attributes => {
+              if (!attributes[this.options.attributeName]) {
+                return {}
+              }
+
+              return {
+                [`data-${this.options.attributeName}`]: attributes[this.options.attributeName],
+              }
+            },
+          },
+        },
+      },
+    ]
+  },
+
+  // check initial content for missing ids
+  onCreate() {
+    const { view, state } = this.editor
+    const { tr, doc } = state
+    const { types, attributeName, generateId } = this.options
+    const nodesWithoutId = findChildren(doc, node => {
+      return types.includes(node.type.name)
+        && node.attrs[attributeName] === null
+    })
+
+    nodesWithoutId.forEach(({ node, pos }) => {
+      tr.setNodeMarkup(pos, undefined, {
+        ...node.attrs,
+        [attributeName]: generateId(),
+      })
+    })
+
+    view.dispatch(tr)
+  },
+
+  addProseMirrorPlugins() {
+    let dragSourceElement: Element | null = null
+    let transformPasted = false
+
+    return [
+      new Plugin({
+        key: new PluginKey('uniqueId'),
+
+        appendTransaction: (transactions, oldState, newState) => {
+          const docChanges = transactions.some(transaction => transaction.docChanged)
+            && !oldState.doc.eq(newState.doc)
+          const filterTransactions = this.options.filterTransaction
+            && transactions.some(tr => !this.options.filterTransaction?.(tr))
+
+          if (!docChanges || filterTransactions) {
+            return
+          }
+
+          const { tr } = newState
+          const { types, attributeName, generateId } = this.options
+          const transform = combineTransactionSteps(oldState.doc, transactions)
+          const { mapping } = transform
+
+          // get changed ranges based on the old state
+          const changes = getChangedRanges(transform)
+
+          changes.forEach(change => {
+            const newRange = {
+              from: change.newStart,
+              to: change.newEnd,
+            }
+
+            const newNodes = findChildrenInRange(newState.doc, newRange, node => {
+              return types.includes(node.type.name)
+            })
+
+            const newIds = newNodes
+              .map(({ node }) => node.attrs[attributeName])
+              .filter(id => id !== null)
+
+            const duplicatedNewIds = findDuplicates(newIds)
+
+            newNodes.forEach(({ node, pos }) => {
+              // instead of checking `node.attrs[attributeName]` directly
+              // we look at the current state of the node within `tr.doc`.
+              // this helps to prevent adding new ids to the same node
+              // if the node changed multiple times within one transaction
+              const id = tr.doc.nodeAt(pos)?.attrs[attributeName]
+
+              if (id === null) {
+                tr.setNodeMarkup(pos, undefined, {
+                  ...node.attrs,
+                  [attributeName]: generateId(),
+                })
+
+                return
+              }
+
+              // check if the node doesn’t exist in the old state
+              const { deleted } = mapping.invert().mapResult(pos)
+              const newNode = deleted && duplicatedNewIds.includes(id)
+
+              if (newNode) {
+                tr.setNodeMarkup(pos, undefined, {
+                  ...node.attrs,
+                  [attributeName]: generateId(),
+                })
+              }
+            })
+
+          })
+
+          if (!tr.steps.length) {
+            return
+          }
+
+          return tr
+        },
+
+        // we register a global drag handler to track the current drag source element
+        view(view) {
+          const handleDragstart = (event: DragEvent) => {
+            dragSourceElement = view.dom.parentElement?.contains(event.target as Element)
+              ? view.dom.parentElement
+              : null
+          }
+
+          window.addEventListener('dragstart', handleDragstart)
+
+          return {
+            destroy() {
+              window.removeEventListener('dragstart', handleDragstart)
+            },
+          }
+        },
+
+        props: {
+          // `handleDOMEvents` is called before `transformPasted`
+          // so we can do some checks before
+          handleDOMEvents: {
+            // only create new ids for dropped content while holding `alt`
+            // or content is dragged from another editor
+            drop: (view, event) => {
+              if (
+                dragSourceElement !== view.dom.parentElement
+                || event.dataTransfer?.effectAllowed === 'copy'
+              ) {
+                dragSourceElement = null
+                transformPasted = true
+              }
+
+              return false
+            },
+            // always create new ids on pasted content
+            paste: () => {
+              transformPasted = true
+
+              return false
+            },
+          },
+
+          // we’ll remove ids for every pasted node
+          // so we can create a new one within `appendTransaction`
+          transformPasted: slice => {
+            if (!transformPasted) {
+              return slice
+            }
+
+            const { types, attributeName } = this.options
+            const removeId = (fragment: Fragment): Fragment => {
+              const list: ProseMirrorNode[] = []
+
+              fragment.forEach(node => {
+                // don’t touch text nodes
+                if (node.isText) {
+                  list.push(node)
+
+                  return
+                }
+
+                // check for any other child nodes
+                if (!types.includes(node.type.name)) {
+                  list.push(node.copy(removeId(node.content)))
+
+                  return
+                }
+
+                // remove id
+                const nodeWithoutId = node.type.create(
+                  {
+                    ...node.attrs,
+                    [attributeName]: null,
+                  },
+                  removeId(node.content),
+                  node.marks,
+                )
+                list.push(nodeWithoutId)
+              })
+
+              return Fragment.from(list)
+            }
+
+            // reset check
+            transformPasted = false
+
+            return new Slice(removeId(slice.content), slice.openStart, slice.openEnd)
+          },
+        },
+      }),
+    ]
+  },
+
+})