@node-minify/utils 10.2.0 → 10.4.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Rodolphe Stoclin
+Copyright (c) 2011-2026 Rodolphe Stoclin
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/buildArgs.js

@@ -1,9 +1,9 @@
-import { n as ValidationError } from "./error-Ck87RwDD.js";
+import { n as ValidationError } from "./error-CUgKxOvI.js";
 
 //#region src/buildArgs.ts
 /*!
 * node-minify
-* Copyright(c) 2011-2025 Rodolphe Stoclin
+* Copyright (c) 2011-2026 Rodolphe Stoclin
 * MIT Licensed
 */
 /**

package/dist/buildArgs.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildArgs.js","names":["result: BuildArgsOptions","args: string[]"],"sources":["../src/buildArgs.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { ValidationError } from \"./error.ts\";\nimport type { BuildArgsOptions } from \"./types.ts\";\n\n/**\n * Converts a generic options object to BuildArgsOptions by filtering out non-primitive values.\n * Only keeps string, number, boolean, and undefined values.\n * @param options - Generic options object\n * @returns Filtered options compatible with buildArgs\n */\nexport function toBuildArgsOptions(\n    options: Record<string, unknown>\n): BuildArgsOptions {\n    const result: BuildArgsOptions = {};\n    for (const [key, value] of Object.entries(options)) {\n        if (\n            typeof value === \"string\" ||\n            typeof value === \"number\" ||\n            typeof value === \"boolean\" ||\n            value === undefined\n        ) {\n            result[key] = value;\n        }\n    }\n    return result;\n}\n\n/**\n * Builds arguments array based on an object.\n * @param options Object containing command line arguments\n * @returns Array of command line arguments\n * @throws {ValidationError} If options is null or undefined\n * @example\n * buildArgs({ compress: true, output: 'file.min.js' })\n * // returns ['--compress', '--output', 'file.min.js']\n */\nexport function buildArgs(options: BuildArgsOptions): string[] {\n    if (!options || typeof options !== \"object\") {\n        throw new ValidationError(\"Options must be a valid object\");\n    }\n\n    const args: string[] = [];\n    Object.entries(options).forEach(([key, value]) => {\n        if (value !== undefined && value !== false) {\n            args.push(`--${key}`);\n            if (value !== true) {\n                args.push(String(value));\n            }\n        }\n    });\n\n    return args;\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,mBACZ,SACgB;CAChB,MAAMA,SAA2B,EAAE;AACnC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,CAC9C,KACI,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,aACjB,UAAU,OAEV,QAAO,OAAO;AAGtB,QAAO;;;;;;;;;;;AAYX,SAAgB,UAAU,SAAqC;AAC3D,KAAI,CAAC,WAAW,OAAO,YAAY,SAC/B,OAAM,IAAI,gBAAgB,iCAAiC;CAG/D,MAAMC,OAAiB,EAAE;AACzB,QAAO,QAAQ,QAAQ,CAAC,SAAS,CAAC,KAAK,WAAW;AAC9C,MAAI,UAAU,UAAa,UAAU,OAAO;AACxC,QAAK,KAAK,KAAK,MAAM;AACrB,OAAI,UAAU,KACV,MAAK,KAAK,OAAO,MAAM,CAAC;;GAGlC;AAEF,QAAO"}
+{"version":3,"file":"buildArgs.js","names":[],"sources":["../src/buildArgs.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { ValidationError } from \"./error.ts\";\nimport type { BuildArgsOptions } from \"./types.ts\";\n\n/**\n * Converts a generic options object to BuildArgsOptions by filtering out non-primitive values.\n * Only keeps string, number, boolean, and undefined values.\n * @param options - Generic options object\n * @returns Filtered options compatible with buildArgs\n */\nexport function toBuildArgsOptions(\n    options: Record<string, unknown>\n): BuildArgsOptions {\n    const result: BuildArgsOptions = {};\n    for (const [key, value] of Object.entries(options)) {\n        if (\n            typeof value === \"string\" ||\n            typeof value === \"number\" ||\n            typeof value === \"boolean\" ||\n            value === undefined\n        ) {\n            result[key] = value;\n        }\n    }\n    return result;\n}\n\n/**\n * Builds arguments array based on an object.\n * @param options Object containing command line arguments\n * @returns Array of command line arguments\n * @throws {ValidationError} If options is null or undefined\n * @example\n * buildArgs({ compress: true, output: 'file.min.js' })\n * // returns ['--compress', '--output', 'file.min.js']\n */\nexport function buildArgs(options: BuildArgsOptions): string[] {\n    if (!options || typeof options !== \"object\") {\n        throw new ValidationError(\"Options must be a valid object\");\n    }\n\n    const args: string[] = [];\n    Object.entries(options).forEach(([key, value]) => {\n        if (value !== undefined && value !== false) {\n            args.push(`--${key}`);\n            if (value !== true) {\n                args.push(String(value));\n            }\n        }\n    });\n\n    return args;\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,mBACZ,SACgB;CAChB,MAAM,SAA2B,EAAE;AACnC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,CAC9C,KACI,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,aACjB,UAAU,OAEV,QAAO,OAAO;AAGtB,QAAO;;;;;;;;;;;AAYX,SAAgB,UAAU,SAAqC;AAC3D,KAAI,CAAC,WAAW,OAAO,YAAY,SAC/B,OAAM,IAAI,gBAAgB,iCAAiC;CAG/D,MAAM,OAAiB,EAAE;AACzB,QAAO,QAAQ,QAAQ,CAAC,SAAS,CAAC,KAAK,WAAW;AAC9C,MAAI,UAAU,UAAa,UAAU,OAAO;AACxC,QAAK,KAAK,KAAK,MAAM;AACrB,OAAI,UAAU,KACV,MAAK,KAAK,OAAO,MAAM,CAAC;;GAGlC;AAEF,QAAO"}

package/dist/compressSingleFile.d.ts

@@ -1,4 +1,4 @@
-import { r as Settings, t as CompressorOptions } from "./types-BUlX1Zbb.js";
+import { i as Settings, n as CompressorOptions } from "./types-CWBFD3au.js";
 
 //#region src/compressSingleFile.d.ts
 

package/dist/compressSingleFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compressSingleFile.d.ts","names":[],"sources":["../src/compressSingleFile.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;iBA+CsB,6BACR,oBAAoB,6BACtB,SAAS,KAAK"}
+{"version":3,"file":"compressSingleFile.d.ts","names":[],"sources":["../src/compressSingleFile.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;iBAsBsB,6BACR,oBAAoB,6BACtB,SAAS,KAAK"}

package/dist/compressSingleFile.js

@@ -1,37 +1,9 @@
 import { getContentFromFilesAsync } from "./getContentFromFiles.js";
+import { isImageFile } from "./isImageFile.js";
+import { readFileAsync } from "./readFile.js";
 import { run } from "./run.js";
-import { readFile } from "node:fs/promises";
 
 //#region src/compressSingleFile.ts
-/*!
-* node-minify
-* Copyright(c) 2011-2025 Rodolphe Stoclin
-* MIT Licensed
-*/
-const IMAGE_EXTENSIONS = new Set([
-	".png",
-	".jpg",
-	".jpeg",
-	".gif",
-	".webp",
-	".avif",
-	".tiff",
-	".tif",
-	".heif",
-	".heic"
-]);
-/**
-* Determines whether a file path refers to a supported image file by its extension.
-*
-* @param filePath - The file name or path to check; may include directories.
-* @returns `true` if the path ends with a recognized image extension, `false` otherwise.
-*/
-function isImageFile(filePath) {
-	const lastDot = filePath.lastIndexOf(".");
-	if (lastDot === -1) return false;
-	const ext = filePath.slice(lastDot).toLowerCase();
-	return IMAGE_EXTENSIONS.has(ext);
-}
 /**
 * Compress a single file using the provided settings.
 *
@@ -57,11 +29,13 @@ async function determineContent(settings) {
 		const imageFilesCount = settings.input.filter((file) => isImageFile(file)).length;
 		if (imageFilesCount > 0) {
 			if (imageFilesCount !== settings.input.length) throw new Error("Cannot mix image and text files in the same input array");
-			return await Promise.all(settings.input.map((file) => readFile(file)));
+			const firstInput = settings.input[0];
+			if (settings.input.length === 1 && firstInput) return await readFileAsync(firstInput, true);
+			return await Promise.all(settings.input.map((file) => readFileAsync(file, true)));
 		}
 	}
 	if (settings.input && typeof settings.input === "string") {
-		if (isImageFile(settings.input)) return await readFile(settings.input);
+		if (isImageFile(settings.input)) return await readFileAsync(settings.input, true);
 	}
 	if (settings.input) return await getContentFromFilesAsync(settings.input);
 	return "";

package/dist/compressSingleFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"compressSingleFile.js","names":[],"sources":["../src/compressSingleFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport type {\n    CompressorOptions,\n    MinifierOptions,\n    Settings,\n} from \"@node-minify/types\";\nimport { getContentFromFilesAsync } from \"./getContentFromFiles.ts\";\nimport { run } from \"./run.ts\";\n\nconst IMAGE_EXTENSIONS = new Set([\n    \".png\",\n    \".jpg\",\n    \".jpeg\",\n    \".gif\",\n    \".webp\",\n    \".avif\",\n    \".tiff\",\n    \".tif\",\n    \".heif\",\n    \".heic\",\n]);\n\n/**\n * Determines whether a file path refers to a supported image file by its extension.\n *\n * @param filePath - The file name or path to check; may include directories.\n * @returns `true` if the path ends with a recognized image extension, `false` otherwise.\n */\nfunction isImageFile(filePath: string): boolean {\n    const lastDot = filePath.lastIndexOf(\".\");\n    if (lastDot === -1) return false;\n    const ext = filePath.slice(lastDot).toLowerCase();\n    return IMAGE_EXTENSIONS.has(ext);\n}\n\n/**\n * Compress a single file using the provided settings.\n *\n * @param settings - Configuration that specifies input content or input path(s) and compressor options\n * @returns The compressed output as a string\n */\nexport async function compressSingleFile<\n    T extends CompressorOptions = CompressorOptions,\n>(settings: Settings<T>): Promise<string> {\n    const content = await determineContent(settings);\n    return run({ settings, content } as MinifierOptions<T>);\n}\n\n/**\n * Resolve the content to be minified from the provided settings.\n *\n * @param settings - Settings that may contain `content` or `input` (string or string[]); `content` is used preferentially.\n * @returns The resolved content: a `string` for text input, a `Buffer` for a single image file, or a `Buffer[]` for multiple image files.\n * @throws Error - If `settings.input` is an array that mixes image and non-image file paths.\n */\nasync function determineContent<\n    T extends CompressorOptions = CompressorOptions,\n>(settings: Settings<T>): Promise<string | Buffer | Buffer[]> {\n    if (settings.content) {\n        return settings.content;\n    }\n\n    if (settings.input && Array.isArray(settings.input)) {\n        const imageFilesCount = settings.input.filter((file) =>\n            isImageFile(file)\n        ).length;\n        if (imageFilesCount > 0) {\n            if (imageFilesCount !== settings.input.length) {\n                throw new Error(\n                    \"Cannot mix image and text files in the same input array\"\n                );\n            }\n            return await Promise.all(\n                settings.input.map((file) => readFile(file))\n            );\n        }\n    }\n\n    if (settings.input && typeof settings.input === \"string\") {\n        if (isImageFile(settings.input)) {\n            return await readFile(settings.input);\n        }\n    }\n\n    if (settings.input) {\n        return await getContentFromFilesAsync(settings.input);\n    }\n\n    return \"\";\n}\n"],"mappings":";;;;;;;;;;AAeA,MAAM,mBAAmB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACH,CAAC;;;;;;;AAQF,SAAS,YAAY,UAA2B;CAC5C,MAAM,UAAU,SAAS,YAAY,IAAI;AACzC,KAAI,YAAY,GAAI,QAAO;CAC3B,MAAM,MAAM,SAAS,MAAM,QAAQ,CAAC,aAAa;AACjD,QAAO,iBAAiB,IAAI,IAAI;;;;;;;;AASpC,eAAsB,mBAEpB,UAAwC;AAEtC,QAAO,IAAI;EAAE;EAAU,SADP,MAAM,iBAAiB,SAAS;EAChB,CAAuB;;;;;;;;;AAU3D,eAAe,iBAEb,UAA4D;AAC1D,KAAI,SAAS,QACT,QAAO,SAAS;AAGpB,KAAI,SAAS,SAAS,MAAM,QAAQ,SAAS,MAAM,EAAE;EACjD,MAAM,kBAAkB,SAAS,MAAM,QAAQ,SAC3C,YAAY,KAAK,CACpB,CAAC;AACF,MAAI,kBAAkB,GAAG;AACrB,OAAI,oBAAoB,SAAS,MAAM,OACnC,OAAM,IAAI,MACN,0DACH;AAEL,UAAO,MAAM,QAAQ,IACjB,SAAS,MAAM,KAAK,SAAS,SAAS,KAAK,CAAC,CAC/C;;;AAIT,KAAI,SAAS,SAAS,OAAO,SAAS,UAAU,UAC5C;MAAI,YAAY,SAAS,MAAM,CAC3B,QAAO,MAAM,SAAS,SAAS,MAAM;;AAI7C,KAAI,SAAS,MACT,QAAO,MAAM,yBAAyB,SAAS,MAAM;AAGzD,QAAO"}
+{"version":3,"file":"compressSingleFile.js","names":[],"sources":["../src/compressSingleFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport type {\n    CompressorOptions,\n    MinifierOptions,\n    Settings,\n} from \"@node-minify/types\";\nimport { getContentFromFilesAsync } from \"./getContentFromFiles.ts\";\nimport { isImageFile } from \"./isImageFile.ts\";\nimport { readFileAsync } from \"./readFile.ts\";\nimport { run } from \"./run.ts\";\n\n/**\n * Compress a single file using the provided settings.\n *\n * @param settings - Configuration that specifies input content or input path(s) and compressor options\n * @returns The compressed output as a string\n */\nexport async function compressSingleFile<\n    T extends CompressorOptions = CompressorOptions,\n>(settings: Settings<T>): Promise<string> {\n    const content = await determineContent(settings);\n    return run({ settings, content } as MinifierOptions<T>);\n}\n\n/**\n * Resolve the content to be minified from the provided settings.\n *\n * @param settings - Settings that may contain `content` or `input` (string or string[]); `content` is used preferentially.\n * @returns The resolved content: a `string` for text input, a `Buffer` for a single image file, or a `Buffer[]` for multiple image files.\n * @throws Error - If `settings.input` is an array that mixes image and non-image file paths.\n */\nasync function determineContent<\n    T extends CompressorOptions = CompressorOptions,\n>(settings: Settings<T>): Promise<string | Buffer | Buffer[]> {\n    if (settings.content) {\n        return settings.content;\n    }\n\n    if (settings.input && Array.isArray(settings.input)) {\n        const imageFilesCount = settings.input.filter((file) =>\n            isImageFile(file)\n        ).length;\n        if (imageFilesCount > 0) {\n            if (imageFilesCount !== settings.input.length) {\n                throw new Error(\n                    \"Cannot mix image and text files in the same input array\"\n                );\n            }\n            const firstInput = settings.input[0];\n            if (settings.input.length === 1 && firstInput) {\n                return await readFileAsync(firstInput, true);\n            }\n            return await Promise.all(\n                settings.input.map((file) => readFileAsync(file, true))\n            );\n        }\n    }\n\n    if (settings.input && typeof settings.input === \"string\") {\n        if (isImageFile(settings.input)) {\n            return await readFileAsync(settings.input, true);\n        }\n    }\n\n    if (settings.input) {\n        return await getContentFromFilesAsync(settings.input);\n    }\n\n    return \"\";\n}\n"],"mappings":";;;;;;;;;;;;AAsBA,eAAsB,mBAEpB,UAAwC;AAEtC,QAAO,IAAI;EAAE;EAAU,SADP,MAAM,iBAAiB,SAAS;EAChB,CAAuB;;;;;;;;;AAU3D,eAAe,iBAEb,UAA4D;AAC1D,KAAI,SAAS,QACT,QAAO,SAAS;AAGpB,KAAI,SAAS,SAAS,MAAM,QAAQ,SAAS,MAAM,EAAE;EACjD,MAAM,kBAAkB,SAAS,MAAM,QAAQ,SAC3C,YAAY,KAAK,CACpB,CAAC;AACF,MAAI,kBAAkB,GAAG;AACrB,OAAI,oBAAoB,SAAS,MAAM,OACnC,OAAM,IAAI,MACN,0DACH;GAEL,MAAM,aAAa,SAAS,MAAM;AAClC,OAAI,SAAS,MAAM,WAAW,KAAK,WAC/B,QAAO,MAAM,cAAc,YAAY,KAAK;AAEhD,UAAO,MAAM,QAAQ,IACjB,SAAS,MAAM,KAAK,SAAS,cAAc,MAAM,KAAK,CAAC,CAC1D;;;AAIT,KAAI,SAAS,SAAS,OAAO,SAAS,UAAU,UAC5C;MAAI,YAAY,SAAS,MAAM,CAC3B,QAAO,MAAM,cAAc,SAAS,OAAO,KAAK;;AAIxD,KAAI,SAAS,MACT,QAAO,MAAM,yBAAyB,SAAS,MAAM;AAGzD,QAAO"}

package/dist/compressor-resolver.d.ts

@@ -0,0 +1,76 @@
+import { t as Compressor } from "./types-CWBFD3au.js";
+
+//#region src/compressor-resolver.d.ts
+
+/**
+ * Result from resolving a compressor.
+ */
+type CompressorResolution = {
+  /**
+   * The resolved compressor function.
+   */
+  compressor: Compressor;
+  /**
+   * Label for the compressor (used in logs/reports).
+   */
+  label: string;
+  /**
+   * Whether this is a built-in @node-minify compressor.
+   */
+  isBuiltIn: boolean;
+};
+/**
+ * Determines whether a string represents a local file path.
+ *
+ * @param name - The path string to test
+ * @returns `true` if `name` appears to be a local file path, `false` otherwise
+ */
+declare function isLocalPath(name: string): boolean;
+/**
+ * Try to resolve a compressor from a built-in @node-minify package.
+ *
+ * @param name - The compressor name (e.g., "terser", "esbuild")
+ * @returns The resolved CompressorResolution if found, or `null` if not installed/available
+ */
+declare function tryResolveBuiltIn(name: string): Promise<CompressorResolution | null>;
+/**
+ * Try to resolve a compressor from an npm package.
+ *
+ * @param name - The npm package name
+ * @returns The resolved CompressorResolution if found, or `null` if not resolvable
+ * @throws Error if the package is found but doesn't export a valid compressor
+ */
+declare function tryResolveNpmPackage(name: string): Promise<CompressorResolution | null>;
+/**
+ * Try to resolve a compressor from a local file path.
+ *
+ * @param name - The local file path (e.g., "./my-compressor.js")
+ * @returns The resolved CompressorResolution if found, or `null` if not a local path
+ * @throws Error if the file is found but doesn't export a valid compressor
+ */
+declare function tryResolveLocalFile(name: string): Promise<CompressorResolution | null>;
+/**
+ * Resolve a compressor by name from a built-in @node-minify package, an installed npm package, or a local file path.
+ *
+ * @param name - Compressor identifier: a built-in name (e.g., "terser"), an npm package name, or a local path (e.g., "./compressor.js")
+ * @returns The resolved CompressorResolution containing the compressor function, a display `label`, and `isBuiltIn` flag
+ * @throws Error if the compressor cannot be found or the module does not export a valid compressor function
+ */
+declare function resolveCompressor(name: string): Promise<CompressorResolution>;
+/**
+ * Determines whether a compressor name corresponds to a known built-in compressor.
+ *
+ * @param name - The compressor identifier (e.g., built-in package name or alias)
+ * @returns `true` if the name corresponds to a known built-in compressor, `false` otherwise.
+ */
+declare function isBuiltInCompressor(name: string): boolean;
+/**
+ * Return the known exported symbol name for a built-in compressor package.
+ *
+ * @param name - The compressor package name (for example, `"esbuild"`, `"terser"`)
+ * @returns The export name used by the built-in package, or `undefined` if the compressor is not a known built-in
+ */
+declare function getKnownExportName(name: string): string | undefined;
+//#endregion
+export { CompressorResolution, getKnownExportName, isBuiltInCompressor, isLocalPath, resolveCompressor, tryResolveBuiltIn, tryResolveLocalFile, tryResolveNpmPackage };
+//# sourceMappingURL=compressor-resolver.d.ts.map

package/dist/compressor-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressor-resolver.d.ts","names":[],"sources":["../src/compressor-resolver.ts"],"sourcesContent":[],"mappings":";;;;AAmLA;AAsCA;AA8CA;AAsCgB,KAnQJ,oBAAA,GAmQuB;EAUnB;;;cAzQA;;;;;;;;;;;;;;;;iBAmBA,WAAA;;;;;;;iBA+EM,iBAAA,gBAEnB,QAAQ;;;;;;;;iBAiCW,oBAAA,gBAEnB,QAAQ;;;;;;;;iBAoCW,mBAAA,gBAEnB,QAAQ;;;;;;;;iBA4CW,iBAAA,gBAEnB,QAAQ;;;;;;;iBAoCK,mBAAA;;;;;;;iBAUA,kBAAA"}

package/dist/compressor-resolver.js

@@ -0,0 +1,183 @@
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+//#region src/compressor-resolver.ts
+/*!
+* node-minify
+* Copyright (c) 2011-2026 Rodolphe Stoclin
+* MIT Licensed
+*/
+/**
+* Known compressor exports for built-in @node-minify packages.
+* Maps package name to the exported function name.
+*/
+const KNOWN_COMPRESSOR_EXPORTS = {
+	esbuild: "esbuild",
+	"google-closure-compiler": "gcc",
+	oxc: "oxc",
+	swc: "swc",
+	terser: "terser",
+	"uglify-js": "uglifyJs",
+	"babel-minify": "babelMinify",
+	"uglify-es": "uglifyEs",
+	yui: "yui",
+	"clean-css": "cleanCss",
+	cssnano: "cssnano",
+	csso: "csso",
+	lightningcss: "lightningCss",
+	crass: "crass",
+	sqwish: "sqwish",
+	"html-minifier": "htmlMinifier",
+	"minify-html": "minifyHtml",
+	jsonminify: "jsonMinify",
+	imagemin: "imagemin",
+	sharp: "sharp",
+	svgo: "svgo",
+	"no-compress": "noCompress"
+};
+/**
+* Determines whether a string represents a local file path.
+*
+* @param name - The path string to test
+* @returns `true` if `name` appears to be a local file path, `false` otherwise
+*/
+function isLocalPath(name) {
+	return name.startsWith("./") || name.startsWith("../") || name.startsWith("/") || /^[a-zA-Z]:[/\\]/.test(name);
+}
+/**
+* Converts a package name to camelCase for export lookup.
+*
+* @param name - The package or file name to convert
+* @returns The input `name` converted to camelCase
+*/
+function toCamelCase(name) {
+	return name.replace(/[-_](.)/g, (_, char) => char.toUpperCase());
+}
+/**
+* Resolve a compressor function exported by a loaded module.
+*
+* @param mod - The imported module object to inspect for exports
+* @param name - The package or file name used to derive known and camelCase export names
+* @returns The resolved `Compressor` function if found, or `null` if no suitable function export exists
+*/
+function extractCompressor(mod, name) {
+	const knownExport = KNOWN_COMPRESSOR_EXPORTS[name];
+	if (knownExport && typeof mod[knownExport] === "function") return mod[knownExport];
+	const camelName = toCamelCase(name.includes("/") ? name.split("/").pop() ?? name : name);
+	if (typeof mod[camelName] === "function") return mod[camelName];
+	if (typeof mod.compressor === "function") return mod.compressor;
+	if (typeof mod.default === "function") return mod.default;
+	for (const value of Object.values(mod)) if (typeof value === "function") return value;
+	return null;
+}
+/**
+* Create a display label from a compressor package name or a local file path.
+*
+* @param name - Compressor npm package name or a local file path
+* @returns The package name for npm compressors, or the local file's basename without extension
+*/
+function generateLabel(name) {
+	if (isLocalPath(name)) return path.basename(name).replace(/\.(js|ts|mjs|cjs)$/, "");
+	return name;
+}
+/**
+* Try to resolve a compressor from a built-in @node-minify package.
+*
+* @param name - The compressor name (e.g., "terser", "esbuild")
+* @returns The resolved CompressorResolution if found, or `null` if not installed/available
+*/
+async function tryResolveBuiltIn(name) {
+	if (!(name in KNOWN_COMPRESSOR_EXPORTS)) return null;
+	try {
+		const compressor = extractCompressor(await import(`@node-minify/${name}`), name);
+		if (compressor) return {
+			compressor,
+			label: name,
+			isBuiltIn: true
+		};
+	} catch {}
+	return null;
+}
+/**
+* Try to resolve a compressor from an npm package.
+*
+* @param name - The npm package name
+* @returns The resolved CompressorResolution if found, or `null` if not resolvable
+* @throws Error if the package is found but doesn't export a valid compressor
+*/
+async function tryResolveNpmPackage(name) {
+	try {
+		const compressor = extractCompressor(await import(name), name);
+		if (compressor) return {
+			compressor,
+			label: generateLabel(name),
+			isBuiltIn: false
+		};
+		throw new Error(`Package '${name}' doesn't export a valid compressor function. Expected a function as default export, named export 'compressor', or named export '${toCamelCase(name)}'.`);
+	} catch (error) {
+		if (error instanceof Error && error.message.includes("doesn't export a valid compressor")) throw error;
+		return null;
+	}
+}
+/**
+* Try to resolve a compressor from a local file path.
+*
+* @param name - The local file path (e.g., "./my-compressor.js")
+* @returns The resolved CompressorResolution if found, or `null` if not a local path
+* @throws Error if the file is found but doesn't export a valid compressor
+*/
+async function tryResolveLocalFile(name) {
+	if (!isLocalPath(name)) return null;
+	try {
+		const compressor = extractCompressor(await import(pathToFileURL(path.resolve(process.cwd(), name)).href), name);
+		if (compressor) return {
+			compressor,
+			label: generateLabel(name),
+			isBuiltIn: false
+		};
+		throw new Error(`Local file '${name}' doesn't export a valid compressor function. Expected a function as default export or named export 'compressor'.`);
+	} catch (error) {
+		if (error instanceof Error && error.message.includes("doesn't export a valid compressor")) throw error;
+		throw new Error(`Could not load local compressor '${name}'. File not found or failed to import: ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+/**
+* Resolve a compressor by name from a built-in @node-minify package, an installed npm package, or a local file path.
+*
+* @param name - Compressor identifier: a built-in name (e.g., "terser"), an npm package name, or a local path (e.g., "./compressor.js")
+* @returns The resolved CompressorResolution containing the compressor function, a display `label`, and `isBuiltIn` flag
+* @throws Error if the compressor cannot be found or the module does not export a valid compressor function
+*/
+async function resolveCompressor(name) {
+	const builtIn = await tryResolveBuiltIn(name);
+	if (builtIn) return builtIn;
+	const npmPackage = await tryResolveNpmPackage(name);
+	if (npmPackage) return npmPackage;
+	if (isLocalPath(name)) {
+		const localFile = await tryResolveLocalFile(name);
+		if (localFile) return localFile;
+	}
+	throw new Error(`Could not resolve compressor '${name}'. Is it installed? For local files, use a path starting with './' or '/'.`);
+}
+/**
+* Determines whether a compressor name corresponds to a known built-in compressor.
+*
+* @param name - The compressor identifier (e.g., built-in package name or alias)
+* @returns `true` if the name corresponds to a known built-in compressor, `false` otherwise.
+*/
+function isBuiltInCompressor(name) {
+	return name in KNOWN_COMPRESSOR_EXPORTS;
+}
+/**
+* Return the known exported symbol name for a built-in compressor package.
+*
+* @param name - The compressor package name (for example, `"esbuild"`, `"terser"`)
+* @returns The export name used by the built-in package, or `undefined` if the compressor is not a known built-in
+*/
+function getKnownExportName(name) {
+	return KNOWN_COMPRESSOR_EXPORTS[name];
+}
+
+//#endregion
+export { getKnownExportName, isBuiltInCompressor, isLocalPath, resolveCompressor, tryResolveBuiltIn, tryResolveLocalFile, tryResolveNpmPackage };
+//# sourceMappingURL=compressor-resolver.js.map

package/dist/compressor-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressor-resolver.js","names":[],"sources":["../src/compressor-resolver.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport type { Compressor } from \"@node-minify/types\";\n\n/**\n * Known compressor exports for built-in @node-minify packages.\n * Maps package name to the exported function name.\n */\nconst KNOWN_COMPRESSOR_EXPORTS: Record<string, string> = {\n    esbuild: \"esbuild\",\n    \"google-closure-compiler\": \"gcc\",\n    oxc: \"oxc\",\n    swc: \"swc\",\n    terser: \"terser\",\n    \"uglify-js\": \"uglifyJs\",\n    \"babel-minify\": \"babelMinify\",\n    \"uglify-es\": \"uglifyEs\",\n    yui: \"yui\",\n    \"clean-css\": \"cleanCss\",\n    cssnano: \"cssnano\",\n    csso: \"csso\",\n    lightningcss: \"lightningCss\",\n    crass: \"crass\",\n    sqwish: \"sqwish\",\n    \"html-minifier\": \"htmlMinifier\",\n    \"minify-html\": \"minifyHtml\",\n    jsonminify: \"jsonMinify\",\n    imagemin: \"imagemin\",\n    sharp: \"sharp\",\n    svgo: \"svgo\",\n    \"no-compress\": \"noCompress\",\n};\n\n/**\n * Result from resolving a compressor.\n */\nexport type CompressorResolution = {\n    /**\n     * The resolved compressor function.\n     */\n    compressor: Compressor;\n\n    /**\n     * Label for the compressor (used in logs/reports).\n     */\n    label: string;\n\n    /**\n     * Whether this is a built-in @node-minify compressor.\n     */\n    isBuiltIn: boolean;\n};\n\n/**\n * Determines whether a string represents a local file path.\n *\n * @param name - The path string to test\n * @returns `true` if `name` appears to be a local file path, `false` otherwise\n */\nexport function isLocalPath(name: string): boolean {\n    return (\n        name.startsWith(\"./\") ||\n        name.startsWith(\"../\") ||\n        name.startsWith(\"/\") ||\n        /^[a-zA-Z]:[/\\\\]/.test(name)\n    );\n}\n\n/**\n * Converts a package name to camelCase for export lookup.\n *\n * @param name - The package or file name to convert\n * @returns The input `name` converted to camelCase\n */\nfunction toCamelCase(name: string): string {\n    return name.replace(/[-_](.)/g, (_, char) => char.toUpperCase());\n}\n\n/**\n * Resolve a compressor function exported by a loaded module.\n *\n * @param mod - The imported module object to inspect for exports\n * @param name - The package or file name used to derive known and camelCase export names\n * @returns The resolved `Compressor` function if found, or `null` if no suitable function export exists\n */\nfunction extractCompressor(\n    mod: Record<string, unknown>,\n    name: string\n): Compressor | null {\n    const knownExport = KNOWN_COMPRESSOR_EXPORTS[name];\n    if (knownExport && typeof mod[knownExport] === \"function\") {\n        return mod[knownExport] as Compressor;\n    }\n\n    const baseName = name.includes(\"/\")\n        ? (name.split(\"/\").pop() ?? name)\n        : name;\n    const camelName = toCamelCase(baseName);\n    if (typeof mod[camelName] === \"function\") {\n        return mod[camelName] as Compressor;\n    }\n\n    if (typeof mod.compressor === \"function\") {\n        return mod.compressor as Compressor;\n    }\n\n    if (typeof mod.default === \"function\") {\n        return mod.default as Compressor;\n    }\n\n    for (const value of Object.values(mod)) {\n        if (typeof value === \"function\") {\n            return value as Compressor;\n        }\n    }\n\n    return null;\n}\n\n/**\n * Create a display label from a compressor package name or a local file path.\n *\n * @param name - Compressor npm package name or a local file path\n * @returns The package name for npm compressors, or the local file's basename without extension\n */\nfunction generateLabel(name: string): string {\n    if (isLocalPath(name)) {\n        return path.basename(name).replace(/\\.(js|ts|mjs|cjs)$/, \"\");\n    }\n    return name;\n}\n\n/**\n * Try to resolve a compressor from a built-in @node-minify package.\n *\n * @param name - The compressor name (e.g., \"terser\", \"esbuild\")\n * @returns The resolved CompressorResolution if found, or `null` if not installed/available\n */\nexport async function tryResolveBuiltIn(\n    name: string\n): Promise<CompressorResolution | null> {\n    if (!(name in KNOWN_COMPRESSOR_EXPORTS)) {\n        return null;\n    }\n\n    try {\n        const mod = (await import(`@node-minify/${name}`)) as Record<\n            string,\n            unknown\n        >;\n        const compressor = extractCompressor(mod, name);\n\n        if (compressor) {\n            return {\n                compressor,\n                label: name,\n                isBuiltIn: true,\n            };\n        }\n    } catch {\n        // Built-in package not installed\n    }\n\n    return null;\n}\n\n/**\n * Try to resolve a compressor from an npm package.\n *\n * @param name - The npm package name\n * @returns The resolved CompressorResolution if found, or `null` if not resolvable\n * @throws Error if the package is found but doesn't export a valid compressor\n */\nexport async function tryResolveNpmPackage(\n    name: string\n): Promise<CompressorResolution | null> {\n    try {\n        const mod = (await import(name)) as Record<string, unknown>;\n        const compressor = extractCompressor(mod, name);\n\n        if (compressor) {\n            return {\n                compressor,\n                label: generateLabel(name),\n                isBuiltIn: false,\n            };\n        }\n\n        throw new Error(\n            `Package '${name}' doesn't export a valid compressor function. ` +\n                `Expected a function as default export, named export 'compressor', or ` +\n                `named export '${toCamelCase(name)}'.`\n        );\n    } catch (error) {\n        if (\n            error instanceof Error &&\n            error.message.includes(\"doesn't export a valid compressor\")\n        ) {\n            throw error;\n        }\n        return null;\n    }\n}\n\n/**\n * Try to resolve a compressor from a local file path.\n *\n * @param name - The local file path (e.g., \"./my-compressor.js\")\n * @returns The resolved CompressorResolution if found, or `null` if not a local path\n * @throws Error if the file is found but doesn't export a valid compressor\n */\nexport async function tryResolveLocalFile(\n    name: string\n): Promise<CompressorResolution | null> {\n    if (!isLocalPath(name)) {\n        return null;\n    }\n\n    try {\n        const absolutePath = path.resolve(process.cwd(), name);\n        const fileUrl = pathToFileURL(absolutePath).href;\n        const mod = (await import(fileUrl)) as Record<string, unknown>;\n        const compressor = extractCompressor(mod, name);\n\n        if (compressor) {\n            return {\n                compressor,\n                label: generateLabel(name),\n                isBuiltIn: false,\n            };\n        }\n\n        throw new Error(\n            `Local file '${name}' doesn't export a valid compressor function. ` +\n                `Expected a function as default export or named export 'compressor'.`\n        );\n    } catch (error) {\n        if (\n            error instanceof Error &&\n            error.message.includes(\"doesn't export a valid compressor\")\n        ) {\n            throw error;\n        }\n        throw new Error(\n            `Could not load local compressor '${name}'. ` +\n                `File not found or failed to import: ${error instanceof Error ? error.message : String(error)}`\n        );\n    }\n}\n\n/**\n * Resolve a compressor by name from a built-in @node-minify package, an installed npm package, or a local file path.\n *\n * @param name - Compressor identifier: a built-in name (e.g., \"terser\"), an npm package name, or a local path (e.g., \"./compressor.js\")\n * @returns The resolved CompressorResolution containing the compressor function, a display `label`, and `isBuiltIn` flag\n * @throws Error if the compressor cannot be found or the module does not export a valid compressor function\n */\nexport async function resolveCompressor(\n    name: string\n): Promise<CompressorResolution> {\n    // 1. Try built-in @node-minify package\n    const builtIn = await tryResolveBuiltIn(name);\n    if (builtIn) {\n        return builtIn;\n    }\n\n    // 2. Try as npm package\n    const npmPackage = await tryResolveNpmPackage(name);\n    if (npmPackage) {\n        return npmPackage;\n    }\n\n    // 3. Try as local file path (throws if file exists but has invalid exports)\n    if (isLocalPath(name)) {\n        const localFile = await tryResolveLocalFile(name);\n        if (localFile) {\n            return localFile;\n        }\n        // tryResolveLocalFile throws for local paths that can't be loaded,\n        // so reaching here means it returned null (which shouldn't happen\n        // after the isLocalPath guard, but we handle it defensively)\n    }\n\n    throw new Error(\n        `Could not resolve compressor '${name}'. ` +\n            `Is it installed? For local files, use a path starting with './' or '/'.`\n    );\n}\n\n/**\n * Determines whether a compressor name corresponds to a known built-in compressor.\n *\n * @param name - The compressor identifier (e.g., built-in package name or alias)\n * @returns `true` if the name corresponds to a known built-in compressor, `false` otherwise.\n */\nexport function isBuiltInCompressor(name: string): boolean {\n    return name in KNOWN_COMPRESSOR_EXPORTS;\n}\n\n/**\n * Return the known exported symbol name for a built-in compressor package.\n *\n * @param name - The compressor package name (for example, `\"esbuild\"`, `\"terser\"`)\n * @returns The export name used by the built-in package, or `undefined` if the compressor is not a known built-in\n */\nexport function getKnownExportName(name: string): string | undefined {\n    return KNOWN_COMPRESSOR_EXPORTS[name];\n}\n"],"mappings":"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"}

package/dist/deleteFile.d.ts

@@ -1,7 +1,7 @@
 //#region src/deleteFile.d.ts
 /*!
  * node-minify
- * Copyright(c) 2011-2025 Rodolphe Stoclin
+ * Copyright (c) 2011-2026 Rodolphe Stoclin
  * MIT Licensed
  */
 /**

package/dist/deleteFile.js

@@ -1,10 +1,10 @@
-import { t as FileOperationError } from "./error-Ck87RwDD.js";
+import { t as FileOperationError } from "./error-CUgKxOvI.js";
 import { existsSync, unlinkSync } from "node:fs";
 
 //#region src/deleteFile.ts
 /*!
 * node-minify
-* Copyright(c) 2011-2025 Rodolphe Stoclin
+* Copyright (c) 2011-2026 Rodolphe Stoclin
 * MIT Licensed
 */
 /**

package/dist/deleteFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"deleteFile.js","names":[],"sources":["../src/deleteFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { existsSync, unlinkSync } from \"node:fs\";\nimport { FileOperationError } from \"./error.ts\";\n\n/**\n * Delete file from the filesystem.\n * @param file Path to the file to delete\n * @throws {FileOperationError} If file doesn't exist or deletion fails\n * @example\n * deleteFile('path/to/file.js')\n */\nexport function deleteFile(file: string): void {\n    try {\n        if (!existsSync(file)) {\n            throw new Error(\"File does not exist\");\n        }\n        unlinkSync(file);\n    } catch (error) {\n        throw new FileOperationError(\"delete\", file, error as Error);\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,WAAW,MAAoB;AAC3C,KAAI;AACA,MAAI,CAAC,WAAW,KAAK,CACjB,OAAM,IAAI,MAAM,sBAAsB;AAE1C,aAAW,KAAK;UACX,OAAO;AACZ,QAAM,IAAI,mBAAmB,UAAU,MAAM,MAAe"}
+{"version":3,"file":"deleteFile.js","names":[],"sources":["../src/deleteFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { existsSync, unlinkSync } from \"node:fs\";\nimport { FileOperationError } from \"./error.ts\";\n\n/**\n * Delete file from the filesystem.\n * @param file Path to the file to delete\n * @throws {FileOperationError} If file doesn't exist or deletion fails\n * @example\n * deleteFile('path/to/file.js')\n */\nexport function deleteFile(file: string): void {\n    try {\n        if (!existsSync(file)) {\n            throw new Error(\"File does not exist\");\n        }\n        unlinkSync(file);\n    } catch (error) {\n        throw new FileOperationError(\"delete\", file, error as Error);\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,WAAW,MAAoB;AAC3C,KAAI;AACA,MAAI,CAAC,WAAW,KAAK,CACjB,OAAM,IAAI,MAAM,sBAAsB;AAE1C,aAAW,KAAK;UACX,OAAO;AACZ,QAAM,IAAI,mBAAmB,UAAU,MAAM,MAAe"}

package/dist/deprecation.d.ts

@@ -1,7 +1,7 @@
 //#region src/deprecation.d.ts
 /*!
  * node-minify
- * Copyright(c) 2011-2025 Rodolphe Stoclin
+ * Copyright (c) 2011-2026 Rodolphe Stoclin
  * MIT Licensed
  */
 /**

package/dist/deprecation.js

@@ -1,7 +1,7 @@
 //#region src/deprecation.ts
 /*!
 * node-minify
-* Copyright(c) 2011-2025 Rodolphe Stoclin
+* Copyright (c) 2011-2026 Rodolphe Stoclin
 * MIT Licensed
 */
 const warnedPackages = /* @__PURE__ */ new Set();

package/dist/deprecation.js.map

@@ -1 +1 @@
-{"version":3,"file":"deprecation.js","names":[],"sources":["../src/deprecation.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nconst warnedPackages = new Set<string>();\n\n/**\n * Show a deprecation warning for a package, but only once per process.\n * Subsequent calls with the same package name will be ignored.\n *\n * @param packageName - The package name (e.g., \"babel-minify\", \"uglify-es\")\n * @param message - The deprecation message explaining why and what to use instead\n *\n * @example\n * ```ts\n * warnDeprecation(\n *   \"babel-minify\",\n *   \"babel-minify uses Babel 6 which is no longer maintained. \" +\n *   \"Please migrate to @node-minify/terser for continued support.\"\n * );\n * ```\n */\nexport function warnDeprecation(packageName: string, message: string): void {\n    if (warnedPackages.has(packageName)) {\n        return;\n    }\n\n    warnedPackages.add(packageName);\n    console.warn(`[@node-minify/${packageName}] DEPRECATED: ${message}`);\n}\n\n/**\n * Reset the deprecation warning state.\n * Only intended for testing purposes.\n */\nexport function resetDeprecationWarnings(): void {\n    warnedPackages.clear();\n}\n"],"mappings":";;;;;;AAMA,MAAM,iCAAiB,IAAI,KAAa;;;;;;;;;;;;;;;;;AAkBxC,SAAgB,gBAAgB,aAAqB,SAAuB;AACxE,KAAI,eAAe,IAAI,YAAY,CAC/B;AAGJ,gBAAe,IAAI,YAAY;AAC/B,SAAQ,KAAK,iBAAiB,YAAY,gBAAgB,UAAU;;;;;;AAOxE,SAAgB,2BAAiC;AAC7C,gBAAe,OAAO"}
+{"version":3,"file":"deprecation.js","names":[],"sources":["../src/deprecation.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\nconst warnedPackages = new Set<string>();\n\n/**\n * Show a deprecation warning for a package, but only once per process.\n * Subsequent calls with the same package name will be ignored.\n *\n * @param packageName - The package name (e.g., \"babel-minify\", \"uglify-es\")\n * @param message - The deprecation message explaining why and what to use instead\n *\n * @example\n * ```ts\n * warnDeprecation(\n *   \"babel-minify\",\n *   \"babel-minify uses Babel 6 which is no longer maintained. \" +\n *   \"Please migrate to @node-minify/terser for continued support.\"\n * );\n * ```\n */\nexport function warnDeprecation(packageName: string, message: string): void {\n    if (warnedPackages.has(packageName)) {\n        return;\n    }\n\n    warnedPackages.add(packageName);\n    console.warn(`[@node-minify/${packageName}] DEPRECATED: ${message}`);\n}\n\n/**\n * Reset the deprecation warning state.\n * Only intended for testing purposes.\n */\nexport function resetDeprecationWarnings(): void {\n    warnedPackages.clear();\n}\n"],"mappings":";;;;;;AAMA,MAAM,iCAAiB,IAAI,KAAa;;;;;;;;;;;;;;;;;AAkBxC,SAAgB,gBAAgB,aAAqB,SAAuB;AACxE,KAAI,eAAe,IAAI,YAAY,CAC/B;AAGJ,gBAAe,IAAI,YAAY;AAC/B,SAAQ,KAAK,iBAAiB,YAAY,gBAAgB,UAAU;;;;;;AAOxE,SAAgB,2BAAiC;AAC7C,gBAAe,OAAO"}

package/dist/ensureStringContent.d.ts

@@ -1,7 +1,7 @@
 //#region src/ensureStringContent.d.ts
 /*!
  * node-minify
- * Copyright(c) 2011-2025 Rodolphe Stoclin
+ * Copyright (c) 2011-2026 Rodolphe Stoclin
  * MIT Licensed
  */
 /**

package/dist/ensureStringContent.js

@@ -1,7 +1,7 @@
 //#region src/ensureStringContent.ts
 /*!
 * node-minify
-* Copyright(c) 2011-2025 Rodolphe Stoclin
+* Copyright (c) 2011-2026 Rodolphe Stoclin
 * MIT Licensed
 */
 /**

package/dist/ensureStringContent.js.map

@@ -1 +1 @@
-{"version":3,"file":"ensureStringContent.js","names":[],"sources":["../src/ensureStringContent.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\n/**\n * Convert provided content to a string suitable for text-based compressors.\n *\n * @param content - The input content; a `Buffer` is converted to a string, `undefined` becomes an empty string, and a `Buffer[]` is rejected.\n * @param compressorName - Name used in the error message when array content is not supported.\n * @returns The content as a string; returns an empty string when `content` is `undefined`.\n * @throws Error if `content` is an array with message \"`<compressorName> compressor does not support array content`\".\n */\nexport function ensureStringContent(\n    content: string | Buffer | Buffer[] | undefined,\n    compressorName: string\n): string {\n    if (Array.isArray(content)) {\n        throw new Error(\n            `${compressorName} compressor does not support array content`\n        );\n    }\n\n    if (Buffer.isBuffer(content)) {\n        return content.toString();\n    }\n\n    return content ?? \"\";\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,oBACZ,SACA,gBACM;AACN,KAAI,MAAM,QAAQ,QAAQ,CACtB,OAAM,IAAI,MACN,GAAG,eAAe,4CACrB;AAGL,KAAI,OAAO,SAAS,QAAQ,CACxB,QAAO,QAAQ,UAAU;AAG7B,QAAO,WAAW"}
+{"version":3,"file":"ensureStringContent.js","names":[],"sources":["../src/ensureStringContent.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\n/**\n * Convert provided content to a string suitable for text-based compressors.\n *\n * @param content - The input content; a `Buffer` is converted to a string, `undefined` becomes an empty string, and a `Buffer[]` is rejected.\n * @param compressorName - Name used in the error message when array content is not supported.\n * @returns The content as a string; returns an empty string when `content` is `undefined`.\n * @throws Error if `content` is an array with message \"`<compressorName> compressor does not support array content`\".\n */\nexport function ensureStringContent(\n    content: string | Buffer | Buffer[] | undefined,\n    compressorName: string\n): string {\n    if (Array.isArray(content)) {\n        throw new Error(\n            `${compressorName} compressor does not support array content`\n        );\n    }\n\n    if (Buffer.isBuffer(content)) {\n        return content.toString();\n    }\n\n    return content ?? \"\";\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,oBACZ,SACA,gBACM;AACN,KAAI,MAAM,QAAQ,QAAQ,CACtB,OAAM,IAAI,MACN,GAAG,eAAe,4CACrB;AAGL,KAAI,OAAO,SAAS,QAAQ,CACxB,QAAO,QAAQ,UAAU;AAG7B,QAAO,WAAW"}

package/dist/{error-Ck87RwDD.js → error-CUgKxOvI.js}

@@ -1,7 +1,7 @@
 //#region src/error.ts
 /*!
 * node-minify
-* Copyright(c) 2011-2025 Rodolphe Stoclin
+* Copyright (c) 2011-2026 Rodolphe Stoclin
 * MIT Licensed
 */
 /**
@@ -9,9 +9,11 @@
 * @extends Error
 */
 var FileOperationError = class extends Error {
+	cause;
 	constructor(operation, path, originalError) {
-		super(`Failed to ${operation} file ${path}: ${originalError?.message || ""}`);
+		super(`Failed to ${operation} file ${path}: ${originalError?.message || ""}`, originalError ? { cause: originalError } : void 0);
 		this.name = "FileOperationError";
+		if (originalError && !this.cause) this.cause = originalError;
 	}
 };
 /**
@@ -27,4 +29,4 @@ var ValidationError = class extends Error {
 
 //#endregion
 export { ValidationError as n, FileOperationError as t };
-//# sourceMappingURL=error-Ck87RwDD.js.map
+//# sourceMappingURL=error-CUgKxOvI.js.map

package/dist/error-CUgKxOvI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-CUgKxOvI.js","names":[],"sources":["../src/error.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\n/**\n * Error class for file operation failures.\n * @extends Error\n */\nexport class FileOperationError extends Error {\n    override cause?: Error;\n\n    constructor(operation: string, path: string, originalError?: Error) {\n        super(\n            `Failed to ${operation} file ${path}: ${originalError?.message || \"\"}`,\n            originalError ? { cause: originalError } : undefined\n        );\n        this.name = \"FileOperationError\";\n        // For older runtimes that don't support the cause option\n        if (originalError && !this.cause) {\n            this.cause = originalError;\n        }\n    }\n}\n\n/**\n * Error class for validation failures.\n * @extends Error\n */\nexport class ValidationError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ValidationError\";\n    }\n}\n"],"mappings":";;;;;;;;;;AAUA,IAAa,qBAAb,cAAwC,MAAM;CAC1C,AAAS;CAET,YAAY,WAAmB,MAAc,eAAuB;AAChE,QACI,aAAa,UAAU,QAAQ,KAAK,IAAI,eAAe,WAAW,MAClE,gBAAgB,EAAE,OAAO,eAAe,GAAG,OAC9C;AACD,OAAK,OAAO;AAEZ,MAAI,iBAAiB,CAAC,KAAK,MACvB,MAAK,QAAQ;;;;;;;AASzB,IAAa,kBAAb,cAAqC,MAAM;CACvC,YAAY,SAAiB;AACzB,QAAM,QAAQ;AACd,OAAK,OAAO"}

package/dist/error.d.ts

@@ -1,7 +1,7 @@
 //#region src/error.d.ts
 /*!
  * node-minify
- * Copyright(c) 2011-2025 Rodolphe Stoclin
+ * Copyright (c) 2011-2026 Rodolphe Stoclin
  * MIT Licensed
  */
 /**
@@ -9,6 +9,7 @@
  * @extends Error
  */
 declare class FileOperationError extends Error {
+  cause?: Error;
   constructor(operation: string, path: string, originalError?: Error);
 }
 /**

package/dist/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","names":[],"sources":["../src/error.ts"],"sourcesContent":[],"mappings":";;AAUA;AAaA;;;;;;;cAba,kBAAA,SAA2B,KAAA;+DACyB;;;;;;cAYpD,eAAA,SAAwB,KAAA"}
+{"version":3,"file":"error.d.ts","names":[],"sources":["../src/error.ts"],"sourcesContent":[],"mappings":";;AAUA;;;;;AAoBA;;;cApBa,kBAAA,SAA2B,KAAA;UACnB;+DAE4C;;;;;;cAiBpD,eAAA,SAAwB,KAAA"}

package/dist/error.js

@@ -1,3 +1,3 @@
-import { n as ValidationError, t as FileOperationError } from "./error-Ck87RwDD.js";
+import { n as ValidationError, t as FileOperationError } from "./error-CUgKxOvI.js";
 
 export { FileOperationError, ValidationError };

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+//#region src/errors.d.ts
+/*!
+ * node-minify
+ * Copyright (c) 2011-2026 Rodolphe Stoclin
+ * MIT Licensed
+ */
+/**
+ * Wraps an error thrown during minification with a consistent, descriptive message.
+ *
+ * @param compressorName - The name of the compressor that failed
+ * @param error - The original error (unknown type for proper catch handling)
+ * @returns A new Error with a standardized message format
+ */
+declare function wrapMinificationError(compressorName: string, error: unknown): Error;
+/**
+ * Validates that a minification result contains valid output.
+ *
+ * @param result - The result object to validate
+ * @param compressorName - The name of the compressor (for error messages)
+ * @throws Error if result is falsy or result.code is not a string
+ */
+declare function validateMinifyResult(result: unknown, compressorName: string): asserts result is {
+  code: string;
+};
+//#endregion
+export { validateMinifyResult, wrapMinificationError };
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../src/errors.ts"],"sourcesContent":[],"mappings":";;AAaA;AAkBA;;;;;;;;;;iBAlBgB,qBAAA,0CAGb;;;;;;;;iBAea,oBAAA"}

package/dist/errors.js

@@ -0,0 +1,32 @@
+//#region src/errors.ts
+/*!
+* node-minify
+* Copyright (c) 2011-2026 Rodolphe Stoclin
+* MIT Licensed
+*/
+/**
+* Wraps an error thrown during minification with a consistent, descriptive message.
+*
+* @param compressorName - The name of the compressor that failed
+* @param error - The original error (unknown type for proper catch handling)
+* @returns A new Error with a standardized message format
+*/
+function wrapMinificationError(compressorName, error) {
+	const message = error instanceof Error ? error.message : String(error);
+	const cause = error instanceof Error ? error : void 0;
+	return new Error(`${compressorName} minification failed: ${message}`, { cause });
+}
+/**
+* Validates that a minification result contains valid output.
+*
+* @param result - The result object to validate
+* @param compressorName - The name of the compressor (for error messages)
+* @throws Error if result is falsy or result.code is not a string
+*/
+function validateMinifyResult(result, compressorName) {
+	if (!result || typeof result !== "object" || !("code" in result) || typeof result.code !== "string") throw new Error(`${compressorName} failed: empty or invalid result`);
+}
+
+//#endregion
+export { validateMinifyResult, wrapMinificationError };
+//# sourceMappingURL=errors.js.map