@deanc/esbuild-plugin-postcss 1.0.2 → 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## Unreleased
+
+## 2.0.0 - 2026-02-08
+### Added
+- Initial entry.

package/README.md

@@ -2,7 +2,7 @@
 
 # esbuild-plugin-postcss
 
-![Node.js CI](https://github.com/deanc/esbuild-plugin-postcss/workflows/Node.js%20CI/badge.svg)
+![CI](https://github.com/deanc/esbuild-plugin-postcss/actions/workflows/ci.yml/badge.svg)
 
 Plugin for [esbuild](https://esbuild.github.io/) to support PostCSS
 
@@ -15,6 +15,10 @@ or yarn
 ```bash
 yarn add esbuild @deanc/esbuild-plugin-postcss
 ```
+or pnpm
+```bash
+pnpm add esbuild @deanc/esbuild-plugin-postcss
+```
 
 ## Usage example
 
@@ -35,9 +39,9 @@ import "./test.css";
 Create file `build.js`:
 
 ```js
-const esbuild = require("esbuild");
-const autoprefixer = require("autoprefixer");
-const postCssPlugin = require("@deanc/esbuild-plugin-postcss");
+import esbuild from "esbuild";
+import autoprefixer from "autoprefixer";
+import postCssPlugin from "@deanc/esbuild-plugin-postcss";
 
 esbuild
   .build({
@@ -46,7 +50,7 @@ esbuild
     outfile: "bundle.js",
     plugins: [
       postCssPlugin({
-        plugins: [autoprefixer],
+        plugins: [autoprefixer()],
       }),
     ],
   })
@@ -60,3 +64,19 @@ node build.js
 ```
 
 File named `bundle.css` with appropriate postcss plugins applied.
+
+## Requirements
+
+- Node.js 22+
+
+## Contributing
+
+- This repo uses pnpm for CI. If you use pnpm locally, run `pnpm import` once to create `pnpm-lock.yaml`.
+
+## Releases
+
+- The release workflow uses npm trusted publishing with provenance. Ensure trusted publishing is enabled for this package in npm before running the workflow.
+- Release checklist:
+  1. Ensure CI is green on `main`.
+  2. Verify `CHANGELOG.md` has entries under `[Unreleased]`.
+  3. Run the "Release package" workflow with the desired release type.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { type AcceptedPlugin } from "postcss";
+import type { Plugin } from "esbuild";
+export interface PostCssPluginOptions {
+    plugins?: AcceptedPlugin[];
+}
+export default function postCssPlugin(options?: PostCssPluginOptions): Plugin;

package/dist/index.js

@@ -0,0 +1,47 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import postcss from "postcss";
+export default function postCssPlugin(options = {}) {
+    const plugins = options.plugins ?? [];
+    return {
+        name: "postcss",
+        setup(build) {
+            build.onResolve({ filter: /\.css$/, namespace: "file" }, async (args) => {
+                // Use esbuild path resolution for node_modules, tsconfig paths, etc.
+                // https://esbuild.github.io/plugins/#resolve
+                const resolution = await build.resolve(args.path, {
+                    resolveDir: args.resolveDir,
+                    kind: args.kind,
+                });
+                if (resolution.errors.length > 0) {
+                    return { errors: resolution.errors };
+                }
+                return {
+                    path: resolution.path,
+                    namespace: "postcss",
+                };
+            });
+            build.onLoad({ filter: /\.css$/, namespace: "postcss" }, async (args) => {
+                const sourceFullPath = args.path;
+                const css = await fs.readFile(sourceFullPath, "utf8");
+                if (plugins.length === 0) {
+                    return {
+                        contents: css,
+                        loader: "css",
+                        resolveDir: path.dirname(sourceFullPath),
+                        watchFiles: [sourceFullPath],
+                    };
+                }
+                const result = await postcss(plugins).process(css, {
+                    from: sourceFullPath,
+                });
+                return {
+                    contents: result.css,
+                    loader: "css",
+                    resolveDir: path.dirname(sourceFullPath),
+                    watchFiles: [sourceFullPath],
+                };
+            });
+        },
+    };
+}

package/package.json

@@ -1,10 +1,25 @@
 {
   "name": "@deanc/esbuild-plugin-postcss",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "description": "Plugin for esbuild to support postcss",
-  "main": "index.js",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "packageManager": "pnpm@10.0.0",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "scripts": {
-    "test": "tape 'tests/*.js' | tap-spec"
+    "build": "pnpm exec tsc -p tsconfig.json",
+    "test": "pnpm build && node --test tests/*.js"
   },
   "author": {
     "name": "Dean Clatworthy",
@@ -21,31 +36,18 @@
     "postcss"
   ],
   "dependencies": {
-    "autoprefixer": "^10.2.4",
-    "css-tree": "^1.1.2",
-    "fs-extra": "^9.0.1",
-    "postcss": "^8.2.4",
-    "tmp": "^0.2.1"
+    "autoprefixer": "^10.4.22",
+    "postcss": "^8.5.6"
   },
   "peerDependencies": {
-    "esbuild": "^0.8.32"
+    "esbuild": "^0.27.0"
   },
   "devDependencies": {
-    "esbuild": "^0.8.32",
-    "husky": "^4.3.7",
-    "lint-staged": "^10.5.3",
-    "prettier": "^2.2.1",
-    "tap-spec": "^5.0.0",
-    "tape": "^5.1.1"
-  },
-  "husky": {
-    "hooks": {
-      "pre-commit": "npx lint-staged"
-    }
+    "@types/node": "^22.13.0",
+    "esbuild": "^0.27.0",
+    "typescript": "^5.7.3"
   },
-  "lint-staged": {
-    "*.js": [
-      "npx prettier --write"
-    ]
+  "engines": {
+    "node": ">=22"
   }
 }

package/.github/workflows/node.js.yml

@@ -1,30 +0,0 @@
-# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
-# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
-
-name: Node.js CI
-
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  build:
-
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [10.x, 12.x, 14.x, 15.x]
-        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
-
-    steps:
-    - uses: actions/checkout@v2
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v1
-      with:
-        node-version: ${{ matrix.node-version }}
-    - run: npm ci
-    - run: npm run build --if-present
-    - run: npm test

package/.github/workflows/npm-publish.yml

@@ -1,33 +0,0 @@
-# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
-# For more information see: https://help.github.com/actions/language-and-framework-guides/publishing-nodejs-packages
-
-name: Node.js Package
-
-on:
-  release:
-    types: [created]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v1
-        with:
-          node-version: 12
-      - run: npm ci
-      - run: npm test
-
-  publish-npm:
-    needs: build
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v1
-        with:
-          node-version: 12
-          registry-url: https://registry.npmjs.org/
-      - run: npm ci
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.npm_token}}

package/.nvmrc

@@ -1 +0,0 @@
-v10.16.0

package/.prettierrc.json

@@ -1 +0,0 @@
-{}

package/index.js

@@ -1,45 +0,0 @@
-const fs = require("fs-extra");
-const postcss = require("postcss");
-const util = require("util");
-const tmp = require("tmp");
-const path = require("path");
-
-const readFile = util.promisify(fs.readFile);
-const writeFile = util.promisify(fs.writeFile);
-const ensureDir = util.promisify(fs.ensureDir);
-
-module.exports = (options = { plugins: [] }) => ({
-  name: "postcss",
-  setup: function (build) {
-    const { rootDir = options.rootDir || process.cwd() } = options;
-    const tmpDirPath = tmp.dirSync().name;
-    build.onResolve(
-      { filter: /.\.(css)$/, namespace: "file" },
-      async (args) => {
-        const sourceFullPath = path.resolve(args.resolveDir, args.path);
-        const sourceExt = path.extname(sourceFullPath);
-        const sourceBaseName = path.basename(sourceFullPath, sourceExt);
-        const sourceDir = path.dirname(sourceFullPath);
-        const sourceRelDir = path.relative(path.dirname(rootDir), sourceDir);
-
-        const tmpDir = path.resolve(tmpDirPath, sourceRelDir);
-        const tmpFilePath = path.resolve(tmpDir, `${sourceBaseName}.css`);
-        await ensureDir(tmpDir);
-
-        const css = await readFile(sourceFullPath);
-
-        const result = await postcss(options.plugins).process(css, {
-          from: sourceFullPath,
-          to: tmpFilePath,
-        });
-
-        // Write result file
-        await writeFile(tmpFilePath, result.css);
-
-        return {
-          path: tmpFilePath,
-        };
-      }
-    );
-  },
-});

package/tests/basic/example.css

@@ -1,3 +0,0 @@
-body {
-  border-radius: 1px;
-}

package/tests/basic/index.js

@@ -1 +0,0 @@
-import "./example.css";

package/tests/basic.js

@@ -1,44 +0,0 @@
-const test = require("tape");
-const path = require("path");
-const autoprefixer = require("autoprefixer");
-const fs = require("fs-extra");
-
-const autoPrefixerPlugin = autoprefixer({
-  browsers: ["last 2 versions", "chrome >= 4"],
-});
-
-process.chdir(path.resolve(__dirname));
-
-const postCssPlugin = require("../index.js");
-
-test("simplest case", function (t) {
-  (async () => {
-    fs.removeSync(".output");
-
-    await require("esbuild").build({
-      entryPoints: ["basic/index.js"],
-      bundle: true,
-      outfile: ".output/bundle.js",
-      plugins: [
-        postCssPlugin({
-          plugins: [autoPrefixerPlugin],
-        }),
-      ],
-    });
-
-    t.ok(fs.existsSync("./.output/bundle.js"), "Bundled js file should exist");
-    t.ok(
-      fs.existsSync("./.output/bundle.css"),
-      "Bundled css file should exist"
-    );
-
-    const fileContent = fs.readFileSync("./.output/bundle.css").toString();
-
-    t.ok(
-      fileContent.indexOf(`-webkit-border-radius`) !== -1,
-      "Should contain prefixed selector"
-    );
-
-    t.end();
-  })().catch((e) => t.fail(e.message));
-});