@thedanbob/esbuild-plugin-sass 1.0.0

package/LICENSE

@@ -0,0 +1,23 @@
+@thedanbob/esbuild-plugin-sass
+
+MIT License
+
+Copyright (c) 2026 Dan Arnfield
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @thedanbob/esbuild-plugin-sass
+
+Sass plugin for [esbuild](https://esbuild.github.io/). This is basically a heavily stripped down version of [esbuild-sass-plugin](https://github.com/glromeo/esbuild-sass-plugin), you should probably just use that one.
+
+## Installation
+
+```bash
+npm install --save-dev esbuild @thedanbob/esbuild-plugin-sass
+```
+
+## How to use
+
+```js
+// esbuild.config.js
+import { build } from "esbuild"
+import sassPlugin from "@thedanbob/esbuild-plugin-sass"
+
+await build({
+  // ...
+  plugins: [
+    sassPlugin({ /* config */ })
+  ]
+});
+```
+
+```bash
+node esbuild.config.js
+```
+
+## Config
+
+### `filter`
+
+Type: `RegExp`<br>
+Default: `/.(s[ac]ss|css)$/`
+
+Esbuild load filter (go syntax).
+
+### `importers`
+Type: `(NodePackageImporter | Importer<sync> | FileImporter<sync>)[]`<br>
+Default: `[]`
+
+Array of [importers](https://sass-lang.com/documentation/js-api/interfaces/options/#importers) passed to the Sass compiler.
+
+### `transform`
+Type: `(css: string, resolveDir: string, filePath: string) => string | Promise<string>`<br>
+Default: `undefined`
+
+Function that post-processes the CSS compiled by Sass before returning it to esbuild.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { Plugin } from "esbuild";
+import { Options } from "sass";
+export interface PluginOptions {
+    filter?: RegExp;
+    importers?: Options<"sync">["importers"];
+    transform?: (css: string, resolveDir: string, filePath: string) => string | Promise<string>;
+}
+declare const _default: ({ filter, importers, transform }?: PluginOptions) => Plugin;
+export default _default;

package/dist/index.js

@@ -0,0 +1,57 @@
+import { compile } from "sass";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+export default ({ filter = /.(s[ac]ss|css)$/, importers = [], transform = undefined } = {}) => ({
+    name: "sass",
+    setup: async ({ initialOptions, onLoad }) => {
+        onLoad({ filter }, async ({ path }) => {
+            const resolveDir = dirname(path);
+            const warnings = [];
+            const logger = {
+                warn: function (message, opts) {
+                    if (!opts.span) {
+                        warnings.push({ text: `sass warning: ${message}` });
+                    }
+                    else {
+                        warnings.push({
+                            text: message,
+                            location: {
+                                file: opts.span.url?.pathname ?? path,
+                                line: opts.span.start.line,
+                                column: opts.span.start.column,
+                                lineText: opts.span.text
+                            },
+                            detail: {
+                                deprecation: opts.deprecation,
+                                stack: opts.stack
+                            }
+                        });
+                    }
+                }
+            };
+            const { css, loadedUrls, sourceMap } = compile(path, {
+                sourceMap: !!initialOptions.sourcemap,
+                sourceMapIncludeSources: true,
+                logger,
+                importers
+            });
+            let cssText = css.toString();
+            if (sourceMap) {
+                const data = Buffer.from(JSON.stringify(sourceMap), "utf-8").toString("base64");
+                const sm = `/*# sourceMappingURL=data:application/json;charset=utf-8;base64,${data} */`;
+                cssText += "\n" + sm;
+            }
+            if (transform) {
+                cssText = await transform(cssText, resolveDir, path);
+            }
+            const watchFiles = [path, ...loadedUrls.map(u => fileURLToPath(u))];
+            return {
+                contents: cssText,
+                loader: "css",
+                resolveDir,
+                warnings,
+                watchFiles
+            };
+        });
+    }
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@thedanbob/esbuild-plugin-sass",
+  "author": "Dan Arnfield <npm@thedanbob.com>",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "types": "./dist/types/index.d.ts",
+  "scripts": {
+    "clean": "rm -rf ./dist",
+    "build": "tsc --project tsconfig.json",
+    "lint": "eslint src/** --max-warnings=0 && tsc --noEmit"
+  },
+  "peerDependencies": {
+    "esbuild": "^0.27.3"
+  },
+  "dependencies": {
+    "sass": "^1.97.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^25.2.2",
+    "esbuild": "^0.27.3",
+    "eslint": "^9",
+    "sass": "^1.97.3",
+    "typescript-eslint": "^8.20.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "esbuild",
+    "plugin",
+    "sass"
+  ],
+  "license": "MIT"
+}