@yume-chan/scrcpy 2.3.0 → 3.0.0-beta.1

package/esm/video/index.d.ts

@@ -0,0 +1,7 @@
+import * as ScrcpyVideoCodecId from "./codec-id.js";
+export * from "./android.js";
+export * from "./size.js";
+type ScrcpyVideoCodecId = (typeof ScrcpyVideoCodecId)[keyof typeof ScrcpyVideoCodecId];
+export declare const ScrcpyVideoCodecNameMap: Map<number, string>;
+export { ScrcpyVideoCodecId };
+//# sourceMappingURL=index.d.ts.map

package/esm/video/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/video/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,kBAAkB,MAAM,eAAe,CAAC;AAEpD,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAE1B,KAAK,kBAAkB,GACnB,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAEjE,eAAO,MAAM,uBAAuB,qBAUhC,CAAC;AAEL,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/esm/video/index.js

@@ -0,0 +1,15 @@
+import * as ScrcpyVideoCodecId from "./codec-id.js";
+export * from "./android.js";
+export * from "./size.js";
+export const ScrcpyVideoCodecNameMap = /* #__PURE__ */ (() => {
+    const result = new Map();
+    for (const key in ScrcpyVideoCodecId) {
+        const value = ScrcpyVideoCodecId[key];
+        if (typeof value === "number") {
+            result.set(value, key);
+        }
+    }
+    return result;
+})();
+export { ScrcpyVideoCodecId };
+//# sourceMappingURL=index.js.map

package/esm/video/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/video/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,kBAAkB,MAAM,eAAe,CAAC;AAEpD,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAK1B,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAe,CAAC,CAAC,GAAG,EAAE;IACzD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACnC,MAAM,KAAK,GACP,kBAAkB,CAAC,GAAsC,CAAC,CAAC;QAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC,EAAE,CAAC;AAEL,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/esm/video/size.d.ts

@@ -0,0 +1,20 @@
+import type { Event } from "@yume-chan/event";
+export interface ScrcpyVideoSizeChangedEvent {
+    width: number;
+    height: number;
+    isClientResize?: boolean | undefined;
+}
+export interface ScrcpyVideoSize {
+    readonly width: number;
+    readonly height: number;
+    readonly sizeChanged: Event<ScrcpyVideoSizeChangedEvent>;
+}
+export declare class ScrcpyVideoSizeImpl implements ScrcpyVideoSize {
+    #private;
+    get width(): number;
+    get height(): number;
+    get sizeChanged(): Event<ScrcpyVideoSizeChangedEvent>;
+    setSize(width: number, height: number, isClientResize?: boolean): void;
+    dispose(): void;
+}
+//# sourceMappingURL=size.d.ts.map

package/esm/video/size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../src/video/size.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,WAAW,2BAA2B;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,2BAA2B,CAAC,CAAC;CAC5D;AAED,qBAAa,mBAAoB,YAAW,eAAe;;IAEvD,IAAI,KAAK,WAER;IAGD,IAAI,MAAM,WAET;IAGD,IAAI,WAAW,uCAEd;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO;IAU/D,OAAO;CAGV"}

package/esm/video/size.js

@@ -0,0 +1,27 @@
+import { StickyEventEmitter } from "@yume-chan/event";
+export class ScrcpyVideoSizeImpl {
+    #width = 0;
+    get width() {
+        return this.#width;
+    }
+    #height = 0;
+    get height() {
+        return this.#height;
+    }
+    #sizeChanged = new StickyEventEmitter();
+    get sizeChanged() {
+        return this.#sizeChanged.event;
+    }
+    setSize(width, height, isClientResize) {
+        if (this.#width === width && this.#height === height) {
+            return;
+        }
+        this.#width = width;
+        this.#height = height;
+        this.#sizeChanged.fire({ width, height, isClientResize });
+    }
+    dispose() {
+        this.#sizeChanged.dispose();
+    }
+}
+//# sourceMappingURL=size.js.map

package/esm/video/size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../../src/video/size.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAetD,MAAM,OAAO,mBAAmB;IAC5B,MAAM,GAAW,CAAC,CAAC;IACnB,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,OAAO,GAAW,CAAC,CAAC;IACpB,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,YAAY,GAAG,IAAI,kBAAkB,EAA+B,CAAC;IACrE,IAAI,WAAW;QACX,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,OAAO,CAAC,KAAa,EAAE,MAAc,EAAE,cAAwB;QAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YACnD,OAAO;QACX,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO;QACH,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yume-chan/scrcpy",
-  "version": "2.3.0",
+  "version": "3.0.0-beta.1",
   "description": "TypeScript implementation of Scrcpy client.",
   "keywords": [
     "adb",
@@ -13,11 +13,11 @@
     "email": "cnsimonchan@live.com",
     "url": "https://chensi.moe/blog"
   },
-  "homepage": "https://github.com/yume-chan/ya-webadb/tree/main/packages/scrcpy#readme",
+  "homepage": "https://github.com/yume-chan/ya-webadb/tree/main/libraries/scrcpy#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/yume-chan/ya-webadb.git",
-    "directory": "packages/scrcpy"
+    "directory": "libraries/scrcpy"
   },
   "bugs": {
     "url": "https://github.com/yume-chan/ya-webadb/issues"
@@ -28,20 +28,21 @@
   "sideEffects": false,
   "dependencies": {
     "@yume-chan/async": "^4.1.3",
-    "@yume-chan/struct": "^2.0.1",
-    "@yume-chan/stream-extra": "^2.1.0",
-    "@yume-chan/no-data-view": "^2.0.0"
+    "@yume-chan/event": "3.0.0-beta.1",
+    "@yume-chan/no-data-view": "3.0.0-beta.1",
+    "@yume-chan/stream-extra": "3.0.0-beta.1",
+    "@yume-chan/struct": "3.0.0-beta.1"
   },
   "devDependencies": {
-    "@types/node": "^24.3.1",
-    "prettier": "^3.6.2",
-    "typescript": "^5.9.2",
+    "@types/node": "^26.1.1",
+    "prettier": "^3.9.6",
+    "typescript": "^6.0.3",
     "@yume-chan/eslint-config": "^1.0.0",
     "@yume-chan/test-runner": "^1.0.0",
     "@yume-chan/tsconfig": "^1.0.0"
   },
   "scripts": {
-    "build": "tsc -b tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json",
     "lint": "run-eslint && prettier src/**/*.ts --write --tab-width 4",
     "test": "run-test"
   }

package/src/1_15/impl/codec-options.ts

@@ -0,0 +1,287 @@
+// cspell: ignore Bframes
+// cspell: ignore macroblocks
+
+import type { ScrcpyOptionValue } from "../../base/option-value.js";
+
+export interface NumberCodecOption {
+    type: "int" | "float";
+    value: number;
+}
+
+export interface BigIntCodecOption {
+    type: "long";
+    value: bigint | number;
+}
+
+export interface StringCodecOption {
+    type: "string";
+    value: string;
+}
+
+export type CodecOption =
+    NumberCodecOption | BigIntCodecOption | StringCodecOption;
+
+export class CodecOptions implements ScrcpyOptionValue {
+    static Empty = /* #__PURE__ */ new CodecOptions();
+
+    #values = new Map<string, CodecOption>();
+    get values(): ReadonlyMap<string, CodecOption> {
+        return this.#values;
+    }
+
+    setInt(key: string, value: number): this {
+        if (value < -2147483648 || value > 2147483647) {
+            throw new Error(`Value ${value} is out of range for int type`);
+        }
+        this.#values.set(key, { type: "int", value: value | 0 });
+        return this;
+    }
+
+    setFloat(key: string, value: number): this {
+        this.#values.set(key, { type: "float", value });
+        return this;
+    }
+
+    setLong(key: string, value: number | bigint): this {
+        this.#values.set(key, {
+            type: "long",
+            // Can't use `value | 0` here because the value may be out of int32 range,
+            // use `Math.floor` instead
+            value: typeof value === "bigint" ? value : Math.floor(value),
+        });
+        return this;
+    }
+
+    setString(key: string, value: string): this {
+        this.#values.set(key, { type: "string", value });
+        return this;
+    }
+
+    delete(key: string) {
+        return this.#values.delete(key);
+    }
+
+    clear() {
+        this.#values.clear();
+    }
+
+    /**
+     * A key describing the desired codec priority.
+     *
+     * The associated value is an integer. Higher value means lower priority.
+     *
+     * Currently, only two levels are supported:
+     *
+     * - 0: realtime priority - meaning that the codec shall support the given performance
+     *  configuration (e.g. framerate) at realtime. This should only be used by media playback,
+     *  capture, and possibly by realtime communication scenarios if best effort performance
+     *  is not suitable.
+     * - 1: non-realtime priority (best effort).
+     *
+     * This is a hint used at codec configuration and resource planning -
+     * to understand the realtime requirements of the application;
+     * however, due to the nature of media components, performance is not guaranteed.
+     */
+    setPriority(priority: number | undefined): this {
+        if (priority === undefined) {
+            this.delete("priority");
+            return this;
+        }
+        return this.setInt("priority", priority);
+    }
+
+    toOptionValue(): string | undefined {
+        if (this.#values.size === 0) {
+            return undefined;
+        }
+
+        return Array.from(this.#values.entries(), ([key, value]) => {
+            let result = key;
+
+            if (value.type !== "int") {
+                result += ":" + value.type;
+            }
+
+            result += "=";
+
+            if (value.type === "string") {
+                result += value.value.replaceAll(",", "\\,");
+            } else {
+                result += value.value;
+            }
+
+            return result;
+        }).join(",");
+    }
+}
+
+export class VideoCodecOptions extends CodecOptions {
+    /**
+     * A key for applications to opt out of allowing a Surface to
+     * discard undisplayed/unconsumed frames as means to catch up after falling behind.
+     * This value is an integer.
+     * The value 0 indicates the surface is not allowed to drop frames.
+     * The value 1 indicates the surface is allowed to drop frames.
+     * [`MediaCodec`](https://developer.android.com/reference/android/media/MediaCodec)
+     * describes the semantics.
+     */
+    setAllowFrameDrop(value: boolean | undefined): this {
+        if (value === undefined) {
+            this.delete("allow-frame-drop");
+            return this;
+        }
+        return this.setInt("allow-frame-drop", value ? 1 : 0);
+    }
+
+    /**
+     * An optional key describing the period of intra refresh in frames.
+     * This is an optional parameter that applies only to video encoders.
+     * If encoder supports it (MediaCodecInfo.CodecCapabilities.FEATURE_IntraRefresh),
+     * the whole frame is completely refreshed after the specified period.
+     * Also for each frame, a fix subset of macroblocks must be intra coded
+     * which leads to more constant bitrate than inserting a key frame.
+     * This key is recommended for video streaming applications as it provides
+     * low-delay and good error-resilience.
+     * This key is ignored if the video encoder does not support the intra refresh feature.
+     * The associated value is an integer.
+     */
+    setIntraRefreshPeriod(value: number | undefined): this {
+        if (value === undefined) {
+            this.delete("intra-refresh-period");
+            return this;
+        }
+        return this.setInt("intra-refresh-period", value);
+    }
+
+    /**
+     * A key describing the frequency of key frames expressed in seconds between key frames.
+     *
+     * This key is used by video encoders.
+     * A negative value means no key frames are requested after the first frame.
+     * A zero value means a stream containing all key frames is requested.
+     *
+     * The associated value is an integer (or float since `Build.VERSION_CODES.N_MR1`).
+     */
+    setIFrameInterval(value: undefined): this;
+    setIFrameInterval(value: number, type?: "int" | "float"): this;
+    setIFrameInterval(
+        value: number | undefined,
+        type: "int" | "float" = "int",
+    ): this {
+        if (value === undefined) {
+            this.delete("i-frame-interval");
+            return this;
+        }
+        return type === "int"
+            ? this.setInt("i-frame-interval", value)
+            : this.setFloat("i-frame-interval", value);
+    }
+
+    /**
+     *
+     * An optional key describing the desired encoder latency in frames.
+     * This is an optional parameter that applies only to video encoders.
+     * If encoder supports it, it should output at least one output frame
+     * after being queued the specified number of frames.
+     * This key is ignored if the video encoder does not support the latency feature.
+     * Use the output format to verify that this feature was enabled
+     * and the actual value used by the encoder.
+     *
+     * If the key is not specified, the default latency will be implementation specific.
+     * The associated value is an integer.
+     */
+    setLatency(value: number | undefined): this {
+        if (value === undefined) {
+            this.delete("latency");
+            return this;
+        }
+        return this.setInt("latency", value);
+    }
+
+    /**
+     * A key describing the desired profile to be used by an encoder.
+     *
+     * The associated value is an integer. Constants are declared in
+     * [`MediaCodecInfo.CodecProfileLevel`](https://developer.android.com/reference/android/media/MediaCodecInfo.CodecProfileLevel).
+     * This key is used as a further hint when specifying a desired profile,
+     * and is only supported for codecs that specify a level.
+     *
+     * This key is ignored if the {@link setProfile | `profile`} is not specified.
+     * Otherwise, the value should be a level compatible with the configured encoding parameters.
+     */
+    setLevel(value: number | undefined): this {
+        if (value === undefined) {
+            this.delete("level");
+            return this;
+        }
+        return this.setInt("level", value);
+    }
+
+    /**
+     * A key describing the maximum number of B frames between I or P frames,
+     * to be used by a video encoder.
+     * The associated value is an integer.
+     * The default value is 0, which means that no B frames are allowed.
+     * Note that non-zero value does not guarantee B frames; it's up to the encoder to decide.
+     */
+    setMaxBFrames(value: number | undefined): this {
+        if (value === undefined) {
+            this.delete("max-bframes");
+            return this;
+        }
+        return this.setInt("max-bframes", value);
+    }
+
+    /**
+     * Instruct the video encoder in "surface-input" mode to drop excessive frames from the source,
+     * so that the input frame rate to the encoder does not exceed the specified fps.
+     * The associated value is a float, representing the max frame rate to feed the encoder at.
+     */
+    setMaxFpsToEncoder(value: number | undefined): this {
+        if (value === undefined) {
+            this.delete("max-fps-to-encoder");
+            return this;
+        }
+        return this.setFloat("max-fps-to-encoder", value);
+    }
+
+    /**
+     * A key describing the desired profile to be used by an encoder.
+     *
+     * The associated value is an integer.
+     * Constants are declared in
+     * [MediaCodecInfo.CodecProfileLevel](https://developer.android.com/reference/android/media/MediaCodecInfo.CodecProfileLevel).
+     * This key is used as a hint, and is only supported for codecs that specify a profile.
+     * When configuring profile,
+     * encoder configuration may fail if other parameters are not compatible with
+     * the desired profile or if the desired profile is not supported,
+     * but it may also fail silently
+     * (where the encoder ends up using a different, compatible profile.)
+     *
+     * It is recommended that the profile is set for all encoders.
+     * For more information, see the *Encoder Profiles* section of the
+     * [`MediaCodec`](https://developer.android.com/reference/android/media/MediaCodec)
+     * API reference.
+     */
+    setProfile(value: number | undefined): this {
+        if (value === undefined) {
+            this.delete("profile");
+            return this;
+        }
+        return this.setInt("profile", value);
+    }
+
+    /**
+     * Applies only when configuring a video encoder in "surface-input" mode.
+     * The associated value is a long and gives the time in microseconds
+     * after which the frame previously submitted to the encoder will be repeated (once)
+     * if no new frame became available since.
+     */
+    setRepeatPreviousFrameAfter(value: bigint | undefined): this {
+        if (value === undefined) {
+            this.delete("repeat-previous-frame-after");
+            return this;
+        }
+        return this.setLong("repeat-previous-frame-after", value);
+    }
+}

package/src/1_15/impl/compute-option-values.ts

@@ -0,0 +1,26 @@
+// Distributive Conditional Types
+// (https://www.typescriptlang.org/docs/handbook/2/conditional-types.html#distributive-conditional-types)
+type ComputeOptionType<T, TDefault> = T extends undefined ? TDefault : T;
+
+export type ComputeOptionTypes<T extends object, TDefaults extends object> = {
+    [K in keyof TDefaults]: K extends keyof T
+        ? ComputeOptionType<T[K], TDefaults[K]>
+        : TDefaults[K];
+};
+
+export function computeOptionValues<T extends object, TDefaults extends object>(
+    options: T,
+    defaults: TDefaults,
+): ComputeOptionTypes<T, TDefaults> {
+    return Object.fromEntries(
+        Object.entries(defaults).map(([key, value]) => {
+            if (key in options) {
+                const optionValue = options[key as keyof T];
+                if (optionValue !== undefined) {
+                    return [key, optionValue];
+                }
+            }
+            return [key, value];
+        }),
+    ) as never;
+}

package/src/1_15/impl/control-message-types.ts

@@ -1,16 +1,16 @@
+import type { ScrcpyControlMessageTypeMap } from "../../base/index.js";
 import { ScrcpyControlMessageType } from "../../base/index.js";
 
-export const ControlMessageTypes: readonly ScrcpyControlMessageType[] =
-    /* #__PURE__ */ (() => [
-        /*  0 */ ScrcpyControlMessageType.InjectKeyCode,
-        /*  1 */ ScrcpyControlMessageType.InjectText,
-        /*  2 */ ScrcpyControlMessageType.InjectTouch,
-        /*  3 */ ScrcpyControlMessageType.InjectScroll,
-        /*  4 */ ScrcpyControlMessageType.BackOrScreenOn,
-        /*  5 */ ScrcpyControlMessageType.ExpandNotificationPanel,
-        /*  6 */ ScrcpyControlMessageType.CollapseNotificationPanel,
-        /*  7 */ ScrcpyControlMessageType.GetClipboard,
-        /*  8 */ ScrcpyControlMessageType.SetClipboard,
-        /*  9 */ ScrcpyControlMessageType.SetDisplayPower,
-        /* 10 */ ScrcpyControlMessageType.RotateDevice,
-    ])();
+export const ControlMessageTypes = {
+    [ScrcpyControlMessageType.InjectKeyCode]: 0,
+    [ScrcpyControlMessageType.InjectText]: 1,
+    [ScrcpyControlMessageType.InjectTouch]: 2,
+    [ScrcpyControlMessageType.InjectScroll]: 3,
+    [ScrcpyControlMessageType.BackOrScreenOn]: 4,
+    [ScrcpyControlMessageType.ExpandNotificationPanel]: 5,
+    [ScrcpyControlMessageType.CollapseNotificationPanel]: 6,
+    [ScrcpyControlMessageType.GetClipboard]: 7,
+    [ScrcpyControlMessageType.SetClipboard]: 8,
+    [ScrcpyControlMessageType.SetDisplayPower]: 9,
+    [ScrcpyControlMessageType.RotateDevice]: 10,
+} as const satisfies ScrcpyControlMessageTypeMap;

package/src/1_15/impl/index.ts

@@ -1,5 +1,7 @@
 export * from "./back-or-screen-on.js";
 export * from "./clipboard-stream.js";
+export * from "./codec-options.js";
+export * from "./compute-option-values.js";
 export * from "./control-message-types.js";
 export * from "./defaults.js";
 export * from "./init.js";
@@ -11,4 +13,5 @@ export * from "./scroll-controller.js";
 export * from "./serialize-order.js";
 export * from "./serialize.js";
 export * from "./set-clipboard.js";
+export * from "./set-display-power.js";
 export * from "./set-list-display.js";

package/src/1_15/impl/init.ts

@@ -1,5 +1,7 @@
 import type { ScrcpyOptionValue } from "../../base/index.js";
 
+import type { CodecOptions } from "./codec-options.js";
+
 export const VideoOrientation = {
     Unlocked: -1,
     Portrait: 0,
@@ -13,82 +15,6 @@ export type VideoOrientation =
 
 export type LogLevel = "debug" | "info" | "warn" | "error";
 
-/**
- * If the option you need is not in this type,
- * please file an issue on GitHub.
- */
-export interface CodecOptionsInit {
-    profile?: number | undefined;
-    level?: number | undefined;
-
-    iFrameInterval?: number | undefined;
-    maxBframes?: number | undefined;
-    repeatPreviousFrameAfter?: number | undefined;
-    maxPtsGapToEncoder?: number | undefined;
-    intraRefreshPeriod?: number | undefined;
-}
-
-function toDashCase(input: string) {
-    return input.replace(/([A-Z])/g, "-$1").toLowerCase();
-}
-
-const CodecOptionTypes: Partial<
-    Record<keyof CodecOptionsInit, "long" | "float" | "string">
-> = {
-    repeatPreviousFrameAfter: "long",
-    maxPtsGapToEncoder: "long",
-};
-
-export class CodecOptions implements ScrcpyOptionValue {
-    static Empty = /* #__PURE__ */ new CodecOptions();
-
-    options: CodecOptionsInit;
-
-    constructor(options: CodecOptionsInit = {}) {
-        for (const [key, value] of Object.entries(options)) {
-            if (value === undefined) {
-                continue;
-            }
-
-            if (typeof value !== "number") {
-                throw new Error(
-                    `Invalid option value for ${key}: ${String(value)}`,
-                );
-            }
-        }
-
-        this.options = options;
-    }
-
-    toOptionValue(): string | undefined {
-        const entries = Object.entries(this.options).filter(
-            ([, value]) => value !== undefined,
-        );
-
-        if (entries.length === 0) {
-            return undefined;
-        }
-
-        return entries
-            .map(([key, value]) => {
-                let result = toDashCase(key);
-
-                const type = CodecOptionTypes[key as keyof CodecOptionsInit];
-                if (type) {
-                    result += `:${type}`;
-                }
-
-                result += `=${value}`;
-                return result;
-            })
-            .join(",");
-    }
-}
-
-export namespace CodecOptions {
-    export type Init = CodecOptionsInit;
-}
-
 export class Crop implements ScrcpyOptionValue {
     width: number;
     height: number;
@@ -108,21 +34,21 @@ export class Crop implements ScrcpyOptionValue {
 }
 
 export interface Init {
-    logLevel?: LogLevel;
+    logLevel?: LogLevel | undefined;
 
     /**
      * The maximum value of both width and height.
      */
-    maxSize?: number;
+    maxSize?: number | undefined;
 
-    bitRate?: number;
+    bitRate?: number | undefined;
 
     /**
      * 0 for unlimited.
      *
      * @default 0
      */
-    maxFps?: number;
+    maxFps?: number | undefined;
 
     /**
      * The orientation of the video stream.
@@ -130,7 +56,7 @@ export interface Init {
      * It will not keep the device screen in specific orientation,
      * only the captured video will in this orientation.
      */
-    lockVideoOrientation?: VideoOrientation;
+    lockVideoOrientation?: VideoOrientation | undefined;
 
     /**
      * Use ADB forward tunnel instead of reverse tunnel.
@@ -140,7 +66,7 @@ export interface Init {
      *
      * When using `AdbScrcpyClient`, it can detect this situation and enable this option automatically.
      */
-    tunnelForward?: boolean;
+    tunnelForward?: boolean | undefined;
 
     crop?: Crop | string | undefined;
 
@@ -155,18 +81,18 @@ export interface Init {
      *
      * @default true
      */
-    sendFrameMeta?: boolean;
+    sendFrameMeta?: boolean | undefined;
 
     /**
      * @default true
      */
-    control?: boolean;
+    control?: boolean | undefined;
 
-    displayId?: number;
+    displayId?: number | undefined;
 
-    showTouches?: boolean;
+    showTouches?: boolean | undefined;
 
-    stayAwake?: boolean;
+    stayAwake?: boolean | undefined;
 
     codecOptions?: CodecOptions | string | undefined;
 }

package/src/1_15/impl/inject-touch.ts

@@ -32,6 +32,7 @@ export const PointerId = {
 
 export const InjectTouchControlMessage = struct(
     {
+        // value of `type` can change between versions
         type: u8,
         action: u8<AndroidMotionEventAction>(),
         pointerId: u64,