<?php

declare(strict_types=1);

/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */

namespace TYPO3\CMS\ContentBlocks\Definition\Factory;

use TYPO3\CMS\ContentBlocks\Definition\Capability\LabelCapability;
use TYPO3\CMS\ContentBlocks\Definition\ContentType\ContentType;
use TYPO3\CMS\ContentBlocks\Definition\Factory\Processing\ProcessedFieldsResult;
use TYPO3\CMS\ContentBlocks\Definition\Factory\Processing\ProcessedRootFieldResult;
use TYPO3\CMS\ContentBlocks\Definition\Factory\Processing\ProcessingInput;
use TYPO3\CMS\ContentBlocks\Definition\FlexForm\ContainerDefinition;
use TYPO3\CMS\ContentBlocks\Definition\FlexForm\FlexFormDefinition;
use TYPO3\CMS\ContentBlocks\Definition\FlexForm\SectionDefinition;
use TYPO3\CMS\ContentBlocks\Definition\FlexForm\SheetDefinition;
use TYPO3\CMS\ContentBlocks\Definition\PaletteDefinition;
use TYPO3\CMS\ContentBlocks\Definition\TCA\LinebreakDefinition;
use TYPO3\CMS\ContentBlocks\Definition\TCA\TabDefinition;
use TYPO3\CMS\ContentBlocks\Definition\TcaFieldDefinition;
use TYPO3\CMS\ContentBlocks\FieldType\FieldTypeInterface;
use TYPO3\CMS\ContentBlocks\FieldType\FieldTypeRegistry;
use TYPO3\CMS\ContentBlocks\FieldType\FlexFormFieldType;
use TYPO3\CMS\ContentBlocks\FieldType\SpecialFieldType;
use TYPO3\CMS\ContentBlocks\Loader\LoadedContentBlock;
use TYPO3\CMS\ContentBlocks\Registry\AutomaticLanguageKeysRegistry;
use TYPO3\CMS\ContentBlocks\Registry\AutomaticLanguageSource;
use TYPO3\CMS\ContentBlocks\Registry\ContentBlockRegistry;
use TYPO3\CMS\ContentBlocks\Schema\SimpleTcaSchemaFactory;
use TYPO3\CMS\ContentBlocks\Utility\ContentBlockPathUtility;
use TYPO3\CMS\Core\Resource\FileType;

/**
 * This class does the main heavy-lifting of parsing and preparing loaded
 * Content Blocks and builds the hierarchy of table definitions, TCA
 * record types (here called Content Types) and other TCA specialties like
 * Palettes, Tabs or FlexForm. The result `CompilationResult` is used for
 * ContentBlockDefinitionCollectionFactory->create(). The resulting
 * immutable object is used as an interchange format for multiple generators
 * as read-only access. As such, this class does not have knowledge about real
 * TCA, only about the YAML definition and how to transform it into the
 * internal object format.
 *
 * List of what this compiler does:
 * - Builds the CompilationResult object for use in ContentBlockDefinitionCollectionFactory->create().
 * - Validates the YAML-schema and errors out in case of incorrect definition.
 * - Assigns and tracks unique identifiers for use in database column names.
 * - Collects automatic language keys, which can be used to generate the
 *   labels.xlf file with a command.
 * - Recursively resolves Collections and creates additional anonymous Record
 *   Types based on them. Meaning one Content Block can indeed define more than
 *   one Content Type with the use of Collections.
 * - Tracks parent references which are used to automatically add `parent_uid`
 *   fields. This way a Record Type can be an aggregate root or not depending on
 *   whether it is used in a foreign_table relation or not.
 * - Replaces identifiers referenced in configuration options with the prefixed
 *   identifier (e.g. for the labelField).
 * - Dynamically adds new fields depending on config. For example the type field
 *   or the description column.
 * - (YAML-defined) FlexForm parsing / preparation.
 *
 * @internal Not part of TYPO3's public API.
 */
final class ContentBlockCompiler
{
    private AutomaticLanguageKeysRegistry $automaticLanguageKeysRegistry;
    private SimpleTcaSchemaFactory $simpleTcaSchemaFactory;
    private FieldTypeRegistry $fieldTypeRegistry;

    /**
     * This property tracks Collection foreign_table parent references.
     * It is needed, because there can be a references to a Content Block,
     * which isn't processed yet. Thus, it needs to be collected throughout the run.
     *
     * @var array<string, array>
     */
    private array $parentReferences = [];

    /**
     * @var array<string, string>
     */
    private array $typeFieldPerTable = [];

    /**
     * @var array<string, array<string, string>>
     */
    private array $fieldTypePerIdentifier = [];

    public function compile(
        ContentBlockRegistry $contentBlockRegistry,
        FieldTypeRegistry $fieldTypeRegistry,
        SimpleTcaSchemaFactory $simpleTcaSchemaFactory
    ): CompilationResult {
        $this->simpleTcaSchemaFactory = $simpleTcaSchemaFactory;
        $this->fieldTypeRegistry = $fieldTypeRegistry;
        $this->automaticLanguageKeysRegistry = new AutomaticLanguageKeysRegistry();
        $tableDefinitionList = [];
        foreach ($contentBlockRegistry->getAll() as $contentBlock) {
            $table = $contentBlock->getYaml()['table'];
            $languagePath = $this->buildBaseLanguagePath($contentBlock);
            $processingInput = new ProcessingInput(
                simpleTcaSchemaFactory: $this->simpleTcaSchemaFactory,
                yaml: $contentBlock->getYaml(),
                contentBlock: $contentBlock,
                table: $table,
                rootTable: $table,
                languagePath: $languagePath,
                contentType: $contentBlock->getContentType(),
                typeFieldPerTable: $this->typeFieldPerTable,
                tableDefinitionList: $tableDefinitionList,
            );
            if ($processingInput->getTypeField() !== null) {
                $this->typeFieldPerTable[$table] = $processingInput->getTypeField();
            }
            $tableDefinitionList = $this->processRootFields($processingInput);
        }
        $mergedTableDefinitionList = $this->mergeProcessingResult($tableDefinitionList);
        $compilationResult = new CompilationResult(
            $this->automaticLanguageKeysRegistry,
            $this->parentReferences,
            $mergedTableDefinitionList,
        );
        $this->resetState();
        return $compilationResult;
    }

    private function resetState(): void
    {
        $this->parentReferences = [];
        $this->typeFieldPerTable = [];
        $this->fieldTypePerIdentifier = [];
        unset($this->automaticLanguageKeysRegistry);
        unset($this->simpleTcaSchemaFactory);
        unset($this->fieldTypeRegistry);
    }

    private function mergeProcessingResult(array $tableDefinitionList): array
    {
        $mergedResult = [];
        foreach ($tableDefinitionList as $table => $definition) {
            // Table definitions could be empty, if only overrides exists to a native TCA table.
            if (isset($definition['tableDefinitions'])) {
                // We are reversing the table definition list here, so that higher priority
                // Content Block definitions override lower ones. This is especially
                // important for the default value of type fields (record type selector).
                $reversedTableDefinitions = array_reverse($definition['tableDefinitions']);
                $combinedTableDefinitions = array_replace_recursive(...$reversedTableDefinitions);
                $mergedResult[$table] = $combinedTableDefinitions;
                $mergedResult[$table]['typeDefinitions'] = $definition['typeDefinitions'] ?? [];
            }
            // Override only fields and palettes, if not already existing.
            foreach ($definition['tableOverrideDefinitions'] ?? [] as $override) {
                $mergedResult[$table]['contentType'] ??= $override['contentType'];
                foreach ($override['fields'] as $key => $field) {
                    $mergedResult[$table]['fields'][$key] ??= $field;
                }
                $mergedResult[$table]['palettes'] = array_merge(
                    $mergedResult[$table]['palettes'] ?? [],
                    $override['palettes']
                );
            }
        }
        return $mergedResult;
    }

    private function processRootFields(ProcessingInput $input): array
    {
        $result = new ProcessedFieldsResult($input);
        $this->initializeContentTypeLabelAndDescription($input, $result);
        $yaml = $input->yaml;
        $yaml = $this->prepareYaml($result, $yaml);
        $yamlFields = $yaml['fields'] ?? [];
        foreach ($yamlFields as $rootField) {
            if (is_array($rootField) === false) {
                continue;
            }
            $fields = $this->handleRootField($rootField, $input, $result);
            $this->processFields($input, $result, $fields);
        }
        $this->prefixTcaConfigFields($input, $result);
        $this->collectOverrideColumns($result);
        $this->collectTableDefinition($input, $result);
        $this->collectTypeDefinition($input, $result);
        return $result->tableDefinitionList;
    }

    private function processFields(ProcessingInput $input, ProcessedFieldsResult $result, array $fields): void
    {
        foreach ($fields as $field) {
            $processedRootField = $this->initializeField($input, $result, $field);
            $input->languagePath->addPathSegment($processedRootField->identifier);
            $tcaType = $processedRootField->fieldType->getTcaType();
            if ($tcaType !== 'passthrough') {
                $field = $this->initializeFieldAutomaticLanguageSources($input, $processedRootField, $field);
            }
            if ($processedRootField->fieldType instanceof FlexFormFieldType) {
                $field = $this->processFlexForm($input, $field);
            }
            if (in_array($tcaType, ['select', 'radio', 'check'], true)) {
                $field = $this->collectItemLabels($input, $processedRootField->fieldType, $field);
            }
            if ($tcaType === 'file' || $tcaType === 'inline') {
                $field['typeOverrides'] = $this->processTypeOverride($input, $result, $processedRootField, $field);
            }
            $processedRootField->tcaFieldDefinition = $this->buildTcaFieldDefinitionArray($input, $processedRootField, $field);
            if ($tcaType === 'inline') {
                $this->processCollection($input, $result, $processedRootField, $field);
            }
            $this->collectProcessedField($result, $processedRootField);
            $input->languagePath->popSegment();
        }
    }

    private function initializeField(ProcessingInput $input, ProcessedFieldsResult $result, array $field): ProcessedRootFieldResult
    {
        $rootFieldResult = new ProcessedRootFieldResult();
        $rootFieldResult->identifier = (string)$field['identifier'];
        $alias = $this->chooseAlias($field);
        $result->identifierToAliasMap[$rootFieldResult->identifier] = $alias;
        $this->assertUniqueFieldIdentifier($result, $rootFieldResult->identifier, $input->contentBlock);
        $this->assertUniqueAliasIdentifier($alias, $result, $input->contentBlock);
        $result->uniqueFieldIdentifiers[] = $rootFieldResult->identifier;
        $result->uniqueAliasIdentifiers[] = $alias;
        $rootFieldResult->fieldType = $this->resolveType($input, $field);
        $rootFieldResult->uniqueIdentifier = $this->chooseUniqueIdentifier($input, $field);
        $result->identifierToUniqueMap[$rootFieldResult->identifier] = $rootFieldResult->uniqueIdentifier;
        $this->fieldTypePerIdentifier[$input->table][$rootFieldResult->uniqueIdentifier] ??= $rootFieldResult->fieldType->getName();
        $this->assertUniqueIdentifiersHaveSameFieldType($input, $rootFieldResult);
        return $rootFieldResult;
    }

    private function prepareYaml(ProcessedFieldsResult $result, array $yaml): array
    {
        $table = $result->contentType->table;
        $contentType = $result->tableDefinition->contentType;
        if ($contentType === ContentType::RECORD_TYPE && $result->tableDefinition->hasTypeField()) {
            $isExistingField = false;
            if ($this->simpleTcaSchemaFactory->has($table)) {
                $tableSchema = $this->simpleTcaSchemaFactory->get($table);
                $isExistingField = $tableSchema->hasField($result->tableDefinition->typeField);
            }
            $yamlFields = $yaml['fields'] ?? [];
            $yamlFields = $this->prependTypeFieldForRecordType($yamlFields, $result, $isExistingField);
            $yaml['fields'] = $yamlFields;
        }
        if ($contentType === ContentType::PAGE_TYPE) {
            $yamlFields = $yaml['fields'] ?? [];
            $yamlFields = $this->prependPagesTitlePalette($yamlFields);
            $yaml['fields'] = $yamlFields;
        }
        return $yaml;
    }

    private function initializeContentTypeLabelAndDescription(
        ProcessingInput $input,
        ProcessedFieldsResult $result
    ): void {
        $languagePathTitle = $input->languagePath->getCurrentPath();
        $languagePathDescription = $input->languagePath->getCurrentPath();
        $title = (string)($input->yaml['title'] ?? '');
        $description = (string)($input->yaml['description'] ?? '');
        if ($input->isRootTable()) {
            // Ensure there is always a title for a Content Type.
            $title = $title !== '' ? $title : $input->contentBlock->getName();
            $result->contentType->title = $title;
            $result->contentType->description = $description;
            $languagePathTitle = $languagePathTitle . 'title';
            $languagePathDescription = $languagePathDescription . 'description';
            $languagePathSource = new AutomaticLanguageSource($languagePathTitle, $title);
            $descriptionPathSource = new AutomaticLanguageSource($languagePathDescription, $description);
            $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $languagePathSource);
            $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $descriptionPathSource);
        } else {
            $languagePathTitle = $languagePathTitle . '.label';
            $languagePathDescription = $languagePathDescription . '.description';
            $result->contentType->title = $title;
            $result->contentType->description = $description;
        }
        $result->contentType->languagePathTitle = $languagePathTitle;
        $result->contentType->languagePathDescription = $languagePathDescription;
    }

    private function initializeFieldAutomaticLanguageSources(
        ProcessingInput $input,
        ProcessedRootFieldResult $result,
        array $field
    ): array {
        // Label
        $labelPath = $this->getFieldLabelPath($input->languagePath);
        $label = (string)($field['label'] ?? '');
        // Never fall back to identifiers for existing fields. They have their standard translation.
        $label = ($label !== '' || $this->isExistingField($field)) ? $label : $result->identifier;
        $field['label'] = $label;
        $labelPathSource = new AutomaticLanguageSource($labelPath, $label);
        $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $labelPathSource);

        // Description
        $descriptionPath = $this->getFieldDescriptionPath($input->languagePath);
        $description = (string)($field['description'] ?? '');
        $descriptionPathSource = new AutomaticLanguageSource($descriptionPath, $description);
        $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $descriptionPathSource);

        // Placeholder
        $placeholderPath = $this->getFieldPlaceholderPath($input->languagePath);
        $placeholder = (string)($field['placeholder'] ?? '');
        $placeholderPathSource = new AutomaticLanguageSource($placeholderPath, $placeholder);
        $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $placeholderPathSource);

        return $field;
    }

    private function collectItemLabels(ProcessingInput $input, FieldTypeInterface $fieldType, array $field): array
    {
        $itemsFieldTypes = ['select', 'radio', 'check'];
        $tcaFieldType = $fieldType->getTcaType();
        if (!in_array($tcaFieldType, $itemsFieldTypes, true)) {
            return $field;
        }
        $currentPath = $input->languagePath->getCurrentPath();
        $items = $field['items'] ?? [];
        foreach ($items as $index => $item) {
            $label = (string)($item['label'] ?? '');
            $itemLabelPath = $this->resolveItemPath($tcaFieldType, $index, $item);
            $basePath = $currentPath . '.' . $itemLabelPath;
            $labelPath = $basePath . '.label';
            $field['items'][$index]['labelPath'] = $labelPath;
            $labelPathSource = new AutomaticLanguageSource($labelPath, $label);
            $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $labelPathSource);
            if ($tcaFieldType === 'check') {
                if (array_key_exists('labelChecked', $item)) {
                    $labelChecked = (string)($item['labelChecked'] ?? '');
                    $labelCheckedPath = $basePath . '.labelChecked';
                    $field['items'][$index]['labelCheckedPath'] = $labelCheckedPath;
                    $labelPathSource = new AutomaticLanguageSource($labelCheckedPath, $labelChecked);
                    $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $labelPathSource);
                }
                if (array_key_exists('labelUnchecked', $item)) {
                    $labelUnchecked = (string)($item['labelUnchecked'] ?? '');
                    $labelUncheckedPath = $basePath . '.labelUnchecked';
                    $field['items'][$index]['labelUncheckedPath'] = $labelUncheckedPath;
                    $labelPathSource = new AutomaticLanguageSource($labelUncheckedPath, $labelUnchecked);
                    $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $labelPathSource);
                }
            }
        }
        return $field;
    }

    private function resolveItemPath(string $tcaFieldType, int $index, array $item): string
    {
        $base = 'items';
        if ($tcaFieldType === 'check') {
            return $base . '.' . $index;
        }
        $value = (string)($item['value'] ?? '');
        if ($value === '') {
            return $base;
        }
        return $base . '.' . $value;
    }

    private function buildTcaFieldDefinitionArray(
        ProcessingInput $input,
        ProcessedRootFieldResult $result,
        array $field,
    ): array {
        $tcaFieldDefinition = [
            'parentTable' => $input->contentBlock->getContentType()->getTable(),
            'identifier' => $result->identifier,
            'uniqueIdentifier' => $result->uniqueIdentifier,
            'config' => $field,
            'type' => $result->fieldType,
            'labelPath' => $this->getFieldLabelPath($input->languagePath),
            'descriptionPath' => $this->getFieldDescriptionPath($input->languagePath),
            'placeholderPath' => $this->getFieldPlaceholderPath($input->languagePath),
        ];
        return $tcaFieldDefinition;
    }

    private function getFieldLabelPath(LanguagePath $languagePath): string
    {
        return $languagePath->getCurrentPath() . '.label';
    }

    private function getFieldDescriptionPath(LanguagePath $languagePath): string
    {
        return $languagePath->getCurrentPath() . '.description';
    }

    private function getFieldPlaceholderPath(LanguagePath $languagePath): string
    {
        return $languagePath->getCurrentPath() . '.placeholder';
    }

    private function prefixTcaConfigFields(ProcessingInput $input, ProcessedFieldsResult $result): void
    {
        $this->prefixSortFieldIfNecessary($input, $result);
        $this->prefixLabelFieldIfNecessary($input, $result);
        $this->prefixFallbackLabelFieldsIfNecessary($input, $result);
        $this->prefixDisplayCondFieldsIfNecessary($result);
    }

    private function prependTypeFieldForRecordType(
        array $yamlFields,
        ProcessedFieldsResult $result,
        bool $isExistingField
    ): array {
        if ($isExistingField) {
            $typeFieldDefinition = [
                'identifier' => $result->tableDefinition->typeField,
                'useExistingField' => true,
            ];
        } else {
            $typeFieldDefinition = [
                'identifier' => $result->tableDefinition->typeField,
                'type' => 'Select',
                'renderType' => 'selectSingle',
                'prefixField' => false,
                'default' => $result->contentType->typeName,
                'label' => 'LLL:EXT:core/Resources/Private/Language/locallang_general.xlf:LGL.type',
                'items' => [],
            ];
        }
        // Prepend type field.
        array_unshift($yamlFields, $typeFieldDefinition);
        return $yamlFields;
    }

    /**
     * This palette is the same as TYPO3 Core's `title` palette, but without `subtitle`,
     * which we consider as an optional field.
     */
    private function prependPagesTitlePalette(array $yamlFields): array
    {
        $titlePalette = [
            'identifier' => 'content_blocks_titleonly',
            'type' => 'Palette',
            'label' => 'LLL:EXT:frontend/Resources/Private/Language/locallang_tca.xlf:pages.palettes.title',
            'prefixField' => false,
            'fields' => [
                [
                    'identifier' => 'title',
                    'useExistingField' => true,
                    'label' => 'LLL:EXT:frontend/Resources/Private/Language/locallang_tca.xlf:pages.title_formlabel',
                ],
                [
                    'type' => 'Linebreak',
                ],
                [
                    'identifier' => 'slug',
                    'useExistingField' => true,
                ],
                [
                    'type' => 'Linebreak',
                ],
                [
                    'identifier' => 'nav_title',
                    'useExistingField' => true,
                    'label' => 'LLL:EXT:frontend/Resources/Private/Language/locallang_tca.xlf:pages.nav_title_formlabel',
                ],
            ],
        ];
        array_unshift($yamlFields, $titlePalette);
        return $yamlFields;
    }

    private function handleRootField(array $rootField, ProcessingInput $input, ProcessedFieldsResult $result): array
    {
        $rootFieldType = $this->resolveType($input, $rootField);
        $fieldTypeName = $rootFieldType->getName();
        $specialFieldType = SpecialFieldType::tryFrom($fieldTypeName);
        if (
            $specialFieldType === SpecialFieldType::LINEBREAK
            && ($rootField['ignoreIfNotInPalette'] ?? false)
        ) {
            return [];
        }
        $this->assertNoLinebreakOutsideOfPalette($fieldTypeName, $input->contentBlock);
        if ($rootFieldType->getTcaType() === 'passthrough') {
            return [$rootField];
        }
        $fields = match ($specialFieldType) {
            SpecialFieldType::PALETTE => $this->handlePalette($input, $result, $rootField),
            SpecialFieldType::TAB => $this->handleTab($input, $result, $rootField),
            default => $this->handleDefault($input, $result, $rootField)
        };
        return $fields;
    }

    private function handleDefault(ProcessingInput $input, ProcessedFieldsResult $result, array $field): array
    {
        $result->contentType->showItems[] = $this->chooseUniqueIdentifier($input, $field);
        return [$field];
    }

    private function handlePalette(ProcessingInput $input, ProcessedFieldsResult $result, array $rootPalette): array
    {
        $rootPaletteIdentifier = $rootPalette['identifier'];
        $this->assertUniquePaletteIdentifier($rootPaletteIdentifier, $result, $input->contentBlock);
        $result->uniquePaletteIdentifiers[] = $rootPaletteIdentifier;
        // Ignore empty Palettes.
        if (($rootPalette['fields'] ?? []) === []) {
            return [];
        }
        $fields = [];
        $paletteItems = [];
        foreach ($rootPalette['fields'] as $paletteField) {
            if (is_array($paletteField) === false) {
                continue;
            }
            $paletteFieldType = $this->resolveType($input, $paletteField);
            $fieldTypeName = $paletteFieldType->getName();
            if (SpecialFieldType::tryFrom($fieldTypeName) === SpecialFieldType::LINEBREAK) {
                $paletteItems[] = new LinebreakDefinition();
                continue;
            }
            $this->assertNoPaletteInPalette(
                $fieldTypeName,
                $paletteField['identifier'],
                $rootPaletteIdentifier,
                $input->contentBlock
            );
            $this->assertNoTabInPalette(
                $fieldTypeName,
                $paletteField['identifier'],
                $rootPaletteIdentifier,
                $input->contentBlock
            );
            $fields[] = $paletteField;
            $paletteItems[] = $this->chooseUniqueIdentifier($input, $paletteField);
        }

        $input->languagePath->addPathSegment('palettes.' . $rootPaletteIdentifier);
        $label = (string)($rootPalette['label'] ?? '');
        $description = $rootPalette['description'] ?? '';
        $languagePathLabel = $input->languagePath->getCurrentPath() . '.label';
        $languagePathDescription = $input->languagePath->getCurrentPath() . '.description';
        $labelPathSource = new AutomaticLanguageSource($languagePathLabel, $label);
        $descriptionPathSource = new AutomaticLanguageSource($languagePathDescription, $description);
        $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $labelPathSource);
        $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $descriptionPathSource);
        $input->languagePath->popSegment();

        $paletteIdentifier = $this->chooseUniqueIdentifier($input, $rootPalette);
        $palette = [
            'contentBlockName' => $input->contentBlock->getName(),
            'identifier' => $paletteIdentifier,
            'label' => $label,
            'description' => $description,
            'languagePathLabel' => $languagePathLabel,
            'languagePathDescription' => $languagePathDescription,
            'items' => $paletteItems,
        ];
        $result->tableDefinition->palettes[$paletteIdentifier] = $palette;
        $result->contentType->showItems[] = PaletteDefinition::createFromArray($palette);
        return $fields;
    }

    private function handleTab(ProcessingInput $input, ProcessedFieldsResult $result, array $field): array
    {
        $identifier = $field['identifier'];
        $this->assertUniqueTabIdentifier($identifier, $result, $input->contentBlock);
        $result->uniqueTabIdentifiers[] = $identifier;

        $input->languagePath->addPathSegment('tabs.' . $identifier);
        $label = (string)($field['label'] ?? '');
        $label = $label !== '' ? $label : $identifier;
        $languagePathLabel = $input->languagePath->getCurrentPath();
        $languagePathSource = new AutomaticLanguageSource($languagePathLabel, $label);
        $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $languagePathSource);
        $input->languagePath->popSegment();

        $tabDefinitionArray = [
            'identifier' => $identifier,
            'contentBlockName' => $input->contentBlock->getName(),
            'label' => $label,
            'languagePathLabel' => $languagePathLabel,
        ];
        $tabDefinition = TabDefinition::createFromArray($tabDefinitionArray);
        $result->contentType->showItems[] = $tabDefinition;
        return [];
    }

    private function collectProcessedField(ProcessedFieldsResult $result, ProcessedRootFieldResult $rootFieldResult): void
    {
        $result->tableDefinition->fields[$rootFieldResult->uniqueIdentifier] = $rootFieldResult->tcaFieldDefinition;
        $result->contentType->columns[] = $rootFieldResult->uniqueIdentifier;
    }

    private function collectOverrideColumns(ProcessedFieldsResult $result): void
    {
        foreach ($result->tableDefinition->fields as $uniqueIdentifier => $tcaFieldDefinition) {
            if ($uniqueIdentifier === $result->tableDefinition->typeField) {
                continue;
            }
            $identifier = $tcaFieldDefinition['identifier'];
            $tcaFieldDefinition['identifier'] = $result->identifierToAliasMap[$identifier];
            $overrideColumn = TcaFieldFactory::create($tcaFieldDefinition);
            $result->contentType->overrideColumns[] = $overrideColumn;
        }
    }

    /**
     * Collect table definitions and Content Types and carry them over to the next stack.
     * This compiler will merge the table definitions and type definitions at the very end.
     */
    private function collectTableDefinition(ProcessingInput $input, ProcessedFieldsResult $result): void
    {
        $table = $input->table;
        $tableDefinition = $result->tableDefinition->toArray();
        $result->tableDefinitionList[$table]['tableDefinitions'][] = $tableDefinition;
    }

    private function collectTypeDefinition(ProcessingInput $input, ProcessedFieldsResult $result): void
    {
        $table = $input->table;
        $typeDefinition = $this->contentTypeToArray($input, $result);
        $result->tableDefinitionList[$table]['typeDefinitions'][] = $typeDefinition;
    }

    private function contentTypeToArray(ProcessingInput $input, ProcessedFieldsResult $result): array
    {
        $isRootTable = $input->isRootTable();
        $identifier = $input->yaml['identifier'] ?? '';
        $typeDefinition = $result->contentType->toArray($isRootTable, $identifier);
        return $typeDefinition;
    }

    private function processCollection(ProcessingInput $input, ProcessedFieldsResult $result, ProcessedRootFieldResult $processedRootField, array $field): void
    {
        $isExternalCollection = array_key_exists('foreign_table', $field);
        $this->assignRelationConfigToCollectionField($field, $processedRootField);
        $foreignTable = $processedRootField->tcaFieldDefinition['config']['foreign_table'];
        $this->parentReferences[$foreignTable][] = $processedRootField->tcaFieldDefinition;
        $fields = $field['fields'] ?? [];
        if ($isExternalCollection || $fields === []) {
            return;
        }
        $isMM = (bool)($field['MM'] ?? false);
        if ($isMM) {
            // Disable sorting as it is already handled in MM table.
            $field['sortable'] = false;
        }
        // The Collection's title equals the field label.
        $field['title'] = $field['label'];
        // Anonymous Collections can't have a type field.
        $field['typeField'] = null;
        $newInput = new ProcessingInput(
            simpleTcaSchemaFactory: $this->simpleTcaSchemaFactory,
            yaml: $field,
            contentBlock: $input->contentBlock,
            table: $foreignTable,
            rootTable: $input->rootTable,
            languagePath: $input->languagePath,
            contentType: ContentType::RECORD_TYPE,
            tableDefinitionList: $result->tableDefinitionList,
        );
        $result->tableDefinitionList = $this->processRootFields($newInput);
    }

    private function processTypeOverride(ProcessingInput $input, ProcessedFieldsResult $result, ProcessedRootFieldResult $processedRootField, array $field): array
    {
        if (($field['overrideType'] ?? []) === []) {
            return [];
        }
        $tcaType = $processedRootField->fieldType->getTcaType();
        if ($tcaType === 'file') {
            $foreignTable = 'sys_file_reference';
        } else {
            if (!array_key_exists('foreign_table', $field)) {
                throw new \InvalidArgumentException('Cannot use "overrideType" on anonymous Collection.', 1742935388);
            }
            $foreignTable = $field['foreign_table'];
        }
        $contentType = ContentType::getByTable($foreignTable);
        $overrideChildTca = [];
        $overrideTypes = $field['overrideType'];
        // For tables without a type field, the type keys can be omitted.
        if (array_is_list($field['overrideType'])) {
            $overrideTypes = [
                '1' => $field['overrideType'],
            ];
        }
        foreach ($overrideTypes as $type => $fields) {
            $typeName = $type;
            if ($tcaType === 'file') {
                $typeName = FileType::tryFromMimeType($type)->value;
            }
            $yaml = [
                'table' => $foreignTable,
                'typeName' => $typeName,
                'fields' => $fields,
            ];
            $newInput = new ProcessingInput(
                simpleTcaSchemaFactory: $this->simpleTcaSchemaFactory,
                yaml: $yaml,
                contentBlock: $input->contentBlock,
                table: $foreignTable,
                rootTable: $input->rootTable,
                languagePath: $input->languagePath,
                contentType: $contentType,
                tableDefinitionList: $result->tableDefinitionList,
            );
            $tableDefinitionList = $this->processRootFields($newInput);
            $typeDefinition = array_pop($tableDefinitionList[$foreignTable]['typeDefinitions']);
            $typeDefinition['typeName'] = $typeName;
            $overrideChildTca[] = $typeDefinition;
            $overrideTableDefinition = array_pop($tableDefinitionList[$foreignTable]['tableDefinitions']);
            $result->tableDefinitionList[$foreignTable]['tableOverrideDefinitions'][] = $overrideTableDefinition;
        }
        return $overrideChildTca;
    }

    private function assignRelationConfigToCollectionField(array $field, ProcessedRootFieldResult $result): void
    {
        $isMM = (bool)($field['MM'] ?? false);
        $isExternalCollection = array_key_exists('foreign_table', $field);
        // MM relations must not have foreign_field set.
        if (!$isMM) {
            $result->tcaFieldDefinition['config']['foreign_field'] ??= 'foreign_table_parent_uid';
        }
        if ($isExternalCollection) {
            if ($field['shareAcrossTables'] ?? false) {
                $result->tcaFieldDefinition['config']['foreign_table_field'] ??= 'tablenames';
            }
            if ($field['shareAcrossFields'] ?? false) {
                $result->tcaFieldDefinition['config']['foreign_match_fields']['fieldname'] = $result->uniqueIdentifier;
            }
        } else {
            $result->tcaFieldDefinition['config']['foreign_table'] = $field['table'] ?? $result->uniqueIdentifier;
        }
    }

    private function processFlexForm(ProcessingInput $input, array $field): array
    {
        $this->validateFlexFormHasOnlySheetsOrNoSheet($field, $input->contentBlock);
        $this->validateFlexFormContainsValidFieldTypes($field, $input->contentBlock);
        $flexFormDefinition = new FlexFormDefinition();
        $flexFormTypeName = $input->getTypeField() !== null ? $input->getTypeName() : 'default';
        $flexFormDefinition->setTypeName($flexFormTypeName);
        $flexFormDefinition->setContentBlockName($input->contentBlock->getName());
        $sheetDefinition = new SheetDefinition();
        $fields = $field['fields'] ?? [];
        if ($this->flexFormDefinitionHasDefaultSheet($fields)) {
            foreach ($fields as $flexFormField) {
                if (is_array($flexFormField) === false) {
                    continue;
                }
                $sheetDefinition->addFieldOrSection($this->resolveFlexFormField($input, $flexFormField));
            }
            $flexFormDefinition->addSheet($sheetDefinition);
        } else {
            foreach ($fields as $sheet) {
                $sheetDefinition = new SheetDefinition();
                $identifier = $sheet['identifier'];
                $sheetDefinition->setIdentifier($identifier);

                $input->languagePath->addPathSegment('sheets.' . $sheetDefinition->getIdentifier());
                $languagePathLabel = $input->languagePath->getCurrentPath() . '.label';
                $descriptionPathLabel = $input->languagePath->getCurrentPath() . '.description';
                $linkTitlePathLabel = $input->languagePath->getCurrentPath() . '.linkTitle';
                $sheetDefinition->setLanguagePathLabel($languagePathLabel);
                $sheetDefinition->setLanguagePathDescription($descriptionPathLabel);
                $sheetDefinition->setLanguagePathLinkTitle($linkTitlePathLabel);
                $label = (string)($sheet['label'] ?? '');
                $label = $label !== '' ? $label : $identifier;
                $description = $sheet['description'] ?? '';
                $linkTitle = $sheet['linkTitle'] ?? '';
                $sheetDefinition->setLabel($label);
                $sheetDefinition->setDescription($description);
                $sheetDefinition->setLinkTitle($linkTitle);
                $languagePathSource = new AutomaticLanguageSource($languagePathLabel, $label);
                $descriptionPathSource = new AutomaticLanguageSource($descriptionPathLabel, $description);
                $linkTitlePathSource = new AutomaticLanguageSource($linkTitlePathLabel, $linkTitle);
                $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $languagePathSource);
                $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $descriptionPathSource);
                $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $linkTitlePathSource);
                $input->languagePath->popSegment();

                foreach ($sheet['fields'] ?? [] as $sheetField) {
                    $sheetDefinition->addFieldOrSection($this->resolveFlexFormField($input, $sheetField));
                }
                $flexFormDefinition->addSheet($sheetDefinition);
            }
        }

        if ($input->getTypeField() !== null) {
            $field['ds_pointerField'] = $input->getTypeField();
        }
        $field['flexFormDefinitions'][$flexFormDefinition->getTypeName()] = $flexFormDefinition;
        return $field;
    }

    private function flexFormDefinitionHasDefaultSheet(array $fields): bool
    {
        foreach ($fields as $flexFormField) {
            if (is_array($flexFormField) === false) {
                continue;
            }
            return FlexFormSubType::tryFrom($flexFormField['type']) !== FlexFormSubType::SHEET;
        }
        return true;
    }

    private function resolveFlexFormField(
        ProcessingInput $input,
        array $flexFormField
    ): TcaFieldDefinition|SectionDefinition {
        if (FlexFormSubType::tryFrom($flexFormField['type']) === FlexFormSubType::SECTION) {
            return $this->processFlexFormSection($input, $flexFormField);
        }
        $identifier = $flexFormField['identifier'];

        $input->languagePath->addPathSegment($identifier);
        $labelPath = $this->getFieldLabelPath($input->languagePath);
        $descriptionPath = $this->getFieldDescriptionPath($input->languagePath);
        $placeholderPath = $this->getFieldPlaceholderPath($input->languagePath);
        $label = (string)($flexFormField['label'] ?? '');
        $label = $label !== '' ? $label : $identifier;
        $flexFormField['label'] = $label;
        $description = $flexFormField['description'] ?? '';
        $placeholder = $flexFormField['placeholder'] ?? '';
        $languagePathSource = new AutomaticLanguageSource($labelPath, $label);
        $descriptionPathSource = new AutomaticLanguageSource($descriptionPath, $description);
        $placeholderPathSource = new AutomaticLanguageSource($placeholderPath, $placeholder);
        $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $languagePathSource);
        $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $descriptionPathSource);
        $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $placeholderPathSource);
        $fieldType = $this->resolveType($input, $flexFormField);
        $flexFormField = $this->collectItemLabels($input, $fieldType, $flexFormField);
        $flexFormFieldArray = [
            'uniqueIdentifier' => $identifier,
            'config' => $flexFormField,
            'type' => $this->fieldTypeRegistry->get($flexFormField['type']),
            'labelPath' => $labelPath,
            'descriptionPath' => $descriptionPath,
            'placeholderPath' => $placeholderPath,
        ];
        $input->languagePath->popSegment();
        $flexFormTcaDefinition = TcaFieldFactory::create($flexFormFieldArray);
        return $flexFormTcaDefinition;
    }

    private function processFlexFormSection(ProcessingInput $input, array $section): SectionDefinition
    {
        $sectionDefinition = new SectionDefinition();
        $sectionIdentifier = $section['identifier'];
        $sectionDefinition->setIdentifier($sectionIdentifier);

        $input->languagePath->addPathSegment('sections.' . $sectionDefinition->getIdentifier());
        $sectionTitle = $input->languagePath->getCurrentPath() . '.title';
        $label = (string)($section['label'] ?? '');
        $label = $label !== '' ? $label : $sectionIdentifier;
        $sectionDefinition->setLanguagePathLabel($sectionTitle);
        $sectionDefinition->setLabel($label);
        $labelPathSource = new AutomaticLanguageSource($sectionTitle, $label);
        $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $labelPathSource);

        foreach ($section['container'] as $container) {
            $containerIdentifier = $container['identifier'];
            $containerDefinition = new ContainerDefinition();
            $containerDefinition->setIdentifier($containerIdentifier);

            $input->languagePath->addPathSegment('container.' . $containerDefinition->getIdentifier());
            $containerTitle = $input->languagePath->getCurrentPath() . '.title';
            $label = (string)($container['label'] ?? '');
            $label = $label !== '' ? $label : $containerIdentifier;
            $containerDefinition->setLanguagePathLabel($containerTitle);
            $containerDefinition->setLabel($label);
            $labelPathSource = new AutomaticLanguageSource($containerTitle, $label);
            $this->automaticLanguageKeysRegistry->addKey($input->contentBlock, $labelPathSource);

            foreach ($container['fields'] as $containerField) {
                $containerDefinition->addField($this->resolveFlexFormField($input, $containerField));
            }
            $sectionDefinition->addContainer($containerDefinition);
            $input->languagePath->popSegment();
        }
        $input->languagePath->popSegment();
        return $sectionDefinition;
    }

    private function prefixSortFieldIfNecessary(ProcessingInput $input, ProcessedFieldsResult $result): void
    {
        $sortField = $input->yaml['sortField'] ?? null;
        if ($sortField === null) {
            return;
        }
        $sortFieldArray = [];
        if (is_string($sortField)) {
            $sortFieldArray = [['identifier' => $sortField]];
            $result->tableDefinition->raw['sortField'] = [];
        }
        if (is_array($sortField)) {
            $sortFieldArray = $sortField;
        }
        if ($sortFieldArray === []) {
            return;
        }
        for ($i = 0; $i < count($sortFieldArray); $i++) {
            $sortFieldItem = $sortFieldArray[$i];
            $sortFieldIdentifier = $sortFieldItem['identifier'];
            $order = '';
            if (array_key_exists('order', $sortFieldItem)) {
                $order = strtolower((string)$sortFieldItem['order']);
                if (!in_array($order, ['asc', 'desc'], true)) {
                    throw new \InvalidArgumentException(
                        'order for sortField.order must be one of "asc" or "desc". "' . $order . '" provided.',
                        1694014891
                    );
                }
            }
            if (
                $sortFieldIdentifier !== ''
                && in_array($sortFieldIdentifier, $result->uniqueFieldIdentifiers, true)
            ) {
                $uniqueIdentifier = $result->identifierToUniqueMap[$sortFieldIdentifier];
                $result->tableDefinition->raw['sortField'][$i]['identifier'] = $uniqueIdentifier;
                $result->tableDefinition->raw['sortField'][$i]['order'] = strtoupper($order);
            }
        }
    }

    private function prefixDisplayCondFieldsIfNecessary(ProcessedFieldsResult $result): void
    {
        foreach ($result->tableDefinition->fields as $currentIdentifier => $tcaFieldDefinition) {
            $field = $tcaFieldDefinition['config'];
            $displayCond = $field['displayCond'] ?? null;
            if ($displayCond === null) {
                continue;
            }
            $isCorrectType = is_string($displayCond) || is_array($displayCond);
            $isEmpty = $displayCond === [] || $displayCond === '';
            if (!$isCorrectType || $isEmpty) {
                continue;
            }
            $field['displayCond'] = $this->prefixDisplayCondFieldRecursive($displayCond, $tcaFieldDefinition, $result);
            $tcaFieldDefinition['config'] = $field;
            $result->tableDefinition->fields[$currentIdentifier] = $tcaFieldDefinition;
        }
    }

    private function prefixDisplayCondFieldRecursive(
        string|array $displayCond,
        array $field,
        ProcessedFieldsResult $result
    ): string|array {
        if (is_string($displayCond)) {
            $displayCond = $this->prefixDisplayCondRule($displayCond, $result);
        } else {
            foreach ($displayCond as $indexOrOperator => $ruleOrGroup) {
                $displayCond[$indexOrOperator] = $this->prefixDisplayCondFieldRecursive($ruleOrGroup, $field, $result);
            }
        }
        return $displayCond;
    }

    private function prefixDisplayCondRule(string $displayCond, ProcessedFieldsResult $result): string
    {
        if (!str_starts_with($displayCond, 'FIELD:')) {
            return $displayCond;
        }
        $parts = explode(':', $displayCond);
        $identifier = $parts[1];
        if (!in_array($identifier, $result->uniqueFieldIdentifiers, true)) {
            return $displayCond;
        }
        $parts[1] = $result->identifierToUniqueMap[$identifier];
        $replacedDisplayCond = implode(':', $parts);
        return $replacedDisplayCond;
    }

    private function prefixLabelFieldIfNecessary(ProcessingInput $input, ProcessedFieldsResult $result): void
    {
        $labelCapability = LabelCapability::createFromArray($input->yaml);
        if (!$labelCapability->hasLabelField()) {
            return;
        }
        $labelFields = $labelCapability->getLabelFieldsAsArray();
        for ($i = 0; $i < count($labelFields); $i++) {
            $currentLabelField = $labelFields[$i];
            if (in_array($currentLabelField, $result->uniqueFieldIdentifiers, true)) {
                if (is_string($result->tableDefinition->raw['labelField'])) {
                    $result->tableDefinition->raw['labelField'] = [];
                }
                $result->tableDefinition->raw['labelField'][$i] = $result->identifierToUniqueMap[$currentLabelField];
            }
        }
    }

    private function prefixFallbackLabelFieldsIfNecessary(ProcessingInput $input, ProcessedFieldsResult $result): void
    {
        $labelCapability = LabelCapability::createFromArray($input->yaml);
        if (!$labelCapability->hasFallbackLabelFields()) {
            return;
        }
        $fallbackLabelFields = $labelCapability->getFallbackLabelFields();
        for ($i = 0; $i < count($fallbackLabelFields); $i++) {
            $currentLabelField = $fallbackLabelFields[$i];
            if (in_array($currentLabelField, $result->uniqueFieldIdentifiers, true)) {
                $labelField = $result->identifierToUniqueMap[$currentLabelField];
                $result->tableDefinition->raw['fallbackLabelFields'][$i] = $labelField;
            }
        }
    }

    private function isPrefixEnabledForField(LoadedContentBlock $contentBlock, array $fieldConfiguration): bool
    {
        if ($this->isExistingField($fieldConfiguration)) {
            return false;
        }
        if (array_key_exists('prefixField', $fieldConfiguration)) {
            return (bool)$fieldConfiguration['prefixField'];
        }
        return $contentBlock->prefixFields();
    }

    private function isExistingField(array $fieldConfiguration): bool
    {
        return (bool)($fieldConfiguration['useExistingField'] ?? false);
    }

    private function getPrefixType(LoadedContentBlock $contentBlock, array $fieldConfiguration): PrefixType
    {
        if (array_key_exists('prefixType', $fieldConfiguration)) {
            return PrefixType::from($fieldConfiguration['prefixType']);
        }
        return $contentBlock->getPrefixType();
    }

    private function resolveType(ProcessingInput $input, array $field): FieldTypeInterface
    {
        $isExistingField = $this->isExistingField($field);
        if ($isExistingField) {
            $this->assertIdentifierExists($field, $input);
            $identifier = $field['identifier'];
            // Check if the field is defined as a "base" TCA field (NOT defined in TCA/Overrides).
            if ($this->simpleTcaSchemaFactory->has($input->table)) {
                $tcaSchema = $this->simpleTcaSchemaFactory->get($input->table);
                if ($tcaSchema->hasField($identifier)) {
                    $fieldType = $tcaSchema->getField($identifier);
                    return $fieldType->getType();
                }
            }
        }
        $this->assertTypeExists($field, $input);
        $fieldTypeName = $field['type'];
        $fieldType = $this->fieldTypeRegistry->get($fieldTypeName);
        if (SpecialFieldType::tryFrom($fieldTypeName) !== SpecialFieldType::LINEBREAK) {
            $this->assertIdentifierExists($field, $input);
        }
        return $fieldType;
    }

    private function chooseUniqueIdentifier(ProcessingInput $input, array $field): string
    {
        if (!$input->isRootTable()) {
            return $field['identifier'];
        }
        $prefixEnabled = $this->isPrefixEnabledForField($input->contentBlock, $field);
        if (!$prefixEnabled) {
            return $field['identifier'];
        }
        $prefixType = $this->getPrefixType($input->contentBlock, $field);
        $uniqueIdentifier = UniqueIdentifierCreator::prefixIdentifier(
            $input->contentBlock,
            $prefixType,
            $field['identifier']
        );
        return $uniqueIdentifier;
    }

    private function chooseAlias(array $field): string
    {
        if (array_key_exists('alias', $field) === false) {
            return (string)$field['identifier'];
        }
        return (string)$field['alias'];
    }

    private function buildBaseLanguagePath(LoadedContentBlock $contentBlock): LanguagePath
    {
        $baseExtPath = 'LLL:' . $contentBlock->getExtPath();
        $languagePathString = $baseExtPath . '/' . ContentBlockPathUtility::getLanguageFilePath();
        $languagePath = new LanguagePath($languagePathString);
        return $languagePath;
    }

    private function assertNoLinebreakOutsideOfPalette(string $type, LoadedContentBlock $contentBlock): void
    {
        if (SpecialFieldType::tryFrom($type) === SpecialFieldType::LINEBREAK) {
            throw new \InvalidArgumentException(
                'Linebreaks are only allowed within Palettes in Content Block "'
                . $contentBlock->getName() . '".',
                1679224392
            );
        }
    }

    private function assertIdentifierExists(array $field, ProcessingInput $input): void
    {
        if (!isset($field['identifier'])) {
            throw new \InvalidArgumentException(
                'A field is missing the required "identifier" in Content Block "'
                . $input->contentBlock->getName() . '".',
                1679226075
            );
        }
    }

    private function assertTypeExists(array $field, ProcessingInput $input): void
    {
        if (!isset($field['type'])) {
            throw new \InvalidArgumentException(
                'The field "' . ($field['identifier'] ?? '')
                . '" is missing the required "type" in Content Block "'
                . $input->contentBlock->getName() . '".',
                1694768937
            );
        }
    }

    private function assertUniquePaletteIdentifier(
        string $identifier,
        ProcessedFieldsResult $result,
        LoadedContentBlock $contentBlock
    ): void {
        if (in_array($identifier, $result->uniquePaletteIdentifiers, true)) {
            throw new \InvalidArgumentException(
                'The palette identifier "' . $identifier . '" in Content Block "' . $contentBlock->getName()
                . '" does exist more than once. Please choose unique identifiers.',
                1679168022
            );
        }
    }

    private function assertNoPaletteInPalette(
        string $type,
        string $identifier,
        string $rootFieldIdentifier,
        LoadedContentBlock $contentBlock
    ): void {
        if (SpecialFieldType::tryFrom($type) === SpecialFieldType::PALETTE) {
            throw new \InvalidArgumentException(
                'Palette "' . $identifier . '" is not allowed inside palette "' . $rootFieldIdentifier
                . '" in Content Block "' . $contentBlock->getName() . '".',
                1679168602
            );
        }
    }

    private function assertNoTabInPalette(
        string $type,
        string $identifier,
        string $rootFieldIdentifier,
        LoadedContentBlock $contentBlock
    ): void {
        if (SpecialFieldType::tryFrom($type) === SpecialFieldType::TAB) {
            throw new \InvalidArgumentException(
                'Tab "' . $identifier . '" is not allowed inside palette "' . $rootFieldIdentifier
                . '" in Content Block "' . $contentBlock->getName() . '".',
                1679245193
            );
        }
    }

    private function assertUniqueTabIdentifier(
        string $identifier,
        ProcessedFieldsResult $result,
        LoadedContentBlock $contentBlock
    ): void {
        if (in_array($identifier, $result->uniqueTabIdentifiers, true)) {
            throw new \InvalidArgumentException(
                'The tab identifier "' . $identifier . '" in Content Block "' . $contentBlock->getName()
                . '" does exist more than once. Please choose unique identifiers.',
                1679243686
            );
        }
    }

    private function assertUniqueFieldIdentifier(ProcessedFieldsResult $result, string $identifier, LoadedContentBlock $contentBlock): void
    {
        if (in_array($identifier, $result->uniqueFieldIdentifiers, true)) {
            throw new \InvalidArgumentException(
                'The identifier "' . $identifier . '" in Content Block "' . $contentBlock->getName()
                . '" does exist more than once. Please choose unique identifiers.',
                1677407942
            );
        }
    }

    private function assertUniqueAliasIdentifier(string $alias, ProcessedFieldsResult $result, LoadedContentBlock $contentBlock): void
    {
        if (in_array($alias, $result->uniqueAliasIdentifiers, true)) {
            throw new \InvalidArgumentException(
                'The alias "' . $alias . '" in Content Block "' . $contentBlock->getName()
                . '" does exist more than once. Please choose unique aliases.',
                1778662531
            );
        }
    }

    private function assertUniqueIdentifiersHaveSameFieldType(ProcessingInput $input, ProcessedRootFieldResult $result): void
    {
        $fieldType1 = $this->fieldTypePerIdentifier[$input->table][$result->uniqueIdentifier];
        $fieldType2 = $result->fieldType->getName();
        if ($fieldType1 !== $fieldType2) {
            throw new \InvalidArgumentException(
                'Field Types for identifier "' . $result->uniqueIdentifier . '" do not match (' . $fieldType1 . ', ' . $fieldType2 . ')',
                1741707494
            );
        }
    }

    private function validateFlexFormHasOnlySheetsOrNoSheet(array $field, LoadedContentBlock $contentBlock): void
    {
        foreach ($field['fields'] ?? [] as $flexField) {
            if (is_array($flexField) === false) {
                continue;
            }
            $flexFormType = FlexFormSubType::tryFrom($flexField['type']);
            if ($flexFormType !== FlexFormSubType::SHEET) {
                $flexFormType = 'nonSheet';
            }
            $currentType ??= $flexFormType;
            $isValid = $currentType === $flexFormType;
            if (!$isValid) {
                throw new \InvalidArgumentException(
                    'You must not mix Sheets with normal fields inside the FlexForm definition "'
                    . $field['identifier'] . '" in Content Block "' . $contentBlock->getName() . '".',
                    1685217163
                );
            }
            $currentType = $flexFormType;
        }
    }

    private function validateFlexFormContainsValidFieldTypes(array $field, LoadedContentBlock $contentBlock): void
    {
        foreach ($field['fields'] ?? [] as $flexField) {
            if (is_array($flexField) === false) {
                continue;
            }
            $flexFieldType = $flexField['type'] ?? '';
            if (FlexFormSubType::tryFrom($flexFieldType) === FlexFormSubType::SHEET) {
                $this->validateFlexFormContainsValidFieldTypes($flexField, $contentBlock);
                continue;
            }
            if (FlexFormSubType::tryFrom($flexFieldType) === FlexFormSubType::SECTION) {
                if (empty($flexField['container'])) {
                    throw new \InvalidArgumentException(
                        'FlexForm field "' . $field['identifier'] . '" has a Section "'
                        . $flexField['identifier'] . '" without "container" defined. This is invalid, please add at'
                        . ' least one item to "container" in Content Block "' . $contentBlock->getName() . '".',
                        1686330220
                    );
                }
                foreach ($flexField['container'] as $container) {
                    if (empty($container['fields'])) {
                        throw new \InvalidArgumentException(
                            'FlexForm field "' . $field['identifier'] . '" has a Container in Section "'
                            . $flexField['identifier'] . '" without "fields" defined. This is invalid, please add at'
                            . ' least one field to "fields" in Content Block "' . $contentBlock->getName() . '".',
                            1686331469
                        );
                    }
                    foreach ($container['fields'] as $containerField) {
                        $containerFieldTypeName = $containerField['type'] ?? '';
                        $this->fieldTypeRegistry->get($containerFieldTypeName);
                        if (!$this->isValidFlexFormField($containerFieldTypeName)) {
                            throw new \InvalidArgumentException(
                                'FlexForm field "' . $field['identifier'] . '" has an invalid field of type "'
                                . $containerFieldTypeName . '" inside of a "container" item. Please use valid field'
                                . ' types in Content Block "' . $contentBlock->getName() . '".',
                                1686330594
                            );
                        }
                    }
                }
                continue;
            }
            $flexFieldTypeName = $flexField['type'];
            $this->fieldTypeRegistry->get($flexFieldTypeName);
            if (!$this->isValidFlexFormField($flexFieldTypeName)) {
                throw new \InvalidArgumentException(
                    'Field type "' . $flexFieldTypeName . '" with identifier "' . $flexField['identifier']
                    . '" is not allowed inside FlexForm in Content Block "' . $contentBlock->getName() . '".',
                    1685220309
                );
            }
        }
    }

    private function isValidFlexFormField(string $type): bool
    {
        if (SpecialFieldType::tryFrom($type) !== null) {
            return false;
        }
        $fieldType = $this->fieldTypeRegistry->get($type);
        if ($fieldType->getTcaType() === 'passthrough') {
            return false;
        }
        if ($fieldType instanceof FlexFormFieldType) {
            return false;
        }
        return true;
    }
}