@bobfrankston/rmfmail 1.2.166 → 1.2.168

package/client/compose/harper-lint.js

@@ -0,0 +1,269 @@
+import { grammarLint } from "../lib/api-client.js";
+const DEBOUNCE_MS = 700;
+const OVERLAY_ID = "harper-overlay";
+const POPUP_ID = "harper-popup";
+// Spelling squiggles stay with the native WebView2 spellchecker (red, with
+// its own suggestion menu) — double-underlining every typo helps no one.
+const SKIP_KINDS = new Set(["Spelling"]);
+export function initHarperLint(ed) {
+    let disposed = false;
+    let timer = null;
+    let placed = [];
+    let paintQueued = false;
+    let bridgeDead = false; // host has no grammarLint (Android today) — go silent
+    const target = () => {
+        try {
+            const nat = ed.nativeEditor;
+            if (nat?.getBody) { // TinyMCE: editable body inside its iframe
+                const b = nat.getBody();
+                return b ? { root: b, doc: b.ownerDocument } : null;
+            }
+            return ed.root ? { root: ed.root, doc: ed.root.ownerDocument } : null;
+        }
+        catch {
+            return null;
+        }
+    };
+    /** Overlay host — html element for TinyMCE (its body IS the editable;
+     *  divs appended there would serialize into the message), page body for
+     *  in-page editors. */
+    const overlayHost = (doc, root) => (root === doc.body ? doc.documentElement : doc.body);
+    const clearOverlay = (doc) => {
+        doc.getElementById(OVERLAY_ID)?.remove();
+        doc.getElementById(POPUP_ID)?.remove();
+    };
+    /** Blocks = top-level element children of the editable root (or the root
+     *  itself when it has none). Quoted reply chains are the author's
+     *  correspondent's text — skip them (also keeps lint cost proportional
+     *  to what's actually being written). */
+    const collectBlocks = (root) => {
+        const kids = Array.from(root.children).filter((c) => c instanceof HTMLElement);
+        const blocks = (kids.length ? kids : [root]).filter(b => b.tagName !== "BLOCKQUOTE" && !b.closest("blockquote") && !b.querySelector("blockquote"));
+        return blocks;
+    };
+    /** Flatten a block to plain text + a map back to its text nodes. */
+    const blockText = (block, doc) => {
+        const walker = doc.createTreeWalker(block, NodeFilter.SHOW_TEXT);
+        const nodes = [];
+        let text = "";
+        for (let n = walker.nextNode(); n; n = walker.nextNode()) {
+            nodes.push({ node: n, from: text.length });
+            text += n.data;
+        }
+        return { text, nodes };
+    };
+    const spanToRange = (doc, nodes, start, end) => {
+        let a = null;
+        let b = null;
+        for (const e of nodes) {
+            const len = e.node.data.length;
+            if (!a && start >= e.from && start <= e.from + len)
+                a = { node: e.node, off: start - e.from };
+            if (end >= e.from && end <= e.from + len)
+                b = { node: e.node, off: end - e.from };
+        }
+        if (!a || !b)
+            return null;
+        try {
+            const r = doc.createRange();
+            r.setStart(a.node, a.off);
+            r.setEnd(b.node, b.off);
+            return r;
+        }
+        catch {
+            return null;
+        }
+    };
+    const paint = () => {
+        if (disposed)
+            return;
+        const t = target();
+        if (!t)
+            return;
+        clearOverlay(t.doc);
+        if (placed.length === 0)
+            return;
+        const host = overlayHost(t.doc, t.root);
+        const ov = t.doc.createElement("div");
+        ov.id = OVERLAY_ID;
+        ov.style.cssText = "position:absolute;left:0;top:0;width:0;height:0;overflow:visible;pointer-events:none;z-index:5;";
+        const win = t.doc.defaultView || window;
+        for (const p of placed) {
+            let rects = [];
+            try {
+                rects = p.range.getClientRects();
+            }
+            catch {
+                continue;
+            }
+            for (const r of Array.from(rects)) {
+                if (r.width < 2)
+                    continue;
+                const u = t.doc.createElement("div");
+                // Dotted blue-ish underline — distinct from the native
+                // spellchecker's red squiggle. Hardcoded color: TinyMCE's
+                // iframe can't see the page's CSS variables.
+                u.style.cssText = `position:absolute;left:${r.left + win.scrollX}px;top:${r.bottom + win.scrollY - 2}px;width:${r.width}px;height:0;border-bottom:2px dotted rgba(66,133,244,0.9);pointer-events:none;`;
+                ov.appendChild(u);
+            }
+        }
+        host.appendChild(ov);
+    };
+    const queuePaint = () => {
+        if (paintQueued || disposed)
+            return;
+        paintQueued = true;
+        requestAnimationFrame(() => { paintQueued = false; paint(); });
+    };
+    const lint = async () => {
+        if (disposed || bridgeDead)
+            return;
+        const t = target();
+        if (!t)
+            return;
+        const blocks = collectBlocks(t.root);
+        const texts = blocks.map(b => blockText(b, t.doc));
+        let res;
+        try {
+            res = await grammarLint(texts.map(x => x.text));
+        }
+        catch {
+            // Host without grammarLint (Android bridge today) or IPC failure:
+            // feature goes quietly dark for this compose session.
+            bridgeDead = true;
+            clearOverlayAll();
+            return;
+        }
+        if (disposed)
+            return;
+        const next = [];
+        (res?.blocks || []).forEach((lints, i) => {
+            const tx = texts[i];
+            if (!tx)
+                return;
+            for (const l of lints || []) {
+                if (SKIP_KINDS.has(l.kind))
+                    continue;
+                const range = spanToRange(t.doc, tx.nodes, l.start, l.end);
+                if (range)
+                    next.push({ lint: l, range });
+            }
+        });
+        placed = next;
+        queuePaint();
+    };
+    const clearOverlayAll = () => {
+        const t = target();
+        if (t)
+            clearOverlay(t.doc);
+        placed = [];
+    };
+    const schedule = () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => { void lint(); }, DEBOUNCE_MS);
+    };
+    /** Apply a suggestion. Prefer the editor's own API (undo coherence);
+     *  fall back to execCommand insertText, which all three engines accept
+     *  as user input. */
+    const applyFix = (p, replacement, doc) => {
+        try {
+            const nat = ed.nativeEditor;
+            if (nat?.selection?.setRng && nat?.insertContent) { // TinyMCE
+                nat.selection.setRng(p.range);
+                const esc = replacement.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+                nat.insertContent(esc);
+            }
+            else {
+                const sel = (doc.defaultView || window).getSelection();
+                if (!sel)
+                    return;
+                sel.removeAllRanges();
+                sel.addRange(p.range);
+                doc.execCommand("insertText", false, replacement);
+            }
+        }
+        catch { /* squiggle stays; user can edit manually */ }
+        doc.getElementById(POPUP_ID)?.remove();
+        schedule();
+    };
+    const showPopup = (p, x, y, doc) => {
+        doc.getElementById(POPUP_ID)?.remove();
+        const pop = doc.createElement("div");
+        pop.id = POPUP_ID;
+        pop.style.cssText = `position:absolute;left:${x}px;top:${y + 6}px;z-index:2100;background:#fff;color:#1a1a1a;border:1px solid #bbb;border-radius:6px;box-shadow:0 4px 16px rgba(0,0,0,0.25);padding:6px 0;min-width:180px;max-width:340px;font:13px system-ui,sans-serif;`;
+        const msg = doc.createElement("div");
+        msg.style.cssText = "padding:4px 12px 6px;color:#555;border-bottom:1px solid #eee;";
+        msg.textContent = p.lint.message;
+        pop.appendChild(msg);
+        for (const s of p.lint.suggestions.slice(0, 5)) {
+            const item = doc.createElement("div");
+            item.style.cssText = "padding:6px 12px;cursor:pointer;font-weight:600;";
+            item.textContent = s;
+            item.addEventListener("mouseenter", () => { item.style.background = "#eef3ff"; });
+            item.addEventListener("mouseleave", () => { item.style.background = ""; });
+            item.addEventListener("mousedown", (e) => { e.preventDefault(); e.stopPropagation(); applyFix(p, s, doc); });
+            pop.appendChild(item);
+        }
+        if (p.lint.suggestions.length === 0) {
+            const none = doc.createElement("div");
+            none.style.cssText = "padding:6px 12px;color:#888;";
+            none.textContent = "(no suggestion — reword manually)";
+            pop.appendChild(none);
+        }
+        overlayHost(doc, target()?.root || doc.body).appendChild(pop);
+        const dismiss = () => { pop.remove(); doc.removeEventListener("mousedown", dismiss, true); };
+        setTimeout(() => doc.addEventListener("mousedown", dismiss, true), 0);
+    };
+    const onClick = (e) => {
+        if (disposed || placed.length === 0)
+            return;
+        const t = target();
+        if (!t)
+            return;
+        for (const p of placed) {
+            let rects = [];
+            try {
+                rects = Array.from(p.range.getClientRects());
+            }
+            catch {
+                continue;
+            }
+            for (const r of rects) {
+                // Small grace margin so the underline itself is clickable.
+                if (e.clientX >= r.left - 2 && e.clientX <= r.right + 2 && e.clientY >= r.top - 2 && e.clientY <= r.bottom + 4) {
+                    const win = t.doc.defaultView || window;
+                    showPopup(p, r.left + win.scrollX, r.bottom + win.scrollY, t.doc);
+                    return;
+                }
+            }
+        }
+    };
+    // ── Wiring ──
+    const t0 = target();
+    ed.onContentChange(schedule);
+    if (t0) {
+        t0.doc.addEventListener("click", onClick);
+        t0.doc.addEventListener("scroll", queuePaint, true);
+        (t0.doc.defaultView || window).addEventListener("resize", queuePaint);
+    }
+    try {
+        ed.getScrollContainer()?.addEventListener("scroll", queuePaint);
+    }
+    catch { /* */ }
+    // First pass once the editor has settled (reply bodies arrive async).
+    setTimeout(() => { void lint(); }, 1500);
+    return () => {
+        disposed = true;
+        if (timer)
+            clearTimeout(timer);
+        clearOverlayAll();
+        const t = target();
+        if (t) {
+            t.doc.removeEventListener("click", onClick);
+            t.doc.removeEventListener("scroll", queuePaint, true);
+            (t.doc.defaultView || window).removeEventListener("resize", queuePaint);
+        }
+    };
+}
+//# sourceMappingURL=harper-lint.js.map

package/client/compose/harper-lint.js.map

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

package/client/compose/harper-lint.ts

@@ -0,0 +1,265 @@
+/**
+ * Live grammar squiggles in compose via Harper (offline; the 18 MB WASM
+ * engine runs in the DAEMON — see mailx-service grammarLint — so this module
+ * costs the compose page nothing but IPC calls and a handful of divs).
+ *
+ * ONE implementation for all three editors (Quill / tiptap / TinyMCE): they
+ * are all contenteditable DOM. Per-editor knowledge is limited to finding
+ * the editable root (TinyMCE = iframe body via nativeEditor.getBody()).
+ * Squiggles are painted in an OVERLAY (never inside the editable subtree —
+ * that would leak markup into the outgoing message); positions come from
+ * Range.getClientRects(), so nothing mutates editor state and the failure
+ * mode of every path is "no squiggle", never a broken compose.
+ *
+ * Plan + phasing: docs/harper-integration.md (TODO C159).
+ */
+import type { MailxEditor } from "./editor.js";
+import { grammarLint } from "../lib/api-client.js";
+
+type WireLint = { start: number; end: number; kind: string; message: string; suggestions: string[] };
+type Placed = { lint: WireLint; range: Range };
+
+const DEBOUNCE_MS = 700;
+const OVERLAY_ID = "harper-overlay";
+const POPUP_ID = "harper-popup";
+// Spelling squiggles stay with the native WebView2 spellchecker (red, with
+// its own suggestion menu) — double-underlining every typo helps no one.
+const SKIP_KINDS = new Set(["Spelling"]);
+
+export function initHarperLint(ed: MailxEditor): () => void {
+    let disposed = false;
+    let timer: ReturnType<typeof setTimeout> | null = null;
+    let placed: Placed[] = [];
+    let paintQueued = false;
+    let bridgeDead = false;   // host has no grammarLint (Android today) — go silent
+
+    const target = (): { root: HTMLElement; doc: Document } | null => {
+        try {
+            const nat: any = ed.nativeEditor;
+            if (nat?.getBody) {   // TinyMCE: editable body inside its iframe
+                const b = nat.getBody();
+                return b ? { root: b, doc: b.ownerDocument } : null;
+            }
+            return ed.root ? { root: ed.root, doc: ed.root.ownerDocument } : null;
+        } catch { return null; }
+    };
+
+    /** Overlay host — html element for TinyMCE (its body IS the editable;
+     *  divs appended there would serialize into the message), page body for
+     *  in-page editors. */
+    const overlayHost = (doc: Document, root: HTMLElement): HTMLElement =>
+        (root === doc.body ? doc.documentElement : doc.body);
+
+    const clearOverlay = (doc: Document): void => {
+        doc.getElementById(OVERLAY_ID)?.remove();
+        doc.getElementById(POPUP_ID)?.remove();
+    };
+
+    /** Blocks = top-level element children of the editable root (or the root
+     *  itself when it has none). Quoted reply chains are the author's
+     *  correspondent's text — skip them (also keeps lint cost proportional
+     *  to what's actually being written). */
+    const collectBlocks = (root: HTMLElement): HTMLElement[] => {
+        const kids = Array.from(root.children).filter((c): c is HTMLElement => c instanceof HTMLElement);
+        const blocks = (kids.length ? kids : [root]).filter(b =>
+            b.tagName !== "BLOCKQUOTE" && !b.closest("blockquote") && !b.querySelector("blockquote"));
+        return blocks;
+    };
+
+    /** Flatten a block to plain text + a map back to its text nodes. */
+    const blockText = (block: HTMLElement, doc: Document): { text: string; nodes: { node: Text; from: number }[] } => {
+        const walker = doc.createTreeWalker(block, NodeFilter.SHOW_TEXT);
+        const nodes: { node: Text; from: number }[] = [];
+        let text = "";
+        for (let n = walker.nextNode(); n; n = walker.nextNode()) {
+            nodes.push({ node: n as Text, from: text.length });
+            text += (n as Text).data;
+        }
+        return { text, nodes };
+    };
+
+    const spanToRange = (doc: Document, nodes: { node: Text; from: number }[], start: number, end: number): Range | null => {
+        let a: { node: Text; off: number } | null = null;
+        let b: { node: Text; off: number } | null = null;
+        for (const e of nodes) {
+            const len = e.node.data.length;
+            if (!a && start >= e.from && start <= e.from + len) a = { node: e.node, off: start - e.from };
+            if (end >= e.from && end <= e.from + len) b = { node: e.node, off: end - e.from };
+        }
+        if (!a || !b) return null;
+        try {
+            const r = doc.createRange();
+            r.setStart(a.node, a.off);
+            r.setEnd(b.node, b.off);
+            return r;
+        } catch { return null; }
+    };
+
+    const paint = (): void => {
+        if (disposed) return;
+        const t = target();
+        if (!t) return;
+        clearOverlay(t.doc);
+        if (placed.length === 0) return;
+        const host = overlayHost(t.doc, t.root);
+        const ov = t.doc.createElement("div");
+        ov.id = OVERLAY_ID;
+        ov.style.cssText = "position:absolute;left:0;top:0;width:0;height:0;overflow:visible;pointer-events:none;z-index:5;";
+        const win = t.doc.defaultView || window;
+        for (const p of placed) {
+            let rects: DOMRectList | DOMRect[] = [];
+            try { rects = p.range.getClientRects(); } catch { continue; }
+            for (const r of Array.from(rects)) {
+                if (r.width < 2) continue;
+                const u = t.doc.createElement("div");
+                // Dotted blue-ish underline — distinct from the native
+                // spellchecker's red squiggle. Hardcoded color: TinyMCE's
+                // iframe can't see the page's CSS variables.
+                u.style.cssText = `position:absolute;left:${r.left + win.scrollX}px;top:${r.bottom + win.scrollY - 2}px;width:${r.width}px;height:0;border-bottom:2px dotted rgba(66,133,244,0.9);pointer-events:none;`;
+                ov.appendChild(u);
+            }
+        }
+        host.appendChild(ov);
+    };
+
+    const queuePaint = (): void => {
+        if (paintQueued || disposed) return;
+        paintQueued = true;
+        requestAnimationFrame(() => { paintQueued = false; paint(); });
+    };
+
+    const lint = async (): Promise<void> => {
+        if (disposed || bridgeDead) return;
+        const t = target();
+        if (!t) return;
+        const blocks = collectBlocks(t.root);
+        const texts = blocks.map(b => blockText(b, t.doc));
+        let res: Awaited<ReturnType<typeof grammarLint>>;
+        try {
+            res = await grammarLint(texts.map(x => x.text));
+        } catch {
+            // Host without grammarLint (Android bridge today) or IPC failure:
+            // feature goes quietly dark for this compose session.
+            bridgeDead = true;
+            clearOverlayAll();
+            return;
+        }
+        if (disposed) return;
+        const next: Placed[] = [];
+        (res?.blocks || []).forEach((lints, i) => {
+            const tx = texts[i];
+            if (!tx) return;
+            for (const l of lints || []) {
+                if (SKIP_KINDS.has(l.kind)) continue;
+                const range = spanToRange(t.doc, tx.nodes, l.start, l.end);
+                if (range) next.push({ lint: l, range });
+            }
+        });
+        placed = next;
+        queuePaint();
+    };
+
+    const clearOverlayAll = (): void => {
+        const t = target();
+        if (t) clearOverlay(t.doc);
+        placed = [];
+    };
+
+    const schedule = (): void => {
+        if (timer) clearTimeout(timer);
+        timer = setTimeout(() => { void lint(); }, DEBOUNCE_MS);
+    };
+
+    /** Apply a suggestion. Prefer the editor's own API (undo coherence);
+     *  fall back to execCommand insertText, which all three engines accept
+     *  as user input. */
+    const applyFix = (p: Placed, replacement: string, doc: Document): void => {
+        try {
+            const nat: any = ed.nativeEditor;
+            if (nat?.selection?.setRng && nat?.insertContent) {   // TinyMCE
+                nat.selection.setRng(p.range);
+                const esc = replacement.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+                nat.insertContent(esc);
+            } else {
+                const sel = (doc.defaultView || window).getSelection();
+                if (!sel) return;
+                sel.removeAllRanges();
+                sel.addRange(p.range);
+                doc.execCommand("insertText", false, replacement);
+            }
+        } catch { /* squiggle stays; user can edit manually */ }
+        doc.getElementById(POPUP_ID)?.remove();
+        schedule();
+    };
+
+    const showPopup = (p: Placed, x: number, y: number, doc: Document): void => {
+        doc.getElementById(POPUP_ID)?.remove();
+        const pop = doc.createElement("div");
+        pop.id = POPUP_ID;
+        pop.style.cssText = `position:absolute;left:${x}px;top:${y + 6}px;z-index:2100;background:#fff;color:#1a1a1a;border:1px solid #bbb;border-radius:6px;box-shadow:0 4px 16px rgba(0,0,0,0.25);padding:6px 0;min-width:180px;max-width:340px;font:13px system-ui,sans-serif;`;
+        const msg = doc.createElement("div");
+        msg.style.cssText = "padding:4px 12px 6px;color:#555;border-bottom:1px solid #eee;";
+        msg.textContent = p.lint.message;
+        pop.appendChild(msg);
+        for (const s of p.lint.suggestions.slice(0, 5)) {
+            const item = doc.createElement("div");
+            item.style.cssText = "padding:6px 12px;cursor:pointer;font-weight:600;";
+            item.textContent = s;
+            item.addEventListener("mouseenter", () => { item.style.background = "#eef3ff"; });
+            item.addEventListener("mouseleave", () => { item.style.background = ""; });
+            item.addEventListener("mousedown", (e) => { e.preventDefault(); e.stopPropagation(); applyFix(p, s, doc); });
+            pop.appendChild(item);
+        }
+        if (p.lint.suggestions.length === 0) {
+            const none = doc.createElement("div");
+            none.style.cssText = "padding:6px 12px;color:#888;";
+            none.textContent = "(no suggestion — reword manually)";
+            pop.appendChild(none);
+        }
+        overlayHost(doc, target()?.root || doc.body).appendChild(pop);
+        const dismiss = (): void => { pop.remove(); doc.removeEventListener("mousedown", dismiss, true); };
+        setTimeout(() => doc.addEventListener("mousedown", dismiss, true), 0);
+    };
+
+    const onClick = (e: MouseEvent): void => {
+        if (disposed || placed.length === 0) return;
+        const t = target();
+        if (!t) return;
+        for (const p of placed) {
+            let rects: DOMRect[] = [];
+            try { rects = Array.from(p.range.getClientRects()); } catch { continue; }
+            for (const r of rects) {
+                // Small grace margin so the underline itself is clickable.
+                if (e.clientX >= r.left - 2 && e.clientX <= r.right + 2 && e.clientY >= r.top - 2 && e.clientY <= r.bottom + 4) {
+                    const win = t.doc.defaultView || window;
+                    showPopup(p, r.left + win.scrollX, r.bottom + win.scrollY, t.doc);
+                    return;
+                }
+            }
+        }
+    };
+
+    // ── Wiring ──
+    const t0 = target();
+    ed.onContentChange(schedule);
+    if (t0) {
+        t0.doc.addEventListener("click", onClick);
+        t0.doc.addEventListener("scroll", queuePaint, true);
+        (t0.doc.defaultView || window).addEventListener("resize", queuePaint);
+    }
+    try { ed.getScrollContainer()?.addEventListener("scroll", queuePaint); } catch { /* */ }
+    // First pass once the editor has settled (reply bodies arrive async).
+    setTimeout(() => { void lint(); }, 1500);
+
+    return () => {
+        disposed = true;
+        if (timer) clearTimeout(timer);
+        clearOverlayAll();
+        const t = target();
+        if (t) {
+            t.doc.removeEventListener("click", onClick);
+            t.doc.removeEventListener("scroll", queuePaint, true);
+            (t.doc.defaultView || window).removeEventListener("resize", queuePaint);
+        }
+    };
+}

package/client/index.html

@@ -762,6 +762,7 @@
                     <label class="tb-menu-item"><input type="radio" name="opt-extedit" value="word" id="opt-extedit-word"> Microsoft Word</label>
                     <label class="tb-menu-item"><input type="radio" name="opt-extedit" value="libreoffice" id="opt-extedit-libre"> LibreOffice Writer</label>
                     <hr class="tb-menu-sep">
+                    <label class="tb-menu-item" title="Live grammar/phrasing squiggles while composing — Harper engine, runs entirely locally (nothing leaves this machine). Click a squiggle for suggestions. English only."><input type="checkbox" id="opt-grammar-check" checked> Grammar check (local)</label>
                     <label class="tb-menu-item" title="Ghost-text completions while composing — Ollama / Claude / OpenAI back-end, off by default"><input type="checkbox" id="opt-autocomplete"> AI autocomplete</label>
                     <label class="tb-menu-item" title="Right-click in message body → Translate"><input type="checkbox" id="opt-ai-translate"> AI translate (off by default)</label>
                     <label class="tb-menu-item" title="Right-click in compose editor → Proofread (when wired)"><input type="checkbox" id="opt-ai-proofread"> AI proofread (off by default)</label>

package/client/lib/api-client.js

@@ -618,6 +618,14 @@ export async function getMessageSource(accountId, uid, folderId) {
 /** Open a message in its own native OS window (msger WebView spawned by the
  *  daemon). Resolves { ok:false, reason } when no popout host is available —
  *  caller falls back to the in-window overlay. */
+/** Offline grammar lint via the daemon's Harper engine. Throws when the
+ *  host has no grammarLint (Android web-service today) — caller disables. */
+export async function grammarLint(blocks) {
+    const fn = ipc().grammarLint;
+    if (!fn)
+        throw new Error("no grammarLint bridge");
+    return fn(blocks);
+}
 /** Register rmfmail as the OS-level mailto: handler (Settings menu). */
 export async function registerMailto() {
     const fn = ipc().registerMailto;