typesditac 1.0.0

package/dist/preprocess/GeneratedListTopicBuilder.js

@@ -0,0 +1,268 @@
+/*
+ * 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 } from "typesxml";
+import { DitaElement } from "../dom/DitaElement.js";
+import { DiacriticUtil } from "../utils/DiacriticUtil.js";
+import { DitaUtils } from "../utils/DitaUtils.js";
+import { ChunkEntryType } from "./ChunkEntry.js";
+import { IndexAnchorPair } from "./IndexAnchorPair.js";
+import { ListTargetType } from "./ListTarget.js";
+export class GeneratedListTopicBuilder {
+    diagnostics;
+    constructor(diagnostics) {
+        this.diagnostics = diagnostics;
+    }
+    buildTitlePage(map, forceTitlePage) {
+        const result = [];
+        const title = DitaUtils.getChildByClass(map, "topic/title");
+        if (title !== undefined) {
+            result.push(DitaUtils.cloneElement(title));
+        }
+        else {
+            const titleText = DitaUtils.getNonEmptyAttribute(map, "title");
+            if (forceTitlePage || titleText !== undefined) {
+                const synthesized = new DitaElement("title");
+                synthesized.setAttribute(new XMLAttribute("class", "- topic/title "));
+                if (titleText !== undefined) {
+                    synthesized.addString(DitaUtils.collapseWhitespace(titleText));
+                }
+                result.push(synthesized);
+            }
+        }
+        const metadata = DitaUtils.getChildByClass(map, "map/topicmeta");
+        if (metadata !== undefined) {
+            result.push(DitaUtils.cloneElement(metadata));
+        }
+        return result;
+    }
+    buildTOC(entries, tocType, chunkBaseName) {
+        const root = { children: [] };
+        const stack = [{ node: root }];
+        for (const entry of entries) {
+            let top = stack[stack.length - 1];
+            while (!this.isTOCParent(top.entry, entry)) {
+                stack.pop();
+                top = stack[stack.length - 1];
+            }
+            let node = { children: [] };
+            if (entry.tocType === tocType) {
+                const element = entry.getElement();
+                if (element === undefined || !DitaUtils.hasClass(element, "glossentry/glossentry")) {
+                    node = { entry, children: [] };
+                    top.node.children.push(node);
+                }
+            }
+            stack.push({ entry, node });
+        }
+        return this.renderTOCTree(root.children, chunkBaseName);
+    }
+    isTOCParent(parent, entry) {
+        if (parent === undefined) {
+            return true;
+        }
+        if (parent.type !== ChunkEntryType.TOPIC) {
+            return false;
+        }
+        const subRole = DitaUtils.getSubRole(parent.role);
+        if (subRole !== entry.role) {
+            return false;
+        }
+        const num1 = parent.number ?? [];
+        const num2 = entry.number ?? [];
+        if (num2.length !== num1.length + 1) {
+            return false;
+        }
+        for (let i = 0; i < num1.length; i++) {
+            if (num2[i] !== num1[i]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    renderTOCTree(nodes, chunkBaseName) {
+        const items = [];
+        for (const node of nodes) {
+            if (node.entry === undefined) {
+                continue;
+            }
+            items.push(this.createTOCEntry(node.entry, this.renderTOCTree(node.children, chunkBaseName), chunkBaseName));
+        }
+        return items;
+    }
+    createTOCEntry(entry, children, chunkBaseName) {
+        const tocEntry = new DitaElement("ditac:tocEntry");
+        tocEntry.setAttribute(new XMLAttribute("file", chunkBaseName(entry.chunk)));
+        tocEntry.setAttribute(new XMLAttribute("number", (entry.number ?? []).join(" ")));
+        tocEntry.setAttribute(new XMLAttribute("role", entry.role ?? ""));
+        const topicElement = entry.getElement();
+        let title;
+        let id;
+        if (topicElement !== undefined) {
+            title = DitaUtils.getTitleTextFromChild(topicElement, true) ?? entry.navtitle ?? "???";
+            id = topicElement.getAttribute("id")?.getValue() ?? "";
+        }
+        else {
+            const role = entry.role ?? "";
+            title = entry.navtitle ?? ("__AUTO__" + role + "__");
+            id = "__AUTO__" + role + "__";
+        }
+        tocEntry.setAttribute(new XMLAttribute("title", title));
+        tocEntry.setAttribute(new XMLAttribute("id", id));
+        for (const child of children) {
+            tocEntry.addElement(child);
+        }
+        return tocEntry;
+    }
+    buildFormalList(lists, type, resolveFile) {
+        if (type === ListTargetType.INDEX_TERM) {
+            return this.buildIndexList(lists.getIndexTerms(), resolveFile);
+        }
+        const qName = "ditac:" + type;
+        const result = [];
+        for (const target of lists.get(type)) {
+            const formalElement = new DitaElement(qName);
+            formalElement.setAttribute(new XMLAttribute("number", target.number ?? ""));
+            formalElement.setAttribute(new XMLAttribute("title", target.title ?? ""));
+            formalElement.setAttribute(new XMLAttribute("file", resolveFile(target.sourceTopic)));
+            formalElement.setAttribute(new XMLAttribute("id", target.targetId));
+            if (target.desc !== undefined) {
+                formalElement.addElement(this.createDescription(target.desc));
+            }
+            result.push(formalElement);
+        }
+        return result;
+    }
+    createDescription(desc) {
+        const description = new DitaElement("ditac:description");
+        description.setContent(DitaUtils.cloneElement(desc).getContent());
+        return description;
+    }
+    buildIndexList(entries, resolveFile) {
+        if (entries.length === 0) {
+            return [];
+        }
+        const termToId = new Map();
+        let idCounter = 0;
+        this.identifyIndexTerms(entries, undefined, termToId, () => "typesdita-indexentry-" + (++idCounter).toString());
+        const divs = [];
+        const symbolEntries = entries.filter((entry) => !this.startsWithLetter(this.groupKey(entry)));
+        if (symbolEntries.length > 0) {
+            divs.push(this.createIndexDiv("symbols", symbolEntries, termToId, resolveFile));
+        }
+        let currentLetter;
+        let currentGroup = [];
+        for (const entry of entries) {
+            const key = this.groupKey(entry);
+            if (!this.startsWithLetter(key)) {
+                continue;
+            }
+            const letter = DiacriticUtil.collapseChar(key.charAt(0)).toUpperCase();
+            if (letter !== currentLetter) {
+                if (currentLetter !== undefined) {
+                    divs.push(this.createIndexDiv(currentLetter, currentGroup, termToId, resolveFile));
+                }
+                currentLetter = letter;
+                currentGroup = [];
+            }
+            currentGroup.push(entry);
+        }
+        if (currentLetter !== undefined) {
+            divs.push(this.createIndexDiv(currentLetter, currentGroup, termToId, resolveFile));
+        }
+        return divs;
+    }
+    identifyIndexTerms(entries, parentKey, termToId, nextId) {
+        for (const entry of entries) {
+            const key = parentKey === undefined ? entry.term : parentKey + "\n" + entry.term;
+            termToId.set(key, nextId());
+            this.identifyIndexTerms(entry.getSubTermList() ?? [], key, termToId, nextId);
+        }
+    }
+    groupKey(entry) {
+        return entry.getSortAs() ?? entry.term;
+    }
+    startsWithLetter(value) {
+        return /^\p{L}/u.test(value);
+    }
+    createIndexDiv(title, entries, termToId, resolveFile) {
+        const div = new DitaElement("ditac:div");
+        div.setAttribute(new XMLAttribute("title", title));
+        for (const entry of entries) {
+            div.addElement(this.createIndexEntry(entry, undefined, termToId, resolveFile));
+        }
+        return div;
+    }
+    createIndexEntry(entry, parentKey, termToId, resolveFile) {
+        const key = parentKey === undefined ? entry.term : parentKey + "\n" + entry.term;
+        const id = termToId.get(key) ?? key;
+        const indexEntry = new DitaElement("ditac:indexEntry");
+        indexEntry.setAttribute(new XMLAttribute("id", id));
+        indexEntry.setAttribute(new XMLAttribute("term", entry.term));
+        if (entry.getSortAs() !== undefined) {
+            indexEntry.setAttribute(new XMLAttribute("sortAs", entry.getSortAs()));
+        }
+        let num = 0;
+        for (const anchor of entry.getAnchorList() ?? []) {
+            const indexAnchor = new DitaElement("ditac:indexAnchor");
+            num++;
+            indexAnchor.setAttribute(new XMLAttribute("number", num.toString()));
+            indexAnchor.setAttribute(new XMLAttribute("file", anchor.file));
+            indexAnchor.setAttribute(new XMLAttribute("id", anchor.getId()));
+            if (anchor instanceof IndexAnchorPair && anchor.getSource2() !== undefined) {
+                num++;
+                indexAnchor.setAttribute(new XMLAttribute("number2", num.toString()));
+                indexAnchor.setAttribute(new XMLAttribute("file2", anchor.getFile2() ?? ""));
+                indexAnchor.setAttribute(new XMLAttribute("id2", anchor.getId2() ?? ""));
+            }
+            indexEntry.addElement(indexAnchor);
+        }
+        for (const seeAlso of entry.getSeeAlsoList() ?? []) {
+            indexEntry.addElement(this.createIndexRef("ditac:indexSeeAlso", seeAlso, termToId));
+        }
+        for (const subTerm of entry.getSubTermList() ?? []) {
+            indexEntry.addElement(this.createIndexEntry(subTerm, key, termToId, resolveFile));
+        }
+        const seeList = entry.getSeeList() ?? [];
+        const anchors = entry.getAnchorList() ?? [];
+        const seeAlsoList = entry.getSeeAlsoList() ?? [];
+        const subTerms = entry.getSubTermList() ?? [];
+        const isSeeEntry = seeList.length > 0 && anchors.length === 0 &&
+            seeAlsoList.length === 0 && subTerms.length === 0;
+        if (isSeeEntry) {
+            for (const see of seeList) {
+                indexEntry.addElement(this.createIndexRef("ditac:indexSee", see, termToId));
+            }
+        }
+        else if (seeList.length > 0) {
+            for (const see of seeList) {
+                this.diagnostics.warning(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("IndexTerms", "seeOnNonLeafIndexTerm2"), [key.split("\n").join(" / ")]), "term=\"" + see.term.join(" / ") + "\"");
+            }
+        }
+        return indexEntry;
+    }
+    createIndexRef(name, ref, termToId) {
+        const redirection = ref.term.join("\n");
+        const targetId = termToId.get(redirection);
+        const element = new DitaElement(name);
+        element.setAttribute(new XMLAttribute("term", redirection));
+        if (targetId === undefined) {
+            this.diagnostics.warning(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("IndexTerms", "noSuchIndexTerm"), [ref.term.join(" / ")]), "term=\"" + ref.term.join(" / ") + "\"");
+        }
+        else {
+            element.setAttribute(new XMLAttribute("ref", targetId));
+        }
+        return element;
+    }
+}
+//# sourceMappingURL=GeneratedListTopicBuilder.js.map

package/dist/preprocess/GeneratedListTopicBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeneratedListTopicBuilder.js","sourceRoot":"","sources":["../../ts/preprocess/GeneratedListTopicBuilder.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 } from \"typesxml\";\nimport { DitaElement } from \"../dom/DitaElement.js\";\nimport { DiacriticUtil } from \"../utils/DiacriticUtil.js\";\nimport { DiagnosticLog } from \"../utils/DiagnosticLog.js\";\nimport { DitaUtils } from \"../utils/DitaUtils.js\";\nimport { Chunk } from \"./Chunk.js\";\nimport { ChunkEntry, ChunkEntryType, TocType } from \"./ChunkEntry.js\";\nimport { EmbeddedLists } from \"./EmbeddedLists.js\";\nimport { IndexAnchor } from \"./IndexAnchor.js\";\nimport { IndexAnchorPair } from \"./IndexAnchorPair.js\";\nimport { IndexTerm } from \"./IndexTerm.js\";\nimport { IndexTermRef } from \"./IndexTermRef.js\";\nimport { ListTarget, ListTargetType } from \"./ListTarget.js\";\nimport { LoadedTopic } from \"./LoadedTopic.js\";\n\ninterface TOCNode {\n    readonly entry?: ChunkEntry;\n    readonly children: TOCNode[];\n}\n\nexport class GeneratedListTopicBuilder {\n    readonly diagnostics: DiagnosticLog;\n\n    constructor(diagnostics: DiagnosticLog) {\n        this.diagnostics = diagnostics;\n    }\n\n    buildTitlePage(map: DitaElement, forceTitlePage: boolean): DitaElement[] {\n        const result: DitaElement[] = [];\n        const title: DitaElement | undefined = DitaUtils.getChildByClass(map, \"topic/title\");\n        if (title !== undefined) {\n            result.push(DitaUtils.cloneElement(title));\n        } else {\n            const titleText: string | undefined = DitaUtils.getNonEmptyAttribute(map, \"title\");\n            if (forceTitlePage || titleText !== undefined) {\n                const synthesized: DitaElement = new DitaElement(\"title\");\n                synthesized.setAttribute(new XMLAttribute(\"class\", \"- topic/title \"));\n                if (titleText !== undefined) {\n                    synthesized.addString(DitaUtils.collapseWhitespace(titleText));\n                }\n                result.push(synthesized);\n            }\n        }\n        const metadata: DitaElement | undefined = DitaUtils.getChildByClass(map, \"map/topicmeta\");\n        if (metadata !== undefined) {\n            result.push(DitaUtils.cloneElement(metadata));\n        }\n        return result;\n    }\n\n    buildTOC(entries: ChunkEntry[], tocType: TocType, chunkBaseName: (chunk: Chunk) => string): DitaElement[] {\n        interface StackFrame {\n            readonly entry?: ChunkEntry;\n            readonly node: TOCNode;\n        }\n        const root: TOCNode = { children: [] };\n        const stack: StackFrame[] = [{ node: root }];\n\n        for (const entry of entries) {\n            let top: StackFrame = stack[stack.length - 1];\n            while (!this.isTOCParent(top.entry, entry)) {\n                stack.pop();\n                top = stack[stack.length - 1];\n            }\n\n            let node: TOCNode = { children: [] };\n            if (entry.tocType === tocType) {\n                const element: DitaElement | undefined = entry.getElement();\n                if (element === undefined || !DitaUtils.hasClass(element, \"glossentry/glossentry\")) {\n                    node = { entry, children: [] };\n                    top.node.children.push(node);\n                }\n            }\n            stack.push({ entry, node });\n        }\n\n        return this.renderTOCTree(root.children, chunkBaseName);\n    }\n\n    private isTOCParent(parent: ChunkEntry | undefined, entry: ChunkEntry): boolean {\n        if (parent === undefined) {\n            return true;\n        }\n        if (parent.type !== ChunkEntryType.TOPIC) {\n            return false;\n        }\n        const subRole: string = DitaUtils.getSubRole(parent.role);\n        if (subRole !== entry.role) {\n            return false;\n        }\n        const num1: string[] = parent.number ?? [];\n        const num2: string[] = entry.number ?? [];\n        if (num2.length !== num1.length + 1) {\n            return false;\n        }\n        for (let i: number = 0; i < num1.length; i++) {\n            if (num2[i] !== num1[i]) {\n                return false;\n            }\n        }\n        return true;\n    }\n\n    private renderTOCTree(nodes: TOCNode[], chunkBaseName: (chunk: Chunk) => string): DitaElement[] {\n        const items: DitaElement[] = [];\n        for (const node of nodes) {\n            if (node.entry === undefined) {\n                continue;\n            }\n            items.push(this.createTOCEntry(node.entry, this.renderTOCTree(node.children, chunkBaseName), chunkBaseName));\n        }\n        return items;\n    }\n\n    private createTOCEntry(entry: ChunkEntry, children: DitaElement[], chunkBaseName: (chunk: Chunk) => string): DitaElement {\n        const tocEntry: DitaElement = new DitaElement(\"ditac:tocEntry\");\n        tocEntry.setAttribute(new XMLAttribute(\"file\", chunkBaseName(entry.chunk)));\n        tocEntry.setAttribute(new XMLAttribute(\"number\", (entry.number ?? []).join(\" \")));\n        tocEntry.setAttribute(new XMLAttribute(\"role\", entry.role ?? \"\"));\n\n        const topicElement: DitaElement | undefined = entry.getElement();\n        let title: string;\n        let id: string;\n        if (topicElement !== undefined) {\n            title = DitaUtils.getTitleTextFromChild(topicElement, true) ?? entry.navtitle ?? \"???\";\n            id = topicElement.getAttribute(\"id\")?.getValue() ?? \"\";\n        } else {\n            const role: string = entry.role ?? \"\";\n            title = entry.navtitle ?? (\"__AUTO__\" + role + \"__\");\n            id = \"__AUTO__\" + role + \"__\";\n        }\n        tocEntry.setAttribute(new XMLAttribute(\"title\", title));\n        tocEntry.setAttribute(new XMLAttribute(\"id\", id));\n\n        for (const child of children) {\n            tocEntry.addElement(child);\n        }\n        return tocEntry;\n    }\n\n    buildFormalList(lists: EmbeddedLists, type: ListTargetType, resolveFile: (topic: LoadedTopic) => string): DitaElement[] {\n        if (type === ListTargetType.INDEX_TERM) {\n            return this.buildIndexList(lists.getIndexTerms(), resolveFile);\n        }\n        const qName: string = \"ditac:\" + type;\n        const result: DitaElement[] = [];\n        for (const target of lists.get(type) as ListTarget[]) {\n            const formalElement: DitaElement = new DitaElement(qName);\n            formalElement.setAttribute(new XMLAttribute(\"number\", target.number ?? \"\"));\n            formalElement.setAttribute(new XMLAttribute(\"title\", target.title ?? \"\"));\n            formalElement.setAttribute(new XMLAttribute(\"file\", resolveFile(target.sourceTopic)));\n            formalElement.setAttribute(new XMLAttribute(\"id\", target.targetId));\n            if (target.desc !== undefined) {\n                formalElement.addElement(this.createDescription(target.desc));\n            }\n            result.push(formalElement);\n        }\n        return result;\n    }\n\n    private createDescription(desc: DitaElement): DitaElement {\n        const description: DitaElement = new DitaElement(\"ditac:description\");\n        description.setContent(DitaUtils.cloneElement(desc).getContent());\n        return description;\n    }\n\n    private buildIndexList(entries: IndexTerm[], resolveFile: (topic: LoadedTopic) => string): DitaElement[] {\n        if (entries.length === 0) {\n            return [];\n        }\n        const termToId: Map<string, string> = new Map<string, string>();\n        let idCounter: number = 0;\n        this.identifyIndexTerms(entries, undefined, termToId, (): string => \"typesdita-indexentry-\" + (++idCounter).toString());\n\n        const divs: DitaElement[] = [];\n\n        const symbolEntries: IndexTerm[] = entries.filter(\n            (entry: IndexTerm): boolean => !this.startsWithLetter(this.groupKey(entry))\n        );\n        if (symbolEntries.length > 0) {\n            divs.push(this.createIndexDiv(\"symbols\", symbolEntries, termToId, resolveFile));\n        }\n\n        let currentLetter: string | undefined;\n        let currentGroup: IndexTerm[] = [];\n        for (const entry of entries) {\n            const key: string = this.groupKey(entry);\n            if (!this.startsWithLetter(key)) {\n                continue;\n            }\n            const letter: string = DiacriticUtil.collapseChar(key.charAt(0)).toUpperCase();\n            if (letter !== currentLetter) {\n                if (currentLetter !== undefined) {\n                    divs.push(this.createIndexDiv(currentLetter, currentGroup, termToId, resolveFile));\n                }\n                currentLetter = letter;\n                currentGroup = [];\n            }\n            currentGroup.push(entry);\n        }\n        if (currentLetter !== undefined) {\n            divs.push(this.createIndexDiv(currentLetter, currentGroup, termToId, resolveFile));\n        }\n\n        return divs;\n    }\n\n    private identifyIndexTerms(\n        entries: IndexTerm[],\n        parentKey: string | undefined,\n        termToId: Map<string, string>,\n        nextId: () => string\n    ): void {\n        for (const entry of entries) {\n            const key: string = parentKey === undefined ? entry.term : parentKey + \"\\n\" + entry.term;\n            termToId.set(key, nextId());\n            this.identifyIndexTerms(entry.getSubTermList() ?? [], key, termToId, nextId);\n        }\n    }\n\n    private groupKey(entry: IndexTerm): string {\n        return entry.getSortAs() ?? entry.term;\n    }\n\n    private startsWithLetter(value: string): boolean {\n        return /^\\p{L}/u.test(value);\n    }\n\n    private createIndexDiv(title: string, entries: IndexTerm[], termToId: Map<string, string>, resolveFile: (topic: LoadedTopic) => string): DitaElement {\n        const div: DitaElement = new DitaElement(\"ditac:div\");\n        div.setAttribute(new XMLAttribute(\"title\", title));\n        for (const entry of entries) {\n            div.addElement(this.createIndexEntry(entry, undefined, termToId, resolveFile));\n        }\n        return div;\n    }\n\n    private createIndexEntry(entry: IndexTerm, parentKey: string | undefined, termToId: Map<string, string>, resolveFile: (topic: LoadedTopic) => string): DitaElement {\n        const key: string = parentKey === undefined ? entry.term : parentKey + \"\\n\" + entry.term;\n        const id: string = termToId.get(key) ?? key;\n\n        const indexEntry: DitaElement = new DitaElement(\"ditac:indexEntry\");\n        indexEntry.setAttribute(new XMLAttribute(\"id\", id));\n        indexEntry.setAttribute(new XMLAttribute(\"term\", entry.term));\n        if (entry.getSortAs() !== undefined) {\n            indexEntry.setAttribute(new XMLAttribute(\"sortAs\", entry.getSortAs() as string));\n        }\n\n        let num: number = 0;\n        for (const anchor of entry.getAnchorList() ?? []) {\n            const indexAnchor: DitaElement = new DitaElement(\"ditac:indexAnchor\");\n            num++;\n            indexAnchor.setAttribute(new XMLAttribute(\"number\", num.toString()));\n            indexAnchor.setAttribute(new XMLAttribute(\"file\", anchor.file));\n            indexAnchor.setAttribute(new XMLAttribute(\"id\", anchor.getId()));\n            if (anchor instanceof IndexAnchorPair && anchor.getSource2() !== undefined) {\n                num++;\n                indexAnchor.setAttribute(new XMLAttribute(\"number2\", num.toString()));\n                indexAnchor.setAttribute(new XMLAttribute(\"file2\", anchor.getFile2() ?? \"\"));\n                indexAnchor.setAttribute(new XMLAttribute(\"id2\", anchor.getId2() ?? \"\"));\n            }\n            indexEntry.addElement(indexAnchor);\n        }\n\n        for (const seeAlso of entry.getSeeAlsoList() ?? []) {\n            indexEntry.addElement(this.createIndexRef(\"ditac:indexSeeAlso\", seeAlso, termToId));\n        }\n\n        for (const subTerm of entry.getSubTermList() ?? []) {\n            indexEntry.addElement(this.createIndexEntry(subTerm, key, termToId, resolveFile));\n        }\n\n        const seeList: IndexTermRef[] = entry.getSeeList() ?? [];\n        const anchors: IndexAnchor[] = entry.getAnchorList() ?? [];\n        const seeAlsoList: IndexTermRef[] = entry.getSeeAlsoList() ?? [];\n        const subTerms: IndexTerm[] = entry.getSubTermList() ?? [];\n        const isSeeEntry: boolean = seeList.length > 0 && anchors.length === 0 &&\n            seeAlsoList.length === 0 && subTerms.length === 0;\n        if (isSeeEntry) {\n            for (const see of seeList) {\n                indexEntry.addElement(this.createIndexRef(\"ditac:indexSee\", see, termToId));\n            }\n        } else if (seeList.length > 0) {\n            for (const see of seeList) {\n                this.diagnostics.warning(\n                    this.diagnostics.i18n.format(\n                        this.diagnostics.i18n.getString(\"IndexTerms\", \"seeOnNonLeafIndexTerm2\"),\n                        [key.split(\"\\n\").join(\" / \")]\n                    ),\n                    \"term=\\\"\" + see.term.join(\" / \") + \"\\\"\"\n                );\n            }\n        }\n\n        return indexEntry;\n    }\n\n    private createIndexRef(name: string, ref: IndexTermRef, termToId: Map<string, string>): DitaElement {\n        const redirection: string = ref.term.join(\"\\n\");\n        const targetId: string | undefined = termToId.get(redirection);\n        const element: DitaElement = new DitaElement(name);\n        element.setAttribute(new XMLAttribute(\"term\", redirection));\n        if (targetId === undefined) {\n            this.diagnostics.warning(\n                this.diagnostics.i18n.format(\n                    this.diagnostics.i18n.getString(\"IndexTerms\", \"noSuchIndexTerm\"),\n                    [ref.term.join(\" / \")]\n                ),\n                \"term=\\\"\" + ref.term.join(\" / \") + \"\\\"\"\n            );\n        } else {\n            element.setAttribute(new XMLAttribute(\"ref\", targetId));\n        }\n        return element;\n    }\n}\n"]}

package/dist/preprocess/Includer.d.ts

@@ -0,0 +1,46 @@
+import { XMLNode } from "typesxml";
+import { DitaElement } from "../dom/DitaElement.js";
+import { DiagnosticLog } from "../utils/DiagnosticLog.js";
+import { LoadedDocument } from "./LoadedDocument.js";
+import { LoadedDocuments } from "./LoadedDocuments.js";
+export declare class InclusionException extends Error {
+}
+export declare abstract class Incl {
+    readonly directiveElement: DitaElement;
+    readonly sourcePath: string;
+    id: number[];
+    replacementNodes: XMLNode[] | undefined;
+    appendedNodes: XMLNode[] | undefined;
+    protected constructor(directiveElement: DitaElement, sourcePath: string);
+}
+export declare abstract class Includer {
+    private static readonly MAX_ITERATIONS;
+    readonly documents: LoadedDocuments;
+    readonly diagnostics: DiagnosticLog;
+    private readonly docList;
+    private readonly processLists;
+    private inclIds;
+    private workingSet;
+    private processedDocCount;
+    private inclCounter;
+    protected constructor(documents: LoadedDocuments, diagnostics: DiagnosticLog);
+    process(loadedDocuments: LoadedDocument[]): void;
+    protected abstract detectInclusion(element: DitaElement, sourcePath: string): Incl | undefined;
+    protected abstract fetchIncluded(incl: Incl): void;
+    protected fetchDoc(path: string): LoadedDocument;
+    protected cloneElement(source: DitaElement): DitaElement;
+    protected cloneNode(source: XMLNode): XMLNode;
+    protected copyInclId(from: DitaElement, to: DitaElement): void;
+    private copyInclIds;
+    private collectIncludes;
+    private collectIncludesInRange;
+    private newInclId;
+    private runToFixpoint;
+    private processDoc;
+    private replaceSingle;
+    private replaceRange;
+    private appendNodes;
+    private removeNodes;
+    protected reportError(incl: Incl, message: string): void;
+    protected reportWarning(element: DitaElement, sourcePath: string, message: string): void;
+}