/*! * Copyright (c) Microsoft Corporation and contributors. All rights reserved. * Licensed under the MIT License. */ import { strict as assert } from "node:assert"; import { toPropTreeNode, createUndoRedo, type UndoRedo } from "@fluidframework/react/internal"; import { TreeViewConfiguration } from "@fluidframework/tree"; import { independentView, PlainText, TreeAlpha, type TreeViewAlpha, } from "@fluidframework/tree/alpha"; import { render } from "@testing-library/react"; import globalJsdom from "global-jsdom"; import Quill from "quill-next"; import { FormattedTextDefault } from "../formatted/index.js"; import { clipboardFormatMatcher, FormattedMainView, parseCssFontFamily, parseCssFontSize, parseLineTag, buildDeltaFromTree, // Allow import of files being tested // eslint-disable-next-line import-x/no-internal-modules } from "../formatted/quillFormattedView.js"; // eslint-disable-next-line import-x/no-internal-modules import { Delta } from "../formatted/quillAttributeUtils.js"; import { QuillMainView, // Allow import of files being tested } from "../plain/index.js"; // Configuration for creating formatted text views const formattedTreeConfig = new TreeViewConfiguration({ schema: FormattedTextDefault.Tree, }); /** * Creates a TreeView for formatted text, initialized with the provided initial value. */ function createFormattedTreeView(initialValue = ""): { tree: FormattedTextDefault.Tree; } { const treeView = independentView(formattedTreeConfig); treeView.initialize(FormattedTextDefault.Tree.fromString(initialValue)); return { tree: treeView.root }; } /** * Creates a TreeView for formatted text with events access (needed for undo/redo tests). */ function createFormattedTreeViewWithEvents( initialValue = "", ): TreeViewAlpha { const treeView = independentView(formattedTreeConfig); treeView.initialize(FormattedTextDefault.Tree.fromString(initialValue)); return treeView; } // TODO add collaboration tests when rich formatting is supported using TestContainerRuntimeFactory from // @fluidframework/test-utils to test rich formatting data sync between multiple collaborators describe("textEditor", () => { let cleanup: () => void; // TODO: why does making this beforeEach/afterEach instead of before/after cause cleanup to crash? // It seems like each test should be able to have its own clean DOM. before(() => { cleanup = globalJsdom(); }); after(() => { cleanup(); }); describe(`Quill view`, () => { describe("dom tests", () => { // Run without strict mode to make sure it works in a normal production setup. // Run with strict mode to potentially detect additional issues. for (const reactStrictMode of [false, true]) { describe(`StrictMode: ${reactStrictMode}`, () => { const ViewComponent = QuillMainView; it("keeps remote editor DOM in sync after a user edit", () => { const text = PlainText.Tree.fromString(""); const root = toPropTreeNode(text); const rendered = render( <> , { reactStrictMode }, ); const sourceContainer = rendered.container.querySelector(".ql-container"); const editors = rendered.container.querySelectorAll(".ql-editor"); const sourceEditor = editors[0]; const remoteEditor = editors[1]; assert.ok( sourceContainer !== null && sourceEditor !== undefined && remoteEditor !== undefined, ); const source = Quill.find(sourceContainer) as Quill; source.setText("Hello", "user"); assert.equal(sourceEditor.innerHTML, "

Hello

"); // Check that the editors have the same content: they should be kept in sync assert.equal(remoteEditor.innerHTML, sourceEditor.innerHTML); source.setText("Hello\nWorld", "user"); // Check the edit did not cause the views to de-sync. assert.equal(sourceEditor.innerHTML, "

Hello

World

"); assert.equal(remoteEditor.innerHTML, sourceEditor.innerHTML); // Check a trailing new line also does not cause de-sync. source.setText("Hello\nWorld\n", "user"); assert.equal(remoteEditor.innerHTML, sourceEditor.innerHTML); }); it("renders MainView with editor container", () => { const text = PlainText.Tree.fromString(""); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok( rendered.container.querySelector(".ql-editor"), "Quill editor should be present after mount", ); }); it("renders MainView with initial text content", () => { const text = PlainText.Tree.fromString("Hello World"); const content = ; const rendered = render(content, { reactStrictMode }); assert.match(rendered.baseElement.textContent ?? "", /Hello World/); }); it("invalidates view when tree is mutated", () => { const text = PlainText.Tree.fromString("Hello"); const content = ; const rendered = render(content, { reactStrictMode }); // Mutate the tree by inserting text text.insertAt(5, " World"); // Rerender and verify the view updates rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /Hello World/); }); it("invalidates view when text is removed", () => { const text = PlainText.Tree.fromString("Hello World"); const content = ; const rendered = render(content, { reactStrictMode }); // Mutate the tree by removing " World" (indices 5 to 11) text.removeRange(5, 11); // Rerender and verify the view updates rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /Hello/); assert(rendered.baseElement.textContent !== null); assert.doesNotMatch(rendered.baseElement.textContent, /World/); }); it("invalidates view when text is cleared and replaced", () => { const text = PlainText.Tree.fromString("Original"); const content = ; const rendered = render(content, { reactStrictMode }); // Clear all text const length = [...text.characters()].length; text.removeRange(0, length); // Insert new text text.insertAt(0, "Replaced"); // Rerender and verify the view updates rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /Replaced/); assert(rendered.baseElement.textContent !== null); assert.doesNotMatch(rendered.baseElement.textContent, /Original/); }); // Tests for surrogate pair characters (emojis use 2 UTF-16 code units) // These verify correct handling where editor indexing may differ from iteration. it("renders MainView with surrogate pair characters", () => { // ๐Ÿ˜€ is a surrogate pair: "๐Ÿ˜€".length === 2, but [..."๐Ÿ˜€"].length === 1 const text = PlainText.Tree.fromString("Hello ๐Ÿ˜€ World"); const content = ; const rendered = render(content, { reactStrictMode }); assert.match(rendered.baseElement.textContent ?? "", /Hello ๐Ÿ˜€ World/); }); it("inserts text after surrogate pair characters", () => { const text = PlainText.Tree.fromString("A๐Ÿ˜€B"); const content = ; const rendered = render(content, { reactStrictMode }); // Insert after the emoji (index 2 in character count: A, ๐Ÿ˜€, B) text.insertAt(2, "X"); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /A๐Ÿ˜€XB/); }); it("removes surrogate pair characters", () => { const text = PlainText.Tree.fromString("A๐Ÿ˜€B"); const content = ; const rendered = render(content, { reactStrictMode }); // Remove the emoji (index 1, length 1 in character count) text.removeRange(1, 2); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /AB/); assert(rendered.baseElement.textContent !== null); assert.doesNotMatch(rendered.baseElement.textContent, /๐Ÿ˜€/); }); it("handles multiple surrogate pair characters", () => { const text = PlainText.Tree.fromString("๐Ÿ‘‹๐ŸŒ๐ŸŽ‰"); const content = ; const rendered = render(content, { reactStrictMode }); // Insert between emojis text.insertAt(2, "!"); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /๐Ÿ‘‹๐ŸŒ!๐ŸŽ‰/); }); }); } }); describe("toolbar", () => { const mockLabel = Symbol("test"); for (const reactStrictMode of [false, true]) { describe(`StrictMode: ${reactStrictMode}`, () => { it("undo and redo buttons are disabled when undoRedo is not provided", () => { const text = PlainText.Tree.fromString(""); const rendered = render(, { reactStrictMode, }); const undoButton = rendered.container.querySelector(".ql-undo"); const redoButton = rendered.container.querySelector(".ql-redo"); assert.ok(undoButton?.disabled === true, "Undo button should be disabled"); assert.ok(redoButton?.disabled === true, "Redo button should be disabled"); }); it("undo and redo buttons are enabled when undoRedo is provided", () => { const mockUndoRedo: UndoRedo = { undo: () => {}, redo: () => {}, canUndo: () => true, canRedo: () => true, dispose: () => {}, }; const text = PlainText.Tree.fromString(""); const rendered = render( , { reactStrictMode }, ); const undoButton = rendered.container.querySelector(".ql-undo"); const redoButton = rendered.container.querySelector(".ql-redo"); assert.equal(undoButton?.disabled, false, "Undo button should be enabled"); assert.equal(redoButton?.disabled, false, "Redo button should be enabled"); }); }); } }); }); // Formatted text view tests - Initial view rendering (matching plain text test structure) describe("Formatted Quill view", () => { describe("dom tests", () => { for (const reactStrictMode of [false, true]) { describe(`StrictMode: ${reactStrictMode}`, () => { it("keeps remote editor DOM in sync after a user edit", () => { const { tree } = createFormattedTreeView(); const root = toPropTreeNode(tree); const rendered = render( <> , { reactStrictMode }, ); const sourceContainer = rendered.container.querySelector(".ql-container"); const editors = rendered.container.querySelectorAll(".ql-editor"); const sourceEditor = editors[0]; const remoteEditor = editors[1]; assert.ok( sourceContainer !== null && sourceEditor !== undefined && remoteEditor !== undefined, ); const source = Quill.find(sourceContainer) as Quill; source.setText("Hello", "user"); assert.equal(sourceEditor.innerHTML, "

Hello

"); // Check that the editors have the same content: they should be kept in sync assert.equal(remoteEditor.innerHTML, sourceEditor.innerHTML); // Do a formatting operation that adds a line atom to the end of the string. // This hits an edge case in the Quill integration because Quill requires a trailing newline, // so our integration replaces its synthetic newline with the real line atom added by this change. source.formatLine(0, source.getLength(), "list", "bullet", "user"); // Check that the above format operation added the expected list item. assert.match(sourceEditor.innerHTML, /^
    /); // Check that the editors have the same content, ensuring they didn't get out of sync. // This validates, among other things, that the fix for handling of the trailing new line doesn't regress. assert.equal(remoteEditor.innerHTML, sourceEditor.innerHTML); }); it("renders FormattedMainView with editor container", () => { const { tree } = createFormattedTreeView(); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok( rendered.container.querySelector(".ql-editor"), "Quill editor should be present after mount", ); assert.ok( rendered.container.querySelector(".ql-toolbar"), "Snow toolbar should be present after mount", ); }); it("renders FormattedMainView with initial text content", () => { const { tree } = createFormattedTreeView("Hello World"); const content = ; const rendered = render(content, { reactStrictMode }); assert.match(rendered.baseElement.textContent ?? "", /Hello World/); }); it("invalidates view when tree is mutated", () => { const { tree: text } = createFormattedTreeView("Hello"); const content = ; const rendered = render(content, { reactStrictMode }); // Mutate the tree by inserting text text.insertAt(5, " World"); // Rerender and verify the view updates rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /Hello World/); }); it("invalidates view when text is removed", () => { const { tree: text } = createFormattedTreeView("Hello World"); const content = ; const rendered = render(content, { reactStrictMode }); // Mutate the tree by removing " World" (indices 5 to 11) text.removeRange(5, 11); // Rerender and verify the view updates rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /Hello/); assert(rendered.baseElement.textContent !== null); assert.doesNotMatch(rendered.baseElement.textContent, /World/); }); it("invalidates view when text is cleared and replaced", () => { const { tree: text } = createFormattedTreeView("Original"); const content = ; const rendered = render(content, { reactStrictMode }); // Clear all text const length = [...text.characters()].length; text.removeRange(0, length); // Insert new text text.insertAt(0, "Replaced"); // Rerender and verify the view updates rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /Replaced/); assert(rendered.baseElement.textContent !== null); assert.doesNotMatch(rendered.baseElement.textContent, /Original/); }); // Tests for surrogate pair characters (emojis use 2 UTF-16 code units) // These verify correct handling where editor indexing may differ from iteration. it("renders FormattedMainView with surrogate pair characters", () => { // ๐Ÿ˜€ is a surrogate pair: "๐Ÿ˜€".length === 2, but [..."๐Ÿ˜€"].length === 1 const { tree: text } = createFormattedTreeView("Hello ๐Ÿ˜€ World"); const content = ; const rendered = render(content, { reactStrictMode }); assert.match(rendered.baseElement.textContent ?? "", /Hello ๐Ÿ˜€ World/); }); it("inserts text after surrogate pair characters", () => { const { tree: text } = createFormattedTreeView("A๐Ÿ˜€B"); const content = ; const rendered = render(content, { reactStrictMode }); // Insert after the emoji (index 2 in character count: A, ๐Ÿ˜€, B) text.insertAt(2, "X"); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /A๐Ÿ˜€XB/); }); it("removes surrogate pair characters", () => { const { tree: text } = createFormattedTreeView("A๐Ÿ˜€B"); const content = ; const rendered = render(content, { reactStrictMode }); // Remove the emoji (index 1, length 1 in character count) text.removeRange(1, 2); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /AB/); assert(rendered.baseElement.textContent !== null); assert.doesNotMatch(rendered.baseElement.textContent, /๐Ÿ˜€/); }); it("handles multiple surrogate pair characters", () => { const { tree: text } = createFormattedTreeView("๐Ÿ‘‹๐ŸŒ๐ŸŽ‰"); const content = ; const rendered = render(content, { reactStrictMode }); // Insert between emojis text.insertAt(2, "!"); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /๐Ÿ‘‹๐ŸŒ!๐ŸŽ‰/); }); }); } }); // Helper to create default format function createPlainFormat(): FormattedTextDefault.CharacterFormat { return new FormattedTextDefault.CharacterFormat({ bold: false, italic: false, underline: false, size: 12, font: "Arial", }); } // Essential tests for character attributes // Each attribute needs: insert, delete, and formatRange tests describe("character attribute tests", () => { for (const reactStrictMode of [false, true]) { describe(`StrictMode: ${reactStrictMode}`, () => { it("delete on empty string does not throw", () => { const { tree: text } = createFormattedTreeView(); const content = ; const rendered = render(content, { reactStrictMode }); assert.doesNotThrow(() => { text.removeRange(0, 0); rendered.rerender(content); }); }); describe("bold", () => { it("inserts bold text and renders with tag", () => { const { tree: text } = createFormattedTreeView("Hello"); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok(!rendered.container.querySelector("strong"), "Initially: no "); text.insertAt(2, "BOLD", { bold: true, italic: false, underline: false, size: 12, font: "Arial", }); rendered.rerender(content); const el = rendered.container.querySelector("strong"); assert.ok(el, "Expected tag"); assert.match(el.textContent ?? "", /BOLD/); }); it("deletes bold text and removes tag", () => { const { tree: text } = createFormattedTreeView(); text.insertAt(0, "BOLD", { bold: true, italic: false, underline: false, size: 12, font: "Arial", }); text.insertAt(4, "plain", createPlainFormat()); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok(rendered.container.querySelector("strong"), "Initially: has "); text.removeRange(0, 4); rendered.rerender(content); assert.ok( !rendered.container.querySelector("strong"), "After delete: no ", ); }); it("applies bold via formatRange", () => { const { tree: text } = createFormattedTreeView("Hello World"); const content = ; const rendered = render(content, { reactStrictMode }); text.formatRange(6, 11, { bold: true }); rendered.rerender(content); const el = rendered.container.querySelector("strong"); assert.ok(el, "Expected after formatRange"); assert.match(el.textContent ?? "", /World/); }); }); describe("italic", () => { it("inserts italic text and renders with tag", () => { const { tree: text } = createFormattedTreeView("Hello"); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok(!rendered.container.querySelector("em"), "Initially: no "); text.insertAt(2, "ITAL", { bold: false, italic: true, underline: false, size: 12, font: "Arial", }); rendered.rerender(content); const el = rendered.container.querySelector("em"); assert.ok(el, "Expected tag"); assert.match(el.textContent ?? "", /ITAL/); }); it("deletes italic text and removes tag", () => { const { tree: text } = createFormattedTreeView(); text.insertAt(0, "ITAL", { bold: false, italic: true, underline: false, size: 12, font: "Arial", }); text.insertAt(4, "plain", createPlainFormat()); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok(rendered.container.querySelector("em"), "Initially: has "); text.removeRange(0, 4); rendered.rerender(content); assert.ok(!rendered.container.querySelector("em"), "After delete: no "); }); it("applies italic via formatRange", () => { const { tree: text } = createFormattedTreeView("Hello World"); const content = ; const rendered = render(content, { reactStrictMode }); text.formatRange(6, 11, { italic: true }); rendered.rerender(content); const el = rendered.container.querySelector("em"); assert.ok(el, "Expected after formatRange"); assert.match(el.textContent ?? "", /World/); }); }); describe("underline", () => { it("inserts underlined text and renders with tag", () => { const { tree: text } = createFormattedTreeView("Hello"); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok(!rendered.container.querySelector("u"), "Initially: no "); text.insertAt(2, "UNDER", { bold: false, italic: false, underline: true, size: 12, font: "Arial", }); rendered.rerender(content); const el = rendered.container.querySelector("u"); assert.ok(el, "Expected tag"); assert.match(el.textContent ?? "", /UNDER/); }); it("deletes underlined text and removes tag", () => { const { tree: text } = createFormattedTreeView(); text.insertAt(0, "UNDER", { bold: false, italic: false, underline: true, size: 12, font: "Arial", }); text.insertAt(5, "plain", createPlainFormat()); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok(rendered.container.querySelector("u"), "Initially: has "); text.removeRange(0, 5); rendered.rerender(content); assert.ok(!rendered.container.querySelector("u"), "After delete: no "); }); it("applies underline via formatRange", () => { const { tree: text } = createFormattedTreeView("Hello World"); const content = ; const rendered = render(content, { reactStrictMode }); text.formatRange(6, 11, { underline: true }); rendered.rerender(content); const el = rendered.container.querySelector("u"); assert.ok(el, "Expected after formatRange"); assert.match(el.textContent ?? "", /World/); }); }); describe("size", () => { it("inserts huge size text and renders with .ql-size-huge", () => { const { tree: text } = createFormattedTreeView("Hello"); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok( !rendered.container.querySelector(".ql-size-huge"), "Initially: no .ql-size-huge", ); text.insertAt(2, "HUGE", { bold: false, italic: false, underline: false, size: 24, font: "Arial", }); rendered.rerender(content); const el = rendered.container.querySelector(".ql-size-huge"); assert.ok(el, "Expected .ql-size-huge"); assert.match(el.textContent ?? "", /HUGE/); }); it("deletes huge size text and removes .ql-size-huge", () => { const { tree: text } = createFormattedTreeView(); text.insertAt(0, "HUGE", { bold: false, italic: false, underline: false, size: 24, font: "Arial", }); text.insertAt(4, "plain", createPlainFormat()); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok( rendered.container.querySelector(".ql-size-huge"), "Initially: has .ql-size-huge", ); text.removeRange(0, 4); rendered.rerender(content); assert.ok( !rendered.container.querySelector(".ql-size-huge"), "After delete: no .ql-size-huge", ); }); it("applies size via formatRange", () => { const { tree: text } = createFormattedTreeView("Hello World"); const content = ; const rendered = render(content, { reactStrictMode }); text.formatRange(6, 11, { size: 24 }); rendered.rerender(content); const el = rendered.container.querySelector(".ql-size-huge"); assert.ok(el, "Expected .ql-size-huge after formatRange"); assert.match(el.textContent ?? "", /World/); }); }); describe("font", () => { it("inserts monospace font text and renders with .ql-font-monospace", () => { const { tree: text } = createFormattedTreeView("Hello"); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok( !rendered.container.querySelector(".ql-font-monospace"), "Initially: no .ql-font-monospace", ); text.insertAt(2, "MONO", { bold: false, italic: false, underline: false, size: 12, font: "monospace", }); rendered.rerender(content); const el = rendered.container.querySelector(".ql-font-monospace"); assert.ok(el, "Expected .ql-font-monospace"); assert.match(el.textContent ?? "", /MONO/); }); it("deletes monospace font text and removes .ql-font-monospace", () => { const { tree: text } = createFormattedTreeView(); text.insertAt(0, "MONO", { bold: false, italic: false, underline: false, size: 12, font: "monospace", }); text.insertAt(4, "plain", createPlainFormat()); const content = ; const rendered = render(content, { reactStrictMode }); assert.ok( rendered.container.querySelector(".ql-font-monospace"), "Initially: has .ql-font-monospace", ); text.removeRange(0, 4); rendered.rerender(content); assert.ok( !rendered.container.querySelector(".ql-font-monospace"), "After delete: no .ql-font-monospace", ); }); it("applies font via formatRange", () => { const { tree: text } = createFormattedTreeView("Hello World"); const content = ; const rendered = render(content, { reactStrictMode }); text.formatRange(6, 11, { font: "monospace" }); rendered.rerender(content); const el = rendered.container.querySelector(".ql-font-monospace"); assert.ok(el, "Expected .ql-font-monospace after formatRange"); assert.match(el.textContent ?? "", /World/); }); }); }); } }); // Undo/Redo tests for non-transactional edits describe("undo/redo", () => { for (const reactStrictMode of [false, true]) { describe(`StrictMode: ${reactStrictMode}`, () => { it("insert character, undo removes it, redo restores it", () => { const treeView = createFormattedTreeViewWithEvents(); const text = treeView.root; const manager = createUndoRedo(treeView); const content = ; const rendered = render(content, { reactStrictMode }); // Insert a character text.insertAt(0, "A"); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /A/); // Undo - character should be removed manager.undo(); rendered.rerender(content); assert(rendered.baseElement.textContent !== null); assert.doesNotMatch(rendered.baseElement.textContent, /A/); // Redo - character should be restored manager.redo(); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /A/); }); it("insert character, make bold, undo removes bold but keeps character", () => { const treeView = createFormattedTreeViewWithEvents(); const text = treeView.root; const manager = createUndoRedo(treeView); const content = ; const rendered = render(content, { reactStrictMode }); // Insert a character text.insertAt(0, "B"); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /B/); assert.ok(!rendered.container.querySelector("strong"), "Initially: no "); // Make it bold text.formatRange(0, 1, { bold: true }); rendered.rerender(content); assert.ok( rendered.container.querySelector("strong"), "After format: has ", ); // Undo - bold should be removed, character should remain manager.undo(); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /B/); assert.ok( !rendered.container.querySelector("strong"), "After undo: no , character remains", ); }); it("multiple operations in transaction undo together as one unit", () => { const treeView = createFormattedTreeViewWithEvents(); const text = treeView.root; const manager = createUndoRedo(treeView); const content = ; const rendered = render(content, { reactStrictMode }); // Two operations in one transaction TreeAlpha.context(text).runTransaction(() => { text.insertAt(0, "A"); text.insertAt(1, "B"); }); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /AB/); // Single undo should remove both characters manager.undo(); rendered.rerender(content); assert(rendered.baseElement.textContent !== null); assert.doesNotMatch(rendered.baseElement.textContent, /A/); assert.doesNotMatch(rendered.baseElement.textContent, /B/); // Single redo should restore both characters manager.redo(); rendered.rerender(content); assert.match(rendered.baseElement.textContent ?? "", /AB/); }); }); } }); describe("copy-paste helpers", () => { /** Helper to create an HTMLElement with inline styles. */ function styledElement(styles: Partial): HTMLElement { const el = document.createElement("span"); Object.assign(el.style, styles); return el; } describe("parseCssFontSize", () => { it("returns undefined when no fontSize is set", () => { assert.equal(parseCssFontSize(styledElement({})), undefined); }); it("returns Quill size name for supported pixel values", () => { assert.equal(parseCssFontSize(styledElement({ fontSize: "10px" })), "small"); assert.equal(parseCssFontSize(styledElement({ fontSize: "18px" })), "large"); assert.equal(parseCssFontSize(styledElement({ fontSize: "24px" })), "huge"); }); it("returns undefined for default or unrecognized sizes", () => { assert.equal(parseCssFontSize(styledElement({ fontSize: "12px" })), undefined); assert.equal(parseCssFontSize(styledElement({ fontSize: "42px" })), undefined); }); }); describe("parseCssFontFamily", () => { it("returns undefined when no fontFamily is set", () => { assert.equal(parseCssFontFamily(styledElement({})), undefined); }); it("returns first recognized font in a comma-separated stack", () => { assert.equal( parseCssFontFamily(styledElement({ fontFamily: "monospace" })), "monospace", ); assert.equal( parseCssFontFamily(styledElement({ fontFamily: '"Courier New", monospace' })), "monospace", ); assert.equal( parseCssFontFamily( styledElement({ fontFamily: '"Times New Roman", "Arial", serif' }), ), "Arial", ); }); it("strips single quotes around recognized font names", () => { assert.equal(parseCssFontFamily(styledElement({ fontFamily: "'Arial'" })), "Arial"); }); it("returns undefined for unrecognized fonts", () => { assert.equal( parseCssFontFamily(styledElement({ fontFamily: '"Courier New", fantasy' })), undefined, ); }); }); describe("clipboardFormatMatcher", () => { it("returns delta unchanged for non-HTMLElement nodes", () => { const delta = new Delta().insert("hello"); const text = document.createTextNode("hello"); const result = clipboardFormatMatcher(text, delta); assert.deepEqual(result.ops, delta.ops); }); it("applies size and font attributes from inline styles", () => { const delta = new Delta().insert("hello"); const el = styledElement({ fontSize: "18px", fontFamily: "serif" }); const result = clipboardFormatMatcher(el, delta); assert.equal(result.ops[0]?.attributes?.size, "large"); assert.equal(result.ops[0]?.attributes?.font, "serif"); }); it("returns delta unchanged when no recognized styles", () => { const delta = new Delta().insert("hello"); const el = styledElement({}); const result = clipboardFormatMatcher(el, delta); assert.deepEqual(result.ops, delta.ops); }); }); }); // Unicode 16+ (joined emojis) section - test attribute cycling describe("Unicode 16+ joined emoji attribute cycling", () => { // ZWJ (Zero Width Joiner) emoji sequence: ๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ = family emoji const joinedEmoji = "๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ"; for (const reactStrictMode of [false, true]) { describe(`StrictMode: ${reactStrictMode}`, () => { it("applies bold to joined emoji and removes it preserving text", () => { const { tree: text } = createFormattedTreeView(`Test ${joinedEmoji} Text`); const content = ; const rendered = render(content, { reactStrictMode }); const emojiStart = 5; // "Test " is 5 chars const emojiLength = [...joinedEmoji].length; text.formatRange(emojiStart, emojiStart + emojiLength, { bold: true }); rendered.rerender(content); assert.ok( rendered.container.querySelector("strong"), "After bold: expected ", ); assert.ok( (rendered.baseElement.textContent ?? "").includes(joinedEmoji), "After bold: emoji should be preserved", ); text.formatRange(emojiStart, emojiStart + emojiLength, { bold: false }); rendered.rerender(content); assert.ok( !rendered.container.querySelector("strong"), "After remove bold: no expected", ); assert.ok( (rendered.baseElement.textContent ?? "").includes(joinedEmoji), "After remove bold: emoji should still be preserved", ); }); it("applies size to joined emoji and removes it preserving text", () => { const { tree: text } = createFormattedTreeView(`Test ${joinedEmoji} Text`); const content = ; const rendered = render(content, { reactStrictMode }); const emojiStart = 5; const emojiLength = [...joinedEmoji].length; text.formatRange(emojiStart, emojiStart + emojiLength, { size: 24 }); rendered.rerender(content); assert.ok( rendered.container.querySelector(".ql-size-huge"), "After size: expected .ql-size-huge", ); assert.ok( (rendered.baseElement.textContent ?? "").includes(joinedEmoji), "Emoji preserved", ); text.formatRange(emojiStart, emojiStart + emojiLength, { size: 12 }); rendered.rerender(content); assert.ok( !rendered.container.querySelector(".ql-size-huge"), "After remove: no .ql-size-huge", ); assert.ok( (rendered.baseElement.textContent ?? "").includes(joinedEmoji), "Emoji still preserved", ); }); }); } }); describe("parseLineTag", () => { it("return lineTag for valid header", () => { const result = parseLineTag({ header: 1 }); assert.ok(result, "Expected a line tag for header 1"); assert.equal(result.value, "h1", "Expected tag to be h1"); }); it("returns lineTag for valid bullet list", () => { const result = parseLineTag({ list: "bullet" }); assert.ok(result, "Expected a line tag for bullet list"); assert.equal(result.value, "li", "Expected tag to be li)"); }); // Tests for unsupported parameters - should return default header ("h5"), not throw an error. // Also used for when formatting is stripped from a newline and it becomes a default newline it("returns undefined for unsupported parameter", () => { const result = parseLineTag({ header: 7 }); assert.ok(result, "Expected a line tag for header 5"); assert.equal(result.value, "h5", "Expected tag to be h5 for unsupported header level"); }); it("parseLineTag handles null attribute alongside active tag", () => { // eslint-disable-next-line unicorn/no-null -- quill sends null for attributes that are being removed const result = parseLineTag({ list: null, blockquote: true }); assert(result !== undefined); assert.equal(result.value, "blockquote"); }); }); // tests quillFormattedview conversion that feeds into quill delta generation, // specifically for line atoms which have special handling for headers and lists. // Quill always has a trailing newline, so these tests set up the string with a newline, // then replace it with a line atom with the appropriate tag. describe("buildDeltaFromTree with line Atoms", () => { it("emits header attribute for h1 line atom", () => { const { tree } = createFormattedTreeView("Hello\n"); tree.removeRange(5, 6); tree.insertWithFormattingAt(5, [ { content: new FormattedTextDefault.StringLineAtom({ tag: FormattedTextDefault.LineTag("h1"), indent: 0, }), format: createPlainFormat(), }, ]); const ops = buildDeltaFromTree(tree); const lineOp = ops.find((op) => op.insert === "\n" && op.attributes?.header === 1); assert.ok(lineOp, "Expected { insert : `\\n`, attributes: { header: 1 } } in delta"); }); it("emits header attribute for li line atom", () => { const { tree } = createFormattedTreeView("item\n"); tree.removeRange(4, 5); tree.insertWithFormattingAt(4, [ { content: new FormattedTextDefault.StringLineAtom({ tag: FormattedTextDefault.LineTag("li"), indent: 0, }), format: createPlainFormat(), }, ]); const ops = buildDeltaFromTree(tree); const lineOp = ops.find( (op) => op.insert === "\n" && op.attributes?.list === "bullet", ); assert.ok( lineOp, "Expected { insert : `\\n`, attributes: { list: 'bullet' } } in delta", ); }); it("includes indent when present in line atom", () => { const { tree } = createFormattedTreeView("abc"); tree.insertWithFormattingAt(3, [ { content: new FormattedTextDefault.StringLineAtom({ tag: FormattedTextDefault.LineTag("ol"), indent: 2, }), format: createPlainFormat(), }, ]); const ops = buildDeltaFromTree(tree); const lineOp = ops.find( (op) => op.insert === "\n" && op.attributes?.list === "ordered", ); assert(lineOp !== undefined); assert.equal(lineOp.attributes?.indent, 2); }); it("indent is omitted when 0 in line atom", () => { const { tree } = createFormattedTreeView("abc"); tree.insertWithFormattingAt(3, [ { content: new FormattedTextDefault.StringLineAtom({ tag: FormattedTextDefault.LineTag("ol"), indent: 0, }), format: createPlainFormat(), }, ]); const ops = buildDeltaFromTree(tree); const lineOp = ops.find( (op) => op.insert === "\n" && op.attributes?.list === "ordered", ); assert(lineOp !== undefined); assert.equal("indent" in (lineOp.attributes ?? {}), false); }); }); describe("toolbar", () => { const mockLabel = Symbol("test"); for (const reactStrictMode of [false, true]) { describe(`StrictMode: ${reactStrictMode}`, () => { it("undo and redo buttons are disabled when undoRedo is not provided", () => { const { tree } = createFormattedTreeView(); const rendered = render(, { reactStrictMode, }); const undoButton = rendered.container.querySelector(".ql-undo"); const redoButton = rendered.container.querySelector(".ql-redo"); assert.ok(undoButton?.disabled === true, "Undo button should be disabled"); assert.ok(redoButton?.disabled === true, "Redo button should be disabled"); }); it("undo and redo buttons are enabled when undoRedo is provided", () => { const mockUndoRedo: UndoRedo = { undo: () => {}, redo: () => {}, canUndo: () => true, canRedo: () => true, dispose: () => {}, }; const { tree } = createFormattedTreeView(); const rendered = render( , { reactStrictMode }, ); const undoButton = rendered.container.querySelector(".ql-undo"); const redoButton = rendered.container.querySelector(".ql-redo"); assert.equal(undoButton?.disabled, false, "Undo button should be enabled"); assert.equal(redoButton?.disabled, false, "Redo button should be enabled"); }); }); } }); }); });