@flighthq/platform 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/platform`. The `@fli
 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/platform@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/platform)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/platform@0.5.1-edge.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/platform)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { explainPlatformBackend, comparePlatformVersions, getPlatformEngine, getPlatformInfo, getPlatformKind, getPlatformName, isPlatformDesktop, isPlatformMobile, isPlatformNative, isPlatformTouch, isPlatformVersionAtLeast, isPlatformWeb, } from './contract';
+export { comparePlatformVersions, getPlatformEngine, getPlatformInfo, getPlatformKind, getPlatformName, getPlatformRuntime, isPlatformDesktop, isPlatformMobile, isPlatformNative, isPlatformTouch, isPlatformVersionAtLeast, isPlatformWeb, } 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,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { explainPlatformBackend, comparePlatformVersions, getPlatformEngine, getPlatformInfo, getPlatformKind, getPlatformName, isPlatformDesktop, isPlatformMobile, isPlatformNative, isPlatformTouch, isPlatformVersionAtLeast, isPlatformWeb, } from './contract';
+export { comparePlatformVersions, getPlatformEngine, getPlatformInfo, getPlatformKind, getPlatformName, getPlatformRuntime, isPlatformDesktop, isPlatformMobile, isPlatformNative, isPlatformTouch, isPlatformVersionAtLeast, isPlatformWeb, } 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,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/platform.d.ts

@@ -1,23 +1,15 @@
-import type { BackendExplanation } from '@flighthq/types/contract';
-import type { PlatformBackend, PlatformEngine, PlatformInfo, PlatformKind, PlatformName, PlatformRuntime } from '@flighthq/types/contract';
+import type { HasSystemPlatform, PlatformEngine, PlatformInfo, PlatformKind, PlatformName, PlatformRuntime } from '@flighthq/types/contract';
 export declare function comparePlatformVersions(a: string, b: string): -1 | 0 | 1;
 export declare function createPlatformInfo(): PlatformInfo;
-export declare function createWebPlatformBackend(): PlatformBackend;
-export declare function explainPlatformBackend(): BackendExplanation;
-export declare function getPlatformBackend(): PlatformBackend;
-export declare function getPlatformEngine(): PlatformEngine;
-export declare function getPlatformInfo(out: PlatformInfo): PlatformInfo;
-export declare function getPlatformKind(): PlatformKind;
-export declare function getPlatformName(): PlatformName;
-export declare function getPlatformRuntime(): PlatformRuntime;
-export declare function installPlatformHostBackend(backend: PlatformBackend): void;
-export declare function isPlatformDesktop(): boolean;
-export declare function isPlatformMobile(): boolean;
-export declare function isPlatformNative(): boolean;
-export declare function isPlatformTouch(): boolean;
-export declare function isPlatformVersionAtLeast(minimum: string): boolean;
-export declare function isPlatformWeb(): boolean;
-export declare function observePlatformHostResult(operation: string, succeeded: boolean): void;
-export declare function resetPlatformBackendForTest(): void;
-export declare function setPlatformBackend(backend: PlatformBackend | null): void;
+export declare function getPlatformEngine(host: HasSystemPlatform): PlatformEngine;
+export declare function getPlatformInfo(host: HasSystemPlatform, out: PlatformInfo): PlatformInfo;
+export declare function getPlatformKind(host: HasSystemPlatform): PlatformKind;
+export declare function getPlatformName(host: HasSystemPlatform): PlatformName;
+export declare function getPlatformRuntime(host: HasSystemPlatform): PlatformRuntime;
+export declare function isPlatformDesktop(host: HasSystemPlatform): boolean;
+export declare function isPlatformMobile(host: HasSystemPlatform): boolean;
+export declare function isPlatformNative(host: HasSystemPlatform): boolean;
+export declare function isPlatformTouch(host: HasSystemPlatform): boolean;
+export declare function isPlatformVersionAtLeast(host: HasSystemPlatform, minimum: string): boolean;
+export declare function isPlatformWeb(host: HasSystemPlatform): boolean;
 //# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAgBlC,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAcxE;AAGD,wBAAgB,kBAAkB,IAAI,YAAY,CAiBjD;AAID,wBAAgB,wBAAwB,IAAI,eAAe,CAE1D;AAED,wBAAgB,sBAAsB,IAAI,kBAAkB,CAa3D;AAID,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAID,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAGD,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAE/D;AAGD,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAGD,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAID,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAMzE;AAGD,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAGD,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAID,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAGD,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAKD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIjE;AAGD,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAKrF;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAKlD;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAExE"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAKlC,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAcxE;AAGD,wBAAgB,kBAAkB,IAAI,YAAY,CAiBjD;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,CAEzE;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,YAAY,GAAG,YAAY,CAExF;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,YAAY,CAErE;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,YAAY,CAErE;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,eAAe,CAE3E;AAGD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAElE;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEjE;AAID,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAGjE;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEhE;AAKD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAI1F;AAGD,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAE9D"}

package/dist/platform.js

@@ -1,4 +1,3 @@
-import { detectEndianness, parseUserAgentArch, parseUserAgentEngine, parseUserAgentEngineVersion, parseUserAgentKind, parseUserAgentName, parseUserAgentPointerWidth, parseUserAgentRuntime, parseUserAgentVersion, } from '@flighthq/useragent/contract';
 // Compares two dotted version strings numerically, segment by segment. Returns -1, 0, or 1.
 // Non-numeric trailing segments are ignored; '' sorts lowest. '' compared with '' returns 0.
 // Example: comparePlatformVersions('10.15.7', '10.15.6') === 1.
@@ -39,153 +38,60 @@ export function createPlatformInfo() {
         version: '',
     };
 }
-// The fixed point of the suite: a host backend that identifies the running platform. Resolves to the
-// registered native backend, or a lazily-created web backend so there is always an answer.
-export function createWebPlatformBackend() {
-    return { getInfo: getWebPlatformInfo };
-}
-export function explainPlatformBackend() {
-    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 platform backend. Capability packages call their own get*Backend; this is the root
-// one for environment identification.
-export function getPlatformBackend() {
-    return _custom ?? _host ?? _sentinel;
-}
 // The browser rendering engine — 'blink' | 'gecko' | 'webkit' | 'unknown'. Convenience over
 // getPlatformInfo. 'unknown' on native hosts where no browser engine is present.
-export function getPlatformEngine() {
-    return getPlatformInfo(_scratch).engine;
+export function getPlatformEngine(host) {
+    return getPlatformInfo(host, _scratch).engine;
 }
 // Fills `out` with the running platform's identity and returns it. Cheap; reads the active backend.
-export function getPlatformInfo(out) {
-    return getPlatformBackend().getInfo(out);
+export function getPlatformInfo(host, out) {
+    return host.system.platform.getInfo(out);
 }
 // The platform family — 'desktop' | 'mobile' | 'web' | 'unknown'. Convenience over getPlatformInfo.
-export function getPlatformKind() {
-    return getPlatformInfo(_scratch).kind;
+export function getPlatformKind(host) {
+    return getPlatformInfo(host, _scratch).kind;
 }
 // The specific OS/runtime name — 'windows' | 'macos' | 'ios' | 'android' | 'linux' | 'web' | 'unknown'.
-export function getPlatformName() {
-    return getPlatformInfo(_scratch).name;
+export function getPlatformName(host) {
+    return getPlatformInfo(host, _scratch).name;
 }
 // The host shell / runtime environment — 'web' | 'electron' | 'tauri' | 'capacitor' | 'native' |
 // 'unknown'. Convenience over getPlatformInfo. Distinguishes plain web from a host shell.
-export function getPlatformRuntime() {
-    return getPlatformInfo(_scratch).runtime;
-}
-export function installPlatformHostBackend(backend) {
-    if (_host !== null) {
-        if (_host !== backend)
-            _hostConflict = true;
-        return;
-    }
-    _host = backend;
+export function getPlatformRuntime(host) {
+    return getPlatformInfo(host, _scratch).runtime;
 }
 // True on a desktop host (Electron/Tauri/native window shell). False on mobile and plain web.
-export function isPlatformDesktop() {
-    return getPlatformKind() === 'desktop';
+export function isPlatformDesktop(host) {
+    return getPlatformKind(host) === 'desktop';
 }
 // True on a mobile host (iOS/Android via Capacitor or a native shell).
-export function isPlatformMobile() {
-    return getPlatformKind() === 'mobile';
+export function isPlatformMobile(host) {
+    return getPlatformKind(host) === 'mobile';
 }
 // True when the app is running inside a host shell (Electron/Tauri/Capacitor/native), not a plain
 // browser page. Convenience over `getPlatformRuntime() !== 'web' && !== 'unknown'`.
-export function isPlatformNative() {
-    const runtime = getPlatformRuntime();
+export function isPlatformNative(host) {
+    const runtime = getPlatformRuntime(host);
     return runtime !== 'web' && runtime !== 'unknown';
 }
 // True on a touch-primary device, independent of desktop/mobile classification.
-export function isPlatformTouch() {
-    return getPlatformInfo(_scratch).isTouch;
+export function isPlatformTouch(host) {
+    return getPlatformInfo(host, _scratch).isTouch;
 }
 // True when the running platform's OS version is at or above `minimum`. Reads the live version via
 // getPlatformInfo. Returns false when the version is '' (unknown). The comparison is numeric and
 // segment-wise (see comparePlatformVersions).
-export function isPlatformVersionAtLeast(minimum) {
-    const version = getPlatformInfo(_scratch).version;
+export function isPlatformVersionAtLeast(host, minimum) {
+    const version = getPlatformInfo(host, _scratch).version;
     if (version === '')
         return false;
     return comparePlatformVersions(version, minimum) >= 0;
 }
 // True when running as a plain web page with no native host registered.
-export function isPlatformWeb() {
-    return getPlatformKind() === 'web';
-}
-export function observePlatformHostResult(operation, succeeded) {
-    _hostObservation = {
-        operation,
-        viability: succeeded ? 'available' : 'runtime-api-unavailable',
-    };
+export function isPlatformWeb(host) {
+    return getPlatformKind(host) === 'web';
 }
-export function resetPlatformBackendForTest() {
-    _custom = null;
-    _host = null;
-    _hostConflict = false;
-    _hostObservation = null;
-}
-// Installs a native host backend (Electron/Tauri/Capacitor/native). Pass null to fall back to
-// the host or sentinel layer.
-export function setPlatformBackend(backend) {
-    _custom = backend;
-}
-let _custom = null;
-let _host = null;
-let _hostConflict = false;
-let _hostObservation = null;
 // Single-threaded JS no-alloc scratch for scalar convenience reads (getPlatformKind, etc.).
 // Rust/native mirror uses a per-call local or thread-local instead.
 const _scratch = createPlatformInfo();
-const _sentinel = {
-    getInfo(out) {
-        out.arch = '';
-        out.distro = '';
-        out.distroVersion = '';
-        out.endianness = 'unknown';
-        out.engine = 'unknown';
-        out.engineVersion = '';
-        out.isTouch = false;
-        out.kind = 'unknown';
-        out.locale = '';
-        out.name = 'unknown';
-        out.osBuild = '';
-        out.pointerWidth = -1;
-        out.runtime = 'unknown';
-        out.version = '';
-        return out;
-    },
-};
-function getWebPlatformInfo(out) {
-    const nav = typeof navigator !== 'undefined' ? navigator : null;
-    const ua = nav?.userAgent ?? '';
-    out.name = parseUserAgentName(ua);
-    out.kind = parseUserAgentKind(out.name);
-    out.version = parseUserAgentVersion(ua, out.name);
-    out.arch = parseUserAgentArch(ua);
-    out.locale = nav?.language ?? '';
-    out.isTouch =
-        typeof navigator !== 'undefined' && 'maxTouchPoints' in navigator ? navigator.maxTouchPoints > 0 : false;
-    out.runtime = parseUserAgentRuntime(typeof window !== 'undefined' ? window : null);
-    out.engine = parseUserAgentEngine(ua);
-    out.engineVersion = parseUserAgentEngineVersion(ua, out.engine);
-    out.endianness = detectEndianness();
-    out.pointerWidth = parseUserAgentPointerWidth(out.arch);
-    // osBuild, distro, distroVersion are native-only; web always returns ''.
-    out.osBuild = '';
-    out.distro = '';
-    out.distroVersion = '';
-    return out;
-}
 //# sourceMappingURL=platform.js.map

package/dist/platform.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/platform",
-  "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/types": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/useragent": "0.5.0-next.1944.cd6b6e7"
+    "@flighthq/types": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/useragent": "0.5.1-edge.638.d4dbd4e"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/platform.test.ts

@@ -1,10 +1,9 @@
-import type { PlatformBackend, PlatformInfo } from '@flighthq/types/contract';
+import type { HasSystemPlatform, PlatformBackend, PlatformInfo } from '@flighthq/types/contract';
 
+import * as platformContract from './platform';
 import {
   comparePlatformVersions,
   createPlatformInfo,
-  createWebPlatformBackend,
-  getPlatformBackend,
   getPlatformEngine,
   getPlatformInfo,
   getPlatformKind,
@@ -16,11 +15,6 @@ import {
   isPlatformTouch,
   isPlatformVersionAtLeast,
   isPlatformWeb,
-  setPlatformBackend,
-  explainPlatformBackend,
-  installPlatformHostBackend,
-  observePlatformHostResult,
-  resetPlatformBackendForTest,
 } from './platform';
 
 function fakeBackend(info: Partial<PlatformInfo>): PlatformBackend {
@@ -32,7 +26,9 @@ function fakeBackend(info: Partial<PlatformInfo>): PlatformBackend {
   };
 }
 
-afterEach(() => setPlatformBackend(null));
+function fakeHost(info: Partial<PlatformInfo>): HasSystemPlatform {
+  return { system: { platform: fakeBackend(info) } };
+}
 
 describe('comparePlatformVersions', () => {
   it('returns 0 for identical strings', () => {
@@ -92,571 +88,157 @@ describe('createPlatformInfo', () => {
   });
 });
 
-describe('createWebPlatformBackend', () => {
-  it('produces a backend that fills the out info', () => {
-    const out = createPlatformInfo();
-    const result = createWebPlatformBackend().getInfo(out);
-    expect(result).toBe(out);
-    expect(typeof result.name).toBe('string');
-  });
-
-  it('sets engine to a known canonical value', () => {
-    const out = createPlatformInfo();
-    createWebPlatformBackend().getInfo(out);
-    expect(['blink', 'gecko', 'webkit', 'unknown']).toContain(out.engine);
-  });
-
-  it('sets runtime to a known canonical value', () => {
-    const out = createPlatformInfo();
-    createWebPlatformBackend().getInfo(out);
-    expect(['web', 'electron', 'tauri', 'capacitor', 'native', 'unknown']).toContain(out.runtime);
-  });
-
-  it('sets kind to a known canonical value', () => {
-    const out = createPlatformInfo();
-    createWebPlatformBackend().getInfo(out);
-    expect(['desktop', 'mobile', 'web', 'unknown']).toContain(out.kind);
-  });
-
-  it('sets name to a known canonical value', () => {
-    const out = createPlatformInfo();
-    createWebPlatformBackend().getInfo(out);
-    expect(['web', 'windows', 'macos', 'linux', 'ios', 'android', 'unknown']).toContain(out.name);
-  });
-
-  it('sets endianness to a known canonical value', () => {
-    const out = createPlatformInfo();
-    createWebPlatformBackend().getInfo(out);
-    expect(['little', 'big', 'unknown']).toContain(out.endianness);
-  });
-
-  it('sets pointerWidth to a known canonical value', () => {
-    const out = createPlatformInfo();
-    createWebPlatformBackend().getInfo(out);
-    expect([-1, 32, 64]).toContain(out.pointerWidth);
-  });
-
-  it('sets osBuild, distro, distroVersion to empty string on web', () => {
-    const out = createPlatformInfo();
-    createWebPlatformBackend().getInfo(out);
-    expect(out.osBuild).toBe('');
-    expect(out.distro).toBe('');
-    expect(out.distroVersion).toBe('');
-  });
-});
-
-describe('explainPlatformBackend', () => {
-  afterEach(() => resetPlatformBackendForTest());
-
-  it('reports host-not-enabled when no backend is installed', () => {
-    resetPlatformBackendForTest();
-    const explanation = explainPlatformBackend();
-    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', () => {
-    setPlatformBackend(fakeBackend({}));
-    expect(explainPlatformBackend().layer).toBe('custom');
-  });
-
-  it('reports host layer when a host backend is installed', () => {
-    installPlatformHostBackend(fakeBackend({}));
-    expect(explainPlatformBackend().layer).toBe('host');
-  });
-
-  it('reports conflict when two different host backends are installed', () => {
-    installPlatformHostBackend(fakeBackend({}));
-    installPlatformHostBackend(fakeBackend({}));
-    expect(explainPlatformBackend().conflict).toBe(true);
-  });
-});
-
-describe('getPlatformBackend', () => {
-  it('falls back to a web backend when none is registered', () => {
-    expect(getPlatformBackend()).not.toBeNull();
-  });
-
-  it('returns the registered backend', () => {
-    const backend = fakeBackend({ kind: 'desktop', name: 'windows' });
-    setPlatformBackend(backend);
-    expect(getPlatformBackend()).toBe(backend);
-  });
-});
-
 describe('getPlatformEngine', () => {
-  it('returns the engine from the active backend', () => {
-    setPlatformBackend(fakeBackend({ engine: 'blink' }));
-    expect(getPlatformEngine()).toBe('blink');
+  it('returns the engine from the host backend', () => {
+    expect(getPlatformEngine(fakeHost({ engine: 'blink' }))).toBe('blink');
   });
 
   it('returns gecko when set', () => {
-    setPlatformBackend(fakeBackend({ engine: 'gecko' }));
-    expect(getPlatformEngine()).toBe('gecko');
+    expect(getPlatformEngine(fakeHost({ engine: 'gecko' }))).toBe('gecko');
   });
 
   it('returns webkit when set', () => {
-    setPlatformBackend(fakeBackend({ engine: 'webkit' }));
-    expect(getPlatformEngine()).toBe('webkit');
+    expect(getPlatformEngine(fakeHost({ engine: 'webkit' }))).toBe('webkit');
   });
 
   it('returns unknown for native backends', () => {
-    setPlatformBackend(fakeBackend({ engine: 'unknown' }));
-    expect(getPlatformEngine()).toBe('unknown');
+    expect(getPlatformEngine(fakeHost({ engine: 'unknown' }))).toBe('unknown');
   });
 });
 
 describe('getPlatformInfo', () => {
   it('fills and returns the out parameter', () => {
-    setPlatformBackend(fakeBackend({ arch: 'arm64', kind: 'mobile', name: 'ios' }));
+    const host = fakeHost({ arch: 'arm64', kind: 'mobile', name: 'ios' });
     const out = createPlatformInfo();
-    expect(getPlatformInfo(out)).toBe(out);
+    expect(getPlatformInfo(host, out)).toBe(out);
     expect(out.name).toBe('ios');
     expect(out.arch).toBe('arm64');
   });
 });
 
 describe('getPlatformKind', () => {
-  it('returns the active backend kind', () => {
-    setPlatformBackend(fakeBackend({ kind: 'desktop' }));
-    expect(getPlatformKind()).toBe('desktop');
+  it('returns the host backend kind', () => {
+    expect(getPlatformKind(fakeHost({ kind: 'desktop' }))).toBe('desktop');
   });
 });
 
 describe('getPlatformName', () => {
-  it('returns the active backend name', () => {
-    setPlatformBackend(fakeBackend({ name: 'macos' }));
-    expect(getPlatformName()).toBe('macos');
+  it('returns the host backend name', () => {
+    expect(getPlatformName(fakeHost({ name: 'macos' }))).toBe('macos');
   });
 });
 
 describe('getPlatformRuntime', () => {
   it('returns web when no host shell is detected', () => {
-    setPlatformBackend(fakeBackend({ runtime: 'web' }));
-    expect(getPlatformRuntime()).toBe('web');
+    expect(getPlatformRuntime(fakeHost({ runtime: 'web' }))).toBe('web');
   });
 
   it('returns electron when set', () => {
-    setPlatformBackend(fakeBackend({ runtime: 'electron' }));
-    expect(getPlatformRuntime()).toBe('electron');
+    expect(getPlatformRuntime(fakeHost({ runtime: 'electron' }))).toBe('electron');
   });
 
   it('returns tauri when set', () => {
-    setPlatformBackend(fakeBackend({ runtime: 'tauri' }));
-    expect(getPlatformRuntime()).toBe('tauri');
+    expect(getPlatformRuntime(fakeHost({ runtime: 'tauri' }))).toBe('tauri');
   });
 
   it('returns capacitor when set', () => {
-    setPlatformBackend(fakeBackend({ runtime: 'capacitor' }));
-    expect(getPlatformRuntime()).toBe('capacitor');
+    expect(getPlatformRuntime(fakeHost({ runtime: 'capacitor' }))).toBe('capacitor');
   });
 
   it('returns native when set by a native backend', () => {
-    setPlatformBackend(fakeBackend({ runtime: 'native' }));
-    expect(getPlatformRuntime()).toBe('native');
-  });
-});
-
-describe('installPlatformHostBackend', () => {
-  afterEach(() => resetPlatformBackendForTest());
-
-  it('installs a host backend that getPlatformBackend returns', () => {
-    const backend = fakeBackend({});
-    installPlatformHostBackend(backend);
-    expect(getPlatformBackend()).toBe(backend);
-  });
-
-  it('is first-host-wins: a second different backend sets conflict', () => {
-    const first = fakeBackend({});
-    const second = fakeBackend({});
-    installPlatformHostBackend(first);
-    installPlatformHostBackend(second);
-    expect(getPlatformBackend()).toBe(first);
-    expect(explainPlatformBackend().conflict).toBe(true);
+    expect(getPlatformRuntime(fakeHost({ runtime: 'native' }))).toBe('native');
   });
 });
 
 describe('isPlatformDesktop', () => {
   it('is true only for desktop kind', () => {
-    setPlatformBackend(fakeBackend({ kind: 'desktop' }));
-    expect(isPlatformDesktop()).toBe(true);
-    setPlatformBackend(fakeBackend({ kind: 'web' }));
-    expect(isPlatformDesktop()).toBe(false);
+    expect(isPlatformDesktop(fakeHost({ kind: 'desktop' }))).toBe(true);
+    expect(isPlatformDesktop(fakeHost({ kind: 'web' }))).toBe(false);
   });
 });
 
 describe('isPlatformMobile', () => {
   it('is true only for mobile kind', () => {
-    setPlatformBackend(fakeBackend({ kind: 'mobile' }));
-    expect(isPlatformMobile()).toBe(true);
+    expect(isPlatformMobile(fakeHost({ kind: 'mobile' }))).toBe(true);
   });
 });
 
 describe('isPlatformNative', () => {
   it('is true for electron runtime', () => {
-    setPlatformBackend(fakeBackend({ runtime: 'electron' }));
-    expect(isPlatformNative()).toBe(true);
+    expect(isPlatformNative(fakeHost({ runtime: 'electron' }))).toBe(true);
   });
 
   it('is true for tauri runtime', () => {
-    setPlatformBackend(fakeBackend({ runtime: 'tauri' }));
-    expect(isPlatformNative()).toBe(true);
+    expect(isPlatformNative(fakeHost({ runtime: 'tauri' }))).toBe(true);
   });
 
   it('is true for capacitor runtime', () => {
-    setPlatformBackend(fakeBackend({ runtime: 'capacitor' }));
-    expect(isPlatformNative()).toBe(true);
+    expect(isPlatformNative(fakeHost({ runtime: 'capacitor' }))).toBe(true);
   });
 
   it('is true for native runtime', () => {
-    setPlatformBackend(fakeBackend({ runtime: 'native' }));
-    expect(isPlatformNative()).toBe(true);
+    expect(isPlatformNative(fakeHost({ runtime: 'native' }))).toBe(true);
   });
 
   it('is false for web runtime', () => {
-    setPlatformBackend(fakeBackend({ runtime: 'web' }));
-    expect(isPlatformNative()).toBe(false);
+    expect(isPlatformNative(fakeHost({ runtime: 'web' }))).toBe(false);
   });
 
   it('is false for unknown runtime', () => {
-    setPlatformBackend(fakeBackend({ runtime: 'unknown' }));
-    expect(isPlatformNative()).toBe(false);
+    expect(isPlatformNative(fakeHost({ runtime: 'unknown' }))).toBe(false);
   });
 });
 
 describe('isPlatformTouch', () => {
   it('reflects the backend isTouch flag', () => {
-    setPlatformBackend(fakeBackend({ isTouch: true }));
-    expect(isPlatformTouch()).toBe(true);
+    expect(isPlatformTouch(fakeHost({ isTouch: true }))).toBe(true);
   });
 });
 
 describe('isPlatformVersionAtLeast', () => {
   it('is true when version equals minimum', () => {
-    setPlatformBackend(fakeBackend({ version: '14.0' }));
-    expect(isPlatformVersionAtLeast('14.0')).toBe(true);
+    expect(isPlatformVersionAtLeast(fakeHost({ version: '14.0' }), '14.0')).toBe(true);
   });
 
   it('is true when version exceeds minimum', () => {
-    setPlatformBackend(fakeBackend({ version: '15.0' }));
-    expect(isPlatformVersionAtLeast('14.0')).toBe(true);
+    expect(isPlatformVersionAtLeast(fakeHost({ version: '15.0' }), '14.0')).toBe(true);
   });
 
   it('is false when version is below minimum', () => {
-    setPlatformBackend(fakeBackend({ version: '13.0' }));
-    expect(isPlatformVersionAtLeast('14.0')).toBe(false);
+    expect(isPlatformVersionAtLeast(fakeHost({ version: '13.0' }), '14.0')).toBe(false);
   });
 
   it('is false when version is empty (unknown)', () => {
-    setPlatformBackend(fakeBackend({ version: '' }));
-    expect(isPlatformVersionAtLeast('1.0')).toBe(false);
+    expect(isPlatformVersionAtLeast(fakeHost({ version: '' }), '1.0')).toBe(false);
   });
 
   it('handles patch-level comparison', () => {
-    setPlatformBackend(fakeBackend({ version: '10.15.7' }));
-    expect(isPlatformVersionAtLeast('10.15.6')).toBe(true);
-    expect(isPlatformVersionAtLeast('10.15.7')).toBe(true);
-    expect(isPlatformVersionAtLeast('10.15.8')).toBe(false);
+    expect(isPlatformVersionAtLeast(fakeHost({ version: '10.15.7' }), '10.15.6')).toBe(true);
+    expect(isPlatformVersionAtLeast(fakeHost({ version: '10.15.7' }), '10.15.7')).toBe(true);
+    expect(isPlatformVersionAtLeast(fakeHost({ version: '10.15.7' }), '10.15.8')).toBe(false);
   });
 });
 
 describe('isPlatformWeb', () => {
   it('is true only for web kind', () => {
-    setPlatformBackend(fakeBackend({ kind: 'web' }));
-    expect(isPlatformWeb()).toBe(true);
-  });
-});
-
-describe('observePlatformHostResult', () => {
-  afterEach(() => resetPlatformBackendForTest());
-
-  it('records a successful observation', () => {
-    installPlatformHostBackend(fakeBackend({}));
-    observePlatformHostResult('getInfo', true);
-    const explanation = explainPlatformBackend();
-    expect(explanation.operation).toBe('getInfo');
-    expect(explanation.viability).toBe('available');
-  });
-
-  it('records a failed observation', () => {
-    installPlatformHostBackend(fakeBackend({}));
-    observePlatformHostResult('getInfo', false);
-    expect(explainPlatformBackend().viability).toBe('runtime-api-unavailable');
-  });
-});
-
-describe('resetPlatformBackendForTest', () => {
-  it('clears all backend slots', () => {
-    setPlatformBackend(fakeBackend({}));
-    installPlatformHostBackend(fakeBackend({}));
-    observePlatformHostResult('getInfo', true);
-    resetPlatformBackendForTest();
-    expect(explainPlatformBackend().layer).toBe('host-not-enabled');
-    expect(explainPlatformBackend().conflict).toBe(false);
-    expect(explainPlatformBackend().viability).toBe('unobserved');
+    expect(isPlatformWeb(fakeHost({ kind: 'web' }))).toBe(true);
   });
 });
 
-describe('setPlatformBackend', () => {
-  it('clears back to the web fallback when passed null', () => {
-    setPlatformBackend(fakeBackend({ name: 'linux' }));
-    setPlatformBackend(null);
-    expect(getPlatformBackend()).not.toBeNull();
-  });
-});
-
-// Web backend UA-detection tests — use the internal createWebPlatformBackend to exercise detection
-// heuristics under controlled UA strings. These run in jsdom which may have its own navigator.
-describe('web backend UA detection', () => {
-  // Helper: temporarily replace navigator.userAgent for a block (jsdom only).
-  function withUserAgent(ua: string, fn: () => void): void {
-    const original = navigator.userAgent;
-    Object.defineProperty(navigator, 'userAgent', { configurable: true, value: ua });
-    try {
-      fn();
-    } finally {
-      Object.defineProperty(navigator, 'userAgent', { configurable: true, value: original });
-    }
-  }
-
-  describe('arch detection', () => {
-    it('detects arm64 from aarch64', () => {
-      withUserAgent('Mozilla/5.0 (Linux; aarch64) AppleWebKit/537.36', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.arch).toBe('arm64');
-      });
-    });
-
-    it('detects arm64 from arm64 token', () => {
-      withUserAgent('Mozilla/5.0 (iPhone; CPU arm64)', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.arch).toBe('arm64');
-      });
-    });
-
-    it('detects x64 from Win64', () => {
-      withUserAgent('Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.arch).toBe('x64');
-      });
-    });
-
-    it('detects x64 from WOW64', () => {
-      withUserAgent('Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.arch).toBe('x64');
-      });
-    });
-
-    it('returns empty string when arch is undetectable', () => {
-      withUserAgent('Mozilla/5.0 (X11; Linux) AppleWebKit/537.36', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.arch).toBe('');
-      });
-    });
-  });
-
-  describe('canonical token normalization', () => {
-    const KNOWN_NAMES = ['web', 'windows', 'macos', 'linux', 'ios', 'android', 'unknown'];
-    const KNOWN_KINDS = ['desktop', 'mobile', 'web', 'unknown'];
-    const KNOWN_RUNTIMES = ['web', 'electron', 'tauri', 'capacitor', 'native', 'unknown'];
-    const KNOWN_ENGINES = ['blink', 'gecko', 'webkit', 'unknown'];
-    const KNOWN_ENDIANNESSES = ['little', 'big', 'unknown'];
-    const KNOWN_POINTER_WIDTHS = [-1, 32, 64];
-
-    const TEST_UAS = [
-      // Windows Chrome
-      'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
-      // macOS Safari
-      'Mozilla/5.0 (Macintosh; Intel Mac OS X 13_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Safari/605.1.15',
-      // Firefox
-      'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:120.0) Gecko/20100101 Firefox/120.0',
-      // iOS Safari
-      'Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X) AppleWebKit/605.1.15',
-      // Android Chrome
-      'Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36',
+describe('R3 boundary', () => {
+  it('exports no ambient-state API (setPlatformBackend, getPlatformBackend, etc.)', () => {
+    const exports = Object.keys(platformContract);
+    const deletedSymbols = [
+      'createWebPlatformBackend',
+      'explainPlatformBackend',
+      'getPlatformBackend',
+      'installPlatformHostBackend',
+      'observePlatformHostResult',
+      'resetPlatformBackendForTest',
+      'setPlatformBackend',
     ];
-
-    for (const ua of TEST_UAS) {
-      it(`only emits known canonical tokens for UA: ${ua.slice(0, 60)}…`, () => {
-        withUserAgent(ua, () => {
-          const out = createPlatformInfo();
-          createWebPlatformBackend().getInfo(out);
-          expect(KNOWN_NAMES).toContain(out.name);
-          expect(KNOWN_KINDS).toContain(out.kind);
-          expect(KNOWN_RUNTIMES).toContain(out.runtime);
-          expect(KNOWN_ENGINES).toContain(out.engine);
-          expect(KNOWN_ENDIANNESSES).toContain(out.endianness);
-          expect(KNOWN_POINTER_WIDTHS).toContain(out.pointerWidth);
-          expect(typeof out.version).toBe('string');
-          expect(typeof out.engineVersion).toBe('string');
-          expect(typeof out.arch).toBe('string');
-        });
-      });
+    for (const symbol of deletedSymbols) {
+      expect(exports).not.toContain(symbol);
     }
   });
-
-  describe('endianness detection', () => {
-    it('returns a known canonical value', () => {
-      const out = createPlatformInfo();
-      createWebPlatformBackend().getInfo(out);
-      expect(['little', 'big', 'unknown']).toContain(out.endianness);
-    });
-
-    it('returns little on jsdom (x64 host)', () => {
-      // jsdom runs on Node.js on x64 hardware — always little-endian.
-      const out = createPlatformInfo();
-      createWebPlatformBackend().getInfo(out);
-      expect(out.endianness).toBe('little');
-    });
-  });
-
-  describe('engine detection', () => {
-    it('detects blink from Chrome UA', () => {
-      withUserAgent(
-        'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
-        () => {
-          const out = createPlatformInfo();
-          createWebPlatformBackend().getInfo(out);
-          expect(out.engine).toBe('blink');
-        },
-      );
-    });
-
-    it('detects gecko from Firefox UA', () => {
-      withUserAgent('Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:120.0) Gecko/20100101 Firefox/120.0', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.engine).toBe('gecko');
-      });
-    });
-
-    it('detects webkit from Safari UA', () => {
-      withUserAgent(
-        'Mozilla/5.0 (Macintosh; Intel Mac OS X 13_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Safari/605.1.15',
-        () => {
-          const out = createPlatformInfo();
-          createWebPlatformBackend().getInfo(out);
-          expect(out.engine).toBe('webkit');
-        },
-      );
-    });
-  });
-
-  describe('engineVersion detection', () => {
-    it('extracts Firefox version', () => {
-      withUserAgent('Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:120.0) Gecko/20100101 Firefox/120.0', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.engineVersion).toBe('120.0');
-      });
-    });
-
-    it('extracts Chrome version', () => {
-      withUserAgent(
-        'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.6099.109 Safari/537.36',
-        () => {
-          const out = createPlatformInfo();
-          createWebPlatformBackend().getInfo(out);
-          expect(out.engineVersion).toBe('120.0.6099.109');
-        },
-      );
-    });
-
-    it('extracts Edge version (Edg/ token)', () => {
-      withUserAgent(
-        'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Edg/120.0.2210.133',
-        () => {
-          const out = createPlatformInfo();
-          createWebPlatformBackend().getInfo(out);
-          expect(out.engineVersion).toBe('120.0.2210.133');
-        },
-      );
-    });
-
-    it('extracts Safari version from Version/ token', () => {
-      withUserAgent(
-        'Mozilla/5.0 (Macintosh; Intel Mac OS X 13_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Safari/605.1.15',
-        () => {
-          const out = createPlatformInfo();
-          createWebPlatformBackend().getInfo(out);
-          expect(out.engineVersion).toBe('16.0');
-        },
-      );
-    });
-  });
-
-  describe('pointerWidth detection', () => {
-    it('returns 64 for x64 arch', () => {
-      withUserAgent('Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.pointerWidth).toBe(64);
-      });
-    });
-
-    it('returns 64 for arm64 arch', () => {
-      withUserAgent('Mozilla/5.0 (Linux; aarch64) AppleWebKit/537.36', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.pointerWidth).toBe(64);
-      });
-    });
-
-    it('returns -1 when arch is undetectable', () => {
-      withUserAgent('Mozilla/5.0 (X11; Linux) AppleWebKit/537.36', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.pointerWidth).toBe(-1);
-      });
-    });
-  });
-
-  describe('version detection', () => {
-    it('parses Windows version from NT string', () => {
-      withUserAgent('Mozilla/5.0 (Windows NT 10.0; Win64; x64)', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.version).toBe('10.0');
-      });
-    });
-
-    it('parses macOS version with underscore separators', () => {
-      withUserAgent('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.version).toBe('10.15.7');
-      });
-    });
-
-    it('parses iOS version', () => {
-      withUserAgent('Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X)', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.version).toBe('17.4.1');
-      });
-    });
-
-    it('parses Android version', () => {
-      withUserAgent('Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.version).toBe('14');
-      });
-    });
-
-    it('returns empty string when version is undetectable', () => {
-      withUserAgent('Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36', () => {
-        const out = createPlatformInfo();
-        createWebPlatformBackend().getInfo(out);
-        expect(out.version).toBe('');
-      });
-    });
-  });
 });