@flighthq/statusbar 0.5.0-next.1944.cd6b6e7 → 0.5.1-edge.638.d4dbd4e

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/statusbar`. The `@fl
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/statusbar@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/statusbar)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/statusbar@0.5.1-edge.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/statusbar)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { attachStatusBar, clearStatusBarStyleStack, createStatusBar, detachStatusBar, disposeStatusBar, explainStatusBarBackend, getStatusBarHeight, getStatusBarInfo, hasStatusBarStyleEntry, popStatusBarStyleEntry, pushStatusBarStyleEntry, setStatusBarColor, setStatusBarOverlaysContent, setStatusBarStyle, setStatusBarVisible, } from './contract';
+export { attachStatusBar, clearStatusBarStyleStack, createStatusBar, detachStatusBar, disposeStatusBar, getStatusBarHeight, getStatusBarInfo, hasStatusBarStyleEntry, popStatusBarStyleEntry, pushStatusBarStyleEntry, setStatusBarColor, setStatusBarOverlaysContent, setStatusBarStyle, setStatusBarVisible, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { attachStatusBar, clearStatusBarStyleStack, createStatusBar, detachStatusBar, disposeStatusBar, explainStatusBarBackend, getStatusBarHeight, getStatusBarInfo, hasStatusBarStyleEntry, popStatusBarStyleEntry, pushStatusBarStyleEntry, setStatusBarColor, setStatusBarOverlaysContent, setStatusBarStyle, setStatusBarVisible, } from './contract';
+export { attachStatusBar, clearStatusBarStyleStack, createStatusBar, detachStatusBar, disposeStatusBar, getStatusBarHeight, getStatusBarInfo, hasStatusBarStyleEntry, popStatusBarStyleEntry, pushStatusBarStyleEntry, setStatusBarColor, setStatusBarOverlaysContent, setStatusBarStyle, setStatusBarVisible, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/statusbar.d.ts

@@ -1,24 +1,18 @@
-import type { BackendExplanation, StatusBar, StatusBarAnimation, StatusBarBackend, StatusBarInfo, StatusBarStyle, StatusBarStyleEntry, StatusBarStyleEntryHandle } from '@flighthq/types/contract';
-export declare function attachStatusBar(bar: StatusBar): void;
-export declare function clearStatusBarStyleStack(): void;
+import type { HasUiStatusBarChange, HasUiStatusBarColor, HasUiStatusBarInfo, HasUiStatusBarOverlays, HasUiStatusBarStyle, HasUiStatusBarStyleStack, HasUiStatusBarVisibility, StatusBar, StatusBarAnimation, StatusBarInfo, StatusBarStyle, StatusBarStyleEntry, StatusBarStyleEntryHandle } from '@flighthq/types/contract';
+export declare function attachStatusBar(host: HasUiStatusBarChange & HasUiStatusBarInfo, bar: StatusBar): void;
+export declare function clearStatusBarStyleStack(host: HasUiStatusBarStyleStack): void;
 export declare function createStatusBar(): StatusBar;
 export declare function createStatusBarInfo(): StatusBarInfo;
 export declare function detachStatusBar(bar: StatusBar): void;
 export declare function disposeStatusBar(bar: StatusBar): void;
-export declare function explainStatusBarBackend(): BackendExplanation;
-export declare function getStatusBarBackend(): StatusBarBackend;
-export declare function getStatusBarHeight(): number;
-export declare function getStatusBarInfo(out: StatusBarInfo): StatusBarInfo;
-export declare function hasStatusBarStyleEntry(handle: StatusBarStyleEntryHandle): boolean;
-export declare function installStatusBarHostBackend(backend: StatusBarBackend): void;
-export declare function observeStatusBarHostResult(operation: string, succeeded: boolean): void;
+export declare function getStatusBarHeight(host: HasUiStatusBarInfo): number;
+export declare function getStatusBarInfo(host: HasUiStatusBarInfo, out: StatusBarInfo): StatusBarInfo;
+export declare function hasStatusBarStyleEntry(host: HasUiStatusBarStyleStack, handle: StatusBarStyleEntryHandle): boolean;
 export declare function packedRgbaToHexColor(color: number): string;
-export declare function popStatusBarStyleEntry(handle: StatusBarStyleEntryHandle): void;
-export declare function pushStatusBarStyleEntry(entry: Readonly<StatusBarStyleEntry>): StatusBarStyleEntryHandle;
-export declare function resetStatusBarBackendForTest(): void;
-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;
+export declare function popStatusBarStyleEntry(host: HasUiStatusBarStyleStack, handle: StatusBarStyleEntryHandle): void;
+export declare function pushStatusBarStyleEntry(host: HasUiStatusBarStyleStack, entry: Readonly<StatusBarStyleEntry>): StatusBarStyleEntryHandle;
+export declare function setStatusBarColor(host: HasUiStatusBarColor, color: number, animated?: boolean): void;
+export declare function setStatusBarOverlaysContent(host: HasUiStatusBarOverlays, overlay: boolean): void;
+export declare function setStatusBarStyle(host: HasUiStatusBarStyle, style: StatusBarStyle): void;
+export declare function setStatusBarVisible(host: HasUiStatusBarVisibility, visible: boolean, animation?: StatusBarAnimation): void;
 //# sourceMappingURL=statusbar.d.ts.map

package/dist/statusbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"statusbar.d.ts","sourceRoot":"","sources":["../src/statusbar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,0BAA0B,CAAC;AAalC,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAOpD;AAKD,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAGD,wBAAgB,eAAe,IAAI,SAAS,CAI3C;AAID,wBAAgB,mBAAmB,IAAI,aAAa,CAQnD;AAGD,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAMpD;AAID,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAErD;AAED,wBAAgB,uBAAuB,IAAI,kBAAkB,CAa5D;AAGD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAEtD;AAOD,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAID,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAElE;AAKD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAGjF;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAM3E;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAKtF;AAGD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG1D;AAMD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAM9E;AAUD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,yBAAyB,CAWvG;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAKnD;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"}
+{"version":3,"file":"statusbar.d.ts","sourceRoot":"","sources":["../src/statusbar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,SAAS,EACT,kBAAkB,EAElB,aAAa,EAEb,cAAc,EAEd,mBAAmB,EACnB,yBAAyB,EAE1B,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,eAAe,CAAC,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAQrG;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI,CAK7E;AAED,wBAAgB,eAAe,IAAI,SAAS,CAE3C;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAQnD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAKpD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAErD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAEnE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,EAAE,aAAa,GAAG,aAAa,CAE5F;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,wBAAwB,EAAE,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAGjH;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,wBAAwB,EAAE,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAQ9G;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,wBAAwB,EAC9B,KAAK,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GACnC,yBAAyB,CAoB3B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAEpG;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAEhG;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAExF;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,wBAAwB,EAC9B,OAAO,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,kBAAkB,GAC7B,IAAI,CAEN"}

package/dist/statusbar.js

@@ -1,40 +1,23 @@
 import { createSignal, emitSignal } from '@flighthq/signals/contract';
-// 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.
-//
-// Each event carries a freshly allocated StatusBarInfo the listener owns outright. This is the one
-// place in the package that deliberately allocates per event rather than filling a shared scratch:
-// an emitted payload is retained by whoever listens, and a shared scratch would let the next event —
-// or an unrelated getStatusBarHeight() call — rewrite a snapshot a listener had already stored, and
-// would hand every attached bar the same object. Status bar changes are rare OS events, so the
-// allocation is not on any hot path; a caller that wants zero-allocation reads uses getStatusBarInfo
-// with its own `out`.
-export function attachStatusBar(bar) {
+export function attachStatusBar(host, bar) {
     detachStatusBar(bar);
-    const backend = getStatusBarBackend();
-    const unsubscribe = backend.subscribe(() => {
-        emitSignal(bar.onChange, backend.getInfo(createStatusBarInfo()));
+    const changeProvider = host.ui.statusBarChange;
+    const infoProvider = host.ui.statusBarInfo;
+    const unsubscribe = changeProvider.subscribe(() => {
+        emitSignal(bar.onChange, infoProvider.getInfo(createStatusBarInfo()));
     });
     _subscriptions.set(bar, unsubscribe);
 }
-// Empties the style stack and restores the status bar to the state it held before the first entry
-// was pushed. The counterpart to pushStatusBarStyleEntry for whole-screen teardown, where popping
-// each handle individually would mean tracking them all. A no-op on an empty stack.
-export function clearStatusBarStyleStack() {
-    if (_styleStack.length === 0)
+export function clearStatusBarStyleStack(host) {
+    const state = _styleStacks.get(host);
+    if (state === undefined || state.entries.length === 0)
         return;
-    _styleStack.length = 0;
-    _applyTopStyleEntry();
+    state.entries.length = 0;
+    applyTopStyleEntry(host, state);
 }
-// Allocates a StatusBar event entity with inert signals; call attachStatusBar to start delivery.
 export function createStatusBar() {
-    return {
-        onChange: createSignal(),
-    };
+    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,
@@ -44,236 +27,118 @@ export function createStatusBarInfo() {
         visible: true,
     };
 }
-// 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);
-    }
+    if (unsubscribe === undefined)
+        return;
+    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);
 }
-export function explainStatusBarBackend() {
-    if (_custom !== null) {
-        return { conflict: _hostConflict, layer: 'custom', operation: null, viability: 'unobserved' };
-    }
-    if (_host !== null) {
-        return {
-            conflict: _hostConflict,
-            layer: 'host',
-            operation: _hostObservation !== null ? _hostObservation.operation : null,
-            viability: _hostObservation !== null ? _hostObservation.viability : 'unobserved',
-        };
-    }
-    return { conflict: false, layer: 'host-not-enabled', operation: null, viability: 'unobserved' };
-}
-// The active status bar backend. Precedence: custom > host > sentinel.
-export function getStatusBarBackend() {
-    return _custom ?? _host ?? _sentinel;
+export function getStatusBarHeight(host) {
+    return host.ui.statusBarInfo.getInfo(_scratchInfo).height;
 }
-// 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;
+export function getStatusBarInfo(host, out) {
+    return host.ui.statusBarInfo.getInfo(out);
 }
-// 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);
-}
-// True when `handle` names an entry still on the style stack. False for a popped handle, an unknown
-// one, or the invalid handle — so a component can check before popping without tracking its own
-// mounted flag.
-export function hasStatusBarStyleEntry(handle) {
+export function hasStatusBarStyleEntry(host, handle) {
     if (handle === INVALID_HANDLE)
         return false;
-    return _styleStack.some((e) => e.handle === handle);
-}
-export function installStatusBarHostBackend(backend) {
-    if (_host !== null) {
-        if (_host !== backend)
-            _hostConflict = true;
-        return;
-    }
-    _host = backend;
+    return _styleStacks.get(host)?.entries.some((entry) => entry.handle === handle) ?? false;
 }
-export function observeStatusBarHostResult(operation, succeeded) {
-    _hostObservation = {
-        operation,
-        viability: succeeded ? 'available' : 'runtime-api-unavailable',
-    };
-}
-// Converts a packed RGBA integer (0xRRGGBBAA) to a #rrggbb hex string, dropping alpha.
 export function packedRgbaToHexColor(color) {
     const rgb = (color >>> 8) & 0xffffff;
     return '#' + rgb.toString(16).padStart(6, '0');
 }
-// Removes the style stack entry identified by `handle`. If the handle is unknown or invalid,
-// this is a no-op. The remaining stack — falling back to the baseline captured before the first
-// push — is re-applied after removal, so a field the popped entry was the last to set returns to
-// what it was rather than staying where that entry left it.
-export function popStatusBarStyleEntry(handle) {
+export function popStatusBarStyleEntry(host, handle) {
     if (handle === INVALID_HANDLE)
         return;
-    const idx = _styleStack.findIndex((e) => e.handle === handle);
-    if (idx === -1)
+    const state = _styleStacks.get(host);
+    if (state === undefined)
         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), and
-// through an empty stack to the baseline.
-//
-// The baseline is read from the backend when the stack goes from empty to non-empty — the last
-// moment it still describes the pre-stack status bar. Capturing it at module load would be wrong
-// (no backend is installed yet) and re-reading it per push would capture the stack's own effect.
-export function pushStatusBarStyleEntry(entry) {
-    if (_styleStack.length === 0) {
-        _baseline = getStatusBarBackend().getInfo(createStatusBarInfo());
-        // `_applied` starts as a copy of the baseline, not null, so the first push only calls setters for
-        // fields it actually changes rather than restating the baseline back to the backend.
-        _applied = getStatusBarBackend().getInfo(createStatusBarInfo());
+    const index = state.entries.findIndex((entry) => entry.handle === handle);
+    if (index === -1)
+        return;
+    state.entries.splice(index, 1);
+    applyTopStyleEntry(host, state);
+}
+export function pushStatusBarStyleEntry(host, entry) {
+    let state = _styleStacks.get(host);
+    if (state === undefined) {
+        const infoProvider = host.ui.statusBarInfo;
+        const baseline = infoProvider.getInfo(createStatusBarInfo());
+        state = {
+            applied: { ...baseline },
+            baseline,
+            colorProvider: host.ui.statusBarColor,
+            entries: [],
+            overlaysProvider: host.ui.statusBarOverlays,
+            styleProvider: host.ui.statusBarStyle,
+            visibilityProvider: host.ui.statusBarVisibility,
+        };
+        _styleStacks.set(host, state);
     }
     const handle = _nextHandle++;
-    _styleStack.push({ handle, entry });
-    _applyTopStyleEntry();
+    state.entries.push({ entry, handle });
+    applyTopStyleEntry(host, state);
     return handle;
 }
-export function resetStatusBarBackendForTest() {
-    _custom = null;
-    _host = null;
-    _hostConflict = false;
-    _hostObservation = null;
-}
-// Installs a custom status bar backend; pass null to clear the custom override.
-export function setStatusBarBackend(backend) {
-    _custom = backend;
+export function setStatusBarColor(host, color, animated) {
+    host.ui.statusBarColor.setBackgroundColor(color, animated);
 }
-// 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);
+export function setStatusBarOverlaysContent(host, overlay) {
+    host.ui.statusBarOverlays.setOverlaysContent(overlay);
 }
-// Controls whether content draws under the status bar. No-op on web.
-export function setStatusBarOverlaysContent(overlay) {
-    getStatusBarBackend().setOverlaysContent(overlay);
+export function setStatusBarStyle(host, style) {
+    host.ui.statusBarStyle.setStyle(style);
 }
-// Sets the status bar foreground style ('light' | 'dark' | 'default'). No-op on web.
-export function setStatusBarStyle(style) {
-    getStatusBarBackend().setStyle(style);
+export function setStatusBarVisible(host, visible, animation) {
+    host.ui.statusBarVisibility.setVisible(visible, animation);
 }
-// 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);
-}
-const _sentinel = {
-    getInfo(out) {
-        out.color = 0;
-        out.height = -1;
-        out.overlaysContent = false;
-        out.style = 'default';
-        out.visible = true;
-        return out;
-    },
-    setBackgroundColor() { },
-    setOverlaysContent() { },
-    setStyle() { },
-    setVisible() { },
-    subscribe() {
-        return () => { };
-    },
-};
-let _custom = null;
-let _host = null;
-let _hostConflict = false;
-let _hostObservation = null;
+const INVALID_HANDLE = -1;
 let _nextHandle = 1;
 const _scratchInfo = createStatusBarInfo();
-const _styleStack = [];
+const _styleStacks = new WeakMap();
 const _subscriptions = new WeakMap();
-// The status bar as it stood before the stack's first entry, and the state the stack has actually
-// pushed to the backend. Together they make pop a restore rather than a no-op: `_baseline` supplies
-// the value a released field returns to, and `_applied` keeps the backend from being told things it
-// already knows. Both are cleared when the stack empties, so the next push re-reads a baseline that
-// is once again the pre-stack truth.
-let _baseline = null;
-let _applied = null;
-const INVALID_HANDLE = -1;
-// Merges the style stack top-down (last pushed = highest priority per field), falls unset fields
-// through to the captured baseline, and pushes to the backend only what actually changed.
-//
-// The baseline fallback is what makes a pop restore: merging the stack alone leaves a released field
-// undefined, and an undefined field used to mean "call no setter", which left the OS holding the
-// value of an entry that is no longer on the stack. Diffing against `_applied` keeps that fix from
-// costing a burst of redundant setter calls on every push and pop.
-function _applyTopStyleEntry() {
-    const backend = getStatusBarBackend();
-    let style;
-    let visible;
+function applyTopStyleEntry(host, state) {
+    let animation;
     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;
-    }
-    const baseline = _baseline;
-    if (baseline !== null) {
-        if (style === undefined)
-            style = baseline.style;
-        if (visible === undefined)
-            visible = baseline.visible;
-        if (color === undefined)
-            color = baseline.color;
-        if (overlaysContent === undefined)
-            overlaysContent = baseline.overlaysContent;
-    }
-    const applied = _applied;
-    if (style !== undefined && style !== applied?.style)
-        backend.setStyle(style);
-    if (visible !== undefined && visible !== applied?.visible)
-        backend.setVisible(visible, animation ?? 'none');
-    if (color !== undefined && color !== applied?.color)
-        backend.setBackgroundColor(color, false);
-    if (overlaysContent !== undefined && overlaysContent !== applied?.overlaysContent) {
-        backend.setOverlaysContent(overlaysContent);
-    }
-    if (_styleStack.length === 0) {
-        // The stack is spent: the backend is back at the baseline, so forget both and let the next push
-        // capture a fresh one.
-        _baseline = null;
-        _applied = null;
-        return;
+    let style;
+    let visible;
+    for (let index = state.entries.length - 1; index >= 0; index--) {
+        const entry = state.entries[index].entry;
+        if (animation === undefined && entry.animation !== undefined)
+            animation = entry.animation;
+        if (color === undefined && entry.color !== undefined)
+            color = entry.color;
+        if (overlaysContent === undefined && entry.overlaysContent !== undefined) {
+            overlaysContent = entry.overlaysContent;
+        }
+        if (style === undefined && entry.style !== undefined)
+            style = entry.style;
+        if (visible === undefined && entry.visible !== undefined)
+            visible = entry.visible;
     }
-    const next = _applied ?? createStatusBarInfo();
-    if (style !== undefined)
-        next.style = style;
-    if (visible !== undefined)
-        next.visible = visible;
-    if (color !== undefined)
-        next.color = color;
-    if (overlaysContent !== undefined)
-        next.overlaysContent = overlaysContent;
-    _applied = next;
+    color ??= state.baseline.color;
+    overlaysContent ??= state.baseline.overlaysContent;
+    style ??= state.baseline.style;
+    visible ??= state.baseline.visible;
+    if (color !== state.applied.color)
+        state.colorProvider.setBackgroundColor(color, false);
+    if (overlaysContent !== state.applied.overlaysContent)
+        state.overlaysProvider.setOverlaysContent(overlaysContent);
+    if (style !== state.applied.style)
+        state.styleProvider.setStyle(style);
+    if (visible !== state.applied.visible)
+        state.visibilityProvider.setVisible(visible, animation ?? 'none');
+    state.applied.color = color;
+    state.applied.overlaysContent = overlaysContent;
+    state.applied.style = style;
+    state.applied.visible = visible;
+    if (state.entries.length === 0)
+        _styleStacks.delete(host);
 }
 //# sourceMappingURL=statusbar.js.map

package/dist/statusbar.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/statusbar",
-  "version": "0.5.0-next.1944.cd6b6e7",
+  "version": "0.5.1-edge.638.d4dbd4e",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,8 +38,8 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/signals": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/types": "0.5.0-next.1944.cd6b6e7"
+    "@flighthq/signals": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/types": "0.5.1-edge.638.d4dbd4e"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/statusbar.test.ts

@@ -1,622 +1,201 @@
 import { connectSignal } from '@flighthq/signals/contract';
-import type { StatusBar, StatusBarBackend, StatusBarInfo, StatusBarStyle } from '@flighthq/types/contract';
+import type {
+  HasUiStatusBarChange,
+  HasUiStatusBarStyleStack,
+  StatusBarInfo,
+  StatusBarStyle,
+} from '@flighthq/types/contract';
+import { describe, expect, it, vi } from 'vitest';
 
-import {
-  attachStatusBar,
-  clearStatusBarStyleStack,
-  createStatusBar,
-  createStatusBarInfo,
-  detachStatusBar,
-  disposeStatusBar,
-  explainStatusBarBackend,
-  getStatusBarBackend,
-  getStatusBarHeight,
-  getStatusBarInfo,
-  hasStatusBarStyleEntry,
-  installStatusBarHostBackend,
-  observeStatusBarHostResult,
-  packedRgbaToHexColor,
-  popStatusBarStyleEntry,
-  pushStatusBarStyleEntry,
-  resetStatusBarBackendForTest,
-  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(() => {
-  clearStatusBarStyleStack();
-  resetStatusBarBackendForTest();
-});
+import * as statusbar from './statusbar';
 
 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);
-  });
-
-  it('hands each event a payload the listener owns, not a shared scratch', () => {
-    // The regression this pins: the emitted info used to be a single module-level scratch, so a
-    // listener that retained a snapshot watched it change under them on the next event — or on an
-    // unrelated getStatusBarHeight() call — and two attached bars received the same object.
-    const backend = fakeBackend();
-    setStatusBarBackend(backend);
-    const bar = createStatusBar();
+  it('pins both event and snapshot providers at attachment time', () => {
+    const first = fakeHost('light');
+    const second = fakeHost('dark');
+    const bar = statusbar.createStatusBar();
     const seen: StatusBarInfo[] = [];
     connectSignal(bar.onChange, (info) => seen.push(info));
-    attachStatusBar(bar);
 
-    backend.infoHeight = 44;
-    backend._emit();
-    backend.infoHeight = 99;
-    backend._emit();
-    expect(seen.length).toBe(2);
-    expect(seen[0]).not.toBe(seen[1]);
-    expect(seen[0].height).toBe(44);
-    expect(seen[1].height).toBe(99);
+    statusbar.attachStatusBar(first.host, bar);
+    first.emit();
+    statusbar.attachStatusBar(second.host, bar);
+    first.emit();
+    second.emit();
 
-    // An unrelated read must not reach back into a payload already delivered.
-    backend.infoHeight = 12;
-    getStatusBarHeight();
-    expect(seen[0].height).toBe(44);
-  });
-
-  it('gives two attached bars separate payload objects', () => {
-    const backend = fakeBackend();
-    setStatusBarBackend(backend);
-    const first = createStatusBar();
-    const second = createStatusBar();
-    const seen: StatusBarInfo[] = [];
-    connectSignal(first.onChange, (info) => seen.push(info));
-    connectSignal(second.onChange, (info) => seen.push(info));
-    attachStatusBar(first);
-    attachStatusBar(second);
-    // The fake keeps one listener slot, so drive each bar's subscription in turn.
-    backend._emit();
-    attachStatusBar(first);
-    backend._emit();
-    expect(seen.length).toBe(2);
-    expect(seen[0]).not.toBe(seen[1]);
+    expect(first.unsubscribe).toHaveBeenCalledOnce();
+    expect(seen.map((info) => info.style)).toEqual(['light', 'dark']);
   });
 });
 
 describe('clearStatusBarStyleStack', () => {
-  it('empties the stack and restores the baseline in one call', () => {
-    const backend = fakeBackend();
-    backend.style = 'default';
-    backend.visible = true;
-    setStatusBarBackend(backend);
-    pushStatusBarStyleEntry({ style: 'dark' });
-    pushStatusBarStyleEntry({ visible: false });
-    clearStatusBarStyleStack();
-    expect(backend.style).toBe('default');
-    expect(backend.visible).toBe(true);
-  });
-
-  it('drops every handle', () => {
-    const backend = fakeBackend();
-    setStatusBarBackend(backend);
-    const first = pushStatusBarStyleEntry({ style: 'dark' });
-    const second = pushStatusBarStyleEntry({ style: 'light' });
-    clearStatusBarStyleStack();
-    expect(hasStatusBarStyleEntry(first)).toBe(false);
-    expect(hasStatusBarStyleEntry(second)).toBe(false);
-  });
-
-  it('is a no-op on an empty stack', () => {
-    const backend = fakeBackend();
-    setStatusBarBackend(backend);
-    clearStatusBarStyleStack();
-    expect(() => clearStatusBarStyleStack()).not.toThrow();
-    expect(backend.style).toBe('default');
+  it('restores only the passed host baseline', () => {
+    const first = fakeHost('light');
+    const second = fakeHost('dark');
+    statusbar.pushStatusBarStyleEntry(first.host, { style: 'dark' });
+    statusbar.pushStatusBarStyleEntry(second.host, { style: 'light' });
+    statusbar.clearStatusBarStyleStack(first.host);
+    expect(first.setStyle).toHaveBeenLastCalledWith('light');
+    expect(second.setStyle).toHaveBeenCalledTimes(1);
   });
 });
 
 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.
-  });
+  it('creates an inert signal entity', () => expect(statusbar.createStatusBar().onChange).toBeDefined());
 });
 
 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);
+  it('creates the documented unknown/default snapshot', () => {
+    expect(statusbar.createStatusBarInfo()).toEqual({
+      color: 0,
+      height: -1,
+      overlaysContent: false,
+      style: 'default',
+      visible: true,
+    });
   });
 });
 
 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);
+  it('releases the exact attached provider once', () => {
+    const provider = fakeHost('light');
+    const bar = statusbar.createStatusBar();
+    statusbar.attachStatusBar(provider.host, bar);
+    statusbar.detachStatusBar(bar);
+    statusbar.detachStatusBar(bar);
+    expect(provider.unsubscribe).toHaveBeenCalledOnce();
   });
 });
 
 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('explainStatusBarBackend', () => {
-  afterEach(() => resetStatusBarBackendForTest());
-
-  it('reports host-not-enabled when no backend is installed', () => {
-    resetStatusBarBackendForTest();
-    const explanation = explainStatusBarBackend();
-    expect(explanation.layer).toBe('host-not-enabled');
-    expect(explanation.conflict).toBe(false);
-    expect(explanation.viability).toBe('unobserved');
-  });
-
-  it('reports custom layer when a custom backend is set', () => {
-    setStatusBarBackend(fakeBackend());
-    expect(explainStatusBarBackend().layer).toBe('custom');
-  });
-
-  it('reports host layer when a host backend is installed', () => {
-    installStatusBarHostBackend(fakeBackend());
-    expect(explainStatusBarBackend().layer).toBe('host');
-  });
-
-  it('reports conflict when two different host backends are installed', () => {
-    installStatusBarHostBackend(fakeBackend());
-    installStatusBarHostBackend(fakeBackend());
-    expect(explainStatusBarBackend().conflict).toBe(true);
-  });
-});
-
-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('getStatusBarBackend (sentinel)', () => {
-  it('no-ops style/visible/overlay/subscribe without throwing', () => {
-    const backend = getStatusBarBackend();
-    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', () => {
-    const backend = getStatusBarBackend();
-    const info = createStatusBarInfo();
-    backend.getInfo(info);
-    expect(info.height).toBe(-1);
-    expect(info.visible).toBe(true);
-    expect(info.color).toBe(0);
-  });
-
-  it('setBackgroundColor is a no-op', () => {
-    const backend = getStatusBarBackend();
-    expect(() => backend.setBackgroundColor(0xff0000ff)).not.toThrow();
-  });
-
-  it('subscribe returns a no-op unsubscribe function', () => {
-    const backend = getStatusBarBackend();
-    const unsub = backend.subscribe(() => {});
-    expect(() => unsub()).not.toThrow();
+  it('detaches its subscription', () => {
+    const provider = fakeHost('light');
+    const bar = statusbar.createStatusBar();
+    statusbar.attachStatusBar(provider.host, bar);
+    statusbar.disposeStatusBar(bar);
+    expect(provider.unsubscribe).toHaveBeenCalledOnce();
   });
 });
 
 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);
-  });
+  it('reads from the passed host', () => expect(statusbar.getStatusBarHeight(fakeHost('light').host)).toBe(20));
 });
 
 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);
+  it('fills and returns the caller out object', () => {
+    const out = statusbar.createStatusBarInfo();
+    expect(statusbar.getStatusBarInfo(fakeHost('dark').host, out)).toBe(out);
     expect(out.style).toBe('dark');
   });
 });
 
 describe('hasStatusBarStyleEntry', () => {
-  it('is true while the entry is on the stack and false once popped', () => {
-    const backend = fakeBackend();
-    setStatusBarBackend(backend);
-    const handle = pushStatusBarStyleEntry({ style: 'dark' });
-    expect(hasStatusBarStyleEntry(handle)).toBe(true);
-    popStatusBarStyleEntry(handle);
-    expect(hasStatusBarStyleEntry(handle)).toBe(false);
-  });
-
-  it('is false for an unknown or invalid handle', () => {
-    expect(hasStatusBarStyleEntry(-1)).toBe(false);
-    expect(hasStatusBarStyleEntry(99999)).toBe(false);
-  });
-
-  it('stays true for an entry below one that was popped', () => {
-    const backend = fakeBackend();
-    setStatusBarBackend(backend);
-    const bottom = pushStatusBarStyleEntry({ style: 'dark' });
-    const top = pushStatusBarStyleEntry({ style: 'light' });
-    popStatusBarStyleEntry(top);
-    expect(hasStatusBarStyleEntry(bottom)).toBe(true);
-  });
-});
-
-describe('installStatusBarHostBackend', () => {
-  afterEach(() => resetStatusBarBackendForTest());
-
-  it('installs a host backend that getStatusBarBackend returns', () => {
-    const backend = fakeBackend();
-    installStatusBarHostBackend(backend);
-    expect(getStatusBarBackend()).toBe(backend);
-  });
-
-  it('is first-host-wins: a second different backend sets conflict', () => {
-    const first = fakeBackend();
-    const second = fakeBackend();
-    installStatusBarHostBackend(first);
-    installStatusBarHostBackend(second);
-    expect(getStatusBarBackend()).toBe(first);
-    expect(explainStatusBarBackend().conflict).toBe(true);
-  });
-});
-
-describe('observeStatusBarHostResult', () => {
-  afterEach(() => resetStatusBarBackendForTest());
-
-  it('records a successful observation', () => {
-    installStatusBarHostBackend(fakeBackend());
-    observeStatusBarHostResult('setBackgroundColor', true);
-    const explanation = explainStatusBarBackend();
-    expect(explanation.operation).toBe('setBackgroundColor');
-    expect(explanation.viability).toBe('available');
-  });
-
-  it('records a failed observation', () => {
-    installStatusBarHostBackend(fakeBackend());
-    observeStatusBarHostResult('setBackgroundColor', false);
-    expect(explainStatusBarBackend().viability).toBe('runtime-api-unavailable');
+  it('tracks handles within one explicit host', () => {
+    const provider = fakeHost('light');
+    const handle = statusbar.pushStatusBarStyleEntry(provider.host, { style: 'dark' });
+    expect(statusbar.hasStatusBarStyleEntry(provider.host, handle)).toBe(true);
+    statusbar.popStatusBarStyleEntry(provider.host, handle);
+    expect(statusbar.hasStatusBarStyleEntry(provider.host, handle)).toBe(false);
   });
 });
 
 describe('packedRgbaToHexColor', () => {
-  it('converts a packed RGBA to a hex color string', () => {
-    expect(packedRgbaToHexColor(0xff0000ff)).toBe('#ff0000');
-  });
-
-  it('converts black', () => {
-    expect(packedRgbaToHexColor(0x000000ff)).toBe('#000000');
-  });
-
-  it('converts white', () => {
-    expect(packedRgbaToHexColor(0xffffffff)).toBe('#ffffff');
-  });
+  it('drops alpha and pads hex digits', () => expect(statusbar.packedRgbaToHexColor(0x01020304)).toBe('#010203'));
 });
 
 describe('popStatusBarStyleEntry', () => {
-  it('no-ops for unknown or invalid handles', () => {
-    expect(() => popStatusBarStyleEntry(-1)).not.toThrow();
-    expect(() => popStatusBarStyleEntry(99999)).not.toThrow();
-  });
-
-  it('restores the pre-push value rather than leaving the popped entry applied', () => {
-    // The regression this replaces: the old assertion stopped at "the pop does not throw", and the
-    // implementation matched it — popping re-merged the stack, found no entry setting `style`, and
-    // called no setter, so the OS kept the popped entry's value forever. A style stack whose whole
-    // purpose is "restore the previous state on unmount" did not restore.
-    const backend = fakeBackend();
-    backend.style = 'default';
-    setStatusBarBackend(backend);
-    const handle = pushStatusBarStyleEntry({ style: 'dark' });
-    expect(backend.style).toBe('dark');
-    popStatusBarStyleEntry(handle);
-    expect(backend.style).toBe('default');
-  });
-
-  it('restores every field the popped entry had set', () => {
-    const backend = fakeBackend();
-    backend.style = 'light';
-    backend.visible = true;
-    backend.color = 0x112233ff;
-    backend.overlay = false;
-    setStatusBarBackend(backend);
-    const handle = pushStatusBarStyleEntry({
-      color: 0xaabbccff,
-      overlaysContent: true,
-      style: 'dark',
-      visible: false,
-    });
-    popStatusBarStyleEntry(handle);
-    expect(backend.style).toBe('light');
-    expect(backend.visible).toBe(true);
-    expect(backend.color).toBe(0x112233ff);
-    expect(backend.overlay).toBe(false);
-  });
-
-  it('falls back to the entry below before the baseline', () => {
-    const backend = fakeBackend();
-    backend.style = 'default';
-    setStatusBarBackend(backend);
-    pushStatusBarStyleEntry({ style: 'dark' });
-    const top = pushStatusBarStyleEntry({ style: 'light' });
-    expect(backend.style).toBe('light');
-    popStatusBarStyleEntry(top);
-    expect(backend.style).toBe('dark');
-  });
-
-  it('restores after popping out of order', () => {
-    const backend = fakeBackend();
-    backend.style = 'default';
-    setStatusBarBackend(backend);
-    const bottom = pushStatusBarStyleEntry({ style: 'dark' });
-    const top = pushStatusBarStyleEntry({ visible: false });
-    popStatusBarStyleEntry(bottom);
-    expect(backend.style).toBe('default');
-    expect(backend.visible).toBe(false);
-    popStatusBarStyleEntry(top);
-    expect(backend.visible).toBe(true);
-  });
-
-  it('captures a fresh baseline after the stack empties and is pushed again', () => {
-    const backend = fakeBackend();
-    backend.style = 'default';
-    setStatusBarBackend(backend);
-    popStatusBarStyleEntry(pushStatusBarStyleEntry({ style: 'dark' }));
-    // A change made outside the stack becomes the new baseline for the next push.
-    setStatusBarStyle('light');
-    popStatusBarStyleEntry(pushStatusBarStyleEntry({ style: 'dark' }));
-    expect(backend.style).toBe('light');
+  it('restores the captured baseline', () => {
+    const provider = fakeHost('light');
+    const handle = statusbar.pushStatusBarStyleEntry(provider.host, { style: 'dark' });
+    statusbar.popStatusBarStyleEntry(provider.host, handle);
+    expect(provider.setStyle).toHaveBeenLastCalledWith('light');
   });
 });
 
 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('resetStatusBarBackendForTest', () => {
-  it('clears all backend slots', () => {
-    const backend = fakeBackend();
-    setStatusBarBackend(backend);
-    installStatusBarHostBackend(fakeBackend());
-    observeStatusBarHostResult('setBackgroundColor', true);
-    resetStatusBarBackendForTest();
-    expect(getStatusBarBackend()).not.toBe(backend);
-    expect(explainStatusBarBackend().layer).toBe('host-not-enabled');
-    expect(explainStatusBarBackend().conflict).toBe(false);
-    expect(explainStatusBarBackend().viability).toBe('unobserved');
-  });
-});
-
-describe('setStatusBarBackend', () => {
-  it('clears back to the web fallback when passed null', () => {
-    setStatusBarBackend(fakeBackend());
-    setStatusBarBackend(null);
-    expect(getStatusBarBackend()).not.toBeNull();
+  it('merges unset fields through the stack', () => {
+    const provider = fakeHost('light');
+    statusbar.pushStatusBarStyleEntry(provider.host, { style: 'dark' });
+    statusbar.pushStatusBarStyleEntry(provider.host, { visible: false });
+    expect(provider.setStyle).toHaveBeenCalledTimes(1);
+    expect(provider.setVisible).toHaveBeenLastCalledWith(false, 'none');
   });
 });
 
 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);
+  it('uses only the color slot', () => {
+    const provider = fakeHost('light');
+    statusbar.setStatusBarColor(provider.host, 0x112233ff, true);
+    expect(provider.setBackgroundColor).toHaveBeenCalledWith(0x112233ff, true);
   });
 });
 
 describe('setStatusBarOverlaysContent', () => {
-  it('forwards overlay to the active backend', () => {
-    const backend = fakeBackend();
-    setStatusBarBackend(backend);
-    setStatusBarOverlaysContent(true);
-    expect(backend.overlay).toBe(true);
+  it('uses only the overlays slot', () => {
+    const provider = fakeHost('light');
+    statusbar.setStatusBarOverlaysContent(provider.host, true);
+    expect(provider.setOverlaysContent).toHaveBeenCalledWith(true);
   });
 });
 
 describe('setStatusBarStyle', () => {
-  it('forwards style to the active backend', () => {
-    const backend = fakeBackend();
-    setStatusBarBackend(backend);
-    setStatusBarStyle('dark');
-    expect(backend.style).toBe('dark');
+  it('uses only the style slot', () => {
+    const provider = fakeHost('light');
+    statusbar.setStatusBarStyle(provider.host, 'dark');
+    expect(provider.setStyle).toHaveBeenCalledWith('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');
+  it('uses only the visibility slot', () => {
+    const provider = fakeHost('light');
+    statusbar.setStatusBarVisible(provider.host, false, 'fade');
+    expect(provider.setVisible).toHaveBeenCalledWith(false, 'fade');
   });
 });
+
+function fakeHost(initialStyle: StatusBarStyle) {
+  let listener: (() => void) | null = null;
+  const unsubscribe = vi.fn(() => {
+    listener = null;
+  });
+  const setBackgroundColor = vi.fn();
+  const setOverlaysContent = vi.fn();
+  const setStyle = vi.fn();
+  const setVisible = vi.fn();
+  const host: HasUiStatusBarChange & HasUiStatusBarStyleStack = {
+    ui: {
+      statusBarChange: {
+        subscribe(next) {
+          listener = next;
+          return unsubscribe;
+        },
+      },
+      statusBarColor: { setBackgroundColor },
+      statusBarInfo: {
+        getInfo(out) {
+          Object.assign(out, {
+            color: 0,
+            height: 20,
+            overlaysContent: false,
+            style: initialStyle,
+            visible: true,
+          });
+          return out;
+        },
+      },
+      statusBarOverlays: { setOverlaysContent },
+      statusBarStyle: { setStyle },
+      statusBarVisibility: { setVisible },
+    },
+  };
+  return {
+    emit: () => listener?.(),
+    host,
+    setBackgroundColor,
+    setOverlaysContent,
+    setStyle,
+    setVisible,
+    unsubscribe,
+  };
+}