kist 0.1.57 → 0.1.59

package/js/actions/CoreActions.d.ts

@@ -2,5 +2,17 @@ import { ActionInterface } from "../interface/ActionInterface";
 /**
  * A record of core actions, mapped by their unique `name` property.
  * Automatically derives names from the action classes.
+ *
+ * Note: Additional actions are available in separate @getkist/action-* packages:
+ * - @getkist/action-eslint - ESLint linting
+ * - @getkist/action-jest - Jest test runner
+ * - @getkist/action-nunjucks - Nunjucks/Jinja templating
+ * - @getkist/action-postcss - PostCSS processing
+ * - @getkist/action-prettier - Prettier formatting
+ * - @getkist/action-sass - SASS/SCSS compilation
+ * - @getkist/action-svg - SVG sprite generation and optimization
+ * - @getkist/action-terser - JavaScript minification
+ * - @getkist/action-tsdown - tsdown bundling
+ * - @getkist/action-tsup - tsup bundling
  */
 export declare const coreActions: Record<string, new () => ActionInterface>;

package/js/actions/CoreActions.js

@@ -10,16 +10,8 @@ const DirectoryCreateAction_1 = require("../actions/DirectoryCreateAction");
 const DocumentationAction_1 = require("../actions/DocumentationAction");
 const FileCopyAction_1 = require("../actions/FileCopyAction");
 const FileRenameAction_1 = require("../actions/FileRenameAction");
-const JavaScriptMinifyAction_1 = require("../actions/JavaScriptMinifyAction");
-const LintAction_1 = require("../actions/LintAction");
 const PackageManagerAction_1 = require("../actions/PackageManagerAction");
 const RunScriptAction_1 = require("../actions/RunScriptAction");
-const StyleProcessingAction_1 = require("../actions/StyleProcessingAction");
-const SvgPackagerAction_1 = require("../actions/SvgPackagerAction");
-const SvgReaderAction_1 = require("../actions/SvgReaderAction");
-const SvgSpriteAction_1 = require("../actions/SvgSpriteAction");
-const SvgToPngAction_1 = require("../actions/SvgToPngAction");
-const TemplateRenderAction_1 = require("../actions/TemplateRenderAction");
 const TypeScriptCompilerAction_1 = require("../actions/TypeScriptCompilerAction");
 const VersionWriteAction_1 = require("../actions/VersionWriteAction");
 // ============================================================================
@@ -28,6 +20,18 @@ const VersionWriteAction_1 = require("../actions/VersionWriteAction");
 /**
  * A record of core actions, mapped by their unique `name` property.
  * Automatically derives names from the action classes.
+ *
+ * Note: Additional actions are available in separate @getkist/action-* packages:
+ * - @getkist/action-eslint - ESLint linting
+ * - @getkist/action-jest - Jest test runner
+ * - @getkist/action-nunjucks - Nunjucks/Jinja templating
+ * - @getkist/action-postcss - PostCSS processing
+ * - @getkist/action-prettier - Prettier formatting
+ * - @getkist/action-sass - SASS/SCSS compilation
+ * - @getkist/action-svg - SVG sprite generation and optimization
+ * - @getkist/action-terser - JavaScript minification
+ * - @getkist/action-tsdown - tsdown bundling
+ * - @getkist/action-tsup - tsup bundling
  */
 exports.coreActions = {
     [new DirectoryCleanAction_1.DirectoryCleanAction().name]: DirectoryCleanAction_1.DirectoryCleanAction,
@@ -36,16 +40,8 @@ exports.coreActions = {
     [new DocumentationAction_1.DocumentationAction().name]: DocumentationAction_1.DocumentationAction,
     [new FileCopyAction_1.FileCopyAction().name]: FileCopyAction_1.FileCopyAction,
     [new FileRenameAction_1.FileRenameAction().name]: FileRenameAction_1.FileRenameAction,
-    [new JavaScriptMinifyAction_1.JavaScriptMinifyAction().name]: JavaScriptMinifyAction_1.JavaScriptMinifyAction,
-    [new LintAction_1.LintAction().name]: LintAction_1.LintAction,
     [new PackageManagerAction_1.PackageManagerAction().name]: PackageManagerAction_1.PackageManagerAction,
     [new RunScriptAction_1.RunScriptAction().name]: RunScriptAction_1.RunScriptAction,
-    [new StyleProcessingAction_1.StyleProcessingAction().name]: StyleProcessingAction_1.StyleProcessingAction,
-    [new SvgPackagerAction_1.SvgPackagerAction().name]: SvgPackagerAction_1.SvgPackagerAction,
-    [new SvgReaderAction_1.SvgReaderAction().name]: SvgReaderAction_1.SvgReaderAction,
-    [new SvgSpriteAction_1.SvgSpriteAction().name]: SvgSpriteAction_1.SvgSpriteAction,
-    [new SvgToPngAction_1.SvgToPngAction().name]: SvgToPngAction_1.SvgToPngAction,
-    [new TemplateRenderAction_1.TemplateRenderAction().name]: TemplateRenderAction_1.TemplateRenderAction,
     [new TypeScriptCompilerAction_1.TypeScriptCompilerAction().name]: TypeScriptCompilerAction_1.TypeScriptCompilerAction,
     [new VersionWriteAction_1.VersionWriteAction().name]: VersionWriteAction_1.VersionWriteAction,
 };

package/js/actions/FileCopyAction/FileCopyAction.d.ts

@@ -5,8 +5,15 @@ import { ActionOptionsType } from "../../types/ActionOptionsType";
  * location to a destination directory. This action handles file path
  * resolution and ensures that existing files in the destination can be
  * replaced if necessary.
+ *
+ * Performance features:
+ * - Uses streaming for large files to reduce memory usage
+ * - Supports file caching to skip unchanged files
+ * - Parallel batch copy support
  */
 export declare class FileCopyAction extends Action {
+    private fileCache;
+    constructor();
     /**
      * Executes the file copy action.
      * @param options - The options specific to file copying, including source
@@ -15,10 +22,21 @@ export declare class FileCopyAction extends Action {
      * copied, or rejects with an error if the action fails.
      */
     execute(options: ActionOptionsType): Promise<void>;
+    /**
+     * Copies a single file with optional caching.
+     */
+    private copySingleFile;
+    /**
+     * Copies multiple files with optional parallel execution.
+     */
+    private copyMultipleFiles;
+    /**
+     * Copies files in parallel with concurrency control.
+     */
+    private copyFilesInParallel;
     /**
      * Copies a file from a specified source to a destination directory.
-     * Handles file path resolution and ensures the destination directory
-     * exists.
+     * Uses streaming for large files to reduce memory usage.
      *
      * @param srcFile - The path of the source file to be copied.
      * @param destDir - The destination directory where the file should
@@ -29,6 +47,10 @@ export declare class FileCopyAction extends Action {
      * permission errors or the source file not existing.
      */
     private copyFileToDirectory;
+    /**
+     * Copies a file using streams for memory-efficient handling of large files.
+     */
+    private streamCopyFile;
     /**
      * Ensures that the given directory exists, creating it if it does not.
      * @param dirPath - The path of the directory to check and create.

package/js/actions/FileCopyAction/FileCopyAction.js

@@ -18,7 +18,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileCopyAction = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const promises_1 = require("stream/promises");
 const Action_1 = require("../../core/pipeline/Action");
+const FileCache_1 = require("../../core/cache/FileCache");
+// ============================================================================
+// Constants
+// ============================================================================
+/** Threshold for using streaming copy (5MB) */
+const STREAMING_THRESHOLD = 5 * 1024 * 1024;
 // ============================================================================
 // Classes
 // ============================================================================
@@ -27,12 +34,19 @@ const Action_1 = require("../../core/pipeline/Action");
  * location to a destination directory. This action handles file path
  * resolution and ensures that existing files in the destination can be
  * replaced if necessary.
+ *
+ * Performance features:
+ * - Uses streaming for large files to reduce memory usage
+ * - Supports file caching to skip unchanged files
+ * - Parallel batch copy support
  */
 class FileCopyAction extends Action_1.Action {
-    // Parameters
-    // ========================================================================
     // Constructor
     // ========================================================================
+    constructor() {
+        super();
+        this.fileCache = FileCache_1.FileCache.getInstance();
+    }
     // Methods
     // ========================================================================
     /**
@@ -45,13 +59,44 @@ class FileCopyAction extends Action_1.Action {
     execute(options) {
         return __awaiter(this, void 0, void 0, function* () {
             const srcFile = options.srcFile;
+            const srcFiles = options.srcFiles;
             const destDir = options.destDir;
-            if (!srcFile || !destDir) {
-                throw new Error("Missing required options: srcFile or destDir.");
+            const useCache = options.useCache;
+            const parallel = options.parallel;
+            if ((!srcFile && !srcFiles) || !destDir) {
+                throw new Error("Missing required options: srcFile/srcFiles or destDir.");
+            }
+            // Handle batch copy
+            if (srcFiles && srcFiles.length > 0) {
+                yield this.copyMultipleFiles(srcFiles, destDir, { useCache, parallel });
+                return;
+            }
+            // Handle single file copy
+            if (srcFile) {
+                yield this.copySingleFile(srcFile, destDir, { useCache });
+            }
+        });
+    }
+    /**
+     * Copies a single file with optional caching.
+     */
+    copySingleFile(srcFile_1, destDir_1) {
+        return __awaiter(this, arguments, void 0, function* (srcFile, destDir, options = {}) {
+            // Check cache if enabled
+            if (options.useCache) {
+                const hasChanged = yield this.fileCache.hasFileChanged(srcFile);
+                if (!hasChanged) {
+                    this.logDebug(`Skipping unchanged file: ${srcFile}`);
+                    return;
+                }
             }
             this.logInfo(`Copying file from ${srcFile} to ${destDir}.`);
             try {
                 yield this.copyFileToDirectory(srcFile, destDir);
+                // Update cache
+                if (options.useCache) {
+                    yield this.fileCache.updateFileEntry(srcFile);
+                }
                 this.logInfo(`File copied successfully from ${srcFile} to ${destDir}.`);
             }
             catch (error) {
@@ -60,10 +105,70 @@ class FileCopyAction extends Action_1.Action {
             }
         });
     }
+    /**
+     * Copies multiple files with optional parallel execution.
+     */
+    copyMultipleFiles(srcFiles_1, destDir_1) {
+        return __awaiter(this, arguments, void 0, function* (srcFiles, destDir, options = {}) {
+            const startTime = performance.now();
+            let filesToCopy = srcFiles;
+            // Filter unchanged files if caching is enabled
+            if (options.useCache) {
+                filesToCopy = yield this.fileCache.getChangedFiles(srcFiles);
+                const skipped = srcFiles.length - filesToCopy.length;
+                if (skipped > 0) {
+                    this.logInfo(`Skipping ${skipped} unchanged files.`);
+                }
+            }
+            if (filesToCopy.length === 0) {
+                this.logInfo("All files are up to date, nothing to copy.");
+                return;
+            }
+            this.logInfo(`Copying ${filesToCopy.length} files to ${destDir}.`);
+            try {
+                if (options.parallel) {
+                    // Parallel copy with concurrency limit
+                    yield this.copyFilesInParallel(filesToCopy, destDir, 10);
+                }
+                else {
+                    // Sequential copy
+                    for (const file of filesToCopy) {
+                        yield this.copyFileToDirectory(file, destDir);
+                    }
+                }
+                // Update cache for all copied files
+                if (options.useCache) {
+                    yield this.fileCache.updateFileEntries(filesToCopy);
+                }
+                const duration = performance.now() - startTime;
+                this.logInfo(`Copied ${filesToCopy.length} files in ${duration.toFixed(2)}ms.`);
+            }
+            catch (error) {
+                this.logError(`Error copying files: ${error}`);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Copies files in parallel with concurrency control.
+     */
+    copyFilesInParallel(srcFiles_1, destDir_1) {
+        return __awaiter(this, arguments, void 0, function* (srcFiles, destDir, maxConcurrent = 10) {
+            const executing = new Set();
+            for (const srcFile of srcFiles) {
+                const copyPromise = this.copyFileToDirectory(srcFile, destDir)
+                    .finally(() => executing.delete(copyPromise));
+                executing.add(copyPromise);
+                if (executing.size >= maxConcurrent) {
+                    yield Promise.race(executing);
+                }
+            }
+            yield Promise.all(executing);
+        });
+    }
     /**
      * Copies a file from a specified source to a destination directory.
-     * Handles file path resolution and ensures the destination directory
-     * exists.
+     * Uses streaming for large files to reduce memory usage.
      *
      * @param srcFile - The path of the source file to be copied.
      * @param destDir - The destination directory where the file should
@@ -81,8 +186,16 @@ class FileCopyAction extends Action_1.Action {
                 // Resolve the destination file path
                 const fileName = path_1.default.basename(srcFile);
                 const destFilePath = path_1.default.join(destDir, fileName);
-                // Copy the file
-                yield fs_1.default.promises.copyFile(srcFile, destFilePath);
+                // Check file size to determine copy method
+                const stat = yield fs_1.default.promises.stat(srcFile);
+                if (stat.size > STREAMING_THRESHOLD) {
+                    // Use streaming for large files
+                    yield this.streamCopyFile(srcFile, destFilePath);
+                }
+                else {
+                    // Use standard copy for smaller files
+                    yield fs_1.default.promises.copyFile(srcFile, destFilePath);
+                }
             }
             catch (error) {
                 this.logError(`Error copying file: ${error}`);
@@ -90,6 +203,16 @@ class FileCopyAction extends Action_1.Action {
             }
         });
     }
+    /**
+     * Copies a file using streams for memory-efficient handling of large files.
+     */
+    streamCopyFile(srcFile, destFile) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const readStream = fs_1.default.createReadStream(srcFile);
+            const writeStream = fs_1.default.createWriteStream(destFile);
+            yield (0, promises_1.pipeline)(readStream, writeStream);
+        });
+    }
     /**
      * Ensures that the given directory exists, creating it if it does not.
      * @param dirPath - The path of the directory to check and create.

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

@@ -1,34 +1,33 @@
 /**
- * Defines which actions are considered "core" and will remain in the main
- * kist package. All other actions should be moved to separate plugin packages.
+ * Defines which actions are in the main kist package vs. separate plugins.
  *
- * Core Actions (Lightweight essentials):
+ * Core Actions (in main kist package):
  * - Directory operations (create, copy, clean)
  * - File operations (copy, rename)
  * - Version management
- * - Template rendering (lightweight)
+ * - TypeScript compilation
+ * - Documentation generation
+ * - Package management
+ * - Script running
  *
- * 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
+ * Migrated to Plugin Packages:
+ * - StyleProcessingAction -> @getkist/action-sass
+ * - JavaScriptMinifyAction -> @getkist/action-terser
+ * - SvgPackagerAction -> @getkist/action-svg
+ * - SvgSpriteAction -> @getkist/action-svg
+ * - SvgToPngAction -> @getkist/action-svg
+ * - SvgReaderAction -> @getkist/action-svg
+ * - LintAction -> @getkist/action-eslint
+ * - TemplateRenderAction -> @getkist/action-nunjucks
  */
-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 declare const CORE_ACTIONS: readonly ["DirectoryCleanAction", "DirectoryCopyAction", "DirectoryCreateAction", "DocumentationAction", "FileCopyAction", "FileRenameAction", "PackageManagerAction", "RunScriptAction", "TypeScriptCompilerAction", "VersionWriteAction"];
+export declare const MIGRATED_ACTIONS: readonly ["StyleProcessingAction", "JavaScriptMinifyAction", "SvgPackagerAction", "SvgReaderAction", "SvgSpriteAction", "SvgToPngAction", "LintAction", "TemplateRenderAction"];
 export type CoreActionName = (typeof CORE_ACTIONS)[number];
-export type PluginActionName = (typeof PLUGIN_ACTIONS)[number];
+export type MigratedActionName = (typeof MIGRATED_ACTIONS)[number];
 /**
- * Plugin package mappings for migration guide
+ * Plugin package mappings - use these packages for the migrated actions
  */
-export declare const PLUGIN_PACKAGES: Record<PluginActionName, {
+export declare const MIGRATED_PACKAGES: Record<MigratedActionName, {
     package: string;
     npm: string;
     github: string;

package/js/config/actions.config.js

@@ -3,117 +3,98 @@
 // Core Actions Configuration
 // ============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PLUGIN_PACKAGES = exports.PLUGIN_ACTIONS = exports.CORE_ACTIONS = void 0;
+exports.MIGRATED_PACKAGES = exports.MIGRATED_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.
+ * Defines which actions are in the main kist package vs. separate plugins.
  *
- * Core Actions (Lightweight essentials):
+ * Core Actions (in main kist package):
  * - Directory operations (create, copy, clean)
  * - File operations (copy, rename)
  * - Version management
- * - Template rendering (lightweight)
+ * - TypeScript compilation
+ * - Documentation generation
+ * - Package management
+ * - Script running
  *
- * 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
+ * Migrated to Plugin Packages:
+ * - StyleProcessingAction -> @getkist/action-sass
+ * - JavaScriptMinifyAction -> @getkist/action-terser
+ * - SvgPackagerAction -> @getkist/action-svg
+ * - SvgSpriteAction -> @getkist/action-svg
+ * - SvgToPngAction -> @getkist/action-svg
+ * - SvgReaderAction -> @getkist/action-svg
+ * - LintAction -> @getkist/action-eslint
+ * - TemplateRenderAction -> @getkist/action-nunjucks
  */
 exports.CORE_ACTIONS = [
     "DirectoryCleanAction",
     "DirectoryCopyAction",
     "DirectoryCreateAction",
+    "DocumentationAction",
     "FileCopyAction",
     "FileRenameAction",
-    "TemplateRenderAction",
+    "PackageManagerAction",
+    "RunScriptAction",
+    "TypeScriptCompilerAction",
     "VersionWriteAction",
 ];
-exports.PLUGIN_ACTIONS = [
-    // @kist/action-sass
+exports.MIGRATED_ACTIONS = [
+    // @getkist/action-sass
     "StyleProcessingAction",
-    // @kist/action-typescript
-    "TypeScriptCompilerAction",
-    // @kist/action-terser
+    // @getkist/action-terser
     "JavaScriptMinifyAction",
-    // @kist/action-svg
+    // @getkist/action-svg
     "SvgPackagerAction",
     "SvgReaderAction",
     "SvgSpriteAction",
     "SvgToPngAction",
-    // @kist/action-lint
+    // @getkist/action-eslint
     "LintAction",
-    // @kist/action-docs
-    "DocumentationAction",
-    // @kist/action-package-manager
-    "PackageManagerAction",
-    // @kist/action-scripts
-    "RunScriptAction",
+    // @getkist/action-nunjucks
+    "TemplateRenderAction",
 ];
 /**
- * Plugin package mappings for migration guide
+ * Plugin package mappings - use these packages for the migrated actions
  */
-exports.PLUGIN_PACKAGES = {
+exports.MIGRATED_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",
+        package: "@getkist/action-sass",
+        npm: "npm install --save-dev @getkist/action-sass",
+        github: "https://github.com/getkist/kist-action-sass",
     },
     JavaScriptMinifyAction: {
-        package: "@kist/action-terser",
-        npm: "npm install --save-dev @kist/action-terser",
-        github: "https://github.com/getkist/action-terser",
+        package: "@getkist/action-terser",
+        npm: "npm install --save-dev @getkist/action-terser",
+        github: "https://github.com/getkist/kist-action-terser",
     },
     SvgPackagerAction: {
-        package: "@kist/action-svg",
-        npm: "npm install --save-dev @kist/action-svg",
-        github: "https://github.com/getkist/action-svg",
+        package: "@getkist/action-svg",
+        npm: "npm install --save-dev @getkist/action-svg",
+        github: "https://github.com/getkist/kist-action-svg",
     },
     SvgReaderAction: {
-        package: "@kist/action-svg",
-        npm: "npm install --save-dev @kist/action-svg",
-        github: "https://github.com/getkist/action-svg",
+        package: "@getkist/action-svg",
+        npm: "npm install --save-dev @getkist/action-svg",
+        github: "https://github.com/getkist/kist-action-svg",
     },
     SvgSpriteAction: {
-        package: "@kist/action-svg",
-        npm: "npm install --save-dev @kist/action-svg",
-        github: "https://github.com/getkist/action-svg",
+        package: "@getkist/action-svg",
+        npm: "npm install --save-dev @getkist/action-svg",
+        github: "https://github.com/getkist/kist-action-svg",
     },
     SvgToPngAction: {
-        package: "@kist/action-svg",
-        npm: "npm install --save-dev @kist/action-svg",
-        github: "https://github.com/getkist/action-svg",
+        package: "@getkist/action-svg",
+        npm: "npm install --save-dev @getkist/action-svg",
+        github: "https://github.com/getkist/kist-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",
+        package: "@getkist/action-eslint",
+        npm: "npm install --save-dev @getkist/action-eslint",
+        github: "https://github.com/getkist/kist-action-eslint",
     },
-    RunScriptAction: {
-        package: "@kist/action-scripts",
-        npm: "npm install --save-dev @kist/action-scripts",
-        github: "https://github.com/getkist/action-scripts",
+    TemplateRenderAction: {
+        package: "@getkist/action-nunjucks",
+        npm: "npm install --save-dev @getkist/action-nunjucks",
+        github: "https://github.com/getkist/kist-action-nunjucks",
     },
 };