@tiptap/extension-unique-id 3.20.1 → 3.20.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/package.json +5 -5
  2. package/src/unique-id.ts +74 -5
  3. package/dist/index.cjs +0 -321
  4. package/dist/index.cjs.map +0 -1
  5. package/dist/index.d.cts +0 -81
  6. package/dist/index.d.ts +0 -81
  7. package/dist/index.js +0 -300
  8. package/dist/index.js.map +0 -1
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@tiptap/extension-unique-id",
3
3
  "description": "unique id extension for tiptap",
4
- "version": "3.20.1",
4
+ "version": "3.20.3",
5
5
  "homepage": "https://tiptap.dev/api/extensions/unique-id",
6
6
  "keywords": [
7
7
  "tiptap",
@@ -31,16 +31,16 @@
31
31
  "dist"
32
32
  ],
33
33
  "peerDependencies": {
34
- "@tiptap/core": "^3.20.1",
35
- "@tiptap/pm": "^3.20.1"
34
+ "@tiptap/core": "^3.20.3",
35
+ "@tiptap/pm": "^3.20.3"
36
36
  },
37
37
  "dependencies": {
38
38
  "uuid": "^10.0.0"
39
39
  },
40
40
  "devDependencies": {
41
41
  "@types/uuid": "^10.0.0",
42
- "@tiptap/core": "^3.20.1",
43
- "@tiptap/pm": "^3.20.1"
42
+ "@tiptap/core": "^3.20.3",
43
+ "@tiptap/pm": "^3.20.3"
44
44
  },
45
45
  "repository": {
46
46
  "type": "git",
package/src/unique-id.ts CHANGED
@@ -81,6 +81,18 @@ export const UniqueID = Extension.create<UniqueIDOptions>({
81
81
  }
82
82
  },
83
83
 
84
+ /**
85
+ * Extension storage for coordination between `addProseMirrorPlugins` and `appendTransaction`.
86
+ * `needsInitialIdGeneration` is set to `true` when the Collaboration extension is
87
+ * detected but no provider is available in its options, deferring ID creation
88
+ * to the first `y-sync$` transaction.
89
+ */
90
+ addStorage() {
91
+ return {
92
+ needsInitialIdGeneration: false,
93
+ }
94
+ },
95
+
84
96
  addGlobalAttributes() {
85
97
  const types = resolveTypes(this.options.types, this.extensions)
86
98
 
@@ -149,12 +161,14 @@ export const UniqueID = Extension.create<UniqueIDOptions>({
149
161
  * because we can't automatically add IDs when the provider is not yet synced
150
162
  * otherwise we end up with empty paragraphs
151
163
  */
152
- if (collab) {
153
- if (!provider) {
154
- return createIds()
164
+ if (collaboration) {
165
+ if (provider) {
166
+ provider.on('synced', createIds)
155
167
  }
156
-
157
- provider.on('synced', createIds)
168
+ // When collaboration is present but no provider is in extension options,
169
+ // needsInitialIdGeneration was already set in addProseMirrorPlugins
170
+ // (which runs synchronously during editor construction, before any
171
+ // y-sync$ transaction can arrive).
158
172
  } else {
159
173
  return createIds()
160
174
  }
@@ -165,6 +179,24 @@ export const UniqueID = Extension.create<UniqueIDOptions>({
165
179
  return []
166
180
  }
167
181
 
182
+ // Capture storage via closure so appendTransaction can access `needsInitialIdGeneration`.
183
+ // `extensionManager.extensions` returns different objects than `this` due to
184
+ // Tiptap's child-extension flattening, so we capture the reference directly.
185
+ const extensionStorage = this.storage
186
+
187
+ // Detect collaboration early — before any y-sync$ transaction can arrive.
188
+ // onCreate runs on a deferred setTimeout(0), so a y-sync$ transaction could
189
+ // be applied before it. Setting the flag here (synchronous during editor
190
+ // construction) ensures the first y-sync$ is always handled.
191
+ const collaboration = this.editor.extensionManager.extensions.find(ext => ext.name === 'collaboration')
192
+ const collaborationCaret = this.editor.extensionManager.extensions.find(ext => ext.name === 'collaborationCaret')
193
+ const collabExtensions = [collaboration, collaborationCaret].filter(Boolean)
194
+ const collabWithProvider = collabExtensions.find(ext => ext?.options?.provider)
195
+
196
+ if (collaboration && !collabWithProvider) {
197
+ extensionStorage.needsInitialIdGeneration = true
198
+ }
199
+
168
200
  let dragSourceElement: Element | null = null
169
201
  let transformPasted = false
170
202
  const types = resolveTypes(this.options.types, this.editor.extensionManager.extensions)
@@ -182,6 +214,43 @@ export const UniqueID = Extension.create<UniqueIDOptions>({
182
214
  const isCollabTransaction = transactions.find(tr => tr.getMeta('y-sync$'))
183
215
 
184
216
  if (isCollabTransaction) {
217
+ if (extensionStorage.needsInitialIdGeneration) {
218
+ extensionStorage.needsInitialIdGeneration = false
219
+
220
+ // Run full-document ID creation after the first Yjs sync.
221
+ // Use a seen-set so only the second+ occurrence of a duplicated
222
+ // ID is regenerated, preserving one existing ID per value.
223
+ const { tr } = newState
224
+ const { attributeName, generateID } = this.options
225
+ const allNodes = findChildren(newState.doc, node => types.includes(node.type.name))
226
+ const seen = new Set<string>()
227
+
228
+ allNodes.forEach(({ node, pos }) => {
229
+ const currentId = node.attrs[attributeName]
230
+
231
+ if (currentId === null || seen.has(currentId)) {
232
+ tr.setNodeMarkup(pos, undefined, {
233
+ ...node.attrs,
234
+ [attributeName]: generateID({ node, pos }),
235
+ })
236
+ } else {
237
+ seen.add(currentId)
238
+ }
239
+ })
240
+
241
+ if (!tr.steps.length) {
242
+ return
243
+ }
244
+
245
+ // Restore stored marks since setNodeMarkup resets them
246
+ tr.setStoredMarks(newState.tr.storedMarks)
247
+ // Mark this transaction as coming from UniqueID to prevent
248
+ // infinite loops with other extensions (e.g., TrailingNode)
249
+ tr.setMeta('__uniqueIDTransaction', true)
250
+ tr.setMeta('addToHistory', false)
251
+ return tr
252
+ }
253
+
185
254
  return
186
255
  }
187
256
 
package/dist/index.cjs DELETED
@@ -1,321 +0,0 @@
1
- "use strict";
2
- var __defProp = Object.defineProperty;
3
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
- var __getOwnPropNames = Object.getOwnPropertyNames;
5
- var __hasOwnProp = Object.prototype.hasOwnProperty;
6
- var __export = (target, all) => {
7
- for (var name in all)
8
- __defProp(target, name, { get: all[name], enumerable: true });
9
- };
10
- var __copyProps = (to, from, except, desc) => {
11
- if (from && typeof from === "object" || typeof from === "function") {
12
- for (let key of __getOwnPropNames(from))
13
- if (!__hasOwnProp.call(to, key) && key !== except)
14
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
- }
16
- return to;
17
- };
18
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
-
20
- // src/index.ts
21
- var index_exports = {};
22
- __export(index_exports, {
23
- UniqueID: () => UniqueID,
24
- default: () => index_default,
25
- generateUniqueIds: () => generateUniqueIds
26
- });
27
- module.exports = __toCommonJS(index_exports);
28
-
29
- // src/unique-id.ts
30
- var import_core = require("@tiptap/core");
31
- var import_model = require("@tiptap/pm/model");
32
- var import_state = require("@tiptap/pm/state");
33
- var import_uuid = require("uuid");
34
-
35
- // src/helpers/findDuplicates.ts
36
- function findDuplicates(items) {
37
- const seen = /* @__PURE__ */ new Set();
38
- const duplicates = /* @__PURE__ */ new Set();
39
- items.forEach((item) => {
40
- if (seen.has(item)) {
41
- duplicates.add(item);
42
- } else {
43
- seen.add(item);
44
- }
45
- });
46
- return Array.from(duplicates);
47
- }
48
-
49
- // src/unique-id.ts
50
- var resolveTypes = (types, extensions) => {
51
- if (types !== "all") {
52
- return types;
53
- }
54
- const { nodeExtensions } = (0, import_core.splitExtensions)(extensions);
55
- return nodeExtensions.map((extension) => extension.name).filter((type) => type !== "doc" && type !== "text");
56
- };
57
- var UniqueID = import_core.Extension.create({
58
- name: "uniqueID",
59
- // we’ll set a very high priority to make sure this runs first
60
- // and is compatible with `appendTransaction` hooks of other extensions
61
- priority: 1e4,
62
- addOptions() {
63
- return {
64
- attributeName: "id",
65
- types: [],
66
- generateID: () => (0, import_uuid.v4)(),
67
- filterTransaction: null,
68
- updateDocument: true
69
- };
70
- },
71
- addGlobalAttributes() {
72
- const types = resolveTypes(this.options.types, this.extensions);
73
- return [
74
- {
75
- types,
76
- attributes: {
77
- [this.options.attributeName]: {
78
- default: null,
79
- parseHTML: (element) => element.getAttribute(`data-${this.options.attributeName}`),
80
- renderHTML: (attributes) => {
81
- if (!attributes[this.options.attributeName]) {
82
- return {};
83
- }
84
- return {
85
- [`data-${this.options.attributeName}`]: attributes[this.options.attributeName]
86
- };
87
- }
88
- }
89
- }
90
- }
91
- ];
92
- },
93
- // check initial content for missing ids
94
- onCreate() {
95
- var _a;
96
- if (!this.options.updateDocument) {
97
- return;
98
- }
99
- const collaboration = this.editor.extensionManager.extensions.find((ext) => ext.name === "collaboration");
100
- const collaborationCaret = this.editor.extensionManager.extensions.find((ext) => ext.name === "collaborationCaret");
101
- const collabExtensions = [collaboration, collaborationCaret].filter(Boolean);
102
- const collab = collabExtensions.find((ext) => {
103
- var _a2;
104
- return (_a2 = ext == null ? void 0 : ext.options) == null ? void 0 : _a2.provider;
105
- });
106
- const provider = (_a = collab == null ? void 0 : collab.options) == null ? void 0 : _a.provider;
107
- const createIds = () => {
108
- const { view, state } = this.editor;
109
- const { tr, doc } = state;
110
- const types = resolveTypes(this.options.types, this.editor.extensionManager.extensions);
111
- const { attributeName, generateID } = this.options;
112
- const nodesWithoutId = (0, import_core.findChildren)(doc, (node) => {
113
- return types.includes(node.type.name) && node.attrs[attributeName] === null;
114
- });
115
- nodesWithoutId.forEach(({ node, pos }) => {
116
- tr.setNodeMarkup(pos, void 0, {
117
- ...node.attrs,
118
- [attributeName]: generateID({ node, pos })
119
- });
120
- });
121
- tr.setMeta("addToHistory", false);
122
- view.dispatch(tr);
123
- if (provider) {
124
- provider.off("synced", createIds);
125
- }
126
- };
127
- if (collab) {
128
- if (!provider) {
129
- return createIds();
130
- }
131
- provider.on("synced", createIds);
132
- } else {
133
- return createIds();
134
- }
135
- },
136
- addProseMirrorPlugins() {
137
- if (!this.options.updateDocument) {
138
- return [];
139
- }
140
- let dragSourceElement = null;
141
- let transformPasted = false;
142
- const types = resolveTypes(this.options.types, this.editor.extensionManager.extensions);
143
- return [
144
- new import_state.Plugin({
145
- key: new import_state.PluginKey("uniqueID"),
146
- appendTransaction: (transactions, oldState, newState) => {
147
- const hasDocChanges = transactions.some((transaction) => transaction.docChanged) && !oldState.doc.eq(newState.doc);
148
- const filterTransactions = this.options.filterTransaction && transactions.some((tr2) => {
149
- var _a, _b;
150
- return !((_b = (_a = this.options).filterTransaction) == null ? void 0 : _b.call(_a, tr2));
151
- });
152
- const isCollabTransaction = transactions.find((tr2) => tr2.getMeta("y-sync$"));
153
- if (isCollabTransaction) {
154
- return;
155
- }
156
- if (!hasDocChanges || filterTransactions) {
157
- return;
158
- }
159
- const { tr } = newState;
160
- const { attributeName, generateID } = this.options;
161
- const transform = (0, import_core.combineTransactionSteps)(oldState.doc, transactions);
162
- const { mapping } = transform;
163
- const changes = (0, import_core.getChangedRanges)(transform);
164
- changes.forEach(({ newRange }) => {
165
- const newNodes = (0, import_core.findChildrenInRange)(newState.doc, newRange, (node) => {
166
- return types.includes(node.type.name);
167
- });
168
- const newIds = newNodes.map(({ node }) => node.attrs[attributeName]).filter((id) => id !== null);
169
- newNodes.forEach(({ node, pos }, i) => {
170
- var _a;
171
- const id = (_a = tr.doc.nodeAt(pos)) == null ? void 0 : _a.attrs[attributeName];
172
- if (id === null) {
173
- tr.setNodeMarkup(pos, void 0, {
174
- ...node.attrs,
175
- [attributeName]: generateID({ node, pos })
176
- });
177
- return;
178
- }
179
- const nextNode = newNodes[i + 1];
180
- if (nextNode && node.content.size === 0) {
181
- const nextNodeInTr = tr.doc.nodeAt(nextNode.pos);
182
- if ((nextNodeInTr == null ? void 0 : nextNodeInTr.attrs[attributeName]) && nextNodeInTr.attrs[attributeName] !== id) {
183
- return;
184
- }
185
- tr.setNodeMarkup(nextNode.pos, void 0, {
186
- ...nextNode.node.attrs,
187
- [attributeName]: id
188
- });
189
- newIds[i + 1] = id;
190
- const generatedId = generateID({ node, pos });
191
- tr.setNodeMarkup(pos, void 0, {
192
- ...node.attrs,
193
- [attributeName]: generatedId
194
- });
195
- newIds[i] = generatedId;
196
- return tr;
197
- }
198
- const duplicatedNewIds = findDuplicates(newIds);
199
- const { deleted } = mapping.invert().mapResult(pos);
200
- const newNode = deleted && duplicatedNewIds.includes(id);
201
- if (newNode) {
202
- tr.setNodeMarkup(pos, void 0, {
203
- ...node.attrs,
204
- [attributeName]: generateID({ node, pos })
205
- });
206
- }
207
- });
208
- });
209
- if (!tr.steps.length) {
210
- return;
211
- }
212
- tr.setStoredMarks(newState.tr.storedMarks);
213
- tr.setMeta("__uniqueIDTransaction", true);
214
- return tr;
215
- },
216
- // we register a global drag handler to track the current drag source element
217
- view(view) {
218
- const handleDragstart = (event) => {
219
- var _a;
220
- dragSourceElement = ((_a = view.dom.parentElement) == null ? void 0 : _a.contains(event.target)) ? view.dom.parentElement : null;
221
- };
222
- window.addEventListener("dragstart", handleDragstart);
223
- return {
224
- destroy() {
225
- window.removeEventListener("dragstart", handleDragstart);
226
- }
227
- };
228
- },
229
- props: {
230
- // `handleDOMEvents` is called before `transformPasted`
231
- // so we can do some checks before
232
- handleDOMEvents: {
233
- // only create new ids for dropped content
234
- // or dropped content while holding `alt`
235
- // or content is dragged from another editor
236
- drop: (view, event) => {
237
- var _a, _b;
238
- if (dragSourceElement !== view.dom.parentElement || ((_a = event.dataTransfer) == null ? void 0 : _a.effectAllowed) === "copyMove" || ((_b = event.dataTransfer) == null ? void 0 : _b.effectAllowed) === "copy") {
239
- dragSourceElement = null;
240
- transformPasted = true;
241
- }
242
- return false;
243
- },
244
- // always create new ids on pasted content
245
- paste: () => {
246
- transformPasted = true;
247
- return false;
248
- }
249
- },
250
- // we’ll remove ids for every pasted node
251
- // so we can create a new one within `appendTransaction`
252
- transformPasted: (slice) => {
253
- if (!transformPasted) {
254
- return slice;
255
- }
256
- const { attributeName } = this.options;
257
- const removeId = (fragment) => {
258
- const list = [];
259
- fragment.forEach((node) => {
260
- if (node.isText) {
261
- list.push(node);
262
- return;
263
- }
264
- if (!types.includes(node.type.name)) {
265
- list.push(node.copy(removeId(node.content)));
266
- return;
267
- }
268
- const nodeWithoutId = node.type.create(
269
- {
270
- ...node.attrs,
271
- [attributeName]: null
272
- },
273
- removeId(node.content),
274
- node.marks
275
- );
276
- list.push(nodeWithoutId);
277
- });
278
- return import_model.Fragment.from(list);
279
- };
280
- transformPasted = false;
281
- return new import_model.Slice(removeId(slice.content), slice.openStart, slice.openEnd);
282
- }
283
- }
284
- })
285
- ];
286
- }
287
- });
288
-
289
- // src/generate-unique-ids.ts
290
- var import_core2 = require("@tiptap/core");
291
- var import_model2 = require("@tiptap/pm/model");
292
- var import_state2 = require("@tiptap/pm/state");
293
- function generateUniqueIds(doc, extensions) {
294
- const uniqueIDExtension = extensions.find((ext) => ext.name === "uniqueID");
295
- if (!uniqueIDExtension) {
296
- throw new Error("UniqueID extension not found in the extensions array");
297
- }
298
- const schema = (0, import_core2.getSchema)([...extensions.filter((ext) => ext.name !== "uniqueID"), uniqueIDExtension]);
299
- const { types: configuredTypes, attributeName, generateID } = uniqueIDExtension.options;
300
- const types = configuredTypes === "all" ? Object.keys(schema.nodes).filter((type) => type !== "doc" && type !== "text") : configuredTypes;
301
- const contentNode = import_model2.Node.fromJSON(schema, doc);
302
- const nodesWithoutId = (0, import_core2.findChildren)(contentNode, (node) => {
303
- return !node.attrs[attributeName] && types.includes(node.type.name);
304
- });
305
- let tr = import_state2.EditorState.create({
306
- doc: contentNode
307
- }).tr;
308
- for (const { node, pos } of nodesWithoutId) {
309
- tr = tr.setNodeAttribute(pos, attributeName, generateID({ node, pos }));
310
- }
311
- return tr.doc.toJSON();
312
- }
313
-
314
- // src/index.ts
315
- var index_default = UniqueID;
316
- // Annotate the CommonJS export names for ESM import in node:
317
- 0 && (module.exports = {
318
- UniqueID,
319
- generateUniqueIds
320
- });
321
- //# sourceMappingURL=index.cjs.map
package/dist/index.cjs.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/index.ts","../src/unique-id.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 {\n type Extensions,\n combineTransactionSteps,\n Extension,\n findChildren,\n findChildrenInRange,\n getChangedRanges,\n splitExtensions,\n} 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 * Use `\"all\"` to add IDs to every node type except `doc` and `text`.\n * @default []\n */\n types: string[] | 'all'\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 * Whether to update the document by adding unique IDs to the nodes. Set this\n * property to `false` if the document is in `readonly` mode, is immutable, or\n * you don't want it to be modified.\n *\n * @default true\n */\n updateDocument: boolean\n}\n\nconst resolveTypes = (types: UniqueIDOptions['types'], extensions: Extensions): string[] => {\n if (types !== 'all') {\n return types\n }\n\n const { nodeExtensions } = splitExtensions(extensions)\n\n return nodeExtensions.map(extension => extension.name).filter(type => type !== 'doc' && type !== 'text')\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 updateDocument: true,\n }\n },\n\n addGlobalAttributes() {\n const types = resolveTypes(this.options.types, this.extensions)\n\n return [\n {\n 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 if (!this.options.updateDocument) {\n return\n }\n\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 = resolveTypes(this.options.types, this.editor.extensionManager.extensions)\n const { 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 if (!this.options.updateDocument) {\n return []\n }\n\n let dragSourceElement: Element | null = null\n let transformPasted = false\n const types = resolveTypes(this.options.types, this.editor.extensionManager.extensions)\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 { 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 const nextNodeInTr = tr.doc.nodeAt(nextNode.pos)\n if (nextNodeInTr?.attrs[attributeName] && nextNodeInTr.attrs[attributeName] !== id) {\n return\n }\n\n tr.setNodeMarkup(nextNode.pos, undefined, {\n ...nextNode.node.attrs,\n [attributeName]: id,\n })\n newIds[i + 1] = id\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 // Mark this transaction as coming from UniqueID\n // to prevent infinite loops with other extensions (e.g., TrailingNode)\n tr.setMeta('__uniqueIDTransaction', true)\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 { 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 * Returns a list of duplicated items within an array.\n */\nexport function findDuplicates(items: any[]): any[] {\n const seen = new Set()\n const duplicates = new Set<any>()\n\n items.forEach(item => {\n if (seen.has(item)) {\n duplicates.add(item)\n } else {\n seen.add(item)\n }\n })\n\n return Array.from(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 // Convert the JSON content to a ProseMirror node\n const schema = getSchema([...extensions.filter(ext => ext.name !== 'uniqueID'), uniqueIDExtension])\n const { types: configuredTypes, attributeName, generateID } = uniqueIDExtension.options\n const types =\n configuredTypes === 'all'\n ? Object.keys(schema.nodes).filter(type => type !== 'doc' && type !== 'text')\n : configuredTypes\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 DELETED
@@ -1,81 +0,0 @@
1
- import { Extension, JSONContent, Extensions } from '@tiptap/core';
2
- import { Node } from '@tiptap/pm/model';
3
- import { Transaction } from '@tiptap/pm/state';
4
-
5
- type UniqueIDGenerationContext = {
6
- node: Node;
7
- pos: number;
8
- };
9
- interface UniqueIDOptions {
10
- /**
11
- * The name of the attribute to add the unique ID to.
12
- * @default "id"
13
- */
14
- attributeName: string;
15
- /**
16
- * The types of nodes to add unique IDs to.
17
- * Use `"all"` to add IDs to every node type except `doc` and `text`.
18
- * @default []
19
- */
20
- types: string[] | 'all';
21
- /**
22
- * The function that generates the unique ID. By default, a UUID v4 is
23
- * generated. However, you can provide your own function to generate the
24
- * unique ID based on the node type and the position.
25
- */
26
- generateID: (ctx: UniqueIDGenerationContext) => any;
27
- /**
28
- * Ignore some mutations, for example applied from other users through the collaboration plugin.
29
- *
30
- * @default null
31
- */
32
- filterTransaction: ((transaction: Transaction) => boolean) | null;
33
- /**
34
- * Whether to update the document by adding unique IDs to the nodes. Set this
35
- * property to `false` if the document is in `readonly` mode, is immutable, or
36
- * you don't want it to be modified.
37
- *
38
- * @default true
39
- */
40
- updateDocument: boolean;
41
- }
42
- declare const UniqueID: Extension<UniqueIDOptions, any>;
43
-
44
- /**
45
- * Creates a new document with unique IDs added to the nodes. Does the same
46
- * thing as the UniqueID extension, but without the need to create an `Editor`
47
- * instance. This lets you add unique IDs to the document in the server.
48
- *
49
- * When you call it, include the `UniqueID` extension in the `extensions` array.
50
- * The configuration from the `UniqueID` extension will be picked up
51
- * automatically, including its configuration options like `types` and
52
- * `attributeName`.
53
- *
54
- * @see `UniqueID` extension for more information.
55
- *
56
- * @throws {Error} If the `UniqueID` extension is not found in the extensions array.
57
- *
58
- * @example
59
- * const doc = {
60
- * type: 'doc',
61
- * content: [
62
- * { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }] }
63
- * ]
64
- * }
65
- * const newDoc = addUniqueIds(doc, [StarterKit, UniqueID.configure({ types: ['paragraph', 'heading'] })])
66
- * console.log(newDoc)
67
- * // Result:
68
- * // {
69
- * // type: 'doc',
70
- * // content: [
71
- * // { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }], id: '123' }
72
- * // ]
73
- * // }
74
- *
75
- * @param doc - A Tiptap JSON document to add unique IDs to.
76
- * @param extensions - The extensions to use. Must include the `UniqueID` extension.
77
- * @returns The updated Tiptap JSON document, with the unique IDs added to the nodes.
78
- */
79
- declare function generateUniqueIds(doc: JSONContent, extensions: Extensions): JSONContent;
80
-
81
- export { UniqueID, type UniqueIDGenerationContext, type UniqueIDOptions, UniqueID as default, generateUniqueIds };
package/dist/index.d.ts DELETED
@@ -1,81 +0,0 @@
1
- import { Extension, JSONContent, Extensions } from '@tiptap/core';
2
- import { Node } from '@tiptap/pm/model';
3
- import { Transaction } from '@tiptap/pm/state';
4
-
5
- type UniqueIDGenerationContext = {
6
- node: Node;
7
- pos: number;
8
- };
9
- interface UniqueIDOptions {
10
- /**
11
- * The name of the attribute to add the unique ID to.
12
- * @default "id"
13
- */
14
- attributeName: string;
15
- /**
16
- * The types of nodes to add unique IDs to.
17
- * Use `"all"` to add IDs to every node type except `doc` and `text`.
18
- * @default []
19
- */
20
- types: string[] | 'all';
21
- /**
22
- * The function that generates the unique ID. By default, a UUID v4 is
23
- * generated. However, you can provide your own function to generate the
24
- * unique ID based on the node type and the position.
25
- */
26
- generateID: (ctx: UniqueIDGenerationContext) => any;
27
- /**
28
- * Ignore some mutations, for example applied from other users through the collaboration plugin.
29
- *
30
- * @default null
31
- */
32
- filterTransaction: ((transaction: Transaction) => boolean) | null;
33
- /**
34
- * Whether to update the document by adding unique IDs to the nodes. Set this
35
- * property to `false` if the document is in `readonly` mode, is immutable, or
36
- * you don't want it to be modified.
37
- *
38
- * @default true
39
- */
40
- updateDocument: boolean;
41
- }
42
- declare const UniqueID: Extension<UniqueIDOptions, any>;
43
-
44
- /**
45
- * Creates a new document with unique IDs added to the nodes. Does the same
46
- * thing as the UniqueID extension, but without the need to create an `Editor`
47
- * instance. This lets you add unique IDs to the document in the server.
48
- *
49
- * When you call it, include the `UniqueID` extension in the `extensions` array.
50
- * The configuration from the `UniqueID` extension will be picked up
51
- * automatically, including its configuration options like `types` and
52
- * `attributeName`.
53
- *
54
- * @see `UniqueID` extension for more information.
55
- *
56
- * @throws {Error} If the `UniqueID` extension is not found in the extensions array.
57
- *
58
- * @example
59
- * const doc = {
60
- * type: 'doc',
61
- * content: [
62
- * { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }] }
63
- * ]
64
- * }
65
- * const newDoc = addUniqueIds(doc, [StarterKit, UniqueID.configure({ types: ['paragraph', 'heading'] })])
66
- * console.log(newDoc)
67
- * // Result:
68
- * // {
69
- * // type: 'doc',
70
- * // content: [
71
- * // { type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }], id: '123' }
72
- * // ]
73
- * // }
74
- *
75
- * @param doc - A Tiptap JSON document to add unique IDs to.
76
- * @param extensions - The extensions to use. Must include the `UniqueID` extension.
77
- * @returns The updated Tiptap JSON document, with the unique IDs added to the nodes.
78
- */
79
- declare function generateUniqueIds(doc: JSONContent, extensions: Extensions): JSONContent;
80
-
81
- export { UniqueID, type UniqueIDGenerationContext, type UniqueIDOptions, UniqueID as default, generateUniqueIds };
package/dist/index.js DELETED
@@ -1,300 +0,0 @@
1
- // src/unique-id.ts
2
- import {
3
- combineTransactionSteps,
4
- Extension,
5
- findChildren,
6
- findChildrenInRange,
7
- getChangedRanges,
8
- splitExtensions
9
- } from "@tiptap/core";
10
- import { Fragment, Slice } from "@tiptap/pm/model";
11
- import { Plugin, PluginKey } from "@tiptap/pm/state";
12
- import { v4 as uuidv4 } from "uuid";
13
-
14
- // src/helpers/findDuplicates.ts
15
- function findDuplicates(items) {
16
- const seen = /* @__PURE__ */ new Set();
17
- const duplicates = /* @__PURE__ */ new Set();
18
- items.forEach((item) => {
19
- if (seen.has(item)) {
20
- duplicates.add(item);
21
- } else {
22
- seen.add(item);
23
- }
24
- });
25
- return Array.from(duplicates);
26
- }
27
-
28
- // src/unique-id.ts
29
- var resolveTypes = (types, extensions) => {
30
- if (types !== "all") {
31
- return types;
32
- }
33
- const { nodeExtensions } = splitExtensions(extensions);
34
- return nodeExtensions.map((extension) => extension.name).filter((type) => type !== "doc" && type !== "text");
35
- };
36
- var UniqueID = Extension.create({
37
- name: "uniqueID",
38
- // we’ll set a very high priority to make sure this runs first
39
- // and is compatible with `appendTransaction` hooks of other extensions
40
- priority: 1e4,
41
- addOptions() {
42
- return {
43
- attributeName: "id",
44
- types: [],
45
- generateID: () => uuidv4(),
46
- filterTransaction: null,
47
- updateDocument: true
48
- };
49
- },
50
- addGlobalAttributes() {
51
- const types = resolveTypes(this.options.types, this.extensions);
52
- return [
53
- {
54
- types,
55
- attributes: {
56
- [this.options.attributeName]: {
57
- default: null,
58
- parseHTML: (element) => element.getAttribute(`data-${this.options.attributeName}`),
59
- renderHTML: (attributes) => {
60
- if (!attributes[this.options.attributeName]) {
61
- return {};
62
- }
63
- return {
64
- [`data-${this.options.attributeName}`]: attributes[this.options.attributeName]
65
- };
66
- }
67
- }
68
- }
69
- }
70
- ];
71
- },
72
- // check initial content for missing ids
73
- onCreate() {
74
- var _a;
75
- if (!this.options.updateDocument) {
76
- return;
77
- }
78
- const collaboration = this.editor.extensionManager.extensions.find((ext) => ext.name === "collaboration");
79
- const collaborationCaret = this.editor.extensionManager.extensions.find((ext) => ext.name === "collaborationCaret");
80
- const collabExtensions = [collaboration, collaborationCaret].filter(Boolean);
81
- const collab = collabExtensions.find((ext) => {
82
- var _a2;
83
- return (_a2 = ext == null ? void 0 : ext.options) == null ? void 0 : _a2.provider;
84
- });
85
- const provider = (_a = collab == null ? void 0 : collab.options) == null ? void 0 : _a.provider;
86
- const createIds = () => {
87
- const { view, state } = this.editor;
88
- const { tr, doc } = state;
89
- const types = resolveTypes(this.options.types, this.editor.extensionManager.extensions);
90
- const { attributeName, generateID } = this.options;
91
- const nodesWithoutId = findChildren(doc, (node) => {
92
- return types.includes(node.type.name) && node.attrs[attributeName] === null;
93
- });
94
- nodesWithoutId.forEach(({ node, pos }) => {
95
- tr.setNodeMarkup(pos, void 0, {
96
- ...node.attrs,
97
- [attributeName]: generateID({ node, pos })
98
- });
99
- });
100
- tr.setMeta("addToHistory", false);
101
- view.dispatch(tr);
102
- if (provider) {
103
- provider.off("synced", createIds);
104
- }
105
- };
106
- if (collab) {
107
- if (!provider) {
108
- return createIds();
109
- }
110
- provider.on("synced", createIds);
111
- } else {
112
- return createIds();
113
- }
114
- },
115
- addProseMirrorPlugins() {
116
- if (!this.options.updateDocument) {
117
- return [];
118
- }
119
- let dragSourceElement = null;
120
- let transformPasted = false;
121
- const types = resolveTypes(this.options.types, this.editor.extensionManager.extensions);
122
- return [
123
- new Plugin({
124
- key: new PluginKey("uniqueID"),
125
- appendTransaction: (transactions, oldState, newState) => {
126
- const hasDocChanges = transactions.some((transaction) => transaction.docChanged) && !oldState.doc.eq(newState.doc);
127
- const filterTransactions = this.options.filterTransaction && transactions.some((tr2) => {
128
- var _a, _b;
129
- return !((_b = (_a = this.options).filterTransaction) == null ? void 0 : _b.call(_a, tr2));
130
- });
131
- const isCollabTransaction = transactions.find((tr2) => tr2.getMeta("y-sync$"));
132
- if (isCollabTransaction) {
133
- return;
134
- }
135
- if (!hasDocChanges || filterTransactions) {
136
- return;
137
- }
138
- const { tr } = newState;
139
- const { attributeName, generateID } = this.options;
140
- const transform = combineTransactionSteps(oldState.doc, transactions);
141
- const { mapping } = transform;
142
- const changes = getChangedRanges(transform);
143
- changes.forEach(({ newRange }) => {
144
- const newNodes = findChildrenInRange(newState.doc, newRange, (node) => {
145
- return types.includes(node.type.name);
146
- });
147
- const newIds = newNodes.map(({ node }) => node.attrs[attributeName]).filter((id) => id !== null);
148
- newNodes.forEach(({ node, pos }, i) => {
149
- var _a;
150
- const id = (_a = tr.doc.nodeAt(pos)) == null ? void 0 : _a.attrs[attributeName];
151
- if (id === null) {
152
- tr.setNodeMarkup(pos, void 0, {
153
- ...node.attrs,
154
- [attributeName]: generateID({ node, pos })
155
- });
156
- return;
157
- }
158
- const nextNode = newNodes[i + 1];
159
- if (nextNode && node.content.size === 0) {
160
- const nextNodeInTr = tr.doc.nodeAt(nextNode.pos);
161
- if ((nextNodeInTr == null ? void 0 : nextNodeInTr.attrs[attributeName]) && nextNodeInTr.attrs[attributeName] !== id) {
162
- return;
163
- }
164
- tr.setNodeMarkup(nextNode.pos, void 0, {
165
- ...nextNode.node.attrs,
166
- [attributeName]: id
167
- });
168
- newIds[i + 1] = id;
169
- const generatedId = generateID({ node, pos });
170
- tr.setNodeMarkup(pos, void 0, {
171
- ...node.attrs,
172
- [attributeName]: generatedId
173
- });
174
- newIds[i] = generatedId;
175
- return tr;
176
- }
177
- const duplicatedNewIds = findDuplicates(newIds);
178
- const { deleted } = mapping.invert().mapResult(pos);
179
- const newNode = deleted && duplicatedNewIds.includes(id);
180
- if (newNode) {
181
- tr.setNodeMarkup(pos, void 0, {
182
- ...node.attrs,
183
- [attributeName]: generateID({ node, pos })
184
- });
185
- }
186
- });
187
- });
188
- if (!tr.steps.length) {
189
- return;
190
- }
191
- tr.setStoredMarks(newState.tr.storedMarks);
192
- tr.setMeta("__uniqueIDTransaction", true);
193
- return tr;
194
- },
195
- // we register a global drag handler to track the current drag source element
196
- view(view) {
197
- const handleDragstart = (event) => {
198
- var _a;
199
- dragSourceElement = ((_a = view.dom.parentElement) == null ? void 0 : _a.contains(event.target)) ? view.dom.parentElement : null;
200
- };
201
- window.addEventListener("dragstart", handleDragstart);
202
- return {
203
- destroy() {
204
- window.removeEventListener("dragstart", handleDragstart);
205
- }
206
- };
207
- },
208
- props: {
209
- // `handleDOMEvents` is called before `transformPasted`
210
- // so we can do some checks before
211
- handleDOMEvents: {
212
- // only create new ids for dropped content
213
- // or dropped content while holding `alt`
214
- // or content is dragged from another editor
215
- drop: (view, event) => {
216
- var _a, _b;
217
- if (dragSourceElement !== view.dom.parentElement || ((_a = event.dataTransfer) == null ? void 0 : _a.effectAllowed) === "copyMove" || ((_b = event.dataTransfer) == null ? void 0 : _b.effectAllowed) === "copy") {
218
- dragSourceElement = null;
219
- transformPasted = true;
220
- }
221
- return false;
222
- },
223
- // always create new ids on pasted content
224
- paste: () => {
225
- transformPasted = true;
226
- return false;
227
- }
228
- },
229
- // we’ll remove ids for every pasted node
230
- // so we can create a new one within `appendTransaction`
231
- transformPasted: (slice) => {
232
- if (!transformPasted) {
233
- return slice;
234
- }
235
- const { attributeName } = this.options;
236
- const removeId = (fragment) => {
237
- const list = [];
238
- fragment.forEach((node) => {
239
- if (node.isText) {
240
- list.push(node);
241
- return;
242
- }
243
- if (!types.includes(node.type.name)) {
244
- list.push(node.copy(removeId(node.content)));
245
- return;
246
- }
247
- const nodeWithoutId = node.type.create(
248
- {
249
- ...node.attrs,
250
- [attributeName]: null
251
- },
252
- removeId(node.content),
253
- node.marks
254
- );
255
- list.push(nodeWithoutId);
256
- });
257
- return Fragment.from(list);
258
- };
259
- transformPasted = false;
260
- return new Slice(removeId(slice.content), slice.openStart, slice.openEnd);
261
- }
262
- }
263
- })
264
- ];
265
- }
266
- });
267
-
268
- // src/generate-unique-ids.ts
269
- import { findChildren as findChildren2, getSchema } from "@tiptap/core";
270
- import { Node } from "@tiptap/pm/model";
271
- import { EditorState } from "@tiptap/pm/state";
272
- function generateUniqueIds(doc, extensions) {
273
- const uniqueIDExtension = extensions.find((ext) => ext.name === "uniqueID");
274
- if (!uniqueIDExtension) {
275
- throw new Error("UniqueID extension not found in the extensions array");
276
- }
277
- const schema = getSchema([...extensions.filter((ext) => ext.name !== "uniqueID"), uniqueIDExtension]);
278
- const { types: configuredTypes, attributeName, generateID } = uniqueIDExtension.options;
279
- const types = configuredTypes === "all" ? Object.keys(schema.nodes).filter((type) => type !== "doc" && type !== "text") : configuredTypes;
280
- const contentNode = Node.fromJSON(schema, doc);
281
- const nodesWithoutId = findChildren2(contentNode, (node) => {
282
- return !node.attrs[attributeName] && types.includes(node.type.name);
283
- });
284
- let tr = EditorState.create({
285
- doc: contentNode
286
- }).tr;
287
- for (const { node, pos } of nodesWithoutId) {
288
- tr = tr.setNodeAttribute(pos, attributeName, generateID({ node, pos }));
289
- }
290
- return tr.doc.toJSON();
291
- }
292
-
293
- // src/index.ts
294
- var index_default = UniqueID;
295
- export {
296
- UniqueID,
297
- index_default as default,
298
- generateUniqueIds
299
- };
300
- //# sourceMappingURL=index.js.map
package/dist/index.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/unique-id.ts","../src/helpers/findDuplicates.ts","../src/generate-unique-ids.ts","../src/index.ts"],"sourcesContent":["import {\n type Extensions,\n combineTransactionSteps,\n Extension,\n findChildren,\n findChildrenInRange,\n getChangedRanges,\n splitExtensions,\n} 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 * Use `\"all\"` to add IDs to every node type except `doc` and `text`.\n * @default []\n */\n types: string[] | 'all'\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 * Whether to update the document by adding unique IDs to the nodes. Set this\n * property to `false` if the document is in `readonly` mode, is immutable, or\n * you don't want it to be modified.\n *\n * @default true\n */\n updateDocument: boolean\n}\n\nconst resolveTypes = (types: UniqueIDOptions['types'], extensions: Extensions): string[] => {\n if (types !== 'all') {\n return types\n }\n\n const { nodeExtensions } = splitExtensions(extensions)\n\n return nodeExtensions.map(extension => extension.name).filter(type => type !== 'doc' && type !== 'text')\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 updateDocument: true,\n }\n },\n\n addGlobalAttributes() {\n const types = resolveTypes(this.options.types, this.extensions)\n\n return [\n {\n 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 if (!this.options.updateDocument) {\n return\n }\n\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 = resolveTypes(this.options.types, this.editor.extensionManager.extensions)\n const { 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 if (!this.options.updateDocument) {\n return []\n }\n\n let dragSourceElement: Element | null = null\n let transformPasted = false\n const types = resolveTypes(this.options.types, this.editor.extensionManager.extensions)\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 { 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 const nextNodeInTr = tr.doc.nodeAt(nextNode.pos)\n if (nextNodeInTr?.attrs[attributeName] && nextNodeInTr.attrs[attributeName] !== id) {\n return\n }\n\n tr.setNodeMarkup(nextNode.pos, undefined, {\n ...nextNode.node.attrs,\n [attributeName]: id,\n })\n newIds[i + 1] = id\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 // Mark this transaction as coming from UniqueID\n // to prevent infinite loops with other extensions (e.g., TrailingNode)\n tr.setMeta('__uniqueIDTransaction', true)\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 { 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 * Returns a list of duplicated items within an array.\n */\nexport function findDuplicates(items: any[]): any[] {\n const seen = new Set()\n const duplicates = new Set<any>()\n\n items.forEach(item => {\n if (seen.has(item)) {\n duplicates.add(item)\n } else {\n seen.add(item)\n }\n })\n\n return Array.from(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 // Convert the JSON content to a ProseMirror node\n const schema = getSchema([...extensions.filter(ext => ext.name !== 'uniqueID'), uniqueIDExtension])\n const { types: configuredTypes, attributeName, generateID } = uniqueIDExtension.options\n const types =\n configuredTypes === 'all'\n ? Object.keys(schema.nodes).filter(type => type !== 'doc' && type !== 'text')\n : configuredTypes\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"]}