<?php
// SPDX-License-Identifier: GPL-3.0-or-later
declare(strict_types=1);

namespace Aiwend\Knowledge;

/**
 * Normalized extraction result. Sections keep the provenance needed for
 * truthful citations: an anchor that exists in the original (a heading slug
 * or a section ordinal), never a manufactured page number.
 */
final class Document
{
    /** @param list<array{anchor:string, heading:string, text:string}> $sections */
    public function __construct(
        public readonly string $title,
        public readonly array $sections,
        public readonly string $language = 'en',
    ) {
    }

    public function totalChars(): int
    {
        $n = 0;
        foreach ($this->sections as $s) {
            $n += mb_strlen($s['text']);
        }
        return $n;
    }
}