@nerd-bible/wordgard 0.6.2-beta7 → 0.6.2-beta9

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.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) {
@@ -834,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));
@@ -1318,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;
@@ -1395,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) {

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

@@ -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})({});
@@ -1392,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);

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
@@ -730,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
@@ -856,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;
     /**
@@ -925,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 {
     /**