Deprecation: #102099 - Deprecate CKEditor 5 bundle module
See forge#102099
Description
With the CKEditor 5 integration in TYPO3 v12 a custom CKEditor 5 build in form of a bundle has been introduced. Missing plugins had to be merged into that bundle again and again which lead to an increased bundle size. Also plugin authors had to reference the bundle module in order to fetch plugin exports from CKEditor.
With CKEditor 5 suggestion to use named exports from the CKEditor 5 package entry
point modules, it became feasible to create smaller bundles. One bundle per
scoped subpackage. For that reason
@typo3/
is now
deprecated.
Impact
TYPO3 can ship all available CKEditor 5 modules and only actually requested modules are loaded. Developers can write plugins as suggested by upstream documentation.
Affected Installations
Installations having custom extensions activated, that provide custom CKEditor 5
plugins. Extensions that use
@typo3/
will still work
as before (as the bundle module re-exports the exports of the split bundles)
but will trigger a deprecation log message to the browser console.
Migration
Extension authors should import from scoped
@ckeditor/
packages
directly.
// Before
import {Core, UI} from '@typo3/ckeditor5-bundle.js';
// After
import * as Core from '@ckeditor/ckeditor5-core';
import * as UI from '@ckeditor/ckeditor5-ui';