@thedanbob/esbuild-plugin-sass 1.1.0 → 2.0.1

package/README.md

@@ -10,8 +10,8 @@ npm install --save-dev esbuild @thedanbob/esbuild-plugin-sass
 
 ## How to use
 
+`esbuild.config.js`:
 ```js
-// esbuild.config.js
 import { build } from "esbuild"
 import sassPlugin from "@thedanbob/esbuild-plugin-sass"
 
@@ -23,6 +23,13 @@ await build({
 });
 ```
 
+`app.scss`:
+```scss
+/* Prepend with ~ to import from node_modules */
+@import "~bootstrap/scss/bootstrap"
+```
+
+Run:
 ```bash
 node esbuild.config.js
 ```
@@ -47,12 +54,6 @@ Default: `[]`
 
 Array of [deprecations](https://sass-lang.com/documentation/js-api/interfaces/options/#silenceDeprecations) to silence.
 
-### `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`

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,7 +1,22 @@
 import { compile } from "sass";
 import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-export default ({ filter = /.(s[ac]ss|css)$/, quietDeps = false, silenceDeprecations = [], importers = [], transform = undefined } = {}) => ({
+const importer = {
+    findFileUrl: (url) => {
+        if (!url.startsWith("~"))
+            return null;
+        try {
+            // import.meta.resolve searches for an index file by default, which isn't guaranteed to exist.
+            // Instead, we attempt to resolve <package>/package.json
+            const file = url.replace(/^~(.+?)\/.+/, "$1/package.json");
+            return new URL(url.substring(1), import.meta.resolve(file).replace(/(?<=node_modules\/).+/, ""));
+        }
+        catch {
+            return null;
+        }
+    }
+};
+export default ({ filter = /.(s[ac]ss|css)$/, quietDeps = false, silenceDeprecations = [], transform = undefined } = {}) => ({
     name: "sass",
     setup: async ({ initialOptions, onLoad }) => {
         onLoad({ filter }, async ({ path }) => {
@@ -35,24 +50,22 @@ export default ({ filter = /.(s[ac]ss|css)$/, quietDeps = false, silenceDeprecat
                 logger,
                 quietDeps,
                 silenceDeprecations,
-                importers
+                importers: [importer]
             });
-            let cssText = css.toString();
+            let contents = 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;
+                contents += `\n/*# sourceMappingURL=data:application/json;charset=utf-8;base64,${data} */`;
             }
             if (transform) {
-                cssText = await transform(cssText, resolveDir, path);
+                contents = await transform(contents, resolveDir, path);
             }
-            const watchFiles = [path, ...loadedUrls.map(u => fileURLToPath(u))];
             return {
-                contents: cssText,
                 loader: "css",
+                contents,
                 resolveDir,
                 warnings,
-                watchFiles
+                watchFiles: [path, ...loadedUrls.map(u => fileURLToPath(u))]
             };
         });
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@thedanbob/esbuild-plugin-sass",
   "author": "Dan Arnfield <npm@thedanbob.com>",
-  "version": "1.1.0",
+  "version": "2.0.1",
   "type": "module",
   "main": "./dist/index.js",
   "repository": {