Release: merge develop into main

.changeset/allow-empty-output.md

@@ -0,0 +1,9 @@
+---
+"@node-minify/types": minor
+"@node-minify/utils": minor
+"@node-minify/cli": minor
+---
+
+feat: add `allowEmptyOutput` option to skip writing empty output files
+
+When minifiers produce empty output (e.g., CSS files with only comments), the new `allowEmptyOutput` option allows gracefully skipping the file write instead of throwing a validation error. Also adds `--allow-empty-output` CLI flag.

.changeset/fix-gzip-stream-and-action-build.md

@@ -0,0 +1,8 @@
+---
+"@node-minify/utils": patch
+"@node-minify/action": patch
+---
+
+fix: improve gzip size stream handling in utils
+fix: ensure action build fails if type definitions copy fails
+docs: add documentation for action inputs and java-version migration

.changeset/fluffy-eagles-sing.md

@@ -0,0 +1,8 @@
+---
+"@node-minify/utils": minor
+"@node-minify/benchmark": minor
+"@node-minify/docs": patch
+---
+
+feat: add `getFilesizeGzippedRaw` utility and update benchmark defaults
+feat(action): launch `@node-minify/action` GitHub Action

.github/actions/node-minify/README.md

@@ -1,41 +1,94 @@
-# node-minify GitHub Action
+# node-minify GitHub Action (DEPRECATED)
 
-Minify JavaScript, CSS, and HTML files in your CI/CD pipeline with detailed reporting.
+> **This action is deprecated.** Please use the new bundled action instead:
+>
+> ```yaml
+> - uses: srod/node-minify@v1
+> ```
 
-## Usage
+The new action includes:
+- Bundled dependencies (faster startup)
+- PR comment reporting
+- File annotations
+- Benchmark comparison
+- Threshold enforcement
+- More compressor options
 
-### Basic Example
+## Migration
+
+Replace:
 
 ```yaml
-- name: Minify JavaScript
-  uses: srod/node-minify/.github/actions/node-minify@main
+- uses: srod/node-minify/.github/actions/node-minify@main
+  with:
+    input: "src/app.js"
+    output: "dist/app.min.js"
+    compressor: "terser"
+```
+
+With:
+
+```yaml
+- uses: srod/node-minify@v1
   with:
     input: "src/app.js"
     output: "dist/app.min.js"
     compressor: "terser"
 ```
 
-### With All Options
+### Removed Inputs
+
+The following inputs are **not supported** in the new action and must be removed from your workflow YAML:
+
+| Removed Input | Migration Guide |
+|---------------|-----------------|
+| `include-gzip` | Gzip sizes are now always included in the output. No action needed. |
+| `java-version` | Use `actions/setup-java@v4` before running the action (see example below). |
+
+#### Java Compressors Migration
+
+If you use `gcc` or `yui` compressors that require Java:
+
+**Before (deprecated):**
+```yaml
+- uses: srod/node-minify/.github/actions/node-minify@main
+  with:
+    compressor: gcc
+    java-version: "17"
+```
+
+**After:**
+```yaml
+- uses: actions/setup-java@v4
+  with:
+    distribution: 'temurin'
+    java-version: '17'
+
+- uses: srod/node-minify@v1
+  with:
+    compressor: gcc
+```
+
+See [packages/action/README.md](../../../packages/action/README.md) for full documentation.
+
+---
+
+## Legacy Documentation
+
+The following documentation is for the deprecated composite action.
+
+### Basic Example
 
 ```yaml
-- name: Minify with full options
-  id: minify
+- name: Minify JavaScript
   uses: srod/node-minify/.github/actions/node-minify@main
   with:
     input: "src/app.js"
     output: "dist/app.min.js"
-    compressor: "esbuild"
-    type: "js"
-    options: '{"minify": true}'
-    report-summary: "true"
-    include-gzip: "true"
-
-- name: Show results
-  run: |
-    echo "Reduction: ${{ steps.minify.outputs.reduction-percent }}%"
+    compressor: "terser"
 ```
 
-## Inputs
+### Inputs
 
 | Input | Description | Required | Default |
 |-------|-------------|----------|---------|
@@ -48,30 +101,7 @@ Minify JavaScript, CSS, and HTML files in your CI/CD pipeline with detailed repo
 | `include-gzip` | Include gzip sizes | No | `true` |
 | `java-version` | Java version for gcc/yui | No | - |
 
-### Available Compressors
-
-**JavaScript (no Java required):**
-- `terser` (recommended)
-- `esbuild` (fastest)
-- `swc`
-- `oxc`
-- `uglify-js`
-
-**CSS (no Java required):**
-- `lightningcss` (recommended)
-- `clean-css`
-- `cssnano`
-- `csso`
-- `esbuild`
-
-**HTML:**
-- `html-minifier`
-
-**Requires Java:**
-- `gcc` (Google Closure Compiler)
-- `yui` (deprecated)
-
-## Outputs
+### Outputs
 
 | Output | Description |
 |--------|-------------|
@@ -84,49 +114,6 @@ Minify JavaScript, CSS, and HTML files in your CI/CD pipeline with detailed repo
 | `gzip-size-formatted` | Gzipped size formatted |
 | `time-ms` | Compression time in milliseconds |
 
-## Examples
-
-### CSS Minification
-
-```yaml
-- name: Minify CSS
-  uses: srod/node-minify/.github/actions/node-minify@main
-  with:
-    input: "src/styles.css"
-    output: "dist/styles.min.css"
-    compressor: "lightningcss"
-    type: "css"
-```
-
-### Using Google Closure Compiler
-
-```yaml
-- name: Setup Java
-  uses: actions/setup-java@v4
-  with:
-    distribution: "temurin"
-    java-version: "17"
-
-- name: Minify with GCC
-  uses: srod/node-minify/.github/actions/node-minify@main
-  with:
-    input: "src/app.js"
-    output: "dist/app.min.js"
-    compressor: "gcc"
-    options: '{"compilation_level": "ADVANCED_OPTIMIZATIONS"}'
-```
-
-### HTML Minification
-
-```yaml
-- name: Minify HTML
-  uses: srod/node-minify/.github/actions/node-minify@main
-  with:
-    input: "src/index.html"
-    output: "dist/index.html"
-    compressor: "html-minifier"
-```
-
 ## License
 
 MIT

.github/actions/node-minify/action.yml

@@ -1,9 +1,9 @@
-name: "node-minify"
-description: "Minify JavaScript, CSS, and HTML files with detailed reporting"
+name: "node-minify (deprecated)"
+description: "DEPRECATED: Use srod/node-minify@v1 instead. This composite action will be removed in a future release."
 author: "srod"
 branding:
   icon: "minimize-2"
-  color: "green"
+  color: "gray"
 
 inputs:
   input:
@@ -20,7 +20,7 @@ inputs:
     description: "Output file path"
     required: true
   type:
-    description: "File type: js or css (required for esbuild, lightningcss, yui)"
+    description: "File type: js or css (required for esbuild, yui)"
     required: false
   options:
     description: "Compressor-specific options (JSON string)"
@@ -67,15 +67,18 @@ outputs:
 runs:
   using: "composite"
   steps:
-    # Setup Java for gcc/yui compressors (auto-setup with default if java-version not specified)
+    - name: Deprecation warning
+      shell: bash
+      run: |
+        echo "::warning::This action (.github/actions/node-minify) is DEPRECATED. Please migrate to 'uses: srod/node-minify@v1' for the new bundled action with more features (PR comments, annotations, benchmarking)."
+
     - name: Setup Java (for gcc/yui)
       if: contains(fromJSON('["gcc", "google-closure-compiler", "yui"]'), inputs.compressor)
       uses: actions/setup-java@v4
       with:
         distribution: "temurin"
         java-version: ${{ inputs.java-version || '17' }}
 
-    # Warn about deprecated yui compressor
     - name: Deprecation warning (yui)
       if: inputs.compressor == 'yui'
       shell: bash
@@ -85,7 +88,7 @@ runs:
     - name: Setup Bun
       uses: oven-sh/setup-bun@v2
       with:
-        bun-version: "1.3.5"
+        bun-version: "1.3.6"
 
     - name: Install dependencies
       shell: bash
@@ -121,7 +124,7 @@ runs:
       shell: bash
       run: |
         cat >> $GITHUB_STEP_SUMMARY << EOF
-        ## 📦 node-minify Results
+        ## node-minify Results
 
         | Metric | Value |
         |--------|-------|
@@ -134,4 +137,6 @@ runs:
         | **Gzip Size** | ${{ steps.minify.outputs.gzip-size-formatted }} |
         | **Time** | ${{ steps.minify.outputs.time-ms }}ms |
 
+        > **Note:** This action is deprecated. Please migrate to \`uses: srod/node-minify@v1\` for enhanced features.
+
         EOF

.github/actions/node-minify/minify.ts

@@ -2,65 +2,10 @@ import { appendFileSync, existsSync } from "node:fs";
 import { stat } from "node:fs/promises";
 import { resolve } from "node:path";
 import { minify } from "@node-minify/core";
-import { getFilesizeGzippedInBytes } from "@node-minify/utils";
-
-const KNOWN_COMPRESSOR_EXPORTS: Record<string, string> = {
-    esbuild: "esbuild",
-    "google-closure-compiler": "gcc",
-    gcc: "gcc",
-    oxc: "oxc",
-    swc: "swc",
-    terser: "terser",
-    "uglify-js": "uglifyJs",
-    "babel-minify": "babelMinify",
-    "uglify-es": "uglifyEs",
-    yui: "yui",
-    "clean-css": "cleanCss",
-    cssnano: "cssnano",
-    csso: "csso",
-    lightningcss: "lightningCss",
-    crass: "crass",
-    sqwish: "sqwish",
-    "html-minifier": "htmlMinifier",
-    jsonminify: "jsonMinify",
-    imagemin: "imagemin",
-    sharp: "sharp",
-    svgo: "svgo",
-    "no-compress": "noCompress",
-};
-
-/**
- * Resolves a compressor function from the @node-minify/{name} package and returns it with a label.
- *
- * @param name - Compressor package identifier (e.g., "terser", "esbuild"); used to import @node-minify/{name}
- * @returns An object containing `compressor` (the resolved compressor function) and `label` (the provided name)
- * @throws Error if the package does not export a usable compressor function
- */
-async function resolveCompressor(
-    name: string
-): Promise<{ compressor: unknown; label: string }> {
-    const packageName = `@node-minify/${name}`;
-    const mod = (await import(packageName)) as Record<string, unknown>;
-
-    const knownExport = KNOWN_COMPRESSOR_EXPORTS[name];
-    if (knownExport && typeof mod[knownExport] === "function") {
-        return { compressor: mod[knownExport], label: name };
-    }
-
-    if (typeof mod.default === "function") {
-        return { compressor: mod.default, label: name };
-    }
-
-    for (const value of Object.values(mod)) {
-        if (typeof value === "function") {
-            return { compressor: value, label: name };
-        }
-    }
-
-    throw new Error(
-        `Package '${packageName}' doesn't export a valid compressor function.`
-    );
-}
+import {
+    getFilesizeGzippedInBytes,
+    resolveCompressor,
+} from "@node-minify/utils";
 
 interface ActionResult {
     originalSize: number;
@@ -164,9 +109,7 @@ async function run(): Promise<void> {
 
         console.log(`Minifying ${inputFile} with ${label}...`);
 
-        const requiresType = ["esbuild", "lightningcss", "yui"].includes(
-            compressorName
-        );
+        const requiresType = ["esbuild", "yui"].includes(compressorName);
         if (requiresType && !fileType) {
             console.error(
                 `::error::Compressor '${compressorName}' requires the 'type' input (js or css)`

.github/workflows/codeql.yml

@@ -29,7 +29,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: "1.3.5"
+          bun-version: "1.3.6"
 
       - name: Setup Node.js
         uses: actions/setup-node@v6

.github/workflows/publish.yml

@@ -27,7 +27,7 @@ jobs:
       - name: 📦 Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: "1.3.5"
+          bun-version: "1.3.6"
 
       - name: ⚙️ Setup Node
         uses: actions/setup-node@v6