@doubao-dev/framework 0.0.38 → 0.0.39

package/dist/components.d.ts

@@ -123,7 +123,8 @@ declare interface BounceConfig {
 /**
  * 按钮组件。
  *
- * ## CSS 继承原则
+ * @remarks
+ * ## 使用建议
  *
  * 由于 Lynx 组件不开启 CSS 继承，Button 的文本样式不会自动应用到 children。
  * 因此提供了以下明确的 API 用法：
@@ -132,9 +133,6 @@ declare interface BounceConfig {
  * - `icon` + `text` prop：组合使用，显示图标和文字
  * - `children`：完全自定义内容，**不会**应用按钮的默认文本样式
  *
- *
- * ## 使用建议
- *
  * ```tsx
  * // 简单文字：用 text prop（推荐）
  * <Button text="确定" />
@@ -206,7 +204,7 @@ export declare interface ButtonProps {
     /**
      * 开放能力类型
      */
-    openType?: 'getPhoneNumber' | 'agreePrivacyAuthorization' | 'agreePrivacyAuthorization|getPhoneNumber';
+    openType?: 'getPhoneNumber' | 'agreePrivacyAuthorization' | 'agreePrivacyAuthorization|getPhoneNumber' | 'openSetting';
     /**
      * 点击回调函数
      * @eventProperty
@@ -227,6 +225,26 @@ export declare interface ButtonProps {
      * @eventProperty
      */
     onAgreePrivacyAuthorization?: (result?: AgreePrivacyResult) => void;
+    /**
+     * 打开授权设置页回调，只在 openType="openSetting" 时有效
+     *
+     * 成功时 detail 包含 `errMsg: 'openSetting:ok'` 和最新 `authSetting`；
+     * 失败时 detail 仅包含 `openSetting:fail ...`，不会包含 `authSetting` 字段。
+     *
+     * @example
+     * ```tsx
+     * <Button
+     *   openType="openSetting"
+     *   onOpenSetting={({ detail }) => {
+     *     if (detail.errMsg === 'openSetting:ok') {
+     *       console.log(detail.authSetting);
+     *     }
+     *   }}
+     * />
+     * ```
+     * @eventProperty
+     */
+    onOpenSetting?: (event: OpenSettingEvent) => void;
 }
 
 declare type ButtonSize = 'default' | 'medium' | 'mini';
@@ -251,13 +269,37 @@ export declare interface CanvasElement {
 }
 
 declare interface CanvasImage {
+    /**
+     * 图片资源地址。
+     */
     src: string;
+    /**
+     * 图片原始宽度。
+     */
     readonly width: number;
+    /**
+     * 图片原始高度。
+     */
     readonly height: number;
+    /**
+     * 图片资源是否加载完成。
+     */
     readonly complete: boolean;
+    /**
+     * 图片加载完成时触发。
+     */
     onload: (() => void) | null;
+    /**
+     * 图片加载失败时触发。
+     */
     onerror: ((error: unknown) => void) | null;
+    /**
+     * 添加图片加载或失败事件监听器。
+     */
     addEventListener: (event: 'load' | 'error', listener: (event: unknown) => void, options?: AddEventListenerOptions | boolean) => void;
+    /**
+     * 移除图片加载或失败事件监听器。
+     */
     removeEventListener: (event: 'load' | 'error', listener: (event: unknown) => void, options?: EventListenerOptions | boolean) => void;
 }
 
@@ -395,7 +437,13 @@ export declare interface CanvasResizeEvent {
 }
 
 export declare interface Circle {
+    /**
+     * 圆形唯一标识。
+     */
     id: string;
+    /**
+     * 圆心坐标。
+     */
     center: LatLng;
     /**
      * 圆半径。
@@ -573,7 +621,13 @@ export declare type GetDoubaoPaymentOrderId = (mode?: DoubaoPaymentMode_2) => st
 declare type GetDoubaoPaymentOrderId_2 = (mode?: DoubaoPaymentMode) => string | Promise<string>;
 
 export declare interface GetPhoneNumberResult {
+    /**
+     * 获取手机号结果码。
+     */
     code?: string;
+    /**
+     * 获取手机号结果信息。
+     */
     message?: string;
 }
 
@@ -653,7 +707,11 @@ export declare interface ImageProps {
      */
     src: string;
     /**
-     * 图片裁剪、缩放模式
+     * 图片裁剪、缩放模式。
+     * - `scaleToFill`：不保持宽高比缩放图片，使图片拉伸填满元素。
+     * - `aspectFit`：保持宽高比缩放图片，使图片长边完整显示。
+     * - `aspectFill`：保持宽高比缩放图片，使图片短边填满元素。
+     * - `center`：不缩放图片，将图片居中显示。
      * @defaultValue 'scaleToFill'
      */
     mode?: 'scaleToFill' | 'aspectFit' | 'aspectFill' | 'center';
@@ -930,7 +988,13 @@ export declare interface InputRef {
 }
 
 export declare type LatLng = {
+    /**
+     * 纬度。
+     */
     latitude: number;
+    /**
+     * 经度。
+     */
     longitude: number;
 };
 
@@ -1543,7 +1607,7 @@ export declare interface MapProps {
      */
     showLocation?: boolean;
     /**
-     * 地图logo位置。
+     * 地图 logo 位置。
      * @defaultValue 'bottom-left'
      */
     logoPosition?: 'bottom-left' | 'bottom-center' | 'bottom-right' | 'top-left' | 'top-center' | 'top-right';
@@ -2170,6 +2234,62 @@ export declare interface MovableViewProps {
     children?: ReactNode;
 }
 
+export declare interface NavigationBarBackEvent {
+    /** 返回的页面层数。为 0 时只触发回调，不执行页面返回。 */
+    delta: number;
+}
+
+/**
+ * 页面顶部导航栏组件。
+ *
+ * 用于隐藏宿主默认标题栏后的自定义页面导航，自动适配状态栏和平台导航规格。
+ */
+export declare interface NavigationBarProps {
+    /** 组件样式。 */
+    style?: CSSProperties;
+    /** 组件类名。 */
+    className?: string;
+    /** 导航标题。为空时渲染 centerContent。 */
+    title?: string;
+    /**
+     * 是否显示默认返回按钮。为 false 时渲染 leftContent。
+     * @defaultValue true
+     */
+    back?: boolean;
+    /**
+     * 点击返回按钮时返回的页面层数。为 0 时只触发 onBack，不执行页面返回。
+     * @defaultValue 1
+     */
+    delta?: number;
+    /** 导航栏背景色。默认跟随当前主题。 */
+    background?: string;
+    /** 标题、返回图标和加载图标的颜色。默认跟随当前主题。 */
+    color?: string;
+    /**
+     * 是否在标题左侧显示加载图标。
+     * @defaultValue false
+     */
+    loading?: boolean;
+    /**
+     * 是否显示导航栏内容。隐藏时仍保留导航栏高度占位。
+     * @defaultValue true
+     */
+    show?: boolean;
+    /**
+     * show 变化时是否使用透明度过渡动画。
+     * @defaultValue true
+     */
+    animated?: boolean;
+    /** back 为 false 时显示的左侧自定义内容。 */
+    leftContent?: ReactNode;
+    /** title 为空时显示的中间自定义内容。 */
+    centerContent?: ReactNode;
+    /** 右侧自定义内容。 */
+    rightContent?: ReactNode;
+    /** 点击默认返回按钮后触发。 */
+    onBack?: (event: NavigationBarBackEvent) => void;
+}
+
 declare interface OffscreenCanvas_2 {
     /**
      * 画布宽度（buffer 像素数）
@@ -2216,6 +2336,40 @@ declare interface OnDragCallback {
     top: number;
 }
 
+/**
+ * Button 通过 `openType="openSetting"` 打开授权设置页后的回调事件。
+ */
+export declare interface OpenSettingEvent {
+    /**
+     * 打开授权设置页的结果详情。
+     */
+    detail: OpenSettingEventDetail;
+}
+
+/**
+ * 打开授权设置页后的事件详情。
+ *
+ * 可通过 `errMsg` 区分成功和失败：成功时同时返回最新的 `authSetting`，
+ * 失败时不包含 `authSetting` 字段。
+ */
+export declare type OpenSettingEventDetail = {
+    /**
+     * 回调状态，成功时固定为 `openSetting:ok`。
+     */
+    errMsg: 'openSetting:ok';
+    /**
+     * 用户授权设置结果。
+     *
+     * key 为权限 scope，value 表示用户是否已授权该权限。
+     */
+    authSetting: Record<string, boolean>;
+} | {
+    /**
+     * 回调状态，失败时格式为 `openSetting:fail ${错误信息}`。
+     */
+    errMsg: `openSetting:fail ${string}`;
+};
+
 /**
  * PickerColumn 单个选项的数据结构
  */
@@ -2331,6 +2485,9 @@ export declare interface PickerViewRef {
 }
 
 export declare interface Polygon {
+    /**
+     * 多边形唯一标识。
+     */
     id: string;
     /**
      * 多边形顶点经纬度数组，顺时针方向。
@@ -2363,6 +2520,9 @@ export declare interface Polygon {
 }
 
 export declare interface Polyline {
+    /**
+     * 路线唯一标识。
+     */
     id: string;
     /**
      * 路线点数组。
@@ -3052,7 +3212,7 @@ export declare interface SliderProps {
      */
     key?: string | number | null | undefined;
     /**
-     * 当前数值 (必填，只支持受控用法)
+     * 当前数值（必填，只支持受控用法）
      */
     value: number;
     /**
@@ -3573,10 +3733,15 @@ export declare interface TextProps {
      */
     textSingleLineVerticalAlign?: 'normal' | 'bottom' | 'center' | 'top';
     /**
-     * 是否开启文本选择功能
+     * 是否开启文本选择功能，开启时需同时设置 `flatten={false}`
      * @defaultValue false
      */
     textSelection?: boolean;
+    /**
+     * 是否将节点扁平化以加速渲染，开启文本选择等需要真实节点的能力时需设为 false
+     * @defaultValue true
+     */
+    flatten?: boolean;
     /**
      * 开启文本选择后，是否使用自定义弹窗菜单
      * @defaultValue false
@@ -4493,6 +4658,9 @@ export declare interface WebViewProps {
 }
 
 export declare interface WebViewRef {
+    /**
+     * 向网页发送消息
+     */
     postMessage(data: unknown): void;
 }
 

package/dist/index.d.ts

@@ -323,7 +323,7 @@ export declare function defineLoginApi(api: LoginApi): LoginApi;
 /**
  * 定义 MCP 登录页面
  * @param options 定义 MCP 登录页面的选项
- * @returns 小程序 MCP 登录页面
+ * @returns 智能服务 MCP 登录页面
  */
 export declare function defineLoginPage<Data extends AnyObject>(options: Omit<DefinePageToolOptions<Data>, 'aiMeta'> & ThisType<Readonly<PageInstanceMethods<Data>>>): Page<Data>;
 
@@ -459,8 +459,9 @@ export { Dispatch }
 
 export { DispatchWithoutAction }
 
-/** 当前小程序基础库版本。 */
-export declare const DoubaoAppsSDKVersion: string;
+/** 当前前端库版本。 */
+declare const DoubaoAppsSDKVersion_2: string;
+export { DoubaoAppsSDKVersion_2 as DoubaoAppsSDKVersion }
 
 export { EffectCallback }
 
@@ -496,7 +497,8 @@ export { FunctionComponentElement }
 
 export { FunctionComponentFactory }
 
-export declare function getApp<T extends App = App>(): T;
+declare function getApp_2<T extends App = App>(): T;
+export { getApp_2 as getApp }
 
 export declare function getCurrentPages(): CurrentPage[];
 
@@ -505,7 +507,13 @@ export { GetDerivedStateFromError }
 export { GetDerivedStateFromProps }
 
 declare interface GetPhoneNumberResult {
+    /**
+     * 获取手机号结果码。
+     */
     code?: string;
+    /**
+     * 获取手机号结果信息。
+     */
     message?: string;
 }
 

package/jsx-runtime.d.ts

@@ -19,6 +19,7 @@ export namespace JSX {
     map: import('./components.d.ts').MapProps;
     'map-marker': import('./components.d.ts').MapMarkerProps;
     markdown: import('./components.d.ts').MarkdownProps;
+    'navigation-bar': import('./components.d.ts').NavigationBarProps;
     'long-image': import('./components.d.ts').LongImageProps;
     'movable-area': import('./components.d.ts').MovableAreaProps;
     'movable-view': import('./components.d.ts').MovableViewProps;

package/package.json

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