@payloadcms/richtext-lexical 3.0.0-beta.7 → 3.0.0-beta.70

package/dist/index.js

@@ -1,270 +1,692 @@
-import { withMergedProps } from '@payloadcms/ui/elements/withMergedProps';
-import { withNullableJSONSchemaType } from 'payload/utilities';
-import { RichTextCell } from './cell/index.js';
-import { RichTextField } from './field/index.js';
-import { defaultEditorConfig, defaultEditorFeatures, defaultSanitizedServerEditorConfig } from './field/lexical/config/server/default.js';
-import { loadFeatures } from './field/lexical/config/server/loader.js';
-import { sanitizeServerFeatures } from './field/lexical/config/server/sanitize.js';
-import { cloneDeep } from './field/lexical/utils/cloneDeep.js';
-import { getGenerateComponentMap } from './generateComponentMap.js';
-import { getGenerateSchemaMap } from './generateSchemaMap.js';
-import { richTextRelationshipPromise } from './populate/richTextRelationshipPromise.js';
+import { withMergedProps } from '@payloadcms/ui/shared';
+import { fileURLToPath } from 'node:url';
+import path from 'path';
+import { afterChangeTraverseFields, afterReadTraverseFields, beforeChangeTraverseFields, beforeValidateTraverseFields, deepCopyObject, getDependencies, withNullableJSONSchemaType } from 'payload';
+// eslint-disable-next-line payload/no-imports-from-exports-dir
+import { RichTextCell, RichTextField } from './exports/client/index.js';
+import { i18n } from './i18n.js';
+import { defaultEditorConfig, defaultEditorFeatures } from './lexical/config/server/default.js';
+import { loadFeatures } from './lexical/config/server/loader.js';
+import { sanitizeServerEditorConfig, sanitizeServerFeatures } from './lexical/config/server/sanitize.js';
+import { populateLexicalPopulationPromises } from './populateGraphQL/populateLexicalPopulationPromises.js';
+import { getGenerateComponentMap } from './utilities/generateComponentMap.js';
+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);
 export function lexicalEditor(props) {
-    let resolvedFeatureMap = null;
-    let finalSanitizedEditorConfig// For server only
-    ;
-    if (!props || !props.features && !props.lexical) {
-        finalSanitizedEditorConfig = cloneDeep(defaultSanitizedServerEditorConfig);
-        resolvedFeatureMap = finalSanitizedEditorConfig.resolvedFeatureMap;
-    } else {
-        let features = props.features && typeof props.features === 'function' ? props.features({
-            defaultFeatures: cloneDeep(defaultEditorFeatures)
-        }) : props.features;
-        if (!features) {
-            features = cloneDeep(defaultEditorFeatures);
+    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;
+                }
+            }
+            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 lexical = props.lexical;
-        resolvedFeatureMap = loadFeatures({
-            unSanitizedEditorConfig: {
-                features,
-                lexical: lexical ? lexical : defaultEditorConfig.lexical
+        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);
             }
-        });
-        finalSanitizedEditorConfig = {
-            features: sanitizeServerFeatures(resolvedFeatureMap),
-            lexical: lexical ? lexical : defaultEditorConfig.lexical,
-            resolvedFeatureMap
-        };
-    }
-    return {
-        CellComponent: withMergedProps({
-            Component: RichTextCell,
-            toMergeIntoProps: {
-                lexicalEditorConfig: finalSanitizedEditorConfig.lexical
+            finalSanitizedEditorConfig = deepCopyObject(defaultSanitizedServerEditorConfig);
+            resolvedFeatureMap = finalSanitizedEditorConfig.resolvedFeatureMap;
+        } else {
+            const rootEditor = config.editor;
+            let rootEditorFeatures = [];
+            if (typeof rootEditor === 'object' && 'features' in rootEditor) {
+                rootEditorFeatures = rootEditor.features;
             }
-        }),
-        FieldComponent: withMergedProps({
-            Component: RichTextField,
-            toMergeIntoProps: {
-                lexicalEditorConfig: finalSanitizedEditorConfig.lexical
+            features = props.features && typeof props.features === 'function' ? props.features({
+                defaultFeatures: deepCopyObject(defaultEditorFeatures),
+                rootFeatures: rootEditorFeatures
+            }) : props.features;
+            if (!features) {
+                features = deepCopyObject(defaultEditorFeatures);
             }
-        }),
-        afterReadPromise: ({ field, incomingEditorState, siblingDoc })=>{
-            return new Promise((resolve, reject)=>{
-                const promises = [];
-                if (finalSanitizedEditorConfig?.features?.hooks?.afterReadPromises?.length) {
-                    for (const afterReadPromise of finalSanitizedEditorConfig.features.hooks.afterReadPromises){
-                        const promise = afterReadPromise({
-                            field,
-                            incomingEditorState,
-                            siblingDoc
-                        });
-                        if (promise) {
-                            promises.push(promise);
-                        }
-                    }
+            const lexical = props.lexical;
+            resolvedFeatureMap = await loadFeatures({
+                config,
+                isRoot,
+                unSanitizedEditorConfig: {
+                    features,
+                    lexical: lexical ? lexical : defaultEditorConfig.lexical
                 }
-                Promise.all(promises).then(()=>resolve()).catch((error)=>reject(error));
             });
-        },
-        editorConfig: finalSanitizedEditorConfig,
-        generateComponentMap: getGenerateComponentMap({
-            resolvedFeatureMap
-        }),
-        generateSchemaMap: getGenerateSchemaMap({
-            resolvedFeatureMap
-        }),
-        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: {
-                                        type: {
-                                            type: 'string'
+            finalSanitizedEditorConfig = {
+                features: sanitizeServerFeatures(resolvedFeatureMap),
+                lexical: lexical ? lexical : defaultEditorConfig.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: withMergedProps({
+                Component: RichTextCell,
+                toMergeIntoProps: {
+                    admin: props?.admin,
+                    lexicalEditorConfig: finalSanitizedEditorConfig.lexical
+                }
+            }),
+            FieldComponent: withMergedProps({
+                Component: RichTextField,
+                toMergeIntoProps: {
+                    admin: props?.admin,
+                    lexicalEditorConfig: finalSanitizedEditorConfig.lexical
+                }
+            }),
+            editorConfig: finalSanitizedEditorConfig,
+            features,
+            generateComponentMap: getGenerateComponentMap({
+                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 ({ collection, context: _context, global, operation, path, req, schemaPath, value })=>{
+                        if (!finalSanitizedEditorConfig.features.hooks.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.hooks.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
                                         },
-                                        version: {
-                                            type: 'integer'
+                                        req,
+                                        schemaPath,
+                                        siblingData: originalData || {},
+                                        siblingDoc: {
+                                            ...data
                                         }
-                                    },
-                                    required: [
-                                        'type',
-                                        'version'
-                                    ]
+                                    });
                                 }
-                            },
-                            direction: {
-                                oneOf: [
-                                    {
-                                        enum: [
-                                            'ltr',
-                                            'rtl'
-                                        ]
-                                    },
-                                    {
-                                        type: 'null'
+                            }
+                        }
+                        return value;
+                    }
+                ],
+                afterRead: [
+                    /**
+           * afterRead hooks do not receive the originalNode. Thus, they can run on all nodes, not just nodes with an ID.
+           */ async ({ collection, context: context, currentDepth, depth, draft, fallbackLocale, fieldPromises, findMany, flattenLocales, global, locale, overrideAccess, path, populationPromises, req, schemaPath, showHiddenFields, triggerAccessControl, triggerHooks, value })=>{
+                        if (!finalSanitizedEditorConfig.features.hooks.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.hooks.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 ({ collection, context: _context, duplicate, errors, field, global, mergeLocaleActions, operation, path, req, schemaPath, siblingData, siblingDocWithLocales, skipValidation, value })=>{
+                        if (!finalSanitizedEditorConfig.features.hooks.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.hooks.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;
                                     }
-                                ]
-                            },
-                            format: {
-                                type: 'string',
-                                enum: [
-                                    'left',
-                                    'start',
-                                    'center',
-                                    'right',
-                                    'end',
-                                    'justify',
-                                    ''
-                                ]
-                            },
-                            indent: {
-                                type: 'integer'
-                            },
-                            version: {
-                                type: 'integer'
+                                    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 ({ collection, context, global, operation, overrideAccess, path, previousValue, req, schemaPath, value })=>{
+                        // return value if there are NO hooks
+                        if (!finalSanitizedEditorConfig.features.hooks.beforeValidate.size && !finalSanitizedEditorConfig.features.hooks.afterChange.size && !finalSanitizedEditorConfig.features.hooks.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
+             *
+             * The other hooks require nodes to have IDs, which is why those are ran only from the nodeIDMap. They require IDs because they have both doc/siblingDoc and data/siblingData, and
+             * 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.hooks.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.hooks.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
+                                    });
+                                }
                             }
-                        },
-                        required: [
-                            'children',
-                            'direction',
-                            'format',
-                            'indent',
-                            'type',
-                            'version'
-                        ]
+                        }
+                        return value;
                     }
-                },
-                required: [
-                    'root'
                 ]
-            };
-            for (const modifyOutputSchema of finalSanitizedEditorConfig.features.generatedTypes.modifyOutputSchemas){
-                outputSchema = modifyOutputSchema({
-                    collectionIDFieldTypes,
-                    config,
-                    currentSchema: outputSchema,
-                    field,
-                    interfaceNameDefinitions,
-                    isRequired
-                });
-            }
-            return outputSchema;
-        },
-        populationPromise ({ context, currentDepth, depth, field, findMany, flattenLocales, overrideAccess, populationPromises, req, showHiddenFields, siblingDoc }) {
-            // check if there are any features with nodes which have populationPromises for this field
-            if (finalSanitizedEditorConfig?.features?.populationPromises?.size) {
-                return richTextRelationshipPromise({
-                    context,
-                    currentDepth,
-                    depth,
-                    editorPopulationPromises: finalSanitizedEditorConfig.features.populationPromises,
-                    field,
-                    findMany,
-                    flattenLocales,
-                    overrideAccess,
-                    populationPromises,
-                    req,
-                    showHiddenFields,
-                    siblingDoc
-                });
-            }
-            return null;
-        },
-        validate: richTextValidateHOC({
-            editorConfig: finalSanitizedEditorConfig
-        })
+            },
+            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: {
+                                            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'
+                            ]
+                        }
+                    },
+                    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 './field/features/align/feature.server.js';
-export { BlockQuoteFeature } from './field/features/blockquote/feature.server.js';
-export { BlocksFeature } from './field/features/blocks/feature.server.js';
-export { $createBlockNode, $isBlockNode, BlockNode } from './field/features/blocks/nodes/BlocksNode.js';
-export { TextDropdownSectionWithEntries } from './field/features/common/floatingSelectToolbarTextDropdownSection/index.js';
-export { LinebreakHTMLConverter } from './field/features/converters/html/converter/converters/linebreak.js';
-export { ParagraphHTMLConverter } from './field/features/converters/html/converter/converters/paragraph.js';
-export { TextHTMLConverter } from './field/features/converters/html/converter/converters/text.js';
-export { defaultHTMLConverters } from './field/features/converters/html/converter/defaultConverters.js';
-export { convertLexicalNodesToHTML, convertLexicalToHTML } from './field/features/converters/html/converter/index.js';
-export { HTMLConverterFeature } from './field/features/converters/html/feature.server.js';
-export { consolidateHTMLConverters, lexicalHTML } from './field/features/converters/html/field/index.js';
-export { createClientComponent } from './field/features/createClientComponent.js';
-export { TestRecorderFeature } from './field/features/debug/testrecorder/feature.server.js';
-export { TreeViewFeature } from './field/features/debug/treeview/feature.server.js';
-export { BoldFeature } from './field/features/format/bold/feature.server.js';
-export { SectionWithEntries as FormatSectionWithEntries } from './field/features/format/common/floatingSelectToolbarSection.js';
-export { InlineCodeFeature } from './field/features/format/inlinecode/feature.server.js';
-export { ItalicFeature } from './field/features/format/italic/feature.server.js';
-export { StrikethroughFeature } from './field/features/format/strikethrough/feature.server.js';
-export { SubscriptFeature } from './field/features/format/subscript/feature.server.js';
-export { SuperscriptFeature } from './field/features/format/superscript/feature.server.js';
-export { UnderlineFeature } from './field/features/format/underline/feature.server.js';
-export { HeadingFeature } from './field/features/heading/feature.server.js';
-export { IndentFeature } from './field/features/indent/feature.server.js';
-export { LinkFeature } from './field/features/link/feature.server.js';
-export { $createAutoLinkNode, $isAutoLinkNode, AutoLinkNode } from './field/features/link/nodes/AutoLinkNode.js';
-export { $createLinkNode, $isLinkNode, LinkNode, TOGGLE_LINK_COMMAND } from './field/features/link/nodes/LinkNode.js';
-export { CheckListFeature } from './field/features/lists/checklist/feature.server.js';
-export { OrderedListFeature } from './field/features/lists/orderedlist/feature.server.js';
-export { UnorderedListFeature } from './field/features/lists/unorderedlist/feature.server.js';
-export { LexicalPluginToLexicalFeature } from './field/features/migrations/lexicalPluginToLexical/feature.server.js';
-export { SlateBlockquoteConverter } from './field/features/migrations/slateToLexical/converter/converters/blockquote/index.js';
-export { SlateHeadingConverter } from './field/features/migrations/slateToLexical/converter/converters/heading/index.js';
-export { SlateIndentConverter } from './field/features/migrations/slateToLexical/converter/converters/indent/index.js';
-export { SlateLinkConverter } from './field/features/migrations/slateToLexical/converter/converters/link/index.js';
-export { SlateListItemConverter } from './field/features/migrations/slateToLexical/converter/converters/listItem/index.js';
-export { SlateOrderedListConverter } from './field/features/migrations/slateToLexical/converter/converters/orderedList/index.js';
-export { SlateRelationshipConverter } from './field/features/migrations/slateToLexical/converter/converters/relationship/index.js';
-export { SlateUnknownConverter } from './field/features/migrations/slateToLexical/converter/converters/unknown/index.js';
-export { SlateUnorderedListConverter } from './field/features/migrations/slateToLexical/converter/converters/unorderedList/index.js';
-export { SlateUploadConverter } from './field/features/migrations/slateToLexical/converter/converters/upload/index.js';
-export { defaultSlateConverters } from './field/features/migrations/slateToLexical/converter/defaultConverters.js';
-export { convertSlateNodesToLexical, convertSlateToLexical } from './field/features/migrations/slateToLexical/converter/index.js';
-export { SlateToLexicalFeature } from './field/features/migrations/slateToLexical/feature.server.js';
-export { ParagraphFeature } from './field/features/paragraph/feature.server.js';
-export { RelationshipFeature } from './field/features/relationship/feature.server.js';
-export { $createRelationshipNode, $isRelationshipNode, RelationshipNode } from './field/features/relationship/nodes/RelationshipNode.js';
-export { UploadFeature } from './field/features/upload/feature.server.js';
-export { $createUploadNode, $isUploadNode, UploadNode } from './field/features/upload/nodes/UploadNode.js';
-export { EditorConfigProvider, useEditorConfigContext } from './field/lexical/config/client/EditorConfigProvider.js';
-export { sanitizeClientEditorConfig, sanitizeClientFeatures } from './field/lexical/config/client/sanitize.js';
-export { defaultEditorConfig, defaultEditorFeatures, defaultEditorLexicalConfig, defaultSanitizedServerEditorConfig } from './field/lexical/config/server/default.js';
-export { loadFeatures, sortFeaturesForOptimalLoading } from './field/lexical/config/server/loader.js';
-export { sanitizeServerEditorConfig, sanitizeServerFeatures } from './field/lexical/config/server/sanitize.js';
-export { getEnabledNodes } from './field/lexical/nodes/index.js';
-export { ENABLE_SLASH_MENU_COMMAND } from './field/lexical/plugins/SlashMenu/LexicalTypeaheadMenuPlugin/index.js';
-export { SlashMenuGroup, SlashMenuOption } from './field/lexical/plugins/SlashMenu/LexicalTypeaheadMenuPlugin/types.js';
-export { CAN_USE_DOM } from './field/lexical/utils/canUseDOM.js';
-export { cloneDeep } from './field/lexical/utils/cloneDeep.js';
-export { getDOMRangeRect } from './field/lexical/utils/getDOMRangeRect.js';
-export { getSelectedNode } from './field/lexical/utils/getSelectedNode.js';
-export { isHTMLElement } from './field/lexical/utils/guard.js';
-export { invariant } from './field/lexical/utils/invariant.js';
-export { joinClasses } from './field/lexical/utils/joinClasses.js';
-export { createBlockNode } from './field/lexical/utils/markdown/createBlockNode.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 './field/lexical/utils/nodeFormat.js';
-export { Point, isPoint } from './field/lexical/utils/point.js';
-export { Rect } from './field/lexical/utils/rect.js';
-export { setFloatingElemPosition } from './field/lexical/utils/setFloatingElemPosition.js';
-export { setFloatingElemPositionForLinkEditor } from './field/lexical/utils/setFloatingElemPositionForLinkEditor.js';
-export { addSwipeDownListener, addSwipeLeftListener, addSwipeRightListener, addSwipeUpListener } from './field/lexical/utils/swipe.js';
-export { sanitizeUrl, validateUrl } from './field/lexical/utils/url.js';
-export { defaultRichTextValue } from './populate/defaultValue.js';
+export { AlignFeature } from './features/align/feature.server.js';
+export { BlockquoteFeature } from './features/blockquote/feature.server.js';
+export { BlocksFeature } from './features/blocks/feature.server.js';
+export { BlockNode } from './features/blocks/nodes/BlocksNode.js';
+export { LinebreakHTMLConverter } from './features/converters/html/converter/converters/linebreak.js';
+export { ParagraphHTMLConverter } from './features/converters/html/converter/converters/paragraph.js';
+export { TextHTMLConverter } from './features/converters/html/converter/converters/text.js';
+export { defaultHTMLConverters } from './features/converters/html/converter/defaultConverters.js';
+export { convertLexicalNodesToHTML, convertLexicalToHTML } from './features/converters/html/converter/index.js';
+export { HTMLConverterFeature } from './features/converters/html/feature.server.js';
+export { consolidateHTMLConverters, lexicalHTML } from './features/converters/html/field/index.js';
+export { TestRecorderFeature } from './features/debug/testRecorder/feature.server.js';
+export { TreeViewFeature } from './features/debug/treeView/feature.server.js';
+export { EXPERIMENTAL_TableFeature } from './features/experimental_table/feature.server.js';
+export { BoldFeature } from './features/format/bold/feature.server.js';
+export { InlineCodeFeature } from './features/format/inlineCode/feature.server.js';
+export { ItalicFeature } from './features/format/italic/feature.server.js';
+export { StrikethroughFeature } from './features/format/strikethrough/feature.server.js';
+export { SubscriptFeature } from './features/format/subscript/feature.server.js';
+export { SuperscriptFeature } from './features/format/superscript/feature.server.js';
+export { UnderlineFeature } from './features/format/underline/feature.server.js';
+export { HeadingFeature } from './features/heading/feature.server.js';
+export { HorizontalRuleFeature } from './features/horizontalRule/feature.server.js';
+export { IndentFeature } from './features/indent/feature.server.js';
+export { LinkFeature } from './features/link/feature.server.js';
+export { AutoLinkNode } from './features/link/nodes/AutoLinkNode.js';
+export { LinkNode } from './features/link/nodes/LinkNode.js';
+export { ChecklistFeature } from './features/lists/checklist/feature.server.js';
+export { OrderedListFeature } from './features/lists/orderedList/feature.server.js';
+export { UnorderedListFeature } from './features/lists/unorderedList/feature.server.js';
+export { LexicalPluginToLexicalFeature } from './features/migrations/lexicalPluginToLexical/feature.server.js';
+export { SlateBlockquoteConverter } from './features/migrations/slateToLexical/converter/converters/blockquote/index.js';
+export { SlateHeadingConverter } from './features/migrations/slateToLexical/converter/converters/heading/index.js';
+export { SlateIndentConverter } from './features/migrations/slateToLexical/converter/converters/indent/index.js';
+export { SlateLinkConverter } from './features/migrations/slateToLexical/converter/converters/link/index.js';
+export { SlateListItemConverter } from './features/migrations/slateToLexical/converter/converters/listItem/index.js';
+export { SlateOrderedListConverter } from './features/migrations/slateToLexical/converter/converters/orderedList/index.js';
+export { SlateRelationshipConverter } from './features/migrations/slateToLexical/converter/converters/relationship/index.js';
+export { SlateUnknownConverter } from './features/migrations/slateToLexical/converter/converters/unknown/index.js';
+export { SlateUnorderedListConverter } from './features/migrations/slateToLexical/converter/converters/unorderedList/index.js';
+export { SlateUploadConverter } from './features/migrations/slateToLexical/converter/converters/upload/index.js';
+export { defaultSlateConverters } from './features/migrations/slateToLexical/converter/defaultConverters.js';
+export { convertSlateNodesToLexical, convertSlateToLexical } from './features/migrations/slateToLexical/converter/index.js';
+export { SlateToLexicalFeature } from './features/migrations/slateToLexical/feature.server.js';
+export { ParagraphFeature } from './features/paragraph/feature.server.js';
+export { RelationshipFeature } from './features/relationship/feature.server.js';
+export { RelationshipNode } from './features/relationship/nodes/RelationshipNode.js';
+export { FixedToolbarFeature } from './features/toolbars/fixed/feature.server.js';
+export { InlineToolbarFeature } from './features/toolbars/inline/feature.server.js';
+export { createNode } from './features/typeUtilities.js'; // Only useful in feature.server.ts
+export { UploadFeature } from './features/upload/feature.server.js';
+export { UploadNode } from './features/upload/nodes/UploadNode.js';
+export { defaultEditorConfig, defaultEditorFeatures, defaultEditorLexicalConfig } from './lexical/config/server/default.js';
+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 { sanitizeUrl, validateUrl } from './lexical/utils/url.js';
+export { defaultRichTextValue } from './populateGraphQL/defaultValue.js';
+export { createServerFeature } from './utilities/createServerFeature.js';
+export { migrateSlateToLexical } from './utilities/migrateSlateToLexical/index.js';
+export { upgradeLexicalData } from './utilities/upgradeLexicalData/index.js';
 
 //# sourceMappingURL=index.js.map