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

packages/extension-text-align/README.md

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

@@ -0,0 +1,50 @@
+{
+  "name": "@tiptap/extension-text-align",
+  "version": "3.30.3",
+  "description": "text align 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-text-align"
+  },
+  "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-text-align/src/index.ts

@@ -0,0 +1,5 @@
+import { TextAlign } from './text-align.js'
+
+export * from './text-align.js'
+
+export default TextAlign

packages/extension-text-align/src/text-align.ts

@@ -0,0 +1,137 @@
+import { Extension } from '@tiptap/core'
+
+export interface TextAlignOptions {
+  /**
+   * The types where the text align attribute can be applied.
+   * @default []
+   * @example ['heading', 'paragraph']
+   */
+  types: string[]
+
+  /**
+   * The alignments which are allowed.
+   * @default ['left', 'center', 'right', 'justify']
+   * @example ['left', 'right']
+   */
+  alignments: string[]
+
+  /**
+   * The default alignment.
+   * @default null
+   * @example 'center'
+   */
+  defaultAlignment: string | null
+}
+
+declare module '@tiptap/core' {
+  interface Commands<ReturnType> {
+    textAlign: {
+      /**
+       * Set the text align attribute
+       * @param alignment The alignment
+       * @example editor.commands.setTextAlign('left')
+       */
+      setTextAlign: (alignment: string) => ReturnType
+      /**
+       * Unset the text align attribute
+       * @example editor.commands.unsetTextAlign()
+       */
+      unsetTextAlign: () => ReturnType
+      /**
+       * Toggle the text align attribute
+       * @param alignment The alignment
+       * @example editor.commands.toggleTextAlign('right')
+       */
+      toggleTextAlign: (alignment: string) => ReturnType
+    }
+  }
+}
+
+/**
+ * This extension allows you to align text.
+ * @see https://www.tiptap.dev/api/extensions/text-align
+ */
+export const TextAlign = Extension.create<TextAlignOptions>({
+  name: 'textAlign',
+
+  addOptions() {
+    return {
+      types: [],
+      alignments: ['left', 'center', 'right', 'justify'],
+      defaultAlignment: null,
+    }
+  },
+
+  addGlobalAttributes() {
+    return [
+      {
+        types: this.options.types,
+        attributes: {
+          textAlign: {
+            default: this.options.defaultAlignment,
+            parseHTML: element => {
+              const alignment = element.style.textAlign
+
+              return this.options.alignments.includes(alignment)
+                ? alignment
+                : this.options.defaultAlignment
+            },
+            renderHTML: attributes => {
+              if (!attributes.textAlign) {
+                return {}
+              }
+
+              return { style: `text-align: ${attributes.textAlign}` }
+            },
+          },
+        },
+      },
+    ]
+  },
+
+  addCommands() {
+    return {
+      setTextAlign:
+        (alignment: string) =>
+        ({ commands }) => {
+          if (!this.options.alignments.includes(alignment)) {
+            return false
+          }
+
+          return this.options.types
+            .map(type => commands.updateAttributes(type, { textAlign: alignment }))
+            .some(response => response)
+        },
+
+      unsetTextAlign:
+        () =>
+        ({ commands }) => {
+          return this.options.types
+            .map(type => commands.resetAttributes(type, 'textAlign'))
+            .some(response => response)
+        },
+
+      toggleTextAlign:
+        alignment =>
+        ({ editor, commands }) => {
+          if (!this.options.alignments.includes(alignment)) {
+            return false
+          }
+
+          if (editor.isActive({ textAlign: alignment })) {
+            return commands.unsetTextAlign()
+          }
+          return commands.setTextAlign(alignment)
+        },
+    }
+  },
+
+  addKeyboardShortcuts() {
+    return {
+      'Mod-Shift-l': () => this.editor.commands.setTextAlign('left'),
+      'Mod-Shift-e': () => this.editor.commands.setTextAlign('center'),
+      'Mod-Shift-r': () => this.editor.commands.setTextAlign('right'),
+      'Mod-Shift-j': () => this.editor.commands.setTextAlign('justify'),
+    }
+  },
+})

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