chore: bump version to 3.1.0 and fix installation docs

- Update all packages to version 3.1.0
- Add @react-code-view/unplugin to installation instructions
- Clarify that unplugin is needed for markdown imports
- Add note about when unplugin is optional

Author: simonguo

NPM_DEPRECATION_COMMANDS.md

@@ -0,0 +1,47 @@
+# NPM Deprecation Commands for react-code-view
+
+## 🚨 Important: Run these commands to deprecate the package on npm
+
+After merging the PR that removes the `react-code-view` package, run the following commands to deprecate it on npm:
+
+### Deprecate all versions
+
+```bash
+# Deprecate all versions of react-code-view
+npm deprecate react-code-view "Package deprecated. Please use @react-code-view/react instead. See https://github.com/simonguo/react-code-view/blob/main/DEPRECATION_react-code-view.md for migration guide."
+```
+
+### Deprecate specific version ranges (alternative)
+
+If you prefer to deprecate specific versions:
+
+```bash
+# Deprecate v3.x versions
+npm deprecate react-code-view@3.x "Package deprecated. Please use @react-code-view/react instead. See https://github.com/simonguo/react-code-view/blob/main/DEPRECATION_react-code-view.md for migration guide."
+
+# Deprecate v2.x versions (if needed)
+npm deprecate react-code-view@2.x "Package deprecated. Please use @react-code-view/react instead. See https://github.com/simonguo/react-code-view/blob/main/DEPRECATION_react-code-view.md for migration guide."
+```
+
+## 📋 Verification
+
+After running the deprecation command, verify it worked:
+
+```bash
+npm view react-code-view
+```
+
+You should see a deprecation warning in the output.
+
+## 📝 Notes
+
+- Deprecation does NOT unpublish the package - it remains available for existing users
+- Users will see a warning when installing: `npm WARN deprecated react-code-view@x.x.x: Package deprecated...`
+- The package will still be installable, but users are encouraged to migrate
+- According to npm policy, you should NOT unpublish packages that others depend on
+
+## 🔗 References
+
+- npm deprecate documentation: https://docs.npmjs.com/cli/v10/commands/npm-deprecate
+- npm unpublish policy: https://docs.npmjs.com/policies/unpublish
+- Migration guide: [DEPRECATION_react-code-view.md](./DEPRECATION_react-code-view.md)

README.md

@@ -29,15 +29,17 @@ A React component library for rendering code with **live preview** and syntax hi
 
 ```bash
 # npm
-npm install @react-code-view/react
+npm install @react-code-view/react @react-code-view/unplugin
 
 # pnpm
-pnpm add @react-code-view/react
+pnpm add @react-code-view/react @react-code-view/unplugin
 
 # yarn
-yarn add @react-code-view/react
+yarn add @react-code-view/react @react-code-view/unplugin
 ```
 
+> **Note:** `@react-code-view/unplugin` is needed if you want to import `.md` files directly as React components. For basic CodeView usage without markdown imports, you only need `@react-code-view/react`.
+
 ## 🚀 Quick Start
 
 ### ⭐ Import Markdown as React Components

package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-code-view-monorepo",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "private": true,
   "description": "Monorepo for react-code-view - A React component for rendering code with live preview",
   "repository": {

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-code-view/core",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "Core markdown transformation utilities for react-code-view",
   "type": "module",
   "main": "./dist/index.cjs",

packages/react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-code-view/react",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "React components for rendering code with live preview",
   "type": "module",
   "main": "./dist/index.cjs",

packages/unplugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-code-view/unplugin",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "Build tool plugins for react-code-view (Webpack, Vite, Rollup, esbuild, Rspack)",
   "license": "MIT",
   "main": "./dist/index.cjs",