@etrepum/lexical-builder 0.0.10-nightly.20240604.0 → 0.0.11

package/dist/AutoFocusPlan.d.ts

@@ -11,7 +11,15 @@ declare module "@etrepum/lexical-builder" {
     }
 }
 export interface AutoFocusConfig {
+    /**
+     * Where to move the selection when the editor is focused and there is no
+     * existing selection. Can be "rootStart" or "rootEnd" (the default).
+     */
     defaultSelection?: "rootStart" | "rootEnd";
 }
-export declare const AutoFocusPlan: import('./types').LexicalPlan<AutoFocusConfig, "@etrepum/lexical-builder/AutoFocusPlan">;
+/**
+ * A Plan to focus the LexicalEditor when the root element is set
+ * (typically only when the editor is first created).
+ */
+export declare const AutoFocusPlan: import('@etrepum/lexical-builder').LexicalPlan<AutoFocusConfig, "@etrepum/lexical-builder/AutoFocusPlan">;
 //# sourceMappingURL=AutoFocusPlan.d.ts.map

package/dist/AutoFocusPlan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AutoFocusPlan.d.ts","sourceRoot":"","sources":["../src/AutoFocusPlan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,QAAQ,0BAA0B,CAAC;IACxC,UAAU,mBAAmB;QAC3B,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,aAAa,CAAC;KAC5C;CACF;AAED,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC5C;AAED,eAAO,MAAM,aAAa,0FAwBxB,CAAC"}
+{"version":3,"file":"AutoFocusPlan.d.ts","sourceRoot":"","sources":["../src/AutoFocusPlan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,QAAQ,0BAA0B,CAAC;IACxC,UAAU,mBAAmB;QAC3B,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,aAAa,CAAC;KAC5C;CACF;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC5C;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,2GAwBxB,CAAC"}

package/dist/DragonPlan.d.ts

@@ -5,5 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-export declare const DragonPlan: import('./types').LexicalPlan<{}, "@lexical/dragon">;
+/**
+ * Add Dragon speech to text input support to the editor, via the
+ * @lexical/dragon module.
+ */
+export declare const DragonPlan: import('@etrepum/lexical-builder').LexicalPlan<{}, "@lexical/dragon">;
 //# sourceMappingURL=DragonPlan.d.ts.map

package/dist/DragonPlan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DragonPlan.d.ts","sourceRoot":"","sources":["../src/DragonPlan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,eAAO,MAAM,UAAU,sDAIrB,CAAC"}
+{"version":3,"file":"DragonPlan.d.ts","sourceRoot":"","sources":["../src/DragonPlan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;GAGG;AACH,eAAO,MAAM,UAAU,uEAIrB,CAAC"}

package/dist/HistoryPlan.d.ts

@@ -6,8 +6,19 @@ declare module "@etrepum/lexical-builder" {
     }
 }
 export interface HistoryConfig {
+    /**
+     * The time (in milliseconds) the editor should delay generating a new history stack,
+     * instead of merging the current changes with the current stack. The default is 300ms.
+     */
     delay: number;
+    /**
+     * The initial history state, the default is {@link createEmptyHistoryState}.
+     */
     createInitialHistoryState: () => HistoryState;
 }
-export declare const HistoryPlan: import('./types').LexicalPlan<HistoryConfig, "@etrepum/lexical-builder/HistoryPlan">;
+/**
+ * Registers necessary listeners to manage undo/redo history stack and related
+ * editor commands, via the @lexical/history module.
+ */
+export declare const HistoryPlan: import('@etrepum/lexical-builder').LexicalPlan<HistoryConfig, "@etrepum/lexical-builder/HistoryPlan">;
 //# sourceMappingURL=HistoryPlan.d.ts.map

package/dist/HistoryPlan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HistoryPlan.d.ts","sourceRoot":"","sources":["../src/HistoryPlan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,QAAQ,0BAA0B,CAAC;IACxC,UAAU,mBAAmB;QAC3B,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,WAAW,CAAC;KACxC;CACF;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB,EAAE,MAAM,YAAY,CAAC;CAC/C;AAED,eAAO,MAAM,WAAW,sFAStB,CAAC"}
+{"version":3,"file":"HistoryPlan.d.ts","sourceRoot":"","sources":["../src/HistoryPlan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,QAAQ,0BAA0B,CAAC;IACxC,UAAU,mBAAmB;QAC3B,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,WAAW,CAAC;KACxC;CACF;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,yBAAyB,EAAE,MAAM,YAAY,CAAC;CAC/C;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,uGAStB,CAAC"}

package/dist/LexicalBuilder.d.ts

@@ -2,6 +2,37 @@ import { AnyLexicalPlan, AnyLexicalPlanArgument, EditorHandle } from './types';
 import { LexicalEditor, CreateEditorArgs } from 'lexical';
 import { PlanRep } from './PlanRep';
 
+/**
+ * Build a LexicalEditor by combining together one or more plans, optionally
+ * overriding some of their configuration.
+ *
+ * @param plan A plan argument (a plan, or a plan with config overrides)
+ * @param plans Optional additional plan arguments
+ * @returns An editor handle
+ *
+ * @example A single root plan with multiple dependencies
+ * ```ts
+ * const editorHandle = buildEditorFromPlans(
+ *   defineRootPlan({
+ *     dependencies: [
+ *       RichTextPlan,
+ *       configPlan(EmojiPlan, { emojiBaseUrl: "/assets/emoji" }),
+ *     ],
+ *     register: (editor: LexicalEditor) => {
+ *       console.log("Editor Created");
+ *       return () => console.log("Editor Disposed");
+ *     },
+ *   }),
+ * );
+ * ```
+ * @example A very similar minimal configuration without the register hook
+ * ```ts
+ * const editorHandle = buildEditorFromPlans(
+ *   RichTextPlan,
+ *   configPlan(EmojiPlan, { emojiBaseUrl: "/assets/emoji" }),
+ * );
+ * ```
+ */
 export declare function buildEditorFromPlans(plan: AnyLexicalPlanArgument, ...plans: AnyLexicalPlanArgument[]): EditorHandle;
 /** @internal */
 export declare class LexicalBuilder {
@@ -10,6 +41,7 @@ export declare class LexicalBuilder {
     planNameMap: Map<string, PlanRep<AnyLexicalPlan>>;
     conflicts: Map<string, string>;
     constructor();
+    /** Look up the editor that was created by this LexicalBuilder or throw */
     static fromEditor(editor: LexicalEditor): LexicalBuilder;
     buildEditor(): EditorHandle;
     addPlan(arg: AnyLexicalPlanArgument): number;

package/dist/LexicalBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LexicalBuilder.d.ts","sourceRoot":"","sources":["../src/LexicalBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,aAAa,EAEb,KAAK,gBAAgB,EAKtB,MAAM,SAAS,CAAC;AAKjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,sBAAsB,EAC5B,GAAG,KAAK,EAAE,sBAAsB,EAAE,GACjC,YAAY,CAOd;AA2BD,gBAAgB;AAChB,qBAAa,cAAc;IACzB,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;IACvD,OAAO,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAChE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAClD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;IAU/B,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc;IASxD,WAAW,IAAI,YAAY;IAmB3B,OAAO,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM;IAsE3C,cAAc;IAMf,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,IAAI;IA6BjD,qBAAqB;CAsFtB"}
+{"version":3,"file":"LexicalBuilder.d.ts","sourceRoot":"","sources":["../src/LexicalBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,YAAY,EAEb,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,aAAa,EAEb,KAAK,gBAAgB,EAKtB,MAAM,SAAS,CAAC;AAKjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,sBAAsB,EAC5B,GAAG,KAAK,EAAE,sBAAsB,EAAE,GACjC,YAAY,CAOd;AA+BD,gBAAgB;AAChB,qBAAa,cAAc;IACzB,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;IACvD,OAAO,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAChE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAClD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;IAU/B,0EAA0E;IAC1E,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc;IASxD,WAAW,IAAI,YAAY;IAmB3B,OAAO,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM;IA4E3C,cAAc;IAMf,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,IAAI;IA6BjD,qBAAqB;CAqFtB"}

package/dist/PlainTextPlan.d.ts

@@ -1,2 +1,5 @@
-export declare const PlainTextPlan: import('./types').LexicalPlan<{}, "@lexical/plain-text">;
+/**
+ * A plan to register @lexical/plain-text behavior
+ */
+export declare const PlainTextPlan: import('@etrepum/lexical-builder').LexicalPlan<{}, "@lexical/plain-text">;
 //# sourceMappingURL=PlainTextPlan.d.ts.map

package/dist/PlainTextPlan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlainTextPlan.d.ts","sourceRoot":"","sources":["../src/PlainTextPlan.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,aAAa,0DAKxB,CAAC"}
+{"version":3,"file":"PlainTextPlan.d.ts","sourceRoot":"","sources":["../src/PlainTextPlan.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,eAAO,MAAM,aAAa,2EAKxB,CAAC"}

package/dist/PlanRep.d.ts

@@ -1,9 +1,13 @@
 import { LexicalBuilder } from './LexicalBuilder';
-import { AnyLexicalPlan, LexicalPlanConfig, LexicalPlanRegistry } from './types';
+import { AnyLexicalPlan, LexicalPlanConfig } from './types';
+import { LexicalPlanRegistry } from '@etrepum/lexical-builder';
 
+/**
+ * @internal
+ */
 export declare class PlanRep<Plan extends AnyLexicalPlan> {
     builder: LexicalBuilder;
-    configs: Set<LexicalPlanConfig<Plan>>;
+    configs: Set<Partial<LexicalPlanConfig<Plan>>>;
     _config?: LexicalPlanConfig<Plan>;
     plan: Plan;
     constructor(builder: LexicalBuilder, plan: Plan);

package/dist/PlanRep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlanRep.d.ts","sourceRoot":"","sources":["../src/PlanRep.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMnD,qBAAa,OAAO,CAAC,IAAI,SAAS,cAAc;IAC9C,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,EAAE,IAAI,CAAC;gBACC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI;IAK/C,aAAa,CAAC,IAAI,SAAS,MAAM,mBAAmB,EAClD,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAI3D,mBAAmB,CAAC,UAAU,SAAS,cAAc,EACnD,GAAG,EAAE,UAAU,GACd,iBAAiB,CAAC,UAAU,CAAC;IAUhC,SAAS,IAAI,iBAAiB,CAAC,IAAI,CAAC;CAcrC"}
+{"version":3,"file":"PlanRep.d.ts","sourceRoot":"","sources":["../src/PlanRep.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAMpE;;GAEG;AACH,qBAAa,OAAO,CAAC,IAAI,SAAS,cAAc;IAC9C,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,EAAE,IAAI,CAAC;gBACC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI;IAK/C,aAAa,CAAC,IAAI,SAAS,MAAM,mBAAmB,EAClD,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAI3D,mBAAmB,CAAC,UAAU,SAAS,cAAc,EACnD,GAAG,EAAE,UAAU,GACd,iBAAiB,CAAC,UAAU,CAAC;IAUhC,SAAS,IAAI,iBAAiB,CAAC,IAAI,CAAC;CAcrC"}

package/dist/RichTextPlan.d.ts

@@ -5,5 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-export declare const RichTextPlan: import('./types').LexicalPlan<{}, "@lexical/rich-text">;
+/**
+ * A plan to register @lexical/rich-text behavior and nodes
+ * ({@link HeadingNode}, {@link QuoteNode})
+ */
+export declare const RichTextPlan: import('@etrepum/lexical-builder').LexicalPlan<{}, "@lexical/rich-text">;
 //# sourceMappingURL=RichTextPlan.d.ts.map

package/dist/RichTextPlan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RichTextPlan.d.ts","sourceRoot":"","sources":["../src/RichTextPlan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,eAAO,MAAM,YAAY,yDAMvB,CAAC"}
+{"version":3,"file":"RichTextPlan.d.ts","sourceRoot":"","sources":["../src/RichTextPlan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;GAGG;AACH,eAAO,MAAM,YAAY,0EAMvB,CAAC"}

package/dist/deepThemeMergeInPlace.d.ts

@@ -5,5 +5,21 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
+/**
+ * Recursively merge the given theme configuration in-place.
+ *
+ * @returns If `a` and `b` are both objects (and `b` is not an Array) then
+ * all keys in `b` are merged into `a` then `a` is returned.
+ * Otherwise `b` is returned.
+ *
+ * @example
+ * ```ts
+ * const a = { a: "a", nested: { a: 1 } };
+ * const b = { b: "b", nested: { b: 2 } };
+ * const rval = deepThemeMergeInPlace(a, b);
+ * expect(a).toBe(rval);
+ * expect(a).toEqual({ a: "a", b: "b", nested: { a: 1, b: 2 } });
+ * ```
+ */
 export declare function deepThemeMergeInPlace(a: unknown, b: unknown): unknown;
 //# sourceMappingURL=deepThemeMergeInPlace.d.ts.map

package/dist/deepThemeMergeInPlace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepThemeMergeInPlace.d.ts","sourceRoot":"","sources":["../src/deepThemeMergeInPlace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,WAgB3D"}
+{"version":3,"file":"deepThemeMergeInPlace.d.ts","sourceRoot":"","sources":["../src/deepThemeMergeInPlace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,WAgB3D"}

package/dist/definePlan.d.ts

@@ -1,6 +1,79 @@
-import { AnyLexicalPlan, LexicalPlan, LexicalPlanConfig, PlanConfigBase } from './types';
+import { LexicalPlan, NormalizedLexicalPlanArgument, PlanConfigBase } from './types';
 
+/**
+ * Define a LexicalPlan from the given object literal. TypeScript will
+ * infer Config and Name in most cases, but you may want to use
+ * {@link safeCast} for config if there are default fields or varying types.
+ *
+ * @param plan The LexicalPlan
+ * @returns The unmodified plan argument (this is only an inference helper)
+ *
+ * @example Basic example
+ * ```ts
+ * export const MyPlan = definePlan({
+ *   // Plan names must be unique in an editor
+ *   name: "my",
+ *   // Config must be an object, but an empty object is fine
+ *   config: {},
+ *   nodes: [MyNode],
+ * });
+ * ```
+ *
+ * @example Plan with optional configuration
+ * ```ts
+ * export interface ConfigurableConfig {
+ *   optional?: string;
+ *   required: number;
+ * }
+ * export const ConfigurablePlan = definePlan({
+ *   name: "configurable",
+ *   // The Plan's config must satisfy the full config type,
+ *   // but using the Plan as a dependency never requires
+ *   // configuration and any partial of the config can be specified
+ *   config: safeCast<ConfigurableConfig>({ required: 1 }),
+ * });
+ * ```
+ */
 export declare function definePlan<Config extends PlanConfigBase, Name extends string>(plan: LexicalPlan<Config, Name>): LexicalPlan<Config, Name>;
-export declare function defineRootPlan(plan: Omit<LexicalPlan<PlanConfigBase, string>, "config" | "name">): LexicalPlan<PlanConfigBase, "[root]">;
-export declare function configPlan<Plan extends AnyLexicalPlan>(plan: Plan, config: Partial<LexicalPlanConfig<Plan>>): [Plan, Partial<LexicalPlanConfig<Plan>>];
+/**
+ * Define a LexicalPlan from the given object literal, assigning an
+ * empty config and the name "[root]". This plan must only be used
+ * at most once per editor, usually as the first argument to
+ * {@link buildEditorFromPlans}
+ *
+ * @param rootPlan A plan without the config or name properties
+ * @returns The given plan argument, after in-place assignment of config and name
+ *
+ * @example
+ * ```ts
+ * const editorHandle = buildEditorFromPlans(
+ *   defineRootPlan({
+ *     dependencies: [DragonPlan, RichTextPlan, HistoryPlan],
+ *   }),
+ * );
+ * ```
+ */
+export declare function defineRootPlan(rootPlan: Omit<LexicalPlan<PlanConfigBase, "[root]">, "config" | "name">): LexicalPlan<PlanConfigBase, "[root]">;
+/**
+ * Define a NormalizedLexicalPlanArgument from the given arguments,
+ * this is a plan and one or more config partials for that plan.
+ * Generally used in the dependencies array of another plan, or as
+ * an argument to {@link buildEditorFromPlans}
+ *
+ * @param args A plan followed by one or more config partials for that plan
+ * @returns [plan, config, ...configs]
+ *
+ * @example
+ * ```ts
+ * export const ReactDecoratorPlan = definePlan({
+ *   name: "react-decorator",
+ *   dependencies: [
+ *     configPlan(ReactPlan, {
+ *       decorators: [<ReactDecorator />]
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function configPlan<Config extends PlanConfigBase, Name extends string>(...args: NormalizedLexicalPlanArgument<Config, Name>): NormalizedLexicalPlanArgument<Config, Name>;
 //# sourceMappingURL=definePlan.d.ts.map

package/dist/definePlan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definePlan.d.ts","sourceRoot":"","sources":["../src/definePlan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB,wBAAgB,UAAU,CAAC,MAAM,SAAS,cAAc,EAAE,IAAI,SAAS,MAAM,EAC3E,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,GAC9B,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAE3B;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,GACjE,WAAW,CAAC,cAAc,EAAE,QAAQ,CAAC,CAEvC;AAED,wBAAgB,UAAU,CAAC,IAAI,SAAS,cAAc,EACpD,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,GACvC,CAAC,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAE1C"}
+{"version":3,"file":"definePlan.d.ts","sourceRoot":"","sources":["../src/definePlan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,6BAA6B,EAC7B,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAS,cAAc,EAAE,IAAI,SAAS,MAAM,EAC3E,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,GAC9B,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAE3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,GACvE,WAAW,CAAC,cAAc,EAAE,QAAQ,CAAC,CAGvC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAS,cAAc,EAAE,IAAI,SAAS,MAAM,EAC3E,GAAG,IAAI,EAAE,6BAA6B,CAAC,MAAM,EAAE,IAAI,CAAC,GACnD,6BAA6B,CAAC,MAAM,EAAE,IAAI,CAAC,CAE7C"}

package/dist/index.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-export declare const PACKAGE_VERSION: any;
+export declare const PACKAGE_VERSION: string;
 export { configPlan, definePlan, defineRootPlan } from './definePlan';
 export { LexicalBuilder, buildEditorFromPlans } from './LexicalBuilder';
 export { type AnyLexicalPlan, type AnyLexicalPlanArgument, type EditorHandle, type InitialEditorStateType, type LexicalPeerConfig, type LexicalPlan, type LexicalPlanArgument, type LexicalPlanConfig, type LexicalPlanName, type NormalizedLexicalPlanArgument, type PlanConfigBase, type RegisterState, } from './types';
@@ -16,4 +16,24 @@ export { DragonPlan } from './DragonPlan';
 export { type HistoryConfig, HistoryPlan } from './HistoryPlan';
 export { PlainTextPlan } from './PlainTextPlan';
 export { RichTextPlan } from './RichTextPlan';
+/**
+ * An open interface for Name -> Config mappings. If you are defining a
+ * plan with non-empty config and it may be used as a peerDependency then
+ * you should extend this as follows:
+ *
+ * @example Extending LexicalPlanRegistry
+ * ```ts
+ * export const SomePlan = definePlan({
+ *   name: "@some/plan",
+ *   config: { className: "default" }
+ * });
+ * declare module '@etrepum/lexical-builder' {
+ *   interface LexicalPlanRegistry {
+ *     [SomePlan.name]: typeof SomePlan;
+ *   }
+ * }
+ * ```
+ */
+export interface LexicalPlanRegistry {
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,eAAe,KAAkC,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,eAAe,EAAE,MAAwC,CAAC;AAEvE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,mBAAmB;CAAG"}

package/dist/index.js

@@ -13,11 +13,11 @@ import { HeadingNode, QuoteNode, registerRichText } from "@lexical/rich-text";
 function definePlan(plan) {
   return plan;
 }
-function defineRootPlan(plan) {
-  return { ...plan, name: "[root]", config: {} };
+function defineRootPlan(rootPlan) {
+  return Object.assign(rootPlan, { name: "[root]", config: {} });
 }
-function configPlan(plan, config) {
-  return [plan, config];
+function configPlan(...args) {
+  return args;
 }
 function invariant(cond, message, ...args) {
   if (cond) {
@@ -64,16 +64,16 @@ function initializeEditor(editor, $initialEditorState = $defaultInitializer) {
     }
   }
 }
-function shallowMergeConfig(a, b) {
-  if (!b || a === b) {
-    return a;
+function shallowMergeConfig(config, overrides) {
+  if (!overrides || config === overrides) {
+    return config;
   }
-  for (const k in b) {
-    if (b[k] !== a[k]) {
-      return { ...a, ...b };
+  for (const k in overrides) {
+    if (config[k] !== overrides[k]) {
+      return { ...config, ...overrides };
     }
   }
-  return a;
+  return config;
 }
 class PlanRep {
   constructor(builder, plan) {
@@ -156,6 +156,7 @@ class LexicalBuilder {
     this.planNameMap = /* @__PURE__ */ new Map();
     this.conflicts = /* @__PURE__ */ new Map();
   }
+  /** Look up the editor that was created by this LexicalBuilder or throw */
   static fromEditor(editor) {
     const builder = buildersForEditors.get(editor);
     invariant(
@@ -218,7 +219,12 @@ class LexicalBuilder {
       )) {
         const dep = this.planNameMap.get(depName);
         if (dep) {
-          phase = Math.max(phase, 1 + this.addPlan([dep.plan, cfg]));
+          phase = Math.max(
+            phase,
+            1 + this.addPlan(
+              configPlan(dep.plan, cfg)
+            )
+          );
         }
       }
       invariant(
@@ -409,7 +415,7 @@ const RichTextPlan = definePlan({
   nodes: [HeadingNode, QuoteNode],
   register: registerRichText
 });
-const PACKAGE_VERSION = "0.0.10-nightly.20240604.0";
+const PACKAGE_VERSION = "0.0.11";
 export {
   AutoFocusPlan,
   DragonPlan,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/definePlan.ts","../src/shared/invariant.ts","../src/deepThemeMergeInPlace.ts","../src/initializeEditor.ts","../src/shallowMergeConfig.ts","../src/PlanRep.ts","../src/LexicalBuilder.ts","../src/safeCast.ts","../src/AutoFocusPlan.ts","../src/DragonPlan.ts","../src/HistoryPlan.ts","../src/PlainTextPlan.ts","../src/RichTextPlan.ts","../src/index.ts"],"sourcesContent":["/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport type {\n  AnyLexicalPlan,\n  LexicalPlan,\n  LexicalPlanConfig,\n  PlanConfigBase,\n} from \"./types\";\n\nexport function definePlan<Config extends PlanConfigBase, Name extends string>(\n  plan: LexicalPlan<Config, Name>,\n): LexicalPlan<Config, Name> {\n  return plan;\n}\n\nexport function defineRootPlan(\n  plan: Omit<LexicalPlan<PlanConfigBase, string>, \"config\" | \"name\">,\n): LexicalPlan<PlanConfigBase, \"[root]\"> {\n  return { ...plan, name: \"[root]\", config: {} };\n}\n\nexport function configPlan<Plan extends AnyLexicalPlan>(\n  plan: Plan,\n  config: Partial<LexicalPlanConfig<Plan>>,\n): [Plan, Partial<LexicalPlanConfig<Plan>>] {\n  return [plan, config];\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\n// invariant(condition, message) will refine types based on \"condition\", and\n// if \"condition\" is false will throw an error. This function is special-cased\n// in flow itself, so we can't name it anything else.\nexport default function invariant(\n  cond?: boolean,\n  message?: string,\n  ...args: string[]\n): asserts cond {\n  if (cond) {\n    return;\n  }\n\n  throw new Error(\n    args.reduce((msg, arg) => msg.replace(\"%s\", String(arg)), message || \"\"),\n  );\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nexport function deepThemeMergeInPlace(a: unknown, b: unknown) {\n  if (\n    a &&\n    b &&\n    !Array.isArray(b) &&\n    typeof a === \"object\" &&\n    typeof b === \"object\"\n  ) {\n    const aObj = a as Record<string, unknown>;\n    const bObj = b as Record<string, unknown>;\n    for (const k in bObj) {\n      aObj[k] = deepThemeMergeInPlace(aObj[k], bObj[k]);\n    }\n    return a;\n  }\n  return b;\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport type { InitialEditorStateType } from \"./types\";\n\nimport { $createParagraphNode, $getRoot, type LexicalEditor } from \"lexical\";\n\nconst HISTORY_MERGE_OPTIONS = { tag: \"history-merge\" };\n\nfunction $defaultInitializer() {\n  const root = $getRoot();\n  if (root.isEmpty()) {\n    root.append($createParagraphNode());\n  }\n}\n\nexport function initializeEditor(\n  editor: LexicalEditor,\n  $initialEditorState: InitialEditorStateType = $defaultInitializer,\n): void {\n  switch (typeof $initialEditorState) {\n    case \"function\": {\n      editor.update(() => $initialEditorState(editor), HISTORY_MERGE_OPTIONS);\n      break;\n    }\n    case \"string\": {\n      const parsedEditorState = editor.parseEditorState($initialEditorState);\n      editor.setEditorState(parsedEditorState, HISTORY_MERGE_OPTIONS);\n      break;\n    }\n    case \"object\": {\n      if ($initialEditorState) {\n        editor.setEditorState($initialEditorState, HISTORY_MERGE_OPTIONS);\n      }\n      break;\n    }\n  }\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\nimport type { PlanConfigBase } from \"./types\";\n\nexport function shallowMergeConfig<T extends PlanConfigBase>(\n  a: T,\n  b?: Partial<T>,\n): T {\n  if (!b || a === b) {\n    return a;\n  }\n  for (const k in b) {\n    if (b[k] !== a[k]) {\n      return { ...a, ...b };\n    }\n  }\n  return a;\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport type { LexicalBuilder } from \"./LexicalBuilder\";\nimport type { AnyLexicalPlan, LexicalPlanConfig } from \"./types\";\nimport type { LexicalPlanRegistry } from \"./types\";\n\nimport invariant from \"./shared/invariant\";\n\nimport { shallowMergeConfig } from \"./shallowMergeConfig\";\n\nexport class PlanRep<Plan extends AnyLexicalPlan> {\n  builder: LexicalBuilder;\n  configs: Set<LexicalPlanConfig<Plan>>;\n  _config?: LexicalPlanConfig<Plan>;\n  plan: Plan;\n  constructor(builder: LexicalBuilder, plan: Plan) {\n    this.builder = builder;\n    this.plan = plan;\n    this.configs = new Set();\n  }\n  getPeerConfig<Name extends keyof LexicalPlanRegistry>(\n    name: string,\n  ): undefined | LexicalPlanConfig<LexicalPlanRegistry[Name]> {\n    const rep = this.builder.planNameMap.get(name);\n    return rep && rep.getConfig();\n  }\n  getDependencyConfig<Dependency extends AnyLexicalPlan>(\n    dep: Dependency,\n  ): LexicalPlanConfig<Dependency> {\n    const pair = this.builder.planMap.get(dep);\n    invariant(\n      pair !== undefined,\n      \"LexicalPlanBuilder: Plan %s missing dependency plan %s to be in registry\",\n      this.plan.name,\n      dep.name,\n    );\n    return pair[1].getConfig();\n  }\n  getConfig(): LexicalPlanConfig<Plan> {\n    if (this._config) {\n      return this._config;\n    }\n    let config = this.plan.config;\n    const mergeConfig = this.plan.mergeConfig\n      ? this.plan.mergeConfig.bind(this.plan)\n      : shallowMergeConfig;\n    for (const cfg of this.configs) {\n      config = mergeConfig(config, cfg);\n    }\n    this._config = config;\n    return config;\n  }\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\nimport type {\n  AnyLexicalPlan,\n  AnyLexicalPlanArgument,\n  EditorHandle,\n} from \"./types\";\n\nimport {\n  LexicalEditor,\n  createEditor,\n  type CreateEditorArgs,\n  type EditorThemeClasses,\n  type HTMLConfig,\n  type KlassConstructor,\n  type LexicalNode,\n} from \"lexical\";\nimport invariant from \"./shared/invariant\";\n\nimport { deepThemeMergeInPlace } from \"./deepThemeMergeInPlace\";\nimport { initializeEditor } from \"./initializeEditor\";\nimport { PlanRep } from \"./PlanRep\";\nimport { mergeRegister } from \"@lexical/utils\";\n\nconst buildersForEditors = new WeakMap<LexicalEditor, LexicalBuilder>();\n\nexport function buildEditorFromPlans(\n  plan: AnyLexicalPlanArgument,\n  ...plans: AnyLexicalPlanArgument[]\n): EditorHandle {\n  const builder = new LexicalBuilder();\n  builder.addPlan(plan);\n  for (const otherPlan of plans) {\n    builder.addPlan(otherPlan);\n  }\n  return builder.buildEditor();\n}\n\nfunction noop() {}\nclass DisposableEditorHandle implements EditorHandle {\n  editor: LexicalEditor;\n  dispose: () => void;\n  constructor(editor: LexicalEditor, dispose: () => void) {\n    this.editor = editor;\n    this.dispose = () => {\n      try {\n        dispose();\n      } finally {\n        this.dispose = noop;\n      }\n    };\n  }\n  // This should be safe even if the runtime doesn't have Symbol.dispose\n  // because it will just be `handle[undefined] = dispose;`\n  [Symbol.dispose]() {\n    this.dispose();\n  }\n}\n\nfunction defaultOnError(err: Error) {\n  throw err;\n}\n\n/** @internal */\nexport class LexicalBuilder {\n  phases: Map<AnyLexicalPlan, PlanRep<AnyLexicalPlan>>[];\n  planMap: Map<AnyLexicalPlan, [number, PlanRep<AnyLexicalPlan>]>;\n  planNameMap: Map<string, PlanRep<AnyLexicalPlan>>;\n  conflicts: Map<string, string>;\n\n  constructor() {\n    // closure compiler can't handle class initializers\n    this.phases = [new Map()];\n    this.planMap = new Map();\n    this.planNameMap = new Map();\n    this.conflicts = new Map();\n  }\n\n  static fromEditor(editor: LexicalEditor): LexicalBuilder {\n    const builder = buildersForEditors.get(editor);\n    invariant(\n      builder !== undefined,\n      \"LexicalBuilder.fromEditor: editor was not created with this version of LexicalBuilder\",\n    );\n    return builder;\n  }\n\n  buildEditor(): EditorHandle {\n    const { $initialEditorState, onError, ...editorConfig } =\n      this.buildCreateEditorArgs();\n    const editor = createEditor({\n      ...editorConfig,\n      ...(onError ? { onError: (err) => onError(err, editor) } : {}),\n    });\n    initializeEditor(editor, $initialEditorState);\n    buildersForEditors.set(editor, this);\n    return new DisposableEditorHandle(\n      editor,\n      mergeRegister(\n        () => buildersForEditors.delete(editor),\n        () => editor.setRootElement(null),\n        this.registerEditor(editor),\n      ),\n    );\n  }\n\n  addPlan(arg: AnyLexicalPlanArgument): number {\n    let plan: AnyLexicalPlan;\n    let configs: unknown[];\n    if (Array.isArray(arg)) {\n      [plan, ...configs] = arg;\n    } else {\n      plan = arg;\n      configs = [];\n    }\n    let [phase, planRep] = this.planMap.get(plan) || [0, undefined];\n    if (!planRep) {\n      const hasConflict = this.conflicts.get(plan.name);\n      if (typeof hasConflict === \"string\") {\n        invariant(\n          false,\n          \"LexicalBuilder: plan %s conflicts with %s\",\n          plan.name,\n          hasConflict,\n        );\n      }\n      for (const name of plan.conflictsWith || []) {\n        invariant(\n          !this.planNameMap.has(name),\n          \"LexicalBuilder: plan %s conflicts with %s\",\n          plan.name,\n          name,\n        );\n        this.conflicts.set(name, plan.name);\n      }\n      // TODO detect circular dependencies\n      for (const dep of plan.dependencies || []) {\n        phase = Math.max(phase, 1 + this.addPlan(dep));\n      }\n      for (const [depName, cfg] of Object.entries(\n        plan.peerDependencies || {},\n      )) {\n        const dep = this.planNameMap.get(depName);\n        if (dep) {\n          phase = Math.max(phase, 1 + this.addPlan([dep.plan, cfg]));\n        }\n      }\n      invariant(\n        this.phases.length >= phase,\n        \"LexicalBuilder: Expected phase to be no greater than phases.length\",\n      );\n      if (this.phases.length === phase) {\n        this.phases.push(new Map());\n      }\n      planRep = new PlanRep(this, plan);\n      invariant(\n        !this.planNameMap.has(plan.name),\n        \"LexicalBuilder: Multiple plans registered with name %s, names must be unique\",\n        plan.name,\n      );\n      this.planMap.set(plan, [phase, planRep]);\n      this.planNameMap.set(plan.name, planRep);\n      const currentPhaseMap = this.phases[phase];\n      invariant(\n        currentPhaseMap !== undefined,\n        \"LexicalBuilder: Expecting phase map for phase %s\",\n        String(phase),\n      );\n      currentPhaseMap.set(plan, planRep);\n    }\n    for (const config of configs) {\n      planRep.configs.add(config);\n    }\n    return phase;\n  }\n\n  *sortedPlanReps() {\n    for (const phase of this.phases) {\n      yield* phase.values();\n    }\n  }\n\n  registerEditor(editor: LexicalEditor): () => void {\n    const cleanups: (() => void)[] = [];\n    const controller = new AbortController();\n    for (const planRep of this.sortedPlanReps()) {\n      if (planRep.plan.register) {\n        cleanups.push(\n          planRep.plan.register(editor, planRep.getConfig(), {\n            getDependencyConfig: planRep.getDependencyConfig.bind(planRep),\n            getPeerConfig: planRep.getPeerConfig.bind(planRep),\n            signal: controller.signal,\n          }),\n        );\n      }\n    }\n    return () => {\n      for (let i = cleanups.length - 1; i >= 0; i--) {\n        const cleanupFun = cleanups[i];\n        invariant(\n          cleanupFun !== undefined,\n          \"LexicalBuilder: Expecting cleanups[%s] to be defined\",\n          String(i),\n        );\n        cleanupFun();\n      }\n      cleanups.length = 0;\n      controller.abort();\n    };\n  }\n\n  buildCreateEditorArgs() {\n    const config: Pick<\n      CreateEditorArgs,\n      \"nodes\" | \"html\" | \"theme\" | \"disableEvents\" | \"editable\" | \"namespace\"\n    > &\n      Pick<AnyLexicalPlan, \"$initialEditorState\" | \"onError\"> = {\n        // Prefer throwing errors rather than console.error by default\n        onError: defaultOnError\n      };\n    const nodes = new Set<NonNullable<CreateEditorArgs[\"nodes\"]>[number]>();\n    const replacedNodes = new Map<\n      KlassConstructor<typeof LexicalNode>,\n      PlanRep<AnyLexicalPlan>\n    >();\n    const htmlExport: NonNullable<HTMLConfig[\"export\"]> = new Map();\n    const htmlImport: NonNullable<HTMLConfig[\"import\"]> = {};\n    const theme: EditorThemeClasses = {};\n    for (const planRep of this.sortedPlanReps()) {\n      const { plan } = planRep;\n      if (plan.onError !== undefined) {\n        config.onError = plan.onError;\n      }\n      if (plan.disableEvents !== undefined) {\n        config.disableEvents = plan.disableEvents;\n      }\n      if (plan.editable !== undefined) {\n        config.editable = plan.editable;\n      }\n      if (plan.namespace !== undefined) {\n        config.namespace = plan.namespace;\n      }\n      if (plan.$initialEditorState !== undefined) {\n        config.$initialEditorState = plan.$initialEditorState;\n      }\n      if (plan.nodes) {\n        for (const node of plan.nodes) {\n          if (typeof node !== \"function\") {\n            const conflictPlan = replacedNodes.get(node.replace);\n            if (conflictPlan) {\n              invariant(\n                false,\n                \"LexicalBuilder: Plan %s can not register replacement for node %s because %s already did\",\n                plan.name,\n                node.replace.name,\n                conflictPlan.plan.name,\n              );\n            }\n            replacedNodes.set(node.replace, planRep);\n          }\n          nodes.add(node);\n        }\n      }\n      if (plan.html) {\n        if (plan.html.export) {\n          for (const [k, v] of plan.html.export.entries()) {\n            htmlExport.set(k, v);\n          }\n        }\n        if (plan.html.import) {\n          Object.assign(htmlImport, plan.html.import);\n        }\n      }\n      if (plan.theme) {\n        deepThemeMergeInPlace(theme, plan.theme);\n      }\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    if (Object.keys(theme).length > 0) {\n      config.theme = theme;\n    }\n    if (nodes.size) {\n      config.nodes = [...nodes];\n    }\n    const hasImport = Object.keys(htmlImport).length > 0;\n    const hasExport = htmlExport.size > 0;\n    if (hasImport || hasExport) {\n      config.html = {};\n      if (hasImport) {\n        config.html.import = htmlImport;\n      }\n      if (hasExport) {\n        config.html.export = htmlExport;\n      }\n    }\n    return config;\n  }\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\n/**\n * Explicitly and safely cast a value to a specific type when inference or\n * satisfies isn't going to work as expected (often useful for the config\n * property with definePlan)\n */\nexport function safeCast<T>(value: T): T {\n  return value;\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport { definePlan } from \"./definePlan\";\nimport { safeCast } from \"./safeCast\";\n\nimport type {} from \"@etrepum/lexical-builder\";\ndeclare module \"@etrepum/lexical-builder\" {\n  interface LexicalPlanRegistry {\n    [AutoFocusPlan.name]: typeof AutoFocusPlan;\n  }\n}\n\nexport interface AutoFocusConfig {\n  defaultSelection?: \"rootStart\" | \"rootEnd\";\n}\n\nexport const AutoFocusPlan = definePlan({\n  config: safeCast<AutoFocusConfig>({}),\n  name: \"@etrepum/lexical-builder/AutoFocusPlan\",\n  register(editor, { defaultSelection }) {\n    return editor.registerRootListener((rootElement) => {\n      editor.focus(\n        () => {\n          // If we try and move selection to the same point with setBaseAndExtent, it won't\n          // trigger a re-focus on the element. So in the case this occurs, we'll need to correct it.\n          // Normally this is fine, Selection API !== Focus API, but fore the intents of the naming\n          // of this plugin, which should preserve focus too.\n          const activeElement = document.activeElement;\n          if (\n            rootElement !== null &&\n            (activeElement === null || !rootElement.contains(activeElement))\n          ) {\n            // Note: preventScroll won't work in Webkit.\n            rootElement.focus({ preventScroll: true });\n          }\n        },\n        { defaultSelection }\n      );\n    });\n  },\n});\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport { registerDragonSupport } from \"@lexical/dragon\";\n\nimport { definePlan } from \"./definePlan\";\n\nexport const DragonPlan = definePlan({\n  config: {},\n  name: \"@lexical/dragon\",\n  register: registerDragonSupport,\n});\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\nimport {\n  createEmptyHistoryState,\n  type HistoryState,\n  registerHistory,\n} from \"@lexical/history\";\n\nimport { definePlan } from \"./definePlan\";\nimport { safeCast } from \"./safeCast\";\n\nimport type {} from \"@etrepum/lexical-builder\";\ndeclare module \"@etrepum/lexical-builder\" {\n  interface LexicalPlanRegistry {\n    [HistoryPlan.name]: typeof HistoryPlan;\n  }\n}\n\nexport interface HistoryConfig {\n  delay: number;\n  createInitialHistoryState: () => HistoryState;\n}\n\nexport const HistoryPlan = definePlan({\n  config: safeCast<HistoryConfig>({\n    createInitialHistoryState: createEmptyHistoryState,\n    delay: 300,\n  }),\n  name: \"@etrepum/lexical-builder/HistoryPlan\",\n  register(editor, { delay, createInitialHistoryState }) {\n    return registerHistory(editor, createInitialHistoryState(), delay);\n  },\n});\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\nimport { registerPlainText } from \"@lexical/plain-text\";\n\nimport { definePlan } from \"./definePlan\";\n\nexport const PlainTextPlan = definePlan({\n  config: {},\n  conflictsWith: [\"@lexical/rich-text\"],\n  name: \"@lexical/plain-text\",\n  register: registerPlainText,\n});\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport { HeadingNode, QuoteNode, registerRichText } from \"@lexical/rich-text\";\n\nimport { definePlan } from \"./definePlan\";\n\nexport const RichTextPlan = definePlan({\n  config: {},\n  conflictsWith: [\"@lexical/plain-text\"],\n  name: \"@lexical/rich-text\",\n  nodes: [HeadingNode, QuoteNode],\n  register: registerRichText,\n});\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nexport const PACKAGE_VERSION = import.meta.env.PACKAGE_VERSION;\n\nexport { configPlan, definePlan, defineRootPlan } from \"./definePlan\";\nexport { LexicalBuilder, buildEditorFromPlans } from \"./LexicalBuilder\";\nexport {\n  type AnyLexicalPlan,\n  type AnyLexicalPlanArgument,\n  type EditorHandle,\n  type InitialEditorStateType,\n  type LexicalPeerConfig,\n  type LexicalPlan,\n  type LexicalPlanArgument,\n  type LexicalPlanConfig,\n  type LexicalPlanName,\n  type NormalizedLexicalPlanArgument,\n  type PlanConfigBase,\n  type RegisterState,\n} from \"./types\";\nexport { safeCast } from \"./safeCast\";\nexport { shallowMergeConfig } from \"./shallowMergeConfig\";\n// These plan definitions should all be colocated with their implementations, only here for convenience\nexport { type AutoFocusConfig, AutoFocusPlan } from \"./AutoFocusPlan\";\nexport { DragonPlan } from \"./DragonPlan\";\nexport { type HistoryConfig, HistoryPlan } from \"./HistoryPlan\";\nexport { PlainTextPlan } from \"./PlainTextPlan\";\nexport { RichTextPlan } from \"./RichTextPlan\";\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/definePlan.ts","../src/shared/invariant.ts","../src/deepThemeMergeInPlace.ts","../src/initializeEditor.ts","../src/shallowMergeConfig.ts","../src/PlanRep.ts","../src/LexicalBuilder.ts","../src/safeCast.ts","../src/AutoFocusPlan.ts","../src/DragonPlan.ts","../src/HistoryPlan.ts","../src/PlainTextPlan.ts","../src/RichTextPlan.ts","../src/index.ts"],"sourcesContent":["/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport type {\n  LexicalPlan,\n  NormalizedLexicalPlanArgument,\n  PlanConfigBase,\n} from \"./types\";\n\n/**\n * Define a LexicalPlan from the given object literal. TypeScript will\n * infer Config and Name in most cases, but you may want to use\n * {@link safeCast} for config if there are default fields or varying types.\n *\n * @param plan The LexicalPlan\n * @returns The unmodified plan argument (this is only an inference helper)\n *\n * @example Basic example\n * ```ts\n * export const MyPlan = definePlan({\n *   // Plan names must be unique in an editor\n *   name: \"my\",\n *   // Config must be an object, but an empty object is fine\n *   config: {},\n *   nodes: [MyNode],\n * });\n * ```\n *\n * @example Plan with optional configuration\n * ```ts\n * export interface ConfigurableConfig {\n *   optional?: string;\n *   required: number;\n * }\n * export const ConfigurablePlan = definePlan({\n *   name: \"configurable\",\n *   // The Plan's config must satisfy the full config type,\n *   // but using the Plan as a dependency never requires\n *   // configuration and any partial of the config can be specified\n *   config: safeCast<ConfigurableConfig>({ required: 1 }),\n * });\n * ```\n */\nexport function definePlan<Config extends PlanConfigBase, Name extends string>(\n  plan: LexicalPlan<Config, Name>,\n): LexicalPlan<Config, Name> {\n  return plan;\n}\n\n/**\n * Define a LexicalPlan from the given object literal, assigning an\n * empty config and the name \"[root]\". This plan must only be used\n * at most once per editor, usually as the first argument to\n * {@link buildEditorFromPlans}\n *\n * @param rootPlan A plan without the config or name properties\n * @returns The given plan argument, after in-place assignment of config and name\n *\n * @example\n * ```ts\n * const editorHandle = buildEditorFromPlans(\n *   defineRootPlan({\n *     dependencies: [DragonPlan, RichTextPlan, HistoryPlan],\n *   }),\n * );\n * ```\n */\nexport function defineRootPlan(\n  rootPlan: Omit<LexicalPlan<PlanConfigBase, \"[root]\">, \"config\" | \"name\">,\n): LexicalPlan<PlanConfigBase, \"[root]\"> {\n  // @ts-ignore\n  return Object.assign(rootPlan, { name: \"[root]\", config: {} }) as any;\n}\n\n/**\n * Define a NormalizedLexicalPlanArgument from the given arguments,\n * this is a plan and one or more config partials for that plan.\n * Generally used in the dependencies array of another plan, or as\n * an argument to {@link buildEditorFromPlans}\n *\n * @param args A plan followed by one or more config partials for that plan\n * @returns [plan, config, ...configs]\n *\n * @example\n * ```ts\n * export const ReactDecoratorPlan = definePlan({\n *   name: \"react-decorator\",\n *   dependencies: [\n *     configPlan(ReactPlan, {\n *       decorators: [<ReactDecorator />]\n *     }),\n *   ],\n * });\n * ```\n */\nexport function configPlan<Config extends PlanConfigBase, Name extends string>(\n  ...args: NormalizedLexicalPlanArgument<Config, Name>\n): NormalizedLexicalPlanArgument<Config, Name> {\n  return args;\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\n// invariant(condition, message) will refine types based on \"condition\", and\n// if \"condition\" is false will throw an error. This function is special-cased\n// in flow itself, so we can't name it anything else.\nexport default function invariant(\n  cond?: boolean,\n  message?: string,\n  ...args: string[]\n): asserts cond {\n  if (cond) {\n    return;\n  }\n\n  throw new Error(\n    args.reduce((msg, arg) => msg.replace(\"%s\", String(arg)), message || \"\"),\n  );\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\n/**\n * Recursively merge the given theme configuration in-place.\n *\n * @returns If `a` and `b` are both objects (and `b` is not an Array) then\n * all keys in `b` are merged into `a` then `a` is returned.\n * Otherwise `b` is returned.\n *\n * @example\n * ```ts\n * const a = { a: \"a\", nested: { a: 1 } };\n * const b = { b: \"b\", nested: { b: 2 } };\n * const rval = deepThemeMergeInPlace(a, b);\n * expect(a).toBe(rval);\n * expect(a).toEqual({ a: \"a\", b: \"b\", nested: { a: 1, b: 2 } });\n * ```\n */\nexport function deepThemeMergeInPlace(a: unknown, b: unknown) {\n  if (\n    a &&\n    b &&\n    !Array.isArray(b) &&\n    typeof a === \"object\" &&\n    typeof b === \"object\"\n  ) {\n    const aObj = a as Record<string, unknown>;\n    const bObj = b as Record<string, unknown>;\n    for (const k in bObj) {\n      aObj[k] = deepThemeMergeInPlace(aObj[k], bObj[k]);\n    }\n    return a;\n  }\n  return b;\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport type { InitialEditorStateType } from \"./types\";\n\nimport { $createParagraphNode, $getRoot, type LexicalEditor } from \"lexical\";\n\nconst HISTORY_MERGE_OPTIONS = { tag: \"history-merge\" };\n\nfunction $defaultInitializer() {\n  const root = $getRoot();\n  if (root.isEmpty()) {\n    root.append($createParagraphNode());\n  }\n}\n\nexport function initializeEditor(\n  editor: LexicalEditor,\n  $initialEditorState: InitialEditorStateType = $defaultInitializer,\n): void {\n  switch (typeof $initialEditorState) {\n    case \"function\": {\n      editor.update(() => $initialEditorState(editor), HISTORY_MERGE_OPTIONS);\n      break;\n    }\n    case \"string\": {\n      const parsedEditorState = editor.parseEditorState($initialEditorState);\n      editor.setEditorState(parsedEditorState, HISTORY_MERGE_OPTIONS);\n      break;\n    }\n    case \"object\": {\n      if ($initialEditorState) {\n        editor.setEditorState($initialEditorState, HISTORY_MERGE_OPTIONS);\n      }\n      break;\n    }\n  }\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\nimport type { PlanConfigBase } from \"./types\";\n\n/**\n * The default merge strategy for plan configuration is a shallow merge.\n *\n * @param config A full config\n * @param overrides A partial config of overrides\n * @returns config if there are no overrides, otherwise `{...config, ...overrides}`\n */\nexport function shallowMergeConfig<T extends PlanConfigBase>(\n  config: T,\n  overrides?: Partial<T>,\n): T {\n  if (!overrides || config === overrides) {\n    return config;\n  }\n  for (const k in overrides) {\n    if (config[k] !== overrides[k]) {\n      return { ...config, ...overrides };\n    }\n  }\n  return config;\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport type { LexicalBuilder } from \"./LexicalBuilder\";\nimport type { AnyLexicalPlan, LexicalPlanConfig } from \"./types\";\nimport type { LexicalPlanRegistry } from \"@etrepum/lexical-builder\";\n\nimport invariant from \"./shared/invariant\";\n\nimport { shallowMergeConfig } from \"./shallowMergeConfig\";\n\n/**\n * @internal\n */\nexport class PlanRep<Plan extends AnyLexicalPlan> {\n  builder: LexicalBuilder;\n  configs: Set<Partial<LexicalPlanConfig<Plan>>>;\n  _config?: LexicalPlanConfig<Plan>;\n  plan: Plan;\n  constructor(builder: LexicalBuilder, plan: Plan) {\n    this.builder = builder;\n    this.plan = plan;\n    this.configs = new Set();\n  }\n  getPeerConfig<Name extends keyof LexicalPlanRegistry>(\n    name: string,\n  ): undefined | LexicalPlanConfig<LexicalPlanRegistry[Name]> {\n    const rep = this.builder.planNameMap.get(name);\n    return rep && rep.getConfig();\n  }\n  getDependencyConfig<Dependency extends AnyLexicalPlan>(\n    dep: Dependency,\n  ): LexicalPlanConfig<Dependency> {\n    const pair = this.builder.planMap.get(dep);\n    invariant(\n      pair !== undefined,\n      \"LexicalPlanBuilder: Plan %s missing dependency plan %s to be in registry\",\n      this.plan.name,\n      dep.name,\n    );\n    return pair[1].getConfig();\n  }\n  getConfig(): LexicalPlanConfig<Plan> {\n    if (this._config) {\n      return this._config;\n    }\n    let config = this.plan.config;\n    const mergeConfig = this.plan.mergeConfig\n      ? this.plan.mergeConfig.bind(this.plan)\n      : shallowMergeConfig;\n    for (const cfg of this.configs) {\n      config = mergeConfig(config, cfg);\n    }\n    this._config = config;\n    return config;\n  }\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\nimport type {\n  AnyLexicalPlan,\n  AnyLexicalPlanArgument,\n  EditorHandle,\n  LexicalPlanConfig,\n} from \"./types\";\n\nimport {\n  LexicalEditor,\n  createEditor,\n  type CreateEditorArgs,\n  type EditorThemeClasses,\n  type HTMLConfig,\n  type KlassConstructor,\n  type LexicalNode,\n} from \"lexical\";\nimport invariant from \"./shared/invariant\";\n\nimport { deepThemeMergeInPlace } from \"./deepThemeMergeInPlace\";\nimport { initializeEditor } from \"./initializeEditor\";\nimport { PlanRep } from \"./PlanRep\";\nimport { mergeRegister } from \"@lexical/utils\";\nimport { configPlan } from \"./definePlan\";\n\nconst buildersForEditors = new WeakMap<LexicalEditor, LexicalBuilder>();\n\n/**\n * Build a LexicalEditor by combining together one or more plans, optionally\n * overriding some of their configuration.\n *\n * @param plan A plan argument (a plan, or a plan with config overrides)\n * @param plans Optional additional plan arguments\n * @returns An editor handle\n *\n * @example A single root plan with multiple dependencies\n * ```ts\n * const editorHandle = buildEditorFromPlans(\n *   defineRootPlan({\n *     dependencies: [\n *       RichTextPlan,\n *       configPlan(EmojiPlan, { emojiBaseUrl: \"/assets/emoji\" }),\n *     ],\n *     register: (editor: LexicalEditor) => {\n *       console.log(\"Editor Created\");\n *       return () => console.log(\"Editor Disposed\");\n *     },\n *   }),\n * );\n * ```\n * @example A very similar minimal configuration without the register hook\n * ```ts\n * const editorHandle = buildEditorFromPlans(\n *   RichTextPlan,\n *   configPlan(EmojiPlan, { emojiBaseUrl: \"/assets/emoji\" }),\n * );\n * ```\n */\nexport function buildEditorFromPlans(\n  plan: AnyLexicalPlanArgument,\n  ...plans: AnyLexicalPlanArgument[]\n): EditorHandle {\n  const builder = new LexicalBuilder();\n  builder.addPlan(plan);\n  for (const otherPlan of plans) {\n    builder.addPlan(otherPlan);\n  }\n  return builder.buildEditor();\n}\n\n/** @internal */\nfunction noop() {}\n\n/** @internal */\nclass DisposableEditorHandle implements EditorHandle {\n  editor: LexicalEditor;\n  dispose: () => void;\n  constructor(editor: LexicalEditor, dispose: () => void) {\n    this.editor = editor;\n    this.dispose = () => {\n      try {\n        dispose();\n      } finally {\n        this.dispose = noop;\n      }\n    };\n  }\n  // This should be safe even if the runtime doesn't have Symbol.dispose\n  // because it will just be `handle[undefined] = dispose;`\n  [Symbol.dispose]() {\n    this.dispose();\n  }\n}\n\n/** Throw the given Error */\nfunction defaultOnError(err: Error) {\n  throw err;\n}\n\n/** @internal */\nexport class LexicalBuilder {\n  phases: Map<AnyLexicalPlan, PlanRep<AnyLexicalPlan>>[];\n  planMap: Map<AnyLexicalPlan, [number, PlanRep<AnyLexicalPlan>]>;\n  planNameMap: Map<string, PlanRep<AnyLexicalPlan>>;\n  conflicts: Map<string, string>;\n\n  constructor() {\n    // closure compiler can't handle class initializers\n    this.phases = [new Map()];\n    this.planMap = new Map();\n    this.planNameMap = new Map();\n    this.conflicts = new Map();\n  }\n\n  /** Look up the editor that was created by this LexicalBuilder or throw */\n  static fromEditor(editor: LexicalEditor): LexicalBuilder {\n    const builder = buildersForEditors.get(editor);\n    invariant(\n      builder !== undefined,\n      \"LexicalBuilder.fromEditor: editor was not created with this version of LexicalBuilder\",\n    );\n    return builder;\n  }\n\n  buildEditor(): EditorHandle {\n    const { $initialEditorState, onError, ...editorConfig } =\n      this.buildCreateEditorArgs();\n    const editor = createEditor({\n      ...editorConfig,\n      ...(onError ? { onError: (err) => onError(err, editor) } : {}),\n    });\n    initializeEditor(editor, $initialEditorState);\n    buildersForEditors.set(editor, this);\n    return new DisposableEditorHandle(\n      editor,\n      mergeRegister(\n        () => buildersForEditors.delete(editor),\n        () => editor.setRootElement(null),\n        this.registerEditor(editor),\n      ),\n    );\n  }\n\n  addPlan(arg: AnyLexicalPlanArgument): number {\n    let plan: AnyLexicalPlan;\n    let configs: unknown[];\n    if (Array.isArray(arg)) {\n      [plan, ...configs] = arg;\n    } else {\n      plan = arg;\n      configs = [];\n    }\n    let [phase, planRep] = this.planMap.get(plan) || [0, undefined];\n    if (!planRep) {\n      const hasConflict = this.conflicts.get(plan.name);\n      if (typeof hasConflict === \"string\") {\n        invariant(\n          false,\n          \"LexicalBuilder: plan %s conflicts with %s\",\n          plan.name,\n          hasConflict,\n        );\n      }\n      for (const name of plan.conflictsWith || []) {\n        invariant(\n          !this.planNameMap.has(name),\n          \"LexicalBuilder: plan %s conflicts with %s\",\n          plan.name,\n          name,\n        );\n        this.conflicts.set(name, plan.name);\n      }\n      // TODO detect circular dependencies\n      for (const dep of plan.dependencies || []) {\n        phase = Math.max(phase, 1 + this.addPlan(dep));\n      }\n      for (const [depName, cfg] of Object.entries(\n        plan.peerDependencies || {},\n      )) {\n        const dep = this.planNameMap.get(depName);\n        if (dep) {\n          phase = Math.max(\n            phase,\n            1 +\n              this.addPlan(\n                configPlan(dep.plan, cfg as LexicalPlanConfig<typeof dep.plan>),\n              ),\n          );\n        }\n      }\n      invariant(\n        this.phases.length >= phase,\n        \"LexicalBuilder: Expected phase to be no greater than phases.length\",\n      );\n      if (this.phases.length === phase) {\n        this.phases.push(new Map());\n      }\n      planRep = new PlanRep(this, plan);\n      invariant(\n        !this.planNameMap.has(plan.name),\n        \"LexicalBuilder: Multiple plans registered with name %s, names must be unique\",\n        plan.name,\n      );\n      this.planMap.set(plan, [phase, planRep]);\n      this.planNameMap.set(plan.name, planRep);\n      const currentPhaseMap = this.phases[phase];\n      invariant(\n        currentPhaseMap !== undefined,\n        \"LexicalBuilder: Expecting phase map for phase %s\",\n        String(phase),\n      );\n      currentPhaseMap.set(plan, planRep);\n    }\n    for (const config of configs) {\n      planRep.configs.add(config as Partial<LexicalPlanConfig<AnyLexicalPlan>>);\n    }\n    return phase;\n  }\n\n  *sortedPlanReps() {\n    for (const phase of this.phases) {\n      yield* phase.values();\n    }\n  }\n\n  registerEditor(editor: LexicalEditor): () => void {\n    const cleanups: (() => void)[] = [];\n    const controller = new AbortController();\n    for (const planRep of this.sortedPlanReps()) {\n      if (planRep.plan.register) {\n        cleanups.push(\n          planRep.plan.register(editor, planRep.getConfig(), {\n            getDependencyConfig: planRep.getDependencyConfig.bind(planRep),\n            getPeerConfig: planRep.getPeerConfig.bind(planRep),\n            signal: controller.signal,\n          }),\n        );\n      }\n    }\n    return () => {\n      for (let i = cleanups.length - 1; i >= 0; i--) {\n        const cleanupFun = cleanups[i];\n        invariant(\n          cleanupFun !== undefined,\n          \"LexicalBuilder: Expecting cleanups[%s] to be defined\",\n          String(i),\n        );\n        cleanupFun();\n      }\n      cleanups.length = 0;\n      controller.abort();\n    };\n  }\n\n  buildCreateEditorArgs() {\n    const config: Pick<\n      CreateEditorArgs,\n      \"nodes\" | \"html\" | \"theme\" | \"disableEvents\" | \"editable\" | \"namespace\"\n    > &\n      Pick<AnyLexicalPlan, \"$initialEditorState\" | \"onError\"> = {\n      // Prefer throwing errors rather than console.error by default\n      onError: defaultOnError,\n    };\n    const nodes = new Set<NonNullable<CreateEditorArgs[\"nodes\"]>[number]>();\n    const replacedNodes = new Map<\n      KlassConstructor<typeof LexicalNode>,\n      PlanRep<AnyLexicalPlan>\n    >();\n    const htmlExport: NonNullable<HTMLConfig[\"export\"]> = new Map();\n    const htmlImport: NonNullable<HTMLConfig[\"import\"]> = {};\n    const theme: EditorThemeClasses = {};\n    for (const planRep of this.sortedPlanReps()) {\n      const { plan } = planRep;\n      if (plan.onError !== undefined) {\n        config.onError = plan.onError;\n      }\n      if (plan.disableEvents !== undefined) {\n        config.disableEvents = plan.disableEvents;\n      }\n      if (plan.editable !== undefined) {\n        config.editable = plan.editable;\n      }\n      if (plan.namespace !== undefined) {\n        config.namespace = plan.namespace;\n      }\n      if (plan.$initialEditorState !== undefined) {\n        config.$initialEditorState = plan.$initialEditorState;\n      }\n      if (plan.nodes) {\n        for (const node of plan.nodes) {\n          if (typeof node !== \"function\") {\n            const conflictPlan = replacedNodes.get(node.replace);\n            if (conflictPlan) {\n              invariant(\n                false,\n                \"LexicalBuilder: Plan %s can not register replacement for node %s because %s already did\",\n                plan.name,\n                node.replace.name,\n                conflictPlan.plan.name,\n              );\n            }\n            replacedNodes.set(node.replace, planRep);\n          }\n          nodes.add(node);\n        }\n      }\n      if (plan.html) {\n        if (plan.html.export) {\n          for (const [k, v] of plan.html.export.entries()) {\n            htmlExport.set(k, v);\n          }\n        }\n        if (plan.html.import) {\n          Object.assign(htmlImport, plan.html.import);\n        }\n      }\n      if (plan.theme) {\n        deepThemeMergeInPlace(theme, plan.theme);\n      }\n    }\n    if (Object.keys(theme).length > 0) {\n      config.theme = theme;\n    }\n    if (nodes.size) {\n      config.nodes = [...nodes];\n    }\n    const hasImport = Object.keys(htmlImport).length > 0;\n    const hasExport = htmlExport.size > 0;\n    if (hasImport || hasExport) {\n      config.html = {};\n      if (hasImport) {\n        config.html.import = htmlImport;\n      }\n      if (hasExport) {\n        config.html.export = htmlExport;\n      }\n    }\n    return config;\n  }\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\n/**\n * Explicitly and safely cast a value to a specific type when inference or\n * satisfies isn't going to work as expected (often useful for the config\n * property with definePlan)\n */\nexport function safeCast<T>(value: T): T {\n  return value;\n}\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport { definePlan } from \"./definePlan\";\nimport { safeCast } from \"./safeCast\";\n\nimport type {} from \"@etrepum/lexical-builder\";\ndeclare module \"@etrepum/lexical-builder\" {\n  interface LexicalPlanRegistry {\n    [AutoFocusPlan.name]: typeof AutoFocusPlan;\n  }\n}\n\nexport interface AutoFocusConfig {\n  /**\n   * Where to move the selection when the editor is focused and there is no\n   * existing selection. Can be \"rootStart\" or \"rootEnd\" (the default).\n   */\n  defaultSelection?: \"rootStart\" | \"rootEnd\";\n}\n\n/**\n * A Plan to focus the LexicalEditor when the root element is set\n * (typically only when the editor is first created).\n */\nexport const AutoFocusPlan = definePlan({\n  config: safeCast<AutoFocusConfig>({}),\n  name: \"@etrepum/lexical-builder/AutoFocusPlan\",\n  register(editor, { defaultSelection }) {\n    return editor.registerRootListener((rootElement) => {\n      editor.focus(\n        () => {\n          // If we try and move selection to the same point with setBaseAndExtent, it won't\n          // trigger a re-focus on the element. So in the case this occurs, we'll need to correct it.\n          // Normally this is fine, Selection API !== Focus API, but fore the intents of the naming\n          // of this plugin, which should preserve focus too.\n          const activeElement = document.activeElement;\n          if (\n            rootElement !== null &&\n            (activeElement === null || !rootElement.contains(activeElement))\n          ) {\n            // Note: preventScroll won't work in Webkit.\n            rootElement.focus({ preventScroll: true });\n          }\n        },\n        { defaultSelection },\n      );\n    });\n  },\n});\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport { registerDragonSupport } from \"@lexical/dragon\";\n\nimport { definePlan } from \"./definePlan\";\n\n/**\n * Add Dragon speech to text input support to the editor, via the\n * @lexical/dragon module.\n */\nexport const DragonPlan = definePlan({\n  config: {},\n  name: \"@lexical/dragon\",\n  register: registerDragonSupport,\n});\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\nimport {\n  createEmptyHistoryState,\n  type HistoryState,\n  registerHistory,\n} from \"@lexical/history\";\n\nimport { definePlan } from \"./definePlan\";\nimport { safeCast } from \"./safeCast\";\n\nimport type {} from \"@etrepum/lexical-builder\";\ndeclare module \"@etrepum/lexical-builder\" {\n  interface LexicalPlanRegistry {\n    [HistoryPlan.name]: typeof HistoryPlan;\n  }\n}\n\nexport interface HistoryConfig {\n  /**\n   * The time (in milliseconds) the editor should delay generating a new history stack,\n   * instead of merging the current changes with the current stack. The default is 300ms.\n   */\n  delay: number;\n  /**\n   * The initial history state, the default is {@link createEmptyHistoryState}.\n   */\n  createInitialHistoryState: () => HistoryState;\n}\n\n/**\n * Registers necessary listeners to manage undo/redo history stack and related\n * editor commands, via the @lexical/history module.\n */\nexport const HistoryPlan = definePlan({\n  config: safeCast<HistoryConfig>({\n    createInitialHistoryState: createEmptyHistoryState,\n    delay: 300,\n  }),\n  name: \"@etrepum/lexical-builder/HistoryPlan\",\n  register(editor, { delay, createInitialHistoryState }) {\n    return registerHistory(editor, createInitialHistoryState(), delay);\n  },\n});\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\nimport { registerPlainText } from \"@lexical/plain-text\";\n\nimport { definePlan } from \"./definePlan\";\n\n/**\n * A plan to register @lexical/plain-text behavior\n */\nexport const PlainTextPlan = definePlan({\n  config: {},\n  conflictsWith: [\"@lexical/rich-text\"],\n  name: \"@lexical/plain-text\",\n  register: registerPlainText,\n});\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nimport { HeadingNode, QuoteNode, registerRichText } from \"@lexical/rich-text\";\n\nimport { definePlan } from \"./definePlan\";\n\n/**\n * A plan to register @lexical/rich-text behavior and nodes\n * ({@link HeadingNode}, {@link QuoteNode})\n */\nexport const RichTextPlan = definePlan({\n  config: {},\n  conflictsWith: [\"@lexical/plain-text\"],\n  name: \"@lexical/rich-text\",\n  nodes: [HeadingNode, QuoteNode],\n  register: registerRichText,\n});\n","/**\n * Copyright (c) Meta Platforms, Inc. and affiliates.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n *\n */\n\nexport const PACKAGE_VERSION: string = import.meta.env.PACKAGE_VERSION;\n\nexport { configPlan, definePlan, defineRootPlan } from \"./definePlan\";\nexport { LexicalBuilder, buildEditorFromPlans } from \"./LexicalBuilder\";\nexport {\n  type AnyLexicalPlan,\n  type AnyLexicalPlanArgument,\n  type EditorHandle,\n  type InitialEditorStateType,\n  type LexicalPeerConfig,\n  type LexicalPlan,\n  type LexicalPlanArgument,\n  type LexicalPlanConfig,\n  type LexicalPlanName,\n  type NormalizedLexicalPlanArgument,\n  type PlanConfigBase,\n  type RegisterState,\n} from \"./types\";\nexport { safeCast } from \"./safeCast\";\nexport { shallowMergeConfig } from \"./shallowMergeConfig\";\n// These plan definitions should all be colocated with their implementations, only here for convenience\nexport { type AutoFocusConfig, AutoFocusPlan } from \"./AutoFocusPlan\";\nexport { DragonPlan } from \"./DragonPlan\";\nexport { type HistoryConfig, HistoryPlan } from \"./HistoryPlan\";\nexport { PlainTextPlan } from \"./PlainTextPlan\";\nexport { RichTextPlan } from \"./RichTextPlan\";\n\n/**\n * An open interface for Name -> Config mappings. If you are defining a\n * plan with non-empty config and it may be used as a peerDependency then\n * you should extend this as follows:\n *\n * @example Extending LexicalPlanRegistry\n * ```ts\n * export const SomePlan = definePlan({\n *   name: \"@some/plan\",\n *   config: { className: \"default\" }\n * });\n * declare module '@etrepum/lexical-builder' {\n *   interface LexicalPlanRegistry {\n *     [SomePlan.name]: typeof SomePlan;\n *   }\n * }\n * ```\n */\nexport interface LexicalPlanRegistry {}\n"],"names":[],"mappings":"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"}

package/dist/shallowMergeConfig.d.ts

@@ -1,4 +1,11 @@
 import { PlanConfigBase } from './types';
 
-export declare function shallowMergeConfig<T extends PlanConfigBase>(a: T, b?: Partial<T>): T;
+/**
+ * The default merge strategy for plan configuration is a shallow merge.
+ *
+ * @param config A full config
+ * @param overrides A partial config of overrides
+ * @returns config if there are no overrides, otherwise `{...config, ...overrides}`
+ */
+export declare function shallowMergeConfig<T extends PlanConfigBase>(config: T, overrides?: Partial<T>): T;
 //# sourceMappingURL=shallowMergeConfig.d.ts.map

package/dist/shallowMergeConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shallowMergeConfig.d.ts","sourceRoot":"","sources":["../src/shallowMergeConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,cAAc,EACzD,CAAC,EAAE,CAAC,EACJ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GACb,CAAC,CAUH"}
+{"version":3,"file":"shallowMergeConfig.d.ts","sourceRoot":"","sources":["../src/shallowMergeConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,cAAc,EACzD,MAAM,EAAE,CAAC,EACT,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GACrB,CAAC,CAUH"}

package/dist/types.d.ts

@@ -1,15 +1,52 @@
 import { CreateEditorArgs, EditorState, LexicalEditor } from 'lexical';
+import { LexicalPlanRegistry } from '@etrepum/lexical-builder';
 
+/**
+ * Any concrete {@link LexicalPlan}
+ */
 export type AnyLexicalPlan = LexicalPlan<any, string>;
+/**
+ * Any {@link LexicalPlan} or {@link NormalizedLexicalPlanArgument}
+ */
 export type AnyLexicalPlanArgument = LexicalPlanArgument<any, string>;
+/**
+ * The default plan configuration of an empty object
+ */
 export type PlanConfigBase = Record<never, never>;
-export type NormalizedLexicalPlanArgument<Config extends PlanConfigBase, Name extends string> = [LexicalPlan<Config, Name>, Config, ...Config[]];
+/**
+ * A tuple of [plan, configOverride, ...configOverrides]
+ */
+export type NormalizedLexicalPlanArgument<Config extends PlanConfigBase, Name extends string> = [LexicalPlan<Config, Name>, Partial<Config>, ...Partial<Config>[]];
+/**
+ * An object that the register method can use to detect unmount and access the
+ * configuration for plan dependencies
+ */
 export interface RegisterState {
+    /** An AbortSignal that is aborted when the EditorHandle is disposed */
     signal: AbortSignal;
+    /**
+     * Get the configuration of a peerDependency by name, if it exists
+     * (must be a peerDependency of this plan)
+     */
     getPeerConfig<Name extends keyof LexicalPlanRegistry>(name: string): undefined | LexicalPlanConfig<LexicalPlanRegistry[Name]>;
+    /**
+     * Get the configuration of a dependency by plan
+     * (must be a direct dependency of this plan)
+     */
     getDependencyConfig<Dependency extends AnyLexicalPlan>(dep: Dependency): LexicalPlanConfig<Dependency>;
 }
+/**
+ * A {@link LexicalPlan} or {@link NormalizedLexicalPlanArgument} (plan with config overrides)
+ */
 export type LexicalPlanArgument<Config extends PlanConfigBase, Name extends string> = LexicalPlan<Config, Name> | NormalizedLexicalPlanArgument<Config, Name>;
+/**
+ * A Plan is a composable unit of LexicalEditor configuration
+ * (nodes, theme, etc) used to create an editor, plus runtime behavior
+ * that is registered after the editor is created.
+ *
+ * A Plan may depend on other Plans, and provide functionality to other
+ * plans through its config.
+ */
 export interface LexicalPlan<Config extends PlanConfigBase = PlanConfigBase, Name extends string = string> {
     /** The name of the Plan, must be unique */
     name: Name;
@@ -22,7 +59,7 @@ export interface LexicalPlan<Config extends PlanConfigBase = PlanConfigBase, Nam
      * configure, if they are directly depended on by another Plan
      */
     peerDependencies?: {
-        [k in keyof LexicalPlanRegistry]?: LexicalPeerConfig<k>;
+        [k in keyof LexicalPlanRegistry]?: Partial<LexicalPeerConfig<k>>;
     };
     /**
      * @internal Disable root element events (for internal Meta use)
@@ -59,7 +96,7 @@ export interface LexicalPlan<Config extends PlanConfigBase = PlanConfigBase, Nam
     /**
      * The editor will catch errors that happen during updates and
      * reconciliation and call this. It defaults to
-     * `(error) => console.error(error)`.
+     * `(error) => { throw error }`.
      *
      * @param error The Error object
      * @param editor The editor that this error came from
@@ -67,23 +104,27 @@ export interface LexicalPlan<Config extends PlanConfigBase = PlanConfigBase, Nam
     onError?: (error: Error, editor: LexicalEditor) => void;
     /**
      * The initial EditorState as a JSON string, an EditorState, or a function
-     * to update the editor once.
+     * to update the editor (once).
      */
     $initialEditorState?: InitialEditorStateType;
     /**
-     * The default configuration specific to this Plan
+     * The default configuration specific to this Plan. This Config may be
+     * seen by this Plan, or any Plan that uses it as a dependency.
+     *
+     * The config may be mutated on register, this is particularly useful
+     * for vending functionality to other Plans that depend on this Plan.
      */
     config: Config;
     /**
-     * By default, Config is shallow merged `{...a, ...b}`, if your Plan
-     * requires other strategies (such as concatenating an Array) you can
-     * implement it here.
+     * By default, Config is shallow merged `{...a, ...b}` with
+     * {@link shallowMergeConfig}, if your Plan requires other strategies
+     * (such as concatenating an Array) you can implement it here.
      *
-     * @param a The current configuration
-     * @param b The partial configuration to merge
+     * @param config The current configuration
+     * @param overrides The partial configuration to merge
      * @returns The merged configuration
      */
-    mergeConfig?: (a: Config, b?: Partial<Config>) => Config;
+    mergeConfig?: (config: Config, overrides?: Partial<Config>) => Config;
     /**
      * Add behavior to the editor (register transforms, listeners, etc.) after
      * the Editor is created.
@@ -97,31 +138,39 @@ export interface LexicalPlan<Config extends PlanConfigBase = PlanConfigBase, Nam
      */
     register?: (editor: LexicalEditor, config: Config, state: RegisterState) => () => void;
 }
+/**
+ * Get the Config type of a peer Plan from {@link LexicalPlanRegistry} by
+ * name, or the empty {@link PlanConfigBase} if it is not globally registered.
+ */
 export type LexicalPeerConfig<Name extends keyof LexicalPlanRegistry | string> = [
     Name
 ] extends [keyof LexicalPlanRegistry] ? LexicalPlanRegistry[Name] : PlanConfigBase;
+/**
+ * Extract the Config type from a Plan
+ */
 export type LexicalPlanConfig<Plan extends AnyLexicalPlan> = Plan["config"];
+/**
+ * Extract the Name type from a Plan
+ */
 export type LexicalPlanName<Plan extends AnyLexicalPlan> = Plan["name"];
+/**
+ * A handle to the editor and its dispose function
+ */
 export interface EditorHandle extends Disposable {
+    /** The created editor */
     editor: LexicalEditor;
+    /**
+     * Dispose the editor and perform all clean-up
+     * (also available as Symbol.dispose via Disposable)
+     */
     dispose: () => void;
 }
-export type InitialEditorStateType = null | string | EditorState | ((editor: LexicalEditor) => void);
 /**
- * An open interface for Name -> Config mappings. If you are defining a
- * plan with non-empty config and it may be used as a peerDependency then
- * you should extend this as follows:
- *
- * @example Extending LexicalPlanRegistry
- * ```ts
- * export const SomePlan = definePlan({ name: "@some/plan", config: { className: "default" } });
- * declare module '@etrepum/lexical-builder' {
- *   interface LexicalPlanRegistry {
- *     [SomePlan.name]: typeof SomePlan;
- *   }
- * }
- * ```
+ * All of the possible ways to initialize $initialEditorState:
+ * - `null` an empty state, the default
+ * - `string` an EditorState serialized to JSON
+ * - `EditorState` an EditorState that has been deserialized already (not just parsed JSON)
+ * - `((editor: LexicalEditor) => void)` A function that is called with the editor for you to mutate it
  */
-export interface LexicalPlanRegistry {
-}
+export type InitialEditorStateType = null | string | EditorState | ((editor: LexicalEditor) => void);
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -17,7 +17,7 @@
     "test": "vitest run",
     "test:watch": "vitest"
   },
-  "version": "0.0.10-nightly.20240604.0",
+  "version": "0.0.11",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -29,13 +29,13 @@
   },
   "homepage": "https://github.com/etrepum/lexical-builder",
   "peerDependencies": {
-    "@lexical/dragon": ">=0.15.0",
-    "@lexical/history": ">=0.15.0",
-    "@lexical/plain-text": ">=0.15.0",
-    "@lexical/rich-text": ">=0.15.0",
-    "@lexical/text": ">=0.15.0",
-    "@lexical/utils": ">=0.15.0",
-    "lexical": ">=0.15.0"
+    "@lexical/dragon": ">=0.16.0",
+    "@lexical/history": ">=0.16.0",
+    "@lexical/plain-text": ">=0.16.0",
+    "@lexical/rich-text": ">=0.16.0",
+    "@lexical/text": ">=0.16.0",
+    "@lexical/utils": ">=0.16.0",
+    "lexical": ">=0.16.0"
   },
   "sideEffects": false,
   "devDependencies": {