@lynx-js/types 3.3.2 → 3.4.11

package/CHANGELOG.md

@@ -1,8 +1,10 @@
 # CHANGELOG
 
-## 3.5.0
-- Add a new `flowIds` subfield to the TraceOption parameter in the Trace API to support one-to-many trace associations.
-- Refactor event definitions for improved IDE compatibility.
+## 3.4.11
+- Fix types of `selectAll()` of `SelectorQuery`.
+
+## 3.4.10
+- Add `animate` for `MainThread.Element`
 
 ## 3.4.9
 - Add more interface for `scroll-view`.
@@ -18,11 +20,11 @@
 - Complete the documentation for image related APIs.
 
 ## 3.4.4
-- Complete the documentation for text related APIs.
+- Revert automatically generated cssTypes
 
 ## 3.4.3
 - Add `font-variation-settings`,`font-feature-settings` and `font-optical-sizing` CSS properties.
-- Add `experimental-recycle-available-item-before-layout` and `enable-dynamic-span-count` property for list.
+- Add `experimental-recycle-available-item-before-layout` property for list.
 
 ## 3.4.2
 - And `lynx.fetchBundle` api defines.
@@ -41,19 +43,24 @@
 
 - Introduce <input> and <textarea>
 
-## 3.3.2
-- SelectorQuery FieldsParams adds query attribute
-- Revert automatically generated cssTypes
+## 3.3.4
+
 - Add typing for the runtime interfaces.
-- Codegen longhand and shorthand properties from css_defines
+
+## 3.3.3
+
+- [Infra][Types] Codegen longhand and shorthand properties from css_defines
 - Add `experimental-recycle-sticky-item` and `sticky-buffer-count` for list
 - Add `experimental-update-sticky-for-diff` for list
 - Add ReloadBundleEntry to standardize the timing of reload behavior.
+
+## 3.3.2
+
 - Add typing for MessageEvent.
 
 ## 3.3.1
 
-- Codegen csstype.d.ts from css_defines
+- [Infra][Types] Codegen csstype.d.ts from css_defines
 - Rename `visibleCellsAfterUpdate` to `visibleItemAfterUpdate` for `list`
 - Rename `visibleCellsBeforeUpdate` to `visibleItemBeforeUpdate` for `list`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynx-js/types",
-  "version": "3.3.2",
+  "version": "3.4.11",
   "description": "",
   "keywords": [
     "lynx",

package/types/background-thread/lynx-performance-entry.d.ts

@@ -90,6 +90,17 @@ export interface MetricActualFmpEntry extends PerformanceEntry {
     totalActualFmp: PerformanceMetric;
 }
 
+/**
+ * @deprecated Due to the influence of long tasks on this metric, the statistical results are 
+ * inaccurate, so this type has been deprecated. 
+ * Since version 3.3, you will no longer receive this event.
+ **/
+export interface MetricTtiEntry extends PerformanceEntry {
+    tti: PerformanceMetric;
+    lynxTti: PerformanceMetric;
+    totalTti: PerformanceMetric;
+}
+
 export interface ReloadBundleEntry extends PipelineEntry {
     reloadBundleStart: number;
     reloadBundleEnd: number;

package/types/background-thread/nodes-ref.d.ts

@@ -47,7 +47,6 @@ export interface FieldsParams {
   index?: boolean;
   class?: boolean;
   attribute?: boolean;
-  query?:boolean;
 }
 
 export interface FieldsData {
@@ -57,12 +56,23 @@ export interface FieldsData {
   index: number;
   class: Array<string>;
   attribute: Record<string, unknown>;
-  query:SelectorQuery;
 }
 
-export type PathCallback = (data: PathData, status: { data: string; code: number }) => void;
+export type PathCallback = (data: PathData | null, status: { data: string; code: number }) => void;
 
-export interface NodesRef {
+interface BaseNodesRef {
+  animate(animations: AnimationV2[] | AnimationV2): SelectorQuery;
+
+  playAnimation(ids: string[] | string): SelectorQuery;
+
+  pauseAnimation(ids: string[] | string): SelectorQuery;
+
+  cancelAnimation(ids: string[] | string): SelectorQuery;
+
+  setNativeProps(nativeProps: Record<string, any>): SelectorQuery;
+}
+
+export interface NodesRef extends BaseNodesRef {
   invoke(options: uiMethodOptions): SelectorQuery;
 
   path(callback: PathCallback): SelectorQuery;
@@ -72,20 +82,24 @@ export interface NodesRef {
     callback: (
       data: {
         [K in keyof Required<FieldsParams> as T[K] extends true ? K : never]: FieldsData[K];
-      },
+      } | null,
       status: { data: string; code: number }
     ) => void
   ): SelectorQuery;
+}
 
-  animate(animations: AnimationV2[] | AnimationV2): SelectorQuery;
-
-  playAnimation(ids: string[] | string): SelectorQuery;
-
-  pauseAnimation(ids: string[] | string): SelectorQuery;
+export interface MultiNodesRef extends BaseNodesRef {
+  path(callback: (data: PathData[], status: { data: string; code: number }) => void): SelectorQuery;
 
-  cancelAnimation(ids: string[] | string): SelectorQuery;
-
-  setNativeProps(nativeProps: Record<string, any>): SelectorQuery;
+  fields<T extends FieldsParams>(
+    fields: Required<FieldsParams> extends Record<keyof T, boolean> ? T : FieldsParams,
+    callback: (
+      data: {
+        [K in keyof Required<FieldsParams> as T[K] extends true ? K : never]: FieldsData[K];
+      }[],
+      status: { data: string; code: number }
+    ) => void
+  ): SelectorQuery;
 }
 
 export interface SelectorQuery {
@@ -99,7 +113,7 @@ export interface SelectorQuery {
    * Selects all nodes satisfying CSS selector.
    * @param selector CSS selector
    */
-  selectAll(selector: string): NodesRef;
+  selectAll(selector: string): MultiNodesRef;
 
   /**
    * Select root node of the component.

package/types/common/element/element.d.ts

@@ -10,19 +10,17 @@ import { ImageProps, ImageUIMethods } from './image';
 import { ListItemProps, ListProps, ListRowProps, ListUIMethods } from './list';
 import { PageProps } from './page';
 import { ScrollViewProps, ScrollViewUIMethods } from './scroll-view';
-import { TextProps, TextUIMethods } from './text';
+import { TextProps } from './text';
 import { ViewProps } from './view';
 import { InputProps, InputUIMethods } from './input';
 import { TextAreaProps, TextAreaUIMethods } from './textarea';
 
-
 export interface UIMethods {
   'list': ListUIMethods;
   'scroll-view': ScrollViewUIMethods;
   'image': ImageUIMethods;
   'input': InputUIMethods;
   'textarea': TextAreaUIMethods;
-  'text': TextUIMethods;
 }
 
 type LynxComponentProps = ComponentProps;

package/types/common/element/image.d.ts

@@ -11,11 +11,7 @@ import { StandardProps } from '../props';
 export interface ImageProps extends StandardProps {
   /**
    * Supports http/https/base64
-   * @defaultValue undefined
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
+   * @defaultValue ""
    * @since 0.2
    */
   src?: string;
@@ -26,12 +22,8 @@ export interface ImageProps extends StandardProps {
    * aspectFit: Scales the image while preserving aspect ratio so that the long side is fully visible
    * aspectFill: Scales the image while preserving aspect ratio, ensuring the short side fills the element
    * center: Does not scale the image; image is centered
-   * @defaultValue 'scaleToFill'
+   * @defaultValue "scaleToFill"
    * @since 0.2
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
    */
   mode?: 'scaleToFill' | 'aspectFit' | 'aspectFill' | 'center';
 
@@ -39,93 +31,72 @@ export interface ImageProps extends StandardProps {
    * ARGB_8888: 32-bit memory per pixel, supports semi-transparent images
    * RGB_565: 16-bit memory per pixel, reduces memory usage but loses transparency
    * @defaultValue "ARGB_8888"
-   * @Android
    * @since 1.4
    */
   'image-config'?: 'ARGB_8888' | 'RGB_565';
 
   /**
    * Placeholder image, used same as src
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
+   * @defaultValue ""
    * @since 1.4
    */
   placeholder?: string;
 
   /**
    * Image blur radius
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
+   * @defaultValue "3px"
    * @since 0.2
    */
   'blur-radius'?: string;
 
   /**
    * Stretchable area for 9patch images, in percentage or decimal, four values for top, right, bottom, left
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
+   * @defaultValue "0.2 10% 0.3 20%"
    * @since 1.4
    */
   'cap-insets'?: string;
 
   /**
-   * Adjust the scale of stretchable area for 9patch images
+   * Number of times an animated image plays
    * @defaultValue 1
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
-   * @since 1.4
-   */
-  'cap-insets-scale'?: number;
-
-  /**
-   * Number of times an animated image plays, 0 stands for infinite 
-   * @defaultValue 0
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
    * @since 1.4
    */
   'loop-count'?: number;
 
   /**
    * Image won't load if its size is 0, but will load if prefetch-width is set
-   * @defaultValue "0px"
-   * @deprecated
-   * @iOS
-   * @Android
+   * @defaultValue "100px"
    * @since 1.4
    */
   'prefetch-width'?: string;
 
   /**
    * Image won't load if its size is 0, but will load if prefetch-height is set
-   * @defaultValue "0px"
-   * @deprecated
-   * @iOS
-   * @Android
+   * @defaultValue "100px"
    * @since 1.4
    */
   'prefetch-height'?: string;
 
+  /**
+   * If true, URL mapping is skipped. LynxView's custom ImageInterceptor won't work
+   * @defaultValue false
+   * @since 1.5
+   */
+  'skip-redirection'?: boolean;
+
+  /**
+   * Reduces the chance of OOM by downsampling large images, requires container support
+   * @defaultValue false
+   * @since iOS 2.0
+   */
+  downsampling?: boolean;
+
   /**
    * When set to true and the <image> element has no width or height,
    * the size of the <image> will be automatically adjusted
    * to match the image's original dimensions after the image is successfully loaded,
    * ensuring that the aspect ratio is maintained.
    * @defaultValue false
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
    * @since 2.6
    */
   'auto-size'?: boolean;
@@ -135,10 +106,6 @@ export interface ImageProps extends StandardProps {
    * The default behavior is to clear the image resource before starting a new load.
    * This can resolve flickering issues when the image src is switched and reloaded. It is not recommended to enable this in scenarios where there is node reuse in views like lists.
    * @defaultValue false
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
    * @since 2.7
    */
   'defer-src-invalidation'?: boolean;
@@ -146,42 +113,75 @@ export interface ImageProps extends StandardProps {
   /**
    * Specifies whether the animated image should start playing automatically once it is loaded.
    * @defaultValue true
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
    * @since 2.11
    */
   'autoplay'?: boolean;
 
   /**
-   * Changes the color of all non-transparent pixels to the tint-color specified. The value is a <color>.
+   * Image animation property. If set to false, images will not be cached. Each image will be discarded by default after use,
+   * which is suitable for scenarios where the animation needs to play only once.
+   * @defaultValue true
    * @iOS
-   * @Android
-   * @Harmony
+   * @since 3.4
+   */
+  'ios-frame-cache-automatically'?: boolean;
+
+  /**
+   * Changes the color of all non-transparent pixels to the tint-color specified. The value is a <color>.
+   * @defaultValue ""
    * @since 2.12
    */
   'tint-color'?: string;
 
+  /**
+   * Support outputting image monitoring information in bindload
+   * @defaultValue false
+   * @since 2.12
+   */
+  'extra-load-info'?: boolean;
+
+  /**
+   * Disables unexpected iOS built-in animations
+   * @defaultValue true
+   * @since iOS 2.0
+   */
+  'implicit-animation'?: boolean;
+
+  /**
+   * Add custom parameters to image
+   * @since 2.17
+   */
+  'additional-custom-info'?: { [key: string]: string };
+
   /**
    * Image load success event
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
    * @since 0.2
    */
   bindload?: (e: LoadEvent) => void;
 
   /**
    * Image load error event
-   * @iOS
-   * @Android
-   * @Harmony
-   * @PC
    * @since 0.2
    */
   binderror?: (e: ErrorEvent) => void;
+
+  /**
+   * The animation will call back when it starts playing.
+   * @since 2.11
+   */
+  bindstartplay?: (e: BaseEvent) => void;
+
+  /**
+   * Call back after one loop time of the animation is played.
+   * @since 2.11
+   */
+  bindcurrentloopcomplete?: (e: BaseEvent) => void;
+
+  /**
+   * It will be called after the animation has been played for all loop-count times. If the loop-count is not set, it will not be called back.
+   * @since 2.11
+   */
+  bindfinalloopcomplete?: (e: BaseEvent) => void;
 }
 
 export type LoadEvent = BaseEvent<'load', ImageLoadEvent>;
@@ -189,10 +189,8 @@ export type ErrorEvent = BaseEvent<'error', ImageErrorEvent>;
 
 /**
  * Restart the animation playback method controlled by the front end, and the animation playback progress and loop count will be reset.
- * @iOS
  * @Android
- * @Harmony
- * @PC
+ * @iOS
  * @deprecated Deprecated. Some scenarios may not call back the call result. It is recommended to use resumeAnimation instead.
  */
 export interface ImageStartAnimMethod extends BaseMethod {
@@ -201,10 +199,8 @@ export interface ImageStartAnimMethod extends BaseMethod {
 
 /**
  * Resumes the animation, without resetting the loop-count.
- * @iOS
  * @Android
- * @Harmony
- * @PC
+ * @iOS
  * @since 2.11
  */
 export interface ImageResumeAnimMethod extends BaseMethod {
@@ -213,10 +209,8 @@ export interface ImageResumeAnimMethod extends BaseMethod {
 
 /**
  * Pauses the animation, without resetting the loop-count.
- * @iOS
  * @Android
- * @Harmony
- * @PC
+ * @iOS
  * @since 2.11
  */
 export interface ImagePauseAnimMethod extends BaseMethod {
@@ -225,10 +219,8 @@ export interface ImagePauseAnimMethod extends BaseMethod {
 
 /**
  * Stops the animation, and it will reset the loop-count.
- * @iOS
  * @Android
- * @Harmony
- * @PC
+ * @iOS
  * @since 2.11
  */
 export interface ImageStopAnimMethod extends BaseMethod {

package/types/common/element/input.d.ts

@@ -128,7 +128,7 @@ export interface InputProps extends Omit<StandardProps, 'bindfocus' | 'bindblur'
    */
   maxlength?: number;
   /**
-   * Readonly
+   * Interaction enabled
    * @defaultValue false
    * @Android
    * @iOS
@@ -137,15 +137,7 @@ export interface InputProps extends Omit<StandardProps, 'bindfocus' | 'bindblur'
    * @since 3.4
    */
   readonly?: boolean;
-  /**
-   * Interaction enabled
-   * @defaultValue false
-   * @Android
-   * @iOS
-   * @Harmony
-   * @since 3.5
-   */
-  disabled?: boolean;
+
   /**
    * Show soft input keyboard while focused
    * @defaultValue true

package/types/common/element/list.d.ts

@@ -757,15 +757,6 @@ export interface ListProps extends StandardProps {
    */
     'need-visible-item-info'?: boolean;
 
-   /**
-    * Control whether the span count can be dynamically switched. The default value is true. If set to true, the list will try to maintain stability of layout, and if set to false, the list will layout from the first list-item.
-    * @defaultValue true
-    * @Android
-    * @iOS
-    * @Harmony
-    */
-    'enable-dynamic-span-count'?: boolean;
-
   /**
    * Specify the callback frequency of the scroll event by passing in a value, which specifies how many milliseconds (ms) <list> will call the scroll callback event during scrolling.
    * @defaultValue  200
@@ -1104,6 +1095,16 @@ export interface ListItemProps extends StandardProps {
    */
   'item-key': string;
 
+  /**
+   * Control whether the list-item can be recycled. If set to false, the list-item will not be recycled after being scrolled off the screen, and do not need to be re-rendered when they come back on the screen. The default value is true.
+   * @since 3.4
+   * @defaultValue true
+   * @Android
+   * @iOS
+   * @Harmony
+   */
+  recyclable?: boolean | undefined;
+
   bindnodeappear?: EventHandler<AppearanceEvent>;
   bindnodedisappear?: EventHandler<AppearanceEvent>;
 }

package/types/common/element/methods.d.ts

@@ -4,11 +4,11 @@
 
 import { BaseMethod, Callback } from '../events';
 import { AutoScrollMethod, ScrollToPositionMethod } from './list';
-import {  ScrollViewUIMethods } from './scroll-view';
+import { ScrollToMethod } from './scroll-view';
 
 export type ListParams = ScrollToPositionMethod;
 
-export type ScrollViewParams = ScrollViewUIMethods | AutoScrollMethod;
+export type ScrollViewParams = ScrollToMethod | AutoScrollMethod;
 
 interface BoundingClientRectMethod extends BaseMethod {
   method: 'boundingClientRect';

package/types/common/element/scroll-view.d.ts

@@ -4,6 +4,7 @@
 
 import { BaseEvent, BaseMethod, EventHandler } from '../events';
 import { StandardProps } from '../props';
+import { AutoScrollMethod } from './list';
 import {
   ContentSizeChangedEvent,
   ScrollEndEvent,
@@ -17,101 +18,172 @@ import {
 } from './common';
 
 export interface ScrollViewProps extends StandardProps {
+  /**
+   * Scroll horizontaly.
+   * @defaultValue false
+   * @since 1.4
+   * @iOS
+   * @Android
+   * @H
+   */
+  'scroll-x'?: boolean;
+
+  /**
+   * Scroll vertically
+   * @defaultValue false
+   * @since 1.4
+   * @iOS
+   * @Android
+   * @H
+   */
+  'scroll-y'?: boolean;
+
   /**
    * Replacement of scroll-x and scroll-y
-   * @defaultValue 'vertical'
    * @since 3.0
    * @iOS
    * @Android
-   * @Harmony
-   * @PC
+   * @H
    */
   'scroll-orientation'?: 'vertical' | 'horizontal';
 
   /**
    * Enable bounce effect
-   * @defaultValue true
+   * @defaultValue false
    * @since 1.4
    * @iOS
-   * @Harmony
-   * @PC
+   * @Android
+   * @H
    */
   bounces?: boolean;
 
   /**
    * Enable dragging
-   * @defaultValue true
+   * @defaultValue false
    * @since 1.4
    * @iOS
    * @Android 2.2
-   * @Harmony
-   * @PC
+   * @H
    */
   'enable-scroll'?: boolean;
 
   /**
    * Enable scrollbar
-   * @defaultValue true
+   * @defaultValue false
    * @since 1.4
    * @iOS
-   * @Harmony
-   * @PC
+   * @Android
+   * @H
    */
   'scroll-bar-enable'?: boolean;
 
   /**
-   * Set upper threshold to bindscrolltoupper event.
+   * Not recommended to use. Please use upper-threshold-item-count instead. Set upper threshold to bindscrolltoupper event.
    * @defaultValue 0
    * @since 1.4
    * @iOS
    * @Android
-   * @Harmony
-   * @PC
+   * @H
    */
   'upper-threshold'?: number;
 
   /**
-   * Set upper threshold to bindscrolltoupper event.
+   * Not recommended to use. Please use lower-threshold-item-count instead. Set upper threshold to bindscrolltoupper event.
    * @defaultValue 0
    * @since 1.4
    * @iOS
    * @Android
-   * @Harmony
-   * @PC
+   * @H
    */
   'lower-threshold'?: number;
 
   /**
-   * Initial scroll position, only effective once, in PX
+   * Please use initial-scroll-offset or ScrollTo method. Set the content offset from the top.
+   * @defaultValue 0
+   * @since 1.4
+   * @deprecated 2.17
+   * @iOS
+   * @Android
+   * @H
+   */
+  'scroll-top'?: number;
+
+  /**
+   * Please use initial-scroll-offset or ScrollTo method. Set the content offset from the left.
+   * @defaultValue 0
+   * @since 1.4
+   * @deprecated 2.17
+   * @iOS
+   * @Android
+   * @H
+   */
+  'scroll-left'?: number;
+
+  /**
+   * Initial scroll position, only effective once
    * @defaultValue 0
    * @since 2.17
    * @iOS
    * @Android
-   * @Harmony
-   * @PC
+   * @H
    */
   'initial-scroll-offset'?: number;
 
+  /**
+   * Please use initial-scroll-index or ScrollTo method。Set the first item at the first screen
+   * @defaultValue 0
+   * @since 2.1
+   * @deprecated 2.17
+   * @iOS
+   * @Android
+   */
+  'scroll-to-index'?: number;
+
   /**
    * Scroll to specified child node on first screen, only effective once. All direct child nodes must be flatten=false.
    * @defaultValue 0
    * @since 2.17
    * @iOS
    * @Android
-   * @Harmony
-   * @PC
+   * @H
    */
   'initial-scroll-to-index'?: number;
 
+  /**
+   * On iOS, force-can-scroll should be used with ios-block-gesture-class and ios-recognized-view-tag. Can be used alone on Android.
+   * @defaultValue false
+   * @since 2.10.1
+   * @iOS
+   * @Android
+   * @H
+   */
+  'force-can-scroll'?: boolean;
+
+  /**
+   * Force-can-scroll should be used with ios-block-gesture-class、ios-recognized-view-tag. Specify the class name of scrollable container that should be blocked by force-can-scroll. Given by container's developer.
+   * @defaultValue none
+   * @since 2.10.1
+   * @iOS
+   */
+  'ios-block-gesture-class'?: string;
+
+  /**
+   *  force-can-scroll should be used with ios-block-gesture-class、ios-recognized-view-tag. Specify scrollable container's tag, the UIView's tag. Set and given by container's developer.
+   * @defaultValue none
+   * @since 2.10.1
+   * @iOS
+   */
+  'ios-recognized-view-tag'?: number;
+
   /**
    * This event is triggered when the upper/left edge of the scrolling area intersects with the visible area defined by the upperThreshold.
    * @defaultValue none
    * @since 1.4
    * @iOS
    * @Android
-   * @Harmony
+   * @H
    */
-  bindscrolltoupper?: (e: ScrollToUpperEvent) => void;
+  bindscrolltoupper?: EventHandler<ScrollToUpperEvent>;
 
   /**
    * This event is triggered when the lower/right edge of the scrolling area intersects with the visible area defined by the lowerThreshold.
@@ -119,9 +191,9 @@ export interface ScrollViewProps extends StandardProps {
    * @since 1.4
    * @iOS
    * @Android
-   * @Harmony
+   * @H
    */
-  bindscrolltolower?: (e: ScrollToLowerEvent) => void;
+  bindscrolltolower?: EventHandler<ScrollToLowerEvent>;
 
   /**
    * This event is triggered when the scrollview is scrolling.
@@ -129,10 +201,9 @@ export interface ScrollViewProps extends StandardProps {
    * @since 1.4
    * @iOS
    * @Android
-   * @Harmony
-   * @PC
+   * @H
    */
-  bindscroll?: (e: ScrollEvent) => void;
+  bindscroll?: EventHandler<ScrollEvent>;
 
   /**
    * This event is triggered when the scrollview's scroll ended.
@@ -140,10 +211,9 @@ export interface ScrollViewProps extends StandardProps {
    * @since 1.6
    * @iOS
    * @Android
-   * @Harmony
-   * @PC
+   * @H
    */
-  bindscrollend?: (e: ScrollEndEvent) => void;
+  bindscrollend?: EventHandler<ScrollEndEvent>;
 
   /**
    * This event is triggered when the scrollview's content size changed.
@@ -151,19 +221,42 @@ export interface ScrollViewProps extends StandardProps {
    * @since 1.6
    * @iOS
    * @Android
-   * @Harmony
+   * @H
+   */
+  bindcontentsizechanged?: EventHandler<ContentSizeChangedEvent>;
+
+  /**
+   * scrollview scrolls to upper edge
+   * @defaultValue none
+   * @since 3.0
+   * @iOS
+   * @Android
+   * @H
    */
-  bindcontentsizechanged?: (e: ContentSizeChangedEvent) => void;
+  bindscrolltoupperedge?: EventHandler<ScrollToUpperEdgeEvent>;
+
+  /**
+   * scrollview scrolls to lower edge
+   * @defaultValue none
+   * @since 3.0
+   * @iOS
+   * @Android
+   * @H
+   */
+  bindscrolltoloweredge?: EventHandler<ScrollToLowerEdgeEvent>;
+
+  /**
+   * scrollview scrolls to normal position. Not at upper or lower edge
+   * @defaultValue none
+   * @since 3.0
+   * @iOS
+   * @Android
+   * @H
+   */
+  bindscrolltonormalstate?: EventHandler<ScrollToNormalStateEvent>;
 }
 
-/**
- * Scroll to specified position
- * @Android
- * @iOS
- * @Harmony
- * @PC
- */
-export interface ScrollViewScrollToMethod extends BaseMethod {
+export interface ScrollToMethod extends BaseMethod {
   method: 'scrollTo';
   params: {
     /**
@@ -184,52 +277,4 @@ export interface ScrollViewScrollToMethod extends BaseMethod {
   };
 }
 
-/**
- * Scroll by specified offset
- * @Android
- * @iOS
- * @Harmony
- * @PC
- */
-export interface ScrollViewScrollByMethod extends BaseMethod {
-  method: 'scrollBy';
-  params: {
-    /**
-     * Offset to scroll
-     */
-    offset?: number;
-  };
-}
-
-
-
-/**
- * Automatic scrolling
- * @Android
- * @iOS
- * @Harmony
- * @PC
- */
-export interface ScrollViewAutoScrollMethod extends BaseMethod {
-  method: 'autoScroll';
-  params: {
-    /**
-     *  The distance of each second's scrolling, which supports positive and negative values. The unit of distance can be "px", "rpx", "ppx", or null (for iOS, the value must be greater than 1/screen.scale px).
-     * @Android
-     * @iOS
-     * @Harmony
-     * @PC
-     */
-    rate: number;
-    /**
-     * Start/stop automatic scrolling.
-     * @Android
-     * @iOS
-     * @Harmony
-     * @PC
-     */
-    start: boolean;
-  };
-}
-
-export type ScrollViewUIMethods = ScrollViewScrollToMethod | ScrollViewScrollByMethod | ScrollViewAutoScrollMethod;
+export type ScrollViewUIMethods = ScrollToMethod | AutoScrollMethod;

package/types/common/element/text.d.ts

@@ -11,16 +11,14 @@ import { StandardProps } from '../props';
 export interface TextProps extends StandardProps {
   /**
    * Maximum number of lines for text display
-   * @Android
-   * @iOS
-   * @Harmony
-   * @PC
+   * @defaultValue "-1"
    * @since 1.0
    */
   'text-maxline'?: string;
 
   /**
    * Maximum number of characters for text display
+   * @defaultValue ""
    * @since 1.0
    * @deprecated Suggest preprocessing the text content length.
    */
@@ -29,7 +27,6 @@ export interface TextProps extends StandardProps {
   /**
    * Whether font-size is affected by system font scaling
    * @defaultValue false
-   * @deprecated
    * @since 1.6
    */
   'enable-font-scaling'?: boolean;
@@ -45,18 +42,15 @@ export interface TextProps extends StandardProps {
   /**
    * By default, if text truncation occurs, the color of the inserted ... will be specified by the style on the nearest inline-text. If this attribute is enabled, the color of ... will be specified by the style on the outermost text tag.
    * @defaultValue false
-   * @Android
-   * @iOS
    * @since 2.0
    */
   'tail-color-convert'?: boolean;
 
   /**
    * Set single-line plain text to be centered and aligned within the line. Inline text settings are not supported. Recommended only when the default font doesn't meet center alignment needs, as it increases text measurement time.
-   * @defaultValue 'normal'
+   * @defaultValue normal
    * @iOS
    * @Android
-   * @PC
    * @since 2.12
    */
   'text-single-line-vertical-align'?: 'normal' | 'bottom' | 'center' | 'top';
@@ -116,17 +110,11 @@ export interface TextProps extends StandardProps {
   /**
    * Text layout event
    * @since 2.7
-   * @Android
-   * @iOS
-   * @Harmony
-   * @PC
    */
   bindlayout?: (e: LayoutEvent) => void;
 
   /**
    * Text selection change event
-   * @Android
-   * @iOS
    * @since 2.18
    */
   bindselectionchange?: (e: SelectionChangeEvent) => void;
@@ -217,7 +205,6 @@ interface SetTextSelectionMethod extends BaseMethod {
  * Gets the bounding rectangle of the text.
  * @Android
  * @iOS
- * @PC
  * @since 2.18
  */
 interface GetTextBoundingRectMethod extends BaseMethod {

package/types/common/element/textarea.d.ts

@@ -152,7 +152,7 @@ export interface TextAreaProps extends Omit<StandardProps, 'bindfocus' | 'bindbl
    */
   'line-spacing'?: number | `${number}px` | `${number}rpx`;
   /**
-   * Readonly
+   * Interaction enabled
    * @defaultValue false
    * @Android
    * @iOS
@@ -162,16 +162,6 @@ export interface TextAreaProps extends Omit<StandardProps, 'bindfocus' | 'bindbl
    */
   readonly?: boolean;
 
-  /**
-   * Interaction enabled
-   * @defaultValue false
-   * @Android
-   * @iOS
-   * @Harmony
-   * @since 3.5
-   */
-  disabled?: boolean;
-
   /**
    * Show soft input keyboard while focused
    * @defaultValue true

package/types/common/events.d.ts

@@ -173,25 +173,33 @@ export interface BaseTransitionEvent<T> extends BaseEventOrig<{}, T> {
 export interface TransitionEvent extends BaseTransitionEvent<Target> {}
 
 export interface BaseImageLoadEvent<T> extends BaseEventOrig<{}, T> {
+  detail: {
     width: number;
     height: number;
+  };
 }
 
 export interface ImageLoadEvent extends BaseImageLoadEvent<Target> {
+  detail: {
     width: number;
     height: number;
+  };
 }
 
 export interface BaseImageErrorEvent<T> extends BaseEventOrig<{}, T> {
+  detail: {
     errMsg: string;
     error_code: number;
     lynx_categorized_code: number;
+  };
 }
 
 export interface ImageErrorEvent extends BaseImageErrorEvent<Target> {
+  detail: {
     errMsg: string;
     error_code: number;
     lynx_categorized_code: number;
+  };
 }
 
 export interface TextLineInfo {
@@ -446,83 +454,11 @@ export interface LynxBindCatchEvent<T = any> {
   LongTap?: EventHandler<BaseTouchEvent<T>>;
 }
 
-type PrefixedEvent<E> = {
-  bind?: E;
-  catch?: E;
-  'capture-bind'?: E;
-  'capture-catch'?: E;
-  'global-bind'?: E;
-}
-
-// Helper interfaces for each event, providing explicit properties
-// for bind, catch, capture-bind, capture-catch, and global-bind prefixes.
-interface BGLoadProps<T> { bindbgload?: LynxEvent<T>['BGLoad']; catchbgload?: LynxEvent<T>['BGLoad']; 'capture-bindbgload'?: LynxEvent<T>['BGLoad']; 'capture-catchbgload'?: LynxEvent<T>['BGLoad']; 'global-bindbgload'?: LynxEvent<T>['BGLoad']; }
-interface BGErrorProps<T> { bindbgerror?: LynxEvent<T>['BGError']; catchbgerror?: LynxEvent<T>['BGError']; 'capture-bindbgerror'?: LynxEvent<T>['BGError']; 'capture-catchbgerror'?: LynxEvent<T>['BGError']; 'global-bindbgerror'?: LynxEvent<T>['BGError']; }
-interface TouchStartProps<T> { bindtouchstart?: LynxEvent<T>['TouchStart']; catchtouchstart?: LynxEvent<T>['TouchStart']; 'capture-bindtouchstart'?: LynxEvent<T>['TouchStart']; 'capture-catchtouchstart'?: LynxEvent<T>['TouchStart']; 'global-bindtouchstart'?: LynxEvent<T>['TouchStart']; }
-interface TouchMoveProps<T> { bindtouchmove?: LynxEvent<T>['TouchMove']; catchtouchmove?: LynxEvent<T>['TouchMove']; 'capture-bindtouchmove'?: LynxEvent<T>['TouchMove']; 'capture-catchtouchmove'?: LynxEvent<T>['TouchMove']; 'global-bindtouchmove'?: LynxEvent<T>['TouchMove']; }
-interface TouchCancelProps<T> { bindtouchcancel?: LynxEvent<T>['TouchCancel']; catchtouchcancel?: LynxEvent<T>['TouchCancel']; 'capture-bindtouchcancel'?: LynxEvent<T>['TouchCancel']; 'capture-catchtouchcancel'?: LynxEvent<T>['TouchCancel']; 'global-bindtouchcancel'?: LynxEvent<T>['TouchCancel']; }
-interface TouchEndProps<T> { bindtouchend?: LynxEvent<T>['TouchEnd']; catchtouchend?: LynxEvent<T>['TouchEnd']; 'capture-bindtouchend'?: LynxEvent<T>['TouchEnd']; 'capture-catchtouchend'?: LynxEvent<T>['TouchEnd']; 'global-bindtouchend'?: LynxEvent<T>['TouchEnd']; }
-interface LongPressProps<T> { bindlongpress?: LynxEvent<T>['LongPress']; catchlongpress?: LynxEvent<T>['LongPress']; 'capture-bindlongpress'?: LynxEvent<T>['LongPress']; 'capture-catchlongpress'?: LynxEvent<T>['LongPress']; 'global-bindlongpress'?: LynxEvent<T>['LongPress']; }
-interface TransitionStartProps<T> { bindtransitionstart?: LynxEvent<T>['TransitionStart']; catchtransitionstart?: LynxEvent<T>['TransitionStart']; 'capture-bindtransitionstart'?: LynxEvent<T>['TransitionStart']; 'capture-catchtransitionstart'?: LynxEvent<T>['TransitionStart']; 'global-bindtransitionstart'?: LynxEvent<T>['TransitionStart']; }
-interface TransitionCancelProps<T> { bindtransitioncancel?: LynxEvent<T>['TransitionCancel']; catchtransitioncancel?: LynxEvent<T>['TransitionCancel']; 'capture-bindtransitioncancel'?: LynxEvent<T>['TransitionCancel']; 'capture-catchtransitioncancel'?: LynxEvent<T>['TransitionCancel']; 'global-bindtransitioncancel'?: LynxEvent<T>['TransitionCancel']; }
-interface TransitionEndProps<T> { bindtransitionend?: LynxEvent<T>['TransitionEnd']; catchtransitionend?: LynxEvent<T>['TransitionEnd']; 'capture-bindtransitionend'?: LynxEvent<T>['TransitionEnd']; 'capture-catchtransitionend'?: LynxEvent<T>['TransitionEnd']; 'global-bindtransitionend'?: LynxEvent<T>['TransitionEnd']; }
-interface AnimationStartProps<T> { bindanimationstart?: LynxEvent<T>['AnimationStart']; catchanimationstart?: LynxEvent<T>['AnimationStart']; 'capture-bindanimationstart'?: LynxEvent<T>['AnimationStart']; 'capture-catchanimationstart'?: LynxEvent<T>['AnimationStart']; 'global-bindanimationstart'?: LynxEvent<T>['AnimationStart']; }
-interface AnimationIterationProps<T> { bindanimationiteration?: LynxEvent<T>['AnimationIteration']; catchanimationiteration?: LynxEvent<T>['AnimationIteration']; 'capture-bindanimationiteration'?: LynxEvent<T>['AnimationIteration']; 'capture-catchanimationiteration'?: LynxEvent<T>['AnimationIteration']; 'global-bindanimationiteration'?: LynxEvent<T>['AnimationIteration']; }
-interface AnimationCancelProps<T> { bindanimationcancel?: LynxEvent<T>['AnimationCancel']; catchanimationcancel?: LynxEvent<T>['AnimationCancel']; 'capture-bindanimationcancel'?: LynxEvent<T>['AnimationCancel']; 'capture-catchanimationcancel'?: LynxEvent<T>['AnimationCancel']; 'global-bindanimationcancel'?: LynxEvent<T>['AnimationCancel']; }
-interface AnimationEndProps<T> { bindanimationend?: LynxEvent<T>['AnimationEnd']; catchanimationend?: LynxEvent<T>['AnimationEnd']; 'capture-bindanimationend'?: LynxEvent<T>['AnimationEnd']; 'capture-catchanimationend'?: LynxEvent<T>['AnimationEnd']; 'global-bindanimationend'?: LynxEvent<T>['AnimationEnd']; }
-interface MouseDownProps<T> { bindmousedown?: LynxEvent<T>['MouseDown']; catchmousedown?: LynxEvent<T>['MouseDown']; 'capture-bindmousedown'?: LynxEvent<T>['MouseDown']; 'capture-catchmousedown'?: LynxEvent<T>['MouseDown']; 'global-bindmousedown'?: LynxEvent<T>['MouseDown']; }
-interface MouseUpProps<T> { bindmouseup?: LynxEvent<T>['MouseUp']; catchmouseup?: LynxEvent<T>['MouseUp']; 'capture-bindmouseup'?: LynxEvent<T>['MouseUp']; 'capture-catchmouseup'?: LynxEvent<T>['MouseUp']; 'global-bindmouseup'?: LynxEvent<T>['MouseUp']; }
-interface MouseMoveProps<T> { bindmousemove?: LynxEvent<T>['MouseMove']; catchmousemove?: LynxEvent<T>['MouseMove']; 'capture-bindmousemove'?: LynxEvent<T>['MouseMove']; 'capture-catchmousemove'?: LynxEvent<T>['MouseMove']; 'global-bindmousemove'?: LynxEvent<T>['MouseMove']; }
-interface MouseClickProps<T> { bindmouseclick?: LynxEvent<T>['MouseClick']; catchmouseclick?: LynxEvent<T>['MouseClick']; 'capture-bindmouseclick'?: LynxEvent<T>['MouseClick']; 'capture-catchmouseclick'?: LynxEvent<T>['MouseClick']; 'global-bindmouseclick'?: LynxEvent<T>['MouseClick']; }
-interface MouseDblClickProps<T> { bindmousedblclick?: LynxEvent<T>['MouseDblClick']; catchmousedblclick?: LynxEvent<T>['MouseDblClick']; 'capture-bindmousedblclick'?: LynxEvent<T>['MouseDblClick']; 'capture-catchmousedblclick'?: LynxEvent<T>['MouseDblClick']; 'global-bindmousedblclick'?: LynxEvent<T>['MouseDblClick']; }
-interface MouseLongPressProps<T> { bindmouselongpress?: LynxEvent<T>['MouseLongPress']; catchmouselongpress?: LynxEvent<T>['MouseLongPress']; 'capture-bindmouselongpress'?: LynxEvent<T>['MouseLongPress']; 'capture-catchmouselongpress'?: LynxEvent<T>['MouseLongPress']; 'global-bindmouselongpress'?: LynxEvent<T>['MouseLongPress']; }
-interface WheelProps<T> { bindwheel?: LynxEvent<T>['Wheel']; catchwheel?: LynxEvent<T>['Wheel']; 'capture-bindwheel'?: LynxEvent<T>['Wheel']; 'capture-catchwheel'?: LynxEvent<T>['Wheel']; 'global-bindwheel'?: LynxEvent<T>['Wheel']; }
-interface KeyDownProps<T> { bindkeydown?: LynxEvent<T>['KeyDown']; catchkeydown?: LynxEvent<T>['KeyDown']; 'capture-bindkeydown'?: LynxEvent<T>['KeyDown']; 'capture-catchkeydown'?: LynxEvent<T>['KeyDown']; 'global-bindkeydown'?: LynxEvent<T>['KeyDown']; }
-interface KeyUpProps<T> { bindkeyup?: LynxEvent<T>['KeyUp']; catchkeyup?: LynxEvent<T>['KeyUp']; 'capture-bindkeyup'?: LynxEvent<T>['KeyUp']; 'capture-catchkeyup'?: LynxEvent<T>['KeyUp']; 'global-bindkeyup'?: LynxEvent<T>['KeyUp']; }
-interface FocusProps<T> { bindfocus?: LynxEvent<T>['Focus']; catchfocus?: LynxEvent<T>['Focus']; 'capture-bindfocus'?: LynxEvent<T>['Focus']; 'capture-catchfocus'?: LynxEvent<T>['Focus']; 'global-bindfocus'?: LynxEvent<T>['Focus']; }
-interface BlurProps<T> { bindblur?: LynxEvent<T>['Blur']; catchblur?: LynxEvent<T>['Blur']; 'capture-bindblur'?: LynxEvent<T>['Blur']; 'capture-catchblur'?: LynxEvent<T>['Blur']; 'global-bindblur'?: LynxEvent<T>['Blur']; }
-interface LayoutChangeProps<T> { bindlayoutchange?: LynxEvent<T>['LayoutChange']; catchlayoutchange?: LynxEvent<T>['LayoutChange']; 'capture-bindlayoutchange'?: LynxEvent<T>['LayoutChange']; 'capture-catchlayoutchange'?: LynxEvent<T>['LayoutChange']; 'global-bindlayoutchange'?: LynxEvent<T>['LayoutChange']; }
-interface UIAppearProps<T> { binduiappear?: LynxEvent<T>['UIAppear']; catchuiappear?: LynxEvent<T>['UIAppear']; 'capture-binduiappear'?: LynxEvent<T>['UIAppear']; 'capture-catchuiappear'?: LynxEvent<T>['UIAppear']; 'global-binduiappear'?: LynxEvent<T>['UIAppear']; }
-interface UIDisappearProps<T> { binduidisappear?: LynxEvent<T>['UIDisappear']; catchuidisappear?: LynxEvent<T>['UIDisappear']; 'capture-binduidisappear'?: LynxEvent<T>['UIDisappear']; 'capture-catchuidisappear'?: LynxEvent<T>['UIDisappear']; 'global-binduidisappear'?: LynxEvent<T>['UIDisappear']; }
-interface AccessibilityActionProps<T> { bindaccessibilityaction?: LynxEvent<T>['AccessibilityAction']; catchaccessibilityaction?: LynxEvent<T>['AccessibilityAction']; 'capture-bindaccessibilityaction'?: LynxEvent<T>['AccessibilityAction']; 'capture-catchaccessibilityaction'?: LynxEvent<T>['AccessibilityAction']; 'global-bindaccessibilityaction'?: LynxEvent<T>['AccessibilityAction']; }
-interface TapProps<T> { bindtap?: LynxBindCatchEvent<T>['Tap']; catchtap?: LynxBindCatchEvent<T>['Tap']; 'capture-bindtap'?: LynxBindCatchEvent<T>['Tap']; 'capture-catchtap'?: LynxBindCatchEvent<T>['Tap']; 'global-bindtap'?: LynxBindCatchEvent<T>['Tap']; }
-interface LongTapProps<T> { bindlongtap?: LynxBindCatchEvent<T>['LongTap']; catchlongtap?: LynxBindCatchEvent<T>['LongTap']; 'capture-bindlongtap'?: LynxBindCatchEvent<T>['LongTap']; 'capture-catchlongtap'?: LynxBindCatchEvent<T>['LongTap']; 'global-bindlongtap'?: LynxBindCatchEvent<T>['LongTap']; }
-
-/**
- * A combination of all possible event properties, statically defined for IDE-friendliness.
- * This replaces the previous dynamic mapped type.
- */
-export type LynxEventPropsBase<T> = BGLoadProps<T> &
-  BGErrorProps<T> &
-  TouchStartProps<T> &
-  TouchMoveProps<T> &
-  TouchCancelProps<T> &
-  TouchEndProps<T> &
-  LongPressProps<T> &
-  TransitionStartProps<T> &
-  TransitionCancelProps<T> &
-  TransitionEndProps<T> &
-  AnimationStartProps<T> &
-  AnimationIterationProps<T> &
-  AnimationCancelProps<T> &
-  AnimationEndProps<T> &
-  MouseDownProps<T> &
-  MouseUpProps<T> &
-  MouseMoveProps<T> &
-  MouseClickProps<T> &
-  MouseDblClickProps<T> &
-  MouseLongPressProps<T> &
-  WheelProps<T> &
-  KeyDownProps<T> &
-  KeyUpProps<T> &
-  FocusProps<T> &
-  BlurProps<T> &
-  LayoutChangeProps<T> &
-  UIAppearProps<T> &
-  UIDisappearProps<T> &
-  AccessibilityActionProps<T> &
-  TapProps<T> &
-  LongTapProps<T>;
+export type LynxEventPropsBase<T> = {
+  [K in keyof LynxEvent<T> as Lowercase<`bind${K}` | `catch${K}` | `capture-bind${K}` | `capture-catch${K}` | `global-bind${K}`>]: LynxEvent<T>[K];
+} & {
+  [K in keyof LynxBindCatchEvent<T> as Lowercase<`bind${K}` | `catch${K}` | `capture-bind${K}` | `capture-catch${K}` | `global-bind${K}`>]: LynxBindCatchEvent<T>[K];
+};
 
 export type LynxEventProps = LynxEventPropsBase<Target>;
 

package/types/common/global.d.ts

@@ -39,8 +39,7 @@ declare global {
    * @since 3.0
    * below Lynx 3.0, use lynx.cancelAnimationFrame.
    */
-  function cancelAnimationFrame(requestID?: number): void; 
-
+  function cancelAnimationFrame(requestID?: number): void;
 }
 
 declare function setTimeout(callback: (...args: unknown[]) => unknown, number: number): number;

package/types/common/performance.d.ts

@@ -7,18 +7,9 @@
  */
 export interface TraceOption {
   /**
-   * An optional unique identifier for tracing a single event flow.
-   * 
-   * Note: If `flowIds` is set, this parameter will be ignored.
+   * An optional unique identifier for tracing the event flow.
    */
   flowId?: number;
-
-  /**
-   * An optional unique identifier for tracing multiple event flows.
-   * Support from Lynx 3.5
-   */
-  flowIds?: number[];
-
   /**
    * An optional collection of key-value pairs providing additional context for the tracing event.
    */

package/types/main-thread/animation.d.ts

@@ -0,0 +1,114 @@
+// Copyright 2025 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { Element } from './element'
+
+/**
+ * Animation timing options configuration
+ */
+export interface AnimationOptions {
+  /**
+   * The length of time for the animation to run.
+   * @default 0
+   */
+  duration?: number;
+
+  /**
+   * The length of time to wait before starting the animation.
+   * @default 0
+   */
+  delay?: number;
+
+  /**
+   * The number of times the animation should repeat. You can set this to `Infinity`
+   * to make the animation loop indefinitely.
+   * @default 1
+   */
+  iterations?: number | typeof Infinity;
+
+  /**
+   * Whether the animation runs forwards (`normal`), backwards (`reverse`),
+   * switches direction after each iteration (`alternate`), or runs backwards
+   * and switches direction after each iteration (`alternate-reverse`).
+   * @default "normal"
+   */
+  direction?: 'normal' | 'reverse' | 'alternate' | 'alternate-reverse';
+
+  /**
+   * The rate of the animation's change over time. Accepts a timing-function,
+   * such as `"linear"`, `"ease-in"`, or `"cubic-bezier(0.42, 0, 0.58, 1)"`.
+   * @default "linear"
+   */
+  easing?: string;
+
+  /**
+   * Dictates whether the animation's effects should be reflected by the
+   * element(s) prior to playing (`"backwards"`), retained after the animation
+   * has completed playing (`"forwards"`), or both.
+   * @default "none"
+   */
+  fill?: 'none' | 'forwards' | 'backwards' | 'both';
+
+  /**
+   * The name of the animation, which can be used to uniquely identify it.
+   * This name appears in the animation events parameters and is typically used
+   * to determine if a particular animation event is the one you're interested in.
+   * @since 2.12
+   * @default "An internal unique ID"
+   */
+  name?: string;
+
+  /**
+   * Animation motion state, which defines whether an animation is running or paused.
+   * Accepts an `animation-play-state`.
+   * @default "running"
+   */
+  'play-state'?: 'running' | 'paused';
+}
+
+/**
+ * Represents a keyframe effect for animations.
+ */
+export interface KeyframeEffect {
+  /**
+   * The target element of the animation.
+   */
+  readonly target: Element;
+  /**
+   * The keyframes for the animation.
+   */
+  readonly keyframes: Record<string, string | number>[];
+  /**
+   * The options for the animation.
+   */
+  readonly options: AnimationOptions;
+}
+
+/**
+ * Represents a CSS animation.
+ */
+export interface Animation {
+  /**
+   * The keyframe effect associated with the animation.
+   */
+  readonly effect: KeyframeEffect;
+  /**
+   * The unique identifier for the animation.
+   */
+  readonly id: string;
+
+  /**
+   * Cancel the animation.
+   */
+  cancel(): void;
+
+  /**
+   * Pause the animation.
+   */
+  pause(): void;
+
+  /**
+   * Play the animation.
+   */
+  play(): void;
+}

package/types/main-thread/element.d.ts

@@ -3,8 +3,29 @@
 // LICENSE file in the root directory of this source tree.
 
 import { CSSProperties } from '../common';
+import { Animation, AnimationOptions } from './animation'
 
 export interface Element {
+  styles: CSSProperties;
+  attributes: Record<string, any>;
+  scrollBy: (
+    width: number,
+    height: number
+  ) => {
+    consumedX: number;
+    consumedY: number;
+    unconsumedX: number;
+    unconsumedY: number;
+  };
+  getBoundingClientRect: () => {
+    width: number;
+    height: number;
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+  };
+
   /**
    * Set an attribute.
    * @param attributeName The name of the attribute.
@@ -62,4 +83,15 @@ export interface Element {
    * @since Lynx 2.14
    */
   invoke(methodName: string, params?: Record<string, any>): Promise<any>;
+
+  /**
+   * Animate the element.
+   * @param keyframes The keyframes for the animation.
+   * @param options The options for the animation.
+   * @since Lynx 3.4
+   */
+  animate(
+    keyframes: Record<string, number | string>[],
+    options?: number | AnimationOptions,
+  ): Animation;
 }

package/types/main-thread/index.d.ts

@@ -5,3 +5,4 @@
 export * from './lynx';
 export * from './element';
 export * from './events';
+export * from './animation'