@bobfrankston/rmfmail 1.0.543 → 1.0.545

package/client/app.js

@@ -2769,6 +2769,44 @@ optSnippet?.addEventListener("change", () => {
     }
     localStorage.setItem("mailx-snippet", String(optSnippet.checked));
 });
+// ── Search help button (?) ──
+// Opens a small modal showing docs/search.md so the user can see the
+// query syntax for each mode (FTS5 vs IMAP SEARCH vs Gmail API). The
+// markdown is fetched from the service via readConfigHelp("search"),
+// rendered as plain text inside a <pre> — no full markdown engine, just
+// preserves headings + tables visually. The doc itself is the source of
+// truth (lives at app/docs/search.md, deployed to GDrive on every
+// release like the other config help files).
+document.getElementById("search-help")?.addEventListener("click", async () => {
+    const { readConfigHelp } = await import("./lib/api-client.js");
+    const r = await readConfigHelp("search").catch(() => ({ content: "" }));
+    const md = r?.content || "";
+    const backdrop = document.createElement("div");
+    backdrop.className = "mailx-modal-backdrop";
+    backdrop.style.cssText = "position:fixed;inset:0;z-index:2000;background:rgba(0,0,0,0.4);display:flex;align-items:center;justify-content:center;";
+    const panel = document.createElement("div");
+    panel.style.cssText = "background:var(--color-bg,#fff);color:var(--color-text,#000);border-radius:8px;box-shadow:0 8px 32px rgba(0,0,0,0.3);width:min(820px,92vw);max-height:85vh;display:flex;flex-direction:column;";
+    panel.innerHTML = `
+        <div style="padding:14px 18px;border-bottom:1px solid var(--color-border,#ddd);display:flex;justify-content:space-between;align-items:center">
+            <span style="font-weight:600">Search syntax</span>
+            <button type="button" id="search-help-close" style="background:none;border:0;font-size:18px;cursor:pointer">&times;</button>
+        </div>
+        <pre style="margin:0;padding:14px 18px;overflow:auto;font:13px/1.5 var(--font-ui);white-space:pre-wrap;word-wrap:break-word">${(md || "Help not available — check that docs/search.md is deployed.")
+        .replace(/[&<>]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;" }[c] || c))}</pre>
+    `;
+    backdrop.appendChild(panel);
+    document.body.appendChild(backdrop);
+    const close = () => backdrop.remove();
+    panel.querySelector("#search-help-close")?.addEventListener("click", close);
+    backdrop.addEventListener("click", e => { if (e.target === backdrop)
+        close(); });
+    document.addEventListener("keydown", function escClose(e) {
+        if (e.key === "Escape") {
+            close();
+            document.removeEventListener("keydown", escClose);
+        }
+    });
+});
 // ── JSONC config file editor ──
 document.getElementById("btn-edit-jsonc")?.addEventListener("click", async () => {
     const settingsDropdown = document.getElementById("settings-dropdown");