@getkist/action-svg 1.0.2

package/dist/actions/SvgReaderAction/SvgReaderAction.d.ts

@@ -0,0 +1,61 @@
+import { Action, ActionOptionsType } from "../../types/Action.js";
+/**
+ * Options for SvgReaderAction
+ */
+export interface SvgReaderActionOptions extends ActionOptionsType {
+    /**
+     * Path to the SVG file to read
+     */
+    filePath: string;
+}
+/**
+ * SvgReaderAction reads SVG file contents and makes them available
+ * for further processing in the pipeline.
+ *
+ * Features:
+ * - Asynchronous file reading
+ * - Content caching for pipeline use
+ * - Path validation
+ * - Detailed error reporting
+ *
+ * @example
+ * ```yaml
+ * steps:
+ *   - name: read-svg
+ *     action: SvgReaderAction
+ *     options:
+ *       filePath: ./assets/logo.svg
+ * ```
+ */
+export declare class SvgReaderAction extends Action {
+    private svgContent;
+    /**
+     * Validates the provided options before execution.
+     *
+     * @param options - The options to validate
+     * @returns true if options are valid
+     * @throws Error if required options are missing or invalid
+     */
+    validateOptions(options: ActionOptionsType): boolean;
+    /**
+     * Executes the SVG reading action.
+     *
+     * @param options - The options specifying the SVG file path
+     * @returns A Promise that resolves when the SVG file is successfully read
+     */
+    execute(options: ActionOptionsType): Promise<void>;
+    /**
+     * Reads the content of an SVG file asynchronously.
+     *
+     * @param filePath - The path to the SVG file
+     * @returns A promise that resolves to the SVG file content
+     */
+    private readSvg;
+    /**
+     * Retrieves the last read SVG content.
+     *
+     * @returns The last read SVG content
+     */
+    getSvgContent(): string;
+}
+//# sourceMappingURL=SvgReaderAction.d.ts.map

package/dist/actions/SvgReaderAction/SvgReaderAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgReaderAction.d.ts","sourceRoot":"","sources":["../../../src/actions/SvgReaderAction/SvgReaderAction.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAMlE;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAgB,SAAQ,MAAM;IACzC,OAAO,CAAC,UAAU,CAAc;IAEhC;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO;IAcpD;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxD;;;;;OAKG;YACW,OAAO;IAIrB;;;;OAIG;IACH,aAAa,IAAI,MAAM;CAGxB"}

package/dist/actions/SvgReaderAction/SvgReaderAction.js

@@ -0,0 +1,89 @@
+// ============================================================================
+// Import
+// ============================================================================
+import { promises as fs } from "fs";
+import path from "path";
+import { Action } from "../../types/Action.js";
+// ============================================================================
+// Class
+// ============================================================================
+/**
+ * SvgReaderAction reads SVG file contents and makes them available
+ * for further processing in the pipeline.
+ *
+ * Features:
+ * - Asynchronous file reading
+ * - Content caching for pipeline use
+ * - Path validation
+ * - Detailed error reporting
+ *
+ * @example
+ * ```yaml
+ * steps:
+ *   - name: read-svg
+ *     action: SvgReaderAction
+ *     options:
+ *       filePath: ./assets/logo.svg
+ * ```
+ */
+export class SvgReaderAction extends Action {
+    constructor() {
+        super(...arguments);
+        this.svgContent = "";
+    }
+    /**
+     * Validates the provided options before execution.
+     *
+     * @param options - The options to validate
+     * @returns true if options are valid
+     * @throws Error if required options are missing or invalid
+     */
+    validateOptions(options) {
+        const opts = options;
+        if (!opts.filePath) {
+            throw new Error("SvgReaderAction requires 'filePath' option");
+        }
+        if (typeof opts.filePath !== "string") {
+            throw new Error("SvgReaderAction 'filePath' must be a string");
+        }
+        return true;
+    }
+    /**
+     * Executes the SVG reading action.
+     *
+     * @param options - The options specifying the SVG file path
+     * @returns A Promise that resolves when the SVG file is successfully read
+     */
+    async execute(options) {
+        this.validateOptions(options);
+        const opts = options;
+        this.logInfo(`Reading SVG file: ${opts.filePath}`);
+        try {
+            this.svgContent = await this.readSvg(opts.filePath);
+            this.logInfo(`Successfully read SVG file: ${opts.filePath}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.logError(`Error reading SVG file: ${opts.filePath}`, error);
+            throw new Error(`SVG file reading failed: ${message}`);
+        }
+    }
+    /**
+     * Reads the content of an SVG file asynchronously.
+     *
+     * @param filePath - The path to the SVG file
+     * @returns A promise that resolves to the SVG file content
+     */
+    async readSvg(filePath) {
+        return fs.readFile(path.resolve(filePath), "utf-8");
+    }
+    /**
+     * Retrieves the last read SVG content.
+     *
+     * @returns The last read SVG content
+     */
+    getSvgContent() {
+        return this.svgContent;
+    }
+}
+//# sourceMappingURL=SvgReaderAction.js.map

package/dist/actions/SvgReaderAction/SvgReaderAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgReaderAction.js","sourceRoot":"","sources":["../../../src/actions/SvgReaderAction/SvgReaderAction.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAqB,MAAM,uBAAuB,CAAC;AAgBlE,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,eAAgB,SAAQ,MAAM;IAA3C;;QACU,eAAU,GAAW,EAAE,CAAC;IA+DlC,CAAC;IA7DC;;;;;;OAMG;IACH,eAAe,CAAC,OAA0B;QACxC,MAAM,IAAI,GAAG,OAAiC,CAAC;QAE/C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,OAA0B;QACtC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,OAAiC,CAAC;QAE/C,IAAI,CAAC,OAAO,CAAC,qBAAqB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEnD,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpD,IAAI,CAAC,OAAO,CAAC,+BAA+B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,CAAC,QAAQ,CAAC,2BAA2B,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,OAAO,CAAC,QAAgB;QACpC,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/actions/SvgReaderAction/index.d.ts

@@ -0,0 +1,3 @@
+export { SvgReaderAction } from "./SvgReaderAction.js";
+export type { SvgReaderActionOptions } from "./SvgReaderAction.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/SvgReaderAction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/SvgReaderAction/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/actions/SvgReaderAction/index.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// Export
+// ============================================================================
+export { SvgReaderAction } from "./SvgReaderAction.js";
+//# sourceMappingURL=index.js.map

package/dist/actions/SvgReaderAction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/SvgReaderAction/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/actions/SvgSpriteAction/SvgSpriteAction.d.ts

@@ -0,0 +1,71 @@
+import svgSprite from "svg-sprite";
+import { Action, ActionOptionsType } from "../../types/Action.js";
+/**
+ * Options for SvgSpriteAction
+ */
+export interface SvgSpriteActionOptions extends ActionOptionsType {
+    /**
+     * Source directory containing SVG files
+     */
+    sourceDir: string;
+    /**
+     * Output directory for generated sprite
+     */
+    outputDir: string;
+    /**
+     * Optional custom configuration for svg-sprite
+     */
+    config?: svgSprite.Config;
+}
+/**
+ * SvgSpriteAction compiles multiple SVG files into a single sprite sheet,
+ * making it more efficient to manage and use SVG assets in web applications.
+ *
+ * Features:
+ * - Combines multiple SVG files into sprite sheets
+ * - Supports multiple sprite modes (symbol, stack, css, view, defs)
+ * - Automatic SVG optimization with SVGO
+ * - Customizable sprite configuration
+ * - CSS stylesheet generation
+ *
+ * @example
+ * ```yaml
+ * steps:
+ *   - name: generate-svg-sprite
+ *     action: SvgSpriteAction
+ *     options:
+ *       sourceDir: ./assets/icons
+ *       outputDir: ./dist/sprites
+ * ```
+ */
+export declare class SvgSpriteAction extends Action {
+    private config;
+    /**
+     * Constructs an instance with merged default and custom configurations.
+     *
+     * @param customConfig - Optional custom configuration for svg-sprite
+     */
+    constructor(customConfig?: svgSprite.Config);
+    /**
+     * Validates the provided options before execution.
+     *
+     * @param options - The options to validate
+     * @returns true if options are valid
+     * @throws Error if required options are missing or invalid
+     */
+    validateOptions(options: ActionOptionsType): boolean;
+    /**
+     * Executes the SVG sprite generation process.
+     *
+     * @param options - Configuration options for sprite generation
+     */
+    execute(options: ActionOptionsType): Promise<void>;
+    /**
+     * Generates an SVG sprite from all SVG files in the specified directory.
+     *
+     * @param sourceDir - Directory containing source SVG files
+     * @param outputDir - Directory where the generated sprite will be saved
+     */
+    private generateSprite;
+}
+//# sourceMappingURL=SvgSpriteAction.d.ts.map

package/dist/actions/SvgSpriteAction/SvgSpriteAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgSpriteAction.d.ts","sourceRoot":"","sources":["../../../src/actions/SvgSpriteAction/SvgSpriteAction.ts"],"names":[],"mappings":"AAMA,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAMlE;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC;CAC3B;AAqDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAgB,SAAQ,MAAM;IACzC,OAAO,CAAC,MAAM,CAAmB;IAEjC;;;;OAIG;gBACS,YAAY,GAAE,SAAS,CAAC,MAAW;IAK/C;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO;IA4BpD;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxD;;;;;OAKG;YACW,cAAc;CAuE7B"}

package/dist/actions/SvgSpriteAction/SvgSpriteAction.js

@@ -0,0 +1,199 @@
+// ============================================================================
+// Import
+// ============================================================================
+import fs from "fs";
+import path from "path";
+import svgSprite from "svg-sprite";
+import { Action } from "../../types/Action.js";
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const defaultSvgSpriteConfig = {
+    dest: "./dist/sprite",
+    shape: {
+        id: {
+            separator: "--",
+            generator: "icon-%s",
+            pseudo: "~",
+        },
+        dimension: {
+            maxWidth: 2000,
+            maxHeight: 2000,
+            precision: 2,
+            attributes: false,
+        },
+        spacing: {
+            padding: 0,
+            box: "content",
+        },
+        transform: ["svgo"],
+    },
+    svg: {
+        xmlDeclaration: false,
+        doctypeDeclaration: true,
+        namespaceIDs: true,
+        namespaceClassnames: false,
+        dimensionAttributes: true,
+    },
+    variables: {},
+    mode: {
+        css: {
+            render: {
+                css: true,
+            },
+        },
+        view: true,
+        defs: true,
+        symbol: {
+            sprite: "icon.sprite.svg",
+        },
+        stack: true,
+    },
+};
+// ============================================================================
+// Class
+// ============================================================================
+/**
+ * SvgSpriteAction compiles multiple SVG files into a single sprite sheet,
+ * making it more efficient to manage and use SVG assets in web applications.
+ *
+ * Features:
+ * - Combines multiple SVG files into sprite sheets
+ * - Supports multiple sprite modes (symbol, stack, css, view, defs)
+ * - Automatic SVG optimization with SVGO
+ * - Customizable sprite configuration
+ * - CSS stylesheet generation
+ *
+ * @example
+ * ```yaml
+ * steps:
+ *   - name: generate-svg-sprite
+ *     action: SvgSpriteAction
+ *     options:
+ *       sourceDir: ./assets/icons
+ *       outputDir: ./dist/sprites
+ * ```
+ */
+export class SvgSpriteAction extends Action {
+    /**
+     * Constructs an instance with merged default and custom configurations.
+     *
+     * @param customConfig - Optional custom configuration for svg-sprite
+     */
+    constructor(customConfig = {}) {
+        super();
+        this.config = { ...defaultSvgSpriteConfig, ...customConfig };
+    }
+    /**
+     * Validates the provided options before execution.
+     *
+     * @param options - The options to validate
+     * @returns true if options are valid
+     * @throws Error if required options are missing or invalid
+     */
+    validateOptions(options) {
+        const opts = options;
+        if (!opts.sourceDir) {
+            throw new Error("SvgSpriteAction requires 'sourceDir' option");
+        }
+        if (!opts.outputDir) {
+            throw new Error("SvgSpriteAction requires 'outputDir' option");
+        }
+        if (typeof opts.sourceDir !== "string") {
+            throw new Error("SvgSpriteAction 'sourceDir' must be a string");
+        }
+        if (typeof opts.outputDir !== "string") {
+            throw new Error("SvgSpriteAction 'outputDir' must be a string");
+        }
+        if (!fs.existsSync(opts.sourceDir)) {
+            throw new Error(`SvgSpriteAction source directory does not exist: ${opts.sourceDir}`);
+        }
+        return true;
+    }
+    /**
+     * Executes the SVG sprite generation process.
+     *
+     * @param options - Configuration options for sprite generation
+     */
+    async execute(options) {
+        const opts = options;
+        // Merge custom config if provided
+        if (opts.config) {
+            this.config = { ...this.config, ...opts.config };
+        }
+        this.logInfo(`Generating SVG sprite from: ${opts.sourceDir}`);
+        try {
+            await this.generateSprite(opts.sourceDir, opts.outputDir);
+            this.logInfo(`SVG sprite successfully generated in: ${opts.outputDir}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.logError(`Error generating SVG sprite: ${message}`, error);
+            throw new Error(`SVG sprite generation failed: ${message}`);
+        }
+    }
+    /**
+     * Generates an SVG sprite from all SVG files in the specified directory.
+     *
+     * @param sourceDir - Directory containing source SVG files
+     * @param outputDir - Directory where the generated sprite will be saved
+     */
+    async generateSprite(sourceDir, outputDir) {
+        return new Promise((resolve, reject) => {
+            try {
+                const files = fs.readdirSync(sourceDir);
+                const sprite = new svgSprite(this.config);
+                let svgCount = 0;
+                // Add all SVG files to the sprite
+                for (const file of files) {
+                    if (path.extname(file) === ".svg") {
+                        const svgPath = path.resolve(sourceDir, file);
+                        const content = fs.readFileSync(svgPath, "utf8");
+                        sprite.add(svgPath, null, content);
+                        svgCount++;
+                    }
+                }
+                if (svgCount === 0) {
+                    this.logWarning(`No SVG files found in source directory: ${sourceDir}`);
+                    resolve();
+                    return;
+                }
+                this.logDebug(`Found ${svgCount} SVG files to process`);
+                // Compile the sprite
+                sprite.compile((error, result) => {
+                    if (error) {
+                        reject(error);
+                        return;
+                    }
+                    try {
+                        // Write all generated files
+                        for (const mode in result) {
+                            for (const resource in result[mode]) {
+                                // svg-sprite may return absolute paths based on source files
+                                // Extract just the mode/filename portion for consistent output
+                                const resourcePath = result[mode][resource].path;
+                                const relativePath = path.isAbsolute(resourcePath)
+                                    ? path.join(mode, "svg", path.basename(resourcePath))
+                                    : resourcePath;
+                                const outputPath = path.join(outputDir, relativePath);
+                                fs.mkdirSync(path.dirname(outputPath), {
+                                    recursive: true,
+                                });
+                                fs.writeFileSync(outputPath, result[mode][resource].contents);
+                                this.logDebug(`Generated: ${outputPath}`);
+                            }
+                        }
+                        resolve();
+                    }
+                    catch (writeError) {
+                        reject(writeError);
+                    }
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+}
+//# sourceMappingURL=SvgSpriteAction.js.map

package/dist/actions/SvgSpriteAction/SvgSpriteAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgSpriteAction.js","sourceRoot":"","sources":["../../../src/actions/SvgSpriteAction/SvgSpriteAction.ts"],"names":[],"mappings":"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"}

package/dist/actions/SvgSpriteAction/index.d.ts

@@ -0,0 +1,3 @@
+export { SvgSpriteAction } from "./SvgSpriteAction.js";
+export type { SvgSpriteActionOptions } from "./SvgSpriteAction.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/SvgSpriteAction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/SvgSpriteAction/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/actions/SvgSpriteAction/index.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// Export
+// ============================================================================
+export { SvgSpriteAction } from "./SvgSpriteAction.js";
+//# sourceMappingURL=index.js.map

package/dist/actions/SvgSpriteAction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/SvgSpriteAction/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/actions/SvgToPngAction/SvgToPngAction.d.ts

@@ -0,0 +1,72 @@
+import { Action, ActionOptionsType } from "../../types/Action.js";
+/**
+ * Options for SvgToPngAction
+ */
+export interface SvgToPngActionOptions extends ActionOptionsType {
+    /**
+     * SVG content to convert
+     */
+    svgContent: string;
+    /**
+     * Output path for the PNG file
+     */
+    outputPath: string;
+    /**
+     * Optional width for the output PNG
+     */
+    width?: number;
+    /**
+     * Optional height for the output PNG
+     */
+    height?: number;
+}
+/**
+ * SvgToPngAction converts SVG content to PNG format.
+ *
+ * Features:
+ * - High-quality SVG to PNG conversion
+ * - Optional resizing
+ * - Automatic dimension detection
+ * - Directory creation
+ * - Uses canvg for rendering
+ *
+ * Uses `canvg` for conversion and `jsdom` for SVG element manipulation.
+ *
+ * @example
+ * ```yaml
+ * steps:
+ *   - name: convert-to-png
+ *     action: SvgToPngAction
+ *     options:
+ *       svgContent: "<svg>...</svg>"
+ *       outputPath: ./dist/logo.png
+ *       width: 512
+ *       height: 512
+ * ```
+ */
+export declare class SvgToPngAction extends Action {
+    /**
+     * Validates the provided options before execution.
+     *
+     * @param options - The options to validate
+     * @returns true if options are valid
+     * @throws Error if required options are missing or invalid
+     */
+    validateOptions(options: ActionOptionsType): boolean;
+    /**
+     * Executes the SVG-to-PNG conversion process.
+     *
+     * @param options - Options including SVG content, output path, width, and height
+     */
+    execute(options: ActionOptionsType): Promise<void>;
+    /**
+     * Converts SVG content to a PNG file, optionally resizing the output.
+     *
+     * @param svgContent - The SVG content to be converted
+     * @param outputPath - The filesystem path where the PNG should be saved
+     * @param width - Optional width for resizing
+     * @param height - Optional height for resizing
+     */
+    private convert;
+}
+//# sourceMappingURL=SvgToPngAction.d.ts.map

package/dist/actions/SvgToPngAction/SvgToPngAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgToPngAction.d.ts","sourceRoot":"","sources":["../../../src/actions/SvgToPngAction/SvgToPngAction.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAMlE;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,cAAe,SAAQ,MAAM;IACxC;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO;IA8BpD;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxD;;;;;;;OAOG;YACW,OAAO;CAkDtB"}