feat(core)!: use one builder for all plug-in extensions

Author: d3m1d0v

demo/Playground.tsx

@@ -5,13 +5,13 @@ import {RadioButton, TextInput} from '@gravity-ui/uikit';
 import {
     BasePreset,
     BehaviorPreset,
-    createExtension,
     MarkdownBlocksPreset,
     MarkdownMarksPreset,
     MarkupString,
     YfmEditorComponent,
     useYfmEditor,
     YfmPreset,
+    Extension,
 } from '../src';
 import {PlaygroundHtmlPreview} from './HtmlPreview';
 import {logger} from '../src/index';
@@ -43,33 +43,31 @@ export const Playground = React.memo<PlaygroundProps>((props) => {
     const [previewType, setPreviewType] = React.useState<string>(PreviewType.Markup);
     const [yfmRaw, setYfmRaw] = React.useState<MarkupString>(initial || '');
 
-    const extensions = React.useMemo(() => {
-        return [
-            createExtension((builder) =>
-                builder
-                    .use(BasePreset, {})
-                    .use(BehaviorPreset, {
-                        history: {
-                            undoKey: keys.undo,
-                            redoKey: keys.redo,
-                        },
-                    })
-                    .use(MarkdownBlocksPreset, {
-                        image: false,
-                        heading: false,
-                        breaks: {preferredBreak: breaks ? 'soft' : 'hard'},
-                    })
-                    .use(MarkdownMarksPreset, {
-                        bold: {boldKey: keys.bold},
-                        italic: {italicKey: keys.italic},
-                        strike: {strikeKey: keys.strike},
-                        underline: {underlineKey: keys.underline},
-                        code: {codeKey: keys.code},
-                    })
-                    .use(YfmPreset, {}),
-            )(),
-        ];
-    }, [breaks]);
+    const extensions = React.useMemo<Extension>(
+        () => (builder) =>
+            builder
+                .use(BasePreset, {})
+                .use(BehaviorPreset, {
+                    history: {
+                        undoKey: keys.undo,
+                        redoKey: keys.redo,
+                    },
+                })
+                .use(MarkdownBlocksPreset, {
+                    image: false,
+                    heading: false,
+                    breaks: {preferredBreak: breaks ? 'soft' : 'hard'},
+                })
+                .use(MarkdownMarksPreset, {
+                    bold: {boldKey: keys.bold},
+                    italic: {italicKey: keys.italic},
+                    strike: {strikeKey: keys.strike},
+                    underline: {underlineKey: keys.underline},
+                    code: {codeKey: keys.code},
+                })
+                .use(YfmPreset, {}),
+        [breaks],
+    );
 
     const editor = useYfmEditor({
         linkify,

src/core/Editor.ts

@@ -2,7 +2,7 @@ import {EditorView} from 'prosemirror-view';
 import {EditorState} from 'prosemirror-state';
 
 import type {CommonEditor, ContentHandler, MarkupString} from '../common';
-import type {ExtensionSpec} from './types/extension';
+import type {Extension} from './types/extension';
 import {bindActions} from './utils/actions';
 import type {Serializer} from './types/serializer';
 import {ExtensionsManager} from './ExtensionsManager';
@@ -17,7 +17,7 @@ export type YfmEditorOptions = {
     domElem?: Element;
     /** yfm markup */
     initialContent?: string;
-    extensions?: ExtensionSpec[];
+    extensions?: Extension;
     allowHTML?: boolean;
     linkify?: boolean;
     /** markdown-it-attrs options */
@@ -48,7 +48,7 @@ export class YfmEditor implements CommonEditor, ActionStorage {
     constructor({
         domElem,
         initialContent = '',
-        extensions = [],
+        extensions = () => {},
         attrs: attrsOpts,
         allowHTML,
         linkify,

src/core/ExtensionsManager.ts

@@ -1,17 +1,24 @@
 import MarkdownIt from 'markdown-it';
 import type {Plugin} from 'prosemirror-state';
 import {ActionsManager} from './ActionsManager';
+import {ExtensionBuilder} from './ExtensionBuilder';
 import {ParserTokensRegistry} from './ParserTokensRegistry';
 import {SchemaSpecRegistry} from './SchemaSpecRegistry';
 import {SerializerTokensRegistry} from './SerializerTokensRegistry';
 import type {ActionSpec} from './types/actions';
-import type {ExtensionDeps, ExtensionSpec, YEMarkSpec, YENodeSpec} from './types/extension';
+import type {
+    Extension,
+    ExtensionDeps,
+    ExtensionSpec,
+    YEMarkSpec,
+    YENodeSpec,
+} from './types/extension';
 import type {MarkViewConstructor, NodeViewConstructor} from './types/node-views';
 
 const attrs = require('markdown-it-attrs');
 
 type ExtensionsManagerParams = {
-    extensions: ExtensionSpec[];
+    extensions: Extension;
     options?: ExtensionsManagerOptions;
 };
 
@@ -25,7 +32,7 @@ type ExtensionsManagerOptions = {
 };
 
 export class ExtensionsManager {
-    static process(extensions: ExtensionSpec[], options: ExtensionsManagerOptions) {
+    static process(extensions: Extension, options: ExtensionsManagerOptions) {
         return new this({extensions, options}).build();
     }
 
@@ -38,8 +45,10 @@ export class ExtensionsManager {
 
     #md: MarkdownIt;
     #mdWithoutAttrs: MarkdownIt;
-    #extensions: ExtensionSpec[];
+    #extensions: Extension;
+    #builder: ExtensionBuilder;
 
+    #spec!: ExtensionSpec;
     #deps!: ExtensionDeps;
     #plugins: Plugin[] = [];
     #actions: Record<string, ActionSpec> = {};
@@ -51,6 +60,9 @@ export class ExtensionsManager {
 
         this.#md = new MarkdownIt(options.mdOpts ?? {}).use(attrs, options.attrsOpts ?? {});
         this.#mdWithoutAttrs = new MarkdownIt(options.mdOpts ?? {});
+
+        // TODO: add prefilled context
+        this.#builder = new ExtensionBuilder();
     }
 
     build() {
@@ -75,12 +87,11 @@ export class ExtensionsManager {
     }
 
     private processExtensions() {
-        for (const ext of this.#extensions) {
-            this.#md = ext.configureMd(this.#md);
-            this.#mdWithoutAttrs = ext.configureMd(this.#mdWithoutAttrs);
-            ext.nodes().forEach(this.processNode);
-            ext.marks().forEach(this.processMark);
-        }
+        this.#spec = this.#builder.use(this.#extensions).build();
+        this.#md = this.#spec.configureMd(this.#md);
+        this.#mdWithoutAttrs = this.#spec.configureMd(this.#mdWithoutAttrs);
+        this.#spec.nodes().forEach(this.processNode);
+        this.#spec.marks().forEach(this.processMark);
     }
 
     private processNode = (name: string, {spec, fromYfm, toYfm, view}: YENodeSpec) => {
@@ -114,10 +125,8 @@ export class ExtensionsManager {
 
     private createDerived() {
         const plugins: {plugin: Plugin; priority: number}[] = [];
-        for (const ext of this.#extensions) {
-            plugins.push(...ext.plugins(this.#deps));
-            Object.assign(this.#actions, ext.actions(this.#deps));
-        }
+        plugins.push(...this.#spec.plugins(this.#deps));
+        Object.assign(this.#actions, this.#spec.actions(this.#deps));
 
         // TODO: move sorting to ExtensionBuilder after WIKI-16660
         this.#plugins = plugins.sort((a, b) => b.priority - a.priority).map((item) => item.plugin);

src/core/createExtension.ts

@@ -1,7 +1,6 @@
 export * from './Editor';
 export * from './ExtensionBuilder';
 export * from './ExtensionsManager';
-export * from './createExtension';
 export {bindActions} from './utils/actions';
 export {trackTransactionMetrics} from './utils/metrics';
 export type {Keymap} from './types/keymap';
@@ -10,7 +9,6 @@ export type {
     Extension,
     ExtensionAuto,
     ExtensionWithOptions,
-    ExtensionSpec,
     ExtensionDeps,
     YENodeSpec,
     YEMarkSpec,

src/core/index.ts

@@ -1,10 +1,10 @@
 import {builders} from 'prosemirror-test-builder';
 import {createMarkupChecker} from '../../../../tests/sameMarkup';
 import {ExtensionsManager} from '../../../core';
-import {BaseNode, BaseSchemaE} from './index';
+import {BaseNode, BaseSchema} from './index';
 
 const {schema, parser, serializer} = new ExtensionsManager({
-    extensions: [BaseSchemaE()],
+    extensions: (builder) => builder.use(BaseSchema, {}),
 }).buildDeps();
 
 const {doc, p} = builders(schema, {

src/extensions/base/BaseSchema/BaseSchema.test.ts

@@ -2,7 +2,7 @@ import type {NodeSpec} from 'prosemirror-model';
 import type {Command} from 'prosemirror-state';
 import {setBlockType} from 'prosemirror-commands';
 import {hasParentNodeOfType} from 'prosemirror-utils';
-import {Action, createExtension, ExtensionAuto} from '../../../core';
+import type {Action, ExtensionAuto} from '../../../core';
 import {nodeTypeFactory} from '../../../utils/schema';
 
 export enum BaseNode {
@@ -82,13 +82,6 @@ export const BaseSchema: ExtensionAuto<BaseSchemaOptions> = (builder, opts) => {
     });
 };
 
-/**
- * @deprecated
- * For tests only.
- * Remove after WIKI-16660
- */
-export const BaseSchemaE = createExtension<BaseSchemaOptions>((b, o) => b.use(BaseSchema, o ?? {}));
-
 declare global {
     namespace YfmEditor {
         interface Actions {

src/extensions/base/BaseSchema/index.ts

@@ -1,4 +1,4 @@
-import {createExtension, ExtensionAuto} from '../../core';
+import type {ExtensionAuto} from '../../core';
 
 import {BaseSchema, BaseSchemaOptions} from './BaseSchema';
 import {BaseInputRules} from './BaseInputRules';
@@ -21,6 +21,3 @@ export const BasePreset: ExtensionAuto<BasePresetOptions> = (builder, opts) => {
         .use(BaseInputRules)
         .use(BaseStyles);
 };
-
-/** @deprecated */
-export const BasePresetE = createExtension<BasePresetOptions>((b, o = {}) => b.use(BasePreset, o));

src/extensions/base/index.ts

@@ -1,11 +1,11 @@
 import {builders} from 'prosemirror-test-builder';
 import {createMarkupChecker} from '../../../../tests/sameMarkup';
 import {ExtensionsManager} from '../../../core';
-import {BaseNode, BaseSchemaE} from '../../base/BaseSchema';
-import {blockquote, BlockquoteE} from './index';
+import {BaseNode, BaseSchema} from '../../base/BaseSchema';
+import {blockquote, Blockquote} from './index';
 
 const {schema, parser, serializer} = new ExtensionsManager({
-    extensions: [BaseSchemaE(), BlockquoteE()],
+    extensions: (builder) => builder.use(BaseSchema, {}).use(Blockquote, {}),
 }).buildDeps();
 
 const {doc, p, q} = builders(schema, {

src/extensions/markdown/Blockquote/Blockquote.test.ts

@@ -2,7 +2,7 @@ import {chainCommands, wrapIn} from 'prosemirror-commands';
 import type {NodeType} from 'prosemirror-model';
 import {wrappingInputRule} from 'prosemirror-inputrules';
 import {hasParentNodeOfType} from 'prosemirror-utils';
-import {Action, createExtension, ExtensionAuto} from '../../../core';
+import type {Action, ExtensionAuto} from '../../../core';
 import {selectQuoteBeforeCursor, liftFromQuote, toggleQuote} from './commands';
 import {blockquote, bqType} from './const';
 
@@ -51,13 +51,6 @@ export const Blockquote: ExtensionAuto<BlockquoteOptions> = (builder, opts) => {
     });
 };
 
-/**
- * @deprecated
- * For tests only.
- * Remove after WIKI-16660
- */
-export const BlockquoteE = createExtension<BlockquoteOptions>((b, o = {}) => b.use(Blockquote, o));
-
 declare global {
     namespace YfmEditor {
         interface Actions {