# @iwer/sem

> Synthetic Environment Module for IWER

Latest version **2.5.0** (published 2026-09-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @iwer/sem
pnpm add @iwer/sem
yarn add @iwer/sem
bun add @iwer/sem
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 2.5.0 |
| Published | 2026-09-24 |
| First published | 2025-01-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 4 |
| Unpacked size | 21.7 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 104 |
| Author | Felix Zhang |
| Maintainers | felixtrz |

## Links

- npm: https://www.npmjs.com/package/@iwer/sem
- Repository: https://github.com/meta-quest/immersive-web-emulation-runtime
- Homepage: https://github.com/meta-quest/immersive-web-emulation-runtime#readme
- Issues: https://github.com/meta-quest/immersive-web-emulation-runtime/issues
- npm.io page: https://npm.io/package/@iwer/sem

## Dependencies (4)

- [three](https://npm.io/package/three.md) ^0.184.0
- [ts-proto](https://npm.io/package/ts-proto.md) ^2.11.7
- [gl-matrix](https://npm.io/package/gl-matrix.md) ^3.4.4
- [@bufbuild/protobuf](https://npm.io/package/@bufbuild/protobuf.md) ^2.12.0

## Recent versions

- 2.5.0 (latest) — 2026-09-24
- 2.4.0 — 2026-09-11
- 2.3.0 — 2026-07-09
- 0.2.5 — 2025-02-21
- 0.2.4 — 2025-02-19
- 0.2.3 — 2025-02-14
- 0.2.2 — 2025-01-31
- 0.2.1 — 2025-01-28
- 0.2.0 — 2025-01-28
- 0.1.0 — 2025-01-22

## README

<p align="center">
    <img height="60px" width="60px" src="https://meta-quest.github.io/immersive-web-emulation-runtime/iwer-text.svg" />
    <h1 align="center">@iwer/sem</h1>
</p>

<p align="center">
    <a href="https://www.npmjs.com/package/@iwer/sem"><img src="https://badgen.net/npm/v/@iwer/sem/?icon=npm&color=orange" alt="npm version" /></a>
    <a href="https://www.npmjs.com/package/@iwer/sem"><img src="https://badgen.net/npm/dt/@iwer/sem" alt="npm download" /></a>
    <a href="https://www.typescriptlang.org/"><img src="https://badgen.net/badge/icon/typescript/?icon=typescript&label=lang" alt="language" /></a>
    <a href="https://raw.githubusercontent.com/meta-quest/immersive-web-emulation-runtime/main/LICENSE"><img src="https://badgen.net/github/license/meta-quest/immersive-web-emulation-runtime/" alt="license" /></a>
</p>

`@iwer/sem` (**Synthetic Environment Module**) is an extension for the Immersive Web Emulation Runtime (**IWER**). It enables advanced Mixed Reality features in IWER by emulating real-world environments with high-fidelity, including video passthrough, plane and mesh detection, semantic labels, and hit testing.

## Key Features

- **Video Passthrough Emulation:** Injects a video passthrough layer, rendering the captured scene behind the emulated app canvas.
- **Plane & Mesh Detection:** Provides `XRPlane` and `XRMesh` information via the `plane-detection` and `mesh-detection` APIs in IWER.
- **High Fidelity Scene Mesh:** Supports emulation of high-fidelity scene meshes exposed on Meta Quest 3 and 3S devices.
- **Hit-Test:** Enables `hit-test` APIs through IWER by conducting real-time raycasting spatial queries with the loaded environment.

## Current Status

`@iwer/sem` is currently in `0.x` status and is under active development. This is an early build, changes may occur before the official v1.0 release.

## Installation

To install `@iwer/sem`, use the following npm command:

```bash
npm install @iwer/sem
```

## Usage

`@iwer/sem` requires an active IWER runtime. If you are new to IWER, refer to the [IWER Getting Started Guide](https://meta-quest.github.io/immersive-web-emulation-runtime/getting-started.html). Here is a quick example:

```javascript
import { XRDevice, metaQuest3 } from 'iwer';

// Initialize the XR device with a preset configuration (e.g., Meta Quest 3)
const xrDevice = new XRDevice(metaQuest3);

// Install the IWER runtime to enable WebXR emulation
xrDevice.installRuntime();
```

Integrate `@iwer/sem`:

```javascript
import { SyntheticEnvironmentModule } from '@iwer/sem';

const sem = new SyntheticEnvironmentModule();
xrDevice.installSyntheticEnvironmentModule(sem);
```

Load an environment using a JSON object:

```javascript
sem.loadEnvironment(sceneJSON);
```

Or fetch from an external source:

```javascript
const url = 'path/to/your/scene.json';
fetch(url)
  .then((response) => response.json())
  .then((data) => {
    sem.loadEnvironment(data);
  })
  .catch((error) => {
    console.error('Error loading JSON:', error);
  });
```

## License

`@iwer/sem` is licensed under the MIT License. For more details, see the [LICENSE](https://github.com/meta-quest/immersive-web-emulation-runtime/blob/main/LICENSE) file in this repository.

## Contributing

Your contributions are welcome! Please feel free to submit issues and pull requests. Before contributing, make sure to review our [Contributing Guidelines](https://github.com/meta-quest/immersive-web-emulation-runtime/blob/main/CONTRIBUTING.md) and [Code of Conduct](https://github.com/meta-quest/immersive-web-emulation-runtime/blob/main/CODE_OF_CONDUCT.md).

---
_Source: https://npm.io/package/@iwer/sem · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._