typesditac 1.0.0

package/dist/preprocess/KeySpaces.js

@@ -0,0 +1,291 @@
+/*
+ * 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 { ProcessingInstruction } from "typesxml";
+import { DitaElement } from "../dom/DitaElement.js";
+import { DitaUtils } from "../utils/DitaUtils.js";
+import { URIComponent } from "../utils/URIComponent.js";
+import { KeySpace } from "./KeySpace.js";
+import { LoadedDocumentType } from "./LoadedDocument.js";
+export class KeySpaces {
+    rootKeySpace;
+    keySpaces = new Map();
+    topicToKeySpace = new Map();
+    elementToKeySpace = new WeakMap();
+    constructor() {
+        this.rootKeySpace = new KeySpace("0");
+        this.keySpaces.set(this.rootKeySpace.id, this.rootKeySpace);
+    }
+    add(keySpace) {
+        this.keySpaces.set(keySpace.id, keySpace);
+    }
+    getRootKeySpace() {
+        return this.rootKeySpace;
+    }
+    getKeySpaceById(id) {
+        return this.keySpaces.get(id);
+    }
+    getAllKeySpaces() {
+        return [...this.keySpaces.values()];
+    }
+    toString() {
+        const lines = [];
+        this.appendKeySpace(this.rootKeySpace, false, lines);
+        if (this.topicToKeySpace.size > 0) {
+            lines.push("Topic URI to key space:");
+            for (const [topic, keySpace] of this.topicToKeySpace) {
+                lines.push(topic + "=" + keySpace.id);
+            }
+        }
+        return lines.join("\n");
+    }
+    mapTopicToKeySpace(topicLocation, keySpace) {
+        this.topicToKeySpace.set(topicLocation, keySpace);
+    }
+    mapElementToKeySpace(element, keySpace) {
+        this.elementToKeySpace.set(element, keySpace);
+    }
+    getElementKeySpace(element) {
+        const registered = this.elementToKeySpace.get(element);
+        if (registered !== undefined) {
+            return registered;
+        }
+        let insideTopic = false;
+        let ancestor = element;
+        while (ancestor !== undefined) {
+            if (DitaUtils.hasClass(ancestor, "topic/topic")) {
+                insideTopic = true;
+                break;
+            }
+            ancestor = ancestor.getParent();
+        }
+        if (insideTopic) {
+            let current = element.getParent();
+            while (current !== undefined) {
+                const keySpace = this.elementToKeySpace.get(current);
+                if (keySpace !== undefined) {
+                    return keySpace;
+                }
+                current = current.getParent();
+            }
+            return this.rootKeySpace;
+        }
+        return this.findMapKeySpace(element) ?? this.rootKeySpace;
+    }
+    findMapKeySpace(element) {
+        let current = element;
+        while (current !== undefined) {
+            let keySpaceId = DitaUtils.getNonEmptyAttribute(current, "ditac:keySpace");
+            if (keySpaceId === undefined) {
+                keySpaceId = this.findGroupKeySpaceId(current);
+            }
+            if (keySpaceId !== undefined) {
+                return this.getKeySpaceById(keySpaceId);
+            }
+            current = current.getParent();
+        }
+        return undefined;
+    }
+    findGroupKeySpaceId(element) {
+        const parent = element.getParent();
+        if (parent === undefined) {
+            return undefined;
+        }
+        const content = parent.getContent();
+        let nesting = 0;
+        for (let index = content.indexOf(element) - 1; index >= 0; index--) {
+            const node = content[index];
+            if (node instanceof ProcessingInstruction) {
+                if (node.getTarget() === "ditac-end-group") {
+                    nesting++;
+                }
+                else if (node.getTarget() === "ditac-begin-group") {
+                    if (nesting > 0) {
+                        nesting--;
+                    }
+                    else {
+                        return this.getPseudoAttribute(node.getData(), "ditac:keySpace");
+                    }
+                }
+            }
+        }
+        return undefined;
+    }
+    getTopicKeySpace(topicLocation) {
+        return this.topicToKeySpace.get(topicLocation) ?? this.rootKeySpace;
+    }
+    lookupKeyDefinition(keySpace, key) {
+        const hierarchy = [];
+        let current = keySpace;
+        while (current !== undefined) {
+            hierarchy.push(current);
+            current = current.getParentKeySpace();
+        }
+        for (let index = hierarchy.length - 1; index >= 0; index--) {
+            const definition = hierarchy[index].get(key);
+            if (definition !== undefined) {
+                return definition;
+            }
+        }
+        return undefined;
+    }
+    resolveReference(keySpace, reference) {
+        const slashIndex = reference.indexOf("/");
+        const key = slashIndex < 0 ? reference : reference.slice(0, slashIndex);
+        const fragment = slashIndex < 0 ? undefined : reference.slice(slashIndex + 1);
+        if (!DitaUtils.isValidKey(key) || (fragment !== undefined && !DitaUtils.isValidId(fragment))) {
+            return undefined;
+        }
+        return { keySpace, key, fragment };
+    }
+    get(key, context) {
+        return this.lookupKeyDefinition(this.getElementKeySpace(context), key);
+    }
+    getHref(key, context) {
+        return this.get(key, context)?.getAttribute("href");
+    }
+    mapTopicsToKeySpaces(root, loadedDocuments, mapPath) {
+        this.topicToKeySpace.clear();
+        this.mapTopicrefTree(root, loadedDocuments, mapPath, [this.rootKeySpace]);
+    }
+    mapTopicrefTree(element, loadedDocuments, mapPath, keySpaceStack) {
+        for (const node of element.getContent()) {
+            if (node instanceof ProcessingInstruction) {
+                if (node.getTarget() === "ditac-begin-group") {
+                    const keySpaceId = this.getPseudoAttribute(node.getData(), "ditac:keySpace");
+                    const keySpace = keySpaceId === undefined
+                        ? undefined
+                        : this.getKeySpaceById(keySpaceId);
+                    if (keySpace === undefined) {
+                        throw new Error(mapPath + ": " +
+                            loadedDocuments.diagnostics.i18n.format(loadedDocuments.diagnostics.i18n.getString("KeySpaces", "unknownKeySpace"), [keySpaceId ?? ""]));
+                    }
+                    keySpaceStack.push(keySpace);
+                }
+                else if (node.getTarget() === "ditac-end-group" && keySpaceStack.length > 1) {
+                    keySpaceStack.pop();
+                }
+                continue;
+            }
+            if (!(node instanceof DitaElement)) {
+                continue;
+            }
+            let pushedKeySpace = false;
+            const keySpaceId = DitaUtils.getNonEmptyAttribute(node, "ditac:keySpace");
+            if (keySpaceId !== undefined) {
+                const keySpace = this.getKeySpaceById(keySpaceId);
+                if (keySpace === undefined) {
+                    throw new Error(mapPath + ": " +
+                        loadedDocuments.diagnostics.i18n.format(loadedDocuments.diagnostics.i18n.getString("KeySpaces", "unknownKeySpace"), [keySpaceId]));
+                }
+                keySpaceStack.push(keySpace);
+                pushedKeySpace = true;
+            }
+            if (DitaUtils.hasClass(node, "map/topicref")) {
+                this.mapTopicref(node, loadedDocuments, mapPath, keySpaceStack[keySpaceStack.length - 1]);
+            }
+            this.mapTopicrefTree(node, loadedDocuments, mapPath, keySpaceStack);
+            if (pushedKeySpace) {
+                keySpaceStack.pop();
+            }
+        }
+    }
+    mapTopicref(topicref, loadedDocuments, mapPath, keySpace) {
+        const href = DitaUtils.getLocalTopicURL(topicref, loadedDocuments.diagnostics.i18n);
+        if (href === undefined) {
+            return;
+        }
+        const parts = href.split("#", 2);
+        const topicPath = DitaUtils.resolveDocumentPath(mapPath, parts[0].split("?", 1)[0]);
+        const sourcePath = KeySpaces.getOriginalTopicURL(topicref, topicPath, mapPath);
+        let document;
+        try {
+            document = loadedDocuments.load(sourcePath, false);
+        }
+        catch (error) {
+            throw new Error(mapPath + ": " + loadedDocuments.diagnostics.i18n.format(loadedDocuments.diagnostics.i18n.getString("MapSimplifier", "cannotLoad"), [sourcePath, error instanceof Error ? error.message : String(error)]));
+        }
+        if (document.type !== LoadedDocumentType.TOPIC && document.type !== LoadedDocumentType.MULTI_TOPIC) {
+            return;
+        }
+        const topicId = parts[1] === undefined
+            ? undefined
+            : URIComponent.decode(parts[1].split("/", 1)[0]);
+        const selectedTopic = topicId === undefined
+            ? document.getFirstTopic()
+            : document.findTopicById(topicId);
+        if (selectedTopic === undefined) {
+            if (topicId !== undefined) {
+                throw new Error(mapPath + ": " + loadedDocuments.diagnostics.i18n.format(loadedDocuments.diagnostics.i18n.getString("Chunker", "topicNotFound"), [topicId, document.path]));
+            }
+            return;
+        }
+        const selection = this.getKeySpaceSelection(href, DitaUtils.getNonEmptyAttribute(topicref, "chunk"));
+        if (document.getSingleTopic() !== undefined) {
+            this.mapBranchToKeySpaces(topicPath, selectedTopic, keySpace, false);
+        }
+        else if (selection === "select-document") {
+            this.mapDocumentToKeySpaces(topicPath, document.getTopics(), keySpace);
+        }
+        else {
+            this.mapBranchToKeySpaces(topicPath, selectedTopic, keySpace, selection === "select-branch");
+        }
+    }
+    getKeySpaceSelection(href, chunk) {
+        let selection = href.includes("#") ? "select-topic" : "select-document";
+        if (chunk !== undefined) {
+            if (chunk.includes("select-document")) {
+                selection = "select-document";
+            }
+            else if (chunk.includes("select-branch")) {
+                selection = "select-branch";
+            }
+            else if (chunk.includes("select-topic")) {
+                selection = "select-topic";
+            }
+        }
+        return selection;
+    }
+    mapBranchToKeySpaces(documentPath, topic, keySpace, includeNested) {
+        this.mapTopicToKeySpace(URIComponent.setFragment(documentPath, topic.topicId), keySpace);
+        if (!includeNested) {
+            return;
+        }
+        for (const nestedTopic of topic.getNestedTopics()) {
+            this.mapBranchToKeySpaces(documentPath, nestedTopic, keySpace, true);
+        }
+    }
+    mapDocumentToKeySpaces(documentPath, topics, keySpace) {
+        for (const topic of topics) {
+            this.mapBranchToKeySpaces(documentPath, topic, keySpace, true);
+        }
+    }
+    static getOriginalTopicURL(topicref, fallback, mapPath) {
+        const copyOf = DitaUtils.getNonEmptyAttribute(topicref, "ditac:copyOf");
+        return copyOf === undefined ? fallback : DitaUtils.resolveDocumentPath(mapPath, copyOf.split("#", 1)[0]);
+    }
+    getPseudoAttribute(data, name) {
+        const escapedName = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const match = data.match(new RegExp("(?:^|\\s)" + escapedName + "=\\\"([^\\\"]*)\\\""));
+        return match === null || match[1].trim().length === 0 ? undefined : match[1].trim();
+    }
+    appendKeySpace(keySpace, details, lines) {
+        lines.push("---");
+        lines.push(keySpace.toString(details));
+        lines.push("---");
+        for (const child of keySpace.getChildKeySpaces()) {
+            this.appendKeySpace(child, details, lines);
+        }
+    }
+}
+//# sourceMappingURL=KeySpaces.js.map

package/dist/preprocess/KeySpaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeySpaces.js","sourceRoot":"","sources":["../../ts/preprocess/KeySpaces.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 { ProcessingInstruction, XMLNode } from \"typesxml\";\nimport { DitaElement } from \"../dom/DitaElement.js\";\nimport { DitaUtils } from \"../utils/DitaUtils.js\";\nimport { URIComponent } from \"../utils/URIComponent.js\";\nimport { KeyDefinition } from \"./KeyDefinition.js\";\nimport { KeySpace } from \"./KeySpace.js\";\nimport { LoadedDocument, LoadedDocumentType } from \"./LoadedDocument.js\";\nimport type { LoadedDocuments } from \"./LoadedDocuments.js\";\nimport { LoadedTopic } from \"./LoadedTopic.js\";\n\nexport class KeySpaces {\n    readonly rootKeySpace: KeySpace;\n    private readonly keySpaces: Map<string, KeySpace> = new Map<string, KeySpace>();\n    private readonly topicToKeySpace: Map<string, KeySpace> = new Map<string, KeySpace>();\n    private readonly elementToKeySpace: WeakMap<DitaElement, KeySpace> = new WeakMap<DitaElement, KeySpace>();\n\n    constructor() {\n        this.rootKeySpace = new KeySpace(\"0\");\n        this.keySpaces.set(this.rootKeySpace.id, this.rootKeySpace);\n    }\n\n    add(keySpace: KeySpace): void {\n        this.keySpaces.set(keySpace.id, keySpace);\n    }\n\n    getRootKeySpace(): KeySpace {\n        return this.rootKeySpace;\n    }\n\n    getKeySpaceById(id: string): KeySpace | undefined {\n        return this.keySpaces.get(id);\n    }\n\n    getAllKeySpaces(): KeySpace[] {\n        return [...this.keySpaces.values()];\n    }\n\n    toString(): string {\n        const lines: string[] = [];\n        this.appendKeySpace(this.rootKeySpace, false, lines);\n        if (this.topicToKeySpace.size > 0) {\n            lines.push(\"Topic URI to key space:\");\n            for (const [topic, keySpace] of this.topicToKeySpace) {\n                lines.push(topic + \"=\" + keySpace.id);\n            }\n        }\n        return lines.join(\"\\n\");\n    }\n\n    mapTopicToKeySpace(topicLocation: string, keySpace: KeySpace): void {\n        this.topicToKeySpace.set(topicLocation, keySpace);\n    }\n\n    mapElementToKeySpace(element: DitaElement, keySpace: KeySpace): void {\n        this.elementToKeySpace.set(element, keySpace);\n    }\n\n    getElementKeySpace(element: DitaElement): KeySpace {\n        const registered: KeySpace | undefined = this.elementToKeySpace.get(element);\n        if (registered !== undefined) {\n            return registered;\n        }\n        let insideTopic: boolean = false;\n        let ancestor: DitaElement | undefined = element;\n        while (ancestor !== undefined) {\n            if (DitaUtils.hasClass(ancestor, \"topic/topic\")) {\n                insideTopic = true;\n                break;\n            }\n            ancestor = ancestor.getParent();\n        }\n        if (insideTopic) {\n            let current: DitaElement | undefined = element.getParent();\n            while (current !== undefined) {\n                const keySpace: KeySpace | undefined = this.elementToKeySpace.get(current);\n                if (keySpace !== undefined) {\n                    return keySpace;\n                }\n                current = current.getParent();\n            }\n            return this.rootKeySpace;\n        }\n        return this.findMapKeySpace(element) ?? this.rootKeySpace;\n    }\n\n    private findMapKeySpace(element: DitaElement): KeySpace | undefined {\n        let current: DitaElement | undefined = element;\n        while (current !== undefined) {\n            let keySpaceId: string | undefined = DitaUtils.getNonEmptyAttribute(current, \"ditac:keySpace\");\n            if (keySpaceId === undefined) {\n                keySpaceId = this.findGroupKeySpaceId(current);\n            }\n            if (keySpaceId !== undefined) {\n                return this.getKeySpaceById(keySpaceId);\n            }\n            current = current.getParent();\n        }\n        return undefined;\n    }\n\n    private findGroupKeySpaceId(element: DitaElement): string | undefined {\n        const parent: DitaElement | undefined = element.getParent();\n        if (parent === undefined) {\n            return undefined;\n        }\n        const content: XMLNode[] = parent.getContent();\n        let nesting: number = 0;\n        for (let index: number = content.indexOf(element) - 1; index >= 0; index--) {\n            const node: XMLNode = content[index];\n            if (node instanceof ProcessingInstruction) {\n                if (node.getTarget() === \"ditac-end-group\") {\n                    nesting++;\n                } else if (node.getTarget() === \"ditac-begin-group\") {\n                    if (nesting > 0) {\n                        nesting--;\n                    } else {\n                        return this.getPseudoAttribute(node.getData(), \"ditac:keySpace\");\n                    }\n                }\n            }\n        }\n        return undefined;\n    }\n\n    getTopicKeySpace(topicLocation: string): KeySpace {\n        return this.topicToKeySpace.get(topicLocation) ?? this.rootKeySpace;\n    }\n\n    lookupKeyDefinition(keySpace: KeySpace, key: string): KeyDefinition | undefined {\n        const hierarchy: KeySpace[] = [];\n        let current: KeySpace | undefined = keySpace;\n        while (current !== undefined) {\n            hierarchy.push(current);\n            current = current.getParentKeySpace();\n        }\n        for (let index: number = hierarchy.length - 1; index >= 0; index--) {\n            const definition: KeyDefinition | undefined = hierarchy[index].get(key);\n            if (definition !== undefined) {\n                return definition;\n            }\n        }\n        return undefined;\n    }\n\n    resolveReference(keySpace: KeySpace, reference: string): { keySpace: KeySpace; key: string; fragment?: string } | undefined {\n        const slashIndex: number = reference.indexOf(\"/\");\n        const key: string = slashIndex < 0 ? reference : reference.slice(0, slashIndex);\n        const fragment: string | undefined = slashIndex < 0 ? undefined : reference.slice(slashIndex + 1);\n        if (!DitaUtils.isValidKey(key) || (fragment !== undefined && !DitaUtils.isValidId(fragment))) {\n            return undefined;\n        }\n        return { keySpace, key, fragment };\n    }\n\n    get(key: string, context: DitaElement): KeyDefinition | undefined {\n        return this.lookupKeyDefinition(this.getElementKeySpace(context), key);\n    }\n\n    getHref(key: string, context: DitaElement): string | undefined {\n        return this.get(key, context)?.getAttribute(\"href\");\n    }\n\n    mapTopicsToKeySpaces(root: DitaElement, loadedDocuments: LoadedDocuments, mapPath: string): void {\n        this.topicToKeySpace.clear();\n        this.mapTopicrefTree(root, loadedDocuments, mapPath, [this.rootKeySpace]);\n    }\n\n    private mapTopicrefTree(\n        element: DitaElement,\n        loadedDocuments: LoadedDocuments,\n        mapPath: string,\n        keySpaceStack: KeySpace[]\n    ): void {\n        for (const node of element.getContent()) {\n            if (node instanceof ProcessingInstruction) {\n                if (node.getTarget() === \"ditac-begin-group\") {\n                    const keySpaceId: string | undefined = this.getPseudoAttribute(node.getData(), \"ditac:keySpace\");\n                    const keySpace: KeySpace | undefined = keySpaceId === undefined\n                        ? undefined\n                        : this.getKeySpaceById(keySpaceId);\n                    if (keySpace === undefined) {\n                        throw new Error(\n                            mapPath + \": \" +\n                            loadedDocuments.diagnostics.i18n.format(\n                                loadedDocuments.diagnostics.i18n.getString(\"KeySpaces\", \"unknownKeySpace\"),\n                                [keySpaceId ?? \"\"]\n                            )\n                        );\n                    }\n                    keySpaceStack.push(keySpace);\n                } else if (node.getTarget() === \"ditac-end-group\" && keySpaceStack.length > 1) {\n                    keySpaceStack.pop();\n                }\n                continue;\n            }\n            if (!(node instanceof DitaElement)) {\n                continue;\n            }\n            let pushedKeySpace: boolean = false;\n            const keySpaceId: string | undefined = DitaUtils.getNonEmptyAttribute(node, \"ditac:keySpace\");\n            if (keySpaceId !== undefined) {\n                const keySpace: KeySpace | undefined = this.getKeySpaceById(keySpaceId);\n                if (keySpace === undefined) {\n                    throw new Error(\n                        mapPath + \": \" +\n                        loadedDocuments.diagnostics.i18n.format(\n                            loadedDocuments.diagnostics.i18n.getString(\"KeySpaces\", \"unknownKeySpace\"),\n                            [keySpaceId]\n                        )\n                    );\n                }\n                keySpaceStack.push(keySpace);\n                pushedKeySpace = true;\n            }\n            if (DitaUtils.hasClass(node, \"map/topicref\")) {\n                this.mapTopicref(node, loadedDocuments, mapPath, keySpaceStack[keySpaceStack.length - 1]);\n            }\n            this.mapTopicrefTree(node, loadedDocuments, mapPath, keySpaceStack);\n            if (pushedKeySpace) {\n                keySpaceStack.pop();\n            }\n        }\n    }\n\n    private mapTopicref(\n        topicref: DitaElement,\n        loadedDocuments: LoadedDocuments,\n        mapPath: string,\n        keySpace: KeySpace\n    ): void {\n        const href: string | undefined = DitaUtils.getLocalTopicURL(topicref, loadedDocuments.diagnostics.i18n);\n        if (href === undefined) {\n            return;\n        }\n        const parts: string[] = href.split(\"#\", 2);\n        const topicPath: string = DitaUtils.resolveDocumentPath(mapPath, parts[0].split(\"?\", 1)[0]);\n        const sourcePath: string = KeySpaces.getOriginalTopicURL(topicref, topicPath, mapPath);\n        let document: LoadedDocument;\n        try {\n            document = loadedDocuments.load(sourcePath, false);\n        } catch (error: unknown) {\n            throw new Error(mapPath + \": \" + loadedDocuments.diagnostics.i18n.format(\n                loadedDocuments.diagnostics.i18n.getString(\"MapSimplifier\", \"cannotLoad\"),\n                [sourcePath, error instanceof Error ? error.message : String(error)]\n            ));\n        }\n        if (document.type !== LoadedDocumentType.TOPIC && document.type !== LoadedDocumentType.MULTI_TOPIC) {\n            return;\n        }\n        const topicId: string | undefined = parts[1] === undefined\n            ? undefined\n            : URIComponent.decode(parts[1].split(\"/\", 1)[0]);\n        const selectedTopic: LoadedTopic | undefined = topicId === undefined\n            ? document.getFirstTopic()\n            : document.findTopicById(topicId);\n        if (selectedTopic === undefined) {\n            if (topicId !== undefined) {\n                throw new Error(mapPath + \": \" + loadedDocuments.diagnostics.i18n.format(\n                    loadedDocuments.diagnostics.i18n.getString(\"Chunker\", \"topicNotFound\"),\n                    [topicId, document.path]\n                ));\n            }\n            return;\n        }\n        const selection: string = this.getKeySpaceSelection(href, DitaUtils.getNonEmptyAttribute(topicref, \"chunk\"));\n        if (document.getSingleTopic() !== undefined) {\n            this.mapBranchToKeySpaces(topicPath, selectedTopic, keySpace, false);\n        } else if (selection === \"select-document\") {\n            this.mapDocumentToKeySpaces(topicPath, document.getTopics(), keySpace);\n        } else {\n            this.mapBranchToKeySpaces(topicPath, selectedTopic, keySpace, selection === \"select-branch\");\n        }\n    }\n\n    private getKeySpaceSelection(href: string, chunk: string | undefined): string {\n        let selection: string = href.includes(\"#\") ? \"select-topic\" : \"select-document\";\n        if (chunk !== undefined) {\n            if (chunk.includes(\"select-document\")) {\n                selection = \"select-document\";\n            } else if (chunk.includes(\"select-branch\")) {\n                selection = \"select-branch\";\n            } else if (chunk.includes(\"select-topic\")) {\n                selection = \"select-topic\";\n            }\n        }\n        return selection;\n    }\n\n\n    private mapBranchToKeySpaces(documentPath: string, topic: LoadedTopic, keySpace: KeySpace, includeNested: boolean): void {\n        this.mapTopicToKeySpace(URIComponent.setFragment(documentPath, topic.topicId), keySpace);\n        if (!includeNested) {\n            return;\n        }\n        for (const nestedTopic of topic.getNestedTopics()) {\n            this.mapBranchToKeySpaces(documentPath, nestedTopic, keySpace, true);\n        }\n    }\n\n    private mapDocumentToKeySpaces(documentPath: string, topics: LoadedTopic[], keySpace: KeySpace): void {\n        for (const topic of topics) {\n            this.mapBranchToKeySpaces(documentPath, topic, keySpace, true);\n        }\n    }\n\n    static getOriginalTopicURL(topicref: DitaElement, fallback: string, mapPath: string): string {\n        const copyOf: string | undefined = DitaUtils.getNonEmptyAttribute(topicref, \"ditac:copyOf\");\n        return copyOf === undefined ? fallback : DitaUtils.resolveDocumentPath(mapPath, copyOf.split(\"#\", 1)[0]);\n    }\n\n    private getPseudoAttribute(data: string, name: string): string | undefined {\n        const escapedName: string = name.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n        const match: RegExpMatchArray | null = data.match(new RegExp(\"(?:^|\\\\s)\" + escapedName + \"=\\\\\\\"([^\\\\\\\"]*)\\\\\\\"\"));\n        return match === null || match[1].trim().length === 0 ? undefined : match[1].trim();\n    }\n\n    private appendKeySpace(keySpace: KeySpace, details: boolean, lines: string[]): void {\n        lines.push(\"---\");\n        lines.push(keySpace.toString(details));\n        lines.push(\"---\");\n        for (const child of keySpace.getChildKeySpaces()) {\n            this.appendKeySpace(child, details, lines);\n        }\n    }\n}"]}

package/dist/preprocess/ListTarget.d.ts

@@ -0,0 +1,21 @@
+import { DitaElement } from "../dom/DitaElement.js";
+import { LoadedTopic } from "./LoadedTopic.js";
+export declare enum ListTargetType {
+    FIGURE = "figure",
+    TABLE = "table",
+    EXAMPLE = "example",
+    EQUATION = "equation",
+    INDEX_TERM = "indexterm"
+}
+export declare class ListTarget {
+    readonly type: ListTargetType;
+    readonly element: DitaElement;
+    readonly sourceTopic: LoadedTopic;
+    targetId: string;
+    readonly title: string | undefined;
+    number: string | undefined;
+    readonly desc: DitaElement | undefined;
+    constructor(type: ListTargetType, element: DitaElement, sourceTopic: LoadedTopic, targetId: string, title: string | undefined, desc?: DitaElement | undefined);
+    getHref(): string;
+    static ensureTargetId(element: DitaElement, sourceTopic: LoadedTopic, ordinal: number, idRegistry: Map<string, DitaElement>): string;
+}

package/dist/preprocess/ListTarget.js

@@ -0,0 +1,55 @@
+/*
+ * 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 { DitaUtils } from "../utils/DitaUtils.js";
+import { URIComponent } from "../utils/URIComponent.js";
+export var ListTargetType;
+(function (ListTargetType) {
+    ListTargetType["FIGURE"] = "figure";
+    ListTargetType["TABLE"] = "table";
+    ListTargetType["EXAMPLE"] = "example";
+    ListTargetType["EQUATION"] = "equation";
+    ListTargetType["INDEX_TERM"] = "indexterm";
+})(ListTargetType || (ListTargetType = {}));
+export class ListTarget {
+    type;
+    element;
+    sourceTopic;
+    targetId;
+    title;
+    number;
+    desc;
+    constructor(type, element, sourceTopic, targetId, title, desc = undefined) {
+        this.type = type;
+        this.element = element;
+        this.sourceTopic = sourceTopic;
+        this.targetId = targetId;
+        this.title = title;
+        this.desc = desc;
+    }
+    getHref() {
+        return URIComponent.setFragment(this.sourceTopic.getAncestorDocument().path, this.targetId);
+    }
+    static ensureTargetId(element, sourceTopic, ordinal, idRegistry) {
+        const idAttribute = element.getAttribute("id");
+        if (idAttribute !== undefined && idAttribute.getValue().trim().length > 0) {
+            return idAttribute.getValue();
+        }
+        const candidate = sourceTopic.topicId + "-" + element.getName() + "-" + ordinal.toString();
+        const generatedId = DitaUtils.makeUniqueId(candidate, idRegistry, element);
+        element.setAttribute(new XMLAttribute("id", generatedId));
+        return generatedId;
+    }
+}
+//# sourceMappingURL=ListTarget.js.map

package/dist/preprocess/ListTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListTarget.js","sourceRoot":"","sources":["../../ts/preprocess/ListTarget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACtB,mCAAiB,CAAA;IACjB,iCAAe,CAAA;IACf,qCAAmB,CAAA;IACnB,uCAAqB,CAAA;IACrB,0CAAwB,CAAA;AAC5B,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB;AAED,MAAM,OAAO,UAAU;IACV,IAAI,CAAiB;IACrB,OAAO,CAAc;IACrB,WAAW,CAAc;IAClC,QAAQ,CAAS;IACR,KAAK,CAAqB;IACnC,MAAM,CAAqB;IAClB,IAAI,CAA0B;IAEvC,YACI,IAAoB,EACpB,OAAoB,EACpB,WAAwB,EACxB,QAAgB,EAChB,KAAyB,EACzB,OAAgC,SAAS;QAEzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,OAAO;QACH,OAAO,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,OAAoB,EAAE,WAAwB,EAAE,OAAe,EAAE,UAAoC;QACvH,MAAM,WAAW,GAA6B,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACzE,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxE,OAAO,WAAW,CAAC,QAAQ,EAAE,CAAC;QAClC,CAAC;QACD,MAAM,SAAS,GAAW,WAAW,CAAC,OAAO,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnG,MAAM,WAAW,GAAW,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACnF,OAAO,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;QAC1D,OAAO,WAAW,CAAC;IACvB,CAAC;CACJ","sourcesContent":["/*\n * Portions Copyright (c) 2017-2025 XMLmind Software. All rights reserved.\n * Author: Hussein Shafie\n *\n * Portions Copyright (c) 2026 Maxprograms SAS.\n *\n * This Source Code Form is subject to the terms of the Mozilla Public\n * License, v. 2.0. If a copy of the MPL was not distributed with this\n * file, You can obtain one at https://mozilla.org/MPL/2.0/.\n *\n * This Source Code Form is \"Incompatible With Secondary Licenses\", as\n * defined by the Mozilla Public License, v. 2.0.\n */\n\nimport { XMLAttribute } from \"typesxml\";\nimport { DitaElement } from \"../dom/DitaElement.js\";\nimport { DitaUtils } from \"../utils/DitaUtils.js\";\nimport { URIComponent } from \"../utils/URIComponent.js\";\nimport { LoadedTopic } from \"./LoadedTopic.js\";\n\nexport enum ListTargetType {\n    FIGURE = \"figure\",\n    TABLE = \"table\",\n    EXAMPLE = \"example\",\n    EQUATION = \"equation\",\n    INDEX_TERM = \"indexterm\"\n}\n\nexport class ListTarget {\n    readonly type: ListTargetType;\n    readonly element: DitaElement;\n    readonly sourceTopic: LoadedTopic;\n    targetId: string;\n    readonly title: string | undefined;\n    number: string | undefined;\n    readonly desc: DitaElement | undefined;\n\n    constructor(\n        type: ListTargetType,\n        element: DitaElement,\n        sourceTopic: LoadedTopic,\n        targetId: string,\n        title: string | undefined,\n        desc: DitaElement | undefined = undefined\n    ) {\n        this.type = type;\n        this.element = element;\n        this.sourceTopic = sourceTopic;\n        this.targetId = targetId;\n        this.title = title;\n        this.desc = desc;\n    }\n\n    getHref(): string {\n        return URIComponent.setFragment(this.sourceTopic.getAncestorDocument().path, this.targetId);\n    }\n\n    static ensureTargetId(element: DitaElement, sourceTopic: LoadedTopic, ordinal: number, idRegistry: Map<string, DitaElement>): string {\n        const idAttribute: XMLAttribute | undefined = element.getAttribute(\"id\");\n        if (idAttribute !== undefined && idAttribute.getValue().trim().length > 0) {\n            return idAttribute.getValue();\n        }\n        const candidate: string = sourceTopic.topicId + \"-\" + element.getName() + \"-\" + ordinal.toString();\n        const generatedId: string = DitaUtils.makeUniqueId(candidate, idRegistry, element);\n        element.setAttribute(new XMLAttribute(\"id\", generatedId));\n        return generatedId;\n    }\n}\n"]}

package/dist/preprocess/ListTargetCollector.d.ts

@@ -0,0 +1,17 @@
+import { DitaElement } from "../dom/DitaElement.js";
+import { DiagnosticLog } from "../utils/DiagnosticLog.js";
+import { Chunk } from "./Chunk.js";
+import { ChunkPlan } from "./ChunkPlan.js";
+import { IndexTerms } from "./IndexTerms.js";
+import { ListTarget, ListTargetType } from "./ListTarget.js";
+export declare class ListTargetCollector {
+    readonly diagnostics: DiagnosticLog;
+    indexTerms: IndexTerms;
+    constructor(diagnostics: DiagnosticLog);
+    collect(plan: ChunkPlan, chunkBaseName: (chunk: Chunk) => string, idRegistry: Map<string, DitaElement>): Map<ListTargetType, ListTarget[]>;
+    private collectTopic;
+    private counterFor;
+    private getTargetType;
+    private getTitle;
+    private createResult;
+}

package/dist/preprocess/ListTargetCollector.js

@@ -0,0 +1,126 @@
+/*
+ * 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 { ChunkEntryType } from "./ChunkEntry.js";
+import { FormalElementCounter } from "./FormalElementCounter.js";
+import { IndexTerms } from "./IndexTerms.js";
+import { ListTarget, ListTargetType } from "./ListTarget.js";
+export class ListTargetCollector {
+    diagnostics;
+    indexTerms;
+    constructor(diagnostics) {
+        this.diagnostics = diagnostics;
+        this.indexTerms = new IndexTerms(diagnostics);
+    }
+    collect(plan, chunkBaseName, idRegistry) {
+        this.indexTerms = new IndexTerms(this.diagnostics);
+        const result = this.createResult();
+        const tableCounter = new FormalElementCounter("table");
+        const figureCounter = new FormalElementCounter("figure");
+        const exampleCounter = new FormalElementCounter("example");
+        const equationCounter = new FormalElementCounter("equation");
+        const processed = new Set();
+        for (const chunk of plan.chunks) {
+            for (const entry of chunk.getEntries()) {
+                const topic = entry.type === ChunkEntryType.TOPIC ? entry.loadedTopic : undefined;
+                if (topic === undefined || processed.has(topic)) {
+                    continue;
+                }
+                processed.add(topic);
+                tableCounter.traversing(entry);
+                figureCounter.traversing(entry);
+                exampleCounter.traversing(entry);
+                equationCounter.traversing(entry);
+                let searchTopic = true;
+                if (DitaUtils.getNonEmptyAttribute(topic.element, "ditac:search") === "false") {
+                    topic.element.removeAttribute("ditac:search");
+                    searchTopic = false;
+                }
+                this.collectTopic(topic, topic.element, chunkBaseName(chunk), tableCounter, figureCounter, exampleCounter, equationCounter, searchTopic, result, idRegistry);
+            }
+        }
+        return result;
+    }
+    collectTopic(topic, element, file, tableCounter, figureCounter, exampleCounter, equationCounter, searchTopic, result, idRegistry) {
+        for (const child of element.getChildren()) {
+            if (DitaUtils.hasClass(child, "topic/topic")) {
+                // Nested topics are visited as their own ChunkEntry, matching PreProcessor.addLists().
+                continue;
+            }
+            if (DitaUtils.hasClass(child, "topic/indexterm")) {
+                if (searchTopic) {
+                    // IndexTerms.collect() parses the whole nested subtree itself (subterms,
+                    // index-see/index-see-also, index-sort-as), so it is not walked again here.
+                    this.indexTerms.collect(child, file, topic);
+                }
+                continue;
+            }
+            const type = this.getTargetType(child);
+            if (type !== undefined) {
+                const title = this.getTitle(child);
+                if (title !== undefined) {
+                    const counter = this.counterFor(type, tableCounter, figureCounter, exampleCounter, equationCounter);
+                    counter.increment();
+                    const number = counter.format();
+                    const targetId = ListTarget.ensureTargetId(child, topic, result.get(type)?.length ?? 0, idRegistry);
+                    const desc = DitaUtils.getChildByClass(child, "topic/desc");
+                    const target = new ListTarget(type, child, topic, targetId, title, desc);
+                    target.number = number;
+                    result.get(type)?.push(target);
+                }
+                // Otherwise, ignore a table/fig/example/equation-figure with no title child, matching
+                // PreProcessor.addLists() - it is not counted and does not become a list entry.
+            }
+            this.collectTopic(topic, child, file, tableCounter, figureCounter, exampleCounter, equationCounter, searchTopic, result, idRegistry);
+        }
+    }
+    counterFor(type, tableCounter, figureCounter, exampleCounter, equationCounter) {
+        switch (type) {
+            case ListTargetType.TABLE:
+                return tableCounter;
+            case ListTargetType.EQUATION:
+                return equationCounter;
+            case ListTargetType.FIGURE:
+                return figureCounter;
+            default:
+                return exampleCounter;
+        }
+    }
+    getTargetType(element) {
+        if (DitaUtils.hasClass(element, "topic/table")) {
+            return ListTargetType.TABLE;
+        }
+        if (DitaUtils.hasClass(element, "equation-d/equation-figure")) {
+            return ListTargetType.EQUATION;
+        }
+        if (DitaUtils.hasClass(element, "topic/fig")) {
+            return ListTargetType.FIGURE;
+        }
+        if (DitaUtils.hasClass(element, "topic/example")) {
+            return ListTargetType.EXAMPLE;
+        }
+        return undefined;
+    }
+    getTitle(element) {
+        return DitaUtils.getTitleTextFromChild(element, false);
+    }
+    createResult() {
+        const result = new Map();
+        for (const type of Object.values(ListTargetType)) {
+            result.set(type, []);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=ListTargetCollector.js.map

package/dist/preprocess/ListTargetCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListTargetCollector.js","sourceRoot":"","sources":["../../ts/preprocess/ListTargetCollector.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 { DitaElement } from \"../dom/DitaElement.js\";\nimport { DiagnosticLog } from \"../utils/DiagnosticLog.js\";\nimport { DitaUtils } from \"../utils/DitaUtils.js\";\nimport { Chunk } from \"./Chunk.js\";\nimport { ChunkEntryType } from \"./ChunkEntry.js\";\nimport { ChunkPlan } from \"./ChunkPlan.js\";\nimport { FormalElementCounter } from \"./FormalElementCounter.js\";\nimport { IndexTerms } from \"./IndexTerms.js\";\nimport { ListTarget, ListTargetType } from \"./ListTarget.js\";\nimport { LoadedTopic } from \"./LoadedTopic.js\";\n\nexport class ListTargetCollector {\n    readonly diagnostics: DiagnosticLog;\n    indexTerms: IndexTerms;\n\n    constructor(diagnostics: DiagnosticLog) {\n        this.diagnostics = diagnostics;\n        this.indexTerms = new IndexTerms(diagnostics);\n    }\n\n    collect(\n        plan: ChunkPlan,\n        chunkBaseName: (chunk: Chunk) => string,\n        idRegistry: Map<string, DitaElement>\n    ): Map<ListTargetType, ListTarget[]> {\n        this.indexTerms = new IndexTerms(this.diagnostics);\n        const result: Map<ListTargetType, ListTarget[]> = this.createResult();\n\n        const tableCounter: FormalElementCounter = new FormalElementCounter(\"table\");\n        const figureCounter: FormalElementCounter = new FormalElementCounter(\"figure\");\n        const exampleCounter: FormalElementCounter = new FormalElementCounter(\"example\");\n        const equationCounter: FormalElementCounter = new FormalElementCounter(\"equation\");\n\n        const processed: Set<LoadedTopic> = new Set<LoadedTopic>();\n        for (const chunk of plan.chunks) {\n            for (const entry of chunk.getEntries()) {\n                const topic: LoadedTopic | undefined = entry.type === ChunkEntryType.TOPIC ? entry.loadedTopic : undefined;\n                if (topic === undefined || processed.has(topic)) {\n                    continue;\n                }\n                processed.add(topic);\n\n                tableCounter.traversing(entry);\n                figureCounter.traversing(entry);\n                exampleCounter.traversing(entry);\n                equationCounter.traversing(entry);\n\n                let searchTopic: boolean = true;\n                if (DitaUtils.getNonEmptyAttribute(topic.element, \"ditac:search\") === \"false\") {\n                    topic.element.removeAttribute(\"ditac:search\");\n                    searchTopic = false;\n                }\n\n                this.collectTopic(\n                    topic,\n                    topic.element,\n                    chunkBaseName(chunk),\n                    tableCounter,\n                    figureCounter,\n                    exampleCounter,\n                    equationCounter,\n                    searchTopic,\n                    result,\n                    idRegistry\n                );\n            }\n        }\n        return result;\n    }\n\n    private collectTopic(\n        topic: LoadedTopic,\n        element: DitaElement,\n        file: string,\n        tableCounter: FormalElementCounter,\n        figureCounter: FormalElementCounter,\n        exampleCounter: FormalElementCounter,\n        equationCounter: FormalElementCounter,\n        searchTopic: boolean,\n        result: Map<ListTargetType, ListTarget[]>,\n        idRegistry: Map<string, DitaElement>\n    ): void {\n        for (const child of element.getChildren()) {\n            if (DitaUtils.hasClass(child, \"topic/topic\")) {\n                // Nested topics are visited as their own ChunkEntry, matching PreProcessor.addLists().\n                continue;\n            }\n            if (DitaUtils.hasClass(child, \"topic/indexterm\")) {\n                if (searchTopic) {\n                    // IndexTerms.collect() parses the whole nested subtree itself (subterms,\n                    // index-see/index-see-also, index-sort-as), so it is not walked again here.\n                    this.indexTerms.collect(child, file, topic);\n                }\n                continue;\n            }\n            const type: ListTargetType | undefined = this.getTargetType(child);\n            if (type !== undefined) {\n                const title: string | undefined = this.getTitle(child);\n                if (title !== undefined) {\n                    const counter: FormalElementCounter = this.counterFor(type, tableCounter, figureCounter, exampleCounter, equationCounter);\n                    counter.increment();\n                    const number: string = counter.format();\n                    const targetId: string = ListTarget.ensureTargetId(child, topic, result.get(type)?.length ?? 0, idRegistry);\n                    const desc: DitaElement | undefined = DitaUtils.getChildByClass(child, \"topic/desc\");\n                    const target: ListTarget = new ListTarget(type, child, topic, targetId, title, desc);\n                    target.number = number;\n                    result.get(type)?.push(target);\n                }\n                // Otherwise, ignore a table/fig/example/equation-figure with no title child, matching\n                // PreProcessor.addLists() - it is not counted and does not become a list entry.\n            }\n            this.collectTopic(\n                topic, child, file, tableCounter, figureCounter, exampleCounter, equationCounter, searchTopic, result, idRegistry\n            );\n        }\n    }\n\n    private counterFor(\n        type: ListTargetType,\n        tableCounter: FormalElementCounter,\n        figureCounter: FormalElementCounter,\n        exampleCounter: FormalElementCounter,\n        equationCounter: FormalElementCounter\n    ): FormalElementCounter {\n        switch (type) {\n            case ListTargetType.TABLE:\n                return tableCounter;\n            case ListTargetType.EQUATION:\n                return equationCounter;\n            case ListTargetType.FIGURE:\n                return figureCounter;\n            default:\n                return exampleCounter;\n        }\n    }\n\n    private getTargetType(element: DitaElement): ListTargetType | undefined {\n        if (DitaUtils.hasClass(element, \"topic/table\")) {\n            return ListTargetType.TABLE;\n        }\n        if (DitaUtils.hasClass(element, \"equation-d/equation-figure\")) {\n            return ListTargetType.EQUATION;\n        }\n        if (DitaUtils.hasClass(element, \"topic/fig\")) {\n            return ListTargetType.FIGURE;\n        }\n        if (DitaUtils.hasClass(element, \"topic/example\")) {\n            return ListTargetType.EXAMPLE;\n        }\n        return undefined;\n    }\n\n    private getTitle(element: DitaElement): string | undefined {\n        return DitaUtils.getTitleTextFromChild(element, false);\n    }\n\n    private createResult(): Map<ListTargetType, ListTarget[]> {\n        const result: Map<ListTargetType, ListTarget[]> = new Map<ListTargetType, ListTarget[]>();\n        for (const type of Object.values(ListTargetType)) {\n            result.set(type, []);\n        }\n        return result;\n    }\n}\n"]}

package/dist/preprocess/ListingCleaner.d.ts

@@ -0,0 +1,13 @@
+import { DitaElement } from "../dom/DitaElement.js";
+export declare class ListingCleaner {
+    private static readonly HL_CODE_LISTS;
+    protected constructor();
+    static checkHLCode(hlCode: string): string | undefined;
+    protected static normalizeWhiteSpace(tree: DitaElement, tabWidth: number, unindent: boolean): void;
+    private static collectTextChars;
+    private static expandTabs;
+    private static expandTabsIn;
+    private static unindentAll;
+    private static indentation;
+    private static unindentOne;
+}