@doubao-apps/ai 0.0.19 → 0.0.20

package/dist/skills/weixin-to-doubao/references/source-framework/components.md

@@ -36,7 +36,7 @@
 
 ### swiper / swiper-item
 
-轮播图，Doubao Apps **无直接映射**，需自定义实现。
+轮播图，当前项目可直接保留为 `<swiper>` / `<swiper-item>`，构建时由 loader 自动注入组件 import，但 API 与微信小程序不完全一致。
 
 ```wxml
 <swiper
@@ -51,11 +51,11 @@
 </swiper>
 ```
 
-**Doubao Apps**：需自定义 Swiper 组件（见 component-mapping.md）
+**Doubao Apps**：优先保留 `<swiper>` / `<swiper-item>`，按当前 SDK 的 `data`、`itemWidth`、`autoPlay` 等 props 改写（见 component-mapping.md）
 
 ### movable-area / movable-view
 
-可拖动区域，Doubao Apps **无直接映射**，需用手势 API 实现。
+可拖动区域，当前项目已有 `<movable-area>` / `<movable-view>`，可优先直接映射；复杂缩放和越界交互需校对 props。
 
 ---
 
@@ -110,6 +110,14 @@
 
 视频，对应 Doubao Apps `<video>`，属性基本相同。
 
+### map
+
+地图组件，当前项目已有 `<map>` 与 `<map-marker>`，中心点、标注点、覆盖物等能力可迁移，但 props 需要按目标组件重新对齐。
+
+### web-view
+
+网页容器，当前项目已有 `<web-view>` 组件。迁移时可先保留标签，再结合宿主白名单与运行时限制做验证。
+
 ### camera
 
 摄像头，Doubao Apps **无直接映射**，使用相机 API。
@@ -120,7 +128,7 @@
 
 ### button
 
-按钮，迁移到内置 `<button>` 元素（**无需导入**，编译为全局变量）。
+按钮，可直接保留为小写 `<button>` 标签；构建时由 `components-loader` 自动补齐组件 import。
 
 ```wxml
 <button
@@ -135,7 +143,7 @@
 </button>
 ```
 
-**Doubao Apps**（无需 import）：
+**Doubao Apps**（迁移代码通常无需手写 import）：
 
 ```tsx
 <button
@@ -174,7 +182,7 @@
 
 ### switch
 
-开关，迁移到内置 `<switch>` 元素（**无需导入**）。
+开关，可直接保留为小写 `<switch>` 标签。
 
 ```wxml
 <switch checked="{{isOn}}" bindchange="handleChange" color="#007AFF" />
@@ -189,7 +197,7 @@
 
 ### slider
 
-滑块，迁移到内置 `<slider>` 元素（**无需导入**）。
+滑块，可直接保留为小写 `<slider>` 标签。
 
 ```wxml
 <slider value="{{sliderVal}}" min="0" max="100" step="1" bindchange="handleSliderChange" />
@@ -204,7 +212,7 @@
 
 ### picker
 
-选择器，Doubao Apps **无直接映射**，需自定义底部弹出选择器（用 `<view>` + 条件渲染模拟）。
+选择器，优先使用现有 `<picker-view>` / `<picker-column>`，并配合 `<popup>`、`Dialog` 或业务弹层容器实现弹出式交互。
 
 ```wxml
 <picker mode="selector" range="{{options}}" value="{{pickerIndex}}" bindchange="handlePickerChange">
@@ -212,7 +220,11 @@
 </picker>
 ```
 
-**Doubao Apps 替代方案**：自定义底部弹出层 + `<view>` 列表。
+**Doubao Apps 替代方案**：底部弹出层 + `<picker-view>` / `<picker-column>`，或简单场景下用 `<view>` 列表。
+
+### picker-view
+
+嵌入式滚动选择器，当前项目已有 `<picker-view>` / `<picker-column>`，适合日期、省市区、枚举值等多列联动场景。
 
 ### checkbox / checkbox-group
 
@@ -220,7 +232,7 @@
 
 ### radio / radio-group
 
-单选框，Doubao Apps **无直接映射**，需自定义。
+单选框，当前项目已有 `<radio>` / `<radio-group>`，组内回调为 `onValueChange(value)`。
 
 ### form
 
@@ -264,8 +276,6 @@ import { navigateTo } from '@doubao-apps/framework/api';
 
 | 微信小程序 | Doubao Apps | 建议 |
 |-----------|-------------|------|
-| `<web-view>` | 不支持 | 使用原生 WebView API |
-| `<map>` | 不支持 | 使用原生地图 API |
 | `<canvas>` | 有限支持 | 检查平台文档 |
 | `<open-data>` | 不支持 | 使用平台用户信息 API |
 | `<official-account>` | 不支持 | 移除 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doubao-apps/ai",
-  "version": "0.0.19",
+  "version": "0.0.20",
   "description": "Doubao Apps SDK AI tools with context and skills management",
   "type": "module",
   "bin": {