@nldd/design-system 0.8.86 → 0.8.88

package/dist/components/inputs/text-editor/text-editor.emphasis.js

@@ -0,0 +1,229 @@
+import { EditorSelection, StateEffect, StateField } from '@codemirror/state';
+import { ViewPlugin } from '@codemirror/view';
+import { enclosingNamed, enclosingNode } from './text-editor.syntax.js';
+/* Emphasis that holds while you type inside it.
+ *
+ * CommonMark's flanking rules decide whether a `**` opens or closes, and a
+ * closing run may not follow whitespace. So `**woord**` is bold and, the moment
+ * a space is typed before the closing markers, `**woord **` is not: the line
+ * falls back to plain text (the weight, the markers' size, the line height)
+ * until the next letter arrives. A bold sentence flickers on every word
+ * boundary (#213).
+ *
+ * The parse is right; showing it that eagerly is not. So the emphasis the caret
+ * is in is remembered, and while the caret stays between its markers the styling
+ * is held whatever the parser says. When the hold ends (the caret leaves, the
+ * editor blurs, a paragraph break cuts the run) the whitespace that broke it is
+ * moved outside the markers, `**woord** `. That is what wrapping a selection
+ * produces too (#212), so bold made by typing and bold made by selecting end
+ * the same. */
+/** The emphasis nodes that live by the flanking rules, with the marker the
+ *  editor writes for them. Inline code is not among them: a code span keeps its
+ *  whitespace and never fails to close. */
+export const EMPHASIS_MARKERS = new Map([
+    ['StrongEmphasis', '**'],
+    ['Emphasis', '*'],
+    ['Strikethrough', '~~'],
+]);
+/** The blocks that hold inline content. A held emphasis must stay within one:
+ *  a paragraph break inside it (Enter twice) ends the run for good. */
+const INLINE_BLOCKS = new Set([
+    'Paragraph', 'ATXHeading1', 'ATXHeading2', 'ATXHeading3', 'ATXHeading4', 'ATXHeading5', 'ATXHeading6',
+    'SetextHeading1', 'SetextHeading2', 'TableCell',
+]);
+/** What may sit between the end of a run's text and its closing marker for the
+ *  marker to be moved back to the text: whitespace, and after a line break the
+ *  scaffolding Enter writes for the next list item, task or quote line. Text
+ *  there means the break fell inside the run, and that is left alone. */
+const TRAIL_RE = /^\s*(?:\n\s*(?:(?:[-*+]|\d+[.)]|>|\[[ xX]\])\s*)*)*$/;
+/** Starts a hold on markers just written around an empty selection: `****`
+ *  parses as nothing, so there is no node to remember, but what is typed
+ *  between them is meant to be bold. */
+export const holdEmphasis = StateEffect.define({
+    map: (value, mapping) => ({ ...value, from: mapping.mapPos(value.from, 1), to: mapping.mapPos(value.to, -1) }),
+});
+function emphasisAround(state, pos, side) {
+    return enclosingNode(state, pos, side, (node) => EMPHASIS_MARKERS.has(node.name));
+}
+function inlineBlockAt(state, pos) {
+    return enclosingNamed(state, pos, 1, INLINE_BLOCKS);
+}
+/** The innermost emphasis the main selection is inside of on both of its sides,
+ *  as the tree parses it now. Just before the opening marker or just after the
+ *  closing one is outside: text typed there lands outside the emphasis. */
+function liveEmphasis(state) {
+    const { from, to } = state.selection.main;
+    const left = emphasisAround(state, from, -1);
+    const right = left && emphasisAround(state, to, 1);
+    if (!left || !right || left.from !== right.from || left.to !== right.to)
+        return null;
+    const len = EMPHASIS_MARKERS.get(left.name).length;
+    return { from: left.from, to: left.to, name: left.name, marker: state.sliceDoc(left.from, left.from + len), live: true };
+}
+/** Whether a remembered emphasis is still worth holding: the selection is between
+ *  its markers, both markers are still there, no paragraph break cut it, and
+ *  the parser has not made something else of its start. (Typing `**` inside
+ *  bold splits it, and then the tree's own reading should show.) */
+function holds(state, held) {
+    const len = held.marker.length;
+    const { from, to } = state.selection.main;
+    if (from < held.from + len || to > held.to - len)
+        return false;
+    const text = state.sliceDoc(held.from, held.to);
+    if (text.length < 2 * len || !text.startsWith(held.marker) || !text.endsWith(held.marker))
+        return false;
+    const block = inlineBlockAt(state, held.from);
+    if (!block || block.to < held.to)
+        return false;
+    const parsed = emphasisAround(state, held.from, 1);
+    return !(parsed && parsed.name === held.name && parsed.from === held.from);
+}
+function mapHeld(held, through) {
+    return { ...held, from: through.changes.mapPos(held.from, 1), to: through.changes.mapPos(held.to, -1) };
+}
+/** The emphasis the caret is in: the tree's own while it parses, and the held
+ *  one, mapped along through edits, once it does not. Null outside any. */
+export const heldEmphasisField = StateField.define({
+    create: (state) => liveEmphasis(state),
+    update(prev, tr) {
+        // The run the caret was in comes first, live or held: if the tree has let
+        // go of it (or still has not taken it up) it is held from here. The tree
+        // may well parse an outer emphasis around it, and that one needs no holding.
+        if (prev) {
+            const held = mapHeld({ ...prev, live: false }, tr);
+            if (holds(tr.state, held))
+                return held;
+        }
+        const live = liveEmphasis(tr.state);
+        if (live)
+            return live;
+        const seed = tr.effects.find((effect) => effect.is(holdEmphasis));
+        return seed ? { ...seed.value, live: false } : null;
+    },
+});
+/** The whitespace at the inside edges of `held`, or null when there is nothing
+ *  to move: no whitespace at the edges, nothing but whitespace inside, or the
+ *  markers are gone. The text ends where the opening block's text does: past
+ *  a paragraph break the rest of the run can never be inside the emphasis, so
+ *  it counts as trail, provided it is scaffolding and not text. */
+function repairFor(state, held) {
+    const len = held.marker.length;
+    const text = state.sliceDoc(held.from, held.to);
+    if (text.length < 2 * len || !text.startsWith(held.marker) || !text.endsWith(held.marker))
+        return null;
+    const inner = text.slice(len, text.length - len);
+    const lead = /^\s*/.exec(inner)[0].length;
+    const block = inlineBlockAt(state, held.from);
+    const inBlock = state.sliceDoc(held.from + len, Math.min(held.to - len, block ? block.to : held.to - len));
+    const contentEnd = held.from + len + inBlock.replace(/\s+$/, '').length;
+    if (contentEnd <= held.from + len + lead)
+        return null;
+    const trail = held.to - len - contentEnd;
+    if (!lead && !trail)
+        return null;
+    if (!TRAIL_RE.test(state.sliceDoc(contentEnd, held.to - len)))
+        return null;
+    return { from: held.from, to: held.to, len, lead, trail };
+}
+/** Moves the lead in front of the opening marker and the trail past the closing
+ *  one. Moving the whitespace rather than the markers keeps an annotation on
+ *  the text on the text. */
+function repairChanges(state, r) {
+    const changes = [];
+    if (r.lead) {
+        changes.push({ from: r.from, insert: state.sliceDoc(r.from + r.len, r.from + r.len + r.lead) }, { from: r.from + r.len, to: r.from + r.len + r.lead });
+    }
+    if (r.trail) {
+        changes.push({ from: r.to - r.len - r.trail, to: r.to - r.len }, { from: r.to, insert: state.sliceDoc(r.to - r.len - r.trail, r.to - r.len) });
+    }
+    return changes;
+}
+/** Where a position lands after the repair. The markers and the whitespace swap
+ *  places, and a caret in the whitespace goes with it past the marker: after
+ *  the space it typed, outside the run. With `stay` it stays with the text,
+ *  inside the markers. That is what a blur wants: a toolbar click blurs the
+ *  editor before its command runs, and the command must find the caret where
+ *  the typing was. */
+function mapRepair(pos, r, stay) {
+    const contentStart = r.from + r.len + r.lead;
+    const contentEnd = r.to - r.len - r.trail;
+    if (r.lead) {
+        if (pos > r.from && pos < r.from + r.len)
+            return pos + r.lead;
+        if (pos >= r.from + r.len && pos < contentStart)
+            return stay ? contentStart : pos - r.len;
+    }
+    if (r.trail) {
+        if (pos > contentEnd && pos <= r.to - r.len)
+            return stay ? contentEnd : pos + r.len;
+        if (pos > r.to - r.len && pos < r.to)
+            return pos - r.trail;
+    }
+    return pos;
+}
+function repairSpec(state, held, stay) {
+    const r = repairFor(state, held);
+    if (!r)
+        return null;
+    const sel = state.selection;
+    return {
+        changes: repairChanges(state, r),
+        selection: EditorSelection.create(sel.ranges.map((range) => EditorSelection.range(mapRepair(range.anchor, r, stay), mapRepair(range.head, r, stay))), sel.mainIndex),
+        userEvent: 'input.emphasis',
+    };
+}
+/** The changes that move edge whitespace out of `held`, for a command that
+ *  steps out of the run itself. Empty when there is nothing to move. */
+export function repairChangesFor(state, held) {
+    const r = repairFor(state, held);
+    return r ? repairChanges(state, r) : [];
+}
+/** Ends a hold at once, for a blur. The display must be right while the editor
+ *  is unfocused, and the value it commits must be markdown that renders the way
+ *  it looked. */
+export function repairHeldEmphasis(view) {
+    const held = view.state.field(heldEmphasisField, false);
+    if (!held || held.live || view.state.readOnly)
+        return;
+    const spec = repairSpec(view.state, held, true);
+    if (spec)
+        view.dispatch(spec);
+}
+/** Repairs an emphasis the moment its hold ends: the caret left it, or a
+ *  paragraph break cut it. A dispatch during an update is an error, so the
+ *  repair waits for the update to finish. A microtask is soon enough to land
+ *  before the paint, so nothing flickers. */
+const repairOnRelease = ViewPlugin.fromClass(class {
+    constructor(view) {
+        this.view = view;
+        this.pending = null;
+        this.destroyed = false;
+    }
+    update(update) {
+        if (this.pending)
+            this.pending = mapHeld(this.pending, update);
+        const before = update.startState.field(heldEmphasisField);
+        if (!before)
+            return;
+        const gone = mapHeld(before, update);
+        const after = update.state.field(heldEmphasisField);
+        if (after && after.name === gone.name && after.from === gone.from && after.to === gone.to)
+            return;
+        this.pending = gone;
+        queueMicrotask(() => this.flush());
+    }
+    flush() {
+        const held = this.pending;
+        this.pending = null;
+        if (!held || this.destroyed || this.view.state.readOnly)
+            return;
+        const spec = repairSpec(this.view.state, held, false);
+        if (spec)
+            this.view.dispatch(spec);
+    }
+    destroy() {
+        this.destroyed = true;
+    }
+});
+export const heldEmphasis = [heldEmphasisField, repairOnRelease];
+//# sourceMappingURL=text-editor.emphasis.js.map

package/dist/components/inputs/text-editor/text-editor.emphasis.js.map

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

package/dist/components/inputs/text-editor/text-editor.js

@@ -19,12 +19,20 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
  *
  * Headless: there is no built-in toolbar. A consumer drives formatting via the
  * command methods (toggleBold/toggleItalic/toggleInlineCode/toggleStrikethrough/
- * toggleHeading/toggleBulletList/toggleQuote/toggleLink/runCommand to toggle, and
+ * toggleHeading/toggleBulletList/toggleTaskList/toggleQuote/toggleLink/runCommand
+ * to toggle, and
  * setHeading/setList for picker-style "set" semantics), reads the active formats
  * with getState(), listens to the nldd-text-editor-state event to render toggle
  * states, and forwards padding clicks with focusFromPoint(). Cmd/Ctrl+B/I/E/K are
- * bound out of the box. Commands keep focus on the editor. An @-mention typeahead
- * (mentionSource) collapses to an atomic token, and a W3C-style annotation overlay
+ * bound out of the box. Commands keep focus on the editor. An inline toggle wraps
+ * the selected text (whitespace at its edges stays outside the markers), unwraps
+ * a run the caret is in, and with the caret at the very end of a run steps out
+ * of it. Bold that a typed space has broken (`**woord **`) keeps its styling
+ * while the caret is inside; the space moves outside the markers when the caret
+ * leaves. insertAtCursor(text) puts text at the caret and replaceRange(from, to,
+ * text) writes at the same clean offsets getSelection() reads. An @-mention typeahead
+ * (mentionSource) collapses to an atomic token, further typeahead lists on their
+ * own trigger (typeaheads) write what you tell them to, and a W3C-style annotation overlay
  * (annotations) marks ranges with a dashed underline, light tint and a count badge
  * without touching the underlying text.
  *
@@ -44,6 +52,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
  * @attr {string} accessible-label - Accessible label forwarded to the editor. Set automatically by nldd-form-field.
  *
  * @prop {MentionSource} mentionSource - Consumer-supplied @-mention candidate source (property only). Without it, @-typeahead is inert.
+ * @prop {Typeahead[]} typeaheads - Your own typeahead lists next to the @-mention (property only): each a trigger character (`#`, `:`, `/`), a `source` that returns candidates for the text typed after it, and an optional `insert` that decides what a choice writes (by default the trigger, the text and a space). Lists on one trigger are merged in order. A candidate is `{ id, text, supportingText? }` and can carry an `avatar` (its row then takes two lines, the supporting text under the text), an `icon` or a `symbol` for its row.
  * @attr {boolean} annotatable - Enable the annotation overlay (off by default). Annotations only render when this is set.
  * @prop {Annotation[]} annotations - Consumer-supplied annotation overlay (property only). Anchored by offset and mapped through edits; the text stays clean. Requires `annotatable`. Assign a NEW array to apply changes (Lit dirty-checks by identity, so in-place mutation like `.push()` won't re-render): `editor.annotations = [...editor.annotations, next]`.
  * @attr {object} translations - Override the editor's assistive-tech strings (the open-in-new-tab link badge and the annotation count badge). Unset keys fall back to Dutch.
@@ -52,7 +61,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
  * @fires input - When the content changes (detail: { value })
  * @fires change - When the content is committed on blur (detail: { value })
  * @fires nldd-text-editor-state - When the selection or content changes (detail: TextEditorState), for toolbar toggle state
- * @fires nldd-text-editor-mention - When an @-mention is inserted (detail: MentionInsertedDetail with id, label, from, to)
+ * @fires nldd-text-editor-mention - When an @-mention is inserted (detail: MentionInsertedDetail with id, text, from, to; clean offsets, like getSelection())
+ * @fires nldd-text-editor-typeahead - When a candidate from one of the `typeaheads` is chosen (detail: TypeaheadChosenDetail with trigger, candidate, from, to; clean offsets)
  * @fires nldd-text-editor-annotation-click - When an annotation's count badge is clicked (detail: { ids: string[], rect: DOMRect }); rect is the badge's viewport box so a consumer can anchor its own note UI to it
  */
 import { LitElement } from 'lit';
@@ -65,15 +75,17 @@ import { defaultKeymap, history, historyKeymap, undo as cmUndo, redo as cmRedo,
 import { NLDDCodeMirrorElement } from '../../../utilities/codemirror/codemirror-element.js';
 import { nlddCodeMirrorTheme } from '../../../utilities/codemirror/theme.js';
 import { markdownEditing, mentionRangeAt, mentionRangeEndingAt, mentionRangeStartingAt } from './text-editor.markdown.js';
-import { mentions } from './text-editor.mentions.js';
+import { typeaheads as typeaheadExtension, mentionInsert, mentionToken, } from './text-editor.mentions.js';
+import { repairHeldEmphasis } from './text-editor.emphasis.js';
 import { annotations as annotationExtension, setAnnotations, pasteAnnotations, currentAnnotations } from './text-editor.annotations.js';
 import { orderedListRenumber } from './text-editor.ordered-list.js';
 import { dragToMove, dragMovePlugin } from './text-editor.drag.js';
 import { linkOpenBadge } from './text-editor.links.js';
-import { toggleInlineWrap, indentListItems as cmIndentListItems, outdentListItems as cmOutdentListItems, canIndentListItem as cmCanIndent, canOutdentListItem as cmCanOutdent, toggleHeading as cmToggleHeading, setHeading as cmSetHeading, toggleBulletList as cmToggleBulletList, setList as cmSetList, toggleQuote as cmToggleQuote, toggleLink as cmToggleLink, toggleCodeBlock as cmToggleCodeBlock, clearListMarkerBackward, readActiveFormats, EMPTY_FORMATS, } from './text-editor.commands.js';
+import { stableCursor } from './text-editor.cursor.js';
+import { toggleInlineWrap, indentListItems as cmIndentListItems, outdentListItems as cmOutdentListItems, canIndentListItem as cmCanIndent, canOutdentListItem as cmCanOutdent, toggleHeading as cmToggleHeading, setHeading as cmSetHeading, toggleBulletList as cmToggleBulletList, toggleTaskList as cmToggleTaskList, setList as cmSetList, toggleQuote as cmToggleQuote, toggleLink as cmToggleLink, toggleCodeBlock as cmToggleCodeBlock, clearListMarkerBackward, readActiveFormats, EMPTY_FORMATS, } from './text-editor.commands.js';
 import { textEditorStyles } from './text-editor.styles.js';
 import { textEditorTemplate } from './text-editor.template.js';
-import { stripSentinels, docToClean } from './text-editor.annotation-sentinels.js';
+import { stripSentinels, docToClean, cleanToDoc, sentinelPositions } from './text-editor.annotation-sentinels.js';
 import { nlddTextEditorTranslations } from './text-editor.i18n.js';
 import { DescribedBy } from '../../../utilities/described-by-mixin.js';
 let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLDDCodeMirrorElement)) {
@@ -94,6 +106,18 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
         this.resize = 'auto';
         this.variant = 'simple';
         this.accessibleLabel = '';
+        /** Your own typeahead lists next to the @-mention, each on its own trigger
+         *  character. Property only. Read on every keystroke, so a new array takes
+         *  effect at once. */
+        this.typeaheads = [];
+        /** The built-in mention as a typeahead: the `@` list fed by `mentionSource`,
+         *  writing the token. One object, so a choice can be told apart from a
+         *  consumer's own `@` list and fire the mention event. */
+        this._mentionTypeahead = {
+            trigger: '@',
+            source: (query) => this.mentionSource?.(query) ?? [],
+            insert: mentionInsert,
+        };
         /** Whether the annotation overlay is enabled. Off by default; set the
          *  `annotatable` attribute to turn it on (so the comment affordance and the
          *  overlay only appear when the consumer opts in). */
@@ -131,6 +155,11 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
         /** Text and annotations of the last cut, so a same-editor paste can move the
          *  annotations along with their text. Cleared by copy and by a matching paste. */
         this._cutBuffer = null;
+        /** The last state handed out, to keep from repeating it. The event drives a
+         *  toolbar's toggles, and moving the caret within one paragraph leaves every
+         *  one of them where it was: a consumer would re-render its whole bar on every
+         *  arrow key for nothing. */
+        this._lastState = null;
         /* # Internals */
         this._onScrollerPointerDown = (event) => {
             if (event.target !== this.view?.scrollDOM)
@@ -201,7 +230,7 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
         return [
             nlddCodeMirrorTheme,
             markdownEditing,
-            mentions(() => this.mentionSource, (detail) => this._emitMention(detail)),
+            typeaheadExtension(() => this._typeaheadLists(), (choice) => this._onTypeaheadChosen(choice)),
             // Prec.low so this transaction filter runs *before* the annotation filter
             // (filters run low-precedence first), letting the annotation map through the
             // renumber changes too — otherwise a marker growing from 1 to 11 drifts a
@@ -222,6 +251,10 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
             Prec.highest(linkOpenBadge((url) => this._t('components.text-editor.open-in-new-tab-label', { url }))),
             this._historyCompartment.of(history()),
             drawSelection(),
+            // Draws the caret in drawSelection's place, on a side that does not depend on
+            // the direction it arrived from unless that direction means something (a
+            // widget, a line wrap). See text-editor.cursor.ts.
+            stableCursor,
             dropCursor(),
             dragToMove,
             // Prec.highest so this beats the markdown language's deleteMarkupBackward,
@@ -237,6 +270,12 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
                 // selects the whole token, the second removes it.
                 { key: 'Backspace', run: (view) => this._selectMentionBeforeDelete(view, -1) },
                 { key: 'Delete', run: (view) => this._selectMentionBeforeDelete(view, 1) },
+                // Cmd/Ctrl+] and +[ nest and un-nest list items. defaultKeymap binds them
+                // to indentMore/indentLess, whose four-space indent turns plain text into
+                // an indented code block. Consumed here in every case: off a list item
+                // they do nothing, which beats a code block nobody asked for.
+                { key: 'Mod-]', run: (view) => { cmIndentListItems(view); return true; } },
+                { key: 'Mod-[', run: (view) => { cmOutdentListItems(view); return true; } },
                 ...defaultKeymap,
                 ...historyKeymap,
             ]),
@@ -254,7 +293,10 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
                 focus: () => {
                     this._valueAtFocus = this.value;
                 },
-                blur: () => {
+                blur: (_event, view) => {
+                    // An emphasis held together while it was being typed is closed
+                    // properly first, so the committed value renders the way it looked.
+                    repairHeldEmphasis(view);
                     if (this.value !== this._valueAtFocus)
                         this._emitChange();
                 },
@@ -315,7 +357,9 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
     firstUpdated() {
         this._initialValue = this.value;
         this.style.setProperty('--_rows', String(this.rows));
-        this.mountEditor(this.value);
+        // The sentinels are the overlay's own; a value that carries one (an editor
+        // whose text was round-tripped through another) hands it back stripped.
+        this.mountEditor(stripSentinels(this.value));
         this.onEditorMounted();
     }
     /* Runs on the initial mount and on every re-mount after a detach/reattach
@@ -349,7 +393,7 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
                 // mirrors the current (sentinel-stripped) doc must not trigger a rewrite,
                 // which would strip the sentinels the filter then re-adds (caret churn).
                 if (stripSentinels(this.doc) !== this.value)
-                    this.setDoc(this.value);
+                    this.setDoc(stripSentinels(this.value));
                 this.commitFormValue();
             }
             if (changed.has('disabled') || changed.has('readonly')) {
@@ -425,8 +469,15 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
         if (this.view)
             cmToggleBulletList(this.view);
     }
+    /** Turn the selected lines into GFM task items (`- [ ] `), or back into
+     *  bullets when they all are tasks. Checking a box is not a command. */
+    toggleTaskList() {
+        if (this.view)
+            cmToggleTaskList(this.view);
+    }
     /** Set the list type, replacing any existing list ('none' strips it) — for an
-     *  exclusive list picker. */
+     *  exclusive list picker. A task keeps its checkbox only within its own type:
+     *  switching to bullet or ordered takes the box along with the marker. */
     setList(type) {
         if (this.view)
             cmSetList(this.view, type);
@@ -551,6 +602,41 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
         this._pasteText(stripSentinels(raw));
         this.view?.focus();
     }
+    /** Puts `text` at the caret, in place of the selection when there is one, and
+     *  leaves the caret after it, with focus on the editor. Plain text: markdown
+     *  in it stays as written and is styled like anything typed. Does nothing on
+     *  a read-only editor. */
+    insertAtCursor(text) {
+        if (!this.view || this.view.state.readOnly)
+            return;
+        const clean = stripSentinels(text);
+        if (clean)
+            this.view.dispatch({ ...this.view.state.replaceSelection(clean), userEvent: 'input' });
+        this.view.focus();
+    }
+    /** Replaces the text between two offsets with `text`, and leaves the caret
+     *  after it. The offsets are CLEAN, the same coordinates `getSelection()` and
+     *  the annotations speak, so a consumer can act on what it read there. Both
+     *  are clamped into the text, and `to` below `from` counts as an insert at
+     *  `from`. Does nothing on a read-only editor. */
+    replaceRange(from, to, text) {
+        if (!this.view || this.view.state.readOnly)
+            return;
+        const doc = this.view.state.doc.toString();
+        const sentinels = sentinelPositions(doc);
+        const cleanLength = doc.length - sentinels.length;
+        const start = Math.max(0, Math.min(from, cleanLength));
+        const end = Math.max(start, Math.min(to, cleanLength));
+        const insert = stripSentinels(text);
+        const docFrom = cleanToDoc(sentinels, start);
+        const docTo = cleanToDoc(sentinels, end);
+        this.view.dispatch({
+            changes: { from: docFrom, to: docTo, insert },
+            selection: { anchor: docFrom + insert.length },
+            userEvent: 'input',
+        });
+        this.view.focus();
+    }
     /** Insert `text` at the selection, re-attaching the cut annotations when it matches
      *  a cut made in this editor (a move, one-shot). Shared by the toolbar's paste()
      *  and the native Cmd/Ctrl+V handler. */
@@ -566,16 +652,28 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
         const sameText = (a, b) => a.replace(/\r\n/g, '\n') === b.replace(/\r\n/g, '\n');
         const carry = !!(buffer && sameText(buffer.text, text) && buffer.anns.length > 0);
         const at = docToClean(this.view.state.doc.toString(), this.view.state.selection.main.from);
-        const spec = this.view.state.replaceSelection(text);
+        // input.paste, like CodeMirror's own paste: history groups it as one step and
+        // a transaction filter can tell a paste from typing.
+        const spec = { ...this.view.state.replaceSelection(text), userEvent: 'input.paste' };
         this.view.dispatch(carry ? { ...spec, effects: pasteAnnotations.of({ at, anns: buffer.anns }) } : spec);
         // One-shot: a second paste of the same cut would duplicate the ids, so drop it.
         if (carry)
             this._cutBuffer = null;
     }
-    /** Escape hatch: run a command by name (bold, italic, inlineCode,
-     *  strikethrough, bulletList, quote, heading [payload: level], link
-     *  [payload: href], copy, cut, paste). */
+    /** Escape hatch: run a command by name, so a toolbar can carry the name in its
+     *  markup instead of a method reference. Every method above is reachable.
+     *
+     *  Toggles (no payload): `bold`, `italic`, `inlineCode`, `strikethrough`,
+     *  `bulletList`, `taskList`, `quote`, `codeBlock`, `heading` (payload: the
+     *  level, default 1), `link` (payload: the href).
+     *  Setters: `setHeading` (payload: the level, 0 for a paragraph), `setList`
+     *  (payload: 'none' | 'bullet' | 'ordered' | 'task').
+     *  The rest: `indent`, `outdent`, `undo`, `redo`, `copy`, `cut`, `paste`.
+     *
+     *  An unknown name warns rather than doing nothing quietly: a typo in a
+     *  toolbar is otherwise invisible. */
     runCommand(name, payload) {
+        const level = (fallback) => (typeof payload === 'number' ? payload : fallback);
         switch (name) {
             case 'bold':
                 this.toggleBold();
@@ -592,15 +690,39 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
             case 'bulletList':
                 this.toggleBulletList();
                 break;
+            case 'taskList':
+                this.toggleTaskList();
+                break;
             case 'quote':
                 this.toggleQuote();
                 break;
+            case 'codeBlock':
+                this.toggleCodeBlock();
+                break;
             case 'heading':
-                this.toggleHeading((typeof payload === 'number' ? payload : 1));
+                this.toggleHeading(level(1));
+                break;
+            case 'setHeading':
+                this.setHeading(level(0));
+                break;
+            case 'setList':
+                this.setList(typeof payload === 'string' ? payload : 'none');
                 break;
             case 'link':
                 this.toggleLink(typeof payload === 'string' ? payload : '');
                 break;
+            case 'indent':
+                this.indent();
+                break;
+            case 'outdent':
+                this.outdent();
+                break;
+            case 'undo':
+                this.undo();
+                break;
+            case 'redo':
+                this.redo();
+                break;
             case 'copy':
                 void this.copy();
                 break;
@@ -610,6 +732,7 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
             case 'paste':
                 void this.paste();
                 break;
+            default: console.warn(`<nldd-text-editor>: runCommand('${name}') is not a command.`);
         }
     }
     /** The formats active at the current selection (drives a toolbar's state). */
@@ -667,8 +790,41 @@ let NLDDTextEditor = class NLDDTextEditor extends DescribedBy(FormAssociated(NLD
         }));
     }
     _emitState() {
+        const state = this.getState();
+        const last = this._lastState;
+        if (last
+            && last.empty === state.empty
+            && last.canIndent === state.canIndent
+            && last.canOutdent === state.canOutdent
+            && last.canUndo === state.canUndo
+            && last.canRedo === state.canRedo
+            && Object.keys(state.active).every((key) => last.active[key] === state.active[key]))
+            return;
+        this._lastState = state;
         this.dispatchEvent(new CustomEvent('nldd-text-editor-state', {
-            detail: this.getState(),
+            detail: state,
+            bubbles: true,
+            composed: true,
+        }));
+    }
+    _typeaheadLists() {
+        return this.mentionSource ? [this._mentionTypeahead, ...this.typeaheads] : this.typeaheads;
+    }
+    /** A choice from any list. Offsets in the events are clean, like
+     *  getSelection() and the annotations: the document carries sentinels the
+     *  value never shows. */
+    _onTypeaheadChosen(choice) {
+        if (!this.view)
+            return;
+        const doc = this.view.state.doc.toString();
+        const from = docToClean(doc, choice.from);
+        if (choice.typeahead === this._mentionTypeahead) {
+            const { id, text } = choice.candidate;
+            this._emitMention({ id, text, from, to: from + mentionToken(choice.candidate).length });
+            return;
+        }
+        this.dispatchEvent(new CustomEvent('nldd-text-editor-typeahead', {
+            detail: { trigger: choice.trigger, candidate: choice.candidate, from, to: docToClean(doc, choice.to) },
             bubbles: true,
             composed: true,
         }));
@@ -774,6 +930,9 @@ __decorate([
 __decorate([
     property({ attribute: false })
 ], NLDDTextEditor.prototype, "mentionSource", void 0);
+__decorate([
+    property({ attribute: false })
+], NLDDTextEditor.prototype, "typeaheads", void 0);
 __decorate([
     property({ type: Boolean, reflect: true })
 ], NLDDTextEditor.prototype, "annotatable", void 0);