@nerd-bible/wordgard 0.6.2-beta1 → 0.6.2-beta10

package/dist/collab.js

@@ -37,6 +37,7 @@ class CollabState {
     }
 }
 const collabConfig = /*@__PURE__*/GardState.Facet.define({
+    name: "collabConfig",
     combine(configs) {
         let combined = GardState.Facet.combineConfig(configs, {
             startVersion: 0,
@@ -52,12 +53,14 @@ const collabConfig = /*@__PURE__*/GardState.Facet.define({
     }
 });
 const collabReceive = /*@__PURE__*/Transaction.Effect.define({
+    name: "collabReceive",
     map(state, changes) {
         return changes.empty ? state
             : new CollabState(state.version, state.syncedDoc, state.nextUpdate, addUpdate(state.openUpdate, changes));
     }
 });
 const collabField = /*@__PURE__*/GardState.Field.define({
+    name: "collab",
     create(state) {
         return new CollabState(state.facet(collabConfig).startVersion, state.doc, null, null);
     },

package/dist/command.d.ts

@@ -518,10 +518,10 @@ declare const enter: Command.Pure;
 /**
 Delete the selection, or the unit after or before the selection.
 If that unit is the start or end of a textblock, this will try to
-join that textblock to the next one. Otherwise, if it is a
-character or leaf node, that is deleted. If none of that is
-possible and the cursor is in an empty textblock, this will delete
-the textblock.
+join that textblock to the next one. Otherwise, if the cursor is
+in an empty textblock, this will delete the textblock. Finally, if
+there is a character or leaf node in the given direction, that is
+deleted.
 
 When deleting backward at the start of a list item that has a
 sibling before it, this command will try to join those list items.
@@ -709,9 +709,17 @@ declare const redo: Command;
 
 /**
 If the cursor is in an empty textblock that can be lifted out of a
-parent, return a transaction that does this.
+parent, return a transaction that does this. Unless
+`splitListItem` is set to false, if the block is part of a
+continued list item, this function will split the item above the
+block before it lifts it.
 */
-declare function liftEmptyBlock(state: GardState): Transaction.Spec | false;
+declare function liftEmptyBlock(state: GardState, splitListItem?: boolean): Transaction.Spec | false;
+/**
+Lift the textblock that the cursor is at the start of out of its
+innermost parent, if possible.
+*/
+declare function liftTextblock(state: GardState): Transaction.Spec | false;
 /**
 If the selection is in a {@link Plot.Spec.preserveWhitespace
 `preserveWhitespace`} textblock, replace the selected content with
@@ -823,4 +831,4 @@ updated to perform those joins.
 */
 declare function autoJoinBlocks(state: GardState, tr: Transaction.Spec): Transaction.Spec;
 
-export { Command, Menu, autoJoinBlocks, canAddMarkInRange, clearNonFitting, deleteBackward, deleteEmptyPlot, deleteForward, deleteLine, deleteSelection, deleteToLineEnd, deleteUnit, deleteWord, doUnwrapBlock, enter, enterInCode, findUnwrappable, findWrappable, insertLineBreak, insertText, joinBackward, joinBlocks, joinForward, joinListItems, killToLineEnd, liftEmptyBlock, listIsActive, moveByLine, moveByPage, moveByUnit, moveByWord, moveToDocSide, moveToLineSide, moveToTextblockSide, redo, selectAll, selectedTextblocks, setAlignment, setDirection, setTextblockType, splitTextblock, toggleBlock, toggleEmphasis, toggleList, toggleMark, toggleStrong, toggleUnderline, transposeChars, undo, unwrapBlock, wrapBlock, wrapBlockRange, yankKilled };
+export { Command, Menu, autoJoinBlocks, canAddMarkInRange, clearNonFitting, deleteBackward, deleteEmptyPlot, deleteForward, deleteLine, deleteSelection, deleteToLineEnd, deleteUnit, deleteWord, doUnwrapBlock, enter, enterInCode, findUnwrappable, findWrappable, insertLineBreak, insertText, joinBackward, joinBlocks, joinForward, joinListItems, killToLineEnd, liftEmptyBlock, liftTextblock, listIsActive, moveByLine, moveByPage, moveByUnit, moveByWord, moveToDocSide, moveToLineSide, moveToTextblockSide, redo, selectAll, selectedTextblocks, setAlignment, setDirection, setTextblockType, splitTextblock, toggleBlock, toggleEmphasis, toggleList, toggleMark, toggleStrong, toggleUnderline, transposeChars, undo, unwrapBlock, wrapBlock, wrapBlockRange, yankKilled };

package/dist/command.js

@@ -5,6 +5,7 @@ import { findClusterBreak } from '@marijn/find-cluster-break';
 import { Alignment, Direction, Emphasis, Strong, Underline } from 'wordgard/types';
 
 const commandHandler = /*@__PURE__*/GardState.Facet.define({
+    name: "commandHandler",
     combine(handlers) {
         let map = new Map();
         for (let [cmd, handler] of handlers) {
@@ -45,12 +46,27 @@ const Command = /*@__PURE__*/(function (Command) {
     Command.dispatch = dispatch;
 ;return Command})({});
 
-function liftEmptyBlock(state) {
+function liftEmptyBlock(state, splitListItem = true) {
     if (!state.selection.isCursor)
         return false;
     let sel = state.sel, block = sel.head.textblockParent;
     if (!block || !sel.head.isAtStart(block) || !sel.head.isAtEnd(block))
         return false;
+    if (splitListItem && block.parent?.parent && block.index && block.parent.parent.node.type.hasRole(Node.Role.List))
+        return {
+            changes: { from: block.before, insert: [Plot.End, block.parent.node.tag] },
+            scrollIntoView: true,
+            userEvent: "split.list"
+        };
+    return liftBlock(state, block);
+}
+function liftTextblock(state) {
+    if (!state.selection.isCursor)
+        return false;
+    let { head } = state.sel, block = head.textblockParent;
+    return !block || !head.isAtStart(block) ? false : liftBlock(state, block);
+}
+function liftBlock(state, block) {
     let start = block.before, end = block.after, before = [], after = [];
     for (let level = block.parent, index = block.index, atStart = true, atEnd = true, first = true; level; first = false, index = level.index, level = level.parent) {
         if (!first && state.schema.canContain(level.node.type, block.node.type))
@@ -60,7 +76,7 @@ function liftEmptyBlock(state) {
                     { from: block.after, to: end, insert: after }
                 ],
                 scrollIntoView: true,
-                userEvent: "unwrap.empty"
+                userEvent: "unwrap"
             };
         if (level.node.isInline || level.node.type.isolating)
             break;
@@ -740,7 +756,7 @@ const insertText = ({ state }, { from, to, insert, userEvent }) => {
     let marks = (from == selection.from && to == selection.to && state.sel.activeMarks) ||
         state.doc.resolve(from).marks(state.doc.resolve(to));
     return {
-        changes: { from, to, insert: [Leaf.Text.of(insert, marks)], fit: true },
+        changes: { from, to, insert: insert ? [Leaf.text(insert, marks)] : undefined, fit: true },
         scrollIntoView: true,
         selection: (cx, changes) => GardSelection.near(cx, changes.mapPos(to, 1), -1),
         userEvent
@@ -792,8 +808,8 @@ const deleteUnit = ({ state }, dir) => {
     if (state.readOnly)
         return false;
     return deleteSelection(state) || (dir == "forward"
-        ? joinForward(state) || deleteForward(state) || deleteEmptyPlot(state, 1)
-        : joinListItems(state) || joinBackward(state) || deleteBackward(state) || deleteEmptyPlot(state, -1));
+        ? joinForward(state) || deleteEmptyPlot(state, 1) || deleteForward(state)
+        : joinListItems(state) || liftTextblock(state) || joinBackward(state) || deleteEmptyPlot(state, -1) || deleteBackward(state));
 };
 const deleteWord = ({ state }, dir) => {
     if (state.readOnly)
@@ -819,8 +835,9 @@ const deleteToLineEnd = (wg, dir) => {
         userEvent: "delete." + dir
     };
 };
-const addToKillBuffer = /*@__PURE__*/Transaction.Effect.define();
+const addToKillBuffer = /*@__PURE__*/Transaction.Effect.define({ name: "addToKillBuffer" });
 const killBuffer = /*@__PURE__*/GardState.Field.define({
+    name: "killBuffer",
     create() { return { content: [], active: false }; },
     update(value, tr) {
         let add = tr.effects.find(e => e.is(addToKillBuffer));
@@ -1303,9 +1320,10 @@ const Menu = /*@__PURE__*/(function (Menu) {
                 let src = Menu.Item.source.of(this);
                 this.extension = this.parent ? [src, this.parent] : src;
             }
+            toString() { return "Menu.Item"; }
         }
         Item.Base = Base;
-        Item.source = GardState.Facet.define();
+        Item.source = GardState.Facet.define({ name: "menuItem" });
     })(Item = Menu.Item || (Menu.Item = {}));
     class Button extends Item.Base {
         spec;
@@ -1380,6 +1398,7 @@ const Menu = /*@__PURE__*/(function (Menu) {
         template(...content) {
             return Template.new(this, content.length ? content : ["..."]);
         }
+        toString() { return "Menu.Group"; }
     }
     Menu.Group = Group;
     (function (Group) {
@@ -1541,4 +1560,4 @@ const Menu = /*@__PURE__*/(function (Menu) {
     Menu.resolve = resolve;
 ;return Menu})({});
 
-export { Command, Menu, autoJoinBlocks, canAddMarkInRange, clearNonFitting, deleteBackward, deleteEmptyPlot, deleteForward, deleteLine, deleteSelection, deleteToLineEnd, deleteUnit, deleteWord, doUnwrapBlock, enter, enterInCode, findUnwrappable, findWrappable, insertLineBreak, insertText, joinBackward, joinBlocks, joinForward, joinListItems, killToLineEnd, liftEmptyBlock, listIsActive, moveByLine, moveByPage, moveByUnit, moveByWord, moveToDocSide, moveToLineSide, moveToTextblockSide, redo, selectAll, selectedTextblocks, setAlignment, setDirection, setTextblockType, splitTextblock, toggleBlock, toggleEmphasis, toggleList, toggleMark, toggleStrong, toggleUnderline, transposeChars, undo, unwrapBlock, wrapBlock, wrapBlockRange, yankKilled };
+export { Command, Menu, autoJoinBlocks, canAddMarkInRange, clearNonFitting, deleteBackward, deleteEmptyPlot, deleteForward, deleteLine, deleteSelection, deleteToLineEnd, deleteUnit, deleteWord, doUnwrapBlock, enter, enterInCode, findUnwrappable, findWrappable, insertLineBreak, insertText, joinBackward, joinBlocks, joinForward, joinListItems, killToLineEnd, liftEmptyBlock, liftTextblock, listIsActive, moveByLine, moveByPage, moveByUnit, moveByWord, moveToDocSide, moveToLineSide, moveToTextblockSide, redo, selectAll, selectedTextblocks, setAlignment, setDirection, setTextblockType, splitTextblock, toggleBlock, toggleEmphasis, toggleList, toggleMark, toggleStrong, toggleUnderline, transposeChars, undo, unwrapBlock, wrapBlock, wrapBlockRange, yankKilled };

package/dist/doc.d.ts

@@ -1310,12 +1310,19 @@ declare namespace Node {
         implies membership of its parent groups.
         */
         readonly parent: Group | undefined;
+        /**
+        This group's debug name.
+        */
+        readonly name: string | null;
         private tag;
         private constructor();
         /**
         Define a custom node group.
         */
-        static define(parent?: Group): Group;
+        static define(spec?: {
+            parent?: Group;
+            name?: string;
+        }): Group;
         /**
         A group that contains every node type.
         */
@@ -1374,11 +1381,15 @@ declare namespace Node {
     whether a given node has the role attached.
     */
     class Role {
+        /**
+        This role's name.
+        */
+        readonly name: string | null;
         private constructor();
         /**
         Define a new role.
         */
-        static define(): Role;
+        static define(name?: string): Role;
         /**
         This role indicates that a plot contains code, and makes some
         commands behave differently inside such a plot.

package/dist/doc.js

@@ -412,7 +412,7 @@ const Attributes = /*@__PURE__*/(function (Attributes) {
                 score--;
                 iA += 2;
             }
-            else if (iB < b.length && iA == a.length) {
+            else if (iB < b.length) {
                 score--;
                 iB += 2;
             }
@@ -867,8 +867,8 @@ class Pos {
         let d = this.depth;
         if (depth > d)
             throw new RangeError("Asking for parent deeper than position depth");
-        for (let d = this.depth, p = this.parent;; p = p.parent)
-            if (d == depth)
+        for (let p = this.parent;; p = p.parent)
+            if (d-- == depth)
                 return p;
     }
     isAtStart(parent) {
@@ -1093,6 +1093,7 @@ class BaseType {
     get isBlock() { return (this.flags & 1) == 0; }
     get isAtom() { return (this.flags & 4) > 0; }
     get isSelectable() { return (this.flags & 32) > 0; }
+    toString() { return this.name; }
 }
 class BaseTag {
     param;
@@ -1131,29 +1132,48 @@ const Node = /*@__PURE__*/(function (Node) {
     })(Node.Type || (Node.Type = {}));
     class Group {
         parent;
+        name;
         constructor(
-        parent) {
+        parent, 
+        name) {
             this.parent = parent;
+            this.name = name;
         }
-        static define(parent) { return new Group(parent); }
-        static All = Group.define();
-        static Inline = Group.define();
-        static Block = Group.define();
-        static Leaf = Group.define();
-        static Plot = Group.define();
-        static Textblock = Group.define();
-        static Content = Group.define();
-        static TableCell = Group.define();
-        static ListItem = Group.define();
+        static define(spec = {}) {
+            return new Group(spec.parent, spec.name || null);
+        }
+        static All = Group.define({ name: "All" });
+        static Inline = Group.define({ name: "Inline" });
+        static Block = Group.define({ name: "Block" });
+        static Leaf = Group.define({ name: "Leaf" });
+        static Plot = Group.define({ name: "Plot" });
+        static Textblock = Group.define({ name: "Textblock" });
+        static Content = Group.define({ name: "Content" });
+        static TableCell = Group.define({ name: "TableCell" });
+        static ListItem = Group.define({ name: "ListItem" });
         static builtin = [Group.All, Group.Inline, Group.Block, Group.Leaf, Group.Plot, Group.Textblock];
+        toString() { return "Node.Group" + (this.name ? ":" + this.name : ""); }
     }
     Node.Group = Group;
+    function queryToString(q) {
+        if ("and" in q)
+            return `and(${q.and.map(queryToString)})`;
+        if (Array.isArray(q))
+            return `or(q.map(queryToString))`;
+        return String(q);
+    }
+    Node.queryToString = queryToString;
     class Role {
-        constructor() { }
-        static define() { return new Role; }
-        static Code = Role.define();
-        static List = Role.define();
-        static LineBreak = Role.define();
+        name;
+        constructor(
+        name) {
+            this.name = name;
+        }
+        static define(name) { return new Role(name || null); }
+        static Code = Role.define("Code");
+        static List = Role.define("List");
+        static LineBreak = Role.define("LineBreak");
+        toString() { return "Node.Role" + (this.name ? ":" + this.name : ""); }
     }
     Node.Role = Role;
 ;return Node})({});
@@ -1207,6 +1227,8 @@ class Leaf extends BaseTag {
         return Leaf.Text.of(this.param.slice(Math.max(from, 0), Math.max(0, to)), this.marks);
     }
     static text(text, marks = Mark.none) {
+        if (!text)
+            throw new Error("Cannot create empty text nodes");
         return Leaf.Text.of(text, marks);
     }
     toString() {
@@ -1390,6 +1412,8 @@ class Plot {
         constructor(type, param, marks) {
             super(param, marks);
             this.type = type;
+            if (this.type.isDoc && marks.length)
+                throw new Error("Document nodes cannot have marks");
         }
         static new(type, param, marks) {
             return new Tag(type, param, marks);
@@ -1995,11 +2019,9 @@ class Builder {
         return this.schema.doc(this.stack.children);
     }
 }
-function isAdd(m) { return !!m.add; }
-function isRemove(m) { return !!m.remove; }
 function applyModifications(modifications, marks, type) {
     for (const m of modifications) {
-        if (isAdd(m)) {
+        if ("add" in m) {
             marks = m.add.addToSet(marks);
         }
         else {
@@ -2009,7 +2031,7 @@ function applyModifications(modifications, marks, type) {
     return marks;
 }
 function modificationToJSON(m) {
-    return isAdd(m) ? { add: m.add.name, value: m.add.value } : { remove: m.remove.name, value: m.remove.value };
+    return "add" in m ? { add: m.add.name, value: m.add.value } : { remove: m.remove.name, value: m.remove.value };
 }
 function modificationFromJSON(schema, json) {
     let { add, remove } = json;
@@ -2034,7 +2056,7 @@ function compareModifications(a, b) {
     return true;
 }
 function compareModification(a, b) {
-    return isAdd(a) ? isAdd(b) && a.add.eq(b.add) : isRemove(b) && a.remove.eq(b.remove);
+    return "add" in a ? "add" in b && a.add.eq(b.add) : "remove" in b && a.remove.eq(b.remove);
 }
 function isNatNum(value) {
     return typeof value == "number" && Math.floor(value) == value && value >= 0;
@@ -2371,7 +2393,7 @@ class ChangeSet {
             }
             else if (data) {
                 text += `[${data.map(mod => {
-                    return `${isAdd(mod) ? "+" + mod.add : "-" + mod.remove}`;
+                    return `${"add" in mod ? "+" + mod.add : "-" + mod.remove}`;
                 })}]`;
             }
             if (text)
@@ -2397,6 +2419,36 @@ class ChangeSetBuilder {
     sections = [];
     data = [];
     pos = 0;
+    addSection(from, to, ins, value) {
+        if (from >= this.pos) {
+            addSection(this.sections, this.data, from - this.pos, -1, null);
+            addSection(this.sections, this.data, to - from, ins, value);
+            this.pos = to;
+            return true;
+        }
+        if (this.sections.length && this.sections[0] > to && this.sections[1] == -1) {
+            this.spliceSection(0, from, to, ins, value);
+            return true;
+        }
+        for (let pos = this.pos, i = this.sections.length; i > 2 && pos > to;) {
+            let nextIns = this.sections[--i], nextLen = this.sections[--i];
+            let start = pos - nextLen;
+            if (nextIns == -1 && start < from) {
+                this.spliceSection(i, from - start, to - start, ins, value);
+                return true;
+            }
+            pos = start;
+        }
+        return false;
+    }
+    spliceSection(i, from, to, ins, value) {
+        let sections = [], data = [];
+        addSection(sections, data, from, -1, null);
+        addSection(sections, data, to - from, ins, value);
+        addSection(sections, data, this.sections[i] - to, -1, null);
+        this.sections.splice(i, 2, ...sections);
+        this.data.splice(i >> 1, 1, ...data);
+    }
 }
 function sliceLen(tokens) {
     return tokens.reduce((l, e) => l + (e.tokenType == Token.Type.Node ? e.length : 1), 0);
@@ -2417,14 +2469,11 @@ function createChangeSet(doc, spec, mayCorrect = true) {
         accum = accum ? accum.compose(transform(set, accum, doc, false, false).set) : set;
     };
     let section = (from, to, ins, value) => {
-        if (!cur || from < cur.pos) {
+        if (!cur?.addSection(from, to, ins, value)) {
             flush();
             cur = new ChangeSetBuilder(doc.length);
+            cur.addSection(from, to, ins, value);
         }
-        if (from > cur.pos)
-            addSection(cur.sections, cur.data, from - cur.pos, -1, null);
-        addSection(cur.sections, cur.data, to - from, ins, value);
-        cur.pos = to;
     };
     let build = (spec) => {
         if (Array.isArray(spec)) {
@@ -2474,17 +2523,20 @@ function createChangeSet(doc, spec, mayCorrect = true) {
                 if (remove) {
                     let mods = [{ remove }];
                     markableSections(doc, from, to, remove.type.spanning, (node, from, to) => {
-                        const has = remove.isInSet(node.tag.marks);
-                        if (!has || !doc.schema.markAllowed(remove.type, node.type))
-                            return false;
-                        let modsHere = mods;
                         if (remove.type.set) {
-                            let left = subtractSet(remove.value, has.value, remove.type.set);
+                            let has = remove.type.isInSet(node.tag.marks);
+                            if (!has)
+                                return false;
+                            let left = remove.value.filter(a => has.value.some(b => remove.type.set(a, b) == 0));
                             if (!left.length)
                                 return false;
-                            modsHere = [{ remove: remove.type.of(left) }];
+                            section(from, to, -2, left.length == remove.value.length ? mods : [{ remove: remove.type.of(left) }]);
+                        }
+                        else {
+                            if (!remove.isInSet(node.tag.marks))
+                                return false;
+                            section(from, to, -2, mods);
                         }
-                        section(from, to, -2, modsHere);
                         return true;
                     });
                 }
@@ -2631,16 +2683,16 @@ function filterMods(mods, against) {
     return mods.filter(m => !against.some(a => modCancels(a, m)));
 }
 function modCancels(mod, other) {
-    if (isAdd(other)) {
-        return isAdd(mod) ? mod.add.type == other.add.type && !mod.add.type.set : mod.remove.eq(other.add);
+    if ("add" in other) {
+        return "add" in mod ? mod.add.type == other.add.type && !mod.add.type.set : mod.remove.eq(other.add);
     }
     else {
-        return isAdd(mod) && mod.add.eq(isAdd(other) ? other.add : other.remove);
+        return "add" in mod && mod.add.eq(other.remove);
     }
 }
 function invertMods(mods, target) {
     return mods.map(mod => {
-        if (isRemove(mod))
+        if ("remove" in mod)
             return { add: mod.remove };
         if (!mod.add.type.set) {
             let existed = mod.add.type.isInSet(target.marks);

package/dist/editor.d.ts

@@ -8,6 +8,7 @@ import { PointSet, Set, RangeSet } from 'wordgard/set';
 
 type MakeSelectionStyle = (wg: Wordgard, event: MouseEvent) => Wordgard.MouseSelectionStyle | null;
 
+import Mark_ = Mark;
 /**
 A widget describes a piece of DOM content that can be used to
 render a node, a part of a node, or an extra element added via a
@@ -193,8 +194,8 @@ declare namespace Decoration {
         /**
         Override the shape used for a given mark inside the editor.
         */
-        function shape<V>(type: Mark.Type<V>, shape: Shape.Element<V> | Shape.Attribute<V> | Shape.Attributes<V>): GardState.Extension;
-        function shape(mark: Mark<null>, shape: Shape.Element<null> | Shape.Attribute<null> | Shape.Attributes<null>): GardState.Extension;
+        function shape<V>(type: Mark_.Type<V>, shape: Shape.Element<V> | Shape.Attribute<V> | Shape.Attributes<V>): GardState.Extension;
+        function shape(mark: Mark_<null>, shape: Shape.Element<null> | Shape.Attribute<null> | Shape.Attributes<null>): GardState.Extension;
     }
     /**
     A point decoration is a decoration that targets a given position
@@ -375,10 +376,11 @@ declare const enum TileFlag {
     Composition = 128,
     Synced = 256,// Node has been synced. DOM content matches child list / text content, child array becomes read-only
     Atom = 512,// Composite tile whose length isn't determined by child length
-    HasContent = 1024,// EltTile whose elt has a content hole
-    AfterContent = 2048,// Tiles that sit after their parent's content position
-    ContentNotLast = 4096,// EltTile that has children with AfterContent flag
-    Dirty = 8192
+    Uneditable = 1024,// Tile's DOM is uneditable
+    HasContent = 2048,// EltTile whose elt has a content hole
+    AfterContent = 4096,// Tiles that sit after their parent's content position
+    ContentNotLast = 8192,// EltTile that has children with AfterContent flag
+    Dirty = 16384
 }
 declare const enum Orientation {
     Row = 0,
@@ -420,14 +422,15 @@ declare abstract class Tile {
     get boundary(): 0 | 1;
     get firstChild(): Tile | null;
     get lastChild(): Tile | null;
-    get nodeParent(): Tile;
     ignoreEvent(event: Event): boolean;
     get ignoreMutations(): boolean;
     toString(): string;
     abstract sync(): void;
     connect(): void;
     disconnect(reused?: Map<Tile, Reused>): void;
-    nearestNode(): Tile;
+    nearestNode(): Tile & {
+        tag: Node$1.Tag;
+    };
     markDirty(): void;
     posAtCoords(state: GardState, x: number, y: number): CoordPos;
     abstract posAtCoordsInner(start: number, state: GardState, x: number, y: number, textblock: TextblockMap | null, orientation: Orientation): CoordPos;
@@ -437,6 +440,7 @@ declare class CompositeTile extends Tile {
     children: Tile[];
     dom: Element;
     addChild(child: Tile): void;
+    putChild(child: Tile, index: number): void;
     sync(): void;
     syncChildren(): void;
     posAtCoordsInner(start: number, state: GardState, x: number, y: number, textblock: TextblockMap | null, orientation: Orientation): CoordPos;
@@ -727,7 +731,13 @@ declare class Wordgard {
     Facet that allows you to register handlers to override paste
     behavior.
     */
-    static pasteHandler: GardState.Facet<(wg: Wordgard, event: InputEvent, slice: wordgard_doc.Slice) => boolean, readonly ((wg: Wordgard, event: InputEvent, slice: wordgard_doc.Slice) => boolean)[]>;
+    static pasteHandler: GardState.Facet<(wg: Wordgard, event: InputEvent | null, slice: wordgard_doc.Slice, html: string, text: string) => boolean, readonly ((wg: Wordgard, event: InputEvent | null, slice: wordgard_doc.Slice, html: string, text: string) => boolean)[]>;
+    /**
+    Perform a paste with the given content. This will run {@link
+    Wordgard.pasteHandler paste handlers} and, if none handles the
+    paste, fall back to the default handling.
+    */
+    paste(html: string, text?: string): void;
     /**
     Facet for custom drop handlers. When the drop is done inside the
     editor and should move an existing range, the `move` parameter
@@ -853,7 +863,7 @@ declare class Wordgard {
     the editor's {@link Wordgard.dom wrapper element} (to which the
     scope class will be added) need to be explicitly differentiated
     by adding an `&` to the selector for that element—for example
-    `&:has(wg-content:focus)`.
+    `&.wg-focused`.
     */
     static theme(spec: Record<string, StyleSpec>): GardState.Extension;
     /**
@@ -922,6 +932,11 @@ declare class Wordgard {
     part of the editor (for example a gutter).
     */
     static coveredMargins: GardState.Facet<(wg: Wordgard) => Partial<DOMRect> | null, readonly ((wg: Wordgard) => Partial<DOMRect> | null)[]>;
+    /**
+    Given a DOM element that may be a Wordgard editor, retrieve its
+    editor instance.
+    */
+    static findFromDOM(elt: Element): Wordgard | null;
 }
 declare namespace Wordgard {
     /**