kist 0.1.37 → 0.1.39

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/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.37",
+  "version": "0.1.39",
   "description": "Package Pipeline Processor",
   "keywords": [
     "kist",

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/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);