@tiptap/extension-character-count 3.0.0-next.1 → 3.0.0-next.2
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.
- package/dist/index.cjs +27 -4
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +12 -0
- package/dist/index.d.ts +12 -0
- package/dist/index.js +27 -4
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
- package/src/character-count.ts +46 -3
package/dist/index.cjs
CHANGED
|
@@ -33,7 +33,9 @@ var CharacterCount = import_core.Extension.create({
|
|
|
33
33
|
addOptions() {
|
|
34
34
|
return {
|
|
35
35
|
limit: null,
|
|
36
|
-
mode: "textSize"
|
|
36
|
+
mode: "textSize",
|
|
37
|
+
textCounter: (text) => text.length,
|
|
38
|
+
wordCounter: (text) => text.split(" ").filter((word) => word !== "").length
|
|
37
39
|
};
|
|
38
40
|
},
|
|
39
41
|
addStorage() {
|
|
@@ -48,21 +50,42 @@ var CharacterCount = import_core.Extension.create({
|
|
|
48
50
|
const mode = (options == null ? void 0 : options.mode) || this.options.mode;
|
|
49
51
|
if (mode === "textSize") {
|
|
50
52
|
const text = node.textBetween(0, node.content.size, void 0, " ");
|
|
51
|
-
return text
|
|
53
|
+
return this.options.textCounter(text);
|
|
52
54
|
}
|
|
53
55
|
return node.nodeSize;
|
|
54
56
|
};
|
|
55
57
|
this.storage.words = (options) => {
|
|
56
58
|
const node = (options == null ? void 0 : options.node) || this.editor.state.doc;
|
|
57
59
|
const text = node.textBetween(0, node.content.size, " ", " ");
|
|
58
|
-
|
|
59
|
-
return words.length;
|
|
60
|
+
return this.options.wordCounter(text);
|
|
60
61
|
};
|
|
61
62
|
},
|
|
62
63
|
addProseMirrorPlugins() {
|
|
64
|
+
let initialEvaluationDone = false;
|
|
63
65
|
return [
|
|
64
66
|
new import_state.Plugin({
|
|
65
67
|
key: new import_state.PluginKey("characterCount"),
|
|
68
|
+
appendTransaction: (transactions, oldState, newState) => {
|
|
69
|
+
if (initialEvaluationDone) {
|
|
70
|
+
return;
|
|
71
|
+
}
|
|
72
|
+
const limit = this.options.limit;
|
|
73
|
+
if (limit === null || limit === void 0 || limit === 0) {
|
|
74
|
+
initialEvaluationDone = true;
|
|
75
|
+
return;
|
|
76
|
+
}
|
|
77
|
+
const initialContentSize = this.storage.characters({ node: newState.doc });
|
|
78
|
+
if (initialContentSize > limit) {
|
|
79
|
+
const over = initialContentSize - limit;
|
|
80
|
+
const from = 0;
|
|
81
|
+
const to = over;
|
|
82
|
+
console.warn(`[CharacterCount] Initial content exceeded limit of ${limit} characters. Content was automatically trimmed.`);
|
|
83
|
+
const tr = newState.tr.deleteRange(from, to);
|
|
84
|
+
initialEvaluationDone = true;
|
|
85
|
+
return tr;
|
|
86
|
+
}
|
|
87
|
+
initialEvaluationDone = true;
|
|
88
|
+
},
|
|
66
89
|
filterTransaction: (transaction, state) => {
|
|
67
90
|
const limit = this.options.limit;
|
|
68
91
|
if (!transaction.docChanged || limit === 0 || limit === null || limit === void 0) {
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/character-count.ts"],"sourcesContent":["import { CharacterCount } from './character-count.js'\n\nexport * from './character-count.js'\n\nexport default CharacterCount\n","import { Extension } from '@tiptap/core'\nimport { Node as ProseMirrorNode } from '@tiptap/pm/model'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\n\nexport interface CharacterCountOptions {\n /**\n * The maximum number of characters that should be allowed. Defaults to `0`.\n * @default null\n * @example 180\n */\n limit: number | null | undefined\n /**\n * The mode by which the size is calculated. If set to `textSize`, the textContent of the document is used.\n * If set to `nodeSize`, the nodeSize of the document is used.\n * @default 'textSize'\n * @example 'textSize'\n */\n mode: 'textSize' | 'nodeSize'\n}\n\nexport interface CharacterCountStorage {\n /**\n * Get the number of characters for the current document.\n * @param options The options for the character count. (optional)\n * @param options.node The node to get the characters from. Defaults to the current document.\n * @param options.mode The mode by which the size is calculated. If set to `textSize`, the textContent of the document is used.\n */\n characters: (options?: { node?: ProseMirrorNode; mode?: 'textSize' | 'nodeSize' }) => number\n\n /**\n * Get the number of words for the current document.\n * @param options The options for the character count. (optional)\n * @param options.node The node to get the words from. Defaults to the current document.\n */\n words: (options?: { node?: ProseMirrorNode }) => number\n}\n\n/**\n * This extension allows you to count the characters and words of your document.\n * @see https://tiptap.dev/api/extensions/character-count\n */\nexport const CharacterCount = Extension.create<CharacterCountOptions, CharacterCountStorage>({\n name: 'characterCount',\n\n addOptions() {\n return {\n limit: null,\n mode: 'textSize',\n }\n },\n\n addStorage() {\n return {\n characters: () => 0,\n words: () => 0,\n }\n },\n\n onBeforeCreate() {\n this.storage.characters = options => {\n const node = options?.node || this.editor.state.doc\n const mode = options?.mode || this.options.mode\n\n if (mode === 'textSize') {\n const text = node.textBetween(0, node.content.size, undefined, ' ')\n\n return text
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/character-count.ts"],"sourcesContent":["import { CharacterCount } from './character-count.js'\n\nexport * from './character-count.js'\n\nexport default CharacterCount\n","import { Extension } from '@tiptap/core'\nimport { Node as ProseMirrorNode } from '@tiptap/pm/model'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\n\nexport interface CharacterCountOptions {\n /**\n * The maximum number of characters that should be allowed. Defaults to `0`.\n * @default null\n * @example 180\n */\n limit: number | null | undefined\n /**\n * The mode by which the size is calculated. If set to `textSize`, the textContent of the document is used.\n * If set to `nodeSize`, the nodeSize of the document is used.\n * @default 'textSize'\n * @example 'textSize'\n */\n mode: 'textSize' | 'nodeSize'\n /**\n * The text counter function to use. Defaults to a simple character count.\n * @default (text) => text.length\n * @example (text) => [...new Intl.Segmenter().segment(text)].length\n */\n textCounter: (text: string) => number\n /**\n * The word counter function to use. Defaults to a simple word count.\n * @default (text) => text.split(' ').filter(word => word !== '').length\n * @example (text) => text.split(/\\s+/).filter(word => word !== '').length\n */\n wordCounter: (text: string) => number\n}\n\nexport interface CharacterCountStorage {\n /**\n * Get the number of characters for the current document.\n * @param options The options for the character count. (optional)\n * @param options.node The node to get the characters from. Defaults to the current document.\n * @param options.mode The mode by which the size is calculated. If set to `textSize`, the textContent of the document is used.\n */\n characters: (options?: { node?: ProseMirrorNode; mode?: 'textSize' | 'nodeSize' }) => number\n\n /**\n * Get the number of words for the current document.\n * @param options The options for the character count. (optional)\n * @param options.node The node to get the words from. Defaults to the current document.\n */\n words: (options?: { node?: ProseMirrorNode }) => number\n}\n\n/**\n * This extension allows you to count the characters and words of your document.\n * @see https://tiptap.dev/api/extensions/character-count\n */\nexport const CharacterCount = Extension.create<CharacterCountOptions, CharacterCountStorage>({\n name: 'characterCount',\n\n addOptions() {\n return {\n limit: null,\n mode: 'textSize',\n textCounter: text => text.length,\n wordCounter: text => text.split(' ').filter(word => word !== '').length,\n }\n },\n\n addStorage() {\n return {\n characters: () => 0,\n words: () => 0,\n }\n },\n\n onBeforeCreate() {\n this.storage.characters = options => {\n const node = options?.node || this.editor.state.doc\n const mode = options?.mode || this.options.mode\n\n if (mode === 'textSize') {\n const text = node.textBetween(0, node.content.size, undefined, ' ')\n\n return this.options.textCounter(text)\n }\n\n return node.nodeSize\n }\n\n this.storage.words = options => {\n const node = options?.node || this.editor.state.doc\n const text = node.textBetween(0, node.content.size, ' ', ' ')\n\n return this.options.wordCounter(text)\n }\n },\n\n addProseMirrorPlugins() {\n let initialEvaluationDone = false\n\n return [\n new Plugin({\n key: new PluginKey('characterCount'),\n appendTransaction: (transactions, oldState, newState) => {\n if (initialEvaluationDone) {\n return\n }\n\n const limit = this.options.limit\n\n if (limit === null || limit === undefined || limit === 0) {\n initialEvaluationDone = true\n return\n }\n\n const initialContentSize = this.storage.characters({ node: newState.doc })\n\n if (initialContentSize > limit) {\n const over = initialContentSize - limit\n const from = 0\n const to = over\n\n console.warn(`[CharacterCount] Initial content exceeded limit of ${limit} characters. Content was automatically trimmed.`)\n const tr = newState.tr.deleteRange(from, to)\n\n initialEvaluationDone = true\n return tr\n }\n\n initialEvaluationDone = true\n },\n filterTransaction: (transaction, state) => {\n const limit = this.options.limit\n\n // Nothing has changed or no limit is defined. Ignore it.\n if (!transaction.docChanged || limit === 0 || limit === null || limit === undefined) {\n return true\n }\n\n const oldSize = this.storage.characters({ node: state.doc })\n const newSize = this.storage.characters({ node: transaction.doc })\n\n // Everything is in the limit. Good.\n if (newSize <= limit) {\n return true\n }\n\n // The limit has already been exceeded but will be reduced.\n if (oldSize > limit && newSize > limit && newSize <= oldSize) {\n return true\n }\n\n // The limit has already been exceeded and will be increased further.\n if (oldSize > limit && newSize > limit && newSize > oldSize) {\n return false\n }\n\n const isPaste = transaction.getMeta('paste')\n\n // Block all exceeding transactions that were not pasted.\n if (!isPaste) {\n return false\n }\n\n // For pasted content, we try to remove the exceeding content.\n const pos = transaction.selection.$head.pos\n const over = newSize - limit\n const from = pos - over\n const to = pos\n\n // It’s probably a bad idea to mutate transactions within `filterTransaction`\n // but for now this is working fine.\n transaction.deleteRange(from, to)\n\n // In some situations, the limit will continue to be exceeded after trimming.\n // This happens e.g. when truncating within a complex node (e.g. table)\n // and ProseMirror has to close this node again.\n // If this is the case, we prevent the transaction completely.\n const updatedSize = this.storage.characters({ node: transaction.doc })\n\n if (updatedSize > limit) {\n return false\n }\n\n return true\n },\n }),\n ]\n },\n})\n"],"mappings":"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","names":[]}
|
package/dist/index.d.cts
CHANGED
|
@@ -15,6 +15,18 @@ interface CharacterCountOptions {
|
|
|
15
15
|
* @example 'textSize'
|
|
16
16
|
*/
|
|
17
17
|
mode: 'textSize' | 'nodeSize';
|
|
18
|
+
/**
|
|
19
|
+
* The text counter function to use. Defaults to a simple character count.
|
|
20
|
+
* @default (text) => text.length
|
|
21
|
+
* @example (text) => [...new Intl.Segmenter().segment(text)].length
|
|
22
|
+
*/
|
|
23
|
+
textCounter: (text: string) => number;
|
|
24
|
+
/**
|
|
25
|
+
* The word counter function to use. Defaults to a simple word count.
|
|
26
|
+
* @default (text) => text.split(' ').filter(word => word !== '').length
|
|
27
|
+
* @example (text) => text.split(/\s+/).filter(word => word !== '').length
|
|
28
|
+
*/
|
|
29
|
+
wordCounter: (text: string) => number;
|
|
18
30
|
}
|
|
19
31
|
interface CharacterCountStorage {
|
|
20
32
|
/**
|
package/dist/index.d.ts
CHANGED
|
@@ -15,6 +15,18 @@ interface CharacterCountOptions {
|
|
|
15
15
|
* @example 'textSize'
|
|
16
16
|
*/
|
|
17
17
|
mode: 'textSize' | 'nodeSize';
|
|
18
|
+
/**
|
|
19
|
+
* The text counter function to use. Defaults to a simple character count.
|
|
20
|
+
* @default (text) => text.length
|
|
21
|
+
* @example (text) => [...new Intl.Segmenter().segment(text)].length
|
|
22
|
+
*/
|
|
23
|
+
textCounter: (text: string) => number;
|
|
24
|
+
/**
|
|
25
|
+
* The word counter function to use. Defaults to a simple word count.
|
|
26
|
+
* @default (text) => text.split(' ').filter(word => word !== '').length
|
|
27
|
+
* @example (text) => text.split(/\s+/).filter(word => word !== '').length
|
|
28
|
+
*/
|
|
29
|
+
wordCounter: (text: string) => number;
|
|
18
30
|
}
|
|
19
31
|
interface CharacterCountStorage {
|
|
20
32
|
/**
|
package/dist/index.js
CHANGED
|
@@ -6,7 +6,9 @@ var CharacterCount = Extension.create({
|
|
|
6
6
|
addOptions() {
|
|
7
7
|
return {
|
|
8
8
|
limit: null,
|
|
9
|
-
mode: "textSize"
|
|
9
|
+
mode: "textSize",
|
|
10
|
+
textCounter: (text) => text.length,
|
|
11
|
+
wordCounter: (text) => text.split(" ").filter((word) => word !== "").length
|
|
10
12
|
};
|
|
11
13
|
},
|
|
12
14
|
addStorage() {
|
|
@@ -21,21 +23,42 @@ var CharacterCount = Extension.create({
|
|
|
21
23
|
const mode = (options == null ? void 0 : options.mode) || this.options.mode;
|
|
22
24
|
if (mode === "textSize") {
|
|
23
25
|
const text = node.textBetween(0, node.content.size, void 0, " ");
|
|
24
|
-
return text
|
|
26
|
+
return this.options.textCounter(text);
|
|
25
27
|
}
|
|
26
28
|
return node.nodeSize;
|
|
27
29
|
};
|
|
28
30
|
this.storage.words = (options) => {
|
|
29
31
|
const node = (options == null ? void 0 : options.node) || this.editor.state.doc;
|
|
30
32
|
const text = node.textBetween(0, node.content.size, " ", " ");
|
|
31
|
-
|
|
32
|
-
return words.length;
|
|
33
|
+
return this.options.wordCounter(text);
|
|
33
34
|
};
|
|
34
35
|
},
|
|
35
36
|
addProseMirrorPlugins() {
|
|
37
|
+
let initialEvaluationDone = false;
|
|
36
38
|
return [
|
|
37
39
|
new Plugin({
|
|
38
40
|
key: new PluginKey("characterCount"),
|
|
41
|
+
appendTransaction: (transactions, oldState, newState) => {
|
|
42
|
+
if (initialEvaluationDone) {
|
|
43
|
+
return;
|
|
44
|
+
}
|
|
45
|
+
const limit = this.options.limit;
|
|
46
|
+
if (limit === null || limit === void 0 || limit === 0) {
|
|
47
|
+
initialEvaluationDone = true;
|
|
48
|
+
return;
|
|
49
|
+
}
|
|
50
|
+
const initialContentSize = this.storage.characters({ node: newState.doc });
|
|
51
|
+
if (initialContentSize > limit) {
|
|
52
|
+
const over = initialContentSize - limit;
|
|
53
|
+
const from = 0;
|
|
54
|
+
const to = over;
|
|
55
|
+
console.warn(`[CharacterCount] Initial content exceeded limit of ${limit} characters. Content was automatically trimmed.`);
|
|
56
|
+
const tr = newState.tr.deleteRange(from, to);
|
|
57
|
+
initialEvaluationDone = true;
|
|
58
|
+
return tr;
|
|
59
|
+
}
|
|
60
|
+
initialEvaluationDone = true;
|
|
61
|
+
},
|
|
39
62
|
filterTransaction: (transaction, state) => {
|
|
40
63
|
const limit = this.options.limit;
|
|
41
64
|
if (!transaction.docChanged || limit === 0 || limit === null || limit === void 0) {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/character-count.ts","../src/index.ts"],"sourcesContent":["import { Extension } from '@tiptap/core'\nimport { Node as ProseMirrorNode } from '@tiptap/pm/model'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\n\nexport interface CharacterCountOptions {\n /**\n * The maximum number of characters that should be allowed. Defaults to `0`.\n * @default null\n * @example 180\n */\n limit: number | null | undefined\n /**\n * The mode by which the size is calculated. If set to `textSize`, the textContent of the document is used.\n * If set to `nodeSize`, the nodeSize of the document is used.\n * @default 'textSize'\n * @example 'textSize'\n */\n mode: 'textSize' | 'nodeSize'\n}\n\nexport interface CharacterCountStorage {\n /**\n * Get the number of characters for the current document.\n * @param options The options for the character count. (optional)\n * @param options.node The node to get the characters from. Defaults to the current document.\n * @param options.mode The mode by which the size is calculated. If set to `textSize`, the textContent of the document is used.\n */\n characters: (options?: { node?: ProseMirrorNode; mode?: 'textSize' | 'nodeSize' }) => number\n\n /**\n * Get the number of words for the current document.\n * @param options The options for the character count. (optional)\n * @param options.node The node to get the words from. Defaults to the current document.\n */\n words: (options?: { node?: ProseMirrorNode }) => number\n}\n\n/**\n * This extension allows you to count the characters and words of your document.\n * @see https://tiptap.dev/api/extensions/character-count\n */\nexport const CharacterCount = Extension.create<CharacterCountOptions, CharacterCountStorage>({\n name: 'characterCount',\n\n addOptions() {\n return {\n limit: null,\n mode: 'textSize',\n }\n },\n\n addStorage() {\n return {\n characters: () => 0,\n words: () => 0,\n }\n },\n\n onBeforeCreate() {\n this.storage.characters = options => {\n const node = options?.node || this.editor.state.doc\n const mode = options?.mode || this.options.mode\n\n if (mode === 'textSize') {\n const text = node.textBetween(0, node.content.size, undefined, ' ')\n\n return text
|
|
1
|
+
{"version":3,"sources":["../src/character-count.ts","../src/index.ts"],"sourcesContent":["import { Extension } from '@tiptap/core'\nimport { Node as ProseMirrorNode } from '@tiptap/pm/model'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\n\nexport interface CharacterCountOptions {\n /**\n * The maximum number of characters that should be allowed. Defaults to `0`.\n * @default null\n * @example 180\n */\n limit: number | null | undefined\n /**\n * The mode by which the size is calculated. If set to `textSize`, the textContent of the document is used.\n * If set to `nodeSize`, the nodeSize of the document is used.\n * @default 'textSize'\n * @example 'textSize'\n */\n mode: 'textSize' | 'nodeSize'\n /**\n * The text counter function to use. Defaults to a simple character count.\n * @default (text) => text.length\n * @example (text) => [...new Intl.Segmenter().segment(text)].length\n */\n textCounter: (text: string) => number\n /**\n * The word counter function to use. Defaults to a simple word count.\n * @default (text) => text.split(' ').filter(word => word !== '').length\n * @example (text) => text.split(/\\s+/).filter(word => word !== '').length\n */\n wordCounter: (text: string) => number\n}\n\nexport interface CharacterCountStorage {\n /**\n * Get the number of characters for the current document.\n * @param options The options for the character count. (optional)\n * @param options.node The node to get the characters from. Defaults to the current document.\n * @param options.mode The mode by which the size is calculated. If set to `textSize`, the textContent of the document is used.\n */\n characters: (options?: { node?: ProseMirrorNode; mode?: 'textSize' | 'nodeSize' }) => number\n\n /**\n * Get the number of words for the current document.\n * @param options The options for the character count. (optional)\n * @param options.node The node to get the words from. Defaults to the current document.\n */\n words: (options?: { node?: ProseMirrorNode }) => number\n}\n\n/**\n * This extension allows you to count the characters and words of your document.\n * @see https://tiptap.dev/api/extensions/character-count\n */\nexport const CharacterCount = Extension.create<CharacterCountOptions, CharacterCountStorage>({\n name: 'characterCount',\n\n addOptions() {\n return {\n limit: null,\n mode: 'textSize',\n textCounter: text => text.length,\n wordCounter: text => text.split(' ').filter(word => word !== '').length,\n }\n },\n\n addStorage() {\n return {\n characters: () => 0,\n words: () => 0,\n }\n },\n\n onBeforeCreate() {\n this.storage.characters = options => {\n const node = options?.node || this.editor.state.doc\n const mode = options?.mode || this.options.mode\n\n if (mode === 'textSize') {\n const text = node.textBetween(0, node.content.size, undefined, ' ')\n\n return this.options.textCounter(text)\n }\n\n return node.nodeSize\n }\n\n this.storage.words = options => {\n const node = options?.node || this.editor.state.doc\n const text = node.textBetween(0, node.content.size, ' ', ' ')\n\n return this.options.wordCounter(text)\n }\n },\n\n addProseMirrorPlugins() {\n let initialEvaluationDone = false\n\n return [\n new Plugin({\n key: new PluginKey('characterCount'),\n appendTransaction: (transactions, oldState, newState) => {\n if (initialEvaluationDone) {\n return\n }\n\n const limit = this.options.limit\n\n if (limit === null || limit === undefined || limit === 0) {\n initialEvaluationDone = true\n return\n }\n\n const initialContentSize = this.storage.characters({ node: newState.doc })\n\n if (initialContentSize > limit) {\n const over = initialContentSize - limit\n const from = 0\n const to = over\n\n console.warn(`[CharacterCount] Initial content exceeded limit of ${limit} characters. Content was automatically trimmed.`)\n const tr = newState.tr.deleteRange(from, to)\n\n initialEvaluationDone = true\n return tr\n }\n\n initialEvaluationDone = true\n },\n filterTransaction: (transaction, state) => {\n const limit = this.options.limit\n\n // Nothing has changed or no limit is defined. Ignore it.\n if (!transaction.docChanged || limit === 0 || limit === null || limit === undefined) {\n return true\n }\n\n const oldSize = this.storage.characters({ node: state.doc })\n const newSize = this.storage.characters({ node: transaction.doc })\n\n // Everything is in the limit. Good.\n if (newSize <= limit) {\n return true\n }\n\n // The limit has already been exceeded but will be reduced.\n if (oldSize > limit && newSize > limit && newSize <= oldSize) {\n return true\n }\n\n // The limit has already been exceeded and will be increased further.\n if (oldSize > limit && newSize > limit && newSize > oldSize) {\n return false\n }\n\n const isPaste = transaction.getMeta('paste')\n\n // Block all exceeding transactions that were not pasted.\n if (!isPaste) {\n return false\n }\n\n // For pasted content, we try to remove the exceeding content.\n const pos = transaction.selection.$head.pos\n const over = newSize - limit\n const from = pos - over\n const to = pos\n\n // It’s probably a bad idea to mutate transactions within `filterTransaction`\n // but for now this is working fine.\n transaction.deleteRange(from, to)\n\n // In some situations, the limit will continue to be exceeded after trimming.\n // This happens e.g. when truncating within a complex node (e.g. table)\n // and ProseMirror has to close this node again.\n // If this is the case, we prevent the transaction completely.\n const updatedSize = this.storage.characters({ node: transaction.doc })\n\n if (updatedSize > limit) {\n return false\n }\n\n return true\n },\n }),\n ]\n },\n})\n","import { CharacterCount } from './character-count.js'\n\nexport * from './character-count.js'\n\nexport default CharacterCount\n"],"mappings":"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","names":[]}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tiptap/extension-character-count",
|
|
3
3
|
"description": "font family extension for tiptap",
|
|
4
|
-
"version": "3.0.0-next.
|
|
4
|
+
"version": "3.0.0-next.2",
|
|
5
5
|
"homepage": "https://tiptap.dev",
|
|
6
6
|
"keywords": [
|
|
7
7
|
"tiptap",
|
|
@@ -28,8 +28,8 @@
|
|
|
28
28
|
"dist"
|
|
29
29
|
],
|
|
30
30
|
"devDependencies": {
|
|
31
|
-
"@tiptap/core": "^3.0.0-next.
|
|
32
|
-
"@tiptap/pm": "^3.0.0-next.
|
|
31
|
+
"@tiptap/core": "^3.0.0-next.2",
|
|
32
|
+
"@tiptap/pm": "^3.0.0-next.2"
|
|
33
33
|
},
|
|
34
34
|
"peerDependencies": {
|
|
35
35
|
"@tiptap/core": "^3.0.0-next.1",
|
package/src/character-count.ts
CHANGED
|
@@ -16,6 +16,18 @@ export interface CharacterCountOptions {
|
|
|
16
16
|
* @example 'textSize'
|
|
17
17
|
*/
|
|
18
18
|
mode: 'textSize' | 'nodeSize'
|
|
19
|
+
/**
|
|
20
|
+
* The text counter function to use. Defaults to a simple character count.
|
|
21
|
+
* @default (text) => text.length
|
|
22
|
+
* @example (text) => [...new Intl.Segmenter().segment(text)].length
|
|
23
|
+
*/
|
|
24
|
+
textCounter: (text: string) => number
|
|
25
|
+
/**
|
|
26
|
+
* The word counter function to use. Defaults to a simple word count.
|
|
27
|
+
* @default (text) => text.split(' ').filter(word => word !== '').length
|
|
28
|
+
* @example (text) => text.split(/\s+/).filter(word => word !== '').length
|
|
29
|
+
*/
|
|
30
|
+
wordCounter: (text: string) => number
|
|
19
31
|
}
|
|
20
32
|
|
|
21
33
|
export interface CharacterCountStorage {
|
|
@@ -46,6 +58,8 @@ export const CharacterCount = Extension.create<CharacterCountOptions, CharacterC
|
|
|
46
58
|
return {
|
|
47
59
|
limit: null,
|
|
48
60
|
mode: 'textSize',
|
|
61
|
+
textCounter: text => text.length,
|
|
62
|
+
wordCounter: text => text.split(' ').filter(word => word !== '').length,
|
|
49
63
|
}
|
|
50
64
|
},
|
|
51
65
|
|
|
@@ -64,7 +78,7 @@ export const CharacterCount = Extension.create<CharacterCountOptions, CharacterC
|
|
|
64
78
|
if (mode === 'textSize') {
|
|
65
79
|
const text = node.textBetween(0, node.content.size, undefined, ' ')
|
|
66
80
|
|
|
67
|
-
return text
|
|
81
|
+
return this.options.textCounter(text)
|
|
68
82
|
}
|
|
69
83
|
|
|
70
84
|
return node.nodeSize
|
|
@@ -73,16 +87,45 @@ export const CharacterCount = Extension.create<CharacterCountOptions, CharacterC
|
|
|
73
87
|
this.storage.words = options => {
|
|
74
88
|
const node = options?.node || this.editor.state.doc
|
|
75
89
|
const text = node.textBetween(0, node.content.size, ' ', ' ')
|
|
76
|
-
const words = text.split(' ').filter(word => word !== '')
|
|
77
90
|
|
|
78
|
-
return
|
|
91
|
+
return this.options.wordCounter(text)
|
|
79
92
|
}
|
|
80
93
|
},
|
|
81
94
|
|
|
82
95
|
addProseMirrorPlugins() {
|
|
96
|
+
let initialEvaluationDone = false
|
|
97
|
+
|
|
83
98
|
return [
|
|
84
99
|
new Plugin({
|
|
85
100
|
key: new PluginKey('characterCount'),
|
|
101
|
+
appendTransaction: (transactions, oldState, newState) => {
|
|
102
|
+
if (initialEvaluationDone) {
|
|
103
|
+
return
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
const limit = this.options.limit
|
|
107
|
+
|
|
108
|
+
if (limit === null || limit === undefined || limit === 0) {
|
|
109
|
+
initialEvaluationDone = true
|
|
110
|
+
return
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
const initialContentSize = this.storage.characters({ node: newState.doc })
|
|
114
|
+
|
|
115
|
+
if (initialContentSize > limit) {
|
|
116
|
+
const over = initialContentSize - limit
|
|
117
|
+
const from = 0
|
|
118
|
+
const to = over
|
|
119
|
+
|
|
120
|
+
console.warn(`[CharacterCount] Initial content exceeded limit of ${limit} characters. Content was automatically trimmed.`)
|
|
121
|
+
const tr = newState.tr.deleteRange(from, to)
|
|
122
|
+
|
|
123
|
+
initialEvaluationDone = true
|
|
124
|
+
return tr
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
initialEvaluationDone = true
|
|
128
|
+
},
|
|
86
129
|
filterTransaction: (transaction, state) => {
|
|
87
130
|
const limit = this.options.limit
|
|
88
131
|
|