@openleaf-editor/core 0.1.0-beta.1 → 0.1.0-beta.2

package/dist/tables.js

@@ -35,10 +35,81 @@
  * is what tells a screen reader which cells a header governs. Dropping it turns
  * a navigable table into a grid of unrelated values.
  */
+import { applyStyleAttribute, parseDeclarations, safeColor, serializeDeclarations, } from './css.js';
+import { isSerializing, scrub, serializationTarget } from './preserve.js';
 /** Presentational attributes legacy CMS content puts on `<table>`. */
 const TABLE_LEGACY_ATTRS = ['border', 'cellpadding', 'cellspacing', 'width', 'align', 'summary', 'class'];
 /** Attributes legacy content puts on cells, plus the accessibility-critical ones. */
 const CELL_LEGACY_ATTRS = ['align', 'valign', 'width', 'height', 'class', 'scope', 'headers', 'abbr'];
+const ROW_ATTRS = ['class', 'align', 'valign'];
+/**
+ * Style properties the table schema models. Kept here rather than in
+ * `MODELLED_PROPERTIES` because those drive span-unwrapping; a span with
+ * `padding` is still an opaque atom, a cell with `padding` is a cell.
+ */
+const TABLE_STYLE_PROPS = ['background-color', 'width', 'height'];
+const ROW_STYLE_PROPS = ['background-color', 'height'];
+const CELL_STYLE_PROPS = ['background-color', 'padding'];
+const LENGTH = /^-?\d+(?:\.\d+)?(?:px|em|rem|%|pt|ex|ch)?$/i;
+const VALIGN = new Set(['top', 'middle', 'bottom', 'baseline']);
+function safeLength(value) {
+    const candidate = value.trim();
+    return LENGTH.test(candidate) ? candidate : null;
+}
+function safePadding(value) {
+    const parts = value.trim().split(/\s+/);
+    if (parts.length < 1 || parts.length > 4)
+        return null;
+    const safe = parts.map(safeLength);
+    return safe.every((part) => part !== null) ? safe.join(' ') : null;
+}
+function safeVAlign(value) {
+    if (!value)
+        return null;
+    const candidate = value.trim().toLowerCase();
+    return VALIGN.has(candidate) ? candidate : null;
+}
+/**
+ * The one validator for a table style declaration, on the way in or out.
+ *
+ * Exported because the property dialogs in `@openleaf-editor/plugins-table`
+ * write node attributes directly, which does not go through any parse rule. A
+ * dialog with its own idea of an acceptable padding would drift from this one,
+ * and `padding: 0;position:fixed;inset:0` is what that drift looks like: the
+ * value becomes two more declarations when the style attribute is serialized.
+ *
+ * Returns null for a property this schema does not model, so an unrecognised
+ * name is dropped rather than trusted.
+ */
+export function safeTableStyleValue(property, value) {
+    if (!value)
+        return null;
+    if (property === 'background-color')
+        return safeColor(value);
+    if (property === 'padding')
+        return safePadding(value);
+    if (property === 'width' || property === 'height')
+        return safeLength(value);
+    return null;
+}
+function safeStyleValue(property, value) {
+    return safeTableStyleValue(property, value);
+}
+function readStyle(el, properties) {
+    const declarations = parseDeclarations(el.getAttribute('style'));
+    const out = new Map();
+    for (const name of properties) {
+        const safe = safeStyleValue(name, declarations.get(name));
+        if (safe)
+            out.set(name, safe);
+    }
+    if (!out.has('background-color')) {
+        const bg = safeColor(el.getAttribute('bgcolor'));
+        if (bg)
+            out.set('background-color', bg);
+    }
+    return serializeDeclarations(out);
+}
 function readAttrs(el, names) {
     const out = {};
     for (const name of names)
@@ -76,15 +147,34 @@ const cellAttrs = {
     rowspan: { default: 1 },
     colwidth: { default: null },
     ...legacyDefaults(CELL_LEGACY_ATTRS),
+    style: { default: null },
 };
 function cellGetAttrs(dom) {
     const el = dom;
-    return {
+    const attrs = {
         colspan: Number.parseInt(el.getAttribute('colspan') ?? '1', 10) || 1,
         rowspan: Number.parseInt(el.getAttribute('rowspan') ?? '1', 10) || 1,
         colwidth: readColwidth(el),
         ...readAttrs(el, CELL_LEGACY_ATTRS),
+        style: readStyle(el, CELL_STYLE_PROPS),
     };
+    // Fold CSS vertical-align into the HTML attribute the commands already edit,
+    // so an inherited `style="vertical-align:middle"` is not a second, uneditable
+    // spelling of the same fact.
+    if (!attrs['valign']) {
+        const fromStyle = safeVAlign(parseDeclarations(el.getAttribute('style')).get('vertical-align'));
+        if (fromStyle)
+            attrs['valign'] = fromStyle;
+    }
+    return attrs;
+}
+function styledElement(tag, attrs, style) {
+    const el = serializationTarget().createElement(tag);
+    for (const [name, value] of Object.entries(attrs))
+        el.setAttribute(name, value);
+    if (style)
+        applyStyleAttribute(el, style);
+    return { dom: el, contentDOM: el };
 }
 function cellToDOM(tag) {
     return (node) => {
@@ -98,17 +188,99 @@ function cellToDOM(tag) {
         const colwidth = node.attrs['colwidth'];
         if (colwidth)
             attrs['data-colwidth'] = colwidth.join(',');
+        const style = node.attrs['style'];
+        if (style)
+            return styledElement(tag, attrs, style);
         return [tag, attrs, 0];
     };
 }
+/**
+ * `<caption>` and `<colgroup>`/`<col>`: preserved as markup on the table node.
+ *
+ * These are the two parts of a table that are neither rows nor cells, and until
+ * now both were discarded on parse. For a caption that is not a cosmetic loss:
+ * a caption is a table's accessible name, so opening and saving an inherited
+ * document silently stripped the one element telling a screen-reader user what
+ * the table is. Column widths in a `<colgroup>` went the same way, taking the
+ * page's layout with them.
+ *
+ * They are attributes rather than child nodes, which is the compromise and is
+ * worth being precise about. The natural model is a `caption` node as the
+ * table's first child. It cannot work today: `prosemirror-tables` computes its
+ * cell map with `height = table.childCount` and reads `table.child(row)` as a
+ * row, so any non-row child shifts every coordinate the library derives, and
+ * cell selection, column resizing and the row/column commands all index into
+ * the wrong place. Storing markup on an attribute keeps the node's children
+ * exactly what that library requires while making the round-trip lossless.
+ *
+ * The cost is that the caption is not editable in place -- it renders, it
+ * survives, it cannot be typed into. That is a real limitation and it is the
+ * same bargain the preservation layer already strikes everywhere else: content
+ * kept intact and inert beats content silently deleted. Editing it needs the
+ * upstream indexing fix, at which point this becomes a node and the attribute
+ * migrates.
+ *
+ * Scrubbed on the way in with the preservation layer's own scrubber, so a
+ * `<caption onclick="...">` cannot ride in on a code path whose entire promise
+ * is to hand markup back unmodified.
+ */
+const FURNITURE_TAGS = new Set(['caption', 'colgroup', 'col']);
+/** Serialized direct children of `el` matching `tags`, in document order. */
+function readFurniture(el, tags) {
+    let html = '';
+    for (const child of Array.from(el.children)) {
+        if (!tags.includes(child.nodeName.toLowerCase()))
+            continue;
+        html += scrub(child);
+        // HTML permits exactly one caption; a second is somebody else's bug and
+        // concatenating it would render two. Take the first and stop.
+        if (child.nodeName.toLowerCase() === 'caption')
+            break;
+    }
+    return html || null;
+}
+/**
+ * Rebuild stored furniture markup and append it to the table being built.
+ *
+ * `<template>` is the parsing context because a bare `<caption>` or `<col>` is
+ * illegal inside a `<div>` and would be silently discarded there -- the same
+ * reason the preservation layer uses one.
+ */
+function appendFurniture(table, html, doc, inert) {
+    const tpl = doc.createElement('template');
+    tpl.innerHTML = html;
+    for (const child of Array.from(tpl.content.children)) {
+        if (!FURNITURE_TAGS.has(child.nodeName.toLowerCase()))
+            continue;
+        // Editor only. A caption sits inside the editable area but outside the
+        // node's contentDOM, so without this a caret can enter text ProseMirror
+        // will discard on its next redraw.
+        if (inert)
+            child.setAttribute('contenteditable', 'false');
+        table.appendChild(child);
+    }
+}
 export const table = {
     content: 'table_row+',
     tableRole: 'table',
     isolating: true,
     group: 'block',
-    attrs: legacyDefaults(TABLE_LEGACY_ATTRS),
+    attrs: {
+        ...legacyDefaults(TABLE_LEGACY_ATTRS),
+        caption: { default: null },
+        colgroup: { default: null },
+        style: { default: null },
+    },
     parseDOM: [
-        { tag: 'table', getAttrs: (dom) => readAttrs(dom, TABLE_LEGACY_ATTRS) },
+        {
+            tag: 'table',
+            getAttrs: (dom) => ({
+                ...readAttrs(dom, TABLE_LEGACY_ATTRS),
+                caption: readFurniture(dom, ['caption']),
+                colgroup: readFurniture(dom, ['colgroup', 'col']),
+                style: readStyle(dom, TABLE_STYLE_PROPS),
+            }),
+        },
         /*
          * `tbody`, `thead` and `tfoot` are SKIPPED rather than ignored: the wrapper
          * itself carries nothing, but its rows are the entire content. `ignore`
@@ -122,35 +294,68 @@ export const table = {
         { tag: 'thead', skip: true },
         { tag: 'tfoot', skip: true },
         /*
-         * KNOWN LIMITATION, declared rather than hidden.
-         *
-         * `<colgroup>`/`<col>` are dropped, and `<caption>` is dropped with its
-         * text. Both should be preserved and neither can be today: a caption node
-         * would have to be the table's first child, and `prosemirror-tables`
-         * computes its cell map by treating every child of a table as a row, so a
-         * leading caption breaks its indexing.
+         * `caption`, `colgroup` and `col` are ignored as CONTENT and captured as
+         * ATTRIBUTES instead -- see `readFurniture` for why they cannot be nodes.
          *
-         * Dropping a caption is a real accessibility regression -- a caption is a
-         * table's accessible name -- so this is tracked as a bug to fix by adding a
-         * caption node and contributing the indexing fix upstream, not as a design
-         * decision. There is a fixture asserting the current behaviour so it cannot
-         * regress further without someone noticing.
+         * The `ignore` rules are still load-bearing after that capture. Without
+         * them the preservation layer's catch-all claims a `<caption>` as an
+         * unrecognised block, and `table_row+` refuses to accept it, so the caption
+         * is dropped a second way by a different mechanism.
          */
         { tag: 'colgroup', ignore: true },
         { tag: 'col', ignore: true },
         { tag: 'caption', ignore: true },
     ],
     toDOM(node) {
-        return ['table', writeAttrs(node.attrs, TABLE_LEGACY_ATTRS), ['tbody', 0]];
+        const attrs = writeAttrs(node.attrs, TABLE_LEGACY_ATTRS);
+        const caption = node.attrs['caption'];
+        const colgroup = node.attrs['colgroup'];
+        const style = node.attrs['style'];
+        if (!caption && !colgroup && !style)
+            return ['table', attrs, ['tbody', 0]];
+        /*
+         * Furniture forces a real element rather than an output-spec array, because
+         * an array cannot express "these children, then the content hole inside a
+         * LATER child". `{ dom, contentDOM }` can, and ProseMirror accepts it from
+         * both the editor's node renderer and DOMSerializer.
+         */
+        const doc = serializationTarget();
+        const table = doc.createElement('table');
+        for (const [name, value] of Object.entries(attrs))
+            table.setAttribute(name, value);
+        if (style)
+            applyStyleAttribute(table, style);
+        // Document order is fixed by HTML: caption first, then colgroup, then rows.
+        // Emitting them in any other order produces markup browsers reshuffle, which
+        // would make the round-trip lossy again by a subtler route.
+        if (caption)
+            appendFurniture(table, caption, doc, !isSerializing());
+        if (colgroup)
+            appendFurniture(table, colgroup, doc, false);
+        const tbody = doc.createElement('tbody');
+        table.appendChild(tbody);
+        return { dom: table, contentDOM: tbody };
     },
 };
 export const table_row = {
     content: '(table_cell | table_header)*',
     tableRole: 'row',
-    attrs: { class: { default: null }, align: { default: null } },
-    parseDOM: [{ tag: 'tr', getAttrs: (dom) => readAttrs(dom, ['class', 'align']) }],
+    attrs: { ...legacyDefaults(ROW_ATTRS), style: { default: null } },
+    parseDOM: [
+        {
+            tag: 'tr',
+            getAttrs: (dom) => ({
+                ...readAttrs(dom, ROW_ATTRS),
+                style: readStyle(dom, ROW_STYLE_PROPS),
+            }),
+        },
+    ],
     toDOM(node) {
-        return ['tr', writeAttrs(node.attrs, ['class', 'align']), 0];
+        const attrs = writeAttrs(node.attrs, ROW_ATTRS);
+        const style = node.attrs['style'];
+        if (style)
+            return styledElement('tr', attrs, style);
+        return ['tr', attrs, 0];
     },
 };
 export const table_cell = {

package/dist/tables.js.map

@@ -1 +1 @@
-{"version":3,"file":"tables.js","sourceRoot":"","sources":["../src/tables.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../src/tables.ts"],"names":[],"mappings":"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"}

package/dist/tokens.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tokens the schema is willing to write onto `id` and `class`.
+ *
+ * Both attributes are how an author names a thing in the page, and both are
+ * how pasted content impersonates the page. The checks here are deliberately
+ * syntactic: they refuse characters that would let a value escape the
+ * attribute, and they do not try to guess whether a class name is "yours".
+ * Which class names a deployment offers in a pick list is an integrator
+ * decision; which characters may appear in one is not.
+ */
+/** An `id` the schema will store, or null. */
+export declare function safeId(value: string | null | undefined): string | null;
+/**
+ * Class tokens the schema will store, or null when none survive.
+ *
+ * Known alignment classes are stripped here when `exclude` is given, so an
+ * image can carry `ol-float-left` as its modelled `align` without also
+ * writing it twice in `class`.
+ */
+export declare function safeClassList(value: string | null | undefined, exclude?: ReadonlySet<string>): string | null;
+/** Image floats the toolbar can express. Centre is not a float: it is a block. */
+export type ImageAlign = 'left' | 'right' | 'center';
+export declare const IMAGE_ALIGNMENTS: readonly ImageAlign[];
+export declare const IMAGE_ALIGN_CLASS: Readonly<Record<ImageAlign, string>>;
+/** The modelled alignment class in this list, if any. */
+export declare function imageAlignFromClass(value: string | null | undefined): ImageAlign | null;
+export declare const IMAGE_ALIGN_CLASSES: ReadonlySet<string>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,8CAA8C;AAC9C,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKtE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,GAAE,WAAW,CAAC,MAAM,CAAa,GACvC,MAAM,GAAG,IAAI,CAWf;AAED,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEpD,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAAgC,CAAA;AAElF,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAIlE,CAAA;AASD,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,CAOvF;AAED,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAA6C,CAAA"}

package/dist/tokens.js

@@ -0,0 +1,68 @@
+/**
+ * Tokens the schema is willing to write onto `id` and `class`.
+ *
+ * Both attributes are how an author names a thing in the page, and both are
+ * how pasted content impersonates the page. The checks here are deliberately
+ * syntactic: they refuse characters that would let a value escape the
+ * attribute, and they do not try to guess whether a class name is "yours".
+ * Which class names a deployment offers in a pick list is an integrator
+ * decision; which characters may appear in one is not.
+ */
+/** HTML5 ids: no spaces, not empty. */
+const ID = /^[^\s]+$/;
+/** A single class token. */
+const CLASS_TOKEN = /^-?[_a-zA-Z]+[_a-zA-Z0-9-]*$/;
+/** An `id` the schema will store, or null. */
+export function safeId(value) {
+    if (value === null || value === undefined)
+        return null;
+    const candidate = value.trim();
+    if (candidate === '' || !ID.test(candidate))
+        return null;
+    return candidate;
+}
+/**
+ * Class tokens the schema will store, or null when none survive.
+ *
+ * Known alignment classes are stripped here when `exclude` is given, so an
+ * image can carry `ol-float-left` as its modelled `align` without also
+ * writing it twice in `class`.
+ */
+export function safeClassList(value, exclude = new Set()) {
+    if (value === null || value === undefined)
+        return null;
+    const kept = [];
+    const seen = new Set();
+    for (const token of value.trim().split(/\s+/)) {
+        if (token === '' || exclude.has(token) || !CLASS_TOKEN.test(token))
+            continue;
+        if (seen.has(token))
+            continue;
+        seen.add(token);
+        kept.push(token);
+    }
+    return kept.length > 0 ? kept.join(' ') : null;
+}
+export const IMAGE_ALIGNMENTS = ['left', 'right', 'center'];
+export const IMAGE_ALIGN_CLASS = {
+    left: 'ol-float-left',
+    right: 'ol-float-right',
+    center: 'ol-align-center',
+};
+const CLASS_TO_ALIGN = new Map(Object.entries(IMAGE_ALIGN_CLASS).map(([align, name]) => [
+    name,
+    align,
+]));
+/** The modelled alignment class in this list, if any. */
+export function imageAlignFromClass(value) {
+    if (!value)
+        return null;
+    for (const token of value.split(/\s+/)) {
+        const align = CLASS_TO_ALIGN.get(token);
+        if (align)
+            return align;
+    }
+    return null;
+}
+export const IMAGE_ALIGN_CLASSES = new Set(Object.values(IMAGE_ALIGN_CLASS));
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,uCAAuC;AACvC,MAAM,EAAE,GAAG,UAAU,CAAA;AAErB,4BAA4B;AAC5B,MAAM,WAAW,GAAG,8BAA8B,CAAA;AAElD,8CAA8C;AAC9C,MAAM,UAAU,MAAM,CAAC,KAAgC;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACtD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC9B,IAAI,SAAS,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAA;IACxD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAgC,EAChC,UAA+B,IAAI,GAAG,EAAE;IAExC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACtD,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,IAAI,KAAK,KAAK,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,SAAQ;QAC5E,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAQ;QAC7B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACf,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAChD,CAAC;AAKD,MAAM,CAAC,MAAM,gBAAgB,GAA0B,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;AAElF,MAAM,CAAC,MAAM,iBAAiB,GAAyC;IACrE,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,iBAAiB;CAC1B,CAAA;AAED,MAAM,cAAc,GAAG,IAAI,GAAG,CAC3B,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAiC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IACxF,IAAI;IACJ,KAAK;CACN,CAAC,CACH,CAAA;AAED,yDAAyD;AACzD,MAAM,UAAU,mBAAmB,CAAC,KAAgC;IAClE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACvC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;IACzB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAA"}

package/dist/visual-aids.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Decorations that make empty blocks, non-breaking spaces, and preserved
+ * atoms visible while editing.
+ *
+ * These marks are view-only. They must never reach serialized HTML: an empty
+ * paragraph is still an empty paragraph, and a ` ` is still a nbsp.
+ */
+import { Plugin } from 'prosemirror-state';
+export declare function visualAidsPlugin(): Plugin;
+//# sourceMappingURL=visual-aids.d.ts.map

package/dist/visual-aids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-aids.d.ts","sourceRoot":"","sources":["../src/visual-aids.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,MAAM,EAAa,MAAM,mBAAmB,CAAA;AAsBrD,wBAAgB,gBAAgB,IAAI,MAAM,CAqCzC"}

package/dist/visual-aids.js

@@ -0,0 +1,61 @@
+/**
+ * Decorations that make empty blocks, non-breaking spaces, and preserved
+ * atoms visible while editing.
+ *
+ * These marks are view-only. They must never reach serialized HTML: an empty
+ * paragraph is still an empty paragraph, and a ` ` is still a nbsp.
+ */
+import { Plugin, PluginKey } from 'prosemirror-state';
+import { Decoration, DecorationSet } from 'prosemirror-view';
+const key = new PluginKey('openleaf-visual-aids');
+/**
+ * True when this position is the last character of its text block.
+ *
+ * ProseMirror renders a document space in that position as a non-breaking space
+ * itself, so the browser does not collapse it. Decorating it wraps that
+ * rendering artifact in a span, and the editor then reads the nbsp back as the
+ * author's own character -- so every space typed at the end of a paragraph
+ * became a nbsp in the stored HTML, and the next one after it too.
+ *
+ * A genuinely stored trailing nbsp therefore goes unmarked. That is the price of
+ * the aid never changing the document it describes.
+ */
+function isBlockFinal(doc, at) {
+    const $at = doc.resolve(at);
+    return $at.parentOffset + 1 >= $at.parent.content.size;
+}
+export function visualAidsPlugin() {
+    return new Plugin({
+        key,
+        props: {
+            decorations(state) {
+                const decorations = [];
+                state.doc.descendants((node, pos) => {
+                    if (node.isTextblock && node.content.size === 0) {
+                        decorations.push(Decoration.node(pos, pos + node.nodeSize, { class: 'ol-empty-block' }));
+                    }
+                    if (node.type.name === 'unknown_block' || node.type.name === 'unknown_inline') {
+                        decorations.push(Decoration.node(pos, pos + node.nodeSize, { class: 'ol-hidden-structure' }));
+                    }
+                    if (node.isText) {
+                        const text = node.text ?? '';
+                        for (let i = 0; i < text.length; i += 1) {
+                            if (text.charCodeAt(i) !== 0xa0)
+                                continue;
+                            // `pos` already addresses the first character: a text node has no
+                            // opening token to step over, unlike a node. Adding one marked the
+                            // character after each nbsp, and ran off the end of the node when
+                            // the nbsp was last -- where the decoration disappeared entirely.
+                            const at = pos + i;
+                            if (isBlockFinal(state.doc, at))
+                                continue;
+                            decorations.push(Decoration.inline(at, at + 1, { class: 'ol-nbsp' }));
+                        }
+                    }
+                });
+                return DecorationSet.create(state.doc, decorations);
+            },
+        },
+    });
+}
+//# sourceMappingURL=visual-aids.js.map

package/dist/visual-aids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-aids.js","sourceRoot":"","sources":["../src/visual-aids.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAE5D,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,sBAAsB,CAAC,CAAA;AAEjD;;;;;;;;;;;GAWG;AACH,SAAS,YAAY,CAAC,GAAW,EAAE,EAAU;IAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC3B,OAAO,GAAG,CAAC,YAAY,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,MAAM,CAAC;QAChB,GAAG;QACH,KAAK,EAAE;YACL,WAAW,CAAC,KAAK;gBACf,MAAM,WAAW,GAAiB,EAAE,CAAA;gBACpC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;oBAClC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;wBAChD,WAAW,CAAC,IAAI,CACd,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CACvE,CAAA;oBACH,CAAC;oBACD,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;wBAC9E,WAAW,CAAC,IAAI,CACd,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAC5E,CAAA;oBACH,CAAC;oBACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;wBAChB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;wBAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;4BACxC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI;gCAAE,SAAQ;4BACzC,kEAAkE;4BAClE,mEAAmE;4BACnE,kEAAkE;4BAClE,kEAAkE;4BAClE,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,CAAA;4BAClB,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;gCAAE,SAAQ;4BACzC,WAAW,CAAC,IAAI,CACd,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CACpD,CAAA;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC,CAAC,CAAA;gBACF,OAAO,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;YACrD,CAAC;SACF;KACF,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openleaf-editor/core",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.2",
   "description": "OpenLeaf editing core: ProseMirror schema, HTML I/O, and the content-preservation layer. No UI, no framework dependencies.",
   "license": "Apache-2.0",
   "publishConfig": {
@@ -35,7 +35,8 @@
     "prosemirror-model": "^1.24.1",
     "prosemirror-schema-list": "^1.5.1",
     "prosemirror-state": "^1.4.3",
-    "prosemirror-transform": "^1.10.2"
+    "prosemirror-transform": "^1.10.2",
+    "prosemirror-view": "^1.37.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json"