@richscripts/richtexteditor 2.6.4 → 2.7.0

package/README.md

@@ -446,4 +446,24 @@ In order to start using Rich Text Editor, configure or customize it further, ple
 
 ## License
 
-For licensing information please read [Licensing Info](http://richtexteditor.com/license.aspx).
+For licensing information please read [Licensing Info](http://richtexteditor.com/license.aspx).
+
+### State inspector (developer tool)
+
+A derived view of the document the editor is actually holding: a serializable
+snapshot (node tree, selection, plugin initialization order) plus structural
+checks for the faults that break documents downstream - zero-length text nodes,
+empty inline wrappers, duplicate nested formatting, control characters that make
+an exported .docx unreadable, unsafe URL schemes, `iframe[srcdoc]`, orphaned
+list items, images with no alt text, and unprotected atomic content.
+
+```js
+editor.stateInspector.open();        // panel with Issues / Tree / Selection / Plugins / Log
+editor.stateInspector.issues();      // [{ id, severity, message, detail }]
+editor.stateInspector.snapshot();    // plain JSON - attach this to a bug report
+```
+
+It is **not** in any default toolbar. Add the button with
+`stateInspectorToolbarButton: true`, open it from the API, or type `/inspect`.
+Other options: `stateInspectorEnabled`, `stateInspectorAutoOpen`,
+`stateInspectorMaxDepth`, `stateInspectorLogLimit`.

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "2.6.4",
+  "version": "2.7.0",
   "description": "A full-featured JavaScript rich text editor (WYSIWYG) with toolbar, plugins, i18n support, a built-in AI Toolkit (Ask AI, AI Chat, AI Review drawer, BYOK resolver), structured content APIs (JSON/Markdown), and an optional collaboration / review stack: slash commands, @mentions, human-author Track Changes, threaded comments, revision history, and Yjs-backed presence. Ships first-class React, Vue, Angular and Svelte bindings, a headless \"bring your own UI\" core, and server-safe conversion helpers.",
   "main": "./richtexteditor/rte.js",
   "bin": {
@@ -133,7 +133,7 @@
     "ai-editor"
   ],
   "author": "CuteSoft Components Inc.",
-  "license": "SEE LICENSE IN http://richtexteditor.com/license.aspx",
+  "license": "SEE LICENSE IN https://richtexteditor.com/license",
   "homepage": "https://richtexteditor.com",
   "repository": {
     "type": "git",

package/richtexteditor/all_plugins.js

@@ -24520,6 +24520,19 @@ function RTE_Plugin_DocumentImport() {
                 // matches the old behaviour rather than inventing <ol>s.
                 info.ordered = !!fmt && fmt !== "bullet" && fmt !== "none";
             }
+            // Word paragraph indentation. Nothing read this before 2026-09-04,
+            // so every indented paragraph in every imported .docx arrived
+            // flush left and the indentation was lost silently.
+            // w:left is in twips; 15 twips = 1px.
+            var ind = firstChildEl(ppr, "ind");
+            if (ind) {
+                var lft = ind.getAttributeNS(W, "left") || ind.getAttribute("w:left") || "";
+                var tw = parseInt(lft, 10);
+                // 720 twips alongside the Quote style is the blockquote's own
+                // indent, already carried by the blockquote element itself.
+                if (tw > 0 && !(info.quote && tw === 720))
+                    info.indentPx = Math.round(tw / 15);
+            }
             var jc = firstChildEl(ppr, "jc");
             if (jc) {
                 var a = jc.getAttributeNS(W, "val") || jc.getAttribute("w:val") || "";
@@ -24586,10 +24599,20 @@ function RTE_Plugin_DocumentImport() {
                     continue;
                 }
                 closeListsTo(0);
-                if (st.heading) out.push("<h" + st.heading + ">" + (inner || "") + "</h" + st.heading + ">");
+                if (st.heading) {
+                    // Headings carry w:ind too; without this an indented
+                    // heading imported flush left.
+                    var hs = st.indentPx ? ' style="margin-left:' + st.indentPx + 'px"' : "";
+                    out.push("<h" + st.heading + hs + ">" + (inner || "") + "</h" + st.heading + ">");
+                }
                 else if (st.quote) out.push("<blockquote>" + (inner || "<br>") + "</blockquote>");
                 else {
-                    var style = st.align ? ' style="text-align:' + st.align + '"' : "";
+                    var decl = [];
+                    if (st.align) decl.push("text-align:" + st.align);
+                    // indentUseMargin defaults to margin, and margin is what
+                    // w:ind means, so import writes margin-left to match.
+                    if (st.indentPx) decl.push("margin-left:" + st.indentPx + "px");
+                    var style = decl.length ? ' style="' + decl.join(";") + '"' : "";
                     // A paragraph that contained ONLY a text box has no text of
                     // its own; emitting an empty <p> before the box adds a blank
                     // line that was never in the document.
@@ -25612,6 +25635,31 @@ function RTE_Plugin_DocxExport() {
         var revSeq = { n: 1 };
         var base = { bold: false, italic: false, underline: false, strike: false, sizeHalfPoints: 0, color: null, highlight: null, vertAlign: null, mono: false };
 
+
+        // A block indented in the editor carries margin-left (or padding-left,
+        // per indentUseMargin). Word expresses the same thing as w:ind, in
+        // TWIPS. Before 2026-09-04 indentation reached Word only when it was
+        // spelled <blockquote>, which dragged the Quote style along with it -
+        // so indented body text arrived italic and accent-coloured.
+        // 1px = 0.75pt and 1pt = 20 twips, hence px * 15.
+        function indentTwips(node) {
+            if (!node || !node.style) return 0;
+            var raw = node.style.marginLeft || node.style.paddingLeft || "";
+            var m = /^\s*(-?[\d.]+)\s*([a-z%]*)\s*$/i.exec(raw);
+            if (!m) return 0;
+            var n = parseFloat(m[1]);
+            if (!n || n <= 0) return 0;
+            var unit = (m[2] || "px").toLowerCase();
+            var px = unit === "px" ? n
+                : unit === "pt" ? n * (4 / 3)
+                : unit === "in" ? n * 96
+                : unit === "cm" ? n * 37.795
+                : unit === "mm" ? n * 3.7795
+                : (unit === "em" || unit === "rem") ? n * 16
+                : 0;
+            return Math.round(px * 15);
+        }
+
         function para(node, style, opts) {
             opts = opts || {};
             var pr = "";
@@ -25620,6 +25668,12 @@ function RTE_Plugin_DocxExport() {
             if (opts.pre) pr += '<w:pStyle w:val="Code"/>';
             if (opts.numId) pr += "<w:numPr><w:ilvl w:val=\"" + (opts.level || 0) + "\"/><w:numId w:val=\"" + opts.numId + "\"/></w:numPr>";
             if (opts.pageBreakBefore) pr += "<w:pageBreakBefore/>";
+            // Independent of the Quote style: a real blockquote already got
+            // its w:ind above, so only emit this for everything else.
+            if (!opts.quote) {
+                var indTw = indentTwips(node);
+                if (indTw > 0) pr += '<w:ind w:left="' + indTw + '"/>';
+            }
             var align = node && node.style ? node.style.textAlign : "";
             if (align === "center" || align === "right") pr += '<w:jc w:val="' + align + '"/>';
             else if (align === "justify") pr += '<w:jc w:val="both"/>';
@@ -29261,6 +29315,277 @@ function RTE_Plugin_ImportStyles() {
     }
 }
 
+if (!window.RTE_DefaultConfig) window.RTE_DefaultConfig = {};
+
+// 2026-09-04 Inline code — CKEditor 5's "Code" feature (`<code>`), the one
+// basic-style it ships that this editor had no command for. Markdown `x` was
+// the only way to produce inline code here, which meant there was no way to
+// REMOVE it and no toolbar affordance at all.
+//
+// The command is "inlinecode", NOT "code". "code" is already taken by the
+// HTML-source-view toggle in the core (__Is_Cmd_Active case "code" ->
+// ___Is_CodeMode()), so registering "code" here would have collided with source
+// view. keyboarda11y.js has carried "inlinecode" in its TOGGLE_CMD list all
+// along, with a comment that it matched nothing in this build; a core
+// __Is_Cmd_Active case added alongside this plugin is what makes it match, so
+// the button reports aria-pressed and not just a highlight.
+//
+// Design notes:
+//   - Toggling is done by SPLITTING the <code> element around the selection
+//     rather than by lifting text nodes out of it. Splitting preserves nested
+//     inline markup: un-coding the middle of <code>a <em>b</em> c</code> keeps
+//     the <em>. Lifting text nodes would have dropped it.
+//   - A collapsed selection acts on the word under the caret. That is the same
+//     choice changecase.js makes, and for the same reason: it makes the command
+//     usable from a keyboard shortcut without selecting first. The alternative -
+//     inserting an empty <code> and putting the caret inside - is the caret trap
+//     documented in the footnotes work, so it is deliberately not done.
+//   - Never nests inside <pre> or an existing <code>: both already mean
+//     "preformatted", and nesting produces markup no serializer round-trips.
+//   - Emits a bare <code> element and no rte-* class. That keeps the styling in
+//     the content stylesheet where authors can override it, and keeps the plugin
+//     out of check-css-contract.mjs, which only scans the four theme sheets.
+RTE_DefaultConfig.plugin_inlinecode = RTE_Plugin_InlineCode;
+
+if (!RTE_DefaultConfig.text_inlinecode) RTE_DefaultConfig.text_inlinecode = "Inline code";
+
+if (!RTE_DefaultConfig.svgCode_inlinecode) {
+    RTE_DefaultConfig.svgCode_inlinecode = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="7 8 3 12 7 16"/><polyline points="17 8 21 12 17 16"/></svg>';
+}
+
+function RTE_Plugin_InlineCode() {
+    var obj = this;
+    var config, editor;
+
+    obj.PluginName = "InlineCode";
+
+    obj.InitConfig = function (argconfig) { config = argconfig; };
+
+    obj.InitEditor = function (argeditor) {
+        editor = argeditor;
+
+        editor.attachEvent("exec_command_inlinecode", function (state) {
+            state.returnValue = true;
+            obj.Toggle();
+        });
+
+        // Public API, matching the shape the other toggle plugins expose.
+        editor.toggleInlineCode = function () { return obj.Toggle(); };
+        editor.isInlineCode = function () { return obj.IsActive(); };
+    };
+
+    function getDoc() { try { return editor.getDocument(); } catch (e) { return null; } }
+    function getEditable() { try { return editor.getEditable(); } catch (e) { return null; } }
+
+    function getRange(doc) {
+        var sel = doc && doc.getSelection ? doc.getSelection() : null;
+        if (!sel || !sel.rangeCount) return null;
+        return sel.getRangeAt(0);
+    }
+
+    // Nearest <code> ancestor that is still inside the editable area.
+    function codeAncestor(node, editable) {
+        while (node && node !== editable) {
+            if (node.nodeType === 1 && node.nodeName === "CODE") return node;
+            node = node.parentNode;
+        }
+        return null;
+    }
+
+    function inPre(node, editable) {
+        while (node && node !== editable) {
+            if (node.nodeType === 1 && node.nodeName === "PRE") return true;
+            node = node.parentNode;
+        }
+        return false;
+    }
+
+    obj.IsActive = function () {
+        var doc = getDoc(), editable = getEditable();
+        if (!doc || !editable) return false;
+        var range = getRange(doc);
+        if (!range) return false;
+        return !!codeAncestor(range.startContainer, editable);
+    };
+
+    // ---- selection helpers -----------------------------------------------
+
+    // Expand a collapsed caret to the word under it. Returns false when the
+    // caret is not sitting in a word, in which case the command does nothing
+    // rather than creating an empty element.
+    function expandToWord(range) {
+        var node = range.startContainer;
+        if (!node || node.nodeType !== 3) return false;
+        var text = node.data || "";
+        var offset = range.startOffset;
+        var start = offset, end = offset;
+        while (start > 0 && /\S/.test(text.charAt(start - 1))) start--;
+        while (end < text.length && /\S/.test(text.charAt(end))) end++;
+        if (start === end) return false;
+        range.setStart(node, start);
+        range.setEnd(node, end);
+        return true;
+    }
+
+    // Every text node the range actually covers. Boundary text nodes are split
+    // first so a partially-selected node is not treated as fully selected.
+    function selectedTextNodes(doc, range, editable) {
+        if (range.startContainer.nodeType === 3 && range.startOffset > 0) {
+            var s = range.startContainer;
+            if (range.startOffset < s.data.length) {
+                var rest = s.splitText(range.startOffset);
+                var endSame = (range.endContainer === s);
+                var endOff = range.endOffset;
+                range.setStart(rest, 0);
+                if (endSame) range.setEnd(rest, endOff - s.data.length);
+            }
+        }
+        if (range.endContainer.nodeType === 3 && range.endOffset < range.endContainer.data.length && range.endOffset > 0) {
+            range.endContainer.splitText(range.endOffset);
+        }
+
+        var out = [];
+        var walker = doc.createTreeWalker(editable, 4 /* SHOW_TEXT */, null, false);
+        var n;
+        while ((n = walker.nextNode())) {
+            if (!n.data) continue;
+            if (range.intersectsNode ? range.intersectsNode(n) : true) {
+                // intersectsNode is true for merely-touching nodes, so confirm
+                // the node is genuinely within the boundaries.
+                var r = doc.createRange();
+                r.selectNodeContents(n);
+                if (range.compareBoundaryPoints(Range.END_TO_START, r) < 0 &&
+                    range.compareBoundaryPoints(Range.START_TO_END, r) > 0) {
+                    out.push(n);
+                }
+            }
+        }
+        return out;
+    }
+
+    // ---- apply / remove ---------------------------------------------------
+
+    // Split `code` around the selection and unwrap only the overlapping part,
+    // so partial removal keeps the untouched halves coded.
+    function unwrapPart(doc, code, range) {
+        var parent = code.parentNode;
+        if (!parent) return;
+
+        var startsInside = code.contains(range.startContainer);
+        var endsInside = code.contains(range.endContainer);
+
+        // Tail first: extracting it cannot disturb the head's boundaries.
+        var after = doc.createRange();
+        if (endsInside) after.setStart(range.endContainer, range.endOffset);
+        else after.setStart(code, code.childNodes.length);
+        after.setEnd(code, code.childNodes.length);
+        var afterFrag = after.extractContents();
+
+        var before = doc.createRange();
+        before.setStart(code, 0);
+        if (startsInside) before.setEnd(range.startContainer, range.startOffset);
+        else before.setEnd(code, 0);
+        var beforeFrag = before.extractContents();
+
+        if (beforeFrag && beforeFrag.textContent !== "") {
+            var head = doc.createElement("code");
+            head.appendChild(beforeFrag);
+            parent.insertBefore(head, code);
+        }
+
+        // What is left in `code` is exactly the selected part: unwrap it.
+        while (code.firstChild) parent.insertBefore(code.firstChild, code);
+
+        if (afterFrag && afterFrag.textContent !== "") {
+            var tail = doc.createElement("code");
+            tail.appendChild(afterFrag);
+            parent.insertBefore(tail, code);
+        }
+
+        parent.removeChild(code);
+    }
+
+    function wrapNodes(doc, nodes, editable) {
+        // Group contiguous siblings so a run of text under one parent becomes a
+        // single <code>, not one per text node.
+        var group = [], groups = [];
+        for (var i = 0; i < nodes.length; i++) {
+            var n = nodes[i];
+            if (inPre(n, editable) || codeAncestor(n, editable)) continue;
+            if (group.length && group[group.length - 1].parentNode === n.parentNode &&
+                group[group.length - 1].nextSibling === n) {
+                group.push(n);
+            } else {
+                if (group.length) groups.push(group);
+                group = [n];
+            }
+        }
+        if (group.length) groups.push(group);
+
+        for (var g = 0; g < groups.length; g++) {
+            var run = groups[g];
+            // Whitespace-only runs would produce a <code> containing nothing but
+            // a space, which is invisible formatting debris.
+            var joined = "";
+            for (var k = 0; k < run.length; k++) joined += run[k].data;
+            if (!/\S/.test(joined)) continue;
+
+            var code = doc.createElement("code");
+            run[0].parentNode.insertBefore(code, run[0]);
+            for (var j = 0; j < run.length; j++) code.appendChild(run[j]);
+        }
+    }
+
+    // Adjacent <code><code> pairs read as one to the user but serialize as two.
+    function mergeAdjacent(editable) {
+        var all = editable.querySelectorAll("code");
+        for (var i = 0; i < all.length; i++) {
+            var code = all[i];
+            var next = code.nextSibling;
+            while (next && next.nodeType === 1 && next.nodeName === "CODE") {
+                while (next.firstChild) code.appendChild(next.firstChild);
+                next.parentNode.removeChild(next);
+                next = code.nextSibling;
+            }
+        }
+    }
+
+    obj.Toggle = function () {
+        var doc = getDoc(), editable = getEditable();
+        if (!doc || !editable) return false;
+        var range = getRange(doc);
+        if (!range) return false;
+        if (!editable.contains(range.startContainer)) return false;
+
+        if (range.collapsed && !expandToWord(range)) return false;
+
+        var nodes = selectedTextNodes(doc, range, editable);
+        if (!nodes.length) return false;
+
+        // Remove when every selected text node is already coded; otherwise apply.
+        var allCoded = true;
+        for (var i = 0; i < nodes.length; i++) {
+            if (!/\S/.test(nodes[i].data)) continue;
+            if (!codeAncestor(nodes[i], editable)) { allCoded = false; break; }
+        }
+
+        if (allCoded) {
+            var codes = [], seen = [];
+            for (var n = 0; n < nodes.length; n++) {
+                var c = codeAncestor(nodes[n], editable);
+                if (c && seen.indexOf(c) < 0) { seen.push(c); codes.push(c); }
+            }
+            for (var x = 0; x < codes.length; x++) unwrapPart(doc, codes[x], range);
+        } else {
+            wrapNodes(doc, nodes, editable);
+            mergeAdjacent(editable);
+        }
+
+        try { editor.updateToolbarStatus && editor.updateToolbarStatus(); } catch (e) { }
+        return true;
+    };
+}
+
 
 if (!RTE_DefaultConfig.svgCode_insertcode) {
 	RTE_DefaultConfig.svgCode_insertcode = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><polyline points="8 7 3 12 8 17"/><polyline points="16 7 21 12 16 17"/><line x1="14" y1="5" x2="10" y2="19"/></svg>';
@@ -35450,6 +35775,28 @@ function RTE_Plugin_PdfExport() {
         var self = this;
         var base = { bold: false, italic: false, underline: false, strike: false, size: this.baseSize, color: [0, 0, 0], mono: false, link: null };
 
+    // A block indented in the editor carries margin-left (or padding-left, per
+    // indentUseMargin). Before 2026-09-04 the PDF honoured an indent only when
+    // it was spelled <blockquote>, because that was the only way the editor
+    // could express one. Points, since that is the PDF's unit: 1px = 0.75pt.
+    function cssIndentPt(node) {
+        if (!node || !node.style) return 0;
+        var raw = node.style.marginLeft || node.style.paddingLeft || "";
+        var m = /^\s*(-?[\d.]+)\s*([a-z%]*)\s*$/i.exec(raw);
+        if (!m) return 0;
+        var n = parseFloat(m[1]);
+        if (!n || n <= 0) return 0;
+        var unit = (m[2] || "px").toLowerCase();
+        var px = unit === "px" ? n
+            : unit === "pt" ? n * (4 / 3)
+            : unit === "in" ? n * 96
+            : unit === "cm" ? n * 37.795
+            : unit === "mm" ? n * 3.7795
+            : (unit === "em" || unit === "rem") ? n * 16
+            : 0;
+        return px * 0.75;
+    }
+
         function block(node, style, indent, listMarker, listId, listOrdered) {
             var tag = node.tagName.toLowerCase();
             var s = styleOf(node, style);
@@ -35522,8 +35869,9 @@ function RTE_Plugin_PdfExport() {
                     continue;
                 }
                 if (isBlockTag(tag)) {
-                    if (hasBlockChildren(c)) { walk(c, styleOf(c, style), indent + (tag === "blockquote" ? self.baseSize * 1.5 : 0)); continue; }
-                    block(c, style, indent + (tag === "blockquote" ? self.baseSize * 1.5 : 0), null);
+                    var own = (tag === "blockquote" ? self.baseSize * 1.5 : 0) + cssIndentPt(c);
+                    if (hasBlockChildren(c)) { walk(c, styleOf(c, style), indent + own); continue; }
+                    block(c, style, indent + own, null);
                     continue;
                 }
                 // Inline content sitting directly under a container.
@@ -43026,7 +43374,9 @@ function RTE_Plugin_WordExport() {
             "table { border-collapse: collapse; }\r\n" +
             "td, th { border: 1px solid #999; padding: 4px 8px; }\r\n" +
             "img { max-width: 100%; height: auto; }\r\n" +
-            "blockquote { border-left: 3px solid #ccc; margin-left: 0; padding-left: 12px; color: #444; }\r\n" +
+            // margin-left was zeroed here, which also flattened any indentation
+            // expressed as a margin. Keep the quote bar, keep the offset.
+            "blockquote { border-left: 3px solid #ccc; padding-left: 12px; color: #444; }\r\n" +
             "pre { font-family: Consolas, 'Courier New', monospace; background: #f4f4f4; padding: 8px; }\r\n" +
             "</style>\r\n" +
             "</head>\r\n" +