Merge remote-tracking branch 'origin/main' into auth-server

# Conflicts:
#	test/snapshots/development-bundles/static-scene.test.ts.crdt
#	test/snapshots/development-bundles/testing-fw.test.ts.crdt
#	test/snapshots/development-bundles/two-way-crdt.test.ts.crdt
#	test/snapshots/production-bundles/append-value-crdt.ts.crdt
#	test/snapshots/production-bundles/billboard.ts.crdt
#	test/snapshots/production-bundles/cube-deleted.ts.crdt
#	test/snapshots/production-bundles/cube.ts.crdt
#	test/snapshots/production-bundles/cubes.ts.crdt
#	test/snapshots/production-bundles/pointer-events.ts.crdt
#	test/snapshots/production-bundles/schema-components.ts.crdt
#	test/snapshots/production-bundles/ui.ts.crdt
#	test/snapshots/production-bundles/with-main-function.ts.crdt

Author: gonpombo8

package-lock.json

@@ -6,7 +6,7 @@
   "bugs": "https://github.com/decentraland/js-sdk-toolchain/issues",
   "dependencies": {
     "@actions/core": "^1.10.0",
-    "@dcl/protocol": "1.0.0-21519068572.commit-814b279",
+    "@dcl/protocol": "1.0.0-22669986637.commit-fb11819",
     "@dcl/quickjs-emscripten": "^0.21.0-3680274614.commit-1808aa1",
     "@dcl/ts-proto": "1.153.0",
     "@types/fs-extra": "^9.0.12",

package.json

@@ -4,6 +4,7 @@ import {
   EasingFunction,
   Move,
   MoveContinuous,
+  MoveRotateScale,
   PBTween,
   Rotate,
   RotateContinuous,
@@ -14,6 +15,63 @@ import {
   Tween
 } from '../generated/index.gen'
 
+/**
+ * @public
+ * Partial params for Tween.Mode.MoveRotateScale(). At least one of position, rotation, or scale must be provided.
+ * Use this when building a mode for Tween.createOrReplace() or TweenSequence (e.g. only positionStart/positionEnd).
+ */
+export interface MoveRotateScaleModeParams {
+  /** Position tween (start → end). Optional. */
+  position?: { start: Vector3; end: Vector3 }
+  /** Rotation tween (start → end). Optional. */
+  rotation?: { start: Quaternion; end: Quaternion }
+  /** Scale tween (start → end). Optional. */
+  scale?: { start: Vector3; end: Vector3 }
+}
+
+/**
+ * @public
+ * Parameters for setMoveRotateScale. At least one of position, rotation, or scale must be provided.
+ */
+export interface SetMoveRotateScaleParams extends MoveRotateScaleModeParams {
+  /** Duration of the tween in milliseconds. */
+  duration: number
+  /** Easing function (defaults to EF_LINEAR). */
+  easingFunction?: EasingFunction
+}
+
+function assertDuration(duration: number, apiName: string): void {
+  if (!Number.isFinite(duration) || duration < 0) {
+    throw new Error(`${apiName}: duration must be a non-negative finite number`)
+  }
+}
+
+/** Shared validation for params that have optional position/rotation/scale with start & end. */
+function assertMoveRotateScaleAxesStartEnd(params: MoveRotateScaleModeParams, apiName: string): void {
+  if (!params.position && !params.rotation && !params.scale) {
+    throw new Error(`${apiName}: at least one of position, rotation, or scale must be provided`)
+  }
+
+  if (params.position) {
+    const pos = params.position!
+    if (!pos.start || !pos.end) {
+      throw new Error(`${apiName}: position must have both start and end`)
+    }
+  }
+  if (params.rotation) {
+    const rot = params.rotation!
+    if (!rot.start || !rot.end) {
+      throw new Error(`${apiName}: rotation must have both start and end`)
+    }
+  }
+  if (params.scale) {
+    const scl = params.scale!
+    if (!scl.start || !scl.end) {
+      throw new Error(`${apiName}: scale must have both start and end`)
+    }
+  }
+}
+
 /**
  * @public
  */
@@ -46,14 +104,19 @@ export interface TweenHelper {
    * @returns a texture-move-continuous mode tween
    */
   TextureMoveContinuous: (textureMove: TextureMoveContinuous) => PBTween['mode']
+  /**
+   * @returns a move-rotate-scale mode tween
+   * @param params - partial transform (at least one of position, rotation, scale); omit axes you don't need
+   */
+  MoveRotateScale: (params: MoveRotateScaleModeParams) => PBTween['mode']
 }
 
 /**
  * @public
  */
 export interface TweenComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBTween> {
   /**
-   * Texture helpers with constructor
+   * Helpers with constructor
    */
   Mode: TweenHelper
 
@@ -152,6 +215,17 @@ export interface TweenComponentDefinitionExtended extends LastWriteWinElementSet
     movementType?: TextureMovementType,
     duration?: number
   ): void
+
+  /**
+   * @public
+   *
+   * Creates or replaces a move-rotate-scale tween component that simultaneously animates
+   * an entity's position, rotation, and/or scale from start to end. Provide only the
+   * properties you need (at least one of position, rotation, or scale).
+   * @param entity - entity to apply the tween to
+   * @param params - object with optional position, rotation, scale (each with start/end), duration, and optional easingFunction
+   */
+  setMoveRotateScale(entity: Entity, params: SetMoveRotateScaleParams): void
 }
 
 const TweenHelper: TweenHelper = {
@@ -196,6 +270,21 @@ const TweenHelper: TweenHelper = {
       $case: 'textureMoveContinuous',
       textureMoveContinuous
     }
+  },
+  MoveRotateScale(params) {
+    assertMoveRotateScaleAxesStartEnd(params, 'Tween.Mode.MoveRotateScale')
+    const moveRotateScale: MoveRotateScale = {
+      positionStart: params.position ? params.position.start : undefined,
+      positionEnd: params.position ? params.position.end : undefined,
+      rotationStart: params.rotation ? params.rotation.start : undefined,
+      rotationEnd: params.rotation ? params.rotation.end : undefined,
+      scaleStart: params.scale ? params.scale.start : undefined,
+      scaleEnd: params.scale ? params.scale!.end : undefined
+    }
+    return {
+      $case: 'moveRotateScale',
+      moveRotateScale
+    }
   }
 }
 
@@ -337,6 +426,28 @@ export function defineTweenComponent(
         easingFunction: EasingFunction.EF_LINEAR,
         playing: true
       })
+    },
+    setMoveRotateScale(entity: Entity, params: SetMoveRotateScaleParams) {
+      assertMoveRotateScaleAxesStartEnd(params, 'setMoveRotateScale')
+      assertDuration(params.duration, 'setMoveRotateScale')
+      const { position, rotation, scale, duration, easingFunction = EasingFunction.EF_LINEAR } = params
+      const moveRotateScale: MoveRotateScale = {
+        positionStart: position ? position.start : undefined,
+        positionEnd: position ? position.end : undefined,
+        rotationStart: rotation ? rotation.start : undefined,
+        rotationEnd: rotation ? rotation.end : undefined,
+        scaleStart: scale ? scale.start : undefined,
+        scaleEnd: scale ? scale.end : undefined
+      }
+      theComponent.createOrReplace(entity, {
+        mode: {
+          $case: 'moveRotateScale',
+          moveRotateScale
+        },
+        duration,
+        easingFunction,
+        playing: true
+      })
     }
   }
 }

packages/@dcl/ecs/src/components/extended/Tween.ts

@@ -11,7 +11,12 @@ export type {
   ReadonlyFlatTexture,
   FlatMaterial
 } from './extended/Material'
-export type { TweenHelper, TweenComponentDefinitionExtended } from './extended/Tween'
+export type {
+  TweenHelper,
+  TweenComponentDefinitionExtended,
+  SetMoveRotateScaleParams,
+  MoveRotateScaleModeParams
+} from './extended/Tween'
 export type { CameraTransitionHelper, VirtualCameraComponentDefinitionExtended } from './extended/VirtualCamera'
 export type { TransformComponentExtended, TransformTypeWithOptionals } from './manual/Transform'
 export type { NameComponent, NameType } from './manual/Name'

packages/@dcl/ecs/src/components/types.ts

@@ -1,6 +1,7 @@
 // The order of the following imports matters. Please do not auto-sort
 export * from './engine'
 export * from './schemas'
+export * from './runtime/globals'
 export * from './runtime/initialization'
 export * from './runtime/types'
 export * from './runtime/helpers'

packages/@dcl/ecs/src/index.ts

@@ -4,15 +4,15 @@
 
 /**
  * Type-safe globalThis property access.
- * @internal
+ * @public
  */
 export function getGlobal<T>(key: string): T | undefined {
   return (globalThis as any)[key]
 }
 
 /**
  * Sets a globalThis property as a polyfill (only if undefined/null).
- * @internal
+ * @public
  */
 export function setGlobalPolyfill<T>(key: string, value: T): void {
   ;(globalThis as any)[key] = (globalThis as any)[key] ?? value