kist 0.1.39 → 0.1.41

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-    <img src="https://raw.githubusercontent.com/getkist/brand/master/src/logo/kist.png" width="20%" height="20%" alt="kist logo"></p>
+    <img src="https://raw.githubusercontent.com/getkist/brand/master/src/logo/kist.png" width="20%" alt="kist logo"></p>
 <h1 align="center" style='border-bottom: none;'>kist</h1>
 <h3 align="center">Package Pipeline Processor</h3>
 
@@ -286,7 +286,7 @@ Contributions are welcome! Follow these steps to contribute:
 
 #### Copyright
 
-Copyright &copy; 2024 [Scape Agency BV](https://www.scape.agency/ "Scape Agency website"). All Rights Reserved.
+Copyright &copy; 2025 [Scape Agency BV](https://www.scape.agency/ "Scape Agency website"). All Rights Reserved.
 
 #### License
 

package/js/actions/TypeScriptCompilerAction/TypeScriptCompilerAction.js

@@ -35,14 +35,26 @@ class TypeScriptCompilerAction extends Action_1.Action {
      */
     execute(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { tsconfigPath = "tsconfig.json" } = options;
+            // const { tsconfigPath = "tsconfig.json" } = options;
+            const { tsconfigPath = "tsconfig.json", filePaths, outputDir, compilerOptions = {}, } = options;
             const resolvedTsconfigPath = path_1.default.resolve(tsconfigPath);
             this.logInfo(`Compiling TypeScript using configuration: ${resolvedTsconfigPath}`);
             try {
                 // **Properly Parse tsconfig.json**
                 const parsedConfig = this.loadAndParseTsConfig(resolvedTsconfigPath);
+                // Merge custom compiler options
+                const mergedCompilerOptions = Object.assign(Object.assign({}, parsedConfig.options), compilerOptions);
+                // Set output directory if specified
+                if (outputDir) {
+                    mergedCompilerOptions.outDir = outputDir;
+                }
+                // **Create a TypeScript Program**
+                const program = typescript_1.default.createProgram(filePaths !== null && filePaths !== void 0 ? filePaths : parsedConfig.fileNames, mergedCompilerOptions);
                 // **Create a TypeScript Program**
-                const program = typescript_1.default.createProgram(parsedConfig.fileNames, parsedConfig.options);
+                // const program = ts.createProgram(
+                //     parsedConfig.fileNames,
+                //     parsedConfig.options,
+                // );
                 const emitResult = program.emit();
                 // **Collect Diagnostics**
                 const allDiagnostics = typescript_1.default

package/js/cli/ArgumentParser.js

@@ -24,6 +24,7 @@ class ArgumentParser extends AbstractProcess_1.AbstractProcess {
      * @param args - Command-line arguments. Defaults to `process.argv.slice(2)`.
      */
     constructor() {
+        // args: string[] = process.argv.slice(2)
         super();
         // Skip Node.js and script path
         this.args = process.argv.slice(2);

package/js/core/config/ConfigLoader.js

@@ -70,11 +70,44 @@ class ConfigLoader extends AbstractProcess_1.AbstractProcess {
                 }
                 catch (error) {
                     this.logDebug(`File not accessible: ${resolvedPath}`);
+                    // ❗ If user explicitly provided --config and it fails, stop immediately
+                    if (cliPath) {
+                        throw new Error(`Configuration file not found or not accessible: ${resolvedPath}`);
+                    }
                 }
             }
             this.logWarn("No configuration file found. Proceeding with default settings.");
         });
     }
+    // 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 config file${cliPath ? ` from --config=${cliPath}` : ""}...`,
+    //     );
+    //     for (const fileName of searchPaths) {
+    //         const resolvedPath = path.resolve(process.cwd(), fileName);
+    //         this.logDebug(`Checking: ${resolvedPath}`);
+    //         try {
+    //             await fs.promises.access(
+    //                 resolvedPath,
+    //                 fs.constants.F_OK | fs.constants.R_OK,
+    //             );
+    //             this.configPath = resolvedPath;
+    //             this.logDebug(`Configuration file found: ${resolvedPath}`);
+    //             return;
+    //         } catch (error) {
+    //             this.logDebug(`File not accessible: ${resolvedPath}`);
+    //         }
+    //     }
+    //     this.logWarn(
+    //         "No configuration file found. Proceeding with default settings.",
+    //     );
+    // }
     /**
      * Loads and validates the configuration file.
      *

package/js/core/config/ConfigStore.js

@@ -65,7 +65,8 @@ class ConfigStore extends AbstractProcess_1.AbstractProcess {
                 return;
             }
             // Ensure property exists and is an object
-            if (!Object.prototype.hasOwnProperty.call(current, k) || typeof current[k] !== "object") {
+            if (!Object.prototype.hasOwnProperty.call(current, k) ||
+                typeof current[k] !== "object") {
                 current[k] = Object.create(null); // Use a null prototype object
             }
             current = current[k];
@@ -118,8 +119,11 @@ class ConfigStore extends AbstractProcess_1.AbstractProcess {
                 this.logWarn(`Skipping unsafe key during merge: "${key}"`);
                 continue;
             }
-            if (source[key] && typeof source[key] === "object" && !Array.isArray(source[key])) {
-                if (!Object.prototype.hasOwnProperty.call(target, key) || typeof target[key] !== "object") {
+            if (source[key] &&
+                typeof source[key] === "object" &&
+                !Array.isArray(source[key])) {
+                if (!Object.prototype.hasOwnProperty.call(target, key) ||
+                    typeof target[key] !== "object") {
                     target[key] = Object.create(null);
                 }
                 target[key] = this.deepMerge(target[key], source[key]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kist",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "description": "Package Pipeline Processor",
   "keywords": [
     "kist",
@@ -86,7 +86,6 @@
     "postcss-preset-env": "^10.0.0",
     "prettier": "^3.0.3",
     "sass": "^1.69.7",
-    "sassdoc": "^2.7.4",
     "semver": "^7.5.4",
     "svg-sprite": "^2.0.2",
     "svgo": "^3.1.0",

package/ts/actions/TypeScriptCompilerAction/TypeScriptCompilerAction.ts

@@ -23,7 +23,14 @@ export class TypeScriptCompilerAction extends Action {
      * @throws {Error} Throws an error if compilation fails.
      */
     async execute(options: ActionOptionsType): Promise<void> {
-        const { tsconfigPath = "tsconfig.json" } = options;
+        // const { tsconfigPath = "tsconfig.json" } = options;
+        const {
+            tsconfigPath = "tsconfig.json",
+            filePaths,
+            outputDir,
+            compilerOptions = {},
+        } = options;
+
         const resolvedTsconfigPath = path.resolve(tsconfigPath);
 
         this.logInfo(
@@ -36,11 +43,28 @@ export class TypeScriptCompilerAction extends Action {
                 resolvedTsconfigPath,
             );
 
+            // Merge custom compiler options
+            const mergedCompilerOptions = {
+                ...parsedConfig.options,
+                ...compilerOptions,
+            };
+
+            // Set output directory if specified
+            if (outputDir) {
+                mergedCompilerOptions.outDir = outputDir;
+            }
+
             // **Create a TypeScript Program**
             const program = ts.createProgram(
-                parsedConfig.fileNames,
-                parsedConfig.options,
+                filePaths ?? parsedConfig.fileNames,
+                mergedCompilerOptions,
             );
+
+            // **Create a TypeScript Program**
+            // const program = ts.createProgram(
+            //     parsedConfig.fileNames,
+            //     parsedConfig.options,
+            // );
             const emitResult = program.emit();
 
             // **Collect Diagnostics**

package/ts/cli/ArgumentParser.ts

@@ -38,7 +38,8 @@ export class ArgumentParser extends AbstractProcess {
      *
      * @param args - Command-line arguments. Defaults to `process.argv.slice(2)`.
      */
-    constructor() { // args: string[] = process.argv.slice(2)
+    constructor() {
+        // args: string[] = process.argv.slice(2)
         super();
         // Skip Node.js and script path
         this.args = process.argv.slice(2);

package/ts/core/config/ConfigLoader.ts

@@ -73,6 +73,13 @@ export class ConfigLoader extends AbstractProcess {
                 return;
             } catch (error) {
                 this.logDebug(`File not accessible: ${resolvedPath}`);
+
+                // ❗ If user explicitly provided --config and it fails, stop immediately
+                if (cliPath) {
+                    throw new Error(
+                        `Configuration file not found or not accessible: ${resolvedPath}`,
+                    );
+                }
             }
         }
 
@@ -80,6 +87,40 @@ export class ConfigLoader extends AbstractProcess {
             "No configuration file found. Proceeding with default settings.",
         );
     }
+    // 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 config file${cliPath ? ` from --config=${cliPath}` : ""}...`,
+    //     );
+
+    //     for (const fileName of searchPaths) {
+    //         const resolvedPath = path.resolve(process.cwd(), fileName);
+    //         this.logDebug(`Checking: ${resolvedPath}`);
+
+    //         try {
+    //             await fs.promises.access(
+    //                 resolvedPath,
+    //                 fs.constants.F_OK | fs.constants.R_OK,
+    //             );
+    //             this.configPath = resolvedPath;
+    //             this.logDebug(`Configuration file found: ${resolvedPath}`);
+    //             return;
+    //         } catch (error) {
+    //             this.logDebug(`File not accessible: ${resolvedPath}`);
+    //         }
+    //     }
+
+    //     this.logWarn(
+    //         "No configuration file found. Proceeding with default settings.",
+    //     );
+    // }
 
     /**
      * Loads and validates the configuration file.

package/ts/core/config/ConfigStore.ts

@@ -80,7 +80,10 @@ export class ConfigStore extends AbstractProcess {
             }
 
             // Ensure property exists and is an object
-            if (!Object.prototype.hasOwnProperty.call(current, k) || typeof current[k] !== "object") {
+            if (
+                !Object.prototype.hasOwnProperty.call(current, k) ||
+                typeof current[k] !== "object"
+            ) {
                 current[k] = Object.create(null); // Use a null prototype object
             }
             current = current[k];
@@ -90,12 +93,16 @@ export class ConfigStore extends AbstractProcess {
 
         // Prevent prototype pollution at the final assignment
         if (["__proto__", "constructor", "prototype"].includes(finalKey)) {
-            this.logWarn(`Attempted prototype pollution detected: "${finalKey}"`);
+            this.logWarn(
+                `Attempted prototype pollution detected: "${finalKey}"`,
+            );
             return;
         }
 
         current[finalKey] = value;
-        this.logDebug(`Set configuration key "${key}" to: ${JSON.stringify(value)}`);
+        this.logDebug(
+            `Set configuration key "${key}" to: ${JSON.stringify(value)}`,
+        );
     }
 
     /**
@@ -120,7 +127,10 @@ export class ConfigStore extends AbstractProcess {
      * Prints the current configuration to the console.
      */
     public print(): void {
-        console.log("Current Configuration:", JSON.stringify(this.config, null, 2));
+        console.log(
+            "Current Configuration:",
+            JSON.stringify(this.config, null, 2),
+        );
     }
 
     /**
@@ -142,8 +152,15 @@ export class ConfigStore extends AbstractProcess {
                 continue;
             }
 
-            if (source[key] && typeof source[key] === "object" && !Array.isArray(source[key])) {
-                if (!Object.prototype.hasOwnProperty.call(target, key) || typeof target[key] !== "object") {
+            if (
+                source[key] &&
+                typeof source[key] === "object" &&
+                !Array.isArray(source[key])
+            ) {
+                if (
+                    !Object.prototype.hasOwnProperty.call(target, key) ||
+                    typeof target[key] !== "object"
+                ) {
                     target[key] = Object.create(null);
                 }
                 target[key] = this.deepMerge(target[key], source[key]);

package/ts/index.ts

@@ -2,8 +2,6 @@
 // Import
 // ============================================================================
 
-
-
 // Core Modules
 // export { Pipeline } from "./core/Pipeline";
 // export { ConfigLoader } from "./core/ConfigLoader";

package/ts/actions/SassDocAction/SassDocAction.ts

@@ -1,66 +0,0 @@
-// // ============================================================================
-// // Imports
-// // ============================================================================
-
-// // @ts-ignore: Implicit any type for sassdoc module
-// import path from "path";
-// import sassdoc from "sassdoc";
-// import { Action } from "../../core/pipeline/Action";
-// import { ActionOptionsType } from "../../types/ActionOptionsType";
-
-// // ============================================================================
-// // Classes
-// // ============================================================================
-
-// /**
-//  * SassDocAction generates SASS documentation using SassDoc.
-//  * This action allows specifying source directories, destination paths, and additional options.
-//  */
-// export class SassDocAction extends Action {
-//     /**
-//      * Executes the SASS documentation generation process.
-//      *
-//      * @param options - The options specifying source directories, output path, and SassDoc configurations.
-//      * @returns A Promise that resolves when the documentation generation is completed successfully.
-//      * @throws {Error} Throws an error if the documentation process fails.
-//      */
-//     async execute(options: ActionOptionsType): Promise<void> {
-//         const {
-//             sourcePaths = ["src/styles"],
-//             outputPath = "docs/sass",
-//             sassdocOptions = {},
-//         } = options;
-
-//         if (!Array.isArray(sourcePaths) || sourcePaths.length === 0) {
-//             throw new Error("Invalid options: 'sourcePaths' must be a non-empty array.");
-//         }
-
-//         this.logInfo(`Generating SASS documentation in ${outputPath}...`);
-
-//         try {
-//             // Merge custom options with default options
-//             const config: sassdoc.Options = {
-//                 dest: path.resolve(outputPath),
-//                 verbose: true,
-//                 ...sassdocOptions,
-//             };
-
-//             // Run SassDoc to generate documentation
-//             await sassdoc(sourcePaths, config);
-
-//             this.logInfo(`SASS documentation successfully generated at: ${config.dest}`);
-//         } catch (error) {
-//             this.logError("An error occurred while generating SASS documentation.", error);
-//             throw error;
-//         }
-//     }
-
-//     /**
-//      * Provides a description of the action.
-//      *
-//      * @returns A string description of the action.
-//      */
-//     describe(): string {
-//         return "Generates SASS documentation using SassDoc.";
-//     }
-// }

package/ts/actions/SassDocAction/index.ts

@@ -1,11 +0,0 @@
-// ============================================================================
-// Import
-// ============================================================================
-
-// import { SassDocAction } from "./SassDocAction";
-
-// ============================================================================
-// Export
-// ============================================================================
-
-// export { SassDocAction };