@node-minify/utils 10.1.0 → 10.2.0

package/README.md

@@ -1,13 +1,13 @@
-<p align="center"><img src="/static/node-minify.svg" width="348" alt="node-minify"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/srod/node-minify/main/static/node-minify.svg" width="348" alt="node-minify"></p>
 
 <p align="center">A very light minifier Node.js module.</p>
 
 <p align="center">
   <br>
-  <a href="https://npmjs.org/package/@node-minify/utils"><img src="https://img.shields.io/npm/v/@node-minify/utils.svg"></a>
-  <a href="https://npmjs.org/package/@node-minify/utils"><img src="https://img.shields.io/npm/dm/@node-minify/utils.svg"></a>
+  <a href="https://npmjs.org/package/@node-minify/utils"><img src="https://img.shields.io/npm/v/@node-minify/utils.svg" alt="npm version"></a>
+  <a href="https://npmjs.org/package/@node-minify/utils"><img src="https://img.shields.io/npm/dm/@node-minify/utils.svg" alt="npm downloads"></a>
   <a href="https://github.com/srod/node-minify/actions"><img alt="Build Status" src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fsrod%2Fnode-minify%2Fbadge%3Fref%3Dmain&style=flat" /></a>
-  <a href="https://codecov.io/gh/srod/node-minify"><img src="https://codecov.io/gh/srod/node-minify/branch/main/graph/badge.svg"></a>
+  <a href="https://codecov.io/gh/srod/node-minify"><img src="https://codecov.io/gh/srod/node-minify/branch/main/graph/badge.svg" alt="code coverage"></a>
 </p>
 
 # @node-minify/utils

package/dist/buildArgs.js

@@ -1,4 +1,4 @@
-import { n as ValidationError } from "./error-B_uK-F18.js";
+import { n as ValidationError } from "./error-Ck87RwDD.js";
 
 //#region src/buildArgs.ts
 /*!

package/dist/compressSingleFile.d.ts

@@ -1,12 +1,14 @@
-import { t as Settings } from "./types-DtDQlx-T.js";
+import { r as Settings, t as CompressorOptions } from "./types-BUlX1Zbb.js";
 
 //#region src/compressSingleFile.d.ts
 
 /**
- * Compress a single file.
- * @param settings Settings
+ * Compress a single file using the provided settings.
+ *
+ * @param settings - Configuration that specifies input content or input path(s) and compressor options
+ * @returns The compressed output as a string
  */
-declare function compressSingleFile(settings: Settings): Promise<string>;
+declare function compressSingleFile<T extends CompressorOptions = CompressorOptions>(settings: Settings<T>): Promise<string>;
 //#endregion
 export { compressSingleFile };
 //# sourceMappingURL=compressSingleFile.d.ts.map

package/dist/compressSingleFile.d.ts.map

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

package/dist/compressSingleFile.js

@@ -1,25 +1,69 @@
-import { getContentFromFiles } from "./getContentFromFiles.js";
+import { getContentFromFilesAsync } from "./getContentFromFiles.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.
-* @param settings Settings
+* Compress a single file using the provided settings.
+*
+* @param settings - Configuration that specifies input content or input path(s) and compressor options
+* @returns The compressed output as a string
 */
 async function compressSingleFile(settings) {
 	return run({
 		settings,
-		content: determineContent(settings)
+		content: await determineContent(settings)
 	});
 }
 /**
-* Determine the content to minify.
-* @param settings - Minification settings
-* @returns Content string to minify
+* Resolve the content to be minified from the provided settings.
+*
+* @param settings - Settings that may contain `content` or `input` (string or string[]); `content` is used preferentially.
+* @returns The resolved content: a `string` for text input, a `Buffer` for a single image file, or a `Buffer[]` for multiple image files.
+* @throws Error - If `settings.input` is an array that mixes image and non-image file paths.
 */
-function determineContent(settings) {
+async function determineContent(settings) {
 	if (settings.content) return settings.content;
-	if (settings.input) return getContentFromFiles(settings.input);
+	if (settings.input && Array.isArray(settings.input)) {
+		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)));
+		}
+	}
+	if (settings.input && typeof settings.input === "string") {
+		if (isImageFile(settings.input)) return await readFile(settings.input);
+	}
+	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 type { Settings } from \"@node-minify/types\";\nimport { getContentFromFiles } from \"./getContentFromFiles.ts\";\nimport { run } from \"./run.ts\";\n\n/**\n * Compress a single file.\n * @param settings Settings\n */\nexport async function compressSingleFile(settings: Settings): Promise<string> {\n    const content = determineContent(settings);\n    return run({ settings, content });\n}\n\n/**\n * Determine the content to minify.\n * @param settings - Minification settings\n * @returns Content string to minify\n */\nfunction determineContent(settings: Settings): string {\n    if (settings.content) {\n        return settings.content;\n    }\n\n    if (settings.input) {\n        return getContentFromFiles(settings.input);\n    }\n\n    return \"\";\n}\n"],"mappings":";;;;;;;;AAcA,eAAsB,mBAAmB,UAAqC;AAE1E,QAAO,IAAI;EAAE;EAAU,SADP,iBAAiB,SAAS;EACV,CAAC;;;;;;;AAQrC,SAAS,iBAAiB,UAA4B;AAClD,KAAI,SAAS,QACT,QAAO,SAAS;AAGpB,KAAI,SAAS,MACT,QAAO,oBAAoB,SAAS,MAAM;AAG9C,QAAO"}
+{"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"}

package/dist/deleteFile.js

@@ -1,4 +1,4 @@
-import { t as FileOperationError } from "./error-B_uK-F18.js";
+import { t as FileOperationError } from "./error-Ck87RwDD.js";
 import { existsSync, unlinkSync } from "node:fs";
 
 //#region src/deleteFile.ts

package/dist/ensureStringContent.d.ts

@@ -0,0 +1,18 @@
+//#region src/ensureStringContent.d.ts
+/*!
+ * node-minify
+ * Copyright(c) 2011-2025 Rodolphe Stoclin
+ * MIT Licensed
+ */
+/**
+ * Convert provided content to a string suitable for text-based compressors.
+ *
+ * @param content - The input content; a `Buffer` is converted to a string, `undefined` becomes an empty string, and a `Buffer[]` is rejected.
+ * @param compressorName - Name used in the error message when array content is not supported.
+ * @returns The content as a string; returns an empty string when `content` is `undefined`.
+ * @throws Error if `content` is an array with message "`<compressorName> compressor does not support array content`".
+ */
+declare function ensureStringContent(content: string | Buffer | Buffer[] | undefined, compressorName: string): string;
+//#endregion
+export { ensureStringContent };
+//# sourceMappingURL=ensureStringContent.d.ts.map

package/dist/ensureStringContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureStringContent.d.ts","names":[],"sources":["../src/ensureStringContent.ts"],"sourcesContent":[],"mappings":";;AAcA;;;;;;;;;;;;iBAAgB,mBAAA,mBACM,SAAS"}

package/dist/ensureStringContent.js

@@ -0,0 +1,23 @@
+//#region src/ensureStringContent.ts
+/*!
+* node-minify
+* Copyright(c) 2011-2025 Rodolphe Stoclin
+* MIT Licensed
+*/
+/**
+* Convert provided content to a string suitable for text-based compressors.
+*
+* @param content - The input content; a `Buffer` is converted to a string, `undefined` becomes an empty string, and a `Buffer[]` is rejected.
+* @param compressorName - Name used in the error message when array content is not supported.
+* @returns The content as a string; returns an empty string when `content` is `undefined`.
+* @throws Error if `content` is an array with message "`<compressorName> compressor does not support array content`".
+*/
+function ensureStringContent(content, compressorName) {
+	if (Array.isArray(content)) throw new Error(`${compressorName} compressor does not support array content`);
+	if (Buffer.isBuffer(content)) return content.toString();
+	return content ?? "";
+}
+
+//#endregion
+export { ensureStringContent };
+//# sourceMappingURL=ensureStringContent.js.map

package/dist/ensureStringContent.js.map

@@ -0,0 +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"}

package/dist/{error-B_uK-F18.js → error-Ck87RwDD.js}

@@ -27,4 +27,4 @@ var ValidationError = class extends Error {
 
 //#endregion
 export { ValidationError as n, FileOperationError as t };
-//# sourceMappingURL=error-B_uK-F18.js.map
+//# sourceMappingURL=error-Ck87RwDD.js.map

package/dist/{error-B_uK-F18.js.map → error-Ck87RwDD.js.map}

@@ -1 +1 @@
-{"version":3,"file":"error-B_uK-F18.js","names":[],"sources":["../src/error.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 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    constructor(operation: string, path: string, originalError?: Error) {\n        super(\n            `Failed to ${operation} file ${path}: ${originalError?.message || \"\"}`\n        );\n        this.name = \"FileOperationError\";\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,YAAY,WAAmB,MAAc,eAAuB;AAChE,QACI,aAAa,UAAU,QAAQ,KAAK,IAAI,eAAe,WAAW,KACrE;AACD,OAAK,OAAO;;;;;;;AAQpB,IAAa,kBAAb,cAAqC,MAAM;CACvC,YAAY,SAAiB;AACzB,QAAM,QAAQ;AACd,OAAK,OAAO"}
+{"version":3,"file":"error-Ck87RwDD.js","names":[],"sources":["../src/error.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 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    constructor(operation: string, path: string, originalError?: Error) {\n        super(\n            `Failed to ${operation} file ${path}: ${originalError?.message || \"\"}`\n        );\n        this.name = \"FileOperationError\";\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,YAAY,WAAmB,MAAc,eAAuB;AAChE,QACI,aAAa,UAAU,QAAQ,KAAK,IAAI,eAAe,WAAW,KACrE;AACD,OAAK,OAAO;;;;;;;AAQpB,IAAa,kBAAb,cAAqC,MAAM;CACvC,YAAY,SAAiB;AACzB,QAAM,QAAQ;AACd,OAAK,OAAO"}

package/dist/error.js

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

package/dist/getContentFromFiles.d.ts

@@ -14,6 +14,15 @@
  * getContentFromFiles(['file1.js', 'file2.js'])
  */
 declare function getContentFromFiles(input: string | string[]): string;
+/**
+ * Concatenate contents of one or more files asynchronously.
+ *
+ * @param input - A file path or an array of file paths to read
+ * @returns The files' contents joined with newline characters
+ * @throws {FileOperationError} If an underlying file operation fails for any path
+ * @throws {Error} If `input` is missing or processing of the provided input fails
+ */
+declare function getContentFromFilesAsync(input: string | string[]): Promise<string>;
 //#endregion
-export { getContentFromFiles };
+export { getContentFromFiles, getContentFromFilesAsync };
 //# sourceMappingURL=getContentFromFiles.d.ts.map

package/dist/getContentFromFiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getContentFromFiles.d.ts","names":[],"sources":["../src/getContentFromFiles.ts"],"sourcesContent":[],"mappings":";;AAuCA;;;;;;;;;;;;;iBAAgB,mBAAA"}
+{"version":3,"file":"getContentFromFiles.d.ts","names":[],"sources":["../src/getContentFromFiles.ts"],"sourcesContent":[],"mappings":";;AAuDA;AAiCA;;;;;;;;;;;;iBAjCgB,mBAAA;;;;;;;;;iBAiCM,wBAAA,4BAEnB"}

package/dist/getContentFromFiles.js

@@ -1,5 +1,6 @@
-import { t as FileOperationError } from "./error-B_uK-F18.js";
-import { t as isValidFile } from "./isValidFile-UAwceQud.js";
+import { t as FileOperationError } from "./error-Ck87RwDD.js";
+import { t as isValidFile } from "./isValidFile-DnWJtlKA.js";
+import { readFile } from "node:fs/promises";
 import { existsSync, readFileSync } from "node:fs";
 
 //#region src/getContentFromFiles.ts
@@ -24,6 +25,20 @@ function readFileContent(path) {
 	}
 }
 /**
+* Read the UTF-8 content of a single file.
+*
+* @param path - Filesystem path to the file
+* @returns The file content as a string
+* @throws FileOperationError if the file does not exist, the path is a directory, or reading the file fails
+*/
+async function readFileContentAsync(path) {
+	try {
+		return await readFile(path, "utf8");
+	} catch (error) {
+		throw new FileOperationError("read", path, error);
+	}
+}
+/**
 * Concatenate all input files and get the data.
 * @param input Single file path or array of file paths
 * @returns Concatenated content of all files
@@ -43,7 +58,26 @@ function getContentFromFiles(input) {
 		throw new Error(`Failed to process input files: ${error instanceof Error ? error.message : String(error)}`);
 	}
 }
+/**
+* Concatenate contents of one or more files asynchronously.
+*
+* @param input - A file path or an array of file paths to read
+* @returns The files' contents joined with newline characters
+* @throws {FileOperationError} If an underlying file operation fails for any path
+* @throws {Error} If `input` is missing or processing of the provided input fails
+*/
+async function getContentFromFilesAsync(input) {
+	try {
+		if (!input) throw new Error("Input must be a string or array of strings");
+		if (!Array.isArray(input)) return await readFileContentAsync(input);
+		if (input.length === 0) return "";
+		return (await Promise.all(input.map(readFileContentAsync))).join("\n");
+	} catch (error) {
+		if (error instanceof FileOperationError) throw error;
+		throw new Error(`Failed to process input files: ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
 
 //#endregion
-export { getContentFromFiles };
+export { getContentFromFiles, getContentFromFilesAsync };
 //# sourceMappingURL=getContentFromFiles.js.map

package/dist/getContentFromFiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"getContentFromFiles.js","names":["error: unknown"],"sources":["../src/getContentFromFiles.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { FileOperationError } from \"./error.ts\";\nimport { isValidFile } from \"./isValidFile.ts\";\n\n/**\n * Read content from a single file with error handling.\n * @param path Path to the file\n * @returns Content of the file\n * @throws {FileOperationError} If file doesn't exist or reading fails\n */\nfunction readFileContent(path: string): string {\n    try {\n        if (!existsSync(path)) {\n            throw new Error(\"File does not exist\");\n        }\n        if (!isValidFile(path)) {\n            throw new Error(\"Path is not a valid file\");\n        }\n        return readFileSync(path, \"utf8\");\n    } catch (error) {\n        throw new FileOperationError(\"read\", path, error as Error);\n    }\n}\n\n/**\n * Concatenate all input files and get the data.\n * @param input Single file path or array of file paths\n * @returns Concatenated content of all files\n * @throws {FileOperationError} If any file operation fails\n * @example\n * getContentFromFiles('file.js')\n * getContentFromFiles(['file1.js', 'file2.js'])\n */\nexport function getContentFromFiles(input: string | string[]): string {\n    try {\n        if (!input) {\n            throw new Error(\"Input must be a string or array of strings\");\n        }\n\n        if (!Array.isArray(input)) {\n            return readFileContent(input);\n        }\n\n        if (input.length === 0) {\n            return \"\";\n        }\n\n        return input.map(readFileContent).join(\"\\n\");\n    } catch (error: unknown) {\n        if (error instanceof FileOperationError) {\n            throw error;\n        }\n        throw new Error(\n            `Failed to process input files: ${error instanceof Error ? error.message : String(error)}`\n        );\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAS,gBAAgB,MAAsB;AAC3C,KAAI;AACA,MAAI,CAAC,WAAW,KAAK,CACjB,OAAM,IAAI,MAAM,sBAAsB;AAE1C,MAAI,CAAC,YAAY,KAAK,CAClB,OAAM,IAAI,MAAM,2BAA2B;AAE/C,SAAO,aAAa,MAAM,OAAO;UAC5B,OAAO;AACZ,QAAM,IAAI,mBAAmB,QAAQ,MAAM,MAAe;;;;;;;;;;;;AAalE,SAAgB,oBAAoB,OAAkC;AAClE,KAAI;AACA,MAAI,CAAC,MACD,OAAM,IAAI,MAAM,6CAA6C;AAGjE,MAAI,CAAC,MAAM,QAAQ,MAAM,CACrB,QAAO,gBAAgB,MAAM;AAGjC,MAAI,MAAM,WAAW,EACjB,QAAO;AAGX,SAAO,MAAM,IAAI,gBAAgB,CAAC,KAAK,KAAK;UACvCA,OAAgB;AACrB,MAAI,iBAAiB,mBACjB,OAAM;AAEV,QAAM,IAAI,MACN,kCAAkC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAC3F"}
+{"version":3,"file":"getContentFromFiles.js","names":["error: unknown"],"sources":["../src/getContentFromFiles.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { FileOperationError } from \"./error.ts\";\nimport { isValidFile } from \"./isValidFile.ts\";\n\n/**\n * Read content from a single file with error handling.\n * @param path Path to the file\n * @returns Content of the file\n * @throws {FileOperationError} If file doesn't exist or reading fails\n */\nfunction readFileContent(path: string): string {\n    try {\n        if (!existsSync(path)) {\n            throw new Error(\"File does not exist\");\n        }\n        if (!isValidFile(path)) {\n            throw new Error(\"Path is not a valid file\");\n        }\n        return readFileSync(path, \"utf8\");\n    } catch (error) {\n        throw new FileOperationError(\"read\", path, error as Error);\n    }\n}\n\n/**\n * Read the UTF-8 content of a single file.\n *\n * @param path - Filesystem path to the file\n * @returns The file content as a string\n * @throws FileOperationError if the file does not exist, the path is a directory, or reading the file fails\n */\nasync function readFileContentAsync(path: string): Promise<string> {\n    try {\n        return await readFile(path, \"utf8\");\n    } catch (error) {\n        throw new FileOperationError(\"read\", path, error as Error);\n    }\n}\n\n/**\n * Concatenate all input files and get the data.\n * @param input Single file path or array of file paths\n * @returns Concatenated content of all files\n * @throws {FileOperationError} If any file operation fails\n * @example\n * getContentFromFiles('file.js')\n * getContentFromFiles(['file1.js', 'file2.js'])\n */\nexport function getContentFromFiles(input: string | string[]): string {\n    try {\n        if (!input) {\n            throw new Error(\"Input must be a string or array of strings\");\n        }\n\n        if (!Array.isArray(input)) {\n            return readFileContent(input);\n        }\n\n        if (input.length === 0) {\n            return \"\";\n        }\n\n        return input.map(readFileContent).join(\"\\n\");\n    } catch (error: unknown) {\n        if (error instanceof FileOperationError) {\n            throw error;\n        }\n        throw new Error(\n            `Failed to process input files: ${error instanceof Error ? error.message : String(error)}`\n        );\n    }\n}\n\n/**\n * Concatenate contents of one or more files asynchronously.\n *\n * @param input - A file path or an array of file paths to read\n * @returns The files' contents joined with newline characters\n * @throws {FileOperationError} If an underlying file operation fails for any path\n * @throws {Error} If `input` is missing or processing of the provided input fails\n */\nexport async function getContentFromFilesAsync(\n    input: string | string[]\n): Promise<string> {\n    try {\n        if (!input) {\n            throw new Error(\"Input must be a string or array of strings\");\n        }\n\n        if (!Array.isArray(input)) {\n            return await readFileContentAsync(input);\n        }\n\n        if (input.length === 0) {\n            return \"\";\n        }\n\n        // Read files in parallel\n        const contents = await Promise.all(input.map(readFileContentAsync));\n        return contents.join(\"\\n\");\n    } catch (error: unknown) {\n        if (error instanceof FileOperationError) {\n            throw error;\n        }\n        throw new Error(\n            `Failed to process input files: ${error instanceof Error ? error.message : String(error)}`\n        );\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,SAAS,gBAAgB,MAAsB;AAC3C,KAAI;AACA,MAAI,CAAC,WAAW,KAAK,CACjB,OAAM,IAAI,MAAM,sBAAsB;AAE1C,MAAI,CAAC,YAAY,KAAK,CAClB,OAAM,IAAI,MAAM,2BAA2B;AAE/C,SAAO,aAAa,MAAM,OAAO;UAC5B,OAAO;AACZ,QAAM,IAAI,mBAAmB,QAAQ,MAAM,MAAe;;;;;;;;;;AAWlE,eAAe,qBAAqB,MAA+B;AAC/D,KAAI;AACA,SAAO,MAAM,SAAS,MAAM,OAAO;UAC9B,OAAO;AACZ,QAAM,IAAI,mBAAmB,QAAQ,MAAM,MAAe;;;;;;;;;;;;AAalE,SAAgB,oBAAoB,OAAkC;AAClE,KAAI;AACA,MAAI,CAAC,MACD,OAAM,IAAI,MAAM,6CAA6C;AAGjE,MAAI,CAAC,MAAM,QAAQ,MAAM,CACrB,QAAO,gBAAgB,MAAM;AAGjC,MAAI,MAAM,WAAW,EACjB,QAAO;AAGX,SAAO,MAAM,IAAI,gBAAgB,CAAC,KAAK,KAAK;UACvCA,OAAgB;AACrB,MAAI,iBAAiB,mBACjB,OAAM;AAEV,QAAM,IAAI,MACN,kCAAkC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAC3F;;;;;;;;;;;AAYT,eAAsB,yBAClB,OACe;AACf,KAAI;AACA,MAAI,CAAC,MACD,OAAM,IAAI,MAAM,6CAA6C;AAGjE,MAAI,CAAC,MAAM,QAAQ,MAAM,CACrB,QAAO,MAAM,qBAAqB,MAAM;AAG5C,MAAI,MAAM,WAAW,EACjB,QAAO;AAKX,UADiB,MAAM,QAAQ,IAAI,MAAM,IAAI,qBAAqB,CAAC,EACnD,KAAK,KAAK;UACrBA,OAAgB;AACrB,MAAI,iBAAiB,mBACjB,OAAM;AAEV,QAAM,IAAI,MACN,kCAAkC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAC3F"}

package/dist/getFilesizeGzippedInBytes.js

@@ -1,5 +1,5 @@
-import { t as FileOperationError } from "./error-B_uK-F18.js";
-import { t as isValidFile } from "./isValidFile-UAwceQud.js";
+import { t as FileOperationError } from "./error-Ck87RwDD.js";
+import { t as isValidFile } from "./isValidFile-DnWJtlKA.js";
 import { prettyBytes } from "./prettyBytes.js";
 import { createReadStream, existsSync } from "node:fs";
 

package/dist/index.d.ts

@@ -3,10 +3,11 @@ import { buildArgs, toBuildArgsOptions } from "./buildArgs.js";
 import { compressSingleFile } from "./compressSingleFile.js";
 import { deleteFile } from "./deleteFile.js";
 import { resetDeprecationWarnings, warnDeprecation } from "./deprecation.js";
-import { getContentFromFiles } from "./getContentFromFiles.js";
+import { ensureStringContent } from "./ensureStringContent.js";
+import { getContentFromFiles, getContentFromFilesAsync } from "./getContentFromFiles.js";
 import { getFilesizeGzippedInBytes } from "./getFilesizeGzippedInBytes.js";
 import { getFilesizeInBytes } from "./getFilesizeInBytes.js";
-import { isValidFile } from "./isValidFile.js";
+import { isValidFile, isValidFileAsync } from "./isValidFile.js";
 import { prettyBytes } from "./prettyBytes.js";
 import { readFile } from "./readFile.js";
 import { run } from "./run.js";
@@ -14,4 +15,4 @@ import { setFileNameMin } from "./setFileNameMin.js";
 import { setPublicFolder } from "./setPublicFolder.js";
 import { wildcards } from "./wildcards.js";
 import { writeFile } from "./writeFile.js";
-export { type BuildArgsOptions, buildArgs, compressSingleFile, deleteFile, getContentFromFiles, getFilesizeGzippedInBytes, getFilesizeInBytes, isValidFile, prettyBytes, readFile, resetDeprecationWarnings, run, setFileNameMin, setPublicFolder, toBuildArgsOptions, warnDeprecation, wildcards, writeFile };
+export { type BuildArgsOptions, buildArgs, compressSingleFile, deleteFile, ensureStringContent, getContentFromFiles, getContentFromFilesAsync, getFilesizeGzippedInBytes, getFilesizeInBytes, isValidFile, isValidFileAsync, prettyBytes, readFile, resetDeprecationWarnings, run, setFileNameMin, setPublicFolder, toBuildArgsOptions, warnDeprecation, wildcards, writeFile };

package/dist/index.js

@@ -1,11 +1,12 @@
 import { buildArgs, toBuildArgsOptions } from "./buildArgs.js";
-import { t as isValidFile } from "./isValidFile-UAwceQud.js";
-import { getContentFromFiles } from "./getContentFromFiles.js";
-import { t as writeFile } from "./writeFile-CwK9ZWXr.js";
+import { n as isValidFileAsync, t as isValidFile } from "./isValidFile-DnWJtlKA.js";
+import { getContentFromFiles, getContentFromFilesAsync } from "./getContentFromFiles.js";
+import { t as writeFile } from "./writeFile-BRfs9FqY.js";
 import { run } from "./run.js";
 import { compressSingleFile } from "./compressSingleFile.js";
 import { deleteFile } from "./deleteFile.js";
 import { resetDeprecationWarnings, warnDeprecation } from "./deprecation.js";
+import { ensureStringContent } from "./ensureStringContent.js";
 import { prettyBytes } from "./prettyBytes.js";
 import { getFilesizeGzippedInBytes } from "./getFilesizeGzippedInBytes.js";
 import { getFilesizeInBytes } from "./getFilesizeInBytes.js";
@@ -14,4 +15,4 @@ import { setFileNameMin } from "./setFileNameMin.js";
 import { setPublicFolder } from "./setPublicFolder.js";
 import { wildcards } from "./wildcards.js";
 
-export { buildArgs, compressSingleFile, deleteFile, getContentFromFiles, getFilesizeGzippedInBytes, getFilesizeInBytes, isValidFile, prettyBytes, readFile, resetDeprecationWarnings, run, setFileNameMin, setPublicFolder, toBuildArgsOptions, warnDeprecation, wildcards, writeFile };
+export { buildArgs, compressSingleFile, deleteFile, ensureStringContent, getContentFromFiles, getContentFromFilesAsync, getFilesizeGzippedInBytes, getFilesizeInBytes, isValidFile, isValidFileAsync, prettyBytes, readFile, resetDeprecationWarnings, run, setFileNameMin, setPublicFolder, toBuildArgsOptions, warnDeprecation, wildcards, writeFile };

package/dist/isValidFile-DnWJtlKA.js

@@ -0,0 +1,46 @@
+import { t as FileOperationError } from "./error-Ck87RwDD.js";
+import { lstat } from "node:fs/promises";
+import { existsSync, lstatSync } from "node:fs";
+
+//#region src/isValidFile.ts
+/*!
+* node-minify
+* Copyright(c) 2011-2025 Rodolphe Stoclin
+* MIT Licensed
+*/
+/**
+* Check if the path is a valid file.
+* @param path Path to check
+* @returns true if path exists and is a file, false otherwise
+* @throws {FileOperationError} If filesystem operations fail
+* @example
+* if (isValidFile('path/to/file.js')) {
+*   // do something
+* }
+*/
+function isValidFile(path) {
+	try {
+		return existsSync(path) && !lstatSync(path).isDirectory();
+	} catch (error) {
+		throw new FileOperationError("validate", path, error);
+	}
+}
+/**
+* Determine whether a filesystem path refers to an existing file (not a directory).
+*
+* @param path - Path to check
+* @returns `true` if the path exists and is a file, `false` otherwise.
+* @throws {FileOperationError} If a filesystem error other than `ENOENT` occurs while validating the path.
+*/
+async function isValidFileAsync(path) {
+	try {
+		return !(await lstat(path)).isDirectory();
+	} catch (error) {
+		if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") return false;
+		throw new FileOperationError("validate", path, error instanceof Error ? error : new Error(String(error)));
+	}
+}
+
+//#endregion
+export { isValidFileAsync as n, isValidFile as t };
+//# sourceMappingURL=isValidFile-DnWJtlKA.js.map

package/dist/isValidFile-DnWJtlKA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValidFile-DnWJtlKA.js","names":["error: unknown"],"sources":["../src/isValidFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { existsSync, lstatSync } from \"node:fs\";\nimport { lstat } from \"node:fs/promises\";\nimport { FileOperationError } from \"./error.ts\";\n\n/**\n * Check if the path is a valid file.\n * @param path Path to check\n * @returns true if path exists and is a file, false otherwise\n * @throws {FileOperationError} If filesystem operations fail\n * @example\n * if (isValidFile('path/to/file.js')) {\n *   // do something\n * }\n */\nexport function isValidFile(path: string): boolean {\n    try {\n        return existsSync(path) && !lstatSync(path).isDirectory();\n    } catch (error) {\n        throw new FileOperationError(\"validate\", path, error as Error);\n    }\n}\n\n/**\n * Determine whether a filesystem path refers to an existing file (not a directory).\n *\n * @param path - Path to check\n * @returns `true` if the path exists and is a file, `false` otherwise.\n * @throws {FileOperationError} If a filesystem error other than `ENOENT` occurs while validating the path.\n */\nexport async function isValidFileAsync(path: string): Promise<boolean> {\n    try {\n        const stats = await lstat(path);\n        return !stats.isDirectory();\n    } catch (error: unknown) {\n        if (\n            error &&\n            typeof error === \"object\" &&\n            \"code\" in error &&\n            error.code === \"ENOENT\"\n        ) {\n            return false;\n        }\n        throw new FileOperationError(\n            \"validate\",\n            path,\n            error instanceof Error ? error : new Error(String(error))\n        );\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,YAAY,MAAuB;AAC/C,KAAI;AACA,SAAO,WAAW,KAAK,IAAI,CAAC,UAAU,KAAK,CAAC,aAAa;UACpD,OAAO;AACZ,QAAM,IAAI,mBAAmB,YAAY,MAAM,MAAe;;;;;;;;;;AAWtE,eAAsB,iBAAiB,MAAgC;AACnE,KAAI;AAEA,SAAO,EADO,MAAM,MAAM,KAAK,EACjB,aAAa;UACtBA,OAAgB;AACrB,MACI,SACA,OAAO,UAAU,YACjB,UAAU,SACV,MAAM,SAAS,SAEf,QAAO;AAEX,QAAM,IAAI,mBACN,YACA,MACA,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC,CAC5D"}

package/dist/isValidFile.d.ts

@@ -15,6 +15,14 @@
  * }
  */
 declare function isValidFile(path: string): boolean;
+/**
+ * Determine whether a filesystem path refers to an existing file (not a directory).
+ *
+ * @param path - Path to check
+ * @returns `true` if the path exists and is a file, `false` otherwise.
+ * @throws {FileOperationError} If a filesystem error other than `ENOENT` occurs while validating the path.
+ */
+declare function isValidFileAsync(path: string): Promise<boolean>;
 //#endregion
-export { isValidFile };
+export { isValidFile, isValidFileAsync };
 //# sourceMappingURL=isValidFile.d.ts.map

package/dist/isValidFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isValidFile.d.ts","names":[],"sources":["../src/isValidFile.ts"],"sourcesContent":[],"mappings":";;AAmBA;;;;;;;;;;;;;;iBAAgB,WAAA"}
+{"version":3,"file":"isValidFile.d.ts","names":[],"sources":["../src/isValidFile.ts"],"sourcesContent":[],"mappings":";;AAoBA;AAeA;;;;;;;;;;;;;iBAfgB,WAAA;;;;;;;;iBAeM,gBAAA,gBAAgC"}

package/dist/isValidFile.js

@@ -1,3 +1,3 @@
-import { t as isValidFile } from "./isValidFile-UAwceQud.js";
+import { n as isValidFileAsync, t as isValidFile } from "./isValidFile-DnWJtlKA.js";
 
-export { isValidFile };
+export { isValidFile, isValidFileAsync };

package/dist/prettyBytes.js

@@ -1,4 +1,4 @@
-import { n as ValidationError } from "./error-B_uK-F18.js";
+import { n as ValidationError } from "./error-Ck87RwDD.js";
 
 //#region src/prettyBytes.ts
 /*!

package/dist/readFile.d.ts

@@ -7,9 +7,20 @@
 /**
  * Read content from file.
  * @param file - Path to file
- * @returns File content as string
+ * @param asBuffer - If true, return Buffer; if false, return string (default: false)
+ * @returns File content as string or Buffer
+ * @throws {FileOperationError} If file doesn't exist or reading fails
+ * @example
+ * // Read as string
+ * const content = readFile('file.txt');
+ *
+ * // Read as Buffer (for binary files like images)
+ * const buffer = readFile('image.png', true);
  */
 declare function readFile(file: string): string;
+declare function readFile(file: string, asBuffer: true): Buffer;
+declare function readFile(file: string, asBuffer: false): string;
+declare function readFile(file: string, asBuffer?: boolean): string | Buffer;
 //#endregion
 export { readFile };
 //# sourceMappingURL=readFile.d.ts.map

package/dist/readFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readFile.d.ts","names":[],"sources":["../src/readFile.ts"],"sourcesContent":[],"mappings":";;AAaA;;;;;;;;;iBAAgB,QAAA"}
+{"version":3,"file":"readFile.d.ts","names":[],"sources":["../src/readFile.ts"],"sourcesContent":[],"mappings":";;AAsBA;AACA;AACA;AACA;;;;;;;;;;;;;;iBAHgB,QAAA;iBACA,QAAA,gCAAwC;iBACxC,QAAA;iBACA,QAAA,6CAAqD"}

package/dist/readFile.js

@@ -1,3 +1,4 @@
+import { t as FileOperationError } from "./error-Ck87RwDD.js";
 import { readFileSync } from "node:fs";
 
 //#region src/readFile.ts
@@ -7,12 +8,19 @@ import { readFileSync } from "node:fs";
 * MIT Licensed
 */
 /**
-* Read content from file.
-* @param file - Path to file
-* @returns File content as string
+* Read a file from disk and return its contents as a UTF-8 string by default or as a raw Buffer.
+*
+* @param file - Path to the file to read.
+* @param asBuffer - If `true`, return a raw `Buffer`; if `false` or omitted, return the file decoded as a UTF-8 `string`.
+* @returns A `Buffer` when `asBuffer` is `true`, otherwise the file content as a UTF-8 `string`.
+* @throws FileOperationError when the file cannot be read; the original error is attached as the cause.
 */
-function readFile(file) {
-	return readFileSync(file, "utf8");
+function readFile(file, asBuffer) {
+	try {
+		return asBuffer ? readFileSync(file) : readFileSync(file, "utf8");
+	} catch (error) {
+		throw new FileOperationError("read", file, error instanceof Error ? error : void 0);
+	}
 }
 
 //#endregion

package/dist/readFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"readFile.js","names":[],"sources":["../src/readFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { readFileSync } from \"node:fs\";\n\n/**\n * Read content from file.\n * @param file - Path to file\n * @returns File content as string\n */\nexport function readFile(file: string): string {\n    return readFileSync(file, \"utf8\");\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,SAAS,MAAsB;AAC3C,QAAO,aAAa,MAAM,OAAO"}
+{"version":3,"file":"readFile.js","names":[],"sources":["../src/readFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { FileOperationError } from \"./error.ts\";\n\n/**\n * Read content from file.\n * @param file - Path to file\n * @param asBuffer - If true, return Buffer; if false, return string (default: false)\n * @returns File content as string or Buffer\n * @throws {FileOperationError} If file doesn't exist or reading fails\n * @example\n * // Read as string\n * const content = readFile('file.txt');\n *\n * // Read as Buffer (for binary files like images)\n * const buffer = readFile('image.png', true);\n */\nexport function readFile(file: string): string;\nexport function readFile(file: string, asBuffer: true): Buffer;\nexport function readFile(file: string, asBuffer: false): string;\nexport function readFile(file: string, asBuffer?: boolean): string | Buffer;\n/**\n * Read a file from disk and return its contents as a UTF-8 string by default or as a raw Buffer.\n *\n * @param file - Path to the file to read.\n * @param asBuffer - If `true`, return a raw `Buffer`; if `false` or omitted, return the file decoded as a UTF-8 `string`.\n * @returns A `Buffer` when `asBuffer` is `true`, otherwise the file content as a UTF-8 `string`.\n * @throws FileOperationError when the file cannot be read; the original error is attached as the cause.\n */\nexport function readFile(file: string, asBuffer?: boolean): string | Buffer {\n    try {\n        return asBuffer ? readFileSync(file) : readFileSync(file, \"utf8\");\n    } catch (error) {\n        throw new FileOperationError(\n            \"read\",\n            file,\n            error instanceof Error ? error : undefined\n        );\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkCA,SAAgB,SAAS,MAAc,UAAqC;AACxE,KAAI;AACA,SAAO,WAAW,aAAa,KAAK,GAAG,aAAa,MAAM,OAAO;UAC5D,OAAO;AACZ,QAAM,IAAI,mBACN,QACA,MACA,iBAAiB,QAAQ,QAAQ,OACpC"}

package/dist/run.d.ts

@@ -1,23 +1,21 @@
-import { t as Settings } from "./types-DtDQlx-T.js";
+import { n as MinifierOptions, t as CompressorOptions } from "./types-BUlX1Zbb.js";
 
 //#region src/run.d.ts
 
-interface RunParameters {
-  settings: Settings;
-  content?: string;
-  index?: number;
-}
 /**
- * Execute the compressor and write output.
- * @param params - Run parameters containing settings, content, and index
- * @returns Minified content string
- * @throws {ValidationError} If settings or compressor is missing
+ * Run the configured compressor and persist its outputs according to the provided settings.
+ *
+ * @param settings - Compressor settings including output targets and the `compressor` implementation
+ * @param content - The input content to be compressed
+ * @param index - Optional index used when processing multiple inputs
+ * @returns The minified code produced by the compressor
+ * @throws {ValidationError} If `settings` is missing or `settings.compressor` is not provided
  */
-declare function run({
+declare function run<T extends CompressorOptions = CompressorOptions>({
   settings,
   content,
   index
-}: RunParameters): Promise<string>;
+}: MinifierOptions<T>): Promise<string>;
 //#endregion
 export { run };
 //# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","names":[],"sources":["../src/run.ts"],"sourcesContent":[],"mappings":";;;;UAUU,aAAA,CAcN;EACA,QAAA,EAdU,QAcV;EACD,OAAA,CAAA,EAAA,MAAA;EAAgB,KAAA,CAAA,EAAA,MAAA;;;;;;;;iBAJG,GAAA;;;;GAInB,gBAAgB"}
+{"version":3,"file":"run.d.ts","names":[],"sources":["../src/run.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;iBAyBsB,cAAc,oBAAoB;;;;GAIrD,gBAAgB,KAAK"}

package/dist/run.js

@@ -1,12 +1,21 @@
-import { n as ValidationError } from "./error-B_uK-F18.js";
-import { t as writeFile } from "./writeFile-CwK9ZWXr.js";
+import { n as ValidationError } from "./error-Ck87RwDD.js";
+import { t as writeFile } from "./writeFile-BRfs9FqY.js";
+import { join, parse } from "node:path";
 
 //#region src/run.ts
+/*!
+* node-minify
+* Copyright(c) 2011-2025 Rodolphe Stoclin
+* MIT Licensed
+*/
 /**
-* Execute the compressor and write output.
-* @param params - Run parameters containing settings, content, and index
-* @returns Minified content string
-* @throws {ValidationError} If settings or compressor is missing
+* Run the configured compressor and persist its outputs according to the provided settings.
+*
+* @param settings - Compressor settings including output targets and the `compressor` implementation
+* @param content - The input content to be compressed
+* @param index - Optional index used when processing multiple inputs
+* @returns The minified code produced by the compressor
+* @throws {ValidationError} If `settings` is missing or `settings.compressor` is not provided
 */
 async function run({ settings, content, index }) {
 	if (!settings) throw new ValidationError("Settings must be provided");
@@ -19,8 +28,29 @@ async function run({ settings, content, index }) {
 	writeOutput(result, settings, index);
 	return result.code;
 }
+/**
+* Write compressor result outputs to disk unless the operation is in-memory.
+*
+* Writes multiple output files when `result.outputs` is provided, writes a binary `result.buffer` to the configured output when present, otherwise writes `result.code`. If a source map is available and a source map URL can be resolved from `settings`, the map is written alongside the main output.
+*
+* @param result - The compressor result containing `code`, optional `buffer`, `map`, or `outputs` describing one or more outputs
+* @param settings - Settings that include output destination(s) and optional in-memory `content` which disables disk writes
+* @param index - Optional index used when writing to multiple targets or when tracking a particular input within a batch
+*/
 function writeOutput(result, settings, index) {
 	if (Boolean(settings.content) || !settings.output) return;
+	if (result.outputs && result.outputs.length > 0) {
+		writeMultipleOutputs(result.outputs, settings, index);
+		return;
+	}
+	if (result.buffer) {
+		writeFile({
+			file: settings.output,
+			content: result.buffer,
+			index
+		});
+		return;
+	}
 	writeFile({
 		file: settings.output,
 		content: result.code,
@@ -35,6 +65,71 @@ function writeOutput(result, settings, index) {
 		});
 	}
 }
+/**
+* Extract the first input file path from the input configuration.
+*
+* @param input - A single file path, an array of paths, or undefined
+* @returns The first input file path, or an empty string if none available
+*/
+function getFirstInputFile(input) {
+	if (typeof input === "string") return input;
+	if (Array.isArray(input) && input.length > 0) return input[0] ?? "";
+	return "";
+}
+/**
+* Write multiple output files produced by a compressor according to the settings' output configuration.
+*
+* This writes each provided output entry to a computed target path:
+* - If `settings.output` is an array, a non-empty array item (not "$1") at the same index is used verbatim as the target path.
+* - If `settings.output` is the string "$1", the target is generated from the first input filename and the output's `format` (or "out" if missing).
+* - If `settings.output` contains "$1", every "$1" is replaced with the input base name and the output's `format` is appended.
+* - If `settings.output` is a plain string, that string is used with the output's `format` appended.
+* - If no usable output pattern is provided, a default path is generated from the input filename and the output's `format`.
+*
+* Each output's `content` is written to its resolved path using `writeFile`. The first input (if any) is used to derive base names and directories for auto-generated targets.
+*
+* @param outputs - Array of compressor outputs (each may include `content` and optional `format`) to write.
+* @param settings - Settings used to resolve output targets (may supply `output` and `input`).
+* @param index - Optional index forwarded to the file writer when writing each output.
+*/
+function writeMultipleOutputs(outputs, settings, index) {
+	const output = settings.output;
+	const isArrayOutput = Array.isArray(output);
+	const outputsArray = isArrayOutput ? output : [output];
+	const inputFile = getFirstInputFile(settings.input);
+	const inputDir = parse(inputFile).dir;
+	const inputBase = parse(inputFile).name;
+	for (let i = 0; i < outputs.length; i++) {
+		const outputResult = outputs[i];
+		if (!outputResult) continue;
+		const format = outputResult.format || "out";
+		let targetFile;
+		const arrayItem = outputsArray[i];
+		if (isArrayOutput && arrayItem !== void 0 && arrayItem !== "$1" && arrayItem.trim() !== "") targetFile = arrayItem;
+		else if (typeof output === "string" && output === "$1") {
+			const baseName = inputBase || "output";
+			targetFile = inputDir ? join(inputDir, `${baseName}.${format}`) : `${baseName}.${format}`;
+		} else if (typeof output === "string" && output.includes("$1")) {
+			const extensionlessName = inputBase || "output";
+			targetFile = `${output.replace(/\$1/g, extensionlessName)}.${format}`;
+		} else if (typeof output === "string") targetFile = `${output}.${format}`;
+		else {
+			const baseName = inputBase || "output";
+			targetFile = inputDir ? join(inputDir, `${baseName}.${format}`) : `${baseName}.${format}`;
+		}
+		writeFile({
+			file: targetFile,
+			content: outputResult.content,
+			index
+		});
+	}
+}
+/**
+* Resolve the configured source map path or URL from the provided settings.
+*
+* @param settings - Minifier settings that may include `options.sourceMap` or `options._sourceMap`
+* @returns The source map URL or filename when configured, `undefined` otherwise.
+*/
 function getSourceMapUrl(settings) {
 	const options = settings.options;
 	if (!options) return;

package/dist/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","names":[],"sources":["../src/run.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport type { CompressorResult, Settings } from \"@node-minify/types\";\nimport { ValidationError } from \"./error.ts\";\nimport { writeFile } from \"./writeFile.ts\";\n\ninterface RunParameters {\n    settings: Settings;\n    content?: string;\n    index?: number;\n}\n\n/**\n * Execute the compressor and write output.\n * @param params - Run parameters containing settings, content, and index\n * @returns Minified content string\n * @throws {ValidationError} If settings or compressor is missing\n */\nexport async function run({\n    settings,\n    content,\n    index,\n}: RunParameters): Promise<string> {\n    if (!settings) {\n        throw new ValidationError(\"Settings must be provided\");\n    }\n\n    if (!settings.compressor) {\n        throw new ValidationError(\"Compressor must be provided in settings\");\n    }\n\n    const result = await settings.compressor({\n        settings,\n        content,\n        index,\n    });\n\n    writeOutput(result, settings, index);\n\n    return result.code;\n}\n\nfunction writeOutput(\n    result: CompressorResult,\n    settings: Settings,\n    index?: number\n): void {\n    const isInMemoryMode = Boolean(settings.content);\n    if (isInMemoryMode || !settings.output) {\n        return;\n    }\n\n    writeFile({ file: settings.output, content: result.code, index });\n\n    if (result.map) {\n        const sourceMapUrl = getSourceMapUrl(settings);\n        if (sourceMapUrl) {\n            writeFile({ file: sourceMapUrl, content: result.map, index });\n        }\n    }\n}\n\nfunction getSourceMapUrl(settings: Settings): string | undefined {\n    const options = settings.options as Record<string, unknown> | undefined;\n    if (!options) {\n        return undefined;\n    }\n\n    const sourceMap = options.sourceMap as Record<string, unknown> | undefined;\n    if (sourceMap) {\n        if (typeof sourceMap.url === \"string\") {\n            return sourceMap.url;\n        }\n        if (typeof sourceMap.filename === \"string\") {\n            return sourceMap.filename;\n        }\n    }\n\n    const _sourceMap = options._sourceMap as\n        | Record<string, unknown>\n        | undefined;\n    if (_sourceMap && typeof _sourceMap.url === \"string\") {\n        return _sourceMap.url;\n    }\n\n    return undefined;\n}\n"],"mappings":";;;;;;;;;;AAsBA,eAAsB,IAAI,EACtB,UACA,SACA,SAC+B;AAC/B,KAAI,CAAC,SACD,OAAM,IAAI,gBAAgB,4BAA4B;AAG1D,KAAI,CAAC,SAAS,WACV,OAAM,IAAI,gBAAgB,0CAA0C;CAGxE,MAAM,SAAS,MAAM,SAAS,WAAW;EACrC;EACA;EACA;EACH,CAAC;AAEF,aAAY,QAAQ,UAAU,MAAM;AAEpC,QAAO,OAAO;;AAGlB,SAAS,YACL,QACA,UACA,OACI;AAEJ,KADuB,QAAQ,SAAS,QAAQ,IAC1B,CAAC,SAAS,OAC5B;AAGJ,WAAU;EAAE,MAAM,SAAS;EAAQ,SAAS,OAAO;EAAM;EAAO,CAAC;AAEjE,KAAI,OAAO,KAAK;EACZ,MAAM,eAAe,gBAAgB,SAAS;AAC9C,MAAI,aACA,WAAU;GAAE,MAAM;GAAc,SAAS,OAAO;GAAK;GAAO,CAAC;;;AAKzE,SAAS,gBAAgB,UAAwC;CAC7D,MAAM,UAAU,SAAS;AACzB,KAAI,CAAC,QACD;CAGJ,MAAM,YAAY,QAAQ;AAC1B,KAAI,WAAW;AACX,MAAI,OAAO,UAAU,QAAQ,SACzB,QAAO,UAAU;AAErB,MAAI,OAAO,UAAU,aAAa,SAC9B,QAAO,UAAU;;CAIzB,MAAM,aAAa,QAAQ;AAG3B,KAAI,cAAc,OAAO,WAAW,QAAQ,SACxC,QAAO,WAAW"}
+{"version":3,"file":"run.js","names":["targetFile: string"],"sources":["../src/run.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { join, parse } from \"node:path\";\nimport type {\n    CompressorOptions,\n    CompressorResult,\n    MinifierOptions,\n    Settings,\n} from \"@node-minify/types\";\nimport { ValidationError } from \"./error.ts\";\nimport { writeFile } from \"./writeFile.ts\";\n\n/**\n * Run the configured compressor and persist its outputs according to the provided settings.\n *\n * @param settings - Compressor settings including output targets and the `compressor` implementation\n * @param content - The input content to be compressed\n * @param index - Optional index used when processing multiple inputs\n * @returns The minified code produced by the compressor\n * @throws {ValidationError} If `settings` is missing or `settings.compressor` is not provided\n */\nexport async function run<T extends CompressorOptions = CompressorOptions>({\n    settings,\n    content,\n    index,\n}: MinifierOptions<T>): Promise<string> {\n    if (!settings) {\n        throw new ValidationError(\"Settings must be provided\");\n    }\n\n    if (!settings.compressor) {\n        throw new ValidationError(\"Compressor must be provided in settings\");\n    }\n\n    const result = await settings.compressor({\n        settings,\n        content,\n        index,\n    });\n\n    writeOutput(result, settings, index);\n\n    return result.code;\n}\n\n/**\n * Write compressor result outputs to disk unless the operation is in-memory.\n *\n * Writes multiple output files when `result.outputs` is provided, writes a binary `result.buffer` to the configured output when present, otherwise writes `result.code`. If a source map is available and a source map URL can be resolved from `settings`, the map is written alongside the main output.\n *\n * @param result - The compressor result containing `code`, optional `buffer`, `map`, or `outputs` describing one or more outputs\n * @param settings - Settings that include output destination(s) and optional in-memory `content` which disables disk writes\n * @param index - Optional index used when writing to multiple targets or when tracking a particular input within a batch\n */\nfunction writeOutput<T extends CompressorOptions = CompressorOptions>(\n    result: CompressorResult,\n    settings: Settings<T>,\n    index?: number\n): void {\n    const isInMemoryMode = Boolean(settings.content);\n    if (isInMemoryMode || !settings.output) {\n        return;\n    }\n\n    // Handle multi-output (for image conversion to multiple formats)\n    if (result.outputs && result.outputs.length > 0) {\n        writeMultipleOutputs(result.outputs, settings, index);\n        return;\n    }\n\n    // Handle single buffer output (for binary images)\n    if (result.buffer) {\n        writeFile({ file: settings.output, content: result.buffer, index });\n        return;\n    }\n\n    // Default: write code (string) output\n    writeFile({ file: settings.output, content: result.code, index });\n\n    if (result.map) {\n        const sourceMapUrl = getSourceMapUrl(settings);\n        if (sourceMapUrl) {\n            writeFile({ file: sourceMapUrl, content: result.map, index });\n        }\n    }\n}\n\n/**\n * Extract the first input file path from the input configuration.\n *\n * @param input - A single file path, an array of paths, or undefined\n * @returns The first input file path, or an empty string if none available\n */\nfunction getFirstInputFile(input: string | string[] | undefined): string {\n    if (typeof input === \"string\") {\n        return input;\n    }\n    if (Array.isArray(input) && input.length > 0) {\n        return input[0] ?? \"\";\n    }\n    return \"\";\n}\n\n/**\n * Write multiple output files produced by a compressor according to the settings' output configuration.\n *\n * This writes each provided output entry to a computed target path:\n * - If `settings.output` is an array, a non-empty array item (not \"$1\") at the same index is used verbatim as the target path.\n * - If `settings.output` is the string \"$1\", the target is generated from the first input filename and the output's `format` (or \"out\" if missing).\n * - If `settings.output` contains \"$1\", every \"$1\" is replaced with the input base name and the output's `format` is appended.\n * - If `settings.output` is a plain string, that string is used with the output's `format` appended.\n * - If no usable output pattern is provided, a default path is generated from the input filename and the output's `format`.\n *\n * Each output's `content` is written to its resolved path using `writeFile`. The first input (if any) is used to derive base names and directories for auto-generated targets.\n *\n * @param outputs - Array of compressor outputs (each may include `content` and optional `format`) to write.\n * @param settings - Settings used to resolve output targets (may supply `output` and `input`).\n * @param index - Optional index forwarded to the file writer when writing each output.\n */\nfunction writeMultipleOutputs<T extends CompressorOptions = CompressorOptions>(\n    outputs: NonNullable<CompressorResult[\"outputs\"]>,\n    settings: Settings<T>,\n    index?: number\n): void {\n    const output = settings.output;\n    const isArrayOutput = Array.isArray(output);\n    const outputsArray = isArrayOutput ? output : [output];\n    const inputFile = getFirstInputFile(settings.input);\n    const inputDir = parse(inputFile).dir;\n    const inputBase = parse(inputFile).name;\n\n    for (let i = 0; i < outputs.length; i++) {\n        const outputResult = outputs[i];\n        if (!outputResult) {\n            continue;\n        }\n\n        const format = outputResult.format || \"out\";\n        let targetFile: string;\n\n        const arrayItem = outputsArray[i];\n\n        if (\n            isArrayOutput &&\n            arrayItem !== undefined &&\n            arrayItem !== \"$1\" &&\n            arrayItem.trim() !== \"\"\n        ) {\n            // Explicit output path provided in array - use as-is\n            targetFile = arrayItem;\n        } else if (typeof output === \"string\" && output === \"$1\") {\n            // $1 only: auto-generate from input filename in input directory\n            const baseName = inputBase || \"output\";\n            targetFile = inputDir\n                ? join(inputDir, `${baseName}.${format}`)\n                : `${baseName}.${format}`;\n        } else if (typeof output === \"string\" && output.includes(\"$1\")) {\n            // $1 pattern in path: replace and append format\n            const extensionlessName = inputBase || \"output\";\n            const outputFile = output.replace(/\\$1/g, extensionlessName);\n            targetFile = `${outputFile}.${format}`;\n        } else if (typeof output === \"string\") {\n            // Single string output: append format extension\n            targetFile = `${output}.${format}`;\n        } else {\n            // Fallback\n            const baseName = inputBase || \"output\";\n            targetFile = inputDir\n                ? join(inputDir, `${baseName}.${format}`)\n                : `${baseName}.${format}`;\n        }\n\n        writeFile({ file: targetFile, content: outputResult.content, index });\n    }\n}\n\n/**\n * Resolve the configured source map path or URL from the provided settings.\n *\n * @param settings - Minifier settings that may include `options.sourceMap` or `options._sourceMap`\n * @returns The source map URL or filename when configured, `undefined` otherwise.\n */\nfunction getSourceMapUrl<T extends CompressorOptions = CompressorOptions>(\n    settings: Settings<T>\n): string | undefined {\n    const options = settings.options as Record<string, unknown> | undefined;\n    if (!options) {\n        return undefined;\n    }\n\n    const sourceMap = options.sourceMap as Record<string, unknown> | undefined;\n    if (sourceMap) {\n        if (typeof sourceMap.url === \"string\") {\n            return sourceMap.url;\n        }\n        if (typeof sourceMap.filename === \"string\") {\n            return sourceMap.filename;\n        }\n    }\n\n    const _sourceMap = options._sourceMap as\n        | Record<string, unknown>\n        | undefined;\n    if (_sourceMap && typeof _sourceMap.url === \"string\") {\n        return _sourceMap.url;\n    }\n\n    return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAyBA,eAAsB,IAAqD,EACvE,UACA,SACA,SACoC;AACpC,KAAI,CAAC,SACD,OAAM,IAAI,gBAAgB,4BAA4B;AAG1D,KAAI,CAAC,SAAS,WACV,OAAM,IAAI,gBAAgB,0CAA0C;CAGxE,MAAM,SAAS,MAAM,SAAS,WAAW;EACrC;EACA;EACA;EACH,CAAC;AAEF,aAAY,QAAQ,UAAU,MAAM;AAEpC,QAAO,OAAO;;;;;;;;;;;AAYlB,SAAS,YACL,QACA,UACA,OACI;AAEJ,KADuB,QAAQ,SAAS,QAAQ,IAC1B,CAAC,SAAS,OAC5B;AAIJ,KAAI,OAAO,WAAW,OAAO,QAAQ,SAAS,GAAG;AAC7C,uBAAqB,OAAO,SAAS,UAAU,MAAM;AACrD;;AAIJ,KAAI,OAAO,QAAQ;AACf,YAAU;GAAE,MAAM,SAAS;GAAQ,SAAS,OAAO;GAAQ;GAAO,CAAC;AACnE;;AAIJ,WAAU;EAAE,MAAM,SAAS;EAAQ,SAAS,OAAO;EAAM;EAAO,CAAC;AAEjE,KAAI,OAAO,KAAK;EACZ,MAAM,eAAe,gBAAgB,SAAS;AAC9C,MAAI,aACA,WAAU;GAAE,MAAM;GAAc,SAAS,OAAO;GAAK;GAAO,CAAC;;;;;;;;;AAWzE,SAAS,kBAAkB,OAA8C;AACrE,KAAI,OAAO,UAAU,SACjB,QAAO;AAEX,KAAI,MAAM,QAAQ,MAAM,IAAI,MAAM,SAAS,EACvC,QAAO,MAAM,MAAM;AAEvB,QAAO;;;;;;;;;;;;;;;;;;AAmBX,SAAS,qBACL,SACA,UACA,OACI;CACJ,MAAM,SAAS,SAAS;CACxB,MAAM,gBAAgB,MAAM,QAAQ,OAAO;CAC3C,MAAM,eAAe,gBAAgB,SAAS,CAAC,OAAO;CACtD,MAAM,YAAY,kBAAkB,SAAS,MAAM;CACnD,MAAM,WAAW,MAAM,UAAU,CAAC;CAClC,MAAM,YAAY,MAAM,UAAU,CAAC;AAEnC,MAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;EACrC,MAAM,eAAe,QAAQ;AAC7B,MAAI,CAAC,aACD;EAGJ,MAAM,SAAS,aAAa,UAAU;EACtC,IAAIA;EAEJ,MAAM,YAAY,aAAa;AAE/B,MACI,iBACA,cAAc,UACd,cAAc,QACd,UAAU,MAAM,KAAK,GAGrB,cAAa;WACN,OAAO,WAAW,YAAY,WAAW,MAAM;GAEtD,MAAM,WAAW,aAAa;AAC9B,gBAAa,WACP,KAAK,UAAU,GAAG,SAAS,GAAG,SAAS,GACvC,GAAG,SAAS,GAAG;aACd,OAAO,WAAW,YAAY,OAAO,SAAS,KAAK,EAAE;GAE5D,MAAM,oBAAoB,aAAa;AAEvC,gBAAa,GADM,OAAO,QAAQ,QAAQ,kBAAkB,CACjC,GAAG;aACvB,OAAO,WAAW,SAEzB,cAAa,GAAG,OAAO,GAAG;OACvB;GAEH,MAAM,WAAW,aAAa;AAC9B,gBAAa,WACP,KAAK,UAAU,GAAG,SAAS,GAAG,SAAS,GACvC,GAAG,SAAS,GAAG;;AAGzB,YAAU;GAAE,MAAM;GAAY,SAAS,aAAa;GAAS;GAAO,CAAC;;;;;;;;;AAU7E,SAAS,gBACL,UACkB;CAClB,MAAM,UAAU,SAAS;AACzB,KAAI,CAAC,QACD;CAGJ,MAAM,YAAY,QAAQ;AAC1B,KAAI,WAAW;AACX,MAAI,OAAO,UAAU,QAAQ,SACzB,QAAO,UAAU;AAErB,MAAI,OAAO,UAAU,aAAa,SAC9B,QAAO,UAAU;;CAIzB,MAAM,aAAa,QAAQ;AAG3B,KAAI,cAAc,OAAO,WAAW,QAAQ,SACxC,QAAO,WAAW"}

package/dist/setFileNameMin.js

@@ -1,4 +1,4 @@
-import { n as ValidationError } from "./error-B_uK-F18.js";
+import { n as ValidationError } from "./error-Ck87RwDD.js";
 
 //#region src/setFileNameMin.ts
 /*!

package/dist/{types-DtDQlx-T.d.ts → types-BUlX1Zbb.d.ts}

@@ -1,11 +1,47 @@
 //#region ../types/src/types.d.ts
 
+/**
+ * Output result for multi-format image compression.
+ */
+type CompressorOutput = {
+  /**
+   * Format of the output (e.g., 'webp', 'avif').
+   */
+  format?: string;
+
+  /**
+   * Output content as string or Buffer.
+   */
+  content: string | Buffer;
+};
 /**
  * Result returned by a compressor function.
  */
 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.
+   * @example
+   * [{ format: 'webp', content: <Buffer> }, { format: 'avif', content: <Buffer> }]
+   */
+  outputs?: CompressorOutput[];
 };
 /**
  * Base options that all compressors can accept.
@@ -53,8 +89,10 @@ type Settings<TOptions extends CompressorOptions = CompressorOptions> = {
   /**
    * Content to minify (for in-memory minification).
    * If provided, input/output are not required.
+   * For text-based formats (JS, CSS, HTML, SVG): string
+   * For binary formats (images): Buffer (handled internally by image compressors)
    */
-  content?: string;
+  content?: string | Buffer;
 
   /**
    * Input file path(s) or glob pattern.
@@ -136,8 +174,11 @@ type MinifierOptions<TOptions extends CompressorOptions = CompressorOptions> = {
 
   /**
    * The content to minify.
+   * For text-based formats (JS, CSS, HTML, SVG): string
+   * For binary formats (images): Buffer
+   * For multiple binary files: Buffer[]
    */
-  content?: string;
+  content?: string | Buffer | Buffer[];
 
   /**
    * Index of current file when processing multiple files.
@@ -145,5 +186,5 @@ type MinifierOptions<TOptions extends CompressorOptions = CompressorOptions> = {
   index?: number;
 };
 //#endregion
-export { Settings as t };
-//# sourceMappingURL=types-DtDQlx-T.d.ts.map
+export { MinifierOptions as n, Settings as r, CompressorOptions as t };
+//# sourceMappingURL=types-BUlX1Zbb.d.ts.map

package/dist/types-BUlX1Zbb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BUlX1Zbb.d.ts","names":["CompressorReturnType","ImageFormat","CompressorOutput","Buffer","CompressorResult","CompressorOptions","Record","Compressor","TOptions","MinifierOptions","Promise","FileType","Settings","Result","MinifyOptions"],"sources":["../../types/src/types.d.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 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     * 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":";;;;;AAqNsC,KAxL1BE,gBAAAA,GAwL0B;;;;;;;;;oBA/KhBC;;;;;KAMVC,gBAAAA;;;;;;;;;;;;;;;;WAgBCD;;;;;;;;YAQCD;;;;;;KAOFG,iBAAAA,GAAoBC;;;;;;KAOpBC,4BAA4BF,oBAAoBA,4BACjDI,gBAAgBD,cAAcE,QAAQN;;;;KAKrCO,QAAAA;;;;;;;;;;;;;;;;;;KAmBAC,0BAA0BP,oBAAoBA;;;;cAI1CE,WAAWC;;;;;;;;;;;;;qBAaJL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA6BTK;;;;;;;;;;;;;;;;;;SAkBHG;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BCF,iCACSJ,oBAAoBA;;;;YAK3BO,SAASJ;;;;;;;;qBAQAL,SAASA"}

package/dist/{writeFile-CwK9ZWXr.js → writeFile-BRfs9FqY.js}

@@ -1,4 +1,4 @@
-import { n as ValidationError, t as FileOperationError } from "./error-B_uK-F18.js";
+import { n as ValidationError, t as FileOperationError } from "./error-Ck87RwDD.js";
 import { existsSync, lstatSync, writeFileSync } from "node:fs";
 
 //#region src/writeFile.ts
@@ -8,14 +8,16 @@ import { existsSync, lstatSync, writeFileSync } from "node:fs";
 * MIT Licensed
 */
 /**
-* Write content into file.
-* @param params Object containing file path, content and optional index
-* @returns Written content
-* @throws {ValidationError} If no target file is provided
-* @throws {FileOperationError} If file operations fail
-* @example
-* writeFile({ file: 'output.js', content: 'console.log("Hello")' })
-* writeFile({ file: ['file1.js', 'file2.js'], content: 'shared content', index: 0 })
+* Write provided content to a target file.
+*
+* When `file` is an array and `index` is provided, the file at that index is used; otherwise `file` is used directly.
+*
+* @param file - Target path or array of target paths
+* @param content - Content to write; may be a `string` or `Buffer`
+* @param index - Optional index to select a file when `file` is an array
+* @returns The same `content` value that was written
+* @throws ValidationError If no target file, no content, or the resolved target path is invalid
+* @throws FileOperationError If the underlying filesystem write fails (wraps the original error)
 */
 function writeFile({ file, content, index }) {
 	try {
@@ -24,7 +26,7 @@ function writeFile({ file, content, index }) {
 		const targetFile = index !== void 0 ? Array.isArray(file) ? file[index] : file : file;
 		if (typeof targetFile !== "string") throw new ValidationError("Invalid target file path");
 		if (!(!existsSync(targetFile) || !lstatSync(targetFile).isDirectory())) throw new Error("Target path exists and is a directory");
-		writeFileSync(targetFile, content, "utf8");
+		writeFileSync(targetFile, content, Buffer.isBuffer(content) ? void 0 : "utf8");
 		return content;
 	} catch (error) {
 		if (error instanceof ValidationError) throw error;
@@ -34,4 +36,4 @@ function writeFile({ file, content, index }) {
 
 //#endregion
 export { writeFile as t };
-//# sourceMappingURL=writeFile-CwK9ZWXr.js.map
+//# sourceMappingURL=writeFile-BRfs9FqY.js.map

package/dist/writeFile-BRfs9FqY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFile-BRfs9FqY.js","names":[],"sources":["../src/writeFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { existsSync, lstatSync, writeFileSync } from \"node:fs\";\nimport { FileOperationError, ValidationError } from \"./error.ts\";\n\ninterface WriteFileParams {\n    file: string | string[];\n    content: string | Buffer;\n    index?: number;\n}\n\n/**\n * Write provided content to a target file.\n *\n * When `file` is an array and `index` is provided, the file at that index is used; otherwise `file` is used directly.\n *\n * @param file - Target path or array of target paths\n * @param content - Content to write; may be a `string` or `Buffer`\n * @param index - Optional index to select a file when `file` is an array\n * @returns The same `content` value that was written\n * @throws ValidationError If no target file, no content, or the resolved target path is invalid\n * @throws FileOperationError If the underlying filesystem write fails (wraps the original error)\n */\nexport function writeFile({\n    file,\n    content,\n    index,\n}: WriteFileParams): string | Buffer {\n    try {\n        if (!file) {\n            throw new ValidationError(\"No target file provided\");\n        }\n\n        if (!content) {\n            throw new ValidationError(\"No content provided\");\n        }\n\n        const targetFile =\n            index !== undefined\n                ? Array.isArray(file)\n                    ? file[index]\n                    : file\n                : file;\n\n        if (typeof targetFile !== \"string\") {\n            throw new ValidationError(\"Invalid target file path\");\n        }\n\n        const shouldWrite =\n            !existsSync(targetFile) || !lstatSync(targetFile).isDirectory();\n\n        if (!shouldWrite) {\n            throw new Error(\"Target path exists and is a directory\");\n        }\n\n        writeFileSync(\n            targetFile,\n            content,\n            Buffer.isBuffer(content) ? undefined : \"utf8\"\n        );\n        return content;\n    } catch (error) {\n        if (error instanceof ValidationError) {\n            throw error;\n        }\n        throw new FileOperationError(\n            \"write to\",\n            typeof file === \"string\" ? file : \"multiple files\",\n            error as Error\n        );\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,UAAU,EACtB,MACA,SACA,SACiC;AACjC,KAAI;AACA,MAAI,CAAC,KACD,OAAM,IAAI,gBAAgB,0BAA0B;AAGxD,MAAI,CAAC,QACD,OAAM,IAAI,gBAAgB,sBAAsB;EAGpD,MAAM,aACF,UAAU,SACJ,MAAM,QAAQ,KAAK,GACf,KAAK,SACL,OACJ;AAEV,MAAI,OAAO,eAAe,SACtB,OAAM,IAAI,gBAAgB,2BAA2B;AAMzD,MAAI,EAFA,CAAC,WAAW,WAAW,IAAI,CAAC,UAAU,WAAW,CAAC,aAAa,EAG/D,OAAM,IAAI,MAAM,wCAAwC;AAG5D,gBACI,YACA,SACA,OAAO,SAAS,QAAQ,GAAG,SAAY,OAC1C;AACD,SAAO;UACF,OAAO;AACZ,MAAI,iBAAiB,gBACjB,OAAM;AAEV,QAAM,IAAI,mBACN,YACA,OAAO,SAAS,WAAW,OAAO,kBAClC,MACH"}

package/dist/writeFile.d.ts

@@ -10,14 +10,16 @@ interface WriteFileParams {
   index?: number;
 }
 /**
- * Write content into file.
- * @param params Object containing file path, content and optional index
- * @returns Written content
- * @throws {ValidationError} If no target file is provided
- * @throws {FileOperationError} If file operations fail
- * @example
- * writeFile({ file: 'output.js', content: 'console.log("Hello")' })
- * writeFile({ file: ['file1.js', 'file2.js'], content: 'shared content', index: 0 })
+ * Write provided content to a target file.
+ *
+ * When `file` is an array and `index` is provided, the file at that index is used; otherwise `file` is used directly.
+ *
+ * @param file - Target path or array of target paths
+ * @param content - Content to write; may be a `string` or `Buffer`
+ * @param index - Optional index to select a file when `file` is an array
+ * @returns The same `content` value that was written
+ * @throws ValidationError If no target file, no content, or the resolved target path is invalid
+ * @throws FileOperationError If the underlying filesystem write fails (wraps the original error)
  */
 declare function writeFile({
   file,

package/dist/writeFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeFile.d.ts","names":[],"sources":["../src/writeFile.ts"],"sourcesContent":[],"mappings":";;;AAyBA;;;UAhBU,eAAA,CAmBN;EACD,IAAA,EAAA,MAAA,GAAA,MAAA,EAAA;EAA2B,OAAA,EAAA,MAAA,GAlBR,MAkBQ;EAAM,KAAA,CAAA,EAAA,MAAA;;;;;;;;;;;;iBAJpB,SAAA;;;;GAIb,2BAA2B"}
+{"version":3,"file":"writeFile.d.ts","names":[],"sources":["../src/writeFile.ts"],"sourcesContent":[],"mappings":";;;AA2BA;;;UAlBU,eAAA,CAqBN;EACD,IAAA,EAAA,MAAA,GAAA,MAAA,EAAA;EAA2B,OAAA,EAAA,MAAA,GApBR,MAoBQ;EAAM,KAAA,CAAA,EAAA,MAAA;;;;;;;;;;;;;;iBAJpB,SAAA;;;;GAIb,2BAA2B"}

package/dist/writeFile.js

@@ -1,3 +1,3 @@
-import { t as writeFile } from "./writeFile-CwK9ZWXr.js";
+import { t as writeFile } from "./writeFile-BRfs9FqY.js";
 
 export { writeFile };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-minify/utils",
-  "version": "10.1.0",
+  "version": "10.2.0",
   "description": "utils for @node-minify",
   "keywords": [
     "compressor",
@@ -46,7 +46,7 @@
     "lint": "biome lint .",
     "prepublishOnly": "bun run build",
     "test": "vitest run",
-    "test:ci": "vitest run --coverage",
+    "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "dev": "tsdown src/index.ts --watch"
@@ -56,6 +56,6 @@
     "gzip-size": "7.0.0"
   },
   "devDependencies": {
-    "@node-minify/types": "workspace:*"
+    "@node-minify/types": "10.2.0"
   }
 }

package/dist/isValidFile-UAwceQud.js

@@ -1,30 +0,0 @@
-import { t as FileOperationError } from "./error-B_uK-F18.js";
-import { existsSync, lstatSync } from "node:fs";
-
-//#region src/isValidFile.ts
-/*!
-* node-minify
-* Copyright(c) 2011-2025 Rodolphe Stoclin
-* MIT Licensed
-*/
-/**
-* Check if the path is a valid file.
-* @param path Path to check
-* @returns true if path exists and is a file, false otherwise
-* @throws {FileOperationError} If filesystem operations fail
-* @example
-* if (isValidFile('path/to/file.js')) {
-*   // do something
-* }
-*/
-function isValidFile(path) {
-	try {
-		return existsSync(path) && !lstatSync(path).isDirectory();
-	} catch (error) {
-		throw new FileOperationError("validate", path, error);
-	}
-}
-
-//#endregion
-export { isValidFile as t };
-//# sourceMappingURL=isValidFile-UAwceQud.js.map

package/dist/isValidFile-UAwceQud.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"isValidFile-UAwceQud.js","names":[],"sources":["../src/isValidFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { existsSync, lstatSync } from \"node:fs\";\nimport { FileOperationError } from \"./error.ts\";\n\n/**\n * Check if the path is a valid file.\n * @param path Path to check\n * @returns true if path exists and is a file, false otherwise\n * @throws {FileOperationError} If filesystem operations fail\n * @example\n * if (isValidFile('path/to/file.js')) {\n *   // do something\n * }\n */\nexport function isValidFile(path: string): boolean {\n    try {\n        return existsSync(path) && !lstatSync(path).isDirectory();\n    } catch (error) {\n        throw new FileOperationError(\"validate\", path, error as Error);\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,YAAY,MAAuB;AAC/C,KAAI;AACA,SAAO,WAAW,KAAK,IAAI,CAAC,UAAU,KAAK,CAAC,aAAa;UACpD,OAAO;AACZ,QAAM,IAAI,mBAAmB,YAAY,MAAM,MAAe"}

package/dist/types-DtDQlx-T.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-DtDQlx-T.d.ts","names":["CompressorReturnType","CompressorResult","CompressorOptions","Record","Compressor","TOptions","MinifierOptions","Promise","FileType","Settings","Result","MinifyOptions"],"sources":["../../types/src/types.d.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 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 * Result returned by a compressor function.\n */\nexport type CompressorResult = {\n    code: string;\n    map?: string;\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     */\n    content?: string;\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     * 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     */\n    content?: string;\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":";;AAwDA;;;AAI2BK,KA7CfJ,gBAAAA,GA6CeI;EAAXD,IAAAA,EAAAA,MAAAA;EAwCFC,GAAAA,CAAAA,EAAAA,MAAAA;CAkBHG;AA4BX;;;;AAMcC,KAhIFP,iBAAAA,GAAoBC,MAgIlBM,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA;;;;;;KAzHFL,4BAA4BF,oBAAoBA,4BACjDI,gBAAgBD,cAAcE,QAAQN;;;;KAKrCO,QAAAA;;;;;;;;;;;;;;;;;;KAmBAC,0BAA0BP,oBAAoBA;;;;cAI1CE,WAAWC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAwCbA;;;;;;;;;;;;;;;;;;SAkBHG;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BCF,iCACSJ,oBAAoBA;;;;YAK3BO,SAASJ"}

package/dist/writeFile-CwK9ZWXr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"writeFile-CwK9ZWXr.js","names":[],"sources":["../src/writeFile.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport { existsSync, lstatSync, writeFileSync } from \"node:fs\";\nimport { FileOperationError, ValidationError } from \"./error.ts\";\n\ninterface WriteFileParams {\n    file: string | string[];\n    content: string | Buffer;\n    index?: number;\n}\n\n/**\n * Write content into file.\n * @param params Object containing file path, content and optional index\n * @returns Written content\n * @throws {ValidationError} If no target file is provided\n * @throws {FileOperationError} If file operations fail\n * @example\n * writeFile({ file: 'output.js', content: 'console.log(\"Hello\")' })\n * writeFile({ file: ['file1.js', 'file2.js'], content: 'shared content', index: 0 })\n */\nexport function writeFile({\n    file,\n    content,\n    index,\n}: WriteFileParams): string | Buffer {\n    try {\n        if (!file) {\n            throw new ValidationError(\"No target file provided\");\n        }\n\n        if (!content) {\n            throw new ValidationError(\"No content provided\");\n        }\n\n        const targetFile =\n            index !== undefined\n                ? Array.isArray(file)\n                    ? file[index]\n                    : file\n                : file;\n\n        if (typeof targetFile !== \"string\") {\n            throw new ValidationError(\"Invalid target file path\");\n        }\n\n        const shouldWrite =\n            !existsSync(targetFile) || !lstatSync(targetFile).isDirectory();\n\n        if (!shouldWrite) {\n            throw new Error(\"Target path exists and is a directory\");\n        }\n\n        writeFileSync(targetFile, content, \"utf8\");\n        return content;\n    } catch (error) {\n        if (error instanceof ValidationError) {\n            throw error;\n        }\n        throw new FileOperationError(\n            \"write to\",\n            typeof file === \"string\" ? file : \"multiple files\",\n            error as Error\n        );\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,UAAU,EACtB,MACA,SACA,SACiC;AACjC,KAAI;AACA,MAAI,CAAC,KACD,OAAM,IAAI,gBAAgB,0BAA0B;AAGxD,MAAI,CAAC,QACD,OAAM,IAAI,gBAAgB,sBAAsB;EAGpD,MAAM,aACF,UAAU,SACJ,MAAM,QAAQ,KAAK,GACf,KAAK,SACL,OACJ;AAEV,MAAI,OAAO,eAAe,SACtB,OAAM,IAAI,gBAAgB,2BAA2B;AAMzD,MAAI,EAFA,CAAC,WAAW,WAAW,IAAI,CAAC,UAAU,WAAW,CAAC,aAAa,EAG/D,OAAM,IAAI,MAAM,wCAAwC;AAG5D,gBAAc,YAAY,SAAS,OAAO;AAC1C,SAAO;UACF,OAAO;AACZ,MAAI,iBAAiB,gBACjB,OAAM;AAEV,QAAM,IAAI,mBACN,YACA,OAAO,SAAS,WAAW,OAAO,kBAClC,MACH"}