lexical 0.12.2 → 0.12.3

package/LexicalEditor.d.ts

@@ -6,7 +6,7 @@
  *
  */
 import type { EditorState, SerializedEditorState } from './LexicalEditorState';
-import type { DOMConversion, NodeKey } from './LexicalNode';
+import type { DOMConversion, DOMConversionMap, DOMExportOutput, NodeKey } from './LexicalNode';
 import { LexicalNode } from './LexicalNode';
 export type Spread<T1, T2> = Omit<T2, keyof T1> & T1;
 export type Klass<T extends LexicalNode> = {
@@ -101,21 +101,27 @@ export type EditorConfig = {
     namespace: string;
     theme: EditorThemeClasses;
 };
+export type LexicalNodeReplacement = {
+    replace: Klass<LexicalNode>;
+    with: <T extends {
+        new (...args: any): any;
+    }>(node: InstanceType<T>) => LexicalNode;
+    withKlass?: Klass<LexicalNode>;
+};
+export type HTMLConfig = {
+    export?: Map<Klass<LexicalNode>, (editor: LexicalEditor, target: LexicalNode) => DOMExportOutput>;
+    import?: DOMConversionMap;
+};
 export type CreateEditorArgs = {
     disableEvents?: boolean;
     editorState?: EditorState;
     namespace?: string;
-    nodes?: ReadonlyArray<Klass<LexicalNode> | {
-        replace: Klass<LexicalNode>;
-        with: <T extends {
-            new (...args: any): any;
-        }>(node: InstanceType<T>) => LexicalNode;
-        withKlass?: Klass<LexicalNode>;
-    }>;
+    nodes?: ReadonlyArray<Klass<LexicalNode> | LexicalNodeReplacement>;
     onError?: ErrorHandler;
     parentEditor?: LexicalEditor;
     editable?: boolean;
     theme?: EditorThemeClasses;
+    html?: HTMLConfig;
 };
 export type RegisteredNodes = Map<string, RegisteredNode>;
 export type RegisteredNode = {
@@ -123,6 +129,7 @@ export type RegisteredNode = {
     transforms: Set<Transform<LexicalNode>>;
     replace: null | ((node: LexicalNode) => LexicalNode);
     replaceWithKlass: null | Klass<LexicalNode>;
+    exportDOM?: (editor: LexicalEditor, targetNode: LexicalNode) => DOMExportOutput;
 };
 export type Transform<T extends LexicalNode> = (node: T) => void;
 export type ErrorHandler = (error: Error) => void;

package/LexicalSelection.d.ts

@@ -74,7 +74,7 @@ export declare class NodeSelection implements BaseSelection {
     extract(): Array<LexicalNode>;
     insertRawText(text: string): void;
     insertText(): void;
-    insertNodes(nodes: Array<LexicalNode>, selectStart?: boolean): boolean;
+    insertNodes(nodes: Array<LexicalNode>): void;
     getNodes(): Array<LexicalNode>;
     getTextContent(): string;
 }
@@ -107,7 +107,7 @@ export declare class GridSelection implements BaseSelection {
     extract(): Array<LexicalNode>;
     insertRawText(text: string): void;
     insertText(): void;
-    insertNodes(nodes: Array<LexicalNode>, selectStart?: boolean): boolean;
+    insertNodes(nodes: Array<LexicalNode>): void;
     getShape(): GridSelectionShape;
     getNodes(): Array<LexicalNode>;
     getTextContent(): string;
@@ -227,19 +227,17 @@ export declare class RangeSelection implements BaseSelection {
      * should be changed, replaced, or moved to accomodate the incoming ones.
      *
      * @param nodes - the nodes to insert
-     * @param selectStart - whether or not to select the start after the insertion.
-     * @returns true if the nodes were inserted successfully, false otherwise.
      */
-    insertNodes(nodes: Array<LexicalNode>, selectStart?: boolean): boolean;
+    insertNodes(nodes: Array<LexicalNode>): void;
     /**
      * Inserts a new ParagraphNode into the EditorState at the current Selection
+     *
+     * @returns the newly inserted node.
      */
-    insertParagraph(): void;
+    insertParagraph(): ElementNode | null;
     /**
      * Inserts a logical linebreak, which may be a new LineBreakNode or a new ParagraphNode, into the EditorState at the
      * current Selection.
-     *
-     * @param selectStart whether or not to select the start of the insertion range after the operation completes.
      */
     insertLineBreak(selectStart?: boolean): void;
     /**
@@ -303,7 +301,7 @@ export declare function applySelectionTransforms(nextEditorState: EditorState, e
 export declare function moveSelectionPointToSibling(point: PointType, node: LexicalNode, parent: ElementNode, prevSibling: LexicalNode | null, nextSibling: LexicalNode | null): void;
 export declare function adjustPointOffsetForMergedSibling(point: PointType, isBefore: boolean, key: NodeKey, target: TextNode, textLength: number): void;
 export declare function updateDOMSelection(prevSelection: RangeSelection | NodeSelection | GridSelection | null, nextSelection: RangeSelection | NodeSelection | GridSelection | null, editor: LexicalEditor, domSelection: Selection, tags: Set<string>, rootElement: HTMLElement, nodeCount: number): void;
-export declare function $insertNodes(nodes: Array<LexicalNode>, selectStart?: boolean): boolean;
+export declare function $insertNodes(nodes: Array<LexicalNode>): void;
 export declare function $getTextContent(): string;
 export declare function DEPRECATED_$computeGridMap(grid: DEPRECATED_GridNode, cellA: DEPRECATED_GridCellNode, cellB: DEPRECATED_GridCellNode): [GridMapType, GridMapValueType, GridMapValueType];
 export declare function DEPRECATED_$getNodeTriplet(source: PointType | LexicalNode | DEPRECATED_GridCellNode): [DEPRECATED_GridCellNode, DEPRECATED_GridRowNode, DEPRECATED_GridNode];

package/index.d.ts

@@ -7,7 +7,7 @@
  *
  */
 export type { PasteCommandType } from './LexicalCommands';
-export type { CommandListener, CommandListenerPriority, CommandPayloadType, CreateEditorArgs, EditableListener, EditorConfig, EditorThemeClasses, Klass, LexicalCommand, LexicalEditor, MutationListener, NodeMutation, SerializedEditor, Spread, } from './LexicalEditor';
+export type { CommandListener, CommandListenerPriority, CommandPayloadType, CreateEditorArgs, EditableListener, EditorConfig, EditorThemeClasses, HTMLConfig, Klass, LexicalCommand, LexicalEditor, LexicalNodeReplacement, MutationListener, NodeMutation, SerializedEditor, Spread, } from './LexicalEditor';
 export type { EditorState, SerializedEditorState } from './LexicalEditorState';
 export type { DOMChildConversion, DOMConversion, DOMConversionFn, DOMConversionMap, DOMConversionOutput, DOMExportOutput, LexicalNode, NodeKey, NodeMap, SerializedLexicalNode, } from './LexicalNode';
 export type { BaseSelection, ElementPointType as ElementPoint, GridMapType, GridMapValueType, GridSelection, GridSelectionShape, NodeSelection, Point, RangeSelection, TextPointType as TextPoint, } from './LexicalSelection';

package/package.json

@@ -9,7 +9,7 @@
     "rich-text"
   ],
   "license": "MIT",
-  "version": "0.12.2",
+  "version": "0.12.3",
   "main": "Lexical.js",
   "repository": {
     "type": "git",