@webspatial/core-sdk 1.7.0 → 2.0.0

package/dist/runtime/WebSpatialRuntimeError.js

@@ -0,0 +1,14 @@
+class WebSpatialRuntimeError extends Error {
+  capability;
+  constructor(capability, message) {
+    super(
+      message ?? `Capability "${capability}" is not supported in this WebSpatial runtime`
+    );
+    this.name = "WebSpatialRuntimeError";
+    this.capability = capability;
+  }
+}
+export {
+  WebSpatialRuntimeError
+};
+//# sourceMappingURL=WebSpatialRuntimeError.js.map

package/dist/runtime/WebSpatialRuntimeError.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/WebSpatialRuntimeError.ts"],"sourcesContent":["/**\n * Thrown when a runtime-gated JS API is invoked but `supports('<name>')` is false.\n * See OpenSpec `runtime-capabilities/spec.md` (Unsupported behavior contracts).\n */\nexport class WebSpatialRuntimeError extends Error {\n  public readonly capability: string\n\n  constructor(capability: string, message?: string) {\n    super(\n      message ??\n        `Capability \"${capability}\" is not supported in this WebSpatial runtime`,\n    )\n    this.name = 'WebSpatialRuntimeError'\n    this.capability = capability\n  }\n}\n"],"mappings":"AAIO,MAAM,+BAA+B,MAAM;AAAA,EAChC;AAAA,EAEhB,YAAY,YAAoB,SAAkB;AAChD;AAAA,MACE,WACE,eAAe,UAAU;AAAA,IAC7B;AACA,SAAK,OAAO;AACZ,SAAK,aAAa;AAAA,EACpB;AACF;","names":[]}

package/dist/runtime/capability-data.d.ts

@@ -0,0 +1,12 @@
+type CapabilityVersionRow = {
+    /** Semver string from `WSAppShell` / `PicoWebApp` (see `review.md` §4). */
+    version: string;
+    /** Top-level keys and `name:subToken` compound keys. */
+    flags: Record<string, boolean>;
+};
+declare const CAPABILITY_TABLE: {
+    visionos: CapabilityVersionRow[];
+    picoos: CapabilityVersionRow[];
+};
+
+export { CAPABILITY_TABLE, type CapabilityVersionRow };

package/dist/runtime/capability-data.js

@@ -0,0 +1,134 @@
+import { SUB_TOKENS_BY_NAME, TOP_LEVEL_KEYS } from "./keys";
+function baseTrueFlags() {
+  const flags = {};
+  for (const k of TOP_LEVEL_KEYS) {
+    flags[k] = true;
+  }
+  for (const [name, toks] of Object.entries(SUB_TOKENS_BY_NAME)) {
+    for (const t of toks) {
+      flags[`${name}:${t}`] = true;
+    }
+  }
+  return flags;
+}
+function matrixVision_1_5_0_Flags() {
+  const flags = baseTrueFlags();
+  const modelNo = [
+    "autoplay",
+    "loop",
+    "stagemode",
+    "poster",
+    "loading",
+    "source",
+    "paused",
+    "duration",
+    "playbackRate",
+    "play",
+    "pause",
+    "currentTime"
+  ];
+  for (const t of modelNo) {
+    flags[`Model:${t}`] = false;
+  }
+  flags["SpatialRotateEvent:constrainedToAxis"] = true;
+  flags["useAnimation"] = false;
+  flags["AttachmentEntity:placement"] = false;
+  return flags;
+}
+function matrixVision_1_6_0_Flags() {
+  const flags = baseTrueFlags();
+  for (const t of ["stagemode", "poster", "loading", "currentTime"]) {
+    flags[`Model:${t}`] = false;
+  }
+  flags["SpatialRotateEvent:constrainedToAxis"] = true;
+  flags["useAnimation"] = false;
+  flags["AttachmentEntity:placement"] = false;
+  return flags;
+}
+function matrixVision_1_7_0_Flags() {
+  const flags = matrixVision_1_6_0_Flags();
+  flags["Model:currentTime"] = true;
+  flags["Model:loading"] = true;
+  flags["Model:poster"] = true;
+  return flags;
+}
+function matrixVision_1_8_0_Flags() {
+  const flags = matrixVision_1_7_0_Flags();
+  flags["useAnimation"] = true;
+  return flags;
+}
+function matrixPico_0_1_1_Flags() {
+  const flags = matrixVision_1_5_0_Flags();
+  flags.xrInnerDepth = false;
+  flags.xrOuterDepth = false;
+  return flags;
+}
+function matrixPico_0_1_2_Flags() {
+  const flags = matrixVision_1_6_0_Flags();
+  flags.xrInnerDepth = false;
+  flags.xrOuterDepth = false;
+  flags["Model:currentTime"] = true;
+  flags["Model:poster"] = true;
+  return flags;
+}
+function matrixPico_0_2_2_Flags() {
+  const flags = matrixPico_0_1_2_Flags();
+  return flags;
+}
+function matrixPico_0_3_1_Flags() {
+  const flags = matrixPico_0_2_2_Flags();
+  flags["Model:loading"] = true;
+  return flags;
+}
+function matrixPico_0_4_90_Flags() {
+  const flags = matrixPico_0_3_1_Flags();
+  flags["useAnimation"] = true;
+  flags["AttachmentEntity:placement"] = true;
+  return flags;
+}
+function visionOsRow_1_5_0() {
+  return { version: "1.5.0", flags: matrixVision_1_5_0_Flags() };
+}
+function visionOsRow_1_6_0() {
+  return { version: "1.6.0", flags: matrixVision_1_6_0_Flags() };
+}
+function visionOsRow_1_7_0() {
+  return { version: "1.7.0", flags: matrixVision_1_7_0_Flags() };
+}
+function visionOsRow_1_8_0() {
+  return { version: "1.8.0", flags: matrixVision_1_8_0_Flags() };
+}
+function picoOsRow_0_1_1() {
+  return { version: "0.1.1", flags: matrixPico_0_1_1_Flags() };
+}
+function picoOsRow_0_1_2() {
+  return { version: "0.1.2", flags: matrixPico_0_1_2_Flags() };
+}
+function picoOsRow_0_2_2() {
+  return { version: "0.2.2", flags: matrixPico_0_2_2_Flags() };
+}
+function picoOsRow_0_3_1() {
+  return { version: "0.3.1", flags: matrixPico_0_3_1_Flags() };
+}
+function picoOsRow_0_4_90() {
+  return { version: "0.4.90", flags: matrixPico_0_4_90_Flags() };
+}
+const CAPABILITY_TABLE = {
+  visionos: [
+    visionOsRow_1_5_0(),
+    visionOsRow_1_6_0(),
+    visionOsRow_1_7_0(),
+    visionOsRow_1_8_0()
+  ],
+  picoos: [
+    picoOsRow_0_1_1(),
+    picoOsRow_0_1_2(),
+    picoOsRow_0_2_2(),
+    picoOsRow_0_3_1(),
+    picoOsRow_0_4_90()
+  ]
+};
+export {
+  CAPABILITY_TABLE
+};
+//# sourceMappingURL=capability-data.js.map

package/dist/runtime/capability-data.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/capability-data.ts"],"sourcesContent":["/**\n * Versioned capability rows transcribed from the product matrix (`capability-matrix.template.md`).\n * visionOS **WSAppShell/1.5.0** & **1.6.0** & **1.7.0** & **1.8.0**; picoOS **PicoWebApp/0.1.1** & **0.1.2** & **0.2.2** & **0.3.1** & **0.4.90** — see matrix in OpenSpec / product docs.\n *\n * **picoOS** rows use dedicated builders (alpha2.0 / alpha2.1 subtokens); visionOS rows are separate.\n */\nimport { SUB_TOKENS_BY_NAME, TOP_LEVEL_KEYS } from './keys'\n\nexport type CapabilityVersionRow = {\n  /** Semver string from `WSAppShell` / `PicoWebApp` (see `review.md` §4). */\n  version: string\n  /** Top-level keys and `name:subToken` compound keys. */\n  flags: Record<string, boolean>\n}\n\nfunction baseTrueFlags(): Record<string, boolean> {\n  const flags: Record<string, boolean> = {}\n  for (const k of TOP_LEVEL_KEYS) {\n    flags[k] = true\n  }\n  for (const [name, toks] of Object.entries(SUB_TOKENS_BY_NAME)) {\n    for (const t of toks) {\n      flags[`${name}:${t}`] = true\n    }\n  }\n  return flags\n}\n\n/**\n * visionOS **WSAppShell/1.5.0**.\n * Model: only `ready`, `currentSrc`, `entityTransform` among tracked sub-tokens are Y; SpatialRotateEvent:constrainedToAxis Y.\n */\nfunction matrixVision_1_5_0_Flags(): Record<string, boolean> {\n  const flags = baseTrueFlags()\n  const modelNo = [\n    'autoplay',\n    'loop',\n    'stagemode',\n    'poster',\n    'loading',\n    'source',\n    'paused',\n    'duration',\n    'playbackRate',\n    'play',\n    'pause',\n    'currentTime',\n  ] as const\n  for (const t of modelNo) {\n    flags[`Model:${t}`] = false\n  }\n  flags['SpatialRotateEvent:constrainedToAxis'] = true\n  // Container useAnimation is not supported until WSAppShell/1.8.0.\n  flags['useAnimation'] = false\n  // Placement-shaped attachment protocol lands in picoOS PicoWebApp/0.4.90\n  // (OTA0); no visionOS shell decodes it yet.\n  flags['AttachmentEntity:placement'] = false\n  return flags\n}\n\n/**\n * visionOS **WSAppShell/1.6.0** — WebSpatial April / playback expansion (see product matrix).\n * Model: `stagemode`, `poster`, `loading`, `currentTime` remain N; rest of tracked Model sub-tokens Y.\n */\nfunction matrixVision_1_6_0_Flags(): Record<string, boolean> {\n  const flags = baseTrueFlags()\n  for (const t of ['stagemode', 'poster', 'loading', 'currentTime'] as const) {\n    flags[`Model:${t}`] = false\n  }\n  flags['SpatialRotateEvent:constrainedToAxis'] = true\n  // Container useAnimation is not supported until WSAppShell/1.8.0.\n  flags['useAnimation'] = false\n  // Placement-shaped attachment protocol lands in picoOS PicoWebApp/0.4.90\n  // (OTA0); no visionOS shell decodes it yet.\n  flags['AttachmentEntity:placement'] = false\n  return flags\n}\n\n/**\n * visionOS **WSAppShell/1.7.0** — entity transform animation support.\n * Container `useAnimation` remains unavailable in this row.\n */\nfunction matrixVision_1_7_0_Flags(): Record<string, boolean> {\n  const flags = matrixVision_1_6_0_Flags()\n  flags['Model:currentTime'] = true\n  flags['Model:loading'] = true\n  flags['Model:poster'] = true\n  return flags\n}\n\n/**\n * visionOS **WSAppShell/1.8.0**.\n */\nfunction matrixVision_1_8_0_Flags(): Record<string, boolean> {\n  const flags = matrixVision_1_7_0_Flags()\n  flags['useAnimation'] = true\n  return flags\n}\n\n/**\n * picoOS **PicoWebApp/0.1.1** — alpha2.0 baseline (product matrix).\n * WindowScene / VolumeScene / Material subtokens Y; Model sub-tokens per matrix; **`xrInnerDepth` / `xrOuterDepth` N**.\n */\nfunction matrixPico_0_1_1_Flags(): Record<string, boolean> {\n  const flags = matrixVision_1_5_0_Flags()\n  flags.xrInnerDepth = false\n  flags.xrOuterDepth = false\n  return flags\n}\n\n/**\n * picoOS **PicoWebApp/0.1.2** — beta2.0 playback expansion (product matrix).\n * **`xrInnerDepth` / `xrOuterDepth` N** (same as 0.1.1).\n */\nfunction matrixPico_0_1_2_Flags(): Record<string, boolean> {\n  const flags = matrixVision_1_6_0_Flags()\n  flags.xrInnerDepth = false\n  flags.xrOuterDepth = false\n  flags['Model:currentTime'] = true\n  flags['Model:poster'] = true\n  return flags\n}\n\n/**\n * picoOS **PicoWebApp/0.2.2** — entity transform animation support.\n * Container `useAnimation` remains unavailable in this row.\n */\nfunction matrixPico_0_2_2_Flags(): Record<string, boolean> {\n  const flags = matrixPico_0_1_2_Flags()\n  return flags\n}\n\n/**\n * picoOS **PicoWebApp/0.3.1** — beta2.1\n */\nfunction matrixPico_0_3_1_Flags(): Record<string, boolean> {\n  const flags = matrixPico_0_2_2_Flags()\n  flags['Model:loading'] = true\n  return flags\n}\n\n/**\n * picoOS **PicoWebApp/0.4.90** — OTA0 container animation support.\n */\nfunction matrixPico_0_4_90_Flags(): Record<string, boolean> {\n  const flags = matrixPico_0_3_1_Flags()\n  flags['useAnimation'] = true\n  flags['AttachmentEntity:placement'] = true\n  return flags\n}\n\nfunction visionOsRow_1_5_0(): CapabilityVersionRow {\n  return { version: '1.5.0', flags: matrixVision_1_5_0_Flags() }\n}\n\nfunction visionOsRow_1_6_0(): CapabilityVersionRow {\n  return { version: '1.6.0', flags: matrixVision_1_6_0_Flags() }\n}\n\nfunction visionOsRow_1_7_0(): CapabilityVersionRow {\n  return { version: '1.7.0', flags: matrixVision_1_7_0_Flags() }\n}\n\n/**\n * Build the capability row for visionOS **WSAppShell/1.8.0**.\n */\nfunction visionOsRow_1_8_0(): CapabilityVersionRow {\n  return { version: '1.8.0', flags: matrixVision_1_8_0_Flags() }\n}\n\nfunction picoOsRow_0_1_1(): CapabilityVersionRow {\n  return { version: '0.1.1', flags: matrixPico_0_1_1_Flags() }\n}\n\n// Pico OS 6.0 Beta 2.0\nfunction picoOsRow_0_1_2(): CapabilityVersionRow {\n  return { version: '0.1.2', flags: matrixPico_0_1_2_Flags() }\n}\n\nfunction picoOsRow_0_2_2(): CapabilityVersionRow {\n  return { version: '0.2.2', flags: matrixPico_0_2_2_Flags() }\n}\n\n// Pico OS 6.0 Beta 2.1\nfunction picoOsRow_0_3_1(): CapabilityVersionRow {\n  return { version: '0.3.1', flags: matrixPico_0_3_1_Flags() }\n}\n\n/**\n * Build the capability row for picoOS **PicoWebApp/0.4.90** OTA0.\n */\nfunction picoOsRow_0_4_90(): CapabilityVersionRow {\n  return { version: '0.4.90', flags: matrixPico_0_4_90_Flags() }\n}\n\nexport const CAPABILITY_TABLE: {\n  visionos: CapabilityVersionRow[]\n  picoos: CapabilityVersionRow[]\n} = {\n  visionos: [\n    visionOsRow_1_5_0(),\n    visionOsRow_1_6_0(),\n    visionOsRow_1_7_0(),\n    visionOsRow_1_8_0(),\n  ],\n  picoos: [\n    picoOsRow_0_1_1(),\n    picoOsRow_0_1_2(),\n    picoOsRow_0_2_2(),\n    picoOsRow_0_3_1(),\n    picoOsRow_0_4_90(),\n  ],\n}\n"],"mappings":"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","names":[]}

package/dist/runtime/index.d.ts

@@ -0,0 +1,8 @@
+export { WebSpatialRuntimeSnapshot, WebSpatialRuntimeType } from './types.js';
+export { WebSpatialRuntimeError } from './WebSpatialRuntimeError.js';
+export { VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER, getRuntime, resetRuntimeCacheForTests, supports } from './supports.js';
+export { compareSemver, parseSemverOrNull } from './semver.js';
+export { computeRuntimeFromUserAgent, parseShellToken } from './userAgent.js';
+export { JsbAdapterPlatformKind, resolveJsbAdapterPlatform } from './jsbAdapterPlatform.js';
+export { CAPABILITY_TABLE, CapabilityVersionRow } from './capability-data.js';
+export { CapabilityKey } from './keys.js';

package/dist/runtime/index.js

@@ -0,0 +1,27 @@
+import { WebSpatialRuntimeError } from "./WebSpatialRuntimeError";
+import {
+  supports,
+  getRuntime,
+  resetRuntimeCacheForTests,
+  VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER
+} from "./supports";
+import { compareSemver, parseSemverOrNull } from "./semver";
+import { computeRuntimeFromUserAgent, parseShellToken } from "./userAgent";
+import {
+  resolveJsbAdapterPlatform
+} from "./jsbAdapterPlatform";
+import { CAPABILITY_TABLE } from "./capability-data";
+export {
+  CAPABILITY_TABLE,
+  VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER,
+  WebSpatialRuntimeError,
+  compareSemver,
+  computeRuntimeFromUserAgent,
+  getRuntime,
+  parseSemverOrNull,
+  parseShellToken,
+  resetRuntimeCacheForTests,
+  resolveJsbAdapterPlatform,
+  supports
+};
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/index.ts"],"sourcesContent":["export type { WebSpatialRuntimeSnapshot, WebSpatialRuntimeType } from './types'\nexport { WebSpatialRuntimeError } from './WebSpatialRuntimeError'\nexport {\n  supports,\n  getRuntime,\n  resetRuntimeCacheForTests,\n  VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER,\n} from './supports'\nexport { compareSemver, parseSemverOrNull } from './semver'\nexport { computeRuntimeFromUserAgent, parseShellToken } from './userAgent'\nexport {\n  resolveJsbAdapterPlatform,\n  type JsbAdapterPlatformKind,\n} from './jsbAdapterPlatform'\nexport type { CapabilityVersionRow } from './capability-data'\nexport { CAPABILITY_TABLE } from './capability-data'\nexport type { CapabilityKey } from './keys'\n"],"mappings":"AACA,SAAS,8BAA8B;AACvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,eAAe,yBAAyB;AACjD,SAAS,6BAA6B,uBAAuB;AAC7D;AAAA,EACE;AAAA,OAEK;AAEP,SAAS,wBAAwB;","names":[]}

package/dist/runtime/jsbAdapterPlatform.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Which native JSB / protocol adapter to load in the browser.
+ * Derived from {@link computeRuntimeFromUserAgent} plus legacy fallbacks
+ * (Pico WebSpatial semver gate; otherwise default visionOS shell).
+ */
+type JsbAdapterPlatformKind = 'puppeteer' | 'picoos' | 'visionos';
+declare function resolveJsbAdapterPlatform(userAgent: string): JsbAdapterPlatformKind;
+
+export { type JsbAdapterPlatformKind, resolveJsbAdapterPlatform };

package/dist/runtime/jsbAdapterPlatform.js

@@ -0,0 +1,38 @@
+import { computeRuntimeFromUserAgent } from "./userAgent";
+function getWebSpatialVersion(ua) {
+  const match = ua.match(/WebSpatial\/(\d+)\.(\d+)\.(\d+)/);
+  if (!match) {
+    return null;
+  }
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function isVersionGreater(a, b) {
+  if (!a) {
+    return false;
+  }
+  for (let index = 0; index < 3; index += 1) {
+    const diff = a[index] - b[index];
+    if (diff > 0) {
+      return true;
+    }
+    if (diff < 0) {
+      return false;
+    }
+  }
+  return false;
+}
+function resolveJsbAdapterPlatform(userAgent) {
+  const rt = computeRuntimeFromUserAgent(userAgent);
+  if (rt.type === "puppeteer") {
+    return "puppeteer";
+  }
+  const webSpatialVersion = getWebSpatialVersion(userAgent);
+  if (userAgent.includes("PicoWebApp") && isVersionGreater(webSpatialVersion, [0, 0, 1])) {
+    return "picoos";
+  }
+  return "visionos";
+}
+export {
+  resolveJsbAdapterPlatform
+};
+//# sourceMappingURL=jsbAdapterPlatform.js.map

package/dist/runtime/jsbAdapterPlatform.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/jsbAdapterPlatform.ts"],"sourcesContent":["import { computeRuntimeFromUserAgent } from './userAgent'\n\nfunction getWebSpatialVersion(ua: string): number[] | null {\n  const match = ua.match(/WebSpatial\\/(\\d+)\\.(\\d+)\\.(\\d+)/)\n  if (!match) {\n    return null\n  }\n  return [Number(match[1]), Number(match[2]), Number(match[3])]\n}\n\nfunction isVersionGreater(a: number[] | null, b: number[]): boolean {\n  if (!a) {\n    return false\n  }\n  for (let index = 0; index < 3; index += 1) {\n    const diff = a[index] - b[index]\n    if (diff > 0) {\n      return true\n    }\n    if (diff < 0) {\n      return false\n    }\n  }\n  return false\n}\n\n/**\n * Which native JSB / protocol adapter to load in the browser.\n * Derived from {@link computeRuntimeFromUserAgent} plus legacy fallbacks\n * (Pico WebSpatial semver gate; otherwise default visionOS shell).\n */\nexport type JsbAdapterPlatformKind = 'puppeteer' | 'picoos' | 'visionos'\n\nexport function resolveJsbAdapterPlatform(\n  userAgent: string,\n): JsbAdapterPlatformKind {\n  const rt = computeRuntimeFromUserAgent(userAgent)\n  if (rt.type === 'puppeteer') {\n    return 'puppeteer'\n  }\n\n  const webSpatialVersion = getWebSpatialVersion(userAgent)\n  if (\n    userAgent.includes('PicoWebApp') &&\n    isVersionGreater(webSpatialVersion, [0, 0, 1])\n  ) {\n    return 'picoos'\n  }\n\n  return 'visionos'\n}\n"],"mappings":"AAAA,SAAS,mCAAmC;AAE5C,SAAS,qBAAqB,IAA6B;AACzD,QAAM,QAAQ,GAAG,MAAM,iCAAiC;AACxD,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AACA,SAAO,CAAC,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC;AAC9D;AAEA,SAAS,iBAAiB,GAAoB,GAAsB;AAClE,MAAI,CAAC,GAAG;AACN,WAAO;AAAA,EACT;AACA,WAAS,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG;AACzC,UAAM,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK;AAC/B,QAAI,OAAO,GAAG;AACZ,aAAO;AAAA,IACT;AACA,QAAI,OAAO,GAAG;AACZ,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AASO,SAAS,0BACd,WACwB;AACxB,QAAM,KAAK,4BAA4B,SAAS;AAChD,MAAI,GAAG,SAAS,aAAa;AAC3B,WAAO;AAAA,EACT;AAEA,QAAM,oBAAoB,qBAAqB,SAAS;AACxD,MACE,UAAU,SAAS,YAAY,KAC/B,iBAAiB,mBAAmB,CAAC,GAAG,GAAG,CAAC,CAAC,GAC7C;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;","names":[]}

package/dist/runtime/keys.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Canonical `supports(name)` key registry (OpenSpec `review.md` §3).
+ * Aliases are normalized before lookup (see `normalizeCapabilityName`).
+ *
+ * @internal SDK contract data — not part of the public `@webspatial/react-sdk`
+ * surface. Import via `@webspatial/core-sdk/runtime/keys` only for SDK demos,
+ * contract tests, and capability-matrix tooling.
+ */
+declare const COMPONENT_KEYS: readonly ["Model", "Reality", "Entity", "BoxEntity", "SphereEntity", "ConeEntity", "CylinderEntity", "PlaneEntity", "SceneGraph", "ModelAsset", "ModelEntity", "UnlitMaterial", "Material", "AttachmentAsset", "AttachmentEntity"];
+declare const CSS_KEYS: readonly ["-xr-background-material", "-xr-back", "-xr-depth", "-xr-transform"];
+declare const GESTURE_KEYS: readonly ["SpatialTapEvent", "SpatialDragStartEvent", "SpatialDragEvent", "SpatialDragEndEvent", "SpatialRotateEvent", "SpatialRotateEndEvent", "SpatialMagnifyEvent", "SpatialMagnifyEndEvent"];
+declare const ANIMATION_KEYS: readonly ["useAnimation"];
+declare const JS_SCENE_KEYS: readonly ["useMetrics", "convertCoordinate", "initScene", "WindowScene", "VolumeScene"];
+/**
+ * Spatialized container `ref` readbacks (`HTMLElement` / React `useDomProxy` Proxy).
+ * See `global.d.ts` (`HTMLElement`) and `useDomProxy.ts` (`has` / `get` traps).
+ */
+declare const ELEMENT_DOM_DEPTH_KEYS: readonly ["xrClientDepth", "xrOffsetBack"];
+/**
+ * Scene / global readbacks on `Window` (`global.d.ts` → `Window`).
+ */
+declare const WINDOW_DOM_DEPTH_KEYS: readonly ["xrInnerDepth", "xrOuterDepth"];
+declare const DOM_DEPTH_KEYS: readonly ["xrClientDepth", "xrOffsetBack", "xrInnerDepth", "xrOuterDepth"];
+/** Top-level names accepted by `supports(name)` (canonical keys after alias normalization). */
+declare const TOP_LEVEL_KEYS: readonly ["Model", "Reality", "Entity", "BoxEntity", "SphereEntity", "ConeEntity", "CylinderEntity", "PlaneEntity", "SceneGraph", "ModelAsset", "ModelEntity", "UnlitMaterial", "Material", "AttachmentAsset", "AttachmentEntity", "-xr-background-material", "-xr-back", "-xr-depth", "-xr-transform", "SpatialTapEvent", "SpatialDragStartEvent", "SpatialDragEvent", "SpatialDragEndEvent", "SpatialRotateEvent", "SpatialRotateEndEvent", "SpatialMagnifyEvent", "SpatialMagnifyEndEvent", "useAnimation", "useMetrics", "convertCoordinate", "initScene", "WindowScene", "VolumeScene", "xrClientDepth", "xrOffsetBack", "xrInnerDepth", "xrOuterDepth"];
+/** Union of documented capability keys; unknown strings may still be passed to `supports` (returns `false`). */
+type CapabilityKey = (typeof TOP_LEVEL_KEYS)[number];
+declare function normalizeCapabilityName(name: string): string;
+/** Known sub-tokens per canonical top-level `name` (AND semantics). */
+declare const SUB_TOKENS_BY_NAME: Readonly<Record<string, readonly string[]>>;
+declare function isKnownTopLevel(name: string): boolean;
+declare function isKnownSubToken(name: string, token: string): boolean;
+
+export { ANIMATION_KEYS, COMPONENT_KEYS, CSS_KEYS, type CapabilityKey, DOM_DEPTH_KEYS, ELEMENT_DOM_DEPTH_KEYS, GESTURE_KEYS, JS_SCENE_KEYS, SUB_TOKENS_BY_NAME, TOP_LEVEL_KEYS, WINDOW_DOM_DEPTH_KEYS, isKnownSubToken, isKnownTopLevel, normalizeCapabilityName };

package/dist/runtime/keys.js

@@ -0,0 +1,122 @@
+const COMPONENT_KEYS = [
+  "Model",
+  "Reality",
+  "Entity",
+  "BoxEntity",
+  "SphereEntity",
+  "ConeEntity",
+  "CylinderEntity",
+  "PlaneEntity",
+  "SceneGraph",
+  "ModelAsset",
+  "ModelEntity",
+  "UnlitMaterial",
+  "Material",
+  "AttachmentAsset",
+  "AttachmentEntity"
+];
+const CSS_KEYS = [
+  "-xr-background-material",
+  "-xr-back",
+  "-xr-depth",
+  "-xr-transform"
+];
+const GESTURE_KEYS = [
+  "SpatialTapEvent",
+  "SpatialDragStartEvent",
+  "SpatialDragEvent",
+  "SpatialDragEndEvent",
+  "SpatialRotateEvent",
+  "SpatialRotateEndEvent",
+  "SpatialMagnifyEvent",
+  "SpatialMagnifyEndEvent"
+];
+const ANIMATION_KEYS = ["useAnimation"];
+const JS_SCENE_KEYS = [
+  "useMetrics",
+  "convertCoordinate",
+  "initScene",
+  "WindowScene",
+  "VolumeScene"
+];
+const ELEMENT_DOM_DEPTH_KEYS = ["xrClientDepth", "xrOffsetBack"];
+const WINDOW_DOM_DEPTH_KEYS = ["xrInnerDepth", "xrOuterDepth"];
+const DOM_DEPTH_KEYS = [
+  ...ELEMENT_DOM_DEPTH_KEYS,
+  ...WINDOW_DOM_DEPTH_KEYS
+];
+const TOP_LEVEL_KEYS = [
+  ...COMPONENT_KEYS,
+  ...CSS_KEYS,
+  ...GESTURE_KEYS,
+  ...ANIMATION_KEYS,
+  ...JS_SCENE_KEYS,
+  ...DOM_DEPTH_KEYS
+];
+const ALIAS_TO_CANONICAL = {
+  Box: "BoxEntity",
+  Sphere: "SphereEntity",
+  Cone: "ConeEntity",
+  Cylinder: "CylinderEntity",
+  Plane: "PlaneEntity",
+  World: "SceneGraph"
+};
+function normalizeCapabilityName(name) {
+  return ALIAS_TO_CANONICAL[name] ?? name;
+}
+const SUB_TOKENS_BY_NAME = {
+  Material: ["unlit"],
+  WindowScene: ["defaultSize", "resizability"],
+  VolumeScene: [
+    "defaultSize",
+    "resizability",
+    "worldScaling",
+    "worldAlignment",
+    "baseplateVisibility"
+  ],
+  SpatialRotateEvent: ["constrainedToAxis"],
+  // Placement-shaped attachment JSB protocol (placementId + Vec3 transform +
+  // meter width/height). Runtimes without it take the legacy payload
+  // (parentEntityId + tuple position + point size).
+  AttachmentEntity: ["placement"],
+  Model: [
+    "autoplay",
+    "loop",
+    "stagemode",
+    "poster",
+    "loading",
+    "source",
+    "ready",
+    "currentSrc",
+    "entityTransform",
+    "paused",
+    "duration",
+    "playbackRate",
+    "play",
+    "pause",
+    "currentTime"
+  ]
+};
+function isKnownTopLevel(name) {
+  return TOP_LEVEL_KEYS.includes(name);
+}
+function isKnownSubToken(name, token) {
+  const allowed = SUB_TOKENS_BY_NAME[name];
+  return allowed !== void 0 && allowed.includes(token);
+}
+export {
+  ANIMATION_KEYS,
+  COMPONENT_KEYS,
+  CSS_KEYS,
+  DOM_DEPTH_KEYS,
+  ELEMENT_DOM_DEPTH_KEYS,
+  GESTURE_KEYS,
+  JS_SCENE_KEYS,
+  SUB_TOKENS_BY_NAME,
+  TOP_LEVEL_KEYS,
+  WINDOW_DOM_DEPTH_KEYS,
+  isKnownSubToken,
+  isKnownTopLevel,
+  normalizeCapabilityName
+};
+//# sourceMappingURL=keys.js.map

package/dist/runtime/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/keys.ts"],"sourcesContent":["/**\n * Canonical `supports(name)` key registry (OpenSpec `review.md` §3).\n * Aliases are normalized before lookup (see `normalizeCapabilityName`).\n *\n * @internal SDK contract data — not part of the public `@webspatial/react-sdk`\n * surface. Import via `@webspatial/core-sdk/runtime/keys` only for SDK demos,\n * contract tests, and capability-matrix tooling.\n */\n\nexport const COMPONENT_KEYS = [\n  'Model',\n  'Reality',\n  'Entity',\n  'BoxEntity',\n  'SphereEntity',\n  'ConeEntity',\n  'CylinderEntity',\n  'PlaneEntity',\n  'SceneGraph',\n  'ModelAsset',\n  'ModelEntity',\n  'UnlitMaterial',\n  'Material',\n  'AttachmentAsset',\n  'AttachmentEntity',\n] as const\n\nexport const CSS_KEYS = [\n  '-xr-background-material',\n  '-xr-back',\n  '-xr-depth',\n  '-xr-transform',\n] as const\n\nexport const GESTURE_KEYS = [\n  'SpatialTapEvent',\n  'SpatialDragStartEvent',\n  'SpatialDragEvent',\n  'SpatialDragEndEvent',\n  'SpatialRotateEvent',\n  'SpatialRotateEndEvent',\n  'SpatialMagnifyEvent',\n  'SpatialMagnifyEndEvent',\n] as const\n\nexport const ANIMATION_KEYS = ['useAnimation'] as const\n\nexport const JS_SCENE_KEYS = [\n  'useMetrics',\n  'convertCoordinate',\n  'initScene',\n  'WindowScene',\n  'VolumeScene',\n] as const\n\n/**\n * Spatialized container `ref` readbacks (`HTMLElement` / React `useDomProxy` Proxy).\n * See `global.d.ts` (`HTMLElement`) and `useDomProxy.ts` (`has` / `get` traps).\n */\nexport const ELEMENT_DOM_DEPTH_KEYS = ['xrClientDepth', 'xrOffsetBack'] as const\n\n/**\n * Scene / global readbacks on `Window` (`global.d.ts` → `Window`).\n */\nexport const WINDOW_DOM_DEPTH_KEYS = ['xrInnerDepth', 'xrOuterDepth'] as const\n\nexport const DOM_DEPTH_KEYS = [\n  ...ELEMENT_DOM_DEPTH_KEYS,\n  ...WINDOW_DOM_DEPTH_KEYS,\n] as const\n\n/** Top-level names accepted by `supports(name)` (canonical keys after alias normalization). */\nexport const TOP_LEVEL_KEYS = [\n  ...COMPONENT_KEYS,\n  ...CSS_KEYS,\n  ...GESTURE_KEYS,\n  ...ANIMATION_KEYS,\n  ...JS_SCENE_KEYS,\n  ...DOM_DEPTH_KEYS,\n] as const\n\n/** Union of documented capability keys; unknown strings may still be passed to `supports` (returns `false`). */\nexport type CapabilityKey = (typeof TOP_LEVEL_KEYS)[number]\n\nconst ALIAS_TO_CANONICAL: Record<string, string> = {\n  Box: 'BoxEntity',\n  Sphere: 'SphereEntity',\n  Cone: 'ConeEntity',\n  Cylinder: 'CylinderEntity',\n  Plane: 'PlaneEntity',\n  World: 'SceneGraph',\n}\n\nexport function normalizeCapabilityName(name: string): string {\n  return ALIAS_TO_CANONICAL[name] ?? name\n}\n\n/** Known sub-tokens per canonical top-level `name` (AND semantics). */\nexport const SUB_TOKENS_BY_NAME: Readonly<Record<string, readonly string[]>> = {\n  Material: ['unlit'],\n  WindowScene: ['defaultSize', 'resizability'],\n  VolumeScene: [\n    'defaultSize',\n    'resizability',\n    'worldScaling',\n    'worldAlignment',\n    'baseplateVisibility',\n  ],\n  SpatialRotateEvent: ['constrainedToAxis'],\n  // Placement-shaped attachment JSB protocol (placementId + Vec3 transform +\n  // meter width/height). Runtimes without it take the legacy payload\n  // (parentEntityId + tuple position + point size).\n  AttachmentEntity: ['placement'],\n  Model: [\n    'autoplay',\n    'loop',\n    'stagemode',\n    'poster',\n    'loading',\n    'source',\n    'ready',\n    'currentSrc',\n    'entityTransform',\n    'paused',\n    'duration',\n    'playbackRate',\n    'play',\n    'pause',\n    'currentTime',\n  ],\n}\n\nexport function isKnownTopLevel(name: string): boolean {\n  return (TOP_LEVEL_KEYS as readonly string[]).includes(name)\n}\n\nexport function isKnownSubToken(name: string, token: string): boolean {\n  const allowed = SUB_TOKENS_BY_NAME[name]\n  return allowed !== undefined && allowed.includes(token)\n}\n"],"mappings":"AASO,MAAM,iBAAiB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,WAAW;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,eAAe;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,iBAAiB,CAAC,cAAc;AAEtC,MAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAMO,MAAM,yBAAyB,CAAC,iBAAiB,cAAc;AAK/D,MAAM,wBAAwB,CAAC,gBAAgB,cAAc;AAE7D,MAAM,iBAAiB;AAAA,EAC5B,GAAG;AAAA,EACH,GAAG;AACL;AAGO,MAAM,iBAAiB;AAAA,EAC5B,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;AAKA,MAAM,qBAA6C;AAAA,EACjD,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO;AAAA,EACP,OAAO;AACT;AAEO,SAAS,wBAAwB,MAAsB;AAC5D,SAAO,mBAAmB,IAAI,KAAK;AACrC;AAGO,MAAM,qBAAkE;AAAA,EAC7E,UAAU,CAAC,OAAO;AAAA,EAClB,aAAa,CAAC,eAAe,cAAc;AAAA,EAC3C,aAAa;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,oBAAoB,CAAC,mBAAmB;AAAA;AAAA;AAAA;AAAA,EAIxC,kBAAkB,CAAC,WAAW;AAAA,EAC9B,OAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,gBAAgB,MAAuB;AACrD,SAAQ,eAAqC,SAAS,IAAI;AAC5D;AAEO,SAAS,gBAAgB,MAAc,OAAwB;AACpE,QAAM,UAAU,mBAAmB,IAAI;AACvC,SAAO,YAAY,UAAa,QAAQ,SAAS,KAAK;AACxD;","names":[]}

package/dist/runtime/semver.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Minimal semver compare for capability table rows (`major.minor.patch`).
+ * Returns negative if a < b, zero if equal, positive if a > b.
+ */
+declare function compareSemver(a: string, b: string): number;
+declare function parseSemverOrNull(v: string): string | null;
+
+export { compareSemver, parseSemverOrNull };

package/dist/runtime/semver.js

@@ -0,0 +1,32 @@
+function compareSemver(a, b) {
+  const pa = parseSemverParts(a);
+  const pb = parseSemverParts(b);
+  if (!pa || !pb) {
+    return String(a).localeCompare(String(b));
+  }
+  const len = Math.max(pa.length, pb.length);
+  for (let i = 0; i < len; i++) {
+    const da = pa[i] ?? 0;
+    const db = pb[i] ?? 0;
+    if (da !== db) return da - db;
+  }
+  return 0;
+}
+function parseSemverParts(v) {
+  const m = /^(\d+)(?:\.(\d+)(?:\.(\d+))?)?/.exec(v.trim());
+  if (!m) return null;
+  const major = Number(m[1]);
+  const minor = m[2] !== void 0 ? Number(m[2]) : 0;
+  const patch = m[3] !== void 0 ? Number(m[3]) : 0;
+  if ([major, minor, patch].some((n) => Number.isNaN(n))) return null;
+  return [major, minor, patch];
+}
+function parseSemverOrNull(v) {
+  const m = /^(\d+(?:\.\d+){0,2})/.exec(v.trim());
+  return m ? m[1] : null;
+}
+export {
+  compareSemver,
+  parseSemverOrNull
+};
+//# sourceMappingURL=semver.js.map

package/dist/runtime/semver.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/semver.ts"],"sourcesContent":["/**\n * Minimal semver compare for capability table rows (`major.minor.patch`).\n * Returns negative if a < b, zero if equal, positive if a > b.\n */\nexport function compareSemver(a: string, b: string): number {\n  const pa = parseSemverParts(a)\n  const pb = parseSemverParts(b)\n  if (!pa || !pb) {\n    return String(a).localeCompare(String(b))\n  }\n  const len = Math.max(pa.length, pb.length)\n  for (let i = 0; i < len; i++) {\n    const da = pa[i] ?? 0\n    const db = pb[i] ?? 0\n    if (da !== db) return da - db\n  }\n  return 0\n}\n\nfunction parseSemverParts(v: string): number[] | null {\n  const m = /^(\\d+)(?:\\.(\\d+)(?:\\.(\\d+))?)?/.exec(v.trim())\n  if (!m) return null\n  const major = Number(m[1])\n  const minor = m[2] !== undefined ? Number(m[2]) : 0\n  const patch = m[3] !== undefined ? Number(m[3]) : 0\n  if ([major, minor, patch].some(n => Number.isNaN(n))) return null\n  return [major, minor, patch]\n}\n\nexport function parseSemverOrNull(v: string): string | null {\n  const m = /^(\\d+(?:\\.\\d+){0,2})/.exec(v.trim())\n  return m ? m[1] : null\n}\n"],"mappings":"AAIO,SAAS,cAAc,GAAW,GAAmB;AAC1D,QAAM,KAAK,iBAAiB,CAAC;AAC7B,QAAM,KAAK,iBAAiB,CAAC;AAC7B,MAAI,CAAC,MAAM,CAAC,IAAI;AACd,WAAO,OAAO,CAAC,EAAE,cAAc,OAAO,CAAC,CAAC;AAAA,EAC1C;AACA,QAAM,MAAM,KAAK,IAAI,GAAG,QAAQ,GAAG,MAAM;AACzC,WAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,UAAM,KAAK,GAAG,CAAC,KAAK;AACpB,UAAM,KAAK,GAAG,CAAC,KAAK;AACpB,QAAI,OAAO,GAAI,QAAO,KAAK;AAAA,EAC7B;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,GAA4B;AACpD,QAAM,IAAI,iCAAiC,KAAK,EAAE,KAAK,CAAC;AACxD,MAAI,CAAC,EAAG,QAAO;AACf,QAAM,QAAQ,OAAO,EAAE,CAAC,CAAC;AACzB,QAAM,QAAQ,EAAE,CAAC,MAAM,SAAY,OAAO,EAAE,CAAC,CAAC,IAAI;AAClD,QAAM,QAAQ,EAAE,CAAC,MAAM,SAAY,OAAO,EAAE,CAAC,CAAC,IAAI;AAClD,MAAI,CAAC,OAAO,OAAO,KAAK,EAAE,KAAK,OAAK,OAAO,MAAM,CAAC,CAAC,EAAG,QAAO;AAC7D,SAAO,CAAC,OAAO,OAAO,KAAK;AAC7B;AAEO,SAAS,kBAAkB,GAA0B;AAC1D,QAAM,IAAI,uBAAuB,KAAK,EAAE,KAAK,CAAC;AAC9C,SAAO,IAAI,EAAE,CAAC,IAAI;AACpB;","names":[]}

package/dist/runtime/supports.d.ts

@@ -0,0 +1,22 @@
+import { WebSpatialRuntimeSnapshot } from './types.js';
+import { CapabilityKey } from './keys.js';
+
+/**
+ * Unsubstituted shell version placeholder from visionOS manifest / Xcode template
+ * (`manifest.swift`). When still present in `WSAppShell/<version>`, treat as debug
+ * build: {@link supports} returns true for every valid capability query.
+ */
+declare const VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER = "WS_SHELL_VERSION";
+/** Test helper: clear cached UA/runtime snapshot between Vitest cases. */
+declare function resetRuntimeCacheForTests(): void;
+/**
+ * Internal runtime snapshot (not part of the public `@webspatial/react-sdk` surface).
+ */
+declare function getRuntime(): WebSpatialRuntimeSnapshot;
+/**
+ * Public capability probe (`WebSpatialRuntime.supports` re-exports this from React SDK).
+ */
+declare function supports(name: CapabilityKey, tokens?: readonly string[]): boolean;
+declare function supports(name: string, tokens?: readonly string[]): boolean;
+
+export { VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER, getRuntime, resetRuntimeCacheForTests, supports };

package/dist/runtime/supports.js

@@ -0,0 +1,78 @@
+import { CAPABILITY_TABLE } from "./capability-data";
+import { compareSemver, parseSemverOrNull } from "./semver";
+import { computeRuntimeFromUserAgent } from "./userAgent";
+import {
+  isKnownSubToken,
+  isKnownTopLevel,
+  normalizeCapabilityName
+} from "./keys";
+const VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER = "WS_SHELL_VERSION";
+let runtimeCache;
+function resetRuntimeCacheForTests() {
+  runtimeCache = void 0;
+}
+function getRuntime() {
+  if (runtimeCache !== void 0) return runtimeCache;
+  if (typeof navigator === "undefined") {
+    runtimeCache = { type: null, shellVersion: null };
+    return runtimeCache;
+  }
+  runtimeCache = computeRuntimeFromUserAgent(navigator.userAgent);
+  return runtimeCache;
+}
+function selectRow(type, shellVersion) {
+  const norm = parseSemverOrNull(shellVersion);
+  if (!norm) return null;
+  const rows = CAPABILITY_TABLE[type];
+  if (!rows.length) return null;
+  const sorted = [...rows].sort((a, b) => compareSemver(a.version, b.version));
+  const minV = sorted[0].version;
+  if (compareSemver(norm, minV) < 0) return null;
+  let chosen = null;
+  for (const row of sorted) {
+    if (compareSemver(row.version, norm) <= 0) {
+      chosen = row;
+    } else {
+      break;
+    }
+  }
+  return chosen;
+}
+function supports(name, tokens) {
+  if (typeof name !== "string") return false;
+  const canonical = normalizeCapabilityName(name);
+  if (!isKnownTopLevel(canonical)) return false;
+  const tokList = tokens === void 0 ? [] : Array.isArray(tokens) ? [...tokens] : [];
+  if (tokList.some((t) => typeof t !== "string")) return false;
+  for (const t of tokList) {
+    if (!isKnownSubToken(canonical, t)) return false;
+  }
+  const rt = getRuntime();
+  if (rt.type === "puppeteer") {
+    return true;
+  }
+  if (rt.type === null) return false;
+  if (rt.shellVersion === null) return false;
+  if (rt.type === "visionos" && rt.shellVersion === VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER) {
+    return true;
+  }
+  const parsedShell = parseSemverOrNull(rt.shellVersion);
+  if (!parsedShell) return false;
+  if (rt.type !== "visionos" && rt.type !== "picoos") return false;
+  const row = selectRow(rt.type, parsedShell);
+  if (!row) return false;
+  if (tokList.length === 0) {
+    return row.flags[canonical] === true;
+  }
+  if (row.flags[canonical] !== true) {
+    return false;
+  }
+  return tokList.every((t) => row.flags[`${canonical}:${t}`] === true);
+}
+export {
+  VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER,
+  getRuntime,
+  resetRuntimeCacheForTests,
+  supports
+};
+//# sourceMappingURL=supports.js.map

package/dist/runtime/supports.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/supports.ts"],"sourcesContent":["import { CAPABILITY_TABLE, type CapabilityVersionRow } from './capability-data'\nimport { compareSemver, parseSemverOrNull } from './semver'\nimport type { WebSpatialRuntimeSnapshot } from './types'\nimport { computeRuntimeFromUserAgent } from './userAgent'\nimport {\n  type CapabilityKey,\n  isKnownSubToken,\n  isKnownTopLevel,\n  normalizeCapabilityName,\n} from './keys'\n\n/**\n * Unsubstituted shell version placeholder from visionOS manifest / Xcode template\n * (`manifest.swift`). When still present in `WSAppShell/<version>`, treat as debug\n * build: {@link supports} returns true for every valid capability query.\n */\nexport const VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER = 'WS_SHELL_VERSION'\n\nlet runtimeCache: WebSpatialRuntimeSnapshot | undefined\n\n/** Test helper: clear cached UA/runtime snapshot between Vitest cases. */\nexport function resetRuntimeCacheForTests(): void {\n  runtimeCache = undefined\n}\n\n/**\n * Internal runtime snapshot (not part of the public `@webspatial/react-sdk` surface).\n */\nexport function getRuntime(): WebSpatialRuntimeSnapshot {\n  if (runtimeCache !== undefined) return runtimeCache\n  if (typeof navigator === 'undefined') {\n    runtimeCache = { type: null, shellVersion: null }\n    return runtimeCache\n  }\n  runtimeCache = computeRuntimeFromUserAgent(navigator.userAgent)\n  return runtimeCache\n}\n\nfunction selectRow(\n  type: 'visionos' | 'picoos',\n  shellVersion: string,\n): CapabilityVersionRow | null {\n  const norm = parseSemverOrNull(shellVersion)\n  if (!norm) return null\n  const rows = CAPABILITY_TABLE[type]\n  if (!rows.length) return null\n  const sorted = [...rows].sort((a, b) => compareSemver(a.version, b.version))\n  const minV = sorted[0].version\n  if (compareSemver(norm, minV) < 0) return null\n\n  let chosen: CapabilityVersionRow | null = null\n  for (const row of sorted) {\n    if (compareSemver(row.version, norm) <= 0) {\n      chosen = row\n    } else {\n      break\n    }\n  }\n  return chosen\n}\n\n/**\n * Public capability probe (`WebSpatialRuntime.supports` re-exports this from React SDK).\n */\nexport function supports(\n  name: CapabilityKey,\n  tokens?: readonly string[],\n): boolean\nexport function supports(name: string, tokens?: readonly string[]): boolean\nexport function supports(name: string, tokens?: readonly string[]): boolean {\n  if (typeof name !== 'string') return false\n  const canonical = normalizeCapabilityName(name)\n  if (!isKnownTopLevel(canonical)) return false\n\n  const tokList =\n    tokens === undefined ? [] : Array.isArray(tokens) ? [...tokens] : []\n  if (tokList.some(t => typeof t !== 'string')) return false\n\n  for (const t of tokList) {\n    if (!isKnownSubToken(canonical, t)) return false\n  }\n\n  const rt = getRuntime()\n  if (rt.type === 'puppeteer') {\n    return true\n  }\n  if (rt.type === null) return false\n  if (rt.shellVersion === null) return false\n\n  if (\n    rt.type === 'visionos' &&\n    rt.shellVersion === VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER\n  ) {\n    return true\n  }\n\n  const parsedShell = parseSemverOrNull(rt.shellVersion)\n  if (!parsedShell) return false\n\n  if (rt.type !== 'visionos' && rt.type !== 'picoos') return false\n\n  const row = selectRow(rt.type, parsedShell)\n  if (!row) return false\n\n  if (tokList.length === 0) {\n    return row.flags[canonical] === true\n  }\n  if (row.flags[canonical] !== true) {\n    return false\n  }\n  return tokList.every(t => row.flags[`${canonical}:${t}`] === true)\n}\n"],"mappings":"AAAA,SAAS,wBAAmD;AAC5D,SAAS,eAAe,yBAAyB;AAEjD,SAAS,mCAAmC;AAC5C;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOA,MAAM,2CAA2C;AAExD,IAAI;AAGG,SAAS,4BAAkC;AAChD,iBAAe;AACjB;AAKO,SAAS,aAAwC;AACtD,MAAI,iBAAiB,OAAW,QAAO;AACvC,MAAI,OAAO,cAAc,aAAa;AACpC,mBAAe,EAAE,MAAM,MAAM,cAAc,KAAK;AAChD,WAAO;AAAA,EACT;AACA,iBAAe,4BAA4B,UAAU,SAAS;AAC9D,SAAO;AACT;AAEA,SAAS,UACP,MACA,cAC6B;AAC7B,QAAM,OAAO,kBAAkB,YAAY;AAC3C,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,OAAO,iBAAiB,IAAI;AAClC,MAAI,CAAC,KAAK,OAAQ,QAAO;AACzB,QAAM,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC;AAC3E,QAAM,OAAO,OAAO,CAAC,EAAE;AACvB,MAAI,cAAc,MAAM,IAAI,IAAI,EAAG,QAAO;AAE1C,MAAI,SAAsC;AAC1C,aAAW,OAAO,QAAQ;AACxB,QAAI,cAAc,IAAI,SAAS,IAAI,KAAK,GAAG;AACzC,eAAS;AAAA,IACX,OAAO;AACL;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAUO,SAAS,SAAS,MAAc,QAAqC;AAC1E,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,QAAM,YAAY,wBAAwB,IAAI;AAC9C,MAAI,CAAC,gBAAgB,SAAS,EAAG,QAAO;AAExC,QAAM,UACJ,WAAW,SAAY,CAAC,IAAI,MAAM,QAAQ,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;AACrE,MAAI,QAAQ,KAAK,OAAK,OAAO,MAAM,QAAQ,EAAG,QAAO;AAErD,aAAW,KAAK,SAAS;AACvB,QAAI,CAAC,gBAAgB,WAAW,CAAC,EAAG,QAAO;AAAA,EAC7C;AAEA,QAAM,KAAK,WAAW;AACtB,MAAI,GAAG,SAAS,aAAa;AAC3B,WAAO;AAAA,EACT;AACA,MAAI,GAAG,SAAS,KAAM,QAAO;AAC7B,MAAI,GAAG,iBAAiB,KAAM,QAAO;AAErC,MACE,GAAG,SAAS,cACZ,GAAG,iBAAiB,0CACpB;AACA,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,kBAAkB,GAAG,YAAY;AACrD,MAAI,CAAC,YAAa,QAAO;AAEzB,MAAI,GAAG,SAAS,cAAc,GAAG,SAAS,SAAU,QAAO;AAE3D,QAAM,MAAM,UAAU,GAAG,MAAM,WAAW;AAC1C,MAAI,CAAC,IAAK,QAAO;AAEjB,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO,IAAI,MAAM,SAAS,MAAM;AAAA,EAClC;AACA,MAAI,IAAI,MAAM,SAAS,MAAM,MAAM;AACjC,WAAO;AAAA,EACT;AACA,SAAO,QAAQ,MAAM,OAAK,IAAI,MAAM,GAAG,SAAS,IAAI,CAAC,EAAE,MAAM,IAAI;AACnE;","names":[]}

package/dist/runtime/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Internal runtime classification (see OpenSpec `review.md`).
+ * `puppeteer`: automation / test harness UA — not a product matrix row; see `supports()`.
+ */
+type WebSpatialRuntimeType = 'visionos' | 'picoos' | 'puppeteer' | null;
+/** Snapshot returned by internal `getRuntime()` (not a public app API). */
+type WebSpatialRuntimeSnapshot = {
+    type: WebSpatialRuntimeType;
+    shellVersion: string | null;
+};
+
+export type { WebSpatialRuntimeSnapshot, WebSpatialRuntimeType };

package/dist/runtime/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/runtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}