Skip to Content
API Referencecorecore/commands

@stesura/core/commands

Document mutations, as ProseMirror Commands or factories that return one, plus a few related predicates and builders. Run a command with command(view.state, view.dispatch, view); call it without dispatch to check whether it applies (for a toolbar’s enabled state) without changing anything. Group commands into one undo step with composeCommands, or all-or-nothing with sequenceCommands.

Core

clearFormatting

Parameters:
NameTypeDefault
optionsClearFormattingOptions
Returns:
Command

composeCommands

Parameters:
NameTypeDefault
commandsCommand[]
Returns:
Command

deleteNode

Parameters:
NameTypeDefault
posnumber
Returns:
Command

insertContent

Parameters:
NameTypeDefault
valuestring | JSONContent | JSONContent[] | Node | Fragment
Returns:
Command

insertOrWrapNode

Parameters:
NameTypeDefault
nodeNamestring
attributesAttrs
Returns:
Command

insertSymbol

Parameters:
NameTypeDefault
symbolstring
Returns:
Command

resetAttributes

Parameters:
NameTypeDefault
__0{ attributes: string | string[]; typeOrName: string | NodeType | MarkType; }
Returns:
Command

sequenceCommands

Parameters:
NameTypeDefault
commandsCommand[]
Returns:
Command

setMark

Parameters:
NameTypeDefault
typeOrNamestring | MarkType
attributesAttrs
Returns:
Command

setNode

Parameters:
NameTypeDefault
typeOrNamestring | NodeType
attributes{}
Returns:
Command

toggleHeading

Parameters:
NameTypeDefault
levelnumber
Returns:
Command

toggleMark

Parameters:
NameTypeDefault
markTypeMarkType
attrsAttrs
optionsToggleMarkOptions
Returns:
Command

toggleMarkOnEntireWord

Parameters:
NameTypeDefault
markNamestring
attrsAttrs
Returns:
Command

toggleNode

Parameters:
NameTypeDefault
typeOrNamestring | NodeType
toggleTypeOrNamestring | NodeType
attributes{}
Returns:
Command

unsetMark

Parameters:
NameTypeDefault
typeOrNamestring | MarkType
options{ extendEmptyMarkRange?: boolean; }
Returns:
Command

updateAttributeAt

Parameters:
NameTypeDefault
__0{ attribute: string; value: unknown; pos: number; type?: string | NodeType; }
Returns:
Command

updateAttributes

Parameters:
NameTypeDefault
__0UpdateAttributesProps
Returns:
Command

Borders

insertHorizontalRule

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

setBorders

Parameters:
NameTypeDefault
bordersBorders
Returns:
Command

toggleOutline

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

Code Block

insertCodeBlock

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

splitCodeBlock

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

updateCodeBlockAttrs

Parameters:
NameTypeDefault
attributekeyof CodeBlockAttrs
valueunknown
posnumber
Returns:
Command

Document Attributes

setDocAttr

Parameters:
NameTypeDefault
attrK
valueDocAttrs[K]
Returns:
Command

setDocBgColor

Parameters:
NameTypeDefault
colorstring
Returns:
Command

setDocDirection

Parameters:
NameTypeDefault
dirTextDirection
Returns:
Command

File

applyFileNodeMove

Parameters:
NameTypeDefault
trTransaction
posnumber
direction1 | -1
Returns:
number | null

insertFileUpload

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

moveFileNode

Parameters:
NameTypeDefault
posnumber
direction1 | -1
Returns:
Command

rotateFile

Parameters:
NameTypeDefault
posnumber
deltanumber
Returns:
Command

setFileDisplayPreview

Parameters:
NameTypeDefault
posnumber
displayPreviewboolean
Returns:
Command

setFileRotation

Parameters:
NameTypeDefault
posnumber
rotationnumber
Returns:
Command

Format Painter

applyFormatPainter

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

disableFormatPainter

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

enableFormatPainter

Parameters:
NameTypeDefault
__0{ once: boolean; }

Disarm after the first applyFormatPainter ; false keeps it armed until disableFormatPainter .

Returns:
Command

Formatting

alignJustifyLeftOnly

Parameters:
This function does not accept any parameters.
Returns:
Command

alignJustifyLeftRight

Parameters:
This function does not accept any parameters.
Returns:
Command

incrementSpacing

Parameters:
NameTypeDefault
__0{ position: "before" | "after"; value: number; }
Returns:
Command

indent

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

outdent

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

resetAlignment

Parameters:
NameTypeDefault
idsstring[]
Returns:
Command

resetIndent

Parameters:
NameTypeDefault
idsstring[]
Returns:
Command

resetLineHeight

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

resetPagination

Parameters:
This function does not accept any parameters.
Returns:
Command

resetSpacing

Parameters:
NameTypeDefault
idsstring[]
Returns:
Command

setDirection

Parameters:
NameTypeDefault
dirTextDirection
Returns:
Command

setFormatting

Parameters:
NameTypeDefault
formattingFormattingUpdate
Returns:
Command

setLineHeight

Parameters:
NameTypeDefault
lineHeightnumber
Returns:
Command

setPaginationAttrs

Parameters:
NameTypeDefault
partialPaginationAttrs
Returns:
Command

setSpacing

Parameters:
NameTypeDefault
spacingSpacingAttrs
Returns:
Command

setSpacingBeforeAfter

Parameters:
NameTypeDefault
__0{ position: "before" | "after"; value: number; }
Returns:
Command

setTextAlign

Parameters:
NameTypeDefault
alignTextAlignType
Returns:
Command

setTextAlignOnlyOn

Parameters:
NameTypeDefault
__0{ applyOnAlignments: string[]; newAlignment: string; }
Returns:
Command

toggleDirection

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

deleteHeaderFooterContent

Parameters:
NameTypeDefault
sectionIdstring
variantHeaderFooterVariant
Returns:
Command

fixHeadersFooters

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

insertHeaderFooterContent

Parameters:
NameTypeDefault
sectionIdstring
variantHeaderFooterVariant
Returns:
Command

insertPageNumberPreset

Parameters:
NameTypeDefault
__0{ sectionId: string; variant?: HeaderFooterVariant; position: PageNumberPresetPosition; pageType?: PageNumberType; }
Returns:
Command

PageNumberPresetPosition

NameTypeDefault
vertical"top" | "bottom"
horizontal"left" | "center" | "right"

Highlight

disableHighlight

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

enableHighlight

Parameters:
NameTypeDefault
colorstring
Returns:
Command

setHighlight

Parameters:
NameTypeDefault
colorstring
Returns:
Command

toggleHighlight

Parameters:
NameTypeDefault
colorstring
Returns:
Command

unsetHighlight

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

History

canRedo

Parameters:
NameTypeDefault
stateEditorState
Returns:
boolean

canUndo

Parameters:
NameTypeDefault
stateEditorState
Returns:
boolean

redo

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

undo

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

Images

insertImageUpload

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

resetAspectRatio

Parameters:
NameTypeDefault
attrsAspectRatioAttrs
Returns:
Command

resizeImage

Parameters:
NameTypeDefault
sizeSize
Returns:
Command

setImageAlignment

Parameters:
NameTypeDefault
alignImageAlign
Returns:
Command

setImageAlt

Parameters:
NameTypeDefault
__0SetImageAltProps
Returns:
Command

setImageSide

Parameters:
NameTypeDefault
sideImageAnchoredSide
Returns:
Command

setImageToFullWidth

Parameters:
This function does not accept any parameters.
Returns:
Command

setImageWrap

Parameters:
NameTypeDefault
wrapImageWrapMode
Returns:
Command

Invisible Characters

setInvisibleCharacters

Parameters:
NameTypeDefault
showboolean
Returns:
Command

toggleInvisibleCharacters

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

Language

setDocLanguage

Parameters:
NameTypeDefault
languagestring
Returns:
Command

setLanguage

Parameters:
NameTypeDefault
languagestring

The language code (e.g., “en-GB”, “en-US”, “fr-FR”), or null to drop the explicit stamp and follow the style/document language.

Returns:
Command
Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean
Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean
Parameters:
NameTypeDefault
urlstring
Returns:
Command

setLinkUrl

Parameters:
NameTypeDefault
urlstring
Returns:
Command
Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

Math

insertMathDisplay

Parameters:
NameTypeDefault
initialTextstring
Returns:
Command

insertMathInline

Parameters:
NameTypeDefault
initialTextstring
Returns:
Command

Marks (shortcuts)

toggleBold

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

toggleCode

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

toggleItalic

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

toggleStrike

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

toggleSubscript

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

toggleSuperscript

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

toggleUnderline

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

Numbering

adjustLevel

Parameters:
NameTypeDefault
propsAdjustLevelProps
Returns:
Command

AdjustLevelProps

NameTypeDefault
direction"up" | "down"
levelnumber

applyListRef

Parameters:
NameTypeDefault
listRefstring
Returns:
Command

cleanupUnusedListRefs

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

continueNumbering

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

removeListConfig

Parameters:
NameTypeDefault
referencestring

The listRef to remove.

Returns:
Command

removeNumbering

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

restartNumbering

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

saveListConfigToDocAttrs

Parameters:
NameTypeDefault
referencestring
levelsILevelsOptions[]
Returns:
Command

setFollowBy

Parameters:
NameTypeDefault
followBy"tab" | "space" | "nothing"

What to place between the number and the text.

Returns:
Command

setListTabStop

Parameters:
NameTypeDefault
tabStopnumber

width of the counter cell in px; null removes the value.

Returns:
Command

setNumberingAttrs

Parameters:
NameTypeDefault
newNumberingAttrsPartial<NumberingAttrs>
Returns:
Command

toggleCounter

Parameters:
NameTypeDefault
propsToggleCounterTrProps
Returns:
Command

updateNumbering

Parameters:
NameTypeDefault
propsUpdateNumberingProps
Returns:
Command

clearSearchState

Parameters:
This function does not accept any parameters.
Returns:
Command

disableSearchState

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

enableSearchState

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

findNext

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

findNextNoWrap

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

findPrev

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

findPrevNoWrap

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

replaceAll

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

replaceCurrent

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

replaceNext

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

replaceNextNoWrap

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

toggleSearchState

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

Sections

addSection

Parameters:
This function does not accept any parameters.
Returns:
Command

focusHeaderFooter

Parameters:
NameTypeDefault
focusOn"header" | "footer"
Returns:
Command

HeaderFooterDistanceOptions

NameTypeDefault
headerFromTopnumber

Distance (px) from the top of the page to the header.

footerFromBottomnumber

Distance (px) from the bottom of the page to the footer.

insertPageBreak

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

insertPageNumber

Parameters:
NameTypeDefault
__0PageNumberAttrs
Returns:
Command

insertPageOfPage

Parameters:
NameTypeDefault
middleTextstring

Separator word between the two fields, defaulting to “of”. A space is added on each side, so pass the bare word — ” of ” would render as “1 of 12”.

Returns:
Command

lineNumbersSuppressed

Parameters:
NameTypeDefault
stateEditorState
Returns:
boolean

openFooter

Parameters:
NameTypeDefault
nodeIdstring
Returns:
Command

openHeader

Parameters:
NameTypeDefault
nodeIdstring
Returns:
Command

removeSection

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

removeSectionAt

Parameters:
NameTypeDefault
sectionPosnumber
Returns:
Command

setHeaderFooterDistance

Parameters:
NameTypeDefault
optionsHeaderFooterDistanceOptions
sectionIdstring
Returns:
Command

setLineNumbers

Parameters:
NameTypeDefault
lineNumberNewAttrsPartial<LineNumbersAttrs>
Returns:
Command

setOrientation

Parameters:
NameTypeDefault
orientation"portrait" | "landscape"
Returns:
Command

setSectionFormat

Parameters:
NameTypeDefault
optionsSectionOptions
Returns:
Command

toggleLineNumbers

Parameters:
This function does not accept any parameters.
Returns:
Command

toggleSuppressLineNumbers

Parameters:
NameTypeDefault
suppressboolean

Force a value instead of toggling.

Returns:
Command

Style Sheets

createStyleDefinition

Parameters:
NameTypeDefault
styleIdstring
styleDefStyleDefinition
Returns:
Command

deleteStyleDefinition

Parameters:
NameTypeDefault
styleDefIdstring
replaceWithstring
Returns:
Command

replaceStyleDefIds

Parameters:
NameTypeDefault
prevStyleDefIdstring
newStyleDefIdstring
Returns:
Command

setStyleNumberingBinding

Parameters:
NameTypeDefault
styleIdstring
numberingStyleNumbering
Returns:
Command

setStyleSheet

Parameters:
NameTypeDefault
styleSheetIdstring
deleteMarkstrue | "sameStyle"
Returns:
Command

submitStyleDefChange

Parameters:
NameTypeDefault
currentStyleDefIdstring
newStyleDefIdstring
styleDefStyleDefinition
Returns:
Command

updateStyleDefinition

Parameters:
NameTypeDefault
styleIdstring
styleDefPartial<StyleDefinition>
Returns:
Command

upsertStyleDefinition

Parameters:
NameTypeDefault
styleIdstring
styleDefPartial<StyleDefinition>
optionsUpsertStyleDefinitionOptions

falseIfExists / falseIfNotExists turn the upsert into a create-only / update-only operation, returning false (with a warning) when the precondition fails. See createStyleDefinition and updateStyleDefinition. replace skips the merge and stores styleDef as the whole override — for callers that submit a complete definition and need omitted fields to mean “cleared” rather than “unchanged” (the stylesheet panel). Dependent styles are unaffected: they store no copies, the resolver walks basedOn on read.

Returns:
Command

Tables

createTableNode

Parameters:
NameTypeDefault
stateEditorState
optionsCreateTableOptions
Returns:
Node | null

deleteColumn

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
Returns:
boolean

deleteRow

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

deleteTable

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

deleteTableIfSelected

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

distributeColWidths

Parameters:
NameTypeDefault
widthInputnumber
Returns:
Command

incrementTableSpacing

Parameters:
NameTypeDefault
__0{ position: "before" | "after"; value: number; }
Returns:
Command

insertColumnAfter

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

insertColumnBefore

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

insertRow

Parameters:
NameTypeDefault
__0TableRect
rownumber
copyRow"bottom" | "top"
updateSelectionboolean
Returns:
TransactionFn

insertRowAfter

Parameters:
NameTypeDefault
updateSelectionboolean
Returns:
Command

insertRowBefore

Parameters:
NameTypeDefault
updateSelectionboolean
Returns:
Command

insertTable

Parameters:
NameTypeDefault
__0{ rows: number; cols: number; borders?: Borders | null; }
Returns:
Command

mergeCells

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

selectEntireTable

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

selectEntireTableAtPos

Parameters:
NameTypeDefault
tablePosnumber
Returns:
Command

setCellAlignment

Parameters:
NameTypeDefault
alignment"top-start" | "top-center" | "top-end" | "middle-start" | "middle-center" | "middle-end" | "bottom-start" | "bottom-center" | "bottom-end"
Returns:
Command

setCellAttr

Parameters:
NameTypeDefault
namestring
valueunknown
returnTrueOnSameValueboolean
Returns:
Command

setRowHeight

Parameters:
NameTypeDefault
heightnumber
Returns:
Command

setTableAlignment

Parameters:
NameTypeDefault
alignmentTableAlign
Returns:
Command

setTableSortOptions

Parameters:
NameTypeDefault
optionsSortOptions
Returns:
Command

setTableSpacing

Parameters:
NameTypeDefault
spacingSpacingAttrs
Returns:
Command

setTableSpacingBeforeAfter

Parameters:
NameTypeDefault
__0{ position: "before" | "after"; value: number; }
Returns:
Command

sortTableRows

Parameters:
NameTypeDefault
optionsSortOptions
Returns:
Command

splitCell

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
Returns:
boolean

splitTable

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

Text Style

changeCase

Parameters:
NameTypeDefault
modeCaseChange
Returns:
Command

clearBackgroundColor

Parameters:
This function does not accept any parameters.
Returns:
Command

clearFontColor

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

cycleCase

Parameters:
NameTypeDefault
stateEditorState
dispatch(tr: Transaction) => void
viewEditorView
Returns:
boolean

incrementFontSize

Parameters:
NameTypeDefault
direction"up" | "down"
Returns:
Command

setBackgroundColor

Parameters:
NameTypeDefault
colorstring
Returns:
Command

setCaps

Parameters:
NameTypeDefault
valueCaps
Returns:
Command

setFontColor

Parameters:
NameTypeDefault
colorstring
Returns:
Command

setFontFamily

Parameters:
NameTypeDefault
fontstring
Returns:
Command

setFontSize

Parameters:
NameTypeDefault
fontSizenumber
Returns:
Command

Table of Contents

insertTOC

Parameters:
This function does not accept any parameters.
Returns:
Command

Escape

hasEscapeConsumer

Parameters:
NameTypeDefault
stateEditorState
Returns:
boolean

registerEscapeConsumer

Parameters:
NameTypeDefault
rootEditorIdstring
Returns:
() => void
Last updated on