@stesura/core/commands

Strips inline marks from the selection, keeping the track-changes marks (insertion / deletion / modification) so clearing formatting never erases a pending suggestion. Refused inside code blocks.

A selection over several textblocks is cleared in chunks (a bulk command), as a batch in edit mode, with the same result as clearFormattingTr.

Transaction form: clearFormattingTr.

Runs every command against ONE transaction and dispatches once, so the whole group undoes in a single step and each command sees what the previous ones wrote. Succeeds if any command did something; one that returns false keeps whatever it already wrote.

Not chainCommands from prosemirror-commands, which runs commands until the first one succeeds and stops there.

Deletes the node at pos. False when pos is null or holds no node.

insertContentAt targeting the current selection.

Inserts a node of the given type at the cursor, or wraps the selection in it.

The type is resolved by name and routed on its shape: block types wrap the selected blocks (via wrapIn) or, at a bare cursor, insert an instance holding a placeholder paragraph; inline types wrap the selected inline content or insert an instance holding placeholder text. Content is built with createAndFill, so a type that cannot hold the content refuses (returns false) rather than throwing.

Warns and returns false when the schema has no node of that name.

Inserts a literal character at the selection, keeping the current marks.

Resets the named attributes to their schema defaults on every node — or mark — of the given type in the selection, without dispatching.

Transaction form: resetAttributesTr.

Like composeCommands, but stops at the first command that returns false and dispatches nothing — the group is all-or-nothing.

Applies a mark to the selection, merging attributes into any existing mark of that type; a merge left with only null attrs removes the mark. A cursor inside a word marks the whole word; at a word boundary the mark is stored for the next keystroke. Returns false, with no steps, when it cannot apply.

A selection over several textblocks is applied in chunks (a bulk command), with the same result as setMarkTr.

A dry run only checks canSetMark. False when typeOrName is undefined.

Transaction form: setMarkTr.

Turns the selected blocks into typeOrName, carrying over the current node’s attrs when the selection sits in a single parent. Falls back to clearNodes first when the target type isn’t directly reachable.

Textblock types only.

Toggles the selected blocks between heading at level and paragraph, applying the Heading<level> style on the way up and returning to Normal on the way down, as Word does. Not plain toggleNode: it would carry the heading’s styleId across to the paragraph.

Toggles a mark on the selection.

• Cursor: inside a word the mark is toggled on the whole word; at a word boundary it is stored/removed for the next keystroke.
• Range: the mark is added when any part of the range is missing it, removed when it is present everywhere.

textStyle is applied per inline node (applyToAllNodesInRange), so math nodes keep their LaTeX source unmarked.

A selection over several textblocks is toggled in chunks (a bulk command), with the same result as toggleMarkTr.

False when markType is undefined.

Transaction form: toggleMarkTr.

toggleMark by mark name, with expandSelectionToWord pinned on: a bare cursor inside a word toggles the whole word. False when the mark is not in the schema.

Switches the selected blocks to typeOrName, or back to toggleTypeOrName when they already are that type.

When the selection sits in a SINGLE parent, that parent’s attrs are carried over to the new node, whatever its type. A caller that must not inherit an attr has to overwrite it in attributes (hence toggleHeading resetting styleId).

Removes a mark from the selection and from the stored marks, without dispatching. A selection over several textblocks is cleared in chunks (a bulk command), with the same result as unsetMarkTr.

Transaction form: unsetMarkTr.

Sets a single attr on the node at a known position. Fails (probe and real) when no node sits at pos — a stale nodeview getPos must not write onto whatever now occupies the position — or when type is given and mismatches.

Merges attributes into every node (or mark) of the given type in the selection, plus the innermost enclosing node of that type; on a collapsed selection a matching stored mark is updated too. Undeclared or already-equal keys are skipped, so a no-op update produces no steps and returns false.

Transaction form: updateAttributesTr.

Inserts a horizontal_rule node at the selection.

Applies borders to whatever the selection targets, trying the horizontal rule, then table, then cells, then styled blocks — the first that applies wins. See setBordersTr.

Toggles the editor-wide outline overlay — the dashed guides drawn where a block has no real border. Meta-only: the doc is untouched.

Inserts an empty code_block at the selection. No-ops inside an existing one.

Splits the code block at the caret into two, breaking after the caret’s line: that line stays in the first block, the rest starts the second. Language, theme and line numbers carry over.

No-ops on the last line — there is nothing to split off.

Sets one attr (language, theme, line numbers, …) on the code block at pos.

Sets one doc attr, typed against DocAttrs. A no-op (false) when the value is already in place, so toolbar dry-runs grey the control out.

Dismisses a checker’s findings on this document, for every collaborator. A plain doc attr step, so undo brings them back. False when all already are.

Brings dismissed findings back: ids, or all of the checker’s. False when none was dismissed.

Sets the canvas color behind the pages, as the docBgColor doc attr. themeRef is the theme slot it was picked from, and then decides the hex; without one, the ref clears.

Sets the document’s default text direction — the bottom of paragraph.dir ?? section.dir ?? doc.dir, and the one option a host sets to mount an RTL-by-default editor. Blocks and sections declaring their own dir keep overriding it; setDirection(null) clears a block’s override.

Document-global, so it forwards to the root doc when run from a sub-editor.

Word’s Design › Colors: sets doc.attrs.theme and moves every themed colour (runs, fills, borders, page colour, styles) onto it, as one undo step. Colours without a theme ref stay as they are. Like Word, not a tracked change. A bulk command: the doc attrs change in the first transaction, the nodes CHUNK_STEPS steps a transaction.

Appends the steps that move the file node at pos one position among its siblings to tr, keeping the selection on it, and returns where the node now starts — or null, untouched, when there is no file there or nowhere to go. A plain delete + insert: a file node is an atom with no content to preserve, and adjacent files are ordinary siblings — “between two files” is already the gap cursor’s job.

A builder rather than only a command so a React caller can add what it knows and core cannot: that the node’s VIEW should survive the move (see preserveNodeViewKey in editor-react).

Inserts an upload placeholder that resolves into a file node once the upload completes. Refused inside code blocks and tables.

With a file node selected it inserts AFTER it rather than refusing: two PDFs in a row are ordinary siblings, and refusing left “add another file here” with no route at all.

applyFileNodeMove as a command.

Turns a file node by a quarter turn (delta 90 or -90), wrapping at 360.

Switches a file node between its preview and its card.

Sets a file node’s whole-file rotation to one of the four storable angles.

Paints the armed formatting onto the selection — or the word under a bare cursor — replacing existing marks (except the track-changes ones).

The captured block type, numbering, indent, spacing, background, borders and style follow only when the target is a whole block, spans several, or is a bare cursor, matching Word: a partial selection inside one paragraph takes the character formatting alone. Numbering replaces the target’s wholesale: a leftover instanceId or level would split it off the source’s run. Disarms afterwards when the painter was armed for one use.

Disarms the format painter and restores the default cursor.

Picks up the formatting under the cursor — inline marks plus the textblock’s type and attrs — and arms the format painter with it. Refused in code blocks.

A source selection covering only part of a single block arms the marks alone (Word copies no paragraph formatting from a partial selection).

Justifies every start-aligned text block in the document.

Justifies every start- or end-aligned text block in the document.

Adds value to the effective spacing on one side (resolved through the stylesheet), floored at 0. Pass a negative value to decrement.

Only the incremented side is written: stamping the resolved value on the other side too would pin it against later stylesheet edits.

Transaction form: incrementSpacingTr.

Indents the block at the selection by one step, Word-style: a block without a first-line indent gets one first, later presses move the whole block. On a NUMBERED node it demotes the list level instead, and touches no paragraph geometry — the level definition supplies that.

Capped at MAX_INDENT_LEVEL steps (unnumbered blocks only; a numbered one is capped by the deepest level its list defines, in adjustLevel).

Reverses one indent step; no-ops once the block is fully outdented.

Resets textAlign to null for nodes in the selection (if ids is undefined) or for all nodes matching the given ids (node id or stylesheet id).

Resets the indent attr to null for nodes in the selection (if ids is undefined) or for all nodes matching the given ids (node id or stylesheet id).

Clears the lineHeight override in the selection, back to the stylesheet.

Clears every pagination override in the selection (back to the stylesheet).

Resets spacing, lineHeight and lineHeightAtLeast to null for nodes in the selection (if ids is undefined) or for all nodes matching the given ids.

Sets the dir attr on the formatted blocks in the selection. null clears the override so direction inherits from the section, then the document.

Merges a partial indent attr into every formatted node in the selection. A whole-table selection writes the table only, so the indent is not applied twice.

Transaction form: setFormattingTr.

Sets lineHeight on every formatted node in the selection.

Merges a partial pagination attr into every paginated block in the selection.

Merges spacing into every spaced node in the selection; sides not given keep their current value. A whole-table selection writes the table only.

Transaction form: setSpacingTr.

setSpacingTr for one side only, leaving the other untouched.

Transaction form: setSpacingBeforeAfterTr.

Sets textAlign on the formatted blocks in the selection.

Rewrites textAlign document-wide, but only on text blocks whose effective alignment (own attr, else style, else start) is one of applyOnAlignments — a bulk realignment that leaves deliberately centered or justified blocks alone.

Flips the selection’s RESOLVED direction (the one the toolbar shows), writing null when the target is what the block inherits anyway. Flipping the raw attr would leave an inheriting-RTL paragraph no route to LTR.

Deletes the variant header_footer_content from both the header and footer of the section. Refuses the “default” variant.

Repairs headers/footers before their editors mount:

• a null variant becomes the default when none exists, else it is deleted;
• duplicate variants are deleted;
• a variant present in only one of header/footer is added to the other, and both always get a default;
• every header_footer_content gets at least one paragraph (the schema says block+, but a custom schema may relax it). Returns false when nothing needed fixing.

Adds a variant header_footer_content, holding one empty paragraph, to the section’s header and footer wherever it is missing.

Inserts a page number into a section’s header (top) or footer (bottom) as a Word-style preset: a borderless 1×3 table whose columns hold a left-, center- and right-aligned paragraph, with the page number in the chosen column.

Must be dispatched on the MAIN editor state (not a header/footer sub-editor): it locates the section by id and creates the header/footer content when the variant doesn’t exist yet, all in one transaction. The guard/track-change metas allow the edit; an open sub-editor picks the change up through the headerFooterBindingPlugin’s normal main→inner sync.

Disarms the highlighter and restores the default cursor.

Arms the highlighter with a color: the cursor becomes the marker and subsequent selections are highlighted until disableHighlight.

Applies the highlight mark in the given color to the selection.

Toggles the highlight mark. Only removes when the existing highlight is the same color — picking a different color recolors instead of clearing.

Removes the highlight mark from the selection.

Tab / Shift-Tab on a selected positioned object: the next or previous one on its page (Word’s shape cycle). Consumes the key while one is selected, even when it is the only one, so Tab never indents the paragraph under it.

Escape on a selected picture or text box: back to the text, the caret before the object.

Opens the selected box’s editor (Enter on a selected box). Edit mode only: read-only and review modes never mount the sub-editor.

The selected positioned object (picture, text box) and its position.

The selected text box and its position.

Inserts a text box anchored at the caret, where boxes may live (D5): square wrap on the right, white fill (Word’s inserted box; the schema’s null fill stays “no fill” for imported and existing boxes), one empty paragraph, the box selected. attrs override the defaults. open then opens its editor, caret inside (the Insert tab).

Moves the object at pos to the inline position to, with position as its new placement when given: the drop of a drag. One transaction, untracked; the object keeps its marks (a tracked insertion stays one) and its id, and ends selected. Refuses a place a text box may not live (D5). A refused move (not a dry run) is traced by debugFloatRejection.

Nudges the selected object by dx/dy px (Alt+Arrow): offsets for front, behind and top-and-bottom objects; a square float’s side for Left/Right. The anchor stays; an aligned horizontal axis first becomes the offset it is drawn at, measured in view. Inline objects are refused (they are text). Selected objects always take the key, so Alt+Left never reaches the browser.

Deletes the selected box and its content. Tracked like any inline node.

Brings the selected front or behind object forward past the next object overlapping it, or sends it backward past the previous one (Word’s bring forward / send backward). The object takes the order just past its neighbour’s and the layer’s objects from there up move one step, so every other pair keeps its order (renumbering the overlapping set alone could flip a neighbour against an object outside it). Needs the view to know what overlaps; without one it only says whether the object can be reordered.

Selects the next (1) or previous (-1) positioned object on the selection’s page, wrapping; from text, the page’s first (or last) one. Selection only, so it runs in every mode. Refuses when there is none, or when the only one is already selected.

Sets the box at pos to width: a width set is no longer Word’s auto width.

Sets one axis’s offset of the selected object (the position fields): the axis becomes an offset, the alignment goes.

Sets where the selected object sits.

Changes what one axis of the selected object is measured from, keeping it where it is drawn: a horizontal offset moves by the page margin between a column and a page frame; a vertical one by the anchor line’s distance from the paragraph start between a line and any other frame. Page and margin frames of a front or behind object the engine has placed are drawn on the page (L2) and convert through its page frame, an alignment becoming an offset; elsewhere they draw at the paragraph. A frame’s line form (yAlign="inline") has no offset, so it is refused.

Floats the selected object to a side of its column; floated wraps only.

Sets how text wraps the selected positioned object, and with side the side a floated wrap sits on, in one step. Text above and below a picture is the block image, which setImageWrap converts to.

Sets the selected box’s own attrs (size, border, fill, padding, text anchor, label), keeping it selected. A Word frame has no text anchor (w:framePr has none, and its dialog no such field), so a frame is refused one.

Converts the selected box to flow: its blocks go right after the host paragraph and the box goes. Untracked (D13), like lifting a callout: the text moves, nothing is written or removed.

Whether there is anything on the redo stack.

Whether there is anything on the undo stack.

Crops the picture: a crop moves an edge of the box, so the box and the percentages change together.

Mirrors the picture horizontally or vertically.

Inserts an upload placeholder that resolves into an image node once the upload completes. Refused in code blocks and with an image selected.

Word’s Reset Picture: clears crop, turn and effects, the DOCX passthrough included (Word’s reset discards those too). The scale is kept, so an uncropped picture’s box grows to the whole bitmap.

Resizes the selected image, block image or inline image_anchored.

Turns the picture by delta degrees clockwise.

Aligns the selected image. On a floated (square/tight) anchored image, start / end map to the float side; center and full-width apply to block images only.

Sets the alt text of an image (block or anchored). The three states are mutually exclusive, so this writes both attrs at once:

• { alt: "…" } → meaningful
• { decorative: true } → decorative (any alt text is discarded)
• { alt: null } → undeclared

Blank/whitespace alt text is undeclared, not an empty label — an empty string is how decorative is expressed in the DOM, and it must not be reachable by typing spaces into the dialog.

Sets some of the picture’s effects, validated; null clears one. Keys not in the patch are kept.

Sets the picture’s rotation, degrees clockwise.

Scales the selected block image to the width it lays out in: the content width, or its column in a column section (the content width again when it spans the columns), preserving its aspect ratio. An image that would then be taller than the page fits the page’s height instead, narrower, as Word fits a picture to the page.

Sets the wrap mode of the selected image, converting between the two image node types when needed:

• “top-bottom” → the BLOCK image node (text above and below).
• anything else → the inline image_anchored node with that wrap (“inline” | “square” | “tight” | “front” | “behind”).

Block → anchored moves the image INTO the adjacent textblock (next, else previous, else a fresh paragraph in place). Anchored → block hoists the image out of its paragraph and places it as the following block sibling. Same-kind changes are plain attribute updates.

Shows or hides the pilcrow / space / tab markers explicitly.

Toggles the pilcrow / space / tab markers.

Sets the document’s default proofing language — the bottom of paragraph.proofingLanguage ?? style.language ?? doc.language.

Dispatches updateCounters because numbering labels are language-sensitive (cardinalText, ordinalText) and the label memo ignores language, so it would otherwise keep the stale words.

Sets the proofing language attribute for all proofread nodes in the current selection. Triggers the updateCounters meta when a modified node has numbering, or when the document holds a cross-reference.

The cross-reference half is not incidental: an aboveBelow reference renders its “above”/“below” in the TARGET’s language, and an AttrStep carries an empty step map, so the cross-reference plugin’s change detection never sees one. Without the meta an Italian “sopra” stayed “sopra” after the target moved to French (REF-46).

Clears the pending-link state without creating a link. False when none is pending.

Opens the link at pos (default: the selection’s anchor) in a new tab, as Ctrl/Cmd+click does. False without a link there or a safe URL, so a menu item probing it disables itself. Dispatches no transaction.

Removes the link from the selection, or the whole link under a bare cursor.

Links the pending selection to url (sanitized), dropping code over it, and clears the pending state. False when nothing is pending or the URL is unsafe.

Links the pending selection to url (sanitized) and clears the pending state. False when nothing is pending or the URL is unsafe.

Enters the pending-link state that opens the link editor. A bare cursor selects the link under it, else the surrounding word. Refused in code blocks.

Inserts a display math node, optionally prefilled, with the caret in its LaTeX source. From a text cursor it splits the block and inserts between the halves.

Inserts an inline math node, optionally prefilled, with the caret in its LaTeX source.

Toggles the strong mark, expanding a bare cursor to the whole word.

Toggles the code mark, expanding a bare cursor to the whole word.

Refuses to APPLY inside a link (D10) — the toolbar toggle greys out via the same dry run. Removal is still allowed, so content that arrived carrying both marks (import, paste) can be cleaned up.

Deliberately not a schema excludes: that would strip the link when code is applied rather than refusing. The other direction is handled by the link commands, which drop code across the range they link.

Toggles the em mark, expanding a bare cursor to the whole word.

Toggles the strikethrough mark, expanding a bare cursor to the whole word.

Toggles the subscript mark, expanding a bare cursor to the whole word.

Toggles the superscript mark, expanding a bare cursor to the whole word.

Toggles the underline mark, expanding a bare cursor to the whole word.

Moves every numbered block in the selection one level up/down, or to level (which wins over direction). Clamped to the list’s deepest defined level; demoting past level 1 removes the numbering.

When a style-numbered paragraph’s target level is bound to a paragraph style, the change becomes a STYLE switch — the paragraph adopts the bound style and drops its own numbering attr, so the binding keeps driving it (Word’s legal-template model).

Transaction form: adjustLevelTr.

Applies listRef as direct numbering. Collapsed selection: re-lists every item of the caret block’s instance, or numbers an unnumbered block (joining an adjacent same-list instance). Ranged: numbers every non-empty numberable block, each keeping its own instance.

Transaction form: applyListRefTr.

Drops doc.attrs.listConfigs entries that no node or style references, and default-ref entries identical to the built-in.

Transaction form: cleanupUnusedListRefsTr.

Rejoins a restarted list to the one before it (Word’s “Continue numbering”), from any item of the run: the run, from its first item, adopts the instanceId of the nearest preceding item of the same list (by root list, so a fork’s items count), so its counters carry on rather than starting at 1. Refused when no such item precedes the run.

Removes a list config from doc.attrs.listConfigs. Command form of removeListConfigTr, symmetric with saveListConfigToDocAttrs.

Removes numbering from the numbered block at the selection.

Transaction form: removeNumberingTr.

Restarts numbering at the selected numbered paragraph: it is stamped with a fresh instanceId and everything after it on the same list follows, through the numbering plugin’s adjacency carry. On a sub-level item only that level restarts: the new run carries on the outer levels (openingStack).

Saves a list config into doc.attrs.listConfigs — a doc attribute, so the change syncs to collaborators and travels with the document.

A built-in default ref may be written too: the defaults are seed values, immutable only at initialization, and a doc-attrs entry SHADOWS the built-in (getListConfigs spreads the doc layer last). An entry that would be identical to the built-in is dropped rather than stored — it is pure duplication, and writing one back is how a shadow is reset.

Command form of setFollowByTr.

Sets the tabStop on the LEVEL CONFIG of the list at the selection (Word’s “Add tab stop at:”, stored per level in the list definition and exported as the level’s w:tabs).

Writes the config rather than the node attrs, so the choice survives into new instances and into the exported file; updateNumbering copies a default or shared config before writing. See setLevelConfigFieldTr for the style-binding rule.

setNumberingAttrsTr as a standalone command.

The list button (buttonType) or format dropdown (levelFormat) — pass exactly one.

Collapsed selection on a numbered block: a bullet↔number switch retargets the whole instance to the default list (unless it uses deeper levels), a repeat press toggles the block off, otherwise the level’s format is rewritten. On an unnumbered block: continues an adjacent list of matching type/format, else starts a new list.

Ranged selection: toggles off when every non-empty block is numbered and none switches type; otherwise re-lists them all onto one new instance.

Only the numbering attr is written; the plugin adds or removes the counter node.

Transaction form: toggleCounterTr.

Saves levels as a list config and moves the listRef/instanceId instance onto it. The target ref is reused when an identical config exists, forked when the old one is a default or shared by other instances (see returnComputedListRef); only a fork retargets the instance’s nodes.

Also refuses when the transaction would not change the doc.

A bulk command: the config is saved in the first transaction, the nodes are updated CHUNK_STEPS steps a transaction. Transaction form: updateNumberingTr.

Clears the query, range and match decorations, and closes the search UI.

Closes the search UI, resetting the query. No-ops when already closed.

Opens the search UI with an empty query. No-ops when already open.

Selects the next match after the selection, wrapping at the end of the range.

findNext without wrapping: fails once past the last match.

Selects the previous match before the selection, wrapping at the start of the range.

findPrev without wrapping: fails once before the first match.

Replaces the exact matches in the search range, at most replaceAllLimit, the first ones in document order: “Replaced N of M; run Replace All again to continue” (replaceAllCount). With an approximate query near misses are left alone, to be replaced one at a time after the user has seen them. A bulk command: matches are replaced last first, CHUNK_STEPS steps a transaction, or in edit mode as one batch step (replaceAllBatch). Fails when there is nothing to replace.

Replaces the selected match in place, leaving the selection on the result.

Replaces the selected match and moves to the next one. When no match is selected yet, selects the next one instead of replacing.

replaceNext without wrapping at the end of the range.

Opens or closes the search UI, resetting the query either way.

Splits the current section after the top-level block holding the cursor: the blocks after it move into a new section that inherits the current one’s page setup and header/footer. Refused in a flow layout mount.

A column break (Word’s Ctrl+Shift+Enter): the next column, or the next page in one column. Refused with column sections off (columnSectionsEnabled).

A hard page break (Word’s Ctrl+Enter).

Inserts a page-number field (current page, total pages, …) at the cursor.

Inserts a “1 of 12” pair of page-number fields.

True when EVERY suppressible block in the selection is already suppressed. Mixed selections read as “not suppressed”, so one toggle suppresses them all.

Removes the break that ends the section holding the selection head; in the last section, the break above it (the previous section then takes on the last one’s settings, as in Word).

Removes the section break after section index (mergeSectionIntoNext), in one undoable transaction. Refused with a toast when the doc has one section, or while track changes is suggesting (a tracked break deletion is not supported yet); refused silently when index is the last section.

Positional rather than selection-based so the section-break divider, which is chrome rather than a selectable position, can remove the break it draws.

Delete/Backspace/type-over/paste over a selection whose ends lie in different sections. False for any other selection, so the usual commands run.

Sets the section attrs headerFromTop / footerFromBottom.

Merges lineNumberNewAttrs into the current section’s line numbering (starting from the defaults when it is off), clamped to bounds.

Switches the current section between portrait and landscape, swapping the page width and height. Refused when already in that orientation.

Sets page borders on the current section, or every section; null removes them.

Whether text-measured page borders enclose the header and footer (document-wide).

Sets the current section’s columns; null returns it to one column. Too narrow columns shrink the gap, then the count (see clampSectionColumns).

Sets the watermark of the current section, or of every section; null removes it. Refuses a picture when the schema has no image node.

Sets the current section’s orientation, page size and/or margins. A page size whose aspect contradicts the orientation is transposed to match it.

Toggles line numbering on the current section: on with the defaults, or off (null).

Toggles spanColumns on the selected blocks of a column section: on unless they all span already. Only the blocks opening the section span (leadingColumnSpanners). Refused outside a column section.

Toggles suppressLineNumbers on every suppressible block in the selection.

Word’s semantics, applied by the pagination engine: a suppressed block’s lines are SKIPPED by the section’s line counter, so the next counted line takes the next number — they are not merely hidden.

upsertStyleDefinition restricted to new styles — fails on an existing id.

Deletes a custom style from the doc’s override map, re-pointing blocks and dependent styles (basedOn/next) at replaceWith. Throws for a DEFAULT_STYLE_SHEET style — those are reset, not deleted.

Re-points every paragraph/heading using prevStyleDefId at newStyleDefId. A bulk command: the blocks are re-pointed CHUNK_STEPS steps a transaction.

Binds a paragraph style to a list level, or clears the binding with null.

Enforces the model’s invariant — at most ONE style per (listRef, level) — by resetting any other style already occupying the slot. Dual storage is deliberately avoided: the binding lives only on the stylesheet side, and the listRef → level → styleId map is derived from it.

Transaction form: setStyleNumberingBindingTr.

Applies paragraph style styleSheetId to the paragraphs/headings in the selection, converting between paragraph and heading to match the style’s outline level. Refused for character styles and inside code blocks.

deleteMarks: true always strips direct-formatting marks; "sameStyle" strips them only when every block in the range already has this style.

Applies a style-definition edit as one undo step.

• Create (currentStyleDefId nullish): upsert under newStyleDefId.
• In-place update (ids equal): the stored override is REPLACED, not merged — the caller (stylesheet panel) submits the complete definition, so a field it omits means “cleared / back to inherited”. Merging would make clearing a saved value impossible.
• Rename (ids differ): rewrite doc block refs, remap dependent styles’ basedOn/next, drop the old override entry, then upsert under newStyleDefId. Renaming a DEFAULT_STYLE_SHEET key is rejected.

upsertStyleDefinition restricted to existing styles — fails on a missing id.

Upserts a (partial) style definition into the doc’s override map. The override map is sparse: only fields that diverge from DEFAULT_STYLE_SHEET live here. Existing overrides deep-merge with the incoming partial, so edits compose (e.g. setting fontSize then fontFamily keeps both). After merging, fields that match DEFAULT_STYLE_SHEET are pruned; if the whole override collapses to identity, the key is removed entirely.

Builds a table node sized to maxWidth, the host cell or the section content width. Shared by insertTable and programmatic builders like insertPageNumberPreset.

Removes the selected columns and redistributes their width across the remaining ones, so the table keeps its overall width. Refused when every column is selected, or every other one is pending deletion (TC-130).

With track changes on (or forced by review mode), neither happens yet. The track-changes engine (table-handler.ts) keeps each removed cell in the doc as a tracked deletion, so the grid stays rectangular while pending. Hence no skipTrackChanges here — that made the delete untracked (TC-41).

Width redistribution is skipped in that mode on purpose: the struck column keeps its width until accepted, and the resolver redistributes then (TC-104).

Removes the selected rows. When the selection spans every row, deletes the whole table instead (via deleteTable), since a table cannot be empty.

Delete a table and insert a paragraph in its place.

deleteTable, but only when the whole table is selected — so a Delete keypress inside a cell edits the cell instead of destroying the table.

Sets every selected column to widthInput px, or — when omitted — to their average width (needs 2+ columns). Floored at 25px. A fixed/pct table’s width follows a typed width that changes its overall width (D9).

Adds value to the table’s effective spacing on one side, floored at 0.

Inserts a column to the right of the selection, rescaling the existing columns so the table keeps its overall width.

Inserts a column to the left of the selection, rescaling the existing columns so the table keeps its overall width.

Inserts as many rows as the rect spans, at row index row. copyRow picks the row whose cell attrs (colspans, not rowspans) are copied: “bottom” the row at row, “top” the one above it, null plain cells. Rowspans crossing the insert point grow to cover the new rows. New rows are header rows when the row they copy is one (Word copies its “repeat as header row”), or, with nothing copied, when inserted above a header row.

Inserts rows below the selection, one per selected row, copying the last selected row’s cell attrs.

Inserts rows above the selection, one per selected row, copying the first selected row’s cell and row attrs, as Word’s Insert Above does. Above a header row the new rows are header rows too.

Inserts a table sized to the section’s content width, or its host cell’s, with the cursor in the first cell. Refused inside code blocks, inside a nested table (two levels at most), inside footnote/endnote bodies, and in a cell too narrow for cols columns.

Merges the selected cells into one. Only available when the selection’s outline forms a rectangle. Does not set skipTrackChanges — mergeCells does.

Transaction form: mergeCellsTr.

Selects every cell of the table containing the selection.

Selects every cell of the table at a known position, as a CellSelection.

Sets the alignment of the selected cells’ content. The CellAlignment token is a <vertical>-<horizontal> pair (“top-start”, “middle-center”, …): the vertical half lands on the cells’ verticalAlign attr, the horizontal half is forwarded to setTextAlignTr for the blocks inside them.

Sets attrs on the selected cells. A dry run reports false when the selection’s cell already has them, unless returnTrueOnSameValue.

The selected cells’ fill; themeRef is the theme slot it was picked from, and a fill without one clears the cell’s ref. No colour in a table with a table style is an explicit none (“transparent”), which hides the style’s band, as Word’s “No Color” does; elsewhere it clears the attr.

setCellAttrs for one attr.

Sets the height attr on every row covered by the selection. Pass null (or a value below the 30px minimum) to clear it, and its rule with it. rule sets Word’s height rule too (exact; null or atLeast is a minimum); left undefined, each row keeps its own.

Sets the height rule of every row covered by the selection: auto clears the height (the row fits its content), atLeast keeps the height as a minimum, exact pins the row at it. atLeast is stored as a null rule, which means the same (docs/executed/table-sizing-plan.md, D6). Refused for atLeast/exact when a covered row has no height to apply it to.

Sets keepTogether (Word’s w:cantSplit) on every row covered by the selection. Not applicable when every covered row already has keep.

Sets how many leading rows of the selected table are header rows (th), clamped to its row count. Not applicable when it already has that many.

The rows down to the selection’s last one become the header rows.

Word’s “Repeat Header Rows”: paint the header rows again at the top of every page the table continues onto. Not applicable without header rows.

Word’s “Header Row”: the first row becomes a header row, or every header row a body row.

Aligns the table within the section’s content width.

Sets the selected table’s layout, Word’s w:tblLayout. Carried for the DOCX round trip only: the editor always lays tables out with fixed columns (docs/executed/table-sizing-plan.md, D4).

Turns table-style regions on or off for the selected table (Word’s Style Options: Header Row, Total Row, First/Last Column, Banded Rows/Columns). Independent of the table’s header rows (headerRowCount), as in Word.

Stores the sort configuration (column, direction, value type) on the table. Persisting it lets sortTableRows re-run later with the same settings.

Merges spacing into the table’s space before/after; sides not given keep their current value. Requires the whole table to be selected.

setTableSpacing for one side only, leaving the other untouched.

Applies a table style to the selected table (Word’s Table Design gallery), or none. The cells’ own formatting is kept, over the style (Word’s “Apply (and Maintain Formatting)”). Not applicable for an id the sheet has no table style under, or the style the table already has.

Sets the selected table’s width (docs/executed/table-sizing-plan.md): the sizing plugin then rescales its columns to it, keeping their shares. Refused when the table already has that width, or for a percentage with no width to take it of (a cell without column widths).

Switches the selected table’s width type without changing its size: fixed at its current width, pct at its current share of the width it lays out in, auto the columns’ own. Refused when the type is already set, the table has a column without a width, or (pct) it is wider than its block.

Reorders the table’s rows by a column’s value (text, number or date per orderBy). Falls back to the table’s stored sort options, then to defaults, when options is omitted. Refused (with a toast) on vertical merges or an out-of-range column; false when already sorted.

Split a selected cell, whose rowspan or colspan is greater than one, into smaller cells. The new cells reuse the split cell’s own type.

Splits the table in two at the cursor’s row, which becomes the first row of the second table. Refused on the first row, which would leave an empty table.

Changes the case of the selected text — Word’s Sentence case, UPPERCASE, lowercase and Capitalize Each Word.

A rewrite, not a format: the characters themselves change and nothing is stored, so undo is the only way back (setCaps is the reversible half). One transaction covers the whole selection (at a caret, the word around it), and only the characters that actually differ are replaced, so the anchors of comments and proofread suggestions inside the range survive.

Drops the direct background formatting so the block falls back to its stylesheet’s paragraphStyle.backgroundColor — the “use stylesheet value” action, as opposed to setBackgroundColor("transparent") which explicitly overrides the stylesheet with no fill.

Clears the run-level mark over the selection too: a leftover textStyle background would keep painting over the restored block color.

Transaction form: clearBackgroundColorTr.

Clears the color override, back to the stylesheet’s.

Word’s Shift+F3: the same three changes as a cycle — lowercase → UPPERCASE → Capitalize Each Word → lowercase — so repeated presses walk the selection round the ring.

The current case is read off the selected text itself, since nothing stores it: text that equals its own lowercasing is lowercase, text that equals its own uppercasing is uppercase, and anything else (capitalized or mixed) counts as the third state. Caseless text — digits, CJK — equals both, and lands on Capitalize, which rewrites nothing.

Steps the font size to the next or previous entry of FONT_SIZES, without dispatching. Text with no explicit size starts from its stylesheet’s size, so stepping up from an inherited 11pt lands on 12pt rather than a hardcoded default. Above the list’s top entry (72pt) it steps to 80pt, then by 10pt up to 140pt; sizes typed above that (up to FONT_SIZE_MAX) are left where they are.

With a bare cursor inside a word the whole word is resized; at a word boundary the new size is stored for the next keystroke.

Transaction form: incrementFontSizeTr.

Sets a background color, choosing between a mark and a node attr so the fill covers exactly what the user selected.

• Partial selection inside one block: a textStyle mark on the selected text.
• Caret, whole block, or a selection spanning several blocks: the block’s own bgColor attr, so the fill extends to the block edges.
• Table cells in the selection (including a whole paragraph inside a cell): the cell’s attr rather than the paragraph’s.

"transparent" is stored as-is — an explicit “no fill” that overrides the block’s stylesheet background. Pass null to clear the direct formatting instead and fall back to the stylesheet (clearBackgroundColor).

Refused inside code blocks.

themeRef is the theme slot the colour was picked from; without one, any ref the target had is cleared.

Transaction form: setBackgroundColorTr.

Sets the casing FORMAT on the selection: "all" (Word’s all caps), "small" (small caps), "none" (an explicit off that beats an inherited caps), or null to re-inherit. UPPERCASE/lowercase/Capitalize are text edits, not a format — they are not values here.

Sets the textStyle mark’s color on the selection. themeRef is the theme slot the colour was picked from (it must resolve to color under the doc’s theme); without one, any ref the run had is cleared.

Sets the font family on the selection. An empty or null value clears the override.

Sets the font size (pt) on the selection. Null removes the override: the text takes its style’s size.

Inserts a toc node at the cursor. Refused inside tables.

Sets one setting of the toc at pos. An imported TOC’s stored field instruction gets the matching switch rewritten, so the export keeps the rest of it. Only page numbers have a switch: number alignment and leader dots live in Word’s TOC styles, and Word has no section scope.

Sets what the toc at pos lists, by rewriting its field instruction’s \o and \t switches. An editor-made TOC (no instruction) gets the one the export would derive for it first, so the two agree.

Wraps the selected blocks (or the caret’s block) in a callout of kind. Where they can’t be wrapped, inserts a callout holding a placeholder paragraph. Refused past MAX_CALLOUT_DEPTH (the schema allows deeper, e.g. by paste).

Removes the callout around (or at) the selection, keeping its content.

Sets the kind and/or title of the callout at pos (a node view’s), else the one around (or at) the selection.

Inserts a field for variable name at the cursor. Refused in code blocks.

Inserts the content_slot at the cursor. Refused inside tables (only section_content can hold it) and when the document already has one: a template has a single place for its content.

Whether something is armed to consume the next Escape: an in-state consumer (format painter, highlighter, search, the paste-options button, a selected picture or text box, which Escape leaves for the text) or a registered external one (see registerEscapeConsumer).

Chrome with an Escape fallback (e.g. focus-to-toolbar) must ask here: ProseMirror’s captureKeyDown calls preventDefault() on every Escape, so event.defaultPrevented is always true. Read it in the capture phase — once ProseMirror has processed the key the consumer has already disarmed itself.

Declares that something outside the editor state (an open floating menu) will consume the next Escape for rootEditorId. Returns the unregister; call it when the consumer closes. The consumer owns its own dismissal — this only stops chrome fallbacks (focus-to-toolbar) from firing on the same keypress.