@parhelia/core 0.3.12832 → 0.3.12833

package/dist/editor/sidebar/liveComponentThumbnails.js

@@ -1,12 +1,13 @@
 import { useEffect, useRef, useState } from "react";
 import { normalizeBridgeKey } from "../bridge/bridgeKeys";
-import { BRIDGE_DOM_UPDATED_EVENT } from "../page-viewer/MiniMap";
+import { usePageViewState, } from "../page-viewer/pageViewContext";
 /** Quiet time after the last host DOM mutation before the page is recaptured. */
 export const LIVE_THUMBNAIL_DEBOUNCE_MS = 1200;
 /** Delay for the first capture after thumbnails are switched on. */
 export const LIVE_THUMBNAIL_INITIAL_DELAY_MS = 300;
-/** Longest canvas side the host renders; thumbnails never need more. */
-export const LIVE_THUMBNAIL_MAX_DIMENSION = 3000;
+export const LIVE_THUMBNAIL_BOX = { width: 56, height: 36 };
+/** Allow long pages while the host limits total pixels and sizes for each crop. */
+export const LIVE_THUMBNAIL_MAX_DIMENSION = 16_384;
 export function buildThumbnailSheet(payload, imageUrl) {
     const rects = new Map();
     for (const component of payload.components ?? []) {
@@ -100,22 +101,20 @@ function revokeThumbnailImageUrl(url) {
  * Keeps a fresh page sheet while `enabled`: captures shortly after switching
  * on, then again a little after every burst of host DOM mutations (typing,
  * inserts, reorders, refreshes). Only one capture runs at a time; changes that
- * arrive mid-capture queue exactly one follow-up. Returns null until the first
- * capture lands, or when the bridge is unavailable.
+ * arrive mid-capture queue exactly one follow-up.
  */
 export function useLiveComponentThumbnails(pageViewContext, enabled) {
     const [sheet, setSheet] = useState(null);
+    const [initialCaptureFailed, setInitialCaptureFailed] = useState(false);
     const sheetRef = useRef(null);
     const timerRef = useRef(null);
     const inFlightRef = useRef(false);
     const dirtyRef = useRef(false);
     const disposedRef = useRef(false);
-    const contextRef = useRef(pageViewContext);
-    contextRef.current = pageViewContext;
-    const bridgeReady = !!pageViewContext?.bridgeReady;
-    const requestPageSnapshot = pageViewContext?.requestBridgePageSnapshot;
-    const bridgeStructure = pageViewContext?.bridgeStructure;
-    const active = enabled && bridgeReady && !!requestPageSnapshot;
+    const bridgeReady = !!usePageViewState(pageViewContext, (state) => state.bridgeReady);
+    const canvasAttached = !!usePageViewState(pageViewContext, (state) => state.canvasAttached);
+    const bridgeStructure = usePageViewState(pageViewContext, (state) => state.bridgeStructure);
+    const active = enabled && bridgeReady && canvasAttached;
     useEffect(() => {
         disposedRef.current = false;
         return () => {
@@ -130,6 +129,7 @@ export function useLiveComponentThumbnails(pageViewContext, enabled) {
     }, []);
     useEffect(() => {
         if (!active) {
+            setInitialCaptureFailed(false);
             if (timerRef.current !== null) {
                 window.clearTimeout(timerRef.current);
                 timerRef.current = null;
@@ -144,8 +144,8 @@ export function useLiveComponentThumbnails(pageViewContext, enabled) {
         }
         const capture = async () => {
             timerRef.current = null;
-            const request = contextRef.current?.requestBridgePageSnapshot;
-            if (!request || !contextRef.current?.bridgeReady)
+            const request = pageViewContext?.requestBridgePageSnapshot;
+            if (!request || !pageViewContext?.getState().bridgeReady)
                 return;
             if (inFlightRef.current) {
                 dirtyRef.current = true;
@@ -156,6 +156,10 @@ export function useLiveComponentThumbnails(pageViewContext, enabled) {
             try {
                 const payload = await request({
                     maxDimension: LIVE_THUMBNAIL_MAX_DIMENSION,
+                    thumbnailSize: {
+                        width: LIVE_THUMBNAIL_BOX.width * 2,
+                        height: LIVE_THUMBNAIL_BOX.height * 2,
+                    },
                 });
                 if (disposedRef.current)
                     return;
@@ -164,10 +168,17 @@ export function useLiveComponentThumbnails(pageViewContext, enabled) {
                     revokeThumbnailImageUrl(sheetRef.current?.imageUrl);
                     sheetRef.current = next;
                     setSheet(next);
+                    setInitialCaptureFailed(false);
+                }
+                else if (!sheetRef.current) {
+                    setInitialCaptureFailed(true);
                 }
             }
             catch {
                 // Keep the previous sheet; the next DOM change retries.
+                if (!disposedRef.current && !sheetRef.current) {
+                    setInitialCaptureFailed(true);
+                }
             }
             finally {
                 inFlightRef.current = false;
@@ -184,13 +195,20 @@ export function useLiveComponentThumbnails(pageViewContext, enabled) {
                 void capture();
             }, delay);
         };
-        const onDomUpdated = () => schedule(LIVE_THUMBNAIL_DEBOUNCE_MS);
-        window.addEventListener(BRIDGE_DOM_UPDATED_EVENT, onDomUpdated);
+        // Every new DOM snapshot of the host is a mutation burst to settle.
+        let lastDom = pageViewContext?.getState().bridgeDom;
+        const unsubscribe = pageViewContext?.subscribe(() => {
+            const dom = pageViewContext.getState().bridgeDom;
+            if (dom === lastDom)
+                return;
+            lastDom = dom;
+            schedule(LIVE_THUMBNAIL_DEBOUNCE_MS);
+        });
         schedule(sheetRef.current
             ? LIVE_THUMBNAIL_DEBOUNCE_MS
             : LIVE_THUMBNAIL_INITIAL_DELAY_MS);
         return () => {
-            window.removeEventListener(BRIDGE_DOM_UPDATED_EVENT, onDomUpdated);
+            unsubscribe?.();
             if (timerRef.current !== null) {
                 window.clearTimeout(timerRef.current);
                 timerRef.current = null;
@@ -198,7 +216,10 @@ export function useLiveComponentThumbnails(pageViewContext, enabled) {
         };
         // A new structure means components were added, removed or reordered; the
         // effect re-runs and schedules a debounced recapture.
-    }, [active, requestPageSnapshot, bridgeStructure]);
-    return sheet;
+    }, [active, pageViewContext, bridgeStructure]);
+    // A not-yet-ready bridge still counts as loading: the page is warming up and
+    // the capture follows. A context that cannot capture at all never loads.
+    const loading = enabled && canvasAttached && !sheet && !initialCaptureFailed;
+    return { sheet, loading };
 }
 //# sourceMappingURL=liveComponentThumbnails.js.map

package/dist/editor/sidebar/liveComponentThumbnails.js.map

@@ -1 +1 @@
-{"version":3,"file":"liveComponentThumbnails.js","sourceRoot":"","sources":["../../../src/editor/sidebar/liveComponentThumbnails.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"liveComponentThumbnails.js","sourceRoot":"","sources":["../../../src/editor/sidebar/liveComponentThumbnails.ts"],"names":[],"mappings":"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"}

package/dist/editor/spellcheck/canvasSpellCheckContextMenu.d.ts

@@ -0,0 +1,30 @@
+import type { MenuItem } from "../../config/types";
+import type { BridgeGeometrySnapshot } from "../bridge/protocol";
+import type { FieldDescriptor } from "../pageModel";
+import { type SpellCheckClient } from "./spellCheckClient";
+export declare const SPANS_FORMATTING_MESSAGE = "This word spans formatting; edit it in the side panel.";
+/** The slice of the edit context the canvas menu needs. */
+export type CanvasSpellCheckEditor = {
+    operations: {
+        editField(args: {
+            field: FieldDescriptor;
+            value: string;
+            refresh: "none" | "immediate";
+            saveMode: "immediate";
+        }): Promise<unknown>;
+    };
+};
+/**
+ * The spell-check section of the canvas context menu: suggestions for the
+ * misspelling under the right-clicked point, or nothing when the point is not
+ * over one. Replacement goes through the same field write the find-and-replace
+ * dialog uses, after the guard proved the field value is still the checked one.
+ */
+export declare function buildCanvasSpellCheckMenuItems(args: {
+    editor: CanvasSpellCheckEditor;
+    geometry: BridgeGeometrySnapshot | undefined;
+    clientX: number | undefined;
+    clientY: number | undefined;
+    enabled?: boolean;
+    client?: SpellCheckClient;
+}): Promise<MenuItem[]>;

package/dist/editor/spellcheck/canvasSpellCheckContextMenu.js

@@ -0,0 +1,69 @@
+import { toast } from "sonner";
+import { captureReplacement, STALE_REPLACEMENT_MESSAGE, verifyReplacement, } from "./replacementGuard";
+import { spellCheckClient } from "./spellCheckClient";
+import { spellCheckCanvasStore } from "./spellCheckCanvasStore";
+import { findSpellCheckTargetAtPoint } from "./spellCheckCanvasTargets";
+import { addWordToDictionary, buildSpellCheckMenuItems, SPELLCHECK_MENU_ID_PREFIX, } from "./spellCheckContextMenu";
+import { replaceRenderedRange } from "./spellCheckReplace";
+export const SPANS_FORMATTING_MESSAGE = "This word spans formatting; edit it in the side panel.";
+/**
+ * The spell-check section of the canvas context menu: suggestions for the
+ * misspelling under the right-clicked point, or nothing when the point is not
+ * over one. Replacement goes through the same field write the find-and-replace
+ * dialog uses, after the guard proved the field value is still the checked one.
+ */
+export async function buildCanvasSpellCheckMenuItems(args) {
+    if (args.enabled === false)
+        return [];
+    const key = findSpellCheckTargetAtPoint(args.geometry, args.clientX, args.clientY);
+    if (!key)
+        return [];
+    const match = spellCheckCanvasStore.getMatch(key);
+    if (!match)
+        return [];
+    const client = args.client ?? spellCheckClient;
+    const capture = captureReplacement(match.checkedText, {
+        start: match.start,
+        end: match.end,
+        word: match.word,
+    });
+    const items = await buildSpellCheckMenuItems({
+        language: match.language,
+        word: match.word,
+        onReplace: async (replacement) => {
+            const latest = spellCheckCanvasStore.getTarget(match.targetKey);
+            const verdict = verifyReplacement(capture, latest?.text ?? "");
+            if (!latest || !verdict.ok || latest.value !== match.value) {
+                toast.info(STALE_REPLACEMENT_MESSAGE);
+                client.invalidateLanguage(match.language);
+                return;
+            }
+            const next = replaceRenderedRange(latest.value, match.fieldType, capture.start, capture.end, capture.word, replacement);
+            if (next === undefined) {
+                toast.error(SPANS_FORMATTING_MESSAGE);
+                return;
+            }
+            await args.editor.operations.editField({
+                field: match.field,
+                value: next,
+                refresh: "immediate",
+                saveMode: "immediate",
+            });
+        },
+        onIgnore: () => client.ignoreWord(match.language, match.word),
+        onAddToDictionary: async () => {
+            await addWordToDictionary(match.language, match.word, client);
+        },
+    });
+    if (items.length === 0)
+        return [];
+    return [
+        {
+            id: `${SPELLCHECK_MENU_ID_PREFIX}heading`,
+            label: `Spelling: ${match.word}`,
+            disabled: true,
+        },
+        ...items,
+    ];
+}
+//# sourceMappingURL=canvasSpellCheckContextMenu.js.map

package/dist/editor/spellcheck/canvasSpellCheckContextMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasSpellCheckContextMenu.js","sourceRoot":"","sources":["../../../src/editor/spellcheck/canvasSpellCheckContextMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAI/B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAyB,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,CAAC,MAAM,wBAAwB,GACnC,wDAAwD,CAAC;AAc3D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,IAOpD;IACC,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,2BAA2B,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACnF,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,KAAK,GAAG,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,gBAAgB,CAAC;IAC/C,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,WAAW,EAAE;QACpD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,wBAAwB,CAAC;QAC3C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE;YAC/B,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAC/D,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC3D,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;gBACtC,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC1C,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,oBAAoB,CAC/B,MAAM,CAAC,KAAK,EACZ,KAAK,CAAC,SAAS,EACf,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,IAAI,EACZ,WAAW,CACZ,CAAC;YACF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;gBACtC,OAAO;YACT,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;gBACrC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,WAAW;gBACpB,QAAQ,EAAE,WAAW;aACtB,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC;QAC7D,iBAAiB,EAAE,KAAK,IAAI,EAAE;YAC5B,MAAM,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC;KACF,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO;QACL;YACE,EAAE,EAAE,GAAG,yBAAyB,SAAS;YACzC,KAAK,EAAE,aAAa,KAAK,CAAC,IAAI,EAAE;YAChC,QAAQ,EAAE,IAAI;SACf;QACD,GAAG,KAAK;KACT,CAAC;AACJ,CAAC"}

package/dist/editor/spellcheck/htmlSpellDocument.d.ts

@@ -0,0 +1,60 @@
+import { type HtmlToken } from "./htmlSpellTokenizer";
+/**
+ * One parsed representation of a stored HTML value that serves both spell
+ * text extraction and replacement.
+ *
+ * - `text` is the spell-check text: every text token decoded with the full
+ *   HTML5 entity table and its line breaks normalized (`\r\n` and `\r` become
+ *   `\n`, as the browser's input preprocessing does), plus a `"\n"` separator
+ *   whenever a block-level element is entered or left and for `<br>` / `<hr>`.
+ *   Raw-text content (`script`, `style`, `textarea`, `title`) is part of the
+ *   browser's `textContent`, so it is kept at full length but masked with
+ *   spaces: nothing inside is ever checked and every later offset stays put.
+ * - Removing the separators yields exactly `element.textContent` of the
+ *   rendered value, which is the offset space the canvas bridge measures.
+ * - Every segment remembers its source range and a decoded→source mapping, so
+ *   a replacement rebuilds the value from untouched source slices and only
+ *   re-encodes the replaced word.
+ */
+export type HtmlSpellSegment = {
+    kind: "text" | "masked";
+    sourceStart: number;
+    sourceEnd: number;
+    /** Decoded, newline-normalized text (spaces for masked segments). */
+    decoded: string;
+    spellStart: number;
+    spellEnd: number;
+    /**
+     * Decoded runs with their source ranges, for mapping decoded offsets back
+     * to source offsets. Absent when the mapping could not be verified against
+     * the authoritative decode; such a segment is checked but never edited.
+     */
+    runs?: DecodedRun[];
+};
+export type DecodedRun = {
+    decStart: number;
+    decEnd: number;
+    srcStart: number;
+    srcEnd: number;
+};
+export type HtmlSpellDocument = {
+    source: string;
+    text: string;
+    separators: number[];
+    segments: HtmlSpellSegment[];
+    tokens: HtmlToken[];
+};
+export declare function parseHtmlSpellDocument(source: string): HtmlSpellDocument;
+/**
+ * Converts a spell-text offset to the matching `element.textContent` offset by
+ * discounting the separators inserted before it.
+ */
+export declare function toTextContentOffset(offset: number, separators: number[]): number;
+/**
+ * Replaces `[start, end)` of the spell text, which must lie inside one text
+ * segment and equal `word`, and returns the new source value. Everything
+ * outside the replaced word is copied from the source byte for byte; the
+ * replacement itself is entity-encoded. Returns undefined when the range spans
+ * a tag boundary, does not match `word`, or falls inside an entity.
+ */
+export declare function replaceInDocument(document: HtmlSpellDocument, start: number, end: number, word: string, replacement: string): string | undefined;

package/dist/editor/spellcheck/htmlSpellDocument.js

@@ -0,0 +1,181 @@
+import { decode, encode } from "html-entities";
+import { tokenizeHtml } from "./htmlSpellTokenizer";
+const ENTITY_PATTERN = /&(?:#[xX][0-9a-fA-F]+;?|#[0-9]+;?|[a-zA-Z][a-zA-Z0-9]*;?)/g;
+function decodeText(raw) {
+    return decode(raw, { level: "html5", scope: "body" });
+}
+/** `\r\n` and lone `\r` become `\n`, matching the HTML input stream preprocessing. */
+function normalizeNewlines(text) {
+    return text.replace(/\r\n?/g, "\n");
+}
+/**
+ * Decodes `raw` run by run (plain characters, entities, CRLF) and records the
+ * source range of every run. Returns undefined when the run-wise decode does
+ * not reproduce the authoritative decode, so callers never map offsets
+ * through an inconsistent table.
+ */
+function buildRuns(raw, decoded) {
+    const runs = [];
+    let out = "";
+    let src = 0;
+    let plainStart = -1;
+    const closePlain = (end) => {
+        if (plainStart < 0)
+            return;
+        runs.push({
+            decStart: out.length,
+            decEnd: out.length + (end - plainStart),
+            srcStart: plainStart,
+            srcEnd: end,
+        });
+        out += raw.slice(plainStart, end);
+        plainStart = -1;
+    };
+    while (src < raw.length) {
+        const code = raw.charCodeAt(src);
+        if (code === 13 /* \r */) {
+            closePlain(src);
+            const end = raw.charCodeAt(src + 1) === 10 ? src + 2 : src + 1;
+            runs.push({ decStart: out.length, decEnd: out.length + 1, srcStart: src, srcEnd: end });
+            out += "\n";
+            src = end;
+            continue;
+        }
+        if (code === 38 /* & */) {
+            ENTITY_PATTERN.lastIndex = src;
+            const match = ENTITY_PATTERN.exec(raw);
+            if (match && match.index === src) {
+                const entityText = decodeText(match[0]);
+                if (entityText !== match[0]) {
+                    closePlain(src);
+                    runs.push({
+                        decStart: out.length,
+                        decEnd: out.length + entityText.length,
+                        srcStart: src,
+                        srcEnd: src + match[0].length,
+                    });
+                    out += entityText;
+                    src += match[0].length;
+                    continue;
+                }
+            }
+        }
+        if (plainStart < 0)
+            plainStart = src;
+        src++;
+    }
+    closePlain(raw.length);
+    return out === decoded ? runs : undefined;
+}
+export function parseHtmlSpellDocument(source) {
+    const tokens = tokenizeHtml(source);
+    const segments = [];
+    const separators = [];
+    let text = "";
+    const separator = () => {
+        separators.push(text.length);
+        text += "\n";
+    };
+    for (const token of tokens) {
+        if (token.kind === "text") {
+            const raw = source.slice(token.start, token.end);
+            const decoded = normalizeNewlines(decodeText(raw));
+            const runs = buildRuns(raw, decoded);
+            segments.push({
+                kind: "text",
+                sourceStart: token.start,
+                sourceEnd: token.end,
+                decoded,
+                spellStart: text.length,
+                spellEnd: text.length + decoded.length,
+                runs,
+            });
+            text += decoded;
+            continue;
+        }
+        if (token.kind === "rawText") {
+            const raw = source.slice(token.start, token.end);
+            const content = normalizeNewlines(token.decodesEntities ? decodeText(raw) : raw);
+            const masked = " ".repeat(content.length);
+            segments.push({
+                kind: "masked",
+                sourceStart: token.start,
+                sourceEnd: token.end,
+                decoded: masked,
+                spellStart: text.length,
+                spellEnd: text.length + masked.length,
+            });
+            text += masked;
+            continue;
+        }
+        if (token.kind === "startTag") {
+            if (token.isBlock)
+                separator();
+            continue;
+        }
+        if (token.kind === "endTag") {
+            if (token.isBlock && !token.isVoid)
+                separator();
+        }
+    }
+    return { source, text, separators, segments, tokens };
+}
+/**
+ * Converts a spell-text offset to the matching `element.textContent` offset by
+ * discounting the separators inserted before it.
+ */
+export function toTextContentOffset(offset, separators) {
+    let count = 0;
+    for (const separator of separators) {
+        if (separator < offset)
+            count++;
+        else
+            break;
+    }
+    return offset - count;
+}
+/** Source offset of a decoded offset inside a segment, or undefined inside a multi-character decode. */
+function toSourceOffset(segment, decodedOffset) {
+    const runs = segment.runs;
+    if (!runs)
+        return undefined;
+    if (decodedOffset === segment.decoded.length)
+        return segment.sourceEnd;
+    // Run offsets are relative to the segment's raw text.
+    const base = segment.sourceStart;
+    for (const run of runs) {
+        if (decodedOffset < run.decStart || decodedOffset >= run.decEnd)
+            continue;
+        if (decodedOffset === run.decStart)
+            return base + run.srcStart;
+        const oneToOne = run.decEnd - run.decStart === run.srcEnd - run.srcStart;
+        return oneToOne ? base + run.srcStart + (decodedOffset - run.decStart) : undefined;
+    }
+    return decodedOffset === 0 ? segment.sourceStart : undefined;
+}
+/**
+ * Replaces `[start, end)` of the spell text, which must lie inside one text
+ * segment and equal `word`, and returns the new source value. Everything
+ * outside the replaced word is copied from the source byte for byte; the
+ * replacement itself is entity-encoded. Returns undefined when the range spans
+ * a tag boundary, does not match `word`, or falls inside an entity.
+ */
+export function replaceInDocument(document, start, end, word, replacement) {
+    if (end <= start)
+        return undefined;
+    const segment = document.segments.find((candidate) => candidate.kind === "text" && candidate.spellStart <= start && end <= candidate.spellEnd);
+    if (!segment)
+        return undefined;
+    const localStart = start - segment.spellStart;
+    const localEnd = end - segment.spellStart;
+    if (segment.decoded.slice(localStart, localEnd) !== word)
+        return undefined;
+    const sourceStart = toSourceOffset(segment, localStart);
+    const sourceEnd = toSourceOffset(segment, localEnd);
+    if (sourceStart === undefined || sourceEnd === undefined)
+        return undefined;
+    return (document.source.slice(0, sourceStart) +
+        encode(replacement, { mode: "specialChars" }) +
+        document.source.slice(sourceEnd));
+}
+//# sourceMappingURL=htmlSpellDocument.js.map

package/dist/editor/spellcheck/htmlSpellDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlSpellDocument.js","sourceRoot":"","sources":["../../../src/editor/spellcheck/htmlSpellDocument.ts"],"names":[],"mappings":"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"}

package/dist/editor/spellcheck/htmlSpellTokenizer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * A small HTML tokenizer that preserves source locations. It follows the HTML
+ * tokenizer states for the subset spell checking needs: data, tags with
+ * double-quoted / single-quoted / unquoted attribute values, self-closing
+ * tags, comments, doctype / bogus comments and the raw-text (script, style)
+ * and RCDATA (textarea, title) elements. `>` inside a quoted attribute value
+ * never ends a tag, so attribute content can never leak into the text.
+ *
+ * Every token carries `[start, end)` into the original string, which lets
+ * callers rebuild the source byte-identically around a replaced text token.
+ */
+export type HtmlTagToken = {
+    kind: "startTag" | "endTag";
+    start: number;
+    end: number;
+    /** Lower-case element name. */
+    name: string;
+    selfClosing: boolean;
+    /** Block-level element: a text boundary when entered or left. */
+    isBlock: boolean;
+    /** Void element (`br`, `hr`, ...): no end tag follows. */
+    isVoid: boolean;
+};
+export type HtmlTextToken = {
+    kind: "text";
+    start: number;
+    end: number;
+};
+export type HtmlRawTextToken = {
+    kind: "rawText";
+    start: number;
+    end: number;
+    /** Element the raw text belongs to. */
+    name: string;
+    /** RCDATA elements (textarea, title) decode entities; raw text ones (script, style) do not. */
+    decodesEntities: boolean;
+};
+export type HtmlOtherToken = {
+    kind: "comment" | "doctype";
+    start: number;
+    end: number;
+};
+export type HtmlToken = HtmlTagToken | HtmlTextToken | HtmlRawTextToken | HtmlOtherToken;
+export declare function isBlockElementName(name: string): boolean;
+export declare function tokenizeHtml(html: string): HtmlToken[];