@gravity-ui/markdown-editor 14.9.0 → 14.10.1

package/build/esm/bundle/useMarkdownEditor.js

@@ -1,4 +1,5 @@
 import { useLayoutEffect, useMemo } from 'react';
+import { getPMTransformers } from '../core/markdown/ProseMirrorTransformer/getTransformers';
 import { ReactRenderStorage } from '../extensions';
 import { logger } from '../logger';
 import { DirectiveSyntaxContext } from '../utils/directive';
@@ -10,11 +11,15 @@ export function useMarkdownEditor(props, deps = []) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
         const { md = {}, initial = {}, handlers = {}, experimental = {}, markupConfig = {}, wysiwygConfig = {}, } = props;
         const breaks = (_a = md.breaks) !== null && _a !== void 0 ? _a : props.breaks;
+        const preserveEmptyRows = experimental.preserveEmptyRows;
         const preset = (_b = props.preset) !== null && _b !== void 0 ? _b : 'full';
         const renderStorage = new ReactRenderStorage();
         const uploadFile = (_c = handlers.uploadFile) !== null && _c !== void 0 ? _c : props.fileUploadHandler;
         const needToSetDimensionsForUploadedImages = (_d = experimental.needToSetDimensionsForUploadedImages) !== null && _d !== void 0 ? _d : props.needToSetDimensionsForUploadedImages;
         const enableNewImageSizeCalculation = experimental.enableNewImageSizeCalculation;
+        const pmTransformers = getPMTransformers({
+            emptyRowTransformer: preserveEmptyRows,
+        });
         const directiveSyntax = new DirectiveSyntaxContext(experimental.directiveSyntax);
         const extensions = (builder) => {
             var _a;
@@ -26,7 +31,7 @@ export function useMarkdownEditor(props, deps = []) {
                 }, onSubmit: () => {
                     editor.emit('submit', null);
                     return true;
-                }, placeholderOptions: wysiwygConfig.placeholderOptions, mdBreaks: breaks, fileUploadHandler: uploadFile, needToSetDimensionsForUploadedImages,
+                }, preserveEmptyRows: preserveEmptyRows, placeholderOptions: wysiwygConfig.placeholderOptions, mdBreaks: breaks, fileUploadHandler: uploadFile, needToSetDimensionsForUploadedImages,
                 enableNewImageSizeCalculation }));
             {
                 const extraExtensions = wysiwygConfig.extensions || props.extraExtensions;
@@ -37,7 +42,8 @@ export function useMarkdownEditor(props, deps = []) {
         };
         return new EditorImpl(Object.assign(Object.assign({}, props), { preset,
             renderStorage,
-            directiveSyntax, md: Object.assign(Object.assign({}, md), { breaks, html: (_e = md.html) !== null && _e !== void 0 ? _e : props.allowHTML, linkify: (_f = md.linkify) !== null && _f !== void 0 ? _f : props.linkify, linkifyTlds: (_g = md.linkifyTlds) !== null && _g !== void 0 ? _g : props.linkifyTlds }), initial: Object.assign(Object.assign({}, initial), { markup: (_h = initial.markup) !== null && _h !== void 0 ? _h : props.initialMarkup, mode: (_j = initial.mode) !== null && _j !== void 0 ? _j : props.initialEditorMode, toolbarVisible: (_k = initial.toolbarVisible) !== null && _k !== void 0 ? _k : props.initialToolbarVisible, splitModeEnabled: (_l = initial.splitModeEnabled) !== null && _l !== void 0 ? _l : props.initialSplitModeEnabled }), handlers: Object.assign(Object.assign({}, handlers), { uploadFile }), experimental: Object.assign(Object.assign({}, experimental), { needToSetDimensionsForUploadedImages,
+            directiveSyntax,
+            pmTransformers, md: Object.assign(Object.assign({}, md), { breaks, html: (_e = md.html) !== null && _e !== void 0 ? _e : props.allowHTML, linkify: (_f = md.linkify) !== null && _f !== void 0 ? _f : props.linkify, linkifyTlds: (_g = md.linkifyTlds) !== null && _g !== void 0 ? _g : props.linkifyTlds }), initial: Object.assign(Object.assign({}, initial), { markup: (_h = initial.markup) !== null && _h !== void 0 ? _h : props.initialMarkup, mode: (_j = initial.mode) !== null && _j !== void 0 ? _j : props.initialEditorMode, toolbarVisible: (_k = initial.toolbarVisible) !== null && _k !== void 0 ? _k : props.initialToolbarVisible, splitModeEnabled: (_l = initial.splitModeEnabled) !== null && _l !== void 0 ? _l : props.initialSplitModeEnabled }), handlers: Object.assign(Object.assign({}, handlers), { uploadFile }), experimental: Object.assign(Object.assign({}, experimental), { needToSetDimensionsForUploadedImages,
                 enableNewImageSizeCalculation, prepareRawMarkup: (_m = experimental.prepareRawMarkup) !== null && _m !== void 0 ? _m : props.prepareRawMarkup, beforeEditorModeChange: (_o = experimental.beforeEditorModeChange) !== null && _o !== void 0 ? _o : props.experimental_beforeEditorModeChange }), markupConfig: Object.assign(Object.assign({}, markupConfig), { splitMode: (_p = markupConfig.splitMode) !== null && _p !== void 0 ? _p : props.splitMode, renderPreview: (_q = markupConfig.renderPreview) !== null && _q !== void 0 ? _q : props.renderPreview, extensions: (_r = markupConfig.extensions) !== null && _r !== void 0 ? _r : props.extraMarkupExtensions }), wysiwygConfig: Object.assign(Object.assign({}, wysiwygConfig), { extensions, escapeConfig: (_s = wysiwygConfig.escapeConfig) !== null && _s !== void 0 ? _s : props.escapeConfig }) }));
     }, deps);
     useLayoutEffect(() => {

package/build/esm/bundle/wysiwyg-preset.d.ts

@@ -9,6 +9,7 @@ export declare type ExtensionsOptions = BehaviorPresetOptions & FullPresetOption
 export declare type BundlePresetOptions = ExtensionsOptions & EditorModeKeymapOptions & {
     preset: MarkdownEditorPreset;
     mdBreaks?: boolean;
+    preserveEmptyRows?: boolean;
     fileUploadHandler?: FileUploadHandler;
     placeholderOptions?: WysiwygPlaceholderOptions;
     /**

package/build/esm/bundle/wysiwyg-preset.js

@@ -31,7 +31,7 @@ export const BundlePreset = (builder, opts) => {
                 return typeof value === 'function'
                     ? value()
                     : value !== null && value !== void 0 ? value : i18nPlaceholder('doc_empty');
-            } }, opts.baseSchema) });
+            }, preserveEmptyRows: opts.preserveEmptyRows }, opts.baseSchema) });
     const commonMarkOptions = Object.assign(Object.assign({}, zeroOptions), { selectionContext: Object.assign({ config: wSelectionMenuConfigByPreset.commonmark }, opts.selectionContext), commandMenu: Object.assign({ actions: wCommandMenuConfigByPreset.commonmark }, opts.commandMenu), breaks: Object.assign({ preferredBreak: (opts.mdBreaks ? 'soft' : 'hard') }, opts.breaks), bold: Object.assign({ boldKey: f.toPM(A.Bold) }, opts.bold), italic: Object.assign({ italicKey: f.toPM(A.Italic) }, opts.italic), code: Object.assign({ codeKey: f.toPM(A.Code) }, opts.code), codeBlock: Object.assign({ codeBlockKey: f.toPM(A.CodeBlock) }, opts.codeBlock), blockquote: Object.assign({ qouteKey: f.toPM(A.Quote) }, opts.blockquote), link: Object.assign({ linkKey: f.toPM(A.Link) }, opts.link), lists: Object.assign({ ulKey: f.toPM(A.BulletList), olKey: f.toPM(A.OrderedList), ulInputRules: { plus: false } }, opts.lists), image: {
             parseInsertedUrlAsImage: (_a = opts.imgSize) === null || _a === void 0 ? void 0 : _a.parseInsertedUrlAsImage,
         } });

package/build/esm/core/Editor.d.ts

@@ -1,5 +1,6 @@
 import type { PresetName } from 'markdown-it';
 import type { CommonEditor, MarkupString } from '../common';
+import { TransformFn } from './markdown/ProseMirrorTransformer';
 import type { ActionStorage } from './types/actions';
 import type { Extension } from './types/extension';
 import type { Parser } from './types/parser';
@@ -18,6 +19,7 @@ export declare type WysiwygEditorOptions = {
     mdPreset?: PresetName;
     allowHTML?: boolean;
     linkify?: boolean;
+    pmTransformers?: TransformFn[];
     linkifyTlds?: string | string[];
     escapeConfig?: EscapeConfig;
     /** Call on any state change (move cursor, change selection, etc...) */
@@ -31,7 +33,7 @@ export declare class WysiwygEditor implements CommonEditor, ActionStorage {
     get serializer(): Serializer;
     get parser(): Parser;
     get actions(): WysiwygEditor.Actions;
-    constructor({ domElem, initialContent, extensions, allowHTML, mdPreset, linkify, linkifyTlds, escapeConfig, onChange, onDocChange, }: WysiwygEditorOptions);
+    constructor({ domElem, initialContent, extensions, allowHTML, mdPreset, linkify, pmTransformers, linkifyTlds, escapeConfig, onChange, onDocChange, }: WysiwygEditorOptions);
     action<T extends keyof WysiwygEditor.Actions>(actionName: T): WysiwygEditor.Actions[T];
     focus(): void;
     hasFocus(): boolean;

package/build/esm/core/Editor.js

@@ -7,7 +7,7 @@ import { ExtensionsManager } from './ExtensionsManager';
 import { bindActions } from './utils/actions';
 import { logTransactionMetrics } from './utils/metrics';
 export class WysiwygEditor {
-    constructor({ domElem, initialContent = '', extensions = () => { }, allowHTML, mdPreset, linkify, linkifyTlds, escapeConfig, onChange, onDocChange, }) {
+    constructor({ domElem, initialContent = '', extensions = () => { }, allowHTML, mdPreset, linkify, pmTransformers, linkifyTlds, escapeConfig, onChange, onDocChange, }) {
         _WysiwygEditor_view.set(this, void 0);
         _WysiwygEditor_serializer.set(this, void 0);
         _WysiwygEditor_parser.set(this, void 0);
@@ -18,6 +18,7 @@ export class WysiwygEditor {
             // "breaks" option only affects the renderer, but not the parser
             mdOpts: { html: allowHTML, linkify, breaks: true, preset: mdPreset },
             linkifyTlds,
+            pmTransformers,
         });
         const state = EditorState.create({
             schema,

package/build/esm/core/ExtensionsManager.d.ts

@@ -1,6 +1,7 @@
 import MarkdownIt, { PresetName } from 'markdown-it';
 import type { Plugin } from 'prosemirror-state';
 import { ActionsManager } from './ActionsManager';
+import { TransformFn } from './markdown/ProseMirrorTransformer';
 import type { ActionSpec } from './types/actions';
 import type { Extension, ExtensionDeps } from './types/extension';
 import type { MarkViewConstructor, NodeViewConstructor } from './types/node-views';
@@ -13,6 +14,7 @@ declare type ExtensionsManagerOptions = {
         preset?: PresetName;
     };
     linkifyTlds?: string | string[];
+    pmTransformers?: TransformFn[];
 };
 export declare class ExtensionsManager {
     #private;

package/build/esm/core/ExtensionsManager.js

@@ -1,4 +1,4 @@
-var _ExtensionsManager_schemaRegistry, _ExtensionsManager_parserRegistry, _ExtensionsManager_serializerRegistry, _ExtensionsManager_nodeViewCreators, _ExtensionsManager_markViewCreators, _ExtensionsManager_mdForMarkup, _ExtensionsManager_mdForText, _ExtensionsManager_extensions, _ExtensionsManager_builder, _ExtensionsManager_spec, _ExtensionsManager_deps, _ExtensionsManager_plugins, _ExtensionsManager_actions, _ExtensionsManager_nodeViews, _ExtensionsManager_markViews;
+var _ExtensionsManager_schemaRegistry, _ExtensionsManager_parserRegistry, _ExtensionsManager_serializerRegistry, _ExtensionsManager_nodeViewCreators, _ExtensionsManager_markViewCreators, _ExtensionsManager_pmTransformers, _ExtensionsManager_mdForMarkup, _ExtensionsManager_mdForText, _ExtensionsManager_extensions, _ExtensionsManager_builder, _ExtensionsManager_spec, _ExtensionsManager_deps, _ExtensionsManager_plugins, _ExtensionsManager_actions, _ExtensionsManager_nodeViews, _ExtensionsManager_markViews;
 import { __classPrivateFieldGet, __classPrivateFieldSet } from "tslib";
 import MarkdownIt from 'markdown-it';
 import { ActionsManager } from './ActionsManager';
@@ -14,6 +14,7 @@ export class ExtensionsManager {
         _ExtensionsManager_serializerRegistry.set(this, new SerializerTokensRegistry());
         _ExtensionsManager_nodeViewCreators.set(this, new Map());
         _ExtensionsManager_markViewCreators.set(this, new Map());
+        _ExtensionsManager_pmTransformers.set(this, []);
         _ExtensionsManager_mdForMarkup.set(this, void 0);
         _ExtensionsManager_mdForText.set(this, void 0);
         _ExtensionsManager_extensions.set(this, void 0);
@@ -48,6 +49,9 @@ export class ExtensionsManager {
             __classPrivateFieldGet(this, _ExtensionsManager_mdForMarkup, "f").linkify.tlds(options.linkifyTlds, true);
             __classPrivateFieldGet(this, _ExtensionsManager_mdForText, "f").linkify.tlds(options.linkifyTlds, true);
         }
+        if (options.pmTransformers) {
+            __classPrivateFieldSet(this, _ExtensionsManager_pmTransformers, options.pmTransformers, "f");
+        }
         // TODO: add prefilled context
         __classPrivateFieldSet(this, _ExtensionsManager_builder, new ExtensionBuilder(), "f");
     }
@@ -77,8 +81,8 @@ export class ExtensionsManager {
         __classPrivateFieldSet(this, _ExtensionsManager_deps, {
             schema,
             actions: new ActionsManager(),
-            markupParser: __classPrivateFieldGet(this, _ExtensionsManager_parserRegistry, "f").createParser(schema, __classPrivateFieldGet(this, _ExtensionsManager_mdForMarkup, "f")),
-            textParser: __classPrivateFieldGet(this, _ExtensionsManager_parserRegistry, "f").createParser(schema, __classPrivateFieldGet(this, _ExtensionsManager_mdForText, "f")),
+            markupParser: __classPrivateFieldGet(this, _ExtensionsManager_parserRegistry, "f").createParser(schema, __classPrivateFieldGet(this, _ExtensionsManager_mdForMarkup, "f"), __classPrivateFieldGet(this, _ExtensionsManager_pmTransformers, "f")),
+            textParser: __classPrivateFieldGet(this, _ExtensionsManager_parserRegistry, "f").createParser(schema, __classPrivateFieldGet(this, _ExtensionsManager_mdForText, "f"), __classPrivateFieldGet(this, _ExtensionsManager_pmTransformers, "f")),
             serializer: __classPrivateFieldGet(this, _ExtensionsManager_serializerRegistry, "f").createSerializer(),
         }, "f");
     }
@@ -93,4 +97,4 @@ export class ExtensionsManager {
         }
     }
 }
-_ExtensionsManager_schemaRegistry = new WeakMap(), _ExtensionsManager_parserRegistry = new WeakMap(), _ExtensionsManager_serializerRegistry = new WeakMap(), _ExtensionsManager_nodeViewCreators = new WeakMap(), _ExtensionsManager_markViewCreators = new WeakMap(), _ExtensionsManager_mdForMarkup = new WeakMap(), _ExtensionsManager_mdForText = new WeakMap(), _ExtensionsManager_extensions = new WeakMap(), _ExtensionsManager_builder = new WeakMap(), _ExtensionsManager_spec = new WeakMap(), _ExtensionsManager_deps = new WeakMap(), _ExtensionsManager_plugins = new WeakMap(), _ExtensionsManager_actions = new WeakMap(), _ExtensionsManager_nodeViews = new WeakMap(), _ExtensionsManager_markViews = new WeakMap();
+_ExtensionsManager_schemaRegistry = new WeakMap(), _ExtensionsManager_parserRegistry = new WeakMap(), _ExtensionsManager_serializerRegistry = new WeakMap(), _ExtensionsManager_nodeViewCreators = new WeakMap(), _ExtensionsManager_markViewCreators = new WeakMap(), _ExtensionsManager_pmTransformers = new WeakMap(), _ExtensionsManager_mdForMarkup = new WeakMap(), _ExtensionsManager_mdForText = new WeakMap(), _ExtensionsManager_extensions = new WeakMap(), _ExtensionsManager_builder = new WeakMap(), _ExtensionsManager_spec = new WeakMap(), _ExtensionsManager_deps = new WeakMap(), _ExtensionsManager_plugins = new WeakMap(), _ExtensionsManager_actions = new WeakMap(), _ExtensionsManager_nodeViews = new WeakMap(), _ExtensionsManager_markViews = new WeakMap();

package/build/esm/core/ParserTokensRegistry.d.ts

@@ -1,8 +1,9 @@
 import type MarkdownIt from 'markdown-it';
 import type { Schema } from 'prosemirror-model';
+import { TransformFn } from './markdown/ProseMirrorTransformer';
 import type { Parser, ParserToken } from './types/parser';
 export declare class ParserTokensRegistry {
     #private;
     addToken(name: string, token: ParserToken): this;
-    createParser(schema: Schema, tokenizer: MarkdownIt): Parser;
+    createParser(schema: Schema, tokenizer: MarkdownIt, pmTransformers: TransformFn[]): Parser;
 }

package/build/esm/core/ParserTokensRegistry.js

@@ -9,8 +9,8 @@ export class ParserTokensRegistry {
         __classPrivateFieldGet(this, _ParserTokensRegistry_tokens, "f")[name] = token;
         return this;
     }
-    createParser(schema, tokenizer) {
-        return new MarkdownParser(schema, tokenizer, __classPrivateFieldGet(this, _ParserTokensRegistry_tokens, "f"));
+    createParser(schema, tokenizer, pmTransformers) {
+        return new MarkdownParser(schema, tokenizer, __classPrivateFieldGet(this, _ParserTokensRegistry_tokens, "f"), pmTransformers);
     }
 }
 _ParserTokensRegistry_tokens = new WeakMap();

package/build/esm/core/markdown/MarkdownParser.d.ts

@@ -2,6 +2,7 @@ import type { Match } from 'linkify-it';
 import type MarkdownIt from 'markdown-it';
 import { Mark, Node, NodeType, Schema } from 'prosemirror-model';
 import type { Parser, ParserToken } from '../types/parser';
+import { TransformFn } from './ProseMirrorTransformer';
 declare type TokenAttrs = {
     [name: string]: unknown;
 };
@@ -15,7 +16,8 @@ export declare class MarkdownParser implements Parser {
     marks: readonly Mark[];
     tokens: Record<string, ParserToken>;
     tokenizer: MarkdownIt;
-    constructor(schema: Schema, tokenizer: MarkdownIt, tokens: Record<string, ParserToken>);
+    pmTransformers: TransformFn[];
+    constructor(schema: Schema, tokenizer: MarkdownIt, tokens: Record<string, ParserToken>, pmTransformers: TransformFn[]);
     validateLink(url: string): boolean;
     normalizeLink(url: string): string;
     normalizeLinkText(url: string): string;

package/build/esm/core/markdown/MarkdownParser.js

@@ -1,5 +1,6 @@
 import { Mark } from 'prosemirror-model';
 import { logger } from '../../logger';
+import { ProseMirrorTransformer } from './ProseMirrorTransformer';
 const openSuffix = '_open';
 const closeSuffix = '_close';
 var TokenType;
@@ -9,12 +10,13 @@ var TokenType;
     TokenType["default"] = "default";
 })(TokenType || (TokenType = {}));
 export class MarkdownParser {
-    constructor(schema, tokenizer, tokens) {
+    constructor(schema, tokenizer, tokens, pmTransformers) {
         this.stack = [];
         this.schema = schema;
         this.marks = Mark.none;
         this.tokens = tokens;
         this.tokenizer = tokenizer;
+        this.pmTransformers = pmTransformers;
     }
     validateLink(url) {
         return this.tokenizer.validateLink(url);
@@ -47,7 +49,8 @@ export class MarkdownParser {
             do {
                 doc = this.closeNode();
             } while (this.stack.length);
-            return (doc || this.schema.topNodeType.createAndFill());
+            const pmTransformer = new ProseMirrorTransformer(this.pmTransformers);
+            return doc ? pmTransformer.transform(doc) : this.schema.topNodeType.createAndFill();
         }
         finally {
             logger.metrics({ component: 'parser', event: 'parse', duration: Date.now() - time });

package/build/esm/core/markdown/MarkdownSerializer.js

@@ -161,7 +161,7 @@ export class MarkdownSerializerState {
             const startOfLine = this.atBlank() || this.closed;
             this.write();
             let text = lines[i];
-            if (escape !== false)
+            if (escape !== false && this.options.escape !== false)
                 text = this.esc(text, startOfLine);
             if (this.escapeWhitespace)
                 text = this.escWhitespace(text);

package/build/esm/core/markdown/ProseMirrorTransformer/emptyRowTransformer.d.ts

@@ -0,0 +1,2 @@
+import { TransformFn } from './index';
+export declare const transformEmptyParagraph: TransformFn;

package/build/esm/core/markdown/ProseMirrorTransformer/emptyRowTransformer.js

@@ -0,0 +1,11 @@
+export const transformEmptyParagraph = (node) => {
+    var _a, _b;
+    if (node.type !== 'paragraph')
+        return;
+    if (((_a = node.content) === null || _a === void 0 ? void 0 : _a.length) !== 1)
+        return;
+    if (((_b = node.content[0]) === null || _b === void 0 ? void 0 : _b.type) !== 'text')
+        return;
+    if (node.content[0].text === String.fromCharCode(160))
+        delete node.content;
+};

package/build/esm/core/markdown/ProseMirrorTransformer/getTransformers.d.ts

@@ -0,0 +1,7 @@
+import { TransformFn } from '.';
+declare type GetTransformersProps = {
+    emptyRowTransformer?: boolean;
+};
+declare type GetPMTransformersType = (config: GetTransformersProps) => TransformFn[];
+export declare const getPMTransformers: GetPMTransformersType;
+export {};

package/build/esm/core/markdown/ProseMirrorTransformer/getTransformers.js

@@ -0,0 +1,9 @@
+// TODO: add a new method to the ExtensionBuilder
+import { transformEmptyParagraph } from './emptyRowTransformer';
+export const getPMTransformers = ({ emptyRowTransformer }) => {
+    const transformers = [];
+    if (emptyRowTransformer) {
+        transformers.push(transformEmptyParagraph);
+    }
+    return transformers;
+};

package/build/esm/core/markdown/ProseMirrorTransformer/index.d.ts

@@ -0,0 +1,15 @@
+import { Node } from 'prosemirror-model';
+declare type PMNodeJSON = {
+    type: string;
+    attrs?: Record<string, any>;
+    content?: PMNodeJSON[];
+    text?: string;
+};
+export declare type TransformFn = (node: PMNodeJSON) => void;
+export declare class ProseMirrorTransformer {
+    private readonly _transformers;
+    constructor(fns: TransformFn[]);
+    transform(doc: Node): Node;
+    transformJSON(node: PMNodeJSON): void;
+}
+export {};

package/build/esm/core/markdown/ProseMirrorTransformer/index.js

@@ -0,0 +1,21 @@
+import { Node } from 'prosemirror-model';
+export class ProseMirrorTransformer {
+    constructor(fns) {
+        this._transformers = fns;
+    }
+    transform(doc) {
+        const docJSON = doc.toJSON();
+        this.transformJSON(docJSON);
+        return Node.fromJSON(doc.type.schema, docJSON);
+    }
+    transformJSON(node) {
+        for (const fn of this._transformers) {
+            fn(node);
+        }
+        if (node.content) {
+            for (const child of node.content) {
+                this.transformJSON(child);
+            }
+        }
+    }
+}

package/build/esm/extensions/additional/Math/MathSpecs/index.js

@@ -40,6 +40,7 @@ export const MathSpecs = (builder) => {
             code: true,
             toDOM: () => ['div', { class: 'math-block' }, 0],
             parseDOM: [{ tag: 'div.math-block', priority: 200 }],
+            selectable: true,
         },
         fromMd: {
             tokenName: 'math_block',

package/build/esm/extensions/base/BaseSchema/BaseSchemaSpecs/index.d.ts

@@ -8,5 +8,6 @@ export declare enum BaseNode {
 export declare const pType: (schema: import("prosemirror-model").Schema<any, any>) => import("prosemirror-model").NodeType;
 export declare type BaseSchemaSpecsOptions = {
     paragraphPlaceholder?: NonNullable<NodeSpec['placeholder']>['content'];
+    preserveEmptyRows?: boolean;
 };
 export declare const BaseSchemaSpecs: ExtensionAuto<BaseSchemaSpecsOptions>;

package/build/esm/extensions/base/BaseSchema/BaseSchemaSpecs/index.js

@@ -42,6 +42,7 @@ export const BaseSchemaSpecs = (builder, opts) => {
                     0,
                 ];
             },
+            selectable: true,
             placeholder: opts.paragraphPlaceholder
                 ? {
                     content: opts.paragraphPlaceholder,
@@ -50,9 +51,28 @@ export const BaseSchemaSpecs = (builder, opts) => {
                 : undefined,
         },
         fromMd: { tokenSpec: { name: BaseNode.Paragraph, type: 'block' } },
-        toMd: (state, node) => {
-            state.renderInline(node);
-            state.closeBlock(node);
+        toMd: (state, node, parent) => {
+            /*
+                An empty line is added only if there is some content in the parent element.
+                This is necessary in order to prevent an empty document with empty lines
+            */
+            if (opts.preserveEmptyRows && !node.content.size) {
+                let isParentEmpty = true;
+                for (let index = 0; index < parent.content.childCount; index++) {
+                    const parentChild = parent.content.child(index);
+                    if (parentChild.content.size !== 0 ||
+                        parentChild.type.name !== 'paragraph') {
+                        isParentEmpty = false;
+                    }
+                }
+                if (!isParentEmpty) {
+                    state.write('&nbsp;\n\n');
+                }
+            }
+            else {
+                state.renderInline(node);
+                state.closeBlock(node);
+            }
         },
     }));
 };

package/build/esm/extensions/behavior/Selection/selection.js

@@ -71,11 +71,7 @@ const getTopLevelNodesFromSelection = (selection, doc) => {
         const { from, to } = selection;
         doc.nodesBetween(from, to, (node, pos) => {
             const withinSelection = from <= pos && pos + node.nodeSize <= to;
-            if (node &&
-                node.type.name !== 'paragraph' &&
-                !node.isText &&
-                node.type.spec.selectable &&
-                withinSelection) {
+            if (node && !node.isText && node.type.spec.selectable !== false && withinSelection) {
                 nodes.push({ node, pos });
                 return false;
             }

package/build/esm/extensions/markdown/Blockquote/BlockquoteSpecs/index.js

@@ -12,6 +12,7 @@ export const BlockquoteSpecs = (builder) => {
             toDOM() {
                 return ['blockquote', 0];
             },
+            selectable: true,
         },
         fromMd: { tokenSpec: { name: blockquoteNodeName, type: 'block' } },
         toMd: (state, node) => {

package/build/esm/extensions/markdown/CodeBlock/commands.js

@@ -16,7 +16,7 @@ export const setCodeBlockType = ({ serializer }) => (state, dispatch) => {
     if (!setBlockType(nodeType)(state))
         return false;
     if (dispatch) {
-        const markup = serializer.serialize(state.selection.content().content);
+        const markup = serializer.serialize(state.selection.content().content, { escape: false });
         dispatch(state.tr.replaceSelectionWith(nodeType.createAndFill({}, markup ? state.schema.text(markup) : null)));
     }
     return true;

package/build/esm/extensions/markdown/HorizontalRule/HorizontalRuleSpecs/index.js

@@ -11,6 +11,7 @@ export const HorizontalRuleSpecs = (builder) => {
             toDOM() {
                 return ['div', ['hr']];
             },
+            selectable: true,
         },
         fromMd: {
             tokenName: 'hr',

package/build/esm/extensions/yfm/YfmTabs/YfmTabsSpecs/schema.js

@@ -64,6 +64,7 @@ export const getSchemaSpecs = (opts, placeholder) => {
             toDOM(node) {
                 return ['div', node.attrs, 0];
             },
+            selectable: true,
             complex: 'root',
         },
         [TabsNode.TabsList]: {

package/build/esm/i18n/empty-row/en.json

@@ -0,0 +1,3 @@
+{
+  "snippet.text": "Empty row"
+}

package/build/esm/i18n/empty-row/index.d.ts

@@ -0,0 +1,5 @@
+export declare const i18n: <G extends "snippet.text", S extends string>(key: G | (string extends S ? S : never), params?: {
+    [key: string]: any;
+} | undefined) => S extends G ? {
+    "snippet.text": string;
+}[G] : string;

package/build/esm/i18n/empty-row/index.js

@@ -0,0 +1,5 @@
+import { registerKeyset } from '../i18n';
+import en from './en.json';
+import ru from './ru.json';
+const KEYSET = 'empty-row';
+export const i18n = registerKeyset(KEYSET, { en, ru });

package/build/esm/i18n/empty-row/ru.json

@@ -0,0 +1,3 @@
+{
+  "snippet.text": "Пустая строка"
+}

package/build/esm/i18n/yfm-note/index.d.ts

@@ -1,4 +1,4 @@
-export declare const i18n: <G extends "remove" | "info" | "warning" | "tip" | "alert", S extends string>(key: G | (string extends S ? S : never), params?: {
+export declare const i18n: <G extends "remove" | "info" | "tip" | "warning" | "alert", S extends string>(key: G | (string extends S ? S : never), params?: {
     [key: string]: any;
 } | undefined) => S extends G ? {
     info: string;

package/build/esm/index.d.ts

@@ -1,6 +1,7 @@
 export * from './common';
 export * from './core';
 export * from './toolbar';
+export * from './modules/toolbars/types';
 export * from './react-utils';
 export * from './classname';
 export * from './logger';

package/build/esm/index.js

@@ -1,6 +1,7 @@
 export * from './common';
 export * from './core';
 export * from './toolbar';
+export * from './modules/toolbars/types';
 export * from './react-utils';
 export * from './classname';
 export * from './logger';

package/build/esm/markup/codemirror/autocomplete/emptyRow.d.ts

@@ -0,0 +1,9 @@
+import { CompletionContext, CompletionResult } from '@codemirror/autocomplete';
+export declare const emptyRowSnippetTemplate = " \n\n";
+export declare const emptyRowSnippet: (editor: {
+    state: import("@codemirror/state").EditorState;
+    dispatch: (tr: import("@codemirror/state").Transaction) => void;
+}, completion: import("@codemirror/autocomplete").Completion | null, from: number, to: number) => void;
+export declare const emptyRowAutocomplete: {
+    autocomplete: (context: CompletionContext) => CompletionResult | null;
+};

package/build/esm/markup/codemirror/autocomplete/emptyRow.js

@@ -0,0 +1,23 @@
+import { snippet } from '@codemirror/autocomplete';
+import { i18n } from '../../../../src/i18n/empty-row';
+export const emptyRowSnippetTemplate = ' \n\n';
+export const emptyRowSnippet = snippet(emptyRowSnippetTemplate);
+export const emptyRowAutocomplete = {
+    autocomplete: (context) => {
+        const word = context.matchBefore(/^.*/);
+        if (word === null || word === void 0 ? void 0 : word.text.startsWith('&')) {
+            return {
+                from: word.from,
+                options: [
+                    {
+                        label: ' ',
+                        displayLabel: i18n('snippet.text'),
+                        type: 'text',
+                        apply: emptyRowSnippet,
+                    },
+                ],
+            };
+        }
+        return null;
+    },
+};

package/build/esm/markup/codemirror/autocomplete/index.d.ts

@@ -0,0 +1,5 @@
+declare type GetAutocompleteConfig = {
+    preserveEmptyRows?: boolean;
+};
+export declare const getAutocompleteConfig: ({ preserveEmptyRows }: GetAutocompleteConfig) => import("../yfm").LanguageData[];
+export {};

package/build/esm/markup/codemirror/autocomplete/index.js

@@ -0,0 +1,10 @@
+import { mdAutocomplete } from '../yfm';
+import { emptyRowAutocomplete } from './emptyRow';
+export const getAutocompleteConfig = ({ preserveEmptyRows }) => {
+    const autocompleteItems = [];
+    if (preserveEmptyRows) {
+        autocompleteItems.push(emptyRowAutocomplete);
+    }
+    autocompleteItems.push(mdAutocomplete);
+    return autocompleteItems;
+};

package/build/esm/markup/codemirror/create.d.ts

@@ -33,6 +33,7 @@ export declare type CreateCodemirrorParams = {
     yfmLangOptions?: YfmLangOptions;
     autocompletion?: Autocompletion;
     directiveSyntax: DirectiveSyntaxContext;
+    preserveEmptyRows: boolean;
 };
 export declare function createCodemirror(params: CreateCodemirrorParams): EditorView;
 export declare function withLogger(action: string, command: StateCommand): StateCommand;

package/build/esm/markup/codemirror/create.js

@@ -6,7 +6,7 @@ import { ActionName } from '../../bundle/config/action-names';
 import { logger } from '../../logger';
 import { Action as A, formatter as f } from '../../shortcuts';
 import { DataTransferType, shouldSkipHtmlConversion } from '../../utils/clipboard';
-import { insertImages, insertLink, toH1, toH2, toH3, toH4, toH5, toH6, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline, wrapToCodeBlock, wrapToInlineCode, wrapToYfmCut, wrapToYfmNote, } from '../commands';
+import { insertEmptyRow, insertImages, insertLink, toH1, toH2, toH3, toH4, toH5, toH6, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline, wrapToCodeBlock, wrapToInlineCode, wrapToYfmCut, wrapToYfmNote, } from '../commands';
 import { DirectiveSyntaxFacet } from './directive-facet';
 import { FileUploadHandlerFacet } from './files-upload-facet';
 import { gravityHighlightStyle, gravityTheme } from './gravity';
@@ -17,7 +17,7 @@ import { SearchPanelPlugin } from './search-plugin/plugin';
 import { smartReindent } from './smart-reindent';
 import { yfmLang } from './yfm';
 export function createCodemirror(params) {
-    const { doc, reactRenderer, onCancel, onScroll, onSubmit, onChange, onDocChange, disabledExtensions = {}, keymaps = [], receiver, yfmLangOptions, extensions: extraExtensions, placeholder: placeholderContent, autocompletion: autocompletionConfig, parseHtmlOnPaste, parseInsertedUrlAsImage, directiveSyntax, } = params;
+    const { doc, reactRenderer, onCancel, onScroll, onSubmit, onChange, onDocChange, disabledExtensions = {}, keymaps = [], receiver, yfmLangOptions, extensions: extraExtensions, placeholder: placeholderContent, autocompletion: autocompletionConfig, parseHtmlOnPaste, parseInsertedUrlAsImage, directiveSyntax, preserveEmptyRows, } = params;
     const extensions = [gravityTheme, placeholder(placeholderContent)];
     if (!disabledExtensions.history) {
         extensions.push(history());
@@ -136,6 +136,11 @@ export function createCodemirror(params) {
         anchorSelector: '.g-md-search-anchor',
         receiver,
     }));
+    if (preserveEmptyRows) {
+        extensions.push(keymap.of([
+            { key: f.toCM(A.EmptyRow), run: withLogger(ActionName.emptyRow, insertEmptyRow) },
+        ]));
+    }
     if (params.uploadHandler) {
         extensions.push(FileUploadHandlerFacet.of({
             fn: params.uploadHandler,

package/build/esm/markup/codemirror/yfm.d.ts

@@ -8,7 +8,7 @@ export declare const customTags: {
 };
 export declare type YfmNoteType = 'info' | 'tip' | 'warning' | 'alert';
 export declare const yfmNoteTypes: readonly YfmNoteType[];
-export declare const yfmNoteSnippetTemplate: (type: YfmNoteType) => "{% note info %}\n\n#{}\n\n{% endnote %}\n\n" | "{% note warning %}\n\n#{}\n\n{% endnote %}\n\n" | "{% note tip %}\n\n#{}\n\n{% endnote %}\n\n" | "{% note alert %}\n\n#{}\n\n{% endnote %}\n\n";
+export declare const yfmNoteSnippetTemplate: (type: YfmNoteType) => "{% note info %}\n\n#{}\n\n{% endnote %}\n\n" | "{% note tip %}\n\n#{}\n\n{% endnote %}\n\n" | "{% note warning %}\n\n#{}\n\n{% endnote %}\n\n" | "{% note alert %}\n\n#{}\n\n{% endnote %}\n\n";
 export declare const yfmNoteSnippets: Record<YfmNoteType, ReturnType<typeof snippet>>;
 export declare const yfmCutSnippetTemplate = "{% cut \"#{title}\" %}\n\n#{}\n\n{% endcut %}\n\n";
 export declare const yfmCutSnippet: (editor: {
@@ -27,4 +27,5 @@ export interface LanguageData {
 export interface YfmLangOptions {
     languageData?: LanguageData[];
 }
+export declare const mdAutocomplete: LanguageData;
 export declare function yfmLang({ languageData }?: YfmLangOptions): Extension;

package/build/esm/markup/codemirror/yfm.js

@@ -57,7 +57,7 @@ export const yfmCutSnippetTemplate = '{% cut "#{title}" %}\n\n#{}\n\n{% endcut %
 export const yfmCutSnippet = snippet(yfmCutSnippetTemplate);
 export const yfmCutDirectiveSnippetTemplate = ':::cut [#{title}]\n#{}\n:::\n\n';
 export const yfmCutDirectiveSnippet = snippet(yfmCutDirectiveSnippetTemplate);
-const mdAutocomplete = {
+export const mdAutocomplete = {
     autocomplete: (context) => {
         const directiveContext = context.state.facet(DirectiveSyntaxFacet);
         // TODO: add more actions and re-enable

package/build/esm/markup/commands/emptyRow.d.ts

@@ -0,0 +1,2 @@
+import { StateCommand } from '@codemirror/state';
+export declare const insertEmptyRow: StateCommand;