<?php

declare(strict_types=1);

namespace Evomedien\Vitec\Import;

use PhpOffice\PhpSpreadsheet\IOFactory;
use TYPO3\CMS\Core\Database\ConnectionPool;
use TYPO3\CMS\Core\DataHandling\DataHandler;
use TYPO3\CMS\Core\Resource\StorageRepository;
use TYPO3\CMS\Core\Utility\GeneralUtility;

/**
 * Imports ONE agency "Template 06" workbook (Joe's Dropbox delivery,
 * 2026-10-23) into its solution GROUP page - the eight hero pages below
 * /solutions that the is_group=1 records point at via detail_page.
 *
 * DELIBERATE SIBLING of SubsolutionWorkbookImporter (same decision as
 * markets vs. solutions, 2026-10-05): pipelines evolve independently.
 *
 * The workbook format differs from our generated templates: ONE sheet
 * "Content" with label rows (column A = component, column B = copy, column
 * C = editorial guidance we ignore), no Meta sheet, no named ranges. The
 * group is identified by the "Hero H1" row (fallback: file name).
 *
 * Target template is the NEW layout 22 "Solution Group Page" (zones
 * hero=1, main=0). Element plan, in page order:
 *
 *   colPos 1: vitec_markethero            (subline, CTA -> #capabilities, bg slot 01)
 *             vitec_introparagraph        (hero introduction)
 *   colPos 0: vitec_marketintro           (Intro H2/body, image slot 02)
 *             vitec_marketintro           (Supporting 50/50 H2/copy)
 *             vitec_introparagraph        (Common Challenges H2)
 *             vitec_card x4               (challenges, text_only)
 *             vitec_introparagraph        (Capabilities H2 + section intro)
 *             vitec_card x4               (capabilities, horizontal alternating,
 *                                          bullets as <ul>, image slots 03-06)
 *             vitec_usecaselist           (testimonials - created HIDDEN and
 *                                          empty: an empty selection would list
 *                                          ALL stories; editors pick & unhide)
 *             vitec_marketinsights        (insights intro + CTA, cover slot 07)
 *             vitec_ctabanner             (prefooter, two CTA labels)
 *
 * Shared lessons: content-idempotent file attach (attachFalFile), explicit
 * tt_content.sorting after the DataHandler run, numbered grey placeholders,
 * full page-properties set (og/twitter/canonical/abstract/keywords).
 */
final class SolutionGroupPageImporter
{
    private const LAYOUT = 22;
    private const COLPOS_HERO = 1;
    private const COLPOS_MAIN = 0;
    private const CHALLENGES = 4;
    private const CAPABILITIES = 4;

    /** Curated page keywords per group (Claude, 2026-10-23). Keys per norm(). */
    private const PAGE_KEYWORDS = [
        'controlroomcommandcentresolutions' => 'control room solutions, command centre technology, operations control rooms, video wall control, soc noc solutions',
        'realtimemonitoringsituationalawareness' => 'real-time monitoring, situational awareness solutions, live video monitoring, operational visibility',
        'videodistributionstreaming' => 'video distribution, enterprise video streaming, iptv solutions, av over ip, video delivery network',
        'videocaptureencodingprocessing' => 'video capture, video encoding, video processing, encoders decoders, capture cards',
        'videowalldatavisualisation' => 'video wall solutions, data visualisation, video wall controllers, multi-display visualisation',
        'digitalsignagecontentdelivery' => 'digital signage solutions, content delivery, signage networks, public information displays',
        'enterprisecommunicationsengagement' => 'enterprise communications, corporate iptv, employee engagement displays, internal broadcasting',
        'securitysurveillancesolutions' => 'security surveillance solutions, cctv integration, security operations centre, surveillance monitoring',
    ];

    /** @var string[] */
    private array $report = [];
    /** @var array<string,array<string|int,array<string,mixed>>> */
    private array $datamap = [];
    /** @var array<string,array<int,array<string,int>>> */
    private array $cmdmap = [];
    /** @var array<int,string[]> colPos => element ids in page order */
    private array $sequence = [];
    /** @var array<string,int[]> "colPos/CType" => existing uids, consumed by cursor */
    private array $slotCursor = [];
    private int $newCounter = 0;

    /**
     * @return array{file:string,group:string,pageUid:int,elements:int,applied:bool,report:string[]}
     */
    public function importFile(string $file, bool $apply): array
    {
        $this->report = [];
        $this->datamap = [];
        $this->cmdmap = [];
        $this->sequence = [];
        $this->slotCursor = [];

        $values = $this->readContentSheet($file);
        $group = trim((string)($values['hero h1'] ?? ''));
        if ($group === '') {
            $group = trim((string)preg_replace('/\.xlsx$/i', '', basename($file)));
            $this->report[] = 'no "Hero H1" row - group taken from the file name';
        }

        // --- resolve the group record and its page -----------------------------
        $record = $this->groupRecord($group);
        if ($record === null) {
            throw new \RuntimeException('No is_group solution record matches "' . $group . '".');
        }
        $pageUid = (int)$record['detail_page'];
        if ($pageUid <= 0 || !$this->pageExists($pageUid)) {
            throw new \RuntimeException('Group record "' . $group . '" has no (living) detail_page - run vitec:create-solution-groups / fix editorially.');
        }
        $pageId = (string)$pageUid;

        $pages = GeneralUtility::makeInstance(ConnectionPool::class)->getConnectionForTable('pages');
        $pageRow = $pages->fetchAssociative('SELECT layout FROM pages WHERE uid = ?', [$pageUid]);
        if ((int)($pageRow['layout'] ?? -1) !== self::LAYOUT) {
            $this->datamap['pages'][$pageId]['layout'] = self::LAYOUT;
            $this->datamap['pages'][$pageId]['backend_layout'] = 'vitec__' . self::LAYOUT;
            $this->report[] = 'page: switch layout -> ' . self::LAYOUT . ' (was ' . (int)($pageRow['layout'] ?? 0) . ')';
        }

        // --- SEO / page properties (same set as the sub-solution pages) --------
        $seoTitle = trim((string)($values['seo title'] ?? ''));
        $seoDescription = trim((string)($values['seo meta description'] ?? ''));
        if ($seoTitle !== '') {
            $this->setFields('pages', $pageId, [
                'seo_title' => $seoTitle, 'og_title' => $seoTitle, 'twitter_title' => $seoTitle,
            ]);
        }
        if ($seoDescription !== '') {
            $this->setFields('pages', $pageId, [
                'description' => $seoDescription, 'og_description' => $seoDescription, 'twitter_description' => $seoDescription,
            ]);
        }
        $this->datamap['pages'][$pageId]['canonical_link'] = 't3://page?uid=' . $pageId;
        $abstract = $this->abstractFrom((string)($values['hero introduction'] ?? ''), $seoDescription);
        if ($abstract !== '') {
            $this->datamap['pages'][$pageId]['abstract'] = $abstract;
        }
        $keywords = self::PAGE_KEYWORDS[$this->norm($group)] ?? '';
        if ($keywords !== '') {
            $this->datamap['pages'][$pageId]['keywords'] = $keywords;
        }
        $this->report[] = 'page meta: og/twitter + canonical + abstract (' . mb_strlen($abstract) . ' chars) + keywords' . ($keywords === '' ? ' MISSING (no curated set for "' . $group . '")' : '');

        // --- hero zone (colPos 1) ----------------------------------------------
        $heroId = $this->slotNext($pageUid, self::COLPOS_HERO, 'vitec_markethero');
        $this->setFields('tt_content', $heroId, [
            'vitec_subline' => (string)($values['hero supporting headline'] ?? ''),
            'vitec_cta_label' => (string)($values['hero cta'] ?? ''),
            // the workbook routes the hero CTA to the capability section
            'vitec_cta_link' => '#capabilities',
        ]);
        $this->attachPlaceholder($heroId, 'vitec_bgimage', $apply, $pageUid, 1);

        $heroIntroId = $this->slotNext($pageUid, self::COLPOS_HERO, 'vitec_introparagraph');
        $this->setFields('tt_content', $heroIntroId, [
            'bodytext' => $this->p((string)($values['hero introduction'] ?? '')),
        ]);

        // --- main: intro 50/50 + supporting 50/50 -------------------------------
        $introId = $this->slotNext($pageUid, self::COLPOS_MAIN, 'vitec_marketintro');
        $this->setFields('tt_content', $introId, [
            'vitec_intro_headline' => (string)($values['intro h2'] ?? ''),
            'vitec_intro_text' => $this->p((string)($values['intro body'] ?? '')),
            'vitec_learnmore_label' => (string)($values['intro secondary cta'] ?? ''),
            'vitec_show_portfolio' => 0,
        ]);
        $this->attachPlaceholder($introId, 'vitec_image', $apply, $pageUid, 2);
        if (trim((string)($values['intro secondary cta'] ?? '')) !== '') {
            $this->report[] = 'intro CTA "' . trim((string)$values['intro secondary cta']) . '": set the link target editorially (contact page)';
        }

        $supportId = $this->slotNext($pageUid, self::COLPOS_MAIN, 'vitec_marketintro');
        $this->setFields('tt_content', $supportId, [
            'vitec_intro_headline' => (string)($values['supporting 50/50 h2'] ?? ''),
            'vitec_intro_text' => $this->p((string)($values['supporting 50/50 copy'] ?? '')),
            'vitec_show_portfolio' => 0,
        ]);

        // --- main: common challenges (header + 4 plain cards) -------------------
        $chHeaderId = $this->slotNext($pageUid, self::COLPOS_MAIN, 'vitec_introparagraph');
        $this->setFields('tt_content', $chHeaderId, [
            'header' => (string)($values['common challenges h2'] ?? 'Common Challenges'),
        ]);
        foreach (range(1, self::CHALLENGES) as $i) {
            $title = trim((string)($values['challenge ' . $i . ' title'] ?? ''));
            $copy = trim((string)($values['challenge ' . $i . ' copy'] ?? ''));
            if ($title === '' && $copy === '') {
                continue;
            }
            $cardId = $this->slotNext($pageUid, self::COLPOS_MAIN, 'vitec_card');
            $this->setFields('tt_content', $cardId, [
                'vitec_layout_variant' => 'text_only',
                'header' => $title,
                'bodytext' => $this->p($copy),
            ]);
        }

        // --- main: capabilities (header + 4 alternating 50/50 cards) ------------
        $capHeaderId = $this->slotNext($pageUid, self::COLPOS_MAIN, 'vitec_introparagraph');
        $this->setFields('tt_content', $capHeaderId, [
            'header' => (string)($values['capabilities section h2'] ?? 'Capabilities'),
            'bodytext' => $this->p((string)($values['capabilities section introduction'] ?? '')),
        ]);
        foreach (range(1, self::CAPABILITIES) as $i) {
            $title = trim((string)($values['capability ' . $i . ' h3'] ?? ''));
            if ($title === '') {
                continue;
            }
            $body = $this->p((string)($values['capability ' . $i . ' body'] ?? ''))
                . $this->bulletsToUl((string)($values['capability ' . $i . ' bullets'] ?? ''));
            $capId = $this->slotNext($pageUid, self::COLPOS_MAIN, 'vitec_card');
            $this->setFields('tt_content', $capId, [
                'vitec_layout_variant' => ($i % 2 === 1) ? 'horizontal' : 'horizontal_reverse',
                'header' => $title,
                'subheader' => (string)($values['capability ' . $i . ' subheading'] ?? ''),
                'bodytext' => $body,
                'vitec_primary_cta_label' => (string)($values['capability ' . $i . ' cta'] ?? ''),
            ]);
            $this->attachPlaceholder($capId, 'vitec_image', $apply, $pageUid, 2 + $i);
            if (trim((string)($values['capability ' . $i . ' cta'] ?? '')) !== '') {
                $this->report[] = 'capability ' . $i . ' CTA: route editorially (product/solution detail per workbook guidance)';
            }
        }

        // --- main: testimonials (hidden shell - selection is editorial) ---------
        $testiExisting = $this->slotElements($pageUid, self::COLPOS_MAIN, 'vitec_usecaselist') !== [];
        $testiId = $this->slotNext($pageUid, self::COLPOS_MAIN, 'vitec_usecaselist');
        $fields = [
            'header' => (string)($values['testimonials h2'] ?? 'Testimonials from the Field'),
        ];
        if (!$testiExisting) {
            // an EMPTY story selection would render ALL stories - ship the shell
            // hidden, editors pick the case studies and unhide
            $fields['hidden'] = 1;
            $fields['pi_flexform'] = $this->flex([
                'settings.layout' => 'testimonials',
                'settings.usecases' => '',
                'settings.showtoolbar' => '0',
            ]);
            $this->report[] = 'testimonials: created HIDDEN - pick the case studies editorially, then unhide';
        }
        $this->setFields('tt_content', $testiId, $fields);

        // --- main: industry insights ---------------------------------------------
        $insightsId = $this->slotNext($pageUid, self::COLPOS_MAIN, 'vitec_marketinsights');
        $this->setFields('tt_content', $insightsId, [
            'header' => (string)($values['industry insights h2'] ?? 'Industry Insights'),
            'vitec_text1' => (string)($values['industry insights intro'] ?? ''),
            'vitec_cta_label' => (string)($values['industry insights cta'] ?? ''),
        ]);
        $this->attachPlaceholder($insightsId, 'vitec_video_cover', $apply, $pageUid, 7);
        if (trim((string)($values['industry insights cta'] ?? '')) !== '') {
            $this->report[] = 'insights CTA: set the link target editorially (insights/news page)';
        }

        // --- main: prefooter CTA banner ------------------------------------------
        $preId = $this->slotNext($pageUid, self::COLPOS_MAIN, 'vitec_ctabanner');
        $this->setFields('tt_content', $preId, [
            'header' => (string)($values['prefooter h2'] ?? ''),
            'bodytext' => $this->p((string)($values['prefooter body'] ?? '')),
            'vitec_primary_cta_label' => (string)($values['prefooter primary cta'] ?? ''),
            'vitec_secondary_cta_label' => (string)($values['prefooter secondary cta'] ?? ''),
            'vitec_layout_variant' => 'centered',
            'vitec_background_variant' => 'orange',
        ]);
        $this->report[] = 'prefooter CTAs: set the link targets editorially (contact / request a demo)';

        $result = [
            'file' => basename($file),
            'group' => $group,
            'pageUid' => $pageUid,
            'elements' => count($this->datamap['tt_content'] ?? []),
            'applied' => $apply,
            'report' => $this->report,
        ];
        if (!$apply) {
            return $result;
        }

        $dataHandler = GeneralUtility::makeInstance(DataHandler::class);
        $dataHandler->start($this->datamap, $this->cmdmap);
        $dataHandler->process_datamap();
        if ($this->cmdmap !== []) {
            $dataHandler->process_cmdmap();
        }
        if ($dataHandler->errorLog !== []) {
            throw new \RuntimeException('DataHandler: ' . implode(' | ', $dataHandler->errorLog));
        }
        $this->applySequence($dataHandler->substNEWwithIDs);
        $result['report'] = $this->report;
        return $result;
    }

    // ---- workbook reading ------------------------------------------------------

    /**
     * Label scan over the single "Content" sheet: column A component label
     * (lower-cased, trailing asterisks stripped), column B copy. First
     * occurrence wins; column C (editorial guidance) is ignored.
     *
     * @return array<string,mixed>
     */
    private function readContentSheet(string $file): array
    {
        $spreadsheet = IOFactory::load($file);
        $content = $spreadsheet->getSheetByName('Content');
        if ($content === null) {
            $spreadsheet->disconnectWorksheets();
            throw new \RuntimeException('No "Content" sheet - not a Template-06 group workbook?');
        }
        $values = [];
        $highestRow = min(200, (int)$content->getHighestRow());
        for ($rowNum = 1; $rowNum <= $highestRow; $rowNum++) {
            $label = mb_strtolower(trim((string)$content->getCell('A' . $rowNum)->getValue()));
            $label = rtrim($label, ' *');
            if ($label === '' || $label === 'component') {
                continue;
            }
            if (!array_key_exists($label, $values)) {
                $values[$label] = $content->getCell('B' . $rowNum)->getValue();
            }
        }
        $spreadsheet->disconnectWorksheets();
        return $values;
    }

    /** "• a\n• b" (one cell, hard line breaks) -> <ul><li>a</li>... */
    private function bulletsToUl(string $cell): string
    {
        $items = [];
        foreach (preg_split('/\r\n|\r|\n/', $cell) ?: [] as $line) {
            $line = trim((string)preg_replace('/^[\x{2022}\-\*]\s*/u', '', trim($line)));
            if ($line !== '') {
                $items[] = '<li>' . htmlspecialchars($line, ENT_QUOTES | ENT_HTML5) . '</li>';
            }
        }
        return $items === [] ? '' : '<ul>' . implode('', $items) . '</ul>';
    }

    private function p(string $text): string
    {
        $text = trim($text);
        return $text === '' ? '' : '<p>' . htmlspecialchars($text, ENT_QUOTES | ENT_HTML5) . '</p>';
    }

    // ---- record / page resolution -----------------------------------------------

    /** @return array<string,mixed>|null the is_group=1 solution record */
    private function groupRecord(string $title): ?array
    {
        $connection = GeneralUtility::makeInstance(ConnectionPool::class)->getConnectionForTable('tx_vitec_domain_model_solution');
        foreach ($connection->fetchAllAssociative(
            'SELECT * FROM tx_vitec_domain_model_solution WHERE deleted = 0 AND is_group = 1'
        ) as $row) {
            if ($this->norm((string)$row['title']) === $this->norm($title)) {
                return $row;
            }
        }
        return null;
    }

    private function pageExists(int $uid): bool
    {
        $connection = GeneralUtility::makeInstance(ConnectionPool::class)->getConnectionForTable('pages');
        return (bool)$connection->fetchOne('SELECT uid FROM pages WHERE deleted = 0 AND uid = ?', [$uid]);
    }

    // ---- element plumbing (pattern of the sibling importers) ----------------------

    /**
     * Existing element for this (colPos, CType) in sorting order, consumed
     * cursor-wise so a CType may appear several times per column (the two
     * marketintros, the eight cards); falls back to a NEW element.
     */
    private function slotNext(int $pageUid, int $colPos, string $ctype): string
    {
        $key = $colPos . '/' . $ctype;
        if (!isset($this->slotCursor[$key])) {
            $this->slotCursor[$key] = $this->slotElements($pageUid, $colPos, $ctype);
        }
        $uid = array_shift($this->slotCursor[$key]);
        if ($uid !== null) {
            $this->sequence[$colPos][] = (string)$uid;
            return (string)$uid;
        }
        $id = $this->newId();
        $this->datamap['tt_content'][$id] = [
            'pid' => $pageUid,
            'colPos' => $colPos,
            'CType' => $ctype,
        ];
        $this->sequence[$colPos][] = $id;
        return $id;
    }

    /** @return int[] uids in sorting order */
    private function slotElements(int $pageUid, int $colPos, string $ctype): array
    {
        $connection = GeneralUtility::makeInstance(ConnectionPool::class)->getConnectionForTable('tt_content');
        return array_map('intval', $connection->fetchFirstColumn(
            'SELECT uid FROM tt_content WHERE deleted = 0 AND pid = ? AND colPos = ? AND CType = ? ORDER BY sorting',
            [$pageUid, $colPos, $ctype]
        ));
    }

    /**
     * Writes tt_content.sorting in page order (DataHandler puts NEW records
     * with a positive pid at the TOP of their column - lesson 2026-10-07).
     *
     * @param array<string,int> $substNEWwithIDs
     */
    private function applySequence(array $substNEWwithIDs): void
    {
        $connection = GeneralUtility::makeInstance(ConnectionPool::class)->getConnectionForTable('tt_content');
        foreach ($this->sequence as $ids) {
            $sorting = 0;
            foreach ($ids as $id) {
                $uid = str_starts_with($id, 'NEW') ? (int)($substNEWwithIDs[$id] ?? 0) : (int)$id;
                if ($uid > 0) {
                    $sorting += 256;
                    $connection->update('tt_content', ['sorting' => $sorting], ['uid' => $uid]);
                }
            }
        }
    }

    /** @param array<string,mixed> $fields */
    private function setFields(string $table, string $id, array $fields): void
    {
        foreach ($fields as $field => $value) {
            $this->datamap[$table][$id][$field] = $value;
        }
    }

    /**
     * Grey numbered stand-in for an image slot (same rules as the sibling
     * importers): never over an existing reference; numbered file
     * placeholders/pages/<pid>-NN.png preferred, generic grey as fallback.
     */
    private function attachPlaceholder(string $elementId, string $fieldName, bool $apply, int $pid, int $slot): void
    {
        if (!str_starts_with($elementId, 'NEW') && $this->liveReferences((int)$elementId, $fieldName) !== []) {
            return;
        }
        $storage = GeneralUtility::makeInstance(StorageRepository::class)->getDefaultStorage();
        $identifier = null;
        if ($slot > 0) {
            $candidate = 'placeholders/pages/' . $pid . '-' . str_pad((string)$slot, 2, '0', STR_PAD_LEFT) . '.png';
            if ($storage->hasFile($candidate)) {
                $identifier = $candidate;
            }
        }
        $identifier ??= 'placeholders/' . ($fieldName === 'vitec_bgimage' ? 'placeholder-grey-wide.png' : 'placeholder-grey.png');
        if (!$storage->hasFile($identifier)) {
            $this->report[] = $fieldName . ': empty in the workbook and fileadmin/' . $identifier . ' is missing - left empty';
            return;
        }
        if (!$apply) {
            $this->report[] = $fieldName . ': empty in the workbook - would attach ' . $identifier;
            return;
        }
        if ($this->attachFalFile($elementId, $fieldName, $storage->getFile($identifier), $pid) !== 'unchanged') {
            $this->report[] = $fieldName . ': placeholder ' . basename($identifier) . ' attached - swap in the real asset later';
        }
    }

    /**
     * Attach one FAL file, re-import-idempotent BY CONTENT (lesson
     * 2026-10-02): reuse the first live reference, delete surplus duplicates.
     */
    private function attachFalFile(string $elementId, string $fieldName, \TYPO3\CMS\Core\Resource\File $file, int|string $pid): string
    {
        if (!str_starts_with($elementId, 'NEW')) {
            $existingRefs = $this->liveReferences((int)$elementId, $fieldName);
            if ($existingRefs !== []) {
                $first = array_shift($existingRefs);
                $state = 'unchanged';
                if ((int)$first['uid_local'] !== $file->getUid()) {
                    $this->datamap['sys_file_reference'][(int)$first['uid']] = ['uid_local' => $file->getUid()];
                    $state = 'swapped';
                }
                foreach ($existingRefs as $surplus) {
                    $this->cmdmap['sys_file_reference'][(int)$surplus['uid']]['delete'] = 1;
                    $this->report[] = $fieldName . ': removed duplicate reference #' . $surplus['uid'];
                }
                return $state;
            }
        }
        $refId = $this->newId();
        // pid, tablenames and uid_foreign are REQUIRED - without them
        // DataHandler silently rejects the reference (lesson 2026-10-02).
        $this->datamap['sys_file_reference'][$refId] = [
            'pid' => $pid,
            'table_local' => 'sys_file',
            'uid_local' => $file->getUid(),
            'tablenames' => 'tt_content',
            'fieldname' => $fieldName,
            'uid_foreign' => str_starts_with($elementId, 'NEW') ? $elementId : (int)$elementId,
        ];
        $this->datamap['tt_content'][$elementId][$fieldName] = $refId;
        return 'attached';
    }

    /** @return array<int,array{uid:int,uid_local:int}> live refs on one field, oldest first */
    private function liveReferences(int $elementUid, string $fieldName): array
    {
        $connection = GeneralUtility::makeInstance(ConnectionPool::class)->getConnectionForTable('sys_file_reference');
        return array_map(
            static fn(array $r): array => ['uid' => (int)$r['uid'], 'uid_local' => (int)$r['uid_local']],
            $connection->fetchAllAssociative(
                "SELECT uid, uid_local FROM sys_file_reference
                 WHERE deleted = 0 AND hidden = 0 AND tablenames = 'tt_content'
                   AND fieldname = ? AND uid_foreign = ? ORDER BY uid",
                [$fieldName, $elementUid]
            )
        );
    }

    /**
     * Page abstract: tags stripped, whitespace collapsed, word-boundary cut
     * near 300 characters; SEO description as fallback.
     */
    private function abstractFrom(string $introHtml, string $fallback): string
    {
        $plain = trim((string)preg_replace('/\s+/u', ' ', html_entity_decode(strip_tags($introHtml), ENT_QUOTES | ENT_HTML5)));
        if ($plain === '') {
            return $fallback;
        }
        if (mb_strlen($plain) <= 300) {
            return $plain;
        }
        $cut = mb_substr($plain, 0, 300);
        $pos = mb_strrpos($cut, ' ');
        return rtrim(mb_substr($cut, 0, $pos ?: 300), ' ,;:.') . "\u{2026}";
    }

    /**
     * DataHandler flexform array for sheet sDEF.
     *
     * @param array<string,string> $settings
     * @return array<string,mixed>
     */
    private function flex(array $settings): array
    {
        $fields = [];
        foreach ($settings as $key => $value) {
            $fields[$key] = ['vDEF' => $value];
        }
        return ['data' => ['sDEF' => ['lDEF' => $fields]]];
    }

    private function newId(): string
    {
        return 'NEW' . str_pad((string)(++$this->newCounter), 6, '0', STR_PAD_LEFT) . substr(md5(uniqid('', true)), 0, 6);
    }

    private function norm(string $value): string
    {
        return (string)preg_replace('/[^a-z0-9]+/', '', str_replace('+', 'plus', mb_strtolower($value)));
    }
}