typesditac 1.0.0

package/dist/preprocess/UnifiedDocumentBuilder.js

@@ -0,0 +1,315 @@
+/*
+ * Portions Copyright (c) 2017-2025 XMLmind Software. All rights reserved.
+ * Author: Hussein Shafie
+ *
+ * Portions Copyright (c) 2026 Maxprograms SAS.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+import { XMLAttribute, XMLDocument } from "typesxml";
+import { LanguageUtils } from "typesbcp47";
+import { DitaElement } from "../dom/DitaElement.js";
+import { I18n } from "../i18n/I18n.js";
+import { DiagnosticLog } from "../utils/DiagnosticLog.js";
+import { DitaUtils } from "../utils/DitaUtils.js";
+import { DITAC_NS_URI } from "./ChunkDocumentBuilder.js";
+export class UnifiedDocumentBuilder {
+    i18n;
+    messages = new Map();
+    extendedToc = "none";
+    constructor(i18n) {
+        this.i18n = i18n;
+    }
+    static PLACEHOLDER_NAMES = new Set([
+        "ditac:titlePage", "ditac:toc", "ditac:figureList", "ditac:tableList",
+        "ditac:exampleList", "ditac:equationList", "ditac:indexList"
+    ]);
+    static MESSAGE_FILE_NAMES = [
+        "cs", "de", "en", "es", "fr", "it", "pl", "ru", "nn", "nb", "ja", "nl", "zh"
+    ];
+    static AUTO_TITLE_KEYS = new Map([
+        ["toc", "tableOfContents"],
+        ["figurelist", "listOfFigures"],
+        ["tablelist", "listOfTables"],
+        ["examplelist", "listOfExamples"],
+        ["equationlist", "listOfEquations"],
+        ["glossarylist", "glossary"],
+        ["indexlist", "index"]
+    ]);
+    static HEADING_KEYS = new Map([
+        ["ditac:toc", "tableOfContents"],
+        ["ditac:figureList", "listOfFigures"],
+        ["ditac:tableList", "listOfTables"],
+        ["ditac:exampleList", "listOfExamples"],
+        ["ditac:equationList", "listOfEquations"],
+        ["ditac:indexList", "index"]
+    ]);
+    setExtendedToc(extendedToc) {
+        this.extendedToc = extendedToc;
+    }
+    merge(map, chunkDocuments, listsDocument) {
+        return this.mergeStructured(map, chunkDocuments, listsDocument);
+    }
+    mergeStructured(map, chunkDocuments, listsDocument) {
+        const sourceRoot = DitaUtils.getRoot(map.document);
+        if (sourceRoot === undefined) {
+            throw new Error(this.i18n.format(this.i18n.getString("LoadedDocument", "documentHasNoRoot"), [map.path]));
+        }
+        const listsRoot = DitaUtils.getRoot(listsDocument);
+        const entriesByElement = new Map();
+        const topicrefsInOrder = [];
+        const usedTopicrefs = new Set();
+        this.collectContentTopicrefs(sourceRoot, topicrefsInOrder);
+        let fallbackTopicrefIndex = 0;
+        for (const chunkDocument of chunkDocuments.values()) {
+            const chunkRoot = DitaUtils.getRoot(chunkDocument);
+            if (chunkRoot === undefined) {
+                continue;
+            }
+            const children = chunkRoot.getChildren();
+            for (const child of children) {
+                const entry = this.resolvePlaceholder(child, listsRoot);
+                let topicref;
+                if (DitaUtils.hasClass(child, "topic/topic")) {
+                    while (fallbackTopicrefIndex < topicrefsInOrder.length && usedTopicrefs.has(topicrefsInOrder[fallbackTopicrefIndex])) {
+                        fallbackTopicrefIndex++;
+                    }
+                    topicref = topicrefsInOrder[fallbackTopicrefIndex++];
+                    if (topicref !== undefined) {
+                        usedTopicrefs.add(topicref);
+                    }
+                }
+                else {
+                    const target = this.findEntryTargetByName(sourceRoot, child.getName());
+                    if (target !== undefined) {
+                        this.addStructuredEntry(entriesByElement, target, entry);
+                    }
+                    continue;
+                }
+                if (topicref !== undefined) {
+                    this.addStructuredEntry(entriesByElement, topicref, entry);
+                }
+            }
+        }
+        const document = new XMLDocument();
+        const root = this.buildStructuredElement(sourceRoot, entriesByElement, listsRoot);
+        root.setAttribute(new XMLAttribute("xmlns:ditac", DITAC_NS_URI));
+        document.setRoot(root);
+        return document;
+    }
+    collectContentTopicrefs(element, topicrefs) {
+        for (const child of element.getChildren()) {
+            if (DitaUtils.hasClass(child, "map/topicref") &&
+                DitaUtils.getTopicrefHref(child) !== undefined &&
+                !this.isGeneratedListTarget(child)) {
+                topicrefs.push(child);
+            }
+            this.collectContentTopicrefs(child, topicrefs);
+        }
+    }
+    buildStructuredElement(source, entriesByElement, listsRoot) {
+        const result = DitaUtils.cloneElement(source);
+        result.setContent([]);
+        const entries = entriesByElement.get(source);
+        if (entries !== undefined) {
+            if (this.isGeneratedListTarget(source)) {
+                return DitaUtils.cloneElement(entries[0]);
+            }
+            for (const entry of entries) {
+                result.addElement(this.resolveGeneratedGlossaryTitle(source, entry));
+            }
+        }
+        else if (listsRoot !== undefined && UnifiedDocumentBuilder.PLACEHOLDER_NAMES.has(source.getName()) && source.getChildren().length === 0) {
+            result.addElement(this.resolvePlaceholder(source, listsRoot));
+        }
+        for (const child of source.getChildren()) {
+            result.addElement(this.buildStructuredElement(child, entriesByElement, listsRoot));
+        }
+        return result;
+    }
+    resolveGeneratedGlossaryTitle(parent, entry) {
+        if (!DitaUtils.hasClass(parent, "bookmap/glossarylist") || !DitaUtils.hasClass(entry, "topic/topic")) {
+            return entry;
+        }
+        const title = DitaUtils.getChildByClass(entry, "topic/title");
+        if (title === undefined || DitaUtils.getTitleTextFromChild(entry, false) !== "__AUTO__glossarylist__") {
+            return entry;
+        }
+        const resolved = DitaUtils.cloneElement(entry);
+        const resolvedTitle = DitaUtils.getChildByClass(resolved, "topic/title");
+        if (resolvedTitle !== undefined) {
+            resolvedTitle.setContent([]);
+            resolvedTitle.addString(this.localize("glossary", entry.getAttribute("xml:lang") !== undefined ? entry : parent));
+        }
+        return resolved;
+    }
+    isGeneratedListTarget(element) {
+        return DitaUtils.hasClass(element, "bookmap/toc") ||
+            DitaUtils.hasClass(element, "bookmap/figurelist") ||
+            DitaUtils.hasClass(element, "bookmap/tablelist") ||
+            DitaUtils.hasClass(element, "bookmap/examplelist") ||
+            DitaUtils.hasClass(element, "bookmap/equationlist") ||
+            DitaUtils.hasClass(element, "bookmap/indexlist");
+    }
+    addStructuredEntry(entriesByElement, target, entry) {
+        const entries = entriesByElement.get(target) ?? [];
+        entries.push(entry);
+        entriesByElement.set(target, entries);
+    }
+    findEntryTargetByName(root, name) {
+        const classes = new Map([
+            ["ditac:toc", "bookmap/toc"],
+            ["ditac:figureList", "bookmap/figurelist"],
+            ["ditac:tableList", "bookmap/tablelist"],
+            ["ditac:exampleList", "bookmap/examplelist"],
+            ["ditac:equationList", "bookmap/equationlist"],
+            ["ditac:indexList", "bookmap/indexlist"]
+        ]);
+        const className = classes.get(name);
+        if (className === undefined) {
+            return root;
+        }
+        return this.findElementByClass(root, className);
+    }
+    findElementByClass(element, className) {
+        if (DitaUtils.hasClass(element, className)) {
+            return element;
+        }
+        for (const child of element.getChildren()) {
+            const found = this.findElementByClass(child, className);
+            if (found !== undefined) {
+                return found;
+            }
+        }
+        return undefined;
+    }
+    resolvePlaceholder(child, listsRoot) {
+        if (listsRoot !== undefined && UnifiedDocumentBuilder.PLACEHOLDER_NAMES.has(child.getName()) && child.getChildren().length === 0) {
+            const section = listsRoot.getChildren().find((candidate) => candidate.getName() === child.getName());
+            if (section !== undefined) {
+                const resolved = DitaUtils.cloneElement(section);
+                if (section.getName() === "ditac:toc" && listsRoot !== undefined) {
+                    this.addExtendedTOC(resolved, listsRoot, section);
+                }
+                if (resolved.getChildren().length > 0) {
+                    this.addHeading(resolved, section);
+                }
+                return resolved;
+            }
+        }
+        return DitaUtils.cloneElement(child);
+    }
+    addExtendedTOC(toc, listsRoot, context) {
+        const content = toc.getContent();
+        if (this.extendedToc === "frontmatter" || this.extendedToc === "both") {
+            const frontmatterTOC = this.extendedTOCGroup(listsRoot, "ditac:frontmatterTOC", context);
+            if (frontmatterTOC !== undefined) {
+                content.unshift(frontmatterTOC);
+            }
+        }
+        if (this.extendedToc === "backmatter" || this.extendedToc === "both") {
+            const backmatterTOC = this.extendedTOCGroup(listsRoot, "ditac:backmatterTOC", context);
+            if (backmatterTOC !== undefined) {
+                content.push(backmatterTOC);
+            }
+        }
+        toc.setContent(content);
+    }
+    extendedTOCGroup(listsRoot, name, context) {
+        const source = listsRoot.getChildren().find((candidate) => candidate.getName() === name);
+        if (source === undefined) {
+            return undefined;
+        }
+        const group = DitaUtils.cloneElement(source);
+        this.prepareExtendedEntries(group, context);
+        return group.getChildren().length > 0 ? group : undefined;
+    }
+    prepareExtendedEntries(parent, context) {
+        const content = [];
+        for (const node of parent.getContent()) {
+            if (node instanceof DitaElement) {
+                const id = node.getAttribute("id")?.getValue() ?? "";
+                if (node.getAttribute("role")?.getValue() === "toc" && id.startsWith("__AUTO__")) {
+                    continue;
+                }
+                this.localizeAutoTitle(node, context);
+                this.prepareExtendedEntries(node, context);
+            }
+            content.push(node);
+        }
+        parent.setContent(content);
+    }
+    localizeAutoTitle(entry, context) {
+        const title = entry.getAttribute("title")?.getValue() ?? "";
+        if (!title.startsWith("__AUTO__") || !title.endsWith("__")) {
+            return;
+        }
+        const key = UnifiedDocumentBuilder.AUTO_TITLE_KEYS.get(title.substring(8, title.length - 2));
+        if (key !== undefined) {
+            entry.setAttribute(new XMLAttribute("title", this.localize(key, context)));
+        }
+    }
+    addHeading(element, context) {
+        const key = UnifiedDocumentBuilder.HEADING_KEYS.get(element.getName());
+        if (key === undefined) {
+            return;
+        }
+        const heading = new DitaElement("title");
+        heading.setAttribute(new XMLAttribute("class", "- topic/title "));
+        heading.addString(this.localize(key, context));
+        const content = element.getContent();
+        content.unshift(heading);
+        element.setContent(content);
+    }
+    localize(key, context) {
+        const lang = UnifiedDocumentBuilder.contextLang(context);
+        let messageFileName = "en";
+        if (UnifiedDocumentBuilder.MESSAGE_FILE_NAMES.includes(lang)) {
+            messageFileName = lang;
+        }
+        else {
+            const hyphen = lang.indexOf("-");
+            const lang3 = hyphen >= 0 ? lang.substring(0, hyphen) : "";
+            if (UnifiedDocumentBuilder.MESSAGE_FILE_NAMES.includes(lang3)) {
+                messageFileName = lang3;
+            }
+        }
+        const missing = "!" + key + "!";
+        const value = this.messageFile(messageFileName).getString("GeneratedListTopicBuilder", key);
+        if (value !== missing) {
+            return value;
+        }
+        const enValue = this.messageFile("en").getString("GeneratedListTopicBuilder", key);
+        return enValue !== missing ? enValue : key;
+    }
+    messageFile(name) {
+        let file = this.messages.get(name);
+        if (file === undefined) {
+            file = I18n.load(DiagnosticLog.I18N_DIRECTORY, "typesditac", name);
+            this.messages.set(name, file);
+        }
+        return file;
+    }
+    static contextLang(context) {
+        let lang = "en";
+        let current = context;
+        while (current !== undefined) {
+            const attribute = current.getAttribute("xml:lang");
+            if (attribute !== undefined) {
+                const normalized = LanguageUtils.normalizeCode(attribute.getValue().trim());
+                if (normalized !== undefined) {
+                    lang = normalized;
+                    break;
+                }
+            }
+            current = current.getParent();
+        }
+        return lang;
+    }
+}
+//# sourceMappingURL=UnifiedDocumentBuilder.js.map

package/dist/preprocess/UnifiedDocumentBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnifiedDocumentBuilder.js","sourceRoot":"","sources":["../../ts/preprocess/UnifiedDocumentBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Portions Copyright (c) 2017-2025 XMLmind Software. All rights reserved.\n * Author: Hussein Shafie\n *\n * Portions Copyright (c) 2026 Maxprograms SAS.\n *\n * This Source Code Form is subject to the terms of the Mozilla Public\n * License, v. 2.0. If a copy of the MPL was not distributed with this\n * file, You can obtain one at https://mozilla.org/MPL/2.0/.\n *\n * This Source Code Form is \"Incompatible With Secondary Licenses\", as\n * defined by the Mozilla Public License, v. 2.0.\n */\n\nimport { XMLAttribute, XMLDocument, XMLNode } from \"typesxml\";\nimport { LanguageUtils } from \"typesbcp47\";\nimport { DitaElement } from \"../dom/DitaElement.js\";\nimport { I18n } from \"../i18n/I18n.js\";\nimport { DiagnosticLog } from \"../utils/DiagnosticLog.js\";\nimport { DitaUtils } from \"../utils/DitaUtils.js\";\nimport { DITAC_NS_URI } from \"./ChunkDocumentBuilder.js\";\nimport { LoadedDocument } from \"./LoadedDocument.js\";\n\nexport class UnifiedDocumentBuilder {\n    private readonly i18n: I18n;\n    private readonly messages: Map<string, I18n> = new Map<string, I18n>();\n    private extendedToc: string = \"none\";\n\n    constructor(i18n: I18n) {\n        this.i18n = i18n;\n    }\n\n    private static readonly PLACEHOLDER_NAMES: Set<string> = new Set([\n        \"ditac:titlePage\", \"ditac:toc\", \"ditac:figureList\", \"ditac:tableList\",\n        \"ditac:exampleList\", \"ditac:equationList\", \"ditac:indexList\"\n    ]);\n\n    private static readonly MESSAGE_FILE_NAMES: string[] = [\n        \"cs\", \"de\", \"en\", \"es\", \"fr\", \"it\", \"pl\", \"ru\", \"nn\", \"nb\", \"ja\", \"nl\", \"zh\"\n    ];\n\n    private static readonly AUTO_TITLE_KEYS: Map<string, string> = new Map([\n        [\"toc\", \"tableOfContents\"],\n        [\"figurelist\", \"listOfFigures\"],\n        [\"tablelist\", \"listOfTables\"],\n        [\"examplelist\", \"listOfExamples\"],\n        [\"equationlist\", \"listOfEquations\"],\n        [\"glossarylist\", \"glossary\"],\n        [\"indexlist\", \"index\"]\n    ]);\n\n    private static readonly HEADING_KEYS: Map<string, string> = new Map([\n        [\"ditac:toc\", \"tableOfContents\"],\n        [\"ditac:figureList\", \"listOfFigures\"],\n        [\"ditac:tableList\", \"listOfTables\"],\n        [\"ditac:exampleList\", \"listOfExamples\"],\n        [\"ditac:equationList\", \"listOfEquations\"],\n        [\"ditac:indexList\", \"index\"]\n    ]);\n\n    setExtendedToc(extendedToc: string): void {\n        this.extendedToc = extendedToc;\n    }\n\n    merge(map: LoadedDocument, chunkDocuments: ReadonlyMap<string, XMLDocument>, listsDocument: XMLDocument): XMLDocument {\n        return this.mergeStructured(map, chunkDocuments, listsDocument);\n    }\n\n    mergeStructured(\n        map: LoadedDocument,\n        chunkDocuments: ReadonlyMap<string, XMLDocument>,\n        listsDocument: XMLDocument\n    ): XMLDocument {\n        const sourceRoot: DitaElement | undefined = DitaUtils.getRoot(map.document);\n        if (sourceRoot === undefined) {\n            throw new Error(this.i18n.format(this.i18n.getString(\"LoadedDocument\", \"documentHasNoRoot\"), [map.path]));\n        }\n        const listsRoot: DitaElement | undefined = DitaUtils.getRoot(listsDocument);\n        const entriesByElement: Map<DitaElement, DitaElement[]> = new Map<DitaElement, DitaElement[]>();\n        const topicrefsInOrder: DitaElement[] = [];\n        const usedTopicrefs: Set<DitaElement> = new Set<DitaElement>();\n        this.collectContentTopicrefs(sourceRoot, topicrefsInOrder);\n        let fallbackTopicrefIndex: number = 0;\n        for (const chunkDocument of chunkDocuments.values()) {\n            const chunkRoot: DitaElement | undefined = DitaUtils.getRoot(chunkDocument);\n            if (chunkRoot === undefined) {\n                continue;\n            }\n            const children: DitaElement[] = chunkRoot.getChildren();\n            for (const child of children) {\n                const entry: DitaElement = this.resolvePlaceholder(child, listsRoot);\n                let topicref: DitaElement | undefined;\n                if (DitaUtils.hasClass(child, \"topic/topic\")) {\n                    while (fallbackTopicrefIndex < topicrefsInOrder.length && usedTopicrefs.has(topicrefsInOrder[fallbackTopicrefIndex])) {\n                        fallbackTopicrefIndex++;\n                    }\n                    topicref = topicrefsInOrder[fallbackTopicrefIndex++];\n                    if (topicref !== undefined) {\n                        usedTopicrefs.add(topicref);\n                    }\n                } else {\n                    const target: DitaElement | undefined = this.findEntryTargetByName(sourceRoot, child.getName());\n                    if (target !== undefined) {\n                        this.addStructuredEntry(entriesByElement, target, entry);\n                    }\n                    continue;\n                }\n                if (topicref !== undefined) {\n                    this.addStructuredEntry(entriesByElement, topicref, entry);\n                }\n            }\n        }\n        const document: XMLDocument = new XMLDocument();\n        const root: DitaElement = this.buildStructuredElement(sourceRoot, entriesByElement, listsRoot);\n        root.setAttribute(new XMLAttribute(\"xmlns:ditac\", DITAC_NS_URI));\n        document.setRoot(root);\n        return document;\n    }\n\n    private collectContentTopicrefs(element: DitaElement, topicrefs: DitaElement[]): void {\n        for (const child of element.getChildren()) {\n            if (DitaUtils.hasClass(child, \"map/topicref\") &&\n                DitaUtils.getTopicrefHref(child) !== undefined &&\n                !this.isGeneratedListTarget(child)) {\n                topicrefs.push(child);\n            }\n            this.collectContentTopicrefs(child, topicrefs);\n        }\n    }\n\n    private buildStructuredElement(\n        source: DitaElement,\n        entriesByElement: ReadonlyMap<DitaElement, DitaElement[]>,\n        listsRoot: DitaElement | undefined\n    ): DitaElement {\n        const result: DitaElement = DitaUtils.cloneElement(source);\n        result.setContent([]);\n        const entries: DitaElement[] | undefined = entriesByElement.get(source);\n        if (entries !== undefined) {\n            if (this.isGeneratedListTarget(source)) {\n                return DitaUtils.cloneElement(entries[0]);\n            }\n            for (const entry of entries) {\n                result.addElement(this.resolveGeneratedGlossaryTitle(source, entry));\n            }\n        } else if (listsRoot !== undefined && UnifiedDocumentBuilder.PLACEHOLDER_NAMES.has(source.getName()) && source.getChildren().length === 0) {\n            result.addElement(this.resolvePlaceholder(source, listsRoot));\n        }\n        for (const child of source.getChildren()) {\n            result.addElement(this.buildStructuredElement(child, entriesByElement, listsRoot));\n        }\n        return result;\n    }\n\n    private resolveGeneratedGlossaryTitle(parent: DitaElement, entry: DitaElement): DitaElement {\n        if (!DitaUtils.hasClass(parent, \"bookmap/glossarylist\") || !DitaUtils.hasClass(entry, \"topic/topic\")) {\n            return entry;\n        }\n        const title: DitaElement | undefined = DitaUtils.getChildByClass(entry, \"topic/title\");\n        if (title === undefined || DitaUtils.getTitleTextFromChild(entry, false) !== \"__AUTO__glossarylist__\") {\n            return entry;\n        }\n        const resolved: DitaElement = DitaUtils.cloneElement(entry);\n        const resolvedTitle: DitaElement | undefined = DitaUtils.getChildByClass(resolved, \"topic/title\");\n        if (resolvedTitle !== undefined) {\n            resolvedTitle.setContent([]);\n            resolvedTitle.addString(this.localize(\"glossary\", entry.getAttribute(\"xml:lang\") !== undefined ? entry : parent));\n        }\n        return resolved;\n    }\n\n    private isGeneratedListTarget(element: DitaElement): boolean {\n        return DitaUtils.hasClass(element, \"bookmap/toc\") ||\n            DitaUtils.hasClass(element, \"bookmap/figurelist\") ||\n            DitaUtils.hasClass(element, \"bookmap/tablelist\") ||\n            DitaUtils.hasClass(element, \"bookmap/examplelist\") ||\n            DitaUtils.hasClass(element, \"bookmap/equationlist\") ||\n            DitaUtils.hasClass(element, \"bookmap/indexlist\");\n    }\n\n    private addStructuredEntry(entriesByElement: Map<DitaElement, DitaElement[]>, target: DitaElement, entry: DitaElement): void {\n        const entries: DitaElement[] = entriesByElement.get(target) ?? [];\n        entries.push(entry);\n        entriesByElement.set(target, entries);\n    }\n\n    private findEntryTargetByName(root: DitaElement, name: string): DitaElement | undefined {\n        const classes: Map<string, string> = new Map<string, string>([\n            [\"ditac:toc\", \"bookmap/toc\"],\n            [\"ditac:figureList\", \"bookmap/figurelist\"],\n            [\"ditac:tableList\", \"bookmap/tablelist\"],\n            [\"ditac:exampleList\", \"bookmap/examplelist\"],\n            [\"ditac:equationList\", \"bookmap/equationlist\"],\n            [\"ditac:indexList\", \"bookmap/indexlist\"]\n        ]);\n        const className: string | undefined = classes.get(name);\n        if (className === undefined) {\n            return root;\n        }\n        return this.findElementByClass(root, className);\n    }\n\n    private findElementByClass(element: DitaElement, className: string): DitaElement | undefined {\n        if (DitaUtils.hasClass(element, className)) {\n            return element;\n        }\n        for (const child of element.getChildren()) {\n            const found: DitaElement | undefined = this.findElementByClass(child, className);\n            if (found !== undefined) {\n                return found;\n            }\n        }\n        return undefined;\n    }\n\n    private resolvePlaceholder(child: DitaElement, listsRoot: DitaElement | undefined): DitaElement {\n        if (listsRoot !== undefined && UnifiedDocumentBuilder.PLACEHOLDER_NAMES.has(child.getName()) && child.getChildren().length === 0) {\n            const section: DitaElement | undefined = listsRoot.getChildren().find(\n                (candidate: DitaElement): boolean => candidate.getName() === child.getName()\n            );\n            if (section !== undefined) {\n                const resolved: DitaElement = DitaUtils.cloneElement(section);\n                if (section.getName() === \"ditac:toc\" && listsRoot !== undefined) {\n                    this.addExtendedTOC(resolved, listsRoot, section);\n                }\n                if (resolved.getChildren().length > 0) {\n                    this.addHeading(resolved, section);\n                }\n                return resolved;\n            }\n        }\n        return DitaUtils.cloneElement(child);\n    }\n\n    private addExtendedTOC(toc: DitaElement, listsRoot: DitaElement, context: DitaElement): void {\n        const content: XMLNode[] = toc.getContent();\n        if (this.extendedToc === \"frontmatter\" || this.extendedToc === \"both\") {\n            const frontmatterTOC: DitaElement | undefined = this.extendedTOCGroup(listsRoot, \"ditac:frontmatterTOC\", context);\n            if (frontmatterTOC !== undefined) {\n                content.unshift(frontmatterTOC);\n            }\n        }\n        if (this.extendedToc === \"backmatter\" || this.extendedToc === \"both\") {\n            const backmatterTOC: DitaElement | undefined = this.extendedTOCGroup(listsRoot, \"ditac:backmatterTOC\", context);\n            if (backmatterTOC !== undefined) {\n                content.push(backmatterTOC);\n            }\n        }\n        toc.setContent(content);\n    }\n\n    private extendedTOCGroup(listsRoot: DitaElement, name: string, context: DitaElement): DitaElement | undefined {\n        const source: DitaElement | undefined = listsRoot.getChildren().find(\n            (candidate: DitaElement): boolean => candidate.getName() === name\n        );\n        if (source === undefined) {\n            return undefined;\n        }\n        const group: DitaElement = DitaUtils.cloneElement(source);\n        this.prepareExtendedEntries(group, context);\n        return group.getChildren().length > 0 ? group : undefined;\n    }\n\n    private prepareExtendedEntries(parent: DitaElement, context: DitaElement): void {\n        const content: XMLNode[] = [];\n        for (const node of parent.getContent()) {\n            if (node instanceof DitaElement) {\n                const id: string = node.getAttribute(\"id\")?.getValue() ?? \"\";\n                if (node.getAttribute(\"role\")?.getValue() === \"toc\" && id.startsWith(\"__AUTO__\")) {\n                    continue;\n                }\n                this.localizeAutoTitle(node, context);\n                this.prepareExtendedEntries(node, context);\n            }\n            content.push(node);\n        }\n        parent.setContent(content);\n    }\n\n    private localizeAutoTitle(entry: DitaElement, context: DitaElement): void {\n        const title: string = entry.getAttribute(\"title\")?.getValue() ?? \"\";\n        if (!title.startsWith(\"__AUTO__\") || !title.endsWith(\"__\")) {\n            return;\n        }\n        const key: string | undefined = UnifiedDocumentBuilder.AUTO_TITLE_KEYS.get(title.substring(8, title.length - 2));\n        if (key !== undefined) {\n            entry.setAttribute(new XMLAttribute(\"title\", this.localize(key, context)));\n        }\n    }\n\n    private addHeading(element: DitaElement, context: DitaElement): void {\n        const key: string | undefined = UnifiedDocumentBuilder.HEADING_KEYS.get(element.getName());\n        if (key === undefined) {\n            return;\n        }\n        const heading: DitaElement = new DitaElement(\"title\");\n        heading.setAttribute(new XMLAttribute(\"class\", \"- topic/title \"));\n        heading.addString(this.localize(key, context));\n        const content: XMLNode[] = element.getContent();\n        content.unshift(heading);\n        element.setContent(content);\n    }\n\n    private localize(key: string, context: DitaElement): string {\n        const lang: string = UnifiedDocumentBuilder.contextLang(context);\n        let messageFileName: string = \"en\";\n        if (UnifiedDocumentBuilder.MESSAGE_FILE_NAMES.includes(lang)) {\n            messageFileName = lang;\n        } else {\n            const hyphen: number = lang.indexOf(\"-\");\n            const lang3: string = hyphen >= 0 ? lang.substring(0, hyphen) : \"\";\n            if (UnifiedDocumentBuilder.MESSAGE_FILE_NAMES.includes(lang3)) {\n                messageFileName = lang3;\n            }\n        }\n        const missing: string = \"!\" + key + \"!\";\n        const value: string = this.messageFile(messageFileName).getString(\"GeneratedListTopicBuilder\", key);\n        if (value !== missing) {\n            return value;\n        }\n        const enValue: string = this.messageFile(\"en\").getString(\"GeneratedListTopicBuilder\", key);\n        return enValue !== missing ? enValue : key;\n    }\n\n    private messageFile(name: string): I18n {\n        let file: I18n | undefined = this.messages.get(name);\n        if (file === undefined) {\n            file = I18n.load(DiagnosticLog.I18N_DIRECTORY, \"typesditac\", name);\n            this.messages.set(name, file);\n        }\n        return file;\n    }\n\n    private static contextLang(context: DitaElement): string {\n        let lang: string = \"en\";\n        let current: DitaElement | undefined = context;\n        while (current !== undefined) {\n            const attribute: XMLAttribute | undefined = current.getAttribute(\"xml:lang\");\n            if (attribute !== undefined) {\n                const normalized: string | undefined = LanguageUtils.normalizeCode(attribute.getValue().trim());\n                if (normalized !== undefined) {\n                    lang = normalized;\n                    break;\n                }\n            }\n            current = current.getParent();\n        }\n        return lang;\n    }\n}\n"]}

package/dist/preprocess/WrapTopicrefTitle.d.ts

@@ -0,0 +1,12 @@
+import { DitaElement } from "../dom/DitaElement.js";
+import { LoadedDocuments } from "./LoadedDocuments.js";
+export declare class WrapTopicrefTitle {
+    static readonly BASENAME_PREFIX: string;
+    private static counter;
+    static processMap(map: DitaElement, mapPath: string, documents: LoadedDocuments): void;
+    private static process;
+    private static isBooklistPlaceholder;
+    private static createTitleContainer;
+    private static copyChildren;
+    private static nextId;
+}

package/dist/preprocess/WrapTopicrefTitle.js

@@ -0,0 +1,121 @@
+/*
+ * Portions Copyright (c) 2017-2023 XMLmind Software. All rights reserved.
+ * Author: Hussein Shafie
+ *
+ * Portions Copyright (c) 2026 Maxprograms SAS.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+ * This Source Code Form is "Incompatible With Secondary Licenses", as
+ * defined by the Mozilla Public License, v. 2.0.
+ */
+import { ProcessingInstruction, TextNode, XMLAttribute, XMLDocument } from "typesxml";
+import { DitaElement } from "../dom/DitaElement.js";
+import { DitaUtils } from "../utils/DitaUtils.js";
+export class WrapTopicrefTitle {
+    static BASENAME_PREFIX = "__TITLE";
+    static counter = 0;
+    static processMap(map, mapPath, documents) {
+        const urlPrefix = DitaUtils.resolveDocumentPath(mapPath, WrapTopicrefTitle.BASENAME_PREFIX);
+        WrapTopicrefTitle.process(map, urlPrefix, documents);
+    }
+    static process(element, urlPrefix, documents) {
+        for (const child of element.getChildren()) {
+            if (!DitaUtils.hasClass(child, "map/topicref") || WrapTopicrefTitle.isBooklistPlaceholder(child, element)) {
+                continue;
+            }
+            // Raw (untrimmed, "???" not filtered) check.
+            const href = child.getAttribute("href")?.getValue();
+            if (href === undefined || href.length === 0) {
+                const topicDoc = WrapTopicrefTitle.createTitleContainer(child);
+                if (topicDoc !== undefined) {
+                    const topic = DitaUtils.getRoot(topicDoc);
+                    if (topic !== undefined) {
+                        const suffix = (++WrapTopicrefTitle.counter).toString(36);
+                        const path = urlPrefix + suffix + ".dita";
+                        const synthDoc = documents.put(path, topicDoc, false);
+                        synthDoc.setProperty("syntheticDocument", true);
+                        const id = topic.getAttribute("id")?.getValue();
+                        child.setAttribute(new XMLAttribute("href", id === undefined ? path : path + "#" + id));
+                    }
+                }
+            }
+            WrapTopicrefTitle.process(child, urlPrefix, documents);
+        }
+    }
+    static isBooklistPlaceholder(topicref, parent) {
+        return DitaUtils.hasClass(parent, "bookmap/booklists") &&
+            DitaUtils.getNonEmptyAttribute(topicref, "href") === undefined &&
+            DitaUtils.getChildByClass(topicref, "map/topicref") === undefined;
+    }
+    static createTitleContainer(topicref) {
+        // We need a navtitle, no matter @locktype.
+        let navtitle;
+        let navtitleText;
+        let shortdesc;
+        const topicmeta = DitaUtils.getChildByClass(topicref, "map/topicmeta");
+        if (topicmeta !== undefined) {
+            navtitle = DitaUtils.getChildByClass(topicmeta, "topic/navtitle");
+            shortdesc = DitaUtils.getChildByClass(topicmeta, "map/shortdesc");
+        }
+        if (navtitle === undefined) {
+            const attribute = DitaUtils.getNonEmptyAttribute(topicref, "navtitle");
+            if (attribute !== undefined) {
+                const collapsed = DitaUtils.collapseWhitespace(attribute);
+                navtitleText = collapsed.length === 0 ? undefined : collapsed;
+            }
+        }
+        if (navtitle === undefined && navtitleText === undefined &&
+            DitaUtils.getChildByClass(topicref, "map/topicref") !== undefined) {
+            for (const cls of DitaUtils.ROOT_ROLES) {
+                if (DitaUtils.hasClass(topicref, cls)) {
+                    navtitleText = "__AUTO__" + cls.slice(cls.lastIndexOf("/") + 1) + "__";
+                    break;
+                }
+            }
+        }
+        if (navtitle === undefined && navtitleText === undefined) {
+            return undefined;
+        }
+        const doc = new XMLDocument();
+        const topic = new DitaElement("topic");
+        topic.setAttribute(new XMLAttribute("class", "- topic/topic "));
+        topic.setAttribute(new XMLAttribute("id", WrapTopicrefTitle.nextId()));
+        doc.setRoot(topic);
+        const title = new DitaElement("title");
+        title.setAttribute(new XMLAttribute("class", "- topic/title "));
+        topic.addElement(title);
+        if (navtitle !== undefined) {
+            WrapTopicrefTitle.copyChildren(navtitle, title);
+        }
+        else {
+            title.addString(navtitleText);
+        }
+        if (shortdesc !== undefined) {
+            const desc = new DitaElement("shortdesc");
+            desc.setAttribute(new XMLAttribute("class", "- map/shortdesc "));
+            topic.addElement(desc);
+            WrapTopicrefTitle.copyChildren(shortdesc, desc);
+        }
+        return doc;
+    }
+    static copyChildren(source, target) {
+        for (const node of source.getContent()) {
+            if (node instanceof DitaElement) {
+                target.addElement(DitaUtils.cloneElement(node));
+            }
+            else if (node instanceof TextNode) {
+                target.addTextNode(new TextNode(node.getValue()));
+            }
+            else if (node instanceof ProcessingInstruction) {
+                target.addProcessingInstruction(new ProcessingInstruction(node.getTarget(), node.getData()));
+            }
+        }
+    }
+    static nextId() {
+        return "I_" + (++WrapTopicrefTitle.counter).toString(36) + "_";
+    }
+}
+//# sourceMappingURL=WrapTopicrefTitle.js.map

package/dist/preprocess/WrapTopicrefTitle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WrapTopicrefTitle.js","sourceRoot":"","sources":["../../ts/preprocess/WrapTopicrefTitle.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Portions Copyright (c) 2017-2023 XMLmind Software. All rights reserved.\n * Author: Hussein Shafie\n *\n * Portions Copyright (c) 2026 Maxprograms SAS.\n *\n * This Source Code Form is subject to the terms of the Mozilla Public\n * License, v. 2.0. If a copy of the MPL was not distributed with this\n * file, You can obtain one at https://mozilla.org/MPL/2.0/.\n *\n * This Source Code Form is \"Incompatible With Secondary Licenses\", as\n * defined by the Mozilla Public License, v. 2.0.\n */\n\nimport { ProcessingInstruction, TextNode, XMLAttribute, XMLDocument } from \"typesxml\";\nimport { DitaElement } from \"../dom/DitaElement.js\";\nimport { DitaUtils } from \"../utils/DitaUtils.js\";\nimport { LoadedDocument } from \"./LoadedDocument.js\";\nimport { LoadedDocuments } from \"./LoadedDocuments.js\";\n\nexport class WrapTopicrefTitle {\n    static readonly BASENAME_PREFIX: string = \"__TITLE\";\n\n    private static counter: number = 0;\n\n    static processMap(map: DitaElement, mapPath: string, documents: LoadedDocuments): void {\n        const urlPrefix: string = DitaUtils.resolveDocumentPath(mapPath, WrapTopicrefTitle.BASENAME_PREFIX);\n        WrapTopicrefTitle.process(map, urlPrefix, documents);\n    }\n\n    private static process(element: DitaElement, urlPrefix: string, documents: LoadedDocuments): void {\n        for (const child of element.getChildren()) {\n            if (!DitaUtils.hasClass(child, \"map/topicref\") || WrapTopicrefTitle.isBooklistPlaceholder(child, element)) {\n                continue;\n            }\n\n            // Raw (untrimmed, \"???\" not filtered) check.\n            const href: string | undefined = child.getAttribute(\"href\")?.getValue();\n            if (href === undefined || href.length === 0) {\n                const topicDoc: XMLDocument | undefined = WrapTopicrefTitle.createTitleContainer(child);\n                if (topicDoc !== undefined) {\n                    const topic: DitaElement | undefined = DitaUtils.getRoot(topicDoc);\n                    if (topic !== undefined) {\n                        const suffix: string = (++WrapTopicrefTitle.counter).toString(36);\n                        const path: string = urlPrefix + suffix + \".dita\";\n                        const synthDoc: LoadedDocument = documents.put(path, topicDoc, false);\n                        synthDoc.setProperty(\"syntheticDocument\", true);\n                        const id: string | undefined = topic.getAttribute(\"id\")?.getValue();\n                        child.setAttribute(new XMLAttribute(\"href\", id === undefined ? path : path + \"#\" + id));\n                    }\n                }\n            }\n\n            WrapTopicrefTitle.process(child, urlPrefix, documents);\n        }\n    }\n\n    private static isBooklistPlaceholder(topicref: DitaElement, parent: DitaElement): boolean {\n        return DitaUtils.hasClass(parent, \"bookmap/booklists\") &&\n            DitaUtils.getNonEmptyAttribute(topicref, \"href\") === undefined &&\n            DitaUtils.getChildByClass(topicref, \"map/topicref\") === undefined;\n    }\n\n    private static createTitleContainer(topicref: DitaElement): XMLDocument | undefined {\n        // We need a navtitle, no matter @locktype.\n        let navtitle: DitaElement | undefined;\n        let navtitleText: string | undefined;\n        let shortdesc: DitaElement | undefined;\n\n        const topicmeta: DitaElement | undefined = DitaUtils.getChildByClass(topicref, \"map/topicmeta\");\n        if (topicmeta !== undefined) {\n            navtitle = DitaUtils.getChildByClass(topicmeta, \"topic/navtitle\");\n            shortdesc = DitaUtils.getChildByClass(topicmeta, \"map/shortdesc\");\n        }\n\n        if (navtitle === undefined) {\n            const attribute: string | undefined = DitaUtils.getNonEmptyAttribute(topicref, \"navtitle\");\n            if (attribute !== undefined) {\n                const collapsed: string = DitaUtils.collapseWhitespace(attribute);\n                navtitleText = collapsed.length === 0 ? undefined : collapsed;\n            }\n        }\n\n        if (navtitle === undefined && navtitleText === undefined &&\n            DitaUtils.getChildByClass(topicref, \"map/topicref\") !== undefined) {\n            for (const cls of DitaUtils.ROOT_ROLES) {\n                if (DitaUtils.hasClass(topicref, cls)) {\n                    navtitleText = \"__AUTO__\" + cls.slice(cls.lastIndexOf(\"/\") + 1) + \"__\";\n                    break;\n                }\n            }\n        }\n\n        if (navtitle === undefined && navtitleText === undefined) {\n            return undefined;\n        }\n\n        const doc: XMLDocument = new XMLDocument();\n\n        const topic: DitaElement = new DitaElement(\"topic\");\n        topic.setAttribute(new XMLAttribute(\"class\", \"- topic/topic \"));\n        topic.setAttribute(new XMLAttribute(\"id\", WrapTopicrefTitle.nextId()));\n        doc.setRoot(topic);\n\n        const title: DitaElement = new DitaElement(\"title\");\n        title.setAttribute(new XMLAttribute(\"class\", \"- topic/title \"));\n        topic.addElement(title);\n\n        if (navtitle !== undefined) {\n            WrapTopicrefTitle.copyChildren(navtitle, title);\n        } else {\n            title.addString(navtitleText as string);\n        }\n\n        if (shortdesc !== undefined) {\n            const desc: DitaElement = new DitaElement(\"shortdesc\");\n            desc.setAttribute(new XMLAttribute(\"class\", \"- map/shortdesc \"));\n            topic.addElement(desc);\n\n            WrapTopicrefTitle.copyChildren(shortdesc, desc);\n        }\n\n        return doc;\n    }\n\n    private static copyChildren(source: DitaElement, target: DitaElement): void {\n        for (const node of source.getContent()) {\n            if (node instanceof DitaElement) {\n                target.addElement(DitaUtils.cloneElement(node));\n            } else if (node instanceof TextNode) {\n                target.addTextNode(new TextNode(node.getValue()));\n            } else if (node instanceof ProcessingInstruction) {\n                target.addProcessingInstruction(new ProcessingInstruction(node.getTarget(), node.getData()));\n            }\n        }\n    }\n\n    private static nextId(): string {\n        return \"I_\" + (++WrapTopicrefTitle.counter).toString(36) + \"_\";\n    }\n}\n"]}

package/dist/typesditac.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};