@node-minify/uglify-es 10.3.0 → 10.5.0

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 //#region ../types/src/types.d.ts
-
 /**
  * Output result for multi-format image compression.
  */
@@ -8,7 +7,6 @@ type CompressorOutput = {
    * Format of the output (e.g., 'webp', 'avif').
    */
   format?: string;
-
   /**
    * Output content as string or Buffer.
    */
@@ -22,19 +20,16 @@ type CompressorResult = {
    * Minified content as string (for text-based formats like JS, CSS, HTML, SVG).
    */
   code: string;
-
   /**
    * Source map (for JS/CSS compressors).
    */
   map?: string;
-
   /**
    * Minified content as Buffer (for binary formats like images).
    * @example
    * When using sharp for PNG/WebP compression
    */
   buffer?: Buffer;
-
   /**
    * Multiple outputs for multi-format image compression.
    * Used when converting to multiple formats simultaneously.
@@ -80,12 +75,10 @@ type Settings<TOptions extends CompressorOptions = CompressorOptions> = {
    * The compressor function to use for minification.
    */
   compressor: Compressor<TOptions>;
-
   /**
    * Optional label for the compressor (used in logging).
    */
   compressorLabel?: string;
-
   /**
    * Content to minify (for in-memory minification).
    * If provided, input/output are not required.
@@ -93,7 +86,6 @@ type Settings<TOptions extends CompressorOptions = CompressorOptions> = {
    * For binary formats (images): Buffer (handled internally by image compressors)
    */
   content?: string | Buffer;
-
   /**
    * Input file path(s) or glob pattern.
    * Can be a single file, array of files, or wildcard pattern.
@@ -104,7 +96,6 @@ type Settings<TOptions extends CompressorOptions = CompressorOptions> = {
    * - 'src/**\/*.js'
    */
   input?: string | string[];
-
   /**
    * Output file path.
    * Use $1 as placeholder for input filename in multi-file scenarios.
@@ -116,43 +107,36 @@ type Settings<TOptions extends CompressorOptions = CompressorOptions> = {
    * - '$1.min.js' (creates app.min.js from app.js)
    */
   output?: string | string[];
-
   /**
    * Compressor-specific options.
    * See individual compressor documentation for available options.
    */
   options?: TOptions;
-
   /**
    * CLI option string (used by CLI only).
    * @internal
    */
   option?: string;
-
   /**
    * Buffer size for file operations (in bytes).
    * @default 1024000 (1MB)
    */
   buffer?: number;
-
   /**
    * Timeout for the compressor process (in milliseconds).
    * If execution exceeds this limit, the process will be killed.
    */
   timeout?: number;
-
   /**
    * File type for compressors that support multiple types.
    * Required for YUI compressor.
    */
   type?: FileType;
-
   /**
    * Suppress console output.
    * @default false
    */
   silence?: boolean;
-
   /**
    * Public folder to prepend to input paths.
    *
@@ -161,12 +145,18 @@ type Settings<TOptions extends CompressorOptions = CompressorOptions> = {
    * the actual path becomes 'public/js/app.js'
    */
   publicFolder?: string;
-
   /**
    * Replace files in place instead of creating new output files.
    * @default false
    */
   replaceInPlace?: boolean;
+  /**
+   * Allow empty output without throwing an error.
+   * When true, if minification results in empty content, the output file will not be written.
+   * Useful for CSS files containing only comments that get stripped.
+   * @default false
+   */
+  allowEmptyOutput?: boolean;
 };
 /**
  * Options passed to compressor functions internally.
@@ -177,7 +167,6 @@ type MinifierOptions<TOptions extends CompressorOptions = CompressorOptions> = {
    * The full settings object.
    */
   settings: Settings<TOptions>;
-
   /**
    * The content to minify.
    * For text-based formats (JS, CSS, HTML, SVG): string
@@ -185,7 +174,6 @@ type MinifierOptions<TOptions extends CompressorOptions = CompressorOptions> = {
    * For multiple binary files: Buffer[]
    */
   content?: string | Buffer | Buffer[];
-
   /**
    * Index of current file when processing multiple files.
    */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["CompressorReturnType","ImageFormat","CompressorOutput","Buffer","CompressorResult","CompressorOptions","Record","Compressor","TOptions","MinifierOptions","Promise","FileType","Settings","Result","MinifyOptions"],"sources":["../../types/src/types.d.ts","../src/index.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\n/**\n * The return type of a compressor function.\n * @deprecated Use `CompressorResult` instead. Will be removed in v11.\n */\nexport type CompressorReturnType = string;\n\n/**\n * Supported image formats for image compression.\n */\nexport type ImageFormat =\n    | \"webp\"\n    | \"avif\"\n    | \"png\"\n    | \"jpeg\"\n    | \"jpg\"\n    | \"gif\"\n    | \"tiff\"\n    | \"heif\"\n    | \"heic\";\n\n/**\n * Output result for multi-format image compression.\n */\nexport type CompressorOutput = {\n    /**\n     * Format of the output (e.g., 'webp', 'avif').\n     */\n    format?: string;\n\n    /**\n     * Output content as string or Buffer.\n     */\n    content: string | Buffer;\n};\n\n/**\n * Result returned by a compressor function.\n */\nexport type CompressorResult = {\n    /**\n     * Minified content as string (for text-based formats like JS, CSS, HTML, SVG).\n     */\n    code: string;\n\n    /**\n     * Source map (for JS/CSS compressors).\n     */\n    map?: string;\n\n    /**\n     * Minified content as Buffer (for binary formats like images).\n     * @example\n     * When using sharp for PNG/WebP compression\n     */\n    buffer?: Buffer;\n\n    /**\n     * Multiple outputs for multi-format image compression.\n     * Used when converting to multiple formats simultaneously.\n     * @example\n     * [{ format: 'webp', content: <Buffer> }, { format: 'avif', content: <Buffer> }]\n     */\n    outputs?: CompressorOutput[];\n};\n\n/**\n * Base options that all compressors can accept.\n * Specific compressors may extend this with their own options.\n */\nexport type CompressorOptions = Record<string, unknown>;\n\n/**\n * A compressor function that minifies content.\n * @param args - The minifier options including settings and content\n * @returns A promise resolving to the compression result\n */\nexport type Compressor<TOptions extends CompressorOptions = CompressorOptions> =\n    (args: MinifierOptions<TOptions>) => Promise<CompressorResult>;\n\n/**\n * File type for compressors that support multiple types (e.g., YUI).\n */\nexport type FileType = \"js\" | \"css\";\n\n/**\n * User-facing settings for the minify function.\n * This is what users pass when calling minify().\n *\n * @example\n * ```ts\n * import { minify } from '@node-minify/core';\n * import { terser } from '@node-minify/terser';\n *\n * await minify({\n *   compressor: terser,\n *   input: 'src/*.js',\n *   output: 'dist/bundle.min.js',\n *   options: { mangle: true }\n * });\n * ```\n */\nexport type Settings<TOptions extends CompressorOptions = CompressorOptions> = {\n    /**\n     * The compressor function to use for minification.\n     */\n    compressor: Compressor<TOptions>;\n\n    /**\n     * Optional label for the compressor (used in logging).\n     */\n    compressorLabel?: string;\n\n    /**\n     * Content to minify (for in-memory minification).\n     * If provided, input/output are not required.\n     * For text-based formats (JS, CSS, HTML, SVG): string\n     * For binary formats (images): Buffer (handled internally by image compressors)\n     */\n    content?: string | Buffer;\n\n    /**\n     * Input file path(s) or glob pattern.\n     * Can be a single file, array of files, or wildcard pattern.\n     *\n     * @example\n     * - 'src/app.js'\n     * - ['src/a.js', 'src/b.js']\n     * - 'src/**\\/*.js'\n     */\n    input?: string | string[];\n\n    /**\n     * Output file path.\n     * Use $1 as placeholder for input filename in multi-file scenarios.\n     * Can be a single file, array of files, or pattern with $1.\n     *\n     * @example\n     * - 'dist/bundle.min.js'\n     * - ['file1.min.js', 'file2.min.js']\n     * - '$1.min.js' (creates app.min.js from app.js)\n     */\n    output?: string | string[];\n\n    /**\n     * Compressor-specific options.\n     * See individual compressor documentation for available options.\n     */\n    options?: TOptions;\n\n    /**\n     * CLI option string (used by CLI only).\n     * @internal\n     */\n    option?: string;\n\n    /**\n     * Buffer size for file operations (in bytes).\n     * @default 1024000 (1MB)\n     */\n    buffer?: number;\n\n    /**\n     * Timeout for the compressor process (in milliseconds).\n     * If execution exceeds this limit, the process will be killed.\n     */\n    timeout?: number;\n\n    /**\n     * File type for compressors that support multiple types.\n     * Required for YUI compressor.\n     */\n    type?: FileType;\n\n    /**\n     * Suppress console output.\n     * @default false\n     */\n    silence?: boolean;\n\n    /**\n     * Public folder to prepend to input paths.\n     *\n     * @example\n     * With publicFolder: 'public/js/' and input: 'app.js',\n     * the actual path becomes 'public/js/app.js'\n     */\n    publicFolder?: string;\n\n    /**\n     * Replace files in place instead of creating new output files.\n     * @default false\n     */\n    replaceInPlace?: boolean;\n};\n\n/**\n * Options passed to compressor functions internally.\n * This is what compressors receive, not what users pass.\n */\nexport type MinifierOptions<\n    TOptions extends CompressorOptions = CompressorOptions,\n> = {\n    /**\n     * The full settings object.\n     */\n    settings: Settings<TOptions>;\n\n    /**\n     * The content to minify.\n     * For text-based formats (JS, CSS, HTML, SVG): string\n     * For binary formats (images): Buffer\n     * For multiple binary files: Buffer[]\n     */\n    content?: string | Buffer | Buffer[];\n\n    /**\n     * Index of current file when processing multiple files.\n     */\n    index?: number;\n};\n\n/**\n * Result returned after compression (used by CLI).\n */\nexport type Result = {\n    /**\n     * Label of the compressor used.\n     */\n    compressorLabel: string;\n\n    /**\n     * Size of minified content (formatted string, e.g., \"1.5 KB\").\n     */\n    size: string;\n\n    /**\n     * Gzipped size of minified content (formatted string).\n     */\n    sizeGzip: string;\n};\n\n/**\n * Type alias for user convenience.\n * @deprecated Use `Settings` instead. Will be removed in v11.\n */\nexport type MinifyOptions<\n    TOptions extends CompressorOptions = CompressorOptions,\n> = Settings<TOptions>;\n"],"mappings":";;;;;AA2NsC,KA9L1BE,gBAAAA,GA8L0B;;;;ECxMhB,MAAA,CAAA,EAAA,MAAQ;;EAE1B;;;EACiB,OAAA,EAAA,MAAA,GDgBCC,MChBD;CAAO;;;;KDsBhBC,gBAAAA;;;;;;;;;;;;;;;;WAgBCD;;;;;;;;YAQCD;;;;;;KAOFG,iBAAAA,GAAoBC;;;;;;KAOpBC,4BAA4BF,oBAAoBA,4BACjDI,gBAAgBD,cAAcE,QAAQN;;;;KAKrCO,QAAAA;;;;;;;;;;;;;;;;;;KAmBAC,0BAA0BP,oBAAoBA;;;;cAI1CE,WAAWC;;;;;;;;;;;;;qBAaJL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA6BTK;;;;;;;;;;;;;;;;;;;;;;;;SAwBHG;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BCF,iCACSJ,oBAAoBA;;;;YAK3BO,SAASJ;;;;;;;;qBAQAL,SAASA;;;;;;;;;;;;;;;AAnIhC;AAmBA;;AAA0DE,iBCxFpC,QAAA,CDwFoCA;EAAAA,QAAAA;EAAAA;AAAAA,CAAAA,ECrFvD,eDqFuDA,CAAAA,ECrFrC,ODqFqCA,CCrF7B,gBDqF6BA,CAAAA"}
+{"version":3,"file":"index.d.ts","names":["CompressorReturnType","ImageFormat","CompressorOutput","Buffer","format","content","CompressorResult","code","map","buffer","outputs","CompressorOptions","Record","Compressor","TOptions","MinifierOptions","Promise","args","FileType","Settings","compressor","compressorLabel","input","output","options","option","timeout","type","silence","publicFolder","replaceInPlace","allowEmptyOutput","settings","index","Result","size","sizeGzip","MinifyOptions"],"sources":["../../types/src/types.d.ts","../src/index.ts"],"mappings":";;AAkFA;;KArDYE,gBAAAA;EAqD4BS;;;EAjDpCP,MAAAA;EAkDqCY;;;EA7CrCX,OAAAA,WAAkBF,MAAAA;AAAAA;;;;KAMVG,gBAAAA;EAuCqCA;;;EAnC7CC,IAAAA;;;;EAKAC,GAAAA;EAsDgBM;;;;;EA/ChBL,MAAAA,GAASN,MAAAA;EAqHFe;;;;;;EA7GPR,OAAAA,GAAUR,gBAAAA;AAAAA;;;;;KAOFS,iBAAAA,GAAoBC,MAAAA;;;;;;KAOpBC,UAAAA,kBAA4BF,iBAAAA,GAAoBA,iBAAAA,KACvDM,IAAAA,EAAMF,eAAAA,CAAgBD,QAAAA,MAAcE,OAAAA,CAAQV,gBAAAA;;;;KAKrCY,QAAAA;;;;;;;;;;;;;;;;;;KAmBAC,QAAAA,kBAA0BR,iBAAAA,GAAoBA,iBAAAA;EAwH1BR;;;EApH5BiB,UAAAA,EAAYP,UAAAA,CAAWC,QAAAA;;;AC5F3B;EDiGIO,eAAAA;EChGA;;;;;;EDwGAhB,OAAAA,YAAmBF,MAAAA;ECxGnB;;;;;;;;;EDmHAmB,KAAAA;;;;;;;;;;;EAYAC,MAAAA;;;;;EAMAC,OAAAA,GAAUV,QAAAA;;;;;EAMVW,MAAAA;;;;;EAMAhB,MAAAA;;;;;EAMAiB,OAAAA;;;;;EAMAC,IAAAA,GAAOT,QAAAA;;;;;EAMPU,OAAAA;;;;;;;;EASAC,YAAAA;;;;;EAMAC,cAAAA;;;;;;;EAQAC,gBAAAA;AAAAA;;;;;KAOQhB,eAAAA,kBACSJ,iBAAAA,GAAoBA,iBAAAA;;;;EAKrCqB,QAAAA,EAAUb,QAAAA,CAASL,QAAAA;;;;;;;EAQnBT,OAAAA,YAAmBF,MAAAA,GAASA,MAAAA;;;;EAK5B8B,KAAAA;AAAAA;;;;;;;AA5LJ;;;;;iBCzBsB,QAAA,CAAA;EAClB,QAAA;EACA;AAAA,GACD,eAAA,GAAkB,OAAA,CAAQ,gBAAA"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["inputContent: string | Record<string, string>"],"sources":["../src/index.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport type { CompressorResult, MinifierOptions } from \"@node-minify/types\";\nimport { ensureStringContent, warnDeprecation } from \"@node-minify/utils\";\nimport uglifyES from \"uglify-es\";\n\n/**\n * Minifies JavaScript content using uglify-es.\n *\n * @deprecated uglify-es is no longer maintained. Use @node-minify/terser instead.\n * @param settings - Minifier settings and uglify-es options\n * @param content - Input content to minify\n * @returns The minified code as `code` and the source map as `map` if produced\n * @throws The error produced by uglify-es when minification fails\n */\nexport async function uglifyEs({\n    settings,\n    content,\n}: MinifierOptions): Promise<CompressorResult> {\n    const contentStr = ensureStringContent(content, \"uglify-es\");\n\n    warnDeprecation(\n        \"uglify-es\",\n        \"uglify-es is no longer maintained. \" +\n            \"Please migrate to @node-minify/terser for continued support and modern JavaScript features.\"\n    );\n\n    let inputContent: string | Record<string, string> = contentStr;\n    const sourceMapOptions = settings.options?.sourceMap as\n        | { filename?: string }\n        | undefined;\n\n    if (typeof sourceMapOptions === \"object\") {\n        inputContent = {\n            [sourceMapOptions.filename ?? \"\"]: contentStr,\n        };\n    }\n\n    const result = uglifyES.minify(inputContent, settings.options);\n\n    if (result.error) {\n        throw result.error;\n    }\n\n    return {\n        code: result.code,\n        map: result.map,\n    };\n}\n"],"mappings":";;;;;;;;;;;;;AAmBA,eAAsB,SAAS,EAC3B,UACA,WAC2C;CAC3C,MAAM,aAAa,oBAAoB,SAAS,YAAY;AAE5D,iBACI,aACA,iIAEH;CAED,IAAIA,eAAgD;CACpD,MAAM,mBAAmB,SAAS,SAAS;AAI3C,KAAI,OAAO,qBAAqB,SAC5B,gBAAe,GACV,iBAAiB,YAAY,KAAK,YACtC;CAGL,MAAM,SAAS,SAAS,OAAO,cAAc,SAAS,QAAQ;AAE9D,KAAI,OAAO,MACP,OAAM,OAAO;AAGjB,QAAO;EACH,MAAM,OAAO;EACb,KAAK,OAAO;EACf"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport type { CompressorResult, MinifierOptions } from \"@node-minify/types\";\nimport { ensureStringContent, warnDeprecation } from \"@node-minify/utils\";\nimport uglifyES from \"uglify-es\";\n\n/**\n * Minifies JavaScript content using uglify-es.\n *\n * @deprecated uglify-es is no longer maintained. Use @node-minify/terser instead.\n * @param settings - Minifier settings and uglify-es options\n * @param content - Input content to minify\n * @returns The minified code as `code` and the source map as `map` if produced\n * @throws The error produced by uglify-es when minification fails\n */\nexport async function uglifyEs({\n    settings,\n    content,\n}: MinifierOptions): Promise<CompressorResult> {\n    const contentStr = ensureStringContent(content, \"uglify-es\");\n\n    warnDeprecation(\n        \"uglify-es\",\n        \"uglify-es is no longer maintained. \" +\n            \"Please migrate to @node-minify/terser for continued support and modern JavaScript features.\"\n    );\n\n    let inputContent: string | Record<string, string> = contentStr;\n    const sourceMapOptions = settings.options?.sourceMap as\n        | { filename?: string }\n        | undefined;\n\n    if (typeof sourceMapOptions === \"object\") {\n        inputContent = {\n            [sourceMapOptions.filename ?? \"\"]: contentStr,\n        };\n    }\n\n    const result = uglifyES.minify(inputContent, settings.options);\n\n    if (result.error) {\n        throw result.error;\n    }\n\n    return {\n        code: result.code,\n        map: result.map,\n    };\n}\n"],"mappings":";;;;;;;;;;;;;AAmBA,eAAsB,SAAS,EAC3B,UACA,WAC2C;CAC3C,MAAM,aAAa,oBAAoB,SAAS,YAAY;AAE5D,iBACI,aACA,iIAEH;CAED,IAAI,eAAgD;CACpD,MAAM,mBAAmB,SAAS,SAAS;AAI3C,KAAI,OAAO,qBAAqB,SAC5B,gBAAe,GACV,iBAAiB,YAAY,KAAK,YACtC;CAGL,MAAM,SAAS,SAAS,OAAO,cAAc,SAAS,QAAQ;AAE9D,KAAI,OAAO,MACP,OAAM,OAAO;AAGjB,QAAO;EACH,MAAM,OAAO;EACb,KAAK,OAAO;EACf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-minify/uglify-es",
-  "version": "10.3.0",
+  "version": "10.5.0",
   "deprecated": "uglify-es is no longer maintained. Please use @node-minify/terser instead.",
   "description": "uglify-es plugin for @node-minify (DEPRECATED - use @node-minify/terser)",
   "keywords": [
@@ -53,11 +53,11 @@
     "dev": "tsdown src/index.ts --watch"
   },
   "dependencies": {
-    "@node-minify/utils": "10.3.0",
+    "@node-minify/utils": "10.5.0",
     "uglify-es": "3.3.9"
   },
   "devDependencies": {
-    "@node-minify/types": "10.3.0",
+    "@node-minify/types": "10.5.0",
     "@types/uglify-es": "^3.0.3"
   }
 }