@tiptap/extensions 3.11.0

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify pkg:npm/%40tiptap/extensions@3.11.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/%40tiptap/extensions@3.11.0

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:26a7d91b956de2c5150ce0078d3b6d57e66f76b1d8bdad09ed16cd45eae862c8","contract":["CharacterCount, Dropcursor, Focus, Gapcursor, Placeholder, Selection, TrailingNode, and UndoRedo export extension objects with valid names and configure methods","Subpath imports from @tiptap/extensions/* export extensions identical to main entrypoint","CharacterCount calculates characters and words using default textCounter and wordCounter functions","Extension configure method creates new configured instances with custom options without mutating defaults","createExtensionBundle returns a complete collection of configured extension instances"],"goal":"verify pkg:npm/%40tiptap/extensions@3.11.0","kind":"HOW","packages":["pkg:npm/%40tiptap/extensions@3.11.0"],"schemaVersion":1},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/%40tiptap/extensions@3.11.0"],"schemaVersion":1,"subject":"pkg:npm/%40tiptap/extensions@3.11.0","verifierAdapter":"node-typescript@1"}

{
  "name": "sample-tiptap-extensions",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-tiptap-extensions",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "@tiptap/extensions": "3.11.0"
      }
    },
    "node_modules/@tiptap/core": {
      "version": "3.31.3",
      "resolved": "https://registry.npmjs.org/@tiptap/core/-/core-3.31.3.tgz",
      "integrity": "sha512-Cz50pvciQrxdSxgTkHOVz0uD0Yl/8Xt0QatGD6ILm47jW8EzyHR9RkUGs/D5IqzXKuVPntfw1ttaT926vXfiRg==",
      "license": "MIT",
      "peer": true,
      "funding": {
        "type": "github",
        "url": "https://github.com/sponsors/ueberdosis"
      },
      "peerDependencies": {
        "@tiptap/pm": "3.31.3"
      }
    },
    "node_modules/@tiptap/extensions": {
      "version": "3.11.0",
      "resolved": "https://registry.npmjs.org/@tiptap/extensions/-/extensions-3.11.0.tgz",
      "integrity": "sha512-g43beA73ZMLezez1st9LEwYrRHZ0FLzlsSlOZKk7sdmtHLmuqWHf4oyb0XAHol1HZIdGv104rYaGNgmQXr1ecQ==",
      "license": "MIT",
      "funding": {
        "type": "github",
        "url": "https://github.com/sponsors/ueberdosis"
      },
      "peerDependencies": {
        "@tiptap/core": "^3.11.0",
        "@tiptap/pm": "^3.11.0"
      }
    },
    "node_modules/@tiptap/pm": {
      "version": "3.31.3",
      "resolved": "https://registry.npmjs.org/@tiptap/pm/-/pm-3.31.3.tgz",
      "integrity": "sha512-sZime0SWsz/k62W2WvHx5Ig7G2h7kVhrrmnqy+wEgIHfDwEfOlelRjaWCiBCFlF7dxGUntJusCh9FxlLhni0Ag==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-changeset": "^2.4.1",
        "prosemirror-commands": "^1.7.1",
        "prosemirror-dropcursor": "^1.8.2",
        "prosemirror-gapcursor": "^1.4.1",
        "prosemirror-history": "^1.5.0",
        "prosemirror-inputrules": "^1.5.1",
        "prosemirror-keymap": "^1.2.3",
        "prosemirror-model": "^1.25.11",
        "prosemirror-schema-list": "^1.5.1",
        "prosemirror-state": "^1.4.4",
        "prosemirror-tables": "^1.8.5",
        "prosemirror-transform": "^1.12.0",
        "prosemirror-view": "^1.42.3"
      },
      "funding": {
        "type": "github",
        "url": "https://github.com/sponsors/ueberdosis"
      }
    },
    "node_modules/orderedmap": {
      "version": "2.1.1",
      "resolved": "https://registry.npmjs.org/orderedmap/-/orderedmap-2.1.1.tgz",
      "integrity": "sha512-TvAWxi0nDe1j/rtMcWcIj94+Ffe6n7zhow33h40SKxmsmozs6dz/e+EajymfoFcHd7sxNn8yHM8839uixMOV6g==",
      "license": "MIT",
      "peer": true
    },
    "node_modules/prosemirror-changeset": {
      "version": "2.4.2",
      "resolved": "https://registry.npmjs.org/prosemirror-changeset/-/prosemirror-changeset-2.4.2.tgz",
      "integrity": "sha512-ViYrjMSg3YFiXwIhKaluu+/mi3Yrxt6AR8ri14ulTaGcZtXO1CThl7A2gv79qx5fQnOw8woKwyBU2u+9PVCm3w==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-transform": "^1.0.0"
      }
    },
    "node_modules/prosemirror-commands": {
      "version": "1.7.2",
      "resolved": "https://registry.npmjs.org/prosemirror-commands/-/prosemirror-commands-1.7.2.tgz",
      "integrity": "sha512-q6Q6szxqdu9Xd6EcdKsqXghu5nQdZTpB4Q9yd04WRc7/jt763e/rT60Owh0L1GYY+T46o5rD+9lEN36dZS43tw==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-model": "^1.0.0",
        "prosemirror-state": "^1.0.0",
        "prosemirror-transform": "^1.10.2"
      }
    },
    "node_modules/prosemirror-dropcursor": {
      "version": "1.8.3",
      "resolved": "https://registry.npmjs.org/prosemirror-dropcursor/-/prosemirror-dropcursor-1.8.3.tgz",
      "integrity": "sha512-FoYbsJR8gK+DGlqhNoE29Loa38eIZPzQRIb1VMaDNBoo4OLP6vVof/jR8qFY/6XvUd6Dhug8MDCHl2a/h8RTfQ==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-state": "^1.0.0",
        "prosemirror-transform": "^1.1.0",
        "prosemirror-view": "^1.1.0"
      }
    },
    "node_modules/prosemirror-gapcursor": {
      "version": "1.4.1",
      "resolved": "https://registry.npmjs.org/prosemirror-gapcursor/-/prosemirror-gapcursor-1.4.1.tgz",
      "integrity": "sha512-pMdYaEnjNMSwl11yjEGtgTmLkR08m/Vl+Jj443167p9eB3HVQKhYCc4gmHVDsLPODfZfjr/MmirsdyZziXbQKw==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-keymap": "^1.0.0",
        "prosemirror-model": "^1.0.0",
        "prosemirror-state": "^1.0.0",
        "prosemirror-view": "^1.0.0"
      }
    },
    "node_modules/prosemirror-history": {
      "version": "1.5.0",
      "resolved": "https://registry.npmjs.org/prosemirror-history/-/prosemirror-history-1.5.0.tgz",
      "integrity": "sha512-zlzTiH01eKA55UAf1MEjtssJeHnGxO0j4K4Dpx+gnmX9n+SHNlDqI2oO1Kv1iPN5B1dm5fsljCfqKF9nFL6HRg==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-state": "^1.2.2",
        "prosemirror-transform": "^1.0.0",
        "prosemirror-view": "^1.31.0",
        "rope-sequence": "^1.3.0"
      }
    },
    "node_modules/prosemirror-inputrules": {
      "version": "1.5.1",
      "resolved": "https://registry.npmjs.org/prosemirror-inputrules/-/prosemirror-inputrules-1.5.1.tgz",
      "integrity": "sha512-7wj4uMjKaXWAQ1CDgxNzNtR9AlsuwzHfdFH1ygEHA2KHF2DOEaXl1CJfNPAKCg9qNEh4rum975QLaCiQPyY6Fw==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-state": "^1.0.0",
        "prosemirror-transform": "^1.0.0"
      }
    },
    "node_modules/prosemirror-keymap": {
      "version": "1.2.3",
      "resolved": "https://registry.npmjs.org/prosemirror-keymap/-/prosemirror-keymap-1.2.3.tgz",
      "integrity": "sha512-4HucRlpiLd1IPQQXNqeo81BGtkY8Ai5smHhKW9jjPKRc2wQIxksg7Hl1tTI2IfT2B/LgX6bfYvXxEpJl7aKYKw==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-state": "^1.0.0",
        "w3c-keyname": "^2.2.0"
      }
    },
    "node_modules/prosemirror-model": {
      "version": "1.25.11",
      "resolved": "https://registry.npmjs.org/prosemirror-model/-/prosemirror-model-1.25.11.tgz",
      "integrity": "sha512-QWg9RhnpLlogAmp3p96uEFrE5txQpFynd4vhBAELkwgOCWQs/X0yCzB3/hrHqiPwf91RG5KyWq6553zs9JqIOQ==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "orderedmap": "^2.0.0"
      }
    },
    "node_modules/prosemirror-schema-list": {
      "version": "1.5.1",
      "resolved": "https://registry.npmjs.org/prosemirror-schema-list/-/prosemirror-schema-list-1.5.1.tgz",
      "integrity": "sha512-927lFx/uwyQaGwJxLWCZRkjXG0p48KpMj6ueoYiu4JX05GGuGcgzAy62dfiV8eFZftgyBUvLx76RsMe20fJl+Q==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-model": "^1.0.0",
        "prosemirror-state": "^1.0.0",
        "prosemirror-transform": "^1.7.3"
      }
    },
    "node_modules/prosemirror-state": {
      "version": "1.4.4",
      "resolved": "https://registry.npmjs.org/prosemirror-state/-/prosemirror-state-1.4.4.tgz",
      "integrity": "sha512-6jiYHH2CIGbCfnxdHbXZ12gySFY/fz/ulZE333G6bPqIZ4F+TXo9ifiR86nAHpWnfoNjOb3o5ESi7J8Uz1jXHw==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-model": "^1.0.0",
        "prosemirror-transform": "^1.0.0",
        "prosemirror-view": "^1.27.0"
      }
    },
    "node_modules/prosemirror-tables": {
      "version": "1.8.5",
      "resolved": "https://registry.npmjs.org/prosemirror-tables/-/prosemirror-tables-1.8.5.tgz",
      "integrity": "sha512-V/0cDCsHKHe/tfWkeCmthNUcEp1IVO3p6vwN8XtwE9PZQLAZJigbw3QoraAdfJPir4NKJtNvOB8oYGKRl+t0Dw==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-keymap": "^1.2.3",
        "prosemirror-model": "^1.25.4",
        "prosemirror-state": "^1.4.4",
        "prosemirror-transform": "^1.10.5",
        "prosemirror-view": "^1.41.4"
      }
    },
    "node_modules/prosemirror-transform": {
      "version": "1.12.1",
      "resolved": "https://registry.npmjs.org/prosemirror-transform/-/prosemirror-transform-1.12.1.tgz",
      "integrity": "sha512-t4F5615FycnCqsX7ShTUs8+jfnwcf46kuFRvSl/3qFx2QTZ4DjgowesLHQXcFP7G//TjesqZG3WtgL7vdyVJyA==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-model": "^1.21.0"
      }
    },
    "node_modules/prosemirror-view": {
      "version": "1.42.3",
      "resolved": "https://registry.npmjs.org/prosemirror-view/-/prosemirror-view-1.42.3.tgz",
      "integrity": "sha512-oTN7EtH+CpwxU9NrwEYWd0UZ4JUx7l048l5A2Xppm4p/60isZYLnth9QVQmC3VRIvdrIWCxwZSd+Uz791G31/w==",
      "license": "MIT",
      "peer": true,
      "dependencies": {
        "prosemirror-model": "^1.25.8",
        "prosemirror-state": "^1.0.0",
        "prosemirror-transform": "^1.1.0"
      }
    },
    "node_modules/rope-sequence": {
      "version": "1.3.4",
      "resolved": "https://registry.npmjs.org/rope-sequence/-/rope-sequence-1.3.4.tgz",
      "integrity": "sha512-UT5EDe2cu2E/6O4igUr5PSFs23nvvukicWHx6GnOPlHAiiYbzNuCRQCuiUdHJQcqKalLKlrYJnjY0ySGsXNQXQ==",
      "license": "MIT",
      "peer": true
    },
    "node_modules/w3c-keyname": {
      "version": "2.2.8",
      "resolved": "https://registry.npmjs.org/w3c-keyname/-/w3c-keyname-2.2.8.tgz",
      "integrity": "sha512-dpojBhNsCNN7T82Tm7k26A6G9ML3NkhDsnw9n/eoxSRlVBB4CEtIQ/KTCLI2Fwf3ataSXRhYFkQi3SlnFwPvPQ==",
      "license": "MIT",
      "peer": true
    }
  }
}

{
  "name": "sample-tiptap-extensions",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "license": "MIT-0",
  "dependencies": {
    "@tiptap/extensions": "3.11.0"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/%40tiptap/extensions@3.11.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/%40tiptap/extensions@3.11.0"
  ]
}

import {
  CharacterCount,
  Dropcursor,
  Focus,
  Gapcursor,
  Placeholder,
  Selection,
  TrailingNode,
  UndoRedo,
} from '@tiptap/extensions';

export {
  CharacterCount,
  Dropcursor,
  Focus,
  Gapcursor,
  Placeholder,
  Selection,
  TrailingNode,
  UndoRedo,
};

export function createExtensionBundle(options = {}) {
  return [
    CharacterCount.configure(options.characterCount || {}),
    Dropcursor.configure(options.dropcursor || {}),
    Focus.configure(options.focus || {}),
    Gapcursor.configure(options.gapcursor || {}),
    Placeholder.configure(options.placeholder || {}),
    Selection.configure(options.selection || {}),
    TrailingNode.configure(options.trailingNode || {}),
    UndoRedo.configure(options.undoRedo || {}),
  ];
}

import assert from 'node:assert/strict';
import {
  CharacterCount,
  Dropcursor,
  Focus,
  Gapcursor,
  Placeholder,
  Selection,
  TrailingNode,
  UndoRedo,
  createExtensionBundle,
} from '../src/index.mjs';

import { CharacterCount as SubpathCharacterCount } from '@tiptap/extensions/character-count';
import { Dropcursor as SubpathDropcursor } from '@tiptap/extensions/drop-cursor';
import { Focus as SubpathFocus } from '@tiptap/extensions/focus';
import { Gapcursor as SubpathGapcursor } from '@tiptap/extensions/gap-cursor';
import { Placeholder as SubpathPlaceholder } from '@tiptap/extensions/placeholder';
import { Selection as SubpathSelection } from '@tiptap/extensions/selection';
import { TrailingNode as SubpathTrailingNode } from '@tiptap/extensions/trailing-node';
import { UndoRedo as SubpathUndoRedo } from '@tiptap/extensions/undo-redo';

// 1. Extensions export valid Extension objects with expected names and types
const extensions = [
  { ext: CharacterCount, expectedName: 'characterCount' },
  { ext: Dropcursor, expectedName: 'dropCursor' },
  { ext: Focus, expectedName: 'focus' },
  { ext: Gapcursor, expectedName: 'gapCursor' },
  { ext: Placeholder, expectedName: 'placeholder' },
  { ext: Selection, expectedName: 'selection' },
  { ext: TrailingNode, expectedName: 'trailingNode' },
  { ext: UndoRedo, expectedName: 'undoRedo' },
];

for (const { ext, expectedName } of extensions) {
  assert.equal(ext.type, 'extension', `${expectedName} must have type 'extension'`);
  assert.equal(ext.name, expectedName, `Extension name must be ${expectedName}`);
  assert.equal(typeof ext.configure, 'function', `${expectedName} must have configure function`);
}

// 2. Subpath entrypoints export identical extensions matching main entrypoint
assert.equal(SubpathCharacterCount.name, CharacterCount.name);
assert.equal(SubpathDropcursor.name, Dropcursor.name);
assert.equal(SubpathFocus.name, Focus.name);
assert.equal(SubpathGapcursor.name, Gapcursor.name);
assert.equal(SubpathPlaceholder.name, Placeholder.name);
assert.equal(SubpathSelection.name, Selection.name);
assert.equal(SubpathTrailingNode.name, TrailingNode.name);
assert.equal(SubpathUndoRedo.name, UndoRedo.name);

// 3. CharacterCount calculates characters and words with default counters
assert.equal(CharacterCount.options.textCounter('Hello world!'), 12);
assert.equal(CharacterCount.options.textCounter(''), 0);
assert.equal(CharacterCount.options.wordCounter('The quick brown fox'), 4);
assert.equal(CharacterCount.options.wordCounter(''), 0);
assert.equal(CharacterCount.options.wordCounter('   spaced   words   '), 2);
assert.equal(CharacterCount.options.mode, 'textSize');
assert.equal(CharacterCount.options.limit, null);

// 4. Extensions configure options immutably without mutating defaults
const customCharCount = CharacterCount.configure({
  limit: 280,
  mode: 'nodeSize',
  textCounter: text => text.trim().length,
});
assert.equal(customCharCount.options.limit, 280);
assert.equal(customCharCount.options.mode, 'nodeSize');
assert.equal(customCharCount.options.textCounter('  abc  '), 3);
assert.equal(CharacterCount.options.limit, null, 'Original CharacterCount options must not be mutated');

const customPlaceholder = Placeholder.configure({
  placeholder: 'Type something here...',
  emptyEditorClass: 'editor-is-blank',
  showOnlyWhenEditable: false,
});
assert.equal(customPlaceholder.options.placeholder, 'Type something here...');
assert.equal(customPlaceholder.options.emptyEditorClass, 'editor-is-blank');
assert.equal(customPlaceholder.options.showOnlyWhenEditable, false);
assert.equal(Placeholder.options.placeholder, 'Write something …', 'Original Placeholder options must not be mutated');

const customUndo = UndoRedo.configure({ depth: 50, newGroupDelay: 1000 });
assert.equal(customUndo.options.depth, 50);
assert.equal(customUndo.options.newGroupDelay, 1000);
assert.equal(UndoRedo.options.depth, 100, 'Original UndoRedo options must not be mutated');

const customFocus = Focus.configure({ className: 'custom-focused', mode: 'shallowest' });
assert.equal(customFocus.options.className, 'custom-focused');
assert.equal(customFocus.options.mode, 'shallowest');
assert.equal(Focus.options.className, 'has-focus');

const customDrop = Dropcursor.configure({ color: '#ff0000', width: 4 });
assert.equal(customDrop.options.color, '#ff0000');
assert.equal(customDrop.options.width, 4);
assert.equal(Dropcursor.options.color, 'currentColor');

// 5. createExtensionBundle returns bundle of configured extensions
const bundle = createExtensionBundle({
  characterCount: { limit: 500 },
  placeholder: { placeholder: 'Start typing...' },
});
assert.equal(bundle.length, 8);
assert.equal(bundle[0].name, 'characterCount');
assert.equal(bundle[0].options.limit, 500);
assert.equal(bundle[4].name, 'placeholder');
assert.equal(bundle[4].options.placeholder, 'Start typing...');

console.log('Contract tests passed successfully.');