chore(iwer): migrate runtime to pnpm monorepo

Summary:
Migrated immersive-web-emulation-runtime from a loose multi-package/npm layout into a pnpm monorepo.

The root is now a private workspace with shared scripts, pnpm-workspace.yaml, pnpm-lock.yaml, tsconfig.base.json, Changesets config, Husky/lint-staged, and CI wired around pnpm. The publishable packages now live under packages/: packages/iwer, packages/devui, and packages/sem. The new private packages/e2e package contains the Playwright/Vite WebXR spec-style browser harness.

Examples moved under examples/: examples/basic and examples/devui-demo. They build as standalone demo apps using local file:../../packages/... package links, while the main workspace only includes packages/*.

Release/versioning was standardized with Changesets using a fixed group for iwer, iwer/devui, and iwer/sem, all synced to 2.3.0. Internal development links use workspace:*, while published peer ranges remain explicit.

The verification story was expanded around pnpm verify: package builds, e2e typecheck, Jest unit tests, Playwright e2e tests, lint, formatting, Changesets status, docs build, tarball packing, and example builds. Dependencies were also updated and audited cleanly across the workspace and examples.

Reviewed By: cabanier

Differential Revision: D104109555

fbshipit-source-id: f1bb7b081ba50a9b566e8be3c05b444d55efc4f8

Author: felixtrz

.changeset/README.md

@@ -0,0 +1,28 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works with multi-package repos, or single-package repos to help you version and publish your code. You can find the full documentation for it [in our repository](https://github.com/changesets/changesets).
+
+We have a quick list of common questions to get you started engaging with this project in [our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md).
+
+## Versioning policy in this repo
+
+The publishable packages in this monorepo are released **lockstep** via the `fixed` group declared in [`config.json`](./config.json):
+
+- `iwer`
+- `@iwer/devui`
+- `@iwer/sem`
+
+A changeset that bumps any one of them bumps all three to the same version. Use the highest semver level that any change in the changeset warrants (for example, a `minor` bump in `iwer` plus a `patch` in `@iwer/sem` results in a `minor` for the whole group).
+
+## Workflow
+
+```bash
+# Add a changeset describing a user-facing change
+pnpm changeset
+
+# Apply pending changesets: bumps versions, updates peerDeps and CHANGELOGs
+pnpm run version
+
+# Build all packages and publish to npm (requires npm auth)
+pnpm release
+```

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@2.3.1/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [["iwer", "@iwer/devui", "@iwer/sem"]],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.changeset/tired-chicken-take.md

@@ -0,0 +1,4 @@
+---
+---
+
+Migrate to pnpm monorepo with synced package versions

.github/dependabot.yml

@@ -9,24 +9,6 @@ updates:
       prefix: 'chore'
       prefix-development: 'chore'
       include: 'scope'
-  - package-ecosystem: 'npm'
-    directory: '/devui'
-    schedule:
-      interval: 'weekly'
-    open-pull-requests-limit: 10
-    commit-message:
-      prefix: 'chore'
-      prefix-development: 'chore'
-      include: 'scope'
-  - package-ecosystem: 'npm'
-    directory: '/sem'
-    schedule:
-      interval: 'weekly'
-    open-pull-requests-limit: 10
-    commit-message:
-      prefix: 'chore'
-      prefix-development: 'chore'
-      include: 'scope'
   - package-ecosystem: 'github-actions'
     directory: '/'
     schedule:

.github/workflows/docs.yml

@@ -29,19 +29,25 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.33.4
+
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Build library
-        run: npm run build
+        run: pnpm build:all
 
       - name: Build doc site
-        run: npm run docs:build
+        run: pnpm docs:build
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

.github/workflows/test.yml

@@ -12,10 +12,23 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.33.4
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-      - run: npm ci
-      - run: npm run build
-      - run: npm test
+          cache: 'pnpm'
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm --filter @iwer/e2e exec playwright install --with-deps chromium
+      - run: pnpm build:all
+      - run: pnpm typecheck
+      - run: pnpm test:all
+      - run: pnpm lint
+      - run: pnpm format:check
+      - run: pnpm changeset:status
+      - run: pnpm docs:build
+      - run: pnpm build:tgz
+      - run: pnpm examples:build

.gitignore

@@ -1,19 +1,21 @@
-/.yarn/*
-!/.yarn/releases
-!/.yarn/plugins
-!/.yarn/sdks
-
-# Swap the comments on the following lines if you don't wish to use zero-installs
-# Documentation here: https://yarnpkg.com/features/zero-installs
-!/.yarn/cache
-#/.pnp.*
+# Dependencies
+node_modules/
+**/node_modules/
+**/pnpm-debug.log*
+**/npm-debug.log*
+**/yarn-debug.log*
+**/yarn-error.log*
 
+# Build outputs
 lib/
 build/
 dist/
-node_modules/
+*.tgz
+**/*.tsbuildinfo
+.eslintcache
 
 /.vscode/
+.idea/
 
 # blender backups
 *.blend?
@@ -23,8 +25,15 @@ node_modules/
 docs/.vitepress/dist/
 docs/.vitepress/cache/
 
+# Generated source files (created by package prebuild scripts)
 **/src/version.ts
+packages/sem/src/registry.ts
 
-*.tgz
+/coverage/
+packages/e2e/test-results/
+playwright-report/
+test-results/
+examples/**/pnpm-lock.yaml
 
-/coverage/
+# Husky internal runtime (we track .husky/pre-commit but not its scaffolding)
+.husky/_

.husky/pre-commit

@@ -0,0 +1 @@
+pnpm exec lint-staged

.npmrc

@@ -0,0 +1,2 @@
+strict-peer-dependencies=false
+only-built-dependencies[]=esbuild

.prettierignore

@@ -1,2 +1,21 @@
-/src/assets/*
-/src/style/*
+node_modules
+dist
+lib
+build
+coverage
+docs/.vitepress/cache
+docs/.vitepress/dist
+pnpm-lock.yaml
+pnpm-workspace.yaml
+*.tgz
+examples/**/node_modules
+examples/**/pnpm-lock.yaml
+examples/basic/cap.min.js
+packages/**/node_modules
+packages/sem/captures
+packages/sem/src/generated
+packages/sem/src/registry.ts
+**/version.ts
+playwright-report
+test-results
+.husky/_