@doubao-dev/framework 0.2.1 → 0.3.0

package/dist/api.d.ts

@@ -1,4 +1,5 @@
 import type { HealthDataType as HealthDataType_2 } from '@byted-doubao-apps/bridge-api';
+import type { OpenAppResult } from '@byted-doubao-apps/bridge-api';
 
 /**
  * 加速度数据变化事件。
@@ -2360,7 +2361,7 @@ export declare type DeviceOrientation = 'portrait' | 'landscape';
  * 关闭页面返回前提醒。
  *
  * @returns 返回一个 Promise，在当前页面的返回提醒关闭后 resolve。
- * @since 0.0.43
+ * @since 0.2.0
  * @platformSupport Android | supported | 支持关闭当前页面已开启的返回提醒。
  * @platformSupport iOS | supported | 支持关闭当前页面已开启的返回提醒。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -2747,7 +2748,7 @@ export declare interface DypayParams {
  * 配合 disableAlertBeforeUnload 使用。
  * @param params 返回提醒参数，字段见 {@link EnableAlertBeforeUnloadParams}。
  * @returns 返回一个 Promise，在当前页面的返回提醒开启或更新后 resolve。
- * @since 0.0.43
+ * @since 0.2.0
  * @platformSupport Android | supported | 支持为当前页面开启返回提醒并更新提示文案。
  * @platformSupport iOS | supported | 支持为当前页面开启返回提醒并更新提示文案。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -7418,6 +7419,15 @@ export declare const onUserScreenRecord: ClientEventRegistry<UserScreenRecordEve
  */
 export declare const onWifiConnected: ClientEventRegistry<WifiConnectedEvent>;
 
+/**
+ * 通过 URI 打开外部应用。
+ *
+ * @internal
+ */
+export declare const openApp: (params: {
+    uri: string;
+}) => Promise<OpenAppResult>;
+
 /**
  * 打开蓝牙适配器。
  *
@@ -7545,7 +7555,7 @@ export declare interface OpenLocationParams {
  * });
  * ```
  *
- * @since 0.0.43
+ * @since 0.2.0
  * @platformSupport Android | supported | 支持 push、replace、navigate 和 pop_to 页面栈操作。
  * @platformSupport iOS | supported | 支持 push、replace、navigate 和 pop_to 页面栈操作。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -7575,7 +7585,7 @@ export declare const openPage: (params: OpenPageParams) => Promise<object>;
  * });
  * ```
  *
- * @since 0.0.43
+ * @since 0.2.0
  * @containerSupport Page | supported
  * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持在当前关联的主对话流中以半屏形式打开应用内页面。

package/dist/components.d.ts

@@ -648,7 +648,7 @@ export { ContentSizeChangedEvent }
  * 自定义地图样式 ID。
  * @since 0.2.1
  */
-export declare type CustomMapStyleId = string;
+export declare type CustomMapStyleId = string & Record<never, never>;
 
 export declare const DoubaoPaymentButton: typeof DoubaoPaymentButton_2;
 
@@ -1453,7 +1453,7 @@ export declare interface LongImageProps {
      */
     scrollEventThrottle?: number;
     /**
-     * 非激活分段占位背景色。
+     * 非激活分段或分段图片加载失败时的占位背景色。
      * @defaultValue 'transparent'
      */
     placeholderColor?: string;
@@ -1540,7 +1540,7 @@ export declare interface LongImageSegmentProps {
      */
     active?: boolean;
     /**
-     * 非激活分段占位背景色。
+     * 非激活分段或分段图片加载失败时的占位背景色。
      * @defaultValue 'transparent'
      */
     placeholderColor?: string;
@@ -1875,6 +1875,10 @@ export declare interface MapProps {
      * 地图加载完成时触发。
      */
     onMapLoaded?: () => void;
+    /**
+     * 地图首个瓦片加载完成时触发。
+     */
+    onMapTileLoaded?: () => void;
     /**
      * 视野开始或结束变化时触发。回调参数包含变化阶段 `type`，以及可选的缩放级别、中心点和可视区域等信息。
      */
@@ -3030,6 +3034,11 @@ export declare interface Polyline {
      * 路线唯一标识。
      */
     id: string;
+    /**
+     * 是否参与 POI 碰撞避让。
+     * @defaultValue false
+     */
+    collideDetection?: boolean;
     /**
      * 路线点数组。
      */
@@ -3511,7 +3520,7 @@ export declare interface RenderLongImageSegmentsOptions {
      */
     mode?: 'view' | 'list';
     /**
-     * 非激活分段占位背景色。
+     * 非激活分段或分段图片加载失败时的占位背景色。
      * @defaultValue 'transparent'
      */
     placeholderColor?: string;

package/dist/config.d.ts

@@ -86,6 +86,14 @@ declare interface AppletChatConfig {
      * App-level chat feature overrides.
      */
     features?: AppletChatFeaturesConfig;
+    /**
+     * Placeholder text for the chat input in text input mode.
+     */
+    inputHint?: string;
+    /**
+     * Hint text for the chat input in voice input mode.
+     */
+    speakHint?: string;
 }
 
 declare interface AppletChatFeatureConfig {

package/dist/index.d.ts

@@ -218,6 +218,14 @@ declare interface AppletChatConfig {
      * App-level chat feature overrides.
      */
     features?: AppletChatFeaturesConfig;
+    /**
+     * Placeholder text for the chat input in text input mode.
+     */
+    inputHint?: string;
+    /**
+     * Hint text for the chat input in voice input mode.
+     */
+    speakHint?: string;
 }
 
 declare interface AppletChatFeatureConfig {
@@ -682,17 +690,6 @@ export declare interface Page<Data extends AnyObject = AnyObject> extends Define
 
 declare type PageInstanceMethods<Data extends AnyObject> = UIInstanceMethods<Data, PageToolExtraMetadata>;
 
-/**
- * 宿主提供的页面运行时元数据。
- *
- * @since 0.1.2
- * @public
- */
-export declare interface PageMeta {
-    /** 是否由 openPageInChat 打开；表示打开来源，不随半屏尺寸变化而改变。 */
-    readonly isInChat: boolean;
-}
-
 declare type PageToolExtraMetadata = {
     /**
      * The page navbar title
@@ -755,6 +752,7 @@ export { RefObject }
 export declare interface SetPageContextParams {
     taskId: string;
     pageInfo: Record<string, unknown>;
+    pageName?: string;
 }
 
 declare const setPageModelContext: (params: SetPageContextParams) => Promise<object>;
@@ -871,41 +869,59 @@ export declare function useModelContext(): ModelContext;
 
 export declare function useMounted(callback: LifecycleCallback): void;
 
+export { useReducer }
+
+export { useRef }
+
+export declare function useShow(callback: LifecycleCallback): void;
+
+export { useState }
+
+export { useSyncExternalStore }
+
+export declare function useViewData<T extends Record<string, any> = Record<string, any>>(): T;
+
 /**
- * 读取当前页面的运行时元数据。
+ * 读取当前视图的运行时元数据。
  *
- * 在 Page / Widget 函数组件顶层调用。宿主未接入或未提供标记时，isInChat 为 false。
+ * 在 Page / Widget（卡片）函数组件顶层调用。宿主未接入或未提供标记时，isOpenedInChat 为 false。
  * 每次调用读取当前值，不订阅宿主更新，也不会主动触发组件渲染。
  *
- * @returns 页面运行时元数据，字段见 {@link PageMeta}。
+ * @returns 视图运行时元数据，字段见 {@link ViewMeta}。
  * @example
  * ```tsx
- * import { usePageMeta } from '@doubao-dev/framework';
+ * import { useViewMeta } from '@doubao-dev/framework';
  *
  * function Page() {
- *   const { isInChat } = usePageMeta();
- *   return <text>{isInChat ? '对话内页面' : '普通页面'}</text>;
+ *   const { isOpenedInChat } = useViewMeta();
+ *   return <text>{isOpenedInChat ? '对话内页面' : '普通页面'}</text>;
  * }
  * ```
- * @since 0.1.2
+ * @since 0.3.0
  * @public
  */
-export declare function usePageMeta(): PageMeta;
-
-export { useReducer }
-
-export { useRef }
-
-export declare function useShow(callback: LifecycleCallback): void;
-
-export { useState }
-
-export { useSyncExternalStore }
-
-export declare function useViewData<T extends Record<string, any> = Record<string, any>>(): T;
+export declare function useViewMeta(): ViewMeta;
 
 export { VFC }
 
+/**
+ * 宿主提供的视图运行时元数据。
+ *
+ * @since 0.3.0
+ * @public
+ */
+export declare interface ViewMeta {
+    /** 当前视图是否为 Page；入口类型标记缺失时为 false。 */
+    readonly isPage: boolean;
+    /** 当前视图是否为 Widget（卡片）；入口类型标记缺失时为 false。 */
+    readonly isWidget: boolean;
+    /**
+     * 页面是否由 openPageInChat 打开；Widget（卡片）为 false，不表示是否展示在聊天中。
+     * 表示打开来源，不随半屏尺寸变化而改变。
+     */
+    readonly isOpenedInChat: boolean;
+}
+
 export { VoidFunctionComponent }
 
 export declare interface Widget<Data extends AnyObject = AnyObject> extends DefineWidgetToolOptions<Data> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doubao-dev/framework",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {