chore: reduce npm package size

Author: webdiscus

.github/workflows/test.yml

@@ -4,37 +4,74 @@ on:
   push:
     branches:
       - master
+      - next
   pull_request:
     branches:
       - master
+      - next
 
 jobs:
-  integration:
+  build:
+    name: Build package
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      # Rollup requires Node.js >=18
+      - name: Set up Node.js 18
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build package
+        run: npm run build
+
+      - name: Save build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: built-package
+          path: ./dist/ # build output
+          retention-days: 1 # keep the artifact for 1 day
+
+  test:
+    name: Test LTS
+    needs: build
     strategy:
       matrix:
         os: [ubuntu-latest]
-        node-version: [ 14, 16, 18, 20 ]
-
+        node-version: [ 18, 20, 22 ]
     runs-on: ${{ matrix.os }}
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           fetch-depth: 1
 
       - name: Set up Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
 
-      - name: Install dependencies
-        run: npm i
+      - name: Download built package
+        uses: actions/download-artifact@v4
+        with:
+          name: built-package
+          path: ./dist/
+
+      - name: Install dependencies (without rebuilding)
+        run: npm install --ignore-scripts
 
       - name: Run the tests
         run: npm run test:coverage
 
       - name: Submit coverage data to codecov
         uses: codecov/codecov-action@v3
         with:
-          flags: integration
+          flags: test
           token: ${{ secrets.CODECOV_TOKEN }}

CHANGELOG.md

@@ -1,3 +1,11 @@
+## 1.1.0 (2025-05-25)
+
+- chore: optimize npm package and reduce unpacked size: 31 kB -> 9 kB
+- docs: update readme
+
+## 1.0.4 (2023-09-23)
+- docs: update readme
+
 ## 1.0.4 (2023-08-28)
 - fix: remove needless double new lines in console output when the `verbose` option is enabled
 - chore: add Community Standards files

LICENSE

@@ -1,6 +1,6 @@
 ISC License
 
-Copyright (c) 2021-2024, webdiscus
+Copyright (c) 2021-2025, webdiscus
 Copyright (c) 20218-2020, fqborges
 
 Permission to use, copy, modify, and/or distribute this software for any

README.md

@@ -1,25 +1,24 @@
 <div align="center">
   <img width="120" height="120" src="https://cdn.worldvectorlogo.com/logos/logo-javascript.svg">
-  <a href="https://webpack.js.org/">
-    <img width="120" height="120" vspace="" hspace="25" src="https://cdn.rawgit.com/webpack/media/e7485eb2/logo/icon-square-big.svg">
-  </a>
+  <img width="120" height="120" vspace="" hspace="25" src="https://cdn.rawgit.com/webpack/media/e7485eb2/logo/icon-square-big.svg">
   <h1><a href="https://github.com/webdiscus/webpack-remove-empty-scripts">webpack-remove-empty-scripts</a></h1>
-  <div>The Webpack plugin removes empty JavaScript files generated when using styles.</div>
 </div>
 
----
 [![npm](https://img.shields.io/npm/v/webpack-remove-empty-scripts?logo=npm&color=brightgreen "npm package")](https://www.npmjs.com/package/webpack-remove-empty-scripts "download npm package")
 [![node](https://img.shields.io/node/v/webpack-remove-empty-scripts)](https://nodejs.org)
 [![node](https://img.shields.io/github/package-json/dependency-version/webdiscus/webpack-remove-empty-scripts/peer/webpack)](https://webpack.js.org/)
 [![Test](https://github.com/webdiscus/webpack-remove-empty-scripts/actions/workflows/test.yml/badge.svg)](https://github.com/webdiscus/webpack-remove-empty-scripts/actions/workflows/test.yml)
 [![codecov](https://codecov.io/gh/webdiscus/webpack-remove-empty-scripts/branch/master/graph/badge.svg)](https://codecov.io/gh/webdiscus/webpack-remove-empty-scripts)
 [![node](https://img.shields.io/npm/dm/webpack-remove-empty-scripts)](https://www.npmjs.com/package/webpack-remove-empty-scripts)
 
-## The problem this plugin solves
+A Webpack plugin to remove empty JavaScript files generated when using style only entries.
+
+## Problem this plugin solves
+
+By default, Webpack creates a JavaScript file for every entry specified in the `entry` option - even when the entry is a style file (like SCSS or CSS).
 
-Webpack generates a JS file for each resource defined in the entry option.
+Example:
 
-For example, you have a style file in the `entry` option:
 ```js
 module.exports = {
   entry: {
@@ -28,28 +27,24 @@ module.exports = {
 }
 ```
 
-The following files are generated in the output directory:
+Output:
 
 ```
 dist/styles.css
-dist/styles.js // <= unexpected empty JS file
+dist/styles.js // <= unwanted empty JS file
 ```
 
-This plugin removes generated empty JS files.
-
-> **Warning**
->
-> This plugin is the `Crutch` 🩼 for the [mini-css-extract-plugin issue](https://github.com/webpack-contrib/mini-css-extract-plugin/issues/151).\
-> The `mini-css-extract-plugin` extract CSS, but not eliminate a generated empty JS file.
->
+When using `mini-css-extract-plugin`, CSS is correctly extracted into a separate file, but Webpack still emits an empty JavaScript file for each style-only entry - the [known issue](https://github.com/webpack-contrib/mini-css-extract-plugin/issues/151).
 
+This plugin detects and removes those redundant `.js` files automatically, keeping your output clean.
 
-> **Note**
-> 
-> This plugin is compatible with `Webpack 5`. For `Webpack 4` use [webpack-fix-style-only-entries](https://github.com/fqborges/webpack-fix-style-only-entries).
+> [!NOTE]
+>
+> This plugin is compatible with `Webpack 5`.
+> For `Webpack 4` use [webpack-fix-style-only-entries](https://github.com/fqborges/webpack-fix-style-only-entries).
 
 ## Install
-```console
+```bash
 npm install webpack-remove-empty-scripts --save-dev
 ```
 

README.npm.md

@@ -0,0 +1,44 @@
+<div align="center">
+  <img width="120" height="120" src="https://cdn.worldvectorlogo.com/logos/logo-javascript.svg">
+  <img width="120" height="120" vspace="" hspace="25" src="https://cdn.rawgit.com/webpack/media/e7485eb2/logo/icon-square-big.svg">
+  <h1><a href="https://github.com/webdiscus/webpack-remove-empty-scripts">webpack-remove-empty-scripts</a></h1>
+</div>
+
+A Webpack plugin to remove empty JavaScript files generated when using style only entries.
+
+## Problem this plugin solves
+
+By default, Webpack creates a JavaScript file for every entry specified in the `entry` option - even when the entry is a style file (like SCSS or CSS).
+
+Example:
+
+```js
+module.exports = {
+  entry: {
+    styles: './styles.scss',
+  },
+}
+```
+
+Output:
+
+```
+dist/styles.css
+dist/styles.js // <= unwanted empty JS file
+```
+
+When using `mini-css-extract-plugin`, CSS is correctly extracted into a separate file, but Webpack still emits an empty JavaScript file for each style-only entry - the [known issue](https://github.com/webpack-contrib/mini-css-extract-plugin/issues/151).
+
+This plugin detects and removes those redundant `.js` files automatically, keeping your output clean.
+
+> **Note**
+> 
+> This plugin is compatible with `Webpack 5`. 
+> For `Webpack 4` use [webpack-fix-style-only-entries](https://github.com/fqborges/webpack-fix-style-only-entries).
+
+## Install
+```bash
+npm install webpack-remove-empty-scripts --save-dev
+```
+
+See the full [documentation](https://github.com/webdiscus/webpack-remove-empty-scripts) on GitHub.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "webpack-remove-empty-scripts",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "Webpack plugin removes empty JavaScript files generated when using styles.",
   "keywords": [
     "webpack",
@@ -14,8 +14,7 @@
     "sass",
     "css",
     "js",
-    "javascript",
-    "mini-css-extract-plugin"
+    "javascript"
   ],
   "license": "ISC",
   "author": "webdiscus (https://github.com/webdiscus)",
@@ -41,14 +40,15 @@
   "main": "src/index.js",
   "scripts": {
     "install:yarn": "yarn install --ignore-engines",
+    "postinstall": "npm run build && npm i webpack-remove-empty-scripts -D",
+    "build": "rollup -c",
     "test": "jest --detectOpenHandles --config ./test/jest.config.js",
     "test:coverage": "jest --detectOpenHandles --collectCoverage --config ./test/jest.config.js",
-    "publish:public": "npm publish --access public",
-    "publish:beta": "npm publish --tag beta"
+    "publish:public": "(npm run build) && npm publish ./dist --access public",
+    "publish:beta": "(npm run build) && npm publish ./dist --tag beta"
   },
   "files": [
     "src",
-    "CHANGELOG.md",
     "README.md",
     "LICENSE"
   ],
@@ -59,24 +59,34 @@
     "webpack": ">=5.32.0"
   },
   "dependencies": {
-    "ansis": "1.5.2"
+    "ansis": "4.0.0-node10"
   },
   "devDependencies": {
-    "@babel/core": "^7.23.7",
-    "@babel/preset-env": "^7.23.8",
+    "@babel/core": "^7.27.1",
+    "@babel/preset-env": "^7.27.2",
+    "@rollup/plugin-commonjs": "^28.0.3",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.4",
     "@test-fixtures/lorem": "0.0.2",
-    "@types/jest": "^29.5.11",
-    "@wordpress/scripts": "^27.0.0",
-    "@wordpress/dependency-extraction-webpack-plugin": "^5.0.0",
-    "css-loader": "^6.9.0",
-    "html-bundler-webpack-plugin": "^3.4.10",
-    "html-loader": "^5.0.0",
+    "@types/jest": "^29.5.14",
+    "@wordpress/scripts": "^30.17.0",
+    "@wordpress/dependency-extraction-webpack-plugin": "^6.24.0",
+    "css-loader": "^7.1.2",
+    "html-loader": "^5.1.0",
     "jest": "^29.7.0",
-    "mini-css-extract-plugin": "^2.7.7",
-    "terser-webpack-plugin": "^5.3.10",
-    "webpack": "^5.89.0",
-    "webpack-hot-middleware": "^2.26.0",
-    "webpack-manifest-plugin": "^5.0.0",
-    "webpack-merge": "^5.10.0"
+    "mini-css-extract-plugin": "^2.9.2",
+    "rollup": "^4.41.1",
+    "rollup-plugin-copy": "^3.5.0",
+    "terser-webpack-plugin": "^5.3.14",
+    "webpack": "^5.99.9",
+    "webpack-hot-middleware": "^2.26.1",
+    "webpack-manifest-plugin": "^5.0.1",
+    "webpack-merge": "^6.0.1",
+    "webpack-remove-empty-scripts": "file:dist"
+  },
+  "overrides": {
+    "rollup-plugin-copy": {
+      "globby": "^11.0.0"
+    }
   }
 }

package.npm.json

@@ -0,0 +1,36 @@
+{
+  "name": "webpack-remove-empty-scripts",
+  "version": "1.1.0",
+  "description": "Webpack plugin removes empty JavaScript files generated when using styles.",
+  "keywords": [
+    "webpack",
+    "plugin",
+    "remove",
+    "empty",
+    "script",
+    "entry",
+    "style",
+    "scss",
+    "sass",
+    "css",
+    "js",
+    "javascript"
+  ],
+  "license": "ISC",
+  "author": "webdiscus",
+  "funding": {
+    "type": "patreon",
+    "url": "https://patreon.com/biodiscus"
+  },
+  "repository": "webdiscus/webpack-remove-empty-scripts",
+  "main": "src/index.js",
+  "engines": {
+    "node": ">=12.14"
+  },
+  "peerDependencies": {
+    "webpack": ">=5.32.0"
+  },
+  "dependencies": {
+    "ansis": "4.0.0-node10"
+  }
+}