@open-dy/vibecoding-sdk-taro 0.0.1 → 0.1.0-beta.0

package/dist/reference/llms.txt

@@ -1,86 +1,78 @@
-# SDK API index
+# @open-dy/vibecoding-sdk-taro
 
-> Generated from structured public SDK contracts and AI-facing JSDoc tags. Read `sdk-api.md` for the entry index, `sdk-api/<subpath>/<API>.md` for a focused API page, and `sdk-api.json` for machine-readable contracts.
+> API documentation for @open-dy/vibecoding-sdk-taro, covering runtime APIs, build configuration and component contracts.
 
-## Entry points
-- `@open-dy/vibecoding-sdk-taro` — 根入口：类型与聚合导出。
-- `@open-dy/vibecoding-sdk-taro/runtime` — SDK 公开 API。 ([docs](./sdk-api/runtime/index.md))
-- `@open-dy/vibecoding-sdk-taro/interest-card/runtime/microapp` — 兴趣卡普通小程序适配器，复用 runtime 入口。 ([docs](./sdk-api/runtime/index.md))
-- `@open-dy/vibecoding-sdk-taro/interest-card/eslint/taro` — 公开导出入口。
-- `@open-dy/vibecoding-sdk-taro/interest-card/types/taro` — 公开导出入口。
-- `@open-dy/vibecoding-sdk-taro/ui` — React UI 组件、Hook、类型和样式函数；按模块渐进查阅。 ([docs](./sdk-api/ui/index.md))
-- `@open-dy/vibecoding-sdk-taro/ui/*` — React UI 组件、Hook、类型和样式函数；按模块渐进查阅。 ([docs](./sdk-api/ui/index.md))
-- `@open-dy/vibecoding-sdk-taro/ui/theme.css` — UI 样式资源入口。
-- `@open-dy/vibecoding-sdk-taro/ui/tailwind.css` — UI 样式资源入口。
-- `@open-dy/vibecoding-sdk-taro/components/miniapp-open-card` — 公开导出入口。
-- `@open-dy/vibecoding-sdk-taro/build/taro` — SDK 公开 API。 ([docs](./sdk-api/build/taro/index.md))
-- `@open-dy/vibecoding-sdk-taro/types/taro` — 平台类型声明入口。
-- `@open-dy/vibecoding-sdk-taro/reference/sdk-api.md` — 已生成的机器可读或 Markdown 参考文档。
-- `@open-dy/vibecoding-sdk-taro/reference/sdk-api.json` — 已生成的机器可读或 Markdown 参考文档。
-- `@open-dy/vibecoding-sdk-taro/reference/llms.txt` — 已生成的机器可读或 Markdown 参考文档。
-- `@open-dy/vibecoding-sdk-taro/reference/sdk-api/*` — 已生成的机器可读或 Markdown 参考文档。
-- `@open-dy/vibecoding-sdk-taro/eslint/taro` — 场景化 ESLint 配置入口。
-- `@open-dy/vibecoding-sdk-taro/eslint/server` — 场景化 ESLint 配置入口。
-- `@open-dy/vibecoding-sdk-taro/build` — 构建能力聚合入口；详细契约见 build/taro 和 build/opencard。 ([docs](./sdk-api/build/taro/index.md))
+Start with the SDK overview, then follow the relevant API or module link. Import paths and types are documented on the linked pages.
+
+Companion libraries are separate project dependencies, imported from their own package names.
+
+## Documentation
+
+- [SDK overview](./sdk-api.md): Complete public entry points and documentation directory.
+- [API manifest](./sdk-api.json): Machine-readable signatures, parameters, return values and usage constraints.
 
 ## APIs
-- [createMicroappClient](./sdk-api/runtime/createMicroappClient.md) — 创建普通小程序的网络入口；SDK 自动绑定项目 Taro 运行时。
-  Import: `@open-dy/vibecoding-sdk-taro/runtime`
-- [CreateMicroappClientOptions](./sdk-api/runtime/CreateMicroappClientOptions.md) — 配置普通小程序 Network 的平台渠道。
-  Import: `@open-dy/vibecoding-sdk-taro/runtime`
-- [BuildContext](./sdk-api/build/taro/BuildContext.md) — Taro 构建阶段共享的编译上下文。
-  Import: `@open-dy/vibecoding-sdk-taro/build/taro`
-- [CreateMicroappTaroConfigOptions](./sdk-api/build/taro/CreateMicroappTaroConfigOptions.md) — 创建普通小程序 Taro 配置的选项。
-  Import: `@open-dy/vibecoding-sdk-taro/build/taro`
-- [createMicroappTaroConfig](./sdk-api/build/taro/createMicroappTaroConfig.md) — 创建普通小程序的 Taro/Vite 构建配置。
-  Import: `@open-dy/vibecoding-sdk-taro/build/taro`
+
+- [createMicroappClient](./sdk-api/runtime/createMicroappClient.md): 创建普通小程序的网络入口；SDK 自动绑定项目 Taro 运行时。 Import: `@open-dy/vibecoding-sdk-taro/runtime`.
+- [CreateMicroappClientOptions](./sdk-api/runtime/CreateMicroappClientOptions.md): 配置普通小程序 Network 的平台渠道。 Import: `@open-dy/vibecoding-sdk-taro/runtime`.
+- [MiniappOpenCard](./sdk-api/components/miniapp-open-card/MiniappOpenCard.md): 承载同一 OpenCard；SDK 选择环境版本并为空初始化参数提供对象，错误类型直接报错。 Import: `@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`.
+- [MiniappOpenCardProps](./sdk-api/components/miniapp-open-card/MiniappOpenCardProps.md): 普通 Taro 宿主的内嵌卡属性；沿用 StandardProps，但不接受 children 或 envVersion。 Import: `@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`.
+- [MiniappOpenCardErrorDetail](./sdk-api/components/miniapp-open-card/MiniappOpenCardErrorDetail.md): 内嵌卡加载错误的事件 detail；可选错误字段由平台提供。 Import: `@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`.
+- [MiniappOpenCardEnvVersion](./sdk-api/components/miniapp-open-card/MiniappOpenCardEnvVersion.md): SDK 根据宿主环境选择的卡片版本；不是业务组件的可配置属性。 Import: `@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`.
+- [BuildContext](./sdk-api/build/taro/BuildContext.md): Taro 构建阶段共享的编译上下文。 Import: `@open-dy/vibecoding-sdk-taro/build/taro`.
+- [CreateMicroappTaroConfigOptions](./sdk-api/build/taro/CreateMicroappTaroConfigOptions.md): 创建普通小程序 Taro 配置的选项。 Import: `@open-dy/vibecoding-sdk-taro/build/taro`.
+- [createMicroappTaroConfig](./sdk-api/build/taro/createMicroappTaroConfig.md): 创建普通小程序的 Taro/Vite 构建配置。 Import: `@open-dy/vibecoding-sdk-taro/build/taro`.
 
 ## UI modules
-Each module index lists all its public components, types, hooks and style functions; follow an API link for props, examples and source.
-- [accordion](./sdk-api/ui/accordion/index.md)
-- [alert-dialog](./sdk-api/ui/alert-dialog/index.md)
-- [alert](./sdk-api/ui/alert/index.md)
-- [aspect-ratio](./sdk-api/ui/aspect-ratio/index.md)
-- [avatar](./sdk-api/ui/avatar/index.md)
-- [badge](./sdk-api/ui/badge/index.md)
-- [button-group](./sdk-api/ui/button-group/index.md)
-- [button](./sdk-api/ui/button/index.md)
-- [calendar](./sdk-api/ui/calendar/index.md)
-- [card](./sdk-api/ui/card/index.md)
-- [carousel](./sdk-api/ui/carousel/index.md)
-- [checkbox](./sdk-api/ui/checkbox/index.md)
-- [collapsible](./sdk-api/ui/collapsible/index.md)
-- [combobox](./sdk-api/ui/combobox/index.md)
-- [dialog](./sdk-api/ui/dialog/index.md)
-- [drawer](./sdk-api/ui/drawer/index.md)
-- [dropdown-menu](./sdk-api/ui/dropdown-menu/index.md)
-- [empty](./sdk-api/ui/empty/index.md)
-- [field](./sdk-api/ui/field/index.md)
-- [helpers](./sdk-api/ui/helpers/index.md)
-- [input-group](./sdk-api/ui/input-group/index.md)
-- [input-otp](./sdk-api/ui/input-otp/index.md)
-- [input](./sdk-api/ui/input/index.md)
-- [item](./sdk-api/ui/item/index.md)
-- [label](./sdk-api/ui/label/index.md)
-- [menubar](./sdk-api/ui/menubar/index.md)
-- [navigation-menu](./sdk-api/ui/navigation-menu/index.md)
-- [pagination](./sdk-api/ui/pagination/index.md)
-- [popover](./sdk-api/ui/popover/index.md)
-- [portal](./sdk-api/ui/portal/index.md)
-- [progress](./sdk-api/ui/progress/index.md)
-- [radio-group](./sdk-api/ui/radio-group/index.md)
-- [resizable](./sdk-api/ui/resizable/index.md)
-- [scroll-area](./sdk-api/ui/scroll-area/index.md)
-- [select](./sdk-api/ui/select/index.md)
-- [separator](./sdk-api/ui/separator/index.md)
-- [sheet](./sdk-api/ui/sheet/index.md)
-- [skeleton](./sdk-api/ui/skeleton/index.md)
-- [slider](./sdk-api/ui/slider/index.md)
-- [sonner](./sdk-api/ui/sonner/index.md)
-- [spinner](./sdk-api/ui/spinner/index.md)
-- [switch](./sdk-api/ui/switch/index.md)
-- [table](./sdk-api/ui/table/index.md)
-- [tabs](./sdk-api/ui/tabs/index.md)
-- [textarea](./sdk-api/ui/textarea/index.md)
-- [toggle-group](./sdk-api/ui/toggle-group/index.md)
-- [toggle](./sdk-api/ui/toggle/index.md)
+
+- [accordion](./sdk-api/ui/accordion/index.md): API reference for the accordion module; Taro only.
+- [alert-dialog](./sdk-api/ui/alert-dialog/index.md): API reference for the alert-dialog module; Taro only.
+- [alert](./sdk-api/ui/alert/index.md): API reference for the alert module; Taro only.
+- [aspect-ratio](./sdk-api/ui/aspect-ratio/index.md): API reference for the aspect-ratio module; Taro only.
+- [avatar](./sdk-api/ui/avatar/index.md): API reference for the avatar module; Taro only.
+- [badge](./sdk-api/ui/badge/index.md): API reference for the badge module; Taro only.
+- [button-group](./sdk-api/ui/button-group/index.md): API reference for the button-group module; Taro only.
+- [button](./sdk-api/ui/button/index.md): API reference for the button module; Taro only.
+- [calendar](./sdk-api/ui/calendar/index.md): API reference for the calendar module; Taro only.
+- [card](./sdk-api/ui/card/index.md): API reference for the card module; Taro only.
+- [carousel](./sdk-api/ui/carousel/index.md): API reference for the carousel module; Taro only.
+- [checkbox](./sdk-api/ui/checkbox/index.md): API reference for the checkbox module; Taro only.
+- [collapsible](./sdk-api/ui/collapsible/index.md): API reference for the collapsible module; Taro only.
+- [combobox](./sdk-api/ui/combobox/index.md): API reference for the combobox module; Taro only.
+- [dialog](./sdk-api/ui/dialog/index.md): API reference for the dialog module; Taro only.
+- [drawer](./sdk-api/ui/drawer/index.md): API reference for the drawer module; Taro only.
+- [dropdown-menu](./sdk-api/ui/dropdown-menu/index.md): API reference for the dropdown-menu module; Taro only.
+- [empty](./sdk-api/ui/empty/index.md): API reference for the empty module; Taro only.
+- [field](./sdk-api/ui/field/index.md): API reference for the field module; Taro only.
+- [helpers](./sdk-api/ui/helpers/index.md): API reference for the helpers module; Taro only.
+- [input-group](./sdk-api/ui/input-group/index.md): API reference for the input-group module; Taro only.
+- [input-otp](./sdk-api/ui/input-otp/index.md): API reference for the input-otp module; Taro only.
+- [input](./sdk-api/ui/input/index.md): API reference for the input module; Taro only.
+- [item](./sdk-api/ui/item/index.md): API reference for the item module; Taro only.
+- [label](./sdk-api/ui/label/index.md): API reference for the label module; Taro only.
+- [menubar](./sdk-api/ui/menubar/index.md): API reference for the menubar module; Taro only.
+- [navigation-menu](./sdk-api/ui/navigation-menu/index.md): API reference for the navigation-menu module; Taro only.
+- [pagination](./sdk-api/ui/pagination/index.md): API reference for the pagination module; Taro only.
+- [popover](./sdk-api/ui/popover/index.md): API reference for the popover module; Taro only.
+- [portal](./sdk-api/ui/portal/index.md): API reference for the portal module; Taro only.
+- [progress](./sdk-api/ui/progress/index.md): API reference for the progress module; Taro only.
+- [radio-group](./sdk-api/ui/radio-group/index.md): API reference for the radio-group module; Taro only.
+- [resizable](./sdk-api/ui/resizable/index.md): API reference for the resizable module; Taro only.
+- [scroll-area](./sdk-api/ui/scroll-area/index.md): API reference for the scroll-area module; Taro only.
+- [select](./sdk-api/ui/select/index.md): API reference for the select module; Taro only.
+- [separator](./sdk-api/ui/separator/index.md): API reference for the separator module; Taro only.
+- [sheet](./sdk-api/ui/sheet/index.md): API reference for the sheet module; Taro only.
+- [skeleton](./sdk-api/ui/skeleton/index.md): API reference for the skeleton module; Taro only.
+- [slider](./sdk-api/ui/slider/index.md): API reference for the slider module; Taro only.
+- [sonner](./sdk-api/ui/sonner/index.md): API reference for the sonner module; Taro only.
+- [spinner](./sdk-api/ui/spinner/index.md): API reference for the spinner module; Taro only.
+- [switch](./sdk-api/ui/switch/index.md): API reference for the switch module; Taro only.
+- [table](./sdk-api/ui/table/index.md): API reference for the table module; Taro only.
+- [tabs](./sdk-api/ui/tabs/index.md): API reference for the tabs module; Taro only.
+- [textarea](./sdk-api/ui/textarea/index.md): API reference for the textarea module; Taro only.
+- [toggle-group](./sdk-api/ui/toggle-group/index.md): API reference for the toggle-group module; Taro only.
+- [toggle](./sdk-api/ui/toggle/index.md): API reference for the toggle module; Taro only.
+
+## Companion libraries
+
+- [@open-dy/lucide-taro](./sdk-api/libraries/lucide-taro.md): Taro 图标组件、属性、Provider 和 TabBar PNG 工具；独立依赖，OpenCard 不使用。

package/dist/reference/sdk-api/build/taro/BuildContext.md

@@ -3,7 +3,7 @@
 <!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
 
 导入路径：`@open-dy/vibecoding-sdk-taro/build/taro`
-源码：[src/build/taro.ts](../../../../../src/build/taro.ts)（安装包内保留）
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/build/taro.ts`（仅补缺或排错时读取）。
 
 #### 说明
 

package/dist/reference/sdk-api/build/taro/CreateMicroappTaroConfigOptions.md

@@ -3,7 +3,7 @@
 <!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
 
 导入路径：`@open-dy/vibecoding-sdk-taro/build/taro`
-源码：[src/build/taro.ts](../../../../../src/build/taro.ts)（安装包内保留）
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/build/taro.ts`（仅补缺或排错时读取）。
 
 #### 说明
 

package/dist/reference/sdk-api/build/taro/createMicroappTaroConfig.md

@@ -3,7 +3,7 @@
 <!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
 
 导入路径：`@open-dy/vibecoding-sdk-taro/build/taro`
-源码：[src/build/taro.ts](../../../../../src/build/taro.ts)（安装包内保留）
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/build/taro.ts`（仅补缺或排错时读取）。
 
 #### 说明
 

package/dist/reference/sdk-api/components/miniapp-open-card/MiniappOpenCard.md

@@ -0,0 +1,109 @@
+# MiniappOpenCard
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/components/miniapp-open-card.ts`（仅补缺或排错时读取）。
+
+#### 说明
+
+承载同一 OpenCard；SDK 选择环境版本并为空初始化参数提供对象，错误类型直接报错。
+
+参数：
+
+| 名称 | 说明 |
+| --- | --- |
+| `props` | 卡片标识、页面路径和生命周期回调。 |
+
+返回：注入环境版本与初始化对象的原生卡片组件。
+
+备注：development 使用 latest，preview 使用 preview，production、未知或无法读取的环境使用 current；业务不传 envVersion。
+initData 省略时 SDK 传入空对象，传 null、数组、字符串或其他非普通对象会抛出 TypeError；业务示例显式传 {}。
+宿主只承载卡片。封闭域请求、数据处理与结果 UI 留在卡内，不通过 initData 或事件把私域结果交给宿主。
+
+示例：
+
+```tsx
+import { MiniappOpenCard } from '@open-dy/vibecoding-sdk-taro/components/miniapp-open-card'
+export function EmbeddedCard({ openCardId }: { openCardId: string }) {
+  return <MiniappOpenCard appId={openCardId} path="pages/index/index" initData={{}} onError={(event) => console.error(event.detail.errMsg)} />
+}
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 在普通 Taro 宿主中渲染已确认的 OpenCard 页面。 |
+| 适用时机 | 用户要求内嵌卡，或宿主需要通过同一封闭域卡片呈现其结果时。 |
+| 避免 | 不要手写原生标签、传 envVersion 或把卡内私域结果转移到宿主。 |
+
+示例：
+
+```ts
+createElement(MiniappOpenCard, { appId: OPEN_CARD_ID, path: 'pages/index/index', initData: {} })
+```
+
+#### 声明
+
+```ts
+function MiniappOpenCard(props: MiniappOpenCardProps);
+```
+
+### MiniappOpenCard 的类型契约
+
+#### 工厂签名
+
+```ts
+(props: MiniappOpenCardProps): React.ReactElement<MiniappOpenCardProps & { envVersion: MiniappOpenCardEnvVersion; }, string | React.JSXElementConstructor<any>>
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| props | `MiniappOpenCardProps` | 卡片标识、页面路径和生命周期回调。 |
+
+##### props 字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| appId | `string` | 已确认的目标 OpenCard 标识；承载当前工程时使用非空 OPEN_CARD_ID，不使用小程序 APP_ID。 |
+| path | `string` | 目标卡片的真实页面路径，例如 pages/index/index。 |
+| initData? | `Record<string, unknown> \| undefined` | 卡片初始化对象；省略时传空对象。禁止传 null、数组或 JSON 字符串。 |
+| onLoad? | `BaseEventOrigFunction<Record<string, never>> \| undefined` | 卡片加载成功时调用；event.detail 为空对象。 |
+| onError? | `BaseEventOrigFunction<MiniappOpenCardErrorDetail> \| undefined` | 卡片加载失败时调用；读取 event.detail 中的错误消息与平台可选错误字段。 |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| className? | `string \| undefined` | 同 `class`，在 React/Preact 里一般使用 `className` 作为 `class` 的代称 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| hidden? | `boolean \| undefined` | 组件是否显示, 所有组件默认显示 |
+| animation? | `TaroGeneral.IAnyObject \| { actions: TaroGeneral.IAnyObject[]; } \| undefined` | 动画属性 |
+| ref? | `React.LegacyRef<any> \| undefined` | 引用 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onTouchStart? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作开始 |
+| onTouchMove? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后移动 |
+| onTouchCancel? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作被打断，如来电提醒，弹窗 |
+| onTouchEnd? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作结束 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTransitionEnd? | `((event: CommonEvent) => void) \| undefined` | 会在 WXSS transition 或 Taro.createAnimation 动画结束后触发 |
+| onAnimationStart? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 动画开始时触发 |
+| onAnimationIteration? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 一次迭代结束时触发 |
+| onAnimationEnd? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 动画完成时触发 |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |
+
+#### 返回值
+
+- 类型：`React.ReactElement<MiniappOpenCardProps & { envVersion: MiniappOpenCardEnvVersion; }, string | React.JSXElementConstructor<any>>`
+
+##### 字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| type | `string \| React.JSXElementConstructor<any>` |  |
+| props | `MiniappOpenCardProps & { envVersion: MiniappOpenCardEnvVersion; }` |  |
+| key | `string \| null` |  |

package/dist/reference/sdk-api/components/miniapp-open-card/MiniappOpenCardEnvVersion.md

@@ -0,0 +1,38 @@
+# MiniappOpenCardEnvVersion
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/components/miniapp-open-card.ts`（仅补缺或排错时读取）。
+
+#### 说明
+
+SDK 根据宿主环境选择的卡片版本；不是业务组件的可配置属性。
+
+示例：
+
+```ts
+const version: MiniappOpenCardEnvVersion = 'current'
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 描述 SDK 自动选择的内嵌卡环境版本。 |
+| 适用时机 | 需要理解宿主环境与卡片版本的对应关系时。 |
+| 避免 | 不要向 MiniappOpenCard 传入 envVersion 覆盖环境选择。 |
+
+#### 声明
+
+```ts
+export type MiniappOpenCardEnvVersion = 'current' | 'latest' | 'preview';
+```
+
+### MiniappOpenCardEnvVersion 的类型契约
+
+#### 类型
+
+```ts
+MiniappOpenCardEnvVersion
+```

package/dist/reference/sdk-api/components/miniapp-open-card/MiniappOpenCardErrorDetail.md

@@ -0,0 +1,52 @@
+# MiniappOpenCardErrorDetail
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/components/miniapp-open-card.ts`（仅补缺或排错时读取）。
+
+#### 说明
+
+内嵌卡加载错误的事件 detail；可选错误字段由平台提供。
+
+示例：
+
+```ts
+const detail: MiniappOpenCardErrorDetail = { errMsg: '卡片加载失败' }
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 识别内嵌卡加载失败的事件字段。 |
+| 适用时机 | 宿主需要通过 onError 展示错误或记录诊断信息时。 |
+| 避免 | 不要假设可选错误编号或类型一定存在。 |
+
+#### 声明
+
+```ts
+export interface MiniappOpenCardErrorDetail {
+    errMsg: string;
+    errNo?: number;
+    errorCode?: number;
+    errorType?: string;
+}
+```
+
+### MiniappOpenCardErrorDetail 的类型契约
+
+#### 类型
+
+```ts
+MiniappOpenCardErrorDetail
+```
+
+#### 字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| errMsg | `string` | 平台返回的错误消息。 |
+| errNo? | `number \| undefined` | 平台错误编号；平台未提供时省略。 |
+| errorCode? | `number \| undefined` | 平台错误码；平台未提供时省略。 |
+| errorType? | `string \| undefined` | 平台错误类型；平台未提供时省略。 |

package/dist/reference/sdk-api/components/miniapp-open-card/MiniappOpenCardProps.md

@@ -0,0 +1,76 @@
+# MiniappOpenCardProps
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/components/miniapp-open-card.ts`（仅补缺或排错时读取）。
+
+#### 说明
+
+普通 Taro 宿主的内嵌卡属性；沿用 StandardProps，但不接受 children 或 envVersion。
+
+示例：
+
+```ts
+const props: MiniappOpenCardProps = { appId: OPEN_CARD_ID, path: 'pages/index/index', initData: {} }
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 配置宿主实际承载的 OpenCard 页面。 |
+| 适用时机 | 普通小程序或兴趣卡落地页需要渲染内嵌卡时。 |
+| 避免 | 不要传小程序 APP_ID、未确认的页面路径或私域结果作为 initData。 |
+
+#### 声明
+
+```ts
+export interface MiniappOpenCardProps extends Omit<StandardProps, 'children'> {
+    appId: string;
+    path: string;
+    initData?: Record<string, unknown>;
+    onLoad?: BaseEventOrigFunction<Record<string, never>>;
+    onError?: BaseEventOrigFunction<MiniappOpenCardErrorDetail>;
+}
+```
+
+### MiniappOpenCardProps 的类型契约
+
+#### 类型
+
+```ts
+MiniappOpenCardProps
+```
+
+#### 字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| appId | `string` | 已确认的目标 OpenCard 标识；承载当前工程时使用非空 OPEN_CARD_ID，不使用小程序 APP_ID。 |
+| path | `string` | 目标卡片的真实页面路径，例如 pages/index/index。 |
+| initData? | `Record<string, unknown> \| undefined` | 卡片初始化对象；省略时传空对象。禁止传 null、数组或 JSON 字符串。 |
+| onLoad? | `BaseEventOrigFunction<Record<string, never>> \| undefined` | 卡片加载成功时调用；event.detail 为空对象。 |
+| onError? | `BaseEventOrigFunction<MiniappOpenCardErrorDetail> \| undefined` | 卡片加载失败时调用；读取 event.detail 中的错误消息与平台可选错误字段。 |
+| style? | `string \| React.CSSProperties \| undefined` | 组件的内联样式, 可以动态设置的内联样式 |
+| id? | `string \| undefined` | 组件的唯一标示, 保持整个页面唯一 |
+| className? | `string \| undefined` | 同 `class`，在 React/Preact 里一般使用 `className` 作为 `class` 的代称 |
+| key? | `string \| number \| undefined` | 如果列表中项目的位置会动态改变或者有新的项目添加到列表中， 需要使用 `wx:key` 来指定列表中项目的唯一的标识符。 |
+| hidden? | `boolean \| undefined` | 组件是否显示, 所有组件默认显示 |
+| animation? | `TaroGeneral.IAnyObject \| { actions: TaroGeneral.IAnyObject[]; } \| undefined` | 动画属性 |
+| ref? | `React.LegacyRef<any> \| undefined` | 引用 |
+| dangerouslySetInnerHTML? | `{ __html: string; } \| undefined` | 渲染 HTML |
+| compileMode? | `string \| boolean \| undefined` | 是否开启编译模式 或者 是否是编译模式的子渲染函数 |
+| harmonyDirection? | `"row" \| "column" \| "flex" \| undefined` | 自定义容器组件的方向 |
+| onTouchStart? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作开始 |
+| onTouchMove? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后移动 |
+| onTouchCancel? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作被打断，如来电提醒，弹窗 |
+| onTouchEnd? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸动作结束 |
+| onClick? | `((event: ITouchEvent) => void) \| undefined` | 手指触摸后马上离开 |
+| onLongPress? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发 |
+| onLongClick? | `((event: CommonEvent) => void) \| undefined` | 手指触摸后，超过350ms再离开（推荐使用 longpress 事件代替） |
+| onTransitionEnd? | `((event: CommonEvent) => void) \| undefined` | 会在 WXSS transition 或 Taro.createAnimation 动画结束后触发 |
+| onAnimationStart? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 动画开始时触发 |
+| onAnimationIteration? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 一次迭代结束时触发 |
+| onAnimationEnd? | `((event: CommonEvent) => void) \| undefined` | 会在一个 WXSS animation 动画完成时触发 |
+| onTouchForceChange? | `((event: CommonEvent) => void) \| undefined` | 在支持 3D Touch 的 iPhone 设备，重按时会触发 |

package/dist/reference/sdk-api/components/miniapp-open-card/index.md

@@ -0,0 +1,12 @@
+# components/miniapp-open-card
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+导入路径前缀：`@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`
+
+| API | 说明 | 文档 |
+| --- | --- | --- |
+| `MiniappOpenCard` | 承载同一 OpenCard；SDK 选择环境版本并为空初始化参数提供对象，错误类型直接报错。 | [查看](./MiniappOpenCard.md) |
+| `MiniappOpenCardProps` | 普通 Taro 宿主的内嵌卡属性；沿用 StandardProps，但不接受 children 或 envVersion。 | [查看](./MiniappOpenCardProps.md) |
+| `MiniappOpenCardErrorDetail` | 内嵌卡加载错误的事件 detail；可选错误字段由平台提供。 | [查看](./MiniappOpenCardErrorDetail.md) |
+| `MiniappOpenCardEnvVersion` | SDK 根据宿主环境选择的卡片版本；不是业务组件的可配置属性。 | [查看](./MiniappOpenCardEnvVersion.md) |

package/dist/reference/sdk-api/libraries/lucide-taro.md

@@ -0,0 +1,151 @@
+<!-- Generated from packages/lucide-taro/README.md. Do not edit. -->
+
+> 本文收录配套图标库的文档；图标包是工程的独立依赖，不由 SDK 重新导出。业务从 `@open-dy/lucide-taro` 导入，Feed OpenCard 不使用。实际版本和可用图标以当前工程安装的图标包及其公开导出为准。
+
+# @open-dy/lucide-taro
+
+面向 Taro 小程序的 Lucide 图标组件库，并提供生成小程序 TabBar PNG 图标的命令行工具。
+
+## 安装
+
+```bash
+pnpm add @open-dy/lucide-taro
+```
+
+项目需要同时安装兼容版本的 React 与 `@tarojs/components`。
+
+## 使用图标组件
+
+图标名和常用 API 与 `lucide-react` 保持一致，业务代码必须从 `@open-dy/lucide-taro` 导入：
+
+```tsx
+import { House, Search, Settings } from '@open-dy/lucide-taro'
+import { View } from '@tarojs/components'
+
+export function Actions() {
+  return (
+    <View className="flex items-center gap-3">
+      <House size={24} color="#1677ff" strokeWidth={2} />
+      <Search size="20" color="#111827" />
+      <Settings size={20} color="#6b7280" />
+    </View>
+  )
+}
+```
+
+### 图标属性
+
+| 属性 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `size` | `string \| number` | `24` | 图标宽高 |
+| `color` | `string` | `currentColor` | 描边颜色；小程序中建议始终显式传入 |
+| `strokeWidth` | `string \| number` | `2` | 描边宽度 |
+| `filled` | `boolean` | `false` | 使用 `color` 填充图标 |
+| `absoluteStrokeWidth` | `boolean` | `false` | 缩放尺寸时保持视觉描边宽度 |
+| `className` | `string` | - | 添加到外层 Taro `Image` |
+| `style` | `CSSProperties` | - | 添加到外层 Taro `Image` |
+
+原生小程序不能直接渲染内联 SVG。本包会把图标序列化为 SVG data URI，并通过 Taro `Image` 组件显示。因此：
+
+- `className` 和 `style` 只影响外层 `Image`，不会把 CSS `color` 传入 SVG。
+- 不要依赖 `currentColor` 或 `text-*` class 改变图标笔画，始终显式传递 `color`。
+- 图标所在的按钮或容器应提供明确宽高和居中布局。
+
+## 全局默认属性
+
+可以使用 `LucideProvider` 为子树设置默认值：
+
+```tsx
+import {
+  Bell,
+  LucideProvider,
+  MessageCircle,
+} from '@open-dy/lucide-taro'
+
+export function IconGroup() {
+  return (
+    <LucideProvider size={20} color="#475569" strokeWidth={2}>
+      <Bell />
+      <MessageCircle color="#1677ff" />
+    </LucideProvider>
+  )
+}
+```
+
+组件自身的属性会覆盖 Provider 默认值。`useLucideContext()` 可读取当前默认配置。
+
+## 查找可用图标
+
+包会导出 Lucide 的 PascalCase 图标名及常见兼容别名。不要猜测图标是否存在，使用前搜索类型声明：
+
+```bash
+rg "declare const House" node_modules/@open-dy/lucide-taro/dist/lucide-taro.d.ts
+```
+
+常见命名形态包括 `House`、`HouseIcon` 和部分历史别名。准确导出列表以 `dist/lucide-taro.d.ts` 为准。
+
+## 生成 TabBar PNG
+
+小程序 TabBar 不支持 SVG 或 data URI，需要使用本地 PNG。安装 `sharp` 后，可使用包内命令生成普通态和选中态图标：
+
+```bash
+pnpm add -D sharp
+
+pnpm exec generate-tabbar-png House Search User \
+  -o ./src/assets/tabbar \
+  -c "#999999" \
+  -a "#1677ff"
+```
+
+生成结果：
+
+```text
+src/assets/tabbar/
+├── House.png
+├── House-active.png
+├── Search.png
+├── Search-active.png
+├── User.png
+└── User-active.png
+```
+
+### CLI 参数
+
+| 参数 | 说明 |
+| --- | --- |
+| `<icon...>` | 一个或多个 PascalCase 图标名 |
+| `-o, --out <dir>` | 输出目录，必填 |
+| `--output <name>` | 单图模式的输出文件名前缀 |
+| `-s, --size <n>` | PNG 尺寸，默认 `81` |
+| `-c, --color <hex>` | 普通态颜色，默认 `#999999` |
+| `-a, --active-color <hex>` | 选中态颜色；传入后额外生成 `-active.png` |
+| `-w, --stroke-width <n>` | 描边宽度，默认 `2` |
+| `-h, --help` | 显示帮助 |
+
+单图自定义文件名示例：
+
+```bash
+pnpm exec generate-tabbar-png House \
+  -o ./src/assets/tabbar \
+  --output home \
+  -c "#999999" \
+  -a "#1677ff"
+```
+
+## 当前能力
+
+- 以 Taro `Image` 渲染 Lucide 图标，支持 H5 与小程序构建。
+- 提供完整 TypeScript 图标类型与常见 Lucide 命名别名。
+- 支持单图属性和 `LucideProvider` 全局默认属性。
+- 支持通过 CLI 批量生成 TabBar 普通态与选中态 PNG。
+- 支持尺寸、颜色、描边宽度和单图输出文件名配置。
+
+## 开发与验证
+
+```bash
+pnpm build
+pnpm test
+pnpm pack:local
+```
+
+`dist/` 是该包直接发布的源码产物。修改图标导出或 TabBar 工具后，需要同步验证 `dist/lucide-taro.mjs`、`dist/lucide-taro.d.ts`、`dist/iconNodes.mjs` 与 `dist/generate-tabbar-png.mjs`。

package/dist/reference/sdk-api/runtime/CreateMicroappClientOptions.md

@@ -3,7 +3,7 @@
 <!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
 
 导入路径：`@open-dy/vibecoding-sdk-taro/runtime`
-源码：[src/runtime/client.ts](../../../../src/runtime/client.ts)（安装包内保留）
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/runtime/client.ts`（仅补缺或排错时读取）。
 
 #### 说明