Add readme for IWER/SEM

Summary: Add readme for IWER/SEM and a default room capture file as example

Reviewed By: cabanier

Differential Revision: D68512954

fbshipit-source-id: 867932a2957f2ea02f9747903855982336932782

sem/README.md

@@ -0,0 +1,83 @@
+<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).