@webspatial/core-sdk 1.7.0 → 2.0.0

package/dist/types/animation.d.ts

@@ -0,0 +1,7 @@
+export { A as AnimateTransformCommand, a as AnimateTransformResult, b as AnimatedProps, c as AnimatedPropsInternal, d as AnimationApi, e as AnimationConfig, f as AnimationError, g as AnimationPlayState, F as Float4x4, ar as TimingFunction, as as TransformValues } from '../spatializedElementMotion-_0XWPQCE.js';
+import './motion/spatializedVisual.js';
+import './motion/spatializedPlayback.js';
+import './global.js';
+import '../physicalMetrics-W5uZ5xKb.js';
+import '../SpatialObject.js';
+import '../reality/component/SpatialComponent.js';

package/dist/types/animation.js

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

package/dist/types/animation.js.map

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

package/dist/types/global.d.ts

@@ -0,0 +1,38 @@
+import { P as PhysicalMetricsValueShape } from '../physicalMetrics-W5uZ5xKb.js';
+
+declare global {
+    const __WEBSPATIAL_CORE_SDK_VERSION__: string;
+    interface Window {
+        __WebSpatialData: {
+            androidNativeMessage: Function;
+            getNativeVersion: Function;
+        };
+        __SpatialWebEvent: Function;
+        webkit: any;
+        webspatialBridge: any;
+        webSpatial?: {
+            genToken?: () => string;
+        };
+        __webspatialShell__?: {
+            genToken?: () => string;
+        };
+        WebSpatailNativeVersion: string;
+        __webspatialsdk__?: {
+            'natvie-version'?: string;
+            'react-sdk-version'?: string;
+            'core-sdk-version'?: string;
+            physicalMetrics?: PhysicalMetricsValueShape;
+            pageEpoch?: string | number;
+        };
+        /** Present when `supports('xrInnerDepth')` is true; otherwise `undefined`. */
+        xrInnerDepth?: number;
+        /** Present when `supports('xrOuterDepth')` is true; otherwise `undefined`. */
+        xrOuterDepth?: number;
+    }
+    interface HTMLElement {
+        /** Present when `supports('xrOffsetBack')` is true for element readbacks. */
+        xrOffsetBack?: number;
+        /** Present when `supports('xrClientDepth')` is true for element readbacks. */
+        xrClientDepth?: number;
+    }
+}

package/dist/types/global.js

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

package/dist/types/global.js.map

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

package/dist/types/internal.d.ts

@@ -0,0 +1,7 @@
+export { aQ as SpatialSceneCreationOptionsInternal, aR as SpatialSceneState } from '../spatializedElementMotion-_0XWPQCE.js';
+import './motion/spatializedVisual.js';
+import './motion/spatializedPlayback.js';
+import './global.js';
+import '../physicalMetrics-W5uZ5xKb.js';
+import '../SpatialObject.js';
+import '../reality/component/SpatialComponent.js';

package/dist/types/internal.js

@@ -0,0 +1,12 @@
+var SpatialSceneState = /* @__PURE__ */ ((SpatialSceneState2) => {
+  SpatialSceneState2["idle"] = "idle";
+  SpatialSceneState2["pending"] = "pending";
+  SpatialSceneState2["willVisible"] = "willVisible";
+  SpatialSceneState2["visible"] = "visible";
+  SpatialSceneState2["fail"] = "fail";
+  return SpatialSceneState2;
+})(SpatialSceneState || {});
+export {
+  SpatialSceneState
+};
+//# sourceMappingURL=internal.js.map

package/dist/types/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/internal.ts"],"sourcesContent":["import { SpatialSceneCreationOptions, SpatialSceneType } from './types'\n\nexport type SpatialSceneCreationOptionsInternal =\n  SpatialSceneCreationOptions & {\n    type: SpatialSceneType\n  }\nexport enum SpatialSceneState {\n  idle = 'idle',\n  pending = 'pending',\n  willVisible = 'willVisible',\n  visible = 'visible',\n  fail = 'fail',\n}\n"],"mappings":"AAMO,IAAK,oBAAL,kBAAKA,uBAAL;AACL,EAAAA,mBAAA,UAAO;AACP,EAAAA,mBAAA,aAAU;AACV,EAAAA,mBAAA,iBAAc;AACd,EAAAA,mBAAA,aAAU;AACV,EAAAA,mBAAA,UAAO;AALG,SAAAA;AAAA,GAAA;","names":["SpatialSceneState"]}

package/dist/types/motion/index.d.ts

@@ -0,0 +1,7 @@
+export { SpatializedVisualTransform, SpatializedVisualValues } from './spatializedVisual.js';
+export { SpatializedPlaybackError } from './spatializedPlayback.js';
+export { aj as SpatializedMotionConfig, ak as SpatializedMotionKind, al as SpatializedMotionPlayState, am as SpatializedMotionSegmentConfig, an as SpatializedMotionTimelineConfig, ao as SpatializedPlaybackApi } from '../../spatializedElementMotion-_0XWPQCE.js';
+import '../global.js';
+import '../../physicalMetrics-W5uZ5xKb.js';
+import '../../SpatialObject.js';
+import '../../reality/component/SpatialComponent.js';

package/dist/types/motion/index.js

@@ -0,0 +1,3 @@
+export * from "./spatializedVisual";
+export * from "./spatializedPlayback";
+//# sourceMappingURL=index.js.map

package/dist/types/motion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/types/motion/index.ts"],"sourcesContent":["export * from './spatializedVisual'\nexport * from './spatializedPlayback'\nexport type {\n  SpatializedMotionKind,\n  SpatializedMotionSegmentConfig,\n  SpatializedMotionTimelineConfig,\n  SpatializedMotionConfig,\n  SpatializedMotionPlayState,\n  SpatializedPlaybackApi,\n} from './spatializedMotion'\n"],"mappings":"AAAA,cAAc;AACd,cAAc;","names":[]}

package/dist/types/motion/spatializedElementMotion.d.ts

@@ -0,0 +1,7 @@
+export { aL as ControlSpatializedElementAnimationCommand, aN as CreateSpatializedElementAnimationCommand, bk as SpatialAnimationStateChangedDetail, bl as SpatialAnimationStateChangedMsg, aM as SpatializedElementAnimationControlType } from '../../spatializedElementMotion-_0XWPQCE.js';
+import './spatializedVisual.js';
+import './spatializedPlayback.js';
+import '../global.js';
+import '../../physicalMetrics-W5uZ5xKb.js';
+import '../../SpatialObject.js';
+import '../../reality/component/SpatialComponent.js';

package/dist/types/motion/spatializedElementMotion.js

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

package/dist/types/motion/spatializedElementMotion.js.map

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

package/dist/types/motion/spatializedMotion.d.ts

@@ -0,0 +1,7 @@
+export { a$ as NormalizedSpatializedMotionConfig, bg as SPATIALIZED_MOTION_PROPERTIES, aj as SpatializedMotionConfig, bh as SpatializedMotionKeyframe, bi as SpatializedMotionKeyframeValues, ak as SpatializedMotionKind, al as SpatializedMotionPlayState, a_ as SpatializedMotionProperty, am as SpatializedMotionSegmentConfig, aO as SpatializedMotionTimeline, an as SpatializedMotionTimelineConfig, bj as SpatializedMotionTrack, ao as SpatializedPlaybackApi } from '../../spatializedElementMotion-_0XWPQCE.js';
+import './spatializedPlayback.js';
+import './spatializedVisual.js';
+import '../global.js';
+import '../../physicalMetrics-W5uZ5xKb.js';
+import '../../SpatialObject.js';
+import '../../reality/component/SpatialComponent.js';

package/dist/types/motion/spatializedMotion.js

@@ -0,0 +1,16 @@
+const SPATIALIZED_MOTION_PROPERTIES = [
+  "opacity",
+  "transform.translate.x",
+  "transform.translate.y",
+  "transform.translate.z",
+  "transform.rotate.x",
+  "transform.rotate.y",
+  "transform.rotate.z",
+  "transform.scale.x",
+  "transform.scale.y",
+  "transform.scale.z"
+];
+export {
+  SPATIALIZED_MOTION_PROPERTIES
+};
+//# sourceMappingURL=spatializedMotion.js.map

package/dist/types/motion/spatializedMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/types/motion/spatializedMotion.ts"],"sourcesContent":["import type { TimingFunction } from '../animation'\nimport type { SpatializedPlaybackError } from './spatializedPlayback'\nimport type { SpatializedVisualValues } from './spatializedVisual'\n\n/** Spatialized container kinds with declarative timeline motion. */\nexport type SpatializedMotionKind = 'spatialized2d' | 'static3d' | 'dynamic3d'\n\n/** Scalar property path on the spatialized visual whitelist. */\nexport const SPATIALIZED_MOTION_PROPERTIES = [\n  'opacity',\n  'transform.translate.x',\n  'transform.translate.y',\n  'transform.translate.z',\n  'transform.rotate.x',\n  'transform.rotate.y',\n  'transform.rotate.z',\n  'transform.scale.x',\n  'transform.scale.y',\n  'transform.scale.z',\n] as const\n\nexport type SpatializedMotionProperty =\n  (typeof SPATIALIZED_MOTION_PROPERTIES)[number]\n\nexport interface SpatializedMotionKeyframe {\n  /** Time in seconds from timeline start, in `[0, duration]`. */\n  at: number\n  value: number\n  timingFunction?: TimingFunction\n}\n\nexport type SpatializedMotionKeyframeValues = SpatializedVisualValues & {\n  timingFunction?: TimingFunction\n}\n\n/** One animatable property path and its keyframes (config-only, not a runtime handle). */\nexport interface SpatializedMotionTrack {\n  property: SpatializedMotionProperty\n  keyframes: SpatializedMotionKeyframe[]\n  timingFunction?: TimingFunction\n}\n\n/** Single-segment motion: `from` → `to` over `duration`. */\nexport interface SpatializedMotionSegmentConfig {\n  to: SpatializedVisualValues\n  from: SpatializedVisualValues\n  tracks?: never\n  timeline?: never\n  duration?: number\n  timingFunction?: TimingFunction\n  delay?: number\n  autoStart?: boolean\n  loop?: boolean | { reverse?: boolean }\n  playbackRate?: number\n  onStart?: () => void\n  onComplete?: (values: SpatializedVisualValues) => void\n  onStop?: (values: SpatializedVisualValues) => void\n  onReset?: (values: SpatializedVisualValues) => void\n  onError?: (error: SpatializedPlaybackError) => void\n}\n\n/** Percentage-keyframe timeline authoring shape before desugaring. */\nexport interface SpatializedMotionTimelineConfig {\n  duration?: number\n  timeline: Record<string, SpatializedMotionKeyframeValues>\n  /** Ignored when timeline authoring is present. */\n  from?: SpatializedVisualValues\n  /** Ignored when timeline authoring is present. */\n  to?: SpatializedVisualValues\n  tracks?: never\n  timingFunction?: TimingFunction\n  delay?: number\n  autoStart?: boolean\n  loop?: boolean | { reverse?: boolean }\n  playbackRate?: number\n  onStart?: () => void\n  onComplete?: (values: SpatializedVisualValues) => void\n  onStop?: (values: SpatializedVisualValues) => void\n  onReset?: (values: SpatializedVisualValues) => void\n  onError?: (error: SpatializedPlaybackError) => void\n}\n\n/** Public authoring accepted by spatialized container motion. */\nexport type SpatializedMotionConfig =\n  | SpatializedMotionSegmentConfig\n  | SpatializedMotionTimelineConfig\n\n/** Canonical internal track document produced before native create. */\nexport interface NormalizedSpatializedMotionConfig {\n  /** Timeline duration in seconds. */\n  duration: number\n  /** Canonical per-property numeric tracks. */\n  tracks: SpatializedMotionTrack[]\n  /** Default interpolation for tracks without an override. */\n  timingFunction?: TimingFunction\n  /** Playback delay in seconds. */\n  delay?: number\n  /** Whether playback starts automatically after binding. */\n  autoStart?: boolean\n  /** Loop behavior for the animation session. */\n  loop?: boolean | { reverse?: boolean }\n  /** Playback speed multiplier. */\n  playbackRate?: number\n  /** Called when playback starts. */\n  onStart?: () => void\n  /** Called when playback completes. */\n  onComplete?: (values: SpatializedVisualValues) => void\n  /** Called when playback stops. */\n  onStop?: (values: SpatializedVisualValues) => void\n  /** Called when playback resets. */\n  onReset?: (values: SpatializedVisualValues) => void\n  /** Called when asynchronous playback fails. */\n  onError?: (error: SpatializedPlaybackError) => void\n}\n\n/** Normalized timeline wire payload for native playback. */\nexport interface SpatializedMotionTimeline {\n  duration: number\n  delay?: number\n  playbackRate?: number\n  loop?: boolean | { reverse?: boolean }\n  tracks: Array<{\n    property: SpatializedMotionProperty\n    keyframes: SpatializedMotionKeyframe[]\n    timingFunction: TimingFunction\n  }>\n}\n\nexport type SpatializedMotionPlayState =\n  | 'idle'\n  | 'queued'\n  | 'running'\n  | 'paused'\n  | 'finished'\n\n/** Public imperative playback controls exposed to spatialized motion consumers. */\nexport interface SpatializedPlaybackApi {\n  play(): void\n  pause(): void\n  stop(): void\n  reset(): void\n  finish(): void\n  readonly isAnimating: boolean\n  readonly isPaused: boolean\n  readonly finished: boolean\n  readonly playState: SpatializedMotionPlayState\n}\n"],"mappings":"AAQO,MAAM,gCAAgC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}

package/dist/types/motion/spatializedPlayback.d.ts

@@ -0,0 +1,11 @@
+/** Async playback failure from native bridge. */
+interface SpatializedPlaybackError {
+    /** Operation that failed. */
+    command: 'create' | 'play' | 'pause' | 'resume' | 'stop' | 'reset' | 'finish' | 'destroy';
+    /** Native or SDK error code when available. */
+    code?: string;
+    /** Human-readable failure reason. */
+    reason: string;
+}
+
+export type { SpatializedPlaybackError };

package/dist/types/motion/spatializedPlayback.js

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

package/dist/types/motion/spatializedPlayback.js.map

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

package/dist/types/motion/spatializedVisual.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Structured visual transform for a spatialized container element.
+ * Composed in fixed order: translate → rotate → scale.
+ * Does NOT support arbitrary CSS transform strings, skew, perspective, or matrix interpolation.
+ */
+interface SpatializedVisualTransform {
+    /** Translation in CSS pixels. */
+    translate?: {
+        x?: number;
+        y?: number;
+        z?: number;
+    };
+    /** Rotation in degrees, aligning with CSS rotateX/Y/Z(). */
+    rotate?: {
+        x?: number;
+        y?: number;
+        z?: number;
+    };
+    /** Scale as unitless multipliers, aligning with CSS scaleX/Y/Z(). */
+    scale?: {
+        x?: number;
+        y?: number;
+        z?: number;
+    };
+}
+/**
+ * Whitelisted visual fields on a spatialized element at an instant in time.
+ * Does not include layout/size fields (width, height, back, depth).
+ */
+interface SpatializedVisualValues {
+    transform?: SpatializedVisualTransform;
+    opacity?: number;
+}
+
+export type { SpatializedVisualTransform, SpatializedVisualValues };

package/dist/types/motion/spatializedVisual.js

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

package/dist/types/motion/spatializedVisual.js.map

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

package/dist/types/types.d.ts

@@ -0,0 +1,7 @@
+import './global.js';
+export { h as AttachmentEntityOptions, i as AttachmentEntityUpdateOptions, B as BackgroundMaterialType, j as BaseplateVisibilityType, k as BaseplateVisibilityValues, C as CornerRadius, l as CubeInfo, M as ModelAssetOptions, m as ModelComponentOptions, n as ModelLoadingMode, o as ModelSource, P as PWAManifest, p as Point3D, Q as Quaternion, S as SceneUnit, q as SceneUnitM, r as SceneUnitPx, s as Size, t as Size3D, u as SpatialBoxGeometryOptions, v as SpatialConeGeometryOptions, w as SpatialCylinderGeometryOptions, x as SpatialDragEndEvent, y as SpatialDragEndEventDetail, z as SpatialDragEvent, D as SpatialDragEventDetail, E as SpatialDragStartEvent, G as SpatialDragStartEventDetail, I as SpatialEntityEventType, J as SpatialEntityOrReality, K as SpatialEntityProperties, L as SpatialEntityUserData, O as SpatialGeometryOptions, R as SpatialGeometryType, T as SpatialMagnifyEndEvent, U as SpatialMagnifyEndEventDetail, V as SpatialMagnifyEvent, W as SpatialMagnifyEventDetail, Y as SpatialMaterialType, Z as SpatialModelDragEvent, _ as SpatialModelEntityCreationOptions, $ as SpatialPlaneGeometryOptions, a0 as SpatialRotateEndEvent, a1 as SpatialRotateEndEventDetail, a2 as SpatialRotateEvent, a3 as SpatialRotateEventDetail, a4 as SpatialSceneCreationOptions, a5 as SpatialSceneProperties, a6 as SpatialSceneState, a7 as SpatialSceneType, a8 as SpatialSceneValues, a9 as SpatialSphereGeometryOptions, aa as SpatialTapEvent, ab as SpatialTapEventDetail, ac as SpatialTextureResourceOptions, ad as SpatialUnlitMaterialOptions, ae as Spatialized2DElementProperties, ah as SpatializedElementProperties, ai as SpatializedElementType, ap as SpatializedStatic3DElementProperties, aq as StageMode, at as Vec3, au as WorldAlignmentType, av as WorldAlignmentValues, aw as WorldScalingType, ax as WorldScalingValues, ay as XRMainSceneConfig, az as XRPrdConfig, aA as XRSceneResizability, aB as XRSceneSize, aC as XRSpatialSceneConfig, aD as XRSpatialSceneDefaults, aE as XRSpatialSceneOverrides, aF as isValidBaseplateVisibilityType, aG as isValidSceneUnit, aH as isValidSpatialSceneType, aI as isValidWorldAlignmentType, aJ as isValidWorldScalingType } from '../spatializedElementMotion-_0XWPQCE.js';
+import '../physicalMetrics-W5uZ5xKb.js';
+import './motion/spatializedVisual.js';
+import './motion/spatializedPlayback.js';
+import '../SpatialObject.js';
+import '../reality/component/SpatialComponent.js';

package/dist/types/types.js

@@ -0,0 +1,117 @@
+var SpatializedElementType = /* @__PURE__ */ ((SpatializedElementType2) => {
+  SpatializedElementType2[SpatializedElementType2["Spatialized2DElement"] = 0] = "Spatialized2DElement";
+  SpatializedElementType2[SpatializedElementType2["SpatializedStatic3DElement"] = 1] = "SpatializedStatic3DElement";
+  SpatializedElementType2[SpatializedElementType2["SpatializedDynamic3DElement"] = 2] = "SpatializedDynamic3DElement";
+  return SpatializedElementType2;
+})(SpatializedElementType || {});
+const BaseplateVisibilityValues = [
+  "automatic",
+  "visible",
+  "hidden"
+];
+function isValidBaseplateVisibilityType(type) {
+  return BaseplateVisibilityValues.includes(type);
+}
+const WorldScalingValues = ["automatic", "dynamic"];
+function isValidWorldScalingType(type) {
+  return WorldScalingValues.includes(type);
+}
+const WorldAlignmentValues = [
+  "adaptive",
+  "automatic",
+  "gravityAligned"
+];
+function isValidWorldAlignmentType(type) {
+  return WorldAlignmentValues.includes(type);
+}
+const SpatialSceneValues = ["window", "volume"];
+function isValidSpatialSceneType(type) {
+  return SpatialSceneValues.includes(type);
+}
+function isValidSceneUnit(val) {
+  if (typeof val === "number") {
+    return val >= 0;
+  }
+  if (typeof val === "string") {
+    if (val.endsWith("px")) {
+      if (isNaN(Number(val.slice(0, -2)))) {
+        return false;
+      }
+      return Number(val.slice(0, -2)) >= 0;
+    }
+    if (val.endsWith("m")) {
+      if (isNaN(Number(val.slice(0, -1)))) {
+        return false;
+      }
+      return Number(val.slice(0, -1)) >= 0;
+    }
+  }
+  return false;
+}
+var SpatialSceneState = /* @__PURE__ */ ((SpatialSceneState2) => {
+  SpatialSceneState2["idle"] = "idle";
+  SpatialSceneState2["pending"] = "pending";
+  SpatialSceneState2["willVisible"] = "willVisible";
+  SpatialSceneState2["visible"] = "visible";
+  SpatialSceneState2["fail"] = "fail";
+  return SpatialSceneState2;
+})(SpatialSceneState || {});
+class CubeInfo {
+  constructor(size, origin) {
+    this.size = size;
+    this.origin = origin;
+    this.size = size;
+    this.origin = origin;
+  }
+  get x() {
+    return this.origin.x;
+  }
+  get y() {
+    return this.origin.y;
+  }
+  get z() {
+    return this.origin.z;
+  }
+  get width() {
+    return this.size.width;
+  }
+  get height() {
+    return this.size.height;
+  }
+  get depth() {
+    return this.size.depth;
+  }
+  get left() {
+    return this.x;
+  }
+  get top() {
+    return this.y;
+  }
+  get right() {
+    return this.x + this.width;
+  }
+  get bottom() {
+    return this.y + this.height;
+  }
+  get back() {
+    return this.z;
+  }
+  get front() {
+    return this.z + this.depth;
+  }
+}
+export {
+  BaseplateVisibilityValues,
+  CubeInfo,
+  SpatialSceneState,
+  SpatialSceneValues,
+  SpatializedElementType,
+  WorldAlignmentValues,
+  WorldScalingValues,
+  isValidBaseplateVisibilityType,
+  isValidSceneUnit,
+  isValidSpatialSceneType,
+  isValidWorldAlignmentType,
+  isValidWorldScalingType
+};
+//# sourceMappingURL=types.js.map

package/dist/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/types.ts"],"sourcesContent":["import type { SpatialEntity } from '..'\nimport { SpatialGeometry } from '../reality/geometry/SpatialGeometry'\nimport { SpatialMaterial } from '../reality/material/SpatialMaterial'\nimport type { SpatializedDynamic3DElement } from '../SpatializedDynamic3DElement'\n\nexport interface Vec3 {\n  x: number\n  y: number\n  z: number\n}\n\nexport type Point3D = Vec3\n\nexport interface Quaternion {\n  x: number\n  y: number\n  z: number\n  w: number\n}\n\n/**\n * Material type for SpatialDiv or HTML document.\n *\n * This type defines the background material options for both SpatialDiv elements and HTML documents.\n *\n * - `'none'`: This is the default value.\n *   - For HTML documents, the web page window will have the default native background.\n *   - For SpatialDiv, the window will have a transparent background.\n * - `'translucent'`: Represents a glass-like material in AVP (Apple Vision Pro).\n * - `'thick'`: Represents a thick material in AVP.\n * - `'regular'`: Represents a regular material in AVP.\n * - `'thin'`: Represents a thin material in AVP.\n * - `'transparent'`: Represents a fully transparent background.\n */\nexport type BackgroundMaterialType =\n  | 'none'\n  | 'translucent'\n  | 'thick'\n  | 'regular'\n  | 'thin'\n  | 'transparent'\n\nexport type CornerRadius = {\n  topLeading: number\n  bottomLeading: number\n  topTrailing: number\n  bottomTrailing: number\n}\n\nexport interface SpatialSceneProperties {\n  cornerRadius: CornerRadius\n  material: BackgroundMaterialType\n  opacity: number\n}\n\nexport enum SpatializedElementType {\n  Spatialized2DElement,\n  SpatializedStatic3DElement,\n  SpatializedDynamic3DElement,\n}\n\nexport interface SpatializedElementProperties {\n  name: string\n  clientX: number\n  clientY: number\n  width: number\n  height: number\n  depth: number\n  opacity: number\n  visible: boolean\n  scrollWithParent: boolean\n  zIndex: number\n  backOffset: number\n  rotationAnchor: Point3D\n  enableTapGesture: boolean\n  enableDragStartGesture: boolean\n  enableDragGesture: boolean\n  enableDragEndGesture: boolean\n  enableRotateGesture: boolean\n  enableRotateEndGesture: boolean\n  enableMagnifyGesture: boolean\n  enableMagnifyEndGesture: boolean\n  /**\n   * Optional world-space axis for spatial rotate gesture. Omitted or zero vector\n   * means unconstrained rotation (platform default).\n   */\n  rotateConstrainedToAxis?: Vec3\n}\n\nexport interface Spatialized2DElementProperties\n  extends SpatializedElementProperties {\n  scrollPageEnabled: boolean\n  cornerRadius: CornerRadius\n  material: BackgroundMaterialType\n  scrollEdgeInsetsMarginRight: number\n}\n\nexport interface ModelSource {\n  src: string\n  type?: string\n}\n\nexport type ModelLoadingMode = 'eager' | 'lazy'\n\nexport type StageMode = 'orbit' | 'none'\n\nexport interface SpatializedStatic3DElementProperties\n  extends SpatializedElementProperties {\n  modelURL: string\n  sources?: ModelSource[]\n  modelTransform?: number[]\n  stagemode?: StageMode\n  autoplay?: boolean\n  loop?: boolean\n  animationPaused?: boolean\n  playbackRate?: number\n  currentTime?: number\n  posterURL?: string\n  loading?: ModelLoadingMode\n}\n\nexport interface SpatialSceneCreationOptions {\n  defaultSize?: {\n    width: number | string // Initial width of the window\n    height: number | string // Initial height of the window\n    depth?: number | string // Initial depth of the window, only for volume\n  }\n\n  resizability?: {\n    minWidth?: number | string // Minimum width of the window\n    minHeight?: number | string // Minimum height of the window\n    maxWidth?: number | string // Maximum width of the window\n    maxHeight?: number | string // Maximum height of the window\n  }\n  worldScaling?: WorldScalingType\n  worldAlignment?: WorldAlignmentType\n\n  baseplateVisibility?: BaseplateVisibilityType\n}\n\nexport type SpatialEntityEventType =\n  | 'spatialtap'\n  | 'spatialdragstart'\n  | 'spatialdrag'\n  | 'spatialdragend'\n  | 'spatialrotate'\n  | 'spatialrotateend'\n  | 'spatialmagnify'\n  | 'spatialmagnifyend'\n\nexport const BaseplateVisibilityValues = [\n  'automatic',\n  'visible',\n  'hidden',\n] as const\nexport type BaseplateVisibilityType = (typeof BaseplateVisibilityValues)[number]\n\nexport function isValidBaseplateVisibilityType(type: string): Boolean {\n  return BaseplateVisibilityValues.includes(type as BaseplateVisibilityType)\n}\n\nexport const WorldScalingValues = ['automatic', 'dynamic'] as const\nexport type WorldScalingType = (typeof WorldScalingValues)[number]\n\nexport function isValidWorldScalingType(type: string): Boolean {\n  return WorldScalingValues.includes(type as WorldScalingType)\n}\n\nexport const WorldAlignmentValues = [\n  'adaptive',\n  'automatic',\n  'gravityAligned',\n] as const\nexport type WorldAlignmentType = (typeof WorldAlignmentValues)[number]\n\nexport function isValidWorldAlignmentType(type: string): Boolean {\n  return WorldAlignmentValues.includes(type as WorldAlignmentType)\n}\n\nexport const SpatialSceneValues = ['window', 'volume'] as const\nexport type SpatialSceneType = (typeof SpatialSceneValues)[number]\n\nexport function isValidSpatialSceneType(type: string): Boolean {\n  return SpatialSceneValues.includes(type as SpatialSceneType)\n}\n\n/**\n * check px,m and number, number must be >= 0\n *\n * */\nexport function isValidSceneUnit(val: string | number): boolean {\n  // only support number or string with unit px or m\n  // rpx cm mm not allowed\n  if (typeof val === 'number') {\n    return val >= 0\n  }\n  if (typeof val === 'string') {\n    if (val.endsWith('px')) {\n      // check if number\n      if (isNaN(Number(val.slice(0, -2)))) {\n        return false\n      }\n      return Number(val.slice(0, -2)) >= 0\n    }\n    if (val.endsWith('m')) {\n      // check if number\n      if (isNaN(Number(val.slice(0, -1)))) {\n        return false\n      }\n      return Number(val.slice(0, -1)) >= 0\n    }\n  }\n  return false\n}\n\nexport interface SpatialEntityProperties {\n  position: Vec3\n  rotation: Vec3\n  scale: Vec3\n}\n\nexport type SpatialGeometryType =\n  | 'BoxGeometry'\n  | 'PlaneGeometry'\n  | 'SphereGeometry'\n  | 'CylinderGeometry'\n  | 'ConeGeometry'\n\nexport interface SpatialBoxGeometryOptions {\n  width?: number\n  height?: number\n  depth?: number\n  cornerRadius?: number\n  splitFaces?: boolean\n}\n\nexport interface SpatialPlaneGeometryOptions {\n  width?: number\n  height?: number\n  cornerRadius?: number\n}\n\nexport interface SpatialSphereGeometryOptions {\n  radius?: number\n}\n\nexport interface SpatialConeGeometryOptions {\n  radius?: number\n  height?: number\n}\n\nexport interface SpatialCylinderGeometryOptions {\n  radius?: number\n  height?: number\n}\n\nexport type SpatialGeometryOptions =\n  | SpatialBoxGeometryOptions\n  | SpatialPlaneGeometryOptions\n  | SpatialSphereGeometryOptions\n  | SpatialCylinderGeometryOptions\n  | SpatialConeGeometryOptions\n\nexport type SpatialMaterialType = 'unlit'\n\nexport interface SpatialUnlitMaterialOptions {\n  color?: string\n  textureId?: string\n  transparent?: boolean\n  opacity?: number\n}\n\nexport interface SpatialTextureResourceOptions {\n  url: string\n}\n\nexport interface ModelComponentOptions {\n  mesh: SpatialGeometry\n  materials: SpatialMaterial[]\n}\n\nexport interface SpatialEntityUserData {\n  id?: string\n  name?: string\n}\n\nexport interface SpatialModelEntityCreationOptions {\n  modelAssetId: string\n  name?: string\n}\n\nexport interface ModelAssetOptions {\n  url: string\n}\n\nexport enum SpatialSceneState {\n  idle = 'idle',\n  pending = 'pending',\n  willVisible = 'willVisible',\n  visible = 'visible',\n  fail = 'fail',\n}\n\n/**\n * Translate event, matching similar behavior to https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/drag_event\n */\nexport type SpatialModelDragEvent = {\n  eventType: 'dragstart' | 'dragend' | 'drag'\n  translation3D: Vec3\n  startLocation3D: Vec3\n}\n\nexport interface Size {\n  width: number\n  height: number\n}\n\nexport interface Size3D extends Size {\n  depth: number\n}\n\nexport class CubeInfo {\n  constructor(\n    public size: Size3D,\n    public origin: Vec3,\n  ) {\n    this.size = size\n    this.origin = origin\n  }\n\n  get x() {\n    return this.origin.x\n  }\n\n  get y() {\n    return this.origin.y\n  }\n\n  get z() {\n    return this.origin.z\n  }\n\n  get width() {\n    return this.size.width\n  }\n\n  get height() {\n    return this.size.height\n  }\n\n  get depth() {\n    return this.size.depth\n  }\n\n  get left() {\n    return this.x\n  }\n\n  get top() {\n    return this.y\n  }\n\n  get right() {\n    return this.x + this.width\n  }\n\n  get bottom() {\n    return this.y + this.height\n  }\n\n  get back() {\n    return this.z\n  }\n\n  get front() {\n    return this.z + this.depth\n  }\n}\n\nexport interface SpatialTapEventDetail {\n  location3D: Point3D\n  globalLocation3D?: Point3D\n}\n\nexport type SpatialTapEvent = CustomEvent<SpatialTapEventDetail>\n\nexport interface SpatialDragStartEventDetail {\n  startLocation3D: Point3D\n  globalLocation3D?: Point3D\n}\n\nexport interface SpatialDragEventDetail {\n  translation3D: Vec3\n}\n\nexport interface SpatialDragEndEventDetail {}\n\nexport type SpatialDragStartEvent = CustomEvent<SpatialDragStartEventDetail>\n\nexport type SpatialDragEvent = CustomEvent<SpatialDragEventDetail>\n\nexport type SpatialDragEndEvent = CustomEvent<SpatialDragEndEventDetail>\nexport interface SpatialRotateEventDetail {\n  quaternion: Quaternion\n}\n\nexport interface SpatialRotateEndEventDetail {}\n\nexport type SpatialRotateEvent = CustomEvent<SpatialRotateEventDetail>\n\nexport type SpatialRotateEndEvent = CustomEvent<SpatialRotateEndEventDetail>\n\nexport interface SpatialMagnifyEventDetail {\n  magnification: number\n}\n\nexport interface SpatialMagnifyEndEventDetail {}\n\nexport type SpatialMagnifyEvent = CustomEvent<SpatialMagnifyEventDetail>\n\nexport type SpatialMagnifyEndEvent = CustomEvent<SpatialMagnifyEndEventDetail>\n\nexport type SpatialEntityOrReality = SpatialEntity | SpatializedDynamic3DElement\n\nexport interface AttachmentEntityOptions {\n  parentEntityId: string\n  position?: [number, number, number]\n  size: { width: number; height: number }\n  ownerViewId: string\n}\n\nexport interface AttachmentEntityUpdateOptions {\n  position?: [number, number, number]\n  size?: { width: number; height: number }\n}\n\n// manifest\n\nexport type SceneUnitPx = `${number}px`\nexport type SceneUnitM = `${number}m`\nexport type SceneUnit = number | SceneUnitPx | SceneUnitM\n\nexport interface XRSceneSize {\n  width: SceneUnit\n  height: SceneUnit\n  depth?: SceneUnit\n}\n\nexport interface XRSceneResizability {\n  minWidth?: SceneUnit\n  minHeight?: SceneUnit\n  maxWidth?: SceneUnit\n  maxHeight?: SceneUnit\n}\n\nexport interface XRMainSceneConfig extends XRSpatialSceneDefaults {\n  type?: SpatialSceneType\n}\n\nexport interface XRSpatialSceneDefaults {\n  default_size?: XRSceneSize\n  resizability?: XRSceneResizability\n  worldScaling?: WorldScalingType\n  worldAlignment?: WorldAlignmentType\n  baseplateVisibility?: BaseplateVisibilityType\n}\n\nexport interface XRSpatialSceneOverrides {\n  window_scene?: XRSpatialSceneDefaults\n  volume_scene?: XRSpatialSceneDefaults\n}\n\nexport interface XRSpatialSceneConfig extends XRSpatialSceneDefaults {\n  overrides?: XRSpatialSceneOverrides\n}\n\nexport interface XRPrdConfig {\n  xr_main_scene?: XRMainSceneConfig\n  xr_spatial_scene?: XRSpatialSceneConfig\n}\n\nexport interface PWAManifest extends XRPrdConfig {\n  name?: string\n  short_name?: string\n  start_url?: string\n  display?: string\n  icons?: Array<{\n    src: string\n    sizes?: string\n    type?: string\n    purpose?: string\n  }>\n  id?: string\n  scope?: string\n  [key: string]: any\n}\n"],"mappings":"AAuDO,IAAK,yBAAL,kBAAKA,4BAAL;AACL,EAAAA,gDAAA;AACA,EAAAA,gDAAA;AACA,EAAAA,gDAAA;AAHU,SAAAA;AAAA,GAAA;AA+FL,MAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AACF;AAGO,SAAS,+BAA+B,MAAuB;AACpE,SAAO,0BAA0B,SAAS,IAA+B;AAC3E;AAEO,MAAM,qBAAqB,CAAC,aAAa,SAAS;AAGlD,SAAS,wBAAwB,MAAuB;AAC7D,SAAO,mBAAmB,SAAS,IAAwB;AAC7D;AAEO,MAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF;AAGO,SAAS,0BAA0B,MAAuB;AAC/D,SAAO,qBAAqB,SAAS,IAA0B;AACjE;AAEO,MAAM,qBAAqB,CAAC,UAAU,QAAQ;AAG9C,SAAS,wBAAwB,MAAuB;AAC7D,SAAO,mBAAmB,SAAS,IAAwB;AAC7D;AAMO,SAAS,iBAAiB,KAA+B;AAG9D,MAAI,OAAO,QAAQ,UAAU;AAC3B,WAAO,OAAO;AAAA,EAChB;AACA,MAAI,OAAO,QAAQ,UAAU;AAC3B,QAAI,IAAI,SAAS,IAAI,GAAG;AAEtB,UAAI,MAAM,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC,GAAG;AACnC,eAAO;AAAA,MACT;AACA,aAAO,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC,KAAK;AAAA,IACrC;AACA,QAAI,IAAI,SAAS,GAAG,GAAG;AAErB,UAAI,MAAM,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC,GAAG;AACnC,eAAO;AAAA,MACT;AACA,aAAO,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC,KAAK;AAAA,IACrC;AAAA,EACF;AACA,SAAO;AACT;AAkFO,IAAK,oBAAL,kBAAKC,uBAAL;AACL,EAAAA,mBAAA,UAAO;AACP,EAAAA,mBAAA,aAAU;AACV,EAAAA,mBAAA,iBAAc;AACd,EAAAA,mBAAA,aAAU;AACV,EAAAA,mBAAA,UAAO;AALG,SAAAA;AAAA,GAAA;AA0BL,MAAM,SAAS;AAAA,EACpB,YACS,MACA,QACP;AAFO;AACA;AAEP,SAAK,OAAO;AACZ,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,IAAI,IAAI;AACN,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,IAAI,IAAI;AACN,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,IAAI,IAAI;AACN,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,IAAI,QAAQ;AACV,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,SAAS;AACX,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,QAAQ;AACV,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,OAAO;AACT,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,MAAM;AACR,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,QAAQ;AACV,WAAO,KAAK,IAAI,KAAK;AAAA,EACvB;AAAA,EAEA,IAAI,SAAS;AACX,WAAO,KAAK,IAAI,KAAK;AAAA,EACvB;AAAA,EAEA,IAAI,OAAO;AACT,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,QAAQ;AACV,WAAO,KAAK,IAAI,KAAK;AAAA,EACvB;AACF;","names":["SpatializedElementType","SpatialSceneState"]}

package/dist/utils.d.ts

@@ -0,0 +1,44 @@
+import { at as Vec3, as as TransformValues } from './spatializedElementMotion-_0XWPQCE.js';
+import './types/motion/spatializedVisual.js';
+import './types/motion/spatializedPlayback.js';
+import './types/global.js';
+import './physicalMetrics-W5uZ5xKb.js';
+import './SpatialObject.js';
+import './reality/component/SpatialComponent.js';
+
+declare function parseCornerRadius(computedStyle: CSSStyleDeclaration): {
+    topLeading: number;
+    bottomLeading: number;
+    topTrailing: number;
+    bottomTrailing: number;
+};
+/**
+ *
+ * compose SRT matrix
+ * @export
+ * @param {Vec3} position meter
+ * @param {Vec3} rotation degree
+ * @param {Vec3} scale
+ * @return {*}  {DOMMatrix}
+ */
+declare function composeSRT(position: Vec3, rotation: Vec3, scale: Vec3): DOMMatrix;
+/**
+ * Deep-clone a plain JSON-serializable object by value.
+ *
+ * Notes:
+ * - Only use for data composed of primitives, arrays, and plain objects.
+ * - Functions, Dates, Maps/Sets, DOM nodes, and circular structures are not supported.
+ */
+declare function deepCloneJSON<T>(value: T): T;
+/**
+ * Decompose a column-major 4x4 matrix (16 numbers) back into
+ * position, rotation (Euler degrees), and scale Vec3 values.
+ *
+ * This is the inverse of `composeSRT`. It extracts:
+ * - Translation from the last column
+ * - Scale from the lengths of the first three column vectors
+ * - Rotation from the normalised upper-3x3 → Euler XYZ in degrees
+ */
+declare function decomposeSRT(m: number[]): TransformValues;
+
+export { composeSRT, decomposeSRT, deepCloneJSON, parseCornerRadius };

package/dist/utils.js

@@ -0,0 +1,86 @@
+function parseBorderRadius(borderProperty, width) {
+  if (borderProperty === "") {
+    return 0;
+  }
+  if (borderProperty.endsWith("%")) {
+    return width * parseFloat(borderProperty) / 100;
+  }
+  return parseFloat(borderProperty);
+}
+function parseCornerRadius(computedStyle) {
+  const width = parseFloat(computedStyle.getPropertyValue("width"));
+  const topLeftPropertyValue = computedStyle.getPropertyValue(
+    "border-top-left-radius"
+  );
+  const topRightPropertyValue = computedStyle.getPropertyValue(
+    "border-top-right-radius"
+  );
+  const bottomLeftPropertyValue = computedStyle.getPropertyValue(
+    "border-bottom-left-radius"
+  );
+  const bottomRightPropertyValue = computedStyle.getPropertyValue(
+    "border-bottom-right-radius"
+  );
+  const cornerRadius = {
+    topLeading: parseBorderRadius(topLeftPropertyValue, width),
+    bottomLeading: parseBorderRadius(bottomLeftPropertyValue, width),
+    topTrailing: parseBorderRadius(topRightPropertyValue, width),
+    bottomTrailing: parseBorderRadius(bottomRightPropertyValue, width)
+  };
+  return cornerRadius;
+}
+function composeSRT(position, rotation, scale) {
+  const { x: px, y: py, z: pz } = position;
+  const { x: rx, y: ry, z: rz } = rotation;
+  const { x: sx, y: sy, z: sz } = scale;
+  let m = new DOMMatrix();
+  m = m.translate(px, py, pz);
+  m = m.rotate(rx, ry, rz);
+  m = m.scale(sx, sy, sz);
+  return m;
+}
+function deepCloneJSON(value) {
+  const sc = globalThis.structuredClone;
+  if (typeof sc === "function") {
+    try {
+      return sc(value);
+    } catch {
+    }
+  }
+  return JSON.parse(JSON.stringify(value));
+}
+function decomposeSRT(m) {
+  const position = { x: m[12], y: m[13], z: m[14] };
+  const sx = Math.sqrt(m[0] * m[0] + m[1] * m[1] + m[2] * m[2]);
+  const sy = Math.sqrt(m[4] * m[4] + m[5] * m[5] + m[6] * m[6]);
+  const sz = Math.sqrt(m[8] * m[8] + m[9] * m[9] + m[10] * m[10]);
+  const scale = { x: sx, y: sy, z: sz };
+  const r00 = sx !== 0 ? m[0] / sx : 0;
+  const r10 = sx !== 0 ? m[1] / sx : 0;
+  const r20 = sx !== 0 ? m[2] / sx : 0;
+  const r11 = sy !== 0 ? m[5] / sy : 0;
+  const r21 = sy !== 0 ? m[6] / sy : 0;
+  const r12 = sz !== 0 ? m[9] / sz : 0;
+  const r22 = sz !== 0 ? m[10] / sz : 0;
+  const RAD2DEG = 180 / Math.PI;
+  let rx, ry, rz;
+  const sinY = -r20;
+  const clampedSinY = Math.max(-1, Math.min(1, sinY));
+  ry = Math.asin(clampedSinY) * RAD2DEG;
+  if (Math.abs(sinY) < 0.9999999) {
+    rx = Math.atan2(r21, r22) * RAD2DEG;
+    rz = Math.atan2(r10, r00) * RAD2DEG;
+  } else {
+    rx = Math.atan2(-r12, r11) * RAD2DEG;
+    rz = 0;
+  }
+  const rotation = { x: rx, y: ry, z: rz };
+  return { position, rotation, scale };
+}
+export {
+  composeSRT,
+  decomposeSRT,
+  deepCloneJSON,
+  parseCornerRadius
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts"],"sourcesContent":["import { Vec3 } from './types/types'\nimport type { TransformValues } from './types/animation'\n\nfunction parseBorderRadius(borderProperty: string, width: number) {\n  if (borderProperty === '') {\n    return 0\n  }\n  if (borderProperty.endsWith('%')) {\n    return (width * parseFloat(borderProperty)) / 100\n  }\n  return parseFloat(borderProperty)\n}\n\nexport function parseCornerRadius(computedStyle: CSSStyleDeclaration) {\n  const width = parseFloat(computedStyle.getPropertyValue('width'))\n\n  const topLeftPropertyValue = computedStyle.getPropertyValue(\n    'border-top-left-radius',\n  )\n  const topRightPropertyValue = computedStyle.getPropertyValue(\n    'border-top-right-radius',\n  )\n  const bottomLeftPropertyValue = computedStyle.getPropertyValue(\n    'border-bottom-left-radius',\n  )\n  const bottomRightPropertyValue = computedStyle.getPropertyValue(\n    'border-bottom-right-radius',\n  )\n\n  const cornerRadius = {\n    topLeading: parseBorderRadius(topLeftPropertyValue, width),\n    bottomLeading: parseBorderRadius(bottomLeftPropertyValue, width),\n    topTrailing: parseBorderRadius(topRightPropertyValue, width),\n    bottomTrailing: parseBorderRadius(bottomRightPropertyValue, width),\n  }\n\n  return cornerRadius\n}\n\n/**\n *\n * compose SRT matrix\n * @export\n * @param {Vec3} position meter\n * @param {Vec3} rotation degree\n * @param {Vec3} scale\n * @return {*}  {DOMMatrix}\n */\nexport function composeSRT(position: Vec3, rotation: Vec3, scale: Vec3) {\n  const { x: px, y: py, z: pz } = position\n  const { x: rx, y: ry, z: rz } = rotation\n  const { x: sx, y: sy, z: sz } = scale\n\n  let m = new DOMMatrix()\n  // https://drafts.fxtf.org/geometry/#immutable-transformation-methods\n  // as these methods are post-multiplication, the order of transformations is reversed\n  // we want SRT = T * R * S\n  m = m.translate(px, py, pz)\n  m = m.rotate(rx, ry, rz)\n  m = m.scale(sx, sy, sz)\n  return m\n}\n\n/**\n * Deep-clone a plain JSON-serializable object by value.\n *\n * Notes:\n * - Only use for data composed of primitives, arrays, and plain objects.\n * - Functions, Dates, Maps/Sets, DOM nodes, and circular structures are not supported.\n */\nexport function deepCloneJSON<T>(value: T): T {\n  const sc = (globalThis as any).structuredClone as\n    | ((v: any) => any)\n    | undefined\n  if (typeof sc === 'function') {\n    try {\n      return sc(value)\n    } catch {\n      // fall through to JSON method\n    }\n  }\n  return JSON.parse(JSON.stringify(value))\n}\n\n/**\n * Decompose a column-major 4x4 matrix (16 numbers) back into\n * position, rotation (Euler degrees), and scale Vec3 values.\n *\n * This is the inverse of `composeSRT`. It extracts:\n * - Translation from the last column\n * - Scale from the lengths of the first three column vectors\n * - Rotation from the normalised upper-3x3 → Euler XYZ in degrees\n */\nexport function decomposeSRT(m: number[]): TransformValues {\n  // Translation\n  const position: Vec3 = { x: m[12], y: m[13], z: m[14] }\n\n  // Scale — column vector lengths\n  const sx = Math.sqrt(m[0] * m[0] + m[1] * m[1] + m[2] * m[2])\n  const sy = Math.sqrt(m[4] * m[4] + m[5] * m[5] + m[6] * m[6])\n  const sz = Math.sqrt(m[8] * m[8] + m[9] * m[9] + m[10] * m[10])\n  const scale: Vec3 = { x: sx, y: sy, z: sz }\n\n  // Normalise columns to get rotation matrix\n  const r00 = sx !== 0 ? m[0] / sx : 0\n  const r10 = sx !== 0 ? m[1] / sx : 0\n  const r20 = sx !== 0 ? m[2] / sx : 0\n  const r11 = sy !== 0 ? m[5] / sy : 0\n  const r21 = sy !== 0 ? m[6] / sy : 0\n  const r12 = sz !== 0 ? m[9] / sz : 0\n  const r22 = sz !== 0 ? m[10] / sz : 0\n\n  // DOMMatrix.rotate(rx, ry, rz) uses ZYX intrinsic order which maps to\n  // extrinsic XYZ. The decomposition below extracts Euler angles that\n  // match this convention.\n  const RAD2DEG = 180 / Math.PI\n  let rx: number, ry: number, rz: number\n\n  // clamp to avoid NaN from asin\n  const sinY = -r20\n  const clampedSinY = Math.max(-1, Math.min(1, sinY))\n  ry = Math.asin(clampedSinY) * RAD2DEG\n\n  if (Math.abs(sinY) < 0.9999999) {\n    rx = Math.atan2(r21, r22) * RAD2DEG\n    rz = Math.atan2(r10, r00) * RAD2DEG\n  } else {\n    // Gimbal lock\n    rx = Math.atan2(-r12, r11) * RAD2DEG\n    rz = 0\n  }\n\n  const rotation: Vec3 = { x: rx, y: ry, z: rz }\n\n  return { position, rotation, scale }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webspatial/core-sdk",
-  "version": "1.7.0",
+  "version": "2.0.0",
   "description": "this is the core js API for webspatial",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -9,10 +9,26 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    }
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    },
+    "./runtime/keys": {
+      "types": "./dist/runtime/keys.d.ts",
+      "import": "./dist/runtime/keys.js"
+    },
+    "./install-polyfills": {
+      "types": "./dist/install-polyfills.d.ts",
+      "import": "./dist/install-polyfills.js"
+    },
+    "./package.json": "./package.json"
   },
   "type": "module",
-  "sideEffects": false,
+  "sideEffects": [
+    "./dist/install-polyfills.js",
+    "./src/install-polyfills.ts"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/webspatial/webspatial-sdk.git",
@@ -25,6 +41,7 @@
   },
   "homepage": "https://github.com/webspatial/webspatial-sdk#readme",
   "devDependencies": {
+    "happy-dom": "^20.9.0",
     "jsdom": "^26.1.0",
     "tsup": "^8.4.0",
     "typedoc": "^0.26.5",
@@ -38,7 +55,6 @@
     "test:w": "vitest",
     "build": "tsup",
     "start": "tsup --watch",
-    "buildIife": "esbuild dist/index.js --outdir=dist/iife --minify --bundle --format=iife --global-name=webspatialCore",
     "format": "npx prettier --write 'src/**/*.ts' 'src/**/*.tsx' || true",
     "genDocs": "typedoc --plugin typedoc-plugin-markdown src/core/index.ts"
   }