@webspatial/core-sdk 1.7.0 → 2.0.0

package/dist/SpatializedElementCreator.d.ts

@@ -0,0 +1,15 @@
+import { Spatialized2DElement } from './Spatialized2DElement.js';
+import { SpatializedStatic3DElement } from './SpatializedStatic3DElement.js';
+import { af as SpatializedDynamic3DElement, o as ModelSource, n as ModelLoadingMode } 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 createSpatialized2DElement(): Promise<Spatialized2DElement>;
+declare function createSpatializedStatic3DElement(modelURL?: string, sources?: ModelSource[], loading?: ModelLoadingMode): Promise<SpatializedStatic3DElement>;
+declare function createSpatializedDynamic3DElement(): Promise<SpatializedDynamic3DElement>;
+
+export { createSpatialized2DElement, createSpatializedDynamic3DElement, createSpatializedStatic3DElement };

package/dist/SpatializedElementCreator.js

@@ -0,0 +1,47 @@
+import {
+  CreateSpatializedDynamic3DElementCommand,
+  CreateSpatializedStatic3DElementCommand
+} from "./JSBCommand";
+import { Spatialized2DElement } from "./Spatialized2DElement";
+import { SpatializedStatic3DElement } from "./SpatializedStatic3DElement";
+import { SpatializedDynamic3DElement } from "./SpatializedDynamic3DElement";
+import { createNativeSpatialDiv } from "./spatial-host";
+async function createSpatialized2DElement() {
+  const result = await createNativeSpatialDiv();
+  if (!result.success) {
+    throw new Error("createSpatialized2DElement failed");
+  } else {
+    const { id, windowProxy } = result.data;
+    windowProxy.document.head.innerHTML = `<meta name="viewport" content="width=device-width, initial-scale=1">
+      <base href="${document.baseURI}">`;
+    return new Spatialized2DElement(id, windowProxy);
+  }
+}
+async function createSpatializedStatic3DElement(modelURL, sources, loading = "eager") {
+  const result = await new CreateSpatializedStatic3DElementCommand(
+    modelURL,
+    sources,
+    loading
+  ).execute();
+  if (!result.success) {
+    throw new Error("createSpatializedStatic3DElement failed");
+  } else {
+    const { id } = result.data;
+    return new SpatializedStatic3DElement(id, modelURL, sources, loading);
+  }
+}
+async function createSpatializedDynamic3DElement() {
+  const result = await new CreateSpatializedDynamic3DElementCommand().execute();
+  if (!result.success) {
+    throw new Error("createSpatializedDynamic3DElement failed");
+  } else {
+    const { id } = result.data;
+    return new SpatializedDynamic3DElement(id);
+  }
+}
+export {
+  createSpatialized2DElement,
+  createSpatializedDynamic3DElement,
+  createSpatializedStatic3DElement
+};
+//# sourceMappingURL=SpatializedElementCreator.js.map

package/dist/SpatializedElementCreator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/SpatializedElementCreator.ts"],"sourcesContent":["import {\n  CreateSpatializedDynamic3DElementCommand,\n  CreateSpatializedStatic3DElementCommand,\n} from './JSBCommand'\nimport { Spatialized2DElement } from './Spatialized2DElement'\nimport { SpatializedStatic3DElement } from './SpatializedStatic3DElement'\nimport { SpatializedDynamic3DElement } from './SpatializedDynamic3DElement'\nimport { createNativeSpatialDiv } from './spatial-host'\nimport { ModelLoadingMode, ModelSource } from './types/types'\n\nexport async function createSpatialized2DElement(): Promise<Spatialized2DElement> {\n  const result = await createNativeSpatialDiv()\n  if (!result.success) {\n    throw new Error('createSpatialized2DElement failed')\n  } else {\n    const { id, windowProxy } = result.data!\n    // set base href to make sure the relative url is correct\n    windowProxy.document.head.innerHTML = `<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n      <base href=\"${document.baseURI}\">`\n    return new Spatialized2DElement(id, windowProxy)\n  }\n}\n\nexport async function createSpatializedStatic3DElement(\n  modelURL?: string,\n  sources?: ModelSource[],\n  loading: ModelLoadingMode = 'eager',\n): Promise<SpatializedStatic3DElement> {\n  const result = await new CreateSpatializedStatic3DElementCommand(\n    modelURL,\n    sources,\n    loading,\n  ).execute()\n  if (!result.success) {\n    throw new Error('createSpatializedStatic3DElement failed')\n  } else {\n    const { id } = result.data\n    return new SpatializedStatic3DElement(id, modelURL, sources, loading)\n  }\n}\n\nexport async function createSpatializedDynamic3DElement(): Promise<SpatializedDynamic3DElement> {\n  const result = await new CreateSpatializedDynamic3DElementCommand().execute()\n  if (!result.success) {\n    throw new Error('createSpatializedDynamic3DElement failed')\n  } else {\n    const { id } = result.data\n    return new SpatializedDynamic3DElement(id)\n  }\n}\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,4BAA4B;AACrC,SAAS,kCAAkC;AAC3C,SAAS,mCAAmC;AAC5C,SAAS,8BAA8B;AAGvC,eAAsB,6BAA4D;AAChF,QAAM,SAAS,MAAM,uBAAuB;AAC5C,MAAI,CAAC,OAAO,SAAS;AACnB,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD,OAAO;AACL,UAAM,EAAE,IAAI,YAAY,IAAI,OAAO;AAEnC,gBAAY,SAAS,KAAK,YAAY;AAAA,oBACtB,SAAS,OAAO;AAChC,WAAO,IAAI,qBAAqB,IAAI,WAAW;AAAA,EACjD;AACF;AAEA,eAAsB,iCACpB,UACA,SACA,UAA4B,SACS;AACrC,QAAM,SAAS,MAAM,IAAI;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,QAAQ;AACV,MAAI,CAAC,OAAO,SAAS;AACnB,UAAM,IAAI,MAAM,yCAAyC;AAAA,EAC3D,OAAO;AACL,UAAM,EAAE,GAAG,IAAI,OAAO;AACtB,WAAO,IAAI,2BAA2B,IAAI,UAAU,SAAS,OAAO;AAAA,EACtE;AACF;AAEA,eAAsB,oCAA0E;AAC9F,QAAM,SAAS,MAAM,IAAI,yCAAyC,EAAE,QAAQ;AAC5E,MAAI,CAAC,OAAO,SAAS;AACnB,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D,OAAO;AACL,UAAM,EAAE,GAAG,IAAI,OAAO;AACtB,WAAO,IAAI,4BAA4B,EAAE;AAAA,EAC3C;AACF;","names":[]}

package/dist/SpatializedStatic3DElement.d.ts

@@ -0,0 +1,195 @@
+import { ag as SpatializedElement, o as ModelSource, n as ModelLoadingMode, ap as SpatializedStatic3DElementProperties, aK as CommandResult, aS as AnimationStateChangeDetail, aT as ModelLoadSuccess, aU as ModelLoadFailure, aV as ReceiveEventData, aW as AnimationStateChangeMsg, aX as EntityTransformChangeMsg, aq as StageMode } 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';
+
+/**
+ * Represents a static 3D model element in the spatial environment.
+ * This class handles loading and displaying pre-built 3D models from URLs,
+ * and provides events for load success and failure.
+ */
+declare class SpatializedStatic3DElement extends SpatializedElement {
+    /**
+     * Identifies the motion target kind supported by this element.
+     */
+    readonly kind: "static3d";
+    /**
+     * Creates a new spatialized static 3D element with the specified ID and URL.
+     * Registers the element to receive spatial events.
+     * @param id Unique identifier for this element
+     * @param modelURL URL of the 3D model
+     * @param sources Optional fallback model sources
+     * @param loading Initial loading mode (`'eager'` by default)
+     */
+    constructor(id: string, modelURL?: string, sources?: ModelSource[], loading?: ModelLoadingMode);
+    /**
+     * Promise resolver for the ready state.
+     * Used to resolve the ready promise when the model is loaded.
+     */
+    private _readyResolve?;
+    /**
+     * Caches the last model URL to detect changes.
+     * Used to reset the ready promise when the model URL changes.
+     */
+    private modelURL?;
+    get modelUrl(): string | undefined;
+    /**
+     * Caches the last sources array to detect changes.
+     */
+    private sources?;
+    /**
+     * The model URL that was successfully loaded by the native runtime.
+     */
+    private _currentSrc;
+    get currentSrc(): string;
+    /**
+     * Creates a new promise for tracking the ready state of the model.
+     * @returns Promise that resolves when the model is loaded (true) or fails to load (false)
+     */
+    private createReadyPromise;
+    /**
+     * Promise that resolves when the model is loaded.
+     * Resolves to true on successful load, false on failure.
+     */
+    ready: Promise<boolean>;
+    /**
+     * Updates the properties of this static 3D element.
+     * Handles special case for modelURL changes by resetting the ready promise.
+     * @param properties Partial set of properties to update
+     * @returns Promise resolving when the update is complete
+     */
+    updateProperties(properties: Partial<SpatializedStatic3DElementProperties>): Promise<CommandResult<any>>;
+    /**
+     * Total animation duration in seconds, synced from native.
+     */
+    private _duration;
+    /**
+     * Returns the total animation duration in seconds.
+     */
+    get duration(): number;
+    /**
+     * Playback speed multiplier.
+     */
+    private _playbackRate;
+    /**
+     * Returns the current playback rate.
+     */
+    get playbackRate(): number;
+    /**
+     * Sets the playback rate and sends it to native.
+     */
+    set playbackRate(value: number);
+    /**
+     * Last playback position sampled from native (seconds).
+     */
+    private _currentTime;
+    /**
+     * Unix epoch time (ms) corresponding to `_currentTime`. Sourced from the
+     * native `timestamp` on samples, or `Date.now()` on local seeks/transitions.
+     */
+    private _anchorTimestamp;
+    private clampTime;
+    /**
+     * Returns the current (un-scaled) playback position in seconds. While
+     * playing, the value is extrapolated from the last anchor using
+     * `playbackRate` and clamped to `[0, duration]`; while paused it returns
+     * the anchor directly.
+     */
+    get currentTime(): number;
+    /**
+     * Seeks the animation to `value` seconds (clamped to `[0, duration]`) and
+     * forwards the request to native.
+     */
+    set currentTime(value: number);
+    /**
+     * Whether the animation is currently paused.
+     */
+    private _paused;
+    /**
+     * Returns whether the animation is currently paused.
+     */
+    get paused(): boolean;
+    /**
+     * Callback for animation state changes.
+     */
+    private _onAnimationStateChangeCallback?;
+    /**
+     * Sets the callback for animation state changes.
+     */
+    set onAnimationStateChangeCallback(callback: undefined | ((detail: AnimationStateChangeDetail) => void));
+    /**
+     * Starts or resumes animation playback.
+     * @returns Promise resolving when the command is sent
+     */
+    play(): Promise<void>;
+    /**
+     * Pauses animation playback.
+     * @returns Promise resolving when the command is sent
+     */
+    pause(): Promise<void>;
+    /**
+     * Processes events received from the WebSpatial environment.
+     * Handles model loading events in addition to base spatial events.
+     * @param data The event data received from the WebSpatial system
+     */
+    onReceiveEvent(data: Static3DReceiveEventData): void;
+    /**
+     * Whether the model should automatically play its first animation on load.
+     */
+    private _autoplay;
+    /**
+     * Returns whether autoplay is enabled for this element.
+     */
+    get autoplay(): boolean;
+    /**
+     * Asset fetch policy. `'lazy'` defers fetching until the host signals the
+     * element is in view; `'eager'` fetches immediately.
+     */
+    private _loading;
+    get loading(): ModelLoadingMode;
+    /**
+     * Whether the model animation should loop continuously.
+     */
+    private _loop;
+    /**
+     * Returns whether loop is enabled for this element.
+     */
+    get loop(): boolean;
+    /**
+     * Callback function for successful model loading.
+     */
+    private _onLoadCallback?;
+    /**
+     * Sets the callback function for successful model loading.
+     * @param callback Function to call when the model is loaded successfully
+     */
+    set onLoadCallback(callback: undefined | (() => void));
+    /**
+     * Callback function for model loading failure.
+     */
+    private _onLoadFailureCallback?;
+    /**
+     * Sets the callback function for model loading failure.
+     * @param callback Function to call when the model fails to load
+     */
+    set onLoadFailureCallback(callback: undefined | (() => void));
+    /**
+     * Built-in interaction mode. In `'orbit'` the native layer drives the
+     * transform and `entityTransform` is read-only.
+     */
+    private _stagemode;
+    get stagemode(): StageMode;
+    /**
+     * Latest transform of the model, including native-driven manipulations such
+     * as orbit interaction.
+     */
+    private _entityTransform;
+    get entityTransform(): DOMMatrixReadOnly;
+    set entityTransform(transform: DOMMatrixReadOnly);
+}
+type Static3DReceiveEventData = ModelLoadSuccess | ModelLoadFailure | ReceiveEventData | AnimationStateChangeMsg | EntityTransformChangeMsg;
+
+export { SpatializedStatic3DElement };

package/dist/SpatializedStatic3DElement.js

@@ -0,0 +1,327 @@
+import { UpdateSpatializedStatic3DElementProperties } from "./JSBCommand";
+import { SpatializedElement } from "./SpatializedElement";
+import {
+  SpatialWebMsgType
+} from "./WebMsgCommand";
+class SpatializedStatic3DElement extends SpatializedElement {
+  /**
+   * Identifies the motion target kind supported by this element.
+   */
+  kind = "static3d";
+  /**
+   * Creates a new spatialized static 3D element with the specified ID and URL.
+   * Registers the element to receive spatial events.
+   * @param id Unique identifier for this element
+   * @param modelURL URL of the 3D model
+   * @param sources Optional fallback model sources
+   * @param loading Initial loading mode (`'eager'` by default)
+   */
+  constructor(id, modelURL, sources, loading = "eager") {
+    super(id);
+    this.modelURL = modelURL;
+    this.sources = sources;
+    this._loading = loading;
+  }
+  /**
+   * Promise resolver for the ready state.
+   * Used to resolve the ready promise when the model is loaded.
+   */
+  _readyResolve;
+  /**
+   * Caches the last model URL to detect changes.
+   * Used to reset the ready promise when the model URL changes.
+   */
+  modelURL;
+  // @TODO: Deprecate modelURL property from Web and Swift code
+  get modelUrl() {
+    return this.modelURL;
+  }
+  /**
+   * Caches the last sources array to detect changes.
+   */
+  sources;
+  /**
+   * The model URL that was successfully loaded by the native runtime.
+   */
+  _currentSrc = "";
+  get currentSrc() {
+    return this._currentSrc;
+  }
+  /**
+   * Creates a new promise for tracking the ready state of the model.
+   * @returns Promise that resolves when the model is loaded (true) or fails to load (false)
+   */
+  createReadyPromise() {
+    this._readyResolve?.(false);
+    return new Promise((resolve) => {
+      this._readyResolve = resolve;
+    });
+  }
+  /**
+   * Promise that resolves when the model is loaded.
+   * Resolves to true on successful load, false on failure.
+   */
+  ready = this.createReadyPromise();
+  /**
+   * Updates the properties of this static 3D element.
+   * Handles special case for modelURL changes by resetting the ready promise.
+   * @param properties Partial set of properties to update
+   * @returns Promise resolving when the update is complete
+   */
+  async updateProperties(properties) {
+    let needsReadyReset = false;
+    if (properties.modelURL !== void 0) {
+      if (this.modelURL !== properties.modelURL) {
+        this.modelURL = properties.modelURL;
+        needsReadyReset = true;
+      }
+    }
+    if (properties.sources !== void 0) {
+      const prevJson = JSON.stringify(this.sources);
+      const nextJson = JSON.stringify(properties.sources);
+      if (prevJson !== nextJson) {
+        this.sources = properties.sources;
+        needsReadyReset = true;
+      }
+    }
+    if (needsReadyReset) {
+      this.ready = this.createReadyPromise();
+    }
+    if (properties.autoplay !== void 0) {
+      this._autoplay = properties.autoplay;
+    }
+    if (properties.loop !== void 0) {
+      this._loop = properties.loop;
+    }
+    if (properties.playbackRate !== void 0) {
+      if (!this._paused) {
+        this._currentTime = this.currentTime;
+        this._anchorTimestamp = Date.now();
+      }
+      this._playbackRate = properties.playbackRate;
+    }
+    if (properties.currentTime !== void 0) {
+      this._currentTime = properties.currentTime;
+      this._anchorTimestamp = Date.now();
+    }
+    if (properties.loading !== void 0) {
+      this._loading = properties.loading;
+    }
+    if (properties.stagemode !== void 0) {
+      this._stagemode = properties.stagemode;
+    }
+    return new UpdateSpatializedStatic3DElementProperties(
+      this,
+      properties
+    ).execute();
+  }
+  /**
+   * Total animation duration in seconds, synced from native.
+   */
+  _duration = 0;
+  /**
+   * Returns the total animation duration in seconds.
+   */
+  get duration() {
+    return this._duration;
+  }
+  /**
+   * Playback speed multiplier.
+   */
+  _playbackRate = 1;
+  /**
+   * Returns the current playback rate.
+   */
+  get playbackRate() {
+    return this._playbackRate;
+  }
+  /**
+   * Sets the playback rate and sends it to native.
+   */
+  set playbackRate(value) {
+    this.updateProperties({ playbackRate: value });
+  }
+  /**
+   * Last playback position sampled from native (seconds).
+   */
+  _currentTime = 0;
+  /**
+   * Unix epoch time (ms) corresponding to `_currentTime`. Sourced from the
+   * native `timestamp` on samples, or `Date.now()` on local seeks/transitions.
+   */
+  _anchorTimestamp = 0;
+  clampTime(time) {
+    if (!Number.isFinite(time) || time < 0) return 0;
+    if (time > this._duration) {
+      return this.loop && this.duration > 0 ? time % this._duration : this.duration;
+    }
+    return time;
+  }
+  /**
+   * Returns the current (un-scaled) playback position in seconds. While
+   * playing, the value is extrapolated from the last anchor using
+   * `playbackRate` and clamped to `[0, duration]`; while paused it returns
+   * the anchor directly.
+   */
+  get currentTime() {
+    if (this._paused) return this._currentTime;
+    const elapsed = (Date.now() - this._anchorTimestamp) / 1e3;
+    return this.clampTime(this._currentTime + elapsed * this._playbackRate);
+  }
+  /**
+   * Seeks the animation to `value` seconds (clamped to `[0, duration]`) and
+   * forwards the request to native.
+   */
+  set currentTime(value) {
+    const time = Number.isNaN(value) ? 0 : clamp(value, 0, this.duration);
+    this.updateProperties({ currentTime: time });
+  }
+  /**
+   * Whether the animation is currently paused.
+   */
+  _paused = true;
+  /**
+   * Returns whether the animation is currently paused.
+   */
+  get paused() {
+    return this._paused;
+  }
+  /**
+   * Callback for animation state changes.
+   */
+  _onAnimationStateChangeCallback;
+  /**
+   * Sets the callback for animation state changes.
+   */
+  set onAnimationStateChangeCallback(callback) {
+    this._onAnimationStateChangeCallback = callback;
+  }
+  /**
+   * Starts or resumes animation playback.
+   * @returns Promise resolving when the command is sent
+   */
+  async play() {
+    if (this._paused) {
+      this._anchorTimestamp = Date.now();
+    }
+    this._paused = false;
+    await this.updateProperties({ animationPaused: false });
+  }
+  /**
+   * Pauses animation playback.
+   * @returns Promise resolving when the command is sent
+   */
+  async pause() {
+    if (!this._paused) {
+      this._currentTime = this.currentTime;
+      this._anchorTimestamp = Date.now();
+    }
+    this._paused = true;
+    await this.updateProperties({ animationPaused: true });
+  }
+  /**
+   * Processes events received from the WebSpatial environment.
+   * Handles model loading events in addition to base spatial events.
+   * @param data The event data received from the WebSpatial system
+   */
+  onReceiveEvent(data) {
+    if (data.type === SpatialWebMsgType.modelloaded) {
+      this._currentSrc = data.detail?.src ?? this.modelURL ?? "";
+      this._onLoadCallback?.();
+      this._readyResolve?.(true);
+    } else if (data.type === SpatialWebMsgType.modelloadfailed) {
+      this._onLoadFailureCallback?.();
+      this._readyResolve?.(false);
+    } else if (data.type === SpatialWebMsgType.animationstatechange) {
+      this._paused = data.detail.paused;
+      this._duration = data.detail.duration;
+      this._currentTime = data.detail.currentTime ?? 0;
+      this._anchorTimestamp = data.detail.timestamp ?? Date.now();
+      this._onAnimationStateChangeCallback?.(data.detail);
+    } else if (data.type === SpatialWebMsgType.entitytransformchange) {
+      this._entityTransform = new DOMMatrixReadOnly(data.detail.transform);
+    } else {
+      super.onReceiveEvent(data);
+    }
+  }
+  /**
+   * Whether the model should automatically play its first animation on load.
+   */
+  _autoplay = false;
+  /**
+   * Returns whether autoplay is enabled for this element.
+   */
+  get autoplay() {
+    return this._autoplay;
+  }
+  /**
+   * Asset fetch policy. `'lazy'` defers fetching until the host signals the
+   * element is in view; `'eager'` fetches immediately.
+   */
+  _loading = "eager";
+  get loading() {
+    return this._loading;
+  }
+  /**
+   * Whether the model animation should loop continuously.
+   */
+  _loop = false;
+  /**
+   * Returns whether loop is enabled for this element.
+   */
+  get loop() {
+    return this._loop;
+  }
+  /**
+   * Callback function for successful model loading.
+   */
+  _onLoadCallback;
+  /**
+   * Sets the callback function for successful model loading.
+   * @param callback Function to call when the model is loaded successfully
+   */
+  set onLoadCallback(callback) {
+    this._onLoadCallback = callback;
+  }
+  /**
+   * Callback function for model loading failure.
+   */
+  _onLoadFailureCallback;
+  /**
+   * Sets the callback function for model loading failure.
+   * @param callback Function to call when the model fails to load
+   */
+  set onLoadFailureCallback(callback) {
+    this._onLoadFailureCallback = callback;
+  }
+  /**
+   * Built-in interaction mode. In `'orbit'` the native layer drives the
+   * transform and `entityTransform` is read-only.
+   */
+  _stagemode = "none";
+  get stagemode() {
+    return this._stagemode;
+  }
+  /**
+   * Latest transform of the model, including native-driven manipulations such
+   * as orbit interaction.
+   */
+  _entityTransform = new DOMMatrixReadOnly();
+  get entityTransform() {
+    return this._entityTransform;
+  }
+  set entityTransform(transform) {
+    if (this._stagemode === "orbit") return;
+    this._entityTransform = transform;
+    this.updateProperties({
+      modelTransform: Array.from(transform.toFloat64Array())
+    });
+  }
+}
+function clamp(num, min, max) {
+  return num <= min ? min : num >= max ? max : num;
+}
+export {
+  SpatializedStatic3DElement
+};
+//# sourceMappingURL=SpatializedStatic3DElement.js.map

package/dist/SpatializedStatic3DElement.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/SpatializedStatic3DElement.ts"],"sourcesContent":["import { UpdateSpatializedStatic3DElementProperties } from './JSBCommand'\nimport { ReceiveEventData, SpatializedElement } from './SpatializedElement'\nimport {\n  ModelLoadingMode,\n  ModelSource,\n  SpatializedStatic3DElementProperties,\n  StageMode,\n} from './types/types'\nimport {\n  ModelLoadSuccess,\n  ModelLoadFailure,\n  SpatialWebMsgType,\n  AnimationStateChangeDetail,\n  AnimationStateChangeMsg,\n  EntityTransformChangeMsg,\n} from './WebMsgCommand'\n\n/**\n * Represents a static 3D model element in the spatial environment.\n * This class handles loading and displaying pre-built 3D models from URLs,\n * and provides events for load success and failure.\n */\nexport class SpatializedStatic3DElement extends SpatializedElement {\n  /**\n   * Identifies the motion target kind supported by this element.\n   */\n  override readonly kind = 'static3d' as const\n\n  /**\n   * Creates a new spatialized static 3D element with the specified ID and URL.\n   * Registers the element to receive spatial events.\n   * @param id Unique identifier for this element\n   * @param modelURL URL of the 3D model\n   * @param sources Optional fallback model sources\n   * @param loading Initial loading mode (`'eager'` by default)\n   */\n  constructor(\n    id: string,\n    modelURL?: string,\n    sources?: ModelSource[],\n    loading: ModelLoadingMode = 'eager',\n  ) {\n    super(id)\n    this.modelURL = modelURL\n    this.sources = sources\n    this._loading = loading\n  }\n\n  /**\n   * Promise resolver for the ready state.\n   * Used to resolve the ready promise when the model is loaded.\n   */\n  private _readyResolve?: (success: boolean) => void\n\n  /**\n   * Caches the last model URL to detect changes.\n   * Used to reset the ready promise when the model URL changes.\n   */\n  private modelURL?: string\n  // @TODO: Deprecate modelURL property from Web and Swift code\n  get modelUrl(): string | undefined {\n    return this.modelURL\n  }\n\n  /**\n   * Caches the last sources array to detect changes.\n   */\n  private sources?: ModelSource[]\n\n  /**\n   * The model URL that was successfully loaded by the native runtime.\n   */\n  private _currentSrc: string = ''\n\n  get currentSrc(): string {\n    return this._currentSrc\n  }\n\n  /**\n   * Creates a new promise for tracking the ready state of the model.\n   * @returns Promise that resolves when the model is loaded (true) or fails to load (false)\n   */\n  private createReadyPromise() {\n    // If there's an existing promise reject it before it's replaced\n    this._readyResolve?.(false)\n    return new Promise<boolean>(resolve => {\n      this._readyResolve = resolve\n    })\n  }\n\n  /**\n   * Promise that resolves when the model is loaded.\n   * Resolves to true on successful load, false on failure.\n   */\n  ready: Promise<boolean> = this.createReadyPromise()\n\n  /**\n   * Updates the properties of this static 3D element.\n   * Handles special case for modelURL changes by resetting the ready promise.\n   * @param properties Partial set of properties to update\n   * @returns Promise resolving when the update is complete\n   */\n  async updateProperties(\n    properties: Partial<SpatializedStatic3DElementProperties>,\n  ) {\n    let needsReadyReset = false\n    if (properties.modelURL !== undefined) {\n      if (this.modelURL !== properties.modelURL) {\n        this.modelURL = properties.modelURL\n        needsReadyReset = true\n      }\n    }\n    if (properties.sources !== undefined) {\n      const prevJson = JSON.stringify(this.sources)\n      const nextJson = JSON.stringify(properties.sources)\n      if (prevJson !== nextJson) {\n        this.sources = properties.sources\n        needsReadyReset = true\n      }\n    }\n    if (needsReadyReset) {\n      this.ready = this.createReadyPromise()\n    }\n    if (properties.autoplay !== undefined) {\n      this._autoplay = properties.autoplay\n    }\n    if (properties.loop !== undefined) {\n      this._loop = properties.loop\n    }\n    if (properties.playbackRate !== undefined) {\n      // Re-anchor so extrapolation uses the new rate only for future elapsed\n      // time, not the window between the last sample and this change.\n      if (!this._paused) {\n        this._currentTime = this.currentTime\n        this._anchorTimestamp = Date.now()\n      }\n      this._playbackRate = properties.playbackRate\n    }\n    if (properties.currentTime !== undefined) {\n      // Optimistically update the local anchor so subsequent reads reflect\n      // the requested seek without waiting for the next native sample.\n      this._currentTime = properties.currentTime\n      this._anchorTimestamp = Date.now()\n    }\n    if (properties.loading !== undefined) {\n      this._loading = properties.loading\n    }\n    if (properties.stagemode !== undefined) {\n      this._stagemode = properties.stagemode\n    }\n    return new UpdateSpatializedStatic3DElementProperties(\n      this,\n      properties,\n    ).execute()\n  }\n\n  /**\n   * Total animation duration in seconds, synced from native.\n   */\n  private _duration: number = 0\n\n  /**\n   * Returns the total animation duration in seconds.\n   */\n  get duration(): number {\n    return this._duration\n  }\n\n  /**\n   * Playback speed multiplier.\n   */\n  private _playbackRate: number = 1\n\n  /**\n   * Returns the current playback rate.\n   */\n  get playbackRate(): number {\n    return this._playbackRate\n  }\n\n  /**\n   * Sets the playback rate and sends it to native.\n   */\n  set playbackRate(value: number) {\n    this.updateProperties({ playbackRate: value })\n  }\n\n  /**\n   * Last playback position sampled from native (seconds).\n   */\n  private _currentTime: number = 0\n\n  /**\n   * Unix epoch time (ms) corresponding to `_currentTime`. Sourced from the\n   * native `timestamp` on samples, or `Date.now()` on local seeks/transitions.\n   */\n  private _anchorTimestamp: number = 0\n\n  private clampTime(time: number): number {\n    if (!Number.isFinite(time) || time < 0) return 0\n    // When looping the current time is modulo the duration\n    if (time > this._duration) {\n      return this.loop && this.duration > 0\n        ? time % this._duration\n        : this.duration\n    }\n    return time\n  }\n\n  /**\n   * Returns the current (un-scaled) playback position in seconds. While\n   * playing, the value is extrapolated from the last anchor using\n   * `playbackRate` and clamped to `[0, duration]`; while paused it returns\n   * the anchor directly.\n   */\n  get currentTime(): number {\n    if (this._paused) return this._currentTime\n    const elapsed = (Date.now() - this._anchorTimestamp) / 1000\n    return this.clampTime(this._currentTime + elapsed * this._playbackRate)\n  }\n\n  /**\n   * Seeks the animation to `value` seconds (clamped to `[0, duration]`) and\n   * forwards the request to native.\n   */\n  set currentTime(value: number) {\n    const time = Number.isNaN(value) ? 0 : clamp(value, 0, this.duration)\n    this.updateProperties({ currentTime: time })\n  }\n\n  /**\n   * Whether the animation is currently paused.\n   */\n  private _paused: boolean = true\n\n  /**\n   * Returns whether the animation is currently paused.\n   */\n  get paused(): boolean {\n    return this._paused\n  }\n\n  /**\n   * Callback for animation state changes.\n   */\n  private _onAnimationStateChangeCallback?: (\n    detail: AnimationStateChangeDetail,\n  ) => void\n\n  /**\n   * Sets the callback for animation state changes.\n   */\n  set onAnimationStateChangeCallback(\n    callback: undefined | ((detail: AnimationStateChangeDetail) => void),\n  ) {\n    this._onAnimationStateChangeCallback = callback\n  }\n\n  /**\n   * Starts or resumes animation playback.\n   * @returns Promise resolving when the command is sent\n   */\n  async play(): Promise<void> {\n    if (this._paused) {\n      // Start extrapolating from the last known position on resume.\n      this._anchorTimestamp = Date.now()\n    }\n    this._paused = false\n    await this.updateProperties({ animationPaused: false })\n  }\n\n  /**\n   * Pauses animation playback.\n   * @returns Promise resolving when the command is sent\n   */\n  async pause(): Promise<void> {\n    if (!this._paused) {\n      // Freeze the extrapolated position so reads remain stable until the\n      // next native sample arrives.\n      this._currentTime = this.currentTime\n      this._anchorTimestamp = Date.now()\n    }\n    this._paused = true\n    await this.updateProperties({ animationPaused: true })\n  }\n\n  /**\n   * Processes events received from the WebSpatial environment.\n   * Handles model loading events in addition to base spatial events.\n   * @param data The event data received from the WebSpatial system\n   */\n  override onReceiveEvent(data: Static3DReceiveEventData) {\n    if (data.type === SpatialWebMsgType.modelloaded) {\n      // On old runtimes (<⍺2.1) detail is not returned so fallback to modelURL\n      this._currentSrc = data.detail?.src ?? this.modelURL ?? ''\n      // Handle successful model loading\n      this._onLoadCallback?.()\n      this._readyResolve?.(true)\n    } else if (data.type === SpatialWebMsgType.modelloadfailed) {\n      // Handle model loading failure\n      this._onLoadFailureCallback?.()\n      this._readyResolve?.(false)\n    } else if (data.type === SpatialWebMsgType.animationstatechange) {\n      this._paused = data.detail.paused\n      this._duration = data.detail.duration\n      // In unsupported environments currentTime is invalid\n      this._currentTime = data.detail.currentTime ?? 0\n      this._anchorTimestamp = data.detail.timestamp ?? Date.now()\n      this._onAnimationStateChangeCallback?.(data.detail)\n    } else if (data.type === SpatialWebMsgType.entitytransformchange) {\n      this._entityTransform = new DOMMatrixReadOnly(data.detail.transform)\n    } else {\n      // Handle other spatial events using the base class implementation\n      super.onReceiveEvent(data)\n    }\n  }\n\n  /**\n   * Whether the model should automatically play its first animation on load.\n   */\n  private _autoplay: boolean = false\n\n  /**\n   * Returns whether autoplay is enabled for this element.\n   */\n  get autoplay(): boolean {\n    return this._autoplay\n  }\n\n  /**\n   * Asset fetch policy. `'lazy'` defers fetching until the host signals the\n   * element is in view; `'eager'` fetches immediately.\n   */\n  private _loading: ModelLoadingMode = 'eager'\n\n  get loading(): ModelLoadingMode {\n    return this._loading\n  }\n\n  /**\n   * Whether the model animation should loop continuously.\n   */\n  private _loop: boolean = false\n\n  /**\n   * Returns whether loop is enabled for this element.\n   */\n  get loop(): boolean {\n    return this._loop\n  }\n\n  /**\n   * Callback function for successful model loading.\n   */\n  private _onLoadCallback?: () => void\n\n  /**\n   * Sets the callback function for successful model loading.\n   * @param callback Function to call when the model is loaded successfully\n   */\n  set onLoadCallback(callback: undefined | (() => void)) {\n    this._onLoadCallback = callback\n  }\n\n  /**\n   * Callback function for model loading failure.\n   */\n  private _onLoadFailureCallback?: undefined | (() => void)\n\n  /**\n   * Sets the callback function for model loading failure.\n   * @param callback Function to call when the model fails to load\n   */\n  set onLoadFailureCallback(callback: undefined | (() => void)) {\n    this._onLoadFailureCallback = callback\n  }\n\n  /**\n   * Built-in interaction mode. In `'orbit'` the native layer drives the\n   * transform and `entityTransform` is read-only.\n   */\n  private _stagemode: StageMode = 'none'\n\n  get stagemode(): StageMode {\n    return this._stagemode\n  }\n\n  /**\n   * Latest transform of the model, including native-driven manipulations such\n   * as orbit interaction.\n   */\n  private _entityTransform: DOMMatrixReadOnly = new DOMMatrixReadOnly()\n\n  get entityTransform(): DOMMatrixReadOnly {\n    return this._entityTransform\n  }\n\n  set entityTransform(transform: DOMMatrixReadOnly) {\n    // In orbit mode the native layer owns the transform, so ignore writes.\n    if (this._stagemode === 'orbit') return\n    this._entityTransform = transform\n    // The public API is `entityTransform`, but the JSB property stays\n    // `modelTransform` so the native side remains backward compatible.\n    this.updateProperties({\n      modelTransform: Array.from(transform.toFloat64Array()),\n    })\n  }\n}\n\n// Equivalent of proposed Math.clamp\nfunction clamp(num: number, min: number, max: number) {\n  return num <= min ? min : num >= max ? max : num\n}\n\ntype Static3DReceiveEventData =\n  | ModelLoadSuccess\n  | ModelLoadFailure\n  | ReceiveEventData\n  | AnimationStateChangeMsg\n  | EntityTransformChangeMsg\n"],"mappings":"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","names":[]}

package/dist/WebMsgCommand.d.ts

@@ -0,0 +1,7 @@
+export { b3 as AnimationCanceledEventPayload, b4 as AnimationCompletedEventPayload, b5 as AnimationFailedEventPayload, aS as AnimationStateChangeDetail, aW as AnimationStateChangeMsg, b6 as EntityTransformChangeDetail, aX as EntityTransformChangeMsg, aU as ModelLoadFailure, aT as ModelLoadSuccess, b7 as ObjectDestroyMsg, b8 as SpatialDragEndMsg, b9 as SpatialDragMsg, ba as SpatialDragStartMsg, bb as SpatialMagnifyEndMsg, bc as SpatialMagnifyMsg, bd as SpatialRotateEndMsg, be as SpatialRotateMsg, bf as SpatialTapMsg, aP as SpatialWebMsgType } 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';

package/dist/WebMsgCommand.js

@@ -0,0 +1,23 @@
+var SpatialWebMsgType = /* @__PURE__ */ ((SpatialWebMsgType2) => {
+  SpatialWebMsgType2["modelloaded"] = "modelloaded";
+  SpatialWebMsgType2["modelloadfailed"] = "modelloadfailed";
+  SpatialWebMsgType2["spatialtap"] = "spatialtap";
+  SpatialWebMsgType2["spatialdragstart"] = "spatialdragstart";
+  SpatialWebMsgType2["spatialdrag"] = "spatialdrag";
+  SpatialWebMsgType2["spatialdragend"] = "spatialdragend";
+  SpatialWebMsgType2["spatialrotate"] = "spatialrotate";
+  SpatialWebMsgType2["spatialrotateend"] = "spatialrotateend";
+  SpatialWebMsgType2["spatialmagnify"] = "spatialmagnify";
+  SpatialWebMsgType2["spatialmagnifyend"] = "spatialmagnifyend";
+  SpatialWebMsgType2["animationstatechange"] = "animationstatechange";
+  SpatialWebMsgType2["entitytransformchange"] = "entitytransformchange";
+  SpatialWebMsgType2["animationcompleted"] = "animationcompleted";
+  SpatialWebMsgType2["animationstopped"] = "animationstopped";
+  SpatialWebMsgType2["animationfailed"] = "animationfailed";
+  SpatialWebMsgType2["objectdestroy"] = "objectdestroy";
+  return SpatialWebMsgType2;
+})(SpatialWebMsgType || {});
+export {
+  SpatialWebMsgType
+};
+//# sourceMappingURL=WebMsgCommand.js.map

package/dist/WebMsgCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/WebMsgCommand.ts"],"sourcesContent":["import {\n  SpatialDragEventDetail,\n  SpatialTapEventDetail,\n  SpatialRotateEventDetail,\n  SpatialMagnifyEventDetail,\n  SpatialDragStartEventDetail,\n  SpatialDragEndEventDetail,\n} from './types/types'\n\nexport enum SpatialWebMsgType {\n  modelloaded = 'modelloaded',\n  modelloadfailed = 'modelloadfailed',\n  spatialtap = 'spatialtap',\n  spatialdragstart = 'spatialdragstart',\n  spatialdrag = 'spatialdrag',\n  spatialdragend = 'spatialdragend',\n  spatialrotate = 'spatialrotate',\n  spatialrotateend = 'spatialrotateend',\n  spatialmagnify = 'spatialmagnify',\n  spatialmagnifyend = 'spatialmagnifyend',\n\n  animationstatechange = 'animationstatechange',\n\n  // Native-driven transform updates (e.g. while in `stagemode=\"orbit\"`)\n  entitytransformchange = 'entitytransformchange',\n\n  // Animation terminal events (keyed by animationId, not by this enum)\n  animationcompleted = 'animationcompleted',\n  animationstopped = 'animationstopped',\n  animationfailed = 'animationfailed',\n\n  objectdestroy = 'objectdestroy',\n}\n\nexport interface ObjectDestroyMsg {\n  type: SpatialWebMsgType.objectdestroy\n}\n\nexport interface SpatialTapMsg {\n  type: SpatialWebMsgType.spatialtap\n  detail: SpatialTapEventDetail\n}\n\nexport interface SpatialDragStartMsg {\n  type: SpatialWebMsgType.spatialdragstart\n  detail: SpatialDragStartEventDetail\n}\n\nexport interface SpatialDragMsg {\n  type: SpatialWebMsgType.spatialdrag\n  detail: SpatialDragEventDetail\n}\n\nexport interface SpatialDragEndMsg {\n  type: SpatialWebMsgType.spatialdragend\n  detail: SpatialDragEndEventDetail\n}\n\nexport interface SpatialRotateMsg {\n  type: SpatialWebMsgType.spatialrotate\n  detail: SpatialRotateEventDetail\n}\n\nexport interface SpatialRotateEndMsg {\n  type: SpatialWebMsgType.spatialrotateend\n  detail: SpatialRotateEventDetail\n}\n\nexport interface SpatialMagnifyMsg {\n  type: SpatialWebMsgType.spatialmagnify\n  detail: SpatialMagnifyEventDetail\n}\n\nexport interface SpatialMagnifyEndMsg {\n  type: SpatialWebMsgType.spatialmagnifyend\n  detail: SpatialMagnifyEventDetail\n}\n\nexport interface ModelLoadSuccess {\n  type: SpatialWebMsgType.modelloaded\n  // detail object is undefined in old native runtimes\n  detail?: { src: string }\n}\n\nexport interface ModelLoadFailure {\n  type: SpatialWebMsgType.modelloadfailed\n}\n\nexport interface AnimationStateChangeDetail {\n  paused: boolean\n  duration: number\n  /**\n   * Sampled animation playback position in seconds at `timestamp`.\n   * Optional for compatibility with older native runtimes.\n   */\n  currentTime?: number\n  /**\n   * Unix epoch time in milliseconds at which `currentTime` was sampled.\n   * Used to extrapolate `currentTime` between samples while playing.\n   */\n  timestamp?: number\n}\n\nexport interface AnimationStateChangeMsg {\n  type: SpatialWebMsgType.animationstatechange\n  detail: AnimationStateChangeDetail\n}\n\nexport interface EntityTransformChangeDetail {\n  /** Column-major 4x4 matrix (16 numbers) representing the manipulated transform. */\n  transform: number[]\n}\n\nexport interface EntityTransformChangeMsg {\n  type: SpatialWebMsgType.entitytransformchange\n  detail: EntityTransformChangeDetail\n}\n\n// Animation terminal event payloads (delivered via SpatialWebEvent keyed by animationId)\n\nexport interface AnimationCompletedEventPayload {\n  type: 'completed'\n  /** Column-major 4x4 matrix (16 numbers) representing the final native transform. */\n  transform: number[]\n}\n\nexport interface AnimationCanceledEventPayload {\n  type: 'canceled'\n  /** Column-major 4x4 matrix (16 numbers) representing the restored transform after cancel. */\n  transform: number[]\n}\n\nexport interface AnimationFailedEventPayload {\n  type: 'failed'\n  animationId: string\n  command: 'play' | 'pause' | 'resume' | 'cancel'\n  code?: string\n  reason: string\n}\n"],"mappings":"AASO,IAAK,oBAAL,kBAAKA,uBAAL;AACL,EAAAA,mBAAA,iBAAc;AACd,EAAAA,mBAAA,qBAAkB;AAClB,EAAAA,mBAAA,gBAAa;AACb,EAAAA,mBAAA,sBAAmB;AACnB,EAAAA,mBAAA,iBAAc;AACd,EAAAA,mBAAA,oBAAiB;AACjB,EAAAA,mBAAA,mBAAgB;AAChB,EAAAA,mBAAA,sBAAmB;AACnB,EAAAA,mBAAA,oBAAiB;AACjB,EAAAA,mBAAA,uBAAoB;AAEpB,EAAAA,mBAAA,0BAAuB;AAGvB,EAAAA,mBAAA,2BAAwB;AAGxB,EAAAA,mBAAA,wBAAqB;AACrB,EAAAA,mBAAA,sBAAmB;AACnB,EAAAA,mBAAA,qBAAkB;AAElB,EAAAA,mBAAA,mBAAgB;AAtBN,SAAAA;AAAA,GAAA;","names":["SpatialWebMsgType"]}