typesditac 1.0.0

package/dist/preprocess/Chunking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chunking.js","sourceRoot":"","sources":["../../ts/preprocess/Chunking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAChB,yBAAa,CAAA;IACb,6BAAiB,CAAA;IACjB,yBAAa,CAAA;AACjB,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC3C,MAAM,OAAO,GAAW,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClD,QAAQ,OAAO,EAAE,CAAC;QACd,KAAK,MAAM;YACP,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,KAAK,QAAQ;YACT,OAAO,QAAQ,CAAC,MAAM,CAAC;QAC3B,KAAK,MAAM;YACP,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB;YACI,OAAO,SAAS,CAAC;IACzB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC3E,CAAC","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\nexport enum Chunking {\n    NONE = \"none\",\n    SINGLE = \"single\",\n    AUTO = \"auto\"\n}\n\nexport function chunkingFromString(spec: string): Chunking | undefined {\n    const trimmed: string = spec.trim().toLowerCase();\n    switch (trimmed) {\n        case \"none\":\n            return Chunking.NONE;\n        case \"single\":\n            return Chunking.SINGLE;\n        case \"auto\":\n            return Chunking.AUTO;\n        default:\n            return undefined;\n    }\n}\n\nexport function joinChunkingStringForms(separator: string): string {\n    return [Chunking.NONE, Chunking.SINGLE, Chunking.AUTO].join(separator);\n}\n"]}

package/dist/preprocess/CollectionLinkProcessor.d.ts

@@ -0,0 +1,17 @@
+import { DitaElement } from "../dom/DitaElement.js";
+import { DiagnosticLog } from "../utils/DiagnosticLog.js";
+import { LoadedDocuments } from "./LoadedDocuments.js";
+export declare class CollectionLinkProcessor {
+    readonly diagnostics: DiagnosticLog;
+    private mapHref;
+    constructor(diagnostics: DiagnosticLog);
+    process(root: DitaElement, documents: LoadedDocuments, mapPath: string): void;
+    private processHierarchy;
+    private processCollection;
+    private addLinkSet;
+    private addLinkpool;
+    private addLink;
+    private entry;
+    private getAttribute;
+    private getCollectionType;
+}

package/dist/preprocess/CollectionLinkProcessor.js

@@ -0,0 +1,236 @@
+/*
+ * 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 { DitaUtils } from "../utils/DitaUtils.js";
+import { URIComponent } from "../utils/URIComponent.js";
+export class CollectionLinkProcessor {
+    diagnostics;
+    mapHref = "";
+    constructor(diagnostics) {
+        this.diagnostics = diagnostics;
+    }
+    process(root, documents, mapPath) {
+        this.mapHref = DitaUtils.toFileUrl(mapPath);
+        this.processHierarchy(root, documents, mapPath);
+    }
+    processHierarchy(topicrefOrMap, documents, mapPath) {
+        this.processCollection(topicrefOrMap, documents, mapPath);
+        for (const child of topicrefOrMap.getChildren()) {
+            if (DitaUtils.hasClass(child, "map/topicref") &&
+                !DitaUtils.hasClass(child, "bookmap/frontmatter") &&
+                !DitaUtils.hasClass(child, "bookmap/backmatter")) {
+                this.processHierarchy(child, documents, mapPath);
+            }
+        }
+    }
+    processCollection(topicrefOrMap, documents, mapPath) {
+        const parent = this.entry(topicrefOrMap, documents, mapPath);
+        const children = [];
+        for (const child of topicrefOrMap.getChildren()) {
+            if (!DitaUtils.hasClass(child, "map/topicref")) {
+                continue;
+            }
+            const entry = this.entry(child, documents, mapPath);
+            if (entry !== undefined) {
+                children.push(entry);
+            }
+        }
+        if (children.length === 0) {
+            return;
+        }
+        const collectionType = this.getCollectionType(topicrefOrMap);
+        if (parent !== undefined && (parent.linking === "normal" || parent.linking === "sourceonly")) {
+            const linkpool = this.addLinkpool(parent.topic.element, collectionType + "-parent");
+            for (const child of children) {
+                this.addLink(linkpool, child, "child");
+            }
+        }
+        if (collectionType === "family") {
+            for (let index = 0; index < children.length; index++) {
+                this.addLinkSet(children[index], parent, children.filter((_, sibling) => sibling !== index), "family-members");
+            }
+        }
+        else if (collectionType === "sequence") {
+            for (let index = 0; index < children.length; index++) {
+                const targets = [];
+                if (parent !== undefined) {
+                    targets.push([parent, "parent"]);
+                }
+                if (index > 0) {
+                    targets.push([children[index - 1], "previous"]);
+                }
+                if (index + 1 < children.length) {
+                    targets.push([children[index + 1], "next"]);
+                }
+                this.addLinkSet(children[index], undefined, targets, "sequence-members");
+            }
+        }
+        else if (parent !== undefined) {
+            for (const child of children) {
+                this.addLinkSet(child, parent, [], collectionType + "-members");
+            }
+        }
+    }
+    addLinkSet(source, parent, siblings, poolType) {
+        if (source.linking !== "normal" && source.linking !== "sourceonly") {
+            return;
+        }
+        const targets = [];
+        if (parent !== undefined) {
+            targets.push([parent, "parent"]);
+        }
+        for (const sibling of siblings) {
+            targets.push(Array.isArray(sibling) ? sibling : [sibling, "sibling"]);
+        }
+        const linkpool = this.addLinkpool(source.topic.element, poolType);
+        for (const [target, role] of targets) {
+            this.addLink(linkpool, target, role);
+        }
+    }
+    addLinkpool(topic, poolType) {
+        let relatedLinks = DitaUtils.getChildByClass(topic, "topic/related-links");
+        if (relatedLinks === undefined) {
+            relatedLinks = new DitaElement("related-links");
+            relatedLinks.setAttribute(new XMLAttribute("class", "- topic/related-links "));
+            const before = topic.getChildren().find((child) => DitaUtils.hasClass(child, "topic/topic"));
+            const content = topic.getContent();
+            const index = before === undefined ? -1 : content.indexOf(before);
+            if (index < 0) {
+                topic.addElement(relatedLinks);
+            }
+            else {
+                content.splice(index, 0, relatedLinks);
+                topic.setContent(content);
+            }
+        }
+        const linkpool = new DitaElement("linkpool");
+        linkpool.setAttribute(new XMLAttribute("class", "- topic/linkpool "));
+        linkpool.setAttribute(new XMLAttribute("mapkeyref", this.mapHref + " type=" + poolType));
+        relatedLinks.setContent([linkpool, ...relatedLinks.getContent()]);
+        return linkpool;
+    }
+    addLink(linkpool, target, role) {
+        if (target.linking !== "normal" && target.linking !== "targetonly") {
+            return;
+        }
+        const link = new DitaElement("link");
+        link.setAttribute(new XMLAttribute("class", "- topic/link "));
+        link.setAttribute(new XMLAttribute("href", target.href));
+        link.setAttribute(new XMLAttribute("scope", "local"));
+        link.setAttribute(new XMLAttribute("format", "dita"));
+        link.setAttribute(new XMLAttribute("role", role));
+        if (target.linktext !== undefined) {
+            const linktext = DitaUtils.cloneElement(target.linktext);
+            linktext.setAttribute(new XMLAttribute("class", "- topic/linktext "));
+            link.addElement(linktext);
+        }
+        if (target.shortdesc !== undefined) {
+            const desc = new DitaElement("desc");
+            desc.setAttribute(new XMLAttribute("class", "- topic/desc "));
+            desc.setContent(target.shortdesc.getContent().map((node) => node instanceof DitaElement ? DitaUtils.cloneElement(node) : node));
+            link.addElement(desc);
+        }
+        linkpool.addElement(link);
+    }
+    entry(element, documents, mapPath) {
+        const href = this.getAttribute(element, "href");
+        if (href === undefined) {
+            return undefined;
+        }
+        const scope = DitaUtils.getScope(element, href);
+        const format = DitaUtils.getFormat(element, href, scope);
+        if (format === undefined) {
+            this.diagnostics.warning(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("Filter", "missingAttribute"), ["format"]), mapPath);
+            return undefined;
+        }
+        const linkingValue = this.getAttribute(element, "linking");
+        let linking;
+        if (linkingValue === undefined || linkingValue === "normal") {
+            linking = "normal";
+        }
+        else if (linkingValue === "none" || linkingValue === "sourceonly" || linkingValue === "targetonly") {
+            linking = linkingValue;
+        }
+        else {
+            this.diagnostics.warning(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("Filter", "invalidAttribute"), [linkingValue, "linking"]), mapPath);
+            linking = "none";
+        }
+        const meta = DitaUtils.getChildByClass(element, "map/topicmeta");
+        const linktext = meta === undefined ? undefined : DitaUtils.getChildByClass(meta, "map/linktext");
+        const shortdesc = meta === undefined ? undefined : DitaUtils.getChildByClass(meta, "map/shortdesc");
+        const local = scope === "local" && format === "dita";
+        let topic;
+        let elementId;
+        let pointsOutside = false;
+        if (local) {
+            const hashIndex = href.indexOf("#");
+            const topicHref = hashIndex < 0 ? href : href.slice(0, hashIndex);
+            const fragment = hashIndex < 0 ? undefined : URIComponent.decode(href.slice(hashIndex + 1));
+            let topicId = fragment;
+            if (fragment !== undefined) {
+                const slashIndex = fragment.indexOf("/");
+                if (slashIndex > 0 && slashIndex + 1 < fragment.length) {
+                    topicId = fragment.slice(0, slashIndex);
+                    elementId = fragment.slice(slashIndex + 1);
+                }
+            }
+            let loadedDoc;
+            try {
+                loadedDoc = documents.load(topicHref);
+            }
+            catch {
+                loadedDoc = undefined;
+            }
+            if (loadedDoc !== undefined) {
+                const loadedTopic = topicId === undefined
+                    ? loadedDoc.getFirstTopic()
+                    : loadedDoc.findTopicById(topicId);
+                if (loadedTopic === undefined) {
+                    pointsOutside = true;
+                }
+                else if (!loadedTopic.isExcluded()) {
+                    topic = loadedTopic;
+                }
+            }
+            else {
+                pointsOutside = true;
+            }
+        }
+        if (local && topic === undefined && pointsOutside) {
+            this.diagnostics.warning(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("LinkGenerator", "pointsOutsidePreprocessedTopics"), [href]), mapPath);
+        }
+        if (topic === undefined) {
+            return undefined;
+        }
+        const resolvedHref = topic.getHref() + (elementId === undefined ? "" : "/" + URIComponent.quoteFragment(elementId));
+        return {
+            topic,
+            href: resolvedHref,
+            linking,
+            linktext,
+            shortdesc
+        };
+    }
+    getAttribute(element, name) {
+        return DitaUtils.getNonEmptyAttribute(element, name);
+    }
+    getCollectionType(element) {
+        const value = this.getAttribute(element, "collection-type");
+        return value === "sequence" || value === "family" || value === "choice" || value === "unordered"
+            ? value
+            : "unordered";
+    }
+}
+//# sourceMappingURL=CollectionLinkProcessor.js.map

package/dist/preprocess/CollectionLinkProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollectionLinkProcessor.js","sourceRoot":"","sources":["../../ts/preprocess/CollectionLinkProcessor.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, XMLNode } from \"typesxml\";\nimport { DitaElement } from \"../dom/DitaElement.js\";\nimport { DiagnosticLog } from \"../utils/DiagnosticLog.js\";\nimport { DitaUtils } from \"../utils/DitaUtils.js\";\nimport { URIComponent } from \"../utils/URIComponent.js\";\nimport { LoadedDocument } from \"./LoadedDocument.js\";\nimport { LoadedDocuments } from \"./LoadedDocuments.js\";\nimport { LoadedTopic } from \"./LoadedTopic.js\";\n\ntype Linking = \"none\" | \"sourceonly\" | \"targetonly\" | \"normal\";\n\ninterface CollectionEntry {\n    readonly topic: LoadedTopic;\n    readonly href: string;\n    readonly linking: Linking;\n    readonly linktext?: DitaElement;\n    readonly shortdesc?: DitaElement;\n}\n\nexport class CollectionLinkProcessor {\n    readonly diagnostics: DiagnosticLog;\n    private mapHref: string = \"\";\n\n    constructor(diagnostics: DiagnosticLog) {\n        this.diagnostics = diagnostics;\n    }\n\n    process(root: DitaElement, documents: LoadedDocuments, mapPath: string): void {\n        this.mapHref = DitaUtils.toFileUrl(mapPath);\n        this.processHierarchy(root, documents, mapPath);\n    }\n\n    private processHierarchy(topicrefOrMap: DitaElement, documents: LoadedDocuments, mapPath: string): void {\n        this.processCollection(topicrefOrMap, documents, mapPath);\n        for (const child of topicrefOrMap.getChildren()) {\n            if (DitaUtils.hasClass(child, \"map/topicref\") &&\n                !DitaUtils.hasClass(child, \"bookmap/frontmatter\") &&\n                !DitaUtils.hasClass(child, \"bookmap/backmatter\")) {\n                this.processHierarchy(child, documents, mapPath);\n            }\n        }\n    }\n\n    private processCollection(topicrefOrMap: DitaElement, documents: LoadedDocuments, mapPath: string): void {\n        const parent: CollectionEntry | undefined = this.entry(topicrefOrMap, documents, mapPath);\n        const children: CollectionEntry[] = [];\n        for (const child of topicrefOrMap.getChildren()) {\n            if (!DitaUtils.hasClass(child, \"map/topicref\")) {\n                continue;\n            }\n            const entry: CollectionEntry | undefined = this.entry(child, documents, mapPath);\n            if (entry !== undefined) {\n                children.push(entry);\n            }\n        }\n        if (children.length === 0) {\n            return;\n        }\n        const collectionType: string = this.getCollectionType(topicrefOrMap);\n        if (parent !== undefined && (parent.linking === \"normal\" || parent.linking === \"sourceonly\")) {\n            const linkpool: DitaElement = this.addLinkpool(parent.topic.element, collectionType + \"-parent\");\n            for (const child of children) {\n                this.addLink(linkpool, child, \"child\");\n            }\n        }\n        if (collectionType === \"family\") {\n            for (let index: number = 0; index < children.length; index++) {\n                this.addLinkSet(children[index], parent, children.filter((_, sibling): boolean => sibling !== index), \"family-members\");\n            }\n        } else if (collectionType === \"sequence\") {\n            for (let index: number = 0; index < children.length; index++) {\n                const targets: Array<[CollectionEntry, string]> = [];\n                if (parent !== undefined) {\n                    targets.push([parent, \"parent\"]);\n                }\n                if (index > 0) {\n                    targets.push([children[index - 1], \"previous\"]);\n                }\n                if (index + 1 < children.length) {\n                    targets.push([children[index + 1], \"next\"]);\n                }\n                this.addLinkSet(children[index], undefined, targets, \"sequence-members\");\n            }\n        } else if (parent !== undefined) {\n            for (const child of children) {\n                this.addLinkSet(child, parent, [], collectionType + \"-members\");\n            }\n        }\n    }\n\n    private addLinkSet(\n        source: CollectionEntry,\n        parent: CollectionEntry | undefined,\n        siblings: CollectionEntry[] | Array<[CollectionEntry, string]>,\n        poolType: string\n    ): void {\n        if (source.linking !== \"normal\" && source.linking !== \"sourceonly\") {\n            return;\n        }\n        const targets: Array<[CollectionEntry, string]> = [];\n        if (parent !== undefined) {\n            targets.push([parent, \"parent\"]);\n        }\n        for (const sibling of siblings) {\n            targets.push(Array.isArray(sibling) ? sibling : [sibling, \"sibling\"]);\n        }\n        const linkpool: DitaElement = this.addLinkpool(source.topic.element, poolType);\n        for (const [target, role] of targets) {\n            this.addLink(linkpool, target, role);\n        }\n    }\n\n    private addLinkpool(topic: DitaElement, poolType: string): DitaElement {\n        let relatedLinks: DitaElement | undefined = DitaUtils.getChildByClass(topic, \"topic/related-links\");\n        if (relatedLinks === undefined) {\n            relatedLinks = new DitaElement(\"related-links\");\n            relatedLinks.setAttribute(new XMLAttribute(\"class\", \"- topic/related-links \"));\n            const before: DitaElement | undefined = topic.getChildren().find(\n                (child: DitaElement): boolean => DitaUtils.hasClass(child, \"topic/topic\")\n            );\n            const content: XMLNode[] = topic.getContent();\n            const index: number = before === undefined ? -1 : content.indexOf(before);\n            if (index < 0) {\n                topic.addElement(relatedLinks);\n            } else {\n                content.splice(index, 0, relatedLinks);\n                topic.setContent(content);\n            }\n        }\n        const linkpool: DitaElement = new DitaElement(\"linkpool\");\n        linkpool.setAttribute(new XMLAttribute(\"class\", \"- topic/linkpool \"));\n        linkpool.setAttribute(new XMLAttribute(\"mapkeyref\", this.mapHref + \" type=\" + poolType));\n        relatedLinks.setContent([linkpool, ...relatedLinks.getContent()]);\n        return linkpool;\n    }\n\n    private addLink(linkpool: DitaElement, target: CollectionEntry, role: string): void {\n        if (target.linking !== \"normal\" && target.linking !== \"targetonly\") {\n            return;\n        }\n        const link: DitaElement = new DitaElement(\"link\");\n        link.setAttribute(new XMLAttribute(\"class\", \"- topic/link \"));\n        link.setAttribute(new XMLAttribute(\"href\", target.href));\n        link.setAttribute(new XMLAttribute(\"scope\", \"local\"));\n        link.setAttribute(new XMLAttribute(\"format\", \"dita\"));\n        link.setAttribute(new XMLAttribute(\"role\", role));\n        if (target.linktext !== undefined) {\n            const linktext: DitaElement = DitaUtils.cloneElement(target.linktext);\n            linktext.setAttribute(new XMLAttribute(\"class\", \"- topic/linktext \"));\n            link.addElement(linktext);\n        }\n        if (target.shortdesc !== undefined) {\n            const desc: DitaElement = new DitaElement(\"desc\");\n            desc.setAttribute(new XMLAttribute(\"class\", \"- topic/desc \"));\n            desc.setContent(target.shortdesc.getContent().map((node: XMLNode): XMLNode =>\n                node instanceof DitaElement ? DitaUtils.cloneElement(node) : node\n            ));\n            link.addElement(desc);\n        }\n        linkpool.addElement(link);\n    }\n\n    private entry(element: DitaElement, documents: LoadedDocuments, mapPath: string): CollectionEntry | undefined {\n        const href: string | undefined = this.getAttribute(element, \"href\");\n        if (href === undefined) {\n            return undefined;\n        }\n        const scope: string = DitaUtils.getScope(element, href);\n        const format: string | undefined = DitaUtils.getFormat(element, href, scope);\n        if (format === undefined) {\n            this.diagnostics.warning(\n                this.diagnostics.i18n.format(this.diagnostics.i18n.getString(\"Filter\", \"missingAttribute\"), [\"format\"]),\n                mapPath\n            );\n            return undefined;\n        }\n        const linkingValue: string | undefined = this.getAttribute(element, \"linking\");\n        let linking: Linking;\n        if (linkingValue === undefined || linkingValue === \"normal\") {\n            linking = \"normal\";\n        } else if (linkingValue === \"none\" || linkingValue === \"sourceonly\" || linkingValue === \"targetonly\") {\n            linking = linkingValue;\n        } else {\n            this.diagnostics.warning(\n                this.diagnostics.i18n.format(\n                    this.diagnostics.i18n.getString(\"Filter\", \"invalidAttribute\"),\n                    [linkingValue, \"linking\"]\n                ),\n                mapPath\n            );\n            linking = \"none\";\n        }\n        const meta: DitaElement | undefined = DitaUtils.getChildByClass(element, \"map/topicmeta\");\n        const linktext: DitaElement | undefined = meta === undefined ? undefined : DitaUtils.getChildByClass(meta, \"map/linktext\");\n        const shortdesc: DitaElement | undefined = meta === undefined ? undefined : DitaUtils.getChildByClass(meta, \"map/shortdesc\");\n        const local: boolean = scope === \"local\" && format === \"dita\";\n        let topic: LoadedTopic | undefined;\n        let elementId: string | undefined;\n        let pointsOutside: boolean = false;\n        if (local) {\n            const hashIndex: number = href.indexOf(\"#\");\n            const topicHref: string = hashIndex < 0 ? href : href.slice(0, hashIndex);\n            const fragment: string | undefined = hashIndex < 0 ? undefined : URIComponent.decode(href.slice(hashIndex + 1));\n            let topicId: string | undefined = fragment;\n            if (fragment !== undefined) {\n                const slashIndex: number = fragment.indexOf(\"/\");\n                if (slashIndex > 0 && slashIndex + 1 < fragment.length) {\n                    topicId = fragment.slice(0, slashIndex);\n                    elementId = fragment.slice(slashIndex + 1);\n                }\n            }\n            let loadedDoc: LoadedDocument | undefined;\n            try {\n                loadedDoc = documents.load(topicHref);\n            } catch {\n                loadedDoc = undefined;\n            }\n            if (loadedDoc !== undefined) {\n                const loadedTopic: LoadedTopic | undefined = topicId === undefined\n                    ? loadedDoc.getFirstTopic()\n                    : loadedDoc.findTopicById(topicId);\n                if (loadedTopic === undefined) {\n                    pointsOutside = true;\n                } else if (!loadedTopic.isExcluded()) {\n                    topic = loadedTopic;\n                }\n            } else {\n                pointsOutside = true;\n            }\n        }\n        if (local && topic === undefined && pointsOutside) {\n            this.diagnostics.warning(\n                this.diagnostics.i18n.format(\n                    this.diagnostics.i18n.getString(\"LinkGenerator\", \"pointsOutsidePreprocessedTopics\"),\n                    [href]\n                ),\n                mapPath\n            );\n        }\n        if (topic === undefined) {\n            return undefined;\n        }\n        const resolvedHref: string = topic.getHref() + (elementId === undefined ? \"\" : \"/\" + URIComponent.quoteFragment(elementId));\n        return {\n            topic,\n            href: resolvedHref,\n            linking,\n            linktext,\n            shortdesc\n        };\n    }\n\n    private getAttribute(element: DitaElement, name: string): string | undefined {\n        return DitaUtils.getNonEmptyAttribute(element, name);\n    }\n\n    private getCollectionType(element: DitaElement): string {\n        const value: string | undefined = this.getAttribute(element, \"collection-type\");\n        return value === \"sequence\" || value === \"family\" || value === \"choice\" || value === \"unordered\"\n            ? value\n            : \"unordered\";\n    }\n}"]}

package/dist/preprocess/ConrefIncluder.d.ts

@@ -0,0 +1,26 @@
+import { DitaElement } from "../dom/DitaElement.js";
+import { DiagnosticLog } from "../utils/DiagnosticLog.js";
+import { Incl, Includer } from "./Includer.js";
+import { LoadedDocuments } from "./LoadedDocuments.js";
+export declare class ConrefIncl extends Incl {
+    readonly targetPath: string;
+    readonly targetId: string | undefined;
+    readonly targetId2: string | undefined;
+    readonly endOfRangeId: string | undefined;
+    constructor(directiveElement: DitaElement, sourcePath: string, conrefHref: string, conrefendHref: string | undefined);
+    getConrefHref(): string;
+    getConrefendHref(): string | undefined;
+}
+export declare class ConrefIncluder extends Includer {
+    constructor(documents: LoadedDocuments, diagnostics: DiagnosticLog);
+    protected detectInclusion(element: DitaElement, sourcePath: string): Incl | undefined;
+    private isValidUrl;
+    private reportInvalidAttribute;
+    protected fetchIncluded(incl: Incl): void;
+    private findConrefTarget;
+    private copyConrefTarget;
+    private checkConrefDomains;
+    private copyAttributes;
+    private copyConrefTargetRange;
+    private isSameOrSpecialized;
+}

package/dist/preprocess/ConrefIncluder.js

@@ -0,0 +1,312 @@
+/*
+ * 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 { DitaUtils } from "../utils/DitaUtils.js";
+import { URIComponent } from "../utils/URIComponent.js";
+import { Incl, Includer, InclusionException } from "./Includer.js";
+import { LoadedDocumentType } from "./LoadedDocument.js";
+export class ConrefIncl extends Incl {
+    targetPath;
+    targetId;
+    targetId2;
+    endOfRangeId;
+    constructor(directiveElement, sourcePath, conrefHref, conrefendHref) {
+        super(directiveElement, sourcePath);
+        const hashIndex1 = conrefHref.indexOf("#");
+        if (hashIndex1 < 0) {
+            this.targetPath = conrefHref;
+            this.targetId = undefined;
+            this.targetId2 = undefined;
+        }
+        else {
+            this.targetPath = conrefHref.slice(0, hashIndex1);
+            const fragment = URIComponent.decode(conrefHref.slice(hashIndex1 + 1));
+            const slashIndex = fragment.lastIndexOf("/");
+            if (slashIndex > 0 && slashIndex + 1 < fragment.length) {
+                this.targetId = fragment.slice(0, slashIndex);
+                this.targetId2 = fragment.slice(slashIndex + 1);
+            }
+            else {
+                this.targetId = fragment;
+                this.targetId2 = undefined;
+            }
+        }
+        let endId;
+        let endId2;
+        if (conrefendHref !== undefined) {
+            const hashIndex2 = conrefendHref.indexOf("#");
+            if (hashIndex2 >= 0) {
+                const endFragment = URIComponent.decode(conrefendHref.slice(hashIndex2 + 1));
+                const endSlashIndex = endFragment.lastIndexOf("/");
+                if (endSlashIndex > 0 && endSlashIndex + 1 < endFragment.length) {
+                    endId = endFragment.slice(0, endSlashIndex);
+                    endId2 = endFragment.slice(endSlashIndex + 1);
+                }
+                else {
+                    endId = endFragment;
+                    endId2 = undefined;
+                }
+            }
+        }
+        if (conrefendHref === undefined) {
+            this.endOfRangeId = undefined;
+        }
+        else if (this.targetId2 !== undefined) {
+            this.endOfRangeId = endId2;
+        }
+        else if (this.targetId !== undefined && endId2 === undefined) {
+            this.endOfRangeId = endId;
+        }
+        else {
+            this.endOfRangeId = undefined;
+        }
+    }
+    getConrefHref() {
+        let result = this.targetPath;
+        if (this.targetId !== undefined) {
+            result += "#" + URIComponent.quoteFragment(this.targetId);
+            if (this.targetId2 !== undefined) {
+                result += "/" + URIComponent.quoteFragment(this.targetId2);
+            }
+        }
+        return result;
+    }
+    getConrefendHref() {
+        if (this.endOfRangeId === undefined) {
+            return undefined;
+        }
+        let result = this.targetPath;
+        if (this.targetId2 !== undefined && this.targetId !== undefined) {
+            result += "#" + URIComponent.quoteFragment(this.targetId) + "/" + URIComponent.quoteFragment(this.endOfRangeId);
+        }
+        else {
+            result += "#" + URIComponent.quoteFragment(this.endOfRangeId);
+        }
+        return result;
+    }
+}
+export class ConrefIncluder extends Includer {
+    constructor(documents, diagnostics) {
+        super(documents, diagnostics);
+    }
+    detectInclusion(element, sourcePath) {
+        const conref = DitaUtils.getNonEmptyAttribute(element, "conref");
+        if (conref === undefined || DitaUtils.getNonEmptyAttribute(element, "conaction") !== undefined) {
+            return undefined;
+        }
+        if (!this.isValidUrl(conref)) {
+            this.reportInvalidAttribute(element, sourcePath, conref, "conref");
+            return undefined;
+        }
+        const conrefend = DitaUtils.getNonEmptyAttribute(element, "conrefend");
+        let validConrefend = conrefend;
+        if (conrefend !== undefined && !this.isValidUrl(conrefend)) {
+            this.reportInvalidAttribute(element, sourcePath, conrefend, "conrefend");
+            validConrefend = undefined;
+        }
+        const incl = new ConrefIncl(element, sourcePath, conref, validConrefend);
+        if (validConrefend !== undefined && incl.endOfRangeId === undefined) {
+            this.reportWarning(element, sourcePath, this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ConrefIncluder", "inconsistentConrefend"), [validConrefend, conref]));
+        }
+        return incl;
+    }
+    isValidUrl(value) {
+        try {
+            new URL(value);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    reportInvalidAttribute(element, sourcePath, value, attributeName) {
+        this.reportWarning(element, sourcePath, this.diagnostics.i18n.format(this.diagnostics.i18n.getString("Filter", "invalidAttribute"), [value, attributeName]));
+    }
+    fetchIncluded(incl) {
+        const conrefIncl = incl;
+        const targetDoc = this.fetchDoc(conrefIncl.targetPath);
+        const target = this.findConrefTarget(conrefIncl, targetDoc);
+        const copy = this.copyConrefTarget(incl.directiveElement, incl.sourcePath, target, conrefIncl.targetPath);
+        const targetId = DitaUtils.getNonEmptyAttribute(target, "id");
+        if (conrefIncl.endOfRangeId === undefined || conrefIncl.endOfRangeId === targetId) {
+            incl.replacementNodes = [copy];
+        }
+        else {
+            const copies = this.copyConrefTargetRange(conrefIncl, target);
+            incl.replacementNodes = [copy, ...copies];
+        }
+    }
+    findConrefTarget(incl, targetDoc) {
+        let target;
+        const root = DitaUtils.getRoot(targetDoc.document);
+        if (root !== undefined) {
+            switch (targetDoc.type) {
+                case LoadedDocumentType.MAP:
+                case LoadedDocumentType.BOOKMAP:
+                    if (incl.targetId === undefined) {
+                        target = root;
+                    }
+                    else if (incl.targetId2 === undefined) {
+                        target = DitaUtils.findById(root, incl.targetId);
+                    }
+                    break;
+                case LoadedDocumentType.MULTI_TOPIC:
+                case LoadedDocumentType.TOPIC:
+                    {
+                        const loadedTopic = incl.targetId === undefined
+                            ? targetDoc.getFirstTopic()
+                            : targetDoc.findTopicById(incl.targetId);
+                        if (loadedTopic !== undefined) {
+                            target = incl.targetId2 === undefined
+                                ? loadedTopic.element
+                                : DitaUtils.findById(loadedTopic.element, incl.targetId2, false);
+                        }
+                    }
+                    break;
+                default:
+                    break;
+            }
+        }
+        if (target === undefined) {
+            throw new InclusionException(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ConrefIncluder", "targetNotFound"), [incl.getConrefHref(), "conref"]));
+        }
+        return target;
+    }
+    copyConrefTarget(conrefSource, sourcePath, conrefTarget, targetPath) {
+        this.checkConrefDomains(conrefSource, sourcePath, conrefTarget, targetPath);
+        const copy = this.cloneElement(conrefTarget);
+        this.copyAttributes(conrefSource, conrefTarget, copy);
+        return copy;
+    }
+    checkConrefDomains(conrefSource, sourcePath, conrefTarget, targetPath) {
+        if (conrefSource.getName() !== conrefTarget.getName()) {
+            throw new InclusionException(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ConrefIncluder", "sourceAndTargetAreDifferentElements"), [conrefSource.getName(), conrefTarget.getName()]));
+        }
+        const sourceDomains = DitaUtils.lookupAncestorAttribute(conrefSource, "domains");
+        if (sourceDomains === undefined || sourceDomains.length === 0) {
+            throw new InclusionException(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ConrefIncluder", "noDomains"), [sourcePath]));
+        }
+        const targetDomains = DitaUtils.lookupAncestorAttribute(conrefTarget, "domains");
+        if (targetDomains === undefined || targetDomains.length === 0) {
+            throw new InclusionException(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ConrefIncluder", "noDomains"), [targetPath]));
+        }
+        if (!DitaUtils.checkDomains(sourceDomains, targetDomains)) {
+            this.diagnostics.warning(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ConrefIncluder", "domainMismatch"), [DitaUtils.collapseWhitespace(targetDomains), DitaUtils.collapseWhitespace(sourceDomains)]), sourcePath + ": " + conrefSource.getName());
+        }
+    }
+    copyAttributes(conrefSource, conrefTarget, copy) {
+        for (const attribute of copy.getAttributes()) {
+            copy.removeAttribute(attribute.getName());
+        }
+        const dontCopyFromTarget = new Set(["id", "xtrf", "xtrc", "xml:lang"]);
+        for (const attribute of conrefSource.getAttributes()) {
+            const name = attribute.getName();
+            const value = attribute.getValue();
+            if (name === "id") {
+                copy.setAttribute(new XMLAttribute(name, value));
+            }
+            else if (name !== "conref" && name !== "conrefend" && name !== "xtrf" && name !== "xtrc" &&
+                name !== "xml:lang" && value !== "-dita-use-conref-target" && value !== "???") {
+                copy.setAttribute(new XMLAttribute(name, value));
+                dontCopyFromTarget.add(name);
+            }
+        }
+        for (const attribute of conrefTarget.getAttributes()) {
+            const name = attribute.getName();
+            if (!dontCopyFromTarget.has(name)) {
+                copy.setAttribute(new XMLAttribute(name, attribute.getValue()));
+            }
+        }
+        const lang = DitaUtils.lookupAncestorAttributeRaw(conrefTarget, "xml:lang");
+        if (lang !== undefined && lang.length > 0) {
+            copy.setAttribute(new XMLAttribute("xml:lang", lang));
+        }
+    }
+    copyConrefTargetRange(incl, conrefTarget) {
+        const parent = conrefTarget.getParent();
+        if (parent === undefined) {
+            throw new InclusionException(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ConrefIncluder", "targetNotFound"), [incl.getConrefendHref(), "conrefend"]));
+        }
+        const siblings = parent.getContent();
+        const startIndex = siblings.indexOf(conrefTarget);
+        let endOfRange;
+        let endIndex = -1;
+        for (let index = startIndex + 1; index < siblings.length; index++) {
+            const node = siblings[index];
+            if (node instanceof DitaElement && DitaUtils.getNonEmptyAttribute(node, "id") === incl.endOfRangeId) {
+                endOfRange = node;
+                endIndex = index;
+                break;
+            }
+        }
+        if (endOfRange === undefined) {
+            throw new InclusionException(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ConrefIncluder", "targetNotFound"), [incl.getConrefendHref(), "conrefend"]));
+        }
+        if (endOfRange.getName() !== conrefTarget.getName()) {
+            throw new InclusionException(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ConrefIncluder", "invalidConrefRange"), [conrefTarget.getName(), endOfRange.getName()]));
+        }
+        const conrefSource = incl.directiveElement;
+        const conrefSourceParent = conrefSource.getParent();
+        const conrefTargetParent = conrefTarget.getParent();
+        if (conrefSourceParent !== undefined && conrefTargetParent !== undefined &&
+            conrefSourceParent.getName() !== conrefTargetParent.getName() &&
+            !this.isSameOrSpecialized(conrefTargetParent, conrefSourceParent)) {
+            throw new InclusionException(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ConrefIncluder", "targetParentNotSpecializedFromSourceParent"), [conrefTargetParent.getName(), conrefSourceParent.getName()]));
+        }
+        const range = [];
+        for (let index = startIndex + 1; index <= endIndex; index++) {
+            const node = siblings[index];
+            if (!(node instanceof DitaElement)) {
+                range.push(this.cloneNode(node));
+                continue;
+            }
+            const copy = this.cloneElement(node);
+            if (node.getName() === conrefSource.getName()) {
+                const savedId = DitaUtils.getNonEmptyAttribute(node, "id");
+                this.copyAttributes(conrefSource, node, copy);
+                if (savedId !== undefined) {
+                    copy.setAttribute(new XMLAttribute("id", savedId));
+                }
+                else {
+                    copy.removeAttribute("id");
+                }
+            }
+            if (node === endOfRange) {
+                copy.removeAttribute("id");
+                range.push(copy);
+                break;
+            }
+            range.push(copy);
+        }
+        return range;
+    }
+    isSameOrSpecialized(candidate, base) {
+        if (candidate.getName() === base.getName()) {
+            return true;
+        }
+        const baseClass = base.getAttribute("class");
+        const candidateClass = candidate.getAttribute("class");
+        if (baseClass === undefined || candidateClass === undefined) {
+            return false;
+        }
+        const baseValue = DitaUtils.collapseWhitespace(baseClass.getValue());
+        const candidateValue = DitaUtils.collapseWhitespace(candidateClass.getValue());
+        if (baseValue.length === 0 || candidateValue.length === 0) {
+            return false;
+        }
+        return candidateValue.startsWith(baseValue.slice(2), 2);
+    }
+}
+//# sourceMappingURL=ConrefIncluder.js.map