typesditac 1.0.0

package/dist/preprocess/ExtractAsImage.js

@@ -0,0 +1,196 @@
+/*
+ * Portions Copyright (c) 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 { writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { XMLAttribute, XMLDocument, XMLWriter } from "typesxml";
+import { DitaElement } from "../dom/DitaElement.js";
+import { DitaUtils } from "../utils/DitaUtils.js";
+function childNamed(element, name) {
+    return element.getChildren().find((candidate) => candidate.getName() === name);
+}
+function hrefOfChild(element, childName) {
+    const ref = childNamed(element, childName);
+    return { text: ref === undefined ? undefined : DitaUtils.getNonEmptyAttribute(ref, "href") };
+}
+export class ExtractAsImage {
+    outDir;
+    diagnostics;
+    specs = [];
+    extractCounter = 0;
+    constructor(outDir, diagnostics) {
+        this.outDir = outDir;
+        this.diagnostics = diagnostics;
+        for (const spec of ExtractAsImage.predefinedSpecs()) {
+            this.specs.push(spec);
+        }
+    }
+    addSpec(spec) {
+        this.specs.push(spec);
+    }
+    static predefinedSpecs() {
+        return [
+            {
+                matches: (element) => element.getName() === "foreign" && DitaUtils.getNonEmptyAttribute(element, "outputclass") === "embed-latex",
+                extract: (element) => ({ text: element.getText() }),
+                fileExtension: "tex"
+            },
+            {
+                matches: (element) => element.getName() === "mathml" && childNamed(element, "mml:math") !== undefined,
+                extract: (element) => ({ element: childNamed(element, "mml:math") }),
+                fileExtension: "mml"
+            },
+            {
+                matches: (element) => element.getName() === "mathml" && childNamed(element, "mathmlref") !== undefined,
+                extract: (element) => hrefOfChild(element, "mathmlref"),
+                fileExtension: undefined
+            },
+            {
+                matches: (element) => element.getName() === "foreign" && childNamed(element, "mml:math") !== undefined,
+                extract: (element) => ({ element: childNamed(element, "mml:math") }),
+                fileExtension: "mml"
+            },
+            {
+                matches: (element) => element.getName() === "svg-container" && childNamed(element, "svg:svg") !== undefined,
+                extract: (element) => ({ element: childNamed(element, "svg:svg") }),
+                fileExtension: "svg"
+            },
+            {
+                matches: (element) => element.getName() === "svg-container" && childNamed(element, "svgref") !== undefined,
+                extract: (element) => hrefOfChild(element, "svgref"),
+                fileExtension: undefined
+            },
+            {
+                matches: (element) => element.getName() === "foreign" && childNamed(element, "svg:svg") !== undefined,
+                extract: (element) => ({ element: childNamed(element, "svg:svg") }),
+                fileExtension: "svg"
+            }
+        ];
+    }
+    process(tree, location) {
+        for (const spec of this.specs) {
+            this.processSpec(tree, spec, location);
+        }
+    }
+    processSpec(element, spec, location) {
+        for (const child of element.getChildren()) {
+            let replaced = false;
+            if (spec.matches(child)) {
+                const value = spec.extract(child);
+                const text = value.text?.trim();
+                if ((text !== undefined && text.length > 0) || value.element !== undefined) {
+                    replaced = this.replace(element, child, text, value.element, spec.fileExtension, location);
+                }
+            }
+            if (!replaced) {
+                this.processSpec(child, spec, location);
+            }
+        }
+    }
+    replace(parent, oldChild, text, element, fileExtension, location) {
+        let href;
+        if (fileExtension === undefined) {
+            href = text;
+        }
+        else {
+            this.extractCounter++;
+            const fileName = "img" + this.extractCounter.toString().padStart(5, "0") + "." + fileExtension;
+            const filePath = resolve(this.outDir, fileName);
+            try {
+                if (text !== undefined) {
+                    writeFileSync(filePath, text, "utf8");
+                }
+                else if (element !== undefined) {
+                    this.ensureNamespaceDeclarations(element);
+                    const document = new XMLDocument();
+                    document.setRoot(element);
+                    XMLWriter.writeDocument(document, filePath);
+                }
+                else {
+                    writeFileSync(filePath, "", "utf8");
+                }
+            }
+            catch (error) {
+                this.diagnostics.error(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ExtractAsImage", "cannotSaveExtractedImage"), [filePath, error instanceof Error ? error.message : String(error)]), location);
+                return false;
+            }
+            href = pathToFileURL(filePath).toString();
+        }
+        if (href === undefined) {
+            this.diagnostics.error(this.diagnostics.i18n.format(this.diagnostics.i18n.getString("ExtractAsImage", "unusableExtractAsImageSpec"), [oldChild.getName()]), location);
+            return false;
+        }
+        const image = new DitaElement("image");
+        image.setAttribute(new XMLAttribute("class", "- topic/image "));
+        image.setAttribute(new XMLAttribute("href", href));
+        this.replaceChild(parent, oldChild, image);
+        return true;
+    }
+    replaceChild(parent, oldChild, newChild) {
+        const content = parent.getContent();
+        const index = content.indexOf(oldChild);
+        if (index >= 0) {
+            content.splice(index, 1, newChild);
+            parent.setContent(content);
+        }
+    }
+    ensureNamespaceDeclarations(element) {
+        const prefixes = new Set();
+        this.collectPrefixes(element, prefixes);
+        for (const prefix of prefixes) {
+            if (element.getAttribute("xmlns:" + prefix) !== undefined) {
+                continue;
+            }
+            const uri = this.findNamespaceURI(element.getParent(), prefix);
+            if (uri !== undefined) {
+                element.setAttribute(new XMLAttribute("xmlns:" + prefix, uri));
+            }
+        }
+    }
+    collectPrefixes(element, prefixes) {
+        const ownPrefix = ExtractAsImage.prefixOf(element.getName());
+        if (ownPrefix !== undefined) {
+            prefixes.add(ownPrefix);
+        }
+        for (const attribute of element.getAttributes()) {
+            const name = attribute.getName();
+            if (name === "xmlns" || name.startsWith("xmlns:")) {
+                continue;
+            }
+            const attributePrefix = ExtractAsImage.prefixOf(name);
+            if (attributePrefix !== undefined) {
+                prefixes.add(attributePrefix);
+            }
+        }
+        for (const child of element.getChildren()) {
+            this.collectPrefixes(child, prefixes);
+        }
+    }
+    static prefixOf(qualifiedName) {
+        const colon = qualifiedName.indexOf(":");
+        return colon > 0 ? qualifiedName.slice(0, colon) : undefined;
+    }
+    findNamespaceURI(start, prefix) {
+        let current = start;
+        while (current !== undefined) {
+            const declared = current.getAttribute("xmlns:" + prefix)?.getValue() ?? current.getAttribute("xmlns")?.getValue();
+            if (declared !== undefined) {
+                return declared;
+            }
+            current = current.getParent();
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=ExtractAsImage.js.map

package/dist/preprocess/ExtractAsImage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtractAsImage.js","sourceRoot":"","sources":["../../ts/preprocess/ExtractAsImage.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Portions Copyright (c) 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 { writeFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { XMLAttribute, XMLDocument, XMLNode, XMLWriter } from \"typesxml\";\nimport { DitaElement } from \"../dom/DitaElement.js\";\nimport { DiagnosticLog } from \"../utils/DiagnosticLog.js\";\nimport { DitaUtils } from \"../utils/DitaUtils.js\";\n\nexport interface ExtractedValue {\n    readonly text?: string;\n    readonly element?: DitaElement;\n}\n\nexport interface ExtractAsImageSpec {\n    readonly matches: (element: DitaElement) => boolean;\n    readonly extract: (element: DitaElement) => ExtractedValue;\n    readonly fileExtension: string | undefined;\n}\n\nfunction childNamed(element: DitaElement, name: string): DitaElement | undefined {\n    return element.getChildren().find((candidate: DitaElement): boolean => candidate.getName() === name);\n}\n\nfunction hrefOfChild(element: DitaElement, childName: string): ExtractedValue {\n    const ref: DitaElement | undefined = childNamed(element, childName);\n    return { text: ref === undefined ? undefined : DitaUtils.getNonEmptyAttribute(ref, \"href\") };\n}\n\nexport class ExtractAsImage {\n    private readonly outDir: string;\n    private readonly diagnostics: DiagnosticLog;\n    private readonly specs: ExtractAsImageSpec[] = [];\n    private extractCounter: number = 0;\n\n    constructor(outDir: string, diagnostics: DiagnosticLog) {\n        this.outDir = outDir;\n        this.diagnostics = diagnostics;\n        for (const spec of ExtractAsImage.predefinedSpecs()) {\n            this.specs.push(spec);\n        }\n    }\n\n    addSpec(spec: ExtractAsImageSpec): void {\n        this.specs.push(spec);\n    }\n\n    private static predefinedSpecs(): ExtractAsImageSpec[] {\n        return [\n            {\n                matches: (element: DitaElement): boolean =>\n                    element.getName() === \"foreign\" && DitaUtils.getNonEmptyAttribute(element, \"outputclass\") === \"embed-latex\",\n                extract: (element: DitaElement): ExtractedValue => ({ text: element.getText() }),\n                fileExtension: \"tex\"\n            },\n            {\n                matches: (element: DitaElement): boolean => element.getName() === \"mathml\" && childNamed(element, \"mml:math\") !== undefined,\n                extract: (element: DitaElement): ExtractedValue => ({ element: childNamed(element, \"mml:math\") }),\n                fileExtension: \"mml\"\n            },\n            {\n                matches: (element: DitaElement): boolean => element.getName() === \"mathml\" && childNamed(element, \"mathmlref\") !== undefined,\n                extract: (element: DitaElement): ExtractedValue => hrefOfChild(element, \"mathmlref\"),\n                fileExtension: undefined\n            },\n            {\n                matches: (element: DitaElement): boolean => element.getName() === \"foreign\" && childNamed(element, \"mml:math\") !== undefined,\n                extract: (element: DitaElement): ExtractedValue => ({ element: childNamed(element, \"mml:math\") }),\n                fileExtension: \"mml\"\n            },\n            {\n                matches: (element: DitaElement): boolean => element.getName() === \"svg-container\" && childNamed(element, \"svg:svg\") !== undefined,\n                extract: (element: DitaElement): ExtractedValue => ({ element: childNamed(element, \"svg:svg\") }),\n                fileExtension: \"svg\"\n            },\n            {\n                matches: (element: DitaElement): boolean => element.getName() === \"svg-container\" && childNamed(element, \"svgref\") !== undefined,\n                extract: (element: DitaElement): ExtractedValue => hrefOfChild(element, \"svgref\"),\n                fileExtension: undefined\n            },\n            {\n                matches: (element: DitaElement): boolean => element.getName() === \"foreign\" && childNamed(element, \"svg:svg\") !== undefined,\n                extract: (element: DitaElement): ExtractedValue => ({ element: childNamed(element, \"svg:svg\") }),\n                fileExtension: \"svg\"\n            }\n        ];\n    }\n\n    process(tree: DitaElement, location: string): void {\n        for (const spec of this.specs) {\n            this.processSpec(tree, spec, location);\n        }\n    }\n\n    private processSpec(element: DitaElement, spec: ExtractAsImageSpec, location: string): void {\n        for (const child of element.getChildren()) {\n            let replaced: boolean = false;\n            if (spec.matches(child)) {\n                const value: ExtractedValue = spec.extract(child);\n                const text: string | undefined = value.text?.trim();\n                if ((text !== undefined && text.length > 0) || value.element !== undefined) {\n                    replaced = this.replace(element, child, text, value.element, spec.fileExtension, location);\n                }\n            }\n            if (!replaced) {\n                this.processSpec(child, spec, location);\n            }\n        }\n    }\n\n    private replace(\n        parent: DitaElement,\n        oldChild: DitaElement,\n        text: string | undefined,\n        element: DitaElement | undefined,\n        fileExtension: string | undefined,\n        location: string\n    ): boolean {\n        let href: string | undefined;\n        if (fileExtension === undefined) {\n            href = text;\n        } else {\n            this.extractCounter++;\n            const fileName: string = \"img\" + this.extractCounter.toString().padStart(5, \"0\") + \".\" + fileExtension;\n            const filePath: string = resolve(this.outDir, fileName);\n            try {\n                if (text !== undefined) {\n                    writeFileSync(filePath, text, \"utf8\");\n                } else if (element !== undefined) {\n                    this.ensureNamespaceDeclarations(element);\n                    const document: XMLDocument = new XMLDocument();\n                    document.setRoot(element);\n                    XMLWriter.writeDocument(document, filePath);\n                } else {\n                    writeFileSync(filePath, \"\", \"utf8\");\n                }\n            } catch (error: unknown) {\n                this.diagnostics.error(\n                    this.diagnostics.i18n.format(\n                        this.diagnostics.i18n.getString(\"ExtractAsImage\", \"cannotSaveExtractedImage\"),\n                        [filePath, error instanceof Error ? error.message : String(error)]\n                    ),\n                    location\n                );\n                return false;\n            }\n            href = pathToFileURL(filePath).toString();\n        }\n        if (href === undefined) {\n            this.diagnostics.error(\n                this.diagnostics.i18n.format(\n                    this.diagnostics.i18n.getString(\"ExtractAsImage\", \"unusableExtractAsImageSpec\"),\n                    [oldChild.getName()]\n                ),\n                location\n            );\n            return false;\n        }\n        const image: DitaElement = new DitaElement(\"image\");\n        image.setAttribute(new XMLAttribute(\"class\", \"- topic/image \"));\n        image.setAttribute(new XMLAttribute(\"href\", href));\n        this.replaceChild(parent, oldChild, image);\n        return true;\n    }\n\n    private replaceChild(parent: DitaElement, oldChild: DitaElement, newChild: DitaElement): void {\n        const content: XMLNode[] = parent.getContent();\n        const index: number = content.indexOf(oldChild);\n        if (index >= 0) {\n            content.splice(index, 1, newChild);\n            parent.setContent(content);\n        }\n    }\n\n    private ensureNamespaceDeclarations(element: DitaElement): void {\n        const prefixes: Set<string> = new Set<string>();\n        this.collectPrefixes(element, prefixes);\n        for (const prefix of prefixes) {\n            if (element.getAttribute(\"xmlns:\" + prefix) !== undefined) {\n                continue;\n            }\n            const uri: string | undefined = this.findNamespaceURI(element.getParent(), prefix);\n            if (uri !== undefined) {\n                element.setAttribute(new XMLAttribute(\"xmlns:\" + prefix, uri));\n            }\n        }\n    }\n\n    private collectPrefixes(element: DitaElement, prefixes: Set<string>): void {\n        const ownPrefix: string | undefined = ExtractAsImage.prefixOf(element.getName());\n        if (ownPrefix !== undefined) {\n            prefixes.add(ownPrefix);\n        }\n        for (const attribute of element.getAttributes()) {\n            const name: string = attribute.getName();\n            if (name === \"xmlns\" || name.startsWith(\"xmlns:\")) {\n                continue;\n            }\n            const attributePrefix: string | undefined = ExtractAsImage.prefixOf(name);\n            if (attributePrefix !== undefined) {\n                prefixes.add(attributePrefix);\n            }\n        }\n        for (const child of element.getChildren()) {\n            this.collectPrefixes(child, prefixes);\n        }\n    }\n\n    private static prefixOf(qualifiedName: string): string | undefined {\n        const colon: number = qualifiedName.indexOf(\":\");\n        return colon > 0 ? qualifiedName.slice(0, colon) : undefined;\n    }\n\n    private findNamespaceURI(start: DitaElement | undefined, prefix: string): string | undefined {\n        let current: DitaElement | undefined = start;\n        while (current !== undefined) {\n            const declared: string | undefined = current.getAttribute(\"xmlns:\" + prefix)?.getValue() ?? current.getAttribute(\"xmlns\")?.getValue();\n            if (declared !== undefined) {\n                return declared;\n            }\n            current = current.getParent();\n        }\n        return undefined;\n    }\n}\n"]}

package/dist/preprocess/Filter.d.ts

@@ -0,0 +1,72 @@
+import { DitaElement } from "../dom/DitaElement.js";
+import { I18n } from "../i18n/I18n.js";
+import { AttributeValues } from "./AttributeValues.js";
+import type { LoadDocument } from "./LoadDocument.js";
+export type Action = "exclude" | "flag" | "include" | "passthrough";
+export declare class Flags {
+    color: string | undefined;
+    backgroundColor: string | undefined;
+    fontWeight: string | undefined;
+    fontStyle: string | undefined;
+    textDecoration: string | undefined;
+    changeBarProps: string[] | undefined;
+    startImage: string | undefined;
+    isAbsoluteStartImageURL: boolean;
+    startText: string | undefined;
+    endImage: string | undefined;
+    isAbsoluteEndImageURL: boolean;
+    endText: string | undefined;
+    conflictColor: string | undefined;
+    conflictBackgroundColor: string | undefined;
+    set(other: Flags): void;
+    clear(): void;
+    isEmpty(): boolean;
+    copy(): Flags;
+}
+export declare class PropValue {
+    readonly value: string | undefined;
+    readonly action: Action;
+    readonly flags: Flags | undefined;
+    constructor(value: string | undefined, action: Action, flags: Flags | undefined);
+}
+export declare class Prop {
+    readonly attribute: string | undefined;
+    private values;
+    constructor(attribute: string | undefined, value: PropValue);
+    addValue(value: PropValue): void;
+    findValue(searched: string): PropValue | undefined;
+    findValue(from: string, excludedAncestor: string | undefined, attributeValues: AttributeValues, attribute: string, elementName: string): PropValue | undefined;
+    getWildcardValue(): PropValue | undefined;
+    getValueCount(): number;
+    getValues(): readonly PropValue[];
+}
+export declare class Filter {
+    private documentRoot;
+    private location;
+    private props;
+    private conflictColor;
+    private conflictBackgroundColor;
+    constructor();
+    constructor(documentRoot: DitaElement, location: string, i18n: I18n);
+    static load(location: string, loader: LoadDocument, i18n: I18n): Filter;
+    static copyOf(other: Filter): Filter;
+    setProps(props: Prop[] | undefined): void;
+    addExcludeProps(...pairs: string[]): void;
+    static newExcludeProp(attrName: string, attrValue: string): Prop;
+    getProps(): readonly Prop[];
+    setConflictColor(conflictColor: string | undefined): void;
+    getConflictColor(): string | undefined;
+    setConflictBackgroundColor(conflictBackgroundColor: string | undefined): void;
+    getConflictBackgroundColor(): string | undefined;
+    getDocumentRoot(): DitaElement | undefined;
+    getLocation(): string | undefined;
+    private parseProp;
+    private parseRevprop;
+    private doParseProp;
+    private static parseChangeBarProps;
+    private static splitStyleProps;
+    private parseStartEndFlag;
+    private parseStyleConflict;
+    private parseColor;
+    private reportError;
+}