@thedanbob/esbuild-plugin-sass 1.0.1 → 2.0.0

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
 ```
@@ -30,17 +37,22 @@ 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>
+### `quietDeps`
+Type: `boolean`<br>
+Default: `false`
+
+Silence warnings in dependencies.
+
+### `silenceDeprecations`
+Type: `DeprecationOrId[]`<br>
 Default: `[]`
 
-Array of [importers](https://sass-lang.com/documentation/js-api/interfaces/options/#importers) passed to the Sass compiler.
+Array of [deprecations](https://sass-lang.com/documentation/js-api/interfaces/options/#silenceDeprecations) to silence.
 
 ### `transform`
 Type: `(css: string, resolveDir: string, filePath: string) => string | Promise<string>`<br>

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 import { Plugin } from "esbuild";
-import { Options } 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, importers, transform }?: PluginOptions) => Plugin;
+declare const _default: ({ filter, quietDeps, silenceDeprecations, transform }?: PluginOptions) => Plugin;
 export default _default;

package/dist/index.js

@@ -1,7 +1,15 @@
 import { compile } from "sass";
 import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-export default ({ filter = /.(s[ac]ss|css)$/, importers = [], transform = undefined } = {}) => ({
+const importer = {
+    findFileUrl: (url) => {
+        if (!url.startsWith("~"))
+            return null;
+        const pkg = url.replace(/^~(.+?)\/.+/, "$1");
+        return new URL(url.substring(1), import.meta.resolve(pkg).replace(/(?<=node_modules\/).+/, ""));
+    }
+};
+export default ({ filter = /.(s[ac]ss|css)$/, quietDeps = false, silenceDeprecations = [], transform = undefined } = {}) => ({
     name: "sass",
     setup: async ({ initialOptions, onLoad }) => {
         onLoad({ filter }, async ({ path }) => {
@@ -33,24 +41,24 @@ export default ({ filter = /.(s[ac]ss|css)$/, importers = [], transform = undefi
                 sourceMap: !!initialOptions.sourcemap,
                 sourceMapIncludeSources: true,
                 logger,
-                importers
+                quietDeps,
+                silenceDeprecations,
+                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.0.1",
+  "version": "2.0.0",
   "type": "module",
   "main": "./dist/index.js",
   "repository": {