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

packages/extension-heading/README.md

@@ -0,0 +1,18 @@
+# @tiptap/extension-heading
+
+[![Version](https://img.shields.io/npm/v/@tiptap/extension-heading.svg?label=version)](https://www.npmjs.com/package/@tiptap/extension-heading)
+[![Downloads](https://img.shields.io/npm/dm/@tiptap/extension-heading.svg)](https://npmcharts.com/compare/tiptap?minimal=true)
+[![License](https://img.shields.io/npm/l/@tiptap/extension-heading.svg)](https://www.npmjs.com/package/@tiptap/extension-heading)
+[![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-heading/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@tiptap/extension-heading",
+  "version": "3.30.3",
+  "description": "heading 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-heading"
+  },
+  "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:^"
+  },
+  "peerDependencies": {
+    "@tiptap/core": "workspace:*"
+  }
+}

packages/extension-heading/src/heading.ts

@@ -0,0 +1,152 @@
+import { mergeAttributes, Node, textblockTypeInputRule } from '@tiptap/core'
+
+/**
+ * The heading level options.
+ */
+export type Level = 1 | 2 | 3 | 4 | 5 | 6
+
+export interface HeadingOptions {
+  /**
+   * The available heading levels.
+   * @default [1, 2, 3, 4, 5, 6]
+   * @example [1, 2, 3]
+   */
+  levels: Level[]
+
+  /**
+   * The HTML attributes for a heading node.
+   * @default {}
+   * @example { class: 'foo' }
+   */
+  HTMLAttributes: Record<string, any>
+}
+
+declare module '@tiptap/core' {
+  interface Commands<ReturnType> {
+    heading: {
+      /**
+       * Set a heading node
+       * @param attributes The heading attributes
+       * @example editor.commands.setHeading({ level: 1 })
+       */
+      setHeading: (attributes: { level: Level }) => ReturnType
+      /**
+       * Toggle a heading node
+       * @param attributes The heading attributes
+       * @example editor.commands.toggleHeading({ level: 1 })
+       */
+      toggleHeading: (attributes: { level: Level }) => ReturnType
+    }
+  }
+}
+
+/**
+ * This extension allows you to create headings.
+ * @see https://www.tiptap.dev/api/nodes/heading
+ */
+export const Heading = Node.create<HeadingOptions>({
+  name: 'heading',
+
+  addOptions() {
+    return {
+      levels: [1, 2, 3, 4, 5, 6],
+      HTMLAttributes: {},
+    }
+  },
+
+  content: 'inline*',
+
+  group: 'block',
+
+  defining: true,
+
+  addAttributes() {
+    return {
+      level: {
+        default: 1,
+        rendered: false,
+      },
+    }
+  },
+
+  parseHTML() {
+    return this.options.levels.map((level: Level) => ({
+      tag: `h${level}`,
+      attrs: { level },
+    }))
+  },
+
+  renderHTML({ node, HTMLAttributes }) {
+    const hasLevel = this.options.levels.includes(node.attrs.level)
+    const level = hasLevel ? node.attrs.level : this.options.levels[0]
+
+    return [`h${level}`, mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), 0]
+  },
+
+  parseMarkdown: (token, helpers) => {
+    // Convert 'heading' token to heading node
+    // marked provides 'depth' property (1-6) for heading level
+    return helpers.createNode(
+      'heading',
+      { level: token.depth || 1 },
+      helpers.parseInline(token.tokens || []),
+    )
+  },
+
+  renderMarkdown: (node, h) => {
+    const level = node.attrs?.level ? parseInt(node.attrs.level as string, 10) : 1
+    const headingChars = '#'.repeat(level)
+
+    if (!node.content) {
+      return ''
+    }
+
+    // Use current context for proper joining/spacing
+    return `${headingChars} ${h.renderChildren(node.content)}`
+  },
+
+  addCommands() {
+    return {
+      setHeading:
+        attributes =>
+        ({ commands }) => {
+          if (!this.options.levels.includes(attributes.level)) {
+            return false
+          }
+
+          return commands.setNode(this.name, attributes)
+        },
+      toggleHeading:
+        attributes =>
+        ({ commands }) => {
+          if (!this.options.levels.includes(attributes.level)) {
+            return false
+          }
+
+          return commands.toggleNode(this.name, 'paragraph', attributes)
+        },
+    }
+  },
+
+  addKeyboardShortcuts() {
+    return this.options.levels.reduce(
+      (items, level) => ({
+        ...items,
+        [`Mod-Alt-${level}`]: () => this.editor.commands.toggleHeading({ level }),
+      }),
+      {},
+    )
+  },
+
+  addInputRules() {
+    return this.options.levels.map(level => {
+      return textblockTypeInputRule({
+        find: new RegExp(`^(#{${Math.min(...this.options.levels)},${level}})\\s$`),
+        type: this.type,
+        getAttributes: {
+          level,
+        },
+      })
+    })
+  },
+})

packages/extension-heading/src/index.ts

@@ -0,0 +1,5 @@
+import { Heading } from './heading.js'
+
+export * from './heading.js'
+
+export default Heading

packages/extension-heading/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(),
+  },
+})