@realitycollective/service-framework-iwsdk 1.0.0

package/Examples/main.ts

@@ -0,0 +1,127 @@
+/**
+ * service-framework-iwsdk — minimal usage example
+ *
+ * Mirrors the three.js / Babylon.js examples, but for the Meta IWSDK frame
+ * source. IWSDK owns the render loop, so instead of a bridge that owns
+ * `setAnimationLoop` / `runRenderLoop`, the IWSDK shim is a *passive* frame
+ * source pumped from inside an IWSDK ECS system, and visibility is mapped to
+ * the manager's focus/pause signals (auto-pause when the headset comes off).
+ *
+ * The mocks below stand in for `@iwsdk/core` so this snippet runs in any
+ * Node.js environment. In a real IWSDK app you pass the real primitives:
+ *
+ *   import { World, createSystem, VisibilityState } from "@iwsdk/core";
+ *   const { manager, adapter } = startServiceRuntime(world, createEnergyProfile);
+ *   world.registerSystem(
+ *     makeServiceBridgeSystem({
+ *       adapter, manager, world, createSystem,
+ *       visibleState: VisibilityState.Visible,
+ *     }),
+ *   );
+ */
+
+import {
+  createServiceProfile,
+  createServiceToken,
+  type ServiceProfile,
+} from "@realitycollective/service-framework";
+import {
+  IWSDKAdapter,
+  SnapshotService,
+  makeServiceBridgeSystem,
+  startServiceRuntime,
+  type CreateSystemLike,
+  type IWSDKWorldLike,
+  type RuntimeAdapter,
+  type ServiceContext,
+  type Unsubscribe,
+} from "@realitycollective/service-framework-iwsdk";
+
+// ---------------------------------------------------------------------------
+// A leaf service that owns its state and decays energy once per frame.
+// It depends only on RuntimeAdapter — never on @iwsdk/core — so it is portable
+// and unit-testable headless against MockRuntimeAdapter.
+// ---------------------------------------------------------------------------
+
+interface EnergySnapshot {
+  readonly energy: number;
+}
+
+const ENERGY_SERVICE_TOKEN = createServiceToken<EnergyService>("EnergyService");
+
+class EnergyService extends SnapshotService<unknown, EnergySnapshot> {
+  private unsubscribe?: Unsubscribe;
+
+  public constructor(
+    context: ServiceContext,
+    private readonly adapter: RuntimeAdapter,
+  ) {
+    super(context, { energy: 1 });
+  }
+
+  public override initialize(): void {
+    this.unsubscribe = this.adapter.onFrame(({ delta }) => {
+      const energy = Math.max(0, this.getSnapshot().energy - delta * 0.1);
+      this.updateSnapshot({ energy });
+    });
+  }
+
+  public override destroy(): void {
+    this.unsubscribe?.();
+  }
+}
+
+function createEnergyProfile(adapter: IWSDKAdapter): ServiceProfile {
+  return createServiceProfile("iwsdk-example", [
+    {
+      token: ENERGY_SERVICE_TOKEN,
+      useFactory: (context) => new EnergyService(context, adapter),
+    },
+  ]);
+}
+
+// ---------------------------------------------------------------------------
+// Mock @iwsdk/core primitives — swap for the real ones in an IWSDK app.
+// ---------------------------------------------------------------------------
+
+const VISIBLE: string = "visible";
+const HIDDEN: string = "hidden";
+
+const world: IWSDKWorldLike<string> = { visibilityState: { value: VISIBLE } };
+
+const createSystem: CreateSystemLike = () =>
+  class {
+    public update(_delta: number, _time: number): void {}
+  };
+
+// ---------------------------------------------------------------------------
+// Bootstrap: stand up the manager + adapter, then wire the bridge system.
+// ---------------------------------------------------------------------------
+
+const { manager, adapter } = startServiceRuntime(world, createEnergyProfile);
+
+const ServiceBridgeSystem = makeServiceBridgeSystem({
+  adapter,
+  manager,
+  world,
+  createSystem,
+  visibleState: VISIBLE,
+});
+
+// In a real app: world.registerSystem(ServiceBridgeSystem). Here we construct
+// it directly and pump a few frames to simulate IWSDK's loop.
+const bridge = new ServiceBridgeSystem();
+
+const energyService = manager.resolve(ENERGY_SERVICE_TOKEN);
+energyService.subscribe((snapshot) => console.log(`energy: ${snapshot.energy.toFixed(3)}`));
+
+for (let frame = 1; frame <= 3; frame++) {
+  bridge.update(1 / 60, (frame * 1000) / 60);
+}
+
+// Headset removed → the bridge stops pumping frames and the manager auto-pauses,
+// so energy stops decaying.
+(world as IWSDKWorldLike<string> & { visibilityState: { value: string } }).visibilityState.value = HIDDEN;
+bridge.update(1 / 60, (4 * 1000) / 60);
+
+console.log("Energy decays only while the session is visible.");

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reality Collective
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,171 @@
+# `@realitycollective/service-framework-iwsdk`
+
+Meta **IWSDK** (WebXR) frame-source bindings for the [Reality Collective TypeScript Service Framework](https://github.com/realitycollective/com.realitycollective.service-framework.ts).
+
+Lets `@realitycollective/service-framework` services run inside the [IWSDK](https://github.com/meta-quest/immersive-web-sdk) engine loop without each project re-implementing the bridge layer. Services written against `BaseService<TConfig>` run unchanged here, on three.js, or on Babylon.js.
+
+---
+
+## How it differs from the render-loop bridges
+
+`service-framework-three` and `service-framework-babylon` **own** the loop — the bridge calls `renderer.setAnimationLoop(...)` / `engine.runRenderLoop(...)`. **IWSDK already owns the loop**, the XR session, input and the ECS, so this shim must *not* own one.
+
+Instead it is a **passive frame source**: a single IWSDK ECS system (`ServiceBridgeSystem`) is pumped one frame at a time by the engine, fans those frames out to subscribed services via `IWSDKAdapter`, and maps IWSDK's `visibilityState` to the manager's focus/pause signals (auto-pause when the headset comes off).
+
+```
+IWSDK World  (render loop, XR session, input, ECS)
+   │  world.registerSystem(makeServiceBridgeSystem({ ... }))
+   ▼
+ServiceBridgeSystem        ← the only place the engine touches services
+   every update(delta, time):
+     • visibilityState → manager.emitFocusChange / emitPauseChange
+     • if focused: adapter.emitFrame(time, delta)
+   ▼
+IWSDKAdapter (RuntimeAdapter)  →  onFrame fan-out  →  services
+   ▼
+ServiceManager  →  your SnapshotService graph
+```
+
+**Invariant:** services depend only on `RuntimeAdapter`, never on `@iwsdk/core`. That is what keeps them unit-testable headless — swap `IWSDKAdapter` for `MockRuntimeAdapter`.
+
+---
+
+## No hard dependency on `@iwsdk/core`
+
+Like the three.js and Babylon.js bridges keep their renderer packages at arm's length, this package **never imports `@iwsdk/core`**. The IWSDK primitives the bridge needs — `createSystem` and the `VisibilityState.Visible` value — are passed in by the consumer (who owns IWSDK). This keeps the package tree-shakeable, version-tolerant across IWSDK `0.4.x`, and trivially mockable in unit tests.
+
+`@iwsdk/core` is declared as an **optional peer dependency**.
+
+---
+
+## Quick start
+
+```typescript
+import { createServiceProfile } from "@realitycollective/service-framework";
+import {
+  startServiceRuntime,
+  makeServiceBridgeSystem,
+} from "@realitycollective/service-framework-iwsdk";
+import { World, createSystem, VisibilityState } from "@iwsdk/core";
+
+// 1. Build the service graph from a profile factory: (adapter) => ServiceProfile
+const createProfile = (adapter) =>
+  createServiceProfile("my-app", [/* your registrations, wired to `adapter` */]);
+
+// 2. Stand up the manager + adapter and start it.
+const { manager, adapter } = startServiceRuntime(world, createProfile);
+
+// 3. Register the one ECS system that pumps frames and maps visibility.
+world.registerSystem(
+  makeServiceBridgeSystem({
+    adapter,
+    manager,
+    world,
+    createSystem,
+    visibleState: VisibilityState.Visible,
+  }),
+);
+```
+
+Game logic ticks **only while the session is visible/focused** — in the browser / 2D preview the host app shows its own "Enter VR" gate and services stay idle until the player enters VR.
+
+---
+
+## Services own their state: `SnapshotService`
+
+`SnapshotService<TConfig, TSnapshot>` is the "services own state" base — one immutable snapshot plus pub/sub. Subscribers receive the current value immediately, then every publish. It has **no IWSDK dependency**.
+
+```typescript
+import { SnapshotService, type ServiceContext, type RuntimeAdapter } from "@realitycollective/service-framework-iwsdk";
+
+interface EnergySnapshot { readonly energy: number; }
+
+class EnergyService extends SnapshotService<unknown, EnergySnapshot> {
+  constructor(context: ServiceContext, private readonly adapter: RuntimeAdapter) {
+    super(context, { energy: 1 });
+  }
+
+  override initialize(): void {
+    this.adapter.onFrame(({ delta }) => {
+      this.updateSnapshot({ energy: Math.max(0, this.getSnapshot().energy - delta * 0.1) });
+    });
+  }
+}
+```
+
+The presentation layer (or another service) subscribes:
+
+```typescript
+const energy = manager.resolve(ENERGY_SERVICE_TOKEN);
+const unsubscribe = energy.subscribe(({ energy }) => hud.setEnergy(energy));
+```
+
+---
+
+## Headless testing with `MockRuntimeAdapter`
+
+Services run against `MockRuntimeAdapter` with no IWSDK / renderer / headset. Tests drive the loop by calling `emitFrame`:
+
+```typescript
+import { MockRuntimeAdapter } from "@realitycollective/service-framework-iwsdk";
+
+const adapter = new MockRuntimeAdapter({ immersive: true });
+const service = new EnergyService(makeContext(), adapter);
+service.initialize();
+
+adapter.emitFrame(0, 1 / 72);   // one frame
+expect(service.getSnapshot().energy).toBeLessThan(1);
+```
+
+No `@iwsdk/core` import appears anywhere in the test.
+
+---
+
+## Capabilities
+
+`AdapterCapabilities` (`immersive`, `handTracking`, `planeDetection`, `passthrough`) is what gating services read (`adapter.getCapabilities()`) or subscribe to (`adapter.onCapabilitiesChange(cb)` — mirrors `onFrame`, so gates don't poll every frame). Refine them with `adapter.setCapabilities({ ... })`.
+
+> **One gap still to close:** deriving capabilities from the live `XRSession` (enabled features, blend mode, hand input sources) is intentionally left to the host wiring because it needs IWSDK session internals. Until that is wired, the adapter reports `DEFAULT_CAPABILITIES` (all-false) and gating services behave conservatively. `IWSDKAdapter.getWorld()` exposes the bound world as the source for that derivation, and `onCapabilitiesChange` is the notification channel for when it lands.
+
+---
+
+## API surface
+
+| Symbol | Kind | Purpose |
+| --- | --- | --- |
+| `RuntimeAdapter` | interface | The seam services depend on (`onFrame`, `getCapabilities`, `onCapabilitiesChange`). |
+| `FrameInfo` | interface | `{ timestamp, delta }`. |
+| `AdapterCapabilities` / `DEFAULT_CAPABILITIES` | interface / const | XR capability flags; all-false default. |
+| `Unsubscribe` / `FrameListener` / `CapabilitiesListener` | types | Callback / handle aliases. |
+| `IWSDKAdapter` | class | Production adapter; `emitFrame`, `setCapabilities`, `getWorld`. |
+| `MockRuntimeAdapter` | class | Headless adapter; `emitFrame(ts?, delta?)`, `setCapabilities`. |
+| `SnapshotService<C, S>` | abstract class | State-owning base (`subscribe` / `getSnapshot` / `publishSnapshot` / `updateSnapshot`). |
+| `ServiceContext<C>` / `SnapshotListener<S>` | types | Activation-context alias; snapshot callback. |
+| `makeServiceBridgeSystem` | factory | Returns the IWSDK `ServiceBridgeSystem` class. |
+| `ServiceBridgeSystemOptions` | interface | `{ adapter, manager, world, createSystem, visibleState }`. |
+| `startServiceRuntime` / `ServiceRuntime` | function / interface | Bootstraps `{ manager, adapter }` from a profile factory. |
+| `IWSDKWorldLike` / `CreateSystemLike` / … | types | Structural `@iwsdk/core` contracts (no engine import). |
+
+---
+
+## Running tests
+
+From the workspace root:
+
+```bash
+npm test
+```
+
+## Running the example
+
+```bash
+npx tsx packages/service-framework-iwsdk/Examples/main.ts
+```
+
+The example mocks the `@iwsdk/core` primitives so it runs in plain Node.js: it decays an `EnergyService` while the session is "visible", then shows it idling once visibility is lost.
+
+---
+
+## License
+
+MIT

package/dist/bootstrap.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Non-React bootstrap for an IWSDK client: build the adapter, stand up the
+ * ServiceManager from the app's profile, and start it. The caller registers
+ * {@link makeServiceBridgeSystem} with the IWSDK world to pump per-frame ticks.
+ */
+import { ServiceManager } from "@realitycollective/service-framework";
+import type { ServiceProfile } from "@realitycollective/service-framework";
+import { IWSDKAdapter } from "./iwsdk-adapter.js";
+import type { IWSDKWorldLike } from "./iwsdk-host.js";
+export interface ServiceRuntime {
+    readonly manager: ServiceManager;
+    readonly adapter: IWSDKAdapter;
+}
+/**
+ * @param world           the IWSDK world (owns the loop / XR session).
+ * @param profileFactory  builds the app service graph from the adapter, e.g.
+ *                        `(adapter) => createServiceProfile("my-app", [...])`.
+ */
+export declare function startServiceRuntime(world: IWSDKWorldLike, profileFactory: (adapter: IWSDKAdapter) => ServiceProfile): ServiceRuntime;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,cAAc,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,cAAc,GACxD,cAAc,CAMhB"}

package/dist/bootstrap.js

@@ -0,0 +1,20 @@
+/**
+ * Non-React bootstrap for an IWSDK client: build the adapter, stand up the
+ * ServiceManager from the app's profile, and start it. The caller registers
+ * {@link makeServiceBridgeSystem} with the IWSDK world to pump per-frame ticks.
+ */
+import { ServiceManager } from "@realitycollective/service-framework";
+import { IWSDKAdapter } from "./iwsdk-adapter.js";
+/**
+ * @param world           the IWSDK world (owns the loop / XR session).
+ * @param profileFactory  builds the app service graph from the adapter, e.g.
+ *                        `(adapter) => createServiceProfile("my-app", [...])`.
+ */
+export function startServiceRuntime(world, profileFactory) {
+    const adapter = new IWSDKAdapter(world);
+    const manager = new ServiceManager();
+    manager.initializeProfile(profileFactory(adapter));
+    manager.start();
+    return { manager, adapter };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAqB,EACrB,cAAyD;IAEzD,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IACrC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { DEFAULT_CAPABILITIES } from "./runtime-adapter.js";
+export type { AdapterCapabilities, CapabilitiesListener, FrameInfo, FrameListener, RuntimeAdapter, Unsubscribe, } from "./runtime-adapter.js";
+export type { CreateSystemLike, IWSDKSignalLike, IWSDKSystemConstructor, IWSDKSystemLike, IWSDKWorldLike, } from "./iwsdk-host.js";
+export { IWSDKAdapter } from "./iwsdk-adapter.js";
+export { MockRuntimeAdapter } from "./mock-runtime-adapter.js";
+export { SnapshotService } from "./snapshot-service.js";
+export type { ServiceContext, SnapshotListener } from "./snapshot-service.js";
+export { makeServiceBridgeSystem } from "./service-bridge-system.js";
+export type { ServiceBridgeSystemOptions } from "./service-bridge-system.js";
+export { startServiceRuntime } from "./bootstrap.js";
+export type { ServiceRuntime } from "./bootstrap.js";
+//# 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,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,EACT,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAE7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { DEFAULT_CAPABILITIES } from "./runtime-adapter.js";
+export { IWSDKAdapter } from "./iwsdk-adapter.js";
+export { MockRuntimeAdapter } from "./mock-runtime-adapter.js";
+export { SnapshotService } from "./snapshot-service.js";
+export { makeServiceBridgeSystem } from "./service-bridge-system.js";
+export { startServiceRuntime } from "./bootstrap.js";
+//# 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,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAkB5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/iwsdk-adapter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * IWSDK implementation of {@link RuntimeAdapter}. IWSDK owns the render loop, so
+ * the adapter is a passive fan-out: the `ServiceBridgeSystem` (a normal IWSDK
+ * system) calls {@link IWSDKAdapter.emitFrame} once per frame and the adapter
+ * notifies subscribed services. Capabilities are refined from the XR session via
+ * {@link IWSDKAdapter.setCapabilities}.
+ */
+import { type AdapterCapabilities, type CapabilitiesListener, type FrameListener, type RuntimeAdapter, type Unsubscribe } from "./runtime-adapter.js";
+import type { IWSDKWorldLike } from "./iwsdk-host.js";
+export declare class IWSDKAdapter implements RuntimeAdapter {
+    private readonly world;
+    private readonly frameListeners;
+    private readonly capabilitiesListeners;
+    private capabilities;
+    constructor(world: IWSDKWorldLike);
+    onFrame(listener: FrameListener): Unsubscribe;
+    getCapabilities(): AdapterCapabilities;
+    onCapabilitiesChange(listener: CapabilitiesListener): Unsubscribe;
+    /**
+     * The IWSDK `World` this adapter is bound to. Reserved for capability
+     * derivation from the live XR session (see the package README "Capabilities"
+     * section) — the one piece still to be wired to the real IWSDK session API.
+     */
+    getWorld(): IWSDKWorldLike;
+    /** Refine capabilities once the XR session reports them; notifies subscribers. */
+    setCapabilities(capabilities: Partial<AdapterCapabilities>): void;
+    /** Called once per frame by the ECS bridge system. */
+    emitFrame(timestamp: number, delta: number): void;
+}
+//# sourceMappingURL=iwsdk-adapter.d.ts.map

package/dist/iwsdk-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iwsdk-adapter.d.ts","sourceRoot":"","sources":["../src/iwsdk-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAEzB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,qBAAa,YAAa,YAAW,cAAc;IAK9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAmC;IACzE,OAAO,CAAC,YAAY,CAA6C;gBAE7B,KAAK,EAAE,cAAc;IAElD,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,WAAW;IAO7C,eAAe,IAAI,mBAAmB;IAItC,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,WAAW;IAOxE;;;;OAIG;IACI,QAAQ,IAAI,cAAc;IAIjC,kFAAkF;IAC3E,eAAe,CAAC,YAAY,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAKxE,sDAAsD;IAC/C,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAIzD"}

package/dist/iwsdk-adapter.js

@@ -0,0 +1,51 @@
+/**
+ * IWSDK implementation of {@link RuntimeAdapter}. IWSDK owns the render loop, so
+ * the adapter is a passive fan-out: the `ServiceBridgeSystem` (a normal IWSDK
+ * system) calls {@link IWSDKAdapter.emitFrame} once per frame and the adapter
+ * notifies subscribed services. Capabilities are refined from the XR session via
+ * {@link IWSDKAdapter.setCapabilities}.
+ */
+import { DEFAULT_CAPABILITIES, } from "./runtime-adapter.js";
+export class IWSDKAdapter {
+    world;
+    frameListeners = new Set();
+    capabilitiesListeners = new Set();
+    capabilities = DEFAULT_CAPABILITIES;
+    constructor(world) {
+        this.world = world;
+    }
+    onFrame(listener) {
+        this.frameListeners.add(listener);
+        return () => {
+            this.frameListeners.delete(listener);
+        };
+    }
+    getCapabilities() {
+        return this.capabilities;
+    }
+    onCapabilitiesChange(listener) {
+        this.capabilitiesListeners.add(listener);
+        return () => {
+            this.capabilitiesListeners.delete(listener);
+        };
+    }
+    /**
+     * The IWSDK `World` this adapter is bound to. Reserved for capability
+     * derivation from the live XR session (see the package README "Capabilities"
+     * section) — the one piece still to be wired to the real IWSDK session API.
+     */
+    getWorld() {
+        return this.world;
+    }
+    /** Refine capabilities once the XR session reports them; notifies subscribers. */
+    setCapabilities(capabilities) {
+        this.capabilities = { ...this.capabilities, ...capabilities };
+        this.capabilitiesListeners.forEach((listener) => listener(this.capabilities));
+    }
+    /** Called once per frame by the ECS bridge system. */
+    emitFrame(timestamp, delta) {
+        const frame = { timestamp, delta };
+        this.frameListeners.forEach((listener) => listener(frame));
+    }
+}
+//# sourceMappingURL=iwsdk-adapter.js.map

package/dist/iwsdk-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iwsdk-adapter.js","sourceRoot":"","sources":["../src/iwsdk-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,oBAAoB,GAOrB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,OAAO,YAAY;IAKa;IAJnB,cAAc,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC1C,qBAAqB,GAAG,IAAI,GAAG,EAAwB,CAAC;IACjE,YAAY,GAAwB,oBAAoB,CAAC;IAEjE,YAAoC,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAEtD,OAAO,CAAC,QAAuB;QACpC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC;IACJ,CAAC;IAEM,eAAe;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEM,oBAAoB,CAAC,QAA8B;QACxD,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,kFAAkF;IAC3E,eAAe,CAAC,YAA0C;QAC/D,IAAI,CAAC,YAAY,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,YAAY,EAAE,CAAC;QAC9D,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,sDAAsD;IAC/C,SAAS,CAAC,SAAiB,EAAE,KAAa;QAC/C,MAAM,KAAK,GAAc,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC9C,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/iwsdk-host.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Structural contracts for the slice of `@iwsdk/core` this shim touches.
+ *
+ * Mirrors the approach the three.js and Babylon.js bridges take with their
+ * engine packages: the shim never imports `@iwsdk/core` directly, so it builds
+ * and unit-tests with no IWSDK / WebXR / headset present, and any 0.4.x IWSDK
+ * works without bumping this package. Consumers pass the real `World`,
+ * `createSystem` and `VisibilityState.Visible` value through
+ * {@link makeServiceBridgeSystem}.
+ */
+/** IWSDK exposes reactive values as `{ value }` signals; the bridge only reads `.value`. */
+export interface IWSDKSignalLike<TValue> {
+    readonly value: TValue;
+}
+/** The slice of an IWSDK `World` the bridge reads: the visibility signal. */
+export interface IWSDKWorldLike<TVisibility = unknown> {
+    readonly visibilityState: IWSDKSignalLike<TVisibility>;
+}
+/** The per-frame entry point IWSDK invokes on a registered system. */
+export interface IWSDKSystemLike {
+    update(delta: number, time: number): void;
+}
+/** Constructor shape of the base class IWSDK's `createSystem` returns. */
+export type IWSDKSystemConstructor = new (...args: unknown[]) => IWSDKSystemLike;
+/**
+ * Structural shape of IWSDK's `createSystem` factory. `createSystem(schema)`
+ * returns a base system class that the bridge extends; the bridge passes an
+ * empty schema because it queries no ECS components.
+ */
+export type CreateSystemLike = (schema?: Record<string, unknown>) => IWSDKSystemConstructor;
+//# sourceMappingURL=iwsdk-host.d.ts.map

package/dist/iwsdk-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iwsdk-host.d.ts","sourceRoot":"","sources":["../src/iwsdk-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,4FAA4F;AAC5F,MAAM,WAAW,eAAe,CAAC,MAAM;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc,CAAC,WAAW,GAAG,OAAO;IACnD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;CACxD;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,0EAA0E;AAC1E,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,eAAe,CAAC;AAEjF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,sBAAsB,CAAC"}

package/dist/iwsdk-host.js

@@ -0,0 +1,12 @@
+/**
+ * Structural contracts for the slice of `@iwsdk/core` this shim touches.
+ *
+ * Mirrors the approach the three.js and Babylon.js bridges take with their
+ * engine packages: the shim never imports `@iwsdk/core` directly, so it builds
+ * and unit-tests with no IWSDK / WebXR / headset present, and any 0.4.x IWSDK
+ * works without bumping this package. Consumers pass the real `World`,
+ * `createSystem` and `VisibilityState.Visible` value through
+ * {@link makeServiceBridgeSystem}.
+ */
+export {};
+//# sourceMappingURL=iwsdk-host.js.map

package/dist/iwsdk-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iwsdk-host.js","sourceRoot":"","sources":["../src/iwsdk-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/mock-runtime-adapter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Headless {@link RuntimeAdapter} for tests. Services run against this with no
+ * IWSDK / renderer / headset; tests drive the loop by calling
+ * {@link MockRuntimeAdapter.emitFrame} and refine gating with
+ * {@link MockRuntimeAdapter.setCapabilities}.
+ */
+import { type AdapterCapabilities, type CapabilitiesListener, type FrameListener, type RuntimeAdapter, type Unsubscribe } from "./runtime-adapter.js";
+export declare class MockRuntimeAdapter implements RuntimeAdapter {
+    private readonly frameListeners;
+    private readonly capabilitiesListeners;
+    private capabilities;
+    constructor(capabilities?: Partial<AdapterCapabilities>);
+    onFrame(listener: FrameListener): Unsubscribe;
+    getCapabilities(): AdapterCapabilities;
+    onCapabilitiesChange(listener: CapabilitiesListener): Unsubscribe;
+    /** Refine capabilities in tests; notifies subscribers. */
+    setCapabilities(capabilities: Partial<AdapterCapabilities>): void;
+    /** Drive a frame in tests. */
+    emitFrame(timestamp?: number, delta?: number): void;
+}
+//# sourceMappingURL=mock-runtime-adapter.d.ts.map

package/dist/mock-runtime-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-runtime-adapter.d.ts","sourceRoot":"","sources":["../src/mock-runtime-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAmC;IACzE,OAAO,CAAC,YAAY,CAAsB;gBAEvB,YAAY,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAI3D,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,WAAW;IAO7C,eAAe,IAAI,mBAAmB;IAItC,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,WAAW;IAOxE,0DAA0D;IACnD,eAAe,CAAC,YAAY,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAKxE,8BAA8B;IACvB,SAAS,CAAC,SAAS,SAAI,EAAE,KAAK,SAAS,GAAG,IAAI;CAGtD"}

package/dist/mock-runtime-adapter.js

@@ -0,0 +1,40 @@
+/**
+ * Headless {@link RuntimeAdapter} for tests. Services run against this with no
+ * IWSDK / renderer / headset; tests drive the loop by calling
+ * {@link MockRuntimeAdapter.emitFrame} and refine gating with
+ * {@link MockRuntimeAdapter.setCapabilities}.
+ */
+import { DEFAULT_CAPABILITIES, } from "./runtime-adapter.js";
+export class MockRuntimeAdapter {
+    frameListeners = new Set();
+    capabilitiesListeners = new Set();
+    capabilities;
+    constructor(capabilities = {}) {
+        this.capabilities = { ...DEFAULT_CAPABILITIES, ...capabilities };
+    }
+    onFrame(listener) {
+        this.frameListeners.add(listener);
+        return () => {
+            this.frameListeners.delete(listener);
+        };
+    }
+    getCapabilities() {
+        return this.capabilities;
+    }
+    onCapabilitiesChange(listener) {
+        this.capabilitiesListeners.add(listener);
+        return () => {
+            this.capabilitiesListeners.delete(listener);
+        };
+    }
+    /** Refine capabilities in tests; notifies subscribers. */
+    setCapabilities(capabilities) {
+        this.capabilities = { ...this.capabilities, ...capabilities };
+        this.capabilitiesListeners.forEach((listener) => listener(this.capabilities));
+    }
+    /** Drive a frame in tests. */
+    emitFrame(timestamp = 0, delta = 1 / 72) {
+        this.frameListeners.forEach((listener) => listener({ timestamp, delta }));
+    }
+}
+//# sourceMappingURL=mock-runtime-adapter.js.map

package/dist/mock-runtime-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-runtime-adapter.js","sourceRoot":"","sources":["../src/mock-runtime-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,oBAAoB,GAMrB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,OAAO,kBAAkB;IACZ,cAAc,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC1C,qBAAqB,GAAG,IAAI,GAAG,EAAwB,CAAC;IACjE,YAAY,CAAsB;IAE1C,YAAmB,eAA6C,EAAE;QAChE,IAAI,CAAC,YAAY,GAAG,EAAE,GAAG,oBAAoB,EAAE,GAAG,YAAY,EAAE,CAAC;IACnE,CAAC;IAEM,OAAO,CAAC,QAAuB;QACpC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC;IACJ,CAAC;IAEM,eAAe;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEM,oBAAoB,CAAC,QAA8B;QACxD,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC;IACJ,CAAC;IAED,0DAA0D;IACnD,eAAe,CAAC,YAA0C;QAC/D,IAAI,CAAC,YAAY,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,YAAY,EAAE,CAAC;QAC9D,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,8BAA8B;IACvB,SAAS,CAAC,SAAS,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,EAAE;QAC5C,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/runtime-adapter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Runtime adapter contract (IWSDK-only, minimal frame-source).
+ *
+ * Trimmed to what an IWSDK-only client needs: a per-frame fan-out and
+ * capability flags. IWSDK already owns sessions, input and rendering, so the
+ * adapter deliberately does NOT re-abstract those. {@link MockRuntimeAdapter}
+ * implements this same interface so services can be unit-tested headless.
+ */
+export type Unsubscribe = () => void;
+export interface FrameInfo {
+    /** Frame timestamp in milliseconds (IWSDK system `time`). */
+    readonly timestamp: number;
+    /** Seconds elapsed since the previous frame (IWSDK system `delta`). */
+    readonly delta: number;
+}
+/** XR capabilities services gate on (e.g. passthrough requires `immersive`). */
+export interface AdapterCapabilities {
+    readonly immersive: boolean;
+    readonly handTracking: boolean;
+    readonly planeDetection: boolean;
+    readonly passthrough: boolean;
+}
+export declare const DEFAULT_CAPABILITIES: AdapterCapabilities;
+export type FrameListener = (frame: FrameInfo) => void;
+export type CapabilitiesListener = (capabilities: AdapterCapabilities) => void;
+export interface RuntimeAdapter {
+    /** Subscribe to per-frame updates; returns an unsubscribe handle. */
+    onFrame(listener: FrameListener): Unsubscribe;
+    /** Current XR capabilities (may change once a session is established). */
+    getCapabilities(): AdapterCapabilities;
+    /**
+     * Subscribe to capability changes; returns an unsubscribe handle. Mirrors
+     * {@link RuntimeAdapter.onFrame} so gating services can react to a session
+     * coming online instead of polling {@link RuntimeAdapter.getCapabilities}
+     * every frame.
+     */
+    onCapabilitiesChange(listener: CapabilitiesListener): Unsubscribe;
+}
+//# sourceMappingURL=runtime-adapter.d.ts.map

package/dist/runtime-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-adapter.d.ts","sourceRoot":"","sources":["../src/runtime-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,MAAM,WAAW,SAAS;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,oBAAoB,EAAE,mBAKlC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AACvD,MAAM,MAAM,oBAAoB,GAAG,CAAC,YAAY,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAE/E,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,WAAW,CAAC;IAC9C,0EAA0E;IAC1E,eAAe,IAAI,mBAAmB,CAAC;IACvC;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,WAAW,CAAC;CACnE"}

package/dist/runtime-adapter.js

@@ -0,0 +1,15 @@
+/**
+ * Runtime adapter contract (IWSDK-only, minimal frame-source).
+ *
+ * Trimmed to what an IWSDK-only client needs: a per-frame fan-out and
+ * capability flags. IWSDK already owns sessions, input and rendering, so the
+ * adapter deliberately does NOT re-abstract those. {@link MockRuntimeAdapter}
+ * implements this same interface so services can be unit-tested headless.
+ */
+export const DEFAULT_CAPABILITIES = {
+    immersive: false,
+    handTracking: false,
+    planeDetection: false,
+    passthrough: false,
+};
+//# sourceMappingURL=runtime-adapter.js.map

package/dist/runtime-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-adapter.js","sourceRoot":"","sources":["../src/runtime-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH,MAAM,CAAC,MAAM,oBAAoB,GAAwB;IACvD,SAAS,EAAE,KAAK;IAChB,YAAY,EAAE,KAAK;IACnB,cAAc,EAAE,KAAK;IACrB,WAAW,EAAE,KAAK;CACnB,CAAC"}

package/dist/service-bridge-system.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The single ECS-services bridge. A normal IWSDK system that, each frame:
+ *   - maps IWSDK `visibilityState` to manager focus/pause (auto-pause when the
+ *     headset is removed), and
+ *   - drives the adapter's per-frame fan-out via {@link IWSDKAdapter.emitFrame}.
+ *
+ * Game logic is only ticked while the session is visible/focused: in the
+ * browser / 2D preview the host app shows its own gate (e.g. an "Enter VR"
+ * overlay) and the services stay idle until the player enters VR.
+ *
+ * This is the only place the engine loop touches the service layer; services
+ * themselves never see IWSDK. The IWSDK primitives (`createSystem` and the
+ * `VisibilityState.Visible` value) are injected so this package never imports
+ * `@iwsdk/core` — mirroring how the three.js / Babylon.js bridges keep their
+ * engine packages at arm's length.
+ */
+import type { ServiceManager } from "@realitycollective/service-framework";
+import type { IWSDKAdapter } from "./iwsdk-adapter.js";
+import type { CreateSystemLike, IWSDKWorldLike } from "./iwsdk-host.js";
+export interface ServiceBridgeSystemOptions<TVisibility = unknown> {
+    /** The passive frame source fanned out to services. */
+    readonly adapter: IWSDKAdapter;
+    /** The service manager whose focus/pause signals are driven by visibility. */
+    readonly manager: ServiceManager;
+    /** The IWSDK world whose `visibilityState` is read each frame. */
+    readonly world: IWSDKWorldLike<TVisibility>;
+    /** IWSDK's `createSystem` factory (from `@iwsdk/core`). */
+    readonly createSystem: CreateSystemLike;
+    /**
+     * The `VisibilityState` value that means the session is visible/focused
+     * (IWSDK `VisibilityState.Visible`). The bridge ticks services only while
+     * `world.visibilityState.value === visibleState`.
+     */
+    readonly visibleState: TVisibility;
+}
+/**
+ * Builds the IWSDK `ServiceBridgeSystem` class. Register the returned class with
+ * the world (`world.registerSystem(makeServiceBridgeSystem({ ... }))`); IWSDK
+ * then calls its `update(delta, time)` once per frame.
+ */
+export declare function makeServiceBridgeSystem<TVisibility>(options: ServiceBridgeSystemOptions<TVisibility>): {
+    new (...args: unknown[]): {
+        update(delta: number, time: number): void;
+    };
+};
+//# sourceMappingURL=service-bridge-system.d.ts.map

package/dist/service-bridge-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-bridge-system.d.ts","sourceRoot":"","sources":["../src/service-bridge-system.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAExE,MAAM,WAAW,0BAA0B,CAAC,WAAW,GAAG,OAAO;IAC/D,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IAC5C,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EACjD,OAAO,EAAE,0BAA0B,CAAC,WAAW,CAAC;;sBAMhB,MAAM,QAAQ,MAAM,GAAG,IAAI;;EAgB5D"}

package/dist/service-bridge-system.js

@@ -0,0 +1,25 @@
+/**
+ * Builds the IWSDK `ServiceBridgeSystem` class. Register the returned class with
+ * the world (`world.registerSystem(makeServiceBridgeSystem({ ... }))`); IWSDK
+ * then calls its `update(delta, time)` once per frame.
+ */
+export function makeServiceBridgeSystem(options) {
+    const { adapter, manager, world, createSystem, visibleState } = options;
+    let lastFocused;
+    return class ServiceBridgeSystem extends createSystem({}) {
+        update(delta, time) {
+            const focused = world.visibilityState.value === visibleState;
+            if (focused !== lastFocused) {
+                lastFocused = focused;
+                manager.emitFocusChange(focused);
+                manager.emitPauseChange({ paused: !focused });
+            }
+            // Only run game logic while visible/focused; idle in the 2D/browser
+            // preview and while the headset is removed (visible-blurred).
+            if (focused) {
+                adapter.emitFrame(time, delta);
+            }
+        }
+    };
+}
+//# sourceMappingURL=service-bridge-system.js.map

package/dist/service-bridge-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-bridge-system.js","sourceRoot":"","sources":["../src/service-bridge-system.ts"],"names":[],"mappings":"AAqCA;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAgD;IAEhD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACxE,IAAI,WAAgC,CAAC;IAErC,OAAO,MAAM,mBAAoB,SAAQ,YAAY,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,KAAa,EAAE,IAAY;YAChD,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,CAAC,KAAK,KAAK,YAAY,CAAC;YAE7D,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;gBAC5B,WAAW,GAAG,OAAO,CAAC;gBACtB,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBACjC,OAAO,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAChD,CAAC;YAED,oEAAoE;YACpE,8DAA8D;YAC9D,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/snapshot-service.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `SnapshotService` base — the "services own state" pattern. A snapshot service
+ * owns one immutable state object and a pub/sub list: consumers (other services,
+ * or the ECS presentation layer) subscribe and receive the current value
+ * immediately, then every subsequent publish.
+ *
+ * It has no IWSDK dependency — only `@realitycollective/service-framework` — so
+ * services that extend it stay unit-testable headless against
+ * {@link MockRuntimeAdapter}.
+ */
+import { BaseService } from "@realitycollective/service-framework";
+/**
+ * The activation-context type a service constructor receives. Aliased here so
+ * every service uses one consistent, framework-correct shape (matches the
+ * `useFactory(context)` parameter the ServiceManager passes).
+ */
+export type ServiceContext<TConfig = unknown> = ConstructorParameters<typeof BaseService<TConfig>>[0];
+export type SnapshotListener<TSnapshot> = (snapshot: TSnapshot) => void;
+export declare abstract class SnapshotService<TConfig, TSnapshot> extends BaseService<TConfig> {
+    protected snapshot: TSnapshot;
+    private readonly listeners;
+    protected constructor(context: ServiceContext<TConfig>, initialSnapshot: TSnapshot);
+    getSnapshot(): TSnapshot;
+    subscribe(listener: SnapshotListener<TSnapshot>): () => void;
+    protected publishSnapshot(snapshot: TSnapshot): void;
+    protected updateSnapshot(partial: Partial<TSnapshot>): void;
+}
+//# sourceMappingURL=snapshot-service.d.ts.map

package/dist/snapshot-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-service.d.ts","sourceRoot":"","sources":["../src/snapshot-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,OAAO,GAAG,OAAO,IAC1C,qBAAqB,CAAC,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAExD,MAAM,MAAM,gBAAgB,CAAC,SAAS,IAAI,CAAC,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAC;AAExE,8BAAsB,eAAe,CAAC,OAAO,EAAE,SAAS,CAAE,SAAQ,WAAW,CAAC,OAAO,CAAC;IACpF,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IAEpE,SAAS,aAAa,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,SAAS;IAK3E,WAAW,IAAI,SAAS;IAIxB,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC,SAAS,CAAC,GAAG,MAAM,IAAI;IAQnE,SAAS,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;IAKpD,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;CAG5D"}

package/dist/snapshot-service.js

@@ -0,0 +1,37 @@
+/**
+ * `SnapshotService` base — the "services own state" pattern. A snapshot service
+ * owns one immutable state object and a pub/sub list: consumers (other services,
+ * or the ECS presentation layer) subscribe and receive the current value
+ * immediately, then every subsequent publish.
+ *
+ * It has no IWSDK dependency — only `@realitycollective/service-framework` — so
+ * services that extend it stay unit-testable headless against
+ * {@link MockRuntimeAdapter}.
+ */
+import { BaseService } from "@realitycollective/service-framework";
+export class SnapshotService extends BaseService {
+    snapshot;
+    listeners = new Set();
+    constructor(context, initialSnapshot) {
+        super(context);
+        this.snapshot = initialSnapshot;
+    }
+    getSnapshot() {
+        return this.snapshot;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.snapshot);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    publishSnapshot(snapshot) {
+        this.snapshot = snapshot;
+        this.listeners.forEach((listener) => listener(this.snapshot));
+    }
+    updateSnapshot(partial) {
+        this.publishSnapshot({ ...this.snapshot, ...partial });
+    }
+}
+//# sourceMappingURL=snapshot-service.js.map

package/dist/snapshot-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-service.js","sourceRoot":"","sources":["../src/snapshot-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAYnE,MAAM,OAAgB,eAAoC,SAAQ,WAAoB;IAC1E,QAAQ,CAAY;IACb,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEpE,YAAsB,OAAgC,EAAE,eAA0B;QAChF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC;IAClC,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAEM,SAAS,CAAC,QAAqC;QACpD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAES,eAAe,CAAC,QAAmB;QAC3C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChE,CAAC;IAES,cAAc,CAAC,OAA2B;QAClD,IAAI,CAAC,eAAe,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;CACF"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@realitycollective/service-framework-iwsdk",
+  "version": "1.0.0",
+  "description": "Meta IWSDK (WebXR) frame-source bindings for the Reality Collective TypeScript Service Framework.",
+  "author": "Reality Collective",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "Examples",
+    "README.md"
+  ],
+  "keywords": [
+    "service-framework",
+    "iwsdk",
+    "webxr",
+    "meta",
+    "xr",
+    "realitycollective",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/realitycollective/com.realitycollective.service-framework.ts.git"
+  },
+  "homepage": "https://github.com/realitycollective/com.realitycollective.service-framework.ts#readme",
+  "bugs": {
+    "url": "https://github.com/realitycollective/com.realitycollective.service-framework.ts/issues"
+  },
+  "peerDependencies": {
+    "@iwsdk/core": ">=0.4.0 <0.5.0"
+  },
+  "peerDependenciesMeta": {
+    "@iwsdk/core": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@realitycollective/service-framework": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}