[Feature] Add experimental video element typings

- Add public TypeScript declarations for the experimental video element attributes, events, and UI methods.

- Wire the video element into JSX intrinsic element and UI method exports.

- Add type coverage for video props, event payloads, and selector query methods.

- Bump the types packages to 4.1.0 and update changelogs for the new video typings.

TEST: bash tools/oliver/types/types-version-check.sh

TEST: Node 24.8.0 pnpm --dir lynx --filter @lynx-js/types test

Author: MoonfaceX

js_libraries/types/CHANGELOG.md

@@ -1,5 +1,8 @@
 # CHANGELOG
 
+## 4.1.0
+- Introduce experimental `<video>` element types.
+
 ## 4.0.0
 - Introduce `<blur-view>`.
 - Add missing `lynx.loadScript<T>(sectionName, { bundleName }): T` declaration on `CommonLynx`. The platform API has existed since LynxSDK 3.7; this is a types-only fix.

js_libraries/types/package.json

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

js_libraries/types/test/pages/video.test-d.tsx

@@ -0,0 +1,86 @@
+// Copyright 2026 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 { assertType } from 'vitest';
+import { IntrinsicElements, UIMethods, VideoBufferingEvent, VideoErrorEvent, VideoFirstFrameEvent, VideoProps, VideoTimeUpdateEvent, VideoUIMethods } from '../../types';
+
+let a: unknown;
+
+{
+  <video src="https://example.com/video.mp4" loop={true} volume={0.5} muted={false} speed={1.25} object-fit="cover" mode="latest" timeupdate-interval={0.2} />;
+
+  assertType<VideoProps>(a as IntrinsicElements['video']);
+  assertType<string | undefined>(a as IntrinsicElements['video']['src']);
+  assertType<boolean | undefined>(a as IntrinsicElements['video']['loop']);
+  assertType<number | undefined>(a as IntrinsicElements['video']['volume']);
+  assertType<boolean | undefined>(a as IntrinsicElements['video']['muted']);
+  assertType<number | undefined>(a as IntrinsicElements['video']['speed']);
+  assertType<'contain' | 'cover' | 'fill' | undefined>(a as IntrinsicElements['video']['object-fit']);
+  assertType<'queue' | 'direct' | 'latest' | undefined>(a as IntrinsicElements['video']['mode']);
+  assertType<number | undefined>(a as IntrinsicElements['video']['timeupdate-interval']);
+}
+
+{
+  <video
+    bindfirstframe={(e: VideoFirstFrameEvent) => {
+      assertType<number>(e.detail.duration);
+    }}
+  />;
+
+  <video
+    bindtimeupdate={(e: VideoTimeUpdateEvent) => {
+      assertType<number>(e.detail.current);
+      assertType<number>(e.detail.duration);
+    }}
+  />;
+
+  <video
+    binderror={(e: VideoErrorEvent) => {
+      assertType<number>(e.detail.errorCode);
+      assertType<string>(e.detail.errorMsg);
+    }}
+  />;
+
+  <video
+    bindbuffering={(e: VideoBufferingEvent) => {
+      assertType<number>(e.detail.buffering);
+    }}
+  />;
+
+  <video bindplaying={() => {}} bindpaused={() => {}} bindstopped={() => {}} bindended={() => {}} bindlooped={() => {}} />;
+}
+
+function invoke<T extends keyof { video: VideoUIMethods }>(_param: { video: VideoUIMethods }[T]) {}
+
+{
+  invoke<'video'>({
+    method: 'play',
+    success: (res) => {
+      assertType<boolean | undefined>(res.success);
+    },
+  });
+
+  invoke<'video'>({
+    method: 'pause',
+    fail: (res) => {
+      assertType<number | undefined>(res.errorCode);
+      assertType<string | undefined>(res.msg);
+      assertType<string | undefined>(res.errorMsg);
+    },
+  });
+
+  invoke<'video'>({
+    method: 'stop',
+  });
+
+  invoke<'video'>({
+    method: 'seek',
+    params: {
+      position: 2,
+    },
+  });
+
+  assertType<VideoUIMethods>(a as UIMethods['video']);
+  assertType<'play' | 'pause' | 'stop' | 'seek'>(a as UIMethods['video']['method']);
+}

js_libraries/types/types/common/element/element.d.ts

@@ -32,6 +32,7 @@ import { ViewPagerItemProps, ViewPagerProps, ViewPagerUIMethods } from './viewpa
 import { BlurViewProps } from './blur-view';
 import { WebviewProps, WebviewUIMethods } from './webview';
 import { MarkdownProps, MarkdownUIMethods } from './markdown';
+import { VideoProps, VideoUIMethods } from './video';
 
 
 export interface UIMethods {
@@ -46,6 +47,7 @@ export interface UIMethods {
   'viewpager': ViewPagerUIMethods;
   'webview': WebviewUIMethods;
   'markdown': MarkdownUIMethods;
+  'video': VideoUIMethods;
 }
 
 type LynxComponentProps = ComponentProps;
@@ -84,6 +86,7 @@ export interface IntrinsicElements {
   'blur-view': BlurViewProps;
   'webview': WebviewProps;
   'markdown': MarkdownProps;
+  'video': VideoProps;
 }
 
 declare module 'react' {
@@ -122,6 +125,7 @@ declare module 'react' {
       'blur-view': BlurViewProps;
       'webview': WebviewProps;
       'markdown': MarkdownProps;
+      'video': VideoProps;
     }
   }
 }

js_libraries/types/types/common/element/index.d.ts

@@ -21,6 +21,7 @@ export * from './viewpager';
 export * from './blur-view';
 export * from './webview';
 export * from './markdown';
+export * from './video';
 export * from './element';
 export * from './methods';
 export * from './attributes';