@node-minify/csso 10.1.1 → 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/csso"><img src="https://img.shields.io/npm/v/@node-minify/csso.svg"></a>
-  <a href="https://npmjs.org/package/@node-minify/csso"><img src="https://img.shields.io/npm/dm/@node-minify/csso.svg"></a>
+  <a href="https://npmjs.org/package/@node-minify/csso"><img src="https://img.shields.io/npm/v/@node-minify/csso.svg" alt="npm version"></a>
+  <a href="https://npmjs.org/package/@node-minify/csso"><img src="https://img.shields.io/npm/dm/@node-minify/csso.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>
 
 # csso

package/dist/index.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.
@@ -147,10 +188,11 @@ type MinifierOptions<TOptions extends CompressorOptions = CompressorOptions> = {
 //#endregion
 //#region src/index.d.ts
 /**
- * Run csso.
- * @param settings - CSSO options
- * @param content - Content to minify
- * @returns Minified content
+ * Minifies CSS using CSSO.
+ *
+ * @param settings - CSSO minifier options (passed to CSSO's `minify` call)
+ * @param content - CSS content to minify; non-string values will be coerced to a string
+ * @returns An object with the minified CSS available as the `code` property
  */
 declare function csso({
   settings,

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["CompressorReturnType","CompressorResult","CompressorOptions","Record","Compressor","TOptions","MinifierOptions","Promise","FileType","Settings","Result","MinifyOptions"],"sources":["../../types/src/types.d.ts","../src/index.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-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;;;;ACzId;;AAEI,KDcQL,UCdR,CAAA,iBDcoCF,iBCdpC,GDcwDA,iBCdxD,CAAA,GACD,CAAA,IAAA,EDcQI,eCdR,CDcwBD,QCdxB,CAAA,EAAA,GDcsCE,OCdtC,CDc8CN,gBCd9C,CAAA;;;;KDmBSO,QAAAA;;;;;;;;;;;;;;;;;;KAmBAC,0BAA0BP,oBAAoBA;;;;cAI1CE,WAAWC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAwCbA;;;;;;;;;;;;;;;;;;SAkBHG;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BCF,iCACSJ,oBAAoBA;;;;YAK3BO,SAASJ;;;;;;;;;;;;;;;;;;;AAnHvB;AAmBYI,iBCzCU,IAAA,CDyCFJ;EAAAA,QAAA;EAAA;AAAA,CAAA,ECtCjB,eDsCiB,CAAA,ECtCC,ODsCD,CCtCS,gBDsCT,CAAA"}
+{"version":3,"file":"index.d.ts","names":["CompressorReturnType","ImageFormat","CompressorOutput","Buffer","CompressorResult","CompressorOptions","Record","Compressor","TOptions","MinifierOptions","Promise","FileType","Settings","Result","MinifyOptions"],"sources":["../../types/src/types.d.ts","../src/index.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-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;;;;ECpMhB,MAAA,CAAI,EAAA,MAAA;;EAEtB;;;EACiB,OAAA,EAAA,MAAA,GDkBCC,MClBD;CAAO;;;;KDwBhBC,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;;;;;;;;;;;;;;;AA7HhC;AAmBYS,iBC1FU,IAAA,CD0FFJ;EAAAA,QAAA;EAAA;AAAA,CAAA,ECvFjB,eDuFiB,CAAA,ECvFC,ODuFD,CCvFS,gBDuFT,CAAA"}

package/dist/index.js

@@ -1,14 +1,16 @@
+import { ensureStringContent } from "@node-minify/utils";
 import { minify } from "csso";
 
 //#region src/index.ts
 /**
-* Run csso.
-* @param settings - CSSO options
-* @param content - Content to minify
-* @returns Minified content
+* Minifies CSS using CSSO.
+*
+* @param settings - CSSO minifier options (passed to CSSO's `minify` call)
+* @param content - CSS content to minify; non-string values will be coerced to a string
+* @returns An object with the minified CSS available as the `code` property
 */
 async function csso({ settings, content }) {
-	return { code: (await minify(content ?? "", settings?.options)).css };
+	return { code: (await minify(ensureStringContent(content, "csso"), settings?.options)).css };
 }
 
 //#endregion

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport type { CompressorResult, MinifierOptions } from \"@node-minify/types\";\nimport { minify } from \"csso\";\n\n/**\n * Run csso.\n * @param settings - CSSO options\n * @param content - Content to minify\n * @returns Minified content\n */\nexport async function csso({\n    settings,\n    content,\n}: MinifierOptions): Promise<CompressorResult> {\n    const result = await minify(content ?? \"\", settings?.options);\n\n    return { code: result.css };\n}\n"],"mappings":";;;;;;;;;AAeA,eAAsB,KAAK,EACvB,UACA,WAC2C;AAG3C,QAAO,EAAE,OAFM,MAAM,OAAO,WAAW,IAAI,UAAU,QAAQ,EAEvC,KAAK"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-2025 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport type { CompressorResult, MinifierOptions } from \"@node-minify/types\";\nimport { ensureStringContent } from \"@node-minify/utils\";\nimport { minify } from \"csso\";\n\n/**\n * Minifies CSS using CSSO.\n *\n * @param settings - CSSO minifier options (passed to CSSO's `minify` call)\n * @param content - CSS content to minify; non-string values will be coerced to a string\n * @returns An object with the minified CSS available as the `code` property\n */\nexport async function csso({\n    settings,\n    content,\n}: MinifierOptions): Promise<CompressorResult> {\n    const contentStr = ensureStringContent(content, \"csso\");\n\n    const result = await minify(contentStr, settings?.options);\n\n    return { code: result.css };\n}\n"],"mappings":";;;;;;;;;;;AAiBA,eAAsB,KAAK,EACvB,UACA,WAC2C;AAK3C,QAAO,EAAE,OAFM,MAAM,OAFF,oBAAoB,SAAS,OAAO,EAEf,UAAU,QAAQ,EAEpC,KAAK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-minify/csso",
-  "version": "10.1.1",
+  "version": "10.2.0",
   "description": "csso plugin for @node-minify",
   "keywords": [
     "compressor",
@@ -52,11 +52,11 @@
     "dev": "tsdown src/index.ts --watch"
   },
   "dependencies": {
-    "@node-minify/utils": "10.1.1",
+    "@node-minify/utils": "10.2.0",
     "csso": "5.0.5"
   },
   "devDependencies": {
-    "@node-minify/types": "10.1.1",
+    "@node-minify/types": "10.2.0",
     "@types/csso": "^5.0.4"
   }
 }