@payloadcms/richtext-lexical 4.0.0-internal.38b7f1d → 4.0.0-internal.40de3ec

package/dist/types/builtInNodes.js

@@ -0,0 +1,203 @@
+import { withNullableJSONSchemaType } from 'payload';
+import { versionSchema } from './jsonSchemaHelpers.js';
+/**
+ * Cross-cutting Lexical types shared by every element node. Inlined into
+ * `payload-types.ts`. Must stay byte-for-byte in sync with the runtime twins
+ * in `types/nodeTypes.ts` (`LexicalElementFormat`, `LexicalElementDirection`,
+ * `SerializedLexicalElementBase`) — cross-module assignability depends on it.
+ */
+export const CORE_LEXICAL_TYPE_STRING = `/** @internal Core Lexical types — see @payloadcms/richtext-lexical. */
+export type LexicalElementFormat = 'left' | 'start' | 'center' | 'right' | 'end' | 'justify' | '';
+export type LexicalElementDirection = ('ltr' | 'rtl') | null;
+
+export interface SerializedLexicalElementBase<TChildren> {
+  children: TChildren[];
+  direction: LexicalElementDirection;
+  format: LexicalElementFormat;
+  indent: number;
+  textFormat?: number;
+  textStyle?: string;
+  version: number;
+}`;
+/**
+ * Built-in Lexical node schemas (always present regardless of feature config).
+ * Co-located with the TS source they reference — each `JSONSchemaFn` adds
+ * its helper interface(s) to `typeStringDefinitions` and returns the JSON
+ * schema for that node.
+ */ /** MUST stay byte-for-byte in sync with `LexicalTextMode` in `types/nodeTypes.ts`. */
+const LEXICAL_TEXT_MODE_TS = `export type LexicalTextMode = 'normal' | 'token' | 'segmented';`;
+/** MUST stay byte-for-byte in sync with `SerializedTextNode` in `types/nodeTypes.ts`. */
+const SERIALIZED_TEXT_NODE_TS = `export interface SerializedTextNode {
+  type: 'text';
+  detail: number;
+  format: number;
+  mode: LexicalTextMode;
+  style: string;
+  text: string;
+  version: number;
+}`;
+/** MUST stay byte-for-byte in sync with `SerializedTabNode` in `types/nodeTypes.ts`. */
+const SERIALIZED_TAB_NODE_TS = `export interface SerializedTabNode {
+  type: 'tab';
+  detail: number;
+  format: number;
+  mode: LexicalTextMode;
+  style: string;
+  text: string;
+  version: number;
+}`;
+/** MUST stay byte-for-byte in sync with `SerializedLineBreakNode` in `types/nodeTypes.ts`. */
+const SERIALIZED_LINE_BREAK_NODE_TS = `export interface SerializedLineBreakNode {
+  type: 'linebreak';
+  version: number;
+}`;
+/** MUST stay byte-for-byte in sync with `SerializedParagraphNode` in `types/nodeTypes.ts`. */
+const SERIALIZED_PARAGRAPH_NODE_TS = `export interface SerializedParagraphNode<TChildren> extends SerializedLexicalElementBase<TChildren> {
+  type: 'paragraph';
+  textFormat: number;
+  textStyle: string;
+}`;
+const textModeSchema = {
+  type: 'string',
+  enum: ['normal', 'token', 'segmented'],
+  tsType: 'LexicalTextMode'
+};
+/** Text-node `format` bitmask (Lexical text-format flags). */
+const textFormatSchema = {
+  type: 'integer',
+  description: 'Active text formats as a bitmask, OR-ed together (0 = none): bold=1, italic=2, strikethrough=4, underline=8, code=16, subscript=32, superscript=64, highlight=128, lowercase=256, uppercase=512. e.g. bold + italic = 3.'
+};
+export const textNodeJSONSchema = ({
+  typeStringDefinitions
+}) => {
+  typeStringDefinitions.add(LEXICAL_TEXT_MODE_TS);
+  typeStringDefinitions.add(SERIALIZED_TEXT_NODE_TS);
+  return {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+      type: {
+        type: 'string',
+        const: 'text'
+      },
+      detail: {
+        type: 'integer'
+      },
+      format: textFormatSchema,
+      mode: textModeSchema,
+      style: {
+        type: 'string'
+      },
+      text: {
+        type: 'string'
+      },
+      version: versionSchema
+    },
+    required: ['detail', 'format', 'mode', 'style', 'text', 'type', 'version'],
+    tsType: 'SerializedTextNode'
+  };
+};
+export const tabNodeJSONSchema = ({
+  typeStringDefinitions
+}) => {
+  typeStringDefinitions.add(LEXICAL_TEXT_MODE_TS);
+  typeStringDefinitions.add(SERIALIZED_TAB_NODE_TS);
+  return {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+      type: {
+        type: 'string',
+        const: 'tab'
+      },
+      // A tab node is fully fixed: Lexical marks it unmergeable (`detail` = IS_UNMERGEABLE = 2) and
+      // its text is a single tab. Any other `detail` makes `TabNode.setDetail` throw on load.
+      detail: {
+        const: 2,
+        description: 'Always 2 (Lexical IS_UNMERGEABLE); other values throw.'
+      },
+      format: textFormatSchema,
+      mode: textModeSchema,
+      style: {
+        type: 'string'
+      },
+      text: {
+        const: '\t',
+        description: 'Always a single tab character.'
+      },
+      version: versionSchema
+    },
+    required: ['detail', 'format', 'mode', 'style', 'text', 'type', 'version'],
+    tsType: 'SerializedTabNode'
+  };
+};
+export const lineBreakNodeJSONSchema = ({
+  typeStringDefinitions
+}) => {
+  typeStringDefinitions.add(SERIALIZED_LINE_BREAK_NODE_TS);
+  return {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+      type: {
+        type: 'string',
+        const: 'linebreak'
+      },
+      version: versionSchema
+    },
+    required: ['type', 'version'],
+    tsType: 'SerializedLineBreakNode'
+  };
+};
+export const paragraphNodeJSONSchema = ({
+  elementNodeSchema,
+  nodeUnionName,
+  typeStringDefinitions
+}) => {
+  typeStringDefinitions.add(SERIALIZED_PARAGRAPH_NODE_TS);
+  return elementNodeSchema({
+    nodeType: 'paragraph',
+    properties: {
+      textFormat: {
+        type: 'integer'
+      },
+      textStyle: {
+        type: 'string'
+      }
+    },
+    required: ['textFormat', 'textStyle'],
+    tsType: `SerializedParagraphNode<${nodeUnionName}>`
+  });
+};
+/** MUST stay byte-for-byte in sync with `LexicalRichText` in `types/nodeTypes.ts`. */
+const ROOT_NODE_TS = `/** Shape of a Lexical \`richText\` field. */
+export interface LexicalRichText<TNode> {
+  root: {
+    children: TNode[];
+    direction: LexicalElementDirection;
+    format: LexicalElementFormat;
+    indent: number;
+    type: 'root';
+    version: number;
+  };
+}`;
+export const rootNodeJSONSchema = ({
+  elementNodeSchema,
+  field,
+  nodeUnionName,
+  typeStringDefinitions
+}) => {
+  typeStringDefinitions.add(ROOT_NODE_TS);
+  return {
+    type: withNullableJSONSchemaType('object', !!field.required),
+    additionalProperties: false,
+    properties: {
+      root: elementNodeSchema({
+        nodeType: 'root'
+      })
+    },
+    required: ['root'],
+    tsType: field.required ? `LexicalRichText<${nodeUnionName}>` : `LexicalRichText<${nodeUnionName}> | null`
+  };
+};
+//# sourceMappingURL=builtInNodes.js.map

package/dist/types/builtInNodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtInNodes.js","names":["withNullableJSONSchemaType","versionSchema","CORE_LEXICAL_TYPE_STRING","LEXICAL_TEXT_MODE_TS","SERIALIZED_TEXT_NODE_TS","SERIALIZED_TAB_NODE_TS","SERIALIZED_LINE_BREAK_NODE_TS","SERIALIZED_PARAGRAPH_NODE_TS","textModeSchema","type","enum","tsType","textFormatSchema","description","textNodeJSONSchema","typeStringDefinitions","add","additionalProperties","properties","const","detail","format","mode","style","text","version","required","tabNodeJSONSchema","lineBreakNodeJSONSchema","paragraphNodeJSONSchema","elementNodeSchema","nodeUnionName","nodeType","textFormat","textStyle","ROOT_NODE_TS","rootNodeJSONSchema","field","root"],"sources":["../../src/types/builtInNodes.ts"],"sourcesContent":["import type { JSONSchema4 } from 'json-schema'\n\nimport { withNullableJSONSchemaType } from 'payload'\n\nimport type { JSONSchemaFn } from '../features/typesServer.js'\n\nimport { versionSchema } from './jsonSchemaHelpers.js'\n\n/**\n * Cross-cutting Lexical types shared by every element node. Inlined into\n * `payload-types.ts`. Must stay byte-for-byte in sync with the runtime twins\n * in `types/nodeTypes.ts` (`LexicalElementFormat`, `LexicalElementDirection`,\n * `SerializedLexicalElementBase`) — cross-module assignability depends on it.\n */\nexport const CORE_LEXICAL_TYPE_STRING = `/** @internal Core Lexical types — see @payloadcms/richtext-lexical. */\nexport type LexicalElementFormat = 'left' | 'start' | 'center' | 'right' | 'end' | 'justify' | '';\nexport type LexicalElementDirection = ('ltr' | 'rtl') | null;\n\nexport interface SerializedLexicalElementBase<TChildren> {\n  children: TChildren[];\n  direction: LexicalElementDirection;\n  format: LexicalElementFormat;\n  indent: number;\n  textFormat?: number;\n  textStyle?: string;\n  version: number;\n}`\n\n/**\n * Built-in Lexical node schemas (always present regardless of feature config).\n * Co-located with the TS source they reference — each `JSONSchemaFn` adds\n * its helper interface(s) to `typeStringDefinitions` and returns the JSON\n * schema for that node.\n */\n\n/** MUST stay byte-for-byte in sync with `LexicalTextMode` in `types/nodeTypes.ts`. */\nconst LEXICAL_TEXT_MODE_TS = `export type LexicalTextMode = 'normal' | 'token' | 'segmented';`\n\n/** MUST stay byte-for-byte in sync with `SerializedTextNode` in `types/nodeTypes.ts`. */\nconst SERIALIZED_TEXT_NODE_TS = `export interface SerializedTextNode {\n  type: 'text';\n  detail: number;\n  format: number;\n  mode: LexicalTextMode;\n  style: string;\n  text: string;\n  version: number;\n}`\n\n/** MUST stay byte-for-byte in sync with `SerializedTabNode` in `types/nodeTypes.ts`. */\nconst SERIALIZED_TAB_NODE_TS = `export interface SerializedTabNode {\n  type: 'tab';\n  detail: number;\n  format: number;\n  mode: LexicalTextMode;\n  style: string;\n  text: string;\n  version: number;\n}`\n\n/** MUST stay byte-for-byte in sync with `SerializedLineBreakNode` in `types/nodeTypes.ts`. */\nconst SERIALIZED_LINE_BREAK_NODE_TS = `export interface SerializedLineBreakNode {\n  type: 'linebreak';\n  version: number;\n}`\n\n/** MUST stay byte-for-byte in sync with `SerializedParagraphNode` in `types/nodeTypes.ts`. */\nconst SERIALIZED_PARAGRAPH_NODE_TS = `export interface SerializedParagraphNode<TChildren> extends SerializedLexicalElementBase<TChildren> {\n  type: 'paragraph';\n  textFormat: number;\n  textStyle: string;\n}`\n\nconst textModeSchema: JSONSchema4 = {\n  type: 'string',\n  enum: ['normal', 'token', 'segmented'],\n  tsType: 'LexicalTextMode',\n}\n\n/** Text-node `format` bitmask (Lexical text-format flags). */\nconst textFormatSchema: JSONSchema4 = {\n  type: 'integer',\n  description:\n    'Active text formats as a bitmask, OR-ed together (0 = none): bold=1, italic=2, strikethrough=4, underline=8, code=16, subscript=32, superscript=64, highlight=128, lowercase=256, uppercase=512. e.g. bold + italic = 3.',\n}\n\nexport const textNodeJSONSchema: JSONSchemaFn = ({ typeStringDefinitions }) => {\n  typeStringDefinitions.add(LEXICAL_TEXT_MODE_TS)\n  typeStringDefinitions.add(SERIALIZED_TEXT_NODE_TS)\n  return {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      type: { type: 'string', const: 'text' },\n      detail: { type: 'integer' },\n      format: textFormatSchema,\n      mode: textModeSchema,\n      style: { type: 'string' },\n      text: { type: 'string' },\n      version: versionSchema,\n    },\n    required: ['detail', 'format', 'mode', 'style', 'text', 'type', 'version'],\n    tsType: 'SerializedTextNode',\n  }\n}\n\nexport const tabNodeJSONSchema: JSONSchemaFn = ({ typeStringDefinitions }) => {\n  typeStringDefinitions.add(LEXICAL_TEXT_MODE_TS)\n  typeStringDefinitions.add(SERIALIZED_TAB_NODE_TS)\n  return {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      type: { type: 'string', const: 'tab' },\n      // A tab node is fully fixed: Lexical marks it unmergeable (`detail` = IS_UNMERGEABLE = 2) and\n      // its text is a single tab. Any other `detail` makes `TabNode.setDetail` throw on load.\n      detail: { const: 2, description: 'Always 2 (Lexical IS_UNMERGEABLE); other values throw.' },\n      format: textFormatSchema,\n      mode: textModeSchema,\n      style: { type: 'string' },\n      text: { const: '\\t', description: 'Always a single tab character.' },\n      version: versionSchema,\n    },\n    required: ['detail', 'format', 'mode', 'style', 'text', 'type', 'version'],\n    tsType: 'SerializedTabNode',\n  }\n}\n\nexport const lineBreakNodeJSONSchema: JSONSchemaFn = ({ typeStringDefinitions }) => {\n  typeStringDefinitions.add(SERIALIZED_LINE_BREAK_NODE_TS)\n  return {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      type: { type: 'string', const: 'linebreak' },\n      version: versionSchema,\n    },\n    required: ['type', 'version'],\n    tsType: 'SerializedLineBreakNode',\n  }\n}\n\nexport const paragraphNodeJSONSchema: JSONSchemaFn = ({\n  elementNodeSchema,\n  nodeUnionName,\n  typeStringDefinitions,\n}) => {\n  typeStringDefinitions.add(SERIALIZED_PARAGRAPH_NODE_TS)\n  return elementNodeSchema({\n    nodeType: 'paragraph',\n    properties: {\n      textFormat: { type: 'integer' },\n      textStyle: { type: 'string' },\n    },\n    required: ['textFormat', 'textStyle'],\n    tsType: `SerializedParagraphNode<${nodeUnionName}>`,\n  })\n}\n\n/** MUST stay byte-for-byte in sync with `LexicalRichText` in `types/nodeTypes.ts`. */\nconst ROOT_NODE_TS = `/** Shape of a Lexical \\`richText\\` field. */\nexport interface LexicalRichText<TNode> {\n  root: {\n    children: TNode[];\n    direction: LexicalElementDirection;\n    format: LexicalElementFormat;\n    indent: number;\n    type: 'root';\n    version: number;\n  };\n}`\n\nexport const rootNodeJSONSchema: JSONSchemaFn = ({\n  elementNodeSchema,\n  field,\n  nodeUnionName,\n  typeStringDefinitions,\n}) => {\n  typeStringDefinitions.add(ROOT_NODE_TS)\n  return {\n    type: withNullableJSONSchemaType('object', !!field.required),\n    additionalProperties: false,\n    properties: {\n      root: elementNodeSchema({\n        nodeType: 'root',\n      }),\n    },\n    required: ['root'],\n    tsType: field.required\n      ? `LexicalRichText<${nodeUnionName}>`\n      : `LexicalRichText<${nodeUnionName}> | null`,\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/{types.d.ts → types/index.d.ts}

@@ -1,22 +1,21 @@
 import type { DecoratorNode, EditorConfig, LexicalEditor, EditorConfig as LexicalEditorConfig, LexicalNode, SerializedEditorState, SerializedLexicalNode } from 'lexical';
 import type { ClientField, DefaultServerCellComponentProps, LabelFunction, PayloadComponent, RichTextAdapter, RichTextField, RichTextFieldClient, RichTextFieldClientProps, SanitizedConfig, ServerFieldBase, StaticLabel } from 'payload';
-import type { BlockComponentContextType } from './features/blocks/client/component/BlockContent.js';
+import type { BlockComponentContextType } from '../features/blocks/client/component/BlockContent.js';
 export type { BlockComponentContextType };
-import type { BlockComponentProps } from './features/blocks/client/component/index.js';
-import type { InlineBlockComponentContextType } from './features/blocks/client/componentInline/index.js';
-import type { JSXConverterArgs, JSXConverters, SerializedLexicalNodeWithParent } from './features/converters/lexicalToJSX/converter/types.js';
-import type { BaseClientFeatureProps, FeatureProviderProviderClient } from './features/typesClient.js';
-import type { FeatureProviderServer } from './features/typesServer.js';
-import type { SanitizedServerEditorConfig } from './lexical/config/types.js';
+import type { BlockComponentProps } from '../features/blocks/client/component/index.js';
+import type { InlineBlockComponentContextType } from '../features/blocks/client/componentInline/index.js';
+import type { JSXConverterArgs, JSXConverters, SerializedLexicalNodeWithParent } from '../features/converters/lexicalToJSX/converter/types.js';
+import type { BaseClientFeatureProps, FeatureProviderProviderClient } from '../features/typesClient.js';
+import type { FeatureProviderServer } from '../features/typesServer.js';
+import type { SanitizedServerEditorConfig } from '../lexical/config/types.js';
+import type { InitialLexicalFormState } from '../utilities/buildInitialState.js';
 import type { DefaultNodeTypes, SerializedBlockNode, SerializedInlineBlockNode } from './nodeTypes.js';
-import type { InitialLexicalFormState } from './utilities/buildInitialState.js';
 /**
  * Base constraint for serialized Lexical node types.
  * Used as the generic constraint for node map types.
  * Extends the base SerializedLexicalNode with optional type for flexibility.
  */
 export type SerializedNodeBase = {
-    [key: string]: unknown;
     type?: string;
 };
 export type LexicalFieldAdminProps = {
@@ -314,26 +313,26 @@ export type LexicalEditorNodeMap<TNodes extends SerializedNodeBase = DefaultNode
     }>>;
 } & {
     blocks?: {
-        [K in Extract<Extract<TNodes, {
+        [K in (Extract<TNodes, {
             type: 'block';
-        }> extends SerializedBlockNode<infer B> ? B extends {
-            blockType: string;
-        } ? B['blockType'] : never : never, string>]?: NodeMapBlockValue<Extract<TNodes, {
+        }> & SerializedBlockNode)['fields']['blockType']]?: NodeMapBlockValue<Extract<Extract<TNodes, {
             type: 'block';
-        }> extends SerializedBlockNode<infer B> ? SerializedBlockNode<Extract<B, {
-            blockType: K;
-        }>> : SerializedBlockNode>;
+        }> & SerializedBlockNode, {
+            fields: {
+                blockType: K;
+            };
+        }>>;
     };
     inlineBlocks?: {
-        [K in Extract<Extract<TNodes, {
+        [K in (Extract<TNodes, {
             type: 'inlineBlock';
-        }> extends SerializedInlineBlockNode<infer B> ? B extends {
-            blockType: string;
-        } ? B['blockType'] : never : never, string>]?: NodeMapInlineBlockValue<Extract<TNodes, {
+        }> & SerializedInlineBlockNode)['fields']['blockType']]?: NodeMapInlineBlockValue<Extract<Extract<TNodes, {
             type: 'inlineBlock';
-        }> extends SerializedInlineBlockNode<infer B> ? SerializedInlineBlockNode<Extract<B, {
-            blockType: K;
-        }>> : SerializedInlineBlockNode>;
+        }> & SerializedInlineBlockNode, {
+            fields: {
+                blockType: K;
+            };
+        }>>;
     };
     unknown?: NodeMapValue<SerializedLexicalNode>;
 };
@@ -435,8 +434,8 @@ export type LexicalRichTextFieldProps = {
      */
     featureClientImportMap?: Record<string, any>;
     featureClientSchemaMap: FeatureClientSchemaMap;
-    initialLexicalFormState: InitialLexicalFormState;
-    lexicalEditorConfig: LexicalEditorConfig | undefined;
+    initialLexicalFormState?: InitialLexicalFormState;
+    lexicalEditorConfig?: LexicalEditorConfig;
     views?: LexicalEditorViewMap;
 } & Pick<ServerFieldBase, 'permissions'> & RichTextFieldClientProps<SerializedEditorState, AdapterProps, object>;
 export type LexicalRichTextCellProps = DefaultServerCellComponentProps<RichTextFieldClient<SerializedEditorState, AdapterProps, object>, SerializedEditorState>;
@@ -448,4 +447,4 @@ export type GeneratedFeatureProviderComponent = {
     clientFeatureProps: BaseClientFeatureProps<object>;
 };
 export type LexicalRichTextField = RichTextField<SerializedEditorState, AdapterProps>;
-//# sourceMappingURL=types.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/types/index.ts"],"sourcesContent":["import type {\n  DecoratorNode,\n  EditorConfig,\n  LexicalEditor,\n  EditorConfig as LexicalEditorConfig,\n  LexicalNode,\n  SerializedEditorState,\n  SerializedLexicalNode,\n} from 'lexical'\nimport type {\n  ClientField,\n  DefaultServerCellComponentProps,\n  LabelFunction,\n  PayloadComponent,\n  RichTextAdapter,\n  RichTextField,\n  RichTextFieldClient,\n  RichTextFieldClientProps,\n  SanitizedConfig,\n  ServerFieldBase,\n  StaticLabel,\n} from 'payload'\n\nimport type { BlockComponentContextType } from '../features/blocks/client/component/BlockContent.js'\nexport type { BlockComponentContextType }\nimport type { BlockComponentProps } from '../features/blocks/client/component/index.js'\nimport type { InlineBlockComponentContextType } from '../features/blocks/client/componentInline/index.js'\nimport type {\n  JSXConverterArgs,\n  JSXConverters,\n  SerializedLexicalNodeWithParent,\n} from '../features/converters/lexicalToJSX/converter/types.js'\nimport type {\n  BaseClientFeatureProps,\n  FeatureProviderProviderClient,\n} from '../features/typesClient.js'\nimport type { FeatureProviderServer } from '../features/typesServer.js'\nimport type { SanitizedServerEditorConfig } from '../lexical/config/types.js'\nimport type { InitialLexicalFormState } from '../utilities/buildInitialState.js'\nimport type {\n  DefaultNodeTypes,\n  SerializedBlockNode,\n  SerializedInlineBlockNode,\n} from './nodeTypes.js'\n\n/**\n * Base constraint for serialized Lexical node types.\n * Used as the generic constraint for node map types.\n * Extends the base SerializedLexicalNode with optional type for flexibility.\n */\nexport type SerializedNodeBase = { type?: string }\n\nexport type LexicalFieldAdminProps = {\n  /**\n   * Controls if the add block button should be hidden. @default false\n   */\n  hideAddBlockButton?: boolean\n  /**\n   * Controls if the draggable block element should be hidden. @default false\n   */\n  hideDraggableBlockElement?: boolean\n  /**\n   * Controls if the gutter (padding to the left & gray vertical line) should be hidden. @default false\n   */\n  hideGutter?: boolean\n  /**\n   * Controls if the insert paragraph at the end button should be hidden. @default false\n   */\n  hideInsertParagraphAtEnd?: boolean\n  /**\n   * Changes the placeholder text in the editor if no content is present.\n   */\n  placeholder?: LabelFunction | StaticLabel\n}\n\nexport type LexicalFieldAdminClientProps = {\n  placeholder?: string\n} & Omit<LexicalFieldAdminProps, 'placeholder'>\n\nexport type FeaturesInput =\n  | (({\n      defaultFeatures,\n      rootFeatures,\n    }: {\n      /**\n       * This opinionated array contains all \"recommended\" default features.\n       *\n       * @Example\n       *\n       * ```ts\n       *  editor: lexicalEditor({\n       *    features: ({ defaultFeatures }) => [...defaultFeatures, FixedToolbarFeature()],\n       *  })\n       *  ```\n       */\n      defaultFeatures: FeatureProviderServer<any, any, any>[]\n      /**\n       * This array contains all features that are enabled in the root richText editor (the one defined in the payload.config.ts).\n       * If this field is the root richText editor, or if the root richText editor is not a lexical editor, this array will be empty.\n       *\n       * @Example\n       *\n       * ```ts\n       *  editor: lexicalEditor({\n       *    features: ({ rootFeatures }) => [...rootFeatures, FixedToolbarFeature()],\n       *  })\n       *  ```\n       */\n      rootFeatures: FeatureProviderServer<any, any, any>[]\n    }) => FeatureProviderServer<any, any, any>[])\n  | FeatureProviderServer<any, any, any>[]\n\ntype WithinEditorArgs = {\n  config: EditorConfig\n  editor: LexicalEditor\n  node: LexicalNode\n}\n\n/**\n *\n * @experimental - This API is experimental and may change in a minor release.\n * @internal\n */\nexport type NodeMapValue<TNode extends SerializedNodeBase = SerializedLexicalNode> = {\n  /**\n   * Provide a react component to render the node.\n   *\n   * **JSX Converter:** Always works. Takes priority over `html`.\n   *\n   * **Lexical Editor:** Only works for DecoratorNodes (renders in `decorate` method). Takes priority over `html` and `createDOM`.\n   */\n  Component?: (\n    args:\n      | ({\n          isEditor: false\n          isJSXConverter: true\n        } & JSXConverterArgs<TNode>)\n      | ({\n          isEditor: true\n          isJSXConverter: false\n          node: {\n            _originalDecorate?: (editor: LexicalEditor, config: EditorConfig) => React.ReactNode\n          } & DecoratorNode<React.ReactNode>\n        } & Omit<WithinEditorArgs, 'node'>),\n  ) => React.ReactNode\n  /**\n   * Provide a function to create the DOM element for the node.\n   *\n   * **JSX Converter:** Not used (only `Component` and `html` work).\n   *\n   * **Lexical Editor:** Always works (renders in `createDOM` method).\n   * - For ElementNodes: This is the standard way to customize rendering.\n   * - For DecoratorNodes: When combined with `html`, the DOM gets custom structure while `decorate` renders the `html` content.\n   */\n  createDOM?: (args: WithinEditorArgs) => HTMLElement\n  /**\n   * Provide HTML string or function to render the node.\n   *\n   * **JSX Converter:** Always works (ignored if `Component` is provided).\n   *\n   * **Lexical Editor behavior depends on node type:**\n   *\n   * - **ElementNodes:** `html` is used in `createDOM` to generate the DOM structure.\n   *\n   * - **DecoratorNodes (have both `createDOM` and `decorate`):**\n   *   - If only `html` is provided: `createDOM` uses `html` to create DOM, `decorate` returns `null`\n   *   - If `html` + `Component`: `createDOM` uses `html`, `decorate` uses `Component`\n   *   - If `html` + `createDOM`: Custom `createDOM` creates structure, `decorate` renders `html` content\n   *   - If `html` + `Component` + `createDOM`: Custom `createDOM` creates structure, `decorate` uses `Component` (html ignored in editor)\n   */\n  html?: (\n    args:\n      | ({\n          isEditor: false\n          isJSXConverter: true\n        } & JSXConverterArgs<TNode>)\n      | ({\n          isEditor: true\n          isJSXConverter: false\n        } & WithinEditorArgs),\n  ) => string\n}\n\ntype SharedViewMapBlockEditorProps<TNode extends SerializedBlockNode | SerializedInlineBlockNode> =\n  {\n    /**\n     * True when rendering in the admin editor.\n     */\n    isEditor: true\n    /**\n     * False when rendering in the admin editor.\n     */\n    isJSXConverter: false\n  } & Pick<BlockComponentProps<TNode['fields']>, 'className' | 'formData' | 'nodeKey'>\n\n/**\n * Props passed to a custom Block component in editor mode.\n * Use `isEditor` to discriminate between editor and JSX converter modes.\n *\n * @experimental - This API is experimental and may change in a minor release.\n */\nexport type ViewMapBlockEditorProps<TNode extends SerializedBlockNode> = {\n  /**\n   * Hook to access block UI components (BlockCollapsible, EditButton, etc.).\n   * Call this inside your component to get the context values.\n   * Passed as a prop so you don't need to import from @payloadcms/richtext-lexical/client.\n   */\n  useBlockComponentContext: () => BlockComponentContextType\n} & SharedViewMapBlockEditorProps<TNode>\n\n/**\n * Props passed to a custom Block component in editor mode.\n * Use `isEditor` to discriminate between editor and JSX converter modes.\n *\n * @experimental - This API is experimental and may change in a minor release.\n */\nexport type ViewMapInlineBlockEditorProps<TNode extends SerializedInlineBlockNode> = {\n  useInlineBlockComponentContext: () => InlineBlockComponentContextType\n} & SharedViewMapBlockEditorProps<TNode>\n\n/**\n * Props passed to a custom Block component in JSX converter mode (frontend).\n * Use `isEditor` to discriminate between editor and JSX converter modes.\n *\n * @experimental - This API is experimental and may change in a minor release.\n */\nexport type ViewMapBlockJSXConverterProps<\n  TNode extends SerializedBlockNode | SerializedInlineBlockNode =\n    | SerializedBlockNode\n    | SerializedInlineBlockNode,\n> = {\n  /**\n   * Index of this node among its siblings.\n   */\n  childIndex: number\n  /**\n   * Available JSX converters for nested content.\n   */\n  converters: JSXConverters\n  /**\n   * The block's form data (field values).\n   */\n  formData: TNode['fields']\n  /**\n   * False when rendering via JSX converter (frontend).\n   */\n  isEditor: false\n  /**\n   * True when rendering via JSX converter (frontend).\n   */\n  isJSXConverter: true\n  /**\n   * The serialized block node.\n   */\n  node: TNode\n  /**\n   * Function to convert child nodes to JSX.\n   */\n  nodesToJSX: (args: {\n    converters?: JSXConverters\n    disableIndent?: boolean | string[]\n    disableTextAlign?: boolean | string[]\n    nodes: SerializedLexicalNode[]\n    parent?: SerializedLexicalNodeWithParent\n  }) => React.ReactNode[]\n  /**\n   * The parent node in the tree.\n   */\n  parent: SerializedLexicalNodeWithParent\n}\n\n/**\n * Props passed to a custom Block component in a view map.\n * This is a discriminated union - use `isEditor` to narrow the type.\n *\n * When `isEditor` is true, you're in the admin editor with access to `blockContext`.\n * When `isEditor` is false, you're in the frontend JSX converter with `nodesToJSX`.\n *\n * @example\n * ```tsx\n * const MyBlock: React.FC<ViewMapBlockComponentProps> = (props) => {\n *   if (props.isEditor) {\n *     // Admin editor - blockContext available\n *     const { BlockCollapsible, EditButton } = props.blockContext\n *     return <BlockCollapsible>{props.formData.title}</BlockCollapsible>\n *   }\n *   // Frontend - readonly render\n *   return <div>{props.formData.title}</div>\n * }\n * ```\n *\n * @experimental - This API is experimental and may change in a minor release.\n */\nexport type ViewMapBlockComponentProps<TNode extends SerializedBlockNode = SerializedBlockNode> =\n  | ViewMapBlockEditorProps<TNode>\n  | ViewMapBlockJSXConverterProps<TNode>\n\nexport type ViewMapInlineBlockComponentProps<\n  TNode extends SerializedInlineBlockNode = SerializedInlineBlockNode,\n> = ViewMapBlockJSXConverterProps<TNode> | ViewMapInlineBlockEditorProps<TNode>\n\n/**\n *\n * @experimental - This API is experimental and may change in a minor release.\n * @internal\n */\nexport type NodeMapBlockValue<TNode extends SerializedBlockNode = SerializedBlockNode> = {\n  /**\n   * A React component that replaces the entire block, including the header/collapsible.\n   * Works for both admin editor and frontend JSX conversion.\n   *\n   * Use `isEditor` to discriminate between modes:\n   * - Editor mode: `blockContext` is available with UI components (BlockCollapsible, EditButton, etc.)\n   * - JSX converter mode: `nodesToJSX` is available for rendering nested content\n   *\n   * @example\n   * ```tsx\n   * Block: (props) => {\n   *   if (props.isEditor) {\n   *     const { BlockCollapsible } = props.blockContext\n   *     return <BlockCollapsible>{props.formData.title}</BlockCollapsible>\n   *   }\n   *   return <div>{props.formData.title}</div>\n   * }\n   * ```\n   */\n  Block?: React.FC<ViewMapBlockComponentProps<TNode>>\n  /**\n   * A React component that replaces the block label.\n   * Use `useBlockComponentContext()` hook to access block context.\n   */\n  Label?: React.FC<ViewMapBlockComponentProps<TNode>>\n} & Pick<NodeMapValue<TNode>, 'Component' | 'createDOM' | 'html'>\n\nexport type NodeMapInlineBlockValue<\n  TNode extends SerializedInlineBlockNode = SerializedInlineBlockNode,\n> = {\n  /**\n   * A React component that replaces the entire block, including the header/collapsible.\n   * Works for both admin editor and frontend JSX conversion.\n   *\n   * Use `isEditor` to discriminate between modes:\n   * - Editor mode: `blockContext` is available with UI components (BlockCollapsible, EditButton, etc.)\n   * - JSX converter mode: `nodesToJSX` is available for rendering nested content\n   *\n   * @example\n   * ```tsx\n   * InlineBlock: (props) => {\n   *   if (props.isEditor) {\n   *     const { BlockCollapsible } = props.blockContext\n   *     return <BlockCollapsible>{props.formData.title}</BlockCollapsible>\n   *   }\n   *   return <div>{props.formData.title}</div>\n   * }\n   * ```\n   */\n  Block?: React.FC<ViewMapInlineBlockComponentProps<TNode>>\n  /**\n   * A React component that replaces the block label.\n   * Use `useBlockComponentContext()` hook to access block context.\n   */\n  Label?: React.FC<ViewMapInlineBlockComponentProps<TNode>>\n} & Pick<NodeMapValue<TNode>, 'Component' | 'createDOM' | 'html'>\n\n/**\n * @experimental - This API is experimental and may change in a minor release.\n * @internal\n */\nexport type LexicalEditorNodeMap<\n  TNodes extends SerializedNodeBase =\n    | DefaultNodeTypes\n    | SerializedBlockNode<{ blockName?: null | string; blockType: string }> // need these to ensure types for blocks and inlineBlocks work if no generics are provided\n    | SerializedInlineBlockNode<{ blockName?: null | string; blockType: string }>, // need these to ensure types for blocks and inlineBlocks work if no generics are provided\n> = {\n  // The index signature must include NodeMapBlockValue in the nested blockSlug mapping because\n  // 'blocks' and 'inlineBlocks' properties use NodeMapBlockValue (which adds Block/Label props).\n  // TypeScript requires that intersection properties be assignable to index signatures.\n  [key: string]:\n    | {\n        [blockSlug: string]: NodeMapBlockValue<any> | NodeMapInlineBlockValue<any>\n      }\n    | NodeMapValue<any>\n    | undefined\n} & {\n  [nodeType in Exclude<NonNullable<TNodes['type']>, 'block' | 'inlineBlock'>]?: NodeMapValue<\n    Extract<TNodes, { type: nodeType }>\n  >\n} & {\n  blocks?: {\n    [K in (Extract<TNodes, { type: 'block' }> & SerializedBlockNode)['fields']['blockType']]?: NodeMapBlockValue<\n      Extract<Extract<TNodes, { type: 'block' }> & SerializedBlockNode, { fields: { blockType: K } }>\n    >\n  }\n  inlineBlocks?: {\n    [K in (Extract<TNodes, { type: 'inlineBlock' }> &\n      SerializedInlineBlockNode)['fields']['blockType']]?: NodeMapInlineBlockValue<\n      Extract<\n        Extract<TNodes, { type: 'inlineBlock' }> & SerializedInlineBlockNode,\n        { fields: { blockType: K } }\n      >\n    >\n  }\n  unknown?: NodeMapValue<SerializedLexicalNode>\n}\n\n/**\n * A map of views, which can be used to render the editor in different ways.\n *\n * In order to override the default view, you can add a `default` key to the map.\n *\n * @experimental - This API is experimental and may change in a minor release.\n * @internal\n */\nexport type ClientFeaturesMap = {\n  [featureKey: string]: {\n    clientFeatureProps?: BaseClientFeatureProps<Record<string, any>>\n    clientFeatureProvider?: FeatureProviderProviderClient<any, any>\n  }\n}\n\nexport type LexicalEditorViewMap<\n  TNodes extends SerializedNodeBase =\n    | DefaultNodeTypes\n    | SerializedBlockNode<{ blockName?: null | string; blockType: string }> // need these to ensure types for blocks and inlineBlocks work if no generics are provided\n    | SerializedInlineBlockNode<{ blockName?: null | string; blockType: string }>, // need these to ensure types for blocks and inlineBlocks work if no generics are provided\n> = {\n  [viewKey: string]: {\n    admin?: LexicalFieldAdminClientProps\n    /**\n     * Transform the client features for this view.\n     * Receives the full clientFeatures map and should return a (potentially modified) map.\n     * Can be used to remove features or add new ones per-view.\n     *\n     * @example Remove toolbars\n     * ```ts\n     * filterFeatures: (features) => {\n     *   const { toolbarFixed, toolbarInline, ...rest } = features\n     *   return rest\n     * }\n     * ```\n     */\n    filterFeatures?: (clientFeatures: ClientFeaturesMap) => ClientFeaturesMap\n    /**\n     * Lexical editor configuration. Can be an object or a function that receives the default config.\n     * Using a function avoids needing to import defaultEditorLexicalConfig.\n     *\n     * @example\n     * ```ts\n     * lexical: (defaultConfig) => ({\n     *   ...defaultConfig,\n     *   theme: { ...defaultConfig.theme, paragraph: 'my-paragraph' },\n     * })\n     * ```\n     */\n    lexical?: ((defaultConfig: LexicalEditorConfig) => LexicalEditorConfig) | LexicalEditorConfig\n    nodes: LexicalEditorNodeMap<TNodes>\n  }\n}\n\n/**\n * @todo rename to LexicalEditorArgs in 4.0, since these are arguments for the lexicalEditor function\n */\nexport type LexicalEditorProps = {\n  admin?: LexicalFieldAdminProps\n  features?: FeaturesInput\n  lexical?: LexicalEditorConfig\n  /**\n   * A path to a LexicalEditorViewMap, which can be used to render the editor in different ways.\n   *\n   * In order to override the default view, you can add a `default` key to the map.\n   *\n   * @experimental - This API is experimental and may change in a minor release.\n   * @internal\n   */\n  views?: PayloadComponent\n}\n\nexport type LexicalRichTextAdapter = {\n  editorConfig: SanitizedServerEditorConfig\n  features: FeatureProviderServer<any, any, any>[]\n} & RichTextAdapter<SerializedEditorState, AdapterProps>\n\nexport type LexicalRichTextAdapterProvider =\n  /**\n   * This is being called during the payload sanitization process\n   */\n  ({\n    config,\n    isRoot,\n    parentIsLocalized,\n  }: {\n    config: SanitizedConfig\n    isRoot?: boolean\n    parentIsLocalized: boolean\n  }) => Promise<LexicalRichTextAdapter>\n\nexport type SingleFeatureClientSchemaMap = {\n  [key: string]: ClientField[]\n}\nexport type FeatureClientSchemaMap = {\n  [featureKey: string]: SingleFeatureClientSchemaMap\n}\n\nexport type LexicalRichTextFieldProps = {\n  admin?: LexicalFieldAdminClientProps\n  // clientFeatures is added through the rsc field\n  clientFeatures: ClientFeaturesMap\n  /**\n   * Part of the import map that contains client components for all lexical features of this field that\n   * have been added through `feature.componentImports`.\n   */\n  featureClientImportMap?: Record<string, any>\n  featureClientSchemaMap: FeatureClientSchemaMap\n  initialLexicalFormState?: InitialLexicalFormState\n  lexicalEditorConfig?: LexicalEditorConfig // Undefined if default lexical editor config should be used\n  views?: LexicalEditorViewMap\n} & Pick<ServerFieldBase, 'permissions'> &\n  RichTextFieldClientProps<SerializedEditorState, AdapterProps, object>\n\nexport type LexicalRichTextCellProps = DefaultServerCellComponentProps<\n  RichTextFieldClient<SerializedEditorState, AdapterProps, object>,\n  SerializedEditorState\n>\n\nexport type AdapterProps = {\n  editorConfig: SanitizedServerEditorConfig\n}\n\nexport type GeneratedFeatureProviderComponent = {\n  clientFeature: FeatureProviderProviderClient<any, any>\n  clientFeatureProps: BaseClientFeatureProps<object>\n}\n\nexport type LexicalRichTextField = RichTextField<SerializedEditorState, AdapterProps>\n"],"mappings":"AAqhBA","ignoreList":[]}

package/dist/types/jsonSchemaHelpers.d.ts

@@ -0,0 +1,30 @@
+import type { JSONSchema4 } from 'json-schema';
+/** `format` property shared by every element node (Lexical `ElementFormatType`). */
+export declare const formatSchema: JSONSchema4;
+/** `direction` property shared by every element node. */
+export declare const directionSchema: JSONSchema4;
+/** `version` property shared by every Lexical node. */
+export declare const versionSchema: JSONSchema4;
+type ElementNodeSchemaOptions = {
+    nodeType: string;
+    properties?: {
+        [k: string]: JSONSchema4;
+    };
+    required?: string[];
+    /** TS helper-type expression — emitted verbatim by json-schema-to-typescript. */
+    tsType?: string;
+};
+/**
+ * Builds the JSON Schema for a Lexical element node - merges the shared
+ * element-base shape (children/direction/format/indent/version) with the
+ * node-specific bits a feature provides.
+ */
+export declare const elementNodeSchema: ({ nodeType, nodeUnionRef, properties, required, tsType, }: {
+    nodeUnionRef: JSONSchema4;
+} & ElementNodeSchemaOptions) => JSONSchema4;
+/**
+ * `elementNodeSchema` HOC type, so that features don't have to pass `nodeUnionRef` every time.
+ */
+export type ElementNodeSchemaFn = (opts: ElementNodeSchemaOptions) => JSONSchema4;
+export {};
+//# sourceMappingURL=jsonSchemaHelpers.d.ts.map

package/dist/types/jsonSchemaHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSchemaHelpers.d.ts","sourceRoot":"","sources":["../../src/types/jsonSchemaHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,oFAAoF;AACpF,eAAO,MAAM,YAAY,EAAE,WAK1B,CAAA;AAED,yDAAyD;AACzD,eAAO,MAAM,eAAe,EAAE,WAG7B,CAAA;AAED,uDAAuD;AACvD,eAAO,MAAM,aAAa,EAAE,WAG3B,CAAA;AAED,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,CAAA;IACzC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,2DAM/B;IAAE,YAAY,EAAE,WAAW,CAAA;CAAE,GAAG,wBAAwB,KAAG,WAc5D,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,wBAAwB,KAAK,WAAW,CAAA"}

package/dist/types/jsonSchemaHelpers.js

@@ -0,0 +1,58 @@
+/** `format` property shared by every element node (Lexical `ElementFormatType`). */export const formatSchema = {
+  type: 'string',
+  description: 'How this element is aligned. Empty string means no explicit alignment.',
+  enum: ['left', 'start', 'center', 'right', 'end', 'justify', ''],
+  tsType: 'LexicalElementFormat'
+};
+/** `direction` property shared by every element node. */
+export const directionSchema = {
+  oneOf: [{
+    type: 'string',
+    enum: ['ltr', 'rtl']
+  }, {
+    type: 'null'
+  }],
+  tsType: 'LexicalElementDirection'
+};
+/** `version` property shared by every Lexical node. */
+export const versionSchema = {
+  type: 'integer',
+  description: "Lexical's internal serialization version for this node type."
+};
+/**
+ * Builds the JSON Schema for a Lexical element node - merges the shared
+ * element-base shape (children/direction/format/indent/version) with the
+ * node-specific bits a feature provides.
+ */
+export const elementNodeSchema = ({
+  nodeType,
+  nodeUnionRef,
+  properties = {},
+  required = [],
+  tsType
+}) => ({
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    type: {
+      type: 'string',
+      const: nodeType
+    },
+    children: {
+      type: 'array',
+      items: nodeUnionRef
+    },
+    direction: directionSchema,
+    format: formatSchema,
+    indent: {
+      type: 'integer'
+    },
+    version: versionSchema,
+    ...properties
+  },
+  required: ['children', 'direction', 'format', 'indent', 'type', 'version', ...required],
+  ...(tsType ? {
+    tsType
+  } : {})
+});
+//# sourceMappingURL=jsonSchemaHelpers.js.map

package/dist/types/jsonSchemaHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSchemaHelpers.js","names":["formatSchema","type","description","enum","tsType","directionSchema","oneOf","versionSchema","elementNodeSchema","nodeType","nodeUnionRef","properties","required","additionalProperties","const","children","items","direction","format","indent","version"],"sources":["../../src/types/jsonSchemaHelpers.ts"],"sourcesContent":["import type { JSONSchema4 } from 'json-schema'\n\n/** `format` property shared by every element node (Lexical `ElementFormatType`). */\nexport const formatSchema: JSONSchema4 = {\n  type: 'string',\n  description: 'How this element is aligned. Empty string means no explicit alignment.',\n  enum: ['left', 'start', 'center', 'right', 'end', 'justify', ''],\n  tsType: 'LexicalElementFormat',\n}\n\n/** `direction` property shared by every element node. */\nexport const directionSchema: JSONSchema4 = {\n  oneOf: [{ type: 'string', enum: ['ltr', 'rtl'] }, { type: 'null' }],\n  tsType: 'LexicalElementDirection',\n}\n\n/** `version` property shared by every Lexical node. */\nexport const versionSchema: JSONSchema4 = {\n  type: 'integer',\n  description: \"Lexical's internal serialization version for this node type.\",\n}\n\ntype ElementNodeSchemaOptions = {\n  nodeType: string\n  properties?: { [k: string]: JSONSchema4 }\n  required?: string[]\n  /** TS helper-type expression — emitted verbatim by json-schema-to-typescript. */\n  tsType?: string\n}\n\n/**\n * Builds the JSON Schema for a Lexical element node - merges the shared\n * element-base shape (children/direction/format/indent/version) with the\n * node-specific bits a feature provides.\n */\nexport const elementNodeSchema = ({\n  nodeType,\n  nodeUnionRef,\n  properties = {},\n  required = [],\n  tsType,\n}: { nodeUnionRef: JSONSchema4 } & ElementNodeSchemaOptions): JSONSchema4 => ({\n  type: 'object',\n  additionalProperties: false,\n  properties: {\n    type: { type: 'string', const: nodeType },\n    children: { type: 'array', items: nodeUnionRef },\n    direction: directionSchema,\n    format: formatSchema,\n    indent: { type: 'integer' },\n    version: versionSchema,\n    ...properties,\n  },\n  required: ['children', 'direction', 'format', 'indent', 'type', 'version', ...required],\n  ...(tsType ? { tsType } : {}),\n})\n\n/**\n * `elementNodeSchema` HOC type, so that features don't have to pass `nodeUnionRef` every time.\n */\nexport type ElementNodeSchemaFn = (opts: ElementNodeSchemaOptions) => JSONSchema4\n"],"mappings":"AAEA,oFACA,OAAO,MAAMA,YAAA,GAA4B;EACvCC,IAAA,EAAM;EACNC,WAAA,EAAa;EACbC,IAAA,EAAM,CAAC,QAAQ,SAAS,UAAU,SAAS,OAAO,WAAW,GAAG;EAChEC,MAAA,EAAQ;AACV;AAEA;AACA,OAAO,MAAMC,eAAA,GAA+B;EAC1CC,KAAA,EAAO,CAAC;IAAEL,IAAA,EAAM;IAAUE,IAAA,EAAM,CAAC,OAAO;EAAO,GAAG;IAAEF,IAAA,EAAM;EAAO,EAAE;EACnEG,MAAA,EAAQ;AACV;AAEA;AACA,OAAO,MAAMG,aAAA,GAA6B;EACxCN,IAAA,EAAM;EACNC,WAAA,EAAa;AACf;AAUA;;;;;AAKA,OAAO,MAAMM,iBAAA,GAAoBA,CAAC;EAChCC,QAAQ;EACRC,YAAY;EACZC,UAAA,GAAa,CAAC,CAAC;EACfC,QAAA,GAAW,EAAE;EACbR;AAAM,CACmD,MAAmB;EAC5EH,IAAA,EAAM;EACNY,oBAAA,EAAsB;EACtBF,UAAA,EAAY;IACVV,IAAA,EAAM;MAAEA,IAAA,EAAM;MAAUa,KAAA,EAAOL;IAAS;IACxCM,QAAA,EAAU;MAAEd,IAAA,EAAM;MAASe,KAAA,EAAON;IAAa;IAC/CO,SAAA,EAAWZ,eAAA;IACXa,MAAA,EAAQlB,YAAA;IACRmB,MAAA,EAAQ;MAAElB,IAAA,EAAM;IAAU;IAC1BmB,OAAA,EAASb,aAAA;IACT,GAAGI;EACL;EACAC,QAAA,EAAU,CAAC,YAAY,aAAa,UAAU,UAAU,QAAQ,W,GAAcA,QAAA,CAAS;EACvF,IAAIR,MAAA,GAAS;IAAEA;EAAO,IAAI,CAAC,CAAC;AAC9B","ignoreList":[]}

package/dist/types/nodeTypes.d.ts

@@ -0,0 +1,128 @@
+import type { SerializedLexicalNode } from 'lexical';
+import type { SerializedQuoteNode } from '../features/blockquote/server/schema.js';
+import type { SerializedBlockNode, SerializedInlineBlockNode } from '../features/blocks/server/schema.js';
+import type { SerializedTableCellNode, SerializedTableNode, SerializedTableRowNode } from '../features/experimental_table/server/schema.js';
+import type { SerializedHeadingNode } from '../features/heading/server/schema.js';
+import type { SerializedHorizontalRuleNode } from '../features/horizontalRule/server/schema.js';
+import type { SerializedAutoLinkNode, SerializedLinkNode } from '../features/link/server/schema.js';
+import type { SerializedListItemNode, SerializedListNode } from '../features/lists/shared/schema.js';
+import type { SerializedRelationshipNode } from '../features/relationship/server/schema.js';
+import type { SerializedUploadNode } from '../features/upload/server/schema.js';
+/** @internal Core Lexical types — see @payloadcms/richtext-lexical. */
+export type LexicalElementFormat = '' | 'center' | 'end' | 'justify' | 'left' | 'right' | 'start';
+export type LexicalElementDirection = ('ltr' | 'rtl') | null;
+export interface SerializedLexicalElementBase<TChildren> {
+    children: TChildren[];
+    direction: LexicalElementDirection;
+    format: LexicalElementFormat;
+    indent: number;
+    textFormat?: number;
+    textStyle?: string;
+    version: number;
+}
+export type LexicalTextMode = 'normal' | 'segmented' | 'token';
+export interface SerializedTextNode {
+    detail: number;
+    format: number;
+    mode: LexicalTextMode;
+    style: string;
+    text: string;
+    type: 'text';
+    version: number;
+}
+export interface SerializedTabNode {
+    detail: number;
+    format: number;
+    mode: LexicalTextMode;
+    style: string;
+    text: string;
+    type: 'tab';
+    version: number;
+}
+export interface SerializedLineBreakNode {
+    type: 'linebreak';
+    version: number;
+}
+export interface SerializedParagraphNode<TChildren extends SerializedLexicalNode = SerializedLexicalNode> extends SerializedLexicalElementBase<TChildren> {
+    textFormat: number;
+    textStyle: string;
+    type: 'paragraph';
+}
+/** Shape of a Lexical `richText` field. */
+export interface LexicalRichText<TNode> {
+    root: {
+        children: TNode[];
+        direction: LexicalElementDirection;
+        format: LexicalElementFormat;
+        indent: number;
+        type: 'root';
+        version: number;
+    };
+}
+export type { SerializedAutoLinkNode, SerializedBlockNode, SerializedHeadingNode, SerializedHorizontalRuleNode, SerializedInlineBlockNode, SerializedLinkNode, SerializedListItemNode, SerializedListNode, SerializedQuoteNode, SerializedRelationshipNode, SerializedTableCellNode, SerializedTableNode, SerializedTableRowNode, SerializedUploadNode, };
+/** `SerializedEditorState` with nodes narrowed by `type`. No type-casting needed. */
+export type TypedEditorState<TNode extends SerializedLexicalNode = SerializedLexicalNode> = LexicalRichText<TNode>;
+/**
+ * The node union of a generated `richText` field. Pass the field type — e.g.
+ * `RichTextNodes<Post['richText']>` — to type an individual node you build for that editor (for
+ * example a single block, or a `.map()` of nodes). To build a whole editor state, prefer passing
+ * the field type straight to {@link buildEditorState}.
+ */
+export type RichTextNodes<TRichText> = NonNullable<TRichText> extends LexicalRichText<infer TNode> ? TNode : never;
+/**
+ * All node types included by default in a lexical editor. Self-recursive —
+ * each element node's `children` is `DefaultNodeTypes` again, no depth limit.
+ * To compose your own union including the defaults, see {@link WithDefaultNodes}.
+ */
+export type DefaultNodeTypes = SerializedAutoLinkNode<DefaultNodeTypes> | SerializedHeadingNode<DefaultNodeTypes> | SerializedHorizontalRuleNode | SerializedLineBreakNode | SerializedLinkNode<DefaultNodeTypes> | SerializedListItemNode<DefaultNodeTypes> | SerializedListNode<DefaultNodeTypes> | SerializedParagraphNode<DefaultNodeTypes> | SerializedQuoteNode<DefaultNodeTypes> | SerializedRelationshipNode | SerializedTabNode | SerializedTextNode | SerializedUploadNode;
+/**
+ * The built-in lexical nodes, plus your own - with your nodes threaded into every container's
+ * `children`, not just the top level. Pass your custom node(s) as the generic:
+ *
+ * ```ts
+ * type MyNodes = WithDefaultNodes<SerializedBlockNode<MyBlockData>>
+ * ```
+ *
+ * Built by flattening {@link DefaultNodeRegistry} (`Registry[keyof Registry]`); see that interface
+ * for why the node set lives in a registry instead of being written as a plain union type.
+ */
+export type WithDefaultNodes<TCustom extends SerializedLexicalNode = never> = DefaultNodeRegistry<TCustom>[keyof DefaultNodeRegistry<TCustom>];
+/** @internal Re-types an element node's `children` to the recursive node union. */
+type WithRecursiveChildren<TNode, TCustom extends SerializedLexicalNode> = {
+    children: WithDefaultNodes<TCustom>[];
+} & Omit<TNode, 'children'>;
+/**
+ * @internal The set of default nodes, generic over the user's custom node(s). {@link WithDefaultNodes}
+ * flattens it into the node union with `Registry[keyof Registry]`.
+ *
+ * Why a registry interface instead of writing the union directly? The union has to be self-referential:
+ * every element node's `children` is the same node union (so custom nodes nest inside containers too).
+ * A generic *type alias* can't reference itself that way - `type N<T> = SerializedParagraphNode<N<T>> | ...`
+ * is a `TS2456` circular reference, because instantiating a type alias resolves its type argument
+ * eagerly. An *interface* resolves its members lazily, so the self-reference inside `children: ...[]`
+ * is allowed - the recursion is legal precisely because it lives inside this interface. Reusing the
+ * real node interfaces (re-typing only `children`) keeps each entry in sync with its node's real shape.
+ */
+interface DefaultNodeRegistry<TCustom extends SerializedLexicalNode> {
+    autolink: WithRecursiveChildren<SerializedAutoLinkNode<SerializedLexicalNode>, TCustom>;
+    custom: TCustom;
+    heading: WithRecursiveChildren<SerializedHeadingNode<SerializedLexicalNode>, TCustom>;
+    horizontalrule: SerializedHorizontalRuleNode;
+    linebreak: SerializedLineBreakNode;
+    link: WithRecursiveChildren<SerializedLinkNode<SerializedLexicalNode>, TCustom>;
+    list: WithRecursiveChildren<SerializedListNode<SerializedLexicalNode>, TCustom>;
+    listitem: WithRecursiveChildren<SerializedListItemNode<SerializedLexicalNode>, TCustom>;
+    paragraph: WithRecursiveChildren<SerializedParagraphNode<SerializedLexicalNode>, TCustom>;
+    quote: WithRecursiveChildren<SerializedQuoteNode<SerializedLexicalNode>, TCustom>;
+    relationship: SerializedRelationshipNode;
+    tab: SerializedTabNode;
+    text: SerializedTextNode;
+    upload: SerializedUploadNode;
+}
+/**
+ * Like `TypedEditorState`, but pre-filled with every default node type. Pass extra node types as a
+ * generic to add your own; they're threaded into every container's `children` (via
+ * {@link WithDefaultNodes}), not just allowed at the top level.
+ */
+export type DefaultTypedEditorState<TAdditionalNodeTypes extends null | SerializedLexicalNode = null> = TypedEditorState<WithDefaultNodes<NonNullable<TAdditionalNodeTypes>>>;
+//# sourceMappingURL=nodeTypes.d.ts.map

package/dist/types/nodeTypes.d.ts.map

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

package/dist/types/nodeTypes.js

@@ -0,0 +1,6 @@
+/**
+ * Like `TypedEditorState`, but pre-filled with every default node type. Pass extra node types as a
+ * generic to add your own; they're threaded into every container's `children` (via
+ * {@link WithDefaultNodes}), not just allowed at the top level.
+ */export {};
+//# sourceMappingURL=nodeTypes.js.map