@spatialwalk/avatarkit 1.0.0-beta.34 → 1.0.0-beta.35

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0-beta.35] - 2025-12-16
+
+### 🔄 API Changes
+- **Avatar Transform API** - Changed `setTransform` method to `transform` getter/setter property for more idiomatic JavaScript API. Now supports both reading and setting transform values.
+
 ## [1.0.0-beta.34] - 2025-12-16
 
 ### ✨ New Features

package/README.md

@@ -292,8 +292,12 @@ const avatarView = new AvatarView(avatar, container)
 // Wait for first frame to render
 await avatarView.ready // Promise that resolves when the first frame is rendered
 
-// Set avatar transform (position and scale)
-avatarView.setTransform(x, y, scale)
+// Get or set avatar transform (position and scale)
+// Get current transform
+const currentTransform = avatarView.transform // { x: number, y: number, scale: number }
+
+// Set transform
+avatarView.transform = { x, y, scale }
 // - x: Horizontal offset in normalized coordinates (-1 to 1, where -1 = left edge, 0 = center, 1 = right edge)
 // - y: Vertical offset in normalized coordinates (-1 to 1, where -1 = bottom edge, 0 = center, 1 = top edge)
 // - scale: Scale factor (1.0 = original size, 2.0 = double size, 0.5 = half size)
@@ -398,14 +402,18 @@ avatarView.avatarController.onError = (error: Error) => {}
 #### Avatar Transform Methods
 
 ```typescript
-// Set avatar transform (position and scale in canvas)
-avatarView.setTransform(x, y, scale)
+// Get or set avatar transform (position and scale in canvas)
+// Get current transform
+const currentTransform = avatarView.transform // { x: number, y: number, scale: number }
+
+// Set transform
+avatarView.transform = { x, y, scale }
 // - x: Horizontal offset in normalized coordinates (-1 to 1, where -1 = left edge, 0 = center, 1 = right edge)
 // - y: Vertical offset in normalized coordinates (-1 to 1, where -1 = bottom edge, 0 = center, 1 = top edge)
 // - scale: Scale factor (1.0 = original size, 2.0 = double size, 0.5 = half size)
 // Example:
-avatarView.setTransform(0, 0, 1.0)  // Center, original size
-avatarView.setTransform(0.5, 0, 2.0) // Right half, double size
+avatarView.transform = { x: 0, y: 0, scale: 1.0 }  // Center, original size
+avatarView.transform = { x: 0.5, y: 0, scale: 2.0 } // Right half, double size
 ```
 
 **Important Notes:**

package/dist/{StreamingAudioPlayer-D_anvcr1.js → StreamingAudioPlayer-eWy8xl8G.js}

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { A as APP_CONFIG, e as errorToMessage, l as logEvent, a as logger } from "./index-D8QhzqfR.js";
+import { A as APP_CONFIG, e as errorToMessage, l as logEvent, a as logger } from "./index-DgkjYDp2.js";
 class StreamingAudioPlayer {
   constructor(options) {
     __publicField(this, "audioContext", null);

package/dist/core/AvatarView.d.ts

@@ -61,5 +61,14 @@ export declare class AvatarView {
     get isOpaque(): boolean;
     set isOpaque(value: boolean);
     setBackgroundImage(image: HTMLImageElement | string | null): void;
-    setTransform(x: number, y: number, scale: number): void;
+    get transform(): {
+        x: number;
+        y: number;
+        scale: number;
+    };
+    set transform(value: {
+        x: number;
+        y: number;
+        scale: number;
+    });
 }

package/dist/{index-D8QhzqfR.js → index-DgkjYDp2.js}

@@ -2977,7 +2977,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-D_anvcr1.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-eWy8xl8G.js");
     this.streamingPlayer = new StreamingAudioPlayer({
       sampleRate: APP_CONFIG.audio.sampleRate,
       channelCount: 1,
@@ -4378,7 +4378,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.34");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.35");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 class EventEmitter {
@@ -8444,10 +8444,17 @@ class AvatarView {
       img.src = imageUrl;
     }
   }
-  setTransform(x, y, scale) {
+  get transform() {
     if (!this.renderSystem) {
       throw new Error("Render system not initialized");
     }
+    return this.renderSystem.getTransform();
+  }
+  set transform(value) {
+    if (!this.renderSystem) {
+      throw new Error("Render system not initialized");
+    }
+    const { x, y, scale } = value;
     logger.log(`[AvatarView] Setting transform: x=${x}, y=${y}, scale=${scale}`);
     this.renderSystem.setTransform(x, y, scale);
     if (this.isInitialized && this.renderSystem) {

package/dist/index.js

@@ -1,4 +1,4 @@
-import { b, c, f, d, j, g, C, i, D, E, k, h, L, R, S, m } from "./index-D8QhzqfR.js";
+import { b, c, f, d, j, g, C, i, D, E, k, h, L, R, S, m } from "./index-DgkjYDp2.js";
 export {
   b as Avatar,
   c as AvatarController,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.34",
+  "version": "1.0.0-beta.35",
   "packageManager": "pnpm@10.18.2",
   "description": "SPAvatar SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "SPAvatar Team",