@bobfrankston/mailx-settings 0.1.19 → 0.1.21

package/docs/contacts.md

@@ -4,7 +4,9 @@
 
 ## What this file documents
 
-`contacts.jsonc` is your address book. It's split into three tiers and lives in `My Drive/home/.rmfmail/`.
+`contacts.jsonc` is the **curated** part of your address book — the entries you (or the app on your behalf) explicitly keep. It lives in your shared `.rmfmail` folder on Google Drive and syncs across devices.
+
+Auto-collected addresses (the *discovered* set) are **not** stored in this file — they are a per-device local cache. See [Discovered addresses](#discovered-addresses) below.
 
 ## Shape
 
@@ -16,9 +18,6 @@
   "denylist": [
     "spammer@example.com"
   ],
-  "discovered": [
-    { "name": "Bob", "email": "bob@example.com", "useCount": 715, "lastUsed": 1777921829000 }
-  ],
   "groups": {
     "Joes": ["joe@example.com", "jo@example.com"],
     "Family": ["alice@example.com", "Joes"]
@@ -30,9 +29,20 @@
 
 - **preferred** — manually-curated, top-ranked in autocomplete. Add people you actually want to reach quickly.
 - **denylist** — addresses (lowercased) excluded from autocomplete entirely.
-- **discovered** — auto-collected from sent/received mail. `useCount` × recency drives autocomplete ranking. Junk patterns (see below) are dropped at insertion.
 - **groups** — mailing lists. Type the group name in To/Cc/Bcc and compose expands it into the member addresses on send. Each value is an array of either email addresses (`"a@b.com"` or `"Name <a@b.com>"`) or other group names (recursive aliasing — cycles are detected, depth capped at 10). Group lookup is case-insensitive on the key. The two `Joes` example above plus the `Family` example show flat membership and one group nested inside another.
 
+Other keys may also appear (e.g. `priorityDomains`) — rmfmail merges into the existing file rather than overwriting it, so hand-added keys survive a flush.
+
+## Discovered addresses
+
+Addresses seen in your sent/received mail are collected automatically into a **discovered** set. This set:
+
+- is a **local cache** held in each device's database — it is *not* written to `contacts.jsonc` and *not* synced to Google Drive;
+- drives autocomplete ranking via `useCount` × recency;
+- drops addresses matching the junk patterns below, both at insertion and on a startup sweep.
+
+Keeping it local keeps `contacts.jsonc` a few KB of curated data instead of a multi-megabyte blob, and avoids cross-device clobbering on every use-count tick. Each device builds its own discovered set from its own copy of your mail.
+
 ## Global junk filter
 
 Addresses matching any of these are dropped at insertion AND swept on startup:
@@ -48,6 +58,5 @@ The full pattern set lives in `contact-rules.jsonc` (shipped with the app). Bump
 ## Notes
 
 - JSONC: `// line comments` and trailing commas are allowed.
-- `useCount` and `lastUsed` are auto-managed; manually editing them only changes ranking briefly until the next sync.
-- Removing a `preferred` entry doesn't add it to `denylist` — it just demotes back to `discovered` (or drops if not seen in mail).
-- Each device contributes its observed addresses to `discovered`. The file accumulates the union across devices.
+- Removing a `preferred` entry doesn't add it to `denylist` — it just demotes back to the discovered set (or drops if not seen in mail).
+- `preferred` and `denylist` are the only tiers this file owns; `groups` and other keys are preserved on flush but otherwise hand-managed.

package/docs/rmf-tiny.md

@@ -1,6 +1,6 @@
-# `rmf-tiny` — optional TinyMCE editor adapter for rmfmail
+# `rmf-tiny` — TinyMCE editor adapter for rmfmail
 
-Status: design only. Not implemented.
+Status: **implemented and shipping.** Source: `y:/dev/utils/msgx/libs/rmf-tiny/src/adapter.ts`; built copy served as `client/lib/rmf-tiny.js` (via `bin/build-rmf-tiny.js`). Selectable in Settings → Compose → Editor. The design notes below are kept for history; see **Known TinyMCE quirks** at the bottom for the live gotcha list.
 
 ## Goal
 
@@ -154,3 +154,32 @@ Don't publish the adapter until the Word-paste case actually works end-to-end th
 - The adapter must not re-implement parts of TinyMCE — it's a thin wrapper. Re-implementing parts of GPL code in MIT is the legal trap; staying purely in adapter / interface territory is safe.
 - TinyMCE's bundle is large (~1MB minified). Users opting in pay that cost on the first compose-window load. Fine for opt-in; would be unacceptable as a default.
 - `rmf-tiny` major version should track TinyMCE's major version (rmf-tiny@7.x for tinymce@7.x) so peerDependency mismatches are obvious.
+
+## Known TinyMCE quirks
+
+TinyMCE frequently gets caret / scroll / block behaviour wrong. Each entry
+below is a quirk found in use and the workaround in `adapter.ts`. Add to
+this list whenever a new one turns up — it's the running gotcha log.
+
+- **Viewport doesn't follow `setCursor`.** After `setContent` of a long
+  reply, collapsing the selection to the start (caret at top, where the
+  user types above the quote) does NOT scroll the iframe — it can be left
+  scrolled down inside the quoted block. Fix: `setCursor(0)` explicitly
+  calls `editor.getWin().scrollTo(0, 0)`; non-zero positions call
+  `editor.selection.scrollIntoView()`. (Bob 2026-05-18.)
+
+- **Typing at a link's trailing edge extends the link.** With the caret
+  collapsed at the end of an `<a>`, contenteditable keeps appending typed
+  characters INTO the link — a whole sentence becomes link text. Fix: a
+  `keypress` handler hops the caret to just after the `<a>` first.
+
+- **Native spellcheck is force-enabled.** `adapter.ts`'s `init` handler
+  sets `spellcheck="true"` on the body. mailx runs its own nspell checker
+  and overrides this back to `"false"` in `wireSpellcheck` (with a
+  MutationObserver) so the two don't double-underline.
+
+- **`<p>` collapses to `<br>`.** Enter / paste sometimes produces a `<br>`
+  line break where a `<p>` paragraph was expected, so paragraph spacing is
+  lost until the lines are merged and Enter re-pressed. Not yet fixed —
+  candidate: `forced_root_block` / paste-normalization config. (Bob
+  2026-05-18, exact trigger still unclear.)

package/index.d.ts

@@ -154,10 +154,11 @@ export declare function loadAllowlist(): typeof DEFAULT_ALLOWLIST;
 /** Save allow-list — merges with existing cloud copy (multi-client safe) */
 export declare function saveAllowlist(list: typeof DEFAULT_ALLOWLIST): Promise<void>;
 /** Load user-added dictionary words. Mirrored to GDrive so "Add to dictionary"
- *  on one machine appears on every machine. Same multi-client merge pattern
- *  as allowlist. Returns a string array; duplicates removed by saveUserDict. */
-export declare function loadUserDict(): string[];
-/** Save user dictionary — merges with cloud copy so concurrent edits on
+ *  on one machine appears on every machine. Returns a deduped string array.
+ *  Tries the cloud copy first (so a fresh machine sees prior words), then
+ *  the local cache. Empty array when nothing has been saved yet. */
+export declare function loadUserDict(): Promise<string[]>;
+/** Save user dictionary — merges with the cloud copy so concurrent edits on
  *  different machines union rather than overwrite. */
 export declare function saveUserDict(words: string[]): Promise<void>;
 /** Load settings — unified view combining all files (backward compatible) */

package/index.d.ts.map

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

package/index.js

@@ -1047,29 +1047,79 @@ export async function saveAllowlist(list) {
     catch { /* cloud read failed — save local version */ }
     saveFile("allowlist.jsonc", merged);
 }
+// User dictionary lives in a plain CSV (single column, one word per line)
+// so it's trivially hand-editable on the server. `# ...` lines and blanks
+// are ignored.
+const USER_DICT_FILE = "userdict.csv";
+/** Parse the single-column user-dictionary CSV. Blank lines and `#` comment
+ *  lines are skipped; a quoted or multi-field row contributes its first
+ *  field — so a file exported from a spreadsheet still loads cleanly. */
+function parseDictCsv(text) {
+    return text.split(/\r?\n/)
+        .map(l => l.trim())
+        .filter(l => l && !l.startsWith("#"))
+        .map(l => l.split(",")[0].trim().replace(/^"(.*)"$/, "$1").trim())
+        .filter(Boolean);
+}
+/** Serialize words to CSV text — sorted, one per line, with a header note. */
+function buildDictCsv(words) {
+    const sorted = [...new Set(words)].filter(Boolean).sort((a, b) => a.localeCompare(b));
+    return "# rmfmail user dictionary — one word per line\n" + sorted.join("\n") + "\n";
+}
+function atomicWriteText(filePath, text) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    const tmp = filePath + ".tmp";
+    fs.writeFileSync(tmp, text);
+    fs.renameSync(tmp, filePath);
+}
 /** Load user-added dictionary words. Mirrored to GDrive so "Add to dictionary"
- *  on one machine appears on every machine. Same multi-client merge pattern
- *  as allowlist. Returns a string array; duplicates removed by saveUserDict. */
-export function loadUserDict() {
-    const raw = loadFile("userdict.jsonc", { words: [] });
-    return Array.isArray(raw?.words) ? raw.words : [];
+ *  on one machine appears on every machine. Returns a deduped string array.
+ *  Tries the cloud copy first (so a fresh machine sees prior words), then
+ *  the local cache. Empty array when nothing has been saved yet. */
+export async function loadUserDict() {
+    try {
+        const cloudCsv = await cloudRead(USER_DICT_FILE);
+        if (cloudCsv != null)
+            return [...new Set(parseDictCsv(cloudCsv))];
+    }
+    catch { /* cloud unreachable — fall back to local */ }
+    const sharedPath = path.join(getSharedDir(), USER_DICT_FILE);
+    const localPath = path.join(LOCAL_DIR, USER_DICT_FILE);
+    try {
+        if (fs.existsSync(sharedPath))
+            return [...new Set(parseDictCsv(fs.readFileSync(sharedPath, "utf-8")))];
+        if (fs.existsSync(localPath))
+            return [...new Set(parseDictCsv(fs.readFileSync(localPath, "utf-8")))];
+    }
+    catch { /* unreadable */ }
+    return [];
 }
-/** Save user dictionary — merges with cloud copy so concurrent edits on
+/** Save user dictionary — merges with the cloud copy so concurrent edits on
  *  different machines union rather than overwrite. */
 export async function saveUserDict(words) {
-    let merged = [...new Set(words)];
+    const merged = new Set(words);
     try {
-        const cloudContent = await cloudRead("userdict.jsonc");
-        if (cloudContent) {
-            const cloud = parseJsonc(cloudContent);
-            if (cloud && Array.isArray(cloud.words)) {
-                merged = [...new Set([...merged, ...cloud.words])];
-            }
-        }
+        const cloudCsv = await cloudRead(USER_DICT_FILE);
+        if (cloudCsv)
+            for (const w of parseDictCsv(cloudCsv))
+                merged.add(w);
     }
     catch { /* cloud unreachable — save local version */ }
-    merged.sort();
-    saveFile("userdict.jsonc", { words: merged });
+    const text = buildDictCsv([...merged]);
+    const sharedDir = getSharedDir();
+    atomicWriteText(path.join(sharedDir, USER_DICT_FILE), text);
+    if (sharedDir !== LOCAL_DIR) {
+        try {
+            atomicWriteText(path.join(LOCAL_DIR, USER_DICT_FILE), text);
+        }
+        catch { /* ignore */ }
+    }
+    if (pendingCloudConfig) {
+        cloudWrite(USER_DICT_FILE, text)
+            .then(() => console.log(`  [cloud] Saved ${USER_DICT_FILE} via ${pendingCloudConfig.provider} API`))
+            .catch(e => console.error(`  [cloud] Failed to save ${USER_DICT_FILE}: ${e.message}`));
+    }
 }
 // ── Legacy compatibility ──
 function loadLegacySettings() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-settings",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",
@@ -17,7 +17,7 @@
   },
   "license": "ISC",
   "dependencies": {
-    "@bobfrankston/mailx-types": "^0.1.15",
+    "@bobfrankston/mailx-types": "^0.1.18",
     "jsonc-parser": "^3.3.1"
   },
   "repository": {
@@ -33,7 +33,7 @@
   },
   ".transformedSnapshot": {
     "dependencies": {
-      "@bobfrankston/mailx-types": "^0.1.15",
+      "@bobfrankston/mailx-types": "^0.1.18",
       "jsonc-parser": "^3.3.1"
     }
   }