prosekit/extensions/enter-rule

Options for EnterRuleHandler.

state: EditorState

The current editor state.

from: number

The start position of the matched text.

to: number

The end position of the matched text.

match: RegExpExecArray

The matched result from the regular expression.

---

Options for defineTextBlockEnterRule.

regex: RegExp

The regular expression to match against. It should end with $.

type: string | NodeType

The node type to replace the matched text with.

attrs?: Attrs | (match: RegExpMatchArray) => Attrs | null | null

Attributes to set on the node. If a function is provided, it will be called with the matched result from the regular expression.

stop?: boolean

Whether to stop further handlers from being called if this rule is triggered.

Default

Section titled “Default”

true

type EnterRuleHandler = (options: EnterRuleHandlerOptions) => Transaction | null

---

type EnterRuleOptions = { regex: RegExp; handler: EnterRuleHandler; stop?: boolean; }

Options for defineEnterRule.

regex: RegExp

The regular expression to match against. It should end with $.

handler: EnterRuleHandler

A function to be called when an enter rule is triggered.

stop?: boolean

Whether to stop further handlers from being called if this rule is triggered.

Default

Section titled “Default”

false

function defineEnterRule(options: EnterRuleOptions): PlainExtension

Defines an enter rule. An enter rule applies when the text directly in front of the cursor matches regex and user presses Enter. The regex should end with $.

---

function defineTextBlockEnterRule(options: TextBlockEnterRuleOptions): PlainExtension

Defines an enter rule that replaces the matched text with a block node.

See also defineEnterRule.