From 32f6fd671aed442f63748adf523ed2a385095334 Mon Sep 17 00:00:00 2001
From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com>
Date: Sat, 21 Mar 2026 00:34:05 +0000
Subject: [PATCH] docs: add descriptions to plugin READMEs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add descriptive introductions to 12 plugin READMEs that were missing
explanations of what the plugins do:
- jest: SWC implementation of babel-jest for fast test transforms
- noop: no-op plugin for debugging/template purposes
- loadable-components: transforms @loadable/component dynamic imports
- relay: compiles Relay GraphQL tagged template literals
- react-remove-properties: removes data-testid and similar props
- remove-console: strips console.* calls from production builds
- styled-components: adds display names and SSR support
- styled-jsx: transforms <style jsx> scoped CSS in JSX
- swc-confidential: encrypts string literals at build time
- swc-magic: processes markAsPure and other magic annotations
- swc-sdk: provides markAsPure and dynamic import transformations
- transform-imports: transforms named imports to file-level imports

Fixes #200

Co-authored-by: Donny/강동윤 <kdy1@users.noreply.github.com>
---
 packages/jest/README.md                    | 20 ++++++++++++++++++++
 packages/loadable-components/README.md     |  2 ++
 packages/noop/README.md                    | 14 ++++++++++++++
 packages/react-remove-properties/README.md |  4 +++-
 packages/relay/README.md                   |  4 ++++
 packages/remove-console/README.md          |  4 +++-
 packages/styled-components/README.md       |  4 ++++
 packages/styled-jsx/README.md              | 18 ++++++++++++++++++
 packages/swc-confidential/README.md        |  2 ++
 packages/swc-magic/README.md               |  2 ++
 packages/swc-sdk/README.md                 |  4 +++-
 packages/transform-imports/README.md       |  6 +++++-
 12 files changed, 80 insertions(+), 4 deletions(-)

diff --git a/packages/jest/README.md b/packages/jest/README.md
index 2703e694b..7e07ed7d7 100644
--- a/packages/jest/README.md
+++ b/packages/jest/README.md
@@ -1,5 +1,25 @@
 # @swc/plugin-jest
 
+The SWC implementation of `babel-jest`. This plugin transforms test files using SWC, enabling fast Jest-based testing without Babel. It replaces `babel-jest` as the transformer in Jest configurations and supports TypeScript, JSX, and modern JavaScript features.
+
+## Usage
+
+Install the plugin and configure Jest to use SWC as the transformer:
+
+```sh
+npm install --save-dev @swc/plugin-jest @swc/jest @swc/core
+```
+
+Then update your Jest configuration (e.g. `jest.config.js`):
+
+```js
+module.exports = {
+  transform: {
+    "^.+\\.(t|j)sx?$": "@swc/jest",
+  },
+};
+```
+
 # @swc/plugin-jest
 
 ## 12.7.0
diff --git a/packages/loadable-components/README.md b/packages/loadable-components/README.md
index 7bcd77dd9..6aae487f9 100644
--- a/packages/loadable-components/README.md
+++ b/packages/loadable-components/README.md
@@ -1,5 +1,7 @@
 # loadable-components
 
+SWC plugin for [`@loadable/component`](https://loadable-components.com/). It transforms dynamic imports inside loadable functions to add chunk names and enable server-side rendering (SSR) support for code-splitting. This is the SWC equivalent of [`babel-plugin-loadable-components`](https://github.com/gregberge/loadable-components/tree/main/packages/babel-plugin).
+
 ## Config
 
 ```json
diff --git a/packages/noop/README.md b/packages/noop/README.md
index 28788e753..e10a102b0 100644
--- a/packages/noop/README.md
+++ b/packages/noop/README.md
@@ -1,5 +1,19 @@
 # @swc/plugin-noop
 
+A no-operation (noop) SWC plugin that passes the AST through unchanged. Useful for debugging the SWC plugin infrastructure, measuring plugin overhead, or as a minimal starting template for new plugins.
+
+## Usage
+
+```json
+{
+  "jsc": {
+    "experimental": {
+      "plugins": [["@swc/plugin-noop", {}]]
+    }
+  }
+}
+```
+
 # @swc/plugin-noop
 
 ## 12.7.0
diff --git a/packages/react-remove-properties/README.md b/packages/react-remove-properties/README.md
index 4193c9c2b..c0b34c466 100644
--- a/packages/react-remove-properties/README.md
+++ b/packages/react-remove-properties/README.md
@@ -1,4 +1,6 @@
-# react-remove-properties
+# @swc/plugin-react-remove-properties
+
+Removes custom React properties (such as `data-testid`) from JSX elements at build time. This reduces bundle size and prevents test-only attributes from being shipped to production. By default it removes all `data-testid` attributes, but you can configure it to target any property using a regex pattern.
 
 See https://nextjs.org/docs/architecture/nextjs-compiler#remove-react-properties for more information.
 
diff --git a/packages/relay/README.md b/packages/relay/README.md
index 049ab1608..ca3a2ce7e 100644
--- a/packages/relay/README.md
+++ b/packages/relay/README.md
@@ -1,3 +1,7 @@
+# @swc/plugin-relay
+
+SWC plugin for [Relay](https://relay.dev/), Facebook's GraphQL client framework for React. It compiles `graphql` tagged template literals into Relay-compatible artifacts, replacing them with `require()` calls to the compiled query files. This is the SWC equivalent of [`babel-plugin-relay`](https://www.npmjs.com/package/babel-plugin-relay).
+
 ### `@swc/plugin-relay`
 
 #### Setup
diff --git a/packages/remove-console/README.md b/packages/remove-console/README.md
index cb22ebcbb..123714ee7 100644
--- a/packages/remove-console/README.md
+++ b/packages/remove-console/README.md
@@ -1,4 +1,6 @@
-# remove-console
+# @swc/plugin-remove-console
+
+Removes `console.*` calls (e.g. `console.log`, `console.warn`, `console.error`) from JavaScript/TypeScript code at build time. This reduces bundle size and prevents debug output from being included in production builds. Specific console methods can be excluded from removal (e.g. keeping `console.error`).
 
 See https://nextjs.org/docs/architecture/nextjs-compiler#remove-console for more information.
 
diff --git a/packages/styled-components/README.md b/packages/styled-components/README.md
index 8c502bce0..0ae6d64aa 100644
--- a/packages/styled-components/README.md
+++ b/packages/styled-components/README.md
@@ -1,3 +1,7 @@
+# @swc/plugin-styled-components
+
+SWC plugin for [styled-components](https://styled-components.com/), a popular CSS-in-JS library. It adds display names for better debugging, server-side rendering (SSR) support via deterministic class names, and smaller bundles by removing unnecessary code in production. This is the SWC equivalent of [`babel-plugin-styled-components`](https://github.com/styled-components/babel-plugin-styled-components).
+
 ### `@swc/plugin-styled-components`
 
 #### Setup
diff --git a/packages/styled-jsx/README.md b/packages/styled-jsx/README.md
index ab9fd15d5..7a42cc2dc 100644
--- a/packages/styled-jsx/README.md
+++ b/packages/styled-jsx/README.md
@@ -1,5 +1,23 @@
 # @swc/plugin-styled-jsx
 
+SWC plugin for [styled-jsx](https://github.com/vercel/styled-jsx), Vercel's CSS-in-JS solution. It transforms `<style jsx>` elements within JSX components into scoped CSS, allowing you to write component-level styles in plain CSS syntax that are automatically scoped to the component.
+
+## Usage
+
+```sh
+npm install --save-dev @swc/plugin-styled-jsx @swc/core
+```
+
+```json
+{
+  "jsc": {
+    "experimental": {
+      "plugins": [["@swc/plugin-styled-jsx", {}]]
+    }
+  }
+}
+```
+
 # @swc/plugin-styled-jsx
 
 ## 13.7.0
diff --git a/packages/swc-confidential/README.md b/packages/swc-confidential/README.md
index 0aebbf50e..c3e52cf75 100644
--- a/packages/swc-confidential/README.md
+++ b/packages/swc-confidential/README.md
@@ -1,5 +1,7 @@
 # @swc/plugin-swc-confidential
 
+Encrypts confidential string literals at build time. Strings marked with the `/*#__CONFIDENTIAL__*/` comment annotation are replaced with AES-encrypted values, preventing sensitive data (such as feature flag names, API keys, or internal identifiers) from being exposed as plain text in the compiled bundle.
+
 ## Usage
 
 .swcrc:
diff --git a/packages/swc-magic/README.md b/packages/swc-magic/README.md
index 3d7abb1c8..ae36a3d75 100644
--- a/packages/swc-magic/README.md
+++ b/packages/swc-magic/README.md
@@ -1,5 +1,7 @@
 # @swc/plugin-swc-magic
 
+SWC plugin for the [`@swc/magic`](https://www.npmjs.com/package/@swc/magic) package. It processes magic annotations in your code, such as `markAsPure`, which marks function calls as side-effect-free so the SWC minifier can safely tree-shake (remove) them when their result is unused.
+
 ## Usage
 
 .swcrc:
diff --git a/packages/swc-sdk/README.md b/packages/swc-sdk/README.md
index 987f2761c..cabe78b98 100644
--- a/packages/swc-sdk/README.md
+++ b/packages/swc-sdk/README.md
@@ -1,6 +1,8 @@
 # @swc/plugin-swc-sdk
 
-# Usage
+SWC plugin for the [`@swc/sdk`](https://www.npmjs.com/package/@swc/sdk) package. It provides build-time code transformations including `markAsPure` (marks function calls as pure/side-effect-free for tree-shaking) and `/*#__DYNAMIC__*/` annotations (converts static imports into dynamic imports for conditional lazy loading).
+
+## Usage
 
 .swcrc:
 
diff --git a/packages/transform-imports/README.md b/packages/transform-imports/README.md
index e90e174e6..894e211a5 100644
--- a/packages/transform-imports/README.md
+++ b/packages/transform-imports/README.md
@@ -1,4 +1,8 @@
-# transform-imports
+# @swc/plugin-transform-imports
+
+Transforms named module imports into direct imports from individual files, reducing bundle size by avoiding the import of entire libraries when only specific members are needed. This is the SWC equivalent of [`babel-plugin-transform-imports`](https://www.npmjs.com/package/babel-plugin-transform-imports).
+
+For example, `import { Button } from 'react-bootstrap'` becomes `import Button from 'react-bootstrap/lib/Button'`.
 
 ## Config