@lynx-js/types 3.3.2 → 3.4.3

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

@@ -3,7 +3,7 @@
 // LICENSE file in the root directory of this source tree.
 
 import { SystemInfo } from './system-info';
-import { Lynx as BackgroundLynx, NativeModules as INativeModules, GetElementByIdFunc, ITextCodecHelper } from '../background-thread';
+import { Lynx as BackgroundLynx, NativeModules as INativeModules, GetElementByIdFunc } from '../background-thread';
 import { Lynx as MainThreadLynx } from '../main-thread';
 import { CommonLynx } from './lynx';
 
@@ -25,7 +25,6 @@ declare global {
   var getElementById: GetElementByIdFunc;
 
   var NativeModules: INativeModules;
-  var TextCodecHelper: ITextCodecHelper;
 
   /**
    * @description requestAnimationFrame
@@ -39,8 +38,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/element.d.ts

@@ -5,6 +5,26 @@
 import { CSSProperties } from '../common';
 
 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.