refactor(paragraph): extract paragraph block tool into standalone package

.github/workflows/paragraph.yml

@@ -0,0 +1,27 @@
+name: Paragraph check
+on:
+  pull_request:
+  merge_group:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Run ESLint check
+        uses: ./.github/actions/lint
+        with:
+          package-name: '@editorjs/paragraph'
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Build the package
+        uses: ./.github/actions/build
+        with:
+          package-name: '@editorjs/paragraph'

README.md

@@ -14,6 +14,8 @@ A model-driven, collaboration-ready Editor.js engine split into focused packages
 
 ## Packages
 
+### Base packages
+
 | Package | Description |
 |---|---|
 | [`@editorjs/model-types`](packages/model-types) | Shared low-level types and base event classes used internally by `model` and `sdk` only — not intended for direct use by other packages or tools |
@@ -26,6 +28,12 @@ A model-driven, collaboration-ready Editor.js engine split into focused packages
 | [`@editorjs/ot-server`](packages/ot-server) | Standalone WebSocket OT server (`OTServer`, `DocumentManager`) |
 | [`playground`](packages/playground) | Vite dev sandbox for manual testing |
 
+### Tools/Plugins
+
+| Package | Description |
+|---|---|
+| [`@editorjs/paragraph`](packages/tools/paragraph) | Built-in Paragraph block tool |
+
 ## Documentation
 
 In-depth architecture, flow, and API docs live in [`docs/`](docs/README.md).

package.json

@@ -4,7 +4,8 @@
   "private": true,
   "packageManager": "yarn@4.0.1",
   "workspaces": [
-    "packages/*"
+    "packages/*",
+    "packages/tools/*"
   ],
   "scripts": {
     "build": "yarn workspaces foreach -At run build",

packages/core/package.json

@@ -45,6 +45,7 @@
     "@editorjs/editorjs": "^2.30.5",
     "@editorjs/helpers": "^1.2.2",
     "@editorjs/model": "workspace:^",
+    "@editorjs/paragraph": "workspace:^",
     "@editorjs/sdk": "workspace:^",
     "inversify": "^8.1.0",
     "reflect-metadata": "^0.2.2"

packages/core/src/index.ts

@@ -19,7 +19,8 @@ import ToolsManager from './tools/ToolsManager.js';
 import type { CoreConfigValidated, CoreConfig, EditorjsPluginConstructor, BlockTuneConstructor, ToolConstructable, EditorjsAdapterPluginConstructor } from '@editorjs/sdk';
 import { EditorAPI } from './api/index.js';
 import { generateId } from './utils/uid.js';
-import { Paragraph, BoldInlineTool, LinkInlineTool, ItalicInlineTool } from './tools/internal';
+import { Paragraph } from '@editorjs/paragraph';
+import { BoldInlineTool, LinkInlineTool, ItalicInlineTool } from './tools/internal';
 import { ShortcutsPlugin } from './plugins/ShortcutsPlugin.js';
 import { DOMAdapters } from '@editorjs/dom-adapters';
 import { BlocksManager } from './components/BlockManager.js';

packages/core/src/tools/internal/index.ts

@@ -1,4 +1,3 @@
-export * from './block-tools/paragraph/index.js';
 export * from './inline-tools/bold/index.js';
 export * from './inline-tools/italic/index.js';
 export * from './inline-tools/link/index.js';

packages/core/tsconfig.build.json

@@ -15,6 +15,9 @@
     },
     {
       "path": "../collaboration-manager/tsconfig.build.json"
+    },
+    {
+      "path": "../tools/paragraph/tsconfig.build.json"
     }
   ]
 }

packages/core/tsconfig.json

@@ -34,6 +34,9 @@
     },
     {
       "path": "../collaboration-manager/tsconfig.build.json"
+    },
+    {
+      "path": "../tools/paragraph/tsconfig.build.json"
     }
   ]
 }

packages/tools/paragraph/.gitignore

@@ -0,0 +1,24 @@
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# Swap the comments on the following lines if you don't wish to use zero-installs
+# Documentation here: https://yarnpkg.com/features/zero-installs
+#!.yarn/cache
+#.pnp.*
+
+# IDE
+.idea/*
+
+node_modules/*
+dist/*
+
+# tests
+coverage/
+reports/
+
+# stryker temp files
+.stryker-tmp

packages/tools/paragraph/README.md

@@ -0,0 +1,3 @@
+# Paragraph
+
+Built-in Editor.js Block Tool for editing plain text paragraphs.

packages/tools/paragraph/eslint.config.mjs

@@ -0,0 +1,27 @@
+import CodeX from 'eslint-config-codex';
+
+export default [
+  ...CodeX,
+  {
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.eslint.json',
+        tsconfigRootDir: import.meta.dirname,
+        sourceType: 'module',
+      },
+    },
+    rules: {
+      'n/no-unpublished-import': ['error', {
+        allowModules: [
+          'eslint-config-codex',
+        ],
+        ignoreTypeImport: true,
+      }],
+      'n/no-missing-import': 'off',
+      'n/no-unsupported-features/node-builtins': ['error', {
+        version: '>=24.0.0',
+        ignores: [],
+      }],
+    },
+  },
+];

packages/tools/paragraph/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@editorjs/paragraph",
+  "version": "0.0.0",
+  "packageManager": "yarn@4.0.1",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "yarn clear && tsc --build tsconfig.build.json",
+    "build:declaration": "yarn build --emitDeclarationOnly",
+    "lint": "eslint",
+    "lint:ci": "yarn lint --max-warnings 0",
+    "lint:fix": "yarn lint --fix",
+    "clear": "rm -rf dist && rm -f tsconfig.build.tsbuildinfo && rm -f tsconfig.tsbuildinfo"
+  },
+  "devDependencies": {
+    "@types/eslint": "^9.6.1",
+    "@types/node": "^22.10.2",
+    "eslint": "^9.24.0",
+    "eslint-config-codex": "^2.0.3",
+    "eslint-plugin-import": "^2.31.0",
+    "typescript": "^5.5.4"
+  },
+  "dependencies": {
+    "@codexteam/icons": "^0.3.3",
+    "@editorjs/dom-adapters": "workspace:^",
+    "@editorjs/editorjs": "^2.30.5",
+    "@editorjs/sdk": "workspace:^"
+  }
+}

packages/tools/paragraph/tsconfig.build.json

@@ -0,0 +1,16 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": [
+    "node_modules/**/*",
+    "dist/**/*",
+    "**/*.spec.ts"
+  ],
+  "references": [
+    {
+      "path": "../../sdk/tsconfig.build.json"
+    },
+    {
+      "path": "../../dom-adapters/tsconfig.build.json"
+    }
+  ]
+}

packages/tools/paragraph/tsconfig.eslint.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "types": ["node"],
+  },
+  "extends": "./tsconfig.json",
+  "include": [
+    "src/**/*",
+    "eslint.config.mjs",
+  ],
+  "exclude": [
+    "dist/**/*",
+    "node_modules/**/*",
+  ]
+}

packages/tools/paragraph/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "target": "esnext",
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "rootDir": "src",
+    "outDir": "dist",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": [
+    "node_modules/**/*",
+    "dist/**/*"
+  ],
+  "references": [
+    {
+      "path": "../../sdk/tsconfig.build.json"
+    },
+    {
+      "path": "../../dom-adapters/tsconfig.build.json"
+    }
+  ]
+}

yarn.lock

@@ -2293,6 +2293,7 @@ __metadata:
     "@editorjs/editorjs": "npm:^2.30.5"
     "@editorjs/helpers": "npm:^1.2.2"
     "@editorjs/model": "workspace:^"
+    "@editorjs/paragraph": "workspace:^"
     "@editorjs/sdk": "workspace:^"
     "@jest/globals": "npm:^29.7.0"
     "@stryker-mutator/core": "npm:^7.0.2"
@@ -2479,6 +2480,23 @@ __metadata:
   languageName: unknown
   linkType: soft
 
+"@editorjs/paragraph@workspace:^, @editorjs/paragraph@workspace:packages/tools/paragraph":
+  version: 0.0.0-use.local
+  resolution: "@editorjs/paragraph@workspace:packages/tools/paragraph"
+  dependencies:
+    "@codexteam/icons": "npm:^0.3.3"
+    "@editorjs/dom-adapters": "workspace:^"
+    "@editorjs/editorjs": "npm:^2.30.5"
+    "@editorjs/sdk": "workspace:^"
+    "@types/eslint": "npm:^9.6.1"
+    "@types/node": "npm:^22.10.2"
+    eslint: "npm:^9.24.0"
+    eslint-config-codex: "npm:^2.0.3"
+    eslint-plugin-import: "npm:^2.31.0"
+    typescript: "npm:^5.5.4"
+  languageName: unknown
+  linkType: soft
+
 "@editorjs/sdk@workspace:^, @editorjs/sdk@workspace:packages/sdk":
   version: 0.0.0-use.local
   resolution: "@editorjs/sdk@workspace:packages/sdk"