npm - typesditac - Versions diffs - 1.0.0 - Mend

typesditac 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1346) hide show

package/dist/preprocess/ReltableProcessor.js ADDED Viewed

@@ -0,0 +1,257 @@
+/*
+ * 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 ReltableProcessor {
+    diagnostics;
+    constructor(diagnostics) {
+        this.diagnostics = diagnostics;
+    }
+    process(root, documents, mapPath) {
+        const collected = new Map();
+        for (const child of root.getChildren()) {
+            if (DitaUtils.hasClass(child, "map/reltable")) {
+                this.processColumns(child, documents, mapPath, collected);
+                this.processRows(child, documents, mapPath, collected);
+            }
+        }
+        if (collected.size === 0) {
+            return;
+        }
+        const mapHref = DitaUtils.toFileUrl(mapPath);
+        for (const [topic, entries] of collected) {
+            this.addRelatedLinks(topic, entries, mapHref);
+        }
+    }
+    processColumns(reltable, documents, mapPath, collected) {
+        const header = DitaUtils.getChildByClass(reltable, "map/relheader");
+        if (header === undefined) {
+            return;
+        }
+        const relcolspecs = header.getChildren().filter((element) => DitaUtils.hasClass(element, "map/relcolspec"));
+        const rows = reltable.getChildren().filter((element) => DitaUtils.hasClass(element, "map/relrow"));
+        for (let column = 0; column < relcolspecs.length; column++) {
+            const headerEntries = this.entries(relcolspecs[column], documents, mapPath);
+            if (headerEntries.length === 0) {
+                continue;
+            }
+            const cellList = [headerEntries];
+            for (const row of rows) {
+                const cell = row.getChildren()[column];
+                cellList.push(cell !== undefined && DitaUtils.hasClass(cell, "map/relcell")
+                    ? this.entries(cell, documents, mapPath)
+                    : []);
+            }
+            this.addColumn(cellList, collected);
+        }
+    }
+    addColumn(cellList, collected) {
+        if (cellList.length < 2) {
+            return;
+        }
+        const sources = cellList[0];
+        for (let index = 1; index < cellList.length; index++) {
+            const targets = cellList[index];
+            this.addLinks(sources, targets, collected);
+            this.addLinks(targets, sources, collected);
+        }
+    }
+    processRows(reltable, documents, mapPath, collected) {
+        for (const row of reltable.getChildren().filter((element) => DitaUtils.hasClass(element, "map/relrow"))) {
+            const cellList = [];
+            for (const cell of row.getChildren().filter((element) => DitaUtils.hasClass(element, "map/relcell"))) {
+                cellList.push(this.entries(cell, documents, mapPath));
+            }
+            this.addRow(cellList, collected);
+        }
+    }
+    addRow(cellList, collected) {
+        for (let index = 0; index < cellList.length; index++) {
+            const sources = cellList[index];
+            for (let target = 0; target < cellList.length; target++) {
+                if (target === index) {
+                    continue;
+                }
+                this.addLinks(sources, cellList[target], collected);
+            }
+        }
+    }
+    addLinks(sources, targets, collected) {
+        for (const source of sources) {
+            if ((source.linking !== "normal" && source.linking !== "sourceonly") || source.topic === undefined) {
+                continue;
+            }
+            for (const target of targets) {
+                if (target.topic === source.topic ||
+                    (target.linking !== "normal" && target.linking !== "targetonly")) {
+                    continue;
+                }
+                const existing = collected.get(source.topic) ?? [];
+                if (!existing.some((entry) => entry.href === target.href)) {
+                    existing.push(target);
+                }
+                collected.set(source.topic, existing);
+            }
+        }
+    }
+    entries(cell, documents, mapPath) {
+        const entries = [];
+        this.processCell(cell, documents, mapPath, entries);
+        return entries;
+    }
+    processCell(cell, documents, mapPath, entries) {
+        for (const element of cell.getChildren()) {
+            const href = DitaUtils.getNonEmptyAttribute(element, "href");
+            if (DitaUtils.hasClass(element, "map/topicref") && href !== undefined) {
+                const entry = this.createEntry(element, href, documents, mapPath);
+                if (entry !== undefined) {
+                    entries.push(entry);
+                }
+            }
+            this.processCell(element, documents, mapPath, entries);
+        }
+    }
+    createEntry(element, href, documents, mapPath) {
+        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 = DitaUtils.getNonEmptyAttribute(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) {
+            if (pointsOutside) {
+                this.diagnostics.warning(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("LinkGenerator", "pointsOutsidePreprocessedTopics"), [href]), mapPath);
+            }
+            return undefined;
+        }
+        if (!local && linking !== "none") {
+            linking = "targetonly";
+        }
+        const resolvedHref = topic === undefined
+            ? href
+            : topic.getHref() + (elementId === undefined ? "" : "/" + URIComponent.quoteFragment(elementId));
+        return {
+            topic,
+            href: resolvedHref,
+            scope,
+            format,
+            linking,
+            linktext,
+            shortdesc
+        };
+    }
+    addRelatedLinks(topic, entries, mapHref) {
+        const linkpool = this.addLinkpool(topic.element, "related", mapHref);
+        for (const entry of entries) {
+            this.addLink(linkpool, entry);
+        }
+    }
+    addLinkpool(topic, poolType, mapHref) {
+        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", mapHref + " type=" + poolType));
+        relatedLinks.addElement(linkpool);
+        return linkpool;
+    }
+    addLink(linkpool, entry) {
+        const link = new DitaElement("link");
+        link.setAttribute(new XMLAttribute("class", "- topic/link "));
+        link.setAttribute(new XMLAttribute("href", entry.href));
+        link.setAttribute(new XMLAttribute("scope", entry.scope));
+        link.setAttribute(new XMLAttribute("format", entry.format));
+        if (entry.linktext !== undefined) {
+            const linktext = DitaUtils.cloneElement(entry.linktext);
+            linktext.setAttribute(new XMLAttribute("class", "- topic/linktext "));
+            link.addElement(linktext);
+        }
+        if (entry.shortdesc !== undefined) {
+            const desc = new DitaElement("desc");
+            desc.setAttribute(new XMLAttribute("class", "- topic/desc "));
+            desc.setContent(entry.shortdesc.getContent().map((node) => node instanceof DitaElement ? DitaUtils.cloneElement(node) : node));
+            link.addElement(desc);
+        }
+        linkpool.addElement(link);
+    }
+}
+//# sourceMappingURL=ReltableProcessor.js.map

package/dist/preprocess/ReltableProcessor.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ReltableProcessor.js","sourceRoot":"","sources":["../../ts/preprocess/ReltableProcessor.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 ReltableEntry {\n readonly topic?: LoadedTopic;\n readonly href: string;\n readonly scope: string;\n readonly format: string;\n readonly linking: Linking;\n readonly linktext?: DitaElement;\n readonly shortdesc?: DitaElement;\n}\n\nexport class ReltableProcessor {\n readonly diagnostics: DiagnosticLog;\n\n constructor(diagnostics: DiagnosticLog) {\n this.diagnostics = diagnostics;\n }\n\n process(root: DitaElement, documents: LoadedDocuments, mapPath: string): void {\n const collected: Map<LoadedTopic, ReltableEntry[]> = new Map();\n for (const child of root.getChildren()) {\n if (DitaUtils.hasClass(child, \"map/reltable\")) {\n this.processColumns(child, documents, mapPath, collected);\n this.processRows(child, documents, mapPath, collected);\n }\n }\n if (collected.size === 0) {\n return;\n }\n const mapHref: string = DitaUtils.toFileUrl(mapPath);\n for (const [topic, entries] of collected) {\n this.addRelatedLinks(topic, entries, mapHref);\n }\n }\n\n private processColumns(\n reltable: DitaElement,\n documents: LoadedDocuments,\n mapPath: string,\n collected: Map<LoadedTopic, ReltableEntry[]>\n ): void {\n const header: DitaElement | undefined = DitaUtils.getChildByClass(reltable, \"map/relheader\");\n if (header === undefined) {\n return;\n }\n const relcolspecs: DitaElement[] = header.getChildren().filter(\n (element: DitaElement): boolean => DitaUtils.hasClass(element, \"map/relcolspec\")\n );\n const rows: DitaElement[] = reltable.getChildren().filter(\n (element: DitaElement): boolean => DitaUtils.hasClass(element, \"map/relrow\")\n );\n for (let column: number = 0; column < relcolspecs.length; column++) {\n const headerEntries: ReltableEntry[] = this.entries(relcolspecs[column], documents, mapPath);\n if (headerEntries.length === 0) {\n continue;\n }\n const cellList: ReltableEntry[][] = [headerEntries];\n for (const row of rows) {\n const cell: DitaElement | undefined = row.getChildren()[column];\n cellList.push(cell !== undefined && DitaUtils.hasClass(cell, \"map/relcell\")\n ? this.entries(cell, documents, mapPath)\n : []);\n }\n this.addColumn(cellList, collected);\n }\n }\n\n private addColumn(cellList: ReltableEntry[][], collected: Map<LoadedTopic, ReltableEntry[]>): void {\n if (cellList.length < 2) {\n return;\n }\n const sources: ReltableEntry[] = cellList[0];\n for (let index: number = 1; index < cellList.length; index++) {\n const targets: ReltableEntry[] = cellList[index];\n this.addLinks(sources, targets, collected);\n this.addLinks(targets, sources, collected);\n }\n }\n\n private processRows(\n reltable: DitaElement,\n documents: LoadedDocuments,\n mapPath: string,\n collected: Map<LoadedTopic, ReltableEntry[]>\n ): void {\n for (const row of reltable.getChildren().filter(\n (element: DitaElement): boolean => DitaUtils.hasClass(element, \"map/relrow\")\n )) {\n const cellList: ReltableEntry[][] = [];\n for (const cell of row.getChildren().filter(\n (element: DitaElement): boolean => DitaUtils.hasClass(element, \"map/relcell\")\n )) {\n cellList.push(this.entries(cell, documents, mapPath));\n }\n this.addRow(cellList, collected);\n }\n }\n\n private addRow(cellList: ReltableEntry[][], collected: Map<LoadedTopic, ReltableEntry[]>): void {\n for (let index: number = 0; index < cellList.length; index++) {\n const sources: ReltableEntry[] = cellList[index];\n for (let target: number = 0; target < cellList.length; target++) {\n if (target === index) {\n continue;\n }\n this.addLinks(sources, cellList[target], collected);\n }\n }\n }\n\n private addLinks(sources: ReltableEntry[], targets: ReltableEntry[], collected: Map<LoadedTopic, ReltableEntry[]>): void {\n for (const source of sources) {\n if ((source.linking !== \"normal\" && source.linking !== \"sourceonly\") || source.topic === undefined) {\n continue;\n }\n for (const target of targets) {\n if (target.topic === source.topic ||\n (target.linking !== \"normal\" && target.linking !== \"targetonly\")) {\n continue;\n }\n const existing: ReltableEntry[] = collected.get(source.topic) ?? [];\n if (!existing.some((entry: ReltableEntry): boolean => entry.href === target.href)) {\n existing.push(target);\n }\n collected.set(source.topic, existing);\n }\n }\n }\n\n private entries(cell: DitaElement, documents: LoadedDocuments, mapPath: string): ReltableEntry[] {\n const entries: ReltableEntry[] = [];\n this.processCell(cell, documents, mapPath, entries);\n return entries;\n }\n\n private processCell(\n cell: DitaElement,\n documents: LoadedDocuments,\n mapPath: string,\n entries: ReltableEntry[]\n ): void {\n for (const element of cell.getChildren()) {\n const href: string | undefined = DitaUtils.getNonEmptyAttribute(element, \"href\");\n if (DitaUtils.hasClass(element, \"map/topicref\") && href !== undefined) {\n const entry: ReltableEntry | undefined = this.createEntry(element, href, documents, mapPath);\n if (entry !== undefined) {\n entries.push(entry);\n }\n }\n this.processCell(element, documents, mapPath, entries);\n }\n }\n\n private createEntry(\n element: DitaElement,\n href: string,\n documents: LoadedDocuments,\n mapPath: string\n ): ReltableEntry | undefined {\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 = DitaUtils.getNonEmptyAttribute(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) {\n if (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 return undefined;\n }\n if (!local && linking !== \"none\") {\n linking = \"targetonly\";\n }\n const resolvedHref: string = topic === undefined\n ? href\n : topic.getHref() + (elementId === undefined ? \"\" : \"/\" + URIComponent.quoteFragment(elementId));\n return {\n topic,\n href: resolvedHref,\n scope,\n format,\n linking,\n linktext,\n shortdesc\n };\n }\n\n private addRelatedLinks(topic: LoadedTopic, entries: ReltableEntry[], mapHref: string): void {\n const linkpool: DitaElement = this.addLinkpool(topic.element, \"related\", mapHref);\n for (const entry of entries) {\n this.addLink(linkpool, entry);\n }\n }\n\n private addLinkpool(topic: DitaElement, poolType: string, mapHref: 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\", mapHref + \" type=\" + poolType));\n relatedLinks.addElement(linkpool);\n return linkpool;\n }\n\n private addLink(linkpool: DitaElement, entry: ReltableEntry): void {\n const link: DitaElement = new DitaElement(\"link\");\n link.setAttribute(new XMLAttribute(\"class\", \"- topic/link \"));\n link.setAttribute(new XMLAttribute(\"href\", entry.href));\n link.setAttribute(new XMLAttribute(\"scope\", entry.scope));\n link.setAttribute(new XMLAttribute(\"format\", entry.format));\n if (entry.linktext !== undefined) {\n const linktext: DitaElement = DitaUtils.cloneElement(entry.linktext);\n linktext.setAttribute(new XMLAttribute(\"class\", \"- topic/linktext \"));\n link.addElement(linktext);\n }\n if (entry.shortdesc !== undefined) {\n const desc: DitaElement = new DitaElement(\"desc\");\n desc.setAttribute(new XMLAttribute(\"class\", \"- topic/desc \"));\n desc.setContent(entry.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"]}

package/dist/preprocess/ResourceHandler.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+import { I18n } from "../i18n/I18n.js";
+export declare class ResourceHandler {
+    private media;
+    private resourcePath;
+    private readonly urlToPath;
+    private readonly i18n;
+    constructor(parameters: string | undefined, i18n: I18n);
+    setMedia(media: "screen" | "print"): void;
+    getMedia(): "screen" | "print";
+    parseParameters(parameters: string): void;
+    reset(): void;
+    handleResource(resourceURL: string, isImage: boolean, outDir: string): string | undefined;
+    private static joinBaseName;
+    private static joinPath;
+    private static isFile;
+    private doHandleResource;
+}

package/dist/preprocess/ResourceHandler.js ADDED Viewed

@@ -0,0 +1,129 @@
+/*
+ * 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 { copyFileSync, existsSync, mkdirSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, isAbsolute, resolve, sep } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { DitaUtils } from "../utils/DitaUtils.js";
+import { URIComponent } from "../utils/URIComponent.js";
+export class ResourceHandler {
+    media = "screen";
+    resourcePath;
+    urlToPath = new Map();
+    i18n;
+    constructor(parameters, i18n) {
+        this.i18n = i18n;
+        if (parameters !== undefined) {
+            this.parseParameters(parameters);
+        }
+    }
+    setMedia(media) {
+        this.media = media;
+    }
+    getMedia() {
+        return this.media;
+    }
+    parseParameters(parameters) {
+        const trimmed = parameters.trim();
+        if (trimmed.length > 0) {
+            this.resourcePath = trimmed;
+            if (sep !== "/" && this.resourcePath.indexOf("/") >= 0) {
+                this.resourcePath = this.resourcePath.split("/").join(sep);
+            }
+        }
+    }
+    reset() {
+        this.urlToPath.clear();
+    }
+    handleResource(resourceURL, isImage, outDir) {
+        const existing = this.urlToPath.get(resourceURL);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const isRemote = /^https?:\/\//i.test(resourceURL);
+        const sourcePath = isRemote
+            ? resourceURL
+            : (resourceURL.startsWith("file:") ? fileURLToPath(resourceURL) : resourceURL);
+        const baseName = isRemote
+            ? URIComponent.getBaseName(new URL(resourceURL).pathname)
+            : basename(sourcePath);
+        if (baseName.length === 0) {
+            return undefined;
+        }
+        const dot = baseName.lastIndexOf(".");
+        const rootName = dot > 0 ? baseName.slice(0, dot) : baseName;
+        const extension = dot > 0 ? baseName.slice(dot + 1) : undefined;
+        let outFile = "";
+        let location;
+        for (let i = 0; i < 1000; ++i) {
+            const name = ResourceHandler.joinBaseName(rootName, i, extension);
+            let path = ResourceHandler.joinPath(this.resourcePath, name);
+            const isAbsolutePath = isAbsolute(path);
+            outFile = isAbsolutePath ? path : resolve(outDir, path);
+            if (!ResourceHandler.isFile(outFile)) {
+                if (isAbsolutePath) {
+                    location = pathToFileURL(outFile).toString();
+                }
+                else {
+                    if (sep !== "/" && path.indexOf(sep) >= 0) {
+                        path = path.split(sep).join("/");
+                    }
+                    location = URIComponent.quoteFullPath(path);
+                }
+                break;
+            }
+        }
+        if (location === undefined) {
+            return undefined;
+        }
+        const resourceDir = dirname(outFile);
+        if (!existsSync(resourceDir)) {
+            mkdirSync(resourceDir, { recursive: true });
+        }
+        this.doHandleResource(resourceURL, sourcePath, outFile);
+        this.urlToPath.set(resourceURL, location);
+        return location;
+    }
+    static joinBaseName(rootName, index, extension) {
+        let buffer = rootName;
+        if (index > 0) {
+            buffer += "-" + (1 + index).toString();
+        }
+        if (extension !== undefined) {
+            buffer += "." + extension;
+        }
+        return buffer;
+    }
+    static joinPath(resourcePath, baseName) {
+        if (resourcePath !== undefined) {
+            let buffer = resourcePath;
+            if (!resourcePath.endsWith(sep)) {
+                buffer += sep;
+            }
+            return buffer + baseName;
+        }
+        return baseName;
+    }
+    static isFile(path) {
+        return existsSync(path) && statSync(path).isFile();
+    }
+    doHandleResource(resourceURL, sourcePath, outFile) {
+        if (/^https?:\/\//i.test(resourceURL)) {
+            writeFileSync(outFile, DitaUtils.retrieveBytes(resourceURL, this.i18n));
+        }
+        else {
+            copyFileSync(sourcePath, outFile);
+        }
+    }
+}
+//# sourceMappingURL=ResourceHandler.js.map

package/dist/preprocess/ResourceHandler.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ResourceHandler.js","sourceRoot":"","sources":["../../ts/preprocess/ResourceHandler.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 { copyFileSync, existsSync, mkdirSync, statSync, writeFileSync } from \"node:fs\";\nimport { basename, dirname, isAbsolute, resolve, sep } from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { I18n } from \"../i18n/I18n.js\";\nimport { DitaUtils } from \"../utils/DitaUtils.js\";\nimport { URIComponent } from \"../utils/URIComponent.js\";\n\nexport class ResourceHandler {\n private media: \"screen\" | \"print\" = \"screen\";\n private resourcePath: string | undefined;\n private readonly urlToPath: Map<string, string> = new Map<string, string>();\n private readonly i18n: I18n;\n\n constructor(parameters: string | undefined, i18n: I18n) {\n this.i18n = i18n;\n if (parameters !== undefined) {\n this.parseParameters(parameters);\n }\n }\n\n setMedia(media: \"screen\" | \"print\"): void {\n this.media = media;\n }\n\n getMedia(): \"screen\" | \"print\" {\n return this.media;\n }\n\n parseParameters(parameters: string): void {\n const trimmed: string = parameters.trim();\n if (trimmed.length > 0) {\n this.resourcePath = trimmed;\n if (sep !== \"/\" && this.resourcePath.indexOf(\"/\") >= 0) {\n this.resourcePath = this.resourcePath.split(\"/\").join(sep);\n }\n }\n }\n\n reset(): void {\n this.urlToPath.clear();\n }\n\n handleResource(resourceURL: string, isImage: boolean, outDir: string): string | undefined {\n const existing: string | undefined = this.urlToPath.get(resourceURL);\n if (existing !== undefined) {\n return existing;\n }\n\n const isRemote: boolean = /^https?:\\/\\//i.test(resourceURL);\n const sourcePath: string = isRemote\n ? resourceURL\n : (resourceURL.startsWith(\"file:\") ? fileURLToPath(resourceURL) : resourceURL);\n const baseName: string = isRemote\n ? URIComponent.getBaseName(new URL(resourceURL).pathname)\n : basename(sourcePath);\n if (baseName.length === 0) {\n return undefined;\n }\n\n const dot: number = baseName.lastIndexOf(\".\");\n const rootName: string = dot > 0 ? baseName.slice(0, dot) : baseName;\n const extension: string | undefined = dot > 0 ? baseName.slice(dot + 1) : undefined;\n\n let outFile: string = \"\";\n let location: string | undefined;\n for (let i: number = 0; i < 1000; ++i) {\n const name: string = ResourceHandler.joinBaseName(rootName, i, extension);\n let path: string = ResourceHandler.joinPath(this.resourcePath, name);\n\n const isAbsolutePath: boolean = isAbsolute(path);\n outFile = isAbsolutePath ? path : resolve(outDir, path);\n if (!ResourceHandler.isFile(outFile)) {\n if (isAbsolutePath) {\n location = pathToFileURL(outFile).toString();\n } else {\n if (sep !== \"/\" && path.indexOf(sep) >= 0) {\n path = path.split(sep).join(\"/\");\n }\n location = URIComponent.quoteFullPath(path);\n }\n break;\n }\n }\n if (location === undefined) {\n return undefined;\n }\n\n const resourceDir: string = dirname(outFile);\n if (!existsSync(resourceDir)) {\n mkdirSync(resourceDir, { recursive: true });\n }\n\n this.doHandleResource(resourceURL, sourcePath, outFile);\n\n this.urlToPath.set(resourceURL, location);\n return location;\n }\n\n private static joinBaseName(rootName: string, index: number, extension: string | undefined): string {\n let buffer: string = rootName;\n if (index > 0) {\n buffer += \"-\" + (1 + index).toString();\n }\n if (extension !== undefined) {\n buffer += \".\" + extension;\n }\n return buffer;\n }\n\n private static joinPath(resourcePath: string | undefined, baseName: string): string {\n if (resourcePath !== undefined) {\n let buffer: string = resourcePath;\n if (!resourcePath.endsWith(sep)) {\n buffer += sep;\n }\n return buffer + baseName;\n }\n return baseName;\n }\n\n private static isFile(path: string): boolean {\n return existsSync(path) && statSync(path).isFile();\n }\n\n private doHandleResource(resourceURL: string, sourcePath: string, outFile: string): void {\n if (/^https?:\\/\\//i.test(resourceURL)) {\n writeFileSync(outFile, DitaUtils.retrieveBytes(resourceURL, this.i18n));\n } else {\n copyFileSync(sourcePath, outFile);\n }\n }\n}\n"]}

package/dist/preprocess/SimplifyTopicrefs.d.ts ADDED Viewed

@@ -0,0 +1,26 @@
+import { DitaElement } from "../dom/DitaElement.js";
+import { I18n } from "../i18n/I18n.js";
+import { DiagnosticLog } from "../utils/DiagnosticLog.js";
+import { LoadedDocuments } from "./LoadedDocuments.js";
+export declare class SimplifyTopicrefs {
+    private static readonly KEY_SPACE_ATTRIBUTE;
+    private static readonly COPY_OF_ATTRIBUTE;
+    private constructor();
+    static processMap(map: DitaElement, mapPath: string, diagnostics: DiagnosticLog): void;
+    private static processMap1;
+    private static updateKeySpace;
+    private static processMap2;
+    private static updateHref;
+    private static splitHref;
+    private static updateKeyscope;
+    private static ditavalmetaFromDitavalref;
+    private static getNonEmptyChildText;
+    static duplicateTopics(map: DitaElement, i18n: I18n): void;
+    private static duplicateTopicsBranch;
+    private static checkHref;
+    private static copyToName;
+    static createTopicCopies(tree: DitaElement, mapPath: string, documents: LoadedDocuments, diagnostics: DiagnosticLog): void;
+    private static createTopicCopy;
+    private static insertBefore;
+    private static removeNode;
+}