@webspatial/core-sdk 1.6.1 → 2.0.0

package/src/runtime/useAnimation.capability.test.ts

@@ -0,0 +1,275 @@
+import { describe, expect, test, vi, beforeEach } from 'vitest'
+
+describe('supports("useAnimation")', () => {
+  beforeEach(() => {
+    vi.resetModules()
+  })
+
+  test('plain browser: supports("useAnimation") is false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X) AppleWebKit/537.36 Chrome/120.0.0.0 Safari/537.36',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+  })
+
+  test('visionOS WSAppShell/1.5.0: supports("useAnimation") is false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 WSAppShell/1.5.0 WebSpatial/1.5.0',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+  })
+
+  test('visionOS WSAppShell/1.6.0: supports("useAnimation") is false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7; wv) AppleWebKit/605.1.15 (KHTML, like Gecko) WSAppShell/1.6.0 WebSpatial/1.5.0 Safari/537.36',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+  })
+
+  test('visionOS WSAppShell/1.7.0: supports("useAnimation") is false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7; wv) AppleWebKit/605.1.15 (KHTML, like Gecko) WSAppShell/1.7.0 WebSpatial/1.5.0 Safari/537.36',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+  })
+
+  test('visionOS WSAppShell/1.8.0: supports("useAnimation") is true', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7; wv) AppleWebKit/605.1.15 (KHTML, like Gecko) WSAppShell/1.8.0 WebSpatial/1.5.0 Safari/537.36',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(true)
+  })
+
+  test('Puppeteer UA: supports("useAnimation") is true (debug mode enables all)', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 Puppeteer WSAppShell/1.5.0 WebSpatial/1.5.0',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(true)
+  })
+
+  test('visionOS WS_SHELL_VERSION placeholder: supports("useAnimation") is true (debug mode)', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7; wv) AppleWebKit/605.1.15 WSAppShell/WS_SHELL_VERSION WebSpatial/1.5.0 Safari/537.36',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(true)
+  })
+
+  test('picoOS PicoWebApp/0.2.2: supports("useAnimation") is false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (X11; Linux x86_64; unknown OS0.11.0 like Quest) AppleWebKit/537.36 PicoWebApp/0.2.2 (like PicoBrowser) Chrome/138.0 WebSpatial/1.5.0',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+  })
+
+  test('picoOS PicoWebApp/0.3.1: supports("useAnimation") is false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (X11; Linux x86_64; unknown OS0.11.0 like Quest) AppleWebKit/537.36 PicoWebApp/0.3.1 (like PicoBrowser) Chrome/138.0 WebSpatial/1.5.0',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+  })
+
+  test('picoOS PicoWebApp/0.4.90: supports("useAnimation") is true', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (X11; Linux x86_64; unknown OS0.11.0 like Quest) AppleWebKit/537.36 PicoWebApp/0.4.90 (like PicoBrowser) Chrome/138.0 WebSpatial/1.5.0',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(true)
+  })
+})
+
+describe('supports("useAnimation", target tokens)', () => {
+  beforeEach(() => {
+    vi.resetModules()
+  })
+
+  test('plain browser: supports("useAnimation") and target tokens are false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X) AppleWebKit/537.36 Chrome/120.0.0.0 Safari/537.36',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+    expect(supports('useAnimation', ['entity'])).toBe(false)
+    expect(supports('useAnimation', ['element'])).toBe(false)
+    expect(supports('useAnimation', ['static3d'])).toBe(false)
+    expect(supports('useAnimation', ['dynamic3d'])).toBe(false)
+  })
+
+  test('visionOS WSAppShell/1.5.0: supports("useAnimation") and target tokens are false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 WSAppShell/1.5.0 WebSpatial/1.5.0',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+    expect(supports('useAnimation', ['entity'])).toBe(false)
+    expect(supports('useAnimation', ['element'])).toBe(false)
+    expect(supports('useAnimation', ['static3d'])).toBe(false)
+    expect(supports('useAnimation', ['dynamic3d'])).toBe(false)
+  })
+
+  test('visionOS WSAppShell/1.6.0: supports("useAnimation") and target tokens are false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7; wv) AppleWebKit/605.1.15 (KHTML, like Gecko) WSAppShell/1.6.0 WebSpatial/1.5.0 Safari/537.36',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+    expect(supports('useAnimation', ['entity'])).toBe(false)
+    expect(supports('useAnimation', ['element'])).toBe(false)
+    expect(supports('useAnimation', ['static3d'])).toBe(false)
+    expect(supports('useAnimation', ['dynamic3d'])).toBe(false)
+  })
+
+  test('Puppeteer UA: supports("useAnimation") is true while all sub-tokens are false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 Puppeteer WSAppShell/1.5.0 WebSpatial/1.5.0',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(true)
+    expect(supports('useAnimation', ['entity'])).toBe(false)
+    expect(supports('useAnimation', ['element'])).toBe(false)
+    expect(supports('useAnimation', ['static3d'])).toBe(false)
+    expect(supports('useAnimation', ['dynamic3d'])).toBe(false)
+  })
+
+  test('visionOS WS_SHELL_VERSION placeholder: supports("useAnimation") is true while all sub-tokens are false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7; wv) AppleWebKit/605.1.15 WSAppShell/WS_SHELL_VERSION WebSpatial/1.5.0 Safari/537.36',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(true)
+    expect(supports('useAnimation', ['entity'])).toBe(false)
+    expect(supports('useAnimation', ['element'])).toBe(false)
+    expect(supports('useAnimation', ['static3d'])).toBe(false)
+    expect(supports('useAnimation', ['dynamic3d'])).toBe(false)
+  })
+
+  test('picoOS PicoWebApp/0.1.1: supports("useAnimation") and target tokens are false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (X11; Linux x86_64; unknown OS0.11.0 like Quest) AppleWebKit/537.36 PicoWebApp/0.1.1 (like PicoBrowser) Chrome/138.0 WebSpatial/1.5.0',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+    expect(supports('useAnimation', ['entity'])).toBe(false)
+    expect(supports('useAnimation', ['element'])).toBe(false)
+    expect(supports('useAnimation', ['static3d'])).toBe(false)
+    expect(supports('useAnimation', ['dynamic3d'])).toBe(false)
+  })
+
+  test('picoOS PicoWebApp/0.1.2: supports("useAnimation") and target tokens are false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (X11; Linux x86_64; unknown OS0.11.0 like Quest) AppleWebKit/537.36 PicoWebApp/0.1.2 (like PicoBrowser) Chrome/138.0 WebSpatial/1.5.0',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+    expect(supports('useAnimation', ['entity'])).toBe(false)
+    expect(supports('useAnimation', ['element'])).toBe(false)
+    expect(supports('useAnimation', ['static3d'])).toBe(false)
+    expect(supports('useAnimation', ['dynamic3d'])).toBe(false)
+  })
+
+  test('picoOS PicoWebApp/0.2.2: supports("useAnimation") and all sub-tokens are false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (X11; Linux x86_64; unknown OS0.11.0 like Quest) AppleWebKit/537.36 PicoWebApp/0.2.2 (like PicoBrowser) Chrome/138.0 WebSpatial/1.5.0',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+    expect(supports('useAnimation', ['entity'])).toBe(false)
+    expect(supports('useAnimation', ['element'])).toBe(false)
+    expect(supports('useAnimation', ['static3d'])).toBe(false)
+    expect(supports('useAnimation', ['dynamic3d'])).toBe(false)
+  })
+
+  test('visionOS WSAppShell/1.8.0: supports("useAnimation") is true while all sub-tokens are false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7; wv) AppleWebKit/605.1.15 (KHTML, like Gecko) WSAppShell/1.8.0 WebSpatial/1.5.0 Safari/537.36',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(true)
+    expect(supports('useAnimation', ['entity'])).toBe(false)
+    expect(supports('useAnimation', ['element'])).toBe(false)
+    expect(supports('useAnimation', ['static3d'])).toBe(false)
+    expect(supports('useAnimation', ['dynamic3d'])).toBe(false)
+  })
+
+  test('visionOS WSAppShell/1.7.0: supports("useAnimation") and all sub-tokens are false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7; wv) AppleWebKit/605.1.15 (KHTML, like Gecko) WSAppShell/1.7.0 WebSpatial/1.5.0 Safari/537.36',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(false)
+    expect(supports('useAnimation', ['entity'])).toBe(false)
+    expect(supports('useAnimation', ['element'])).toBe(false)
+    expect(supports('useAnimation', ['static3d'])).toBe(false)
+    expect(supports('useAnimation', ['dynamic3d'])).toBe(false)
+  })
+})
+
+describe('useAnimation sub-tokens', () => {
+  beforeEach(() => {
+    vi.resetModules()
+  })
+
+  test('all useAnimation sub-tokens return false', async () => {
+    vi.stubGlobal('navigator', {
+      userAgent:
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 Puppeteer WSAppShell/1.5.0 WebSpatial/1.5.0',
+    } as Navigator)
+    const { supports, resetRuntimeCacheForTests } = await import('./supports')
+    resetRuntimeCacheForTests()
+    expect(supports('useAnimation')).toBe(true)
+    expect(supports('useAnimation', ['entity'])).toBe(false)
+    expect(supports('useAnimation', ['element'])).toBe(false)
+    expect(supports('useAnimation', ['static3d'])).toBe(false)
+    expect(supports('useAnimation', ['dynamic3d'])).toBe(false)
+    expect(supports('useAnimation', ['unknown' as any])).toBe(false)
+    expect(supports('useAnimation', ['opacity' as any])).toBe(false)
+  })
+})

package/src/runtime/userAgent.ts

@@ -0,0 +1,64 @@
+import type { WebSpatialRuntimeSnapshot } from './types'
+
+/**
+ * Parse shell token from UA:
+ * - packaged/hybrid runtimes use `WSAppShell/<version>`
+ * - browser-mode runtime on Pico OS uses `PicoWebApp/<version>`
+ *
+ * Keep `WSAppShell` precedence when both appear in one UA.
+ */
+export function parseShellToken(ua: string): {
+  version: string | null
+  source: 'wsapp' | 'picoapp' | null
+} {
+  const ws = /\bWSAppShell\/([\w.-]+)/i.exec(ua)
+  if (ws?.[1]) return { version: ws[1], source: 'wsapp' }
+  const pico = /\bPicoWebApp\/([\w.-]+)/i.exec(ua)
+  if (pico?.[1]) return { version: pico[1], source: 'picoapp' }
+  return { version: null, source: null }
+}
+
+/** Pico runtime: require explicit Pico tokens (do not treat generic `like Quest` VR UAs as picoos). */
+function inferPicoOs(ua: string): boolean {
+  return /\bPicoWebApp\//i.test(ua) || /\bPicoBrowser\b/i.test(ua)
+}
+
+/** visionOS-class WebView UAs include a Mac OS X platform token; `WSAppShell` alone is not enough. */
+function inferVisionOsFromUa(ua: string): boolean {
+  return /Mac OS X/i.test(ua)
+}
+
+/**
+ * Resolve internal runtime snapshot from `navigator.userAgent`.
+ * SSR / no navigator → `{ type: null, shellVersion: null }` (no throw).
+ */
+export function computeRuntimeFromUserAgent(
+  userAgent: string | undefined,
+): WebSpatialRuntimeSnapshot {
+  if (userAgent === undefined || userAgent === '') {
+    return { type: null, shellVersion: null }
+  }
+  // Must run before the shell-token gate: Puppeteer UAs may omit WSAppShell/PicoWebApp.
+  if (userAgent.includes('Puppeteer')) {
+    const { version } = parseShellToken(userAgent)
+    return { type: 'puppeteer', shellVersion: version }
+  }
+
+  const { version, source } = parseShellToken(userAgent)
+  if (!version) {
+    return { type: null, shellVersion: null }
+  }
+
+  if (source === 'picoapp' || inferPicoOs(userAgent)) {
+    return { type: 'picoos', shellVersion: version }
+  }
+
+  if (source === 'wsapp') {
+    if (inferVisionOsFromUa(userAgent)) {
+      return { type: 'visionos', shellVersion: version }
+    }
+    return { type: null, shellVersion: version }
+  }
+
+  return { type: null, shellVersion: version }
+}

package/src/scene-polyfill.manifest.test.ts

@@ -1,15 +1,35 @@
-import { describe, it, expect, vi } from 'vitest'
+import { afterEach, describe, expect, it, vi } from 'vitest'
+
+const jsbMocks = vi.hoisted(() => ({
+  createSpatialSceneCommand: vi.fn().mockImplementation(() => ({
+    executeSync: vi.fn().mockReturnValue({
+      data: { id: 'scene-1', windowProxy: {} },
+    }),
+  })),
+  focusSceneExecute: vi.fn().mockResolvedValue(undefined),
+}))
+
+const spatialHostMocks = vi.hoisted(() => ({
+  openSpatialSceneSync: vi.fn().mockReturnValue({
+    success: true,
+    data: { id: 'scene-1', windowProxy: {} },
+  }),
+}))
+
+const originalWindowOpen = window.open
+
+vi.mock('./spatial-host', () => ({
+  openSpatialSceneSync: spatialHostMocks.openSpatialSceneSync,
+}))
 
 vi.mock('./JSBCommand', () => {
   return {
-    createSpatialSceneCommand: vi.fn().mockImplementation(() => ({
-      executeSync: vi.fn().mockReturnValue({
-        data: { id: 'scene-1', windowProxy: {} },
-      }),
-    })),
-    FocusScene: vi.fn().mockImplementation(() => ({
-      execute: vi.fn().mockResolvedValue(undefined),
-    })),
+    createSpatialSceneCommand: jsbMocks.createSpatialSceneCommand,
+    FocusScene: vi.fn().mockImplementation(function () {
+      return {
+        execute: jsbMocks.focusSceneExecute,
+      }
+    }),
   }
 })
 
@@ -29,6 +49,16 @@ async function waitTick() {
   await new Promise(r => setTimeout(r, 0))
 }
 
+afterEach(() => {
+  window.open = originalWindowOpen
+  jsbMocks.createSpatialSceneCommand.mockClear()
+  jsbMocks.focusSceneExecute.mockClear()
+  spatialHostMocks.openSpatialSceneSync.mockClear()
+  document
+    .querySelectorAll('link[rel="manifest"]')
+    .forEach(node => node.parentElement?.removeChild(node))
+})
+
 describe('setupManifest applies overrides to xr_window_defaults / xr_volume_defaults', () => {
   it('applies window overrides without affecting volume defaults', async () => {
     vi.resetModules()
@@ -109,6 +139,279 @@ describe('setupManifest applies overrides to xr_window_defaults / xr_volume_defa
     cleanup()
   })
 
+  it('prefers snake_case over camelCase within a layer and still applies overrides by priority', async () => {
+    vi.resetModules()
+    const cleanup = addDataManifest({
+      xr_spatial_scene: {
+        defaultSize: { width: '111px', height: '111px' },
+        default_size: { width: '222px', height: '333px' },
+        overrides: {
+          window_scene: {
+            defaultSize: { width: '444px' },
+            default_size: { width: '555px' },
+          },
+        },
+      },
+    })
+    const { hijackWindowOpen, initScene } = await import('./scene-polyfill')
+    hijackWindowOpen(window)
+    await waitTick()
+
+    let winDefaults: any
+    initScene(
+      'w',
+      pre => {
+        winDefaults = pre
+        return pre
+      },
+      { type: 'window' },
+    )
+
+    let volDefaults: any
+    initScene(
+      'v',
+      pre => {
+        volDefaults = pre
+        return pre
+      },
+      { type: 'volume' },
+    )
+
+    expect(winDefaults).toEqual(
+      expect.objectContaining({
+        defaultSize: { width: '555px', height: '333px' },
+      }),
+    )
+
+    expect(volDefaults).toEqual(
+      expect.objectContaining({
+        defaultSize: { width: '222px', height: '333px' },
+      }),
+    )
+
+    cleanup()
+  })
+
+  it('resolves same-layer aliases recursively so winners own their layer values', async () => {
+    vi.resetModules()
+    const cleanup = addDataManifest({
+      xr_spatial_scene: {
+        defaultSize: { width: '111px', height: '111px' },
+        default_size: { width: '222px', height: '333px' },
+        resizability: {
+          minWidth: '100px',
+          min_width: '200px',
+          maxWidth: '800px',
+        },
+      },
+    })
+    const { hijackWindowOpen, initScene } = await import('./scene-polyfill')
+    hijackWindowOpen(window)
+    await waitTick()
+
+    let defaults: any
+    initScene(
+      'recursive-layer',
+      pre => {
+        defaults = pre
+        return pre
+      },
+      { type: 'window' },
+    )
+
+    expect(defaults).toEqual(
+      expect.objectContaining({
+        defaultSize: { width: '222px', height: '333px' },
+        resizability: {
+          minWidth: '200px',
+          maxWidth: '800px',
+        },
+      }),
+    )
+
+    cleanup()
+  })
+
+  it('supports overrides windowScene/volumeScene and snake_case resizability keys', async () => {
+    vi.resetModules()
+    const cleanup = addDataManifest({
+      xr_spatial_scene: {
+        resizability: {
+          min_width: '300px',
+          min_height: '400px',
+          max_width: '1200px',
+          max_height: '1300px',
+        },
+        worldScaling: 'automatic',
+        overrides: {
+          windowScene: {
+            world_scaling: 'dynamic',
+          },
+          volumeScene: {
+            baseplate_visibility: 'hidden',
+          },
+        },
+      },
+    })
+    const { hijackWindowOpen, initScene } = await import('./scene-polyfill')
+    hijackWindowOpen(window)
+    await waitTick()
+
+    let winDefaults: any
+    initScene(
+      'w',
+      pre => {
+        winDefaults = pre
+        return pre
+      },
+      { type: 'window' },
+    )
+
+    let volDefaults: any
+    initScene(
+      'v',
+      pre => {
+        volDefaults = pre
+        return pre
+      },
+      { type: 'volume' },
+    )
+
+    expect(winDefaults).toEqual(
+      expect.objectContaining({
+        resizability: {
+          minWidth: '300px',
+          minHeight: '400px',
+          maxWidth: '1200px',
+          maxHeight: '1300px',
+        },
+        worldScaling: 'dynamic',
+      }),
+    )
+
+    expect(volDefaults).toEqual(
+      expect.objectContaining({
+        resizability: {
+          minWidth: '300px',
+          minHeight: '400px',
+          maxWidth: '1200px',
+          maxHeight: '1300px',
+        },
+        baseplateVisibility: 'hidden',
+      }),
+    )
+
+    cleanup()
+  })
+
+  it('normalizes top-level world_alignment and baseplate_visibility aliases', async () => {
+    vi.resetModules()
+    const cleanup = addDataManifest({
+      xr_spatial_scene: {
+        world_alignment: 'gravityAligned',
+        baseplate_visibility: 'hidden',
+      },
+    })
+    const { hijackWindowOpen, initScene } = await import('./scene-polyfill')
+    hijackWindowOpen(window)
+    await waitTick()
+
+    let winDefaults: any
+    initScene(
+      'w-alias',
+      pre => {
+        winDefaults = pre
+        return pre
+      },
+      { type: 'window' },
+    )
+
+    let volDefaults: any
+    initScene(
+      'v-alias',
+      pre => {
+        volDefaults = pre
+        return pre
+      },
+      { type: 'volume' },
+    )
+
+    expect(winDefaults).toEqual(
+      expect.objectContaining({
+        worldAlignment: 'gravityAligned',
+        baseplateVisibility: 'hidden',
+      }),
+    )
+    expect(volDefaults).toEqual(
+      expect.objectContaining({
+        worldAlignment: 'gravityAligned',
+        baseplateVisibility: 'hidden',
+      }),
+    )
+
+    cleanup()
+  })
+
+  it('does not normalize initScene callback return value when chaining', async () => {
+    vi.resetModules()
+    const cleanup = addDataManifest({
+      xr_spatial_scene: {
+        default_size: { width: '222px', height: '333px' },
+      },
+    })
+    const { hijackWindowOpen, initScene } = await import('./scene-polyfill')
+    hijackWindowOpen(window)
+    await waitTick()
+
+    const firstReturn: any = { default_size: { width: '777px' } }
+    const cb1 = vi.fn().mockReturnValue(firstReturn)
+    initScene('chain', cb1, { type: 'window' })
+
+    const cb2 = vi.fn().mockReturnValue({})
+    initScene('chain', cb2, { type: 'window' })
+
+    expect(cb2).toHaveBeenCalledWith(firstReturn)
+
+    cleanup()
+  })
+
+  it('uses manifest aliases when window.open creates a named scene without initScene', async () => {
+    vi.resetModules()
+    const cleanup = addDataManifest({
+      xr_spatial_scene: {
+        default_size: { width: '300px', height: '400px' },
+        world_alignment: 'gravityAligned',
+        overrides: {
+          windowScene: {
+            default_size: { width: '500px' },
+            resizability: { min_width: '320px' },
+            baseplate_visibility: 'visible',
+          },
+        },
+      },
+    })
+    const { hijackWindowOpen } = await import('./scene-polyfill')
+    hijackWindowOpen(window)
+    await waitTick()
+
+    window.open('https://example.com/scene', 'manifest-alias-window')
+
+    expect(spatialHostMocks.openSpatialSceneSync).toHaveBeenCalledWith(
+      'https://example.com/scene',
+      expect.objectContaining({
+        type: 'window',
+        defaultSize: { width: 500, height: 400 },
+        resizability: { minWidth: 320 },
+        worldAlignment: 'gravityAligned',
+        baseplateVisibility: 'visible',
+      }),
+      'manifest-alias-window',
+      undefined,
+    )
+
+    cleanup()
+  })
+
   it('applies volume overrides without affecting window defaults', async () => {
     vi.resetModules()
     const cleanup = addDataManifest({