@payloadcms/richtext-lexical 3.0.0-canary.a192632 → 3.0.0-canary.a5aaf21

package/dist/index.js

@@ -1,6 +1,4 @@
-import { fileURLToPath } from 'node:url';
-import path from 'path';
-import { afterChangeTraverseFields, afterReadTraverseFields, beforeChangeTraverseFields, beforeValidateTraverseFields, deepCopyObject, deepCopyObjectSimple, getDependencies, withNullableJSONSchemaType } from 'payload';
+import { afterChangeTraverseFields, afterReadTraverseFields, beforeChangeTraverseFields, beforeValidateTraverseFields, checkDependencies, deepCopyObject, deepCopyObjectSimple, withNullableJSONSchemaType } from 'payload';
 import { i18n } from './i18n.js';
 import { defaultEditorConfig, defaultEditorFeatures } from './lexical/config/server/default.js';
 import { loadFeatures } from './lexical/config/server/loader.js';
@@ -11,452 +9,511 @@ import { getGenerateSchemaMap } from './utilities/generateSchemaMap.js';
 import { recurseNodeTree } from './utilities/recurseNodeTree.js';
 import { richTextValidateHOC } from './validate/index.js';
 let defaultSanitizedServerEditorConfig = null;
-const filename = fileURLToPath(import.meta.url);
-const dirname = path.dirname(filename);
+let checkedDependencies = false;
 export function lexicalEditor(props) {
-    return async ({ config, isRoot })=>{
-        if (process.env.NODE_ENV !== 'production') {
-            const resolvedDependencies = await getDependencies(dirname, [
-                'lexical',
-                '@lexical/headless',
-                '@lexical/link',
-                '@lexical/list',
-                '@lexical/mark',
-                '@lexical/markdown',
-                '@lexical/react',
-                '@lexical/rich-text',
-                '@lexical/selection',
-                '@lexical/utils'
-            ]);
-            // Go through each resolved dependency. If any dependency has a mismatching version, throw an error
-            const foundVersions = {};
-            for (const [_pkg, { version }] of resolvedDependencies.resolved){
-                if (!Object.keys(foundVersions).includes(version)) {
-                    foundVersions[version] = _pkg;
+  return async ({
+    config,
+    isRoot,
+    parentIsLocalized
+  }) => {
+    if (process.env.NODE_ENV !== 'production' && process.env.PAYLOAD_DISABLE_DEPENDENCY_CHECKER !== 'true' && !checkedDependencies) {
+      checkedDependencies = true;
+      await checkDependencies({
+        dependencyGroups: [{
+          name: 'lexical',
+          dependencies: ['lexical', '@lexical/headless', '@lexical/link', '@lexical/list', '@lexical/mark', '@lexical/markdown', '@lexical/react', '@lexical/rich-text', '@lexical/selection', '@lexical/utils'],
+          targetVersion: '0.17.0'
+        }]
+      });
+    }
+    let features = [];
+    let resolvedFeatureMap;
+    let finalSanitizedEditorConfig // For server only
+    ;
+    if (!props || !props.features && !props.lexical) {
+      if (!defaultSanitizedServerEditorConfig) {
+        defaultSanitizedServerEditorConfig = await sanitizeServerEditorConfig(defaultEditorConfig, config, parentIsLocalized);
+        features = deepCopyObject(defaultEditorFeatures);
+      }
+      finalSanitizedEditorConfig = deepCopyObject(defaultSanitizedServerEditorConfig);
+      resolvedFeatureMap = finalSanitizedEditorConfig.resolvedFeatureMap;
+    } else {
+      const rootEditor = config.editor;
+      let rootEditorFeatures = [];
+      if (typeof rootEditor === 'object' && 'features' in rootEditor) {
+        rootEditorFeatures = rootEditor.features;
+      }
+      features = props.features && typeof props.features === 'function' ? props.features({
+        defaultFeatures: deepCopyObject(defaultEditorFeatures),
+        rootFeatures: rootEditorFeatures
+      }) : props.features;
+      if (!features) {
+        features = deepCopyObject(defaultEditorFeatures);
+      }
+      const lexical = props.lexical ?? deepCopyObjectSimple(defaultEditorConfig.lexical);
+      resolvedFeatureMap = await loadFeatures({
+        config,
+        isRoot,
+        parentIsLocalized,
+        unSanitizedEditorConfig: {
+          features,
+          lexical
+        }
+      });
+      finalSanitizedEditorConfig = {
+        features: sanitizeServerFeatures(resolvedFeatureMap),
+        lexical,
+        resolvedFeatureMap
+      };
+    }
+    const featureI18n = finalSanitizedEditorConfig.features.i18n;
+    for (const lang in i18n) {
+      if (!featureI18n[lang]) {
+        featureI18n[lang] = {
+          lexical: {}
+        };
+      }
+      featureI18n[lang].lexical.general = i18n[lang];
+    }
+    return {
+      CellComponent: {
+        clientProps: {
+          admin: props?.admin,
+          lexicalEditorConfig: finalSanitizedEditorConfig.lexical
+        },
+        path: '@payloadcms/richtext-lexical/client#RichTextCell'
+      },
+      editorConfig: finalSanitizedEditorConfig,
+      features,
+      FieldComponent: {
+        clientProps: {
+          admin: props?.admin,
+          lexicalEditorConfig: finalSanitizedEditorConfig.lexical
+        },
+        path: '@payloadcms/richtext-lexical/client#RichTextField'
+      },
+      generateComponentMap: {
+        path: '@payloadcms/richtext-lexical/generateComponentMap#getGenerateComponentMap',
+        serverProps: {
+          resolvedFeatureMap
+        }
+      },
+      generateImportMap: getGenerateImportMap({
+        resolvedFeatureMap
+      }),
+      generateSchemaMap: getGenerateSchemaMap({
+        resolvedFeatureMap
+      }),
+      graphQLPopulationPromises({
+        context,
+        currentDepth,
+        depth,
+        draft,
+        field,
+        fieldPromises,
+        findMany,
+        flattenLocales,
+        overrideAccess,
+        populationPromises,
+        req,
+        showHiddenFields,
+        siblingDoc
+      }) {
+        // check if there are any features with nodes which have populationPromises for this field
+        if (finalSanitizedEditorConfig?.features?.graphQLPopulationPromises?.size) {
+          populateLexicalPopulationPromises({
+            context,
+            currentDepth: currentDepth ?? 0,
+            depth,
+            draft,
+            editorPopulationPromises: finalSanitizedEditorConfig.features.graphQLPopulationPromises,
+            field,
+            fieldPromises,
+            findMany,
+            flattenLocales,
+            overrideAccess,
+            populationPromises,
+            req,
+            showHiddenFields,
+            siblingDoc
+          });
+        }
+      },
+      hooks: {
+        afterChange: [async args => {
+          const {
+            collection,
+            context: _context,
+            global,
+            operation,
+            path,
+            req,
+            schemaPath
+          } = args;
+          let {
+            value
+          } = args;
+          if (finalSanitizedEditorConfig?.features?.hooks?.afterChange?.length) {
+            for (const hook of finalSanitizedEditorConfig.features.hooks.afterChange) {
+              value = await hook(args);
+            }
+          }
+          if (!finalSanitizedEditorConfig.features.nodeHooks.afterChange.size && !finalSanitizedEditorConfig.features.getSubFields.size) {
+            return value;
+          }
+          const context = _context;
+          const nodeIDMap = {};
+          /**
+          * Get the originalNodeIDMap from the beforeValidate hook, which is always run before this hook.
+          */
+          const originalNodeIDMap = context?.internal?.richText?.[path.join('.')]?.originalNodeIDMap;
+          if (!originalNodeIDMap || !Object.keys(originalNodeIDMap).length || !value) {
+            return value;
+          }
+          recurseNodeTree({
+            nodeIDMap,
+            nodes: value?.root?.children ?? []
+          });
+          // eslint-disable-next-line prefer-const
+          for (let [id, node] of Object.entries(nodeIDMap)) {
+            const afterChangeHooks = finalSanitizedEditorConfig.features.nodeHooks.afterChange;
+            if (afterChangeHooks?.has(node.type)) {
+              for (const hook of afterChangeHooks.get(node.type)) {
+                if (!originalNodeIDMap[id]) {
+                  console.warn('(afterChange) No original node found for node with id', id, 'node:', node, 'path', path.join('.'));
+                  continue;
                 }
+                node = await hook({
+                  context,
+                  node,
+                  operation,
+                  originalNode: originalNodeIDMap[id],
+                  parentRichTextFieldPath: path,
+                  parentRichTextFieldSchemaPath: schemaPath,
+                  req
+                });
+              }
             }
-            if (Object.keys(foundVersions).length > 1) {
-                const formattedVersionsWithPackageNameString = Object.entries(foundVersions).map(([version, pkg])=>`${pkg}@${version}`).join(', ');
-                throw new Error(`Mismatching lexical dependency versions found: ${formattedVersionsWithPackageNameString}. All lexical and @lexical/* packages must have the same version. This is an error with your set-up, caused by you, not a bug in payload. Please go to your package.json and ensure all lexical and @lexical/* packages have the same version.`);
+            const subFieldFn = finalSanitizedEditorConfig.features.getSubFields.get(node.type);
+            const subFieldDataFn = finalSanitizedEditorConfig.features.getSubFieldsData.get(node.type);
+            if (subFieldFn) {
+              const subFields = subFieldFn({
+                node,
+                req
+              });
+              const data = subFieldDataFn({
+                node,
+                req
+              }) ?? {};
+              const originalData = subFieldDataFn({
+                node: originalNodeIDMap[id],
+                req
+              }) ?? {};
+              if (subFields?.length) {
+                await afterChangeTraverseFields({
+                  collection,
+                  context,
+                  data: originalData,
+                  doc: data,
+                  fields: subFields,
+                  global,
+                  operation,
+                  path,
+                  previousDoc: data,
+                  previousSiblingDoc: {
+                    ...data
+                  },
+                  req,
+                  schemaPath,
+                  siblingData: originalData || {},
+                  siblingDoc: {
+                    ...data
+                  }
+                });
+              }
             }
-        }
-        let features = [];
-        let resolvedFeatureMap;
-        let finalSanitizedEditorConfig// For server only
-        ;
-        if (!props || !props.features && !props.lexical) {
-            if (!defaultSanitizedServerEditorConfig) {
-                defaultSanitizedServerEditorConfig = await sanitizeServerEditorConfig(defaultEditorConfig, config);
-                features = deepCopyObject(defaultEditorFeatures);
+          }
+          return value;
+        }],
+        afterRead: [
+        /**
+        * afterRead hooks do not receive the originalNode. Thus, they can run on all nodes, not just nodes with an ID.
+        */
+        async args => {
+          const {
+            collection,
+            context: context,
+            currentDepth,
+            depth,
+            draft,
+            fallbackLocale,
+            fieldPromises,
+            findMany,
+            flattenLocales,
+            global,
+            locale,
+            overrideAccess,
+            path,
+            populationPromises,
+            req,
+            schemaPath,
+            showHiddenFields,
+            triggerAccessControl,
+            triggerHooks
+          } = args;
+          let {
+            value
+          } = args;
+          if (finalSanitizedEditorConfig?.features?.hooks?.afterRead?.length) {
+            for (const hook of finalSanitizedEditorConfig.features.hooks.afterRead) {
+              value = await hook(args);
             }
-            finalSanitizedEditorConfig = deepCopyObject(defaultSanitizedServerEditorConfig);
-            resolvedFeatureMap = finalSanitizedEditorConfig.resolvedFeatureMap;
-        } else {
-            const rootEditor = config.editor;
-            let rootEditorFeatures = [];
-            if (typeof rootEditor === 'object' && 'features' in rootEditor) {
-                rootEditorFeatures = rootEditor.features;
+          }
+          if (!finalSanitizedEditorConfig.features.nodeHooks.afterRead.size && !finalSanitizedEditorConfig.features.getSubFields.size) {
+            return value;
+          }
+          const flattenedNodes = [];
+          recurseNodeTree({
+            flattenedNodes,
+            nodes: value?.root?.children ?? []
+          });
+          for (let node of flattenedNodes) {
+            const afterReadHooks = finalSanitizedEditorConfig.features.nodeHooks.afterRead;
+            if (afterReadHooks?.has(node.type)) {
+              for (const hook of afterReadHooks.get(node.type)) {
+                node = await hook({
+                  context,
+                  currentDepth,
+                  depth,
+                  draft,
+                  fallbackLocale,
+                  fieldPromises,
+                  findMany,
+                  flattenLocales,
+                  locale,
+                  node,
+                  overrideAccess,
+                  parentRichTextFieldPath: path,
+                  parentRichTextFieldSchemaPath: schemaPath,
+                  populationPromises,
+                  req,
+                  showHiddenFields,
+                  triggerAccessControl,
+                  triggerHooks
+                });
+              }
             }
-            features = props.features && typeof props.features === 'function' ? props.features({
-                defaultFeatures: deepCopyObject(defaultEditorFeatures),
-                rootFeatures: rootEditorFeatures
-            }) : props.features;
-            if (!features) {
-                features = deepCopyObject(defaultEditorFeatures);
+            const subFieldFn = finalSanitizedEditorConfig.features.getSubFields.get(node.type);
+            const subFieldDataFn = finalSanitizedEditorConfig.features.getSubFieldsData.get(node.type);
+            if (subFieldFn) {
+              const subFields = subFieldFn({
+                node,
+                req
+              });
+              const data = subFieldDataFn({
+                node,
+                req
+              }) ?? {};
+              if (subFields?.length) {
+                afterReadTraverseFields({
+                  collection,
+                  context,
+                  currentDepth,
+                  depth,
+                  doc: data,
+                  draft,
+                  fallbackLocale,
+                  fieldPromises,
+                  fields: subFields,
+                  findMany,
+                  flattenLocales,
+                  global,
+                  locale,
+                  overrideAccess,
+                  path,
+                  populationPromises,
+                  req,
+                  schemaPath,
+                  showHiddenFields,
+                  siblingDoc: data,
+                  triggerAccessControl,
+                  triggerHooks
+                });
+              }
             }
-            const lexical = props.lexical ?? deepCopyObjectSimple(defaultEditorConfig.lexical);
-            resolvedFeatureMap = await loadFeatures({
-                config,
-                isRoot,
-                unSanitizedEditorConfig: {
-                    features,
-                    lexical
-                }
-            });
-            finalSanitizedEditorConfig = {
-                features: sanitizeServerFeatures(resolvedFeatureMap),
-                lexical,
-                resolvedFeatureMap
-            };
-        }
-        const featureI18n = finalSanitizedEditorConfig.features.i18n;
-        for(const lang in i18n){
-            if (!featureI18n[lang]) {
-                featureI18n[lang] = {
-                    lexical: {}
-                };
+          }
+          return value;
+        }],
+        beforeChange: [async args => {
+          const {
+            collection,
+            context: _context,
+            errors,
+            field,
+            global,
+            mergeLocaleActions,
+            operation,
+            path,
+            req,
+            schemaPath,
+            siblingData,
+            siblingDocWithLocales,
+            skipValidation
+          } = args;
+          let {
+            value
+          } = args;
+          if (finalSanitizedEditorConfig?.features?.hooks?.beforeChange?.length) {
+            for (const hook of finalSanitizedEditorConfig.features.hooks.beforeChange) {
+              value = await hook(args);
             }
-            featureI18n[lang].lexical.general = i18n[lang];
-        }
-        return {
-            CellComponent: {
-                clientProps: {
-                    admin: props?.admin,
-                    lexicalEditorConfig: finalSanitizedEditorConfig.lexical
-                },
-                path: '@payloadcms/richtext-lexical/client#RichTextCell'
-            },
-            FieldComponent: {
-                clientProps: {
-                    admin: props?.admin,
-                    lexicalEditorConfig: finalSanitizedEditorConfig.lexical
-                },
-                path: '@payloadcms/richtext-lexical/client#RichTextField'
-            },
-            editorConfig: finalSanitizedEditorConfig,
-            features,
-            generateComponentMap: {
-                path: '@payloadcms/richtext-lexical/generateComponentMap#getGenerateComponentMap',
-                serverProps: {
-                    resolvedFeatureMap
-                }
-            },
-            generateImportMap: getGenerateImportMap({
-                resolvedFeatureMap
-            }),
-            generateSchemaMap: getGenerateSchemaMap({
-                resolvedFeatureMap
-            }),
-            graphQLPopulationPromises ({ context, currentDepth, depth, draft, field, fieldPromises, findMany, flattenLocales, overrideAccess, populationPromises, req, showHiddenFields, siblingDoc }) {
-                // check if there are any features with nodes which have populationPromises for this field
-                if (finalSanitizedEditorConfig?.features?.graphQLPopulationPromises?.size) {
-                    populateLexicalPopulationPromises({
-                        context,
-                        currentDepth: currentDepth ?? 0,
-                        depth,
-                        draft,
-                        editorPopulationPromises: finalSanitizedEditorConfig.features.graphQLPopulationPromises,
-                        field,
-                        fieldPromises,
-                        findMany,
-                        flattenLocales,
-                        overrideAccess,
-                        populationPromises,
-                        req,
-                        showHiddenFields,
-                        siblingDoc
-                    });
+          }
+          if (!finalSanitizedEditorConfig.features.nodeHooks.beforeChange.size && !finalSanitizedEditorConfig.features.getSubFields.size) {
+            return value;
+          }
+          const context = _context;
+          const nodeIDMap = {};
+          /**
+          * Get the originalNodeIDMap from the beforeValidate hook, which is always run before this hook.
+          */
+          const originalNodeIDMap = context?.internal?.richText?.[path.join('.')]?.originalNodeIDMap;
+          if (!originalNodeIDMap || !Object.keys(originalNodeIDMap).length || !value) {
+            return value;
+          }
+          const originalNodeWithLocalesIDMap = {};
+          recurseNodeTree({
+            nodeIDMap,
+            nodes: value?.root?.children ?? []
+          });
+          if (siblingDocWithLocales?.[field.name]) {
+            recurseNodeTree({
+              nodeIDMap: originalNodeWithLocalesIDMap,
+              nodes: siblingDocWithLocales[field.name]?.root?.children ?? []
+            });
+          }
+          // eslint-disable-next-line prefer-const
+          for (let [id, node] of Object.entries(nodeIDMap)) {
+            const beforeChangeHooks = finalSanitizedEditorConfig.features.nodeHooks.beforeChange;
+            if (beforeChangeHooks?.has(node.type)) {
+              for (const hook of beforeChangeHooks.get(node.type)) {
+                if (!originalNodeIDMap[id]) {
+                  console.warn('(beforeChange) No original node found for node with id', id, 'node:', node, 'path', path.join('.'));
+                  continue;
                 }
-            },
-            hooks: {
-                afterChange: [
-                    async (args)=>{
-                        const { collection, context: _context, global, operation, path, req, schemaPath } = args;
-                        let { value } = args;
-                        if (finalSanitizedEditorConfig?.features?.hooks?.afterChange?.length) {
-                            for (const hook of finalSanitizedEditorConfig.features.hooks.afterChange){
-                                value = await hook(args);
-                            }
-                        }
-                        if (!finalSanitizedEditorConfig.features.nodeHooks.afterChange.size && !finalSanitizedEditorConfig.features.getSubFields.size) {
-                            return value;
-                        }
-                        const context = _context;
-                        const nodeIDMap = {};
-                        /**
-             * Get the originalNodeIDMap from the beforeValidate hook, which is always run before this hook.
-             */ const originalNodeIDMap = context?.internal?.richText?.[path.join('.')]?.originalNodeIDMap;
-                        if (!originalNodeIDMap || !Object.keys(originalNodeIDMap).length || !value) {
-                            return value;
-                        }
-                        recurseNodeTree({
-                            nodeIDMap,
-                            nodes: value?.root?.children ?? []
-                        });
-                        // eslint-disable-next-line prefer-const
-                        for (let [id, node] of Object.entries(nodeIDMap)){
-                            const afterChangeHooks = finalSanitizedEditorConfig.features.nodeHooks.afterChange;
-                            if (afterChangeHooks?.has(node.type)) {
-                                for (const hook of afterChangeHooks.get(node.type)){
-                                    if (!originalNodeIDMap[id]) {
-                                        console.warn('(afterChange) No original node found for node with id', id, 'node:', node, 'path', path.join('.'));
-                                        continue;
-                                    }
-                                    node = await hook({
-                                        context,
-                                        node,
-                                        operation,
-                                        originalNode: originalNodeIDMap[id],
-                                        parentRichTextFieldPath: path,
-                                        parentRichTextFieldSchemaPath: schemaPath,
-                                        req
-                                    });
-                                }
-                            }
-                            const subFieldFn = finalSanitizedEditorConfig.features.getSubFields.get(node.type);
-                            const subFieldDataFn = finalSanitizedEditorConfig.features.getSubFieldsData.get(node.type);
-                            if (subFieldFn) {
-                                const subFields = subFieldFn({
-                                    node,
-                                    req
-                                });
-                                const data = subFieldDataFn({
-                                    node,
-                                    req
-                                }) ?? {};
-                                const originalData = subFieldDataFn({
-                                    node: originalNodeIDMap[id],
-                                    req
-                                }) ?? {};
-                                if (subFields?.length) {
-                                    await afterChangeTraverseFields({
-                                        collection,
-                                        context,
-                                        data: originalData,
-                                        doc: data,
-                                        fields: subFields,
-                                        global,
-                                        operation,
-                                        path,
-                                        previousDoc: data,
-                                        previousSiblingDoc: {
-                                            ...data
-                                        },
-                                        req,
-                                        schemaPath,
-                                        siblingData: originalData || {},
-                                        siblingDoc: {
-                                            ...data
-                                        }
-                                    });
-                                }
-                            }
-                        }
-                        return value;
-                    }
-                ],
-                afterRead: [
-                    /**
-           * afterRead hooks do not receive the originalNode. Thus, they can run on all nodes, not just nodes with an ID.
-           */ async (args)=>{
-                        const { collection, context: context, currentDepth, depth, draft, fallbackLocale, fieldPromises, findMany, flattenLocales, global, locale, overrideAccess, path, populationPromises, req, schemaPath, showHiddenFields, triggerAccessControl, triggerHooks } = args;
-                        let { value } = args;
-                        if (finalSanitizedEditorConfig?.features?.hooks?.afterRead?.length) {
-                            for (const hook of finalSanitizedEditorConfig.features.hooks.afterRead){
-                                value = await hook(args);
-                            }
-                        }
-                        if (!finalSanitizedEditorConfig.features.nodeHooks.afterRead.size && !finalSanitizedEditorConfig.features.getSubFields.size) {
-                            return value;
-                        }
-                        const flattenedNodes = [];
-                        recurseNodeTree({
-                            flattenedNodes,
-                            nodes: value?.root?.children ?? []
-                        });
-                        for (let node of flattenedNodes){
-                            const afterReadHooks = finalSanitizedEditorConfig.features.nodeHooks.afterRead;
-                            if (afterReadHooks?.has(node.type)) {
-                                for (const hook of afterReadHooks.get(node.type)){
-                                    node = await hook({
-                                        context,
-                                        currentDepth,
-                                        depth,
-                                        draft,
-                                        fallbackLocale,
-                                        fieldPromises,
-                                        findMany,
-                                        flattenLocales,
-                                        locale,
-                                        node,
-                                        overrideAccess,
-                                        parentRichTextFieldPath: path,
-                                        parentRichTextFieldSchemaPath: schemaPath,
-                                        populationPromises,
-                                        req,
-                                        showHiddenFields,
-                                        triggerAccessControl,
-                                        triggerHooks
-                                    });
-                                }
-                            }
-                            const subFieldFn = finalSanitizedEditorConfig.features.getSubFields.get(node.type);
-                            const subFieldDataFn = finalSanitizedEditorConfig.features.getSubFieldsData.get(node.type);
-                            if (subFieldFn) {
-                                const subFields = subFieldFn({
-                                    node,
-                                    req
-                                });
-                                const data = subFieldDataFn({
-                                    node,
-                                    req
-                                }) ?? {};
-                                if (subFields?.length) {
-                                    afterReadTraverseFields({
-                                        collection,
-                                        context,
-                                        currentDepth,
-                                        depth,
-                                        doc: data,
-                                        draft,
-                                        fallbackLocale,
-                                        fieldPromises,
-                                        fields: subFields,
-                                        findMany,
-                                        flattenLocales,
-                                        global,
-                                        locale,
-                                        overrideAccess,
-                                        path,
-                                        populationPromises,
-                                        req,
-                                        schemaPath,
-                                        showHiddenFields,
-                                        siblingDoc: data,
-                                        triggerAccessControl,
-                                        triggerHooks
-                                    });
-                                }
-                            }
-                        }
-                        return value;
-                    }
-                ],
-                beforeChange: [
-                    async (args)=>{
-                        const { collection, context: _context, duplicate, errors, field, global, mergeLocaleActions, operation, path, req, schemaPath, siblingData, siblingDocWithLocales, skipValidation } = args;
-                        let { value } = args;
-                        if (finalSanitizedEditorConfig?.features?.hooks?.beforeChange?.length) {
-                            for (const hook of finalSanitizedEditorConfig.features.hooks.beforeChange){
-                                value = await hook(args);
-                            }
-                        }
-                        if (!finalSanitizedEditorConfig.features.nodeHooks.beforeChange.size && !finalSanitizedEditorConfig.features.getSubFields.size) {
-                            return value;
-                        }
-                        const context = _context;
-                        const nodeIDMap = {};
-                        /**
-             * Get the originalNodeIDMap from the beforeValidate hook, which is always run before this hook.
-             */ const originalNodeIDMap = context?.internal?.richText?.[path.join('.')]?.originalNodeIDMap;
-                        if (!originalNodeIDMap || !Object.keys(originalNodeIDMap).length || !value) {
-                            return value;
-                        }
-                        const originalNodeWithLocalesIDMap = {};
-                        recurseNodeTree({
-                            nodeIDMap,
-                            nodes: value?.root?.children ?? []
-                        });
-                        if (siblingDocWithLocales?.[field.name]) {
-                            recurseNodeTree({
-                                nodeIDMap: originalNodeWithLocalesIDMap,
-                                nodes: siblingDocWithLocales[field.name]?.root?.children ?? []
-                            });
-                        }
-                        // eslint-disable-next-line prefer-const
-                        for (let [id, node] of Object.entries(nodeIDMap)){
-                            const beforeChangeHooks = finalSanitizedEditorConfig.features.nodeHooks.beforeChange;
-                            if (beforeChangeHooks?.has(node.type)) {
-                                for (const hook of beforeChangeHooks.get(node.type)){
-                                    if (!originalNodeIDMap[id]) {
-                                        console.warn('(beforeChange) No original node found for node with id', id, 'node:', node, 'path', path.join('.'));
-                                        continue;
-                                    }
-                                    node = await hook({
-                                        context,
-                                        duplicate,
-                                        errors,
-                                        mergeLocaleActions,
-                                        node,
-                                        operation,
-                                        originalNode: originalNodeIDMap[id],
-                                        originalNodeWithLocales: originalNodeWithLocalesIDMap[id],
-                                        parentRichTextFieldPath: path,
-                                        parentRichTextFieldSchemaPath: schemaPath,
-                                        req,
-                                        skipValidation
-                                    });
-                                }
-                            }
-                            const subFieldFn = finalSanitizedEditorConfig.features.getSubFields.get(node.type);
-                            const subFieldDataFn = finalSanitizedEditorConfig.features.getSubFieldsData.get(node.type);
-                            if (subFieldFn) {
-                                const subFields = subFieldFn({
-                                    node,
-                                    req
-                                });
-                                const data = subFieldDataFn({
-                                    node,
-                                    req
-                                }) ?? {};
-                                const originalData = subFieldDataFn({
-                                    node: originalNodeIDMap[id],
-                                    req
-                                }) ?? {};
-                                const originalDataWithLocales = subFieldDataFn({
-                                    node: originalNodeWithLocalesIDMap[id],
-                                    req
-                                }) ?? {};
-                                if (subFields?.length) {
-                                    await beforeChangeTraverseFields({
-                                        id,
-                                        collection,
-                                        context,
-                                        data,
-                                        doc: originalData,
-                                        docWithLocales: originalDataWithLocales ?? {},
-                                        duplicate,
-                                        errors,
-                                        fields: subFields,
-                                        global,
-                                        mergeLocaleActions,
-                                        operation,
-                                        path,
-                                        req,
-                                        schemaPath,
-                                        siblingData: data,
-                                        siblingDoc: originalData,
-                                        siblingDocWithLocales: originalDataWithLocales ?? {},
-                                        skipValidation
-                                    });
-                                }
-                            }
-                        }
-                        /**
-             * within the beforeChange hook, id's may be re-generated.
-             * Example:
-             * 1. Seed data contains IDs for block feature blocks.
-             * 2. Those are used in beforeValidate
-             * 3. in beforeChange, those IDs are regenerated, because you cannot provide IDs during document creation. See baseIDField beforeChange hook for reasoning
-             * 4. Thus, in order for all post-beforeChange hooks to receive the correct ID, we need to update the originalNodeIDMap with the new ID's, by regenerating the nodeIDMap.
-             * The reason this is not generated for every hook, is to save on performance. We know we only really have to generate it in beforeValidate, which is the first hook,
-             * and in beforeChange, which is where modifications to the provided IDs can occur.
-             */ const newOriginalNodeIDMap = {};
-                        const previousValue = siblingData[field.name];
-                        recurseNodeTree({
-                            nodeIDMap: newOriginalNodeIDMap,
-                            nodes: previousValue?.root?.children ?? []
-                        });
-                        if (!context.internal) {
-                            // Add to context, for other hooks to use
-                            context.internal = {};
-                        }
-                        if (!context.internal.richText) {
-                            context.internal.richText = {};
-                        }
-                        context.internal.richText[path.join('.')] = {
-                            originalNodeIDMap: newOriginalNodeIDMap
-                        };
-                        return value;
-                    }
-                ],
-                beforeValidate: [
-                    async (args)=>{
-                        const { collection, context, global, operation, overrideAccess, path, previousValue, req, schemaPath } = args;
-                        let { value } = args;
-                        if (finalSanitizedEditorConfig?.features?.hooks?.beforeValidate?.length) {
-                            for (const hook of finalSanitizedEditorConfig.features.hooks.beforeValidate){
-                                value = await hook(args);
-                            }
-                        }
-                        // return value if there are NO hooks
-                        if (!finalSanitizedEditorConfig.features.nodeHooks.beforeValidate.size && !finalSanitizedEditorConfig.features.nodeHooks.afterChange.size && !finalSanitizedEditorConfig.features.nodeHooks.beforeChange.size && !finalSanitizedEditorConfig.features.getSubFields.size) {
-                            return value;
-                        }
-                        /**
-             * beforeValidate is the first field hook which runs. This is where we can create the node map, which can then be used in the other hooks.
-             *
-             */ /**
+                node = await hook({
+                  context,
+                  errors,
+                  mergeLocaleActions,
+                  node,
+                  operation,
+                  originalNode: originalNodeIDMap[id],
+                  originalNodeWithLocales: originalNodeWithLocalesIDMap[id],
+                  parentRichTextFieldPath: path,
+                  parentRichTextFieldSchemaPath: schemaPath,
+                  req,
+                  skipValidation
+                });
+              }
+            }
+            const subFieldFn = finalSanitizedEditorConfig.features.getSubFields.get(node.type);
+            const subFieldDataFn = finalSanitizedEditorConfig.features.getSubFieldsData.get(node.type);
+            if (subFieldFn) {
+              const subFields = subFieldFn({
+                node,
+                req
+              });
+              const data = subFieldDataFn({
+                node,
+                req
+              }) ?? {};
+              const originalData = subFieldDataFn({
+                node: originalNodeIDMap[id],
+                req
+              }) ?? {};
+              const originalDataWithLocales = subFieldDataFn({
+                node: originalNodeWithLocalesIDMap[id],
+                req
+              }) ?? {};
+              if (subFields?.length) {
+                await beforeChangeTraverseFields({
+                  id,
+                  collection,
+                  context,
+                  data,
+                  doc: originalData,
+                  docWithLocales: originalDataWithLocales ?? {},
+                  errors,
+                  fields: subFields,
+                  global,
+                  mergeLocaleActions,
+                  operation,
+                  path,
+                  req,
+                  schemaPath,
+                  siblingData: data,
+                  siblingDoc: originalData,
+                  siblingDocWithLocales: originalDataWithLocales ?? {},
+                  skipValidation
+                });
+              }
+            }
+          }
+          /**
+          * within the beforeChange hook, id's may be re-generated.
+          * Example:
+          * 1. Seed data contains IDs for block feature blocks.
+          * 2. Those are used in beforeValidate
+          * 3. in beforeChange, those IDs are regenerated, because you cannot provide IDs during document creation. See baseIDField beforeChange hook for reasoning
+          * 4. Thus, in order for all post-beforeChange hooks to receive the correct ID, we need to update the originalNodeIDMap with the new ID's, by regenerating the nodeIDMap.
+          * The reason this is not generated for every hook, is to save on performance. We know we only really have to generate it in beforeValidate, which is the first hook,
+          * and in beforeChange, which is where modifications to the provided IDs can occur.
+          */
+          const newOriginalNodeIDMap = {};
+          const previousValue = siblingData[field.name];
+          recurseNodeTree({
+            nodeIDMap: newOriginalNodeIDMap,
+            nodes: previousValue?.root?.children ?? []
+          });
+          if (!context.internal) {
+            // Add to context, for other hooks to use
+            context.internal = {};
+          }
+          if (!context.internal.richText) {
+            context.internal.richText = {};
+          }
+          context.internal.richText[path.join('.')] = {
+            originalNodeIDMap: newOriginalNodeIDMap
+          };
+          return value;
+        }],
+        beforeValidate: [async args => {
+          const {
+            collection,
+            context,
+            global,
+            operation,
+            overrideAccess,
+            path,
+            previousValue,
+            req,
+            schemaPath
+          } = args;
+          let {
+            value
+          } = args;
+          if (finalSanitizedEditorConfig?.features?.hooks?.beforeValidate?.length) {
+            for (const hook of finalSanitizedEditorConfig.features.hooks.beforeValidate) {
+              value = await hook(args);
+            }
+          }
+          // return value if there are NO hooks
+          if (!finalSanitizedEditorConfig.features.nodeHooks.beforeValidate.size && !finalSanitizedEditorConfig.features.nodeHooks.afterChange.size && !finalSanitizedEditorConfig.features.nodeHooks.beforeChange.size && !finalSanitizedEditorConfig.features.getSubFields.size) {
+            return value;
+          }
+          /**
+          * beforeValidate is the first field hook which runs. This is where we can create the node map, which can then be used in the other hooks.
+          *
+          */ /**
              * flattenedNodes contains all nodes in the editor, in the order they appear in the editor. They will be used for the following hooks:
              * - afterRead
              *
@@ -464,198 +521,178 @@ export function lexicalEditor(props) {
              * thus require a reliable way to match new node data to old node data. Given that node positions can change in between hooks, this is only reliably possible for nodes which are saved with
              * an ID.
              */ //const flattenedNodes: SerializedLexicalNode[] = []
-                        /**
-             * Only nodes with id's (so, nodes with hooks added to them) will be added to the nodeIDMap. They will be used for the following hooks:
-             * - afterChange
-             * - beforeChange
-             * - beforeValidate
-             * - beforeDuplicate
-             *
-             * Other hooks are handled by the flattenedNodes. All nodes in the nodeIDMap are part of flattenedNodes.
-             */ const originalNodeIDMap = {};
-                        recurseNodeTree({
-                            nodeIDMap: originalNodeIDMap,
-                            nodes: previousValue?.root?.children ?? []
-                        });
-                        if (!context.internal) {
-                            // Add to context, for other hooks to use
-                            context.internal = {};
-                        }
-                        if (!context.internal.richText) {
-                            context.internal.richText = {};
-                        }
-                        context.internal.richText[path.join('.')] = {
-                            originalNodeIDMap
-                        };
-                        /**
-             * Now that the maps for all hooks are set up, we can run the validate hook
-             */ if (!finalSanitizedEditorConfig.features.nodeHooks.beforeValidate.size) {
-                            return value;
-                        }
-                        const nodeIDMap = {};
-                        recurseNodeTree({
-                            //flattenedNodes,
-                            nodeIDMap,
-                            nodes: value?.root?.children ?? []
-                        });
-                        // eslint-disable-next-line prefer-const
-                        for (let [id, node] of Object.entries(nodeIDMap)){
-                            const beforeValidateHooks = finalSanitizedEditorConfig.features.nodeHooks.beforeValidate;
-                            if (beforeValidateHooks?.has(node.type)) {
-                                for (const hook of beforeValidateHooks.get(node.type)){
-                                    if (!originalNodeIDMap[id]) {
-                                        console.warn('(beforeValidate) No original node found for node with id', id, 'node:', node, 'path', path.join('.'));
-                                        continue;
-                                    }
-                                    node = await hook({
-                                        context,
-                                        node,
-                                        operation,
-                                        originalNode: originalNodeIDMap[id],
-                                        overrideAccess,
-                                        parentRichTextFieldPath: path,
-                                        parentRichTextFieldSchemaPath: schemaPath,
-                                        req
-                                    });
-                                }
-                            }
-                            const subFieldFn = finalSanitizedEditorConfig.features.getSubFields.get(node.type);
-                            const subFieldDataFn = finalSanitizedEditorConfig.features.getSubFieldsData.get(node.type);
-                            if (subFieldFn) {
-                                const subFields = subFieldFn({
-                                    node,
-                                    req
-                                });
-                                const data = subFieldDataFn({
-                                    node,
-                                    req
-                                }) ?? {};
-                                const originalData = subFieldDataFn({
-                                    node: originalNodeIDMap[id],
-                                    req
-                                }) ?? {};
-                                if (subFields?.length) {
-                                    await beforeValidateTraverseFields({
-                                        id,
-                                        collection,
-                                        context,
-                                        data,
-                                        doc: originalData,
-                                        fields: subFields,
-                                        global,
-                                        operation,
-                                        overrideAccess,
-                                        path,
-                                        req,
-                                        schemaPath,
-                                        siblingData: data,
-                                        siblingDoc: originalData
-                                    });
-                                }
-                            }
-                        }
-                        return value;
-                    }
-                ]
-            },
-            i18n: featureI18n,
-            outputSchema: ({ collectionIDFieldTypes, config, field, interfaceNameDefinitions, isRequired })=>{
-                let outputSchema = {
-                    // This schema matches the SerializedEditorState type so far, that it's possible to cast SerializedEditorState to this schema without any errors.
-                    // In the future, we should
-                    // 1) allow recursive children
-                    // 2) Pass in all the different types for every node added to the editorconfig. This can be done with refs in the schema.
-                    type: withNullableJSONSchemaType('object', isRequired),
+          /**
+          * Only nodes with id's (so, nodes with hooks added to them) will be added to the nodeIDMap. They will be used for the following hooks:
+          * - afterChange
+          * - beforeChange
+          * - beforeValidate
+          *
+          * Other hooks are handled by the flattenedNodes. All nodes in the nodeIDMap are part of flattenedNodes.
+          */
+          const originalNodeIDMap = {};
+          recurseNodeTree({
+            nodeIDMap: originalNodeIDMap,
+            nodes: previousValue?.root?.children ?? []
+          });
+          if (!context.internal) {
+            // Add to context, for other hooks to use
+            context.internal = {};
+          }
+          if (!context.internal.richText) {
+            context.internal.richText = {};
+          }
+          context.internal.richText[path.join('.')] = {
+            originalNodeIDMap
+          };
+          /**
+          * Now that the maps for all hooks are set up, we can run the validate hook
+          */
+          if (!finalSanitizedEditorConfig.features.nodeHooks.beforeValidate.size) {
+            return value;
+          }
+          const nodeIDMap = {};
+          recurseNodeTree({
+            //flattenedNodes,
+            nodeIDMap,
+            nodes: value?.root?.children ?? []
+          });
+          // eslint-disable-next-line prefer-const
+          for (let [id, node] of Object.entries(nodeIDMap)) {
+            const beforeValidateHooks = finalSanitizedEditorConfig.features.nodeHooks.beforeValidate;
+            if (beforeValidateHooks?.has(node.type)) {
+              for (const hook of beforeValidateHooks.get(node.type)) {
+                if (!originalNodeIDMap[id]) {
+                  console.warn('(beforeValidate) No original node found for node with id', id, 'node:', node, 'path', path.join('.'));
+                  continue;
+                }
+                node = await hook({
+                  context,
+                  node,
+                  operation,
+                  originalNode: originalNodeIDMap[id],
+                  overrideAccess,
+                  parentRichTextFieldPath: path,
+                  parentRichTextFieldSchemaPath: schemaPath,
+                  req
+                });
+              }
+            }
+            const subFieldFn = finalSanitizedEditorConfig.features.getSubFields.get(node.type);
+            const subFieldDataFn = finalSanitizedEditorConfig.features.getSubFieldsData.get(node.type);
+            if (subFieldFn) {
+              const subFields = subFieldFn({
+                node,
+                req
+              });
+              const data = subFieldDataFn({
+                node,
+                req
+              }) ?? {};
+              const originalData = subFieldDataFn({
+                node: originalNodeIDMap[id],
+                req
+              }) ?? {};
+              if (subFields?.length) {
+                await beforeValidateTraverseFields({
+                  id,
+                  collection,
+                  context,
+                  data,
+                  doc: originalData,
+                  fields: subFields,
+                  global,
+                  operation,
+                  overrideAccess,
+                  path,
+                  req,
+                  schemaPath,
+                  siblingData: data,
+                  siblingDoc: originalData
+                });
+              }
+            }
+          }
+          return value;
+        }]
+      },
+      i18n: featureI18n,
+      outputSchema: ({
+        collectionIDFieldTypes,
+        config,
+        field,
+        interfaceNameDefinitions,
+        isRequired
+      }) => {
+        let outputSchema = {
+          // This schema matches the SerializedEditorState type so far, that it's possible to cast SerializedEditorState to this schema without any errors.
+          // In the future, we should
+          // 1) allow recursive children
+          // 2) Pass in all the different types for every node added to the editorconfig. This can be done with refs in the schema.
+          type: withNullableJSONSchemaType('object', isRequired),
+          properties: {
+            root: {
+              type: 'object',
+              additionalProperties: false,
+              properties: {
+                type: {
+                  type: 'string'
+                },
+                children: {
+                  type: 'array',
+                  items: {
+                    type: 'object',
+                    additionalProperties: true,
                     properties: {
-                        root: {
-                            type: 'object',
-                            additionalProperties: false,
-                            properties: {
-                                type: {
-                                    type: 'string'
-                                },
-                                children: {
-                                    type: 'array',
-                                    items: {
-                                        type: 'object',
-                                        additionalProperties: true,
-                                        properties: {
-                                            type: {
-                                                type: 'string'
-                                            },
-                                            version: {
-                                                type: 'integer'
-                                            }
-                                        },
-                                        required: [
-                                            'type',
-                                            'version'
-                                        ]
-                                    }
-                                },
-                                direction: {
-                                    oneOf: [
-                                        {
-                                            enum: [
-                                                'ltr',
-                                                'rtl'
-                                            ]
-                                        },
-                                        {
-                                            type: 'null'
-                                        }
-                                    ]
-                                },
-                                format: {
-                                    type: 'string',
-                                    enum: [
-                                        'left',
-                                        'start',
-                                        'center',
-                                        'right',
-                                        'end',
-                                        'justify',
-                                        ''
-                                    ]
-                                },
-                                indent: {
-                                    type: 'integer'
-                                },
-                                version: {
-                                    type: 'integer'
-                                }
-                            },
-                            required: [
-                                'children',
-                                'direction',
-                                'format',
-                                'indent',
-                                'type',
-                                'version'
-                            ]
-                        }
+                      type: {
+                        type: 'string'
+                      },
+                      version: {
+                        type: 'integer'
+                      }
                     },
-                    required: [
-                        'root'
-                    ]
-                };
-                for (const modifyOutputSchema of finalSanitizedEditorConfig.features.generatedTypes.modifyOutputSchemas){
-                    outputSchema = modifyOutputSchema({
-                        collectionIDFieldTypes,
-                        config,
-                        currentSchema: outputSchema,
-                        field,
-                        interfaceNameDefinitions,
-                        isRequired
-                    });
+                    required: ['type', 'version']
+                  }
+                },
+                direction: {
+                  oneOf: [{
+                    enum: ['ltr', 'rtl']
+                  }, {
+                    type: 'null'
+                  }]
+                },
+                format: {
+                  type: 'string',
+                  enum: ['left', 'start', 'center', 'right', 'end', 'justify', '']
+                },
+                indent: {
+                  type: 'integer'
+                },
+                version: {
+                  type: 'integer'
                 }
-                return outputSchema;
-            },
-            validate: richTextValidateHOC({
-                editorConfig: finalSanitizedEditorConfig
-            })
+              },
+              required: ['children', 'direction', 'format', 'indent', 'type', 'version']
+            }
+          },
+          required: ['root']
         };
+        for (const modifyOutputSchema of finalSanitizedEditorConfig.features.generatedTypes.modifyOutputSchemas) {
+          outputSchema = modifyOutputSchema({
+            collectionIDFieldTypes,
+            config,
+            currentSchema: outputSchema,
+            field,
+            interfaceNameDefinitions,
+            isRequired
+          });
+        }
+        return outputSchema;
+      },
+      validate: richTextValidateHOC({
+        editorConfig: finalSanitizedEditorConfig
+      })
     };
+  };
 }
 export { AlignFeature } from './features/align/server/index.js';
 export { BlockquoteFeature } from './features/blockquote/server/index.js';
@@ -698,10 +735,10 @@ export { defaultEditorConfig, defaultEditorFeatures, defaultEditorLexicalConfig
 export { loadFeatures, sortFeaturesForOptimalLoading } from './lexical/config/server/loader.js';
 export { sanitizeServerEditorConfig, sanitizeServerFeatures } from './lexical/config/server/sanitize.js';
 export { getEnabledNodes } from './lexical/nodes/index.js';
-export { DETAIL_TYPE_TO_DETAIL, DOUBLE_LINE_BREAK, ELEMENT_FORMAT_TO_TYPE, ELEMENT_TYPE_TO_FORMAT, IS_ALL_FORMATTING, LTR_REGEX, NON_BREAKING_SPACE, NodeFormat, RTL_REGEX, TEXT_MODE_TO_TYPE, TEXT_TYPE_TO_FORMAT, TEXT_TYPE_TO_MODE } from './lexical/utils/nodeFormat.js';
+export { DETAIL_TYPE_TO_DETAIL, DOUBLE_LINE_BREAK, ELEMENT_FORMAT_TO_TYPE, ELEMENT_TYPE_TO_FORMAT, IS_ALL_FORMATTING, LTR_REGEX, NodeFormat, NON_BREAKING_SPACE, RTL_REGEX, TEXT_MODE_TO_TYPE, TEXT_TYPE_TO_FORMAT, TEXT_TYPE_TO_MODE } from './lexical/utils/nodeFormat.js';
 export { sanitizeUrl, validateUrl } from './lexical/utils/url.js';
 export { defaultRichTextValue } from './populateGraphQL/defaultValue.js';
+export { populate } from './populateGraphQL/populate.js';
 export { createServerFeature } from './utilities/createServerFeature.js';
 export { upgradeLexicalData } from './utilities/upgradeLexicalData/index.js';
-
 //# sourceMappingURL=index.js.map