kist 0.1.38 → 0.1.40

package/js/actions/TemplateRenderAction/TemplateRenderAction.d.ts

@@ -3,6 +3,7 @@ import { ActionOptionsType } from "../../types/ActionOptionsType";
 export declare class TemplateRenderAction extends Action {
     execute(options: ActionOptionsType): Promise<void>;
     private renderTemplate;
+    private mergeContextFiles;
     describe(): string;
 }
 export default TemplateRenderAction;

package/js/actions/TemplateRenderAction/TemplateRenderAction.js

@@ -28,9 +28,11 @@ const nunjucks_config_js_1 = __importDefault(require("./nunjucks.config.js"));
 class TemplateRenderAction extends Action_1.Action {
     execute(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { templatesDir = "./templates", outputDir = "./dist", templates = [], context = {}, renderAllFromDir = false, customConfig = {}, } = options;
+            const { templatesDir = "./templates", outputDir = "./dist", templates = [], context = {}, contextFiles = [], renderAllFromDir = false, customConfig = {}, } = options;
             const config = Object.assign(Object.assign({}, nunjucks_config_js_1.default), customConfig);
             nunjucks_1.default.configure(templatesDir, config);
+            // Load and merge all JSON context files
+            const mergedContext = yield this.mergeContextFiles(context, contextFiles);
             try {
                 if (renderAllFromDir) {
                     this.logInfo(`Auto-rendering all templates from ${templatesDir}...`);
@@ -39,7 +41,7 @@ class TemplateRenderAction extends Action_1.Action {
                     });
                     for (const templateRelPath of templateFiles) {
                         const outputFile = path_1.default.join(outputDir, templateRelPath.replace(/\.jinja$/, ""));
-                        yield this.renderTemplate(templateRelPath, outputFile, context, templatesDir);
+                        yield this.renderTemplate(templateRelPath, outputFile, mergedContext, templatesDir);
                     }
                 }
                 else {
@@ -47,7 +49,7 @@ class TemplateRenderAction extends Action_1.Action {
                         throw new Error("Option 'templates' must be provided if 'renderAllFromDir' is false.");
                     }
                     for (const { template, outputFile } of templates) {
-                        yield this.renderTemplate(template, outputFile, context, templatesDir);
+                        yield this.renderTemplate(template, outputFile, mergedContext, templatesDir);
                     }
                 }
                 this.logInfo("✓ All templates rendered successfully.");
@@ -68,12 +70,26 @@ class TemplateRenderAction extends Action_1.Action {
             this.logInfo(`✓ Rendered: ${outputFile}`);
         });
     }
+    mergeContextFiles(baseContext, files) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let merged = Object.assign({}, baseContext);
+            for (const file of files) {
+                try {
+                    const content = yield (0, promises_1.readFile)(file, "utf-8");
+                    const parsed = JSON.parse(content);
+                    merged = Object.assign(Object.assign({}, merged), parsed);
+                }
+                catch (error) {
+                    this.logWarn(`Skipping context file due to error: ${file}`);
+                    this.logError("Context file parsing failed", error);
+                }
+            }
+            return merged;
+        });
+    }
     describe() {
-        return "Renders one or many Nunjucks templates using a shared context. Supports folder-wide auto-rendering.";
+        return "Renders one or many Nunjucks templates using a shared context or context files. Supports folder-wide auto-rendering.";
     }
 }
 exports.TemplateRenderAction = TemplateRenderAction;
-// ============================================================================
-// Export
-// ============================================================================
 exports.default = TemplateRenderAction;

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.38",
+  "version": "0.1.40",
   "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/TemplateRenderAction/TemplateRenderAction.ts

@@ -2,7 +2,7 @@
 // Imports
 // ============================================================================
 
-import { mkdir, writeFile } from "fs/promises";
+import { mkdir, readFile, writeFile } from "fs/promises";
 import { glob } from "glob";
 import nunjucks from "nunjucks";
 import path from "path";
@@ -21,6 +21,7 @@ export class TemplateRenderAction extends Action {
             outputDir = "./dist",
             templates = [],
             context = {},
+            contextFiles = [],
             renderAllFromDir = false,
             customConfig = {},
         } = options;
@@ -28,6 +29,12 @@ export class TemplateRenderAction extends Action {
         const config = { ...nunjucksConfig, ...customConfig };
         nunjucks.configure(templatesDir, config);
 
+        // Load and merge all JSON context files
+        const mergedContext = await this.mergeContextFiles(
+            context,
+            contextFiles,
+        );
+
         try {
             if (renderAllFromDir) {
                 this.logInfo(
@@ -45,7 +52,7 @@ export class TemplateRenderAction extends Action {
                     await this.renderTemplate(
                         templateRelPath,
                         outputFile,
-                        context,
+                        mergedContext,
                         templatesDir,
                     );
                 }
@@ -60,7 +67,7 @@ export class TemplateRenderAction extends Action {
                     await this.renderTemplate(
                         template,
                         outputFile,
-                        context,
+                        mergedContext,
                         templatesDir,
                     );
                 }
@@ -89,13 +96,29 @@ export class TemplateRenderAction extends Action {
         this.logInfo(`✓ Rendered: ${outputFile}`);
     }
 
+    private async mergeContextFiles(
+        baseContext: Record<string, any>,
+        files: string[],
+    ): Promise<Record<string, any>> {
+        let merged = { ...baseContext };
+
+        for (const file of files) {
+            try {
+                const content = await readFile(file, "utf-8");
+                const parsed = JSON.parse(content);
+                merged = { ...merged, ...parsed };
+            } catch (error) {
+                this.logWarn(`Skipping context file due to error: ${file}`);
+                this.logError("Context file parsing failed", error);
+            }
+        }
+
+        return merged;
+    }
+
     describe(): string {
-        return "Renders one or many Nunjucks templates using a shared context. Supports folder-wide auto-rendering.";
+        return "Renders one or many Nunjucks templates using a shared context or context files. Supports folder-wide auto-rendering.";
     }
 }
 
-// ============================================================================
-// Export
-// ============================================================================
-
 export default TemplateRenderAction;

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 };