u

code/g3soft-libs/docs/.vitepress/theme/index.ts

@@ -2,6 +2,10 @@ import type { Theme } from 'vitepress'
 import DefaultTheme from 'vitepress/theme'
 import Layout from './Layout.vue'
 import './custom.css'
+// API 文档版式（content/api/**）：端点标题、参数面板、报文面板
+import './api.css'
+import G3ApiParams from './G3ApiParams.vue'
+import G3ApiPayload from './G3ApiPayload.vue'
 // 设计令牌的编译产物（经 vite alias 落到 packages/tokens/dist/index.css）。
 // 组件样式全部依赖 --g3-* 变量，必须先引入。改 tokens 后需重新 build @g3soft/tokens。
 import '@g3soft/tokens'
@@ -9,4 +13,10 @@ import '@g3soft/tokens'
 export default {
   extends: DefaultTheme,
   Layout,
+  enhanceApp({ app }) {
+    // API 文档版式组件：全局注册，md 里直接写 <G3ApiParams> / <G3ApiPayload>，
+    // 与 <demo> 一样是「不 import 就能用」的形态。
+    app.component('G3ApiParams', G3ApiParams)
+    app.component('G3ApiPayload', G3ApiPayload)
+  },
 } satisfies Theme