From e0c46a320a8b6775f7910f44ef6100578036b82d Mon Sep 17 00:00:00 2001
From: alexander-akait <sheo13666q@gmail.com>
Date: Thu, 27 Aug 2026 14:55:30 +0000
Subject: [PATCH 1/2] docs: deprecate style-loader in favor of webpack's
 built-in CSS support

The exportType: "style" parser option injects a <style> element from the
webpack runtime. Point the README at the Native CSS guide and its
migration guide on webpack.js.org.
---
 .cspell.json | 3 ++-
 README.md    | 9 +++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.cspell.json b/.cspell.json
index 05cf3747..b99c1f4c 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -11,7 +11,8 @@
     "camelcase",
     "EAAE",
     "Unse",
-    "memfs"
+    "memfs",
+    "codemod"
   ],
 
   "ignorePaths": [
diff --git a/README.md b/README.md
index 8491f890..fe37bbf8 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,15 @@
 
 # style-loader
 
+> [!WARNING]
+>
+> **`style-loader` is deprecated** — webpack injects CSS into the DOM itself and no longer needs it.
+>
+> [`experiments.css`](https://webpack.js.org/configuration/experiments/#experimentscss) defaults to `"auto"` since webpack 5.109.0. The [`exportType: "style"`](https://webpack.js.org/guides/native-css/#output-modes-exporttype) parser option injects a `<style>` element from the webpack runtime, covering the default `injectType: "styleTag"`; the extraction `injectType: "linkTag"` is the built-in default.
+> Read the [Native CSS guide](https://webpack.js.org/guides/native-css/) and follow its [migration guide](https://webpack.js.org/guides/native-css/#5-replace-style-loader), or run `npx codemod @webpack/css-plugins-to-native-css` to do most of the migration automatically.
+>
+> `attributes`, `insert` and `styleTagTransform` have no native equivalent — keep `style-loader` if you rely on them.
+
 Inject CSS into the DOM.
 
 ## Getting Started

From ee71d797ea55ef211486dd7677b1df16d02d6855 Mon Sep 17 00:00:00 2001
From: alexander-akait <sheo13666q@gmail.com>
Date: Thu, 27 Aug 2026 15:50:37 +0000
Subject: [PATCH 2/2] docs: trim the deprecation notice to the migration guide
 link

Drop the codemod suggestion and the per-option mapping from the README
notice; the migration guide is the place that tracks both.
---
 .cspell.json | 3 +--
 README.md    | 5 ++---
 2 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/.cspell.json b/.cspell.json
index b99c1f4c..05cf3747 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -11,8 +11,7 @@
     "camelcase",
     "EAAE",
     "Unse",
-    "memfs",
-    "codemod"
+    "memfs"
   ],
 
   "ignorePaths": [
diff --git a/README.md b/README.md
index fe37bbf8..bf5397b4 100644
--- a/README.md
+++ b/README.md
@@ -19,10 +19,9 @@
 >
 > **`style-loader` is deprecated** — webpack injects CSS into the DOM itself and no longer needs it.
 >
-> [`experiments.css`](https://webpack.js.org/configuration/experiments/#experimentscss) defaults to `"auto"` since webpack 5.109.0. The [`exportType: "style"`](https://webpack.js.org/guides/native-css/#output-modes-exporttype) parser option injects a `<style>` element from the webpack runtime, covering the default `injectType: "styleTag"`; the extraction `injectType: "linkTag"` is the built-in default.
-> Read the [Native CSS guide](https://webpack.js.org/guides/native-css/) and follow its [migration guide](https://webpack.js.org/guides/native-css/#5-replace-style-loader), or run `npx codemod @webpack/css-plugins-to-native-css` to do most of the migration automatically.
+> Read the [Native CSS guide](https://webpack.js.org/guides/native-css/) and follow its [migration guide](https://webpack.js.org/guides/native-css/#5-replace-style-loader), which lists what the built-in support covers.
 >
-> `attributes`, `insert` and `styleTagTransform` have no native equivalent — keep `style-loader` if you rely on them.
+> 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.
 
 Inject CSS into the DOM.