@webspatial/core-sdk 1.2.0 → 1.3.0

package/dist/index.d.ts

@@ -402,10 +402,12 @@ declare class CubeInfo$1 {
 }
 interface SpatialTapEventDetail {
     location3D: Point3D;
+    globalLocation3D?: Point3D;
 }
 type SpatialTapEvent = CustomEvent<SpatialTapEventDetail>;
 interface SpatialDragStartEventDetail {
     startLocation3D: Point3D;
+    globalLocation3D?: Point3D;
 }
 interface SpatialDragEventDetail {
     translation3D: Vec3;
@@ -430,6 +432,21 @@ interface SpatialMagnifyEndEventDetail {
 type SpatialMagnifyEvent = CustomEvent<SpatialMagnifyEventDetail>;
 type SpatialMagnifyEndEvent = CustomEvent<SpatialMagnifyEndEventDetail>;
 type SpatialEntityOrReality = SpatialEntity | SpatializedDynamic3DElement;
+interface AttachmentEntityOptions {
+    parentEntityId: string;
+    position?: [number, number, number];
+    size: {
+        width: number;
+        height: number;
+    };
+}
+interface AttachmentEntityUpdateOptions {
+    position?: [number, number, number];
+    size?: {
+        width: number;
+        height: number;
+    };
+}
 
 declare class SpatialComponent extends SpatialObject {
     constructor(id: string);
@@ -523,6 +540,16 @@ declare class SpatialModelAsset extends SpatialObject {
     constructor(id: string, options: ModelAssetOptions);
 }
 
+declare class Attachment extends SpatialObject {
+    private readonly windowProxy;
+    private options;
+    constructor(id: string, windowProxy: WindowProxy, options: AttachmentEntityOptions);
+    getContainer(): HTMLElement;
+    getWindowProxy(): WindowProxy;
+    update(options: AttachmentEntityUpdateOptions): Promise<CommandResult | undefined>;
+}
+declare function createAttachmentEntity(options: AttachmentEntityOptions): Promise<Attachment>;
+
 declare function initScene(name: string, callback: (pre: SpatialSceneCreationOptions$1) => SpatialSceneCreationOptions$1, options?: {
     type: SpatialSceneType$1;
 }): void;
@@ -614,6 +641,13 @@ declare class Spatialized2DElement extends SpatializedElement {
  * and provides events for load success and failure.
  */
 declare class SpatializedStatic3DElement extends SpatializedElement {
+    /**
+     * 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
+     */
+    constructor(id: string, modelURL: string);
     /**
      * Promise resolver for the ready state.
      * Used to resolve the ready promise when the model is loaded.
@@ -694,7 +728,7 @@ declare class SpatialSession {
      * @param modelURL Optional URL to the 3D model to load
      * @returns Promise resolving to a new SpatializedStatic3DElement instance
      */
-    createSpatializedStatic3DElement(modelURL?: string): Promise<SpatializedStatic3DElement>;
+    createSpatializedStatic3DElement(modelURL: string): Promise<SpatializedStatic3DElement>;
     /**
      * Initializes the spatial scene with custom configuration.
      * This is a reference to the initScene function from scene-polyfill.
@@ -771,6 +805,13 @@ declare class SpatialSession {
      * @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>;
 }
 
 /**
@@ -856,4 +897,4 @@ declare global {
 
 declare const isSSREnv: () => boolean;
 
-export { type BackgroundMaterialType, type BaseplateVisibilityType, BaseplateVisibilityValues, type CornerRadius, CubeInfo$1 as CubeInfo, type ModelAssetOptions, ModelComponent, type ModelComponentOptions, type Point3D, type Quaternion, type Size, type Size3D, Spatial, SpatialBoxGeometry, type SpatialBoxGeometryOptions, SpatialComponent, SpatialConeGeometry, type SpatialConeGeometryOptions, SpatialCylinderGeometry, type SpatialCylinderGeometryOptions, type SpatialDragEndEvent, type SpatialDragEndEventDetail, type SpatialDragEvent, type SpatialDragEventDetail, type SpatialDragStartEvent, type SpatialDragStartEventDetail, SpatialEntity, type SpatialEntityEventType, type SpatialEntityOrReality, type SpatialEntityProperties, type SpatialEntityUserData, SpatialGeometry, type SpatialGeometryOptions, type SpatialGeometryType, type SpatialMagnifyEndEvent, type SpatialMagnifyEndEventDetail, type SpatialMagnifyEvent, type SpatialMagnifyEventDetail, SpatialMaterial, type SpatialMaterialType, SpatialModelAsset, type SpatialModelDragEvent, SpatialModelEntity, type SpatialModelEntityCreationOptions, SpatialObject, SpatialPlaneGeometry, type SpatialPlaneGeometryOptions, type SpatialRotateEndEvent, type SpatialRotateEndEventDetail, type SpatialRotateEvent, type SpatialRotateEventDetail, SpatialScene, type SpatialSceneCreationOptions$1 as SpatialSceneCreationOptions, type SpatialSceneProperties, SpatialSceneState$1 as SpatialSceneState, type SpatialSceneType$1 as SpatialSceneType, SpatialSceneValues, SpatialSession, SpatialSphereGeometry, type SpatialSphereGeometryOptions, type SpatialTapEvent, type SpatialTapEventDetail, SpatialUnlitMaterial, type SpatialUnlitMaterialOptions, Spatialized2DElement, type Spatialized2DElementProperties, SpatializedDynamic3DElement, SpatializedElement, type SpatializedElementProperties, SpatializedElementType, SpatializedStatic3DElement, type SpatializedStatic3DElementProperties, type Vec3, type WorldAlignmentType, WorldAlignmentValues, type WorldScalingType, WorldScalingValues, isSSREnv, isValidBaseplateVisibilityType, isValidSceneUnit, isValidSpatialSceneType, isValidWorldAlignmentType, isValidWorldScalingType };
+export { Attachment, type AttachmentEntityOptions, type AttachmentEntityUpdateOptions, type BackgroundMaterialType, type BaseplateVisibilityType, BaseplateVisibilityValues, type CornerRadius, CubeInfo$1 as CubeInfo, type ModelAssetOptions, ModelComponent, type ModelComponentOptions, type Point3D, type Quaternion, type Size, type Size3D, Spatial, SpatialBoxGeometry, type SpatialBoxGeometryOptions, SpatialComponent, SpatialConeGeometry, type SpatialConeGeometryOptions, SpatialCylinderGeometry, type SpatialCylinderGeometryOptions, type SpatialDragEndEvent, type SpatialDragEndEventDetail, type SpatialDragEvent, type SpatialDragEventDetail, type SpatialDragStartEvent, type SpatialDragStartEventDetail, SpatialEntity, type SpatialEntityEventType, type SpatialEntityOrReality, type SpatialEntityProperties, type SpatialEntityUserData, SpatialGeometry, type SpatialGeometryOptions, type SpatialGeometryType, type SpatialMagnifyEndEvent, type SpatialMagnifyEndEventDetail, type SpatialMagnifyEvent, type SpatialMagnifyEventDetail, SpatialMaterial, type SpatialMaterialType, SpatialModelAsset, type SpatialModelDragEvent, SpatialModelEntity, type SpatialModelEntityCreationOptions, SpatialObject, SpatialPlaneGeometry, type SpatialPlaneGeometryOptions, type SpatialRotateEndEvent, type SpatialRotateEndEventDetail, type SpatialRotateEvent, type SpatialRotateEventDetail, SpatialScene, type SpatialSceneCreationOptions$1 as SpatialSceneCreationOptions, type SpatialSceneProperties, SpatialSceneState$1 as SpatialSceneState, type SpatialSceneType$1 as SpatialSceneType, SpatialSceneValues, SpatialSession, SpatialSphereGeometry, type SpatialSphereGeometryOptions, type SpatialTapEvent, type SpatialTapEventDetail, SpatialUnlitMaterial, type SpatialUnlitMaterialOptions, Spatialized2DElement, type Spatialized2DElementProperties, SpatializedDynamic3DElement, SpatializedElement, type SpatializedElementProperties, SpatializedElementType, SpatializedStatic3DElement, type SpatializedStatic3DElementProperties, type Vec3, type WorldAlignmentType, WorldAlignmentValues, type WorldScalingType, WorldScalingValues, createAttachmentEntity, isSSREnv, isValidBaseplateVisibilityType, isValidSceneUnit, isValidSpatialSceneType, isValidWorldAlignmentType, isValidWorldScalingType };

package/dist/index.js

@@ -2,7 +2,7 @@
     (function(){
       if(typeof window === 'undefined') return;
       if(!window.__webspatialsdk__) window.__webspatialsdk__ = {}
-      window.__webspatialsdk__['core-sdk-version'] = "1.2.0"
+      window.__webspatialsdk__['core-sdk-version'] = "1.3.0"
   })()
     
 var __defProp = Object.defineProperty;
@@ -93,6 +93,368 @@ var init_CommandResultUtils = __esm({
   }
 });
 
+// src/platform-adapter/puppeteer/PuppeteerPlatform.ts
+var PuppeteerPlatform_exports = {};
+__export(PuppeteerPlatform_exports, {
+  PuppeteerPlatform: () => PuppeteerPlatform
+});
+var PuppeteerPlatform;
+var init_PuppeteerPlatform = __esm({
+  "src/platform-adapter/puppeteer/PuppeteerPlatform.ts"() {
+    "use strict";
+    init_CommandResultUtils();
+    console.log("PuppeteerPlatform");
+    PuppeteerPlatform = class {
+      // 存储iframe实例
+      iframeRegistry = /* @__PURE__ */ new Map();
+      constructor() {
+      }
+      callJSB(cmd, msg) {
+        return new Promise((resolve) => {
+          try {
+            if (window.__handleJSBMessage) {
+              try {
+                console.log(` core-sdk Puppeteer Platform: callJSB: ${cmd}::${msg}`);
+                const result = window.__handleJSBMessage(`${cmd}::${msg}`);
+                console.log(
+                  ` core-sdk Puppeteer Platform callJSB result: ${result}`
+                );
+                resolve(CommandResultSuccess(result));
+              } catch (err) {
+                resolve(CommandResultFailure("500", "JSB execution error"));
+              }
+            } else {
+              resolve(CommandResultSuccess("ok"));
+            }
+          } catch (error) {
+            console.error(
+              `PuppeteerPlatform cmd Error: ${cmd}, msg: ${msg} error: ${error}`
+            );
+            resolve(CommandResultFailure("500", "Internal error"));
+          }
+        });
+      }
+      /**
+       * 同步创建Spatialized2DElement到Puppeteer Runner
+       */
+      createSpatializedElementSync(spatialId, webspatialUrl) {
+        try {
+          console.log(
+            `[Puppeteer Platform] Creating spatialized element sync with id: ${spatialId}, url: ${webspatialUrl}`
+          );
+          const win = window;
+          if (win.__handleJSBMessage) {
+            const createCommand = {
+              id: spatialId,
+              url: webspatialUrl
+            };
+            win.__handleJSBMessage(
+              `CreateSpatialized2DElement::${JSON.stringify(createCommand)}`
+            );
+          }
+        } catch (error) {
+          console.error("Error creating spatialized element sync:", error);
+        }
+      }
+      callWebSpatialProtocol(command, query, target, features) {
+        console.log(
+          `PuppeteerPlatform: Calling webspatial protocol: webspatial://${command}${query ? `?${query}` : ""}`
+        );
+        return new Promise((resolve) => {
+          try {
+            const webspatialUrl = `webspatial://${command}${query ? `?${query}` : ""}`;
+            const { spatialId, iframe, windowProxy } = this.createIframeWindow(
+              webspatialUrl,
+              target,
+              features
+            );
+            if (command === "createSpatialized2DElement") {
+              this.createSpatializedElementSync(spatialId, webspatialUrl);
+            }
+            console.log(
+              `[Puppeteer Platform] iframe created with spatialId: ${spatialId}`
+            );
+            this.iframeRegistry.set(spatialId, iframe);
+            resolve(CommandResultSuccess({ windowProxy, id: spatialId }));
+          } catch (error) {
+            console.error("Error calling webspatial protocol:", error);
+            resolve(
+              CommandResultFailure("500", "Failed to call webspatial protocol")
+            );
+          }
+        });
+      }
+      callWebSpatialProtocolSync(command, query, target, features) {
+        try {
+          const webspatialUrl = `webspatial://${command}${query ? `?${query}` : ""}`;
+          console.log(`Calling webspatial protocol sync: ${webspatialUrl}`);
+          const { spatialId, iframe, windowProxy } = this.createIframeWindow(
+            webspatialUrl,
+            target,
+            features
+          );
+          if (command === "createSpatialized2DElement") {
+            this.createSpatializedElementSync(spatialId, webspatialUrl);
+          }
+          this.iframeRegistry.set(spatialId, iframe);
+          return CommandResultSuccess({ windowProxy, id: spatialId });
+        } catch (error) {
+          console.error("Error calling webspatial protocol sync:", error);
+          return CommandResultFailure(
+            "500",
+            "Failed to call webspatial protocol sync"
+          );
+        }
+      }
+      /**
+       * 创建基于iframe的窗口
+       */
+      createIframeWindow(url, target, features) {
+        const iframe = document.createElement("iframe");
+        iframe.style.border = "none";
+        iframe.style.display = "none";
+        iframe.style.width = "100%";
+        iframe.style.height = "100%";
+        const spatialId = this.generateUUID();
+        iframe.spatialId = spatialId;
+        iframe.id = `spatial-iframe-${spatialId}`;
+        const featuresObj = this.parseFeatures(features || "");
+        if (featuresObj.width) {
+          iframe.style.width = featuresObj.width;
+        }
+        if (featuresObj.height) {
+          iframe.style.height = featuresObj.height;
+        }
+        if (featuresObj.left) {
+          iframe.style.left = featuresObj.left;
+          iframe.style.position = "absolute";
+        }
+        if (featuresObj.top) {
+          iframe.style.top = featuresObj.top;
+          iframe.style.position = "absolute";
+        }
+        document.body.appendChild(iframe);
+        const windowProxy = this.createEnhancedWindowProxy(iframe, url, spatialId);
+        iframe.src = "about:blank";
+        console.log(
+          `PuppeteerPlatform created iframe window with spatialId: ${spatialId}, URL: ${url}`
+        );
+        this.initializeIframeContent(iframe, url, spatialId);
+        return { spatialId, iframe, windowProxy };
+      }
+      /**
+       * 创建增强的windowProxy对象
+       */
+      createEnhancedWindowProxy(iframe, url, spatialId) {
+        return {
+          // 基本属性
+          location: {
+            href: url,
+            toString: () => url,
+            reload: () => {
+              if (iframe.contentWindow) {
+                iframe.contentWindow.location.reload();
+              }
+            }
+          },
+          navigator: {
+            userAgent: `Mozilla/5.0 (WebKit) SpatialId/${spatialId}`
+          },
+          // 方法
+          close: () => {
+            console.log(`Closing iframe with spatialId: ${spatialId}`);
+            iframe.remove();
+            this.iframeRegistry.delete(spatialId);
+          },
+          // 文档访问
+          document: iframe.contentDocument || {},
+          contentWindow: iframe.contentWindow || {},
+          // 添加消息通信方法
+          postMessage: (message, targetOrigin) => {
+            if (iframe.contentWindow) {
+              iframe.contentWindow.postMessage(message, targetOrigin || "*");
+            }
+          },
+          // 添加事件监听方法
+          addEventListener: (type, listener) => {
+            if (iframe.contentWindow) {
+              iframe.contentWindow.addEventListener(type, listener);
+            }
+          },
+          removeEventListener: (type, listener) => {
+            if (iframe.contentWindow) {
+              iframe.contentWindow.removeEventListener(type, listener);
+            }
+          },
+          // 执行JavaScript
+          executeScript: (code) => {
+            if (iframe.contentWindow) {
+              try {
+                const win = iframe.contentWindow;
+                return win.eval(code);
+              } catch (error) {
+                console.error(
+                  `Error executing script in iframe ${spatialId}:`,
+                  error
+                );
+                return null;
+              }
+            }
+            return null;
+          },
+          // 获取iframe引用
+          getIframe: () => iframe,
+          // 获取spatialId
+          getSpatialId: () => spatialId
+        };
+      }
+      /**
+       * 初始化iframe内容
+       */
+      initializeIframeContent(iframe, url, spatialId) {
+        try {
+          iframe.onload = () => {
+            try {
+              const iframeContent = `
+            // \u6CE8\u5165\u901A\u4FE1\u811A\u672C
+            window.webSpatialId = '${spatialId}';
+            window.SpatialId = '${spatialId}';
+            
+            // \u91CD\u5199window.open\u4EE5\u652F\u6301webspatial\u534F\u8BAE
+            const originalOpen = window.open;
+            window.open = function(url, target, features) {
+              if (url && url.startsWith('webspatial://')) {
+                // \u901A\u8FC7windowProxy\u5904\u7406webspatial\u534F\u8BAE
+                const windowProxy = new Proxy({}, {
+                  get: function(target, prop) {
+                    if (prop === 'toString') {
+                      return function() { return url; };
+                    }
+                    return undefined;
+                  }
+                });
+                return windowProxy;
+              }
+              return originalOpen.call(window, url, target, features);
+            };
+            
+            // \u8BBE\u7F6Enavigator.userAgent\u4EE5\u8BC6\u522Bwebspatial\u73AF\u5883
+            Object.defineProperty(navigator, 'userAgent', {
+              value: 'WebSpatial/1.0 ' + navigator.userAgent,
+              configurable: true
+            });
+            
+            // \u53D1\u9001\u52A0\u8F7D\u5B8C\u6210\u6D88\u606F
+            window.parent.postMessage({
+              type: 'iframe_loaded',
+              spatialId: '${spatialId}',
+              url: '${url}'
+            }, '${window.location.origin}');
+            
+            // \u8BBE\u7F6E\u6D88\u606F\u5904\u7406\u5668
+            window.addEventListener('message', (event) => {
+              if (event.origin !== window.parent.location.origin) return;
+              
+              const data = event.data;
+              if (data && data.type === 'webspatial_command') {
+                // \u5904\u7406\u6765\u81EA\u7236\u7A97\u53E3\u7684\u547D\u4EE4
+                console.log('Received command in iframe from parent:', data.command);
+                // \u8FD9\u91CC\u53EF\u4EE5\u6DFB\u52A0\u547D\u4EE4\u5904\u7406\u903B\u8F91
+              }
+            });
+          `;
+              const doc = iframe.contentDocument;
+              if (doc) {
+                doc.open();
+                doc.write(`
+              <!DOCTYPE html>
+              <html>
+              <head>
+                <title>Spatial Iframe - ${spatialId}</title>
+                <meta charset="UTF-8">
+                <style>
+                  body {
+                    margin: 0;
+                    padding: 0;
+                    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+                  }
+                </style>
+              </head>
+              <body>
+                <script>${iframeContent}</script>
+              </body>
+              </html>
+            `);
+                doc.close();
+              }
+            } catch (error) {
+              console.error("Error initializing iframe content:", error);
+            }
+          };
+        } catch (error) {
+          console.error("Error setting up iframe:", error);
+        }
+      }
+      /**
+       * 解析features字符串为对象
+       */
+      parseFeatures(features) {
+        const result = {};
+        const pairs = features.split(",");
+        pairs.forEach((pair) => {
+          const [key, value] = pair.split("=").map((s) => s.trim());
+          if (key && value) {
+            result[key] = value;
+          }
+        });
+        return result;
+      }
+      /**
+       * 发送消息到指定spatialId的iframe
+       */
+      sendMessageToIframe(spatialId, message) {
+        const iframe = this.iframeRegistry.get(spatialId);
+        if (iframe && iframe.contentWindow) {
+          iframe.contentWindow.postMessage(message, window.location.origin);
+          return true;
+        }
+        return false;
+      }
+      /**
+       * 获取所有活跃的iframe
+       */
+      getAllActiveIframes() {
+        const result = [];
+        this.iframeRegistry.forEach((iframe, spatialId) => {
+          result.push({ spatialId, iframe });
+        });
+        return result;
+      }
+      /**
+       * 清理资源
+       */
+      dispose() {
+        this.iframeRegistry.forEach((iframe, spatialId) => {
+          console.log(`Disposing iframe with spatialId: ${spatialId}`);
+          iframe.remove();
+        });
+        this.iframeRegistry.clear();
+      }
+      // 生成UUID函数
+      generateUUID() {
+        return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(
+          /[xy]/g,
+          function(c) {
+            const r = Math.random() * 16 | 0;
+            const v = c === "x" ? r : r & 3 | 8;
+            return v.toString(16).toUpperCase();
+          }
+        );
+      }
+    };
+  }
+});
+
 // src/SpatialWebEvent.ts
 var SpatialWebEvent;
 var init_SpatialWebEvent = __esm({
@@ -401,7 +763,10 @@ function createPlatform() {
   }
   const userAgent = window.navigator.userAgent;
   const webSpatialVersion = getWebSpatialVersion(userAgent);
-  if (userAgent.includes("PicoWebApp") && isVersionGreater(webSpatialVersion, [0, 0, 1])) {
+  if (window.navigator.userAgent.includes("Puppeteer")) {
+    const PuppeteerPlatform2 = (init_PuppeteerPlatform(), __toCommonJS(PuppeteerPlatform_exports)).PuppeteerPlatform;
+    return new PuppeteerPlatform2();
+  } else if (userAgent.includes("PicoWebApp") && isVersionGreater(webSpatialVersion, [0, 0, 1])) {
     const XRPlatform2 = (init_XRPlatform(), __toCommonJS(XRPlatform_exports)).XRPlatform;
     return new XRPlatform2();
   } else if (userAgent.includes("Android") || userAgent.includes("Linux")) {
@@ -469,7 +834,7 @@ var init_utils = __esm({
 });
 
 // src/JSBCommand.ts
-var platform, JSBCommand, UpdateEntityPropertiesCommand, UpdateEntityEventCommand, UpdateSpatialSceneProperties, UpdateSceneConfig, FocusScene, GetSpatialSceneState, SpatializedElementCommand, UpdateSpatialized2DElementProperties, UpdateSpatializedDynamic3DElementProperties, UpdateUnlitMaterialProperties, UpdateSpatializedElementTransform, UpdateSpatializedStatic3DElementProperties, AddSpatializedElementToSpatialized2DElement, AddSpatializedElementToSpatialScene, CreateSpatializedStatic3DElementCommand, CreateSpatializedDynamic3DElementCommand, CreateSpatialEntityCommand, CreateModelComponentCommand, CreateSpatialModelEntityCommand, CreateModelAssetCommand, CreateSpatialGeometryCommand, CreateSpatialUnlitMaterialCommand, AddComponentToEntityCommand, SetParentForEntityCommand, ConvertFromEntityToEntityCommand, ConvertFromEntityToSceneCommand, ConvertFromSceneToEntityCommand, InspectCommand, DestroyCommand, CheckWebViewCanCreateCommand, WebSpatialProtocolCommand, createSpatialized2DElementCommand, createSpatialSceneCommand;
+var platform, JSBCommand, UpdateEntityPropertiesCommand, UpdateEntityEventCommand, UpdateSpatialSceneProperties, UpdateSceneConfig, FocusScene, GetSpatialSceneState, SpatializedElementCommand, UpdateSpatialized2DElementProperties, UpdateSpatializedDynamic3DElementProperties, UpdateUnlitMaterialProperties, UpdateSpatializedElementTransform, UpdateSpatializedStatic3DElementProperties, AddSpatializedElementToSpatialized2DElement, AddSpatializedElementToSpatialScene, CreateSpatializedStatic3DElementCommand, CreateSpatializedDynamic3DElementCommand, CreateSpatialEntityCommand, CreateModelComponentCommand, CreateSpatialModelEntityCommand, CreateModelAssetCommand, CreateSpatialGeometryCommand, CreateSpatialUnlitMaterialCommand, AddComponentToEntityCommand, SetParentForEntityCommand, ConvertFromEntityToEntityCommand, ConvertFromEntityToSceneCommand, ConvertFromSceneToEntityCommand, InspectCommand, DestroyCommand, CheckWebViewCanCreateCommand, WebSpatialProtocolCommand, createSpatialized2DElementCommand, createSpatialSceneCommand, CreateAttachmentEntityCommand, UpdateAttachmentEntityCommand;
 var init_JSBCommand = __esm({
   "src/JSBCommand.ts"() {
     "use strict";
@@ -896,6 +1261,34 @@ var init_JSBCommand = __esm({
         };
       }
     };
+    CreateAttachmentEntityCommand = class extends WebSpatialProtocolCommand {
+      constructor(options) {
+        super();
+        this.options = options;
+      }
+      commandType = "createAttachment";
+      getParams() {
+        return {
+          parentEntityId: this.options.parentEntityId,
+          position: this.options.position ?? [0, 0, 0],
+          size: this.options.size
+        };
+      }
+    };
+    UpdateAttachmentEntityCommand = class extends JSBCommand {
+      constructor(attachmentId, options) {
+        super();
+        this.attachmentId = attachmentId;
+        this.options = options;
+      }
+      commandType = "UpdateAttachmentEntity";
+      getParams() {
+        return {
+          id: this.attachmentId,
+          ...this.options
+        };
+      }
+    };
   }
 });
 
@@ -1627,6 +2020,16 @@ var Spatialized2DElement = class extends SpatializedElement {
 // src/SpatializedStatic3DElement.ts
 init_JSBCommand();
 var SpatializedStatic3DElement = class extends SpatializedElement {
+  /**
+   * 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
+   */
+  constructor(id, modelURL) {
+    super(id);
+    this.modelURL = modelURL;
+  }
   /**
    * Promise resolver for the ready state.
    * Used to resolve the ready promise when the model is loaded.
@@ -1636,7 +2039,7 @@ var SpatializedStatic3DElement = class extends SpatializedElement {
    * Caches the last model URL to detect changes.
    * Used to reset the ready promise when the model URL changes.
    */
-  modelURL = "";
+  modelURL;
   /**
    * 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)
@@ -1754,7 +2157,7 @@ async function createSpatializedStatic3DElement(modelURL) {
     throw new Error("createSpatializedStatic3DElement failed");
   } else {
     const { id } = result.data;
-    return new SpatializedStatic3DElement(id);
+    return new SpatializedStatic3DElement(id, modelURL);
   }
 }
 async function createSpatializedDynamic3DElement() {
@@ -1767,6 +2170,36 @@ async function createSpatializedDynamic3DElement() {
   }
 }
 
+// src/reality/Attachment.ts
+init_JSBCommand();
+var Attachment = class extends SpatialObject {
+  constructor(id, windowProxy, options) {
+    super(id);
+    this.windowProxy = windowProxy;
+    this.options = options;
+  }
+  getContainer() {
+    return this.windowProxy.document.body;
+  }
+  getWindowProxy() {
+    return this.windowProxy;
+  }
+  async update(options) {
+    if (this.isDestroyed) return;
+    if (options.position) this.options.position = options.position;
+    if (options.size) this.options.size = options.size;
+    return new UpdateAttachmentEntityCommand(this.id, options).execute();
+  }
+};
+async function createAttachmentEntity(options) {
+  const result = await new CreateAttachmentEntityCommand(options).execute();
+  if (!result.success) {
+    throw new Error("createAttachmentEntity failed: " + result?.errorMessage);
+  }
+  const { id, windowProxy } = result.data;
+  return new Attachment(id, windowProxy, options);
+}
+
 // src/reality/realityCreator.ts
 init_JSBCommand();
 
@@ -2156,7 +2589,7 @@ var SpatialSession = class {
    * @param modelURL Optional URL to the 3D model to load
    * @returns Promise resolving to a new SpatializedStatic3DElement instance
    */
-  createSpatializedStatic3DElement(modelURL = "") {
+  createSpatializedStatic3DElement(modelURL) {
     return createSpatializedStatic3DElement(modelURL);
   }
   /**
@@ -2257,6 +2690,15 @@ var SpatialSession = class {
   createSpatialModelEntity(options, userData) {
     return createSpatialModelEntity(options, userData);
   }
+  /**
+   * 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) {
+    return createAttachmentEntity(options);
+  }
 };
 
 // src/Spatial.ts
@@ -2312,7 +2754,7 @@ var Spatial = class {
    * @returns Client SDK version string in format "x.x.x"
    */
   getClientVersion() {
-    return "1.2.0";
+    return "1.3.0";
   }
 };
 
@@ -2463,6 +2905,7 @@ if (!isSSREnv() && navigator.userAgent.indexOf("WebSpatial/") > 0) {
   spatialWindowPolyfill();
 }
 export {
+  Attachment,
   BaseplateVisibilityValues,
   CubeInfo,
   ModelComponent,
@@ -2491,6 +2934,7 @@ export {
   SpatializedStatic3DElement,
   WorldAlignmentValues,
   WorldScalingValues,
+  createAttachmentEntity,
   isSSREnv,
   isValidBaseplateVisibilityType,
   isValidSceneUnit,