@inshapardaz/likhari-react 0.1.28 → 0.1.29-dev.265

package/dist/i18n/strings.js

@@ -46,13 +46,14 @@ const en = {
         autocorrect: 'Auto-correct',
         textCleanup: 'Text cleanup',
         spellChecker: 'Spell-checker',
+        joinLines: 'Join lines',
         moreFormatting: 'More formatting',
         strikethrough: 'Strikethrough',
         superscript: 'Superscript',
         subscript: 'Subscript',
         uppercase: 'UPPERCASE',
         lowercase: 'lowercase',
-        capitalize: 'Capitalize',
+        capitalize: 'InitCap',
         clearFormatting: 'Clear formatting',
         outdent: 'Outdent',
         indent: 'Indent',
@@ -178,6 +179,7 @@ const en = {
     },
     contextMenu: {
         cut: 'Cut',
+        joinLines: 'Join lines',
         copy: 'Copy',
         paste: 'Paste',
         selectAll: 'Select all',
@@ -322,6 +324,7 @@ const ur = {
         autocorrect: 'خودکار تصحیح',
         textCleanup: 'متن کی صفائی',
         spellChecker: 'ہجے چیک کرنے والا',
+        joinLines: 'سطریں ملائیں',
         moreFormatting: 'مزید فارمیٹنگ',
         strikethrough: 'خط زدہ',
         superscript: 'بالا نویس',
@@ -454,6 +457,7 @@ const ur = {
     },
     contextMenu: {
         cut: 'کاٹیں',
+        joinLines: 'سطریں ملائیں',
         copy: 'کاپی کریں',
         paste: 'چسپاں کریں',
         selectAll: 'سب منتخب کریں',
@@ -598,6 +602,7 @@ const paShahmukhi = {
         autocorrect: 'خودکار درستی',
         textCleanup: 'متن دی صفائی',
         spellChecker: 'ہجے چیکر',
+        joinLines: 'سطراں ملاؤ',
         moreFormatting: 'ہور فارمیٹنگ',
         strikethrough: 'کٹی لکیر',
         superscript: 'اُتلا لکھت',
@@ -730,6 +735,7 @@ const paShahmukhi = {
     },
     contextMenu: {
         cut: 'کٹو',
+        joinLines: 'سطراں ملاؤ',
         copy: 'کاپی کرو',
         paste: 'چسپاں کرو',
         selectAll: 'سارا چنو',

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { EditorRoot } from './EditorRoot.js';
 export type { EditorRootProps, EditorRef, EditorInitialContent, NavigationGuardMode } from './EditorRoot.js';
+export type { ToolbarStyle } from './components/Toolbar.js';
 export type { DraftRestoreMode } from './components/DraftRestore.js';
 export { defaultMantineTheme } from './theme/mantineTheme.js';
 export { ImageNode, $createImageNode, $isImageNode } from './image/ImageNode.js';
@@ -8,7 +9,7 @@ export { DEFAULT_FONT_OPTIONS, URDU_WEB_FONT_OPTIONS, FONT_SIZES_PX } from './fo
 export type { FontOption } from './fonts/index.js';
 export { STRINGS, getStrings, useStrings, useUiStrings, UiStringsContext } from './i18n/index.js';
 export type { Locale, Strings } from './i18n/index.js';
-export { registerSpellDictionary, hasSpellDictionary, type HunspellFiles, type SpellLanguage } from './spellcheck/spellDictionaries.js';
+export { registerSpellDictionary, hasSpellDictionary, setEnglishDictionaryBaseUrl, type HunspellFiles, type SpellLanguage } from './spellcheck/spellDictionaries.js';
 export { localStorageAutoCorrectStore, apiAutoCorrectStore, fileAutoCorrectStore } from './autocorrect/autoCorrectStores.js';
 export type { AutoCorrectStore, AutoCorrectEntry } from './autocorrect/autoCorrectStores.js';
 export { normalizeUrdu, normalizeUrduCharacters, removeUrduDiacritics, replaceUrduDigits } from './normalization/urduNormalize.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC1G,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrF,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AACzF,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACrI,OAAO,EAAE,4BAA4B,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC1H,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAChI,YAAY,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAClI,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAChG,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC1G,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrF,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AACzF,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAClK,OAAO,EAAE,4BAA4B,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC1H,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAChI,YAAY,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAClI,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAChG,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -3,7 +3,7 @@ export { defaultMantineTheme } from './theme/mantineTheme.js';
 export { ImageNode, $createImageNode, $isImageNode } from './image/ImageNode.js';
 export { DEFAULT_FONT_OPTIONS, URDU_WEB_FONT_OPTIONS, FONT_SIZES_PX } from './fonts/index.js';
 export { STRINGS, getStrings, useStrings, useUiStrings, UiStringsContext } from './i18n/index.js';
-export { registerSpellDictionary, hasSpellDictionary } from './spellcheck/spellDictionaries.js';
+export { registerSpellDictionary, hasSpellDictionary, setEnglishDictionaryBaseUrl } from './spellcheck/spellDictionaries.js';
 export { localStorageAutoCorrectStore, apiAutoCorrectStore, fileAutoCorrectStore } from './autocorrect/autoCorrectStores.js';
 export { normalizeUrdu, normalizeUrduCharacters, removeUrduDiacritics, replaceUrduDigits } from './normalization/urduNormalize.js';
 export { localStorageUserWordStore, apiUserWordStore, ignoreWord, addUserWord, onSpellWordsChange } from './spellcheck/userWords.js';

package/dist/join/joinLinesActions.d.ts

@@ -0,0 +1,9 @@
+export declare function $canJoinLines(): boolean;
+/**
+ * Joins the lines in the selection into one paragraph. Soft breaks and the
+ * paragraph breaks between selected paragraphs become a single space each,
+ * unless there is already a space at that point. A soft break right after the
+ * selection becomes a paragraph break, so the joined text stands on its own.
+ */
+export declare function $joinSelectedLines(): boolean;
+//# sourceMappingURL=joinLinesActions.d.ts.map

package/dist/join/joinLinesActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"joinLinesActions.d.ts","sourceRoot":"","sources":["../../src/join/joinLinesActions.ts"],"names":[],"mappings":"AAyBA,wBAAgB,aAAa,IAAI,OAAO,CAKvC;AAuCD;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAyB5C"}

package/dist/join/joinLinesActions.js

@@ -0,0 +1,89 @@
+import { $createTextNode, $getSelection, $isLineBreakNode, $isParagraphNode, $isRangeSelection, $createParagraphNode, } from 'lexical';
+function $paragraphsInSelection(selection) {
+    const seen = new Set();
+    const paragraphs = [];
+    for (const node of selection.getNodes()) {
+        const block = node.getTopLevelElement();
+        if (!block || !$isParagraphNode(block) || seen.has(block.getKey()))
+            continue;
+        seen.add(block.getKey());
+        paragraphs.push(block);
+    }
+    return paragraphs;
+}
+export function $canJoinLines() {
+    const selection = $getSelection();
+    if (!$isRangeSelection(selection) || selection.isCollapsed())
+        return false;
+    if ($paragraphsInSelection(selection).length > 1)
+        return true;
+    return selection.getNodes().some($isLineBreakNode);
+}
+/** A soft break becomes one space, unless the text either side already has a space there. */
+function $replaceBreakWithSpace(lineBreak) {
+    const before = lineBreak.getPreviousSibling()?.getTextContent() ?? '';
+    const after = lineBreak.getNextSibling()?.getTextContent() ?? '';
+    if (before === '' || after === '' || /\s$/.test(before) || /^\s/.test(after)) {
+        lineBreak.remove();
+        return;
+    }
+    lineBreak.replace($createTextNode(' '));
+}
+/** Moves a paragraph's content onto the end of the target, with a space between when needed. */
+function $appendParagraph(target, paragraph) {
+    const content = paragraph.getTextContent();
+    if (content !== '') {
+        const targetText = target.getTextContent();
+        if (targetText !== '' && !/\s$/.test(targetText) && !/^\s/.test(content)) {
+            target.append($createTextNode(' '));
+        }
+        for (const child of paragraph.getChildren())
+            target.append(child);
+    }
+    paragraph.remove();
+}
+/** Turns a soft break into a paragraph break: the content after it moves to a new paragraph. */
+function $splitParagraphAt(lineBreak, paragraph) {
+    const rest = $createParagraphNode();
+    let sibling = lineBreak.getNextSibling();
+    while (sibling) {
+        const next = sibling.getNextSibling();
+        rest.append(sibling);
+        sibling = next;
+    }
+    lineBreak.remove();
+    paragraph.insertAfter(rest);
+}
+/**
+ * Joins the lines in the selection into one paragraph. Soft breaks and the
+ * paragraph breaks between selected paragraphs become a single space each,
+ * unless there is already a space at that point. A soft break right after the
+ * selection becomes a paragraph break, so the joined text stands on its own.
+ */
+export function $joinSelectedLines() {
+    const selection = $getSelection();
+    if (!$isRangeSelection(selection) || selection.isCollapsed())
+        return false;
+    const paragraphs = $paragraphsInSelection(selection);
+    const nodes = selection.getNodes();
+    const lineBreaks = nodes.filter($isLineBreakNode);
+    if (paragraphs.length < 2 && lineBreaks.length === 0)
+        return false;
+    const last = nodes[nodes.length - 1];
+    const breakAfter = last?.getNextSibling();
+    const trailingBreak = $isLineBreakNode(breakAfter) ? breakAfter : null;
+    for (const lineBreak of lineBreaks)
+        $replaceBreakWithSpace(lineBreak);
+    const [target, ...rest] = paragraphs;
+    if (!target)
+        return false;
+    for (const paragraph of rest)
+        $appendParagraph(target, paragraph);
+    if (trailingBreak?.isAttached()) {
+        const paragraph = trailingBreak.getParent();
+        if ($isParagraphNode(paragraph))
+            $splitParagraphAt(trailingBreak, paragraph);
+    }
+    target.selectEnd();
+    return true;
+}

package/dist/spellcheck/SpellHighlightPlugin.d.ts

@@ -1,8 +1,10 @@
 /**
  * Underlines misspelled words the way the browser does, without changing the
- * document: ranges are set on the rendered text through the CSS Custom
- * Highlight API. Checking is debounced so typing stays smooth. In browsers
- * without the API, nothing is underlined.
+ * document. Only blocks that are in view are checked, a block a few seconds after
+ * it scrolls into view, and an edit is rechecked after typing pauses. Results are
+ * kept per block, so a change re-checks only the block it is in. Underlines are
+ * ranges set through the CSS Custom Highlight API. In browsers without it, nothing
+ * is underlined.
  */
 export declare function SpellHighlightPlugin(): null;
 //# sourceMappingURL=SpellHighlightPlugin.d.ts.map

package/dist/spellcheck/SpellHighlightPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpellHighlightPlugin.d.ts","sourceRoot":"","sources":["../../src/spellcheck/SpellHighlightPlugin.tsx"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAgB,oBAAoB,SAkDnC"}
+{"version":3,"file":"SpellHighlightPlugin.d.ts","sourceRoot":"","sources":["../../src/spellcheck/SpellHighlightPlugin.tsx"],"names":[],"mappings":"AAsBA;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,SAoJnC"}

package/dist/spellcheck/SpellHighlightPlugin.js

@@ -1,60 +1,196 @@
 import { useEffect } from 'react';
 import { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext';
-import { $collectMisspellings } from './spellcheckActions.js';
+import { $getNodeByKey, $getRoot, $isElementNode } from 'lexical';
+import { $misspellingsInBlock } from './spellcheckActions.js';
 import { getSpeller } from './spellDictionaries.js';
 import { onSpellWordsChange } from './userWords.js';
 /** The CSS Custom Highlight name; editor.css styles it as a red wavy underline. */
 const HIGHLIGHT = 'likhari-spelling';
-const DEBOUNCE_MS = 300;
+/** A block that has just come into view is checked after this long, so scrolling past it costs nothing. */
+const VIEW_DELAY_MS = 2000;
+/** An edit inside a visible block is checked after the typing pauses for this long. */
+const TYPING_DELAY_MS = 300;
+/** The top-level block (paragraph, table, list...) that holds a node, or null. */
+function $topLevelKey(node) {
+    const root = $getRoot();
+    let current = node;
+    while (current.getParent() && !current.getParent().is(root))
+        current = current.getParent();
+    return current.getParent() ? current.getKey() : null;
+}
 /**
  * Underlines misspelled words the way the browser does, without changing the
- * document: ranges are set on the rendered text through the CSS Custom
- * Highlight API. Checking is debounced so typing stays smooth. In browsers
- * without the API, nothing is underlined.
+ * document. Only blocks that are in view are checked, a block a few seconds after
+ * it scrolls into view, and an edit is rechecked after typing pauses. Results are
+ * kept per block, so a change re-checks only the block it is in. Underlines are
+ * ranges set through the CSS Custom Highlight API. In browsers without it, nothing
+ * is underlined.
  */
 export function SpellHighlightPlugin() {
     const [editor] = useLexicalComposerContext();
     useEffect(() => {
-        if (typeof CSS === 'undefined' || !('highlights' in CSS))
+        if (typeof CSS === 'undefined' || !('highlights' in CSS) || typeof IntersectionObserver === 'undefined')
             return;
         let checkers = null;
-        let timer;
         let active = true;
+        const cache = new Map();
+        const visible = new Set();
+        const elements = new Map();
+        const keyOf = new Map();
+        const timers = new Map();
         const paint = () => {
-            if (!active || !checkers)
-                return;
-            const found = editor.getEditorState().read(() => $collectMisspellings(checkers));
             const ranges = [];
-            for (const misspelling of found) {
-                for (const segment of misspelling.segments) {
-                    const text = editor.getElementByKey(segment.key)?.firstChild;
-                    if (!text || text.nodeType !== Node.TEXT_NODE)
-                        continue;
-                    const range = document.createRange();
-                    range.setStart(text, segment.start);
-                    range.setEnd(text, segment.end);
-                    ranges.push(range);
+            for (const [key, words] of cache) {
+                const block = editor.getElementByKey(key);
+                if (!block || words.length === 0)
+                    continue;
+                const pieces = textPieces(block);
+                for (const word of words) {
+                    for (const piece of pieces) {
+                        const start = Math.max(word.start, piece.start);
+                        const end = Math.min(word.end, piece.end);
+                        if (end <= start)
+                            continue;
+                        const range = document.createRange();
+                        range.setStart(piece.node, start - piece.start);
+                        range.setEnd(piece.node, end - piece.start);
+                        ranges.push(range);
+                    }
                 }
             }
             CSS.highlights.set(HIGHLIGHT, new Highlight(...ranges));
         };
-        const schedule = () => {
-            clearTimeout(timer);
-            timer = setTimeout(paint, DEBOUNCE_MS);
+        const checkBlock = (key) => {
+            if (!active || !checkers)
+                return;
+            const words = editor.getEditorState().read(() => {
+                const node = $getNodeByKey(key);
+                return $isElementNode(node) ? $misspellingsInBlock(node, checkers) : null;
+            });
+            if (words === null)
+                cache.delete(key);
+            else
+                cache.set(key, words);
+            paint();
+        };
+        const schedule = (key, delay) => {
+            clearTimeout(timers.get(key));
+            timers.set(key, setTimeout(() => {
+                timers.delete(key);
+                if (visible.has(key))
+                    checkBlock(key);
+            }, delay));
+        };
+        const observer = new IntersectionObserver((entries) => {
+            for (const entry of entries) {
+                const key = keyOf.get(entry.target);
+                if (key === undefined)
+                    continue;
+                if (entry.isIntersecting) {
+                    visible.add(key);
+                    if (!cache.has(key))
+                        schedule(key, VIEW_DELAY_MS);
+                }
+                else {
+                    visible.delete(key);
+                    clearTimeout(timers.get(key));
+                    timers.delete(key);
+                }
+            }
+        });
+        // Keeps the observer on exactly the current top-level blocks.
+        const syncBlocks = (editorState = editor.getEditorState()) => {
+            const current = new Map();
+            editorState.read(() => {
+                for (const block of $getRoot().getChildren()) {
+                    const element = editor.getElementByKey(block.getKey());
+                    if (element)
+                        current.set(block.getKey(), element);
+                }
+            });
+            for (const [key, element] of elements) {
+                if (current.get(key) !== element) {
+                    observer.unobserve(element);
+                    keyOf.delete(element);
+                    elements.delete(key);
+                    visible.delete(key);
+                    cache.delete(key);
+                    clearTimeout(timers.get(key));
+                    timers.delete(key);
+                }
+            }
+            for (const [key, element] of current) {
+                if (!elements.has(key)) {
+                    elements.set(key, element);
+                    keyOf.set(element, key);
+                    observer.observe(element);
+                }
+            }
         };
-        const unregister = editor.registerUpdateListener(schedule);
-        const unsubscribe = onSpellWordsChange(schedule);
+        const unregisterUpdate = editor.registerUpdateListener(({ editorState, dirtyElements, dirtyLeaves }) => {
+            if (!checkers)
+                return;
+            const dirty = new Set();
+            editorState.read(() => {
+                for (const key of dirtyLeaves) {
+                    const node = $getNodeByKey(key);
+                    const top = node ? $topLevelKey(node) : null;
+                    if (top)
+                        dirty.add(top);
+                }
+                for (const key of dirtyElements.keys()) {
+                    const node = $getNodeByKey(key);
+                    const top = node ? $topLevelKey(node) : null;
+                    if (top)
+                        dirty.add(top);
+                }
+            });
+            syncBlocks(editorState);
+            for (const key of dirty) {
+                if (visible.has(key))
+                    schedule(key, TYPING_DELAY_MS);
+                else
+                    cache.delete(key);
+            }
+            if (dirty.size > 0)
+                paint();
+        });
+        const unsubscribeWords = onSpellWordsChange(() => {
+            cache.clear();
+            for (const key of visible)
+                schedule(key, 0);
+            paint();
+        });
         Promise.all([getSpeller('en'), getSpeller('ur')]).then(async ([en, ur]) => {
+            if (!active)
+                return;
             checkers = { ltr: en ? await en : undefined, rtl: ur ? await ur : undefined };
-            schedule();
+            syncBlocks();
+            for (const key of visible)
+                if (!cache.has(key))
+                    schedule(key, 0);
         });
         return () => {
             active = false;
-            clearTimeout(timer);
-            unregister();
-            unsubscribe();
+            observer.disconnect();
+            unregisterUpdate();
+            unsubscribeWords();
+            for (const timer of timers.values())
+                clearTimeout(timer);
             CSS.highlights.delete(HIGHLIGHT);
         };
     }, [editor]);
     return null;
 }
+/** The text nodes of a rendered block, with where each one starts in the block's text. */
+function textPieces(block) {
+    const pieces = [];
+    const walker = document.createTreeWalker(block, NodeFilter.SHOW_TEXT);
+    let offset = 0;
+    for (let node = walker.nextNode(); node; node = walker.nextNode()) {
+        const text = node;
+        pieces.push({ node: text, start: offset, end: offset + text.length });
+        offset += text.length;
+    }
+    return pieces;
+}

package/dist/spellcheck/spellDictionaries.d.ts

@@ -12,6 +12,8 @@ export interface Speller {
     suggest(word: string): string[];
 }
 type Loader = () => Promise<HunspellFiles>;
+/** Sets where the English dictionary files are served from. Takes effect on the next load. */
+export declare function setEnglishDictionaryBaseUrl(url: string): void;
 /**
  * Registers a dictionary for a language. Call once at startup with files you
  * have licence to ship — e.g. the Urdu `.aff`/`.dic` pair — either as strings

package/dist/spellcheck/spellDictionaries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spellDictionaries.d.ts","sourceRoot":"","sources":["../../src/spellcheck/spellDictionaries.ts"],"names":[],"mappings":"AAGA,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,cAAc,CAAC;AAEzD,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACjC;AAED,KAAK,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;AAoB3C;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAIpG;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAc3E;AAYD,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrD;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAGpF;AAED,gEAAgE;AAChE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AASD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAMhD;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,QAAQ,EAAE,CAEzE"}
+{"version":3,"file":"spellDictionaries.d.ts","sourceRoot":"","sources":["../../src/spellcheck/spellDictionaries.ts"],"names":[],"mappings":"AAGA,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,cAAc,CAAC;AAEzD,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACjC;AAED,KAAK,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;AAiB3C,8FAA8F;AAC9F,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI7D;AAUD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAIpG;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAc3E;AAYD,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrD;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAGpF;AAED,gEAAgE;AAChE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AASD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAMhD;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,QAAQ,EAAE,CAEzE"}

package/dist/spellcheck/spellDictionaries.js

@@ -9,10 +9,20 @@ async function fetchText(url) {
         throw new Error(`Spellcheck dictionary failed to load: ${url}`);
     return response.text();
 }
+// Where the English dictionary files are. Built from this module's own URL, so the
+// files shipped next to it are found; a host that bundles the editor can point this
+// elsewhere with setEnglishDictionaryBaseUrl.
+let englishBaseUrl = import.meta.url.replace(/[^/]*$/, 'dictionaries/en/');
+/** Sets where the English dictionary files are served from. Takes effect on the next load. */
+export function setEnglishDictionaryBaseUrl(url) {
+    englishBaseUrl = url.endsWith('/') ? url : `${url}/`;
+    loadedFiles.delete('en');
+    spellers.delete('en');
+}
 /** English ships with the editor: its files are fetched on first use. */
 const englishLoader = async () => ({
-    aff: await fetchText(new URL('./dictionaries/en/index.aff', import.meta.url).href),
-    dic: await fetchText(new URL('./dictionaries/en/index.dic', import.meta.url).href),
+    aff: await fetchText(`${englishBaseUrl}index.aff`),
+    dic: await fetchText(`${englishBaseUrl}index.dic`),
 });
 loaders.set('en', englishLoader);
 /**

package/dist/spellcheck/spellcheckActions.d.ts

@@ -1,3 +1,4 @@
+import type { ElementNode } from 'lexical';
 import { type FindMatch } from '../find/findReplaceActions.js';
 import { type Speller } from './spellDictionaries.js';
 /** The checker for each text direction: English for LTR blocks, Urdu for RTL. */
@@ -18,4 +19,16 @@ export interface Misspelling {
 }
 /** Every word in the document its block's checker does not recognise. */
 export declare function $collectMisspellings(checkers: Checkers): Misspelling[];
+/** A misspelled word inside a block, as offsets into the block's text. */
+export interface BlockMisspelling {
+    start: number;
+    end: number;
+    word: string;
+}
+/**
+ * The misspelled words inside one top-level block (a paragraph, a table, a list...),
+ * as offsets into the block's text. Words are found per parent (paragraph or cell),
+ * so text in different cells never forms one word. Must run inside an editor read.
+ */
+export declare function $misspellingsInBlock(block: ElementNode, checkers: Checkers): BlockMisspelling[];
 //# sourceMappingURL=spellcheckActions.d.ts.map

package/dist/spellcheck/spellcheckActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spellcheckActions.d.ts","sourceRoot":"","sources":["../../src/spellcheck/spellcheckActions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE5D,iFAAiF;AACjF,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,EAAE,CAmBtE"}
+{"version":3,"file":"spellcheckActions.d.ts","sourceRoot":"","sources":["../../src/spellcheck/spellcheckActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE5D,iFAAiF;AACjF,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,EAAE,CAmBtE;AAeD,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,EAAE,CA8B/F"}

package/dist/spellcheck/spellcheckActions.js

@@ -36,3 +36,38 @@ function segmentsOf(group, start, end) {
     }
     return segments;
 }
+/**
+ * The misspelled words inside one top-level block (a paragraph, a table, a list...),
+ * as offsets into the block's text. Words are found per parent (paragraph or cell),
+ * so text in different cells never forms one word. Must run inside an editor read.
+ */
+export function $misspellingsInBlock(block, checkers) {
+    const nodes = block.getAllTextNodes();
+    const starts = [];
+    let offset = 0;
+    for (const node of nodes) {
+        starts.push(offset);
+        offset += node.getTextContent().length;
+    }
+    const found = [];
+    let i = 0;
+    while (i < nodes.length) {
+        const parent = nodes[i].getParentOrThrow();
+        let j = i;
+        let text = '';
+        while (j < nodes.length && nodes[j].getParentOrThrow().getKey() === parent.getKey()) {
+            text += nodes[j].getTextContent();
+            j += 1;
+        }
+        const speller = parent.getDirection() === 'rtl' ? checkers.rtl : checkers.ltr;
+        if (speller) {
+            for (const span of wordsIn(text)) {
+                if (!speller.correct(span.word)) {
+                    found.push({ start: starts[i] + span.start, end: starts[i] + span.end, word: span.word });
+                }
+            }
+        }
+        i = j;
+    }
+    return found;
+}