@richscripts/richtexteditor 2.4.0 → 2.4.1

package/richtexteditor/plugins/comments.js

@@ -564,60 +564,47 @@ function RTE_Plugin_Comments() {
             style.setAttribute("data-rte-comments", "1");
             style.textContent = [
                 ".rte-comment-sidebar-host{display:flex!important;align-items:stretch}",
-                ".rte-comment-sidebar{width:310px;min-width:270px;max-width:min(360px,32vw);margin-left:12px;padding:0;background:linear-gradient(180deg,rgba(255,255,255,.98),rgba(248,251,255,.96));border:1px solid rgba(148,163,184,.22);border-radius:16px;font-family:Aptos,'Segoe UI',sans-serif;font-size:13px;color:#172033;display:flex;flex-direction:column;max-height:calc(100vh - 120px);overflow:hidden;box-shadow:0 18px 42px rgba(29,78,216,.12),0 2px 8px rgba(15,23,42,.06)}",
+                "/* 2026-07-12 comments panel precision */",
+                ".rte-comment-sidebar{width:310px;min-width:270px;max-width:min(360px,32vw);margin-left:12px;padding:0;background:linear-gradient(180deg,rgba(255,255,255,.98),rgba(248,251,255,.96));border:1px solid rgba(148,163,184,.22);border-radius:8px;font-family:Aptos,'Segoe UI',sans-serif;font-size:13px;color:#172033;display:flex;flex-direction:column;max-height:calc(100vh - 120px);overflow:hidden;box-shadow:0 14px 32px rgba(29,78,216,.1),0 2px 8px rgba(15,23,42,.06)}",
                 ".rte-comment-sidebar-header{display:flex;align-items:center;justify-content:space-between;gap:10px;padding:10px 10px 9px 14px;border-bottom:1px solid rgba(148,163,184,.16);font-weight:750;background:rgba(255,255,255,.72)}",
                 ".rte-comment-sidebar-title{font-size:13px;font-weight:850;letter-spacing:.02em}",
-                ".rte-comment-sidebar-close{width:28px;height:28px;border:1px solid rgba(100,116,139,.18);background:#fff;cursor:pointer;color:#64748b;padding:0;border-radius:999px;display:inline-flex;align-items:center;justify-content:center}",
+                ".rte-comment-sidebar-close{width:28px;height:28px;border:1px solid rgba(100,116,139,.18);background:#fff;cursor:pointer;color:#64748b;padding:0;border-radius:7px;display:inline-flex;align-items:center;justify-content:center}",
                 ".rte-comment-sidebar-close:hover,.rte-comment-sidebar-close:focus-visible{background:#eef4ff;color:#0f3f9f;border-color:rgba(37,99,235,.28)}",
                 ".rte-comment-list{flex:1;min-height:0;overflow-y:auto;padding:6px;scrollbar-width:thin}",
-                ".rte-comment-empty{margin:6px;padding:14px;color:#52657e;font-size:12px;font-weight:700;line-height:1.45;text-align:center;background:#fff;border:1px dashed rgba(148,163,184,.28);border-radius:13px}",
-                ".rte-comment-item{padding:10px;border:1px solid rgba(148,163,184,.14);border-radius:14px;background:rgba(255,255,255,.82);box-shadow:0 8px 18px rgba(15,23,42,.04);transition:background 200ms ease,box-shadow 200ms ease,transform 200ms ease}",
+                ".rte-comment-empty{margin:6px;padding:14px;color:#52657e;font-size:12px;font-weight:700;line-height:1.45;text-align:center;background:#fff;border:1px dashed rgba(148,163,184,.28);border-radius:8px}",
+                ".rte-comment-item{padding:10px;border:1px solid rgba(148,163,184,.14);border-radius:8px;background:rgba(255,255,255,.82);box-shadow:0 6px 14px rgba(15,23,42,.04);transition:background 200ms ease,box-shadow 200ms ease,transform 200ms ease}",
                 ".rte-comment-item+.rte-comment-item{margin-top:7px}",
                 ".rte-comment-item-active{background:#eef4ff;box-shadow:0 12px 28px rgba(37,99,235,.14);transform:translateY(-1px)}",
                 ".rte-comment-item-top{display:grid;grid-template-columns:30px minmax(0,1fr) auto;align-items:center;gap:8px}",
-                ".rte-comment-avatar{width:30px;height:30px;border-radius:11px;display:inline-flex;align-items:center;justify-content:center;color:#fff;font-size:11px;font-weight:800;flex:0 0 30px;box-shadow:inset 0 0 0 1px rgba(255,255,255,.28)}",
+                ".rte-comment-avatar{width:30px;height:30px;border-radius:8px;display:inline-flex;align-items:center;justify-content:center;color:#fff;font-size:11px;font-weight:800;flex:0 0 30px;box-shadow:inset 0 0 0 1px rgba(255,255,255,.28)}",
                 ".rte-comment-namewrap{flex:1;min-width:0}",
                 ".rte-comment-name{font-weight:800;font-size:12px;line-height:1.2;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}",
                 ".rte-comment-when{font-size:11px;color:#64748b}",
                 ".rte-comment-actions{display:flex;gap:4px;align-items:center}",
-                ".rte-comment-action{font-size:11px;font-weight:750;padding:4px 8px;border-radius:999px;border:1px solid rgba(100,116,139,.16);background:#fff;cursor:pointer}",
+                ".rte-comment-action{font-size:11px;font-weight:750;padding:4px 8px;border-radius:6px;border:1px solid rgba(100,116,139,.16);background:#fff;cursor:pointer}",
                 ".rte-comment-action:hover,.rte-comment-action:focus-visible{transform:translateY(-1px)}",
                 ".rte-comment-resolve{color:#0f3f9f;border-color:rgba(37,99,235,.2);background:#eef4ff}",
                 ".rte-comment-delete{color:#9f1239;border-color:rgba(159,18,57,.18);background:#fff1f2}",
-                ".rte-comment-quote{margin:8px 0 0;padding:7px 9px;background:#fff8e8;border:1px solid rgba(245,158,11,.18);border-left:3px solid #f59e0b;border-radius:11px;font-size:11px;color:#67430a;cursor:pointer;line-height:1.35}",
+                ".rte-comment-quote{margin:8px 0 0;padding:7px 9px;background:#fff8e8;border:1px solid rgba(245,158,11,.18);border-left:3px solid #f59e0b;border-radius:7px;font-size:11px;color:#67430a;cursor:pointer;line-height:1.35}",
                 ".rte-comment-quote:hover{background:#fff3cf}",
                 ".rte-comment-body{margin-top:8px;font-size:13px;line-height:1.45;color:#172033;white-space:pre-wrap}",
                 ".rte-comment-reply{display:flex;gap:8px;margin-top:10px;padding-top:9px;border-top:1px dashed rgba(148,163,184,.22)}",
-                ".rte-comment-reply-avatar{width:24px;height:24px;border-radius:9px;display:inline-flex;align-items:center;justify-content:center;color:#fff;font-size:10px;font-weight:800;flex:0 0 24px}",
+                ".rte-comment-reply-avatar{width:24px;height:24px;border-radius:7px;display:inline-flex;align-items:center;justify-content:center;color:#fff;font-size:10px;font-weight:800;flex:0 0 24px}",
                 ".rte-comment-reply-body{flex:1;min-width:0}",
                 ".rte-comment-reply-name{font-size:11px;color:#64748b}",
                 ".rte-comment-reply-text{font-size:12px;color:#172033;line-height:1.45;white-space:pre-wrap;margin-top:2px}",
                 ".rte-comment-reply-composer{margin-top:8px;display:flex}",
-                ".rte-comment-reply-input{flex:1;min-width:0;padding:7px 10px;border-radius:999px;border:1px solid rgba(148,163,184,.24);font:inherit;font-size:12px;background:#fff}",
+                ".rte-comment-reply-input{flex:1;min-width:0;padding:7px 10px;border-radius:7px;border:1px solid rgba(148,163,184,.24);font:inherit;font-size:12px;background:#fff}",
                 ".rte-comment-reply-input:focus,.rte-comment-composer-textarea:focus{outline:2px solid rgba(37,99,235,.18);border-color:rgba(37,99,235,.38)}",
-                ".rte-comment-composer{position:absolute;z-index:2147483000;width:min(320px,calc(100vw - 24px));background:linear-gradient(180deg,#fff,#f8fbff);border:1px solid rgba(148,163,184,.22);box-shadow:0 18px 42px rgba(29,78,216,.16),0 2px 8px rgba(15,23,42,.08);border-radius:16px;padding:12px;font-family:Aptos,'Segoe UI',sans-serif;color:#172033}",
+                ".rte-comment-composer{position:absolute;z-index:2147483000;width:min(320px,calc(100vw - 24px));background:linear-gradient(180deg,#fff,#f8fbff);border:1px solid rgba(148,163,184,.22);box-shadow:0 14px 32px rgba(29,78,216,.12),0 2px 8px rgba(15,23,42,.08);border-radius:8px;padding:12px;font-family:Aptos,'Segoe UI',sans-serif;color:#172033}",
                 ".rte-comment-composer-header{font-weight:850;font-size:13px;margin-bottom:8px;color:#172033}",
-                ".rte-comment-composer-textarea{width:100%;box-sizing:border-box;padding:9px 10px;border-radius:12px;border:1px solid rgba(148,163,184,.24);font:inherit;font-size:13px;resize:vertical;min-height:70px;background:#fff}",
+                ".rte-comment-composer-textarea{width:100%;box-sizing:border-box;padding:9px 10px;border-radius:7px;border:1px solid rgba(148,163,184,.24);font:inherit;font-size:13px;resize:vertical;min-height:70px;background:#fff}",
                 ".rte-comment-composer-actions{display:flex;justify-content:flex-end;gap:8px;margin-top:9px}",
-                ".rte-comment-btn{min-height:30px;padding:0 13px;border-radius:999px;border:1px solid rgba(100,116,139,.18);font:750 12px/1 Aptos,'Segoe UI',sans-serif;cursor:pointer}",
+                ".rte-comment-btn{min-height:30px;padding:0 13px;border-radius:7px;border:1px solid rgba(100,116,139,.18);font:750 12px/1 Aptos,'Segoe UI',sans-serif;cursor:pointer}",
                 ".rte-comment-btn-ghost{background:#fff;color:#52657e}",
                 ".rte-comment-btn-primary{background:#1d67ba;color:#fff;border-color:#1d67ba;box-shadow:0 8px 16px rgba(29,103,186,.18)}",
-                // Dark mode — the sidebar/composer are body-appended (outside the
-                // editor container) so the .rte-dark class can't reach them. Apply
-                // automatically via prefers-color-scheme, and via an explicit
-                // .rte-comment-dark class set when the editor is forced dark.
-                "@media (prefers-color-scheme:dark){",
-                "  .rte-comment-sidebar,.rte-comment-composer{background:linear-gradient(180deg,#1e293b,#0f172a);border-color:#334155;color:#e2e8f0}",
-                "  .rte-comment-sidebar-header{background:rgba(30,41,59,.72);border-color:#334155}",
-                "  .rte-comment-item{background:rgba(30,41,59,.85);border-color:#334155}",
-                "  .rte-comment-item-active{background:#1e3a8a}",
-                "  .rte-comment-empty{background:#0f172a;color:#94a3b8;border-color:#334155}",
-                "  .rte-comment-when,.rte-comment-reply-name{color:#94a3b8}",
-                "  .rte-comment-body,.rte-comment-reply-text,.rte-comment-composer-header{color:#e2e8f0}",
-                "  .rte-comment-reply-input,.rte-comment-composer-textarea{background:#0f172a;color:#e2e8f0;border-color:#334155}",
-                "  .rte-comment-action,.rte-comment-btn-ghost,.rte-comment-sidebar-close{background:#0f172a;color:#cbd5e1;border-color:#334155}",
-                "  .rte-comment-quote{background:rgba(245,158,11,.12);color:#fcd34d}",
-                "}",
+                // Body-appended overlays remain light unless the host editor
+                // explicitly opts into its rte-dark treatment below.
                 ".rte-comment-dark.rte-comment-sidebar,.rte-comment-dark.rte-comment-composer{background:linear-gradient(180deg,#1e293b,#0f172a);border-color:#334155;color:#e2e8f0}",
                 ".rte-comment-dark .rte-comment-sidebar-header{background:rgba(30,41,59,.72);border-color:#334155}",
                 ".rte-comment-dark .rte-comment-item{background:rgba(30,41,59,.85);border-color:#334155}",

package/richtexteditor/plugins/contentminimap.js

@@ -81,7 +81,8 @@ function RTE_Plugin_ContentMinimap() {
         style.innerHTML = [
             ".rte-content-minimap-shell{display:flex;align-items:stretch;gap:10px;}",
             ".rte-content-minimap-shell>.rte-content-minimap-host{flex:1 1 auto;min-width:0;}",
-            ".rte-content-minimap-panel{display:none;flex:0 0 var(--rte-content-minimap-width,168px);min-width:148px;max-width:220px;border:1px solid rgba(148,163,184,.22);border-radius:16px;background:linear-gradient(180deg,rgba(255,255,255,.98),rgba(248,251,255,.96));box-shadow:0 18px 42px rgba(29,78,216,.12),0 2px 8px rgba(15,23,42,.06);overflow:hidden;color:#172033;font-family:Aptos,'Segoe UI',sans-serif;}",
+            "/* 2026-07-12 navigation panel precision */",
+            ".rte-content-minimap-panel{display:none;flex:0 0 var(--rte-content-minimap-width,168px);min-width:148px;max-width:220px;border:1px solid rgba(148,163,184,.22);border-radius:8px;background:linear-gradient(180deg,rgba(255,255,255,.98),rgba(248,251,255,.96));box-shadow:0 14px 32px rgba(29,78,216,.1),0 2px 8px rgba(15,23,42,.06);overflow:hidden;color:#172033;font-family:Aptos,'Segoe UI',sans-serif;}",
             ".rte-content-minimap-shell.is-open>.rte-content-minimap-panel{display:flex;flex-direction:column;}",
             ".rte-content-minimap-header{padding:12px 12px 9px 14px;border-bottom:1px solid rgba(148,163,184,.16);background:rgba(255,255,255,.72);}",
             ".rte-content-minimap-kicker{font-size:10px;line-height:1.3;letter-spacing:.08em;text-transform:uppercase;color:#52657e;font-weight:850;}",
@@ -89,17 +90,17 @@ function RTE_Plugin_ContentMinimap() {
             ".rte-content-minimap-copy{margin-top:5px;font-size:12px;line-height:1.42;color:#52657e;}",
             ".rte-content-minimap-toolbar{display:flex;align-items:center;justify-content:space-between;padding:8px 10px 8px 14px;border-bottom:1px solid rgba(148,163,184,.16);gap:8px;background:rgba(255,255,255,.52);}",
             ".rte-content-minimap-meta{min-width:0;font-size:12px;font-weight:750;color:#52657e;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}",
-            ".rte-content-minimap-close{appearance:none;border:1px solid rgba(100,116,139,.18);background:#fff;color:#315277;cursor:pointer;font-size:12px;font-weight:750;padding:6px 9px;border-radius:999px;line-height:1;}",
+            ".rte-content-minimap-close{appearance:none;border:1px solid rgba(100,116,139,.18);background:#fff;color:#315277;cursor:pointer;font-size:12px;font-weight:750;padding:6px 9px;border-radius:7px;line-height:1;}",
             ".rte-content-minimap-close:hover,.rte-content-minimap-close:focus-visible{background:#eef4ff;color:#0f3f9f;border-color:rgba(37,99,235,.28);}",
             ".rte-content-minimap-body{padding:6px;overflow:auto;min-height:140px;max-height:520px;scrollbar-width:thin;}",
-            ".rte-content-minimap-canvas{position:relative;border-radius:14px;background:#fff;border:1px solid rgba(148,163,184,.18);overflow:hidden;min-height:120px;box-shadow:inset 0 0 0 1px rgba(255,255,255,.7);}",
+            ".rte-content-minimap-canvas{position:relative;border-radius:8px;background:#fff;border:1px solid rgba(148,163,184,.18);overflow:hidden;min-height:120px;box-shadow:inset 0 0 0 1px rgba(255,255,255,.7);}",
             ".rte-content-minimap-preview{position:relative;transform-origin:top left;pointer-events:none;color:#172033;background:#fff;}",
             ".rte-content-minimap-preview>*{max-width:100%;}",
             ".rte-content-minimap-preview img,.rte-content-minimap-preview table,.rte-content-minimap-preview iframe,.rte-content-minimap-preview video{max-width:100% !important;}",
             ".rte-content-minimap-preview [contenteditable]{pointer-events:none;}",
-            ".rte-content-minimap-viewport{position:absolute;left:0;right:0;border:1px solid rgba(37,99,235,.62);background:linear-gradient(180deg,rgba(37,99,235,.18) 0%,rgba(14,165,233,.12) 100%);box-shadow:inset 0 0 0 1px rgba(255,255,255,.48),0 8px 18px rgba(37,99,235,.16);border-radius:10px;cursor:grab;}",
+            ".rte-content-minimap-viewport{position:absolute;left:0;right:0;border:1px solid rgba(37,99,235,.62);background:linear-gradient(180deg,rgba(37,99,235,.18) 0%,rgba(14,165,233,.12) 100%);box-shadow:inset 0 0 0 1px rgba(255,255,255,.48),0 6px 14px rgba(37,99,235,.14);border-radius:7px;cursor:grab;}",
             ".rte-content-minimap-viewport.is-dragging{cursor:grabbing;}",
-            ".rte-content-minimap-empty{position:absolute;inset:auto 8px 8px 8px;padding:10px;border-radius:12px;background:rgba(255,255,255,.94);color:#52657e;font-size:12px;font-weight:700;line-height:1.45;border:1px dashed rgba(148,163,184,.32);}",
+            ".rte-content-minimap-empty{position:absolute;inset:auto 8px 8px 8px;padding:10px;border-radius:7px;background:rgba(255,255,255,.94);color:#52657e;font-size:12px;font-weight:700;line-height:1.45;border:1px dashed rgba(148,163,184,.32);}",
             "@media (max-width: 1100px){.rte-content-minimap-shell{display:block;}.rte-content-minimap-panel{margin-top:12px;max-width:none;width:100%;}.rte-content-minimap-body{max-height:280px;}}"
         ].join("");
         hostDoc.head.appendChild(style);

package/richtexteditor/plugins/crossreference.js

@@ -0,0 +1,408 @@
+if (!window.RTE_DefaultConfig) window.RTE_DefaultConfig = {};
+
+// 2026-07-27 Cross-references. "See clause 3.2", "Figure 4", "as described in
+// Scope of Work (page 7)" — references that keep pointing at the right thing
+// after the document is edited around them.
+//
+// This is the piece that makes the rest of the document suite hold together.
+// Legal numbering renumbers clauses, the table of contents re-derives itself,
+// footnotes renumber — and until now a sentence saying "see clause 3.2" stayed
+// frozen at 3.2 while the clause it meant became 4.1. A stale cross-reference in
+// a contract is not cosmetic; it changes what the contract says.
+//
+// Competitive position (checked 2026-07-27): CKEditor 5 ships Bookmarks
+// (in-text anchors) and its own auto-updating table of contents, but describes
+// auto-updating cross-references as a PLANNED enhancement rather than a current
+// feature. TinyMCE documents no cross-reference plugin. Word has had this for
+// decades and it is table stakes for contract and specification work.
+//
+// Design notes:
+//   - A reference is an atomic contenteditable=false chip carrying the target id
+//     and the display format. The visible text is REAL TEXT, recomputed on every
+//     mutation, so the saved HTML stands alone outside the editor (same reasoning
+//     as footnotes.js).
+//   - A reference whose target has been deleted renders a visible error rather
+//     than silently keeping its last value. Word does this too, and it is the
+//     right call: a wrong-but-plausible clause number is far more dangerous than
+//     an obviously broken one.
+RTE_DefaultConfig.plugin_crossreference = RTE_Plugin_CrossReference;
+
+// Shown when the target no longer exists.
+if (typeof RTE_DefaultConfig.crossRefMissingText === "undefined") RTE_DefaultConfig.crossRefMissingText = "[reference not found]";
+// Prefixes used when auto-numbering tables and figures.
+if (typeof RTE_DefaultConfig.crossRefTableLabel === "undefined") RTE_DefaultConfig.crossRefTableLabel = "Table";
+if (typeof RTE_DefaultConfig.crossRefFigureLabel === "undefined") RTE_DefaultConfig.crossRefFigureLabel = "Figure";
+
+function RTE_Plugin_CrossReference() {
+    var obj = this;
+    var config, editor;
+    var boundDoc = null;
+    var queued = false;
+    var idSeq = 0;
+
+    obj.PluginName = "CrossReference";
+
+    obj.InitConfig = function (argconfig) { config = argconfig; };
+
+    obj.InitEditor = function (argeditor) {
+        editor = argeditor;
+
+        editor.attachEvent("exec_command_insertcrossreference", function (state) {
+            state.returnValue = true;
+            var v = state && state.value;
+            if (v && typeof v === "object") obj.Insert(v.target, v.format);
+        });
+
+        setup();
+        try { editor.attachEvent("ready", setup); } catch (e) {}
+        try { editor.attachEvent("aftersethtml", function () { setup(); queue(); }); } catch (e) {}
+        setTimeout(function () { setup(); queue(); }, 0);
+
+        // Public API.
+        editor.listCrossReferenceTargets = function () { return obj.Targets(); };
+        editor.insertCrossReference = function (targetId, format) { return obj.Insert(targetId, format); };
+        editor.updateCrossReferences = function () { return refresh(); };
+        editor.getCrossReferences = function () { return obj.List(); };
+        editor.getCrossReferenceCss = function () { return css(); };
+    };
+
+    function setup() {
+        var doc = getDoc();
+        if (!doc) return;
+        injectStyles(doc);
+        if (doc === boundDoc) return;
+        boundDoc = doc;
+        var editable = getEditable();
+        if (!editable) return;
+        editable.addEventListener("keyup", queue);
+        editable.addEventListener("cut", queue);
+        editable.addEventListener("paste", queue);
+        editable.addEventListener("drop", queue);
+        editable.addEventListener("click", function (e) {
+            var chip = closestClass(e.target, "rte-xref", editable);
+            if (!chip) return;
+            e.preventDefault();
+            var t = resolveTarget(chip.getAttribute("data-xref-target"));
+            if (!t) return;
+            try { t.el.scrollIntoView({ block: "center" }); } catch (e2) { t.el.scrollIntoView(); }
+        });
+    }
+
+    function getDoc() { try { return editor.getDocument(); } catch (e) { return null; } }
+    function getEditable() { try { return editor.getEditable(); } catch (e) { return null; } }
+
+    function queue() {
+        if (queued) return;
+        queued = true;
+        setTimeout(function () { queued = false; refresh(); }, 0);
+    }
+
+    function closestClass(node, cls, root) {
+        while (node && node !== root) {
+            if (node.nodeType === 1 && node.classList && node.classList.contains(cls)) return node;
+            node = node.parentNode;
+        }
+        return null;
+    }
+
+    function newId(prefix) {
+        return prefix + Math.floor(Math.random() * 1e9).toString(36) + (idSeq++).toString(36);
+    }
+
+    function ensureId(el, prefix) {
+        var id = el.getAttribute("id");
+        if (id) return id;
+        id = newId(prefix);
+        el.setAttribute("id", id);
+        return id;
+    }
+
+    // ---- targets ---------------------------------------------------------
+
+    // Everything in the document that can be referred to, in document order.
+    obj.Targets = function () {
+        var editable = getEditable();
+        if (!editable) return [];
+        var out = [];
+
+        var headings = editable.querySelectorAll("h1,h2,h3,h4,h5,h6");
+        for (var i = 0; i < headings.length; i++) {
+            var h = headings[i];
+            // Generated regions are not referable content.
+            if (h.closest && (h.closest("nav.rte-toc") || h.closest("section.rte-footnotes"))) continue;
+            var text = (h.textContent || "").trim();
+            if (!text) continue;
+            out.push({ id: ensureId(h, "rte-h-"), type: "heading", label: text, number: null });
+        }
+
+        // Legal-numbered clauses: the number is derived from position, exactly
+        // like the CSS counters that render it.
+        var roots = editable.querySelectorAll("ol.rte-legal-list");
+        for (var r = 0; r < roots.length; r++) collectClauses(roots[r], [], out);
+
+        var notes = editable.querySelectorAll("li.rte-fn-note[data-fn-id]");
+        for (var n = 0; n < notes.length; n++) {
+            out.push({
+                id: ensureId(notes[n], "rte-fn-"),
+                type: "footnote",
+                label: (noteText(notes[n]) || "footnote"),
+                number: notes[n].getAttribute("data-fn-number")
+            });
+        }
+
+        var tables = editable.querySelectorAll("table");
+        var tnum = 0;
+        for (var t = 0; t < tables.length; t++) {
+            tnum++;
+            var cap = tables[t].querySelector("caption");
+            out.push({
+                id: ensureId(tables[t], "rte-tbl-"),
+                type: "table",
+                label: (cap && cap.textContent.trim()) || (String(config.crossRefTableLabel) + " " + tnum),
+                number: String(tnum)
+            });
+        }
+
+        var figs = editable.querySelectorAll("figure, img");
+        var fnum = 0;
+        for (var f = 0; f < figs.length; f++) {
+            // An <img> inside a <figure> is the same figure, counted once.
+            if (figs[f].nodeName === "IMG" && figs[f].closest && figs[f].closest("figure")) continue;
+            fnum++;
+            var fc = figs[f].querySelector ? figs[f].querySelector("figcaption") : null;
+            out.push({
+                id: ensureId(figs[f], "rte-fig-"),
+                type: "figure",
+                label: (fc && fc.textContent.trim()) || (String(config.crossRefFigureLabel) + " " + fnum),
+                number: String(fnum)
+            });
+        }
+        return out;
+    };
+
+    function collectClauses(ol, path, out) {
+        var idx = 0;
+        for (var i = 0; i < ol.children.length; i++) {
+            var li = ol.children[i];
+            if (li.nodeName !== "LI") continue;
+            idx++;
+            var here = path.concat([idx]);
+            var first = firstLineText(li);
+            out.push({
+                id: ensureId(li, "rte-cl-"),
+                type: "clause",
+                label: first || ("clause " + here.join(".")),
+                number: here.join(".")
+            });
+            for (var c = 0; c < li.children.length; c++) {
+                if (li.children[c].nodeName === "OL") collectClauses(li.children[c], here, out);
+            }
+        }
+    }
+
+    // The clause's own text, excluding any nested sub-list.
+    function firstLineText(li) {
+        var s = "";
+        for (var i = 0; i < li.childNodes.length; i++) {
+            var n = li.childNodes[i];
+            if (n.nodeType === 1 && (n.nodeName === "OL" || n.nodeName === "UL")) break;
+            s += n.textContent || "";
+        }
+        return s.trim().replace(/\s+/g, " ").slice(0, 80);
+    }
+
+    function noteText(note) {
+        var clone = note.cloneNode(true);
+        var backs = clone.querySelectorAll ? clone.querySelectorAll("a.rte-fn-back") : [];
+        for (var i = 0; i < backs.length; i++) if (backs[i].parentNode) backs[i].parentNode.removeChild(backs[i]);
+        return (clone.textContent || "").replace(/↩/g, "").trim().slice(0, 80);
+    }
+
+    function resolveTarget(id) {
+        if (!id) return null;
+        var list = obj.Targets();
+        for (var i = 0; i < list.length; i++) {
+            if (list[i].id !== id) continue;
+            var editable = getEditable();
+            var el = editable ? editable.querySelector("#" + id.replace(/["\\\]\[]/g, "\\$&")) : null;
+            if (!el) return null;
+            var t = list[i];
+            t.el = el;
+            return t;
+        }
+        return null;
+    }
+
+    // ---- insert ----------------------------------------------------------
+
+    // format: "text" | "number" | "page" | "position" | "label"
+    obj.Insert = function (targetId, format) {
+        var doc = getDoc();
+        var editable = getEditable();
+        if (!doc || !editable) return false;
+        var target = resolveTarget(targetId);
+        if (!target) return false;
+        format = String(format || "text");
+
+        var chip = doc.createElement("span");
+        chip.className = "rte-xref";
+        chip.setAttribute("data-xref-target", targetId);
+        chip.setAttribute("data-xref-format", format);
+        chip.setAttribute("contenteditable", "false");
+        chip.textContent = displayFor(target, format, chip);
+
+        var placed = false;
+        try {
+            if (typeof editor.insertElement === "function") { editor.insertElement(chip); placed = true; }
+        } catch (e) {}
+        if (!placed) {
+            try {
+                var sel = editor.getSelection();
+                if (sel && sel.rangeCount) {
+                    var r = sel.getRangeAt(0);
+                    r.collapse(false);
+                    r.insertNode(chip);
+                    r.setStartAfter(chip); r.collapse(true);
+                    sel.removeAllRanges(); sel.addRange(r);
+                    placed = true;
+                }
+            } catch (e) {}
+        }
+        if (!placed) editable.appendChild(chip);
+        // Recompute now that the chip is actually IN the document. The text set
+        // above was computed while it was still detached, and the "position"
+        // format compares the chip against its target — on a detached node that
+        // comparison is meaningless, so a reference to something earlier in the
+        // document displayed "below" until the next refresh happened to fix it.
+        refresh();
+        fireChange();
+        return targetId;
+    };
+
+    function displayFor(target, format, chip) {
+        if (!target) return String(config.crossRefMissingText);
+        switch (format) {
+            case "number":
+                if (target.number) return target.number;
+                return target.label;                       // headings have no number
+            case "label":
+                // "Table 2" / "Figure 3" / "clause 3.2" style
+                if (target.type === "table") return String(config.crossRefTableLabel) + " " + target.number;
+                if (target.type === "figure") return String(config.crossRefFigureLabel) + " " + target.number;
+                if (target.type === "clause") return "clause " + target.number;
+                if (target.type === "footnote") return "footnote " + target.number;
+                return target.label;
+            case "page":
+                var p = null;
+                try {
+                    if (typeof editor.getPageOfElement === "function") p = editor.getPageOfElement(target.el);
+                } catch (e) { p = null; }
+                // No page view means no honest page number; keep whatever was
+                // last computed rather than inventing or blanking one.
+                if (p) return String(p);
+                var prev = chip ? chip.getAttribute("data-xref-last-page") : null;
+                return prev || "?";
+            case "position":
+                return positionOf(target.el, chip);
+            default:
+                return target.label;
+        }
+    }
+
+    // "above" / "below" relative to the reference itself.
+    function positionOf(targetEl, chip) {
+        if (!targetEl || !chip) return "above";
+        try {
+            var pos = chip.compareDocumentPosition(targetEl);
+            if (pos & Node.DOCUMENT_POSITION_PRECEDING) return "above";
+            if (pos & Node.DOCUMENT_POSITION_FOLLOWING) return "below";
+        } catch (e) {}
+        return "above";
+    }
+
+    // ---- refresh ---------------------------------------------------------
+
+    function chips() {
+        var editable = getEditable();
+        if (!editable) return [];
+        return Array.prototype.slice.call(editable.querySelectorAll("span.rte-xref[data-xref-target]"));
+    }
+
+    function refresh() {
+        var list = chips();
+        if (!list.length) return [];
+        // Build the target index once rather than per chip.
+        var targets = obj.Targets();
+        var byId = {};
+        for (var t = 0; t < targets.length; t++) byId[targets[t].id] = targets[t];
+        var editable = getEditable();
+
+        var out = [];
+        for (var i = 0; i < list.length; i++) {
+            var chip = list[i];
+            var id = chip.getAttribute("data-xref-target");
+            var fmt = chip.getAttribute("data-xref-format") || "text";
+            var target = byId[id] || null;
+            if (target) {
+                target.el = editable.querySelector("#" + id.replace(/["\\\]\[]/g, "\\$&"));
+            }
+            var text = displayFor(target, fmt, chip);
+            if (chip.textContent !== text) chip.textContent = text;
+            if (target) {
+                chip.classList.remove("rte-xref-broken");
+                if (fmt === "page" && /^\d+$/.test(text)) chip.setAttribute("data-xref-last-page", text);
+            } else {
+                // Visible failure beats a plausible wrong number.
+                chip.classList.add("rte-xref-broken");
+            }
+            out.push({ target: id, format: fmt, text: text, resolved: !!target });
+        }
+        return out;
+    }
+
+    obj.List = function () {
+        var list = chips();
+        var out = [];
+        for (var i = 0; i < list.length; i++) {
+            out.push({
+                target: list[i].getAttribute("data-xref-target"),
+                format: list[i].getAttribute("data-xref-format") || "text",
+                text: list[i].textContent,
+                resolved: !list[i].classList.contains("rte-xref-broken")
+            });
+        }
+        return out;
+    };
+
+    function fireChange() {
+        try { if (typeof editor.updateDesign === "function") editor.updateDesign(); } catch (e) {}
+        try { if (typeof editor.fireChange === "function") editor.fireChange(); } catch (e) {}
+    }
+
+    // ---- styles ----------------------------------------------------------
+
+    function css() {
+        return (
+            "span.rte-xref{color:#1474ea;cursor:pointer;border-bottom:1px dotted #9dc2f5;" +
+            "user-select:none;}" +
+            "span.rte-xref:hover{border-bottom-style:solid;}" +
+            "span.rte-xref.rte-xref-broken{color:#c81e1e;background:rgba(200,30,30,.09);" +
+            "border-bottom:1px solid #e59b9b;border-radius:2px;padding:0 .15em;}"
+        );
+    }
+
+    function injectStyles(doc) {
+        if (!doc) return;
+        var existing = doc.getElementById("rte-xref-styles");
+        var text = css();
+        if (existing) {
+            if (existing.getAttribute("data-css") === text) return;
+            existing.parentNode && existing.parentNode.removeChild(existing);
+        }
+        var st = doc.createElement("style");
+        st.id = "rte-xref-styles";
+        st.setAttribute("data-css", text);
+        st.appendChild(doc.createTextNode(text));
+        (doc.head || doc.getElementsByTagName("head")[0] || doc.documentElement).appendChild(st);
+    }
+}