@rathkit/rte-core 0.1.0-alpha.4 → 0.2.0-beta.0

package/dist/policy.js

@@ -0,0 +1,40 @@
+export const DROPPED_ELEMENTS = new Set([
+    "script", "style", "link", "meta", "base", "object", "embed", "iframe", "frame", "frameset", "noscript", "template",
+    "head", "textarea", "input", "select", "option", "button", "canvas", "audio", "video", "applet", "xml",
+]);
+export const GROUPING_ELEMENTS = new Set([
+    "div", "section", "article", "header", "footer", "aside", "nav", "figure", "figcaption", "address", "main", "form",
+    "body", "html", "center", "details", "summary", "dd", "dt", "fieldset", "hgroup",
+]);
+export const DEFAULT_LINK_SCHEMES = ["http", "https", "mailto", "tel"];
+export const IMAGE_SCHEMES = ["http", "https"];
+export const DATA_IMAGE_SIGNATURES = [
+    ["image/png", "iVBORw0KGgo"], ["image/jpeg", "/9j/"], ["image/gif", "R0lGOD"], ["image/webp", "UklGR"], ["image/bmp", "Qk"],
+];
+export const CONTENT_PROFILES = {
+    strict: { pasteRelativeImages: false, linkSchemes: ["http", "https", "mailto"], styles: "semantic", maxDataImageLength: 0, maxDepth: 32, maxInputLength: 1_000_000 },
+    standard: { pasteRelativeImages: false, linkSchemes: DEFAULT_LINK_SCHEMES, styles: "allowlist", maxDataImageLength: 12_000_000, maxDepth: 100, maxInputLength: 50_000_000 },
+    loose: { pasteRelativeImages: false, linkSchemes: ["http", "https", "mailto", "tel", "sms", "ftp", "ftps"], styles: "allowlist", maxDataImageLength: 25_000_000, maxDepth: 200, maxInputLength: 200_000_000 },
+};
+export function contentPolicy(options = {}, complain = () => undefined) {
+    const { profile = "standard", ...rest } = options;
+    if (!Object.hasOwn(CONTENT_PROFILES, profile))
+        complain(`content.profile "${String(profile)}" is not a profile: using standard (strict, standard or loose).`);
+    const base = Object.hasOwn(CONTENT_PROFILES, profile) ? CONTENT_PROFILES[profile] : CONTENT_PROFILES.standard;
+    const given = {};
+    for (const [key, value] of Object.entries(rest)) {
+        if (value === undefined)
+            continue;
+        const ok = key === "linkSchemes" ? Array.isArray(value) && value.every((v) => typeof v === "string" && /^[a-z][a-z0-9+.-]*$/i.test(v))
+            : key === "styles" ? value === "semantic" || value === "allowlist"
+                : key === "pasteRelativeImages" ? typeof value === "boolean"
+                    : key === "maxDepth" ? Number.isInteger(value) && value >= 1
+                        : (key === "maxInputLength" || key === "maxDataImageLength") ? Number.isInteger(value) && value >= 0
+                            : false;
+        if (ok)
+            given[key] = value;
+        else
+            complain(`content.${key} cannot be ${JSON.stringify(value)}: using the ${profile in CONTENT_PROFILES ? profile : "standard"} profile's value.`);
+    }
+    return { ...base, ...given };
+}

package/dist/standard/index.d.ts

@@ -25,4 +25,3 @@ export interface StandardOptions extends Omit<EditorOptions, "plugins">, Standar
 /** The standard plugins, for hosts that build their own editor but want the usual parts. */
 export declare function standardPlugins(options?: StandardPluginOptions): Plugin[];
 export declare function createEditor(options: StandardOptions): Editor;
-export { Editor, type EditorOptions };

package/dist/standard/index.js

@@ -31,4 +31,3 @@ export function createEditor(options) {
     void [_lists, _tables, _find, _autoformat, _footnotes, _plugins, _u, _m, _f, _r];
     return new Editor({ ...editorOptions, plugins: standardPlugins(options) });
 }
-export { Editor };

package/dist/stats.js

@@ -4,7 +4,7 @@ import { selectedText } from "./edit.js";
 const WORD = /[\p{L}\p{M}\p{N}]+(?:['’\-‑][\p{L}\p{M}\p{N}]+)*/gu;
 export function countText(text) {
     const clean = text.replace(//g, "").replace(/\n/g, " ");
-    return { words: (clean.match(WORD) ?? []).length, characters: [...clean.replace(/\s+$/g, "").replace(/^\s+/g, "")].length };
+    return { words: (clean.match(WORD) ?? []).length, characters: [...clean.trim()].length };
 }
 export function countDocument(doc) {
     let words = 0;

package/dist/svg/svg.js

@@ -44,7 +44,15 @@ const decodeXml = (value) => value.replace(ENTITY, (_, dec, hex, name) => {
 function parseXml(source, limits) {
     if (/<!ENTITY|<!ATTLIST|<!NOTATION/i.test(source) || /<!\[CDATA\[/i.test(source))
         return undefined;
-    const stripped = source.replace(/^/, "").replace(/<\?xml[^>]*\?>/i, "").replace(/<!DOCTYPE[^>[]*(?:\[[^\]]*\])?[^>]*>/gi, "").replace(/<!--[\s\S]*?-->/g, "");
+    let stripped = source.replace(/^/, "").replace(/<\?xml[^>]*\?>/i, "").replace(/<!DOCTYPE[^>[]*(?:\[[^\]]*\])?[^>]*>/gi, "");
+    for (let pass = 0; pass < 4; pass++) {
+        const next = stripped.replace(/<!--[\s\S]*?-->/g, "");
+        if (next === stripped)
+            break;
+        stripped = next;
+    }
+    if (stripped.includes("<!--"))
+        return undefined;
     const stack = [];
     let root;
     let count = 0;

package/dist/tables/cells.d.ts

@@ -1,6 +1,6 @@
 import type { ViewHost } from "../plugin.ts";
 /** The attribute on a cell that a selection covers, for styling. */
-export declare const SELECTED_CELL = "data-rk-cell-selected";
+export declare const SELECTED_CELL = "data-rte-cell-selected";
 /**
  * Marks the cells of the rectangle a selection runs across (when it starts and ends in different cells of one table). The marks are
  * attributes on the drawn cells, not part of the model, and they are put on again after every change.

package/dist/tables/cells.js

@@ -1,6 +1,6 @@
 import { pathKey } from "../path.js";
 import { inRow, locateCell, selectedCells } from "../tablegrid.js";
-export const SELECTED_CELL = "data-rk-cell-selected";
+export const SELECTED_CELL = "data-rte-cell-selected";
 const GRAB = 5;
 const MIN_WIDTH = 24;
 const MIN_HEIGHT = 16;
@@ -96,7 +96,7 @@ export function installColumnResize(host) {
             const rowBox = row.getBoundingClientRect();
             const rowTable = rowCell.closest("table")?.getBoundingClientRect() ?? rowBox;
             const rowLine = document.createElement("div");
-            rowLine.setAttribute("data-rk-resize-line", "");
+            rowLine.setAttribute("data-rte-resize-line", "");
             rowLine.style.cssText = `position:fixed;z-index:2147483647;pointer-events:none;height:2px;background:#17408b;top:${rowBox.bottom - 1}px;left:${rowTable.left}px;width:${rowTable.width}px`;
             document.body.appendChild(rowLine);
             rowDrag = { path: rowPath, startY: event.clientY, startHeight: rowBox.height, top: rowBox.top, line: rowLine, height: rowBox.height };
@@ -106,7 +106,7 @@ export function installColumnResize(host) {
         const box = cell.getBoundingClientRect();
         const table = cell.closest("table")?.getBoundingClientRect() ?? box;
         const line = document.createElement("div");
-        line.setAttribute("data-rk-resize-line", "");
+        line.setAttribute("data-rte-resize-line", "");
         line.style.cssText = `position:fixed;z-index:2147483647;pointer-events:none;width:2px;background:#17408b;left:${box.right - 1}px;top:${table.top}px;height:${table.height}px`;
         document.body.appendChild(line);
         drag = { cell, path, startX: event.clientX, startWidth: box.width, line, width: box.width };

package/dist/tables/grips.js

@@ -82,7 +82,7 @@ export class TableGrips {
     }
     make(kind) {
         const el = document.createElement("div");
-        el.setAttribute("data-rk-grip", kind);
+        el.setAttribute("data-rte-grip", kind);
         el.setAttribute("role", "presentation");
         const cursor = kind === "row" ? "ns-resize" : kind === "column" ? "ew-resize" : kind === "width" ? "col-resize" : "row-resize";
         el.style.cssText = `position:fixed;z-index:2147483646;width:${SIZE}px;height:${SIZE}px;box-sizing:border-box;background:${COLOR};border:2px solid #fff;border-radius:${kind === "row" || kind === "column" ? "4px" : "50%"};cursor:${cursor};touch-action:none;opacity:0.9`;
@@ -120,7 +120,7 @@ export class TableGrips {
         const t = table.getBoundingClientRect();
         const horizontal = kind === "column" || kind === "width";
         const line = document.createElement("div");
-        line.setAttribute("data-rk-resize-line", "");
+        line.setAttribute("data-rte-resize-line", "");
         line.style.cssText = `position:fixed;z-index:2147483645;pointer-events:none;background:${COLOR};${horizontal ? `width:2px;top:${t.top}px;height:${t.height}px` : `height:2px;left:${t.left}px;width:${t.width}px`}`;
         document.body.appendChild(line);
         this.guide = line;

package/dist/warning.d.ts

@@ -0,0 +1,16 @@
+/** Why a warning was made. The codes are stable: a host can switch on them. */
+export declare const WARNING_CODES: readonly ["plugin-failed", "plugin-rejected", "plugin-message", "key-conflict", "content-too-long", "content-unreadable", "copy-failed", "upload-failed", "bad-option", "missing-label", "late-options", "listener-failed"];
+/** One of the codes in `WARNING_CODES`. */
+export type WarningCode = (typeof WARNING_CODES)[number];
+/** A problem the editor carried on from, reported to `onWarning`. Never thrown. */
+export interface Warning {
+    readonly code: WarningCode;
+    /** For a person: what happened and what was done about it. */
+    readonly message: string;
+    /** The plugin it concerns, when there is one. */
+    readonly plugin?: string;
+    /** The error that was caught, when one was. */
+    readonly error?: unknown;
+}
+/** What an error says, whatever was thrown. */
+export declare const describeError: (error: unknown) => string;

package/dist/warning.js

@@ -0,0 +1,5 @@
+export const WARNING_CODES = [
+    "plugin-failed", "plugin-rejected", "plugin-message", "key-conflict", "content-too-long", "content-unreadable",
+    "copy-failed", "upload-failed", "bad-option", "missing-label", "late-options", "listener-failed",
+];
+export const describeError = (error) => (error instanceof Error ? error.message : String(error));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathkit/rte-core",
-  "version": "0.1.0-alpha.4",
+  "version": "0.2.0-beta.0",
   "description": "Document model, transforms, commands, view layer and plugin API for Rathkit RTE.",
   "keywords": [
     "rich-text",