@flighthq/platform 0.1.0

package/README.md

@@ -0,0 +1,77 @@
+# @flighthq/platform
+
+Environment identification — OS name, family, architecture, runtime shell, and engine — over a swappable web/native backend.
+
+`platform` is the **root identification seam** of the desktop/mobile integration suite. Every public function is a free function that delegates to the active `PlatformBackend`. A web/DOM backend is lazily available, so every function works on the web; a native host (Electron, Tauri, Capacitor, a C/C++ shell) replaces it via `setPlatformBackend`. Snapshot reads fill an `out` value and return it. Unknown or unavailable fields resolve to sentinels (`''` / `-1` / `'unknown'` / `false`), never throwing. Import is side-effect-free: nothing registers until a host calls `setPlatformBackend`.
+
+This package answers _what host am I running on_. Live, event-bearing, or richer concerns live in their own cells (see the delegation table) — `PlatformInfo` is a static identity snapshot.
+
+## Functions
+
+| Function | Purpose |
+| --- | --- |
+| `comparePlatformVersions(a, b)` | Compare two dotted version strings numerically, segment by segment. Returns `-1` / `0` / `1`; `''` sorts lowest. |
+| `createPlatformInfo()` | Allocate a zeroed `PlatformInfo` (strings `''`, `kind`/`name`/`runtime`/`engine` `'unknown'`, `endianness` `'unknown'`, `pointerWidth` `-1`, `isTouch` `false`) to pass as `out`. |
+| `createWebPlatformBackend()` | Build the default web backend. |
+| `getPlatformBackend()` | Return the active backend, lazily creating the web default. There is always a backend. |
+| `getPlatformEngine()` | Return the browser engine family. Convenience over `getPlatformInfo`. |
+| `getPlatformInfo(out)` | Fill `out` with the running platform's identity snapshot and return it. |
+| `getPlatformKind()` | Return the platform family (`desktop` / `mobile` / `web` / `unknown`). Convenience over `getPlatformInfo`. |
+| `getPlatformName()` | Return the OS/runtime name. Convenience over `getPlatformInfo`. |
+| `getPlatformRuntime()` | Return the host shell / runtime environment. Convenience over `getPlatformInfo`. |
+| `isPlatformDesktop()` | `true` on a desktop host (Electron/Tauri/native window shell). |
+| `isPlatformMobile()` | `true` on a mobile host (iOS/Android via Capacitor or a native shell). |
+| `isPlatformNative()` | `true` when running inside a host shell, not a plain browser page. |
+| `isPlatformTouch()` | `true` on a touch-primary device, independent of desktop/mobile classification. |
+| `isPlatformVersionAtLeast(minimum)` | `true` when the live OS version is at or above `minimum`. `false` when the version is `''`. |
+| `isPlatformWeb()` | `true` when running as a plain web page with no native host registered. |
+| `setPlatformBackend(backend)` | Install a native host backend. Pass `null` to fall back to the web default. |
+
+## `PlatformInfo` fields
+
+`PlatformInfo` carries 14 fields. Every field is filled on the web from the user-agent string, `navigator`, and runtime probes; native hosts fill the same shape from OS APIs. Fields a web page cannot honestly report resolve to a sentinel rather than guessing.
+
+| Field | Type | Value space | Sentinel | Web source | Native source |
+| --- | --- | --- | --- | --- | --- |
+| `name` | `PlatformName` | `'web'` `'windows'` `'macos'` `'linux'` `'ios'` `'android'` `'unknown'` | `'unknown'` | parsed from UA string | OS name |
+| `kind` | `PlatformKind` | `'desktop'` `'mobile'` `'web'` `'unknown'` | `'unknown'` | derived from `name` | OS family |
+| `version` | `string` | dotted OS version, e.g. `'10.15.7'` | `''` | parsed from UA string (best-effort) | OS version API |
+| `arch` | `string` | `'x64'` `'arm64'` `'x86'` `'arm'` `'wasm'`, … | `''` | parsed from UA string | CPU arch |
+| `locale` | `string` | BCP-47 tag, e.g. `'en-US'` | `''` | `navigator.language` | OS locale |
+| `isTouch` | `boolean` | touch-primary input | `false` | `navigator.maxTouchPoints > 0` | input enumeration |
+| `runtime` | `PlatformRuntime` | `'web'` `'electron'` `'tauri'` `'capacitor'` `'native'` `'unknown'` | `'unknown'` | probed from `window` globals | host shell identity |
+| `engine` | `PlatformEngine` | `'gecko'` `'blink'` `'webkit'` `'unknown'` | `'unknown'` | parsed from UA string | `'unknown'` (no browser engine) |
+| `engineVersion` | `string` | dotted engine version | `''` | parsed from UA string | `''` (no browser engine) |
+| `endianness` | `PlatformEndianness` | `'big'` `'little'` `'unknown'` | `'unknown'` | `ArrayBuffer` byte-order probe | CPU byte order |
+| `pointerWidth` | `32 \| 64 \| -1` | word width in bits | `-1` | inferred from `arch` | inferred from `arch` |
+| `osBuild` | `string` | OS build identifier | `''` | **native-reserved** — always `''` | OS build string |
+| `distro` | `string` | Linux distribution id, e.g. `'ubuntu'` | `''` | **native-reserved** — always `''` | `os-release` id |
+| `distroVersion` | `string` | Linux distribution version | `''` | **native-reserved** — always `''` | `os-release` version |
+
+`osBuild`, `distro`, and `distroVersion` exist in the shape so a native backend can fill them without a breaking type change. The web backend cannot honestly report them, so it returns `''`; they stay empty until a native host provides them. Treat `''` here as **native-reserved**, not an error.
+
+## Cross-package delegation
+
+`platform` reports only host **identity**. Richer or live concerns belong to their own cells; reach for these rather than expecting them on `PlatformInfo`:
+
+| Concern | Owner | Why not here |
+| --- | --- | --- |
+| Device model, manufacturer, memory, safe-area insets | `@flighthq/device` | Hardware/device identity is a distinct, larger snapshot. |
+| Battery, charging, low-power, keep-awake | `@flighthq/power` | Live, event-bearing state — not a static snapshot. |
+| Display enumeration, work area, scale factor | `@flighthq/screen` | Multi-display geometry is its own live surface. |
+| App name/version, quit/relaunch, single-instance lock | `@flighthq/app` | Application/process identity, not host identity. |
+
+The UA-string parsing primitives (`parseUserAgent*`, `probeEndianness`) live in `@flighthq/useragent`, the shared value-leaf both `platform` and `device` build their web backends on.
+
+## Usage
+
+```ts
+import { createPlatformInfo, getPlatformInfo, isPlatformVersionAtLeast } from '@flighthq/platform';
+
+const info = getPlatformInfo(createPlatformInfo());
+console.log(info.name, info.kind, info.arch, info.runtime);
+
+if (isPlatformVersionAtLeast('10.15')) {
+  // gate a feature on a minimum OS version
+}
+```

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

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

package/dist/index.js.map

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

package/dist/platform.d.ts

@@ -0,0 +1,18 @@
+import type { PlatformBackend, PlatformEngine, PlatformInfo, PlatformKind, PlatformName, PlatformRuntime } from '@flighthq/types';
+export declare function comparePlatformVersions(a: string, b: string): -1 | 0 | 1;
+export declare function createPlatformInfo(): PlatformInfo;
+export declare function createWebPlatformBackend(): PlatformBackend;
+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 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 setPlatformBackend(backend: PlatformBackend | null): void;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAgBzB,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;AAID,wBAAgB,kBAAkB,IAAI,eAAe,CAGpD;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;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;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAExE"}

package/dist/platform.js

@@ -0,0 +1,137 @@
+import { detectEndianness, parseUserAgentArch, parseUserAgentEngine, parseUserAgentEngineVersion, parseUserAgentKind, parseUserAgentName, parseUserAgentPointerWidth, parseUserAgentRuntime, parseUserAgentVersion, } from '@flighthq/useragent';
+// 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.
+export function comparePlatformVersions(a, b) {
+    if (a === b)
+        return 0;
+    const aParts = a === '' ? [] : a.split('.');
+    const bParts = b === '' ? [] : b.split('.');
+    const len = Math.max(aParts.length, bParts.length);
+    for (let i = 0; i < len; i++) {
+        const aNum = i < aParts.length ? parseInt(aParts[i], 10) : 0;
+        const bNum = i < bParts.length ? parseInt(bParts[i], 10) : 0;
+        const aN = isNaN(aNum) ? 0 : aNum;
+        const bN = isNaN(bNum) ? 0 : bNum;
+        if (aN < bN)
+            return -1;
+        if (aN > bN)
+            return 1;
+    }
+    return 0;
+}
+// Allocates a zeroed PlatformInfo; use as the `out` for getPlatformInfo or when building a backend.
+export function createPlatformInfo() {
+    return {
+        arch: '',
+        distro: '',
+        distroVersion: '',
+        endianness: 'unknown',
+        engine: 'unknown',
+        engineVersion: '',
+        isTouch: false,
+        kind: 'unknown',
+        locale: '',
+        name: 'unknown',
+        osBuild: '',
+        pointerWidth: -1,
+        runtime: 'unknown',
+        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 };
+}
+// The active platform backend, or the web default when no native host has registered one. Capability
+// packages call their own get*Backend; this is the root one for environment identification.
+export function getPlatformBackend() {
+    if (_backend === null)
+        _backend = createWebPlatformBackend();
+    return _backend;
+}
+// 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;
+}
+// Fills `out` with the running platform's identity and returns it. Cheap; reads the active backend.
+export function getPlatformInfo(out) {
+    return getPlatformBackend().getInfo(out);
+}
+// The platform family — 'desktop' | 'mobile' | 'web' | 'unknown'. Convenience over getPlatformInfo.
+export function getPlatformKind() {
+    return getPlatformInfo(_scratch).kind;
+}
+// The specific OS/runtime name — 'windows' | 'macos' | 'ios' | 'android' | 'linux' | 'web' | 'unknown'.
+export function getPlatformName() {
+    return getPlatformInfo(_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;
+}
+// True on a desktop host (Electron/Tauri/native window shell). False on mobile and plain web.
+export function isPlatformDesktop() {
+    return getPlatformKind() === 'desktop';
+}
+// True on a mobile host (iOS/Android via Capacitor or a native shell).
+export function isPlatformMobile() {
+    return getPlatformKind() === '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();
+    return runtime !== 'web' && runtime !== 'unknown';
+}
+// True on a touch-primary device, independent of desktop/mobile classification.
+export function isPlatformTouch() {
+    return getPlatformInfo(_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;
+    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';
+}
+// Installs a native host backend (Electron/Tauri/Capacitor/native). Pass null to fall back to web.
+// Opt-in and side-effect-free at import: nothing registers until a host calls this.
+export function setPlatformBackend(backend) {
+    _backend = backend;
+}
+let _backend = 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();
+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

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,4FAA4F;AAC5F,6FAA6F;AAC7F,gEAAgE;AAChE,MAAM,UAAU,uBAAuB,CAAC,CAAS,EAAE,CAAS;IAC1D,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClC,IAAI,EAAE,GAAG,EAAE;YAAE,OAAO,CAAC,CAAC,CAAC;QACvB,IAAI,EAAE,GAAG,EAAE;YAAE,OAAO,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,EAAE;QACR,MAAM,EAAE,EAAE;QACV,aAAa,EAAE,EAAE;QACjB,UAAU,EAAE,SAAS;QACrB,MAAM,EAAE,SAAS;QACjB,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,CAAC,CAAC;QAChB,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC;AAED,qGAAqG;AACrG,2FAA2F;AAC3F,MAAM,UAAU,wBAAwB;IACtC,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AACzC,CAAC;AAED,qGAAqG;AACrG,4FAA4F;AAC5F,MAAM,UAAU,kBAAkB;IAChC,IAAI,QAAQ,KAAK,IAAI;QAAE,QAAQ,GAAG,wBAAwB,EAAE,CAAC;IAC7D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,4FAA4F;AAC5F,iFAAiF;AACjF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;AAC1C,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,eAAe,CAAC,GAAiB;IAC/C,OAAO,kBAAkB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,eAAe;IAC7B,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,eAAe;IAC7B,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC;AAED,iGAAiG;AACjG,0FAA0F;AAC1F,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;AAC3C,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,EAAE,KAAK,SAAS,CAAC;AACzC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,eAAe,EAAE,KAAK,QAAQ,CAAC;AACxC,CAAC;AAED,kGAAkG;AAClG,oFAAoF;AACpF,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,OAAO,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,SAAS,CAAC;AACpD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe;IAC7B,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;AAC3C,CAAC;AAED,mGAAmG;AACnG,iGAAiG;AACjG,8CAA8C;AAC9C,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;IAClD,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAe,EAAE,KAAK,KAAK,CAAC;AACrC,CAAC;AAED,mGAAmG;AACnG,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAAC,OAA+B;IAChE,QAAQ,GAAG,OAAO,CAAC;AACrB,CAAC;AAED,IAAI,QAAQ,GAA2B,IAAI,CAAC;AAC5C,4FAA4F;AAC5F,oEAAoE;AACpE,MAAM,QAAQ,GAAiB,kBAAkB,EAAE,CAAC;AAEpD,SAAS,kBAAkB,CAAC,GAAiB;IAC3C,MAAM,GAAG,GAAG,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,MAAM,EAAE,GAAG,GAAG,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,GAAG,CAAC,IAAI,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,GAAG,CAAC,OAAO,GAAG,qBAAqB,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAClD,GAAG,CAAC,IAAI,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,QAAQ,IAAI,EAAE,CAAC;IACjC,GAAG,CAAC,OAAO;QACT,OAAO,SAAS,KAAK,WAAW,IAAI,gBAAgB,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3G,GAAG,CAAC,OAAO,GAAG,qBAAqB,CACjC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAE,MAA6C,CAAC,CAAC,CAAC,IAAI,CACtF,CAAC;IACF,GAAG,CAAC,MAAM,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;IACtC,GAAG,CAAC,aAAa,GAAG,2BAA2B,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChE,GAAG,CAAC,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACpC,GAAG,CAAC,YAAY,GAAG,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxD,yEAAyE;IACzE,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC;IACjB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAChB,GAAG,CAAC,aAAa,GAAG,EAAE,CAAC;IACvB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/platform",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/types": "0.1.0",
+    "@flighthq/useragent": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Platform identification seam for the desktop/mobile integration suite: OS/kind/arch detection with a swappable host backend",
+  "sideEffects": false
+}

package/src/platform.test.ts

@@ -0,0 +1,581 @@
+import type { PlatformBackend, PlatformInfo } from '@flighthq/types';
+
+import {
+  comparePlatformVersions,
+  createPlatformInfo,
+  createWebPlatformBackend,
+  getPlatformBackend,
+  getPlatformEngine,
+  getPlatformInfo,
+  getPlatformKind,
+  getPlatformName,
+  getPlatformRuntime,
+  isPlatformDesktop,
+  isPlatformMobile,
+  isPlatformNative,
+  isPlatformTouch,
+  isPlatformVersionAtLeast,
+  isPlatformWeb,
+  setPlatformBackend,
+} from './platform';
+
+function fakeBackend(info: Partial<PlatformInfo>): PlatformBackend {
+  return {
+    getInfo(out) {
+      Object.assign(out, createPlatformInfo(), info);
+      return out;
+    },
+  };
+}
+
+afterEach(() => setPlatformBackend(null));
+
+describe('comparePlatformVersions', () => {
+  it('returns 0 for identical strings', () => {
+    expect(comparePlatformVersions('10.15.7', '10.15.7')).toBe(0);
+  });
+
+  it('returns 0 for two empty strings', () => {
+    expect(comparePlatformVersions('', '')).toBe(0);
+  });
+
+  it('empty string sorts lower than any version', () => {
+    expect(comparePlatformVersions('', '1.0')).toBe(-1);
+    expect(comparePlatformVersions('1.0', '')).toBe(1);
+  });
+
+  it('returns -1 when a is lower', () => {
+    expect(comparePlatformVersions('10.15.6', '10.15.7')).toBe(-1);
+    expect(comparePlatformVersions('9', '10')).toBe(-1);
+    expect(comparePlatformVersions('10.0', '10.0.1')).toBe(-1);
+  });
+
+  it('returns 1 when a is higher', () => {
+    expect(comparePlatformVersions('10.15.7', '10.15.6')).toBe(1);
+    expect(comparePlatformVersions('11', '10')).toBe(1);
+    expect(comparePlatformVersions('14', '13.0.1')).toBe(1);
+  });
+
+  it('compares numeric segments, not lexicographic', () => {
+    expect(comparePlatformVersions('10', '9')).toBe(1);
+    expect(comparePlatformVersions('2.10', '2.9')).toBe(1);
+  });
+
+  it('treats missing trailing segments as 0', () => {
+    expect(comparePlatformVersions('10.0', '10.0.0')).toBe(0);
+    expect(comparePlatformVersions('10', '10.0.0')).toBe(0);
+  });
+});
+
+describe('createPlatformInfo', () => {
+  it('allocates a zeroed PlatformInfo with all new fields', () => {
+    expect(createPlatformInfo()).toEqual({
+      arch: '',
+      distro: '',
+      distroVersion: '',
+      endianness: 'unknown',
+      engine: 'unknown',
+      engineVersion: '',
+      isTouch: false,
+      kind: 'unknown',
+      locale: '',
+      name: 'unknown',
+      osBuild: '',
+      pointerWidth: -1,
+      runtime: 'unknown',
+      version: '',
+    });
+  });
+});
+
+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('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 gecko when set', () => {
+    setPlatformBackend(fakeBackend({ engine: 'gecko' }));
+    expect(getPlatformEngine()).toBe('gecko');
+  });
+
+  it('returns webkit when set', () => {
+    setPlatformBackend(fakeBackend({ engine: 'webkit' }));
+    expect(getPlatformEngine()).toBe('webkit');
+  });
+
+  it('returns unknown for native backends', () => {
+    setPlatformBackend(fakeBackend({ engine: 'unknown' }));
+    expect(getPlatformEngine()).toBe('unknown');
+  });
+});
+
+describe('getPlatformInfo', () => {
+  it('fills and returns the out parameter', () => {
+    setPlatformBackend(fakeBackend({ arch: 'arm64', kind: 'mobile', name: 'ios' }));
+    const out = createPlatformInfo();
+    expect(getPlatformInfo(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');
+  });
+});
+
+describe('getPlatformName', () => {
+  it('returns the active backend name', () => {
+    setPlatformBackend(fakeBackend({ name: 'macos' }));
+    expect(getPlatformName()).toBe('macos');
+  });
+});
+
+describe('getPlatformRuntime', () => {
+  it('returns web when no host shell is detected', () => {
+    setPlatformBackend(fakeBackend({ runtime: 'web' }));
+    expect(getPlatformRuntime()).toBe('web');
+  });
+
+  it('returns electron when set', () => {
+    setPlatformBackend(fakeBackend({ runtime: 'electron' }));
+    expect(getPlatformRuntime()).toBe('electron');
+  });
+
+  it('returns tauri when set', () => {
+    setPlatformBackend(fakeBackend({ runtime: 'tauri' }));
+    expect(getPlatformRuntime()).toBe('tauri');
+  });
+
+  it('returns capacitor when set', () => {
+    setPlatformBackend(fakeBackend({ runtime: 'capacitor' }));
+    expect(getPlatformRuntime()).toBe('capacitor');
+  });
+
+  it('returns native when set by a native backend', () => {
+    setPlatformBackend(fakeBackend({ runtime: 'native' }));
+    expect(getPlatformRuntime()).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);
+  });
+});
+
+describe('isPlatformMobile', () => {
+  it('is true only for mobile kind', () => {
+    setPlatformBackend(fakeBackend({ kind: 'mobile' }));
+    expect(isPlatformMobile()).toBe(true);
+  });
+});
+
+describe('isPlatformNative', () => {
+  it('is true for electron runtime', () => {
+    setPlatformBackend(fakeBackend({ runtime: 'electron' }));
+    expect(isPlatformNative()).toBe(true);
+  });
+
+  it('is true for tauri runtime', () => {
+    setPlatformBackend(fakeBackend({ runtime: 'tauri' }));
+    expect(isPlatformNative()).toBe(true);
+  });
+
+  it('is true for capacitor runtime', () => {
+    setPlatformBackend(fakeBackend({ runtime: 'capacitor' }));
+    expect(isPlatformNative()).toBe(true);
+  });
+
+  it('is true for native runtime', () => {
+    setPlatformBackend(fakeBackend({ runtime: 'native' }));
+    expect(isPlatformNative()).toBe(true);
+  });
+
+  it('is false for web runtime', () => {
+    setPlatformBackend(fakeBackend({ runtime: 'web' }));
+    expect(isPlatformNative()).toBe(false);
+  });
+
+  it('is false for unknown runtime', () => {
+    setPlatformBackend(fakeBackend({ runtime: 'unknown' }));
+    expect(isPlatformNative()).toBe(false);
+  });
+});
+
+describe('isPlatformTouch', () => {
+  it('reflects the backend isTouch flag', () => {
+    setPlatformBackend(fakeBackend({ isTouch: true }));
+    expect(isPlatformTouch()).toBe(true);
+  });
+});
+
+describe('isPlatformVersionAtLeast', () => {
+  it('is true when version equals minimum', () => {
+    setPlatformBackend(fakeBackend({ version: '14.0' }));
+    expect(isPlatformVersionAtLeast('14.0')).toBe(true);
+  });
+
+  it('is true when version exceeds minimum', () => {
+    setPlatformBackend(fakeBackend({ version: '15.0' }));
+    expect(isPlatformVersionAtLeast('14.0')).toBe(true);
+  });
+
+  it('is false when version is below minimum', () => {
+    setPlatformBackend(fakeBackend({ version: '13.0' }));
+    expect(isPlatformVersionAtLeast('14.0')).toBe(false);
+  });
+
+  it('is false when version is empty (unknown)', () => {
+    setPlatformBackend(fakeBackend({ version: '' }));
+    expect(isPlatformVersionAtLeast('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);
+  });
+});
+
+describe('isPlatformWeb', () => {
+  it('is true only for web kind', () => {
+    setPlatformBackend(fakeBackend({ kind: 'web' }));
+    expect(isPlatformWeb()).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',
+    ];
+
+    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');
+        });
+      });
+    }
+  });
+
+  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('');
+      });
+    });
+  });
+});