@doubao-dev/framework 0.0.39 → 0.0.41

package/dist/components.d.ts

@@ -328,6 +328,11 @@ export declare interface CanvasProps {
      * 元素的唯一标识
      */
     id?: string;
+    /**
+     * 原生属性透传，一般由自带画布渲染的三方库使用，业务代码请改用 `ref` 上的绘图方法。
+     * 传入后画布交由外部通过 `attachToCanvasView(name)` 接管，组件不再创建自己的画布实例，`ref` 上的绘图方法随之失效。
+     */
+    name?: string;
     /**
      * 手指触摸动作开始
      * @eventProperty
@@ -3032,6 +3037,47 @@ export declare interface RenderLongImageSegmentsOptions {
     listItemReuseIdentifierPrefix?: string;
 }
 
+/** An allowlisted HTML element in a rich-text node tree. */
+export declare interface RichTextElementNode {
+    /** Optional mini-program-compatible element node discriminator. */
+    type?: 'node';
+    /** Name of the allowlisted HTML element to render. */
+    name: string;
+    /** Element attributes; unsupported attributes are removed during parsing. */
+    attrs?: Record<string, string>;
+    /** Nested text and element nodes rendered inside this element. */
+    children?: RichTextNode[];
+}
+
+/** A text or element node accepted by RichText. */
+export declare type RichTextNode = RichTextTextNode | RichTextElementNode;
+
+/** Props for the mini-program-compatible RichText adapter. */
+export declare interface RichTextProps {
+    /**
+     * An HTML string or a structured node array to render. Unsupported nodes and
+     * attributes are removed before the content is passed to Lynx UI RichText.
+     */
+    nodes?: string | RichTextNode[];
+    /** How plain spaces in text nodes are converted. */
+    space?: RichTextSpace;
+    /** Class name applied to the outer Lynx container. */
+    className?: string;
+    /** Inline style applied to the outer Lynx container. */
+    style?: CSSProperties | string;
+}
+
+/** Whitespace replacement mode compatible with mini-program rich-text. */
+export declare type RichTextSpace = '' | 'nbsp' | 'ensp' | 'emsp';
+
+/** Text content in a rich-text node tree. */
+export declare interface RichTextTextNode {
+    /** Identifies this entry as a text node. */
+    type: 'text';
+    /** Plain text rendered at this position in the node tree. */
+    text: string;
+}
+
 export declare interface RouteLabel {
     /**
      * 标签 ID。
@@ -3055,6 +3101,11 @@ export declare interface RouteLabel {
      * @defaultValue 12
      */
     fontSize?: number;
+    /**
+     * 标签文字字重。
+     * @defaultValue "normal"
+     */
+    fontWeight?: 'normal' | 'bold';
     /**
      * 标签边框颜色。
      * @defaultValue "#cccccc"
@@ -4626,6 +4677,86 @@ declare interface WebGLContextAttributes_2 {
     antialias?: boolean;
 }
 
+/**
+ * 网页视图组件，用于在智能服务页面内承载 H5 页面。
+ *
+ * @remarks
+ * ## 与 H5 双向通信
+ *
+ * H5 页面需要先引入 WebView JSSDK，才能收发消息。可以用 script 标签引入：
+ *
+ * ```html
+ * <script src="https://lf3-static.bytednsdoc.com/obj/eden-cn/msvdeh7pfhpquly/doubao-jssdk-0.0.34-canary-1022d83a-20260615035129.js"></script>
+ * ```
+ *
+ * 构建型项目也可以安装 `@doubao-dev/webview-jssdk` 后导入，导入时会同时挂载全局 `window.doubao`：
+ *
+ * ```js
+ * import doubao from '@doubao-dev/webview-jssdk';
+ * // 或按需导入：import { postMessage, onMessage } from '@doubao-dev/webview-jssdk';
+ * ```
+ *
+ * 应用侧：`src` 指向 H5 地址，`ref` 用于拿到 `postMessage`，`onMessage` 接收 H5 消息。
+ *
+ * ```tsx
+ * import { definePage, useRef } from '@doubao-dev/framework';
+ * import type { WebViewRef } from '@doubao-dev/framework/components';
+ *
+ * function WebViewPage() {
+ *   const webViewRef = useRef<WebViewRef>(null);
+ *
+ *   return (
+ *     <web-view
+ *       ref={webViewRef}
+ *       src="https://example.com/page"
+ *       // 网页加载完成后再发首条消息，H5 才接得住
+ *       onLoad={(event) => webViewRef.current?.postMessage({ type: 'ready', src: event.src })}
+ *       // H5 → 应用：event.data 就是 H5 传入的原始值
+ *       onMessage={(event) => {
+ *         const data = event.data as { type?: string };
+ *         if (data?.type === 'submit') {
+ *           webViewRef.current?.postMessage({ type: 'ack', timestamp: Date.now() });
+ *         }
+ *       }}
+ *       onError={(event) => console.error(event.errorMsg, event.errorCode)}
+ *     />
+ *   );
+ * }
+ *
+ * export default definePage({ render: () => <WebViewPage /> });
+ * ```
+ *
+ * H5 侧：`doubao.onMessage` 接收应用消息并返回注销函数，`doubao.postMessage` 发送消息给应用。
+ *
+ * ```js
+ * const off = doubao.onMessage((raw) => {
+ *   // 应用侧发送的对象会被序列化，这里统一还原
+ *   const data = typeof raw === 'string' ? JSON.parse(raw) : raw;
+ *
+ *   if (data.type === 'ready') {
+ *     // H5 → 应用：参数是 { data }，不是直接传值
+ *     doubao.postMessage({ data: { type: 'submit', payload: { name: '豆包' } } });
+ *   }
+ * });
+ *
+ * // 页面卸载或不再需要时注销
+ * // off();
+ * ```
+ *
+ * 三个容易踩的点：
+ *
+ * - 首条消息放在 `onLoad` 之后发，H5 尚未加载完成时发送的消息会丢失。
+ * - 两个方向的数据形态不同：应用 → H5 时非字符串会被 `JSON.stringify`，H5 收到的是 JSON 字符串，
+ *   需要自行 `JSON.parse`；H5 → 应用时 `onMessage` 的 `event.data` 保持 H5 传入的原始值。
+ * - 如果两侧都写成“收到就回”，务必按消息 `type` 区分，否则会无限互相回声。
+ *
+ * 除消息通道外，H5 还可以调用 `doubao.setTitle({ title })` 同步应用侧 WebView 头部标题。
+ *
+ * Web 模拟器中的 `<web-view>` 通过本地代理承载 H5 页面，页面脚本读取到的
+ * `location.origin` / `location.host` 可能是调试器本地域名，而不是真机 WebView 中的业务域名。
+ * 如果 H5 依赖 `location.origin` 或 `location.host` 判断测试环境、线上环境、白名单或鉴权逻辑，
+ * Web 模拟器结果可能与真机不一致，请使用真机调试确认。
+ */
 export declare interface WebViewProps {
     /**
      * 用于获取 WebView 实例方法

package/dist/config.d.ts

@@ -27,6 +27,10 @@ declare interface AIAppMetadata {
      * 应用版本
      */
     version?: string;
+    /**
+     * 是否声明小程序已适配深色模式
+     */
+    darkMode?: boolean;
 }
 
 declare type AIPageMetadata = Omit<PageDefinition, 'entry' | 'renderType' | 'digest' | 'web'>;

package/dist/index.d.ts

@@ -135,6 +135,10 @@ declare interface AIAppMetadata {
      * 应用版本
      */
     version?: string;
+    /**
+     * 是否声明小程序已适配深色模式
+     */
+    darkMode?: boolean;
 }
 
 export declare type AIToolContext = MessageMeta & {
@@ -583,6 +587,13 @@ export { NamedExoticComponent }
 
 export { NewLifecycle }
 
+/**
+ * Register the runtime error handler.
+ *
+ * Calling this again replaces the previously registered handler.
+ */
+export declare function onError(callback: (error: Error) => void): void;
+
 export declare interface Page<Data extends AnyObject = AnyObject> extends DefineUIToolOptions<Data> {
     __UI__: boolean;
     __PAGE__: boolean;

package/jsx-runtime.d.ts

@@ -26,6 +26,7 @@ export namespace JSX {
     popup: import('./components.d.ts').PopupProps;
     radio: import('./components.d.ts').RadioProps;
     'radio-group': import('./components.d.ts').RadioGroupProps;
+    'rich-text': import('./components.d.ts').RichTextProps;
     slider: import('./components.d.ts').SliderProps;
     switch: import('./components.d.ts').SwitchProps;
     swiper: import('./components.d.ts').SwiperProps;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doubao-dev/framework",
-  "version": "0.0.39",
+  "version": "0.0.41",
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -68,7 +68,7 @@
     "types.d.ts"
   ],
   "dependencies": {
-    "@lynx-js/types": "4.0.0",
+    "@lynx-js/types": "4.1.0",
     "@types/react": "18.3.27"
   },
   "publishConfig": {