@webspatial/core-sdk 1.6.1 → 2.0.0

package/dist/JSBCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/JSBCommand.ts"],"sourcesContent":["import { getPlatform } from './platform-runtime'\nimport { pointToPhysical } from './physicalMetrics'\nimport {\n  getRuntime,\n  supports,\n  VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER,\n} from './runtime/supports'\nimport { SpatialComponent } from './reality/component/SpatialComponent'\nimport { SpatialEntity } from './reality/entity/SpatialEntity'\nimport { SpatialMaterial } from './reality/material/SpatialMaterial'\nimport { SpatializedDynamic3DElement } from './SpatializedDynamic3DElement'\nimport { SpatializedElement } from './SpatializedElement'\nimport { SpatialObject } from './SpatialObject'\n\nimport {\n  Spatialized2DElementProperties,\n  SpatializedElementProperties,\n  SpatializedStatic3DElementProperties,\n  SpatialSceneProperties,\n  SpatialSceneCreationOptions,\n  SpatialUnlitMaterialOptions,\n  SpatialGeometryOptions,\n  SpatialGeometryType,\n  ModelComponentOptions,\n  SpatialEntityProperties,\n  ModelAssetOptions,\n  SpatialModelEntityCreationOptions,\n  SpatialEntityEventType,\n  Vec3,\n  AttachmentEntityOptions,\n  AttachmentEntityUpdateOptions,\n  ModelLoadingMode,\n  ModelSource,\n  SpatialTextureResourceOptions,\n} from './types/types'\nimport type { AnimateTransformCommand } from './types/animation'\nimport { composeSRT } from './utils'\nimport type {\n  ControlSpatializedElementAnimationCommand,\n  CreateSpatializedElementAnimationCommand,\n} from './types/motion/spatializedElementMotion'\n\nabstract class JSBCommand {\n  commandType: string = ''\n  protected abstract getParams(): Record<string, any> | undefined\n\n  async execute() {\n    const param = this.getParams()\n    const msg = param ? JSON.stringify(param) : ''\n    const platform = await getPlatform()\n    return platform.callJSB(this.commandType, msg)\n  }\n}\n\nexport class UpdateEntityPropertiesCommand extends JSBCommand {\n  commandType = 'UpdateEntityProperties'\n\n  constructor(\n    public entity: SpatialEntity,\n    public properties: Partial<SpatialEntityProperties>,\n  ) {\n    super()\n  }\n\n  protected getParams() {\n    const transform = composeSRT(\n      this.properties.position ?? this.entity.position,\n      this.properties.rotation ?? this.entity.rotation,\n      this.properties.scale ?? this.entity.scale,\n    ).toFloat64Array()\n    return {\n      entityId: this.entity.id,\n      transform,\n    }\n  }\n}\n\nexport class UpdateEntityEventCommand extends JSBCommand {\n  commandType = 'UpdateEntityEvent'\n\n  constructor(\n    public entity: SpatialEntity,\n    public type: SpatialEntityEventType,\n    public isEnable: boolean,\n  ) {\n    super()\n  }\n\n  protected getParams() {\n    return {\n      type: this.type,\n      entityId: this.entity.id,\n      isEnable: this.isEnable,\n    }\n  }\n}\n\n// todo: to be used in SpatialEntity\nexport class UpdateEntityEventsCommand extends JSBCommand {\n  // let types:[String:Bool]\n  // let entityId:String\n  constructor(\n    public entity: SpatialEntity,\n    public types: Record<SpatialEntityEventType, boolean>,\n  ) {\n    super()\n  }\n\n  protected getParams() {\n    return {\n      entityId: this.entity.id,\n      types: this.types,\n    }\n  }\n}\n\nexport class UpdateSpatialSceneProperties extends JSBCommand {\n  properties: Partial<SpatialSceneProperties>\n  commandType = 'UpdateSpatialSceneProperties'\n\n  constructor(properties: Partial<SpatialSceneProperties>) {\n    super()\n    this.properties = properties\n  }\n\n  protected getParams() {\n    return this.properties\n  }\n}\n\nexport class UpdateSceneConfig extends JSBCommand {\n  config: SpatialSceneCreationOptions\n  commandType = 'UpdateSceneConfig'\n\n  constructor(config: SpatialSceneCreationOptions) {\n    super()\n    this.config = config\n  }\n\n  protected getParams(): Record<string, any> | undefined {\n    return { config: this.config }\n  }\n}\n\nexport class FocusScene extends JSBCommand {\n  commandType = 'FocusScene'\n\n  constructor(public id: string) {\n    super()\n  }\n\n  protected getParams(): Record<string, any> | undefined {\n    return { id: this.id }\n  }\n}\n\nexport class GetSpatialSceneState extends JSBCommand {\n  commandType = 'GetSpatialSceneState'\n\n  constructor() {\n    super()\n  }\n\n  protected getParams(): Record<string, any> | undefined {\n    return {}\n  }\n}\n\nexport abstract class SpatializedElementCommand extends JSBCommand {\n  constructor(readonly spatialObject: SpatialObject) {\n    super()\n  }\n\n  protected getParams() {\n    const extraParams = this.getExtraParams()\n    return { id: this.spatialObject.id, ...extraParams }\n  }\n\n  protected abstract getExtraParams(): Record<string, any> | undefined\n}\n\nexport class UpdateSpatialized2DElementProperties extends SpatializedElementCommand {\n  properties: Partial<Spatialized2DElementProperties>\n  commandType = 'UpdateSpatialized2DElementProperties'\n\n  constructor(\n    spatialObject: SpatialObject,\n    properties: Partial<SpatializedElementProperties>,\n  ) {\n    super(spatialObject)\n    this.properties = properties\n  }\n\n  protected getExtraParams() {\n    return this.properties\n  }\n}\n\nexport class UpdateSpatializedDynamic3DElementProperties extends SpatializedElementCommand {\n  properties: Partial<Spatialized2DElementProperties>\n  commandType = 'UpdateSpatializedDynamic3DElementProperties'\n\n  constructor(\n    spatialObject: SpatialObject,\n    properties: Partial<SpatializedElementProperties>,\n  ) {\n    super(spatialObject)\n    this.properties = properties\n  }\n\n  protected getExtraParams() {\n    return {\n      id: this.spatialObject.id,\n      ...this.properties,\n    }\n  }\n}\n\nexport class UpdateUnlitMaterialProperties extends SpatializedElementCommand {\n  properties: Partial<SpatialUnlitMaterialOptions>\n  commandType = 'UpdateUnlitMaterialProperties'\n\n  constructor(\n    spatialObject: SpatialObject,\n    properties: Partial<SpatialUnlitMaterialOptions>,\n  ) {\n    super(spatialObject)\n    this.properties = properties\n  }\n\n  protected getExtraParams() {\n    return this.properties\n  }\n}\n\nexport class UpdateSpatializedElementTransform extends SpatializedElementCommand {\n  matrix: DOMMatrix\n  commandType = 'UpdateSpatializedElementTransform'\n\n  constructor(spatialObject: SpatialObject, matrix: DOMMatrix) {\n    super(spatialObject)\n    this.matrix = matrix\n  }\n\n  protected getExtraParams() {\n    return { matrix: Array.from(this.matrix.toFloat64Array()) }\n  }\n}\n\nexport class UpdateSpatializedStatic3DElementProperties extends SpatializedElementCommand {\n  properties: Partial<SpatializedStatic3DElementProperties>\n  commandType = 'UpdateSpatializedStatic3DElementProperties'\n\n  constructor(\n    spatialObject: SpatialObject,\n    properties: Partial<SpatializedStatic3DElementProperties>,\n  ) {\n    super(spatialObject)\n    this.properties = properties\n  }\n\n  protected getExtraParams() {\n    return this.properties\n  }\n}\n\nexport class AddSpatializedElementToSpatialized2DElement extends SpatializedElementCommand {\n  commandType = 'AddSpatializedElementToSpatialized2DElement'\n  spatializedElement: SpatializedElement\n\n  constructor(\n    spatialObject: SpatialObject,\n    spatializedElement: SpatializedElement,\n  ) {\n    super(spatialObject)\n    this.spatializedElement = spatializedElement\n  }\n\n  protected getExtraParams() {\n    return { spatializedElementId: this.spatializedElement.id }\n  }\n}\n\nexport class AddSpatializedElementToSpatialScene extends JSBCommand {\n  commandType = 'AddSpatializedElementToSpatialScene'\n  spatializedElement: SpatializedElement\n\n  constructor(spatializedElement: SpatializedElement) {\n    super()\n    this.spatializedElement = spatializedElement\n  }\n\n  protected getParams() {\n    return {\n      spatializedElementId: this.spatializedElement.id,\n    }\n  }\n}\n\nexport class CreateSpatializedStatic3DElementCommand extends JSBCommand {\n  commandType = 'CreateSpatializedStatic3DElement'\n\n  constructor(\n    readonly modelURL?: string,\n    readonly sources?: ModelSource[],\n    readonly loading: ModelLoadingMode = 'eager',\n  ) {\n    super()\n    this.modelURL = modelURL\n    this.sources = sources\n    this.loading = loading\n  }\n\n  protected getParams() {\n    return {\n      modelURL: this.modelURL,\n      sources: this.sources,\n      loading: this.loading,\n    }\n  }\n}\n\nexport class CreateSpatializedDynamic3DElementCommand extends JSBCommand {\n  protected getParams(): Record<string, any> | undefined {\n    return { test: true }\n  }\n  commandType = 'CreateSpatializedDynamic3DElement'\n}\n\nexport class CreateSpatialEntityCommand extends JSBCommand {\n  constructor(private name?: string) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return { name: this.name }\n  }\n  commandType = 'CreateSpatialEntity'\n}\n\nexport class CreateModelComponentCommand extends JSBCommand {\n  constructor(private options: ModelComponentOptions) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    let geometryId = this.options.mesh.id\n    let materialIds = this.options.materials.map(material => material.id)\n    return { geometryId, materialIds }\n  }\n  commandType = 'CreateModelComponent'\n}\n\nexport class CreateSpatialModelEntityCommand extends JSBCommand {\n  constructor(private options: SpatialModelEntityCreationOptions) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return this.options\n  }\n  commandType = 'CreateSpatialModelEntity'\n}\n\nexport class CreateModelAssetCommand extends JSBCommand {\n  constructor(private options: ModelAssetOptions) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return { url: this.options.url }\n  }\n  commandType = 'CreateModelAsset'\n}\n\nexport class CreateSpatialGeometryCommand extends JSBCommand {\n  constructor(\n    private type: SpatialGeometryType,\n    private options: SpatialGeometryOptions = {},\n  ) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return { type: this.type, ...this.options }\n  }\n  commandType = 'CreateGeometry'\n}\n\nexport class CreateSpatialUnlitMaterialCommand extends JSBCommand {\n  constructor(private options: SpatialUnlitMaterialOptions) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return this.options\n  }\n  commandType = 'CreateUnlitMaterial'\n}\n\nexport class AddComponentToEntityCommand extends JSBCommand {\n  constructor(\n    public entity: SpatialEntity,\n    public comp: SpatialComponent,\n  ) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      entityId: this.entity.id,\n      componentId: this.comp.id,\n    }\n  }\n  commandType = 'AddComponentToEntity'\n}\n\nexport class RemoveComponentFromEntityCommand extends JSBCommand {\n  constructor(\n    public entity: SpatialEntity,\n    public comp: SpatialComponent,\n  ) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      entityId: this.entity.id,\n      componentId: this.comp.id,\n    }\n  }\n  commandType = 'RemoveComponentFromEntity'\n}\n\nexport class SetMaterialsOnEntityCommand extends JSBCommand {\n  constructor(\n    public entityId: string,\n    public materials: SpatialMaterial[],\n  ) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      entityId: this.entityId,\n      materialIds: this.materials.map(m => m.id),\n    }\n  }\n  commandType = 'SetMaterialsOnEntity'\n}\n\nexport class AddEntityToDynamic3DCommand extends JSBCommand {\n  constructor(\n    public d3dEle: SpatializedDynamic3DElement,\n    public entity: SpatialEntity,\n  ) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      entityId: this.entity.id,\n      dynamic3dId: this.d3dEle.id,\n    }\n  }\n\n  commandType = 'AddEntityToDynamic3D'\n}\n\nexport class AddEntityToEntityCommand extends JSBCommand {\n  constructor(\n    public parent: SpatialEntity,\n    public child: SpatialEntity,\n  ) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      parentId: this.parent.id,\n      childId: this.child.id,\n    }\n  }\n  commandType = 'AddEntityToEntity'\n}\n\nexport class RemoveEntityFromParentCommand extends JSBCommand {\n  constructor(public entity: SpatialEntity) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      entityId: this.entity.id,\n    }\n  }\n  commandType = 'RemoveEntityFromParent'\n}\n\nexport class SetParentForEntityCommand extends JSBCommand {\n  // childId, parentId\n  constructor(\n    public childId: string,\n    public parentId?: string,\n  ) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      childId: this.childId,\n      parentId: this.parentId,\n    }\n  }\n  commandType = 'SetParentToEntity'\n}\n\nexport class ConvertFromEntityToEntityCommand extends JSBCommand {\n  constructor(\n    public fromEntityId: string,\n    public toEntityId: string,\n    public fromPosition: Vec3,\n  ) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      fromEntityId: this.fromEntityId,\n      toEntityId: this.toEntityId,\n      position: this.fromPosition,\n    }\n  }\n  commandType = 'ConvertFromEntityToEntity'\n}\n\nexport class ConvertFromEntityToSceneCommand extends JSBCommand {\n  constructor(\n    public fromEntityId: string,\n    public position: Vec3,\n  ) {\n    super()\n  }\n\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      fromEntityId: this.fromEntityId,\n      position: this.position,\n    }\n  }\n\n  commandType = 'ConvertFromEntityToScene'\n}\n\nexport class ConvertFromSceneToEntityCommand extends JSBCommand {\n  //  let entityId: String\n  // let position:Vec3\n  constructor(\n    public entityId: string,\n    public position: Vec3,\n  ) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      entityId: this.entityId,\n      position: this.position,\n    }\n  }\n  commandType = 'ConvertFromSceneToEntity'\n}\n\nexport class ConvertCoordinateCommand extends JSBCommand {\n  constructor(\n    public position: Vec3,\n    public fromId: string,\n    public toId: string,\n  ) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      position: this.position,\n      fromId: this.fromId,\n      toId: this.toId,\n    }\n  }\n  commandType = 'ConvertCoordinate'\n}\n\nexport class CreateTextureCommand extends JSBCommand {\n  constructor(private url: string) {\n    super()\n  }\n  protected getParams(): Record<string, any> | undefined {\n    return {\n      url: this.url,\n    }\n  }\n  commandType = 'CreateTexture'\n}\n\nexport class UpdateTexturePropertiesCommand extends SpatializedElementCommand {\n  properties: Partial<SpatialTextureResourceOptions>\n  commandType = 'UpdateTextureProperties'\n\n  constructor(\n    spatialObject: SpatialObject,\n    properties: Partial<SpatialTextureResourceOptions>,\n  ) {\n    super(spatialObject)\n    this.properties = properties\n  }\n\n  protected getExtraParams() {\n    return this.properties\n  }\n}\n\nexport class InspectCommand extends JSBCommand {\n  commandType = 'Inspect'\n\n  constructor(readonly id: string = '') {\n    super()\n  }\n\n  protected getParams() {\n    return this.id ? { id: this.id } : { id: '' }\n  }\n}\n\nexport class DestroyCommand extends JSBCommand {\n  commandType = 'Destroy'\n\n  constructor(readonly id: string) {\n    super()\n  }\n\n  protected getParams() {\n    return { id: this.id }\n  }\n}\n\nexport class CheckWebViewCanCreateCommand extends JSBCommand {\n  commandType = 'CheckWebViewCanCreate'\n\n  constructor(readonly id: string = '') {\n    super()\n  }\n\n  protected getParams() {\n    return { id: this.id }\n  }\n}\n\nexport class AnimateTransformJSBCommand extends JSBCommand {\n  commandType = 'AnimateTransform'\n\n  constructor(private command: AnimateTransformCommand) {\n    super()\n  }\n\n  protected getParams(): Record<string, any> | undefined {\n    const { type, animationId, entityId } = this.command\n    const params: Record<string, any> = { type, animationId }\n\n    if (entityId !== undefined) params.entityId = entityId\n\n    if (type === 'play') {\n      if (this.command.toTransform) {\n        params.toTransform = Array.from(this.command.toTransform)\n      }\n      if (this.command.fromTransform) {\n        params.fromTransform = Array.from(this.command.fromTransform)\n      }\n      if (this.command.duration !== undefined)\n        params.duration = this.command.duration\n      if (this.command.timingFunction !== undefined)\n        params.timingFunction = this.command.timingFunction\n      if (this.command.delay !== undefined) params.delay = this.command.delay\n      if (this.command.loop !== undefined) params.loop = this.command.loop\n      if (this.command.playbackRate !== undefined)\n        params.playbackRate = this.command.playbackRate\n    }\n\n    return params\n  }\n}\n// TODO(remove): temporary OTA0 compat shim — delete once #1330 lands and\n// attachment JSB always uses the placement-shaped payload.\nfunction usePlacementProtocol(): boolean {\n  // WS_SHELL_VERSION debug shells claim every capability via supports(), but\n  // the in-repo visionOS runtime still decodes only the legacy attachment\n  // payload — keep sending it there.\n  const rt = getRuntime()\n  if (\n    rt.type === 'visionos' &&\n    rt.shellVersion === VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER\n  ) {\n    return false\n  }\n  return supports('AttachmentEntity', ['placement'])\n}\n\nfunction toPlacementVec3(position?: [number, number, number]): {\n  x: number\n  y: number\n  z: number\n} {\n  const [x, y, z] = position ?? [0, 0, 0]\n  return { x, y, z }\n}\n\nexport class InitializeAttachmentCommand extends JSBCommand {\n  commandType = 'InitializeAttachment'\n  constructor(\n    private attachmentId: string,\n    private options: AttachmentEntityOptions,\n  ) {\n    super()\n  }\n  protected getParams() {\n    const p = this.options\n    if (!usePlacementProtocol()) {\n      return {\n        id: this.attachmentId,\n        parentEntityId: p.parentEntityId,\n        position: p.position ?? [0, 0, 0],\n        size: p.size,\n        ownerViewId: p.ownerViewId,\n      }\n    }\n    // Runtimes advertising this capability decode a Vec3 position and meter\n    // dimensions instead of the legacy tuple and point size.\n    return {\n      id: this.attachmentId,\n      placementId: p.parentEntityId,\n      position: toPlacementVec3(p.position),\n      width: pointToPhysical(p.size.width),\n      height: pointToPhysical(p.size.height),\n      ownerViewId: p.ownerViewId,\n    }\n  }\n}\n\nexport class UpdateAttachmentEntityCommand extends JSBCommand {\n  commandType = 'UpdateAttachmentEntity'\n  constructor(\n    private attachmentId: string,\n    private options: AttachmentEntityUpdateOptions,\n  ) {\n    super()\n  }\n  protected getParams() {\n    if (!usePlacementProtocol()) {\n      return {\n        id: this.attachmentId,\n        ...this.options,\n      }\n    }\n    const { position, size } = this.options\n    return {\n      id: this.attachmentId,\n      ...(position ? { position: toPlacementVec3(position) } : {}),\n      ...(size\n        ? {\n            width: pointToPhysical(size.width),\n            height: pointToPhysical(size.height),\n          }\n        : {}),\n    }\n  }\n}\n\nexport class CreateSpatializedElementAnimationJSBCommand extends JSBCommand {\n  commandType = 'CreateSpatializedElementAnimation'\n\n  constructor(private command: CreateSpatializedElementAnimationCommand) {\n    super()\n  }\n\n  protected getParams() {\n    const { elementId, timeline } = this.command\n    return {\n      elementId,\n      timeline,\n    }\n  }\n}\n\nexport class ControlSpatializedElementAnimationJSBCommand extends JSBCommand {\n  commandType = 'ControlSpatializedElementAnimation'\n\n  constructor(private command: ControlSpatializedElementAnimationCommand) {\n    super()\n  }\n\n  protected getParams() {\n    const { animationId, type } = this.command\n    return {\n      animationId,\n      type,\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/Spatial.d.ts

@@ -0,0 +1,63 @@
+import { SpatialSession } from './SpatialSession.js';
+import './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';
+import './reality/entity/SpatialModelEntity.js';
+import './reality/component/ModelComponent.js';
+import './reality/material/SpatialUnlitMaterial.js';
+import './reality/geometry/SpatialBoxGeometry.js';
+import './reality/geometry/SpatialSphereGeometry.js';
+import './reality/geometry/SpatialCylinderGeometry.js';
+import './reality/geometry/SpatialPlaneGeometry.js';
+import './reality/geometry/SpatialConeGeometry.js';
+import './reality/resource/SpatialModelAsset.js';
+import './reality/resource/SpatialTextureResource.js';
+import './reality/Attachment.js';
+import './scene-polyfill.js';
+import './SpatialScene.js';
+import './Spatialized2DElement.js';
+import './SpatializedStatic3DElement.js';
+
+/**
+ * Base object designed to be placed on navigator.spatial to mirror navigator.xr for webxr.
+ * This is the main entry point for the WebSpatial SDK, providing access to spatial capabilities.
+ */
+declare class Spatial {
+    /**
+     * Requests a spatial session object from the browser.
+     * This is the primary method to initialize spatial functionality.
+     * @returns The SpatialSession instance or null if not available in the current browser
+     * [TODO] discuss implications of this not being async
+     */
+    requestSession(): SpatialSession | null;
+    /**
+     * Checks if the current page is running in a spatial web environment.
+     * This method detects if the application is running in a WebSpatial-compatible browser.
+     * @returns True if running in a spatial web environment, false otherwise
+     */
+    runInSpatialWeb(): boolean;
+    /** @deprecated
+     * Checks if WebSpatial is supported in the current environment.
+     * Verifies compatibility between native and client versions.
+     * @returns True if web spatial is supported by this webpage
+     */
+    isSupported(): boolean;
+    /** @deprecated
+     * Gets the native WebSpatial version from the browser environment.
+     * The version format follows semantic versioning (x.x.x).
+     * @returns Native version string in format "x.x.x"
+     */
+    getNativeVersion(): any;
+    /** @deprecated
+     * Gets the client SDK version.
+     * The version format follows semantic versioning (x.x.x).
+     * @returns Client SDK version string in format "x.x.x"
+     */
+    getClientVersion(): string;
+}
+
+export { Spatial };

package/dist/Spatial.js

@@ -0,0 +1,60 @@
+import { SpatialSession } from "./SpatialSession";
+import { SpatialWebEvent } from "./SpatialWebEvent";
+class Spatial {
+  /**
+   * Requests a spatial session object from the browser.
+   * This is the primary method to initialize spatial functionality.
+   * @returns The SpatialSession instance or null if not available in the current browser
+   * [TODO] discuss implications of this not being async
+   */
+  requestSession() {
+    if (this.runInSpatialWeb()) {
+      SpatialWebEvent.init();
+      return new SpatialSession();
+    } else {
+      return null;
+    }
+  }
+  /**
+   * Checks if the current page is running in a spatial web environment.
+   * This method detects if the application is running in a WebSpatial-compatible browser.
+   * @returns True if running in a spatial web environment, false otherwise
+   */
+  runInSpatialWeb() {
+    if (navigator.userAgent.indexOf("WebSpatial/") >= 0) {
+      return true;
+    }
+    return false;
+  }
+  /** @deprecated
+   * Checks if WebSpatial is supported in the current environment.
+   * Verifies compatibility between native and client versions.
+   * @returns True if web spatial is supported by this webpage
+   */
+  isSupported() {
+    return true;
+  }
+  /** @deprecated
+   * Gets the native WebSpatial version from the browser environment.
+   * The version format follows semantic versioning (x.x.x).
+   * @returns Native version string in format "x.x.x"
+   */
+  getNativeVersion() {
+    if (window.__WebSpatialData && window.__WebSpatialData.getNativeVersion) {
+      return window.__WebSpatialData.getNativeVersion();
+    }
+    return window.WebSpatailNativeVersion === "WS_SHELL_VERSION" ? this.getClientVersion() : window.WebSpatailNativeVersion;
+  }
+  /** @deprecated
+   * Gets the client SDK version.
+   * The version format follows semantic versioning (x.x.x).
+   * @returns Client SDK version string in format "x.x.x"
+   */
+  getClientVersion() {
+    return "2.0.0";
+  }
+}
+export {
+  Spatial
+};
+//# sourceMappingURL=Spatial.js.map

package/dist/Spatial.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Spatial.ts"],"sourcesContent":["import { SpatialSession } from './SpatialSession'\nimport { SpatialWebEvent } from './SpatialWebEvent'\n\n/**\n * Base object designed to be placed on navigator.spatial to mirror navigator.xr for webxr.\n * This is the main entry point for the WebSpatial SDK, providing access to spatial capabilities.\n */\nexport class Spatial {\n  /**\n   * Requests a spatial session object from the browser.\n   * This is the primary method to initialize spatial functionality.\n   * @returns The SpatialSession instance or null if not available in the current browser\n   * [TODO] discuss implications of this not being async\n   */\n  requestSession() {\n    if (this.runInSpatialWeb()) {\n      SpatialWebEvent.init()\n      return new SpatialSession()\n    } else {\n      return null\n    }\n  }\n\n  /**\n   * Checks if the current page is running in a spatial web environment.\n   * This method detects if the application is running in a WebSpatial-compatible browser.\n   * @returns True if running in a spatial web environment, false otherwise\n   */\n  runInSpatialWeb() {\n    if (navigator.userAgent.indexOf('WebSpatial/') >= 0) {\n      return true\n    }\n    return false\n  }\n\n  /** @deprecated\n   * Checks if WebSpatial is supported in the current environment.\n   * Verifies compatibility between native and client versions.\n   * @returns True if web spatial is supported by this webpage\n   */\n  isSupported() {\n    return true\n  }\n\n  /** @deprecated\n   * Gets the native WebSpatial version from the browser environment.\n   * The version format follows semantic versioning (x.x.x).\n   * @returns Native version string in format \"x.x.x\"\n   */\n  getNativeVersion() {\n    if (window.__WebSpatialData && window.__WebSpatialData.getNativeVersion) {\n      return window.__WebSpatialData.getNativeVersion()\n    }\n    return window.WebSpatailNativeVersion === 'WS_SHELL_VERSION'\n      ? this.getClientVersion()\n      : window.WebSpatailNativeVersion\n  }\n\n  /** @deprecated\n   * Gets the client SDK version.\n   * The version format follows semantic versioning (x.x.x).\n   * @returns Client SDK version string in format \"x.x.x\"\n   */\n  getClientVersion() {\n    // @ts-ignore\n    return __WEBSPATIAL_CORE_SDK_VERSION__\n  }\n}\n"],"mappings":"AAAA,SAAS,sBAAsB;AAC/B,SAAS,uBAAuB;AAMzB,MAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOnB,iBAAiB;AACf,QAAI,KAAK,gBAAgB,GAAG;AAC1B,sBAAgB,KAAK;AACrB,aAAO,IAAI,eAAe;AAAA,IAC5B,OAAO;AACL,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,kBAAkB;AAChB,QAAI,UAAU,UAAU,QAAQ,aAAa,KAAK,GAAG;AACnD,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,cAAc;AACZ,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,mBAAmB;AACjB,QAAI,OAAO,oBAAoB,OAAO,iBAAiB,kBAAkB;AACvE,aAAO,OAAO,iBAAiB,iBAAiB;AAAA,IAClD;AACA,WAAO,OAAO,4BAA4B,qBACtC,KAAK,iBAAiB,IACtB,OAAO;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,mBAAmB;AAEjB,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/SpatialObject.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @hidden
+ * Parent class of spatial objects, should not be used directly
+ */
+declare class SpatialObject {
+    /** @hidden */
+    readonly id: string;
+    /** @hidden */
+    constructor(
+    /** @hidden */
+    id: string);
+    name?: string;
+    isDestroyed: boolean;
+    inspect(): Promise<any>;
+    destroy(): Promise<any>;
+    protected onDestroy(): void;
+}
+
+export { SpatialObject };

package/dist/SpatialObject.js

@@ -0,0 +1,44 @@
+import { DestroyCommand, InspectCommand } from "./JSBCommand";
+class SpatialObject {
+  /** @hidden */
+  constructor(id) {
+    this.id = id;
+  }
+  name;
+  isDestroyed = false;
+  async inspect() {
+    const ret = await new InspectCommand(this.id).execute();
+    if (ret.success) {
+      return ret.data;
+    }
+    throw new Error(ret.errorMessage);
+  }
+  async destroy() {
+    if (this.isDestroyed) {
+      return;
+    }
+    const ret = await new DestroyCommand(this.id).execute();
+    if (ret.success) {
+      this.onDestroy();
+      this.isDestroyed = true;
+      return ret.data;
+    } else if (this.isDestroyed) {
+      return;
+    }
+    const errorMessage = typeof ret.errorMessage === "string" ? ret.errorMessage.toLowerCase() : "";
+    const isMissingNativeObject = errorMessage.includes("not exsit");
+    if (isMissingNativeObject) {
+      this.onDestroy();
+      this.isDestroyed = true;
+      return;
+    }
+    throw new Error(ret.errorMessage);
+  }
+  // override this method to do some cleanup
+  onDestroy() {
+  }
+}
+export {
+  SpatialObject
+};
+//# sourceMappingURL=SpatialObject.js.map

package/dist/SpatialObject.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/SpatialObject.ts"],"sourcesContent":["import { DestroyCommand, InspectCommand } from './JSBCommand'\n\n/**\n * @hidden\n * Parent class of spatial objects, should not be used directly\n */\nexport class SpatialObject {\n  /** @hidden */\n  constructor(\n    /** @hidden */\n    public readonly id: string,\n  ) {}\n\n  name?: string\n\n  isDestroyed = false\n\n  async inspect() {\n    const ret = await new InspectCommand(this.id).execute()\n    if (ret.success) {\n      return ret.data\n    }\n    throw new Error(ret.errorMessage)\n  }\n\n  async destroy() {\n    if (this.isDestroyed) {\n      return\n    }\n\n    const ret = await new DestroyCommand(this.id).execute()\n    if (ret.success) {\n      this.onDestroy()\n      this.isDestroyed = true\n      return ret.data\n    } else if (this.isDestroyed) {\n      // already destroyed\n      return\n    }\n\n    const errorMessage =\n      typeof ret.errorMessage === 'string' ? ret.errorMessage.toLowerCase() : ''\n    const isMissingNativeObject = errorMessage.includes('not exsit')\n    if (isMissingNativeObject) {\n      // Treat native pre-teardown as an idempotent destroy during page back navigation.\n      this.onDestroy()\n      this.isDestroyed = true\n      return\n    }\n\n    throw new Error(ret.errorMessage)\n  }\n\n  // override this method to do some cleanup\n  protected onDestroy() {}\n}\n"],"mappings":"AAAA,SAAS,gBAAgB,sBAAsB;AAMxC,MAAM,cAAc;AAAA;AAAA,EAEzB,YAEkB,IAChB;AADgB;AAAA,EACf;AAAA,EAEH;AAAA,EAEA,cAAc;AAAA,EAEd,MAAM,UAAU;AACd,UAAM,MAAM,MAAM,IAAI,eAAe,KAAK,EAAE,EAAE,QAAQ;AACtD,QAAI,IAAI,SAAS;AACf,aAAO,IAAI;AAAA,IACb;AACA,UAAM,IAAI,MAAM,IAAI,YAAY;AAAA,EAClC;AAAA,EAEA,MAAM,UAAU;AACd,QAAI,KAAK,aAAa;AACpB;AAAA,IACF;AAEA,UAAM,MAAM,MAAM,IAAI,eAAe,KAAK,EAAE,EAAE,QAAQ;AACtD,QAAI,IAAI,SAAS;AACf,WAAK,UAAU;AACf,WAAK,cAAc;AACnB,aAAO,IAAI;AAAA,IACb,WAAW,KAAK,aAAa;AAE3B;AAAA,IACF;AAEA,UAAM,eACJ,OAAO,IAAI,iBAAiB,WAAW,IAAI,aAAa,YAAY,IAAI;AAC1E,UAAM,wBAAwB,aAAa,SAAS,WAAW;AAC/D,QAAI,uBAAuB;AAEzB,WAAK,UAAU;AACf,WAAK,cAAc;AACnB;AAAA,IACF;AAEA,UAAM,IAAI,MAAM,IAAI,YAAY;AAAA,EAClC;AAAA;AAAA,EAGU,YAAY;AAAA,EAAC;AACzB;","names":[]}

package/dist/SpatialScene.d.ts

@@ -0,0 +1,51 @@
+import { at as Vec3, a5 as SpatialSceneProperties, aK as CommandResult, ag as SpatializedElement, aQ as SpatialSceneCreationOptionsInternal, aR as SpatialSceneState } from './spatializedElementMotion-_0XWPQCE.js';
+import { SpatialObject } from './SpatialObject.js';
+import './types/motion/spatializedVisual.js';
+import './types/motion/spatializedPlayback.js';
+import './types/global.js';
+import './physicalMetrics-W5uZ5xKb.js';
+import './reality/component/SpatialComponent.js';
+
+/**
+ * Represents the spatial scene that contains all spatialized elements.
+ * This class follows the singleton pattern - only one instance exists per application.
+ * The scene manages the overall spatial environment properties and contains all spatial elements.
+ */
+declare class SpatialScene extends SpatialObject {
+    /**
+     * Gets the singleton instance of the SpatialScene.
+     * Creates a new instance if one doesn't exist yet.
+     * @returns The singleton SpatialScene instance
+     */
+    static getInstance(): SpatialScene;
+    convertCoordinate(position: Vec3, fromId: string, toId: string): Promise<Vec3>;
+    /**
+     * Updates the properties of the spatial scene.
+     * This can include background settings, lighting, and other scene-wide properties.
+     * @param properties Partial set of properties to update
+     * @returns Promise resolving when the update is complete
+     */
+    updateSpatialProperties(properties: Partial<SpatialSceneProperties>): Promise<CommandResult<any>>;
+    /**
+     * Adds a spatialized element to the scene.
+     * This makes the element visible and interactive in the spatial environment.
+     * @param element The SpatializedElement to add to the scene
+     * @returns Promise resolving when the element is added
+     */
+    addSpatializedElement(element: SpatializedElement): Promise<CommandResult<any>>;
+    /**
+     * Updates the scene creation configuration.
+     * This allows changing scene parameters after initial creation.
+     * @param config The new scene creation configuration
+     * @returns Promise resolving when the update is complete
+     */
+    updateSceneCreationConfig(config: SpatialSceneCreationOptionsInternal): Promise<CommandResult<any>>;
+    /**
+     * Gets the current state of the spatial scene.
+     * This includes information about active elements and scene configuration.
+     * @returns Promise resolving to the current SpatialSceneState
+     */
+    getState(): Promise<SpatialSceneState>;
+}
+
+export { SpatialScene };

package/dist/SpatialScene.js

@@ -0,0 +1,74 @@
+import {
+  AddSpatializedElementToSpatialScene,
+  GetSpatialSceneState,
+  UpdateSceneConfig,
+  UpdateSpatialSceneProperties
+} from "./JSBCommand";
+import { ConvertCoordinateCommand } from "./JSBCommand";
+import { SpatialObject } from "./SpatialObject";
+let instance;
+class SpatialScene extends SpatialObject {
+  /**
+   * Gets the singleton instance of the SpatialScene.
+   * Creates a new instance if one doesn't exist yet.
+   * @returns The singleton SpatialScene instance
+   */
+  static getInstance() {
+    if (!instance) {
+      instance = new SpatialScene("");
+    }
+    return instance;
+  }
+  async convertCoordinate(position, fromId, toId) {
+    try {
+      const ret = await new ConvertCoordinateCommand(
+        position,
+        fromId,
+        toId
+      ).execute();
+      return ret?.data ?? position;
+    } catch (error) {
+      console.warn("SpatialScene.convertCoordinate error:", error);
+      throw error;
+    }
+  }
+  /**
+   * Updates the properties of the spatial scene.
+   * This can include background settings, lighting, and other scene-wide properties.
+   * @param properties Partial set of properties to update
+   * @returns Promise resolving when the update is complete
+   */
+  async updateSpatialProperties(properties) {
+    return new UpdateSpatialSceneProperties(properties).execute();
+  }
+  /**
+   * Adds a spatialized element to the scene.
+   * This makes the element visible and interactive in the spatial environment.
+   * @param element The SpatializedElement to add to the scene
+   * @returns Promise resolving when the element is added
+   */
+  async addSpatializedElement(element) {
+    return new AddSpatializedElementToSpatialScene(element).execute();
+  }
+  /**
+   * Updates the scene creation configuration.
+   * This allows changing scene parameters after initial creation.
+   * @param config The new scene creation configuration
+   * @returns Promise resolving when the update is complete
+   */
+  async updateSceneCreationConfig(config) {
+    return new UpdateSceneConfig(config).execute();
+  }
+  /**
+   * Gets the current state of the spatial scene.
+   * This includes information about active elements and scene configuration.
+   * @returns Promise resolving to the current SpatialSceneState
+   */
+  async getState() {
+    return (await new GetSpatialSceneState().execute()).data.name;
+  }
+}
+export {
+  SpatialScene
+};
+//# sourceMappingURL=SpatialScene.js.map

package/dist/SpatialScene.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/SpatialScene.ts"],"sourcesContent":["import { SpatialSceneProperties, Vec3 } from './types/types'\nimport { SpatialSceneCreationOptionsInternal } from './types/internal'\nimport {\n  AddSpatializedElementToSpatialScene,\n  GetSpatialSceneState,\n  UpdateSceneConfig,\n  UpdateSpatialSceneProperties,\n} from './JSBCommand'\nimport { ConvertCoordinateCommand } from './JSBCommand'\n\nimport { SpatializedElement } from './SpatializedElement'\nimport { SpatialObject } from './SpatialObject'\nimport { SpatialSceneState } from './types/internal'\n\nlet instance: SpatialScene\n\n/**\n * Represents the spatial scene that contains all spatialized elements.\n * This class follows the singleton pattern - only one instance exists per application.\n * The scene manages the overall spatial environment properties and contains all spatial elements.\n */\nexport class SpatialScene extends SpatialObject {\n  /**\n   * Gets the singleton instance of the SpatialScene.\n   * Creates a new instance if one doesn't exist yet.\n   * @returns The singleton SpatialScene instance\n   */\n  static getInstance(): SpatialScene {\n    if (!instance) {\n      instance = new SpatialScene('')\n    }\n    return instance\n  }\n\n  async convertCoordinate(\n    position: Vec3,\n    fromId: string,\n    toId: string,\n  ): Promise<Vec3> {\n    try {\n      const ret = await new ConvertCoordinateCommand(\n        position,\n        fromId,\n        toId,\n      ).execute()\n      return (ret as any)?.data ?? position\n    } catch (error) {\n      console.warn('SpatialScene.convertCoordinate error:', error)\n      throw error\n    }\n  }\n\n  /**\n   * Updates the properties of the spatial scene.\n   * This can include background settings, lighting, and other scene-wide properties.\n   * @param properties Partial set of properties to update\n   * @returns Promise resolving when the update is complete\n   */\n  async updateSpatialProperties(properties: Partial<SpatialSceneProperties>) {\n    return new UpdateSpatialSceneProperties(properties).execute()\n  }\n\n  /**\n   * Adds a spatialized element to the scene.\n   * This makes the element visible and interactive in the spatial environment.\n   * @param element The SpatializedElement to add to the scene\n   * @returns Promise resolving when the element is added\n   */\n  async addSpatializedElement(element: SpatializedElement) {\n    return new AddSpatializedElementToSpatialScene(element).execute()\n  }\n\n  /**\n   * Updates the scene creation configuration.\n   * This allows changing scene parameters after initial creation.\n   * @param config The new scene creation configuration\n   * @returns Promise resolving when the update is complete\n   */\n  async updateSceneCreationConfig(config: SpatialSceneCreationOptionsInternal) {\n    return new UpdateSceneConfig(config).execute()\n  }\n\n  /**\n   * Gets the current state of the spatial scene.\n   * This includes information about active elements and scene configuration.\n   * @returns Promise resolving to the current SpatialSceneState\n   */\n  async getState(): Promise<SpatialSceneState> {\n    return (await new GetSpatialSceneState().execute()).data.name\n  }\n}\n"],"mappings":"AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,gCAAgC;AAGzC,SAAS,qBAAqB;AAG9B,IAAI;AAOG,MAAM,qBAAqB,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM9C,OAAO,cAA4B;AACjC,QAAI,CAAC,UAAU;AACb,iBAAW,IAAI,aAAa,EAAE;AAAA,IAChC;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,kBACJ,UACA,QACA,MACe;AACf,QAAI;AACF,YAAM,MAAM,MAAM,IAAI;AAAA,QACpB;AAAA,QACA;AAAA,QACA;AAAA,MACF,EAAE,QAAQ;AACV,aAAQ,KAAa,QAAQ;AAAA,IAC/B,SAAS,OAAO;AACd,cAAQ,KAAK,yCAAyC,KAAK;AAC3D,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,wBAAwB,YAA6C;AACzE,WAAO,IAAI,6BAA6B,UAAU,EAAE,QAAQ;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,sBAAsB,SAA6B;AACvD,WAAO,IAAI,oCAAoC,OAAO,EAAE,QAAQ;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,0BAA0B,QAA6C;AAC3E,WAAO,IAAI,kBAAkB,MAAM,EAAE,QAAQ;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,WAAuC;AAC3C,YAAQ,MAAM,IAAI,qBAAqB,EAAE,QAAQ,GAAG,KAAK;AAAA,EAC3D;AACF;","names":[]}

package/dist/SpatialSession.d.ts

@@ -0,0 +1,143 @@
+import { o as ModelSource, n as ModelLoadingMode, af as SpatializedDynamic3DElement, L as SpatialEntityUserData, H as SpatialEntity, u as SpatialBoxGeometryOptions, $ as SpatialPlaneGeometryOptions, a9 as SpatialSphereGeometryOptions, v as SpatialConeGeometryOptions, w as SpatialCylinderGeometryOptions, m as ModelComponentOptions, ad as SpatialUnlitMaterialOptions, ac as SpatialTextureResourceOptions, M as ModelAssetOptions, _ as SpatialModelEntityCreationOptions, h as AttachmentEntityOptions } from './spatializedElementMotion-_0XWPQCE.js';
+import { SpatialModelEntity } from './reality/entity/SpatialModelEntity.js';
+import { ModelComponent } from './reality/component/ModelComponent.js';
+import { SpatialUnlitMaterial } from './reality/material/SpatialUnlitMaterial.js';
+import { SpatialBoxGeometry } from './reality/geometry/SpatialBoxGeometry.js';
+import { SpatialSphereGeometry } from './reality/geometry/SpatialSphereGeometry.js';
+import { SpatialCylinderGeometry } from './reality/geometry/SpatialCylinderGeometry.js';
+import { SpatialPlaneGeometry } from './reality/geometry/SpatialPlaneGeometry.js';
+import { SpatialConeGeometry } from './reality/geometry/SpatialConeGeometry.js';
+import { SpatialModelAsset } from './reality/resource/SpatialModelAsset.js';
+import { SpatialTextureResource } from './reality/resource/SpatialTextureResource.js';
+import { Attachment } from './reality/Attachment.js';
+import { initScene } from './scene-polyfill.js';
+import { SpatialScene } from './SpatialScene.js';
+import { Spatialized2DElement } from './Spatialized2DElement.js';
+import { SpatializedStatic3DElement } from './SpatializedStatic3DElement.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';
+
+/**
+ * Session used to establish a connection to the spatial renderer of the system.
+ * All spatial resources must be created through this session object.
+ * This class serves as the main factory for creating spatial elements and geometries.
+ */
+declare class SpatialSession {
+    /**
+     * Gets the singleton instance of the spatial scene.
+     * The spatial scene is the root container for all spatial elements.
+     * @returns The SpatialScene singleton instance
+     */
+    getSpatialScene(): SpatialScene;
+    /**
+     * Creates a new 2D element that can be spatialized in the 3D environment.
+     * 2D elements represent HTML content that can be positioned in 3D space.
+     * @returns Promise resolving to a new Spatialized2DElement instance
+     */
+    createSpatialized2DElement(): Promise<Spatialized2DElement>;
+    /**
+     * Creates a new static 3D element with an optional model URL.
+     * Static 3D elements represent pre-built 3D models that can be loaded from a URL.
+     * @param modelURL Optional URL to the 3D model to load
+     * @param sources Optional list of fallback model sources
+     * @param loading Whether the asset should fetch eagerly or be deferred (`'lazy'`)
+     * @returns Promise resolving to a new SpatializedStatic3DElement instance
+     */
+    createSpatializedStatic3DElement(modelURL?: string, sources?: ModelSource[], loading?: ModelLoadingMode): Promise<SpatializedStatic3DElement>;
+    /**
+     * Initializes the spatial scene with custom configuration.
+     * This is a reference to the initScene function from scene-polyfill.
+     */
+    initScene: typeof initScene;
+    /**
+     * Creates a new dynamic 3D element that can be manipulated at runtime.
+     * Dynamic 3D elements allow for programmatic creation and modification of 3D content.
+     * @returns Promise resolving to a new SpatializedDynamic3DElement instance
+     */
+    createSpatializedDynamic3DElement(): Promise<SpatializedDynamic3DElement>;
+    /**
+     * Creates a new spatial entity with an optional name.
+     * Entities are the basic building blocks for creating custom 3D content.
+     * @param name Optional name for the entity
+     * @returns Promise resolving to a new SpatialEntity instance
+     */
+    createEntity(userData?: SpatialEntityUserData): Promise<SpatialEntity>;
+    /**
+     * Creates a box geometry with optional configuration.
+     * @param options Configuration options for the box geometry
+     * @returns Promise resolving to a new SpatialBoxGeometry instance
+     */
+    createBoxGeometry(options?: SpatialBoxGeometryOptions): Promise<SpatialBoxGeometry>;
+    /**
+     * Creates a plane geometry with optional configuration.
+     * @param options Configuration options for the plane geometry
+     * @returns Promise resolving to a new SpatialPlaneGeometry instance
+     */
+    createPlaneGeometry(options?: SpatialPlaneGeometryOptions): Promise<SpatialPlaneGeometry>;
+    /**
+     * Creates a sphere geometry with optional configuration.
+     * @param options Configuration options for the sphere geometry
+     * @returns Promise resolving to a new SpatialSphereGeometry instance
+     */
+    createSphereGeometry(options?: SpatialSphereGeometryOptions): Promise<SpatialSphereGeometry>;
+    /**
+     * Creates a cone geometry with the specified configuration.
+     * @param options Configuration options for the cone geometry
+     * @returns Promise resolving to a new SpatialConeGeometry instance
+     */
+    createConeGeometry(options: SpatialConeGeometryOptions): Promise<SpatialConeGeometry>;
+    /**
+     * Creates a cylinder geometry with the specified configuration.
+     * @param options Configuration options for the cylinder geometry
+     * @returns Promise resolving to a new SpatialCylinderGeometry instance
+     */
+    createCylinderGeometry(options: SpatialCylinderGeometryOptions): Promise<SpatialCylinderGeometry>;
+    /**
+     * Creates a model component with the specified configuration.
+     * Model components are used to add 3D model rendering capabilities to entities.
+     * @param options Configuration options for the model component
+     * @returns Promise resolving to a new ModelComponent instance
+     */
+    createModelComponent(options: ModelComponentOptions): Promise<ModelComponent>;
+    /**
+     * Creates an unlit material with the specified configuration.
+     * Unlit materials don't respond to lighting in the scene.
+     * @param options Configuration options for the unlit material
+     * @returns Promise resolving to a new SpatialUnlitMaterial instance
+     */
+    createUnlitMaterial(options: SpatialUnlitMaterialOptions): Promise<SpatialUnlitMaterial>;
+    /**
+     * Creates a texture resource from the specified image URL.
+     * Texture resources can be referenced by materials and other spatial content.
+     * @param options Configuration options for the texture resource
+     * @returns Promise resolving to a new SpatialTextureResource instance
+     */
+    createTexture(options: SpatialTextureResourceOptions): Promise<SpatialTextureResource>;
+    /**
+     * Creates a model asset with the specified configuration.
+     * Model assets represent 3D model resources that can be used by entities.
+     * @param options Configuration options for the model asset
+     * @returns Promise resolving to a new SpatialModelAsset instance
+     */
+    createModelAsset(options: ModelAssetOptions): Promise<SpatialModelAsset>;
+    /**
+     * Creates a spatial model entity with the specified configuration.
+     * This is a convenience method for creating an entity with a model component.
+     * @param options Configuration options for the spatial model entity
+     * @returns Promise resolving to a new SpatialModelEntity instance
+     */
+    createSpatialModelEntity(options: SpatialModelEntityCreationOptions, userData?: SpatialEntityUserData): Promise<SpatialModelEntity>;
+    /**
+     * Creates an attachment entity that renders 2D HTML content as a child
+     * of a 3D entity in the scene graph.
+     * @param options Configuration options including parent entity ID, position, and size
+     * @returns Promise resolving to a new Attachment instance
+     */
+    createAttachmentEntity(options: AttachmentEntityOptions): Promise<Attachment>;
+}
+
+export { SpatialSession };