@node-minify/terser 10.1.1 → 10.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/README.md +4 -4
- package/dist/index.d.ts +55 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8 -5
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
|
-
<p align="center"><img src="/static/node-minify.svg" width="348" alt="node-minify"></p>
|
|
1
|
+
<p align="center"><img src="https://raw.githubusercontent.com/srod/node-minify/main/static/node-minify.svg" width="348" alt="node-minify"></p>
|
|
2
2
|
|
|
3
3
|
<p align="center">A very light minifier Node.js module.</p>
|
|
4
4
|
|
|
5
5
|
<p align="center">
|
|
6
6
|
<br>
|
|
7
|
-
<a href="https://npmjs.org/package/@node-minify/terser"><img src="https://img.shields.io/npm/v/@node-minify/terser.svg"></a>
|
|
8
|
-
<a href="https://npmjs.org/package/@node-minify/terser"><img src="https://img.shields.io/npm/dm/@node-minify/terser.svg"></a>
|
|
7
|
+
<a href="https://npmjs.org/package/@node-minify/terser"><img src="https://img.shields.io/npm/v/@node-minify/terser.svg" alt="npm version"></a>
|
|
8
|
+
<a href="https://npmjs.org/package/@node-minify/terser"><img src="https://img.shields.io/npm/dm/@node-minify/terser.svg" alt="npm downloads"></a>
|
|
9
9
|
<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>
|
|
10
|
-
<a href="https://codecov.io/gh/srod/node-minify"><img src="https://codecov.io/gh/srod/node-minify/branch/main/graph/badge.svg"></a>
|
|
10
|
+
<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>
|
|
11
11
|
</p>
|
|
12
12
|
|
|
13
13
|
# terser
|
package/dist/index.d.ts
CHANGED
|
@@ -1,11 +1,47 @@
|
|
|
1
1
|
//#region ../types/src/types.d.ts
|
|
2
2
|
|
|
3
|
+
/**
|
|
4
|
+
* Output result for multi-format image compression.
|
|
5
|
+
*/
|
|
6
|
+
type CompressorOutput = {
|
|
7
|
+
/**
|
|
8
|
+
* Format of the output (e.g., 'webp', 'avif').
|
|
9
|
+
*/
|
|
10
|
+
format?: string;
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* Output content as string or Buffer.
|
|
14
|
+
*/
|
|
15
|
+
content: string | Buffer;
|
|
16
|
+
};
|
|
3
17
|
/**
|
|
4
18
|
* Result returned by a compressor function.
|
|
5
19
|
*/
|
|
6
20
|
type CompressorResult = {
|
|
21
|
+
/**
|
|
22
|
+
* Minified content as string (for text-based formats like JS, CSS, HTML, SVG).
|
|
23
|
+
*/
|
|
7
24
|
code: string;
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Source map (for JS/CSS compressors).
|
|
28
|
+
*/
|
|
8
29
|
map?: string;
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Minified content as Buffer (for binary formats like images).
|
|
33
|
+
* @example
|
|
34
|
+
* When using sharp for PNG/WebP compression
|
|
35
|
+
*/
|
|
36
|
+
buffer?: Buffer;
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Multiple outputs for multi-format image compression.
|
|
40
|
+
* Used when converting to multiple formats simultaneously.
|
|
41
|
+
* @example
|
|
42
|
+
* [{ format: 'webp', content: <Buffer> }, { format: 'avif', content: <Buffer> }]
|
|
43
|
+
*/
|
|
44
|
+
outputs?: CompressorOutput[];
|
|
9
45
|
};
|
|
10
46
|
/**
|
|
11
47
|
* Base options that all compressors can accept.
|
|
@@ -53,8 +89,10 @@ type Settings<TOptions extends CompressorOptions = CompressorOptions> = {
|
|
|
53
89
|
/**
|
|
54
90
|
* Content to minify (for in-memory minification).
|
|
55
91
|
* If provided, input/output are not required.
|
|
92
|
+
* For text-based formats (JS, CSS, HTML, SVG): string
|
|
93
|
+
* For binary formats (images): Buffer (handled internally by image compressors)
|
|
56
94
|
*/
|
|
57
|
-
content?: string;
|
|
95
|
+
content?: string | Buffer;
|
|
58
96
|
|
|
59
97
|
/**
|
|
60
98
|
* Input file path(s) or glob pattern.
|
|
@@ -97,6 +135,12 @@ type Settings<TOptions extends CompressorOptions = CompressorOptions> = {
|
|
|
97
135
|
*/
|
|
98
136
|
buffer?: number;
|
|
99
137
|
|
|
138
|
+
/**
|
|
139
|
+
* Timeout for the compressor process (in milliseconds).
|
|
140
|
+
* If execution exceeds this limit, the process will be killed.
|
|
141
|
+
*/
|
|
142
|
+
timeout?: number;
|
|
143
|
+
|
|
100
144
|
/**
|
|
101
145
|
* File type for compressors that support multiple types.
|
|
102
146
|
* Required for YUI compressor.
|
|
@@ -136,8 +180,11 @@ type MinifierOptions<TOptions extends CompressorOptions = CompressorOptions> = {
|
|
|
136
180
|
|
|
137
181
|
/**
|
|
138
182
|
* The content to minify.
|
|
183
|
+
* For text-based formats (JS, CSS, HTML, SVG): string
|
|
184
|
+
* For binary formats (images): Buffer
|
|
185
|
+
* For multiple binary files: Buffer[]
|
|
139
186
|
*/
|
|
140
|
-
content?: string;
|
|
187
|
+
content?: string | Buffer | Buffer[];
|
|
141
188
|
|
|
142
189
|
/**
|
|
143
190
|
* Index of current file when processing multiple files.
|
|
@@ -147,10 +194,12 @@ type MinifierOptions<TOptions extends CompressorOptions = CompressorOptions> = {
|
|
|
147
194
|
//#endregion
|
|
148
195
|
//#region src/index.d.ts
|
|
149
196
|
/**
|
|
150
|
-
*
|
|
151
|
-
*
|
|
152
|
-
* @param
|
|
153
|
-
* @
|
|
197
|
+
* Minifies JavaScript content using Terser.
|
|
198
|
+
*
|
|
199
|
+
* @param settings - Optional minifier settings; `settings.options` are forwarded to Terser
|
|
200
|
+
* @param content - Input to minify; non-string inputs will be converted to a string
|
|
201
|
+
* @returns An object with `code` containing the minified source and `map` containing the source map string when available
|
|
202
|
+
* @throws Error if Terser produces no output code
|
|
154
203
|
*/
|
|
155
204
|
declare function terser({
|
|
156
205
|
settings,
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +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-
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":["CompressorReturnType","ImageFormat","CompressorOutput","Buffer","CompressorResult","CompressorOptions","Record","Compressor","TOptions","MinifierOptions","Promise","FileType","Settings","Result","MinifyOptions"],"sources":["../../types/src/types.d.ts","../src/index.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\n/**\n * The return type of a compressor function.\n * @deprecated Use `CompressorResult` instead. Will be removed in v11.\n */\nexport type CompressorReturnType = string;\n\n/**\n * Supported image formats for image compression.\n */\nexport type ImageFormat =\n | \"webp\"\n | \"avif\"\n | \"png\"\n | \"jpeg\"\n | \"jpg\"\n | \"gif\"\n | \"tiff\"\n | \"heif\"\n | \"heic\";\n\n/**\n * Output result for multi-format image compression.\n */\nexport type CompressorOutput = {\n /**\n * Format of the output (e.g., 'webp', 'avif').\n */\n format?: string;\n\n /**\n * Output content as string or Buffer.\n */\n content: string | Buffer;\n};\n\n/**\n * Result returned by a compressor function.\n */\nexport type CompressorResult = {\n /**\n * Minified content as string (for text-based formats like JS, CSS, HTML, SVG).\n */\n code: string;\n\n /**\n * Source map (for JS/CSS compressors).\n */\n map?: string;\n\n /**\n * Minified content as Buffer (for binary formats like images).\n * @example\n * When using sharp for PNG/WebP compression\n */\n buffer?: Buffer;\n\n /**\n * Multiple outputs for multi-format image compression.\n * Used when converting to multiple formats simultaneously.\n * @example\n * [{ format: 'webp', content: <Buffer> }, { format: 'avif', content: <Buffer> }]\n */\n outputs?: CompressorOutput[];\n};\n\n/**\n * Base options that all compressors can accept.\n * Specific compressors may extend this with their own options.\n */\nexport type CompressorOptions = Record<string, unknown>;\n\n/**\n * A compressor function that minifies content.\n * @param args - The minifier options including settings and content\n * @returns A promise resolving to the compression result\n */\nexport type Compressor<TOptions extends CompressorOptions = CompressorOptions> =\n (args: MinifierOptions<TOptions>) => Promise<CompressorResult>;\n\n/**\n * File type for compressors that support multiple types (e.g., YUI).\n */\nexport type FileType = \"js\" | \"css\";\n\n/**\n * User-facing settings for the minify function.\n * This is what users pass when calling minify().\n *\n * @example\n * ```ts\n * import { minify } from '@node-minify/core';\n * import { terser } from '@node-minify/terser';\n *\n * await minify({\n * compressor: terser,\n * input: 'src/*.js',\n * output: 'dist/bundle.min.js',\n * options: { mangle: true }\n * });\n * ```\n */\nexport type Settings<TOptions extends CompressorOptions = CompressorOptions> = {\n /**\n * The compressor function to use for minification.\n */\n compressor: Compressor<TOptions>;\n\n /**\n * Optional label for the compressor (used in logging).\n */\n compressorLabel?: string;\n\n /**\n * Content to minify (for in-memory minification).\n * If provided, input/output are not required.\n * For text-based formats (JS, CSS, HTML, SVG): string\n * For binary formats (images): Buffer (handled internally by image compressors)\n */\n content?: string | Buffer;\n\n /**\n * Input file path(s) or glob pattern.\n * Can be a single file, array of files, or wildcard pattern.\n *\n * @example\n * - 'src/app.js'\n * - ['src/a.js', 'src/b.js']\n * - 'src/**\\/*.js'\n */\n input?: string | string[];\n\n /**\n * Output file path.\n * Use $1 as placeholder for input filename in multi-file scenarios.\n * Can be a single file, array of files, or pattern with $1.\n *\n * @example\n * - 'dist/bundle.min.js'\n * - ['file1.min.js', 'file2.min.js']\n * - '$1.min.js' (creates app.min.js from app.js)\n */\n output?: string | string[];\n\n /**\n * Compressor-specific options.\n * See individual compressor documentation for available options.\n */\n options?: TOptions;\n\n /**\n * CLI option string (used by CLI only).\n * @internal\n */\n option?: string;\n\n /**\n * Buffer size for file operations (in bytes).\n * @default 1024000 (1MB)\n */\n buffer?: number;\n\n /**\n * Timeout for the compressor process (in milliseconds).\n * If execution exceeds this limit, the process will be killed.\n */\n timeout?: number;\n\n /**\n * File type for compressors that support multiple types.\n * Required for YUI compressor.\n */\n type?: FileType;\n\n /**\n * Suppress console output.\n * @default false\n */\n silence?: boolean;\n\n /**\n * Public folder to prepend to input paths.\n *\n * @example\n * With publicFolder: 'public/js/' and input: 'app.js',\n * the actual path becomes 'public/js/app.js'\n */\n publicFolder?: string;\n\n /**\n * Replace files in place instead of creating new output files.\n * @default false\n */\n replaceInPlace?: boolean;\n};\n\n/**\n * Options passed to compressor functions internally.\n * This is what compressors receive, not what users pass.\n */\nexport type MinifierOptions<\n TOptions extends CompressorOptions = CompressorOptions,\n> = {\n /**\n * The full settings object.\n */\n settings: Settings<TOptions>;\n\n /**\n * The content to minify.\n * For text-based formats (JS, CSS, HTML, SVG): string\n * For binary formats (images): Buffer\n * For multiple binary files: Buffer[]\n */\n content?: string | Buffer | Buffer[];\n\n /**\n * Index of current file when processing multiple files.\n */\n index?: number;\n};\n\n/**\n * Result returned after compression (used by CLI).\n */\nexport type Result = {\n /**\n * Label of the compressor used.\n */\n compressorLabel: string;\n\n /**\n * Size of minified content (formatted string, e.g., \"1.5 KB\").\n */\n size: string;\n\n /**\n * Gzipped size of minified content (formatted string).\n */\n sizeGzip: string;\n};\n\n/**\n * Type alias for user convenience.\n * @deprecated Use `Settings` instead. Will be removed in v11.\n */\nexport type MinifyOptions<\n TOptions extends CompressorOptions = CompressorOptions,\n> = Settings<TOptions>;\n"],"mappings":";;;;;AA2NsC,KA9L1BE,gBAAAA,GA8L0B;;;;ECzMhB,MAAA,CAAA,EAAM,MAAA;;EAExB;;;EACiB,OAAA,EAAA,MAAA,GDiBCC,MCjBD;CAAO;;;;KDuBhBC,gBAAAA;;;;;;;;;;;;;;;;WAgBCD;;;;;;;;YAQCD;;;;;;KAOFG,iBAAAA,GAAoBC;;;;;;KAOpBC,4BAA4BF,oBAAoBA,4BACjDI,gBAAgBD,cAAcE,QAAQN;;;;KAKrCO,QAAAA;;;;;;;;;;;;;;;;;;KAmBAC,0BAA0BP,oBAAoBA;;;;cAI1CE,WAAWC;;;;;;;;;;;;;qBAaJL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA6BTK;;;;;;;;;;;;;;;;;;;;;;;;SAwBHG;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BCF,iCACSJ,oBAAoBA;;;;YAK3BO,SAASJ;;;;;;;;qBAQAL,SAASA;;;;;;;;;;;;;;;AAnIhC;AAmBA;AAAsCE,iBCzFhB,MAAA,CDyFgBA;EAAAA,QAAAA;EAAAA;AAAAA,CAAAA,ECtFnC,eDsFmCA,CAAAA,ECtFjB,ODsFiBA,CCtFT,gBDsFSA,CAAAA"}
|
package/dist/index.js
CHANGED
|
@@ -1,14 +1,17 @@
|
|
|
1
|
+
import { ensureStringContent } from "@node-minify/utils";
|
|
1
2
|
import { minify } from "terser";
|
|
2
3
|
|
|
3
4
|
//#region src/index.ts
|
|
4
5
|
/**
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
* @param
|
|
8
|
-
* @
|
|
6
|
+
* Minifies JavaScript content using Terser.
|
|
7
|
+
*
|
|
8
|
+
* @param settings - Optional minifier settings; `settings.options` are forwarded to Terser
|
|
9
|
+
* @param content - Input to minify; non-string inputs will be converted to a string
|
|
10
|
+
* @returns An object with `code` containing the minified source and `map` containing the source map string when available
|
|
11
|
+
* @throws Error if Terser produces no output code
|
|
9
12
|
*/
|
|
10
13
|
async function terser({ settings, content }) {
|
|
11
|
-
const result = await minify(content
|
|
14
|
+
const result = await minify(ensureStringContent(content, "terser"), settings?.options);
|
|
12
15
|
if (typeof result.code !== "string") throw new Error("Terser failed: empty result");
|
|
13
16
|
return {
|
|
14
17
|
code: result.code,
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright(c) 2011-
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/*!\n * node-minify\n * Copyright (c) 2011-2026 Rodolphe Stoclin\n * MIT Licensed\n */\n\nimport type { CompressorResult, MinifierOptions } from \"@node-minify/types\";\nimport { ensureStringContent } from \"@node-minify/utils\";\nimport { minify } from \"terser\";\n\n/**\n * Minifies JavaScript content using Terser.\n *\n * @param settings - Optional minifier settings; `settings.options` are forwarded to Terser\n * @param content - Input to minify; non-string inputs will be converted to a string\n * @returns An object with `code` containing the minified source and `map` containing the source map string when available\n * @throws Error if Terser produces no output code\n */\nexport async function terser({\n settings,\n content,\n}: MinifierOptions): Promise<CompressorResult> {\n const contentStr = ensureStringContent(content, \"terser\");\n\n const result = await minify(contentStr, settings?.options);\n\n if (typeof result.code !== \"string\") {\n throw new Error(\"Terser failed: empty result\");\n }\n\n return {\n code: result.code,\n map: typeof result.map === \"string\" ? result.map : undefined,\n };\n}\n"],"mappings":";;;;;;;;;;;;AAkBA,eAAsB,OAAO,EACzB,UACA,WAC2C;CAG3C,MAAM,SAAS,MAAM,OAFF,oBAAoB,SAAS,SAAS,EAEjB,UAAU,QAAQ;AAE1D,KAAI,OAAO,OAAO,SAAS,SACvB,OAAM,IAAI,MAAM,8BAA8B;AAGlD,QAAO;EACH,MAAM,OAAO;EACb,KAAK,OAAO,OAAO,QAAQ,WAAW,OAAO,MAAM;EACtD"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@node-minify/terser",
|
|
3
|
-
"version": "10.
|
|
3
|
+
"version": "10.3.0",
|
|
4
4
|
"description": "terser plugin for @node-minify",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"compressor",
|
|
@@ -52,10 +52,10 @@
|
|
|
52
52
|
"dev": "tsdown src/index.ts --watch"
|
|
53
53
|
},
|
|
54
54
|
"dependencies": {
|
|
55
|
-
"@node-minify/utils": "10.
|
|
55
|
+
"@node-minify/utils": "10.3.0",
|
|
56
56
|
"terser": "5.44.1"
|
|
57
57
|
},
|
|
58
58
|
"devDependencies": {
|
|
59
|
-
"@node-minify/types": "10.
|
|
59
|
+
"@node-minify/types": "10.3.0"
|
|
60
60
|
}
|
|
61
61
|
}
|