@fluidframework/react 2.90.0-378676 โ†’ 2.91.0

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 (112) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +2 -0
  3. package/api-report/react.alpha.api.md +8 -8
  4. package/lib/index.d.ts +2 -0
  5. package/lib/index.d.ts.map +1 -1
  6. package/lib/index.js +2 -0
  7. package/lib/index.js.map +1 -1
  8. package/lib/propNode.js.map +1 -1
  9. package/lib/reactSharedTreeView.d.ts +6 -6
  10. package/lib/reactSharedTreeView.d.ts.map +1 -1
  11. package/lib/reactSharedTreeView.js +16 -18
  12. package/lib/reactSharedTreeView.js.map +1 -1
  13. package/lib/test/mochaHooks.js +13 -0
  14. package/lib/test/mochaHooks.js.map +1 -0
  15. package/lib/test/reactSharedTreeView.spec.js +3 -3
  16. package/lib/test/reactSharedTreeView.spec.js.map +1 -1
  17. package/lib/test/text/plainUtils.test.js +75 -0
  18. package/lib/test/text/plainUtils.test.js.map +1 -0
  19. package/lib/test/text/textEditor.test.js +760 -0
  20. package/lib/test/text/textEditor.test.js.map +1 -0
  21. package/lib/test/undoRedo.test.js +62 -0
  22. package/lib/test/undoRedo.test.js.map +1 -0
  23. package/lib/test/useObservation.spec.js +8 -9
  24. package/lib/test/useObservation.spec.js.map +1 -1
  25. package/lib/test/useTree.spec.js +15 -16
  26. package/lib/test/useTree.spec.js.map +1 -1
  27. package/lib/text/formatted/index.d.ts +6 -0
  28. package/lib/text/formatted/index.d.ts.map +1 -0
  29. package/lib/text/formatted/index.js +6 -0
  30. package/lib/text/formatted/index.js.map +1 -0
  31. package/lib/text/formatted/quillFormattedView.d.ts +66 -0
  32. package/lib/text/formatted/quillFormattedView.d.ts.map +1 -0
  33. package/lib/text/formatted/quillFormattedView.js +520 -0
  34. package/lib/text/formatted/quillFormattedView.js.map +1 -0
  35. package/lib/text/index.d.ts +7 -0
  36. package/lib/text/index.d.ts.map +1 -0
  37. package/lib/text/index.js +7 -0
  38. package/lib/text/index.js.map +1 -0
  39. package/lib/text/plain/index.d.ts +7 -0
  40. package/lib/text/plain/index.d.ts.map +1 -0
  41. package/lib/text/plain/index.js +7 -0
  42. package/lib/text/plain/index.js.map +1 -0
  43. package/lib/text/plain/plainTextView.d.ts +14 -0
  44. package/lib/text/plain/plainTextView.d.ts.map +1 -0
  45. package/lib/text/plain/plainTextView.js +70 -0
  46. package/lib/text/plain/plainTextView.js.map +1 -0
  47. package/lib/text/plain/plainUtils.d.ts +23 -0
  48. package/lib/text/plain/plainUtils.d.ts.map +1 -0
  49. package/lib/text/plain/plainUtils.js +51 -0
  50. package/lib/text/plain/plainUtils.js.map +1 -0
  51. package/lib/text/plain/quillView.d.ts +22 -0
  52. package/lib/text/plain/quillView.d.ts.map +1 -0
  53. package/lib/text/plain/quillView.js +106 -0
  54. package/lib/text/plain/quillView.js.map +1 -0
  55. package/lib/undoRedo.d.ts +51 -0
  56. package/lib/undoRedo.d.ts.map +1 -0
  57. package/lib/undoRedo.js +76 -0
  58. package/lib/undoRedo.js.map +1 -0
  59. package/lib/useObservation.js +6 -6
  60. package/lib/useObservation.js.map +1 -1
  61. package/lib/useTree.d.ts +7 -7
  62. package/lib/useTree.d.ts.map +1 -1
  63. package/lib/useTree.js +6 -6
  64. package/lib/useTree.js.map +1 -1
  65. package/package.json +28 -46
  66. package/react.test-files.tar +0 -0
  67. package/src/index.ts +10 -0
  68. package/src/propNode.ts +1 -1
  69. package/src/reactSharedTreeView.tsx +11 -13
  70. package/src/text/formatted/index.ts +11 -0
  71. package/src/text/formatted/quillFormattedView.tsx +627 -0
  72. package/src/text/index.ts +15 -0
  73. package/src/text/plain/index.ts +7 -0
  74. package/src/text/plain/plainTextView.tsx +110 -0
  75. package/src/text/plain/plainUtils.ts +68 -0
  76. package/src/text/plain/quillView.tsx +149 -0
  77. package/src/undoRedo.ts +117 -0
  78. package/src/useObservation.ts +6 -6
  79. package/src/useTree.ts +19 -12
  80. package/tsconfig.json +6 -0
  81. package/api-extractor/api-extractor-lint-alpha.cjs.json +0 -5
  82. package/api-extractor/api-extractor-lint-beta.cjs.json +0 -5
  83. package/api-extractor/api-extractor-lint-public.cjs.json +0 -5
  84. package/dist/alpha.d.ts +0 -45
  85. package/dist/beta.d.ts +0 -15
  86. package/dist/index.d.ts +0 -16
  87. package/dist/index.d.ts.map +0 -1
  88. package/dist/index.js +0 -26
  89. package/dist/index.js.map +0 -1
  90. package/dist/package.json +0 -4
  91. package/dist/propNode.d.ts +0 -114
  92. package/dist/propNode.d.ts.map +0 -1
  93. package/dist/propNode.js +0 -43
  94. package/dist/propNode.js.map +0 -1
  95. package/dist/public.d.ts +0 -15
  96. package/dist/reactSharedTreeView.d.ts +0 -119
  97. package/dist/reactSharedTreeView.d.ts.map +0 -1
  98. package/dist/reactSharedTreeView.js +0 -206
  99. package/dist/reactSharedTreeView.js.map +0 -1
  100. package/dist/simpleIdentifier.d.ts +0 -19
  101. package/dist/simpleIdentifier.d.ts.map +0 -1
  102. package/dist/simpleIdentifier.js +0 -33
  103. package/dist/simpleIdentifier.js.map +0 -1
  104. package/dist/useObservation.d.ts +0 -83
  105. package/dist/useObservation.d.ts.map +0 -1
  106. package/dist/useObservation.js +0 -295
  107. package/dist/useObservation.js.map +0 -1
  108. package/dist/useTree.d.ts +0 -80
  109. package/dist/useTree.d.ts.map +0 -1
  110. package/dist/useTree.js +0 -137
  111. package/dist/useTree.js.map +0 -1
  112. package/tsconfig.cjs.json +0 -7
@@ -0,0 +1,760 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ /*!
3
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
4
+ * Licensed under the MIT License.
5
+ */
6
+ import { strict as assert } from "node:assert";
7
+ import { TreeViewConfiguration } from "@fluidframework/tree";
8
+ import { TreeAlpha } from "@fluidframework/tree/alpha";
9
+ import { independentView, TextAsTree } from "@fluidframework/tree/internal";
10
+ import { render } from "@testing-library/react";
11
+ import globalJsdom from "global-jsdom";
12
+ import DeltaPackage from "quill-delta";
13
+ import { createRef } from "react";
14
+ import { toPropTreeNode } from "../../propNode.js";
15
+ import { clipboardFormatMatcher, FormattedTextAsTree, FormattedMainView, parseCssFontFamily, parseCssFontSize, parseLineTag, buildDeltaFromTree,
16
+ // Allow import of files being tested
17
+ // eslint-disable-next-line import-x/no-internal-modules
18
+ } from "../../text/formatted/quillFormattedView.js";
19
+ import { PlainTextMainView, QuillMainView,
20
+ // Allow import of files being tested
21
+ // eslint-disable-next-line import-x/no-internal-modules
22
+ } from "../../text/plain/index.js";
23
+ import { UndoRedoStacks } from "../../undoRedo.js";
24
+ const Delta = DeltaPackage.default;
25
+ // Configuration for creating formatted text views
26
+ const formattedTreeConfig = new TreeViewConfiguration({ schema: FormattedTextAsTree.Tree });
27
+ /**
28
+ * Creates a TreeView for formatted text, initialized with the provided initial value.
29
+ */
30
+ function createFormattedTreeView(initialValue = "") {
31
+ const treeView = independentView(formattedTreeConfig);
32
+ treeView.initialize(FormattedTextAsTree.Tree.fromString(initialValue));
33
+ return { tree: treeView.root };
34
+ }
35
+ /**
36
+ * Creates a TreeView for formatted text with events access (needed for undo/redo tests).
37
+ */
38
+ function createFormattedTreeViewWithEvents(initialValue = "") {
39
+ const treeView = independentView(formattedTreeConfig);
40
+ treeView.initialize(FormattedTextAsTree.Tree.fromString(initialValue));
41
+ return treeView;
42
+ }
43
+ const views = [
44
+ { name: "Quill", component: QuillMainView },
45
+ { name: "Plain TextArea", component: PlainTextMainView },
46
+ ];
47
+ // TODO add collaboration tests when rich formatting is supported using TestContainerRuntimeFactory from
48
+ // @fluidframework/test-utils to test rich formatting data sync between multiple collaborators
49
+ describe("textEditor", () => {
50
+ // Note: JSDOM is initialized once in mochaHooks.ts before Quill is imported,
51
+ // since Quill requires document at import time. See src/test/mochaHooks.ts.
52
+ // These tests reset up a clean DOM.
53
+ let cleanup;
54
+ // TODO: why does making this beforeEach/afterEach instead of before/after cause cleanup to crash?
55
+ // It seems like each test should be able to have its own clean DOM.
56
+ before(() => {
57
+ cleanup = globalJsdom();
58
+ });
59
+ after(() => {
60
+ cleanup();
61
+ });
62
+ // Loop through all registered views
63
+ for (const view of views) {
64
+ describe(`${view.name} view`, () => {
65
+ describe("dom tests", () => {
66
+ // Run without strict mode to make sure it works in a normal production setup.
67
+ // Run with strict mode to potentially detect additional issues.
68
+ for (const reactStrictMode of [false, true]) {
69
+ describe(`StrictMode: ${reactStrictMode}`, () => {
70
+ const ViewComponent = view.component;
71
+ it("renders MainView with editor container", () => {
72
+ const text = TextAsTree.Tree.fromString("");
73
+ const content = _jsx(ViewComponent, { root: toPropTreeNode(text) });
74
+ const rendered = render(content, { reactStrictMode });
75
+ assert.match(rendered.baseElement.textContent ?? "", /Collaborative Text Editor/);
76
+ });
77
+ it("renders MainView with initial text content", () => {
78
+ const text = TextAsTree.Tree.fromString("Hello World");
79
+ const content = _jsx(ViewComponent, { root: toPropTreeNode(text) });
80
+ const rendered = render(content, { reactStrictMode });
81
+ assert.match(rendered.baseElement.textContent ?? "", /Hello World/);
82
+ });
83
+ it("invalidates view when tree is mutated", () => {
84
+ const text = TextAsTree.Tree.fromString("Hello");
85
+ const content = _jsx(ViewComponent, { root: toPropTreeNode(text) });
86
+ const rendered = render(content, { reactStrictMode });
87
+ // Mutate the tree by inserting text
88
+ text.insertAt(5, " World");
89
+ // Rerender and verify the view updates
90
+ rendered.rerender(content);
91
+ assert.match(rendered.baseElement.textContent ?? "", /Hello World/);
92
+ });
93
+ it("invalidates view when text is removed", () => {
94
+ const text = TextAsTree.Tree.fromString("Hello World");
95
+ const content = _jsx(ViewComponent, { root: toPropTreeNode(text) });
96
+ const rendered = render(content, { reactStrictMode });
97
+ // Mutate the tree by removing " World" (indices 5 to 11)
98
+ text.removeRange(5, 11);
99
+ // Rerender and verify the view updates
100
+ rendered.rerender(content);
101
+ assert.match(rendered.baseElement.textContent ?? "", /Hello/);
102
+ assert(rendered.baseElement.textContent !== null);
103
+ assert.doesNotMatch(rendered.baseElement.textContent, /World/);
104
+ });
105
+ it("invalidates view when text is cleared and replaced", () => {
106
+ const text = TextAsTree.Tree.fromString("Original");
107
+ const content = _jsx(ViewComponent, { root: toPropTreeNode(text) });
108
+ const rendered = render(content, { reactStrictMode });
109
+ // Clear all text
110
+ const length = [...text.characters()].length;
111
+ text.removeRange(0, length);
112
+ // Insert new text
113
+ text.insertAt(0, "Replaced");
114
+ // Rerender and verify the view updates
115
+ rendered.rerender(content);
116
+ assert.match(rendered.baseElement.textContent ?? "", /Replaced/);
117
+ assert(rendered.baseElement.textContent !== null);
118
+ assert.doesNotMatch(rendered.baseElement.textContent, /Original/);
119
+ });
120
+ // Tests for surrogate pair characters (emojis use 2 UTF-16 code units)
121
+ // These verify correct handling where editor indexing may differ from iteration.
122
+ it("renders MainView with surrogate pair characters", () => {
123
+ // ๐Ÿ˜€ is a surrogate pair: "๐Ÿ˜€".length === 2, but [..."๐Ÿ˜€"].length === 1
124
+ const text = TextAsTree.Tree.fromString("Hello ๐Ÿ˜€ World");
125
+ const content = _jsx(ViewComponent, { root: toPropTreeNode(text) });
126
+ const rendered = render(content, { reactStrictMode });
127
+ assert.match(rendered.baseElement.textContent ?? "", /Hello ๐Ÿ˜€ World/);
128
+ });
129
+ it("inserts text after surrogate pair characters", () => {
130
+ const text = TextAsTree.Tree.fromString("A๐Ÿ˜€B");
131
+ const content = _jsx(ViewComponent, { root: toPropTreeNode(text) });
132
+ const rendered = render(content, { reactStrictMode });
133
+ // Insert after the emoji (index 2 in character count: A, ๐Ÿ˜€, B)
134
+ text.insertAt(2, "X");
135
+ rendered.rerender(content);
136
+ assert.match(rendered.baseElement.textContent ?? "", /A๐Ÿ˜€XB/);
137
+ });
138
+ it("removes surrogate pair characters", () => {
139
+ const text = TextAsTree.Tree.fromString("A๐Ÿ˜€B");
140
+ const content = _jsx(ViewComponent, { root: toPropTreeNode(text) });
141
+ const rendered = render(content, { reactStrictMode });
142
+ // Remove the emoji (index 1, length 1 in character count)
143
+ text.removeRange(1, 2);
144
+ rendered.rerender(content);
145
+ assert.match(rendered.baseElement.textContent ?? "", /AB/);
146
+ assert(rendered.baseElement.textContent !== null);
147
+ assert.doesNotMatch(rendered.baseElement.textContent, /๐Ÿ˜€/);
148
+ });
149
+ it("handles multiple surrogate pair characters", () => {
150
+ const text = TextAsTree.Tree.fromString("๐Ÿ‘‹๐ŸŒ๐ŸŽ‰");
151
+ const content = _jsx(ViewComponent, { root: toPropTreeNode(text) });
152
+ const rendered = render(content, { reactStrictMode });
153
+ // Insert between emojis
154
+ text.insertAt(2, "!");
155
+ rendered.rerender(content);
156
+ assert.match(rendered.baseElement.textContent ?? "", /๐Ÿ‘‹๐ŸŒ!๐ŸŽ‰/);
157
+ });
158
+ });
159
+ }
160
+ });
161
+ });
162
+ }
163
+ // Formatted text view tests - Initial view rendering (matching plain text test structure)
164
+ describe("Formatted Quill view", () => {
165
+ describe("dom tests", () => {
166
+ for (const reactStrictMode of [false, true]) {
167
+ describe(`StrictMode: ${reactStrictMode}`, () => {
168
+ it("renders FormattedMainView with editor container", () => {
169
+ const { tree } = createFormattedTreeView();
170
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(tree) });
171
+ const rendered = render(content, { reactStrictMode });
172
+ assert.match(rendered.baseElement.textContent ?? "", /Collaborative Formatted Text Editor/);
173
+ });
174
+ it("renders FormattedMainView with initial text content", () => {
175
+ const { tree } = createFormattedTreeView("Hello World");
176
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(tree) });
177
+ const rendered = render(content, { reactStrictMode });
178
+ assert.match(rendered.baseElement.textContent ?? "", /Hello World/);
179
+ });
180
+ it("invalidates view when tree is mutated", () => {
181
+ const { tree: text } = createFormattedTreeView("Hello");
182
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
183
+ const rendered = render(content, { reactStrictMode });
184
+ // Mutate the tree by inserting text
185
+ text.insertAt(5, " World");
186
+ // Rerender and verify the view updates
187
+ rendered.rerender(content);
188
+ assert.match(rendered.baseElement.textContent ?? "", /Hello World/);
189
+ });
190
+ it("invalidates view when text is removed", () => {
191
+ const { tree: text } = createFormattedTreeView("Hello World");
192
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
193
+ const rendered = render(content, { reactStrictMode });
194
+ // Mutate the tree by removing " World" (indices 5 to 11)
195
+ text.removeRange(5, 11);
196
+ // Rerender and verify the view updates
197
+ rendered.rerender(content);
198
+ assert.match(rendered.baseElement.textContent ?? "", /Hello/);
199
+ assert(rendered.baseElement.textContent !== null);
200
+ assert.doesNotMatch(rendered.baseElement.textContent, /World/);
201
+ });
202
+ it("invalidates view when text is cleared and replaced", () => {
203
+ const { tree: text } = createFormattedTreeView("Original");
204
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
205
+ const rendered = render(content, { reactStrictMode });
206
+ // Clear all text
207
+ const length = [...text.characters()].length;
208
+ text.removeRange(0, length);
209
+ // Insert new text
210
+ text.insertAt(0, "Replaced");
211
+ // Rerender and verify the view updates
212
+ rendered.rerender(content);
213
+ assert.match(rendered.baseElement.textContent ?? "", /Replaced/);
214
+ assert(rendered.baseElement.textContent !== null);
215
+ assert.doesNotMatch(rendered.baseElement.textContent, /Original/);
216
+ });
217
+ // Tests for surrogate pair characters (emojis use 2 UTF-16 code units)
218
+ // These verify correct handling where editor indexing may differ from iteration.
219
+ it("renders FormattedMainView with surrogate pair characters", () => {
220
+ // ๐Ÿ˜€ is a surrogate pair: "๐Ÿ˜€".length === 2, but [..."๐Ÿ˜€"].length === 1
221
+ const { tree: text } = createFormattedTreeView("Hello ๐Ÿ˜€ World");
222
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
223
+ const rendered = render(content, { reactStrictMode });
224
+ assert.match(rendered.baseElement.textContent ?? "", /Hello ๐Ÿ˜€ World/);
225
+ });
226
+ it("inserts text after surrogate pair characters", () => {
227
+ const { tree: text } = createFormattedTreeView("A๐Ÿ˜€B");
228
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
229
+ const rendered = render(content, { reactStrictMode });
230
+ // Insert after the emoji (index 2 in character count: A, ๐Ÿ˜€, B)
231
+ text.insertAt(2, "X");
232
+ rendered.rerender(content);
233
+ assert.match(rendered.baseElement.textContent ?? "", /A๐Ÿ˜€XB/);
234
+ });
235
+ it("removes surrogate pair characters", () => {
236
+ const { tree: text } = createFormattedTreeView("A๐Ÿ˜€B");
237
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
238
+ const rendered = render(content, { reactStrictMode });
239
+ // Remove the emoji (index 1, length 1 in character count)
240
+ text.removeRange(1, 2);
241
+ rendered.rerender(content);
242
+ assert.match(rendered.baseElement.textContent ?? "", /AB/);
243
+ assert(rendered.baseElement.textContent !== null);
244
+ assert.doesNotMatch(rendered.baseElement.textContent, /๐Ÿ˜€/);
245
+ });
246
+ it("handles multiple surrogate pair characters", () => {
247
+ const { tree: text } = createFormattedTreeView("๐Ÿ‘‹๐ŸŒ๐ŸŽ‰");
248
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
249
+ const rendered = render(content, { reactStrictMode });
250
+ // Insert between emojis
251
+ text.insertAt(2, "!");
252
+ rendered.rerender(content);
253
+ assert.match(rendered.baseElement.textContent ?? "", /๐Ÿ‘‹๐ŸŒ!๐ŸŽ‰/);
254
+ });
255
+ });
256
+ }
257
+ });
258
+ // Helper to create default format
259
+ function createPlainFormat() {
260
+ return new FormattedTextAsTree.CharacterFormat({
261
+ bold: false,
262
+ italic: false,
263
+ underline: false,
264
+ size: 12,
265
+ font: "Arial",
266
+ });
267
+ }
268
+ // Essential tests for character attributes
269
+ // Each attribute needs: insert, delete, and formatRange tests
270
+ describe("character attribute tests", () => {
271
+ for (const reactStrictMode of [false, true]) {
272
+ describe(`StrictMode: ${reactStrictMode}`, () => {
273
+ it("delete on empty string does not throw", () => {
274
+ const { tree: text } = createFormattedTreeView();
275
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
276
+ const rendered = render(content, { reactStrictMode });
277
+ assert.doesNotThrow(() => {
278
+ text.removeRange(0, 0);
279
+ rendered.rerender(content);
280
+ });
281
+ });
282
+ describe("bold", () => {
283
+ it("inserts bold text and renders with <strong> tag", () => {
284
+ const { tree: text } = createFormattedTreeView("Hello");
285
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
286
+ const rendered = render(content, { reactStrictMode });
287
+ assert.ok(!rendered.container.querySelector("strong"), "Initially: no <strong>");
288
+ text.defaultFormat = new FormattedTextAsTree.CharacterFormat({
289
+ bold: true,
290
+ italic: false,
291
+ underline: false,
292
+ size: 12,
293
+ font: "Arial",
294
+ });
295
+ text.insertAt(2, "BOLD");
296
+ rendered.rerender(content);
297
+ const el = rendered.container.querySelector("strong");
298
+ assert.ok(el, "Expected <strong> tag");
299
+ assert.match(el.textContent ?? "", /BOLD/);
300
+ });
301
+ it("deletes bold text and removes <strong> tag", () => {
302
+ const { tree: text } = createFormattedTreeView();
303
+ text.defaultFormat = new FormattedTextAsTree.CharacterFormat({
304
+ bold: true,
305
+ italic: false,
306
+ underline: false,
307
+ size: 12,
308
+ font: "Arial",
309
+ });
310
+ text.insertAt(0, "BOLD");
311
+ text.defaultFormat = createPlainFormat();
312
+ text.insertAt(4, "plain");
313
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
314
+ const rendered = render(content, { reactStrictMode });
315
+ assert.ok(rendered.container.querySelector("strong"), "Initially: has <strong>");
316
+ text.removeRange(0, 4);
317
+ rendered.rerender(content);
318
+ assert.ok(!rendered.container.querySelector("strong"), "After delete: no <strong>");
319
+ });
320
+ it("applies bold via formatRange", () => {
321
+ const { tree: text } = createFormattedTreeView("Hello World");
322
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
323
+ const rendered = render(content, { reactStrictMode });
324
+ text.formatRange(6, 11, { bold: true });
325
+ rendered.rerender(content);
326
+ const el = rendered.container.querySelector("strong");
327
+ assert.ok(el, "Expected <strong> after formatRange");
328
+ assert.match(el.textContent ?? "", /World/);
329
+ });
330
+ });
331
+ describe("italic", () => {
332
+ it("inserts italic text and renders with <em> tag", () => {
333
+ const { tree: text } = createFormattedTreeView("Hello");
334
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
335
+ const rendered = render(content, { reactStrictMode });
336
+ assert.ok(!rendered.container.querySelector("em"), "Initially: no <em>");
337
+ text.defaultFormat = new FormattedTextAsTree.CharacterFormat({
338
+ bold: false,
339
+ italic: true,
340
+ underline: false,
341
+ size: 12,
342
+ font: "Arial",
343
+ });
344
+ text.insertAt(2, "ITAL");
345
+ rendered.rerender(content);
346
+ const el = rendered.container.querySelector("em");
347
+ assert.ok(el, "Expected <em> tag");
348
+ assert.match(el.textContent ?? "", /ITAL/);
349
+ });
350
+ it("deletes italic text and removes <em> tag", () => {
351
+ const { tree: text } = createFormattedTreeView();
352
+ text.defaultFormat = new FormattedTextAsTree.CharacterFormat({
353
+ bold: false,
354
+ italic: true,
355
+ underline: false,
356
+ size: 12,
357
+ font: "Arial",
358
+ });
359
+ text.insertAt(0, "ITAL");
360
+ text.defaultFormat = createPlainFormat();
361
+ text.insertAt(4, "plain");
362
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
363
+ const rendered = render(content, { reactStrictMode });
364
+ assert.ok(rendered.container.querySelector("em"), "Initially: has <em>");
365
+ text.removeRange(0, 4);
366
+ rendered.rerender(content);
367
+ assert.ok(!rendered.container.querySelector("em"), "After delete: no <em>");
368
+ });
369
+ it("applies italic via formatRange", () => {
370
+ const { tree: text } = createFormattedTreeView("Hello World");
371
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
372
+ const rendered = render(content, { reactStrictMode });
373
+ text.formatRange(6, 11, { italic: true });
374
+ rendered.rerender(content);
375
+ const el = rendered.container.querySelector("em");
376
+ assert.ok(el, "Expected <em> after formatRange");
377
+ assert.match(el.textContent ?? "", /World/);
378
+ });
379
+ });
380
+ describe("underline", () => {
381
+ it("inserts underlined text and renders with <u> tag", () => {
382
+ const { tree: text } = createFormattedTreeView("Hello");
383
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
384
+ const rendered = render(content, { reactStrictMode });
385
+ assert.ok(!rendered.container.querySelector("u"), "Initially: no <u>");
386
+ text.defaultFormat = new FormattedTextAsTree.CharacterFormat({
387
+ bold: false,
388
+ italic: false,
389
+ underline: true,
390
+ size: 12,
391
+ font: "Arial",
392
+ });
393
+ text.insertAt(2, "UNDER");
394
+ rendered.rerender(content);
395
+ const el = rendered.container.querySelector("u");
396
+ assert.ok(el, "Expected <u> tag");
397
+ assert.match(el.textContent ?? "", /UNDER/);
398
+ });
399
+ it("deletes underlined text and removes <u> tag", () => {
400
+ const { tree: text } = createFormattedTreeView();
401
+ text.defaultFormat = new FormattedTextAsTree.CharacterFormat({
402
+ bold: false,
403
+ italic: false,
404
+ underline: true,
405
+ size: 12,
406
+ font: "Arial",
407
+ });
408
+ text.insertAt(0, "UNDER");
409
+ text.defaultFormat = createPlainFormat();
410
+ text.insertAt(5, "plain");
411
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
412
+ const rendered = render(content, { reactStrictMode });
413
+ assert.ok(rendered.container.querySelector("u"), "Initially: has <u>");
414
+ text.removeRange(0, 5);
415
+ rendered.rerender(content);
416
+ assert.ok(!rendered.container.querySelector("u"), "After delete: no <u>");
417
+ });
418
+ it("applies underline via formatRange", () => {
419
+ const { tree: text } = createFormattedTreeView("Hello World");
420
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
421
+ const rendered = render(content, { reactStrictMode });
422
+ text.formatRange(6, 11, { underline: true });
423
+ rendered.rerender(content);
424
+ const el = rendered.container.querySelector("u");
425
+ assert.ok(el, "Expected <u> after formatRange");
426
+ assert.match(el.textContent ?? "", /World/);
427
+ });
428
+ });
429
+ describe("size", () => {
430
+ it("inserts huge size text and renders with .ql-size-huge", () => {
431
+ const { tree: text } = createFormattedTreeView("Hello");
432
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
433
+ const rendered = render(content, { reactStrictMode });
434
+ assert.ok(!rendered.container.querySelector(".ql-size-huge"), "Initially: no .ql-size-huge");
435
+ text.defaultFormat = new FormattedTextAsTree.CharacterFormat({
436
+ bold: false,
437
+ italic: false,
438
+ underline: false,
439
+ size: 24,
440
+ font: "Arial",
441
+ });
442
+ text.insertAt(2, "HUGE");
443
+ rendered.rerender(content);
444
+ const el = rendered.container.querySelector(".ql-size-huge");
445
+ assert.ok(el, "Expected .ql-size-huge");
446
+ assert.match(el.textContent ?? "", /HUGE/);
447
+ });
448
+ it("deletes huge size text and removes .ql-size-huge", () => {
449
+ const { tree: text } = createFormattedTreeView();
450
+ text.defaultFormat = new FormattedTextAsTree.CharacterFormat({
451
+ bold: false,
452
+ italic: false,
453
+ underline: false,
454
+ size: 24,
455
+ font: "Arial",
456
+ });
457
+ text.insertAt(0, "HUGE");
458
+ text.defaultFormat = createPlainFormat();
459
+ text.insertAt(4, "plain");
460
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
461
+ const rendered = render(content, { reactStrictMode });
462
+ assert.ok(rendered.container.querySelector(".ql-size-huge"), "Initially: has .ql-size-huge");
463
+ text.removeRange(0, 4);
464
+ rendered.rerender(content);
465
+ assert.ok(!rendered.container.querySelector(".ql-size-huge"), "After delete: no .ql-size-huge");
466
+ });
467
+ it("applies size via formatRange", () => {
468
+ const { tree: text } = createFormattedTreeView("Hello World");
469
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
470
+ const rendered = render(content, { reactStrictMode });
471
+ text.formatRange(6, 11, { size: 24 });
472
+ rendered.rerender(content);
473
+ const el = rendered.container.querySelector(".ql-size-huge");
474
+ assert.ok(el, "Expected .ql-size-huge after formatRange");
475
+ assert.match(el.textContent ?? "", /World/);
476
+ });
477
+ });
478
+ describe("font", () => {
479
+ it("inserts monospace font text and renders with .ql-font-monospace", () => {
480
+ const { tree: text } = createFormattedTreeView("Hello");
481
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
482
+ const rendered = render(content, { reactStrictMode });
483
+ assert.ok(!rendered.container.querySelector(".ql-font-monospace"), "Initially: no .ql-font-monospace");
484
+ text.defaultFormat = new FormattedTextAsTree.CharacterFormat({
485
+ bold: false,
486
+ italic: false,
487
+ underline: false,
488
+ size: 12,
489
+ font: "monospace",
490
+ });
491
+ text.insertAt(2, "MONO");
492
+ rendered.rerender(content);
493
+ const el = rendered.container.querySelector(".ql-font-monospace");
494
+ assert.ok(el, "Expected .ql-font-monospace");
495
+ assert.match(el.textContent ?? "", /MONO/);
496
+ });
497
+ it("deletes monospace font text and removes .ql-font-monospace", () => {
498
+ const { tree: text } = createFormattedTreeView();
499
+ text.defaultFormat = new FormattedTextAsTree.CharacterFormat({
500
+ bold: false,
501
+ italic: false,
502
+ underline: false,
503
+ size: 12,
504
+ font: "monospace",
505
+ });
506
+ text.insertAt(0, "MONO");
507
+ text.defaultFormat = createPlainFormat();
508
+ text.insertAt(4, "plain");
509
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
510
+ const rendered = render(content, { reactStrictMode });
511
+ assert.ok(rendered.container.querySelector(".ql-font-monospace"), "Initially: has .ql-font-monospace");
512
+ text.removeRange(0, 4);
513
+ rendered.rerender(content);
514
+ assert.ok(!rendered.container.querySelector(".ql-font-monospace"), "After delete: no .ql-font-monospace");
515
+ });
516
+ it("applies font via formatRange", () => {
517
+ const { tree: text } = createFormattedTreeView("Hello World");
518
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
519
+ const rendered = render(content, { reactStrictMode });
520
+ text.formatRange(6, 11, { font: "monospace" });
521
+ rendered.rerender(content);
522
+ const el = rendered.container.querySelector(".ql-font-monospace");
523
+ assert.ok(el, "Expected .ql-font-monospace after formatRange");
524
+ assert.match(el.textContent ?? "", /World/);
525
+ });
526
+ });
527
+ });
528
+ }
529
+ });
530
+ // Undo/Redo tests for non-transactional edits
531
+ describe("undo/redo", () => {
532
+ for (const reactStrictMode of [false, true]) {
533
+ describe(`StrictMode: ${reactStrictMode}`, () => {
534
+ it("insert character, undo removes it, redo restores it", () => {
535
+ const treeView = createFormattedTreeViewWithEvents();
536
+ const text = treeView.root;
537
+ const undoRedo = new UndoRedoStacks(treeView.events);
538
+ const editorRef = createRef();
539
+ const content = (_jsx(FormattedMainView, { ref: editorRef, root: toPropTreeNode(text), undoRedo: undoRedo }));
540
+ const rendered = render(content, { reactStrictMode });
541
+ // Insert a character
542
+ text.insertAt(0, "A");
543
+ rendered.rerender(content);
544
+ assert.match(rendered.baseElement.textContent ?? "", /A/);
545
+ // Undo - character should be removed
546
+ editorRef.current?.undo();
547
+ rendered.rerender(content);
548
+ assert(rendered.baseElement.textContent !== null);
549
+ assert.doesNotMatch(rendered.baseElement.textContent, /A/);
550
+ // Redo - character should be restored
551
+ editorRef.current?.redo();
552
+ rendered.rerender(content);
553
+ assert.match(rendered.baseElement.textContent ?? "", /A/);
554
+ });
555
+ it("insert character, make bold, undo removes bold but keeps character", () => {
556
+ const treeView = createFormattedTreeViewWithEvents();
557
+ const text = treeView.root;
558
+ const undoRedo = new UndoRedoStacks(treeView.events);
559
+ const editorRef = createRef();
560
+ const content = (_jsx(FormattedMainView, { ref: editorRef, root: toPropTreeNode(text), undoRedo: undoRedo }));
561
+ const rendered = render(content, { reactStrictMode });
562
+ // Insert a character
563
+ text.insertAt(0, "B");
564
+ rendered.rerender(content);
565
+ assert.match(rendered.baseElement.textContent ?? "", /B/);
566
+ assert.ok(!rendered.container.querySelector("strong"), "Initially: no <strong>");
567
+ // Make it bold
568
+ text.formatRange(0, 1, { bold: true });
569
+ rendered.rerender(content);
570
+ assert.ok(rendered.container.querySelector("strong"), "After format: has <strong>");
571
+ // Undo - bold should be removed, character should remain
572
+ editorRef.current?.undo();
573
+ rendered.rerender(content);
574
+ assert.match(rendered.baseElement.textContent ?? "", /B/);
575
+ assert.ok(!rendered.container.querySelector("strong"), "After undo: no <strong>, character remains");
576
+ });
577
+ it("multiple operations in transaction undo together as one unit", () => {
578
+ const treeView = createFormattedTreeViewWithEvents();
579
+ const text = treeView.root;
580
+ const undoRedo = new UndoRedoStacks(treeView.events);
581
+ const editorRef = createRef();
582
+ const content = (_jsx(FormattedMainView, { ref: editorRef, root: toPropTreeNode(text), undoRedo: undoRedo }));
583
+ const rendered = render(content, { reactStrictMode });
584
+ // Two operations in one transaction
585
+ TreeAlpha.branch(text)?.runTransaction(() => {
586
+ text.insertAt(0, "A");
587
+ text.insertAt(1, "B");
588
+ });
589
+ rendered.rerender(content);
590
+ assert.match(rendered.baseElement.textContent ?? "", /AB/);
591
+ // Single undo should remove both characters
592
+ editorRef.current?.undo();
593
+ rendered.rerender(content);
594
+ assert(rendered.baseElement.textContent !== null);
595
+ assert.doesNotMatch(rendered.baseElement.textContent, /A/);
596
+ assert.doesNotMatch(rendered.baseElement.textContent, /B/);
597
+ // Single redo should restore both characters
598
+ editorRef.current?.redo();
599
+ rendered.rerender(content);
600
+ assert.match(rendered.baseElement.textContent ?? "", /AB/);
601
+ });
602
+ });
603
+ }
604
+ });
605
+ describe("copy-paste helpers", () => {
606
+ /** Helper to create an HTMLElement with inline styles. */
607
+ function styledElement(styles) {
608
+ const el = document.createElement("span");
609
+ Object.assign(el.style, styles);
610
+ return el;
611
+ }
612
+ describe("parseCssFontSize", () => {
613
+ it("returns undefined when no fontSize is set", () => {
614
+ assert.equal(parseCssFontSize(styledElement({})), undefined);
615
+ });
616
+ it("returns Quill size name for supported pixel values", () => {
617
+ assert.equal(parseCssFontSize(styledElement({ fontSize: "10px" })), "small");
618
+ assert.equal(parseCssFontSize(styledElement({ fontSize: "18px" })), "large");
619
+ assert.equal(parseCssFontSize(styledElement({ fontSize: "24px" })), "huge");
620
+ });
621
+ it("returns undefined for default or unrecognized sizes", () => {
622
+ assert.equal(parseCssFontSize(styledElement({ fontSize: "12px" })), undefined);
623
+ assert.equal(parseCssFontSize(styledElement({ fontSize: "42px" })), undefined);
624
+ });
625
+ });
626
+ describe("parseCssFontFamily", () => {
627
+ it("returns undefined when no fontFamily is set", () => {
628
+ assert.equal(parseCssFontFamily(styledElement({})), undefined);
629
+ });
630
+ it("returns first recognized font in a comma-separated stack", () => {
631
+ assert.equal(parseCssFontFamily(styledElement({ fontFamily: "monospace" })), "monospace");
632
+ assert.equal(parseCssFontFamily(styledElement({ fontFamily: '"Courier New", monospace' })), "monospace");
633
+ assert.equal(parseCssFontFamily(styledElement({ fontFamily: '"Times New Roman", "Arial", serif' })), "Arial");
634
+ });
635
+ it("strips single quotes around recognized font names", () => {
636
+ assert.equal(parseCssFontFamily(styledElement({ fontFamily: "'Arial'" })), "Arial");
637
+ });
638
+ it("returns undefined for unrecognized fonts", () => {
639
+ assert.equal(parseCssFontFamily(styledElement({ fontFamily: '"Courier New", fantasy' })), undefined);
640
+ });
641
+ });
642
+ describe("clipboardFormatMatcher", () => {
643
+ it("returns delta unchanged for non-HTMLElement nodes", () => {
644
+ const delta = new Delta().insert("hello");
645
+ const text = document.createTextNode("hello");
646
+ const result = clipboardFormatMatcher(text, delta);
647
+ assert.deepEqual(result.ops, delta.ops);
648
+ });
649
+ it("applies size and font attributes from inline styles", () => {
650
+ const delta = new Delta().insert("hello");
651
+ const el = styledElement({ fontSize: "18px", fontFamily: "serif" });
652
+ const result = clipboardFormatMatcher(el, delta);
653
+ assert.equal(result.ops[0]?.attributes?.size, "large");
654
+ assert.equal(result.ops[0]?.attributes?.font, "serif");
655
+ });
656
+ it("returns delta unchanged when no recognized styles", () => {
657
+ const delta = new Delta().insert("hello");
658
+ const el = styledElement({});
659
+ const result = clipboardFormatMatcher(el, delta);
660
+ assert.deepEqual(result.ops, delta.ops);
661
+ });
662
+ });
663
+ });
664
+ // Unicode 16+ (joined emojis) section - test attribute cycling
665
+ describe("Unicode 16+ joined emoji attribute cycling", () => {
666
+ // ZWJ (Zero Width Joiner) emoji sequence: ๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ = family emoji
667
+ const joinedEmoji = "๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ";
668
+ for (const reactStrictMode of [false, true]) {
669
+ describe(`StrictMode: ${reactStrictMode}`, () => {
670
+ it("applies bold to joined emoji and removes it preserving text", () => {
671
+ const { tree: text } = createFormattedTreeView(`Test ${joinedEmoji} Text`);
672
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
673
+ const rendered = render(content, { reactStrictMode });
674
+ const emojiStart = 5; // "Test " is 5 chars
675
+ const emojiLength = [...joinedEmoji].length;
676
+ text.formatRange(emojiStart, emojiStart + emojiLength, { bold: true });
677
+ rendered.rerender(content);
678
+ assert.ok(rendered.container.querySelector("strong"), "After bold: expected <strong>");
679
+ assert.ok((rendered.baseElement.textContent ?? "").includes(joinedEmoji), "After bold: emoji should be preserved");
680
+ text.formatRange(emojiStart, emojiStart + emojiLength, { bold: false });
681
+ rendered.rerender(content);
682
+ assert.ok(!rendered.container.querySelector("strong"), "After remove bold: no <strong> expected");
683
+ assert.ok((rendered.baseElement.textContent ?? "").includes(joinedEmoji), "After remove bold: emoji should still be preserved");
684
+ });
685
+ it("applies size to joined emoji and removes it preserving text", () => {
686
+ const { tree: text } = createFormattedTreeView(`Test ${joinedEmoji} Text`);
687
+ const content = _jsx(FormattedMainView, { root: toPropTreeNode(text) });
688
+ const rendered = render(content, { reactStrictMode });
689
+ const emojiStart = 5;
690
+ const emojiLength = [...joinedEmoji].length;
691
+ text.formatRange(emojiStart, emojiStart + emojiLength, { size: 24 });
692
+ rendered.rerender(content);
693
+ assert.ok(rendered.container.querySelector(".ql-size-huge"), "After size: expected .ql-size-huge");
694
+ assert.ok((rendered.baseElement.textContent ?? "").includes(joinedEmoji), "Emoji preserved");
695
+ text.formatRange(emojiStart, emojiStart + emojiLength, { size: 12 });
696
+ rendered.rerender(content);
697
+ assert.ok(!rendered.container.querySelector(".ql-size-huge"), "After remove: no .ql-size-huge");
698
+ assert.ok((rendered.baseElement.textContent ?? "").includes(joinedEmoji), "Emoji still preserved");
699
+ });
700
+ });
701
+ }
702
+ });
703
+ describe("parseLineTag", () => {
704
+ it("return lineTag for valid header", () => {
705
+ const result = parseLineTag({ header: 1 });
706
+ assert.ok(result, "Expected a line tag for header 1");
707
+ assert.equal(result.value, "h1", "Expected tag to be h1");
708
+ });
709
+ it("returns lineTag for valid bullet list", () => {
710
+ const result = parseLineTag({ list: "bullet" });
711
+ assert.ok(result, "Expected a line tag for bullet list");
712
+ assert.equal(result.value, "li", "Expected tag to be li)");
713
+ });
714
+ // Tests for unsupported parameters - should return default header ("h5"), not throw an error.
715
+ // Also used for when formatting is stripped from a newline and it becomes a default newline
716
+ it("returns undefined for unsupported parameter", () => {
717
+ const result = parseLineTag({ header: 7 });
718
+ assert.ok(result, "Expected a line tag for header 5");
719
+ assert.equal(result.value, "h5", "Expected tag to be h5 for unsupported header level");
720
+ });
721
+ });
722
+ // tests quillFormattedview conversion that feeds into quill delta generation,
723
+ // specifically for line atoms which have special handling for headers and lists.
724
+ // Quill always has a trailing newline, so these tests set up the string with a newline,
725
+ // then replace it with a line atom with the appropriate tag.
726
+ describe("buildDeltaFromTree with line Atoms", () => {
727
+ it("emits header attribute for h1 line atom", () => {
728
+ const { tree } = createFormattedTreeView("Hello\n");
729
+ tree.removeRange(5, 6);
730
+ tree.insertWithFormattingAt(5, [
731
+ new FormattedTextAsTree.StringAtom({
732
+ content: new FormattedTextAsTree.StringLineAtom({
733
+ tag: FormattedTextAsTree.LineTag("h1"),
734
+ }),
735
+ format: createPlainFormat(),
736
+ }),
737
+ ]);
738
+ const ops = buildDeltaFromTree(tree);
739
+ const lineOp = ops.find((op) => op.insert === "\n" && op.attributes?.header === 1);
740
+ assert.ok(lineOp, "Expected { insert : `\\n`, attributes: { header: 1 } } in delta");
741
+ });
742
+ it("emits header attribute for li line atom", () => {
743
+ const { tree } = createFormattedTreeView("item\n");
744
+ tree.removeRange(4, 5);
745
+ tree.insertWithFormattingAt(4, [
746
+ new FormattedTextAsTree.StringAtom({
747
+ content: new FormattedTextAsTree.StringLineAtom({
748
+ tag: FormattedTextAsTree.LineTag("li"),
749
+ }),
750
+ format: createPlainFormat(),
751
+ }),
752
+ ]);
753
+ const ops = buildDeltaFromTree(tree);
754
+ const lineOp = ops.find((op) => op.insert === "\n" && op.attributes?.list === "bullet");
755
+ assert.ok(lineOp, "Expected { insert : `\\n`, attributes: { list: 'bullet' } } in delta");
756
+ });
757
+ });
758
+ });
759
+ });
760
+ //# sourceMappingURL=textEditor.test.js.map