typesditac 1.0.0

package/dist/preprocess/ListsDocumentBuilder.js

@@ -0,0 +1,128 @@
+/*
+ * 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 { DitaElement } from "../dom/DitaElement.js";
+import { DitaUtils } from "../utils/DitaUtils.js";
+import { DITAC_NS_URI, ENTRY_QNAMES } from "./ChunkDocumentBuilder.js";
+import { ChunkEntry, ChunkEntryType, TocType } from "./ChunkEntry.js";
+import { GeneratedListTopicBuilder } from "./GeneratedListTopicBuilder.js";
+import { ListTargetType } from "./ListTarget.js";
+export class ListsDocumentBuilder {
+    listTopicBuilder;
+    constructor(diagnostics) {
+        this.listTopicBuilder = new GeneratedListTopicBuilder(diagnostics);
+    }
+    build(plan, lists, mapRoot, docLang, forceTitlePage, chunkBaseName) {
+        const root = new DitaElement("ditac:lists");
+        root.setAttribute(new XMLAttribute("xmlns:ditac", DITAC_NS_URI));
+        if (docLang !== undefined) {
+            root.setAttribute(new XMLAttribute("xml:lang", docLang));
+        }
+        if (plan.chunks.length > 0 && this.hasTitlePage(mapRoot, forceTitlePage)) {
+            const firstChunk = plan.chunks[0];
+            firstChunk.prependEntry(new ChunkEntry(firstChunk, ChunkEntryType.TITLE_PAGE, [], undefined, undefined, TocType.NONE, undefined));
+        }
+        root.addElement(this.buildChunkList(plan.chunks, chunkBaseName));
+        const titlePage = new DitaElement("ditac:titlePage");
+        if (mapRoot !== undefined) {
+            for (const child of this.listTopicBuilder.buildTitlePage(mapRoot, forceTitlePage)) {
+                titlePage.addElement(child);
+            }
+        }
+        root.addElement(titlePage);
+        const allEntries = plan.chunks.flatMap((chunk) => chunk.getEntries());
+        const frontmatterTOC = new DitaElement("ditac:frontmatterTOC");
+        for (const child of this.listTopicBuilder.buildTOC(allEntries, TocType.FRONTMATTER, chunkBaseName)) {
+            frontmatterTOC.addElement(child);
+        }
+        root.addElement(frontmatterTOC);
+        const toc = new DitaElement("ditac:toc");
+        for (const child of this.listTopicBuilder.buildTOC(allEntries, TocType.BODY, chunkBaseName)) {
+            toc.addElement(child);
+        }
+        root.addElement(toc);
+        const backmatterTOC = new DitaElement("ditac:backmatterTOC");
+        for (const child of this.listTopicBuilder.buildTOC(allEntries, TocType.BACKMATTER, chunkBaseName)) {
+            backmatterTOC.addElement(child);
+        }
+        root.addElement(backmatterTOC);
+        const resolveFile = (topic) => {
+            const chunk = plan.getChunk(topic);
+            return chunk === undefined ? "" : chunkBaseName(chunk);
+        };
+        for (const type of [ListTargetType.FIGURE, ListTargetType.TABLE, ListTargetType.EXAMPLE, ListTargetType.EQUATION, ListTargetType.INDEX_TERM]) {
+            const wrapper = new DitaElement("ditac:" + this.listElementName(type));
+            for (const child of this.listTopicBuilder.buildFormalList(lists, type, resolveFile)) {
+                wrapper.addElement(child);
+            }
+            root.addElement(wrapper);
+        }
+        const document = new XMLDocument();
+        document.setRoot(root);
+        return document;
+    }
+    listElementName(type) {
+        switch (type) {
+            case ListTargetType.FIGURE:
+                return "figureList";
+            case ListTargetType.TABLE:
+                return "tableList";
+            case ListTargetType.EXAMPLE:
+                return "exampleList";
+            case ListTargetType.EQUATION:
+                return "equationList";
+            case ListTargetType.INDEX_TERM:
+                return "indexList";
+        }
+    }
+    hasTitlePage(mapRoot, forceTitlePage) {
+        if (mapRoot === undefined) {
+            return forceTitlePage;
+        }
+        if (DitaUtils.getChildByClass(mapRoot, "topic/title") !== undefined) {
+            return true;
+        }
+        if (DitaUtils.getNonEmptyAttribute(mapRoot, "title") !== undefined) {
+            return true;
+        }
+        return forceTitlePage;
+    }
+    buildChunkList(chunks, chunkBaseName) {
+        const chunkList = new DitaElement("ditac:chunkList");
+        for (const chunk of chunks) {
+            const chunkItem = new DitaElement("ditac:chunk");
+            chunkItem.setAttribute(new XMLAttribute("file", chunkBaseName(chunk)));
+            for (const entry of chunk.getEntries()) {
+                chunkItem.addElement(this.buildChunkListEntry(entry));
+            }
+            chunkList.addElement(chunkItem);
+        }
+        return chunkList;
+    }
+    buildChunkListEntry(entry) {
+        if (entry.type !== ChunkEntryType.TOPIC || entry.loadedTopic === undefined) {
+            return new DitaElement(ENTRY_QNAMES.get(entry.type) ?? entry.type);
+        }
+        const entryItem = new DitaElement("ditac:topic");
+        entryItem.setAttribute(new XMLAttribute("number", (entry.number ?? []).join(" ")));
+        entryItem.setAttribute(new XMLAttribute("role", entry.role ?? ""));
+        const topicElement = entry.loadedTopic.element;
+        const title = DitaUtils.getTitleTextFromChild(topicElement, true) ?? entry.navtitle ?? "???";
+        const id = topicElement.getAttribute("id")?.getValue() ?? "";
+        entryItem.setAttribute(new XMLAttribute("title", title));
+        entryItem.setAttribute(new XMLAttribute("id", id));
+        return entryItem;
+    }
+}
+//# sourceMappingURL=ListsDocumentBuilder.js.map

package/dist/preprocess/ListsDocumentBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListsDocumentBuilder.js","sourceRoot":"","sources":["../../ts/preprocess/ListsDocumentBuilder.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 } from \"typesxml\";\nimport { DitaElement } from \"../dom/DitaElement.js\";\nimport { DiagnosticLog } from \"../utils/DiagnosticLog.js\";\nimport { DitaUtils } from \"../utils/DitaUtils.js\";\nimport { Chunk } from \"./Chunk.js\";\nimport { DITAC_NS_URI, ENTRY_QNAMES } from \"./ChunkDocumentBuilder.js\";\nimport { ChunkEntry, ChunkEntryType, TocType } from \"./ChunkEntry.js\";\nimport { ChunkPlan } from \"./ChunkPlan.js\";\nimport { EmbeddedLists } from \"./EmbeddedLists.js\";\nimport { GeneratedListTopicBuilder } from \"./GeneratedListTopicBuilder.js\";\nimport { ListTargetType } from \"./ListTarget.js\";\nimport { LoadedTopic } from \"./LoadedTopic.js\";\n\nexport class ListsDocumentBuilder {\n    private readonly listTopicBuilder: GeneratedListTopicBuilder;\n\n    constructor(diagnostics: DiagnosticLog) {\n        this.listTopicBuilder = new GeneratedListTopicBuilder(diagnostics);\n    }\n\n    build(plan: ChunkPlan, lists: EmbeddedLists, mapRoot: DitaElement | undefined, docLang: string | undefined, forceTitlePage: boolean, chunkBaseName: (chunk: Chunk) => string): XMLDocument {\n        const root: DitaElement = new DitaElement(\"ditac:lists\");\n        root.setAttribute(new XMLAttribute(\"xmlns:ditac\", DITAC_NS_URI));\n        if (docLang !== undefined) {\n            root.setAttribute(new XMLAttribute(\"xml:lang\", docLang));\n        }\n\n        if (plan.chunks.length > 0 && this.hasTitlePage(mapRoot, forceTitlePage)) {\n            const firstChunk: Chunk = plan.chunks[0];\n            firstChunk.prependEntry(new ChunkEntry(firstChunk, ChunkEntryType.TITLE_PAGE, [], undefined, undefined, TocType.NONE, undefined));\n        }\n\n        root.addElement(this.buildChunkList(plan.chunks, chunkBaseName));\n\n        const titlePage: DitaElement = new DitaElement(\"ditac:titlePage\");\n        if (mapRoot !== undefined) {\n            for (const child of this.listTopicBuilder.buildTitlePage(mapRoot, forceTitlePage)) {\n                titlePage.addElement(child);\n            }\n        }\n        root.addElement(titlePage);\n\n        const allEntries: ChunkEntry[] = plan.chunks.flatMap((chunk: Chunk): ChunkEntry[] => chunk.getEntries());\n\n        const frontmatterTOC: DitaElement = new DitaElement(\"ditac:frontmatterTOC\");\n        for (const child of this.listTopicBuilder.buildTOC(allEntries, TocType.FRONTMATTER, chunkBaseName)) {\n            frontmatterTOC.addElement(child);\n        }\n        root.addElement(frontmatterTOC);\n\n        const toc: DitaElement = new DitaElement(\"ditac:toc\");\n        for (const child of this.listTopicBuilder.buildTOC(allEntries, TocType.BODY, chunkBaseName)) {\n            toc.addElement(child);\n        }\n        root.addElement(toc);\n\n        const backmatterTOC: DitaElement = new DitaElement(\"ditac:backmatterTOC\");\n        for (const child of this.listTopicBuilder.buildTOC(allEntries, TocType.BACKMATTER, chunkBaseName)) {\n            backmatterTOC.addElement(child);\n        }\n        root.addElement(backmatterTOC);\n\n        const resolveFile: (topic: LoadedTopic) => string = (topic: LoadedTopic): string => {\n            const chunk: Chunk | undefined = plan.getChunk(topic);\n            return chunk === undefined ? \"\" : chunkBaseName(chunk);\n        };\n\n        for (const type of [ListTargetType.FIGURE, ListTargetType.TABLE, ListTargetType.EXAMPLE, ListTargetType.EQUATION, ListTargetType.INDEX_TERM]) {\n            const wrapper: DitaElement = new DitaElement(\"ditac:\" + this.listElementName(type));\n            for (const child of this.listTopicBuilder.buildFormalList(lists, type, resolveFile)) {\n                wrapper.addElement(child);\n            }\n            root.addElement(wrapper);\n        }\n\n        const document: XMLDocument = new XMLDocument();\n        document.setRoot(root);\n        return document;\n    }\n\n    private listElementName(type: ListTargetType): string {\n        switch (type) {\n            case ListTargetType.FIGURE:\n                return \"figureList\";\n            case ListTargetType.TABLE:\n                return \"tableList\";\n            case ListTargetType.EXAMPLE:\n                return \"exampleList\";\n            case ListTargetType.EQUATION:\n                return \"equationList\";\n            case ListTargetType.INDEX_TERM:\n                return \"indexList\";\n        }\n    }\n\n    private hasTitlePage(mapRoot: DitaElement | undefined, forceTitlePage: boolean): boolean {\n        if (mapRoot === undefined) {\n            return forceTitlePage;\n        }\n        if (DitaUtils.getChildByClass(mapRoot, \"topic/title\") !== undefined) {\n            return true;\n        }\n        if (DitaUtils.getNonEmptyAttribute(mapRoot, \"title\") !== undefined) {\n            return true;\n        }\n        return forceTitlePage;\n    }\n\n    private buildChunkList(chunks: Chunk[], chunkBaseName: (chunk: Chunk) => string): DitaElement {\n        const chunkList: DitaElement = new DitaElement(\"ditac:chunkList\");\n        for (const chunk of chunks) {\n            const chunkItem: DitaElement = new DitaElement(\"ditac:chunk\");\n            chunkItem.setAttribute(new XMLAttribute(\"file\", chunkBaseName(chunk)));\n            for (const entry of chunk.getEntries()) {\n                chunkItem.addElement(this.buildChunkListEntry(entry));\n            }\n            chunkList.addElement(chunkItem);\n        }\n        return chunkList;\n    }\n\n    private buildChunkListEntry(entry: ChunkEntry): DitaElement {\n        if (entry.type !== ChunkEntryType.TOPIC || entry.loadedTopic === undefined) {\n            return new DitaElement(ENTRY_QNAMES.get(entry.type) ?? entry.type);\n        }\n        const entryItem: DitaElement = new DitaElement(\"ditac:topic\");\n        entryItem.setAttribute(new XMLAttribute(\"number\", (entry.number ?? []).join(\" \")));\n        entryItem.setAttribute(new XMLAttribute(\"role\", entry.role ?? \"\"));\n        const topicElement: DitaElement = entry.loadedTopic.element;\n        const title: string = DitaUtils.getTitleTextFromChild(topicElement, true) ?? entry.navtitle ?? \"???\";\n        const id: string = topicElement.getAttribute(\"id\")?.getValue() ?? \"\";\n        entryItem.setAttribute(new XMLAttribute(\"title\", title));\n        entryItem.setAttribute(new XMLAttribute(\"id\", id));\n        return entryItem;\n    }\n}\n"]}

package/dist/preprocess/LoadDocument.d.ts

@@ -0,0 +1,11 @@
+import { Catalog, XMLDocument } from "typesxml";
+import { DiagnosticLog } from "../utils/DiagnosticLog.js";
+export declare class LoadDocument {
+    static readonly DEFAULT_CATALOG: string;
+    readonly catalog: Catalog;
+    private readonly diagnostics;
+    constructor(diagnostics: DiagnosticLog, catalog?: Catalog);
+    load(filePath: string, validate?: boolean): XMLDocument;
+    private loadSource;
+    private loadSourceFromFile;
+}

package/dist/preprocess/LoadDocument.js

@@ -0,0 +1,71 @@
+/*
+ * 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 { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Catalog, SAXParser } from "typesxml";
+import { DitaDOMBuilder } from "../dom/DitaDOMBuilder.js";
+import { DitaUtils } from "../utils/DitaUtils.js";
+import { DocumentLoaderFactories } from "./DocumentLoaderFactories.js";
+export class LoadDocument {
+    static DEFAULT_CATALOG = fileURLToPath(new URL("../catalog/catalog.xml", import.meta.url));
+    catalog;
+    diagnostics;
+    constructor(diagnostics, catalog = new Catalog(LoadDocument.DEFAULT_CATALOG)) {
+        this.catalog = catalog;
+        this.diagnostics = diagnostics;
+    }
+    load(filePath, validate = false) {
+        if (/^https?:\/\//i.test(filePath)) {
+            const formatLoader = DocumentLoaderFactories.createLoader(filePath, this.catalog, this.diagnostics);
+            const source = DitaUtils.retrieve(filePath, this.diagnostics.i18n);
+            return formatLoader === undefined
+                ? this.loadSource(source, filePath, validate)
+                : formatLoader.loadSource(source, filePath, validate);
+        }
+        const localPath = /^file:/i.test(filePath) ? fileURLToPath(new URL(filePath)) : filePath;
+        const absolutePath = resolve(localPath);
+        const formatLoader = DocumentLoaderFactories.createLoader(absolutePath, this.catalog, this.diagnostics);
+        if (formatLoader !== undefined) {
+            return formatLoader.load(absolutePath, validate);
+        }
+        return this.loadSourceFromFile(absolutePath, validate);
+    }
+    loadSource(source, location, validate) {
+        const builder = new DitaDOMBuilder();
+        const parser = new SAXParser();
+        parser.setContentHandler(builder);
+        parser.setCatalog(this.catalog);
+        parser.setValidating(validate);
+        parser.parseString(source);
+        const document = builder.getDocument();
+        if (document === undefined) {
+            throw new Error(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("LoadDocument", "documentHasNoContent"), [location]));
+        }
+        return document;
+    }
+    loadSourceFromFile(filePath, validate) {
+        const builder = new DitaDOMBuilder();
+        const parser = new SAXParser();
+        parser.setContentHandler(builder);
+        parser.setCatalog(this.catalog);
+        parser.setValidating(validate);
+        parser.parseFile(filePath);
+        const document = builder.getDocument();
+        if (document === undefined) {
+            throw new Error(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("LoadDocument", "documentHasNoContent"), [filePath]));
+        }
+        return document;
+    }
+}
+//# sourceMappingURL=LoadDocument.js.map

package/dist/preprocess/LoadDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadDocument.js","sourceRoot":"","sources":["../../ts/preprocess/LoadDocument.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 { resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { Catalog, SAXParser, XMLDocument } from \"typesxml\";\nimport { DitaDOMBuilder } from \"../dom/DitaDOMBuilder.js\";\nimport { DiagnosticLog } from \"../utils/DiagnosticLog.js\";\nimport { DitaUtils } from \"../utils/DitaUtils.js\";\nimport { DocumentLoader } from \"./DocumentLoader.js\";\nimport { DocumentLoaderFactories } from \"./DocumentLoaderFactories.js\";\n\nexport class LoadDocument {\n    static readonly DEFAULT_CATALOG: string = fileURLToPath(new URL(\"../catalog/catalog.xml\", import.meta.url));\n\n    readonly catalog: Catalog;\n    private readonly diagnostics: DiagnosticLog;\n\n    constructor(diagnostics: DiagnosticLog, catalog: Catalog = new Catalog(LoadDocument.DEFAULT_CATALOG)) {\n        this.catalog = catalog;\n        this.diagnostics = diagnostics;\n    }\n\n    load(filePath: string, validate: boolean = false): XMLDocument {\n        if (/^https?:\\/\\//i.test(filePath)) {\n            const formatLoader: DocumentLoader | undefined =\n                DocumentLoaderFactories.createLoader(filePath, this.catalog, this.diagnostics);\n            const source: string = DitaUtils.retrieve(filePath, this.diagnostics.i18n);\n            return formatLoader === undefined\n                ? this.loadSource(source, filePath, validate)\n                : formatLoader.loadSource(source, filePath, validate);\n        }\n        const localPath: string = /^file:/i.test(filePath) ? fileURLToPath(new URL(filePath)) : filePath;\n        const absolutePath: string = resolve(localPath);\n        const formatLoader: DocumentLoader | undefined =\n            DocumentLoaderFactories.createLoader(absolutePath, this.catalog, this.diagnostics);\n        if (formatLoader !== undefined) {\n            return formatLoader.load(absolutePath, validate);\n        }\n        return this.loadSourceFromFile(absolutePath, validate);\n    }\n\n    private loadSource(source: string, location: string, validate: boolean): XMLDocument {\n        const builder: DitaDOMBuilder = new DitaDOMBuilder();\n        const parser: SAXParser = new SAXParser();\n        parser.setContentHandler(builder);\n        parser.setCatalog(this.catalog);\n        parser.setValidating(validate);\n        parser.parseString(source);\n        const document: XMLDocument | undefined = builder.getDocument();\n        if (document === undefined) {\n            throw new Error(this.diagnostics.i18n.format(this.diagnostics.i18n.getString(\"LoadDocument\", \"documentHasNoContent\"), [location]));\n        }\n        return document;\n    }\n\n    private loadSourceFromFile(filePath: string, validate: boolean): XMLDocument {\n        const builder: DitaDOMBuilder = new DitaDOMBuilder();\n        const parser: SAXParser = new SAXParser();\n        parser.setContentHandler(builder);\n        parser.setCatalog(this.catalog);\n        parser.setValidating(validate);\n        parser.parseFile(filePath);\n        const document: XMLDocument | undefined = builder.getDocument();\n        if (document === undefined) {\n            throw new Error(this.diagnostics.i18n.format(this.diagnostics.i18n.getString(\"LoadDocument\", \"documentHasNoContent\"), [filePath]));\n        }\n        return document;\n    }\n}\n"]}

package/dist/preprocess/LoadedDocument.d.ts

@@ -0,0 +1,30 @@
+import { XMLDocument } from "typesxml";
+import { I18n } from "../i18n/I18n.js";
+import { DiagnosticLog } from "../utils/DiagnosticLog.js";
+import { LoadedTopic } from "./LoadedTopic.js";
+export declare enum LoadedDocumentType {
+    MAP = "map",
+    BOOKMAP = "bookmap",
+    SUBJECT_SCHEME = "subjectScheme",
+    MULTI_TOPIC = "multiTopic",
+    TOPIC = "topic",
+    DITAVAL = "ditaval"
+}
+export declare class LoadedDocument {
+    private static readonly XSI_NS_URI;
+    readonly path: string;
+    readonly document: XMLDocument;
+    readonly type: LoadedDocumentType;
+    private readonly properties;
+    private topics;
+    constructor(path: string, document: XMLDocument, i18n: I18n);
+    setProperty(name: string, value: unknown): void;
+    getProperty(name: string): unknown;
+    getTopics(diagnostics?: DiagnosticLog): LoadedTopic[];
+    getTopicCount(): number;
+    getFirstTopic(): LoadedTopic | undefined;
+    getSingleTopic(): LoadedTopic | undefined;
+    findTopicById(id: string): LoadedTopic | undefined;
+    private getType;
+    private findNestedTopic;
+}

package/dist/preprocess/LoadedDocument.js

@@ -0,0 +1,145 @@
+/*
+ * 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 { DitaUtils } from "../utils/DitaUtils.js";
+import { LoadedTopic } from "./LoadedTopic.js";
+export var LoadedDocumentType;
+(function (LoadedDocumentType) {
+    LoadedDocumentType["MAP"] = "map";
+    LoadedDocumentType["BOOKMAP"] = "bookmap";
+    LoadedDocumentType["SUBJECT_SCHEME"] = "subjectScheme";
+    LoadedDocumentType["MULTI_TOPIC"] = "multiTopic";
+    LoadedDocumentType["TOPIC"] = "topic";
+    LoadedDocumentType["DITAVAL"] = "ditaval";
+})(LoadedDocumentType || (LoadedDocumentType = {}));
+export class LoadedDocument {
+    static XSI_NS_URI = "http://www.w3.org/2001/XMLSchema-instance";
+    path;
+    document;
+    type;
+    properties = new Map();
+    topics;
+    constructor(path, document, i18n) {
+        const root = DitaUtils.getRoot(document);
+        if (root === undefined) {
+            throw new Error(i18n.format(i18n.getString("LoadedDocument", "documentHasNoRoot"), [path]));
+        }
+        this.path = path;
+        this.document = document;
+        this.type = this.getType(root, i18n);
+        // No longer useful.
+        const xsiPrefixes = [];
+        for (const attribute of root.getAttributes()) {
+            const name = attribute.getName();
+            if (name.startsWith("xmlns:") && attribute.getValue() === LoadedDocument.XSI_NS_URI) {
+                xsiPrefixes.push(name.slice(6));
+            }
+        }
+        for (const prefix of xsiPrefixes) {
+            root.removeAttribute(prefix + ":noNamespaceSchemaLocation");
+        }
+    }
+    setProperty(name, value) {
+        if (value === undefined) {
+            this.properties.delete(name);
+        }
+        else {
+            this.properties.set(name, value);
+        }
+    }
+    getProperty(name) {
+        return this.properties.get(name);
+    }
+    getTopics(diagnostics) {
+        if (this.topics !== undefined) {
+            return this.topics;
+        }
+        this.topics = [];
+        const root = DitaUtils.getRoot(this.document);
+        if (root === undefined) {
+            return this.topics;
+        }
+        if (this.type === LoadedDocumentType.TOPIC) {
+            this.topics.push(new LoadedTopic(root, this, undefined, undefined, diagnostics));
+            return this.topics;
+        }
+        if (this.type !== LoadedDocumentType.MULTI_TOPIC) {
+            return this.topics;
+        }
+        for (const child of root.getChildren()) {
+            if (DitaUtils.hasClass(child, "topic/topic")) {
+                this.topics.push(new LoadedTopic(child, this, undefined, undefined, diagnostics));
+            }
+        }
+        return this.topics;
+    }
+    getTopicCount() {
+        return this.getTopics().length;
+    }
+    getFirstTopic() {
+        return this.getTopics()[0];
+    }
+    getSingleTopic() {
+        const topics = this.getTopics();
+        if (topics.length !== 1) {
+            return undefined;
+        }
+        return topics[0].getNestedTopics().length > 0 ? undefined : topics[0];
+    }
+    findTopicById(id) {
+        const topics = this.getTopics();
+        for (const topic of topics) {
+            const found = this.findNestedTopic(topic, id);
+            if (found !== undefined) {
+                return found;
+            }
+        }
+        return undefined;
+    }
+    getType(root, i18n) {
+        if (root.getName() === "dita") {
+            return LoadedDocumentType.MULTI_TOPIC;
+        }
+        if (root.getName() === "val") {
+            return LoadedDocumentType.DITAVAL;
+        }
+        if (DitaUtils.hasClass(root, "topic/topic")) {
+            return LoadedDocumentType.TOPIC;
+        }
+        if (DitaUtils.hasClass(root, "subjectScheme/subjectScheme")) {
+            return LoadedDocumentType.SUBJECT_SCHEME;
+        }
+        if (DitaUtils.hasClass(root, "bookmap/bookmap")) {
+            return LoadedDocumentType.BOOKMAP;
+        }
+        if (DitaUtils.hasClass(root, "map/map")) {
+            return LoadedDocumentType.MAP;
+        }
+        throw new Error(i18n.format(i18n.getString("LoadedDocument", "unexpectedElement"), [root.getName()]));
+    }
+    findNestedTopic(topic, id) {
+        if (topic.topicId === id) {
+            return topic;
+        }
+        for (const child of topic.getNestedTopics()) {
+            if (DitaUtils.hasClass(child.element, "topic/topic")) {
+                const found = this.findNestedTopic(child, id);
+                if (found !== undefined) {
+                    return found;
+                }
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=LoadedDocument.js.map

package/dist/preprocess/LoadedDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadedDocument.js","sourceRoot":"","sources":["../../ts/preprocess/LoadedDocument.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 { XMLDocument } from \"typesxml\";\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 { LoadedTopic } from \"./LoadedTopic.js\";\n\nexport enum LoadedDocumentType {\n    MAP = \"map\",\n    BOOKMAP = \"bookmap\",\n    SUBJECT_SCHEME = \"subjectScheme\",\n    MULTI_TOPIC = \"multiTopic\",\n    TOPIC = \"topic\",\n    DITAVAL = \"ditaval\"\n}\n\nexport class LoadedDocument {\n    private static readonly XSI_NS_URI: string = \"http://www.w3.org/2001/XMLSchema-instance\";\n\n    readonly path: string;\n    readonly document: XMLDocument;\n    readonly type: LoadedDocumentType;\n    private readonly properties: Map<string, unknown> = new Map<string, unknown>();\n    private topics: LoadedTopic[] | undefined;\n\n    constructor(path: string, document: XMLDocument, i18n: I18n) {\n        const root: DitaElement | undefined = DitaUtils.getRoot(document);\n        if (root === undefined) {\n            throw new Error(i18n.format(i18n.getString(\"LoadedDocument\", \"documentHasNoRoot\"), [path]));\n        }\n        this.path = path;\n        this.document = document;\n        this.type = this.getType(root, i18n);\n\n        // No longer useful.\n        const xsiPrefixes: string[] = [];\n        for (const attribute of root.getAttributes()) {\n            const name: string = attribute.getName();\n            if (name.startsWith(\"xmlns:\") && attribute.getValue() === LoadedDocument.XSI_NS_URI) {\n                xsiPrefixes.push(name.slice(6));\n            }\n        }\n        for (const prefix of xsiPrefixes) {\n            root.removeAttribute(prefix + \":noNamespaceSchemaLocation\");\n        }\n    }\n\n    setProperty(name: string, value: unknown): void {\n        if (value === undefined) {\n            this.properties.delete(name);\n        } else {\n            this.properties.set(name, value);\n        }\n    }\n\n    getProperty(name: string): unknown {\n        return this.properties.get(name);\n    }\n\n    getTopics(diagnostics?: DiagnosticLog): LoadedTopic[] {\n        if (this.topics !== undefined) {\n            return this.topics;\n        }\n        this.topics = [];\n        const root: DitaElement | undefined = DitaUtils.getRoot(this.document);\n        if (root === undefined) {\n            return this.topics;\n        }\n        if (this.type === LoadedDocumentType.TOPIC) {\n            this.topics.push(new LoadedTopic(root, this, undefined, undefined, diagnostics));\n            return this.topics;\n        }\n        if (this.type !== LoadedDocumentType.MULTI_TOPIC) {\n            return this.topics;\n        }\n        for (const child of root.getChildren()) {\n            if (DitaUtils.hasClass(child, \"topic/topic\")) {\n                this.topics.push(new LoadedTopic(child, this, undefined, undefined, diagnostics));\n            }\n        }\n        return this.topics;\n    }\n\n    getTopicCount(): number {\n        return this.getTopics().length;\n    }\n\n    getFirstTopic(): LoadedTopic | undefined {\n        return this.getTopics()[0];\n    }\n\n    getSingleTopic(): LoadedTopic | undefined {\n        const topics: LoadedTopic[] = this.getTopics();\n        if (topics.length !== 1) {\n            return undefined;\n        }\n        return topics[0].getNestedTopics().length > 0 ? undefined : topics[0];\n    }\n\n    findTopicById(id: string): LoadedTopic | undefined {\n        const topics: LoadedTopic[] = this.getTopics();\n        for (const topic of topics) {\n            const found: LoadedTopic | undefined = this.findNestedTopic(topic, id);\n            if (found !== undefined) {\n                return found;\n            }\n        }\n        return undefined;\n    }\n\n    private getType(root: DitaElement, i18n: I18n): LoadedDocumentType {\n        if (root.getName() === \"dita\") {\n            return LoadedDocumentType.MULTI_TOPIC;\n        }\n        if (root.getName() === \"val\") {\n            return LoadedDocumentType.DITAVAL;\n        }\n        if (DitaUtils.hasClass(root, \"topic/topic\")) {\n            return LoadedDocumentType.TOPIC;\n        }\n        if (DitaUtils.hasClass(root, \"subjectScheme/subjectScheme\")) {\n            return LoadedDocumentType.SUBJECT_SCHEME;\n        }\n        if (DitaUtils.hasClass(root, \"bookmap/bookmap\")) {\n            return LoadedDocumentType.BOOKMAP;\n        }\n        if (DitaUtils.hasClass(root, \"map/map\")) {\n            return LoadedDocumentType.MAP;\n        }\n        throw new Error(i18n.format(i18n.getString(\"LoadedDocument\", \"unexpectedElement\"), [root.getName()]));\n    }\n\n    private findNestedTopic(topic: LoadedTopic, id: string): LoadedTopic | undefined {\n        if (topic.topicId === id) {\n            return topic;\n        }\n        for (const child of topic.getNestedTopics()) {\n            if (DitaUtils.hasClass(child.element, \"topic/topic\")) {\n                const found: LoadedTopic | undefined = this.findNestedTopic(child, id);\n                if (found !== undefined) {\n                    return found;\n                }\n            }\n        }\n        return undefined;\n    }\n}"]}

package/dist/preprocess/LoadedDocuments.d.ts

@@ -0,0 +1,77 @@
+import { XMLDocument } from "typesxml";
+import { DitaElement } from "../dom/DitaElement.js";
+import { DiagnosticLog } from "../utils/DiagnosticLog.js";
+import { LoadDocument } from "./LoadDocument.js";
+import { KeyDefinition } from "./KeyDefinition.js";
+import { KeySpaces } from "./KeySpaces.js";
+import { LoadedDocument } from "./LoadedDocument.js";
+type DocumentLocation = string | URL;
+export declare class LoadedDocuments {
+    private static readonly SUPPORTED_DITA_VERSIONS;
+    readonly loader: LoadDocument;
+    readonly diagnostics: DiagnosticLog;
+    private readonly documents;
+    private readonly preloadedDocuments;
+    readonly keySpaces: KeySpaces | undefined;
+    private validate;
+    private cascadingAttributes;
+    constructor(loader: LoadDocument, diagnostics: DiagnosticLog, keySpaces?: KeySpaces);
+    setValidating(validate: boolean): void;
+    isValidating(): boolean;
+    preload(filePath: DocumentLocation): LoadedDocument;
+    private loadDocument;
+    load(filePath: DocumentLocation, process?: boolean): LoadedDocument;
+    protected createLoadedDocument(filePath: string, document: XMLDocument): LoadedDocument;
+    private checkDITAVersion;
+    private checkDITAVersionElement;
+    put(filePath: DocumentLocation, document: XMLDocument, process?: boolean): LoadedDocument;
+    private processLoadedDocument;
+    get(filePath: DocumentLocation): LoadedDocument | undefined;
+    remove(filePath: DocumentLocation): LoadedDocument | undefined;
+    has(filePath: DocumentLocation): boolean;
+    size(): number;
+    values(): IterableIterator<LoadedDocument>;
+    iterator(): IterableIterator<LoadedDocument>;
+    private ensureHasValidId;
+    private needsId;
+    private process;
+    private resolveHref;
+    private markAbsoluteHref;
+    private resolveFragment;
+    private getDocumentUrl;
+    private createUrl;
+    private resolveAbsoluteUri;
+    private resolveUri;
+    private resolveCatalogURL;
+    private resolveElement;
+    private lookupDefinition;
+    private resolveConkeyref;
+    private resolveKeyref;
+    private splitKeyref;
+    private keyrefWarning;
+    private addIdToHref;
+    static readonly LINKING_ATTRIBUTES: string[];
+    private processKeyref;
+    private resolveObjectElement;
+    private resolveObjectParam;
+    private resolveObjectType;
+    private resolveObjectKeyref;
+    private resolveObjectKeyrefs;
+    private resolveObjectKeyrefTarget;
+    private resolveObjectAttributeUrls;
+    private resolveObjectAttributeUrl;
+    private joinObjectUrl;
+    private capitalize;
+    private static readonly VARIABLE_ELEMENTS;
+    private isVariableElement;
+    private addContent;
+    private copyElement;
+    private copyChildren;
+    private static readonly BASE_CASCADING_ATTRIBUTES;
+    private static readonly FIRST_ADDITIVE_INDEX;
+    private getCascadingAttributes;
+    addMetadata(definition: KeyDefinition, topicref: DitaElement): void;
+    private mergeValues;
+    private canonicalize;
+}
+export {};