@bobfrankston/mailx-settings 0.1.20 → 0.1.21

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-settings",
-  "version": "0.1.20",
+  "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.17",
+    "@bobfrankston/mailx-types": "^0.1.18",
     "jsonc-parser": "^3.3.1"
   },
   "repository": {
@@ -33,7 +33,7 @@
   },
   ".transformedSnapshot": {
     "dependencies": {
-      "@bobfrankston/mailx-types": "^0.1.17",
+      "@bobfrankston/mailx-types": "^0.1.18",
       "jsonc-parser": "^3.3.1"
     }
   }