kist 0.0.0 → 0.1.31

package/js/actions/FileRenameAction/FileRenameAction.js

@@ -0,0 +1,84 @@
+"use strict";
+// ============================================================================
+// Import
+// ============================================================================
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileRenameAction = void 0;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const Action_1 = require("../../core/pipeline/Action");
+// ============================================================================
+// Classes
+// ============================================================================
+/**
+ * FileRenameAction handles renaming files within the file system.
+ * Ensures that file renaming operations are handled efficiently and safely.
+ */
+class FileRenameAction extends Action_1.Action {
+    /**
+     * Executes the file renaming action.
+     *
+     * @param options - The options specifying the source and target file paths.
+     * @returns A Promise that resolves when the file has been successfully renamed.
+     * @throws {Error} If the source file does not exist or cannot be renamed.
+     */
+    execute(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { srcPath, targetPath } = options;
+            if (!srcPath || !targetPath) {
+                throw new Error("Invalid options: 'srcPath' and 'targetPath' are required.");
+            }
+            this.logInfo(`Renaming file: ${srcPath} → ${targetPath}`);
+            try {
+                yield this.renameFile(srcPath, targetPath);
+                this.logInfo(`File successfully renamed to ${targetPath}`);
+            }
+            catch (error) {
+                this.logError("Failed to rename file.", error);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Renames a file from its current path to a new path.
+     *
+     * @param srcPath - The current file path.
+     * @param targetPath - The new file path.
+     * @returns A Promise that resolves once the file is successfully renamed.
+     */
+    renameFile(srcPath, targetPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const resolvedSrcPath = path_1.default.resolve(srcPath);
+                const resolvedTargetPath = path_1.default.resolve(targetPath);
+                yield fs_1.promises.rename(resolvedSrcPath, resolvedTargetPath);
+                this.logDebug(`File renamed: ${resolvedSrcPath} → ${resolvedTargetPath}`);
+            }
+            catch (error) {
+                this.logError(`Error renaming file: ${srcPath} → ${targetPath}`, error);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Provides a description of the action.
+     *
+     * @returns A string description of the action.
+     */
+    describe() {
+        return "Renames a file from a specified source path to a target path.";
+    }
+}
+exports.FileRenameAction = FileRenameAction;

package/js/actions/FileRenameAction/index.d.ts

@@ -0,0 +1,2 @@
+import { FileRenameAction } from "./FileRenameAction";
+export { FileRenameAction };

package/js/actions/FileRenameAction/index.js

@@ -0,0 +1,8 @@
+"use strict";
+// ============================================================================
+// Import
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileRenameAction = void 0;
+const FileRenameAction_1 = require("./FileRenameAction");
+Object.defineProperty(exports, "FileRenameAction", { enumerable: true, get: function () { return FileRenameAction_1.FileRenameAction; } });

package/js/actions/JavaScriptMinifyAction/JavaScriptMinifyAction.d.ts

@@ -0,0 +1,31 @@
+import { Action } from "../../core/pipeline/Action";
+import { ActionOptionsType } from "../../types/ActionOptionsType";
+/**
+ * JavaScriptMinifyAction handles the minification of JavaScript files.
+ * Uses Terser to reduce file size and optimize performance.
+ */
+export declare class JavaScriptMinifyAction extends Action {
+    /**
+     * Executes the JavaScript minification action.
+     *
+     * @param options - The options containing input and output file paths.
+     * @returns A Promise that resolves when the minification process completes.
+     * @throws {Error} If input file is missing, minification fails, or output cannot be written.
+     */
+    execute(options: ActionOptionsType): Promise<void>;
+    /**
+     * Minifies a JavaScript file using Terser.
+     *
+     * @param inputPath - Path to the input JavaScript file.
+     * @param outputPath - Path where the minified file will be saved.
+     * @param customConfig - Custom Terser configuration.
+     * @returns A Promise that resolves when the minification is complete.
+     */
+    private minifyFile;
+    /**
+     * Provides a description of the action.
+     *
+     * @returns A string description of the action.
+     */
+    describe(): string;
+}

package/js/actions/JavaScriptMinifyAction/JavaScriptMinifyAction.js

@@ -0,0 +1,98 @@
+"use strict";
+// ============================================================================
+// Import
+// ============================================================================
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JavaScriptMinifyAction = void 0;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const terser_1 = require("terser");
+const Action_1 = require("../../core/pipeline/Action");
+const terser_config_js_1 = __importDefault(require("./terser.config.js"));
+// ============================================================================
+// Classes
+// ============================================================================
+/**
+ * JavaScriptMinifyAction handles the minification of JavaScript files.
+ * Uses Terser to reduce file size and optimize performance.
+ */
+class JavaScriptMinifyAction extends Action_1.Action {
+    /**
+     * Executes the JavaScript minification action.
+     *
+     * @param options - The options containing input and output file paths.
+     * @returns A Promise that resolves when the minification process completes.
+     * @throws {Error} If input file is missing, minification fails, or output cannot be written.
+     */
+    execute(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { inputPath, outputPath, customConfig = {} } = options;
+            if (!inputPath || !outputPath) {
+                throw new Error("Invalid options: 'inputPath' and 'outputPath' are required.");
+            }
+            this.logInfo(`Minifying JavaScript file: ${inputPath} → ${outputPath}`);
+            try {
+                yield this.minifyFile(inputPath, outputPath, customConfig);
+                this.logInfo(`JavaScript minification completed: ${outputPath}`);
+            }
+            catch (error) {
+                this.logError("JavaScript minification failed.", error);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Minifies a JavaScript file using Terser.
+     *
+     * @param inputPath - Path to the input JavaScript file.
+     * @param outputPath - Path where the minified file will be saved.
+     * @param customConfig - Custom Terser configuration.
+     * @returns A Promise that resolves when the minification is complete.
+     */
+    minifyFile(inputPath, outputPath, customConfig) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            try {
+                const resolvedInputPath = path_1.default.resolve(inputPath);
+                const resolvedOutputPath = path_1.default.resolve(outputPath);
+                // Read JavaScript file
+                const inputCode = yield fs_1.promises.readFile(resolvedInputPath, "utf8");
+                // Merge Terser configuration with explicit type casting
+                const terserOptions = Object.assign(Object.assign(Object.assign({}, terser_config_js_1.default), customConfig), { ecma: terser_config_js_1.default.ecma, nameCache: (_a = terser_config_js_1.default.nameCache) !== null && _a !== void 0 ? _a : undefined });
+                // Minify using Terser
+                const result = yield (0, terser_1.minify)(inputCode, terserOptions);
+                if (!result.code) {
+                    throw new Error("Minification resulted in empty output.");
+                }
+                // Write minified file
+                yield fs_1.promises.writeFile(resolvedOutputPath, result.code, "utf8");
+                this.logDebug(`Minified JavaScript file saved to ${resolvedOutputPath}`);
+            }
+            catch (error) {
+                this.logError(`Error minifying JavaScript file: ${inputPath}`, error);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Provides a description of the action.
+     *
+     * @returns A string description of the action.
+     */
+    describe() {
+        return "Minifies JavaScript files using Terser to reduce size and optimize performance.";
+    }
+}
+exports.JavaScriptMinifyAction = JavaScriptMinifyAction;

package/js/actions/JavaScriptMinifyAction/index.d.ts

@@ -0,0 +1,2 @@
+import { JavaScriptMinifyAction } from "./JavaScriptMinifyAction";
+export { JavaScriptMinifyAction };

package/js/actions/JavaScriptMinifyAction/index.js

@@ -0,0 +1,8 @@
+"use strict";
+// ============================================================================
+// Import
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JavaScriptMinifyAction = void 0;
+const JavaScriptMinifyAction_1 = require("./JavaScriptMinifyAction");
+Object.defineProperty(exports, "JavaScriptMinifyAction", { enumerable: true, get: function () { return JavaScriptMinifyAction_1.JavaScriptMinifyAction; } });

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

@@ -0,0 +1,27 @@
+declare const terserConfig: {
+    parse: {};
+    compress: {
+        drop_console: boolean;
+        drop_debugger: boolean;
+        pure_funcs: string[];
+        arrows: boolean;
+    };
+    mangle: {
+        properties: boolean;
+    };
+    format: {
+        comments: boolean;
+        beautify: boolean;
+    };
+    sourceMap: {};
+    ecma: number;
+    enclose: boolean;
+    keep_classnames: boolean;
+    keep_fnames: boolean;
+    ie8: boolean;
+    module: boolean;
+    nameCache: null;
+    safari10: boolean;
+    toplevel: boolean;
+};
+export default terserConfig;

package/js/actions/JavaScriptMinifyAction/terser.config.js

@@ -0,0 +1,119 @@
+"use strict";
+// ============================================================================
+// Import
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+// ============================================================================
+// Constants
+// ============================================================================
+// https://terser.org/docs/api-reference/
+const terserConfig = {
+    parse: {
+    // parse options
+    },
+    compress: {
+        // compress options
+        drop_console: true, // Remove console.log statements
+        drop_debugger: true, // Remove debugger statements
+        pure_funcs: ["console.info", "console.debug", "console.warn"], // Remove specific console functions
+        // defaults (default: true) -- Pass false to disable most default enabled compress transforms. Useful when you only want to enable a few compress options while disabling the rest.
+        // Class and object literal methods are converted will also be
+        // converted to arrow expressions if the resultant code is shorter:
+        // m(){return x} becomes m:()=>x. To do this to regular ES5 functions
+        // which don't use this or arguments, see unsafe_arrows.
+        arrows: true, // (default: true)
+        // arguments (default: false) -- replace arguments[index] with function parameter name whenever possible.
+        // booleans (default: true) -- various optimizations for boolean context, for example !!a ? b : c → a ? b : c
+        // booleans_as_integers (default: false) -- Turn booleans into 0 and 1, also makes comparisons with booleans use == and != instead of === and !==.
+        // collapse_vars (default: true) -- Collapse single-use non-constant variables, side effects permitting.
+        // comparisons (default: true) -- apply certain optimizations to binary nodes, e.g. !(a <= b) → a > b (only when unsafe_comps), attempts to negate binary nodes, e.g. a = !b && !c && !d && !e → a=!(b||c||d||e) etc. Note: comparisons works best with lhs_constants enabled.
+        // computed_props (default: true) -- Transforms constant computed properties into regular ones: {["computed"]: 1} is converted to {computed: 1}.
+        // conditionals (default: true) -- apply optimizations for if-s and conditional expressions
+        // dead_code (default: true) -- remove unreachable code
+        // directives (default: true) -- remove redundant or non-standard directives
+        // drop_console (default: false) -- Pass true to discard calls to console.* functions. If you only want to discard a portion of console, you can pass an array like this ['log', 'info'], which will only discard console.log、 console.info.
+        // drop_debugger (default: true) -- remove debugger; statements
+        // ecma (default: 5) -- Pass 2015 or greater to enable compress options that will transform ES5 code into smaller ES6+ equivalent forms.
+        // evaluate (default: true) -- attempt to evaluate constant expressions
+        // expression (default: false) -- Pass true to preserve completion values from terminal statements without return, e.g. in bookmarklets.
+        // global_defs (default: {}) -- see conditional compilation
+        // hoist_funs (default: false) -- hoist function declarations
+        // hoist_props (default: true) -- hoist properties from constant object and array literals into regular variables subject to a set of constraints. For example: var o={p:1, q:2}; f(o.p, o.q); is converted to f(1, 2);. Note: hoist_props works best with mangle enabled, the compress option passes set to 2 or higher, and the compress option toplevel enabled.
+        // hoist_vars (default: false) -- hoist var declarations (this is false by default because it seems to increase the size of the output in general)
+        // if_return (default: true) -- optimizations for if/return and if/continue
+        // inline (default: true) -- inline calls to function with simple/return statement:
+        // false -- same as 0
+        // 0 -- disabled inlining
+        // 1 -- inline simple functions
+        // 2 -- inline functions with arguments
+        // 3 -- inline functions with arguments and variables
+        // true -- same as 3
+        // join_vars (default: true) -- join consecutive var, let and const statements
+        // keep_classnames (default: false) -- Pass true to prevent the compressor from discarding class names. Pass a regular expression to only keep class names matching that regex. See also: the keep_classnames mangle option.
+        // keep_fargs (default: true) -- Prevents the compressor from discarding unused function arguments. You need this for code which relies on Function.length.
+        // keep_fnames (default: false) -- Pass true to prevent the compressor from discarding function names. Pass a regular expression to only keep function names matching that regex. Useful for code relying on Function.prototype.name. See also: the keep_fnames mangle option.
+        // keep_infinity (default: false) -- Pass true to prevent Infinity from being compressed into 1/0, which may cause performance issues on Chrome.
+        // lhs_constants (default: true) -- Moves constant values to the left-hand side of binary nodes. foo == 42 → 42 == foo
+        // loops (default: true) -- optimizations for do, while and for loops when we can statically determine the condition.
+        // module (default false) -- Pass true when compressing an ES6 module. Strict mode is implied and the toplevel option as well.
+        // negate_iife (default: true) -- negate "Immediately-Called Function Expressions" where the return value is discarded, to avoid the parens that the code generator would insert.
+        // passes (default: 1) -- The maximum number of times to run compress. In some cases more than one pass leads to further compressed code. Keep in mind more passes will take more time.
+        // properties (default: true) -- rewrite property access using the dot notation, for example foo["bar"] → foo.bar
+        // pure_funcs (default: null) -- You can pass an array of names and Terser will assume that those functions do not produce side effects. DANGER: will not check if the name is redefined in scope. An example case here, for instance var q = Math.floor(a/b). If variable q is not used elsewhere, Terser will drop it, but will still keep the Math.floor(a/b), not knowing what it does. You can pass pure_funcs: [ 'Math.floor' ] to let it know that this function won't produce any side effect, in which case the whole statement would get discarded. The current implementation adds some overhead (compression will be slower).
+        // pure_getters (default: "strict") -- If you pass true for this, Terser will assume that object property access (e.g. foo.bar or foo["bar"]) doesn't have any side effects. Specify "strict" to treat foo.bar as side-effect-free only when foo is certain to not throw, i.e. not null or undefined.
+        // pure_new (default: false) -- Set to true to assume new X() never has side effects.
+        // reduce_vars (default: true) -- Improve optimization on variables assigned with and used as constant values.
+        // reduce_funcs (default: true) -- Inline single-use functions when possible. Depends on reduce_vars being enabled. Disabling this option sometimes improves performance of the output code.
+        // sequences (default: true) -- join consecutive simple statements using the comma operator. May be set to a positive integer to specify the maximum number of consecutive comma sequences that will be generated. If this option is set to true then the default sequences limit is 200. Set option to false or 0 to disable. The smallest sequences length is 2. A sequences value of 1 is grandfathered to be equivalent to true and as such means 200. On rare occasions the default sequences limit leads to very slow compress times in which case a value of 20 or less is recommended.
+        // side_effects (default: true) -- Remove expressions which have no side effects and whose results aren't used.
+        // switches (default: true) -- de-duplicate and remove unreachable switch branches
+        // toplevel (default: false) -- drop unreferenced functions ("funcs") and/or variables ("vars") in the top level scope (false by default, true to drop both unreferenced functions and variables)
+        // top_retain (default: null) -- prevent specific toplevel functions and variables from unused removal (can be array, comma-separated, RegExp or function. Implies toplevel)
+        // typeofs (default: true) -- Transforms typeof foo == "undefined" into foo === void 0. Note: recommend to set this value to false for IE10 and earlier versions due to known issues.
+        // unsafe (default: false) -- apply "unsafe" transformations (details).
+        // unsafe_arrows (default: false) -- Convert ES5 style anonymous function expressions to arrow functions if the function body does not reference this. Note: it is not always safe to perform this conversion if code relies on the the function having a prototype, which arrow functions lack. This transform requires that the ecma compress option is set to 2015 or greater.
+        // unsafe_comps (default: false) -- Reverse < and <= to > and >= to allow improved compression. This might be unsafe when an at least one of two operands is an object with computed values due the use of methods like get, or valueOf. This could cause change in execution order after operands in the comparison are switching. Compression only works if both comparisons and unsafe_comps are both set to true.
+        // unsafe_Function (default: false) -- compress and mangle Function(args, code) when both args and code are string literals.
+        // unsafe_math (default: false) -- optimize numerical expressions like 2 * x * 3 into 6 * x, which may give imprecise floating point results.
+        // unsafe_symbols (default: false) -- removes keys from native Symbol declarations, e.g Symbol("kDog") becomes Symbol().
+        // unsafe_methods (default: false) -- Converts { m: function(){} } to { m(){} }. ecma must be set to 6 or greater to enable this transform. If unsafe_methods is a RegExp then key/value pairs with keys matching the RegExp will be converted to concise methods. Note: if enabled there is a risk of getting a "<method name> is not a constructor" TypeError should any code try to new the former function.
+        // unsafe_proto (default: false) -- optimize expressions like Array.prototype.slice.call(a) into [].slice.call(a)
+        // unsafe_regexp (default: false) -- enable substitutions of variables with RegExp values the same way as if they are constants.
+        // unsafe_undefined (default: false) -- substitute void 0 if there is a variable named undefined in scope (variable name will be mangled, typically reduced to a single character)
+        // unused (default: true) -- drop unreferenced functions and variables (simple direct variable assignments do not count as references unless set to "keep_assign")
+    },
+    mangle: {
+        // mangle options
+        // Mangle names for obfuscation and size reduction
+        properties: true, // Mangle property names
+        // properties: {
+        //     // mangle property options // gives error messages
+        //     // bare_returns: false, //support top level return statements
+        //     html5_comments: true, // (default true)
+        //     shebang: true, //(default true) -- support #!command as the first line
+        //     spidermonkey: false, // (default false) -- accept a Spidermonkey (Mozilla) AST
+        // }
+    },
+    format: {
+        // format options (can also use `output` for backwards compatibility)
+        comments: false, // Remove comments to reduce file size
+        beautify: false, // Disable beautification for smaller file size
+    },
+    sourceMap: {
+    // source map options
+    },
+    // Define ECMAScript target version
+    ecma: 5, // specify one of: 5, 2015, 2016, etc.
+    enclose: false, // or specify true, or "args:values"
+    keep_classnames: false, // Remove class names
+    keep_fnames: false, // Remove function names
+    ie8: false,
+    module: false,
+    nameCache: null, // or specify a name cache object
+    safari10: false,
+    toplevel: true, // Enable top-level variable and function name mangling
+};
+// ============================================================================
+// Export
+// ============================================================================
+exports.default = terserConfig;

package/js/actions/LintAction/LintAction.d.ts

@@ -0,0 +1,17 @@
+import { Action } from "../../core/pipeline/Action";
+import { ActionOptionsType } from "../../types/ActionOptionsType";
+/**
+ * LintAction handles linting TypeScript and JavaScript files using ESLint.
+ * This action can be configured to run in strict mode or automatically fix issues.
+ */
+export declare class LintAction extends Action {
+    private eslint;
+    constructor();
+    execute(options: ActionOptionsType): Promise<void>;
+    /**
+     * Provides a description of the action.
+     *
+     * @returns A string description of the action.
+     */
+    describe(): string;
+}

package/js/actions/LintAction/LintAction.js

@@ -0,0 +1,63 @@
+"use strict";
+// ============================================================================
+// Import
+// ============================================================================
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LintAction = void 0;
+const eslint_1 = require("eslint");
+const Action_1 = require("../../core/pipeline/Action");
+// ============================================================================
+// Classes
+// ============================================================================
+/**
+ * LintAction handles linting TypeScript and JavaScript files using ESLint.
+ * This action can be configured to run in strict mode or automatically fix issues.
+ */
+class LintAction extends Action_1.Action {
+    constructor() {
+        super(); // Call the parent class constructor
+        this.eslint = new eslint_1.ESLint({}); // Initialize ESLint with default config
+    }
+    execute(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { targetFiles = ["src/**/*.ts"], fix = false, configPath = ".eslintrc.js", } = options;
+            if (!targetFiles || targetFiles.length === 0) {
+                throw new Error("Invalid options: 'targetFiles' is required and must contain at least one file or directory.");
+            }
+            this.logInfo(`Starting ESLint on: ${targetFiles.join(", ")}`);
+            try {
+                // Update ESLint instance with correct configuration
+                this.eslint = new eslint_1.ESLint({ fix, overrideConfigFile: configPath });
+                const results = yield this.eslint.lintFiles(targetFiles);
+                if (fix) {
+                    yield eslint_1.ESLint.outputFixes(results);
+                }
+                const formatter = yield this.eslint.loadFormatter("stylish");
+                console.log(formatter.format(results));
+                this.logInfo("ESLint linting completed successfully.");
+            }
+            catch (error) {
+                this.logError("ESLint encountered an error.", error);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Provides a description of the action.
+     *
+     * @returns A string description of the action.
+     */
+    describe() {
+        return "Runs ESLint on specified files and directories, with optional auto-fixing.";
+    }
+}
+exports.LintAction = LintAction;

package/js/actions/LintAction/index.d.ts

@@ -0,0 +1,2 @@
+import { LintAction } from "./LintAction";
+export { LintAction };

package/js/actions/LintAction/index.js

@@ -0,0 +1,8 @@
+"use strict";
+// ============================================================================
+// Import
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LintAction = void 0;
+const LintAction_1 = require("./LintAction");
+Object.defineProperty(exports, "LintAction", { enumerable: true, get: function () { return LintAction_1.LintAction; } });

package/js/actions/PackageManagerAction/PackageManagerAction.d.ts

@@ -0,0 +1,57 @@
+import { Action } from "../../core/pipeline/Action";
+import { ActionOptionsType } from "../../types/ActionOptionsType.js";
+/**
+ * PackageManagerAction handles reading, validating, and creating `package.json`
+ * files, supporting custom configurations and merging with selected fields.
+ */
+export declare class PackageManagerAction extends Action {
+    /**
+     * Executes the package management action.
+     * Reads an existing `package.json`, extracts selected fields, and writes a new one.
+     *
+     * @param options - Options specifying input path, output directory, and fields to export.
+     * @returns A Promise that resolves when the action is completed successfully.
+     * @throws {Error} Throws an error if neither `packageJsonPath` nor `outputDir` is provided.
+     */
+    execute(options: ActionOptionsType): Promise<void>;
+    /**
+     * Reads and parses an existing `package.json`.
+     *
+     * @param packageJsonPath - Path to the `package.json` file.
+     * @returns Parsed JSON object.
+     * @throws {Error} If the file does not exist or contains invalid JSON.
+     */
+    private readPackageJson;
+    /**
+     * Filters specified fields from a `package.json` object.
+     *
+     * @param config - The original package.json object.
+     * @param fields - List of fields to extract.
+     * @returns A new object containing only the selected fields.
+     */
+    private filterFields;
+    /**
+     * Creates a `package.json` file with selected fields and custom overrides.
+     *
+     * @param outputDir - Directory where the new `package.json` will be created.
+     * @param filteredConfig - The filtered package.json fields.
+     * @param customConfig - Custom overrides to apply.
+     * @returns A Promise that resolves when the file has been successfully created.
+     * @throws {Error} If the file cannot be written.
+     */
+    private createPackageJson;
+    /**
+     * Ensures that the specified directory exists, creating it if it does not.
+     *
+     * @param dirPath - The path of the directory to verify or create.
+     * @returns A Promise that resolves once the directory is verified or created.
+     * @throws {Error} If the directory cannot be created.
+     */
+    private ensureDirectoryExists;
+    /**
+     * Provides a description of the action.
+     *
+     * @returns A string description of the action.
+     */
+    describe(): string;
+}