@doubao-dev/framework 0.0.38-canary-1b929937-20260722020207

package/dist/components.d.ts

@@ -0,0 +1,4504 @@
+import type { BaseEvent } from '@lynx-js/types';
+import type { BaseGesture } from '@byted-lynx/gesture-runtime';
+import { ContentSizeChangedEvent } from '@lynx-js/types';
+import type { CSSProperties } from '@lynx-js/types';
+import type { CSSProperties as CSSProperties_2 } from '@byted-lynx/type-lynx';
+import type { ErrorEvent as ErrorEvent_2 } from '@lynx-js/types';
+import type { ForwardedRef } from '@byted-lynx/react';
+import type { ForwardRefExoticComponent } from 'react';
+import type { InputBlurEvent } from '@lynx-js/types';
+import type { InputConfirmEvent } from '@lynx-js/types';
+import type { InputFocusEvent } from '@lynx-js/types';
+import type { InputInputEvent } from '@lynx-js/types';
+import type { InputSelectionEvent } from '@lynx-js/types';
+import type { LayoutChangeEvent } from '@lynx-js/types';
+import type { LayoutEvent } from '@lynx-js/types';
+import { ListAttachedCell } from '@lynx-js/types';
+import { ListItemInfo } from '@lynx-js/types';
+import type { ListItemSnapAlignment } from '@lynx-js/types';
+import { ListLayoutCompleteEvent } from '@lynx-js/types';
+import { ListLayoutCompleteInfo } from '@lynx-js/types';
+import { ListScrollEvent } from '@lynx-js/types';
+import { ListScrollInfo } from '@lynx-js/types';
+import { ListScrollState } from '@lynx-js/types';
+import { ListScrollStateChangeEvent } from '@lynx-js/types';
+import { ListScrollStateInfo } from '@lynx-js/types';
+import { ListScrollToLowerEvent } from '@lynx-js/types';
+import { ListScrollToUpperEvent } from '@lynx-js/types';
+import { ListSnapEvent } from '@lynx-js/types';
+import { ListSnapInfo } from '@lynx-js/types';
+import type { LoadEvent } from '@lynx-js/types';
+import type { NodesRef } from '@lynx-js/types';
+import type { ReactElement } from '@byted-lynx/react';
+import type { ReactElement as ReactElement_2 } from 'react';
+import type { ReactNode } from 'react';
+import type { Ref } from 'react';
+import type { RefAttributes } from 'react';
+import { ScrollEndEvent } from '@lynx-js/types';
+import { ScrollEvent } from '@lynx-js/types';
+import { ScrollToLowerEvent } from '@lynx-js/types';
+import { ScrollToUpperEvent } from '@lynx-js/types';
+import type { SelectionChangeEvent } from '@lynx-js/types';
+import type { TextAreaBlurEvent } from '@lynx-js/types';
+import type { TextAreaConfirmEvent } from '@lynx-js/types';
+import type { TextAreaFocusEvent } from '@lynx-js/types';
+import type { TextAreaInputEvent } from '@lynx-js/types';
+import type { TextAreaSelectionChangeEvent } from '@lynx-js/types';
+import type { TouchEvent as TouchEvent_2 } from '@lynx-js/types';
+import type { UIAppearanceEvent } from '@lynx-js/types';
+import type { XOverlayNGProps } from '@byted-lynx/type-lynx';
+
+export declare interface AgreePrivacyResult {
+    /** Whether the save was successful */
+    result: boolean;
+}
+
+export declare interface Arc {
+    /**
+     * 弧线 id。
+     */
+    id: string;
+    /**
+     * 弧线起始点。
+     */
+    start: LatLng;
+    /**
+     * 弧线中间点（用于控制弧度）。
+     */
+    middle: LatLng;
+    /**
+     * 弧线终点。
+     */
+    end: LatLng;
+    /**
+     * 弧线宽度。
+     */
+    width?: number;
+    /**
+     * 弧线颜色，支持 HEX, RGBA, 颜色别名。
+     * @defaultValue "#0066ff"
+     */
+    color?: string;
+    /**
+     * 设置弧线 Z 轴数值。
+     * @defaultValue 0
+     */
+    zIndex?: number;
+}
+
+declare interface BounceConfig {
+    /**
+     * 是否启用回弹效果，当 loop 为 true 时忽略此设置
+     * @defaultValue false
+     */
+    enable?: boolean;
+    /**
+     * 左侧回弹项（水平方向时）
+     */
+    startBounceItem?: ReactElement_2;
+    /**
+     * 右侧回弹项（水平方向时）
+     */
+    endBounceItem?: ReactElement_2;
+    /**
+     * 当 startBounceItem 处于回弹状态时，释放手指将调用此函数
+     */
+    onStartBounceItemBounce?: (bounceParams: onBounceParams) => void;
+    /**
+     * 当 endBounceItem 处于回弹状态时，释放手指将调用此函数
+     */
+    onEndBounceItemBounce?: (bounceParams: onBounceParams) => void;
+    /**
+     * 回弹项的宽度
+     * @defaultValue 100
+     */
+    startBounceItemWidth?: number;
+    /**
+     * 回弹项的宽度
+     * @defaultValue 100
+     */
+    endBounceItemWidth?: number;
+}
+
+/**
+ * 按钮组件。
+ *
+ * ## CSS 继承原则
+ *
+ * 由于 Lynx 组件不开启 CSS 继承，Button 的文本样式不会自动应用到 children。
+ * 因此提供了以下明确的 API 用法：
+ *
+ * - `text` prop：传入字符串，按钮会应用默认文本样式
+ * - `icon` + `text` prop：组合使用，显示图标和文字
+ * - `children`：完全自定义内容，**不会**应用按钮的默认文本样式
+ *
+ *
+ * ## 使用建议
+ *
+ * ```tsx
+ * // 简单文字：用 text prop（推荐）
+ * <Button text="确定" />
+ *
+ * // 图标+文字：用 icon + text
+ * <Button icon={<Icon />} text="提交" />
+ *
+ * // 完全自定义：用 children（无默认样式）
+ * <Button>
+ *   <text style={{ color: 'red' }}>自定义</text>
+ * </Button>
+ * ```
+ */
+export declare interface ButtonProps {
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 按钮文字
+     */
+    text?: string;
+    /**
+     * 按钮尺寸
+     * @defaultValue 'default'
+     */
+    size?: ButtonSize;
+    /**
+     * 按钮样式类型
+     * @defaultValue 'primary'
+     */
+    type?: ButtonType;
+    /**
+     * 是否禁用
+     * @defaultValue false
+     */
+    disabled?: boolean;
+    /**
+     * 是否展示组件内置的禁用态样式
+     * @defaultValue true
+     */
+    showDisabledStyle?: boolean;
+    /**
+     * 是否显示加载状态
+     * @defaultValue false
+     */
+    loading?: boolean;
+    /**
+     * 图标，显示在文字前面
+     */
+    icon?: ReactNode;
+    /**
+     * 子元素，用于自定义内容。当同时提供 icon/text 和 children 时，children 优先。
+     */
+    children?: ReactNode;
+    /**
+     * onClick 的节流时间，单位为毫秒
+     * @defaultValue 500
+     */
+    throttle?: number;
+    /**
+     * 开放能力类型
+     */
+    openType?: 'getPhoneNumber' | 'agreePrivacyAuthorization' | 'agreePrivacyAuthorization|getPhoneNumber';
+    /**
+     * 点击回调函数
+     * @eventProperty
+     */
+    onClick?: (event?: TouchEvent_2) => void;
+    /**
+     * 禁用状态下的点击回调函数
+     * @eventProperty
+     */
+    onDisabledClick?: (event?: TouchEvent_2) => void;
+    /**
+     * 获取用户手机号回调，只在 openType="getPhoneNumber" 时有效
+     * @eventProperty
+     */
+    onGetPhoneNumber?: (result?: GetPhoneNumberResult) => void;
+    /**
+     * 授权隐私协议回调，只在 openType="agreePrivacyAuthorization" 时有效
+     * @eventProperty
+     */
+    onAgreePrivacyAuthorization?: (result?: AgreePrivacyResult) => void;
+}
+
+declare type ButtonSize = 'default' | 'medium' | 'mini';
+
+declare type ButtonType = 'primary' | 'default' | 'plain';
+
+declare interface Canvas2DContext extends CanvasRenderingContext2D {
+    drawImage(image: DrawImageSource, dx: number, dy: number): void;
+    drawImage(image: DrawImageSource, dx: number, dy: number, dw: number, dh: number): void;
+    drawImage(image: DrawImageSource, sx: number, sy: number, sw: number, sh: number, dx: number, dy: number, dw: number, dh: number): void;
+}
+
+export declare interface CanvasElement {
+    width: number;
+    height: number;
+    getContext: ((ctx: '2d') => CanvasRenderingContext2D | null) & ((ctx: 'webgl', contextAttributes?: Record<string, unknown>) => WebGLRenderingContext | null) & ((ctx: 'webgl2', contextAttributes?: Record<string, unknown>) => WebGL2RenderingContext | null);
+    toDataURL: (type?: string, encoderOptions?: number) => string;
+    attachToCanvasView: (name: string) => boolean;
+    detachFromCanvasView: () => void;
+    addEventListener: (event: 'resize', listener: (event: CanvasResizeEvent) => void, options?: AddEventListenerOptions | boolean) => void;
+    removeEventListener: (event: 'resize', listener: (event: CanvasResizeEvent) => void, options?: EventListenerOptions | boolean) => void;
+}
+
+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;
+}
+
+/**
+ * 画布组件，提供 2D/WebGL 绘图上下文，用于图形绘制、动画渲染等场景。
+ */
+export declare interface CanvasProps {
+    /**
+     * Canvas 实例引用，用于获取绘图上下文。
+     */
+    ref?: Ref<CanvasRef>;
+    /**
+     * 有手势事件绑定时，禁止屏幕滚动及下拉刷新
+     * @defaultValue false
+     */
+    disableScroll?: boolean;
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 元素的唯一标识
+     */
+    id?: string;
+    /**
+     * 手指触摸动作开始
+     * @eventProperty
+     */
+    onTouchStart?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onTouchStart 替代
+     */
+    bindtouchstart?: (event: TouchEvent_2) => void;
+    /**
+     * 手指触摸后移动
+     * @eventProperty
+     */
+    onTouchMove?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onTouchMove 替代
+     */
+    bindtouchmove?: (event: TouchEvent_2) => void;
+    /**
+     * 手指触摸动作结束
+     * @eventProperty
+     */
+    onTouchEnd?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onTouchEnd 替代
+     */
+    bindtouchend?: (event: TouchEvent_2) => void;
+    /**
+     * 手指触摸动作被打断，如来电提醒，弹窗
+     * @eventProperty
+     */
+    onTouchCancel?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onTouchCancel 替代
+     */
+    bindtouchcancel?: (event: TouchEvent_2) => void;
+    /**
+     * 手指长按 500ms 之后触发，触发了长按事件后进行移动不会触发屏幕的滚动
+     * @eventProperty
+     */
+    onLongPress?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onLongPress 替代
+     */
+    bindlongpress?: (event: TouchEvent_2) => void;
+    /**
+     * 当发生错误时触发 error 事件，detail = {errMsg}
+     * @eventProperty
+     */
+    onError?: (event: {
+        detail: {
+            errMsg: string;
+        };
+    }) => void;
+    /**
+     * @deprecated 请使用 onError 替代
+     */
+    binderror?: (event: {
+        detail: {
+            errMsg: string;
+        };
+    }) => void;
+}
+
+export declare interface CanvasRef {
+    /**
+     * 同步获取绘图上下文
+     */
+    getContext: {
+        (contextType: '2d'): Canvas2DContext | null;
+        (contextType: 'webgl', contextAttributes?: WebGLContextAttributes_2): WebGLRenderingContext | null;
+        (contextType: 'webgl2', contextAttributes?: WebGLContextAttributes_2): WebGL2RenderingContext | null;
+    };
+    /**
+     * 创建图片对象，用于加载图片后绘制到画布
+     */
+    createImage: () => CanvasImage | undefined;
+    /**
+     * 导出画布内容为 data URI
+     */
+    toDataURL: (type?: string, encoderOptions?: number) => Promise<string>;
+    /**
+     * 在下次重绘之前调用指定的回调函数
+     */
+    requestAnimationFrame: (callback: FrameRequestCallback) => number;
+    /**
+     * 取消由 requestAnimationFrame 添加的动画帧请求
+     */
+    cancelAnimationFrame: (id: number) => void;
+    /**
+     * 创建与画布同尺寸的空白 ImageData 对象，仅支持 2D 上下文
+     */
+    createImageData: () => Promise<ImageData>;
+    /**
+     * 画布宽度（buffer 像素数），写入时会清空画布内容
+     */
+    width: number;
+    /**
+     * 画布高度（buffer 像素数），写入时会清空画布内容
+     */
+    height: number;
+}
+
+export declare interface CanvasResizeEvent {
+    width: number;
+    height: number;
+}
+
+export declare interface Circle {
+    id: string;
+    center: LatLng;
+    /**
+     * 圆半径。
+     */
+    radius: number;
+    /**
+     * 圆环宽度。
+     */
+    strokeWidth?: number;
+    /**
+     * 圆环颜色。
+     */
+    strokeColor?: string;
+    /**
+     * 圆形填充色。
+     */
+    fillColor?: string;
+    /**
+     * 设置圆 Z 轴数值。
+     * @defaultValue 0
+     */
+    zIndex?: number;
+}
+
+export { ContentSizeChangedEvent }
+
+export declare const DoubaoPaymentButton: typeof DoubaoPaymentButton_2;
+
+declare const DoubaoPaymentButton_2: DoubaoPaymentButton_3;
+
+declare type DoubaoPaymentButton_3 = ForwardRefExoticComponent<DoubaoPaymentButtonProps_2 & RefAttributes<NodesRef>>;
+
+/**
+ * 支付按钮组件。
+ *
+ * 根据订单是否支持免密支付，自动渲染普通支付或免密支付单按钮。
+ * 其中免密支付按钮文案来自平台接口返回的 signInfo。
+ */
+export declare interface DoubaoPaymentButtonProps {
+    /**
+     * 动态获取订单 ID。
+     *
+     * 点击支付按钮后调用，可在回调内创建订单并返回订单 ID。
+     */
+    getOrderId: GetDoubaoPaymentOrderId;
+    /**
+     * 支付金额，单位为分。
+     */
+    amount: number;
+    /**
+     * 按钮样式。
+     */
+    style?: CSSProperties;
+    /**
+     * 按钮类名。
+     */
+    className?: string;
+    /**
+     * 是否禁用支付按钮。
+     * @defaultValue false
+     */
+    disabled?: boolean;
+    /**
+     * 是否显示加载态。
+     * @defaultValue false
+     */
+    loading?: boolean;
+    /**
+     * 是否展示内置禁用态样式。
+     * @defaultValue true
+     */
+    showDisabledStyle?: boolean;
+    /**
+     * 禁用态点击回调。
+     */
+    onDisabledClick?: (event?: TouchEvent_2) => void;
+    /**
+     * 点击节流时间，单位为毫秒。
+     * @defaultValue 500
+     */
+    throttle?: number;
+    /**
+     * 支付完成后的统一回调。
+     * 成功时返回 result，失败时返回 error。
+     */
+    onPaymentResult?: (payload: DoubaoPaymentResultPayload_2) => void;
+}
+
+/**
+ * 支付按钮组件。
+ *
+ * 根据订单是否支持免密支付，自动渲染普通支付或免密支付单按钮。
+ * 其中免密支付按钮文案来自平台接口返回的 signInfo。
+ */
+declare interface DoubaoPaymentButtonProps_2 {
+    /**
+     * 动态获取订单 ID。
+     *
+     * 点击支付按钮后调用，可在回调内创建订单并返回订单 ID。
+     */
+    getOrderId: GetDoubaoPaymentOrderId_2;
+    /**
+     * 支付金额，单位为分。
+     */
+    amount: number;
+    /**
+     * 按钮样式。
+     */
+    style?: CSSProperties;
+    /**
+     * 按钮类名。
+     */
+    className?: string;
+    /**
+     * 是否禁用支付按钮。
+     * @defaultValue false
+     */
+    disabled?: boolean;
+    /**
+     * 是否显示加载态。
+     * @defaultValue false
+     */
+    loading?: boolean;
+    /**
+     * 是否展示内置禁用态样式。
+     * @defaultValue true
+     */
+    showDisabledStyle?: boolean;
+    /**
+     * 禁用态点击回调。
+     */
+    onDisabledClick?: (event?: TouchEvent_2) => void;
+    /**
+     * 点击节流时间，单位为毫秒。
+     * @defaultValue 500
+     */
+    throttle?: number;
+    /**
+     * 支付完成后的统一回调。
+     * 成功时返回 result，失败时返回 error。
+     */
+    onPaymentResult?: (payload: DoubaoPaymentResultPayload) => void;
+}
+
+declare type DoubaoPaymentMode = 'normal' | 'password-free';
+
+declare type DoubaoPaymentMode_2 = 'normal' | 'password-free';
+
+declare interface DoubaoPaymentResult {
+    orderId: string;
+    logId: string;
+}
+
+declare interface DoubaoPaymentResult_2 {
+    orderId: string;
+    logId: string;
+}
+
+declare interface DoubaoPaymentResultPayload {
+    mode: DoubaoPaymentMode;
+    result?: DoubaoPaymentResult;
+    error?: unknown;
+}
+
+declare interface DoubaoPaymentResultPayload_2 {
+    mode: DoubaoPaymentMode_2;
+    result?: DoubaoPaymentResult_2;
+    error?: unknown;
+}
+
+declare type DrawImageSource = CanvasImageSource | CanvasImage | OffscreenCanvas_2;
+
+export declare type GetDoubaoPaymentOrderId = (mode?: DoubaoPaymentMode_2) => string | Promise<string>;
+
+declare type GetDoubaoPaymentOrderId_2 = (mode?: DoubaoPaymentMode) => string | Promise<string>;
+
+export declare interface GetPhoneNumberResult {
+    code?: string;
+    message?: string;
+}
+
+declare interface HeightPercent {
+    /**
+     * The init offset percentage or absolute value (e.g. "200px") that the popup, base line is maxHeight
+     * @zh 弹窗的初始偏移百分比或绝对值（例如 "200px"），基准线是 maxHeight   * @defaultValue 60
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    init: number | `${number}px` | `${number}%` | `${number}rpx`;
+    /**
+     * The maximum offset percentage or absolute value (e.g. "400px") that the popup can drag, base line is maxHeight
+     * @zh 弹窗可拖动的最大偏移百分比或绝对值（例如 "400px"），基准线是 maxHeight
+     * @defaultValue 100
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    top: number | `${number}px` | `${number}%` | `${number}rpx`;
+    /**
+     * The minimum offset percentage or absolute value (e.g. "0px") that the popup can drag, base line is maxHeight
+     * @zh 弹窗可拖动的最小偏移百分比或绝对值（例如 "0px"），基准线是 maxHeight
+     * @defaultValue 0
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    bottom?: number | `${number}px` | `${number}%` | `${number}rpx`;
+    /**
+     * The boundary offset percentage or absolute value (e.g., "20px") for the popup's non-inertial slide release rebound. When the non-inertial slide release rebound area is within position - boundaryArea to + boundaryArea, it will trigger a rebound back to the current position; otherwise, it will move to the next position. The baseline is maxHeight.
+     * @zh 弹窗无惯性滑动的松手回弹的边界偏移百分比或绝对值（例如 "20px"），当无惯性滑动松手回弹的区域在position - boundaryArea / + boundaryArea 之间时，会触发回弹到当前的position为止，否则会进入下一个位置，基准线是 maxHeight
+     * @defaultValue 10
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    boundaryArea?: number | `${number}px` | `${number}%` | `${number}rpx`;
+    /**
+     * The speed threshold for inertial sliding rebound. When the release speed is greater than this value, it will slide to the next position; when less than this value, it will rebound to the current position
+     * @zh 惯性滑动回弹阈值：弹窗有惯性滑动时的速度阈值，当松手大于该速度时会滑动到下一个position，当小于该速度时会回弹至当前的position
+     * @defaultValue 5(px/s)
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    flingThreshold?: number;
+}
+
+/**
+ * 图片展示组件，支持加载本地或网络图片资源，提供多种裁剪和缩放模式。
+ */
+export declare interface ImageProps {
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 元素的唯一标识
+     */
+    id?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 用于获取组件实例的 ref
+     */
+    ref?: Ref<NodesRef>;
+    /**
+     * 图片资源地址，支持 http/https/base64
+     */
+    src: string;
+    /**
+     * 图片裁剪、缩放模式
+     * @defaultValue 'scaleToFill'
+     */
+    mode?: 'scaleToFill' | 'aspectFit' | 'aspectFill' | 'center';
+    /**
+     * 占位图地址，用法同 src
+     */
+    placeholder?: string;
+    /**
+     * 是否在加载成功后自动调整图片尺寸为原图大小
+     * @defaultValue false
+     */
+    autoSize?: boolean;
+    /**
+     * 是否扁平化元素，避免创建真实渲染对象以提升性能。
+     *
+     * Android 上默认图片链路会受到 Fresco / OpenGL 纹理尺寸限制影响，
+     * 超过限制的图片可能按分辨率逐轮除 2 降采样。设置 `flatten={false}`
+     * 会走 Lynx 自定义解码链路，将默认限制替换为约 3379 x 3379
+     * （厂商未修改时），能在一定程度上缓解大图被过度降采样的问题。
+     * @defaultValue true
+     */
+    flatten?: boolean;
+    /**
+     * 是否启用降采样。
+     *
+     * 仅建议在确认图片分辨率可控时设置 `subsample={false}`。
+     * `flatten={false} & subsample={false}` 会关闭尺寸限制和降采样逻辑，
+     * 可能显著增加解码内存峰值，超大图片存在 OOM 风险。
+     * @defaultValue true
+     */
+    subsample?: boolean;
+    /**
+     * 图片加载成功时触发，事件对象中包含图片宽高信息
+     * @eventProperty
+     */
+    onLoad?: (event: LoadEvent) => void;
+    /**
+     * @deprecated 请使用 onLoad 替代
+     */
+    bindload?: (event: LoadEvent) => void;
+    /**
+     * 图片加载失败时触发，事件对象中包含错误信息
+     * @eventProperty
+     */
+    onError?: (event: ErrorEvent_2) => void;
+    /**
+     * @deprecated 请使用 onError 替代
+     */
+    binderror?: (event: ErrorEvent_2) => void;
+    /**
+     * 点击时的回调函数
+     * @eventProperty
+     */
+    onClick?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onClick 替代
+     */
+    bindtap?: (event: TouchEvent_2) => void;
+    /**
+     * 点击时的回调函数（阻止事件冒泡）
+     * @eventProperty
+     */
+    onCatchTap?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onCatchTap 替代
+     */
+    catchtap?: (event: TouchEvent_2) => void;
+    /**
+     * 长按时的回调函数
+     * @eventProperty
+     */
+    onLongPress?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onLongPress 替代
+     */
+    bindlongpress?: (event: TouchEvent_2) => void;
+    /**
+     * 触摸开始时的回调函数
+     * @eventProperty
+     */
+    onTouchStart?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onTouchStart 替代
+     */
+    bindtouchstart?: (event: TouchEvent_2) => void;
+    /**
+     * 触摸结束时的回调函数
+     * @eventProperty
+     */
+    onTouchEnd?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onTouchEnd 替代
+     */
+    bindtouchend?: (event: TouchEvent_2) => void;
+    /**
+     * 触摸移动时的回调函数
+     * @eventProperty
+     */
+    onTouchMove?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onTouchMove 替代
+     */
+    bindtouchmove?: (event: TouchEvent_2) => void;
+    /**
+     * 元素曝光时的回调函数（进入可视区域）
+     * @eventProperty
+     */
+    onAppear?: (event: UIAppearanceEvent) => void;
+    /**
+     * @deprecated 请使用 onAppear 替代
+     */
+    binduiappear?: (event: UIAppearanceEvent) => void;
+    /**
+     * 元素消失时的回调函数（离开可视区域）
+     * @eventProperty
+     */
+    onDisappear?: (event: UIAppearanceEvent) => void;
+    /**
+     * @deprecated 请使用 onDisappear 替代
+     */
+    binduidisappear?: (event: UIAppearanceEvent) => void;
+    /**
+     * 布局变化时的回调函数
+     * @eventProperty
+     */
+    onLayoutChange?: (event: LayoutChangeEvent) => void;
+    /**
+     * @deprecated 请使用 onLayoutChange 替代
+     */
+    bindlayoutchange?: (event: LayoutChangeEvent) => void;
+}
+
+/**
+ * 单行文本输入组件，支持多种输入类型（文本、数字、密码等）及受控/非受控模式。
+ */
+export declare interface InputProps {
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 元素的唯一标识
+     */
+    id?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 用于获取组件实例的 ref
+     */
+    ref?: Ref<InputRef>;
+    /**
+     * 占位符文本
+     */
+    placeholder?: string;
+    /**
+     * 输入类型
+     * @defaultValue 'text'
+     */
+    type?: 'text' | 'number' | 'digit' | 'password' | 'tel' | 'email';
+    /**
+     * 最大输入长度
+     * @defaultValue 140
+     */
+    maxlength?: number;
+    /**
+     * 是否禁用
+     * @defaultValue false
+     */
+    disabled?: boolean;
+    /**
+     * 是否只读
+     * @defaultValue false
+     */
+    readonly?: boolean;
+    /**
+     * 输入框的当前值，用于受控组件
+     */
+    value?: string;
+    /**
+     * 输入框的默认值，用于非受控组件
+     */
+    defaultValue?: string;
+    /**
+     * 键盘右下角确认按钮的类型
+     * @defaultValue 'send'
+     */
+    confirmType?: 'send' | 'search' | 'go' | 'done' | 'next';
+    /**
+     * 聚焦时是否显示软键盘
+     * @defaultValue true
+     */
+    showSoftInputOnFocus?: boolean;
+    /**
+     * 输入内容变化时触发
+     * @eventProperty
+     */
+    onInput?: (event: BaseEvent<'bindinput', InputInputEvent>) => void;
+    /**
+     * @deprecated 请使用 onInput 替代
+     */
+    bindinput?: (event: BaseEvent<'bindinput', InputInputEvent>) => void;
+    /**
+     * 聚焦时触发
+     * @eventProperty
+     */
+    onFocus?: (event: BaseEvent<'bindfocus', InputFocusEvent>) => void;
+    /**
+     * @deprecated 请使用 onFocus 替代
+     */
+    bindfocus?: (event: BaseEvent<'bindfocus', InputFocusEvent>) => void;
+    /**
+     * 失焦时触发
+     * @eventProperty
+     */
+    onBlur?: (event: BaseEvent<'bindblur', InputBlurEvent>) => void;
+    /**
+     * @deprecated 请使用 onBlur 替代
+     */
+    bindblur?: (event: BaseEvent<'bindblur', InputBlurEvent>) => void;
+    /**
+     * 点击键盘确认按钮时触发
+     * @eventProperty
+     */
+    onConfirm?: (event: BaseEvent<'bindconfirm', InputConfirmEvent>) => void;
+    /**
+     * @deprecated 请使用 onConfirm 替代
+     */
+    bindconfirm?: (event: BaseEvent<'bindconfirm', InputConfirmEvent>) => void;
+    /**
+     * 选择区域变化时触发
+     * @eventProperty
+     */
+    onSelectionChange?: (event: BaseEvent<'bindselection', InputSelectionEvent>) => void;
+    /**
+     * @deprecated 请使用 onSelectionChange 替代
+     */
+    bindselection?: (event: BaseEvent<'bindselection', InputSelectionEvent>) => void;
+}
+
+/**
+ * Input 组件暴露的方法
+ */
+export declare interface InputRef {
+    /**
+     * 设置输入框的值
+     */
+    setValue: (value: string) => Promise<void>;
+    /**
+     * 获取输入框的值和选择区域
+     */
+    getValue: () => Promise<{
+        value: string;
+        selectionStart: number;
+        selectionEnd: number;
+    }>;
+    /**
+     * 聚焦输入框
+     */
+    focus: () => Promise<void>;
+    /**
+     * 失焦输入框
+     */
+    blur: () => Promise<void>;
+    /**
+     * 设置选择区域
+     */
+    setSelectionRange: (selectionStart: number, selectionEnd: number) => Promise<void>;
+}
+
+export declare type LatLng = {
+    latitude: number;
+    longitude: number;
+};
+
+export { ListAttachedCell }
+
+export { ListItemInfo }
+
+export { ListLayoutCompleteEvent }
+
+export { ListLayoutCompleteInfo }
+
+/**
+ * 高性能列表组件，适用于渲染大量数据，支持垂直滚动和按需渲染。
+ */
+export declare interface ListProps {
+    /**
+     * 子元素
+     */
+    children?: ReactNode;
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 元素的唯一标识
+     */
+    id?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 用于获取组件实例的 ref
+     */
+    ref?: Ref<NodesRef>;
+    /**
+     * 滚动方向和布局方向
+     * @defaultValue 'vertical'
+     */
+    scrollOrientation?: 'vertical' | 'horizontal';
+    /**
+     * 列表的列数或行数，仅当 listType 为 'flow' 或 'waterfall' 时有效
+     * @defaultValue 1
+     */
+    spanCount?: number;
+    /**
+     * 列表的布局类型
+     * @defaultValue 'single'
+     */
+    listType?: 'single' | 'flow' | 'waterfall';
+    /**
+     * 是否允许滚动
+     * @defaultValue true
+     */
+    enableScroll?: boolean;
+    /**
+     * 是否支持嵌套滚动
+     * @defaultValue false
+     */
+    enableNestedScroll?: boolean;
+    /**
+     * 是否允许列表整体吸顶或吸底
+     * @defaultValue false
+     */
+    sticky?: boolean;
+    /**
+     * 吸顶或吸底时的偏移距离（px）
+     * @defaultValue 0
+     */
+    stickyOffset?: number;
+    /**
+     * 是否启用弹性效果（iOS 回弹效果）
+     * @defaultValue true
+     */
+    bounces?: boolean;
+    /**
+     * 列表渲染后自动滚动到的节点位置
+     * @defaultValue 0
+     */
+    initialScrollIndex?: number;
+    /**
+     * 是否在滚动事件回调参数中包含当前渲染节点的位置信息
+     * @defaultValue false
+     */
+    needVisibleItemInfo?: boolean;
+    /**
+     * 触发滚动到底部的剩余子节点数量阈值
+     * @defaultValue 0
+     */
+    lowerThresholdItemCount?: number;
+    /**
+     * 触发滚动到顶部的剩余子节点数量阈值
+     * @defaultValue 0
+     */
+    upperThresholdItemCount?: number;
+    /**
+     * 滚动事件的回调频率（ms）
+     * @defaultValue 200
+     */
+    scrollEventThrottle?: number;
+    /**
+     * 启用分页效果
+     */
+    itemSnap?: ListItemSnapAlignment;
+    /**
+     * layoutcomplete 事件是否包含布局信息
+     * @defaultValue false
+     */
+    needLayoutCompleteInfo?: boolean;
+    /**
+     * 数据源更新的唯一标识，会在 layoutcomplete 事件中返回
+     * @defaultValue -1
+     */
+    layoutId?: number;
+    /**
+     * 列表外预加载的节点数量
+     * @defaultValue 0
+     */
+    preloadBufferCount?: number;
+    /**
+     * 是否显示滚动条
+     */
+    scrollBarEnable?: boolean;
+    /**
+     * 是否回收吸顶元素
+     */
+    experimentalRecycleStickyItem?: boolean;
+    /**
+     * 滚动事件
+     * @eventProperty
+     */
+    onScroll?: (event: ListScrollEvent) => void;
+    /**
+     * 滚动到顶部时触发
+     * @eventProperty
+     */
+    onScrollToUpper?: (event: ListScrollToUpperEvent) => void;
+    /**
+     * 滚动到底部时触发
+     * @eventProperty
+     */
+    onScrollToLower?: (event: ListScrollToLowerEvent) => void;
+    /**
+     * 滚动状态变化时触发
+     * @eventProperty
+     */
+    onScrollStateChange?: (event: ListScrollStateChangeEvent) => void;
+    /**
+     * 首屏渲染完成时触发
+     * @eventProperty
+     */
+    onLayoutComplete?: (event: ListLayoutCompleteEvent) => void;
+    /**
+     * 分页滚动回调
+     * @eventProperty
+     */
+    onSnap?: (event: ListSnapEvent) => void;
+}
+
+export { ListScrollEvent }
+
+export { ListScrollInfo }
+
+export { ListScrollState }
+
+export { ListScrollStateChangeEvent }
+
+export { ListScrollStateInfo }
+
+export { ListScrollToLowerEvent }
+
+export { ListScrollToUpperEvent }
+
+export { ListSnapEvent }
+
+export { ListSnapInfo }
+
+export declare type LongImageActiveRange = {
+    /**
+     * 当前激活解码窗口起始分段索引（含）。
+     */
+    start: number;
+    /**
+     * 当前激活解码窗口结束分段索引（含）。
+     */
+    end: number;
+};
+
+export declare type LongImageMetrics = {
+    /**
+     * 容器实际渲染宽度（px）。
+     */
+    displayWidth: number;
+    /**
+     * 原图宽度（px）。
+     */
+    imageWidth: number;
+    /**
+     * 原图高度（px）。
+     */
+    imageHeight: number;
+    /**
+     * 单个分段在原图坐标系中的解码高度（px）。
+     */
+    segmentSrcHeight: number;
+    /**
+     * 总分段数量。
+     */
+    segmentCount: number;
+    /**
+     * 当前激活解码窗口起始分段索引（含）。
+     * 空窗口时固定为 0。
+     */
+    activeStartIndex: number;
+    /**
+     * 当前激活解码窗口结束分段索引（含）。
+     * 空窗口时固定为 -1。
+     */
+    activeEndIndex: number;
+    /**
+     * 当前激活解码窗口内分段数量。
+     */
+    activeSegmentCount: number;
+};
+
+export declare type LongImagePhase = 'idle' | 'measuring' | 'loading-meta' | 'ready' | 'error';
+
+/**
+ * 长图加载与展示组件，支持分段懒加载，适用于超长图片的高性能渲染。
+ */
+export declare interface LongImageProps {
+    /**
+     * 图片资源地址。
+     */
+    src: string;
+    /**
+     * 元素唯一标识。未传时内部自动生成。
+     */
+    id?: string;
+    /**
+     * 手动重建分段与解码窗口的触发令牌。值变化时会重新初始化。
+     * @defaultValue 0
+     */
+    reloadToken?: number;
+    /**
+     * 单段在展示坐标系下的目标高度（px）。
+     * 值越大，单次解码像素越大；值越小，分段数量越多。
+     * @defaultValue 600
+     */
+    segmentDisplayHeight?: number;
+    /**
+     * 解码窗口的预加载屏数，基于当前可视区域高度计算。
+     * @defaultValue 1
+     */
+    decodeOverscanScreens?: number;
+    /**
+     * 解码窗口允许同时激活的最大分段数。
+     * 用于控制单次内存峰值。
+     * @defaultValue 8
+     */
+    maxActiveSegments?: number;
+    /**
+     * 滚动事件回调节流时间（ms）。
+     * @defaultValue 60
+     */
+    scrollEventThrottle?: number;
+    /**
+     * 非激活分段占位背景色。
+     * @defaultValue 'transparent'
+     */
+    placeholderColor?: string;
+    /**
+     * 组件样式。
+     * - `style.height`：建议显式指定；未指定时默认使用 `100vh`。
+     * - `style.width`：未指定时默认使用 `100%`。
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名。
+     */
+    className?: string;
+    /**
+     * 指标回调，输出尺寸和当前激活窗口信息。
+     */
+    onMetricsChange?: (metrics: LongImageMetrics) => void;
+    /**
+     * 状态回调，输出阶段与错误信息。
+     */
+    onStateChange?: (state: LongImageState) => void;
+}
+
+export declare type LongImageScrollEventLike = {
+    detail?: {
+        scrollTop?: number;
+        listHeight?: number;
+    };
+    scrollTop?: number;
+    listHeight?: number;
+};
+
+export declare type LongImageSegmentData = {
+    /**
+     * 分段唯一标识。
+     */
+    id: string;
+    /**
+     * 分段索引（0-based）。
+     */
+    index: number;
+    /**
+     * 分段在原图中的起始 y 坐标（px）。
+     */
+    y: number;
+    /**
+     * 分段在原图中的解码高度（px）。
+     */
+    height: number;
+    /**
+     * 分段在展示坐标系中的高度（px）。
+     */
+    displayHeight: number;
+    /**
+     * 分段在展示坐标系中的顶部位置（px）。
+     */
+    displayTop: number;
+    /**
+     * 分段在展示坐标系中的底部位置（px）。
+     */
+    displayBottom: number;
+};
+
+/**
+ * 长图的单个渲染分段，配合 LongImage 使用。
+ */
+export declare interface LongImageSegmentProps {
+    /**
+     * 图片资源地址。
+     */
+    src: string;
+    /**
+     * 分段数据。
+     */
+    segment: LongImageSegmentData;
+    /**
+     * 原图宽度（px）。
+     */
+    imageWidth: number;
+    /**
+     * 当前分段是否处于激活解码窗口内。
+     * 非激活分段只渲染占位节点，不触发区域解码。
+     * @defaultValue true
+     */
+    active?: boolean;
+    /**
+     * 非激活分段占位背景色。
+     * @defaultValue 'transparent'
+     */
+    placeholderColor?: string;
+    /**
+     * 分段样式。未指定时默认铺满父容器。
+     */
+    style?: CSSProperties;
+    /**
+     * 分段类名。
+     */
+    className?: string;
+}
+
+export declare type LongImageState = {
+    /**
+     * 当前状态阶段。
+     */
+    phase: 'idle' | 'measuring' | 'loading-meta' | 'ready';
+    /**
+     * 当前阶段对应的提示文案。
+     */
+    message: string;
+    /**
+     * 分段总数。
+     */
+    totalSegments: number;
+    /**
+     * 当前激活解码窗口起始分段索引（含）。
+     */
+    activeStartIndex: number;
+    /**
+     * 当前激活解码窗口结束分段索引（含）。
+     */
+    activeEndIndex: number;
+    /**
+     * 非错误阶段不返回 error 字段。
+     */
+    error?: never;
+} | {
+    /**
+     * 当前状态阶段。
+     */
+    phase: 'error';
+    /**
+     * 当前阶段对应的提示文案。
+     */
+    message: string;
+    /**
+     * 错误摘要。
+     */
+    error: string;
+    /**
+     * 分段总数。
+     */
+    totalSegments: number;
+    /**
+     * 当前激活解码窗口起始分段索引（含）。
+     */
+    activeStartIndex: number;
+    /**
+     * 当前激活解码窗口结束分段索引（含）。
+     */
+    activeEndIndex: number;
+};
+
+declare type Map_2 = ForwardRefExoticComponent<MapProps & RefAttributes<MapRef>>;
+export { Map_2 as Map }
+
+export declare type MapMarker = ForwardRefExoticComponent<MapMarkerProps & RefAttributes<MapMarkerRef>>;
+
+export declare interface MapMarkerAnimate {
+    /**
+     * 缩放动画。from / to 为缩放倍率，1 表示原始大小。
+     */
+    scale?: MapMarkerAnimationConfig;
+    /**
+     * 透明度动画。from / to 范围为 0-1。
+     */
+    alpha?: MapMarkerAnimationConfig;
+}
+
+export declare interface MapMarkerAnimationConfig {
+    /**
+     * 动画起始值。
+     * @defaultValue 1.0
+     */
+    from?: number;
+    /**
+     * 动画结束值。
+     * @defaultValue 1.0
+     */
+    to?: number;
+    /**
+     * 动画时长，单位 ms。
+     * @defaultValue 250
+     */
+    duration?: number;
+    /**
+     * 重复次数。0 表示不重复，-1 表示无限循环。
+     * @defaultValue 0
+     */
+    repeatCount?: number;
+}
+
+/**
+ * 地图标记点组件，作为 Map 的子组件使用，支持自定义图标和动画。
+ */
+export declare interface MapMarkerProps {
+    ref?: Ref<MapMarkerRef>;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 组件的样式。
+     */
+    style?: CSSProperties;
+    /**
+     * 标记点坐标。
+     */
+    position: LatLng;
+    /**
+     * 经纬度在标注图标的锚点。
+     */
+    anchor?: [number, number];
+    /**
+     * 标记点透明度。
+     */
+    alpha?: number;
+    /**
+     * 标记点旋转角度。
+     */
+    rotation?: number;
+    /**
+     * 标记点动画配置。多个动画属性会并行执行。
+     */
+    animate?: MapMarkerAnimate;
+    /**
+     * 标记点在自定义布局中的容器位置。
+     */
+    containerPosition?: {
+        x: number;
+        y: number;
+    };
+    /**
+     * 点击事件处理函数。
+     */
+    onClick?: () => void;
+    /**
+     * 标记点是否可点击，设为 false 时，点击标记点会触发地图的 onClick 事件。
+     * @defaultValue true
+     */
+    clickable?: boolean;
+    /**
+     * 标记点是否可拖拽。
+     * @defaultValue false
+     */
+    draggable?: boolean;
+    /**
+     * 标记点是否参与 POI 碰撞避让。
+     * @defaultValue false
+     */
+    enableCollideWithPoi?: boolean;
+    /**
+     * 标记点的自定义 UI 内容。**必填 - 必须提供自定义标记点 UI**
+     */
+    children: ReactNode;
+}
+
+export declare type MapMarkerRef = {
+    /**
+     * 刷新标记点样式。当自定义内容（children）样式变化时调用此方法更新。
+     */
+    refreshMarker: () => void;
+};
+
+/**
+ * 地图展示组件，支持标记点、路线、多边形等覆盖物，以及平移、缩放等交互。
+ */
+export declare interface MapProps {
+    ref?: Ref<MapRef>;
+    /**
+     * 组件的样式。
+     */
+    style?: CSSProperties;
+    /**
+     * 组件的类名。
+     */
+    className?: string;
+    /**
+     * 子元素。一般与 `<MapMarker />` 搭配使用。
+     */
+    children?: ReactNode;
+    /**
+     * 地图主题样式。
+     * @defaultValue "normal-light"
+     */
+    mapStyle?: 'normal-light' | 'normal-dark' | 'simple-light' | 'simple-dark';
+    /**
+     * 地图中心位置。
+     */
+    center?: LatLng;
+    /**
+     * 缩放级别，取值范围为 3-20。
+     * @defaultValue 16
+     */
+    scale?: number;
+    /**
+     * 最小缩放级别，取值范围为 3-20。
+     * @defaultValue 3
+     */
+    minScale?: number;
+    /**
+     * 最大缩放级别，取值范围为 3-20。
+     * @defaultValue 20
+     */
+    maxScale?: number;
+    /**
+     * 路线数组。
+     */
+    polyline?: Polyline[];
+    /**
+     * 路线标签数组。
+     */
+    routeLabel?: RouteLabel[];
+    /**
+     * 多边形数组。
+     */
+    polygons?: Polygon[];
+    /**
+     * 圆数组。
+     */
+    circles?: Circle[];
+    /**
+     * 弧线数组。
+     */
+    arcs?: Arc[];
+    /**
+     * 旋转角度。
+     * @defaultValue 0
+     */
+    rotate?: number;
+    /**
+     * 显示比例尺。
+     * @defaultValue false
+     */
+    showScale?: boolean;
+    /**
+     * 是否显示当前位置标记。开启后会调用定位 API 获取并监听当前位置变化，使用内置 marker 图标展示。
+     * @defaultValue false
+     */
+    showLocation?: boolean;
+    /**
+     * 地图logo位置。
+     * @defaultValue 'bottom-left'
+     */
+    logoPosition?: 'bottom-left' | 'bottom-center' | 'bottom-right' | 'top-left' | 'top-center' | 'top-right';
+    /**
+     * 是否允许缩放。
+     * @defaultValue true
+     */
+    enableScale?: boolean;
+    /**
+     * 是否允许拖动。
+     * @defaultValue true
+     */
+    enableDrag?: boolean;
+    /**
+     * 是否允许旋转。
+     * @defaultValue false
+     */
+    enableRotate?: boolean;
+    /**
+     * 是否允许倾斜。
+     * @defaultValue false
+     */
+    enableTilt?: boolean;
+    /**
+     * 是否允许原生交互。控制平台层触摸事件的处理，影响平台层手势。
+     * @defaultValue true
+     */
+    enableNativeInteraction?: boolean;
+    /**
+     * 点击地图时触发。
+     */
+    onClick?: (event: {
+        point: LatLng;
+    }) => void;
+    /**
+     * 地图加载完成时触发。
+     */
+    onMapLoaded?: () => void;
+    /**
+     * 视野发生变化时触发。
+     */
+    onRegionChange?: (event: {
+        type: 'begin' | 'end';
+        rotate?: number;
+        scale?: number;
+        center?: LatLng;
+        region?: {
+            northeast: LatLng;
+            southwest: LatLng;
+        };
+        causedBy?: 'drag' | 'scale';
+        triggeredBy?: 'user' | 'api';
+    }) => void;
+    /**
+     * 点击路线时触发。
+     */
+    onPolylineClick?: (event: {
+        id: string;
+    }) => void;
+}
+
+export declare interface MapRef {
+    /**
+     * 设置地图中心点。
+     */
+    setCenter: (center: LatLng, scale?: number, animationOptions?: MapViewportAnimationOptions) => void;
+    /**
+     * 获取当前地图中心位置。
+     */
+    getCenter: () => Promise<LatLng>;
+    /**
+     * 获取当前缩放级别。
+     */
+    getScale: () => Promise<number>;
+    /**
+     * 设置缩放级别。
+     */
+    setScale: (scale: number, animationOptions?: MapViewportAnimationOptions) => void;
+    /**
+     * 获取当前地图边界。
+     */
+    getBound: () => Promise<{
+        southwest: LatLng;
+        northeast: LatLng;
+    }>;
+    /**
+     * 设置地图边界。
+     */
+    setBound: (bounds: {
+        northeast: LatLng;
+        southwest: LatLng;
+    }, animationOptions?: MapViewportAnimationOptions) => void;
+    /**
+     * 使地图视图适合给定的点。
+     * @param points - 要适配的点数组
+     * @param padding - 点周围的内边距, 分别为左、右、上、下的内边距（像素，默认：[0, 0, 0, 0]）
+     * @param animationOptions - 地图视野变化动画配置
+     */
+    fitPoints: (points: LatLng[], padding?: number[], animationOptions?: MapViewportAnimationOptions) => void;
+    /**
+     * 设置地图锚点（地图坐标对齐的屏幕像素位置）。
+     * 默认情况下，setCenter() 将坐标对齐到视口中心。
+     * 调用 setAnchor(x, y) 后，setCenter() 会将坐标对齐到屏幕的 (x, y) 像素位置。
+     * @param position.x - 屏幕 x 坐标像素（0 = 左边缘）
+     * @param position.y - 屏幕 y 坐标像素（0 = 上边缘）
+     * @example
+     * // 将地图中心对齐到屏幕左上角
+     * setAnchor({ x: 0, y: 0 })
+     * // 将地图中心对齐到指定像素位置 (100, 100)
+     * setAnchor({ x: 100, y: 100 })
+     * // 重置为视口中心（假设地图为 500x500）
+     * setAnchor({ x: 250, y: 250 })
+     */
+    setAnchor: (position: {
+        x: number;
+        y: number;
+    }) => void;
+    /**
+     * 将地图经纬度转换为屏幕像素坐标。
+     */
+    latLngToPx: (latLng: LatLng) => Promise<{
+        x: number;
+        y: number;
+    }>;
+    /**
+     * 将屏幕像素坐标转换为地图经纬度。
+     */
+    pxToLatLng: (point: {
+        x: number;
+        y: number;
+    }) => Promise<LatLng>;
+}
+
+export declare interface MapViewportAnimationOptions {
+    /**
+     * 是否开启地图视野变化动画。
+     * @defaultValue true
+     */
+    animated?: boolean;
+    /**
+     * 动画时长，单位 ms。
+     * 仅支持 Android 平台。
+     * @defaultValue 250
+     */
+    duration?: number;
+}
+
+export declare interface MarkdownAnimationStepEvent {
+    animationStep: number;
+    maxAnimationStep: number;
+}
+
+export declare interface MarkdownAnimationStepResult {
+    animationStep: number;
+}
+
+export declare interface MarkdownBoundingRect {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+
+export declare interface MarkdownContentRangeOptions {
+    /**
+     * 起始索引
+     * @defaultValue 0
+     */
+    start?: number;
+    /**
+     * 结束索引
+     * @defaultValue int32_max
+     */
+    end?: number;
+}
+
+export declare interface MarkdownContentResult {
+    content: string;
+}
+
+export declare type MarkdownEffect = Record<string, unknown>;
+
+export declare type MarkdownEvent<EventType extends string = string, Detail = unknown> = BaseEvent<EventType, Detail>;
+
+export declare interface MarkdownImagesResult {
+    images: string[];
+}
+
+export declare interface MarkdownImageTapEvent {
+    url: string;
+}
+
+export declare interface MarkdownLineStyle {
+    lineType: 'solid' | 'dashed';
+    color: string;
+    width: number;
+    elementSize?: number;
+    emptySize?: number;
+}
+
+export declare interface MarkdownLinkEvent {
+    url: string;
+    content: string;
+}
+
+export declare interface MarkdownMarkAttachment {
+    startIndex: number;
+    endIndex: number;
+    indexType: 'char' | 'source';
+    clickable?: boolean;
+    id?: string;
+    layer?: 'background' | 'foreground';
+    style: MarkdownMarkStyle;
+}
+
+export declare interface MarkdownMarkStyle {
+    radius?: number;
+    left?: number;
+    right?: number;
+    top?: number;
+    bottom?: number;
+    color?: string;
+    borderLeft?: MarkdownLineStyle;
+    borderTop?: MarkdownLineStyle;
+    borderRight?: MarkdownLineStyle;
+    borderBottom?: MarkdownLineStyle;
+}
+
+export declare interface MarkdownMethodFailResult {
+    code: number;
+    data: string;
+}
+
+export declare interface MarkdownOverflowEvent {
+    type: 'ellipsis' | 'clip';
+}
+
+export declare interface MarkdownParseEndEvent {
+    id: string;
+}
+
+export declare interface MarkdownParseResult {
+    result: Map<string, MarkdownSourceRange[]>;
+}
+
+export declare interface MarkdownParseResultOptions {
+    /**
+     * 需要获取源码区间的标签名
+     */
+    tags: string[];
+}
+
+/**
+ * Markdown 渲染组件，基于 Lynx `x-markdown` 渲染 Markdown 内容。
+ */
+export declare interface MarkdownProps {
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 元素的唯一标识
+     */
+    id?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 用于获取组件实例的 ref
+     */
+    ref?: Ref<MarkdownRef>;
+    /**
+     * Markdown 源内容
+     */
+    content: string;
+    /**
+     * 内容标识，会在事件和 UI 方法中回传
+     */
+    contentId?: string;
+    /**
+     * Markdown 内部元素样式表。该对象会直接透传给 Lynx 原生 `x-markdown` 的 `markdown-style`，
+     * 不是普通 CSS style；颜色使用不带 `#` 的十六进制字符串（如 `'151515'`），尺寸使用 number
+     *（如 `fontSize: 15`、`lineHeight: 22`），不要传 `var(--color)`、`'#151515'` 或 `'15px'`。
+     * @defaultValue {}
+     */
+    markdownStyle?: MarkdownStyle;
+    /**
+     * 动画类型
+     * @defaultValue 'none'
+     */
+    animationType?: 'none' | 'typewriter';
+    /**
+     * 动画速度。打字机模式下表示每秒输出字符数
+     * @defaultValue 1
+     */
+    animationVelocity?: number;
+    /**
+     * 最大文本行数，表格行也会计为一行
+     */
+    textMaxline?: number;
+    /**
+     * 动画起始步数
+     * @defaultValue 0
+     */
+    initialAnimationStep?: number;
+    /**
+     * 打字机动画完成后是否隐藏光标并触发绘制完成事件
+     * @defaultValue true
+     */
+    contentComplete?: boolean;
+    /**
+     * 打字机模式下高度是否跟随已输出内容变化
+     * @defaultValue false
+     */
+    typewriterDynamicHeight?: boolean;
+    /**
+     * 是否支持文本选择
+     * @defaultValue false
+     */
+    textSelection?: boolean;
+    /**
+     * 文本高亮、下划线等标注配置
+     * @defaultValue []
+     */
+    textMarkAttachments?: MarkdownMarkAttachment[];
+    /**
+     * 需要解析的内容区间
+     * @defaultValue [0, int32_max]
+     */
+    contentRange?: number[];
+    /**
+     * 额外 Markdown 效果配置
+     * @defaultValue {}
+     */
+    markdownEffect?: MarkdownEffect;
+    /**
+     * 打字机动画扩展高度时的过渡时长
+     * @defaultValue 0
+     */
+    typewriterHeightTransitionDuration?: number;
+    /**
+     * 是否启用 GIF 动画
+     * @defaultValue false
+     */
+    enableGif?: boolean;
+    /**
+     * 开始绘制时触发
+     * @eventProperty
+     */
+    onDrawStart?: (event: MarkdownEvent<'binddrawStart'>) => void;
+    /**
+     * 绘制完成时触发
+     * @eventProperty
+     */
+    onDrawEnd?: (event: MarkdownEvent<'binddrawEnd'>) => void;
+    /**
+     * 动画每步结束时触发
+     * @eventProperty
+     */
+    onAnimationStep?: (event: MarkdownEvent<'bindanimationStep', MarkdownAnimationStepEvent>) => void;
+    /**
+     * 文本溢出时触发
+     * @eventProperty
+     */
+    onOverflow?: (event: MarkdownEvent<'bindoverflow', MarkdownOverflowEvent>) => void;
+    /**
+     * 点击链接时触发
+     * @eventProperty
+     */
+    onLink?: (event: MarkdownEvent<'bindlink', MarkdownLinkEvent>) => void;
+    /**
+     * 文本选择变化时触发
+     * @eventProperty
+     */
+    onSelectionChange?: (event: MarkdownEvent<'bindselectionchange', MarkdownSelectionChangeEvent>) => void;
+    /**
+     * 点击图片时触发
+     * @eventProperty
+     */
+    onImageTap?: (event: MarkdownEvent<'bindimageTap', MarkdownImageTapEvent>) => void;
+    /**
+     * 解析完成时触发
+     * @eventProperty
+     */
+    onParseEnd?: (event: MarkdownEvent<'bindparseEnd', MarkdownParseEndEvent>) => void;
+    /**
+     * 点击 textMarkAttachments 中的可点击标注时触发
+     * @eventProperty
+     */
+    onTextClick?: (event: MarkdownEvent<'bindtextClick', MarkdownTextClickEvent>) => void;
+}
+
+/**
+ * Markdown 组件暴露的方法
+ */
+export declare interface MarkdownRef {
+    /**
+     * 暂停打字机动画
+     */
+    pauseAnimation: () => Promise<MarkdownAnimationStepResult>;
+    /**
+     * 继续打字机动画
+     */
+    resumeAnimation: (options?: MarkdownResumeAnimationOptions) => Promise<void>;
+    /**
+     * 获取指定区间的已解析内容
+     */
+    getContent: (options?: MarkdownContentRangeOptions) => Promise<MarkdownContentResult>;
+    /**
+     * 获取当前选中的文本
+     */
+    getSelectedText: () => Promise<MarkdownSelectedTextResult>;
+    /**
+     * 通过坐标设置文本选区
+     */
+    setTextSelection: (options: MarkdownTextSelectionOptions) => Promise<MarkdownTextSelectionResult>;
+    /**
+     * 获取指定文本区间的布局包围盒
+     */
+    getTextBoundingRect: (options?: MarkdownTextBoundingRectOptions) => Promise<MarkdownTextBoundingRectResult>;
+    /**
+     * 获取 Markdown 中的所有图片地址
+     */
+    getImages: () => Promise<MarkdownImagesResult>;
+    /**
+     * 获取指定标签对应的源码区间
+     */
+    getParseResult: (options: MarkdownParseResultOptions) => Promise<MarkdownParseResult>;
+}
+
+export declare interface MarkdownResumeAnimationOptions {
+    /**
+     * 动画从指定步数继续
+     */
+    animationStep?: number;
+}
+
+export declare interface MarkdownSelectedTextResult {
+    selectedText: string;
+}
+
+export declare interface MarkdownSelectionChangeEvent {
+    start: number;
+    end: number;
+    direction: 'forward' | 'backward';
+}
+
+export declare interface MarkdownSelectionHandle {
+    x: number;
+    y: number;
+    radius: number;
+}
+
+export declare interface MarkdownSourceRange {
+    start: number;
+    end: number;
+}
+
+export declare type MarkdownStyle = Record<string, unknown>;
+
+export declare interface MarkdownTextBoundingRectOptions extends MarkdownContentRangeOptions {
+    /**
+     * start/end 的索引类型
+     * @defaultValue 'char'
+     */
+    indexType?: 'source' | 'char';
+}
+
+export declare interface MarkdownTextBoundingRectResult {
+    boundingRect: MarkdownBoundingRect;
+    boxes: MarkdownBoundingRect[];
+}
+
+export declare interface MarkdownTextClickEvent {
+    id: string;
+}
+
+export declare interface MarkdownTextSelectionOptions {
+    /**
+     * 选区起点相对组件的 x 坐标
+     */
+    startX: number;
+    /**
+     * 选区起点相对组件的 y 坐标
+     */
+    startY: number;
+    /**
+     * 选区终点相对组件的 x 坐标
+     */
+    endX: number;
+    /**
+     * 选区终点相对组件的 y 坐标
+     */
+    endY: number;
+}
+
+export declare interface MarkdownTextSelectionResult {
+    boundingRect: MarkdownBoundingRect;
+    boxes: MarkdownBoundingRect[];
+    handles: {
+        start: MarkdownSelectionHandle;
+        end: MarkdownSelectionHandle;
+    }[];
+}
+
+/**
+ * 可移动区域组件，定义子视图可拖拽移动的范围边界。
+ */
+export declare interface MovableAreaProps {
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 子组件
+     */
+    children?: ReactNode;
+}
+
+/**
+ * 可移动视图组件，支持拖拽移动、双指缩放、惯性滑动、越界回弹等交互。
+ */
+export declare interface MovableViewProps {
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 移动方向
+     * - 'all'：允许所有方向移动
+     * - 'vertical'：只允许垂直移动
+     * - 'horizontal'：只允许水平移动
+     * - 'none'：不允许移动
+     *
+     * @defaultValue 'none'
+     */
+    direction?: 'all' | 'vertical' | 'horizontal' | 'none';
+    /**
+     * 是否禁用移动
+     * @defaultValue false
+     */
+    disabled?: boolean;
+    /**
+     * 是否允许缩放
+     * @defaultValue false
+     */
+    scale?: boolean;
+    /**
+     * 是否启用惯性滑动
+     * @defaultValue false
+     */
+    inertia?: boolean;
+    /**
+     * 是否启用动画
+     * @defaultValue true
+     */
+    animation?: boolean;
+    /**
+     * 阻尼系数，用于控制 x/y 改变时的动画和越界回弹动画。值越大越快。
+     * @defaultValue 20
+     */
+    damping?: number;
+    /**
+     * 摩擦系数，用于控制惯性滑动衰减。值越大摩擦越大，越快停止；必须 > 0。
+     * @defaultValue 2
+     */
+    friction?: number;
+    /**
+     * 最小缩放比例
+     * @defaultValue 0.5
+     */
+    scaleMin?: number;
+    /**
+     * 最大缩放比例
+     * @defaultValue 10
+     */
+    scaleMax?: number;
+    /**
+     * 是否允许超出可移动区域
+     * @defaultValue false
+     */
+    outOfBounds?: boolean;
+    /**
+     * 初始 X 轴偏移
+     * @defaultValue 0
+     */
+    x?: number;
+    /**
+     * 初始 Y 轴偏移
+     * @defaultValue 0
+     */
+    y?: number;
+    /**
+     * 初始缩放值
+     * @defaultValue 1
+     */
+    scaleValue?: number;
+    /**
+     * 拖拽移动时触发
+     */
+    onDrag?: (x: number, y: number) => void;
+    /**
+     * 双指缩放时触发
+     */
+    onScale?: (scale: number) => void;
+    /**
+     * 子组件
+     */
+    children?: ReactNode;
+}
+
+declare interface OffscreenCanvas_2 {
+    /**
+     * 画布宽度（buffer 像素数）
+     */
+    width: number;
+    /**
+     * 画布高度（buffer 像素数）
+     */
+    height: number;
+    /**
+     * 获取绘图上下文
+     */
+    getContext: {
+        (contextType: '2d'): Canvas2DContext | null;
+        (contextType: 'webgl', contextAttributes?: WebGLContextAttributes_2): WebGLRenderingContext | null;
+        (contextType: 'webgl2', contextAttributes?: WebGLContextAttributes_2): WebGL2RenderingContext | null;
+    };
+    /**
+     * 创建图片对象
+     */
+    createImage: () => CanvasImage | undefined;
+}
+
+declare interface onBounceParams {
+    type: 'start' | 'end';
+    offset: number;
+}
+
+declare interface OnDragCallback {
+    /**
+     * 0 - begin 1 - drag 2 - end
+     * @zh 0 - 开始 1 - 拖动 2 - 结束
+     */
+    state: number;
+    /**
+     * x and y coordinate
+     * @zh x 和 y 坐标
+     */
+    touchEvent: TouchEvent_3;
+    /**
+     * The top of popup
+     * @zh 弹窗的顶部位置
+     */
+    top: number;
+}
+
+/**
+ * PickerColumn 单个选项的数据结构
+ */
+export declare interface PickerColumnOption {
+    /**
+     * 选项显示的文本
+     */
+    label: string;
+    /**
+     * 选项的值
+     */
+    value: string | number;
+    /**
+     * 是否禁用
+     */
+    disabled?: boolean;
+}
+
+/**
+ * 滚轮选择列，单列数据选择，通常作为 PickerView 的子组件使用。
+ */
+export declare interface PickerColumnProps {
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 列数据
+     */
+    options: PickerColumnOption[];
+    /**
+     * 当前选中的值
+     */
+    value?: string | number;
+    /**
+     * 默认选中的值，用于非受控模式
+     */
+    defaultValue?: string | number;
+    /**
+     * 选项变化时触发
+     */
+    onChange?: (value: string | number, option: PickerColumnOption) => void;
+}
+
+export declare interface PickerColumnRef {
+    getValue: () => {
+        value: string | number;
+        option: PickerColumnOption;
+    };
+    setValue: (value: string | number) => void;
+}
+
+/**
+ * 滚轮选择器分隔线组件，用于在 PickerColumn 之间展示文字或自定义内容。
+ */
+export declare interface PickerDividerProps {
+    /**
+     * 展示文本。
+     */
+    text?: string;
+    /**
+     * 自定义内容，优先级高于 text。
+     */
+    children?: ReactNode;
+    /**
+     * 组件类名。
+     */
+    className?: string;
+    /**
+     * 组件样式。
+     */
+    style?: CSSProperties;
+}
+
+/**
+ * 滚轮选择器容器，支持多列组合选择。
+ */
+export declare interface PickerViewProps {
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 组件主题。未传时跟随宿主应用主题；传入后固定使用指定主题。
+     */
+    theme?: Theme;
+    /**
+     * 单个选项高度，单位 px。PickerView 会用它同步 indicator 高度和滚动居中计算。
+     */
+    itemHeight?: number;
+    /**
+     * 子元素，通常是 PickerColumn
+     */
+    children?: ReactNode;
+    /**
+     * 选项变化时触发
+     */
+    onChange?: (values: (string | number)[], options: PickerColumnOption[]) => void;
+}
+
+export declare interface PickerViewRef {
+    getValues: () => (string | number)[];
+    getOptions: () => PickerColumnOption[];
+    setValues: (values: (string | number)[]) => void;
+}
+
+export declare interface Polygon {
+    id: string;
+    /**
+     * 多边形顶点经纬度数组，顺时针方向。
+     */
+    points: LatLng[];
+    /**
+     * 是否虚线。
+     */
+    dottedLine?: boolean;
+    /**
+     * 描边的宽度。
+     * @defaultValue 1
+     */
+    strokeWidth?: number;
+    /**
+     * 描边的颜色。
+     * @defaultValue "#52afff99"
+     */
+    strokeColor?: string;
+    /**
+     * 填充颜色。
+     * @defaultValue "#52afff33"
+     */
+    fillColor?: string;
+    /**
+     * 设置多边形 Z 轴数值。
+     * @defaultValue 0
+     */
+    zIndex?: number;
+}
+
+export declare interface Polyline {
+    id: string;
+    /**
+     * 路线点数组。
+     */
+    points: LatLng[];
+    /**
+     * 路线各段边缘颜色数组。
+     */
+    edgeColor?: string[];
+    /**
+     * 路线各段纹理 ID 数组，ID 必须在 edgeTextureAssets 中定义。
+     */
+    edgeTexture?: string[];
+    /**
+     * 路线纹理资源数组。
+     */
+    edgeTextureAssets?: PolylineEdgeTexture[];
+    /**
+     * 路线上叠加展示的方向箭头。
+     *
+     * 箭头会作为独立纹理层渲染在当前路线上方，不会占用 edgeTexture 和
+     * edgeTextureAssets 配置。
+     */
+    arrow?: PolylineArrow;
+    /**
+     * 路线宽度，单位 px。
+     */
+    width?: number;
+    /**
+     * 是否虚线。
+     */
+    dottedLine?: boolean;
+    /**
+     * 线帽样式（端点样式）。注意：客户端仅支持在构造时设置，若需更新请手动更换 id 或重新构造整条折线。
+     * @defaultValue "line_cap_butt"
+     */
+    lineCapType?: 'line_cap_butt' | 'line_cap_round';
+    /**
+     * 线连接样式（拐角样式）。注意：客户端仅支持在构造时设置，若需更新请手动更换 id 或重新构造整条折线。
+     * @defaultValue "line_join_bevel"
+     */
+    lineJoinType?: 'line_join_miter' | 'line_join_round' | 'line_join_bevel';
+    /**
+     * 设置折线 Z 轴数值。
+     * @defaultValue 0
+     */
+    zIndex?: number;
+}
+
+export declare interface PolylineArrow {
+    /**
+     * 箭头纹理图片 URL，支持网络图片和 base64 字符串。
+     */
+    iconPath: string;
+}
+
+export declare interface PolylineEdgeTexture {
+    /**
+     * 纹理 ID。
+     */
+    id: string;
+    /**
+     * 纹理图片 URL，支持网络图片和 base64 字符串。
+     */
+    url: string;
+}
+
+export declare interface PopupProps {
+    ref?: ForwardedRef<PopupRef>;
+    /**
+     * The id of root scroll container(required)
+     * @zh 根节点滚动容器的 ID（必需）
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    scrollContainerId: string;
+    /**
+     * children of popup.
+     * @zh 弹窗的子元素
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    children: (prop: RenderFunction) => ReactElement;
+    /**
+     * The ID of the popup content, which needs to be set when autoHeight is true, to get the content height
+     * @zh 弹窗内容的 ID, 在 autoHeight 为 true 时需要设置，用于获取内容高度
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    contentId?: string;
+    /**
+     * Auto height of popup, when set to true, you need to specified contentId prop, the height of popup will be the height of content, The drag area is between bottom and the current height, initHeight and maxHeight are no longer valid
+     * @zh 自动弹窗高度，设置为 true 时，需要指定 contentId 属性，弹窗高度会根据内容高度动态变化，拖动区域在底部和当前高度之间，initHeight 和 maxHeight 不再有效
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    autoHeight?: boolean;
+    /**
+     * Style for mask
+     * @zh 遮罩的样式
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    maskStyle?: CSSProperties_2;
+    /**
+     * Style for popup content
+     * @zh 弹窗内容的样式
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    contentStyle?: CSSProperties_2;
+    /**
+     * Preload when popup is create, it will speed up shown when visible is true
+     * @zh 弹窗创建时预加载，这样在 visible 为 true 时会加快显示速度
+     * @defaultValue true
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    preload?: boolean;
+    /**
+     * When set to true, click mask will dismiss popup.
+     * @zh 设置为 true 时，点击遮罩会关闭弹窗
+     * @defaultValue true
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    closeOnMaskClick?: boolean;
+    /**
+     * When set to true, mask event will through to children
+     * @zh 当设置为true的时候，遮罩事件会传递到子元素
+     * @defaultValue false
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    maskEventThrough?: boolean;
+    /**
+     * if enable drag or not
+     * @zh 是否启用拖动
+     * @defaultValue true
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    enableDrag?: boolean;
+    /**
+     * if enable bounces or not when touch up
+     * @zh 是否需要松手回弹
+     * @defaultValue true
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    enableBounces?: boolean;
+    /**
+     * If true, allows the component to overflow the bottom boundary when dragged.
+     * @zh 如果为 true，则允许组件在拖动时超出底部边界。
+     * @defaultValue false
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    allowDragBeyondBottom?: boolean;
+    /**
+     * Stops the propagation of gesture events when the scroll container is at the top.
+     * @zh 当滚动容器滚动到顶部时，停止滚动容器的手势事件传播。
+     * @defaultValue false
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    stopGesturePropagationWhenScrollAtTop?: boolean;
+    /**
+     * Dynamically adjusts the exit animation based on the content height. When enabled, the on-screen animation duration remains constant. As a result, the greater the content height, the faster the exit velocity to ensure the animation completes within the fixed time
+     * @zh 根据内容高度动态调整退出动画。启用后，屏幕上的动画持续时间保持不变。因此，内容高度越大，退出速度越快，以确保动画在固定时间内完成。
+     * @defaultValue false
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    adjustExitTransitionByContentHeight?: boolean;
+    /**
+     * Theoretically, this is the maximum height that can be dragged to. When using overlayMode, the screen height needs to be passed in. When not using overlayMode, the height of the current LynxView needs to be passed in.
+     * @zh 理论上能拖拽到的最大高度，当使用overlayMode时需要传入屏幕高度，当不使用overlayMode时，需要传入当前LynxView的高度
+     * @defaultValue screenHeight
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    maxHeight: number;
+    /**
+     * Nodes fixed at the bottom of the popup will not be affected by dragging
+     * @zh 固定在弹窗底部的节点，不会受到拖动影响
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    bottomNode?: ReactElement;
+    /**
+     * Whether to allow dragging the Popup when touching the internal scroll container area
+     * @zh 是否允许触摸在内部滚动容器区域时可拖拽Popup
+     * @defaultValue true
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    enableScrollContainerDraggable?: boolean;
+    /**
+     * It is recommended to use a full-screen transparent container for the popup, as it offers better performance. Alternatively, you can also choose to use the popup through an overlay
+     * @zh 建议为弹窗使用全屏透明容器，因为这样性能更好。或者，你也可以选择通过overlay使用弹窗，请参考overlay-ng mode官网描述
+     * @Android
+     * @iOS
+     * @Harmony
+     * @docTypeFallback 'spark' | 'bullet' | 'bulletPopup' | (string & {})
+     */
+    bytedanceOverlayMode?: 'spark' | 'bullet' | 'bulletPopup' | (string & {});
+    /**
+     * Whether to enable the debug log
+     * @zh 是否启用调试日志
+     * @defaultValue false
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    internalDebugLog?: boolean;
+    /**
+     * show animation transition
+     * @zh 显示动画过渡效果
+     * @defaultValue 'all ease-out'
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    enterEasingFunction?: string;
+    /**
+     * hide animation transition
+     * @zh 隐藏动画过渡效果
+     * @defaultValue 'all ease-out'
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    exitEasingFunction?: string;
+    /**
+     * enter animation duration(ms)
+     * @zh 进入动画持续时间（毫秒）
+     * @defaultValue 300
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    enterDuration?: number;
+    /**
+     * exit animation duration(ms)
+     * @zh 退出动画持续时间（毫秒）
+     * @defaultValue 300
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    exitDuration?: number;
+    /**
+     * If you want to use gesture, pass it here.
+     * @zh 如果你想使用手势，请使用这个属性
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    'main-thread:gesture'?: BaseGesture;
+    /**
+     * height percentage of Popup
+     * @zh 弹窗的高度百分比
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    heightPercent?: HeightPercent;
+    /**
+     * bounces transition
+     * @zh 松手回弹效果动画
+     * @defaultValue 'all 0.1s ease-out'
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    bouncesTransition?: string;
+    /**
+     * mask transition timing function, e.g. cubic-bezier(0.25, 0.1, 0.25, 1)
+     * @zh 遮罩的过渡动画时间函数，例如 cubic-bezier(0.25, 0.1, 0.25, 1)
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    maskTransitionTimingFunction?: string;
+    /**
+     * x-overlay-ng props for the popup
+     * @zh 在弹窗的overlay id, 用于在设置bytedanceOverlayMode下指定弹窗的overlay props
+     * @defaultValue {}
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    overlayProps?: Partial<XOverlayNGProps>;
+    /**
+     * drag callback
+     * @zh 拖动回调
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    onDrag?: (eventParam: OnDragCallback) => void;
+    /**
+     * popup position callback
+     * @zh 弹窗位置回调
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    onPopupPositionChange?: (
+    /**
+     * 0(center) 1(top) -1(bottom) 4(close)
+     * @zh 0(中间) 1(顶部) -1(底部) 4(关闭)
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    position: number) => void;
+    /**
+     * 弹窗高度变化回调
+     * @param height 弹窗的高度
+     * @returns
+     */
+    onPopupTopChange?: (height: number) => void;
+    /**
+     * clicking the back button or sliding back
+     * @zh 是否左滑或者点击返回键
+     * @Android
+     */
+    onRequestClose?: () => void;
+}
+
+export declare interface PopupRef {
+    /**
+     * Open the popup. Popup position: 0 (center), 1 (top), -1 (bottom). Default is center.
+     * @zh 打开弹窗, 弹窗位置 0（中心）1（顶部）-1（底部）,默认是中心
+     * @defaultValue 0
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    open: (position?: PopupStatus) => void;
+    /**
+     * Close popup
+     * @zh 关闭弹窗
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    close: () => void;
+    /**
+     * Translate popup to specified position, 0(center) 1(top) -1(bottom) | "px" | "%" | "rpx"
+     * @zh 移动弹窗到指定位置，0（中心）1（顶部）-1（底部）
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    translateTo: (position: PopupStatus | string) => void;
+}
+
+declare const enum PopupStatus {
+    AT_BOTTOM = -1,
+    AT_CENTER = 0,
+    AT_TOP = 1,
+    TOP_TO_CENTER = 2,
+    CENTER_TO_TOP = 3,
+    AT_CLOSE = 4
+}
+
+/**
+ * 单选按钮组，管理一组互斥的 Radio 选项，提供统一的值控制。
+ */
+export declare interface RadioGroupProps {
+    /**
+     * 子元素
+     */
+    children?: ReactNode;
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 当前选中的值（受控模式）
+     */
+    value?: string;
+    /**
+     * 默认选中的值（非受控模式）
+     */
+    defaultValue?: string;
+    /**
+     * 是否禁用整组
+     * @defaultValue false
+     */
+    disabled?: boolean;
+    /**
+     * 选中值变化时的回调
+     */
+    onValueChange?: (value: string) => void;
+}
+
+/**
+ * 单选按钮，需配合 RadioGroup 使用。
+ */
+export declare interface RadioProps {
+    /**
+     * Radio 的值
+     */
+    value: string;
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 是否禁用
+     * @defaultValue false
+     */
+    disabled?: boolean;
+}
+
+declare interface RenderFunction {
+    /**
+     * The gesture that needs to be bound to the scroll container inside the popup. After binding, the scroll container inside the popup follows the rule that when it is not at the top, it will drag the popup first, and when it is at the top, it can scroll the inner scroll container.
+     * @zh Popup内滚动容器需要绑定的手势，绑定后弹窗内的滚动容器遵循未到达顶部时，优先拖拽Popup，到达顶部后可以滚动内部滚动容器
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    'main-thread:gesture': BaseGesture;
+    /**
+     * The gesture that needs to be bound to the non-scrollable container inside the popup. After binding, the non-scrollable container inside the popup will only respond to dragging.
+     * @zh Popup内非滚动容器当需要拖拽时需要绑定的手势，绑定后该节点仅响应拖拽
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    'draggableGesture': BaseGesture;
+}
+
+declare interface RenderFunctionProps<T> {
+    item: T;
+    index: number;
+    realIndex: number;
+}
+
+export declare interface RenderLongImageSegmentsOptions {
+    /**
+     * 渲染模式：
+     * - `view`：返回一组 `<view>` 包裹的分段节点，适合放在 `scroll-view` / 普通容器中。
+     * - `list`：返回一组 `<list-item>` 包裹的分段节点，适合直接放在 `list` 中。
+     * @defaultValue 'view'
+     */
+    mode?: 'view' | 'list';
+    /**
+     * 非激活分段占位背景色。
+     * @defaultValue 'transparent'
+     */
+    placeholderColor?: string;
+    /**
+     * 传给 `LongImageSegment` 的样式。
+     */
+    segmentStyle?: CSSProperties;
+    /**
+     * 传给 `LongImageSegment` 的类名。
+     */
+    segmentClassName?: string;
+    /**
+     * 外层包装节点的样式。
+     */
+    wrapperStyle?: CSSProperties;
+    /**
+     * 外层包装节点的类名。
+     */
+    wrapperClassName?: string;
+    /**
+     * `mode='list'` 时的 `reuse-identifier` 前缀。
+     * @defaultValue 'item_'
+     */
+    listItemReuseIdentifierPrefix?: string;
+}
+
+export declare interface RouteLabel {
+    /**
+     * 标签 ID。
+     */
+    id: string;
+    /**
+     * 标签沿线点数组。
+     */
+    points: LatLng[];
+    /**
+     * 标签文案。
+     */
+    text: string;
+    /**
+     * 标签文字颜色。
+     * @defaultValue "#000000"
+     */
+    textColor?: string;
+    /**
+     * 标签字体大小，单位为 px。
+     * @defaultValue 12
+     */
+    fontSize?: number;
+    /**
+     * 标签边框颜色。
+     * @defaultValue "#cccccc"
+     */
+    borderColor?: string;
+    /**
+     * 路名文字描边宽度，单位 px。
+     * @defaultValue 0
+     */
+    borderWidth?: number;
+    /**
+     * 标签 Z 轴数值。
+     * @defaultValue 0
+     */
+    zIndex?: number;
+}
+
+export { ScrollEndEvent }
+
+export { ScrollEvent }
+
+export { ScrollToLowerEvent }
+
+export { ScrollToUpperEvent }
+
+/**
+ * 可滚动容器，支持垂直和水平方向内容滚动，适用于内容超出可视区域的场景。
+ */
+export declare interface ScrollViewProps {
+    /**
+     * 子元素
+     */
+    children?: ReactNode;
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 元素的唯一标识
+     */
+    id?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 用于获取组件实例的 ref
+     */
+    ref?: Ref<NodesRef>;
+    /**
+     * 滚动方向
+     * @defaultValue 'vertical'
+     */
+    scrollOrientation?: 'vertical' | 'horizontal';
+    /**
+     * 是否启用弹性效果（iOS 回弹效果）
+     * @defaultValue true
+     */
+    bounces?: boolean;
+    /**
+     * 是否允许滚动
+     * @defaultValue true
+     */
+    enableScroll?: boolean;
+    /**
+     * 是否显示滚动条
+     * @defaultValue true
+     */
+    scrollBarEnable?: boolean;
+    /**
+     * 触发滚动到顶部/左侧的距离阈值（px）
+     * @defaultValue 0
+     */
+    upperThreshold?: number;
+    /**
+     * 触发滚动到底部/右侧的距离阈值（px）
+     * @defaultValue 0
+     */
+    lowerThreshold?: number;
+    /**
+     * 初始滚动偏移量（px），仅首屏有效
+     * @defaultValue 0
+     */
+    initialScrollOffset?: number;
+    /**
+     * 初始滚动到指定子节点的索引，仅首屏有效。所有直接子节点必须设置 flatten=false
+     * @defaultValue 0
+     */
+    initialScrollToIndex?: number;
+    /**
+     * 滚动到顶部/左侧时触发
+     * @eventProperty
+     */
+    onScrollToUpper?: (event: ScrollToUpperEvent) => void;
+    /**
+     * @deprecated 请使用 onScrollToUpper 替代
+     */
+    bindscrolltoupper?: (event: ScrollToUpperEvent) => void;
+    /**
+     * 滚动到底部/右侧时触发
+     * @eventProperty
+     */
+    onScrollToLower?: (event: ScrollToLowerEvent) => void;
+    /**
+     * @deprecated 请使用 onScrollToLower 替代
+     */
+    bindscrolltolower?: (event: ScrollToLowerEvent) => void;
+    /**
+     * 滚动过程中触发
+     * @eventProperty
+     */
+    onScroll?: (event: ScrollEvent) => void;
+    /**
+     * @deprecated 请使用 onScroll 替代
+     */
+    bindscroll?: (event: ScrollEvent) => void;
+    /**
+     * 滚动结束时触发
+     * @eventProperty
+     */
+    onScrollEnd?: (event: ScrollEndEvent) => void;
+    /**
+     * @deprecated 请使用 onScrollEnd 替代
+     */
+    bindscrollend?: (event: ScrollEndEvent) => void;
+    /**
+     * 内容尺寸变化时触发
+     * @eventProperty
+     */
+    onContentSizeChanged?: (event: ContentSizeChangedEvent) => void;
+    /**
+     * @deprecated 请使用 onContentSizeChanged 替代
+     */
+    bindcontentsizechanged?: (event: ContentSizeChangedEvent) => void;
+}
+
+/**
+ * 滑块组件，支持在指定范围内选择连续或离散数值。
+ */
+export declare interface SliderProps {
+    /**
+     * 组件样式。
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名。
+     */
+    className?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 当前数值 (必填，只支持受控用法)
+     */
+    value: number;
+    /**
+     * 最小值
+     * @defaultValue 0
+     */
+    min?: number;
+    /**
+     * 最大值
+     * @defaultValue 100
+     */
+    max?: number;
+    /**
+     * 是否展示数值
+     * @defaultValue true
+     */
+    showValue?: boolean;
+    /**
+     * 是否禁用
+     * @defaultValue false
+     */
+    disabled?: boolean;
+    /**
+     * 数值变化的回调
+     */
+    onChange?: (value: number) => void;
+}
+
+/**
+ * SVG 图形渲染组件，支持内联展示 SVG 格式图片。
+ */
+export declare interface SvgProps {
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 元素的唯一标识
+     */
+    id?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 用于获取组件实例的 ref
+     */
+    ref?: Ref<NodesRef>;
+    /**
+     * SVG 资源地址，支持 http/https/base64
+     */
+    src?: string;
+    /**
+     * SVG 内容字符串，直接传入 SVG XML 内容
+     */
+    content?: string;
+    /**
+     * 点击时的回调函数
+     * @eventProperty
+     */
+    onClick?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onClick 替代
+     */
+    bindtap?: (event: TouchEvent_2) => void;
+}
+
+/**
+ * 轮播项组件，用于包裹单个轮播内容，必须作为 Swiper 的直接子组件使用。
+ */
+export declare interface SwiperItemProps {
+    /**
+     * 当前 SwiperItem 的索引，基于 Swiper 的数据
+     */
+    index: number;
+    /**
+     * 子元素
+     */
+    children: ReactElement_2 | ReactElement_2[];
+    /**
+     * 样式
+     */
+    style?: CSSProperties;
+    /**
+     * 类名
+     */
+    className?: string;
+    /**
+     * 当前 SwiperItem 的真实索引，基于 Swiper 的数据
+     * 与 `index` 相同，但在 loop 模式下会不同
+     */
+    realIndex?: number;
+    /**
+     * 传递给 SwiperItem 直接子元素的 `overlap` 属性
+     * 仅在透明度有问题时使用
+     */
+    overlap?: boolean;
+}
+
+/**
+ * 轮播容器组件，支持自动播放、循环、自定义动画等功能。子节点须为 SwiperItem 组件。
+ */
+export declare type SwiperProps<T = any> = SwiperPropsNormal<T> | SwiperPropsCustom<T>;
+
+declare interface SwiperProps_2<T> {
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 轮播图数据集合
+     */
+    data: T[];
+    /**
+     * 轮播项宽度
+     */
+    itemWidth: number;
+    /**
+     * 轮播项高度
+     */
+    itemHeight?: number | 'auto';
+    /**
+     * 子元素，应该是一个函数，返回 SwiperItem
+     * @example
+     * ```tsx
+     * <Swiper
+     *    data={items}
+     *   itemWidth={350}
+     *  >
+     *    {({ index, item }) => (
+     *      <SwiperItem index={index} key={index}>
+     *        <image class="image" src={`${item}`}></image>
+     *        <text class="image-text">Number.{index}</text>
+     *      </SwiperItem>
+     *    )}
+     *  </Swiper>
+     * ```
+     */
+    children: (prop: RenderFunctionProps<T>) => ReactElement_2;
+    /**
+     * 容器宽度
+     * @defaultValue screenWidth
+     */
+    containerWidth?: number;
+    /**
+     * 初始索引，仅在首屏时使用，后续更新将被忽略
+     * @defaultValue 0
+     */
+    initialIndex?: number;
+    /**
+     * 是否开启循环轮播
+     * @defaultValue false
+     */
+    loop?: boolean;
+    /**
+     * 当 loop 为 true 时，Swiper 会复制前 2 个和后 2 个项目来创建循环效果。
+     * 此属性可用于自定义复制第一个和最后一个项目的数量
+     * @defaultValue 2
+     */
+    loopDuplicateCount?: number;
+    /**
+     * 翻页或滑动动画的持续时间
+     * @defaultValue 500
+     */
+    duration?: number;
+    /**
+     * 当前索引改变时的回调函数
+     */
+    onChange?: (current: number) => void;
+    /**
+     * 开始滑动时的回调函数，可与 onSwipeStop 配合使用，用于在滑动时禁用点击事件
+     */
+    onSwipeStart?: (current: number) => void;
+    /**
+     * 停止滑动时的回调函数，可与 onSwipeStart 配合使用
+     */
+    onSwipeStop?: (current: number) => void;
+    /**
+     * Swiper 偏移量改变时的回调函数，应该是一个主线程函数
+     */
+    'main-thread:onOffsetChange'?: (offset: number) => void;
+    /**
+     * 自定义翻页效果的缓动函数
+     */
+    'main-thread:easing'?: (progress: number) => number;
+    /**
+     * 自定义动画效果，应该是一个主线程函数
+     */
+    'main-thread:customAnimation'?: (value: number, index: number) => CSSProperties;
+    /**
+     * 在 JS 中使用的自定义动画效果，应该是一个 JS 函数。
+     * customAnimationFirstScreen 应该是与 'main-thread:customAnimation' 内容相同的函数，但不带 'main thread' 注解。
+     * 这是对 MainThreadScript 不支持首屏的临时解决方案
+     */
+    customAnimationFirstScreen?: (value: number, index: number) => CSSProperties;
+    /**
+     * 是否启用自动播放
+     * @defaultValue false
+     */
+    autoPlay?: boolean;
+    /**
+     * 自动播放间隔
+     * @defaultValue 2000
+     */
+    autoPlayInterval?: number;
+    /**
+     * 用于限制或扩展 Swiper 的偏移量范围，可用于限制偏移量以避免过度滚动
+     */
+    offsetLimit?: [number, number];
+    /**
+     * 回弹参数配置
+     */
+    bounceConfig?: BounceConfig;
+    /**
+     * Swiper 组件的 key，更改此值将重置 Swiper 的进度和状态
+     */
+    swiperKey?: unknown;
+    /**
+     * 在重用 Swiper 组件时是否重置 Swiper 的进度和状态
+     * @defaultValue false
+     */
+    resetOnReuse?: boolean;
+    /**
+     * 根元素样式，控制包含轮播图的可见视口/框架
+     */
+    style?: CSSProperties;
+    /**
+     * 内部滑动轨道的样式，这是实际移动/滑动的元素
+     */
+    trackStyle?: CSSProperties;
+    /**
+     * 决定 Swiper 如何响应不同角度的触摸
+     * @defaultValue [[-180, -135], [-45, 45], [135, 180]]
+     */
+    consumeSlideEvent?: [number, number][];
+    /**
+     * 是否阻止原生事件
+     * @defaultValue false
+     */
+    blockNativeEvent?: boolean;
+    /**
+     * 是否启用 RTL 模式
+     * @defaultValue false
+     */
+    RTL?: boolean | 'lynx-rtl';
+}
+
+/**
+ * @hidden
+ */
+declare interface SwiperPropsCustom<T> extends SwiperProps_2<T> {
+    /**
+     * Swiper 的模式。普通模式会使 SwiperItem 依次排列。
+     * 自定义模式会使 SwiperItem 以绝对定位方式放置在最左侧
+     * @defaultValue normal
+     */
+    mode?: 'custom';
+    /**
+     * 模式的额外配置
+     */
+    modeConfig?: Record<string, unknown>;
+}
+
+/**
+ * @hidden
+ */
+declare interface SwiperPropsNormal<T> extends SwiperProps_2<T> {
+    /**
+     * Swiper 的模式。普通模式会使 SwiperItem 依次排列。
+     * 自定义模式会使 SwiperItem 以绝对定位方式放置在最左侧
+     * @defaultValue normal
+     */
+    mode?: 'normal';
+    /**
+     * 模式的额外配置
+     */
+    modeConfig?: {
+        /**
+         * SwiperItem 的对齐方式
+         * @defaultValue start
+         */
+        align?: 'start' | 'center' | 'end';
+        /**
+         * SwiperItem 之间的间距
+         * @defaultValue 0
+         */
+        spaceBetween?: number;
+    };
+}
+
+export declare interface SwiperRef {
+    /**
+     * 滑动到指定索引的项目
+     */
+    swipeTo: (index: number, options?: SwipeToOptions) => void;
+    /**
+     * 滑动到下一个项目
+     */
+    swipeNext: () => void;
+    /**
+     * 滑动到上一个项目
+     */
+    swipePrev: () => void;
+    /**
+     * 取消当前正在运行的动画。谨慎使用，可能会破坏内部状态
+     * @experimental
+     */
+    cancelAnimation: () => void;
+}
+
+declare interface SwipeToOptions {
+    animate?: boolean;
+    onFinished?: () => void;
+}
+
+/**
+ * 开关切换组件，用于二元状态（开/关）的交互控制。
+ */
+export declare interface SwitchProps {
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 尺寸
+     * @defaultValue 'large'
+     */
+    size?: SwitchSize;
+    /**
+     * 是否选中。如果设置了 `checked`，则 Switch 将处于受控模式，此时 `defaultChecked` 将被忽略。
+     */
+    checked?: boolean;
+    /**
+     * 默认选中状态，仅在非受控模式下生效
+     * @defaultValue false
+     */
+    defaultChecked?: boolean;
+    /**
+     * 是否禁用。当为 `true` 时用户无法操作
+     * @defaultValue false
+     */
+    disabled?: boolean;
+    /**
+     * 状态变化时的回调函数
+     * @param checked - 最新的选中状态
+     */
+    onChange?: (checked: boolean) => void;
+}
+
+/** Switch 尺寸变体 */
+declare type SwitchSize = 'default' | 'large';
+
+/**
+ * 多行文本输入组件，支持自动高度、字数限制等功能。
+ */
+export declare interface TextAreaProps {
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 元素的唯一标识
+     */
+    id?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 用于获取组件实例的 ref
+     */
+    ref?: Ref<NodesRef>;
+    /**
+     * 占位符文本
+     */
+    placeholder?: string;
+    /**
+     * 最大输入长度
+     * @defaultValue 140
+     */
+    maxlength?: number;
+    /**
+     * 最大行数
+     */
+    maxlines?: number;
+    /**
+     * 行间距
+     */
+    lineSpacing?: number | `${number}px` | `${number}rpx`;
+    /**
+     * 是否禁用
+     * @defaultValue false
+     */
+    disabled?: boolean;
+    /**
+     * 是否只读
+     * @defaultValue false
+     */
+    readonly?: boolean;
+    /**
+     * 键盘右下角确认按钮的类型
+     * @defaultValue 'done'
+     */
+    confirmType?: 'send' | 'search' | 'go' | 'done' | 'next';
+    /**
+     * 聚焦时是否显示软键盘
+     * @defaultValue true
+     */
+    showSoftInputOnFocus?: boolean;
+    /**
+     * iOS 弹性效果
+     * @defaultValue true
+     */
+    bounces?: boolean;
+    /**
+     * 输入内容变化时触发
+     * @eventProperty
+     */
+    onInput?: (event: BaseEvent<'bindinput', TextAreaInputEvent>) => void;
+    /**
+     * @deprecated 请使用 onInput 替代
+     */
+    bindinput?: (event: BaseEvent<'bindinput', TextAreaInputEvent>) => void;
+    /**
+     * 聚焦时触发
+     * @eventProperty
+     */
+    onFocus?: (event: BaseEvent<'bindfocus', TextAreaFocusEvent>) => void;
+    /**
+     * @deprecated 请使用 onFocus 替代
+     */
+    bindfocus?: (event: BaseEvent<'bindfocus', TextAreaFocusEvent>) => void;
+    /**
+     * 失焦时触发
+     * @eventProperty
+     */
+    onBlur?: (event: BaseEvent<'bindblur', TextAreaBlurEvent>) => void;
+    /**
+     * @deprecated 请使用 onBlur 替代
+     */
+    bindblur?: (event: BaseEvent<'bindblur', TextAreaBlurEvent>) => void;
+    /**
+     * 点击键盘确认按钮时触发
+     * @eventProperty
+     */
+    onConfirm?: (event: BaseEvent<'bindconfirm', TextAreaConfirmEvent>) => void;
+    /**
+     * @deprecated 请使用 onConfirm 替代
+     */
+    bindconfirm?: (event: BaseEvent<'bindconfirm', TextAreaConfirmEvent>) => void;
+    /**
+     * 选择区域变化时触发
+     * @eventProperty
+     */
+    onSelectionChange?: (event: BaseEvent<'bindselection', TextAreaSelectionChangeEvent>) => void;
+    /**
+     * @deprecated 请使用 onSelectionChange 替代
+     */
+    bindselection?: (event: BaseEvent<'bindselection', TextAreaSelectionChangeEvent>) => void;
+}
+
+/**
+ * 文本渲染组件，是展示文字内容的基础元件，支持文字样式配置。
+ */
+export declare interface TextProps {
+    /**
+     * 子元素
+     */
+    children?: ReactNode;
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 元素的唯一标识
+     */
+    id?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 用于获取组件实例的 ref
+     */
+    ref?: Ref<NodesRef>;
+    /**
+     * 文本显示的最大行数，超出将显示省略号
+     */
+    textMaxline?: string;
+    /**
+     * 文本截断时，省略号颜色是否使用外层 text 标签样式（默认使用最近 inline-text 样式）
+     * @defaultValue false
+     */
+    tailColorConvert?: boolean;
+    /**
+     * 单行纯文本在行内垂直居中/对齐方式，inline 文本不支持
+     * @defaultValue 'normal'
+     */
+    textSingleLineVerticalAlign?: 'normal' | 'bottom' | 'center' | 'top';
+    /**
+     * 是否开启文本选择功能，开启时需同时设置 `flatten={false}`
+     * @defaultValue false
+     */
+    textSelection?: boolean;
+    /**
+     * 是否将节点扁平化以加速渲染，开启文本选择等需要真实节点的能力时需设为 false
+     * @defaultValue true
+     */
+    flatten?: boolean;
+    /**
+     * 开启文本选择后，是否使用自定义弹窗菜单
+     * @defaultValue false
+     */
+    customContextMenu?: boolean;
+    /**
+     * 文本布局完成时触发，事件对象包含文本布局信息
+     * @eventProperty
+     */
+    onLayout?: (event: LayoutEvent) => void;
+    /**
+     * @deprecated 请使用 onLayout 替代
+     */
+    bindlayout?: (event: LayoutEvent) => void;
+    /**
+     * 文本选择变化时触发（需开启 text-selection）
+     * @eventProperty
+     */
+    onSelectionChange?: (event: SelectionChangeEvent) => void;
+    /**
+     * @deprecated 请使用 onSelectionChange 替代
+     */
+    bindselectionchange?: (event: SelectionChangeEvent) => void;
+    /**
+     * 点击时的回调函数
+     * @eventProperty
+     */
+    onClick?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onClick 替代
+     */
+    bindtap?: (event: TouchEvent_2) => void;
+}
+
+export declare type Theme = 'light' | 'dark';
+
+/**
+ * 主题配置组件，为其包裹的子组件统一设置主题样式（颜色、圆角等 CSS 变量）。
+ */
+export declare interface ThemeProviderProps {
+    /**
+     * Theme for the provider subtree. Defaults to the nearest provider theme or host app theme.
+     */
+    theme?: Theme;
+    /**
+     * Child nodes that should inherit Doubao theme CSS variables.
+     */
+    children?: ReactNode;
+    /**
+     * Container style.
+     */
+    style?: CSSProperties;
+    /**
+     * Container class name.
+     */
+    className?: string;
+    /**
+     * Container id.
+     */
+    id?: string;
+    /**
+     * Whether to flatten the provider view. Defaults to false because the view is used as a CSS variable scope.
+     *
+     * @defaultValue false
+     */
+    flatten?: boolean;
+}
+
+declare interface TouchEvent_3 {
+    detail: {
+        /**
+         * x coordinate of touch event
+         * @zh 触摸事件的 x 坐标
+         */
+        y: number;
+        /**
+         * y coordinate of touch event
+         * @zh 触摸事件的 y 坐标
+         */
+        x: number;
+    };
+}
+
+/**
+ * 内容更新状态组件，在内容更新时展示渐变过渡效果。
+ */
+export declare interface UpdatedStateProps {
+    className?: string;
+    style?: CSSProperties;
+}
+
+export declare interface UseLongImageOptions {
+    /**
+     * 图片资源地址。
+     */
+    src: string;
+    /**
+     * 滚动容器唯一标识。未传时内部自动生成。
+     */
+    containerId?: string;
+    /**
+     * 手动重建分段与解码窗口的触发令牌。值变化时会重新初始化。
+     * @defaultValue 0
+     */
+    reloadToken?: number;
+    /**
+     * 单段在展示坐标系下的目标高度（px）。
+     * 值越大，单次解码像素越大；值越小，分段数量越多。
+     * @defaultValue 600
+     */
+    segmentDisplayHeight?: number;
+    /**
+     * 解码窗口的预加载屏数，基于当前可视区域高度计算。
+     * @defaultValue 1
+     */
+    decodeOverscanScreens?: number;
+    /**
+     * 解码窗口允许同时激活的最大分段数。
+     * 用于控制单次内存峰值。
+     * @defaultValue 8
+     */
+    maxActiveSegments?: number;
+    /**
+     * 指标回调，输出尺寸和当前激活窗口信息。
+     */
+    onMetricsChange?: (metrics: LongImageMetrics) => void;
+    /**
+     * 状态回调，输出阶段与错误信息。
+     */
+    onStateChange?: (state: LongImageState) => void;
+}
+
+export declare interface UseLongImageResult {
+    /**
+     * 图片资源地址。
+     */
+    src: string;
+    /**
+     * 需要绑定到外部滚动容器测量节点上的 id。
+     */
+    containerId: string;
+    /**
+     * 原图宽度（px）。
+     */
+    imageWidth: number;
+    /**
+     * 原图高度（px）。
+     */
+    imageHeight: number;
+    /**
+     * 容器实际渲染宽度（px）。
+     */
+    displayWidth: number;
+    /**
+     * 分段数据。
+     */
+    segments: LongImageSegmentData[];
+    /**
+     * 当前激活窗口。
+     */
+    activeRange: LongImageActiveRange;
+    /**
+     * 当前指标快照。
+     */
+    metrics: LongImageMetrics;
+    /**
+     * 当前状态快照。
+     */
+    state: LongImageState;
+    /**
+     * 外部容器布局变化时触发，内部会重新测量容器宽高。
+     */
+    handleContainerLayoutChange: () => void;
+    /**
+     * 外部滚动事件处理器。
+     */
+    handleScroll: (event: LongImageScrollEventLike) => void;
+    /**
+     * 判断指定索引的分段当前是否处于激活解码窗口内。
+     */
+    isSegmentActive: (index: number) => boolean;
+}
+
+declare enum VideoEngineOption {
+    PLAYER_OPTION_ENABLE_DASH = "17"
+}
+
+declare type VideoEnginePlaybackCallback = (success: boolean, errCode?: number, errMsg?: string) => void;
+
+export declare interface VideoProps {
+    ref?: ForwardedRef<VideoRef>;
+    /**
+     * Style for wrapper, especially for border-radius
+     * @zh 包装器的样式，特别用于设置圆角
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    style?: CSSProperties_2;
+    /**
+     * Be used to select the `x-video-engine`. Please ensure that it is unique throughout the page.
+     * @zh 用于选择 `x-video-engine`。请确保在整个页面中唯一。
+     * @defaultValue 'videoengine'
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    videoEngineId?: string;
+    /**
+     * Be used to mark the exposure timing. Please ensure that it is unique throughout the page.
+     * @zh 用于标记曝光时间点。请确保在整个页面中唯一。
+     * @defaultValue 'videoengine'
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    scene?: string;
+    /**
+     * The specified video playback source uses the videoModel data structure recommended by the company to play the resource and is expressed by JSONString.
+     * @zh 指定视频播放源，使用公司推荐的视频模型数据结构播放资源，表现为 JSON 字符串。
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     */
+    videoModel?: string;
+    /**
+     * Use vid to specify the video playback source. Most hosts use vid to play. You need to pass in token and domain at the same time. Toutiao can support only passing in vid.
+     * @zh 使用 vid 指定视频播放源。大多数主机会使用 vid 来播放。你需要同时传入 token 和 domain。头条支持仅传入 vid。
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     */
+    videoId?: string;
+    /**
+     * To play with vid, you need to pass in both token and domain. Toutiao can support passing in only vid
+     * @zh 使用 vid 播放视频需要同时传入 token 和 domain。头条支持仅传入 vid。
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     */
+    token?: string;
+    /**
+     * To play with vid, you need to pass in both token and domain. Toutiao can support passing in only vid. {@link https://lynx.bytedance.net/docs/frontend/components/x-video-engine | see more}.
+     * @zh 使用 vid 播放视频需要同时传入 token 和 domain。头条支持仅传入 vid。{@link https://lynx.bytedance.net/docs/frontend/components/x-video-engine | 查看更多}.
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     */
+    domain?: string;
+    /**
+     * For the specified video playback source, once play-url is set, the player will try to load the resource asynchronously. Before bindredirect, all playback control logic will not take effect.
+     * @zh 指定视频播放源，一旦设置 play-url，播放器将尝试异步加载资源。在绑定重定向之前，所有播放控制逻辑将无效。
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    playUrl?: string;
+    /**
+     * Poster. Will be dismissed after playing.
+     * @zh 海报。播放后将被取消显示。
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    poster?: string;
+    /**
+     * Play automatically after stream data changes.
+     * @zh 流数据变化后自动播放。
+     * @defaultValue false
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    autoPlay?: boolean;
+    /**
+     * Specifies the video cropping/scaling mode.
+     * @zh 指定视频裁剪/缩放模式。
+     * @defaultValue 'aspectFit'
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    objectfit?: 'aspectFit' | 'aspectFill' | 'scaleToFill';
+    /**
+     * Rotate or not in full-screen mode
+     * @zh 全屏模式下是否旋转
+     * @defaultValue 'landscape'
+     * @Android
+     * @iOS
+     * @since 2.18
+     */
+    fullscreenMode?: 'landscape' | 'portrait';
+    /**
+     * Live player should muted.
+     * @zh 是否静音实时播放器。
+     * @defaultValue true
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    mute?: boolean;
+    /**
+     * Loop play. After the video starts playing, loop changes will not change the current play/pause status of the video.
+     * @zh 循环播放。视频开始播放后，循环状态变化不会改变视频的当前播放/暂停状态。
+     * @defaultValue false
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    loop?: boolean;
+    /**
+     * Automatically pre-render the player (showing the first frame) after resource preparation is completed
+     * @zh 在资源准备完成后自动预渲染播放器（显示首帧）
+     * @defaultValue true
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    autoPrepare?: boolean;
+    /**
+     * Automatically pre-render the player (showing the first frame) after resource preparation is completed
+     * @zh 在资源准备完成后自动预渲染播放器（显示首帧）
+     * @defaultValue false
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    initTime?: number;
+    /**
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     */
+    preloadKey?: string;
+    /**
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     */
+    cacheSize?: number;
+    /**
+     * For player monitoring.
+     * @zh 用于播放器监控。
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    tag?: string;
+    /**
+     * For player monitoring.
+     * @zh 用于播放器监控。
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     */
+    subTag?: string;
+    /**
+     * Specify whether to pause the video when the LynxView exits the background or moves out of the screen to prevent sound leakage
+     * @zh 指定当 LynxView 退出背景或移出屏幕后是否暂停视频，以防止声音泄漏
+     * @defaultValue false
+     * @Android
+     * @iOS
+     */
+    pauseOnHide?: boolean;
+    /**
+     * To customize engine parameters, you need to refer to TTVideoEngine key definition and pass in the correct value type. The client needs to pay attention to it.
+     * @zh 要自定义引擎参数，需要参考 TTVideoEngine 键定义并传入正确的值类型。客户端需要注意。
+     * @defaultValue undefined
+     * @Android
+     * @iOS
+     */
+    playerOption?: Record<VideoEngineOption, `@encode(${string | number | boolean}, ${'[c]' | 'i' | 'l' | 'f' | 'd' | 'b'})`>;
+    /**
+     * Specify the playback speed.
+     * @zh 指定播放速度
+     * @defaultValue 1.0
+     * @Android
+     * @iOS
+     */
+    playbackSpeed?: number;
+    /**
+     * Specify the volume, range: [0.0, 1.0]
+     * @zh 指定音量，范围：[0.0, 1.0]
+     * @defaultValue 1.0
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    volume?: number;
+    /**
+     * Whether to use the default resource loader (Forest、Gecko) to download resources
+     * @zh 是否使用默认资源加载器（Forest、Gecko）下载资源
+     * @defaultValue true
+     * @Android
+     * @iOS
+     */
+    skipRedirection?: boolean;
+    /**
+     * Execute pending ops automatically
+     * @zh 自动执行待处理的操作
+     * @defaultValue true
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    cachingPendingOps?: boolean;
+    /**
+     * Custom player backend. The host can inject its own player. `preloadKey` is not supported for playerType === 'light'.
+     * @zh 自定义播放器后端。宿主可注入其自己的播放器。playerType === 'light' 不支持 `preloadKey`。
+     * @defaultValue 'default'
+     * @Android
+     * @iOS
+     * @docTypeFallback 'default' | 'light' | (string & {})
+     */
+    playerType?: 'default' | 'light' | (string & {});
+    /**
+     * Whether to load player instances on demand for performance optimization, commonly used in list scenarios, no need to set in other cases
+     * @zh 是否按需加载播放器实例，用于性能优化，常用于列表场景，其他情况无需设置
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    attached?: boolean;
+    /**
+     * Specify the playback resolution.
+     * @zh 指定播放分辨率。
+     * @defaultValue 'auto'
+     * @Android
+     * @iOS
+     * @since 3.3
+     */
+    resolution?: 'auto' | '240p' | '360p' | '480p' | '540p' | '720p' | '1080p' | '4k' | 'hdr' | '2k' | '1080p 50fps' | '2k 50fps' | '4k 50fps' | '1080p 60fps' | '2k 60fps' | '4k 60fps' | '1080p 120fps' | '2k 120fps' | '4k 120fps';
+    /**
+     * The type of the media
+     * @zh 媒体的类型
+     * @defaultValue 'Video'
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    as?: 'Video' | 'Audio';
+    /**
+     * The player starts playing.
+     * @zh 播放器开始播放。
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    onPlay?: () => void;
+    /**
+     * The player is paused.
+     * @zh 播放器暂停。
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    onPause?: () => void;
+    /**
+     * The player is stopped.
+     * @zh 播放器停止。
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    onStop?: () => void;
+    /**
+     * The player is seek.
+     * @zh 播放器搜索。
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     */
+    onSeek?: (willPlay: boolean) => void;
+    /**
+     * The player finish playing.
+     * @zh 播放器播放结束。
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    onEnded?: () => void;
+    /**
+     * The src is changed
+     * @zh 源文件发生变化
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    onSrcChanged?: () => void;
+    /**
+     * The player receives an error.
+     * @zh 播放器接收到错误信息。
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    onError?: (e: {
+        errorCode: number;
+        errorMsg: string;
+    }) => void;
+    /**
+     * The player's progress is updated
+     * @zh 播放器进度更新
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    onTimeUpdate?: (e: {
+        detail: {
+            current: number;
+            total: number;
+        };
+    }) => void;
+    /**
+     * If you access gecko resources, the loading is asynchronous
+     * @zh 如果访问 gecko 资源，加载是异步的
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     */
+    onRedirected?: () => void;
+    /**
+     * Triggered when the video starts rendering the first frame
+     * @zh 视频开始渲染首帧时触发
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    onFirstFrame?: () => void;
+    /**
+     * The player is ready to play.
+     * @zh 播放器准备好播放。
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     */
+    onPrepared?: () => void;
+    /**
+     * The player is visible. `scene` and `videoengineId` should be specified.
+     * @zh 播放器可见。应该指定 `scene` 和 `videoengineId`。
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     */
+    onAppear?: () => void;
+    /**
+     * The player is invisible. `scene` and `videoengineId` should be specified.
+     * @zh 播放器不可见。应该指定 `scene` 和 `videoengineId`。
+     * @defaultValue undefined
+     * @eventProperty
+     * @Android
+     * @iOS
+     */
+    onDisappear?: () => void;
+}
+
+export declare interface VideoRef {
+    /**
+     * Start playing. You should start play after resource redirect (after `onRedirected`)
+     * @zh 开始播放。你应该在资源重定向后（`onRedirected`）开始播放
+     * @remarks When this operation is successful, it only means that the operation was successfully submitted to the player, and does not mean that the player status has changed.
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    play: (
+    /**
+     * Invocation callback，errCode refer to {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @zh 调用回调，errCode 参考 {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    callback?: VideoEnginePlaybackCallback) => void;
+    /**
+     * Pause playing
+     * @zh 暂停播放
+     * @remarks When this operation is successful, it only means that the operation was successfully submitted to the player, and does not mean that the player status has changed.
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    pause: (
+    /**
+     * Invocation callback，errCode refer to {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @zh 调用回调，errCode 参考 {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @Android
+     * @iOS
+     */
+    callback?: VideoEnginePlaybackCallback) => void;
+    /**
+     * Stop playing
+     * @zh 停止播放
+     * @remarks When this operation is successful, it only means that the operation was successfully submitted to the player, and does not mean that the player status has changed.
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    stop: (
+    /**
+     * Invocation callback，errCode refer to {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @zh 调用回调，errCode 参考 {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @Android
+     * @iOS
+     */
+    callback?: VideoEnginePlaybackCallback) => void;
+    /**
+     * Seek
+     * @zh 定位播放位置
+     * @remarks When this operation is successful, it only means that the operation was successfully submitted to the player, and does not mean that the player status has changed.
+     * @Android
+     * @iOS
+     */
+    seek: (position: number, play: boolean, 
+    /**
+     * Invocation callback，errCode refer to {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @zh 调用回调，errCode 参考 {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @Android
+     * @iOS
+     */
+    callback?: VideoEnginePlaybackCallback) => void;
+    /**
+     * Replay, it is recommended to call it after the playback ends.
+     * @zh 重新播放，建议在播放结束后调用
+     * @remarks When this operation is successful, it only means that the operation was successfully submitted to the player, and does not mean that the player status has changed.
+     * @Android
+     * @iOS
+     */
+    replay: (
+    /**
+     * Whether to play after replay. If not, it will be stopped at the first frame.
+     * @zh 是否在重新播放后开始播放。如果为 false，则会在第一帧停止。
+     * @Android
+     * @iOS
+     */
+    play: boolean, 
+    /**
+     * Invocation callback，errCode refer to {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @zh 调用回调，errCode 参考 {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @Android
+     * @iOS
+     */
+    callback?: VideoEnginePlaybackCallback) => void;
+    /**
+     * Prepare manually.
+     * @zh 手动准备。
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    prepare: (
+    /**
+     * Invocation callback，errCode refer to {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @zh 调用回调，errCode 参考 {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @Android
+     * @iOS
+     */
+    callback?: VideoEnginePlaybackCallback) => void;
+    /**
+     * Get playback duration.
+     * @zh 获取播放时长。
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    getDuration: (
+    /**
+     * Invocation callback，errCode refer to {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @zh 调用回调，errCode 参考 {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @Android
+     * @iOS
+     */
+    callback?: (success: boolean, 
+    /**
+     * Duration, in ms.
+     * @zh 时长，以毫秒为单位
+     * @Android
+     * @iOS
+     */
+    duration: number, errCode?: number, errMsg?: string) => void) => void;
+    /**
+     * Enter full screen. It need client impl, {@link https://lynx.bytedance.net/docs/frontend/components/x-video-engine | see more}.
+     * @zh 进入全屏。需要客户端实现，{@link https://lynx.bytedance.net/docs/frontend/components/x-video-engine | 了解更多}.
+     * @Android
+     * @iOS
+     */
+    enterFullScreen: (
+    /**
+     * Invocation callback，errCode refer to {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @zh 调用回调，errCode 参考 {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @Android
+     * @iOS
+     */
+    callback?: VideoEnginePlaybackCallback) => void;
+    /**
+     * Exit full screen. It need client impl, {@link https://lynx.bytedance.net/docs/frontend/components/x-video-engine | see more}.
+     * @zh 退出全屏。需要客户端实现，{@link https://lynx.bytedance.net/docs/frontend/components/x-video-engine | 了解更多}.
+     * @Android
+     * @iOS
+     */
+    exitFullScreen: (
+    /**
+     * Invocation callback，errCode refer to {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @zh 调用回调，errCode 参考 {@link https://lynx.bytedance.net/docs/frontend/lynx-api/selector-query/selector-query | SelectorQuery}
+     * @Android
+     * @iOS
+     */
+    callback?: VideoEnginePlaybackCallback) => void;
+    /**
+     * Reset the Video. It is required to reset the Video if it is reused. Will be deprecated after being refactored by MTS.
+     * @zh 重置视频。如果要重复使用视频，则需要重置视频。重构后将弃用。
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    reset: () => void;
+    /**
+     * Handle the poster manually
+     * @zh 手动处理海报
+     * @Android
+     * @iOS
+     * @Harmony
+     */
+    operatePoster: (display: boolean) => void;
+}
+
+/**
+ * 基础布局容器，用于组织和嵌套其他组件，支持 Flexbox 布局。
+ */
+export declare interface ViewProps {
+    /**
+     * 子元素
+     */
+    children?: ReactNode;
+    /**
+     * 组件样式
+     */
+    style?: CSSProperties;
+    /**
+     * 组件类名
+     */
+    className?: string;
+    /**
+     * 元素的唯一标识
+     */
+    id?: string;
+    /**
+     * React key 属性
+     */
+    key?: string | number | null | undefined;
+    /**
+     * 用于获取组件实例的 ref
+     */
+    ref?: Ref<NodesRef>;
+    /**
+     * 是否扁平化元素，避免创建真实渲染对象以提升性能
+     * @defaultValue true
+     */
+    flatten?: boolean;
+    /**
+     * 点击时的回调函数
+     * @eventProperty
+     */
+    onClick?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onClick 替代
+     */
+    bindtap?: (event: TouchEvent_2) => void;
+    /**
+     * 点击时的回调函数（阻止事件冒泡）
+     * @eventProperty
+     */
+    onCatchTap?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onCatchTap 替代
+     */
+    catchtap?: (event: TouchEvent_2) => void;
+    /**
+     * 长按时的回调函数
+     * @eventProperty
+     */
+    onLongPress?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onLongPress 替代
+     */
+    bindlongpress?: (event: TouchEvent_2) => void;
+    /**
+     * 触摸开始时的回调函数
+     * @eventProperty
+     */
+    onTouchStart?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onTouchStart 替代
+     */
+    bindtouchstart?: (event: TouchEvent_2) => void;
+    /**
+     * 触摸结束时的回调函数
+     * @eventProperty
+     */
+    onTouchEnd?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onTouchEnd 替代
+     */
+    bindtouchend?: (event: TouchEvent_2) => void;
+    /**
+     * 触摸移动时的回调函数
+     * @eventProperty
+     */
+    onTouchMove?: (event: TouchEvent_2) => void;
+    /**
+     * @deprecated 请使用 onTouchMove 替代
+     */
+    bindtouchmove?: (event: TouchEvent_2) => void;
+    /**
+     * 元素曝光时的回调函数（进入可视区域）
+     * @eventProperty
+     */
+    onAppear?: (event: UIAppearanceEvent) => void;
+    /**
+     * @deprecated 请使用 onAppear 替代
+     */
+    binduiappear?: (event: UIAppearanceEvent) => void;
+    /**
+     * 元素消失时的回调函数（离开可视区域）
+     * @eventProperty
+     */
+    onDisappear?: (event: UIAppearanceEvent) => void;
+    /**
+     * @deprecated 请使用 onDisappear 替代
+     */
+    binduidisappear?: (event: UIAppearanceEvent) => void;
+    /**
+     * 布局变化时的回调函数
+     * @eventProperty
+     */
+    onLayoutChange?: (event: LayoutChangeEvent) => void;
+    /**
+     * @deprecated 请使用 onLayoutChange 替代
+     */
+    bindlayoutchange?: (event: LayoutChangeEvent) => void;
+}
+
+declare interface WebGLContextAttributes_2 {
+    /**
+     * 是否开启透明通道，开启后画布背景透明可与下层内容叠加显示
+     * @defaultValue false
+     */
+    alpha?: boolean;
+    /**
+     * 是否保留绘图缓冲区，开启后 toDataURL/readPixels 可在绘制后正常读取
+     * @defaultValue false
+     */
+    preserveDrawingBuffer?: boolean;
+    /**
+     * 是否开启抗锯齿
+     * @defaultValue false
+     */
+    antialias?: boolean;
+}
+
+export declare interface WebViewProps {
+    /**
+     * 用于获取 WebView 实例方法
+     */
+    ref?: Ref<WebViewRef>;
+    /**
+     * 网页资源地址
+     */
+    src?: string;
+    /**
+     * 网页加载成功时触发
+     */
+    onLoad?: (event: {
+        src: string;
+    }) => void;
+    /**
+     * 网页加载错误时触发
+     */
+    onError?: (event: {
+        errorMsg: string;
+        errorCode: number;
+        url: string;
+    }) => void;
+    /**
+     * 网页向应用 postMessage 时触发
+     */
+    onMessage?: (event: {
+        data: unknown;
+    }) => void;
+}
+
+export declare interface WebViewRef {
+    postMessage(data: unknown): void;
+}
+
+export { }