snapshot of https://github.com/ueberdosis/tiptap.git (main, 2026-09-15; blobs > 131072B omitted)

packages/extension-code-block/README.md

@@ -0,0 +1,18 @@
+# @tiptap/extension-code-block
+
+[![Version](https://img.shields.io/npm/v/@tiptap/extension-code-block.svg?label=version)](https://www.npmjs.com/package/@tiptap/extension-code-block)
+[![Downloads](https://img.shields.io/npm/dm/@tiptap/extension-code-block.svg)](https://npmcharts.com/compare/tiptap?minimal=true)
+[![License](https://img.shields.io/npm/l/@tiptap/extension-code-block.svg)](https://www.npmjs.com/package/@tiptap/extension-code-block)
+[![Sponsor](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub)](https://github.com/sponsors/ueberdosis)
+
+## Introduction
+
+Tiptap is a headless wrapper around [ProseMirror](https://ProseMirror.net) – a toolkit for building rich text WYSIWYG editors, which is already in use at many well-known companies such as _New York Times_, _The Guardian_ or _Atlassian_.
+
+## Official Documentation
+
+Documentation can be found on the [Tiptap website](https://tiptap.dev).
+
+## License
+
+Tiptap is open sourced software licensed under the [MIT license](https://github.com/ueberdosis/tiptap/blob/main/LICENSE.md).

packages/extension-code-block/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@tiptap/extension-code-block",
+  "version": "3.30.3",
+  "description": "code block extension for tiptap",
+  "keywords": [
+    "tiptap",
+    "tiptap extension"
+  ],
+  "homepage": "https://tiptap.dev",
+  "bugs": {
+    "url": "https://github.com/ueberdosis/tiptap/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ueberdosis/tiptap",
+    "directory": "packages/extension-code-block"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/ueberdosis"
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.ts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "vp pack"
+  },
+  "devDependencies": {
+    "@tiptap/core": "workspace:^",
+    "@tiptap/pm": "workspace:^"
+  },
+  "peerDependencies": {
+    "@tiptap/core": "workspace:*",
+    "@tiptap/pm": "workspace:*"
+  }
+}

packages/extension-code-block/src/code-block.test.ts

@@ -0,0 +1,97 @@
+import { Editor } from '@tiptap/core'
+import { Document } from '@tiptap/extension-document'
+import { Paragraph } from '@tiptap/extension-paragraph'
+import { Text } from '@tiptap/extension-text'
+import { afterEach, describe, expect, it } from 'vite-plus/test'
+
+import { CodeBlock } from './code-block.js'
+
+const pressArrowUp = (editor: Editor) => {
+  editor.view.dispatchEvent(new KeyboardEvent('keydown', { key: 'ArrowUp', code: 'ArrowUp' }))
+}
+
+describe('CodeBlock ArrowUp exit', () => {
+  let editor: Editor
+
+  afterEach(() => {
+    editor?.destroy()
+  })
+
+  it('inserts a paragraph above when the code block is the only node', () => {
+    editor = new Editor({
+      extensions: [Document, Paragraph, Text, CodeBlock],
+      content: '<pre><code>hello</code></pre>',
+    })
+    editor.commands.setTextSelection(1)
+
+    pressArrowUp(editor)
+
+    expect(editor.getHTML()).toBe('<p></p><pre><code>hello</code></pre>')
+    expect(editor.state.selection.$from.parent.type.name).toBe('paragraph')
+    expect(editor.state.selection.from).toBe(1)
+    expect(editor.state.selection.to).toBe(1)
+  })
+
+  it('inserts a paragraph above when the code block is the first node in the doc', () => {
+    editor = new Editor({
+      extensions: [Document, Paragraph, Text, CodeBlock],
+      content: '<pre><code>hello</code></pre><p>after</p>',
+    })
+    editor.commands.setTextSelection(1)
+
+    pressArrowUp(editor)
+
+    expect(editor.getHTML()).toBe('<p></p><pre><code>hello</code></pre><p>after</p>')
+    expect(editor.state.selection.$from.parent.type.name).toBe('paragraph')
+    expect(editor.state.selection.from).toBe(1)
+    expect(editor.state.selection.to).toBe(1)
+  })
+
+  it('does nothing when exitOnArrowUp is disabled', () => {
+    editor = new Editor({
+      extensions: [Document, Paragraph, Text, CodeBlock.configure({ exitOnArrowUp: false })],
+      content: '<pre><code>hello</code></pre>',
+    })
+    editor.commands.setTextSelection(1)
+    const before = editor.getHTML()
+
+    pressArrowUp(editor)
+
+    expect(editor.getHTML()).toBe(before)
+  })
+
+  it('does nothing when a node precedes the code block', () => {
+    editor = new Editor({
+      extensions: [Document, Paragraph, Text, CodeBlock],
+      content: '<p>before</p><pre><code>hello</code></pre>',
+    })
+
+    let codeBlockContentStart = 0
+    editor.state.doc.descendants((node, pos) => {
+      if (node.type.name === 'codeBlock') {
+        codeBlockContentStart = pos + 1
+        return false
+      }
+      return true
+    })
+    editor.commands.setTextSelection(codeBlockContentStart)
+    const before = editor.getHTML()
+
+    pressArrowUp(editor)
+
+    expect(editor.getHTML()).toBe(before)
+  })
+
+  it('does nothing when the caret is not at the start of the code block', () => {
+    editor = new Editor({
+      extensions: [Document, Paragraph, Text, CodeBlock],
+      content: '<pre><code>hello</code></pre>',
+    })
+    editor.commands.setTextSelection(3)
+    const before = editor.getHTML()
+
+    pressArrowUp(editor)
+
+    expect(editor.getHTML()).toBe(before)
+  })
+})

packages/extension-code-block/src/code-block.ts

@@ -0,0 +1,514 @@
+import { mergeAttributes, Node, textblockTypeInputRule } from '@tiptap/core'
+import { Plugin, PluginKey, Selection, TextSelection } from '@tiptap/pm/state'
+
+const DEFAULT_TAB_SIZE = 4
+
+export interface CodeBlockOptions {
+  /**
+   * Adds a prefix to language classes that are applied to code tags.
+   * @default 'language-'
+   */
+  languageClassPrefix: string | null | undefined
+  /**
+   * Define whether the node should be exited on triple enter.
+   * @default true
+   */
+  exitOnTripleEnter: boolean | null | undefined
+  /**
+   * Define whether the node should be exited on arrow down if there is no node after it.
+   * @default true
+   */
+  exitOnArrowDown: boolean | null | undefined
+  /**
+   * Define whether the node should be exited on arrow up if there is no node before it.
+   * @default true
+   */
+  exitOnArrowUp: boolean | null | undefined
+  /**
+   * The default language.
+   * @default null
+   * @example 'js'
+   */
+  defaultLanguage: string | null | undefined
+  /**
+   * Enable tab key for indentation in code blocks.
+   * @default false
+   */
+  enableTabIndentation: boolean | null | undefined
+  /**
+   * The number of spaces to use for tab indentation.
+   * @default 4
+   */
+  tabSize: number | null | undefined
+  /**
+   * Custom HTML attributes that should be added to the rendered HTML tag.
+   * @default {}
+   * @example { class: 'foo' }
+   */
+  HTMLAttributes: Record<string, any>
+}
+
+declare module '@tiptap/core' {
+  interface Commands<ReturnType> {
+    codeBlock: {
+      /**
+       * Set a code block
+       * @param attributes Code block attributes
+       * @example editor.commands.setCodeBlock({ language: 'javascript' })
+       */
+      setCodeBlock: (attributes?: { language: string }) => ReturnType
+      /**
+       * Toggle a code block
+       * @param attributes Code block attributes
+       * @example editor.commands.toggleCodeBlock({ language: 'javascript' })
+       */
+      toggleCodeBlock: (attributes?: { language: string }) => ReturnType
+    }
+  }
+}
+
+/**
+ * Matches a code block with backticks.
+ */
+export const backtickInputRegex = /^```([a-z]+)?[\s\n]$/
+
+/**
+ * Matches a code block with tildes.
+ */
+export const tildeInputRegex = /^~~~([a-z]+)?[\s\n]$/
+
+/**
+ * This extension allows you to create code blocks.
+ * @see https://tiptap.dev/api/nodes/code-block
+ */
+export const CodeBlock = Node.create<CodeBlockOptions>({
+  name: 'codeBlock',
+
+  addOptions() {
+    return {
+      languageClassPrefix: 'language-',
+      exitOnTripleEnter: true,
+      exitOnArrowDown: true,
+      exitOnArrowUp: true,
+      defaultLanguage: null,
+      enableTabIndentation: false,
+      tabSize: DEFAULT_TAB_SIZE,
+      HTMLAttributes: {},
+    }
+  },
+
+  content: 'text*',
+
+  marks: '',
+
+  group: 'block',
+
+  code: true,
+
+  defining: true,
+
+  addAttributes() {
+    return {
+      language: {
+        default: this.options.defaultLanguage,
+        parseHTML: element => {
+          const { languageClassPrefix } = this.options
+
+          if (!languageClassPrefix) {
+            return null
+          }
+
+          const classNames = [...(element.firstElementChild?.classList || [])]
+          const languages = classNames
+            .filter(className => className.startsWith(languageClassPrefix))
+            .map(className => className.replace(languageClassPrefix, ''))
+          const language = languages[0]
+
+          if (!language) {
+            return null
+          }
+
+          return language
+        },
+        rendered: false,
+      },
+    }
+  },
+
+  parseHTML() {
+    return [
+      {
+        tag: 'pre',
+        preserveWhitespace: 'full',
+      },
+    ]
+  },
+
+  renderHTML({ node, HTMLAttributes }) {
+    return [
+      'pre',
+      mergeAttributes(this.options.HTMLAttributes, HTMLAttributes),
+      [
+        'code',
+        {
+          class: node.attrs.language
+            ? this.options.languageClassPrefix + node.attrs.language
+            : null,
+        },
+        0,
+      ],
+    ]
+  },
+
+  markdownTokenName: 'code',
+
+  parseMarkdown: (token, helpers) => {
+    if (
+      token.raw?.startsWith('```') === false &&
+      token.raw?.startsWith('~~~') === false &&
+      token.codeBlockStyle !== 'indented'
+    ) {
+      return []
+    }
+
+    return helpers.createNode(
+      'codeBlock',
+      { language: token.lang || null },
+      token.text ? [helpers.createTextNode(token.text)] : [],
+    )
+  },
+
+  renderMarkdown: (node, h) => {
+    let output = ''
+    const language = node.attrs?.language || ''
+
+    if (!node.content) {
+      output = `\`\`\`${language}\n\n\`\`\``
+    } else {
+      const lines = [`\`\`\`${language}`, h.renderChildren(node.content), '```']
+      output = lines.join('\n')
+    }
+
+    return output
+  },
+
+  addCommands() {
+    return {
+      setCodeBlock:
+        attributes =>
+        ({ commands }) => {
+          return commands.setNode(this.name, attributes)
+        },
+      toggleCodeBlock:
+        attributes =>
+        ({ commands }) => {
+          return commands.toggleNode(this.name, 'paragraph', attributes)
+        },
+    }
+  },
+
+  addKeyboardShortcuts() {
+    return {
+      'Mod-Alt-c': () => this.editor.commands.toggleCodeBlock(),
+
+      // remove code block when at start of document or code block is empty
+      Backspace: () => {
+        const { empty, $anchor } = this.editor.state.selection
+        const isAtStart = $anchor.pos === 1
+
+        if (!empty || $anchor.parent.type.name !== this.name) {
+          return false
+        }
+
+        if (isAtStart || !$anchor.parent.textContent.length) {
+          return this.editor.commands.clearNodes()
+        }
+
+        return false
+      },
+
+      // handle tab indentation
+      Tab: ({ editor }) => {
+        if (!this.options.enableTabIndentation) {
+          return false
+        }
+
+        const tabSize = this.options.tabSize ?? DEFAULT_TAB_SIZE
+        const { state } = editor
+        const { selection } = state
+        const { $from, empty } = selection
+
+        if ($from.parent.type !== this.type) {
+          return false
+        }
+
+        const indent = ' '.repeat(tabSize)
+
+        if (empty) {
+          return editor.commands.insertContent(indent)
+        }
+
+        return editor.commands.command(({ tr }) => {
+          const { from, to } = selection
+          const text = state.doc.textBetween(from, to, '\n', '\n')
+          const lines = text.split('\n')
+          const indentedText = lines.map(line => indent + line).join('\n')
+
+          tr.replaceWith(from, to, state.schema.text(indentedText))
+          return true
+        })
+      },
+
+      // handle shift+tab reverse indentation
+      'Shift-Tab': ({ editor }) => {
+        if (!this.options.enableTabIndentation) {
+          return false
+        }
+
+        const tabSize = this.options.tabSize ?? DEFAULT_TAB_SIZE
+        const { state } = editor
+        const { selection } = state
+        const { $from, empty } = selection
+
+        if ($from.parent.type !== this.type) {
+          return false
+        }
+
+        if (empty) {
+          return editor.commands.command(({ tr }) => {
+            const { pos } = $from
+            const codeBlockStart = $from.start()
+            const codeBlockEnd = $from.end()
+
+            const allText = state.doc.textBetween(codeBlockStart, codeBlockEnd, '\n', '\n')
+            const lines = allText.split('\n')
+
+            let currentLineIndex = 0
+            let charCount = 0
+            const relativeCursorPos = pos - codeBlockStart
+
+            for (let i = 0; i < lines.length; i += 1) {
+              if (charCount + lines[i].length >= relativeCursorPos) {
+                currentLineIndex = i
+                break
+              }
+              charCount += lines[i].length + 1
+            }
+
+            const currentLine = lines[currentLineIndex]
+            const leadingSpaces = currentLine.match(/^ */)?.[0] || ''
+            const spacesToRemove = Math.min(leadingSpaces.length, tabSize)
+
+            if (spacesToRemove === 0) {
+              return true
+            }
+
+            let lineStartPos = codeBlockStart
+            for (let i = 0; i < currentLineIndex; i += 1) {
+              lineStartPos += lines[i].length + 1
+            }
+
+            tr.delete(lineStartPos, lineStartPos + spacesToRemove)
+
+            const cursorPosInLine = pos - lineStartPos
+            if (cursorPosInLine <= spacesToRemove) {
+              tr.setSelection(TextSelection.create(tr.doc, lineStartPos))
+            }
+
+            return true
+          })
+        }
+
+        return editor.commands.command(({ tr }) => {
+          const { from, to } = selection
+          const text = state.doc.textBetween(from, to, '\n', '\n')
+          const lines = text.split('\n')
+          const reverseIndentText = lines
+            .map(line => {
+              const leadingSpaces = line.match(/^ */)?.[0] || ''
+              const spacesToRemove = Math.min(leadingSpaces.length, tabSize)
+              return line.slice(spacesToRemove)
+            })
+            .join('\n')
+
+          tr.replaceWith(from, to, state.schema.text(reverseIndentText))
+          return true
+        })
+      },
+
+      // exit node on triple enter
+      Enter: ({ editor }) => {
+        if (!this.options.exitOnTripleEnter) {
+          return false
+        }
+
+        const { state } = editor
+        const { selection } = state
+        const { $from, empty } = selection
+
+        if (!empty || $from.parent.type !== this.type) {
+          return false
+        }
+
+        const isAtEnd = $from.parentOffset === $from.parent.nodeSize - 2
+        const endsWithDoubleNewline = $from.parent.textContent.endsWith('\n\n')
+
+        if (!isAtEnd || !endsWithDoubleNewline) {
+          return false
+        }
+
+        return editor
+          .chain()
+          .command(({ tr }) => {
+            tr.delete($from.pos - 2, $from.pos)
+
+            return true
+          })
+          .exitCode()
+          .run()
+      },
+
+      // exit node on arrow up if there is no node before it
+      ArrowUp: ({ editor }) => {
+        if (!this.options.exitOnArrowUp) {
+          return false
+        }
+
+        const { state } = editor
+        const { selection } = state
+        const { $from, empty } = selection
+
+        if (!empty || $from.parent.type !== this.type) {
+          return false
+        }
+
+        if ($from.parentOffset !== 0) {
+          return false
+        }
+
+        const before = $from.before()
+
+        if (before > 0) {
+          return false
+        }
+
+        return editor.commands.insertDefaultBlock({ pos: before })
+      },
+
+      // exit node on arrow down
+      ArrowDown: ({ editor }) => {
+        if (!this.options.exitOnArrowDown) {
+          return false
+        }
+
+        const { state } = editor
+        const { selection, doc } = state
+        const { $from, empty } = selection
+
+        if (!empty || $from.parent.type !== this.type) {
+          return false
+        }
+
+        const isAtEnd = $from.parentOffset === $from.parent.nodeSize - 2
+
+        if (!isAtEnd) {
+          return false
+        }
+
+        const after = $from.after()
+
+        if (after === undefined) {
+          return false
+        }
+
+        const nodeAfter = doc.nodeAt(after)
+
+        if (nodeAfter) {
+          return editor.commands.command(({ tr }) => {
+            tr.setSelection(Selection.near(doc.resolve(after)))
+            return true
+          })
+        }
+
+        return editor.commands.exitCode()
+      },
+    }
+  },
+
+  addInputRules() {
+    return [
+      textblockTypeInputRule({
+        find: backtickInputRegex,
+        type: this.type,
+        getAttributes: match => ({
+          language: match[1],
+        }),
+      }),
+      textblockTypeInputRule({
+        find: tildeInputRegex,
+        type: this.type,
+        getAttributes: match => ({
+          language: match[1],
+        }),
+      }),
+    ]
+  },
+
+  addProseMirrorPlugins() {
+    return [
+      // this plugin creates a code block for pasted content from VS Code
+      // we can also detect the copied code language
+      new Plugin({
+        key: new PluginKey('codeBlockVSCodeHandler'),
+        props: {
+          handlePaste: (view, event) => {
+            if (!event.clipboardData) {
+              return false
+            }
+
+            // don’t create a new code block within code blocks
+            if (this.editor.isActive(this.type.name)) {
+              return false
+            }
+
+            const text = event.clipboardData.getData('text/plain')
+            const vscode = event.clipboardData.getData('vscode-editor-data')
+            const vscodeData = vscode ? JSON.parse(vscode) : undefined
+            const language = vscodeData?.mode
+
+            if (!text || !language) {
+              return false
+            }
+
+            const { tr, schema } = view.state
+
+            // prepare a text node
+            // strip carriage return chars from text pasted as code
+            // see: https://github.com/ProseMirror/prosemirror-view/commit/a50a6bcceb4ce52ac8fcc6162488d8875613aacd
+            const textNode = schema.text(text.replace(/\r\n?/g, '\n'))
+
+            // create a code block with the text node
+            // replace selection with the code block
+            tr.replaceSelectionWith(this.type.create({ language }, textNode))
+
+            if (tr.selection.$from.parent.type !== this.type) {
+              // put cursor inside the newly created code block
+              tr.setSelection(
+                TextSelection.near(tr.doc.resolve(Math.max(0, tr.selection.from - 2))),
+              )
+            }
+
+            // store meta information
+            // this is useful for other plugins that depends on the paste event
+            // like the paste rule plugin
+            tr.setMeta('paste', true)
+
+            view.dispatch(tr)
+
+            return true
+          },
+        },
+      }),
+    ]
+  },
+})

packages/extension-code-block/src/index.ts

@@ -0,0 +1,5 @@
+import { CodeBlock } from './code-block.js'
+
+export * from './code-block.js'
+
+export default CodeBlock

packages/extension-code-block/vite.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vite-plus'
+import { basePackConfig } from '../../pack.config.mjs'
+
+export default defineConfig({
+  pack: {
+    entry: ['src/index.ts'],
+    ...basePackConfig(),
+  },
+})