@richscripts/richtexteditor 2.14.1 → 2.16.0

package/index.d.ts

@@ -1057,6 +1057,19 @@ export interface RichTextEditorInstance {
    * editor-specific commands (`source`, `fullscreen`, `ai-ask`, …).
    */
   execCommand(command: RichTextEditorCommand, value?: unknown): unknown;
+  /** Record an undo checkpoint around a custom DOM edit. */
+  recordUndo(): void;
+  /** Set the selected ordered list's start (including zero). False outside a list. */
+  setListStart(start: number): boolean;
+  /** Continue from the nearest preceding sibling ordered list. False if unavailable. */
+  continueListNumbering(): boolean;
+  /** Toggle the selected table's caption. False outside a table. */
+  toggleTableCaption(): boolean;
+  /** Cancel pending uploads; late callbacks cannot change the document. */
+  cancelUploads(reason?: string): number;
+  getPendingUploadCount(): number;
+  /** Upload embedded data-image URLs through the configured handler. */
+  uploadEmbeddedImages(done?: (summary: { uploaded: number; failed: number; skipped: number; errors: string[] }) => void): void;
   /** Returns true when the command is enabled in the current selection context. */
   isCommandEnabled(command: RichTextEditorCommand): boolean;
   /** Returns true when the command's effect is currently active (e.g. selection is bold). */
@@ -1330,9 +1343,6 @@ export interface RichTextEditorInstance {
 
   toMarkdown?(): string;
   fromMarkdown?(markdown: string): unknown;
-  getMarkdown?(): string;
-  copyAsMarkdown?(): unknown;
-  downloadMarkdown?(filename?: string): unknown;
 
   // ---- Export ----
 
@@ -1342,10 +1352,6 @@ export interface RichTextEditorInstance {
   exportPdf?(options?: Record<string, unknown>): unknown;
   getDocxBlob?(options?: Record<string, unknown>): Blob | Promise<Blob>;
   exportToDocx?(filename?: string, options?: Record<string, unknown>): unknown;
-  exportToWord?(options?: RichTextEditorWordExportOptions): unknown;
-  downloadWord?(filename?: string, options?: RichTextEditorWordExportOptions): unknown;
-  getWordDocument?(options?: RichTextEditorWordExportOptions): string;
-  getEmailHTML?(options?: Record<string, unknown>): string;
 
   // ---- Formatting marks and inline code ----
 
@@ -1384,8 +1390,6 @@ export interface RichTextEditorInstance {
   announce?(text: string, options?: { assertive?: boolean }): unknown;
   /** Moves focus to the first toolbar button (the documented Escape hatch target). */
   focusToolbar?(): unknown;
-  applyAccessibilityMetadata?(): unknown;
-  applyDialogAccessibility?(dialog?: HTMLElement): unknown;
   ensureStyleSheetLive?(doc: Document, style: HTMLStyleElement, id: string, cssText: string): unknown;
 
   // ---- Toolbar / dialog building blocks ----
@@ -1402,49 +1406,6 @@ export interface RichTextEditorInstance {
 
   insertTableOfContents?(): unknown;
   toggleWatermark?(): unknown;
-  readAloud?(): unknown;
-  stopReadAloud?(): unknown;
-  showShortcuts?(): unknown;
-  openFindDialog?(): unknown;
-  openImportDialog?(): unknown;
-  importFile?(file: File, options?: RichTextEditorImportOptions): unknown;
-  htmlFromImportText?(text: string, filename?: string): string;
-  embedUrl?(url: string): unknown;
-  renderMath?(): unknown;
-  applyMathMarkup?(): unknown;
-  renderDiagrams?(): unknown;
-  getReadabilityStats?(): Record<string, unknown>;
-  countSyllables?(word: string): number;
-  getFootnotes?(): unknown[];
-  getCharCount?(): number;
-  getWordCount?(): number;
-  getRemainingChars?(): number;
-  isOverLimit?(): boolean;
-  getCommentsOnly?(): boolean;
-  setCommentsOnly?(on: boolean): unknown;
-  setFocusMode?(on: boolean): unknown;
-  toggleFocusMode?(): unknown;
-  isFocusMode?(): boolean;
-  setTypewriterMode?(on: boolean): unknown;
-  toggleTypewriterMode?(): unknown;
-  isTypewriterMode?(): boolean;
-  saveLocalDraft?(): unknown;
-  restoreLocalDraft?(): unknown;
-  hasLocalDraft?(): boolean;
-  getLocalDraft?(): unknown;
-  clearLocalDraft?(): unknown;
-  requestGhostText?(): unknown;
-  acceptGhostText?(): unknown;
-  dismissGhostText?(): unknown;
-  hasGhostText?(): boolean;
-  setGhostTextResolver?(resolver: (context: unknown) => unknown): unknown;
-  foldAtCaret?(): unknown;
-  toggleHeadingFold?(el?: HTMLElement): unknown;
-  unfoldAll?(): unknown;
-  findHighlight?(text: string): unknown;
-  getSelectedControl?(): HTMLElement | null;
-  getSelectedText?(): string;
-  getDocument?(): Document;
 
   // ---- Tables ----
 
@@ -1688,7 +1649,25 @@ export interface RichTextEditorInstance {
 // Constructor
 // =====================
 
+export type RichTextEditorUploadCallback = (url: string | null, error?: string) => void;
+export type RichTextEditorUploadHandle = void | (() => void) | { abort(): void };
+export type RichTextEditorUploadHandler = (
+  file: File,
+  callback: RichTextEditorUploadCallback,
+  index?: number,
+  files?: File[]
+) => RichTextEditorUploadHandle;
+
 export interface RichTextEditorConfig {
+  /** Custom uploader; return an abort handle if requests can be cancelled. */
+  file_upload_handler?: RichTextEditorUploadHandler;
+  /** Scan embedded images and upload through the handler; default false. */
+  automaticUploads?: boolean;
+  automaticUploadsDelay?: number;
+  /** Extra upload attempts after the first; default zero. */
+  uploadRetryCount?: number;
+  /** Initial retry delay in milliseconds; doubles on subsequent retries. */
+  uploadRetryDelay?: number;
   toolbar?: string | string[];
   height?: string | number;
   width?: string | number;
@@ -2067,6 +2046,15 @@ declare global {
   interface Window {
     RichTextEditor: RichTextEditorConstructor;
     RTE_DefaultConfig?: RichTextEditorConfig;
+    /**
+     * The editor's Trusted Types policy, "richtexteditor", for plugins that write HTML or a script URL to a sink.
+     * Under CSP `require-trusted-types-for 'script'` the results are TrustedHTML / TrustedScriptURL; without Trusted
+     * Types they are the input unchanged. Typed as string so they assign to innerHTML and src.
+     */
+    RTE_TrustedTypes?: {
+      html(value: string): string;
+      scriptURL(value: string): string;
+    };
   }
 }
 

package/integrations/initialization-scope.js

@@ -0,0 +1,27 @@
+// Private framework lifecycle helper. Never abort a caller's shared controller.
+function createInitializationScope(parentSignal) {
+    var controller = typeof AbortController === "function" ? new AbortController() : null;
+    var disposed = false;
+    var forwardAbort = null;
+    function complete() {
+        if (parentSignal && forwardAbort) parentSignal.removeEventListener("abort", forwardAbort);
+        forwardAbort = null;
+        parentSignal = null;
+    }
+    if (controller && parentSignal) {
+        forwardAbort = function () { controller.abort(parentSignal.reason); };
+        if (parentSignal.aborted) forwardAbort();
+        else parentSignal.addEventListener("abort", forwardAbort, { once: true });
+    }
+    return {
+        signal: controller ? controller.signal : parentSignal,
+        complete: complete,
+        dispose: function () {
+            if (disposed) return;
+            disposed = true;
+            complete();
+            if (controller) controller.abort();
+        }
+    };
+}
+module.exports = { createInitializationScope: createInitializationScope };

package/integrations/native-mount.js

@@ -0,0 +1,30 @@
+// Native inputs are converted into a sibling editor by the core. Frameworks
+// remove their input, not that sibling; retain ownership of only the generated
+// chrome and restore the input's original visibility during teardown.
+function captureNativeMount(host) {
+    if (!host || !/^(INPUT|TEXTAREA)$/i.test(host.tagName || host.nodeName || "")) return null;
+    var previous = host.__rteIntegrationNativeMount;
+    var ownership = { host: host, parent: host.parentNode, display: previous ? previous.display : host.style && host.style.display,
+        hidden: previous ? previous.hidden : host.__rteHidden,
+        hadHidden: previous ? previous.hadHidden : Object.prototype.hasOwnProperty.call(host, "__rteHidden") };
+    host.__rteIntegrationNativeMount = ownership;
+    return ownership;
+}
+function releaseNativeMount(editor, ownership) {
+    if (!ownership) return;
+    var host = ownership.host, parent = ownership.parent, root = editor && editor.container;
+    if (root && root !== host && parent) {
+        while (root && root.parentNode !== parent) root = root.parentNode;
+        // Never remove the framework-owned input or a wrapper containing it.
+        var cursor = host, containsHost = false;
+        while (cursor) { if (cursor === root) { containsHost = true; break; } cursor = cursor.parentNode; }
+        if (root && root !== host && !containsHost && root.parentNode === parent) parent.removeChild(root);
+    }
+    if (host.__rteIntegrationNativeMount === ownership) {
+        if (host.style) host.style.display = ownership.display || "";
+        if (ownership.hadHidden) host.__rteHidden = ownership.hidden;
+        else delete host.__rteHidden;
+        delete host.__rteIntegrationNativeMount;
+    }
+}
+module.exports = { captureNativeMount: captureNativeMount, releaseNativeMount: releaseNativeMount };

package/integrations/shared.d.ts

@@ -9,6 +9,7 @@ import type {
   RichTextEditorInstance,
   RichTextEditorLinkAuditOptions,
   RichTextEditorLinkAuditResult,
+  RichTextEditorPageSetup,
   RichTextEditorStructuredDocument,
   RichTextEditorStructuredNode,
   RichTextEditorStructuredInput,
@@ -19,10 +20,24 @@ import type {
   RichTextEditorValueFormat
 } from "../index";
 
+/** An instance after the structured-content bridge has been installed. */
+export interface RichTextEditorBridgedInstance extends RichTextEditorInstance {
+  getJSON(): RichTextEditorStructuredDocument;
+  setJSON(value: RichTextEditorStructuredInput): this;
+}
+
+export interface RichTextEditorChangeCoalescer {
+  (): void;
+  flush(): void;
+  cancel(): void;
+}
+
+export function createChangeCoalescer(emit: () => void, delay?: number): RichTextEditorChangeCoalescer;
+
 export function createEditor(
   element: string | Element,
   config?: Record<string, unknown>
-): RichTextEditorInstance;
+): RichTextEditorBridgedInstance;
 
 export function auditAccessibility(
   value: RichTextEditorStructuredInput
@@ -67,6 +82,13 @@ export function getDocumentMetrics(
   }
 ): RichTextEditorDocumentMetrics;
 
+export function getDocumentPageSetup(value: RichTextEditorStructuredInput): RichTextEditorPageSetup | null;
+
+export function setDocumentPageSetup(
+  value: RichTextEditorStructuredInput,
+  pageSetup: RichTextEditorPageSetup | null
+): RichTextEditorStructuredDocument;
+
 export function getMarkdownShortcutAction(
   value: string | null | undefined
 ): {

package/integrations/shared.js

@@ -1,4 +1,5 @@
-var pendingLoadsByBasePath = {};
+var pendingLoadsByBasePath = Object.create(null);
+var failedLoadsByBasePath = Object.create(null);
 
 var INLINE_CONTAINER_TAGS = {
     a: true,
@@ -1789,7 +1790,7 @@ function parseBlockNode(node) {
         }
         var orderedListAttrs = {};
         if (startValue) {
-            orderedListAttrs.start = parseInt(startValue, 10) || 1;
+            orderedListAttrs.start = (isFinite(parseInt(startValue, 10)) ? parseInt(startValue, 10) : 1);
         }
         if (orderedListType) {
             orderedListAttrs.orderedListType = orderedListType;
@@ -2529,7 +2530,7 @@ function escapeHtml(value) {
 }
 
 function escapeAttribute(value) {
-    return escapeHtml(value).replace(/"/g, """);
+    return escapeHtml(value === undefined || value === null ? "" : String(value)).replace(/"/g, """);
 }
 
 function buildAttributeString(attrs) {
@@ -2782,7 +2783,7 @@ function serializeNode(node, inlineMode) {
 
     if (node.type === "orderedList") {
         var listAttrs = {};
-        if (node.attrs && node.attrs.start) {
+        if (node.attrs && node.attrs.start !== undefined && node.attrs.start !== null) {
             listAttrs.start = node.attrs.start;
         }
         if (node.attrs) {
@@ -3183,8 +3184,8 @@ function validateNode(node, path, mode, issues) {
 
     if (node.type === "bulletList" || node.type === "orderedList") {
         if (node.type === "orderedList" && node.attrs && node.attrs.start !== undefined) {
-            if (typeof node.attrs.start !== "number" || node.attrs.start < 1) {
-                issues.push(createValidationIssue(path + ".attrs.start", "Ordered lists require a positive numeric start value."));
+            if (typeof node.attrs.start !== "number" || !isFinite(node.attrs.start) || Math.floor(node.attrs.start) !== node.attrs.start || Math.abs(node.attrs.start) > 9007199254740991) {
+                issues.push(createValidationIssue(path + ".attrs.start", "Ordered lists require a finite safe integer start value."));
             }
         }
         if (node.type === "orderedList" && node.attrs && node.attrs.orderedListType !== undefined) {
@@ -3796,6 +3797,16 @@ function repairAccessibilityIssue(value, issue, options) {
         return workingDocument;
     }
 
+    // A queued repair is not permission to overwrite newer author edits. The
+    // same problem must still exist at this node in the current document.
+    var stillPresent = auditAccessibility(workingDocument).issues.some(function (currentIssue) {
+        return currentIssue.code === normalizedIssue.code &&
+            resolveAccessibilityIssueNodePath(currentIssue) === nodePath;
+    });
+    if (!stillPresent) {
+        return workingDocument;
+    }
+
     if (normalizedIssue.code === "image-missing-alt") {
         var altText = normalizePlainText(normalizedOptions.altText);
         if (!altText) {
@@ -3919,12 +3930,12 @@ function getMarkdownListMatch(line) {
         };
     }
 
-    var orderedMatch = /^(\s*)(\d+)\.\s+(.*)$/.exec(line);
+    var orderedMatch = /^(\s*)(\d{1,9})\.\s+(.*)$/.exec(line);
     if (orderedMatch) {
         return {
             indent: orderedMatch[1].length,
             ordered: true,
-            start: parseInt(orderedMatch[2], 10) || 1,
+            start: parseInt(orderedMatch[2], 10),
             text: orderedMatch[3],
             marker: orderedMatch[2] + ".",
             contentIndent: orderedMatch[1].length + orderedMatch[2].length + 2,
@@ -4914,8 +4925,13 @@ function serializeMarkdownBlocks(nodes) {
 
         if (node.type === "bulletList" || node.type === "orderedList") {
             var listParts = [];
-            var start = node.type === "orderedList" && node.attrs && node.attrs.start ? parseInt(node.attrs.start, 10) || 1 : 1;
+            var start = node.type === "orderedList" && node.attrs && node.attrs.start !== undefined ? parseInt(node.attrs.start, 10) : 1;
+            if (!isFinite(start)) start = 1;
             var listItems = node.content || [];
+            if (node.type === "orderedList" && (start < 0 || start + Math.max(0, listItems.length - 1) > 999999999)) {
+                parts.push(serializeNode(node, false));
+                continue;
+            }
             for (var itemIndex = 0; itemIndex < listItems.length; itemIndex++) {
                 var prefix = node.type === "orderedList" ? (start + itemIndex) + ". " : "- ";
                 listParts.push(serializeMarkdownListItem(listItems[itemIndex].content || [], prefix));
@@ -5060,15 +5076,28 @@ function installStructuredContentBridge() {
 }
 
 function ensureStylesheet(href) {
-    if (document.querySelector('link[data-rte-style="' + href + '"]')) {
-        return;
-    }
-
-    var link = document.createElement("link");
-    link.rel = "stylesheet";
-    link.href = href;
-    link.setAttribute("data-rte-style", href);
-    document.head.appendChild(link);
+    return new Promise(function (resolve, reject) {
+        var existing = document.querySelector('link[data-rte-style="' + href + '"]');
+        if (existing && (existing.getAttribute("data-rte-loaded") === "true" || existing.sheet)) {
+            resolve();
+            return;
+        }
+        var link = existing || document.createElement("link");
+        link.addEventListener("load", function () {
+            link.setAttribute("data-rte-loaded", "true");
+            resolve();
+        }, { once: true });
+        link.addEventListener("error", function () {
+            if (link.parentNode) link.parentNode.removeChild(link);
+            reject(new Error("Failed to load " + href));
+        }, { once: true });
+        if (!existing) {
+            link.rel = "stylesheet";
+            link.href = href;
+            link.setAttribute("data-rte-style", href);
+            document.head.appendChild(link);
+        }
+    });
 }
 
 function loadScript(src) {
@@ -5098,6 +5127,9 @@ function loadScript(src) {
             resolve(script);
         };
         script.onerror = function () {
+            // A failed tag will never fire load again. Let an explicit retry
+            // create a fresh request, without removing successfully loaded core.
+            if (script.parentNode) script.parentNode.removeChild(script);
             reject(new Error("Failed to load " + src));
         };
 
@@ -5114,18 +5146,32 @@ function loadRichTextEditorAssets(options) {
 
     var basePath = trimTrailingSlash(options && options.basePath ? options.basePath : "/richtexteditor");
 
-    if (window.RichTextEditor) {
+    // Core becomes global before plugins finish. All concurrent mounts must
+    // await the same complete attempt rather than treating core as readiness.
+    if (pendingLoadsByBasePath[basePath]) {
+        return pendingLoadsByBasePath[basePath];
+    }
+
+    if (window.RichTextEditor && !failedLoadsByBasePath[basePath]) {
         return Promise.resolve(installStructuredContentBridge());
     }
 
     if (!pendingLoadsByBasePath[basePath]) {
-        ensureStylesheet(basePath + "/rte_theme_default.css");
-        pendingLoadsByBasePath[basePath] = loadScript(basePath + "/rte.js")
+        var themeReady = ensureStylesheet(basePath + "/rte_theme_default.css");
+        var scriptsReady = loadScript(basePath + "/rte.js")
             .then(function () {
+                if (window.RTE_DefaultConfig) window.RTE_DefaultConfig.url_base = basePath;
                 return loadScript(basePath + "/plugins/all_plugins.js");
-            })
+            });
+        pendingLoadsByBasePath[basePath] = Promise.all([themeReady, scriptsReady])
             .then(function () {
+                delete failedLoadsByBasePath[basePath];
                 return installStructuredContentBridge();
+            })
+            .catch(function (error) {
+                delete pendingLoadsByBasePath[basePath];
+                failedLoadsByBasePath[basePath] = true;
+                throw error;
             });
     }
 

package/package.json

@@ -3,13 +3,15 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "2.14.1",
+  "version": "2.16.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": {
     "rte-migration-report": "./migration/cli.js"
   },
   "scripts": {
+    "build:angular": "node scripts/build-angular.mjs",
+    "prepack": "node scripts/build-angular.mjs",
     "test:server": "node tests/run-all.test.js",
     "test:admin": "node tests/run-all.test.js",
     "test": "node tests/run-all.test.js",
@@ -28,10 +30,12 @@
     },
     "./angular": {
       "types": "./angular/index.d.ts",
-      "default": "./angular/index.ts"
+      "default": "./angular/index.mjs"
     },
     "./react": {
       "types": "./react/index.d.ts",
+      "import": "./react/index.mjs",
+      "require": "./react/index.js",
       "default": "./react/index.js"
     },
     "./vue": {
@@ -66,7 +70,11 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "angular",
+    "angular/*.mjs",
+    "angular/*.d.ts",
+    "angular/package.json",
+    "angular/build-manifest.json",
+    "scripts/build-angular.mjs",
     "admin",
     "headless",
     "index.d.ts",
@@ -78,12 +86,26 @@
     "svelte",
     "vue"
   ],
+  "devDependencies": {
+    "@angular/common": "20.3.31",
+    "@angular/compiler": "20.3.31",
+    "@angular/compiler-cli": "20.3.31",
+    "@angular/core": "20.3.31",
+    "@angular/forms": "20.3.31",
+    "esbuild": "0.28.1",
+    "rxjs": "~7.8.2",
+    "typescript": "~5.9.3"
+  },
   "peerDependencies": {
+    "@angular/core": ">=20.3.0",
+    "@angular/forms": ">=20.3.0",
     "react": ">=18",
     "svelte": ">=3",
     "vue": ">=3"
   },
   "peerDependenciesMeta": {
+    "@angular/core": { "optional": true },
+    "@angular/forms": { "optional": true },
     "react": {
       "optional": true
     },