uglify-js-minify-css-allfiles 2.3.3 → 2.4.1

package/README.md

@@ -19,6 +19,7 @@ You can easily minify all files in a specific folder, with the option to exclude
   - [Babel Integration](#babel-integration)
   - [Image Versioning](#image-versioning)
   - [Logging System](#logging-system)
+  - [Source Maps](#source-maps)
 - [API Reference](#api-reference)
 - [Minification Options](#minification-options)
 - [Contributing](#contributing)
@@ -33,6 +34,7 @@ You can easily minify all files in a specific folder, with the option to exclude
 - 🛡️ Configurable file exclusion
 - 🔄 ES module support
 - 📊 Processing statistics and summaries
+- 🔍 Source map generation for easier debugging
 
 ## Installation
 
@@ -91,6 +93,7 @@ await minifyAll('./src/', {
   useVersioning: {
     extensions: ['.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp'],
   },
+  useJsMap: true,
 });
 ```
 
@@ -159,6 +162,22 @@ await minifyAll('./src/', {
 });
 ```
 
+### Source Maps
+
+Generate source maps for JavaScript files to aid in debugging minified code:
+
+- Maps compressed code back to original source code
+- Automatically creates `.map` files alongside minified JavaScript
+- Seamless integration with browser developer tools
+- Works with or without Babel transformation
+- Helps maintain debuggability in production environments
+
+```js
+await minifyAll('./src/', {
+  useJsMap: true,
+});
+```
+
 ## API Reference
 
 ### minifyAll(contentPath, options)
@@ -174,6 +193,7 @@ Main function to process files.
   - `cssMinifyOptions` (object): CSS minification options
   - `useVersioning` (object): Image versioning configuration
     - `extensions` (string[]): List of image extensions to version
+  - `useJsMap` (boolean): Enable source map generation for JavaScript files
 
 ### Babel Options
 

package/demo.js

@@ -8,4 +8,5 @@ minifyAll('./test/', {
   useVersioning: {
     extensions: ['.png', '.jpg', '.webp', '.avif', '.svg'],
   },
+  useJsMap: true,
 });

package/dist/module.js

@@ -13,6 +13,7 @@ import HashManager from './modules/hashManager.js';
 import { minifyJS, minifyCSS } from './modules/minifier.js';
 import { DEFAULT_IMAGE_EXTENSIONS, IMAGE_PATTERNS } from './modules/imageUtils.js';
 import { resolveImagePath, resolveModulePath, makeRelativePath, containsFolder, getExtension, resolvePath } from './modules/pathResolver.js';
+import path from 'path';
 
 /**
  * Processes image references in files and adds/updates version hashes for cache busting.
@@ -176,6 +177,7 @@ async function resolveBabelOptions(useBabel) {
  * @param {BabelOptions} [options.babelOptions] - Babel transformation options.
  * @param {Object} [options.jsMinifyOptions] - JavaScript minification options.
  * @param {Object} [options.cssMinifyOptions] - CSS minification options.
+ * @param {boolean} [options.useJsMap] - JavaScript map file options.
  * @returns {Promise<void>}
  */
 async function processFile(filePath, logger, options) {
@@ -185,25 +187,60 @@ async function processFile(filePath, logger, options) {
 
     let result;
     if (fileExtension === '.js') {
-      let transformed = fileContent;
+      let content = fileContent;
       if (options.babelOptions) {
         const babelCoreUrl = resolveModulePath('@babel/core');
         const { transformSync } = await import(babelCoreUrl);
-        transformed = transformSync(fileContent, options.babelOptions).code;
+
+        let babelOptions = {
+          ...options.babelOptions,
+        };
+
+        if (options.useJsMap) {
+          babelOptions = {
+            ...babelOptions,
+            filename: filePath,
+            sourceMaps: true,
+            sourceFileName: filePath,
+          };
+        }
+
+        content = transformSync(fileContent, babelOptions);
+      }
+
+      let jsMinifyOptions = { ...options.jsMinifyOptions };
+
+      if (options.useJsMap) {
+        jsMinifyOptions.sourceMap = {
+          includeSources: true,
+        };
+
+        if (options.babelOptions && content.map) {
+          jsMinifyOptions.sourceMap.content = JSON.stringify(content.map);
+        }
+      }
+
+      result = minifyJS(options.babelOptions ? content.code : content, jsMinifyOptions);
+
+      if (options.useJsMap) {
+        const fileName = path.basename(filePath);
+        const mapFilePath = filePath.replace('.js', '.js.map');
+
+        await writeFile(filePath, result.code + `\n//# sourceMappingURL=${fileName}.map`, logger);
+        await writeFile(mapFilePath, result.map, logger);
+      } else {
+        await writeFile(filePath, result.code, logger);
       }
-      result = minifyJS(transformed, options.jsMinifyOptions);
     } else if (fileExtension === '.css') {
       const output = await minifyCSS(fileContent, options.cssMinifyOptions);
       if (output.warnings.length > 0) {
         await logger?.warn('CSS minification warnings', { filePath, warnings: output.warnings });
       }
-      result = output.styles;
+      await writeFile(filePath, output.styles, logger);
     } else {
       // `Unsupported file type, skipping: ${filePath}`;
       return;
     }
-
-    await writeFile(filePath, result, logger);
   } catch (error) {
     await logger?.error('Error processing file', { filePath, error: error.message });
   }
@@ -262,6 +299,7 @@ async function processFile(filePath, logger, options) {
  * @property {JSMinifyOptions} [jsMinifyOptions={}] - Options for JavaScript minification.
  * @property {CSSMinifyOptions} [cssMinifyOptions={}] - Options for CSS minification.
  * @property {string[]|null} [useVersioning=null] - Options for file versioning.
+ * @property {boolean} [useJsMap=false] - Whether to use JavaScript Map file.
  */
 
 /**
@@ -273,7 +311,15 @@ async function processFile(filePath, logger, options) {
  * @throws {Error} If there's an issue reading or writing files.
  */
 export default async function minifyAll(contentPath, options = {}) {
-  const { excludeFolder = '', useBabel = false, useLog = true, jsMinifyOptions = {}, cssMinifyOptions = {}, useVersioning = null } = options;
+  const {
+    excludeFolder = '',
+    useBabel = false,
+    useLog = true,
+    jsMinifyOptions = {},
+    cssMinifyOptions = {},
+    useVersioning = null,
+    useJsMap = false,
+  } = options;
 
   let logger = null;
   if (useLog) {
@@ -285,6 +331,7 @@ export default async function minifyAll(contentPath, options = {}) {
       excludeFolder,
       useBabel,
       useVersioning: !!useVersioning,
+      useJsMap,
     });
   }
 
@@ -301,6 +348,7 @@ export default async function minifyAll(contentPath, options = {}) {
     babelOptions,
     jsMinifyOptions,
     cssMinifyOptions,
+    useJsMap,
   };
 
   try {

package/dist/modules/minifier.js

@@ -24,7 +24,12 @@ export function minifyJS(content, options = {}) {
   };
 
   const mergedOptions = { ...defaultOptions, ...options };
-  return uglifyJS(content, mergedOptions).code;
+  const result = uglifyJS(content, mergedOptions);
+
+  return {
+    code: result.code,
+    map: result.map,
+  };
 }
 
 /**

package/minify.d.ts

@@ -180,6 +180,13 @@ declare module 'uglify-js-minify-css-allfiles' {
      * @default {}
      */
     cssMinifyOptions?: CSSMinifyOptions;
+
+    /**
+     * Enables source map generation for JavaScript files during minification.
+     * Source maps help with debugging by mapping minified code back to original source code.
+     * @default false
+     */
+    useJsMap?: boolean;
   }
 
   /**
@@ -206,7 +213,8 @@ declare module 'uglify-js-minify-css-allfiles' {
    *   useLog: {
    *     logLevel: 'warn',
    *     retentionDays: 7
-   *   }
+   *   },
+   *   useJsMap: true // Enable source map generation
    * });
    * ```
    */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "uglify-js-minify-css-allfiles",
-    "version": "2.3.3",
+    "version": "2.4.1",
     "description": "you will be able to minify all files as same file names which is js or css",
     "main": "minify.js",
     "type": "module",