sass-loader 16.0.8 → 17.0.0

package/dist/esm/index.js

@@ -0,0 +1,71 @@
+import path from "node:path";
+import url from "node:url";
+import schema from "./options.json" with { type: "json" };
+import { errorFactory, getCompileFn, getModernWebpackImporter, getSassImplementation, getSassOptions, normalizeSourceMap } from "./utils.js";
+
+/** @typedef {import("webpack").LoaderContext<LoaderOptions>} LoaderContext */
+/** @typedef {import("schema-utils/declarations/validate").Schema} Schema */
+/** @typedef {import("./utils.js").LoaderOptions} LoaderOptions */
+/** @typedef {import("./utils.js").SassError} SassError */
+
+/**
+ * The sass-loader makes dart-sass and sass-embedded available to webpack modules.
+ * @this {LoaderContext}
+ * @param {string} content content
+ * @returns {Promise<void>} loader result
+ */
+async function loader(content) {
+  const options = this.getOptions(/** @type {Schema} */schema);
+  const callback = this.async();
+  let implementation;
+  try {
+    implementation = await getSassImplementation(options.implementation);
+  } catch (error) {
+    callback(/** @type {Error} */error);
+    return;
+  }
+  const useSourceMap = typeof options.sourceMap === "boolean" ? options.sourceMap : this.sourceMap === true;
+  const sassOptions = await getSassOptions(this, options, content, useSourceMap);
+  const shouldUseWebpackImporter = typeof options.webpackImporter === "boolean" ? options.webpackImporter : true;
+  if (shouldUseWebpackImporter) {
+    sassOptions.importers.push(getModernWebpackImporter(this));
+  }
+  let compile;
+  try {
+    compile = getCompileFn(this, implementation, options.api);
+  } catch (error) {
+    callback(/** @type {Error} */error);
+    return;
+  }
+  let result;
+  try {
+    result = await compile(sassOptions);
+  } catch (error) {
+    const sassError = /** @type {SassError} */error;
+
+    // There are situations when the `span.url` property does not exist
+    if (sassError.span && typeof sassError.span.url !== "undefined") {
+      this.addDependency(url.fileURLToPath(sassError.span.url));
+    }
+    callback(errorFactory(sassError));
+    return;
+  }
+  let map = result.sourceMap || undefined;
+
+  // Modify source paths only for webpack, otherwise we do nothing
+  if (map && useSourceMap) {
+    map = normalizeSourceMap(map, this.rootContext);
+  }
+  if (typeof result.loadedUrls !== "undefined") {
+    for (const includedFile of result.loadedUrls.filter(loadedUrl => loadedUrl.protocol === "file:")) {
+      const normalizedIncludedFile = url.fileURLToPath(includedFile);
+
+      // Custom `importer` can return only `contents` so includedFile will be relative
+      if (path.isAbsolute(normalizedIncludedFile)) {
+        this.addDependency(normalizedIncludedFile);
+      }
+    }
+  }
+  callback(null, result.css.toString(), map || undefined);
+}
+export default loader;

package/dist/esm/options.json

@@ -0,0 +1,64 @@
+{
+  "title": "Sass Loader options",
+  "type": "object",
+  "properties": {
+    "implementation": {
+      "description": "The implementation of the sass to be used.",
+      "link": "https://github.com/webpack/sass-loader#implementation",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object"
+        }
+      ]
+    },
+    "api": {
+      "description": "Switch between `auto`, `modern` and `modern-compiler` API for `sass` (`Dart Sass`) and `Sass Embedded` implementations.",
+      "link": "https://github.com/webpack/sass-loader#sassoptions",
+      "enum": ["auto", "modern", "modern-compiler"]
+    },
+    "sassOptions": {
+      "description": "Options for `sass` (`Dart Sass`) or `sass-embedded` implementation.",
+      "link": "https://github.com/webpack/sass-loader#sassoptions",
+      "anyOf": [
+        {
+          "type": "object",
+          "additionalProperties": true
+        },
+        {
+          "instanceof": "Function"
+        }
+      ]
+    },
+    "additionalData": {
+      "description": "Prepends/Appends `Sass`/`SCSS` code before the actual entry file.",
+      "link": "https://github.com/webpack/sass-loader#additionaldata",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "instanceof": "Function"
+        }
+      ]
+    },
+    "sourceMap": {
+      "description": "Enables/Disables generation of source maps.",
+      "link": "https://github.com/webpack/sass-loader#sourcemap",
+      "type": "boolean"
+    },
+    "webpackImporter": {
+      "description": "Enables/Disables default `webpack` importer.",
+      "link": "https://github.com/webpack/sass-loader#webpackimporter",
+      "type": "boolean"
+    },
+    "warnRuleAsWarning": {
+      "description": "Treats the '@warn' rule as a webpack warning.",
+      "link": "https://github.com/webpack/sass-loader#warnruleaswarning",
+      "type": "boolean"
+    }
+  },
+  "additionalProperties": false
+}