chore: release 0.4.1

felixtrz · meta-codesync[bot] · commit e6e639e98d58 · 2026-05-20T21:39:20.000-07:00
Summary: chore: release 0.4.1

Reviewed By: zjm-meta

Differential Revision: D105707290

fbshipit-source-id: e7ada2ff4774e0511afe2311855cd6c46501f58e
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @iwsdk/cli
 
+## 0.4.1
+
+### Patch Changes
+
+- Connect runtime WebSocket traffic to `127.0.0.1` instead of `localhost`, avoiding local DNS/IPv6 resolution issues when talking to the dev server.
+- Tighten dev-server browser readiness/status handling used by CLI and MCP probes.
+
 ## 0.4.0
 
 ### Minor Changes
diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iwsdk/cli",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Runtime-first CLI for IWSDK dev servers, adapters, and MCP access",
   "private": false,
   "type": "module",
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -1,24 +1,18 @@
 # @iwsdk/core
 
-## Unreleased
-
-### Behavior Changes
-
-- `AssetManager.getGLTF(key)` (and `GLTFAssetLoader.getGLTF(key)`) now
-  return a fresh clone of the cached `GLTF` by default. `scene` and
-  `scenes` are cloned via `SkeletonUtils.clone` (correct for
-  `SkinnedMesh`/`Bone` hierarchies); geometries, materials, and
-  `animations` remain shared by reference. This fixes silent re-parenting
-  when the same key is used to spawn multiple entities (T270858760).
-  Pass `{ shared: true }` to opt back into the previous shared-instance
-  behavior.
-- `world.camera` is now auto-restored to its pre-XR local transform and
-  projection on session exit (deferred one `requestAnimationFrame` so
-  three.js's `WebXRManager` finishes tearing down on the end-tick first).
-  Previously the camera was left at the last head pose and the 2D
-  fallback view was inside-the-head until the app re-applied a camera
-  setup. Opt out via `xr: { restoreCameraOnExit: false }` if your app
-  manages this transition itself.
+## 0.4.1
+
+### Patch Changes
+
+- `AssetManager.getGLTF(key)` and `GLTFAssetLoader.getGLTF(key)` now return a fresh clone of the cached GLTF by default, preventing silent re-parenting when spawning multiple entities from the same asset. Pass `{ shared: true }` to opt back into the previous shared-instance behavior.
+- Restore `world.camera` to its pre-XR local transform and projection after XR session exit, avoiding a broken browser fallback view after leaving immersive mode. Opt out with `xr: { restoreCameraOnExit: false }`.
+- Route canvas pointer events correctly to screen-space `PanelUI`, including descendant hit handling.
+- Add regression tests for GLTF cloning, browser camera restore, canvas pointer routing, and screen-space UI descendants.
+
+- Updated dependencies
+  - @iwsdk/glxf@0.4.1
+  - @iwsdk/locomotor@0.4.1
+  - @iwsdk/xr-input@0.4.1
 
 ## 0.4.0
 
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iwsdk/core",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Javascript WebXR Runtime for Emulation",
   "type": "module",
   "main": "dist/index.js",
diff --git a/packages/create/CHANGELOG.md b/packages/create/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @iwsdk/create
 
+## 0.4.1
+
+### Patch Changes
+
+- Version-only release to keep the `@iwsdk/*` package set aligned for 0.4.1.
+
 ## 0.4.0
 
 ### Minor Changes
diff --git a/packages/create/package.json b/packages/create/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iwsdk/create",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Interactive CLI to scaffold Immersive Web SDK starter apps",
   "type": "module",
   "private": false,
diff --git a/packages/glxf/CHANGELOG.md b/packages/glxf/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @iwsdk/glxf
 
+## 0.4.1
+
+### Patch Changes
+
+- Version-only release to keep the `@iwsdk/*` package set aligned for 0.4.1.
+
 ## 0.4.0
 
 ### Minor Changes
diff --git a/packages/glxf/package.json b/packages/glxf/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iwsdk/glxf",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "GLXF (GLTF eXtended Format) loader for Three.js - composite scene format for WebXR applications",
   "type": "module",
   "main": "dist/index.js",
diff --git a/packages/locomotor/CHANGELOG.md b/packages/locomotor/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @iwsdk/locomotor
 
+## 0.4.1
+
+### Patch Changes
+
+- Version-only release to keep the `@iwsdk/*` package set aligned for 0.4.1.
+
 ## 0.4.0
 
 ### Minor Changes
diff --git a/packages/locomotor/package.json b/packages/locomotor/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iwsdk/locomotor",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Locomotion engine for WebXR applications - physics-based movement, teleportation, and collision detection for Three.js",
   "type": "module",
   "main": "dist/index.js",
diff --git a/packages/reference-assets/CHANGELOG.md b/packages/reference-assets/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @iwsdk/reference-assets
 
+## 0.4.1
+
+### Patch Changes
+
+- Add pinned per-file hashes to reference model metadata so warmup/cache validation no longer depends on recompressing model archives.
+- Rebuild the reference payload/model artifacts for the 0.4.1 release.
+
 ## 0.4.0
 
 ### Minor Changes
diff --git a/packages/reference-assets/package.json b/packages/reference-assets/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iwsdk/reference-assets",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Producer pipeline and versioned corpus payloads for @iwsdk/reference",
   "private": false,
   "type": "module",
diff --git a/packages/reference/CHANGELOG.md b/packages/reference/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @iwsdk/reference
 
+## 0.4.1
+
+### Patch Changes
+
+- Validate warmed reference model caches with pinned per-file hashes instead of recreating nondeterministic archives.
+- Add reference warmup/cache validation coverage for the updated model metadata contract.
+
 ## 0.4.0
 
 ### Minor Changes
diff --git a/packages/reference/package.json b/packages/reference/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iwsdk/reference",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Workspace-local reference CLI/MCP server for semantic IWSDK search using externally hosted corpus/model warmup artifacts",
   "type": "module",
   "main": "dist/index.js",
diff --git a/packages/starter-assets/CHANGELOG.md b/packages/starter-assets/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @iwsdk/starter-assets
 
+## 0.4.1
+
+### Patch Changes
+
+- Add the `iwsdk-depth-occlusion` skill to generated starter agent guidance.
+- Update starter `PROJECT_AGENTS.md`, `PROJECT_CLAUDE.md`, and planner guidance for the latest AI workflow.
+- Rebuild starter recipes and assets for the 0.4.1 release.
+
 ## 0.4.0
 
 ### Minor Changes
diff --git a/packages/starter-assets/package.json b/packages/starter-assets/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iwsdk/starter-assets",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "CDN-ready assets and recipes for IWSDK starters (VR/AR manual & metaspatial).",
   "type": "module",
   "files": [
diff --git a/packages/starter-assets/scripts/chef-verify.mjs b/packages/starter-assets/scripts/chef-verify.mjs
@@ -7,15 +7,99 @@
  */
 
 import fsp from 'fs/promises';
+import http from 'http';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { buildProject } from '@pmndrs/chef';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const ROOT = path.resolve(__dirname, '..');
+const DIST_DIR = path.join(ROOT, 'dist');
 const RECIPES_DIR = path.join(ROOT, 'dist', 'recipes');
 
+const MIME_TYPES = {
+  '.css': 'text/css',
+  '.gltf': 'model/gltf+json',
+  '.html': 'text/html',
+  '.js': 'application/javascript',
+  '.json': 'application/json',
+  '.mp3': 'audio/mpeg',
+  '.png': 'image/png',
+  '.svg': 'image/svg+xml',
+  '.ts': 'text/plain',
+  '.txt': 'text/plain',
+  '.uikitml': 'application/xml',
+  '.xml': 'application/xml',
+};
+
+function resolveRecipeUrls(recipe, baseUrl) {
+  if (!recipe.edits) {
+    return recipe;
+  }
+
+  const edits = {};
+  for (const [key, value] of Object.entries(recipe.edits)) {
+    if (
+      value &&
+      typeof value === 'object' &&
+      !Array.isArray(value) &&
+      typeof value.url === 'string' &&
+      !URL.canParse(value.url)
+    ) {
+      edits[key] = { ...value, url: new URL(value.url, baseUrl).href };
+      continue;
+    }
+    edits[key] = value;
+  }
+
+  return { ...recipe, edits };
+}
+
+async function startDistServer() {
+  const server = http.createServer((req, res) => {
+    const requestUrl = new URL(req.url || '/', 'http://localhost');
+    const relativePath = decodeURIComponent(requestUrl.pathname).replace(
+      /^\/+/,
+      '',
+    );
+    const filePath = path.resolve(DIST_DIR, relativePath);
+
+    if (filePath !== DIST_DIR && !filePath.startsWith(`${DIST_DIR}${path.sep}`)) {
+      res.writeHead(403).end('Forbidden');
+      return;
+    }
+
+    fsp
+      .readFile(filePath)
+      .then((bytes) => {
+        const contentType =
+          MIME_TYPES[path.extname(filePath).toLowerCase()] ||
+          'application/octet-stream';
+        res.writeHead(200, { 'content-type': contentType });
+        res.end(bytes);
+      })
+      .catch(() => {
+        res.writeHead(404).end('Not found');
+      });
+  });
+
+  await new Promise((resolve, reject) => {
+    server.once('error', reject);
+    server.listen(0, '127.0.0.1', resolve);
+  });
+
+  const address = server.address();
+  if (!address || typeof address === 'string') {
+    throw new Error('Could not bind local verification server.');
+  }
+
+  return {
+    baseUrl: `http://127.0.0.1:${address.port}/`,
+    close: () => new Promise((resolve) => server.close(resolve)),
+  };
+}
+
 async function main() {
   const files = (await fsp.readdir(RECIPES_DIR)).filter((f) =>
     f.endsWith('.recipe.json'),
@@ -24,21 +108,30 @@ async function main() {
     console.error('No *.recipe.json files found in dist/recipes. Build first.');
     process.exit(1);
   }
+  const distServer = await startDistServer();
   let ok = 0;
-  for (const f of files) {
-    const p = path.join(RECIPES_DIR, f);
-    const recipe = JSON.parse(await fsp.readFile(p, 'utf8'));
-    try {
-      const result = await buildProject([recipe], undefined, {
-        allowUrl: false,
-      });
-      const count = Object.keys(result).length;
-      console.log(`OK ${f} (${count} files)`);
-      ok++;
-    } catch (e) {
-      console.error(`FAIL ${f}:`, e?.message || e);
-      process.exit(1);
+  try {
+    for (const f of files) {
+      const p = path.join(RECIPES_DIR, f);
+      const recipe = resolveRecipeUrls(
+        JSON.parse(await fsp.readFile(p, 'utf8')),
+        distServer.baseUrl,
+      );
+      try {
+        const result = await buildProject([recipe], undefined, {
+          allowUrl: true,
+        });
+        const count = Object.keys(result).length;
+        console.log(`OK ${f} (${count} files)`);
+        ok++;
+      } catch (e) {
+        console.error(`FAIL ${f}:`, e?.message || e);
+        process.exitCode = 1;
+        return;
+      }
     }
+  } finally {
+    await distServer.close();
   }
   console.log(`Summary: ${ok} / ${files.length} recipes OK`);
 }
diff --git a/packages/vite-plugin-dev/CHANGELOG.md b/packages/vite-plugin-dev/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @iwsdk/vite-plugin-dev
 
+## 0.4.1
+
+### Patch Changes
+
+- Use `waitUntil: 'commit'` for managed-browser navigation, reducing startup flake before the browser runtime bridge becomes ready.
+- Tighten managed-browser session state updates for relaunch/readiness handling.
+
 ## 0.4.0
 
 ### Minor Changes
diff --git a/packages/vite-plugin-dev/package.json b/packages/vite-plugin-dev/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iwsdk/vite-plugin-dev",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "description": "Vite plugin for IWSDK development — XR emulation, AI agent tooling, and Playwright browser",
   "main": "dist/index.js",
diff --git a/packages/vite-plugin-gltf-optimizer/CHANGELOG.md b/packages/vite-plugin-gltf-optimizer/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @iwsdk/vite-plugin-gltf-optimizer
 
+## 0.4.1
+
+### Patch Changes
+
+- Version-only release to keep the `@iwsdk/*` package set aligned for 0.4.1.
+
 ## 0.4.0
 
 ### Minor Changes
diff --git a/packages/vite-plugin-gltf-optimizer/package.json b/packages/vite-plugin-gltf-optimizer/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iwsdk/vite-plugin-gltf-optimizer",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "description": "Vite plugin for GLTF/GLB optimization during build using gltf-transform",
   "main": "dist/index.js",
diff --git a/packages/vite-plugin-metaspatial/CHANGELOG.md b/packages/vite-plugin-metaspatial/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @iwsdk/vite-plugin-metaspatial
 
+## 0.4.1
+
+### Patch Changes
+
+- Version-only release to keep the `@iwsdk/*` package set aligned for 0.4.1.
+
 ## 0.4.0
 
 ### Minor Changes
diff --git a/packages/vite-plugin-metaspatial/package.json b/packages/vite-plugin-metaspatial/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iwsdk/vite-plugin-metaspatial",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "description": "Vite plugins for Meta Spatial SDK integration: component discovery & GLXF generation",
   "main": "dist/index.js",
diff --git a/packages/vite-plugin-uikitml/CHANGELOG.md b/packages/vite-plugin-uikitml/CHANGELOG.md
diff --git a/packages/vite-plugin-uikitml/package.json b/packages/vite-plugin-uikitml/package.json
diff --git a/packages/xr-input/CHANGELOG.md b/packages/xr-input/CHANGELOG.md
diff --git a/packages/xr-input/package.json b/packages/xr-input/package.json
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@iwsdk/cli",`
`3`		`- "version": "0.4.0",`
	`3`	`+ "version": "0.4.1",`
`4`	`4`	`"description": "Runtime-first CLI for IWSDK dev servers, adapters, and MCP access",`
`5`	`5`	`"private": false,`
`6`	`6`	`"type": "module",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@iwsdk/core",`
`3`		`- "version": "0.4.0",`
	`3`	`+ "version": "0.4.1",`
`4`	`4`	`"description": "Javascript WebXR Runtime for Emulation",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@iwsdk/create",`
`3`		`- "version": "0.4.0",`
	`3`	`+ "version": "0.4.1",`
`4`	`4`	`"description": "Interactive CLI to scaffold Immersive Web SDK starter apps",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"private": false,`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@iwsdk/glxf",`
`3`		`- "version": "0.4.0",`
	`3`	`+ "version": "0.4.1",`
`4`	`4`	`"description": "GLXF (GLTF eXtended Format) loader for Three.js - composite scene format for WebXR applications",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@iwsdk/locomotor",`
`3`		`- "version": "0.4.0",`
	`3`	`+ "version": "0.4.1",`
`4`	`4`	`"description": "Locomotion engine for WebXR applications - physics-based movement, teleportation, and collision detection for Three.js",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "dist/index.js",`