kist 0.1.36 → 0.1.38

package/js/actions/SvgToPngAction/SvgToPngAction.d.ts

@@ -2,7 +2,7 @@ import { Action } from "../../core/pipeline/Action";
 import { ActionOptionsType } from "../../types/ActionOptionsType";
 /**
  * SvgToPngAction converts SVG content to PNG format.
- * Uses `resvg-js` for conversion and `jsdom` for SVG element manipulation.
+ * Uses `canvg` for conversion and `jsdom` for SVG element manipulation.
  */
 export declare class SvgToPngAction extends Action {
     /**

package/js/actions/SvgToPngAction/SvgToPngAction.js

@@ -16,21 +16,26 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SvgToPngAction = void 0;
-const resvg_js_1 = require("@resvg/resvg-js");
+const canvas_1 = require("canvas");
+const canvg_1 = require("canvg");
 const fs_1 = __importDefault(require("fs"));
 const jsdom_1 = require("jsdom");
 const path_1 = __importDefault(require("path"));
 const Action_1 = require("../../core/pipeline/Action");
 // ============================================================================
+// Utilities
+// ============================================================================
+function getSafeRenderingContext(canvas) {
+    return canvas.getContext("2d");
+}
+// ============================================================================
 // Classes
 // ============================================================================
 /**
  * SvgToPngAction converts SVG content to PNG format.
- * Uses `resvg-js` for conversion and `jsdom` for SVG element manipulation.
+ * Uses `canvg` for conversion and `jsdom` for SVG element manipulation.
  */
 class SvgToPngAction extends Action_1.Action {
-    // Methods
-    // ========================================================================
     /**
      * Executes the SVG-to-PNG conversion process.
      * @param options - Options including SVG content, output path, width,
@@ -63,29 +68,27 @@ class SvgToPngAction extends Action_1.Action {
     convert(svgContent, outputPath, width, height) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                // Ensure the output directory exists
                 const outputDir = path_1.default.dirname(outputPath);
                 if (!fs_1.default.existsSync(outputDir)) {
                     fs_1.default.mkdirSync(outputDir, { recursive: true });
                 }
-                // Parse SVG and apply width/height
                 const dom = new jsdom_1.JSDOM(svgContent);
                 const svgElement = dom.window.document.querySelector("svg");
                 if (!svgElement) {
                     throw new Error("Invalid SVG content");
                 }
-                if (width)
-                    svgElement.setAttribute("width", width.toString());
-                if (height)
-                    svgElement.setAttribute("height", height.toString());
+                const w = width ||
+                    parseInt(svgElement.getAttribute("width") || "800", 10);
+                const h = height ||
+                    parseInt(svgElement.getAttribute("height") || "600", 10);
+                svgElement.setAttribute("width", w.toString());
+                svgElement.setAttribute("height", h.toString());
                 const updatedSvgContent = svgElement.outerHTML;
-                // Render using Resvg
-                const resvg = new resvg_js_1.Resvg(updatedSvgContent, {
-                    fitTo: width && height
-                        ? { mode: "width", value: width }
-                        : undefined,
-                });
-                const pngBuffer = resvg.render().asPng();
+                const canvas = (0, canvas_1.createCanvas)(w, h);
+                const ctx = getSafeRenderingContext(canvas);
+                const canvg = yield canvg_1.Canvg.from(ctx, updatedSvgContent);
+                yield canvg.render();
+                const pngBuffer = canvas.toBuffer("image/png");
                 fs_1.default.writeFileSync(outputPath, pngBuffer);
             }
             catch (error) {
@@ -98,7 +101,7 @@ class SvgToPngAction extends Action_1.Action {
      * @returns A string description of the action.
      */
     describe() {
-        return "Converts SVG content to PNG format with optional resizing using resvg-js.";
+        return "Converts SVG content to PNG format with optional resizing using canvg and canvas.";
     }
 }
 exports.SvgToPngAction = SvgToPngAction;

package/js/core/config/ConfigLoader.d.ts

@@ -1,10 +1,8 @@
 import { ConfigInterface } from "../../interface/ConfigInterface";
 import { AbstractProcess } from "../abstract/AbstractProcess";
 /**
- * ConfigLoader is responsible for loading and parsing configuration files
- * (`kist.yaml` or `kist.yml` by default). It validates the configuration
- * structure and provides it in a usable format for the pipeline.
- * Extends `AbstractProcess` for consistent logging.
+ * ConfigLoader is responsible for loading and parsing configuration files.
+ * Supports a custom path via `--config`, and falls back to `kist.yaml` or `kist.yml`.
  */
 export declare class ConfigLoader extends AbstractProcess {
     /**
@@ -15,21 +13,12 @@ export declare class ConfigLoader extends AbstractProcess {
      * Default filenames to search for configuration files.
      */
     private readonly defaultFilenames;
-    /**
-     * Constructs a ConfigLoader instance.
-     * Searches for `kist.yaml` or `kist.yml` in the working directory
-     * unless a custom path is provided.
-     *
-     * @param configPath - Optional custom configuration file path.
-     */
-    constructor(configPath?: string);
+    constructor();
     /**
      * Initializes the loader by locating the configuration file.
-     * Searches for `kist.yaml` or `kist.yml` by default.
-     *
-     * @param configPath - Optional custom configuration file path.
+     * Uses `--config` CLI flag if provided, otherwise defaults.
      */
-    initialize(configPath?: string): Promise<void>;
+    initialize(): Promise<void>;
     /**
      * Loads and validates the configuration file.
      *

package/js/core/config/ConfigLoader.js

@@ -19,27 +19,19 @@ exports.ConfigLoader = void 0;
 const fs_1 = __importDefault(require("fs"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
 const path_1 = __importDefault(require("path"));
+const ArgumentParser_1 = require("../../cli/ArgumentParser");
 const AbstractProcess_1 = require("../abstract/AbstractProcess");
 // ============================================================================
 // Class
 // ============================================================================
 /**
- * ConfigLoader is responsible for loading and parsing configuration files
- * (`kist.yaml` or `kist.yml` by default). It validates the configuration
- * structure and provides it in a usable format for the pipeline.
- * Extends `AbstractProcess` for consistent logging.
+ * ConfigLoader is responsible for loading and parsing configuration files.
+ * Supports a custom path via `--config`, and falls back to `kist.yaml` or `kist.yml`.
  */
 class ConfigLoader extends AbstractProcess_1.AbstractProcess {
     // Constructor
     // ========================================================================
-    /**
-     * Constructs a ConfigLoader instance.
-     * Searches for `kist.yaml` or `kist.yml` in the working directory
-     * unless a custom path is provided.
-     *
-     * @param configPath - Optional custom configuration file path.
-     */
-    constructor(configPath) {
+    constructor() {
         super();
         // Parameters
         // ========================================================================
@@ -51,27 +43,22 @@ class ConfigLoader extends AbstractProcess_1.AbstractProcess {
          * Default filenames to search for configuration files.
          */
         this.defaultFilenames = ["kist.yaml", "kist.yml"];
-        if (configPath) {
-            this.configPath = path_1.default.resolve(process.cwd(), configPath);
-            this.logDebug(`Custom configuration path set: ${this.configPath}`);
-        }
-        else {
-            this.logDebug("ConfigLoader initialized without custom path.");
-        }
+        this.logDebug("ConfigLoader initialized.");
     }
     // Methods
     // ========================================================================
     /**
      * Initializes the loader by locating the configuration file.
-     * Searches for `kist.yaml` or `kist.yml` by default.
-     *
-     * @param configPath - Optional custom configuration file path.
+     * Uses `--config` CLI flag if provided, otherwise defaults.
      */
-    initialize(configPath) {
+    initialize() {
         return __awaiter(this, void 0, void 0, function* () {
-            const searchPaths = configPath ? [configPath] : this.defaultFilenames;
+            const parser = new ArgumentParser_1.ArgumentParser();
+            const cliFlags = parser.getAllFlags();
+            const cliPath = typeof cliFlags.config === "string" ? cliFlags.config : undefined;
+            const searchPaths = cliPath ? [cliPath] : this.defaultFilenames;
             this.logDebug(`Current working directory: ${process.cwd()}`);
-            this.logDebug("Searching for configuration files...");
+            this.logDebug(`Searching for config file${cliPath ? ` from --config=${cliPath}` : ""}...`);
             for (const fileName of searchPaths) {
                 const resolvedPath = path_1.default.resolve(process.cwd(), fileName);
                 this.logDebug(`Checking: ${resolvedPath}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kist",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "Package Pipeline Processor",
   "keywords": [
     "kist",
@@ -60,15 +60,14 @@
     "@babel/core": "^7.23.6",
     "@babel/preset-env": "^7.23.6",
     "@babel/preset-typescript": "^7.23.3",
-    "@resvg/resvg-js": "^2.6.2",
     "@types/fs-extra": "^11.0.4",
     "@types/glob": "^8.1.0",
-    "@types/jsdom": "^21.1.6",
     "@types/micromatch": "^4.0.9",
-    "@types/node": "^22.13.0",
     "@types/nunjucks": "^3.2.6",
     "@types/svg-sprite": "^0.0.39",
     "autoprefixer": "^10.4.21",
+    "canvas": "^3.1.0",
+    "canvg": "^4.0.3",
     "chokidar": "^4.0.0",
     "cssnano": "^7.0.4",
     "del": "^8.0.0",
@@ -80,7 +79,7 @@
     "fs-extra": "^11.2.0",
     "glob": "^11.0.0",
     "js-yaml": "^4.1.0",
-    "jsdom": "^26.0.0",
+    "jsdom": "^26.1.0",
     "lodash": "^4.17.21",
     "nunjucks": "^3.2.4",
     "postcss": "^8.4.32",

package/ts/actions/SvgToPngAction/SvgToPngAction.ts

@@ -2,25 +2,31 @@
 // Imports
 // ============================================================================
 
-import { Resvg } from "@resvg/resvg-js";
+import { createCanvas } from "canvas";
+import { Canvg } from "canvg";
 import fs from "fs";
 import { JSDOM } from "jsdom";
 import path from "path";
 import { Action } from "../../core/pipeline/Action";
 import { ActionOptionsType } from "../../types/ActionOptionsType";
 
+// ============================================================================
+// Utilities
+// ============================================================================
+
+function getSafeRenderingContext(canvas: ReturnType<typeof createCanvas>) {
+    return canvas.getContext("2d");
+}
+
 // ============================================================================
 // Classes
 // ============================================================================
 
 /**
  * SvgToPngAction converts SVG content to PNG format.
- * Uses `resvg-js` for conversion and `jsdom` for SVG element manipulation.
+ * Uses `canvg` for conversion and `jsdom` for SVG element manipulation.
  */
 export class SvgToPngAction extends Action {
-    // Methods
-    // ========================================================================
-
     /**
      * Executes the SVG-to-PNG conversion process.
      * @param options - Options including SVG content, output path, width,
@@ -60,13 +66,11 @@ export class SvgToPngAction extends Action {
         height?: number,
     ): Promise<void> {
         try {
-            // Ensure the output directory exists
             const outputDir = path.dirname(outputPath);
             if (!fs.existsSync(outputDir)) {
                 fs.mkdirSync(outputDir, { recursive: true });
             }
 
-            // Parse SVG and apply width/height
             const dom = new JSDOM(svgContent);
             const svgElement = dom.window.document.querySelector("svg");
 
@@ -74,21 +78,25 @@ export class SvgToPngAction extends Action {
                 throw new Error("Invalid SVG content");
             }
 
-            if (width) svgElement.setAttribute("width", width.toString());
-            if (height) svgElement.setAttribute("height", height.toString());
+            const w =
+                width ||
+                parseInt(svgElement.getAttribute("width") || "800", 10);
+            const h =
+                height ||
+                parseInt(svgElement.getAttribute("height") || "600", 10);
+
+            svgElement.setAttribute("width", w.toString());
+            svgElement.setAttribute("height", h.toString());
 
             const updatedSvgContent = svgElement.outerHTML;
 
-            // Render using Resvg
-            const resvg = new Resvg(updatedSvgContent, {
-                fitTo:
-                    width && height
-                        ? { mode: "width", value: width }
-                        : undefined,
-            });
+            const canvas = createCanvas(w, h);
+            const ctx = getSafeRenderingContext(canvas) as unknown as any;
 
-            const pngBuffer = resvg.render().asPng();
+            const canvg = await Canvg.from(ctx, updatedSvgContent);
+            await canvg.render();
 
+            const pngBuffer = canvas.toBuffer("image/png");
             fs.writeFileSync(outputPath, pngBuffer);
         } catch (error) {
             throw new Error(
@@ -102,7 +110,7 @@ export class SvgToPngAction extends Action {
      * @returns A string description of the action.
      */
     describe(): string {
-        return "Converts SVG content to PNG format with optional resizing using resvg-js.";
+        return "Converts SVG content to PNG format with optional resizing using canvg and canvas.";
     }
 }
 

package/ts/core/config/ConfigLoader.ts

@@ -5,6 +5,7 @@
 import fs from "fs";
 import yaml from "js-yaml";
 import path from "path";
+import { ArgumentParser } from "../../cli/ArgumentParser";
 import { ConfigInterface } from "../../interface/ConfigInterface";
 import { AbstractProcess } from "../abstract/AbstractProcess";
 
@@ -13,10 +14,8 @@ import { AbstractProcess } from "../abstract/AbstractProcess";
 // ============================================================================
 
 /**
- * ConfigLoader is responsible for loading and parsing configuration files
- * (`kist.yaml` or `kist.yml` by default). It validates the configuration
- * structure and provides it in a usable format for the pipeline.
- * Extends `AbstractProcess` for consistent logging.
+ * ConfigLoader is responsible for loading and parsing configuration files.
+ * Supports a custom path via `--config`, and falls back to `kist.yaml` or `kist.yml`.
  */
 export class ConfigLoader extends AbstractProcess {
     // Parameters
@@ -35,21 +34,9 @@ export class ConfigLoader extends AbstractProcess {
     // Constructor
     // ========================================================================
 
-    /**
-     * Constructs a ConfigLoader instance.
-     * Searches for `kist.yaml` or `kist.yml` in the working directory
-     * unless a custom path is provided.
-     *
-     * @param configPath - Optional custom configuration file path.
-     */
-    constructor(configPath?: string) {
+    constructor() {
         super();
-        if (configPath) {
-            this.configPath = path.resolve(process.cwd(), configPath);
-            this.logDebug(`Custom configuration path set: ${this.configPath}`);
-        } else {
-            this.logDebug("ConfigLoader initialized without custom path.");
-        }
+        this.logDebug("ConfigLoader initialized.");
     }
 
     // Methods
@@ -57,15 +44,20 @@ export class ConfigLoader extends AbstractProcess {
 
     /**
      * Initializes the loader by locating the configuration file.
-     * Searches for `kist.yaml` or `kist.yml` by default.
-     *
-     * @param configPath - Optional custom configuration file path.
+     * Uses `--config` CLI flag if provided, otherwise defaults.
      */
-    public async initialize(configPath?: string): Promise<void> {
-        const searchPaths = configPath ? [configPath] : this.defaultFilenames;
+    public async initialize(): Promise<void> {
+        const parser = new ArgumentParser();
+        const cliFlags = parser.getAllFlags();
+        const cliPath =
+            typeof cliFlags.config === "string" ? cliFlags.config : undefined;
+
+        const searchPaths = cliPath ? [cliPath] : this.defaultFilenames;
 
         this.logDebug(`Current working directory: ${process.cwd()}`);
-        this.logDebug("Searching for configuration files...");
+        this.logDebug(
+            `Searching for config file${cliPath ? ` from --config=${cliPath}` : ""}...`,
+        );
 
         for (const fileName of searchPaths) {
             const resolvedPath = path.resolve(process.cwd(), fileName);