uglify-js-minify-css-allfiles 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] - 2024-08-21
+
+### Added
+
+- Customizable minification options for both JavaScript and CSS
+- New `jsMinifyOptions` parameter to allow fine-tuning of JavaScript minification
+- New `cssMinifyOptions` parameter to allow fine-tuning of CSS minification
+
+### Changed
+
+- Updated `minifyAll` function to accept and use new minification options
+- Refactored `FILE_HANDLERS` to accommodate new options
+- Updated documentation to reflect new customization capabilities
+
+### Improved
+
+- Enhanced flexibility in minification process, allowing users to tailor the process to their specific needs
+
 ## [2.1.0] - 2024-08-20
 
 ### Changed
@@ -88,10 +106,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - New `exceptFolder` parameter to exclude specific folders from minification
 - Support for using relative paths
 
+[2.2.0]: https://github.com/oinochoe/uglify-js-minify-css-allfiles/compare/v2.1.0...v2.2.0
 [2.1.0]: https://github.com/oinochoe/uglify-js-minify-css-allfiles/compare/v2.0.0...v2.1.0
 [2.0.0]: https://github.com/oinochoe/uglify-js-minify-css-allfiles/compare/v1.3.2...v2.0.0
 [1.3.2]: https://github.com/oinochoe/uglify-js-minify-css-allfiles/compare/v1.3.1...v1.3.2
 [1.3.1]: https://github.com/oinochoe/uglify-js-minify-css-allfiles/compare/v1.3.0...v1.3.1
 [1.3.0]: https://github.com/oinochoe/uglify-js-minify-css-allfiles/compare/v1.2.0...v1.3.0
 [1.2.0]: https://github.com/oinochoe/uglify-js-minify-css-allfiles/compare/v1.1.0...v1.2.0
-[1.1.0]: https://github.com/oinochoe/uglify-js-minify-css-allfiles/compare/releases/tag/v1.1.0
+[1.1.0]: https://github.com/oinochoe/uglify-js-minify-css-allfiles/releases/tag/v1.1.0

package/README.md

@@ -27,6 +27,7 @@ You can easily minify all files in a specific folder, with the option to exclude
 - [Usage](#usage)
 - [Parameters](#parameters)
 - [Options](#options)
+- [Minification Options](#minification-options)
 - [Changelog](#changelog)
 - [License](#license)
 
@@ -70,24 +71,27 @@ $ npm i uglify-js-minify-css-allfiles
        logToConsole: true,
        logToFile: true,
      },
-   });
-   ```
-
-3. Using Babel and custom logging options:
-
-   ```js
-   import minifyAll from 'uglify-js-minify-css-allfiles';
-
-   await minifyAll('./src/', {
-     useBabel: { targets: 'chrome 40' },
-     useLog: {
-       logDir: 'logs',
-       retentionDays: 30,
-       logLevel: 'info',
-       dateFormat: 'YYYY-MM-DD',
-       timeZone: 'UTC',
-       logToConsole: true,
-       logToFile: true,
+     jsMinifyOptions: {
+       compress: {
+         dead_code: true,
+         drop_debugger: true,
+         conditionals: true,
+         evaluate: true,
+         booleans: true,
+         loops: true,
+         unused: true,
+         hoist_funs: true,
+         keep_fargs: false,
+         hoist_vars: true,
+         if_return: true,
+         join_vars: true,
+         cascade: true,
+         side_effects: true,
+         warnings: false,
+       },
+     },
+     cssMinifyOptions: {
+       level: 2,
      },
    });
    ```
@@ -105,11 +109,13 @@ The `minifyAll` function accepts the following parameters:
 
 The `options` object can have the following properties:
 
-| Property        | Type              | Default | Description                                                                                |
-| --------------- | ----------------- | ------- | ------------------------------------------------------------------------------------------ |
-| `excludeFolder` | string            | `''`    | The name of a folder to exclude from minification.                                         |
-| `useBabel`      | boolean \| object | `false` | If `true`, enables Babel with default settings. If an object, specifies Babel options.     |
-| `useLog`        | boolean \| object | `true`  | If `true`, enables logging with default settings. If an object, specifies logging options. |
+| Property           | Type              | Default | Description                                                                                |
+| ------------------ | ----------------- | ------- | ------------------------------------------------------------------------------------------ |
+| `excludeFolder`    | string            | `''`    | The name of a folder to exclude from minification.                                         |
+| `useBabel`         | boolean \| object | `false` | If `true`, enables Babel with default settings. If an object, specifies Babel options.     |
+| `useLog`           | boolean \| object | `true`  | If `true`, enables logging with default settings. If an object, specifies logging options. |
+| `jsMinifyOptions`  | object            | `{}`    | Options for JavaScript minification (passed to UglifyJS).                                  |
+| `cssMinifyOptions` | object            | `{}`    | Options for CSS minification (passed to CleanCSS).                                         |
 
 ### Babel Options
 
@@ -137,6 +143,28 @@ When `useLog` is an object, it can have the following properties:
 | `logToConsole`  | boolean | `true`         | Determines if logs should also be output to the console.              |
 | `logToFile`     | boolean | `true`         | Determines if logs should be written to a file.                       |
 
+## Minification Options
+
+### JavaScript Minification Options
+
+The `jsMinifyOptions` object is passed directly to UglifyJS. For a full list of available options, please refer to the [UglifyJS documentation](https://github.com/mishoo/UglifyJS#minify-options).
+
+Some commonly used options include:
+
+- `compress`: An object specifying compression options.
+- `mangle`: Controls name mangling. Can be a boolean or an object with more specific options.
+- `output`: An object controlling the output format.
+
+### CSS Minification Options
+
+The `cssMinifyOptions` object is passed directly to Clean-CSS. For a full list of available options, please refer to the [Clean-CSS documentation](https://github.com/clean-css/clean-css#constructor-options).
+
+Some commonly used options include:
+
+- `level`: Optimization level (0, 1, or 2).
+- `compatibility`: Browser compatibility (e.g., 'ie7', '\*').
+- `format`: Output formatting options.
+
 ## Changelog
 
 See CHANGELOG.md for details on each release.

package/dist/module.js

@@ -11,22 +11,48 @@ import { getAllFiles, writeFile } from './modules/fileHandler.js';
 import { minifyJS, minifyCSS } from './modules/minifier.js';
 import babelCore from '@babel/core';
 
+/**
+ * Object containing handlers for different file types.
+ * @type {Object.<string, function>}
+ */
 const FILE_HANDLERS = {
-  '.js': async (filePath, content, logger, babelOptions) => {
+  /**
+   * Handles JavaScript file minification.
+   * @async
+   * @param {string} filePath - The path of the JavaScript file.
+   * @param {string} content - The content of the JavaScript file.
+   * @param {Logger} logger - The logger instance.
+   * @param {Object} options - Options for processing.
+   * @param {Object} [options.babelOptions] - Babel transformation options.
+   * @param {Object} [options.jsMinifyOptions] - JavaScript minification options.
+   * @returns {Promise<void>}
+   */
+  '.js': async (filePath, content, logger, options) => {
     try {
       let transformed = content;
-      if (babelOptions) {
-        transformed = babelCore.transformSync(content, babelOptions).code;
+      if (options.babelOptions) {
+        transformed = babelCore.transformSync(content, options.babelOptions).code;
       }
-      const result = minifyJS(transformed);
+      const result = minifyJS(transformed, options.jsMinifyOptions);
       await writeFile(filePath, result, logger);
     } catch (error) {
       await logger?.error('JavaScript minification failed', { filePath, error: error.message });
     }
   },
-  '.css': async (filePath, content, logger) => {
+
+  /**
+   * Handles CSS file minification.
+   * @async
+   * @param {string} filePath - The path of the CSS file.
+   * @param {string} content - The content of the CSS file.
+   * @param {Logger} logger - The logger instance.
+   * @param {Object} options - Options for processing.
+   * @param {Object} [options.cssMinifyOptions] - CSS minification options.
+   * @returns {Promise<void>}
+   */
+  '.css': async (filePath, content, logger, options) => {
     try {
-      const output = await minifyCSS(content);
+      const output = await minifyCSS(content, options.cssMinifyOptions);
       if (0 < output.warnings.length) {
         await logger?.warn('CSS minification warnings', { filePath, warnings: output.warnings });
       }
@@ -42,17 +68,17 @@ const FILE_HANDLERS = {
  * @async
  * @param {string} filePath - The path of the file to process.
  * @param {Logger} logger - The logger instance.
- * @param {Object} [babelOptions=null] - Babel options for converting JavaScript files.
+ * @param {Object} options - Options for processing.
  * @returns {Promise<void>}
  */
-async function processFile(filePath, logger, babelOptions = null) {
+async function processFile(filePath, logger, options) {
   try {
     const fileContent = await fs.readFile(filePath, 'utf-8');
     const fileExtension = path.extname(filePath).toLowerCase();
     const handler = FILE_HANDLERS[fileExtension];
 
     if (handler) {
-      await handler(filePath, fileContent, logger, babelOptions);
+      await handler(filePath, fileContent, logger, options);
     } else {
       await logger?.info(`Unsupported file type, skipping: ${filePath}`);
     }
@@ -63,8 +89,7 @@ async function processFile(filePath, logger, babelOptions = null) {
 
 /**
  * Resolves Babel options based on the provided configuration.
- *
- * @param {Object|null} useBabel - The Babel options object or null.
+ * @param {boolean|Object} useBabel - The Babel options object or boolean.
  * @returns {Object|null} The resolved Babel options or null if no valid options are provided.
  */
 function resolveBabelOptions(useBabel) {
@@ -106,11 +131,12 @@ function resolveBabelOptions(useBabel) {
 
 /**
  * Options for minification configuration.
- *
  * @typedef {Object} MinifyOptions
- * @property {string} [excludeFolder] - Folder to exclude from minification.
- * @property {boolean|BabelOptions} [useBabel] - Whether to use Babel for transformation, and the options for Babel if used.
- * @property {boolean|LogOptions} [useLog] - Whether to use logging, and the options for logging if used.
+ * @property {string} [excludeFolder=''] - Folder to exclude from minification.
+ * @property {boolean|Object} [useBabel=false] - Whether to use Babel for transformation, and the options for Babel if used.
+ * @property {boolean|Object} [useLog=true] - Whether to use logging, and the options for logging if used.
+ * @property {Object} [jsMinifyOptions={}] - Options for JavaScript minification.
+ * @property {Object} [cssMinifyOptions={}] - Options for CSS minification.
  */
 
 /**
@@ -124,17 +150,30 @@ function resolveBabelOptions(useBabel) {
  * @throws {Error} If there's an issue reading or writing files.
  */
 export default async function minifyAll(contentPath, options = {}) {
-  const { excludeFolder = '', useBabel = false, useLog = true, logOptions = {} } = options;
+  const {
+    excludeFolder = '',
+    useBabel = false,
+    useLog = true,
+    jsMinifyOptions = {},
+    cssMinifyOptions = {},
+  } = options;
 
-  const logger = useLog ? new Logger(logOptions) : null;
-
-  if (logger) {
+  let logger = null;
+  if (useLog) {
+    const logOptions = typeof useLog === 'object' ? useLog : {};
+    logger = new Logger(logOptions);
     await logger.initialize();
     await logger.info('Starting minification process', { contentPath, excludeFolder, useBabel });
   }
 
   const rootDir = path.resolve(contentPath || '');
-  const finalBabelOptions = resolveBabelOptions(useBabel);
+  const babelOptions = resolveBabelOptions(useBabel);
+
+  const processOptions = {
+    babelOptions,
+    jsMinifyOptions,
+    cssMinifyOptions,
+  };
 
   try {
     await getAllFiles(rootDir, async (filePath) => {
@@ -143,7 +182,7 @@ export default async function minifyAll(contentPath, options = {}) {
         return;
       }
 
-      await processFile(filePath, logger, finalBabelOptions);
+      await processFile(filePath, logger, processOptions);
       logger?.incrementProcessedFiles(filePath);
     });
   } catch (error) {

package/dist/modules/minifier.js

@@ -6,26 +6,26 @@
 import { minify as uglifyJS } from 'uglify-js';
 import CleanCSS from 'clean-css';
 
-/**
- * Options for CSS minification.
- * @constant {Object}
- */
-const CSS_OPTIONS = {
-  level: { 1: { all: false } },
-};
-
 /**
  * Minifies JavaScript content.
  *
  * @param {string} content - The JavaScript content to minify.
+ * @param {Object} options - Options for JavaScript minification.
  * @returns {string} The minified JavaScript content.
  */
-export function minifyJS(content) {
-  return uglifyJS(content, {
+export function minifyJS(content, options = {}) {
+  const defaultOptions = {
     compress: {
       pure_funcs: ['console.log', 'console.error', 'console.warn', 'console.info'],
+      module: false,
+      arrows: false,
+      drop_debugger: true,
     },
-  }).code;
+    ie8: false,
+  };
+
+  const mergedOptions = { ...defaultOptions, ...options };
+  return uglifyJS(content, mergedOptions).code;
 }
 
 /**
@@ -33,10 +33,17 @@ export function minifyJS(content) {
  *
  * @async
  * @param {string} content - The CSS content to minify.
+ * @param {Object} options - Options for CSS minification.
  * @returns {Promise<Object>} A promise that resolves to the minification result.
  */
-export function minifyCSS(content) {
+export function minifyCSS(content, options = {}) {
+  const defaultOptions = {
+    level: { 1: { all: false } },
+  };
+
+  const mergedOptions = { ...defaultOptions, ...options };
+
   return new Promise((resolve) => {
-    new CleanCSS(CSS_OPTIONS).minify(content, (error, output) => resolve(output));
+    new CleanCSS(mergedOptions).minify(content, (error, output) => resolve(output));
   });
 }

package/logs/log-08-21-2024.log

@@ -0,0 +1,80 @@
+[08/21/2024, 04:47:18] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:47:18] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:47:19] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.js
+[08/21/2024, 04:47:19] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":0,"errorCount":0,"errorFiles":[]}}
+[08/21/2024, 04:48:46] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:48:46] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:48:47] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.js
+[08/21/2024, 04:48:47] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":0,"errorCount":0,"errorFiles":[]}}
+[08/21/2024, 04:53:29] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:53:29] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:53:30] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:53:30] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:53:47] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:53:47] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:53:48] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:53:48] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:55:05] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:55:05] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:55:06] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:55:06] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:55:21] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:55:21] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:55:22] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:55:22] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:55:30] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:55:30] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:55:31] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:55:31] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:55:37] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:55:37] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:55:38] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:55:38] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:55:46] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:55:46] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:55:47] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:55:47] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:56:00] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:56:00] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:56:01] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:56:01] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:56:21] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:56:21] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:56:22] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.js
+[08/21/2024, 04:56:22] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":0,"errorCount":0,"errorFiles":[]}}
+[08/21/2024, 04:56:30] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:56:30] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:56:30] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:56:30] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:56:38] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:56:38] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:56:39] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:56:39] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:56:48] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:56:48] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:56:49] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.js
+[08/21/2024, 04:56:49] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":0,"errorCount":0,"errorFiles":[]}}
+[08/21/2024, 04:59:02] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:59:02] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:59:03] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:59:03] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:59:23] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:59:23] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:59:24] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:59:24] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 04:59:33] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:59:33] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:59:34] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.js
+[08/21/2024, 04:59:34] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":0,"errorCount":0,"errorFiles":[]}}
+[08/21/2024, 04:59:49] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 04:59:49] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 04:59:50] [ERROR] Invalid or empty content {"filePath":"C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"}
+[08/21/2024, 04:59:50] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":1,"errorCount":1,"errorFiles":["C:\\Users\\PEARL\\Desktop\\uglify-js-minify-css-allfiles\\test\\test.js"]}}
+[08/21/2024, 05:00:00] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 05:00:00] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 05:00:01] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.js
+[08/21/2024, 05:00:01] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":0,"errorCount":0,"errorFiles":[]}}
+[08/21/2024, 12:02:11] [INFO] Starting minification process {"contentPath":"./test/","excludeFolder":"lib","useBabel":{"targets":"chrome 40"}}
+[08/21/2024, 12:02:11] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.css
+[08/21/2024, 12:02:12] [INFO] Writing file: C:\Users\PEARL\Desktop\uglify-js-minify-css-allfiles\test\test.js
+[08/21/2024, 12:02:12] [INFO] Processing Summary {"summary":{"totalFilesProcessed":2,"filesWithErrors":0,"errorCount":0,"errorFiles":[]}}

package/minify.d.ts

@@ -1,31 +1,135 @@
 declare module 'uglify-js-minify-css-allfiles' {
+  /**
+   * Babel configuration options.
+   * These options are passed directly to @babel/preset-env.
+   */
   export interface BabelOptions {
+    /**
+     * Describes the environments you support/target for your project.
+     * Can be a string (e.g., "last 2 versions", "safari >= 7"), an array of strings, or an object of minimum environment versions to support.
+     */
     targets?: string | string[] | { [key: string]: string };
+
+    /**
+     * Enables transformation of ES6 module syntax to another module type.
+     * Use false to preserve ES modules.
+     */
     modules?: 'amd' | 'umd' | 'systemjs' | 'commonjs' | 'cjs' | 'auto' | false;
+
+    /** Enable debug output to see what Babel is doing. */
     debug?: boolean;
+
+    /** Array of plugins to always include. */
     include?: string[];
+
+    /** Array of plugins to always exclude/remove. */
     exclude?: string[];
+
+    /**
+     * Configures how Babel handles polyfills.
+     * 'usage' adds specific imports for polyfills when they are used in each file.
+     * 'entry' imports the full polyfill based on your target environments.
+     */
     useBuiltIns?: 'usage' | 'entry' | false;
+
+    /**
+     * Specifies the core-js version used when useBuiltIns is set to 'usage' or 'entry'.
+     */
     corejs?: 2 | 3 | { version: 2 | 3; proposals: boolean };
+
+    /**
+     * Forces Babel to apply all transformations, even if the target environment(s) support them natively.
+     */
     forceAllTransforms?: boolean;
+
+    /**
+     * Path to a .browserslistrc file to use instead of targets.
+     */
     configPath?: string;
+
+    /**
+     * Toggles whether or not browserslist config sources are used, which includes searching for any browserslist files or referencing the browserslist key inside package.json.
+     */
     ignoreBrowserslistConfig?: boolean;
+
+    /**
+     * Toggles enabling support for builtin/feature proposals that have shipped in browsers.
+     */
     shippedProposals?: boolean;
   }
 
+  /**
+   * Logging configuration options.
+   */
   export interface LogOptions {
+    /**
+     * Specifies the directory where log files will be stored.
+     * @default 'logs'
+     */
     logDir?: string;
+
+    /**
+     * Number of days to keep log files before they are deleted.
+     * @default 30
+     */
     retentionDays?: number;
-    logLevel?: string;
+
+    /**
+     * Sets the minimum level of messages that will be logged.
+     * @default 'info'
+     */
+    logLevel?: 'error' | 'warn' | 'info' | 'debug';
+
+    /**
+     * Format for dates in log file names and entries.
+     * @default 'YYYY-MM-DD'
+     */
     dateFormat?: string;
+
+    /**
+     * Time zone used for timestamps in log entries.
+     * @default 'UTC'
+     */
     timeZone?: string;
+
+    /**
+     * Whether to output logs to the console in addition to (or instead of) writing to files.
+     * @default true
+     */
     logToConsole?: boolean;
+
+    /**
+     * Whether to write logs to files.
+     * @default true
+     */
     logToFile?: boolean;
   }
 
+  /**
+   * Configuration options for the minifyAll function.
+   */
   export interface MinifyOptions {
+    /**
+     * Name of a folder to exclude from the minification process.
+     * Useful for skipping already minified files or third-party libraries.
+     * @default ''
+     */
     excludeFolder?: string;
+
+    /**
+     * Enables Babel transformation of JavaScript files.
+     * If true, uses default Babel settings.
+     * If an object is provided, it should conform to the BabelOptions interface.
+     * @default false
+     */
     useBabel?: boolean | BabelOptions;
+
+    /**
+     * Configures logging behavior.
+     * If true, uses default logging settings.
+     * If an object is provided, it should conform to the LogOptions interface.
+     * @default true
+     */
     useLog?: boolean | LogOptions;
   }
 
@@ -33,9 +137,29 @@ declare module 'uglify-js-minify-css-allfiles' {
    * Minifies all JavaScript and CSS files in the specified directory and its subdirectories.
    *
    * @param contentPath - The path to the directory containing the files to be minified.
-   * @param options - Options for minification and logging.
+   *                      This is the root directory from which the function will start searching for files.
+   * @param options - Configuration options for the minification process.
+   *                  These options control Babel usage, logging, and allow excluding certain folders.
    * @returns A promise that resolves when all files have been processed.
-   * @throws {Error} If there's an issue reading or writing files.
+   * @throws {Error} If there's an issue reading or writing files, or if the minification process fails.
+   *
+   * @example
+   * ```typescript
+   * import minifyAll from 'uglify-js-minify-css-allfiles';
+   *
+   * await minifyAll('./src', {
+   *   excludeFolder: 'node_modules',
+   *   useBabel: {
+   *     targets: '> 0.25%, not dead',
+   *     useBuiltIns: 'usage',
+   *     corejs: 3
+   *   },
+   *   useLog: {
+   *     logLevel: 'warn',
+   *     retentionDays: 7
+   *   }
+   * });
+   * ```
    */
   export default function minifyAll(contentPath: string, options?: MinifyOptions): Promise<void>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "uglify-js-minify-css-allfiles",
-    "version": "2.1.0",
+    "version": "2.2.0",
     "description": "you will be able to minify all files as same file names which is js or css",
     "main": "minify.js",
     "type": "module",
@@ -15,6 +15,9 @@
         "type": "git",
         "url": "git+https://github.com/oinochoe/uglify-js-minify-css-allfiles.git"
     },
+    "publishConfig": {
+        "registry": "https://registry.npmjs.org/"
+    },
     "keywords": [
         "ugly-code",
         "uglyCode",

package/.vscode/settings.json

@@ -1,13 +0,0 @@
-{
-    "cSpell.words": [
-        "allfile",
-        "allfiles",
-        "comporessor",
-        "corejs",
-        "esmodules",
-        "minifycss",
-        "oinochoe",
-        "uglifyjs",
-        "yeongmin"
-    ]
-}