docs(bubble): add docs for bubble component (#43)

ztygod · fu050409 · web-flow · commit 2571fb660f72 · 2025-07-07T22:10:19.000+08:00
文档中组件演示添加 bubble 如下： ![image](https://github.com/user-attachments/assets/f2ab7d3a-c0cb-4080-8fed-19f3449c0745) ![image](https://github.com/user-attachments/assets/33c7aab6-1494-4eda-9a59-c3023a220923) --------- Co-authored-by: 苏向夜 <46275354+fu050409@users.noreply.github.com> Co-authored-by: 苏向夜 <fu050409@163.com>
diff --git a/README.md b/README.md
@@ -102,8 +102,8 @@ We welcome all kinds of contributions:
 
 ## Contact Us
 
-|                                              MateChat React Chat Group                                               |                                         SOA Chat Group                                          |
-| :------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------: |
+|                                              MateChat React Chat Group                                               |                                         SOA Chat Group                                         |
+| :------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: |
 | [<img alt="MateChat React Chat Group" src="./assets/matechat-react-qq-group.jpg" />](https://qm.qq.com/q/aMLehEXzBm) | [<img alt="SOA Chat Group" src="./assets/soa-qq-group.jpg" />](https://qm.qq.com/q/lOocKriX74) |
 
 ## License
diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -116,4 +116,4 @@ export default function BubbleDemo() {
 
 ## License
 
-该项目已获得 [MIT 许可](./LICENSE).
+该项目已获得 [MIT 许可](./LICENSE).
diff --git a/docs/docs/en/_meta.json b/docs/docs/en/_meta.json
@@ -1,4 +1,9 @@
 [
+  {
+    "text": "components",
+    "link": "/components",
+    "activeMatch": "^/components"
+  },
   {
     "text": "Releases",
     "items": [
diff --git a/docs/docs/en/components/_meta.json b/docs/docs/en/components/_meta.json
@@ -0,0 +1,9 @@
+[
+  {
+    "type": "dir",
+    "name": "interaction",
+    "label": "interaction",
+    "collapsible": true,
+    "collapsed": false
+  }
+]
diff --git a/docs/docs/en/components/index.md b/docs/docs/en/components/index.md
@@ -0,0 +1,3 @@
+# Components
+
+> This page is not complete yet.
diff --git a/docs/docs/en/components/interaction/bubble.mdx b/docs/docs/en/components/interaction/bubble.mdx
@@ -0,0 +1,21 @@
+# Bubble
+
+Bubble components used to contain conversation content, supporting transparent background, custom loading animation, etc.
+
+## Examples
+
+```tsx preview
+import { Bubble } from "@matechat/react";
+
+export default function () {
+  return (
+    <div className="flex">
+      <Bubble text="Hello, how can I help you?" />
+    </div>
+  );
+}
+```
+
+## Properties
+
+<API moduleName="bubble" />
diff --git a/docs/docs/zh/_meta.json b/docs/docs/zh/_meta.json
@@ -1,4 +1,9 @@
 [
+  {
+    "text": "components",
+    "link": "/zh/components",
+    "activeMatch": "^/zh/components"
+  },
   {
     "text": "版本",
     "items": [
diff --git a/docs/docs/zh/components/_meta.json b/docs/docs/zh/components/_meta.json
@@ -0,0 +1,9 @@
+[
+  {
+    "type": "dir",
+    "name": "interaction",
+    "label": "interaction",
+    "collapsible": true,
+    "collapsed": false
+  }
+]
diff --git a/docs/docs/zh/components/index.md b/docs/docs/zh/components/index.md
@@ -0,0 +1,3 @@
+# 组件
+
+> 此页面还在施工中。
diff --git a/docs/docs/zh/components/interaction/bubble.mdx b/docs/docs/zh/components/interaction/bubble.mdx
@@ -0,0 +1,21 @@
+# Bubble 气泡
+
+Bubble 组件用于承载对话内容的气泡组件，支持透明背景、自定义加载动画等。
+
+## 代码演示
+
+```tsx preview
+import { Bubble } from "@matechat/react";
+
+export default function () {
+  return (
+    <div className="flex">
+      <Bubble text="你好，有什么我可以帮助你的吗" />
+    </div>
+  );
+}
+```
+
+## 参数
+
+<API moduleName="bubble" />
diff --git a/docs/env.d.ts b/docs/env.d.ts
@@ -0,0 +1,3 @@
+declare module "*.png";
+declare module "*.jpg";
+declare module "*.svg";
diff --git a/docs/i18n.json b/docs/i18n.json
@@ -2,5 +2,13 @@
   "quickStart": {
     "zh": "快速开始",
     "en": "Quick Start"
+  },
+  "components": {
+    "zh": "组件",
+    "en": "Components"
+  },
+  "interaction": {
+    "zh": "交互",
+    "en": "Interaction"
   }
 }
diff --git a/docs/package.json b/docs/package.json
@@ -11,10 +11,12 @@
   },
   "dependencies": {
     "@matechat/react": "link:..",
-    "@rspress/plugin-playground": "^1.44.0",
     "rspress": "^1.40.2"
   },
   "devDependencies": {
+    "@rspress/plugin-api-docgen": "^1.44.0",
+    "@rspress/plugin-playground": "^1.44.0",
+    "@rspress/plugin-preview": "^1.44.0",
     "@tailwindcss/postcss": "^4.1.11",
     "@types/node": "^18.11.17",
     "postcss": "^8.5.6",
diff --git a/docs/pnpm-lock.yaml b/docs/pnpm-lock.yaml
diff --git a/docs/rspress.config.ts b/docs/rspress.config.ts
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml

Original file line number	Diff line number	Diff line change
`@@ -116,4 +116,4 @@ export default function BubbleDemo() {`
`116`	`116`
`117`	`117`	`## License`
`118`	`118`
`119`		`-该项目已获得 [MIT 许可](./LICENSE).`
	`119`	`+该项目已获得 [MIT 许可](./LICENSE).`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,9 @@`
`1`	`1`	`[`
	`2`	`+ {`
	`3`	`+ "text": "components",`
	`4`	`+ "link": "/components",`
	`5`	`+ "activeMatch": "^/components"`
	`6`	`+ },`
`2`	`7`	`{`
`3`	`8`	`"text": "Releases",`
`4`	`9`	`"items": [`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Components`
	`2`	`+`
	`3`	`+> This page is not complete yet.`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# 组件`
	`2`	`+`
	`3`	`+> 此页面还在施工中。`