css-loader 7.1.4 → 7.1.5

package/README.md

@@ -16,6 +16,14 @@
 
 # css-loader
 
+> [!WARNING]
+>
+> **`css-loader` is deprecated** — webpack parses CSS itself and no longer needs it.
+>
+> Read the [Native CSS guide](https://webpack.js.org/guides/native-css/) and follow its [migration guide](https://webpack.js.org/guides/native-css/#migration-guide).
+>
+> Existing setups keep working: built-in CSS support stays off for any `.css` rule that already has a loader, so you can migrate one rule at a time.
+
 The `css-loader` interprets `@import` and `url()` like `import/require()` and resolves them.
 
 ## Getting Started
@@ -42,6 +50,12 @@ or
 pnpm add -D css-loader
 ```
 
+In the example configuration below, `style-loader` is used to inject the processed CSS into the DOM during runtime. You may need to install it as well:
+
+```console
+npm install --save-dev style-loader
+```
+
 Then, add the loader to your `webpack` configuration. For example:
 
 **file.js**

package/dist/index.js

@@ -108,7 +108,7 @@ async function loader(content, map, meta) {
   } = this;
   let result;
   try {
-    result = await (0, _postcss.default)(plugins).process(content, {
+    result = await (0, _postcss.default)(plugins).process((0, _utils.stripBom)(content), {
       hideNothingWarning: true,
       from: resourcePath,
       to: resourcePath,

package/dist/utils.js

@@ -27,6 +27,7 @@ exports.shouldUseModulesPlugins = shouldUseModulesPlugins;
 exports.shouldUseURLPlugin = shouldUseURLPlugin;
 exports.sort = sort;
 exports.stringifyRequest = stringifyRequest;
+exports.stripBom = stripBom;
 exports.supportTemplateLiteral = supportTemplateLiteral;
 exports.syntaxErrorFactory = syntaxErrorFactory;
 exports.warningFactory = warningFactory;
@@ -1065,4 +1066,20 @@ function supportTemplateLiteral(loaderContext) {
     return true;
   }
   return false;
+}
+const BOM_CODE_POINT = 0xfeff;
+
+// postcss stripped a leading BOM until 8.5.24 and preserves it since, so strip
+// it ourselves: concatenated stylesheets must not carry one in the middle.
+// `content` is a postcss `Root` when a previous loader handed over its AST,
+// and there the BOM lives on the input rather than in the tree.
+function stripBom(content) {
+  if (typeof content === "string") {
+    return content.charCodeAt(0) === BOM_CODE_POINT ? content.slice(1) : content;
+  }
+  if (content && content.source && content.source.input) {
+    // eslint-disable-next-line no-param-reassign
+    content.source.input.hasBOM = false;
+  }
+  return content;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "css-loader",
-  "version": "7.1.4",
+  "version": "7.1.5",
   "description": "css loader module for webpack",
   "license": "MIT",
   "repository": "webpack/css-loader",