kist 0.1.44 → 0.1.57

package/js/actions/DirectoryCleanAction/DirectoryCleanAction.js

@@ -88,7 +88,7 @@ class DirectoryCleanAction extends Action_1.Action {
                     const stat = yield fs_1.default.promises.lstat(curPath);
                     if (stat.isDirectory()) {
                         // Recursively clean subdirectory
-                        yield fs_1.default.promises.rmdir(curPath, { recursive: true });
+                        yield fs_1.default.promises.rm(curPath, { recursive: true });
                         this.logInfo(`Deleted directory: ${relativePath}`);
                     }
                     else {
@@ -108,7 +108,7 @@ class DirectoryCleanAction extends Action_1.Action {
      * @returns A string description of the action.
      */
     describe() {
-        let description = `
+        const description = `
             Cleans a directory by deleting all its contents while retaining
             files and directories matching specified glob patterns. If the
             directory does not exist, the action will skip gracefully.

package/js/actions/SvgPackagerAction/SvgPackagerAction.js

@@ -49,7 +49,7 @@ exports.SvgPackagerAction = void 0;
 const fs = __importStar(require("fs/promises"));
 const glob = __importStar(require("glob"));
 const path = __importStar(require("path"));
-const svgo_1 = __importStar(require("svgo"));
+const svgo_1 = require("svgo");
 const Action_1 = require("../../core/pipeline/Action");
 // ============================================================================
 // Classes
@@ -117,7 +117,7 @@ class SvgPackagerAction extends Action_1.Action {
     optimizeSvg(svgoConfigPath, svgContent) {
         return __awaiter(this, void 0, void 0, function* () {
             const config = yield (0, svgo_1.loadConfig)(svgoConfigPath);
-            const result = yield svgo_1.default.optimize(svgContent, Object.assign({}, config));
+            const result = yield (0, svgo_1.optimize)(svgContent, Object.assign({}, config));
             return result.data.trim();
         });
     }

package/js/actions/TemplateRenderAction/TemplateRenderAction.js

@@ -60,7 +60,7 @@ class TemplateRenderAction extends Action_1.Action {
             }
         });
     }
-    renderTemplate(template, outputFile, context, templatesDir) {
+    renderTemplate(template, outputFile, context, _templatesDir) {
         return __awaiter(this, void 0, void 0, function* () {
             this.logInfo(`Rendering: ${template} → ${outputFile}`);
             const content = nunjucks_1.default.render(template, context);

package/js/actions/VersionWriteAction/VersionWriteAction.js

@@ -118,7 +118,7 @@ class VersionWriteAction extends Action_1.Action {
                     }
                     return line;
                 });
-                yield fs_1.promises.writeFile(filePath, updatedLines.join("\n"), "utf8");
+                yield fs_1.promises.writeFile(filePath, updatedLines.join("\n") + "\n", "utf8");
                 this.logInfo(`Version replaced in file "${filePath}" for key "${key}".`);
             }
             catch (error) {
@@ -132,7 +132,7 @@ class VersionWriteAction extends Action_1.Action {
      * @returns A string description of the action.
      */
     describe() {
-        let description = `
+        const description = `
             Replaces a version string in one or more specified files based on
             a key and pattern. Can retrieve the version from package.json or
             set it manually.

package/js/config/actions.config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Defines which actions are considered "core" and will remain in the main
+ * kist package. All other actions should be moved to separate plugin packages.
+ *
+ * Core Actions (Lightweight essentials):
+ * - Directory operations (create, copy, clean)
+ * - File operations (copy, rename)
+ * - Version management
+ * - Template rendering (lightweight)
+ *
+ * Plugin Actions (Move to separate repos):
+ * - StyleProcessingAction -> @kist/action-sass
+ * - TypeScriptCompilerAction -> @kist/action-typescript
+ * - JavaScriptMinifyAction -> @kist/action-terser
+ * - SvgPackagerAction -> @kist/action-svg
+ * - SvgSpriteAction -> @kist/action-svg
+ * - SvgToPngAction -> @kist/action-svg
+ * - SvgReaderAction -> @kist/action-svg
+ * - LintAction -> @kist/action-lint
+ * - DocumentationAction -> @kist/action-docs
+ * - PackageManagerAction -> @kist/action-package-manager
+ * - RunScriptAction -> @kist/action-scripts
+ */
+export declare const CORE_ACTIONS: readonly ["DirectoryCleanAction", "DirectoryCopyAction", "DirectoryCreateAction", "FileCopyAction", "FileRenameAction", "TemplateRenderAction", "VersionWriteAction"];
+export declare const PLUGIN_ACTIONS: readonly ["StyleProcessingAction", "TypeScriptCompilerAction", "JavaScriptMinifyAction", "SvgPackagerAction", "SvgReaderAction", "SvgSpriteAction", "SvgToPngAction", "LintAction", "DocumentationAction", "PackageManagerAction", "RunScriptAction"];
+export type CoreActionName = (typeof CORE_ACTIONS)[number];
+export type PluginActionName = (typeof PLUGIN_ACTIONS)[number];
+/**
+ * Plugin package mappings for migration guide
+ */
+export declare const PLUGIN_PACKAGES: Record<PluginActionName, {
+    package: string;
+    npm: string;
+    github: string;
+}>;

package/js/config/actions.config.js

@@ -0,0 +1,119 @@
+"use strict";
+// ============================================================================
+// Core Actions Configuration
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLUGIN_PACKAGES = exports.PLUGIN_ACTIONS = exports.CORE_ACTIONS = void 0;
+/**
+ * Defines which actions are considered "core" and will remain in the main
+ * kist package. All other actions should be moved to separate plugin packages.
+ *
+ * Core Actions (Lightweight essentials):
+ * - Directory operations (create, copy, clean)
+ * - File operations (copy, rename)
+ * - Version management
+ * - Template rendering (lightweight)
+ *
+ * Plugin Actions (Move to separate repos):
+ * - StyleProcessingAction -> @kist/action-sass
+ * - TypeScriptCompilerAction -> @kist/action-typescript
+ * - JavaScriptMinifyAction -> @kist/action-terser
+ * - SvgPackagerAction -> @kist/action-svg
+ * - SvgSpriteAction -> @kist/action-svg
+ * - SvgToPngAction -> @kist/action-svg
+ * - SvgReaderAction -> @kist/action-svg
+ * - LintAction -> @kist/action-lint
+ * - DocumentationAction -> @kist/action-docs
+ * - PackageManagerAction -> @kist/action-package-manager
+ * - RunScriptAction -> @kist/action-scripts
+ */
+exports.CORE_ACTIONS = [
+    "DirectoryCleanAction",
+    "DirectoryCopyAction",
+    "DirectoryCreateAction",
+    "FileCopyAction",
+    "FileRenameAction",
+    "TemplateRenderAction",
+    "VersionWriteAction",
+];
+exports.PLUGIN_ACTIONS = [
+    // @kist/action-sass
+    "StyleProcessingAction",
+    // @kist/action-typescript
+    "TypeScriptCompilerAction",
+    // @kist/action-terser
+    "JavaScriptMinifyAction",
+    // @kist/action-svg
+    "SvgPackagerAction",
+    "SvgReaderAction",
+    "SvgSpriteAction",
+    "SvgToPngAction",
+    // @kist/action-lint
+    "LintAction",
+    // @kist/action-docs
+    "DocumentationAction",
+    // @kist/action-package-manager
+    "PackageManagerAction",
+    // @kist/action-scripts
+    "RunScriptAction",
+];
+/**
+ * Plugin package mappings for migration guide
+ */
+exports.PLUGIN_PACKAGES = {
+    StyleProcessingAction: {
+        package: "@kist/action-sass",
+        npm: "npm install --save-dev @kist/action-sass",
+        github: "https://github.com/getkist/action-sass",
+    },
+    TypeScriptCompilerAction: {
+        package: "@kist/action-typescript",
+        npm: "npm install --save-dev @kist/action-typescript",
+        github: "https://github.com/getkist/action-typescript",
+    },
+    JavaScriptMinifyAction: {
+        package: "@kist/action-terser",
+        npm: "npm install --save-dev @kist/action-terser",
+        github: "https://github.com/getkist/action-terser",
+    },
+    SvgPackagerAction: {
+        package: "@kist/action-svg",
+        npm: "npm install --save-dev @kist/action-svg",
+        github: "https://github.com/getkist/action-svg",
+    },
+    SvgReaderAction: {
+        package: "@kist/action-svg",
+        npm: "npm install --save-dev @kist/action-svg",
+        github: "https://github.com/getkist/action-svg",
+    },
+    SvgSpriteAction: {
+        package: "@kist/action-svg",
+        npm: "npm install --save-dev @kist/action-svg",
+        github: "https://github.com/getkist/action-svg",
+    },
+    SvgToPngAction: {
+        package: "@kist/action-svg",
+        npm: "npm install --save-dev @kist/action-svg",
+        github: "https://github.com/getkist/action-svg",
+    },
+    LintAction: {
+        package: "@kist/action-lint",
+        npm: "npm install --save-dev @kist/action-lint",
+        github: "https://github.com/getkist/action-lint",
+    },
+    DocumentationAction: {
+        package: "@kist/action-docs",
+        npm: "npm install --save-dev @kist/action-docs",
+        github: "https://github.com/getkist/action-docs",
+    },
+    PackageManagerAction: {
+        package: "@kist/action-package-manager",
+        npm: "npm install --save-dev @kist/action-package-manager",
+        github: "https://github.com/getkist/action-package-manager",
+    },
+    RunScriptAction: {
+        package: "@kist/action-scripts",
+        npm: "npm install --save-dev @kist/action-scripts",
+        github: "https://github.com/getkist/action-scripts",
+    },
+};

package/js/core/config/ConfigLoader.js

@@ -68,7 +68,7 @@ class ConfigLoader extends AbstractProcess_1.AbstractProcess {
                     this.logDebug(`Configuration file found: ${resolvedPath}`);
                     return;
                 }
-                catch (error) {
+                catch (_error) {
                     this.logDebug(`File not accessible: ${resolvedPath}`);
                     // ❗ If user explicitly provided --config and it fails, stop immediately
                     if (cliPath) {
@@ -79,35 +79,6 @@ class ConfigLoader extends AbstractProcess_1.AbstractProcess {
             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/pipeline/Action.d.ts

@@ -28,7 +28,7 @@ export declare abstract class Action extends AbstractProcess implements ActionIn
      * @returns A boolean indicating whether the options are valid. Default
      * implementation always returns true.
      */
-    validateOptions(options: ActionOptionsType): boolean;
+    validateOptions(_options: ActionOptionsType): boolean;
     /**
      * Abstract method that must be implemented by derived classes to perform
      * the action"s main logic.

package/js/core/pipeline/Action.js

@@ -45,7 +45,7 @@ class Action extends AbstractProcess_1.AbstractProcess {
      * @returns A boolean indicating whether the options are valid. Default
      * implementation always returns true.
      */
-    validateOptions(options) {
+    validateOptions(_options) {
         // Default validation: always returns true, can be overridden in
         // derived classes
         return true;

package/js/core/pipeline/ActionRegistry.d.ts

@@ -71,7 +71,11 @@ export declare class ActionRegistry extends AbstractProcess {
      * actions as needed.
      */
     private registerCoreActions;
-    private discoverPlugins;
+    /**
+     * Registers actions from loaded plugins via PluginManager.
+     * This method integrates the plugin system with the action registry.
+     */
+    private registerPluginActions;
     /**
      * Clears all registered actions in the registry.
      * Useful for testing or resetting the pipeline.

package/js/core/pipeline/ActionRegistry.js

@@ -4,10 +4,9 @@
 // ============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActionRegistry = void 0;
-const fs_1 = require("fs");
-const path_1 = require("path");
 const CoreActions_1 = require("../../actions/CoreActions");
 const AbstractProcess_1 = require("../abstract/AbstractProcess");
+const PluginManager_1 = require("../plugin/PluginManager");
 // ============================================================================
 // Class
 // ============================================================================
@@ -30,7 +29,8 @@ class ActionRegistry extends AbstractProcess_1.AbstractProcess {
         this.registry = new Map();
         // Automatically register core actions
         this.registerCoreActions();
-        this.discoverPlugins();
+        // Register plugin actions via PluginManager
+        this.registerPluginActions();
         this.logInfo("ActionRegistry initialized.");
     }
     // Singleton Methods
@@ -135,32 +135,23 @@ class ActionRegistry extends AbstractProcess_1.AbstractProcess {
         });
         this.logInfo("Core actions registered successfully.");
     }
-    discoverPlugins() {
-        this.logInfo("Discovering external plugins...");
-        const nodeModulesPath = (0, path_1.join)(process.cwd(), "node_modules");
-        const pluginPrefix = "@kist/plugin-";
-        try {
-            const directories = (0, fs_1.readdirSync)(nodeModulesPath, {
-                withFileTypes: true,
-            });
-            for (const dir of directories) {
-                if (dir.isDirectory() && dir.name.startsWith(pluginPrefix)) {
-                    const pluginPath = (0, path_1.join)(nodeModulesPath, dir.name);
-                    const plugin = require(pluginPath).default;
-                    if (plugin &&
-                        typeof plugin.registerActions === "function") {
-                        const actions = plugin.registerActions();
-                        for (const [name, actionClass] of Object.entries(actions)) {
-                            this.registerAction(actionClass);
-                        }
-                    }
-                }
+    /**
+     * Registers actions from loaded plugins via PluginManager.
+     * This method integrates the plugin system with the action registry.
+     */
+    registerPluginActions() {
+        const pluginManager = PluginManager_1.PluginManager.getInstance();
+        const pluginActions = pluginManager.getPluginActions();
+        for (const [actionName, actionClass] of pluginActions.entries()) {
+            try {
+                this.registerAction(actionClass);
+                this.logDebug(`Registered plugin action: ${actionName}`);
+            }
+            catch (error) {
+                this.logError(`Failed to register plugin action ${actionName}:`, error);
             }
-            this.logInfo("Plugins loaded successfully.");
-        }
-        catch (error) {
-            this.logError("Failed to discover plugins.", error);
         }
+        this.logInfo(`Registered ${pluginActions.size} actions from plugins.`);
     }
     /**
      * Clears all registered actions in the registry.

package/js/core/pipeline/Step.js

@@ -44,7 +44,7 @@ class Step extends AbstractProcess_1.AbstractProcess {
         // const ActionClass = actionRegistry.getAction(step.action.name);
         const ActionClass = actionRegistry.getAction(String(step.action));
         if (!ActionClass) {
-            let msg = `
+            const msg = `
                 Unknown action "${step.action}" for step "${this.name}".
                 Ensure the action is registered in the registry.
                 `;

package/js/core/plugin/PluginManager.d.ts

@@ -0,0 +1,70 @@
+import { ActionInterface } from "../../interface/ActionInterface";
+import { ActionPlugin } from "../../interface/ActionPlugin";
+import { PluginMetadata } from "../../interface/PluginMetadata";
+import { AbstractProcess } from "../abstract/AbstractProcess";
+/**
+ * PluginManager handles discovery, loading, and lifecycle of kist plugins.
+ * Supports both npm-installed plugins (@kist/plugin-*) and local plugins.
+ */
+export declare class PluginManager extends AbstractProcess {
+    private static instance;
+    private loadedPlugins;
+    private pluginActions;
+    private constructor();
+    static getInstance(): PluginManager;
+    static resetInstance(): void;
+    /**
+     * Discovers and loads all available plugins from:
+     * - node_modules/@kist/plugin-*
+     * - node_modules/kist-plugin-*
+     * - Local plugins directory (if configured)
+     */
+    discoverPlugins(options?: {
+        localPluginsPath?: string;
+        pluginPrefixes?: string[];
+    }): Promise<void>;
+    /**
+     * Discovers plugins installed via npm with specified prefixes
+     */
+    private discoverNpmPlugins;
+    /**
+     * Discovers plugins in scoped packages (@kist/*)
+     */
+    private discoverScopedPlugins;
+    /**
+     * Discovers plugins from a local directory
+     */
+    private discoverLocalPlugins;
+    /**
+     * Loads a single plugin from the specified path
+     */
+    private loadPlugin;
+    /**
+     * Manually register a plugin programmatically
+     */
+    registerPlugin(plugin: ActionPlugin, name: string): void;
+    /**
+     * Gets all actions from loaded plugins
+     */
+    getPluginActions(): Map<string, new () => ActionInterface>;
+    /**
+     * Gets metadata for all loaded plugins
+     */
+    getLoadedPlugins(): PluginMetadata[];
+    /**
+     * Gets metadata for a specific plugin
+     */
+    getPluginMetadata(name: string): PluginMetadata | undefined;
+    /**
+     * Checks if a specific plugin is loaded
+     */
+    isPluginLoaded(name: string): boolean;
+    /**
+     * Lists all action names from plugins
+     */
+    listPluginActions(): string[];
+    /**
+     * Clears all loaded plugins and their actions
+     */
+    clearPlugins(): void;
+}