@webspatial/core-sdk 1.3.0 → 1.5.0

package/src/reality/entity/SpatialModelEntity.ts

@@ -2,6 +2,8 @@ import {
   SpatialEntityUserData,
   SpatialModelEntityCreationOptions,
 } from '../../types/types'
+import { SetMaterialsOnEntityCommand } from '../../JSBCommand'
+import { SpatialMaterial } from '../material/SpatialMaterial'
 import { SpatialEntity } from './SpatialEntity'
 
 export class SpatialModelEntity extends SpatialEntity {
@@ -12,4 +14,8 @@ export class SpatialModelEntity extends SpatialEntity {
   ) {
     super(id, userData)
   }
+
+  async setMaterials(materials: SpatialMaterial[]) {
+    return new SetMaterialsOnEntityCommand(this.id, materials).execute()
+  }
 }

package/src/scene-polyfill.ts

@@ -76,6 +76,18 @@ class SceneManager {
   private open = (url?: string, target?: string, features?: string) => {
     // bypass internal
     if (url?.startsWith(INTERNAL_SCHEMA_PREFIX)) {
+      if (url.includes('createSpatialized2DElement')) {
+        const token = window.webSpatial?.genToken?.()
+        if (token) {
+          const host = window.location.host
+          const protocol = window.location.protocol
+          const finalURL = `${protocol}//${host}/${token}/?command=createSpatialized2DElement`
+          const rid = new URL(url).searchParams.get('rid')
+          const final = new URL(finalURL)
+          if (rid) final.searchParams.set('rid', rid)
+          return this.originalOpen(final.toString(), target, features)
+        }
+      }
       return this.originalOpen(url, target, features)
     }
 

package/src/types/global.d.ts

@@ -1,3 +1,5 @@
+import type { PhysicalMetricsValueShape } from '../physicalMetrics'
+
 declare global {
   declare const __WEBSPATIAL_CORE_SDK_VERSION__: string
 
@@ -20,6 +22,11 @@ declare global {
     webkit: any
     webspatialBridge: any
 
+    // Project Pico OS browser injects this global object to provide internal capabilities.
+    webSpatial?: {
+      genToken?: () => string
+    }
+
     // Will be removed in favor of __WebSpatialData
     WebSpatailNativeVersion: string
 
@@ -28,16 +35,16 @@ declare global {
       'natvie-version'?: string
       'react-sdk-version'?: string
       'core-sdk-version'?: string
+      physicalMetrics?: PhysicalMetricsValueShape
     }
 
-    innerDepth: number
-    outerDepth: number
+    xrInnerDepth: number
+    xrOuterDepth: number
   }
 
   interface HTMLElement {
-    offsetBack: number
-    clientDepth: number
-    getBoundingClientCube: () => CubeInfo | undefined
+    xrOffsetBack: number
+    xrClientDepth: number
   }
 }
 

package/src/types/types.ts

@@ -80,6 +80,11 @@ export interface SpatializedElementProperties {
   enableRotateEndGesture: boolean
   enableMagnifyGesture: boolean
   enableMagnifyEndGesture: boolean
+  /**
+   * Optional world-space axis for spatial rotate gesture. Omitted or zero vector
+   * means unconstrained rotation (platform default).
+   */
+  rotateConstrainedToAxis?: Vec3
 }
 
 export interface Spatialized2DElementProperties
@@ -115,6 +120,16 @@ export interface SpatialSceneCreationOptions {
   baseplateVisibility?: BaseplateVisibilityType
 }
 
+export type SpatialEntityEventType =
+  | 'spatialtap'
+  | 'spatialdragstart'
+  | 'spatialdrag'
+  | 'spatialdragend'
+  | 'spatialrotate'
+  | 'spatialrotateend'
+  | 'spatialmagnify'
+  | 'spatialmagnifyend'
+
 export const BaseplateVisibilityValues = [
   'automatic',
   'visible',
@@ -186,8 +201,6 @@ export interface SpatialEntityProperties {
   scale: Vec3
 }
 
-export type SpatialEntityEventType = 'spatialtap' //| 'drag' | 'rotate' | 'scale'
-
 export type SpatialGeometryType =
   | 'BoxGeometry'
   | 'PlaneGeometry'
@@ -391,6 +404,7 @@ export interface AttachmentEntityOptions {
   parentEntityId: string
   position?: [number, number, number]
   size: { width: number; height: number }
+  ownerViewId: string
 }
 
 export interface AttachmentEntityUpdateOptions {