@flighthq/statusbar 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './statusbar';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './statusbar';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/statusbar.d.ts

@@ -0,0 +1,18 @@
+import type { StatusBar, StatusBarAnimation, StatusBarBackend, StatusBarInfo, StatusBarStyle, StatusBarStyleEntry, StatusBarStyleEntryHandle } from '@flighthq/types';
+export declare function attachStatusBar(bar: StatusBar): void;
+export declare function createStatusBar(): StatusBar;
+export declare function createStatusBarInfo(): StatusBarInfo;
+export declare function createWebStatusBarBackend(): StatusBarBackend;
+export declare function detachStatusBar(bar: StatusBar): void;
+export declare function disposeStatusBar(bar: StatusBar): void;
+export declare function getStatusBarBackend(): StatusBarBackend;
+export declare function getStatusBarHeight(): number;
+export declare function getStatusBarInfo(out: StatusBarInfo): StatusBarInfo;
+export declare function popStatusBarStyleEntry(handle: StatusBarStyleEntryHandle): void;
+export declare function pushStatusBarStyleEntry(entry: Readonly<StatusBarStyleEntry>): StatusBarStyleEntryHandle;
+export declare function setStatusBarBackend(backend: StatusBarBackend | null): void;
+export declare function setStatusBarColor(color: number, animated?: boolean): void;
+export declare function setStatusBarOverlaysContent(overlay: boolean): void;
+export declare function setStatusBarStyle(style: StatusBarStyle): void;
+export declare function setStatusBarVisible(visible: boolean, animation?: StatusBarAnimation): void;
+//# sourceMappingURL=statusbar.d.ts.map

package/dist/statusbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusbar.d.ts","sourceRoot":"","sources":["../src/statusbar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,iBAAiB,CAAC;AAKzB,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAQpD;AAGD,wBAAgB,eAAe,IAAI,SAAS,CAI3C;AAID,wBAAgB,mBAAmB,IAAI,aAAa,CAQnD;AAMD,wBAAgB,yBAAyB,IAAI,gBAAgB,CAsC5D;AAGD,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAMpD;AAID,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAErD;AAGD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD;AAOD,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAID,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAElE;AAID,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAM9E;AAKD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,yBAAyB,CAKvG;AAGD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAE1E;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAEzE;AAGD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAElE;AAGD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAE7D;AAGD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAE1F"}

package/dist/statusbar.js

@@ -0,0 +1,213 @@
+import { createSignal, emitSignal } from '@flighthq/signals';
+// Begins delivering OS-driven status bar changes to `bar`'s signals by subscribing to the active
+// backend. Idempotent: a prior subscription is torn down first. Pair with detachStatusBar /
+// disposeStatusBar.
+export function attachStatusBar(bar) {
+    detachStatusBar(bar);
+    const backend = getStatusBarBackend();
+    const unsubscribe = backend.subscribe(() => {
+        const info = backend.getInfo(_scratchInfo);
+        emitSignal(bar.onChange, info);
+    });
+    _subscriptions.set(bar, unsubscribe);
+}
+// Allocates a StatusBar event entity with inert signals; call attachStatusBar to start delivery.
+export function createStatusBar() {
+    return {
+        onChange: createSignal(),
+    };
+}
+// Allocates a zeroed StatusBarInfo, suitable as the `out` for getStatusBarInfo.
+// height defaults to -1 (unknown), color to 0 (transparent black), style to 'default'.
+export function createStatusBarInfo() {
+    return {
+        color: 0,
+        height: -1,
+        overlaysContent: false,
+        style: 'default',
+        visible: true,
+    };
+}
+// Builds the default web backend. Web pages have no true status bar, so only setBackgroundColor does
+// anything observable: it upserts a <meta name="theme-color"> hint (alpha dropped). The rest no-op
+// until a native host registers a backend. getInfo reads from the current theme-color meta where
+// present and returns safe defaults for fields the web cannot know (height = -1, visible = true).
+export function createWebStatusBarBackend() {
+    return {
+        getInfo(out) {
+            // Read back the theme-color meta if present; otherwise 0 (no hint set).
+            out.color = _webReadThemeColor();
+            out.height = -1;
+            out.overlaysContent = false;
+            out.style = 'default';
+            out.visible = true;
+            return out;
+        },
+        setBackgroundColor(color, _animated) {
+            // Derive #rrggbb from the top 24 bits of the packed RGBA integer; alpha is dropped.
+            if (typeof document === 'undefined')
+                return;
+            const head = document.head;
+            if (head === null || head === undefined)
+                return;
+            let meta = head.querySelector('meta[name="theme-color"]');
+            if (meta === null) {
+                meta = document.createElement('meta');
+                meta.setAttribute('name', 'theme-color');
+                head.appendChild(meta);
+            }
+            meta.setAttribute('content', packedRgbaToHexColor(color));
+        },
+        setOverlaysContent(_overlay) {
+            // No web status bar; a native host is required to control content overlay.
+        },
+        setStyle(_style) {
+            // No web status bar; a native host (Capacitor/native shell) is required to honor style.
+        },
+        setVisible(_visible, _animation) {
+            // No web status bar; a native host is required to show/hide it.
+        },
+        subscribe(_listener) {
+            // No OS-driven status bar events on web; return a no-op unsubscribe.
+            return () => { };
+        },
+    };
+}
+// Stops delivery to `bar` and forgets its subscription. Safe to call when not attached.
+export function detachStatusBar(bar) {
+    const unsubscribe = _subscriptions.get(bar);
+    if (unsubscribe !== undefined) {
+        unsubscribe();
+        _subscriptions.delete(bar);
+    }
+}
+// Releases `bar` for garbage collection by detaching its backend subscription. The signals remain
+// plain GC-managed memory afterward.
+export function disposeStatusBar(bar) {
+    detachStatusBar(bar);
+}
+// The active status bar backend, or a lazily-created web default. There is always a backend.
+export function getStatusBarBackend() {
+    if (_backend === null)
+        _backend = createWebStatusBarBackend();
+    return _backend;
+}
+// Returns the status bar height in CSS pixels, or -1 when the host does not report it (web,
+// desktops). Convenience over getStatusBarInfo.
+// NOTE: On notched/island devices, the safe-area top inset (owned by @flighthq/device) may differ
+// from the status bar height. Use device.getSafeAreaInsets().top for layout-safe top padding;
+// use getStatusBarHeight() when you specifically need the status bar element's intrinsic height.
+export function getStatusBarHeight() {
+    return getStatusBarBackend().getInfo(_scratchInfo).height;
+}
+// Fills `out` with the current status bar state snapshot and returns it. Alias-safe: `out` may
+// be the same object as any internal scratch.
+export function getStatusBarInfo(out) {
+    return getStatusBarBackend().getInfo(out);
+}
+// Removes the style stack entry identified by `handle`. If the handle is unknown or invalid,
+// this is a no-op. The top entry (or baseline) is re-applied after removal.
+export function popStatusBarStyleEntry(handle) {
+    if (handle === INVALID_HANDLE)
+        return;
+    const idx = _styleStack.findIndex((e) => e.handle === handle);
+    if (idx === -1)
+        return;
+    _styleStack.splice(idx, 1);
+    _applyTopStyleEntry();
+}
+// Pushes a style stack entry, returns an opaque handle for later pop. Nested components can push
+// entries and restore the previous state on unmount without global last-write-wins clashes.
+// Unset fields fall through to the next entry down the stack (last pushed wins per field).
+export function pushStatusBarStyleEntry(entry) {
+    const handle = _nextHandle++;
+    _styleStack.push({ handle, entry });
+    _applyTopStyleEntry();
+    return handle;
+}
+// Installs a native host status bar backend; pass null to fall back to the web default.
+export function setStatusBarBackend(backend) {
+    _backend = backend;
+}
+// Sets the status bar background color from a packed RGBA integer (0xRRGGBBAA). On web this
+// updates the theme-color hint; alpha is ignored. Set animated to true for a smooth transition
+// (native hosts only; no-op on web).
+export function setStatusBarColor(color, animated) {
+    getStatusBarBackend().setBackgroundColor(color, animated);
+}
+// Controls whether content draws under the status bar. No-op on web.
+export function setStatusBarOverlaysContent(overlay) {
+    getStatusBarBackend().setOverlaysContent(overlay);
+}
+// Sets the status bar foreground style ('light' | 'dark' | 'default'). No-op on web.
+export function setStatusBarStyle(style) {
+    getStatusBarBackend().setStyle(style);
+}
+// Shows or hides the status bar. animation controls the transition; defaults to 'none'. No-op on web.
+export function setStatusBarVisible(visible, animation) {
+    getStatusBarBackend().setVisible(visible, animation);
+}
+// ---- module-level state ----
+let _backend = null;
+let _nextHandle = 1;
+const _scratchInfo = createStatusBarInfo();
+const _styleStack = [];
+const _subscriptions = new WeakMap();
+const INVALID_HANDLE = -1;
+// Merges the style stack top-down (last pushed = highest priority per field) and applies the
+// merged result to the active backend. Falls through to no-ops where no entry sets a field.
+function _applyTopStyleEntry() {
+    const backend = getStatusBarBackend();
+    let style;
+    let visible;
+    let color;
+    let overlaysContent;
+    let animation;
+    // Stack is in push order; iterate from last pushed (top) to earliest (bottom).
+    for (let i = _styleStack.length - 1; i >= 0; i--) {
+        const e = _styleStack[i].entry;
+        if (style === undefined && e.style !== undefined)
+            style = e.style;
+        if (visible === undefined && e.visible !== undefined)
+            visible = e.visible;
+        if (color === undefined && e.color !== undefined)
+            color = e.color;
+        if (overlaysContent === undefined && e.overlaysContent !== undefined)
+            overlaysContent = e.overlaysContent;
+        if (animation === undefined && e.animation !== undefined)
+            animation = e.animation;
+    }
+    if (style !== undefined)
+        backend.setStyle(style);
+    if (visible !== undefined)
+        backend.setVisible(visible, animation ?? 'none');
+    if (color !== undefined)
+        backend.setBackgroundColor(color, false);
+    if (overlaysContent !== undefined)
+        backend.setOverlaysContent(overlaysContent);
+}
+function packedRgbaToHexColor(color) {
+    const rgb = (color >>> 8) & 0xffffff;
+    return '#' + rgb.toString(16).padStart(6, '0');
+}
+// Reads the current theme-color meta content and parses it back to a packed RGBA integer.
+// Returns 0 if no meta is present or the value cannot be parsed.
+function _webReadThemeColor() {
+    if (typeof document === 'undefined')
+        return 0;
+    const meta = document.head?.querySelector('meta[name="theme-color"]');
+    if (meta === null || meta === undefined)
+        return 0;
+    const content = meta.getAttribute('content');
+    if (content === null || !content.startsWith('#'))
+        return 0;
+    const hex = content.slice(1);
+    if (hex.length !== 6)
+        return 0;
+    const rgb = parseInt(hex, 16);
+    if (isNaN(rgb))
+        return 0;
+    // Reconstruct as 0xRRGGBBFF (alpha fully opaque since web drops alpha).
+    return ((rgb << 8) | 0xff) >>> 0;
+}
+//# sourceMappingURL=statusbar.js.map

package/dist/statusbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusbar.js","sourceRoot":"","sources":["../src/statusbar.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/statusbar",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/signals": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Mobile status bar style, visibility, and color over a swappable web/native backend",
+  "sideEffects": false
+}

package/src/statusbar.test.ts

@@ -0,0 +1,379 @@
+import type { StatusBar, StatusBarBackend, StatusBarInfo, StatusBarStyle } from '@flighthq/types';
+
+import {
+  attachStatusBar,
+  createStatusBar,
+  createStatusBarInfo,
+  createWebStatusBarBackend,
+  detachStatusBar,
+  disposeStatusBar,
+  getStatusBarBackend,
+  getStatusBarHeight,
+  getStatusBarInfo,
+  popStatusBarStyleEntry,
+  pushStatusBarStyleEntry,
+  setStatusBarBackend,
+  setStatusBarColor,
+  setStatusBarOverlaysContent,
+  setStatusBarStyle,
+  setStatusBarVisible,
+} from './statusbar';
+
+function fakeBackend(): StatusBarBackend & {
+  _emit(): void;
+  animatedColor: boolean | undefined;
+  animation: string | undefined;
+  color: number;
+  infoHeight: number;
+  overlay: boolean;
+  style: StatusBarStyle;
+  subscribeCallCount: number;
+  visible: boolean;
+} {
+  let listener: (() => void) | null = null;
+  return {
+    animatedColor: undefined,
+    animation: undefined,
+    color: 0,
+    infoHeight: 42,
+    overlay: false,
+    style: 'default',
+    subscribeCallCount: 0,
+    visible: true,
+    getInfo(out: StatusBarInfo): StatusBarInfo {
+      out.color = this.color;
+      out.height = this.infoHeight;
+      out.overlaysContent = this.overlay;
+      out.style = this.style;
+      out.visible = this.visible;
+      return out;
+    },
+    setBackgroundColor(color: number, animated?: boolean): void {
+      this.color = color;
+      this.animatedColor = animated;
+    },
+    setOverlaysContent(overlay: boolean): void {
+      this.overlay = overlay;
+    },
+    setStyle(style: StatusBarStyle): void {
+      this.style = style;
+    },
+    setVisible(visible: boolean, animation?: string): void {
+      this.visible = visible;
+      this.animation = animation;
+    },
+    subscribe(l: () => void): () => void {
+      this.subscribeCallCount++;
+      listener = l;
+      return () => {
+        listener = null;
+      };
+    },
+    // Trigger for tests: fire the subscription listener externally.
+    _emit(): void {
+      if (listener !== null) listener();
+    },
+  } as ReturnType<typeof fakeBackend>;
+}
+
+afterEach(() => {
+  setStatusBarBackend(null);
+  // Reset style stack state between tests by popping all entries (pop returns no-op on invalid)
+  for (let i = 0; i < 100; i++) popStatusBarStyleEntry(i);
+});
+
+describe('attachStatusBar', () => {
+  it('subscribes to the backend and emits onChange on change', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    const bar = createStatusBar();
+    const received: StatusBarInfo[] = [];
+    bar.onChange.emit = (info) => {
+      received.push({ ...info });
+    };
+    attachStatusBar(bar);
+    (backend as ReturnType<typeof fakeBackend>)._emit();
+    expect(received.length).toBe(1);
+    expect(received[0].height).toBe(42);
+    disposeStatusBar(bar);
+  });
+
+  it('is idempotent: re-attaching replaces the subscription', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    const bar = createStatusBar();
+    attachStatusBar(bar);
+    attachStatusBar(bar);
+    expect(backend.subscribeCallCount).toBe(2);
+    disposeStatusBar(bar);
+  });
+});
+
+describe('createStatusBar', () => {
+  it('returns a StatusBar with an inert onChange signal', () => {
+    const bar = createStatusBar();
+    expect(bar.onChange).not.toBeNull();
+    // Signals are inert (no listeners) until attachStatusBar is called.
+  });
+});
+
+describe('createStatusBarInfo', () => {
+  it('returns defaults with height -1 and style default', () => {
+    const info = createStatusBarInfo();
+    expect(info.height).toBe(-1);
+    expect(info.style).toBe('default');
+    expect(info.visible).toBe(true);
+    expect(info.overlaysContent).toBe(false);
+    expect(info.color).toBe(0);
+  });
+});
+
+describe('createWebStatusBarBackend', () => {
+  it('upserts a single theme-color meta with #rrggbb from the top 24 bits', () => {
+    document.head.querySelectorAll('meta[name="theme-color"]').forEach((m) => m.remove());
+    const backend = createWebStatusBarBackend();
+    backend.setBackgroundColor(0x11223344);
+    backend.setBackgroundColor(0xaabbccff);
+    const metas = document.head.querySelectorAll('meta[name="theme-color"]');
+    expect(metas.length).toBe(1);
+    expect(metas[0].getAttribute('content')).toBe('#aabbcc');
+  });
+
+  it('no-ops style/visible/overlay/subscribe without throwing', () => {
+    const backend = createWebStatusBarBackend();
+    expect(() => {
+      backend.setStyle('light');
+      backend.setVisible(false, 'slide');
+      backend.setOverlaysContent(true);
+      const unsub = backend.subscribe(() => {});
+      unsub();
+    }).not.toThrow();
+  });
+
+  it('getInfo returns -1 height and defaults when no theme-color meta', () => {
+    document.head.querySelectorAll('meta[name="theme-color"]').forEach((m) => m.remove());
+    const backend = createWebStatusBarBackend();
+    const info = createStatusBarInfo();
+    backend.getInfo(info);
+    expect(info.height).toBe(-1);
+    expect(info.visible).toBe(true);
+    expect(info.color).toBe(0);
+  });
+
+  it('getInfo reads back a previously set theme-color meta', () => {
+    document.head.querySelectorAll('meta[name="theme-color"]').forEach((m) => m.remove());
+    const backend = createWebStatusBarBackend();
+    backend.setBackgroundColor(0xff000000); // red, no alpha
+    const info = createStatusBarInfo();
+    backend.getInfo(info);
+    // Color should be reconstructed as 0xff0000ff (alpha forced to 0xff on web read-back)
+    expect(info.color).toBe(0xff0000ff);
+  });
+
+  it('subscribe returns a no-op unsubscribe function', () => {
+    const backend = createWebStatusBarBackend();
+    const unsub = backend.subscribe(() => {});
+    expect(() => unsub()).not.toThrow();
+  });
+});
+
+describe('detachStatusBar', () => {
+  it('stops subscription and is safe to call when not attached', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    const bar = createStatusBar();
+    expect(() => detachStatusBar(bar)).not.toThrow();
+    attachStatusBar(bar);
+    detachStatusBar(bar);
+    let emitCount = 0;
+    bar.onChange.emit = () => {
+      emitCount++;
+    };
+    (backend as ReturnType<typeof fakeBackend>)._emit();
+    expect(emitCount).toBe(0);
+  });
+});
+
+describe('disposeStatusBar', () => {
+  it('detaches subscription and releases the entity', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    const bar = createStatusBar();
+    attachStatusBar(bar);
+    disposeStatusBar(bar);
+    let emitCount = 0;
+    bar.onChange.emit = () => {
+      emitCount++;
+    };
+    (backend as ReturnType<typeof fakeBackend>)._emit();
+    expect(emitCount).toBe(0);
+  });
+});
+
+describe('getStatusBarBackend', () => {
+  it('falls back to a web backend', () => {
+    expect(getStatusBarBackend()).not.toBeNull();
+  });
+
+  it('returns the registered backend', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    expect(getStatusBarBackend()).toBe(backend);
+  });
+});
+
+describe('getStatusBarHeight', () => {
+  it('returns the height from the active backend', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    expect(getStatusBarHeight()).toBe(42);
+  });
+
+  it('returns -1 when the web backend reports unknown height', () => {
+    document.head.querySelectorAll('meta[name="theme-color"]').forEach((m) => m.remove());
+    // Web backend always returns -1 for height.
+    expect(getStatusBarHeight()).toBe(-1);
+  });
+});
+
+describe('getStatusBarInfo', () => {
+  it('fills the out parameter from the active backend', () => {
+    const backend = fakeBackend();
+    backend.color = 0x112233ff;
+    backend.style = 'light';
+    backend.visible = false;
+    backend.overlay = true;
+    setStatusBarBackend(backend);
+    const out = createStatusBarInfo();
+    const result = getStatusBarInfo(out);
+    expect(result).toBe(out); // returns `out`
+    expect(out.color).toBe(0x112233ff);
+    expect(out.style).toBe('light');
+    expect(out.visible).toBe(false);
+    expect(out.overlaysContent).toBe(true);
+    expect(out.height).toBe(42);
+  });
+
+  it('is alias-safe: out may be reused across calls', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    const out = createStatusBarInfo();
+    getStatusBarInfo(out);
+    backend.style = 'dark';
+    getStatusBarInfo(out);
+    expect(out.style).toBe('dark');
+  });
+});
+
+describe('popStatusBarStyleEntry', () => {
+  it('no-ops for unknown or invalid handles', () => {
+    expect(() => popStatusBarStyleEntry(-1)).not.toThrow();
+    expect(() => popStatusBarStyleEntry(99999)).not.toThrow();
+  });
+
+  it('removes the entry and re-applies the stack', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    const handle = pushStatusBarStyleEntry({ style: 'dark' });
+    expect(backend.style).toBe('dark');
+    popStatusBarStyleEntry(handle);
+    // After pop the backend should have been re-applied with the empty stack (no-op for style).
+    // The key invariant: the push was applied, the pop does not throw.
+  });
+});
+
+describe('pushStatusBarStyleEntry', () => {
+  it('applies the entry to the active backend', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    pushStatusBarStyleEntry({ style: 'light', visible: false });
+    expect(backend.style).toBe('light');
+    expect(backend.visible).toBe(false);
+  });
+
+  it('later entries win per-field over earlier entries', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    pushStatusBarStyleEntry({ style: 'dark' });
+    pushStatusBarStyleEntry({ style: 'light' });
+    expect(backend.style).toBe('light');
+  });
+
+  it('returns unique handles', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    const h1 = pushStatusBarStyleEntry({ style: 'dark' });
+    const h2 = pushStatusBarStyleEntry({ style: 'light' });
+    expect(h1).not.toBe(h2);
+    popStatusBarStyleEntry(h1);
+    popStatusBarStyleEntry(h2);
+  });
+
+  it('fields not set fall through to lower entries', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    pushStatusBarStyleEntry({ style: 'dark' });
+    pushStatusBarStyleEntry({ visible: false }); // no style set → falls through
+    expect(backend.style).toBe('dark');
+    expect(backend.visible).toBe(false);
+  });
+});
+
+describe('setStatusBarBackend', () => {
+  it('clears back to the web fallback when passed null', () => {
+    setStatusBarBackend(fakeBackend());
+    setStatusBarBackend(null);
+    expect(getStatusBarBackend()).not.toBeNull();
+  });
+});
+
+describe('setStatusBarColor', () => {
+  it('forwards the packed color to the active backend', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    setStatusBarColor(0x123456ff);
+    expect(backend.color).toBe(0x123456ff);
+    expect(backend.animatedColor).toBeUndefined();
+  });
+
+  it('forwards the animated flag when provided', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    setStatusBarColor(0x123456ff, true);
+    expect(backend.animatedColor).toBe(true);
+  });
+});
+
+describe('setStatusBarOverlaysContent', () => {
+  it('forwards overlay to the active backend', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    setStatusBarOverlaysContent(true);
+    expect(backend.overlay).toBe(true);
+  });
+});
+
+describe('setStatusBarStyle', () => {
+  it('forwards style to the active backend', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    setStatusBarStyle('dark');
+    expect(backend.style).toBe('dark');
+  });
+});
+
+describe('setStatusBarVisible', () => {
+  it('forwards visibility to the active backend', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    setStatusBarVisible(false);
+    expect(backend.visible).toBe(false);
+  });
+
+  it('forwards animation parameter to the active backend', () => {
+    const backend = fakeBackend();
+    setStatusBarBackend(backend);
+    setStatusBarVisible(false, 'fade');
+    expect(backend.animation).toBe('fade');
+  });
+});