assistsx-js 0.1.29 → 0.1.31

package/dist/AssistsX.d.ts

@@ -38,11 +38,19 @@ export type AccessibilityEventListener = (event: AccessibilityEvent) => void;
 export interface WebFloatingWindowOptions {
     initialWidth?: number;
     initialHeight?: number;
+    /** Initial window X position (default 0) */
+    initialX?: number;
+    /** Initial window Y position (default 0) */
+    initialY?: number;
     minWidth?: number;
     minHeight?: number;
     maxWidth?: number;
     maxHeight?: number;
     initialCenter?: boolean;
+    /** Whether to show top operation area (title bar, close button, etc.) */
+    showTopOperationArea?: boolean;
+    /** Whether to show bottom operation area (zoom, back/forward/refresh, etc.) */
+    showBottomOperationArea?: boolean;
 }
 export declare const callbacks: Map<string, (data: string) => void>;
 export declare const accessibilityEventListeners: AccessibilityEventListener[];

package/dist/AssistsX.js

@@ -240,17 +240,21 @@ export class AssistsX {
         return data.value;
     }
     static async loadWebViewOverlay(url, options = {}) {
-        const { initialWidth, initialHeight, minWidth, minHeight, maxWidth, maxHeight, initialCenter, timeout, } = options;
+        const { initialWidth, initialHeight, initialX, initialY, minWidth, minHeight, maxWidth, maxHeight, initialCenter, showTopOperationArea, showBottomOperationArea, timeout, } = options;
         const response = await this.asyncCall(CallMethod.loadWebViewOverlay, {
             args: {
                 url,
                 initialWidth,
                 initialHeight,
+                initialX,
+                initialY,
                 minWidth,
                 minHeight,
                 maxWidth,
                 maxHeight,
                 initialCenter,
+                showTopOperationArea,
+                showBottomOperationArea,
             },
             timeout,
         });

package/dist/AssistsXAsync.js

@@ -203,17 +203,21 @@ export class AssistsXAsync {
         return data.value;
     }
     static async loadWebViewOverlay(url, options = {}) {
-        const { initialWidth, initialHeight, minWidth, minHeight, maxWidth, maxHeight, initialCenter, timeout, } = options;
+        const { initialWidth, initialHeight, initialX, initialY, minWidth, minHeight, maxWidth, maxHeight, initialCenter, showTopOperationArea, showBottomOperationArea, timeout, } = options;
         const response = await this.asyncCall(CallMethod.loadWebViewOverlay, {
             args: {
                 url,
                 initialWidth,
                 initialHeight,
+                initialX,
+                initialY,
                 minWidth,
                 minHeight,
                 maxWidth,
                 maxHeight,
                 initialCenter,
+                showTopOperationArea,
+                showBottomOperationArea,
             },
             timeout,
         });

package/dist/barutils/BarUtilsCallMethod.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Bar utils (status bar, nav bar, action bar) method constants.
+ * Matches BarUtilsCallMethod in Kotlin.
+ */
+export declare const BarUtilsCallMethod: {
+    readonly getStatusBarHeight: "getStatusBarHeight";
+    readonly setStatusBarVisibility: "setStatusBarVisibility";
+    readonly isStatusBarVisible: "isStatusBarVisible";
+    readonly setStatusBarLightMode: "setStatusBarLightMode";
+    readonly isStatusBarLightMode: "isStatusBarLightMode";
+    readonly setStatusBarColor: "setStatusBarColor";
+    readonly transparentStatusBar: "transparentStatusBar";
+    readonly getActionBarHeight: "getActionBarHeight";
+    readonly getNavBarHeight: "getNavBarHeight";
+    readonly setNavBarVisibility: "setNavBarVisibility";
+    readonly isNavBarVisible: "isNavBarVisible";
+    readonly setNavBarColor: "setNavBarColor";
+    readonly getNavBarColor: "getNavBarColor";
+    readonly isSupportNavBar: "isSupportNavBar";
+    readonly setNavBarLightMode: "setNavBarLightMode";
+    readonly isNavBarLightMode: "isNavBarLightMode";
+    readonly transparentNavBar: "transparentNavBar";
+};
+export type BarUtilsCallMethodType = (typeof BarUtilsCallMethod)[keyof typeof BarUtilsCallMethod];

package/dist/barutils/BarUtilsCallMethod.js

@@ -0,0 +1,26 @@
+/**
+ * Bar utils (status bar, nav bar, action bar) method constants.
+ * Matches BarUtilsCallMethod in Kotlin.
+ */
+export const BarUtilsCallMethod = {
+    // Status bar
+    getStatusBarHeight: "getStatusBarHeight",
+    setStatusBarVisibility: "setStatusBarVisibility",
+    isStatusBarVisible: "isStatusBarVisible",
+    setStatusBarLightMode: "setStatusBarLightMode",
+    isStatusBarLightMode: "isStatusBarLightMode",
+    setStatusBarColor: "setStatusBarColor",
+    transparentStatusBar: "transparentStatusBar",
+    // ActionBar
+    getActionBarHeight: "getActionBarHeight",
+    // Nav bar
+    getNavBarHeight: "getNavBarHeight",
+    setNavBarVisibility: "setNavBarVisibility",
+    isNavBarVisible: "isNavBarVisible",
+    setNavBarColor: "setNavBarColor",
+    getNavBarColor: "getNavBarColor",
+    isSupportNavBar: "isSupportNavBar",
+    setNavBarLightMode: "setNavBarLightMode",
+    isNavBarLightMode: "isNavBarLightMode",
+    transparentNavBar: "transparentNavBar",
+};

package/dist/barutils/bar-utils.d.ts

@@ -0,0 +1,41 @@
+export declare class BarUtils {
+    private asyncCall;
+    private errorMessage;
+    /** Get status bar height in px. */
+    getStatusBarHeight(timeout?: number): Promise<number>;
+    /** Set status bar visibility. */
+    setStatusBarVisibility(isVisible?: boolean, timeout?: number): Promise<void>;
+    /** Check if status bar is visible. */
+    isStatusBarVisible(timeout?: number): Promise<boolean>;
+    /** Set status bar light mode (light content on dark background). */
+    setStatusBarLightMode(isLightMode?: boolean, timeout?: number): Promise<void>;
+    /** Check if status bar is in light mode. */
+    isStatusBarLightMode(timeout?: number): Promise<boolean>;
+    /** Set status bar color. color: Android color int (e.g. 0xff0000). isDecor: whether to apply to decor. */
+    setStatusBarColor(color: number, options?: {
+        isDecor?: boolean;
+    }, timeout?: number): Promise<void>;
+    /** Make status bar transparent. */
+    transparentStatusBar(timeout?: number): Promise<void>;
+    /** Get action bar height in px. */
+    getActionBarHeight(timeout?: number): Promise<number>;
+    /** Get navigation bar height in px. */
+    getNavBarHeight(timeout?: number): Promise<number>;
+    /** Set navigation bar visibility. */
+    setNavBarVisibility(isVisible?: boolean, timeout?: number): Promise<void>;
+    /** Check if navigation bar is visible. */
+    isNavBarVisible(timeout?: number): Promise<boolean>;
+    /** Set navigation bar color. color: Android color int. */
+    setNavBarColor(color: number, timeout?: number): Promise<void>;
+    /** Get current navigation bar color. */
+    getNavBarColor(timeout?: number): Promise<number>;
+    /** Check if device supports navigation bar. */
+    isSupportNavBar(timeout?: number): Promise<boolean>;
+    /** Set navigation bar light mode. */
+    setNavBarLightMode(isLightMode?: boolean, timeout?: number): Promise<void>;
+    /** Check if navigation bar is in light mode. */
+    isNavBarLightMode(timeout?: number): Promise<boolean>;
+    /** Make navigation bar transparent. */
+    transparentNavBar(timeout?: number): Promise<void>;
+}
+export declare const barUtils: BarUtils;

package/dist/barutils/bar-utils.js

@@ -0,0 +1,205 @@
+/**
+ * Bar utils (status bar, nav bar, action bar) for WebView.
+ * Requires Activity context on native side. Matches BarUtilsJavascriptInterface.kt.
+ */
+import { CallResponse } from "../CallResponse";
+import { decodeBase64UTF8, generateUUID } from "../Utils";
+import { BarUtilsCallMethod } from "./BarUtilsCallMethod";
+const callbacks = new Map();
+if (typeof window !== "undefined" && !window.assistsxBarUtilsCallback) {
+    window.assistsxBarUtilsCallback = (data) => {
+        let callbackId;
+        try {
+            const json = decodeBase64UTF8(data);
+            const response = JSON.parse(json);
+            callbackId = response.callbackId;
+            if (callbackId) {
+                const callback = callbacks.get(callbackId);
+                if (callback) {
+                    callback(json);
+                }
+            }
+        }
+        catch (e) {
+            console.error("BarUtils callback error:", e);
+        }
+        finally {
+            if (callbackId) {
+                callbacks.delete(callbackId);
+            }
+        }
+    };
+}
+export class BarUtils {
+    async asyncCall(method, args, timeout = 30) {
+        const uuid = generateUUID();
+        const params = {
+            method,
+            arguments: args !== null && args !== void 0 ? args : undefined,
+            callbackId: uuid,
+        };
+        const promise = new Promise((resolve) => {
+            callbacks.set(uuid, (data) => {
+                resolve(data);
+            });
+            setTimeout(() => {
+                callbacks.delete(uuid);
+                resolve(JSON.stringify(new CallResponse(-1, { message: "Timeout" }, uuid)));
+            }, timeout * 1000);
+        });
+        window.assistsxBarUtils.call(JSON.stringify(params));
+        const promiseResult = await promise;
+        if (typeof promiseResult === "string") {
+            const responseData = JSON.parse(promiseResult);
+            const data = responseData.code !== 0 && responseData.message != null
+                ? { message: responseData.message }
+                : responseData.data;
+            return new CallResponse(responseData.code, data, responseData.callbackId);
+        }
+        throw new Error("BarUtils call failed");
+    }
+    errorMessage(res, fallback) {
+        const d = res.getDataOrNull();
+        if (d &&
+            typeof d === "object" &&
+            typeof d.message === "string") {
+            return d.message;
+        }
+        if (typeof d === "string")
+            return d;
+        return fallback;
+    }
+    // --- Status bar ---
+    /** Get status bar height in px. */
+    async getStatusBarHeight(timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.getStatusBarHeight, undefined, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "getStatusBarHeight failed"));
+        }
+        return res.getData().height;
+    }
+    /** Set status bar visibility. */
+    async setStatusBarVisibility(isVisible = true, timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.setStatusBarVisibility, { isVisible }, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "setStatusBarVisibility failed"));
+        }
+    }
+    /** Check if status bar is visible. */
+    async isStatusBarVisible(timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.isStatusBarVisible, undefined, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "isStatusBarVisible failed"));
+        }
+        return res.getData().visible;
+    }
+    /** Set status bar light mode (light content on dark background). */
+    async setStatusBarLightMode(isLightMode = true, timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.setStatusBarLightMode, { isLightMode }, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "setStatusBarLightMode failed"));
+        }
+    }
+    /** Check if status bar is in light mode. */
+    async isStatusBarLightMode(timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.isStatusBarLightMode, undefined, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "isStatusBarLightMode failed"));
+        }
+        return res.getData().isLightMode;
+    }
+    /** Set status bar color. color: Android color int (e.g. 0xff0000). isDecor: whether to apply to decor. */
+    async setStatusBarColor(color, options, timeout) {
+        var _a;
+        const res = await this.asyncCall(BarUtilsCallMethod.setStatusBarColor, { color, isDecor: (_a = options === null || options === void 0 ? void 0 : options.isDecor) !== null && _a !== void 0 ? _a : false }, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "setStatusBarColor failed"));
+        }
+    }
+    /** Make status bar transparent. */
+    async transparentStatusBar(timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.transparentStatusBar, undefined, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "transparentStatusBar failed"));
+        }
+    }
+    // --- ActionBar ---
+    /** Get action bar height in px. */
+    async getActionBarHeight(timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.getActionBarHeight, undefined, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "getActionBarHeight failed"));
+        }
+        return res.getData().height;
+    }
+    // --- Nav bar ---
+    /** Get navigation bar height in px. */
+    async getNavBarHeight(timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.getNavBarHeight, undefined, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "getNavBarHeight failed"));
+        }
+        return res.getData().height;
+    }
+    /** Set navigation bar visibility. */
+    async setNavBarVisibility(isVisible = true, timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.setNavBarVisibility, { isVisible }, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "setNavBarVisibility failed"));
+        }
+    }
+    /** Check if navigation bar is visible. */
+    async isNavBarVisible(timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.isNavBarVisible, undefined, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "isNavBarVisible failed"));
+        }
+        return res.getData().visible;
+    }
+    /** Set navigation bar color. color: Android color int. */
+    async setNavBarColor(color, timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.setNavBarColor, { color }, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "setNavBarColor failed"));
+        }
+    }
+    /** Get current navigation bar color. */
+    async getNavBarColor(timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.getNavBarColor, undefined, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "getNavBarColor failed"));
+        }
+        return res.getData().color;
+    }
+    /** Check if device supports navigation bar. */
+    async isSupportNavBar(timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.isSupportNavBar, undefined, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "isSupportNavBar failed"));
+        }
+        return res.getData().support;
+    }
+    /** Set navigation bar light mode. */
+    async setNavBarLightMode(isLightMode = true, timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.setNavBarLightMode, { isLightMode }, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "setNavBarLightMode failed"));
+        }
+    }
+    /** Check if navigation bar is in light mode. */
+    async isNavBarLightMode(timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.isNavBarLightMode, undefined, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "isNavBarLightMode failed"));
+        }
+        return res.getData().isLightMode;
+    }
+    /** Make navigation bar transparent. */
+    async transparentNavBar(timeout) {
+        const res = await this.asyncCall(BarUtilsCallMethod.transparentNavBar, undefined, timeout);
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "transparentNavBar failed"));
+        }
+    }
+}
+export const barUtils = new BarUtils();

package/dist/index.d.ts

@@ -24,3 +24,5 @@ export * from "./imageutils/image-utils";
 export * from "./gallery/gallery";
 export * from "./mlkit/mlkit";
 export * from "./mlkit/MlkitCallMethod";
+export * from "./barutils/bar-utils";
+export * from "./barutils/BarUtilsCallMethod";

package/dist/index.js

@@ -24,3 +24,5 @@ export * from "./imageutils/image-utils";
 export * from "./gallery/gallery";
 export * from "./mlkit/mlkit";
 export * from "./mlkit/MlkitCallMethod";
+export * from "./barutils/bar-utils";
+export * from "./barutils/BarUtilsCallMethod";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "assistsx-js",
-    "version": "0.1.29",
+    "version": "0.1.31",
     "description": "assistsx-js自动化开发SDK",
     "main": "dist/index.js",
     "module": "dist/index.js",

package/src/AssistsX.ts

@@ -44,11 +44,19 @@ export type AccessibilityEventListener = (event: AccessibilityEvent) => void;
 export interface WebFloatingWindowOptions {
     initialWidth?: number;
     initialHeight?: number;
+    /** Initial window X position (default 0) */
+    initialX?: number;
+    /** Initial window Y position (default 0) */
+    initialY?: number;
     minWidth?: number;
     minHeight?: number;
     maxWidth?: number;
     maxHeight?: number;
     initialCenter?: boolean;
+    /** Whether to show top operation area (title bar, close button, etc.) */
+    showTopOperationArea?: boolean;
+    /** Whether to show bottom operation area (zoom, back/forward/refresh, etc.) */
+    showBottomOperationArea?: boolean;
 }
 
 // 回调函数存储对象
@@ -336,11 +344,15 @@ export class AssistsX {
         const {
             initialWidth,
             initialHeight,
+            initialX,
+            initialY,
             minWidth,
             minHeight,
             maxWidth,
             maxHeight,
             initialCenter,
+            showTopOperationArea,
+            showBottomOperationArea,
             timeout,
         } = options;
         const response = await this.asyncCall(CallMethod.loadWebViewOverlay, {
@@ -348,11 +360,15 @@ export class AssistsX {
                 url,
                 initialWidth,
                 initialHeight,
+                initialX,
+                initialY,
                 minWidth,
                 minHeight,
                 maxWidth,
                 maxHeight,
                 initialCenter,
+                showTopOperationArea,
+                showBottomOperationArea,
             },
             timeout,
         });

package/src/AssistsXAsync.ts

@@ -354,11 +354,15 @@ export class AssistsXAsync {
         const {
             initialWidth,
             initialHeight,
+            initialX,
+            initialY,
             minWidth,
             minHeight,
             maxWidth,
             maxHeight,
             initialCenter,
+            showTopOperationArea,
+            showBottomOperationArea,
             timeout,
         } = options;
         const response = await this.asyncCall(CallMethod.loadWebViewOverlay, {
@@ -366,11 +370,15 @@ export class AssistsXAsync {
                 url,
                 initialWidth,
                 initialHeight,
+                initialX,
+                initialY,
                 minWidth,
                 minHeight,
                 maxWidth,
                 maxHeight,
                 initialCenter,
+                showTopOperationArea,
+                showBottomOperationArea,
             },
             timeout,
         });

package/src/barutils/BarUtilsCallMethod.ts

@@ -0,0 +1,31 @@
+/**
+ * Bar utils (status bar, nav bar, action bar) method constants.
+ * Matches BarUtilsCallMethod in Kotlin.
+ */
+export const BarUtilsCallMethod = {
+    // Status bar
+    getStatusBarHeight: "getStatusBarHeight",
+    setStatusBarVisibility: "setStatusBarVisibility",
+    isStatusBarVisible: "isStatusBarVisible",
+    setStatusBarLightMode: "setStatusBarLightMode",
+    isStatusBarLightMode: "isStatusBarLightMode",
+    setStatusBarColor: "setStatusBarColor",
+    transparentStatusBar: "transparentStatusBar",
+
+    // ActionBar
+    getActionBarHeight: "getActionBarHeight",
+
+    // Nav bar
+    getNavBarHeight: "getNavBarHeight",
+    setNavBarVisibility: "setNavBarVisibility",
+    isNavBarVisible: "isNavBarVisible",
+    setNavBarColor: "setNavBarColor",
+    getNavBarColor: "getNavBarColor",
+    isSupportNavBar: "isSupportNavBar",
+    setNavBarLightMode: "setNavBarLightMode",
+    isNavBarLightMode: "isNavBarLightMode",
+    transparentNavBar: "transparentNavBar",
+} as const;
+
+export type BarUtilsCallMethodType =
+    (typeof BarUtilsCallMethod)[keyof typeof BarUtilsCallMethod];

package/src/barutils/bar-utils.ts

@@ -0,0 +1,357 @@
+/**
+ * Bar utils (status bar, nav bar, action bar) for WebView.
+ * Requires Activity context on native side. Matches BarUtilsJavascriptInterface.kt.
+ */
+import { CallResponse } from "../CallResponse";
+import { decodeBase64UTF8, generateUUID } from "../Utils";
+import { BarUtilsCallMethod } from "./BarUtilsCallMethod";
+
+const callbacks: Map<string, (data: string) => void> = new Map();
+
+if (typeof window !== "undefined" && !(window as any).assistsxBarUtilsCallback) {
+    (window as any).assistsxBarUtilsCallback = (data: string) => {
+        let callbackId: string | undefined;
+        try {
+            const json = decodeBase64UTF8(data);
+            const response = JSON.parse(json);
+            callbackId = response.callbackId;
+            if (callbackId) {
+                const callback = callbacks.get(callbackId);
+                if (callback) {
+                    callback(json);
+                }
+            }
+        } catch (e) {
+            console.error("BarUtils callback error:", e);
+        } finally {
+            if (callbackId) {
+                callbacks.delete(callbackId);
+            }
+        }
+    };
+}
+
+export class BarUtils {
+    private async asyncCall(
+        method: string,
+        args?: Record<string, unknown>,
+        timeout: number = 30
+    ): Promise<CallResponse> {
+        const uuid = generateUUID();
+        const params = {
+            method,
+            arguments: args ?? undefined,
+            callbackId: uuid,
+        };
+        const promise = new Promise<string>((resolve) => {
+            callbacks.set(uuid, (data: string) => {
+                resolve(data);
+            });
+            setTimeout(() => {
+                callbacks.delete(uuid);
+                resolve(
+                    JSON.stringify(
+                        new CallResponse(-1, { message: "Timeout" }, uuid)
+                    )
+                );
+            }, timeout * 1000);
+        });
+        (window as any).assistsxBarUtils.call(JSON.stringify(params));
+        const promiseResult = await promise;
+        if (typeof promiseResult === "string") {
+            const responseData = JSON.parse(promiseResult);
+            const data =
+                responseData.code !== 0 && responseData.message != null
+                    ? { message: responseData.message }
+                    : responseData.data;
+            return new CallResponse(
+                responseData.code,
+                data,
+                responseData.callbackId
+            );
+        }
+        throw new Error("BarUtils call failed");
+    }
+
+    private errorMessage(res: CallResponse, fallback: string): string {
+        const d = res.getDataOrNull();
+        if (
+            d &&
+            typeof d === "object" &&
+            typeof (d as { message?: string }).message === "string"
+        ) {
+            return (d as { message: string }).message;
+        }
+        if (typeof d === "string") return d;
+        return fallback;
+    }
+
+    // --- Status bar ---
+
+    /** Get status bar height in px. */
+    async getStatusBarHeight(timeout?: number): Promise<number> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.getStatusBarHeight,
+            undefined,
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(this.errorMessage(res, "getStatusBarHeight failed"));
+        }
+        return (res.getData() as { height: number }).height;
+    }
+
+    /** Set status bar visibility. */
+    async setStatusBarVisibility(
+        isVisible: boolean = true,
+        timeout?: number
+    ): Promise<void> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.setStatusBarVisibility,
+            { isVisible },
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "setStatusBarVisibility failed")
+            );
+        }
+    }
+
+    /** Check if status bar is visible. */
+    async isStatusBarVisible(timeout?: number): Promise<boolean> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.isStatusBarVisible,
+            undefined,
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "isStatusBarVisible failed")
+            );
+        }
+        return (res.getData() as { visible: boolean }).visible;
+    }
+
+    /** Set status bar light mode (light content on dark background). */
+    async setStatusBarLightMode(
+        isLightMode: boolean = true,
+        timeout?: number
+    ): Promise<void> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.setStatusBarLightMode,
+            { isLightMode },
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "setStatusBarLightMode failed")
+            );
+        }
+    }
+
+    /** Check if status bar is in light mode. */
+    async isStatusBarLightMode(timeout?: number): Promise<boolean> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.isStatusBarLightMode,
+            undefined,
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "isStatusBarLightMode failed")
+            );
+        }
+        return (res.getData() as { isLightMode: boolean }).isLightMode;
+    }
+
+    /** Set status bar color. color: Android color int (e.g. 0xff0000). isDecor: whether to apply to decor. */
+    async setStatusBarColor(
+        color: number,
+        options?: { isDecor?: boolean },
+        timeout?: number
+    ): Promise<void> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.setStatusBarColor,
+            { color, isDecor: options?.isDecor ?? false },
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "setStatusBarColor failed")
+            );
+        }
+    }
+
+    /** Make status bar transparent. */
+    async transparentStatusBar(timeout?: number): Promise<void> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.transparentStatusBar,
+            undefined,
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "transparentStatusBar failed")
+            );
+        }
+    }
+
+    // --- ActionBar ---
+
+    /** Get action bar height in px. */
+    async getActionBarHeight(timeout?: number): Promise<number> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.getActionBarHeight,
+            undefined,
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "getActionBarHeight failed")
+            );
+        }
+        return (res.getData() as { height: number }).height;
+    }
+
+    // --- Nav bar ---
+
+    /** Get navigation bar height in px. */
+    async getNavBarHeight(timeout?: number): Promise<number> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.getNavBarHeight,
+            undefined,
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "getNavBarHeight failed")
+            );
+        }
+        return (res.getData() as { height: number }).height;
+    }
+
+    /** Set navigation bar visibility. */
+    async setNavBarVisibility(
+        isVisible: boolean = true,
+        timeout?: number
+    ): Promise<void> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.setNavBarVisibility,
+            { isVisible },
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "setNavBarVisibility failed")
+            );
+        }
+    }
+
+    /** Check if navigation bar is visible. */
+    async isNavBarVisible(timeout?: number): Promise<boolean> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.isNavBarVisible,
+            undefined,
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "isNavBarVisible failed")
+            );
+        }
+        return (res.getData() as { visible: boolean }).visible;
+    }
+
+    /** Set navigation bar color. color: Android color int. */
+    async setNavBarColor(color: number, timeout?: number): Promise<void> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.setNavBarColor,
+            { color },
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "setNavBarColor failed")
+            );
+        }
+    }
+
+    /** Get current navigation bar color. */
+    async getNavBarColor(timeout?: number): Promise<number> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.getNavBarColor,
+            undefined,
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "getNavBarColor failed")
+            );
+        }
+        return (res.getData() as { color: number }).color;
+    }
+
+    /** Check if device supports navigation bar. */
+    async isSupportNavBar(timeout?: number): Promise<boolean> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.isSupportNavBar,
+            undefined,
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "isSupportNavBar failed")
+            );
+        }
+        return (res.getData() as { support: boolean }).support;
+    }
+
+    /** Set navigation bar light mode. */
+    async setNavBarLightMode(
+        isLightMode: boolean = true,
+        timeout?: number
+    ): Promise<void> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.setNavBarLightMode,
+            { isLightMode },
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "setNavBarLightMode failed")
+            );
+        }
+    }
+
+    /** Check if navigation bar is in light mode. */
+    async isNavBarLightMode(timeout?: number): Promise<boolean> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.isNavBarLightMode,
+            undefined,
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "isNavBarLightMode failed")
+            );
+        }
+        return (res.getData() as { isLightMode: boolean }).isLightMode;
+    }
+
+    /** Make navigation bar transparent. */
+    async transparentNavBar(timeout?: number): Promise<void> {
+        const res = await this.asyncCall(
+            BarUtilsCallMethod.transparentNavBar,
+            undefined,
+            timeout
+        );
+        if (!res.isSuccess()) {
+            throw new Error(
+                this.errorMessage(res, "transparentNavBar failed")
+            );
+        }
+    }
+}
+
+export const barUtils = new BarUtils();

package/src/global.d.ts

@@ -43,6 +43,10 @@ declare global {
             call(method: string): string | null;
         };
         assistsxMlkitCallback: (data: string) => void;
+        assistsxBarUtils: {
+            call(method: string): string | null;
+        };
+        assistsxBarUtilsCallback: (data: string) => void;
     }
 }
 

package/src/index.ts

@@ -23,4 +23,6 @@ export * from "./ime/ime";
 export * from "./imageutils/image-utils";
 export * from "./gallery/gallery";
 export * from "./mlkit/mlkit";
-export * from "./mlkit/MlkitCallMethod";
+export * from "./mlkit/MlkitCallMethod";
+export * from "./barutils/bar-utils";
+export * from "./barutils/BarUtilsCallMethod";