@elenajs/plugin-rollup-css 0.3.0 → 0.5.0

package/README.md

@@ -0,0 +1,135 @@
+<div align="center">
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://elenajs.com/img/elena-dark.png" alt="Elena" width="201" height="230">
+  </source>
+  <source media="(prefers-color-scheme: light)" srcset="https://elenajs.com/img/elena.png" alt="Elena" width="201" height="230">
+  </source>
+  <img src="https://elenajs.com/img/elena.png" alt="Elena" width="201" height="230">
+</picture>
+
+### Rollup plugin that minifies and bundles individual Elena CSS files.
+
+<br/>
+
+<a href="https://arielsalminen.com"><img src="https://img.shields.io/badge/creator-@arielle-F95B1F" alt="Creator @arielle"/></a>
+<a href="https://www.npmjs.com/package/@elenajs/plugin-rollup-css"><img src="https://img.shields.io/npm/v/@elenajs/plugin-rollup-css.svg" alt="Latest version on npm" /></a>
+<a href="https://github.com/getelena/elena/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-yellow.svg" alt="Elena is released under the MIT license." /></a>
+<a href="https://github.com/getelena/elena/actions/workflows/tests.yml"><img src="https://github.com/getelena/elena/actions/workflows/tests.yml/badge.svg" alt="Tests status" /></a>
+
+</div>
+
+<br/>
+
+<p align="center"><strong>@elenajs/plugin-rollup-css</strong> is a <a href="https://rollupjs.org">Rollup</a> plugin that minifies individual Elena CSS files and optionally concatenates them into a single bundle. Built for <a href="https://elenajs.com">Elena</a> Progressive Web Component libraries, but works with any Rollup project.</p>
+
+<br/>
+
+## Table of contents
+
+- **[Install](#install)**
+- **[Usage](#usage)**
+  - **[Individual CSS files](#individual-css-files)**
+  - **[CSS bundle](#css-bundle)**
+  - **[Both together](#both-together)**
+- **[API](#api)**
+  - **[`cssPlugin(srcDir)`](#csspluginsrcdir)**
+  - **[`cssBundlePlugin(srcDir, fileName)`](#cssbundlepluginsrcdir-filename)**
+  - **[`minifyCss(css, filename?)`](#minifycsscss-filename)**
+
+## Install
+
+```bash
+npm install --save-dev @elenajs/plugin-rollup-css
+```
+
+**Peer dependency:** `rollup >= 4.0.0`
+
+## Usage
+
+### Individual CSS files
+
+Emit minified copies of each CSS file from your source directory:
+
+```js
+// rollup.config.js
+import { cssPlugin } from "@elenajs/plugin-rollup-css";
+
+export default {
+  input: "src/index.js",
+  output: { dir: "dist", format: "esm" },
+  plugins: [cssPlugin("src")],
+};
+```
+
+This scans `src/` for `.css` files and emits each one (minified) into the output directory, preserving the original file name.
+
+### CSS bundle
+
+Concatenate all CSS files into a single minified bundle:
+
+```js
+// rollup.config.js
+import { cssBundlePlugin } from "@elenajs/plugin-rollup-css";
+
+export default {
+  input: "src/index.js",
+  output: { dir: "dist", format: "esm" },
+  plugins: [cssBundlePlugin("src", "bundle.css")],
+};
+```
+
+### Both together
+
+Use both plugins to emit individual files and a concatenated bundle:
+
+```js
+// rollup.config.js
+import { cssPlugin, cssBundlePlugin } from "@elenajs/plugin-rollup-css";
+
+export default {
+  input: "src/index.js",
+  output: { dir: "dist", format: "esm" },
+  plugins: [
+    cssPlugin("src"),
+    cssBundlePlugin("src", "bundle.css"),
+  ],
+};
+```
+
+## API
+
+### `cssPlugin(srcDir)`
+
+Returns a Rollup plugin that finds all `.css` files in `srcDir` and emits each one as a minified asset.
+
+| Parameter | Type     | Description                                |
+| --------- | -------- | ------------------------------------------ |
+| `srcDir`  | `string` | Source directory to scan for `.css` files. |
+
+### `cssBundlePlugin(srcDir, fileName)`
+
+Returns a Rollup plugin that concatenates all `.css` files in `srcDir`, minifies the result, and emits it as a single asset.
+
+| Parameter  | Type     | Description                                           |
+| ---------- | -------- | ----------------------------------------------------- |
+| `srcDir`   | `string` | Source directory to scan for `.css` files.            |
+| `fileName` | `string` | Output filename for the bundle (e.g. `"bundle.css"`). |
+
+### `minifyCss(css, filename?)`
+
+Minifies a CSS string using [Lightning CSS](https://lightningcss.dev/).
+
+| Parameter   | Type     | Description                            |
+| ----------- | -------- | -------------------------------------- |
+| `css`       | `string` | The CSS source to minify.              |
+| `filename?` | `string` | Optional filename for error reporting. |
+
+**Returns:** `string`, the minified CSS.
+
+## License
+
+MIT
+
+## Copyright
+
+Copyright © 2026 [Ariel Salminen](https://arielsalminen.com)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elenajs/plugin-rollup-css",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Rollup plugin that minifies individual CSS files and optionally concatenates them into a single bundle.",
   "author": "Elena <hi@elenajs.com>",
   "homepage": "https://elenajs.com/",
@@ -15,6 +15,9 @@
   "files": [
     "src"
   ],
+  "scripts": {
+    "test": "vitest run"
+  },
   "engines": {
     "node": ">= 20"
   },
@@ -24,5 +27,8 @@
   "dependencies": {
     "lightningcss": "^1.31.1"
   },
-  "gitHead": "e2caa93517537a057b0e362d8bc2e4315b0fb883"
+  "devDependencies": {
+    "vitest": "4.0.18"
+  },
+  "gitHead": "c181af0625f691a95a5cb1ef9adb0d7f2c796eae"
 }

package/src/index.js

@@ -1,3 +1,17 @@
+/**
+ *  ██████████ ████
+ * ░░███░░░░░█░░███
+ *  ░███  █ ░  ███   ██████  ████████    ██████
+ *  ░██████    ███  ███░░███░░███░░███  ░░░░░███
+ *  ░███░░█    ███ ░███████  ░███ ░███   ███████
+ *  ░███ ░   █ ███ ░███░░░   ░███ ░███  ███░░███
+ *  ██████████ █████░░██████  ████ █████░░████████
+ * ░░░░░░░░░░ ░░░░░  ░░░░░░  ░░░░ ░░░░░  ░░░░░░░░
+ *
+ * Elena Rollup CSS Plugin
+ * https://elenajs.com
+ */
+
 import { basename } from "path";
 import { readFileSync, readdirSync } from "fs";
 import { transform } from "lightningcss";