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

package/README.md

@@ -0,0 +1,115 @@
+# @openleaf-editor/core
+
+The schema, commands, HTML input and output, and the content-preservation
+layer. No UI, no framework dependencies.
+
+> **Editor output is untrusted input.** Whatever the editor produces — and
+> whatever a user pasted into it — must be sanitized **on your server** before it
+> is stored or rendered as HTML. Client-side sanitization is a user-experience
+> feature, not a security control: anything the editor strips can be put back
+> with developer tools, because the editor runs under the user's control.
+>
+> [`@openleaf-editor/sanitize`](https://github.com/PeytonNowlin/openleaf/tree/main/packages/sanitize) ships the
+> canonical allowlist as data and generates configuration for DOMPurify, Python
+> `bleach` and PHP HTMLPurifier from it, so client and server enforce the same
+> rules. Read [SECURITY.md](https://github.com/PeytonNowlin/openleaf/blob/main/SECURITY.md) before you ship.
+
+## Install
+
+```sh
+npm install @openleaf-editor/core@beta
+```
+
+Keep every `@openleaf-editor/*` package on the same version. They pin each other
+exactly, so mixing versions installs two copies of the schema and the toolbar
+registry -- and a node built by one is not a node type the other accepts.
+
+## What it is for
+
+Most integrations never import this directly -- they use
+[`@openleaf-editor/element`](../element), which builds an editor out of it. You
+want `core` when you are embedding ProseMirror yourself, running HTML through the
+schema on a server, or writing a plugin.
+
+```ts
+import { coreSchema, parseHtml, serializeHtml, roundTrip } from '@openleaf-editor/core'
+
+roundTrip('<p style="text-align:center">hi</p>')
+// '<p style="text-align:center">hi</p>'
+roundTrip('<p><strong class="brand-name">Acme</strong></p>')
+// '<p><strong class="brand-name">Acme</strong></p>'
+```
+
+## The preservation layer is the point
+
+A schema-based editor has to decide what it understands, and the usual answer for
+everything else is to delete it. `core` keeps unrecognised markup as a
+selectable, movable atom that round-trips byte-for-byte instead.
+
+Block-level tags the HTML parser will not keep inside a `<p>` (`div`, `section`,
+and the rest of `CLOSES_OPEN_P`) are stored as block atoms even when they appear
+inside a blockquote or list item. Treating them as inline would wrap them in a
+paragraph the next parse splits, growing two empty paragraphs on every save.
+
+That is why the schema is larger than it might look: `<table>`, `<figure>`,
+`<details>`, `<video>`, allowlisted `<iframe>` embeds and the typography marks are
+all modelled here rather than in an opt-in plugin. Not because every deployment
+edits them, but because a node type that is absent is content that becomes an
+atom -- and "we kept your tables and you may not touch them" is not something you
+can tell a CMS with a fifteen-year archive. A `<figcaption>` is only a modelled
+node inside a modelled `<figure>`; outside one it is that same atom, so it is
+never emitted inside a `<p>` the next parse would split.
+
+The editing chrome for those things is opt-in. The storage format is not.
+
+## Commands and predicates
+
+Commands take ProseMirror's `(state, dispatch, view)` shape. Every one has a
+matching predicate, so a control can show its state without duplicating the
+logic:
+
+```ts
+import { setFontFamily, activeFontFamily } from '@openleaf-editor/core'
+
+activeFontFamily(view.state)                          // 'Georgia' | null
+setFontFamily('Georgia')(view.state, view.dispatch)   // boolean
+```
+
+`selectedImage` / `updateImage` (and the matching media pair) are how the
+insert-image control also edits: a `NodeSelection` on the picture or its
+`<figure>` prefills the dialog, and Save uses `setNodeMarkup` so caption,
+class and dimensions survive.
+
+A predicate returns `null` for a mixed selection rather than the first value it
+finds -- a dropdown showing "Georgia" for a range that is half Georgia would be
+worse than showing nothing.
+
+Block-type commands (`setHeading`, `setParagraph`, `toggleCodeBlock`) refuse a
+textblock whose content the destination cannot hold. A captioned `<figure>` is a
+textblock in the schema (`content: 'inline+'`) but not a paragraph: converting it
+used to produce an `<h2>` holding an image and a `<figcaption>`, and
+`toggleCodeBlock` threw. `canInsert` also stops at an isolating node, so
+inserting an `<hr>` cannot split a figure.
+
+## Isolating selections
+
+If you construct a ProseMirror editor yourself, install
+`isolatingSelectionPlugin()` next to `history()` and the keymap. A
+`TextSelection` that starts in a `<blockquote>` and ends inside a following
+`<details>` otherwise throws on the next keystroke (`Cannot join details onto
+blockquote`), and the recovery rewrites the document with no undo entry.
+`<openleaf-editor>` already installs the plugin. Details are in
+[authoring-plugins.md §4.11](../../docs/authoring-plugins.md#411-isolating-nodes-clamp-the-selection-at-their-boundary).
+
+## Safety
+
+URL, CSS and embed rules come from
+[`@openleaf-editor/content-policy`](../content-policy), shared with
+[`@openleaf-editor/sanitize`](../sanitize) so the editor and your server cannot
+disagree. `javascript:` URLs, `on*` handlers and unallowlisted iframes are dropped
+on the way in, with tests. Sanitize on the server anyway -- anything a client
+strips can be put back with developer tools.
+
+## License
+
+Apache-2.0.

package/dist/autolink.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Turn a typed URL into a link when the author finishes it.
+ *
+ * Space and Enter are the commit keys, matching the behaviour authors already
+ * have in mail clients and office software. The plugin never rewrites a range
+ * that is already a link, and it refuses anything `isSafeUrl` would drop, so
+ * typing `javascript:` cannot become a mark the serializer would then emit.
+ */
+import { Plugin } from 'prosemirror-state';
+export declare function hrefFromTypedUrl(raw: string): string | null;
+export declare function autolinkPlugin(): Plugin;
+//# sourceMappingURL=autolink.d.ts.map

package/dist/autolink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autolink.d.ts","sourceRoot":"","sources":["../src/autolink.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAiD,MAAM,mBAAmB,CAAA;AA8CzF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK3D;AAuCD,wBAAgB,cAAc,IAAI,MAAM,CA0BvC"}

package/dist/autolink.js

@@ -0,0 +1,136 @@
+/**
+ * Turn a typed URL into a link when the author finishes it.
+ *
+ * Space and Enter are the commit keys, matching the behaviour authors already
+ * have in mail clients and office software. The plugin never rewrites a range
+ * that is already a link, and it refuses anything `isSafeUrl` would drop, so
+ * typing `javascript:` cannot become a mark the serializer would then emit.
+ */
+import { Plugin, PluginKey } from 'prosemirror-state';
+import { isSafeUrl } from './url.js';
+const key = new PluginKey('openleaf-autolink');
+/**
+ * A URL at the end of a typed run. Parentheses are in the match so
+ * `(www.example.com)` and `Foo_(bar)` can both be considered; the strip below
+ * decides which trailing `)` is prose and which is the URL. Angle brackets stay
+ * out because they are HTML delimiters, not URL characters we want to mark.
+ */
+const TRAILING_URL = /(?:https?:\/\/|www\.)[^\s<>]+$/i;
+/**
+ * Closers that end a URL in a sentence, a citation, or quotes. `)` is handled
+ * separately: a trailing one is prose when unmatched, and part of the URL when
+ * it balances an earlier `(`.
+ */
+const TRAILING_PUNCTUATION = /[.,;:!?\]}'"]/;
+function stripTrailingUrlPunctuation(token) {
+    let s = token;
+    while (s.length > 0) {
+        const last = s.charAt(s.length - 1);
+        if (TRAILING_PUNCTUATION.test(last)) {
+            s = s.slice(0, -1);
+            continue;
+        }
+        if (last === ')') {
+            let opens = 0;
+            let closes = 0;
+            for (let i = 0; i < s.length; i++) {
+                const ch = s.charAt(i);
+                if (ch === '(')
+                    opens++;
+                else if (ch === ')')
+                    closes++;
+            }
+            if (closes > opens) {
+                s = s.slice(0, -1);
+                continue;
+            }
+        }
+        break;
+    }
+    return s;
+}
+export function hrefFromTypedUrl(raw) {
+    const trimmed = stripTrailingUrlPunctuation(raw);
+    if (!trimmed)
+        return null;
+    const href = /^www\./i.test(trimmed) ? `https://${trimmed}` : trimmed;
+    return isSafeUrl(href) ? href : null;
+}
+function trailingUrl(state, end) {
+    const $end = state.doc.resolve(end);
+    if (!$end.parent.isTextblock)
+        return null;
+    const parentStart = $end.start();
+    const raw = $end.parent.textBetween(0, $end.parentOffset, undefined, '\ufffc');
+    const trimmed = raw.replace(/[\s\u00a0]+$/, '');
+    const match = TRAILING_URL.exec(trimmed);
+    if (!match)
+        return null;
+    const token = match[0];
+    const bare = stripTrailingUrlPunctuation(token);
+    if (!bare)
+        return null;
+    const href = hrefFromTypedUrl(bare);
+    if (!href)
+        return null;
+    const from = parentStart + (match.index ?? 0);
+    const to = from + bare.length;
+    if (from >= to)
+        return null;
+    const link = state.schema.marks['link'];
+    if (!link)
+        return null;
+    if (state.doc.rangeHasMark(from, to, link))
+        return null;
+    return { from, to, href };
+}
+function applyAutolink(state, end) {
+    const found = trailingUrl(state, end);
+    if (!found)
+        return null;
+    const link = state.schema.marks['link'];
+    if (!link)
+        return null;
+    return state.tr.addMark(found.from, found.to, link.create({ href: found.href }));
+}
+function maybeAutolink(view, end) {
+    const tr = applyAutolink(view.state, end);
+    if (!tr)
+        return false;
+    view.dispatch(tr);
+    return true;
+}
+export function autolinkPlugin() {
+    return new Plugin({
+        key,
+        appendTransaction(transactions, _oldState, newState) {
+            if (!transactions.some((tr) => tr.docChanged))
+                return null;
+            if (transactions.some((tr) => tr.getMeta(key)))
+                return null;
+            const $from = newState.selection.$from;
+            if (!$from.parent.isTextblock || $from.parentOffset === 0)
+                return null;
+            const prev = $from.parent.textBetween($from.parentOffset - 1, $from.parentOffset);
+            if (prev !== ' ' && prev !== '\u00a0')
+                return null;
+            const tr = applyAutolink(newState, $from.pos);
+            return tr ? tr.setMeta(key, true) : null;
+        },
+        props: {
+            handleTextInput(view, from, _to, text) {
+                if (text !== ' ' && text !== '\u00a0')
+                    return false;
+                maybeAutolink(view, from);
+                return false;
+            },
+            handleKeyDown(view, event) {
+                if (event.key !== 'Enter' || event.shiftKey)
+                    return false;
+                maybeAutolink(view, view.state.selection.from);
+                return false;
+            },
+        },
+    });
+}
+//# sourceMappingURL=autolink.js.map

package/dist/autolink.js.map

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

package/dist/command-helpers.d.ts

@@ -0,0 +1,8 @@
+import type { MarkType, NodeType } from 'prosemirror-model';
+import type { Command, EditorState } from 'prosemirror-state';
+export declare function markIn(state: EditorState, name: string): MarkType | undefined;
+export declare function nodeIn(state: EditorState, name: string): NodeType | undefined;
+export declare function markCommand(name: string, build: (type: MarkType) => Command): Command;
+export declare function nodeCommand(name: string, build: (type: NodeType) => Command): Command;
+export declare function canInsertNode(state: EditorState, nodeName: string): boolean;
+//# sourceMappingURL=command-helpers.d.ts.map

package/dist/command-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-helpers.d.ts","sourceRoot":"","sources":["../src/command-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE7D,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE7E;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE7E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAKrF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAKrF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAa3E"}

package/dist/command-helpers.js

@@ -0,0 +1,36 @@
+export function markIn(state, name) {
+    return state.schema.marks[name];
+}
+export function nodeIn(state, name) {
+    return state.schema.nodes[name];
+}
+export function markCommand(name, build) {
+    return (state, dispatch, view) => {
+        const type = markIn(state, name);
+        return type ? build(type)(state, dispatch, view) : false;
+    };
+}
+export function nodeCommand(name, build) {
+    return (state, dispatch, view) => {
+        const type = nodeIn(state, name);
+        return type ? build(type)(state, dispatch, view) : false;
+    };
+}
+export function canInsertNode(state, nodeName) {
+    const type = nodeIn(state, nodeName);
+    if (!type)
+        return false;
+    const { $from } = state.selection;
+    for (let depth = $from.depth; depth >= 0; depth -= 1) {
+        const index = $from.index(depth);
+        if ($from.node(depth).canReplaceWith(index, index, type))
+            return true;
+        // Isolating nodes (figure, table cells, details, preserved atoms) must not
+        // be split to make room for a sibling. Walking past them is how
+        // insertHorizontalRule used to bisect a captioned image.
+        if ($from.node(depth).type.spec.isolating)
+            return false;
+    }
+    return false;
+}
+//# sourceMappingURL=command-helpers.js.map

package/dist/command-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-helpers.js","sourceRoot":"","sources":["../src/command-helpers.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,MAAM,CAAC,KAAkB,EAAE,IAAY;IACrD,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAkB,EAAE,IAAY;IACrD,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAkC;IAC1E,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAChC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAC1D,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAkC;IAC1E,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAChC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAC1D,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAkB,EAAE,QAAgB;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IACvB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,SAAS,CAAA;IACjC,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAChC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QACrE,2EAA2E;QAC3E,gEAAgE;QAChE,yDAAyD;QACzD,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAA;IACzD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/commands.d.ts

@@ -12,9 +12,9 @@
  * reports whether it *could* apply, without doing anything. That is what makes
  * button disabled-state free -- the same function answers "can I?" and "do it".
  */
-import type { Attrs } from 'prosemirror-model';
+import { type Attrs } from 'prosemirror-model';
 import type { Command, EditorState } from 'prosemirror-state';
-import { type Align } from './css.js';
+import { type Align, type Dir, type ListStyle } from './css.js';
 /**
  * Is this mark active at the cursor, or across the selection?
  *
@@ -37,7 +37,19 @@ export declare const toggleItalic: Command;
 export declare const toggleUnderline: Command;
 export declare const toggleStrike: Command;
 export declare const toggleInlineCode: Command;
+export declare const toggleSubscript: Command;
+export declare const toggleSuperscript: Command;
 export declare const setParagraph: Command;
+/**
+ * `level` is the only attribute this command decides; everything else about the
+ * block is the author's and travels with it.
+ *
+ * `id` needs no special case any more, and that is a property of the schema
+ * rather than a shortcut: `paragraph` does not declare an `id`, so `carryOver`
+ * cannot promote one from a paragraph, while a heading's own `id` is declared
+ * and does come across. A paragraph stored as `<p id="x">` keeps its id anyway,
+ * through the carried residue, which is where an unmodelled attribute belongs.
+ */
 export declare function setHeading(level: number): Command;
 /**
  * Toggle a heading level: applying the level you are already in returns the
@@ -54,6 +66,16 @@ export declare const toggleOrderedList: Command;
 export declare const splitListItemCommand: Command;
 export declare const indentListItem: Command;
 export declare const outdentListItem: Command;
+/**
+ * Indent: nest a list item when the selection is in a list, otherwise add a
+ * `padding-inline-start` step on the text blocks. Outdent is the reverse, and
+ * lifting a top-level list item out of its list is still how you leave a list.
+ */
+export declare const indent: Command;
+export declare const outdent: Command;
+export declare function activeIndent(state: EditorState): number | null;
+export declare function setListStyle(style: ListStyle | null): Command;
+export declare function activeListStyle(state: EditorState): ListStyle | null;
 /**
  * The alignment of the selection, or null when it has none or is mixed.
  *
@@ -88,35 +110,34 @@ export declare function setTextAlign(align: Align | null): Command;
  * un-centre button that does not exist.
  */
 export declare function toggleTextAlign(align: Align): Command;
+export declare function setLineHeight(value: string | null): Command;
+export declare function activeLineHeight(state: EditorState): string | null;
+export declare function setDir(dir: Dir | null): Command;
+export declare function toggleDir(dir: Dir): Command;
+export declare function activeDir(state: EditorState): Dir | null;
 export declare function setTextColor(color: string): Command;
 export declare function setBackgroundColor(color: string): Command;
 export declare const clearTextColor: Command;
 export declare const clearBackgroundColor: Command;
 export declare function activeTextColor(state: EditorState): string | null;
 export declare function activeBackgroundColor(state: EditorState): string | null;
-export interface LinkAttrs {
-    href: string;
-    title?: string | null;
-    target?: string | null;
-    rel?: string | null;
-}
+export declare function setFontFamily(family: string | null): Command;
+export declare function setFontSize(size: string | null): Command;
+export declare function setLanguage(lang: string | null): Command;
+export declare function activeFontFamily(state: EditorState): string | null;
+export declare function activeFontSize(state: EditorState): string | null;
+export declare function activeLanguage(state: EditorState): string | null;
 /**
- * Apply or update a link across the selection.
+ * Strip character formatting and block decoration from the selection.
  *
- * Removes any existing link first: without that, updating a link that only
- * partially overlaps the selection leaves two adjacent links with different
- * hrefs, which looks fine and is wrong.
+ * Links stay: they are a destination, not a look. Direction stays: it is
+ * content. Language stays: it is the same kind of fact as direction, only
+ * modelled as a mark (`<span lang>`) rather than a node attribute. Headings
+ * and lists stay: they are structure. Alignment, indent, line height, fonts,
+ * colours, and the common character marks go.
  */
-export declare function setLink(attrs: LinkAttrs): Command;
-export declare const unsetLink: Command;
-export interface ImageAttrs {
-    src: string;
-    alt?: string | null;
-    title?: string | null;
-    width?: string | null;
-    height?: string | null;
-}
-export declare function insertImage(attrs: ImageAttrs): Command;
+export declare const clearFormatting: Command;
+export { insertAudio, insertDetails, insertHtml, insertIframe, insertImage, insertNamedAnchor, insertNonBreakingSpace, insertPageBreak, insertText, insertVideo, selectedImage, selectedMedia, setHeadingId, setLink, unsetLink, updateImage, updateMedia, type ImageAttrs, type LinkAttrs, type MediaAttrs, type MediaSource, type SelectedImage, type SelectedMedia, } from './insert-commands.js';
 export { redo, undo } from 'prosemirror-history';
 export declare const canUndo: (state: EditorState) => boolean;
 export declare const canRedo: (state: EditorState) => boolean;

package/dist/commands.d.ts.map

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