@openleaf-editor/core 0.1.0-beta.0

package/dist/extensions.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Schema extensions: how a plugin contributes node and mark types.
+ *
+ * ## Why this could not be a simple registry
+ *
+ * A ProseMirror `Schema` is immutable, and `EditorState.reconfigure` -- the
+ * mechanism that lets a late-loading plugin add behaviour to an open editor --
+ * cannot change it. Verified in prosemirror-state: `reconfigure` builds
+ * `new Configuration(this.schema, config.plugins)`, taking the schema from the
+ * old state. So schema extension is not "register and the editors update"; it is
+ * "register before an editor is built, or wait for the next one".
+ *
+ * That constraint decides the shape of everything here.
+ *
+ * ## Append-only, and why it is not a preference
+ *
+ * Extension nodes are appended, never prepended, and there is no positioning
+ * hint. Measured: prepending a `group: 'block'` node makes it the document's
+ * `defaultType`, so `topNodeType.createAndFill()` produces
+ * `{"type":"doc","content":[{"type":"widget"}]}` instead of an empty paragraph.
+ * Every new document, and every gap the editor fills, would start with a
+ * plugin's widget.
+ *
+ * ## No priority field
+ *
+ * The preservation layer's catch-all rules sit at priority 0 and 1, which makes
+ * them the last two rules in the parse table -- so an extension rule at the
+ * default priority already wins, for free. Offering a priority knob would invite
+ * an author to set `priority: 0` to be polite and thereby tie with the
+ * catch-all, where the winner is decided by map insertion order. Instead,
+ * `createSchema` rejects any rule at priority <= 1 and says why.
+ *
+ * ## Collisions throw
+ *
+ * Deliberately the opposite of `registerToolbarItem`, which is last-wins because
+ * a button is UI and replacing one is a feature. A node type is a *storage
+ * format*: two definitions of `footnote` mean two serializations of the same
+ * content chosen by script-tag order, and whichever loses has already written
+ * documents in its shape. `replaces` is the explicit opt-in.
+ */
+import { Schema, type MarkSpec, type NodeSpec } from 'prosemirror-model';
+export interface SchemaExtension {
+    /** Stable and unique. Namespace it: `openleaf/footnote`. */
+    readonly id: string;
+    /** Node types by schema name, appended after the core nodes. */
+    readonly nodes?: Readonly<Record<string, NodeSpec>>;
+    /** Mark types by schema name. */
+    readonly marks?: Readonly<Record<string, MarkSpec>>;
+    /** Names this extension deliberately replaces. Absent means a clash throws. */
+    readonly replaces?: readonly string[];
+    /**
+     * Re-emit attributes the spec does not model. Defaults to true.
+     *
+     * Adding a node type strictly *reduces* fidelity for the tag it claims: before
+     * the node existed, the preservation layer kept the element and every
+     * attribute on it; afterwards the spec keeps only what it declares. A callout
+     * node modelling `class` silently drops `id` and `data-analytics` that used to
+     * survive.
+     *
+     * So unmodelled attributes are captured on parse and merged back on
+     * serialize, by default, at schema-build time -- which means an author cannot
+     * opt out by forgetting.
+     */
+    readonly carryUnknownAttributes?: boolean;
+}
+/** Where carried attributes live. Underscored: it is not for plugin authors. */
+export declare const CARRIED_ATTR = "__openleafCarried";
+/**
+ * Register a schema extension.
+ *
+ * Must happen before the editor that should have it is constructed. The element
+ * defers building its view until the document's scripts have run, which covers
+ * every documented integration; anything registering later applies to editors
+ * created after it, not to open ones.
+ */
+export declare function registerSchemaExtension(extension: SchemaExtension): () => void;
+export declare function registeredSchemaExtensions(): readonly SchemaExtension[];
+export declare function onSchemaExtensionsChange(listener: () => void): () => void;
+/** Testing seam. Not part of the public API. */
+export declare function clearSchemaExtensions(): void;
+export declare function createSchema(list?: readonly SchemaExtension[]): Schema;
+/**
+ * The schema for the currently registered extensions.
+ *
+ * A function rather than a constant, and this is the point: a `const` reads as
+ * "bind to this" and would be captured at import by every consumer, which is
+ * exactly what made the schema impossible to extend. Memoized, and invalidated
+ * whenever the registry changes.
+ */
+export declare function coreSchema(): Schema;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,EACL,MAAM,EAEN,KAAK,QAAQ,EACb,KAAK,QAAQ,EAGd,MAAM,mBAAmB,CAAA;AAI1B,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;IACnD,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;IACnD,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;CAC1C;AAED,gFAAgF;AAChF,eAAO,MAAM,YAAY,sBAAsB,CAAA;AAmB/C;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,IAAI,CAe9E;AAED,wBAAgB,0BAA0B,IAAI,SAAS,eAAe,EAAE,CAEvE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKzE;AAED,gDAAgD;AAChD,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAgKD,wBAAgB,YAAY,CAAC,IAAI,GAAE,SAAS,eAAe,EAAO,GAAG,MAAM,CAyB1E;AAID;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAGnC"}

package/dist/extensions.js

@@ -0,0 +1,281 @@
+/**
+ * Schema extensions: how a plugin contributes node and mark types.
+ *
+ * ## Why this could not be a simple registry
+ *
+ * A ProseMirror `Schema` is immutable, and `EditorState.reconfigure` -- the
+ * mechanism that lets a late-loading plugin add behaviour to an open editor --
+ * cannot change it. Verified in prosemirror-state: `reconfigure` builds
+ * `new Configuration(this.schema, config.plugins)`, taking the schema from the
+ * old state. So schema extension is not "register and the editors update"; it is
+ * "register before an editor is built, or wait for the next one".
+ *
+ * That constraint decides the shape of everything here.
+ *
+ * ## Append-only, and why it is not a preference
+ *
+ * Extension nodes are appended, never prepended, and there is no positioning
+ * hint. Measured: prepending a `group: 'block'` node makes it the document's
+ * `defaultType`, so `topNodeType.createAndFill()` produces
+ * `{"type":"doc","content":[{"type":"widget"}]}` instead of an empty paragraph.
+ * Every new document, and every gap the editor fills, would start with a
+ * plugin's widget.
+ *
+ * ## No priority field
+ *
+ * The preservation layer's catch-all rules sit at priority 0 and 1, which makes
+ * them the last two rules in the parse table -- so an extension rule at the
+ * default priority already wins, for free. Offering a priority knob would invite
+ * an author to set `priority: 0` to be polite and thereby tie with the
+ * catch-all, where the winner is decided by map insertion order. Instead,
+ * `createSchema` rejects any rule at priority <= 1 and says why.
+ *
+ * ## Collisions throw
+ *
+ * Deliberately the opposite of `registerToolbarItem`, which is last-wins because
+ * a button is UI and replacing one is a feature. A node type is a *storage
+ * format*: two definitions of `footnote` mean two serializations of the same
+ * content chosen by script-tag order, and whichever loses has already written
+ * documents in its shape. `replaces` is the explicit opt-in.
+ */
+import OrderedMap from 'orderedmap';
+import { Schema, } from 'prosemirror-model';
+import { coreMarks, coreNodes } from './schema.js';
+import { URL_ATTRIBUTES, isEventHandlerAttribute, isSafeUrl } from './url.js';
+/** Where carried attributes live. Underscored: it is not for plugin authors. */
+export const CARRIED_ATTR = '__openleafCarried';
+/* ------------------------------------------------------------------ *
+ * Registry
+ * ------------------------------------------------------------------ */
+const extensions = new Map();
+const listeners = new Set();
+function notify() {
+    for (const listener of listeners) {
+        try {
+            listener();
+        }
+        catch (error) {
+            console.error('@openleaf-editor/core: a schema-extension listener threw', error);
+        }
+    }
+}
+/**
+ * Register a schema extension.
+ *
+ * Must happen before the editor that should have it is constructed. The element
+ * defers building its view until the document's scripts have run, which covers
+ * every documented integration; anything registering later applies to editors
+ * created after it, not to open ones.
+ */
+export function registerSchemaExtension(extension) {
+    if (extensions.has(extension.id)) {
+        console.warn(`@openleaf-editor/core: schema extension "${extension.id}" is already registered. ` +
+            'The second registration was ignored.');
+        return () => undefined;
+    }
+    extensions.set(extension.id, extension);
+    notify();
+    return () => {
+        // Removing an extension cannot un-extend a schema that is already built --
+        // a document may contain its nodes. It affects editors created afterwards.
+        if (extensions.delete(extension.id))
+            notify();
+    };
+}
+export function registeredSchemaExtensions() {
+    return [...extensions.values()];
+}
+export function onSchemaExtensionsChange(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/** Testing seam. Not part of the public API. */
+export function clearSchemaExtensions() {
+    extensions.clear();
+    notify();
+}
+/* ------------------------------------------------------------------ *
+ * Carrying unmodelled attributes
+ * ------------------------------------------------------------------ */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Residue a spec has already encoded into a modelled attribute, and so must not
+ * carry a second copy of.
+ *
+ * `code_block` reads `language-js` from either `<pre>` or `<code>` and re-emits
+ * it on `<code>` -- read both, write one. Carrying the `<pre>`'s class verbatim
+ * writes it twice, so the language token is dropped from the residue while any
+ * other class the author put there is kept. Keyed by node name because the
+ * overlap is a property of the spec, not of the attribute.
+ */
+const CARRY_SCRUB = {
+    code_block(carried) {
+        const cls = carried['class'];
+        if (cls === undefined)
+            return;
+        const kept = cls.split(/\s+/).filter((c) => c && !/^(?:language|lang)-/i.test(c));
+        if (kept.length > 0)
+            carried['class'] = kept.join(' ');
+        else
+            delete carried['class'];
+    },
+};
+/**
+ * Wrap a node spec so attributes it does not model survive the round trip.
+ *
+ * Applied to extension nodes unconditionally: they only ever claim markup the
+ * preservation layer previously kept in full, so carrying the residue is a pure
+ * improvement over the alternative of silently dropping it.
+ */
+function withCarriedAttributes(name, spec) {
+    const modelled = new Set(Object.keys(spec.attrs ?? {}));
+    const attrs = { ...(spec.attrs ?? {}), [CARRIED_ATTR]: { default: null } };
+    // A node's parse rules are always tag rules -- only marks may match styles --
+    // so the narrower type is the accurate one and keeps the map total.
+    const parseDOM = (spec.parseDOM ?? []).map((rule) => {
+        const original = rule.getAttrs;
+        return {
+            ...rule,
+            getAttrs(dom) {
+                const base = original ? original.call(rule, dom) : (rule.attrs ?? {});
+                if (base === false || base === null || base === undefined)
+                    return base;
+                const carried = {};
+                for (const attr of Array.from(dom.attributes ?? [])) {
+                    if (modelled.has(attr.name))
+                        continue;
+                    // Same scrub as the preservation layer: carrying `onclick` or a
+                    // `javascript:` URL would reintroduce exactly the executable content
+                    // core promises to drop.
+                    if (isEventHandlerAttribute(attr.name))
+                        continue;
+                    if (URL_ATTRIBUTES.has(attr.name.toLowerCase()) && !isSafeUrl(attr.value))
+                        continue;
+                    carried[attr.name] = attr.value;
+                }
+                CARRY_SCRUB[name]?.(carried);
+                return {
+                    ...base,
+                    [CARRIED_ATTR]: Object.keys(carried).length > 0 ? carried : null,
+                };
+            },
+        };
+    });
+    const originalToDOM = spec.toDOM;
+    const toDOM = originalToDOM
+        ? (node) => {
+            const out = originalToDOM(node);
+            const carried = node.attrs[CARRIED_ATTR];
+            if (!carried || !Array.isArray(out))
+                return out;
+            const result = [...out];
+            if (isPlainObject(result[1])) {
+                // Modelled attributes win: an author's spec is the authority on the
+                // names it declared.
+                result[1] = { ...carried, ...result[1] };
+            }
+            else {
+                result.splice(1, 0, carried);
+            }
+            return result;
+        }
+        : originalToDOM;
+    return { ...spec, attrs, parseDOM, ...(toDOM ? { toDOM } : {}) };
+}
+/* ------------------------------------------------------------------ *
+ * Building
+ * ------------------------------------------------------------------ */
+function assertRulePriorities(extensionId, name, spec) {
+    for (const rule of (spec.parseDOM ?? [])) {
+        if (rule.priority !== undefined && rule.priority <= 1) {
+            throw new Error(`@openleaf-editor/core: extension "${extensionId}" gives "${name}" a parse rule at ` +
+                `priority ${rule.priority}. The preservation layer's catch-all rules sit at ` +
+                'priority 0 and 1, so this rule would tie with them and the winner would be ' +
+                'decided by insertion order. Remove the priority: the default already wins.');
+        }
+    }
+}
+function claim(claimed, kind, name, extension, existsInCore) {
+    const replaces = new Set(extension.replaces ?? []);
+    const previous = claimed.get(`${kind}:${name}`);
+    if (previous && !replaces.has(name)) {
+        throw new Error(`@openleaf-editor/core: extensions "${previous}" and "${extension.id}" both define the ` +
+            `${kind} "${name}". A ${kind} type is a storage format, not a preference: two ` +
+            'definitions mean two serializations of the same content chosen by load order. ' +
+            `If replacing it is intended, declare replaces: ['${name}'].`);
+    }
+    if (existsInCore && !replaces.has(name)) {
+        throw new Error(`@openleaf-editor/core: extension "${extension.id}" defines the ${kind} "${name}", which ` +
+            `already exists in the base schema. If replacing it is intended, declare ` +
+            `replaces: ['${name}'].`);
+    }
+    claimed.set(`${kind}:${name}`, extension.id);
+}
+/**
+ * Build a schema from the base types plus these extensions.
+ *
+ * Pure: it reads no registry. That is deliberate -- a registry-reading default
+ * would make the fidelity suite depend on whichever other test file happened to
+ * register an extension first.
+ */
+/**
+ * Node types whose attributes are already the whole story — wrapping them
+ * would duplicate markup (unknown_*) or add a phantom attr to nodes that
+ * never parse from the DOM (doc, text).
+ */
+const SKIP_CARRY = new Set(['doc', 'text', 'unknown_block', 'unknown_inline']);
+function coreNodesWithCarriedAttributes() {
+    // Claimed tags used to drop every attribute they do not model. Extension
+    // nodes already carry the residue; core nodes were the remaining hole, and
+    // it is how `<p class="lead">` became `<p>` on the first save.
+    let nodes = OrderedMap.from({});
+    for (const [name, spec] of Object.entries(coreNodes)) {
+        nodes = nodes.addToEnd(name, SKIP_CARRY.has(name) ? spec : withCarriedAttributes(name, spec));
+    }
+    return nodes;
+}
+export function createSchema(list = []) {
+    let nodes = coreNodesWithCarriedAttributes();
+    let marks = OrderedMap.from(coreMarks);
+    const claimed = new Map();
+    for (const extension of list) {
+        for (const [name, spec] of Object.entries(extension.nodes ?? {})) {
+            assertRulePriorities(extension.id, name, spec);
+            claim(claimed, 'node', name, extension, Object.hasOwn(coreNodes, name));
+            const prepared = extension.carryUnknownAttributes === false
+                ? spec
+                : withCarriedAttributes(name, spec);
+            // addToEnd, never prepend: a leading block node becomes the document's
+            // defaultType and every new document would start with it.
+            nodes = nodes.remove(name).addToEnd(name, prepared);
+        }
+        for (const [name, spec] of Object.entries(extension.marks ?? {})) {
+            assertRulePriorities(extension.id, name, spec);
+            claim(claimed, 'mark', name, extension, Object.hasOwn(coreMarks, name));
+            marks = marks.remove(name).addToEnd(name, spec);
+        }
+    }
+    return new Schema({ nodes, marks });
+}
+let cached = null;
+/**
+ * The schema for the currently registered extensions.
+ *
+ * A function rather than a constant, and this is the point: a `const` reads as
+ * "bind to this" and would be captured at import by every consumer, which is
+ * exactly what made the schema impossible to extend. Memoized, and invalidated
+ * whenever the registry changes.
+ */
+export function coreSchema() {
+    if (!cached)
+        cached = createSchema(registeredSchemaExtensions());
+    return cached;
+}
+onSchemaExtensionsChange(() => {
+    cached = null;
+});
+//# sourceMappingURL=extensions.js.map

package/dist/extensions.js.map

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

package/dist/html.d.ts

@@ -0,0 +1,22 @@
+/**
+ * HTML in, HTML out.
+ *
+ * OpenLeaf's storage format is HTML, not a proprietary JSON document
+ * model. A CMS that adopts OpenLeaf and later drops it should be left
+ * with content it can still render, which rules out formats that require
+ * our code to interpret.
+ */
+import { type Node as PMNode, type Schema } from 'prosemirror-model';
+export interface HtmlIOOptions {
+    /** DOM implementation to use. Defaults to the global `document`. */
+    document?: Document;
+    /** Schema to parse against. Defaults to the built-in one. */
+    schema?: Schema;
+}
+/** Parse an HTML string into an OpenLeaf document. */
+export declare function parseHtml(html: string, opts?: HtmlIOOptions): PMNode;
+/** Serialize an OpenLeaf document back to an HTML string. */
+export declare function serializeHtml(node: PMNode, opts?: HtmlIOOptions): string;
+/** Convenience: one full parse/serialize cycle. */
+export declare function roundTrip(html: string, opts?: HtmlIOOptions): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA4B,KAAK,IAAI,IAAI,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAqC9F,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAaD,sDAAsD;AACtD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CAOpE;AAqCD,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CAaxE;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CAEpE"}

package/dist/html.js

@@ -0,0 +1,117 @@
+/**
+ * HTML in, HTML out.
+ *
+ * OpenLeaf's storage format is HTML, not a proprietary JSON document
+ * model. A CMS that adopts OpenLeaf and later drops it should be left
+ * with content it can still render, which rules out formats that require
+ * our code to interpret.
+ */
+import { DOMParser, DOMSerializer } from 'prosemirror-model';
+import { isInsidePreserved, withSerializationDocument } from './preserve.js';
+import { coreSchema } from './extensions.js';
+/**
+ * Parsers and serializers are resolved per schema rather than built once.
+ *
+ * `DOMSerializer.fromSchema` builds a map keyed by node NAME at construction, so
+ * a serializer built from one schema throws `this.nodes[node.type.name] is not a
+ * function` the moment it meets a node type a plugin added. Module-level
+ * instances were therefore a hard ceiling on extensibility, not just an
+ * optimisation.
+ *
+ * ProseMirror caches these on the schema object itself, so a WeakMap here is
+ * belt-and-braces -- it costs nothing and makes the intent explicit.
+ */
+const parsers = new WeakMap();
+const serializers = new WeakMap();
+function parserFor(target) {
+    let found = parsers.get(target);
+    if (!found) {
+        found = DOMParser.fromSchema(target);
+        parsers.set(target, found);
+    }
+    return found;
+}
+function serializerFor(target) {
+    let found = serializers.get(target);
+    if (!found) {
+        found = DOMSerializer.fromSchema(target);
+        serializers.set(target, found);
+    }
+    return found;
+}
+function resolveDocument(opts) {
+    const doc = opts?.document ?? (typeof document !== 'undefined' ? document : undefined);
+    if (!doc) {
+        throw new Error('@openleaf-editor/core: no Document available. Pass { document } when ' +
+            'running outside a browser.');
+    }
+    return doc;
+}
+/** Parse an HTML string into an OpenLeaf document. */
+export function parseHtml(html, opts) {
+    const doc = resolveDocument(opts);
+    const tpl = doc.createElement('template');
+    tpl.innerHTML = html;
+    return parserFor(opts?.schema ?? coreSchema()).parse(tpl.content, {
+        preserveWhitespace: false,
+    });
+}
+/**
+ * Collapse `<td><p>text</p></td>` back to `<td>text</td>`.
+ *
+ * Table cells hold `block+` content, because real tables contain paragraphs and
+ * lists. The consequence is that parsing the overwhelmingly common legacy form
+ * `<td>text</td>` produces a cell containing a paragraph, and serializing it
+ * back would write `<td><p>text</p></td>` -- rewriting every cell of every table
+ * in a CMS the first time each post is opened and saved.
+ *
+ * That is a normalization rather than information loss, but "we changed every
+ * table in your archive" is not a thing this project gets to do quietly. So a
+ * cell holding exactly one attribute-free paragraph is unwrapped on the way out.
+ *
+ * The asymmetry is deliberate and worth stating: a cell that was authored as
+ * `<td><p>text</p></td>` also comes back as `<td>text</td>`. That form is rare
+ * in the content this editor inherits, and the alternative is rewriting the
+ * common case instead of the rare one.
+ */
+function unwrapSoleCellParagraph(host) {
+    for (const cell of Array.from(host.querySelectorAll('td, th'))) {
+        // Never reach inside preserved markup. A table nested in an unrecognised
+        // wrapper is content we undertook to return byte-identical, and a
+        // normalization that is right for our own tables is a broken promise there.
+        if (isInsidePreserved(cell))
+            continue;
+        if (cell.childElementCount !== 1)
+            continue;
+        const only = cell.firstElementChild;
+        if (!only || only.nodeName !== 'P' || only.attributes.length > 0)
+            continue;
+        // Only when the paragraph is the cell's entire content; a stray text node
+        // beside it means the markup is doing something we should not touch.
+        if (cell.childNodes.length !== 1)
+            continue;
+        while (only.firstChild)
+            cell.insertBefore(only.firstChild, only);
+        cell.removeChild(only);
+    }
+}
+/** Serialize an OpenLeaf document back to an HTML string. */
+export function serializeHtml(node, opts) {
+    const doc = resolveDocument(opts);
+    return withSerializationDocument(doc, () => {
+        // Taken from the document itself, so a document built on an extended schema
+        // serializes with a serializer that knows its node types. Passing the wrong
+        // schema explicitly is still possible, but the default is now correct.
+        const target = opts?.schema ?? node.type.schema;
+        const fragment = serializerFor(target).serializeFragment(node.content, { document: doc });
+        const host = doc.createElement('div');
+        host.appendChild(fragment);
+        unwrapSoleCellParagraph(host);
+        return host.innerHTML;
+    });
+}
+/** Convenience: one full parse/serialize cycle. */
+export function roundTrip(html, opts) {
+    return serializeHtml(parseHtml(html, opts), opts);
+}
+//# sourceMappingURL=html.js.map

package/dist/html.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { baseSchema, coreMarks, coreNodes } from './schema.js';
+export { parseHtml, serializeHtml, roundTrip, type HtmlIOOptions } from './html.js';
+export { isLosslesslyUnwrappable, unknownBlock, unknownInline } from './preserve.js';
+export { URL_ATTRIBUTES, isEventHandlerAttribute, isSafeUrl, safeUrlOrNull, } from './url.js';
+export { activeHeadingLevel, activeLink, canInsert, canRedo, canUndo, isMarkActive, isNodeActive, toggleBold, toggleInlineCode, toggleItalic, toggleStrike, toggleUnderline, insertHorizontalRule, setHeading, setParagraph, toggleBlockquote, toggleCodeBlock, toggleHeading, wrapInBlockquote, indentListItem, outdentListItem, splitListItemCommand, toggleBulletList, toggleOrderedList, insertImage, setLink, unsetLink, type ImageAttrs, type LinkAttrs, redo, undo, } from './commands.js';
+export { buildKeymap, shortcutFor, shortcuts, type Shortcut, } from './keymap.js';
+export { createRegisteredPlugins, onEditorPluginsChange, registerEditorPlugin, type EditorPluginFactory, } from './plugins.js';
+export { table, table_cell, table_header, table_row } from './tables.js';
+export { CARRIED_ATTR, clearSchemaExtensions, coreSchema, createSchema, onSchemaExtensionsChange, registerSchemaExtension, registeredSchemaExtensions, type SchemaExtension, } from './extensions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AACnF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACpF,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,SAAS,EACT,aAAa,GACd,MAAM,UAAU,CAAA;AACjB,OAAO,EAEL,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,YAAY,EACZ,YAAY,EAEZ,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,eAAe,EAEf,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,gBAAgB,EAEhB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EAEjB,WAAW,EACX,OAAO,EACP,SAAS,EACT,KAAK,UAAU,EACf,KAAK,SAAS,EAEd,IAAI,EACJ,IAAI,GACL,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,KAAK,QAAQ,GACd,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACxE,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,22 @@
+export { baseSchema, coreMarks, coreNodes } from './schema.js';
+export { parseHtml, serializeHtml, roundTrip } from './html.js';
+export { isLosslesslyUnwrappable, unknownBlock, unknownInline } from './preserve.js';
+export { URL_ATTRIBUTES, isEventHandlerAttribute, isSafeUrl, safeUrlOrNull, } from './url.js';
+export { 
+// predicates
+activeHeadingLevel, activeLink, canInsert, canRedo, canUndo, isMarkActive, isNodeActive, 
+// marks
+toggleBold, toggleInlineCode, toggleItalic, toggleStrike, toggleUnderline, 
+// blocks
+insertHorizontalRule, setHeading, setParagraph, toggleBlockquote, toggleCodeBlock, toggleHeading, wrapInBlockquote, 
+// lists
+indentListItem, outdentListItem, splitListItemCommand, toggleBulletList, toggleOrderedList, 
+// links and images
+insertImage, setLink, unsetLink, 
+// history
+redo, undo, } from './commands.js';
+export { buildKeymap, shortcutFor, shortcuts, } from './keymap.js';
+export { createRegisteredPlugins, onEditorPluginsChange, registerEditorPlugin, } from './plugins.js';
+export { table, table_cell, table_header, table_row } from './tables.js';
+export { CARRIED_ATTR, clearSchemaExtensions, coreSchema, createSchema, onSchemaExtensionsChange, registerSchemaExtension, registeredSchemaExtensions, } from './extensions.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAsB,MAAM,WAAW,CAAA;AACnF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACpF,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,SAAS,EACT,aAAa,GACd,MAAM,UAAU,CAAA;AACjB,OAAO;AACL,aAAa;AACb,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,YAAY,EACZ,YAAY;AACZ,QAAQ;AACR,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,eAAe;AACf,SAAS;AACT,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,gBAAgB;AAChB,QAAQ;AACR,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB;AACjB,mBAAmB;AACnB,WAAW,EACX,OAAO,EACP,SAAS;AAGT,UAAU;AACV,IAAI,EACJ,IAAI,GACL,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,GAEV,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GAErB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACxE,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,GAE3B,MAAM,iBAAiB,CAAA"}

package/dist/keymap.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Keyboard shortcuts.
+ *
+ * Bindings follow whatever convention the largest number of users already have
+ * in their fingers, which usually means Word and Google Docs rather than
+ * anything invented here. Where those disagree, the web convention wins,
+ * because this editor lives in a browser.
+ *
+ * `Mod` resolves to Cmd on macOS and Ctrl elsewhere.
+ *
+ * ## On Tab
+ *
+ * Tab is deliberately NOT bound to list indentation, even though Word does it
+ * and users ask for it. Inside a `contenteditable`, capturing Tab removes the
+ * only way a keyboard user has to leave the editor, which is a WCAG 2.1.2
+ * keyboard-trap failure -- and for the institutional users who most need a free
+ * editor, that is a procurement blocker rather than a rough edge.
+ *
+ * Indentation uses `Mod-[` and `Mod-]` instead, matching Google Docs and
+ * VS Code. If Tab is ever added it must come with a documented escape (Escape
+ * then Tab, or a first-Tab-escapes heuristic) and real screen reader testing.
+ */
+import type { Command } from 'prosemirror-state';
+/** A shortcut, its command, and a human label for the help surface. */
+export interface Shortcut {
+    keys: string;
+    command: Command;
+    label: string;
+}
+/**
+ * The default shortcut table.
+ *
+ * Exported as data rather than as a finished keymap so that an integrator can
+ * remove a binding that collides with their own application, and so the help
+ * dialog and the toolbar tooltips can render the real bindings instead of a
+ * hand-maintained duplicate list that drifts.
+ */
+export declare const shortcuts: Shortcut[];
+/**
+ * Build the keymap bindings object.
+ *
+ * `Enter` chains: splitting a list item must be tried before ProseMirror's
+ * default paragraph split, or pressing Enter in a list creates a paragraph
+ * instead of the next bullet.
+ */
+export declare function buildKeymap(custom?: Record<string, Command>): Record<string, Command>;
+/** Human-readable shortcut for a label, with the platform's modifier symbol. */
+export declare function shortcutFor(label: string, isMac?: boolean): string | null;
+//# sourceMappingURL=keymap.d.ts.map

package/dist/keymap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keymap.d.ts","sourceRoot":"","sources":["../src/keymap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAmBhD,uEAAuE;AACvE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,EAAE,QAAQ,EA+B/B,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,UAAc,GAAG,MAAM,GAAG,IAAI,CAQ7E"}