@dcl/ecs 7.22.5 → 7.22.6-25007982108.commit-83012ab

package/dist/systems/events.js

@@ -18,14 +18,15 @@ export function createPointerEventsSystem(engine, inputSystem) {
         EventType[EventType["Up"] = 2] = "Up";
         EventType[EventType["HoverEnter"] = 3] = "HoverEnter";
         EventType[EventType["HoverLeave"] = 4] = "HoverLeave";
-        EventType[EventType["ProximityEnter"] = 5] = "ProximityEnter";
-        EventType[EventType["ProximityLeave"] = 6] = "ProximityLeave";
+        EventType[EventType["Drag"] = 5] = "Drag";
+        EventType[EventType["DragLocked"] = 6] = "DragLocked";
+        EventType[EventType["DragEnd"] = 7] = "DragEnd";
     })(EventType || (EventType = {}));
     const eventsMap = new Map();
     function getEvent(entity) {
         return eventsMap.get(entity) || eventsMap.set(entity, new Map()).get(entity);
     }
-    function setPointerEvent(entity, type, opts, interactionType = 0 /* InteractionType.CURSOR */) {
+    function setPointerEvent(entity, type, opts) {
         const pointerEvent = PointerEvents.getMutableOrNull(entity) || PointerEvents.create(entity);
         pointerEvent.pointerEvents.push({
             eventType: type,
@@ -35,19 +36,15 @@ export function createPointerEventsSystem(engine, inputSystem) {
                 showHighlight: opts.showHighlight,
                 hoverText: opts.hoverText,
                 maxDistance: opts.maxDistance,
-                maxPlayerDistance: opts.maxPlayerDistance,
-                priority: opts.priority
-            },
-            interactionType: interactionType ?? 0 /* InteractionType.CURSOR */
+                maxPlayerDistance: opts.maxPlayerDistance
+            }
         });
     }
-    function removePointerEvent(entity, type, button, interactionType = 0 /* InteractionType.CURSOR */) {
+    function removePointerEvent(entity, type, button) {
         const pointerEvent = PointerEvents.getMutableOrNull(entity);
         if (!pointerEvent)
             return;
-        pointerEvent.pointerEvents = pointerEvent.pointerEvents.filter((pointer) => !(pointer.eventInfo?.button === button &&
-            pointer.eventType === type &&
-            pointer.interactionType === interactionType));
+        pointerEvent.pointerEvents = pointerEvent.pointerEvents.filter((pointer) => !(pointer.eventInfo?.button === button && pointer.eventType === type));
     }
     function getPointerEvent(eventType) {
         if (eventType === EventType.Up) {
@@ -59,117 +56,148 @@ export function createPointerEventsSystem(engine, inputSystem) {
         else if (eventType === EventType.HoverEnter) {
             return 2 /* PointerEventType.PET_HOVER_ENTER */;
         }
-        else if (eventType === EventType.ProximityEnter) {
-            return 4 /* PointerEventType.PET_PROXIMITY_ENTER */;
+        else if (eventType === EventType.Drag) {
+            return 7 /* PointerEventType.PET_DRAG */;
+        }
+        else if (eventType === EventType.DragLocked) {
+            return 6 /* PointerEventType.PET_DRAG_LOCKED */;
         }
-        else if (eventType === EventType.ProximityLeave) {
-            return 5 /* PointerEventType.PET_PROXIMITY_LEAVE */;
+        else if (eventType === EventType.DragEnd) {
+            return 8 /* PointerEventType.PET_DRAG_END */;
         }
         return 1 /* PointerEventType.PET_DOWN */;
     }
-    function removeEvent(entity, type, interactionType = 0 /* InteractionType.CURSOR */) {
+    function getEventType(pet) {
+        if (pet === 0 /* PointerEventType.PET_UP */) {
+            return EventType.Up;
+        }
+        else if (pet === 2 /* PointerEventType.PET_HOVER_ENTER */) {
+            return EventType.HoverEnter;
+        }
+        else if (pet === 3 /* PointerEventType.PET_HOVER_LEAVE */) {
+            return EventType.HoverLeave;
+        }
+        else if (pet === 7 /* PointerEventType.PET_DRAG */) {
+            return EventType.Drag;
+        }
+        else if (pet === 6 /* PointerEventType.PET_DRAG_LOCKED */) {
+            return EventType.DragLocked;
+        }
+        else if (pet === 8 /* PointerEventType.PET_DRAG_END */) {
+            return EventType.DragEnd;
+        }
+        else {
+            return EventType.Down;
+        }
+    }
+    function removeEvent(entity, type) {
         const event = getEvent(entity);
-        const pointerEvent = event.get(type);
-        if (pointerEvent?.opts.hoverText) {
-            removePointerEvent(entity, getPointerEvent(type), pointerEvent.opts.button);
+        const pointerEventList = event.get(type);
+        if (pointerEventList === undefined) {
+            return;
+        }
+        for (const button of pointerEventList.keys()) {
+            removePointerEvent(entity, getPointerEvent(type), button);
         }
         event.delete(type);
     }
     engine.addSystem(function EventSystem() {
-        for (const [entity, event] of eventsMap) {
+        if (eventsMap.size === 0) {
+            return;
+        }
+        for (const entity of eventsMap.keys()) {
             if (engine.getEntityState(entity) === EntityState.Removed) {
                 eventsMap.delete(entity);
+            }
+        }
+        for (const command of inputSystem.getInputCommands()) {
+            const entity = command.hit?.entityId;
+            if (entity === undefined) {
+                continue;
+            }
+            const entityMap = eventsMap.get(entity);
+            if (entityMap === undefined) {
                 continue;
             }
-            for (const [eventType, { cb, opts }] of event) {
-                if (eventType === EventType.Click) {
-                    const command = inputSystem.getClick(opts.button, entity);
-                    if (command)
-                        checkNotThenable(cb(command.up), 'Click event returned a thenable. Only synchronous functions are allowed');
+            const typeMap = entityMap.get(getEventType(command.state));
+            if (typeMap) {
+                const data = typeMap.get(command.button);
+                if (data) {
+                    checkNotThenable(data.cb(command), 'Event handler returned a thenable. Only synchronous functions are allowed');
                 }
-                if (eventType === EventType.Down ||
-                    eventType === EventType.Up ||
-                    eventType === EventType.HoverEnter ||
-                    eventType === EventType.HoverLeave ||
-                    eventType === EventType.ProximityEnter ||
-                    eventType === EventType.ProximityLeave) {
-                    const command = inputSystem.getInputCommand(opts.button, getPointerEvent(eventType), entity);
-                    if (command) {
-                        checkNotThenable(cb(command), 'Event handler returned a thenable. Only synchronous functions are allowed');
+                const anyData = typeMap.get(3 /* InputAction.IA_ANY */);
+                if (anyData) {
+                    checkNotThenable(anyData.cb(command), 'Event handler returned a thenable. Only synchronous functions are allowed');
+                }
+            }
+            // check clicks separately
+            if (command.state === 0 /* PointerEventType.PET_UP */) {
+                const clickMap = entityMap.get(EventType.Click);
+                if (clickMap) {
+                    const data = clickMap.get(command.button);
+                    if (data && inputSystem.getClick(command.button, entity)) {
+                        checkNotThenable(data.cb(command), 'Click event returned a thenable. Only synchronous functions are allowed');
+                    }
+                    const anyData = clickMap.get(3 /* InputAction.IA_ANY */);
+                    if (anyData && inputSystem.getClick(command.button, entity)) {
+                        checkNotThenable(anyData.cb(command), 'Event handler returned a thenable. Only synchronous functions are allowed');
                     }
                 }
             }
         }
     });
-    const onPointerDown = (...args) => {
-        const [data, cb, maybeOpts] = args;
-        if (typeof data === 'number') {
-            return onPointerDown({ entity: data, opts: maybeOpts ?? {} }, cb);
-        }
-        const { entity, opts } = data;
-        const options = getDefaultOpts(opts);
-        removeEvent(entity, EventType.Down);
-        getEvent(entity).set(EventType.Down, { cb, opts: options });
-        setPointerEvent(entity, 1 /* PointerEventType.PET_DOWN */, options);
-    };
-    const onPointerUp = (...args) => {
-        const [data, cb, maybeOpts] = args;
-        if (typeof data === 'number') {
-            return onPointerUp({ entity: data, opts: maybeOpts ?? {} }, cb);
-        }
-        const { entity, opts } = data;
-        const options = getDefaultOpts(opts);
-        removeEvent(entity, EventType.Up);
-        getEvent(entity).set(EventType.Up, { cb, opts: options });
-        setPointerEvent(entity, 0 /* PointerEventType.PET_UP */, options);
-    };
-    const onPointerHoverEnter = (...args) => {
-        const [data, cb] = args;
-        const { entity, opts } = data;
-        const options = getDefaultOpts(opts);
-        removeEvent(entity, EventType.HoverEnter);
-        getEvent(entity).set(EventType.HoverEnter, { cb, opts: options });
-        setPointerEvent(entity, 2 /* PointerEventType.PET_HOVER_ENTER */, options);
-    };
-    const onPointerHoverLeave = (...args) => {
-        const [data, cb] = args;
-        const { entity, opts } = data;
-        const options = getDefaultOpts(opts);
-        removeEvent(entity, EventType.HoverLeave);
-        getEvent(entity).set(EventType.HoverLeave, { cb, opts: options });
-        setPointerEvent(entity, 3 /* PointerEventType.PET_HOVER_LEAVE */, options);
-    };
-    const onProximityDown = (...args) => {
-        const [data, cb] = args;
-        const { entity, opts } = data;
-        const options = getDefaultOpts(opts);
-        removeEvent(entity, EventType.Down, 1 /* InteractionType.PROXIMITY */);
-        getEvent(entity).set(EventType.Down, { cb, opts: options });
-        setPointerEvent(entity, 1 /* PointerEventType.PET_DOWN */, options, 1 /* InteractionType.PROXIMITY */);
-    };
-    const onProximityUp = (...args) => {
-        const [data, cb] = args;
-        const { entity, opts } = data;
-        const options = getDefaultOpts(opts);
-        removeEvent(entity, EventType.Up, 1 /* InteractionType.PROXIMITY */);
-        getEvent(entity).set(EventType.Up, { cb, opts: options });
-        setPointerEvent(entity, 0 /* PointerEventType.PET_UP */, options, 1 /* InteractionType.PROXIMITY */);
-    };
-    const onProximityEnter = (...args) => {
-        const [data, cb] = args;
-        const { entity, opts } = data;
-        const options = getDefaultOpts(opts);
-        removeEvent(entity, EventType.ProximityEnter, 1 /* InteractionType.PROXIMITY */);
-        getEvent(entity).set(EventType.ProximityEnter, { cb, opts: options });
-        setPointerEvent(entity, 4 /* PointerEventType.PET_PROXIMITY_ENTER */, options, 1 /* InteractionType.PROXIMITY */);
-    };
-    const onProximityLeave = (...args) => {
-        const [data, cb] = args;
-        const { entity, opts } = data;
-        const options = getDefaultOpts(opts);
-        removeEvent(entity, EventType.ProximityLeave, 1 /* InteractionType.PROXIMITY */);
-        getEvent(entity).set(EventType.ProximityLeave, { cb, opts: options });
-        setPointerEvent(entity, 5 /* PointerEventType.PET_PROXIMITY_LEAVE */, options, 1 /* InteractionType.PROXIMITY */);
+    // return a function with the correct event type.
+    // we use onPointerDown as the "archetype" for the returned function, but it fits with
+    // all the onPointer* declarations
+    const onPointerFunction = (ty) => {
+        return (arg0, arg1, arg2) => {
+            let entity;
+            let optsList;
+            if (typeof arg0 === 'number') {
+                // called as onPointerDown(entity: Entity, cb: EventSystemCallback, opts?: Partial<EventSystemOptions>): void
+                entity = arg0;
+                const cb = arg1;
+                const opts = arg2;
+                optsList = [{ cb, ...getDefaultOpts(opts) }];
+            }
+            else if (typeof arg1 === 'function') {
+                // called as onPointerDown(pointerData: { entity: Entity; opts?: Partial<EventSystemOptions> }, cb: EventSystemCallback): void
+                const { entity: e, opts } = arg0;
+                const cb = arg1;
+                entity = e;
+                optsList = [{ cb, ...getDefaultOpts(opts) }];
+            }
+            else {
+                // called as onPointerDown(pointerData: { entity: Entity; optsList: EventSystemOptionsCallback[] }): void
+                const { entity: e, optsList: o } = arg0;
+                entity = e;
+                optsList = o;
+            }
+            const previous = getEvent(entity).get(ty) ?? new Map();
+            const callbacks = new Map();
+            for (const opts of optsList) {
+                const prevOpts = previous.get(opts.button);
+                if (prevOpts !== undefined) {
+                    if (prevOpts.hoverText !== opts.hoverText ||
+                        prevOpts.maxDistance !== opts.maxDistance ||
+                        prevOpts.showFeedback !== opts.showFeedback ||
+                        prevOpts.showHighlight !== opts.showHighlight) {
+                        removePointerEvent(entity, getPointerEvent(ty), opts.button);
+                        setPointerEvent(entity, getPointerEvent(ty), opts);
+                    }
+                }
+                else {
+                    setPointerEvent(entity, getPointerEvent(ty), opts);
+                }
+                callbacks.set(opts.button, opts);
+            }
+            for (const button of previous.keys()) {
+                if (!callbacks.has(button)) {
+                    removePointerEvent(entity, getPointerEvent(ty), button);
+                }
+            }
+            getEvent(entity).set(ty, callbacks);
+        };
     };
     return {
         removeOnClick(entity) {
@@ -187,34 +215,22 @@ export function createPointerEventsSystem(engine, inputSystem) {
         removeOnPointerHoverLeave(entity) {
             removeEvent(entity, EventType.HoverLeave);
         },
-        removeOnProximityDown(entity) {
-            removeEvent(entity, EventType.Down, 1 /* InteractionType.PROXIMITY */);
-        },
-        removeOnProximityUp(entity) {
-            removeEvent(entity, EventType.Up, 1 /* InteractionType.PROXIMITY */);
+        removeOnPointerDrag(entity) {
+            removeEvent(entity, EventType.Drag);
         },
-        removeOnProximityEnter(entity) {
-            removeEvent(entity, EventType.ProximityEnter, 1 /* InteractionType.PROXIMITY */);
+        removeOnPointerDragLocked(entity) {
+            removeEvent(entity, EventType.DragLocked);
         },
-        removeOnProximityLeave(entity) {
-            removeEvent(entity, EventType.ProximityLeave, 1 /* InteractionType.PROXIMITY */);
-        },
-        onClick(value, cb) {
-            const { entity } = value;
-            const options = getDefaultOpts(value.opts);
-            // Clear previous event with over feedback included
-            removeEvent(entity, EventType.Click);
-            // Set new event
-            getEvent(entity).set(EventType.Click, { cb, opts: options });
-            setPointerEvent(entity, 1 /* PointerEventType.PET_DOWN */, options);
+        removeOnPointerDragEnd(entity) {
+            removeEvent(entity, EventType.DragEnd);
         },
-        onPointerDown,
-        onPointerUp,
-        onPointerHoverEnter,
-        onPointerHoverLeave,
-        onProximityDown,
-        onProximityUp,
-        onProximityEnter,
-        onProximityLeave
+        onClick: onPointerFunction(EventType.Click),
+        onPointerDown: onPointerFunction(EventType.Down),
+        onPointerUp: onPointerFunction(EventType.Up),
+        onPointerHoverEnter: onPointerFunction(EventType.HoverEnter),
+        onPointerHoverLeave: onPointerFunction(EventType.HoverLeave),
+        onPointerDrag: onPointerFunction(EventType.Drag),
+        onPointerDragLocked: onPointerFunction(EventType.DragLocked),
+        onPointerDragEnd: onPointerFunction(EventType.DragEnd)
     };
 }

package/dist/systems/raycast.d.ts

@@ -1,4 +1,4 @@
-import { RaycastQueryType, PBRaycastResult } from '../components';
+import { RaycastQueryType, RaycastShape, PBRaycastResult } from '../components';
 import { DeepReadonlyObject, Entity } from '../engine';
 import { Vector3 } from '../components/generated/pb/decentraland/common/vectors.gen';
 /**
@@ -14,6 +14,8 @@ export type RaycastSystemOptions = {
     queryType: RaycastQueryType;
     continuous?: boolean | undefined;
     collisionMask?: number | undefined;
+    shape?: RaycastShape | undefined;
+    includeWorld?: boolean | undefined;
 };
 export type LocalDirectionRaycastSystemOptions = {
     direction?: Vector3;

package/dist/systems/raycast.js

@@ -58,6 +58,8 @@ export function createRaycastSystem(engine) {
             raycast.direction = raycastValue.directionRawValue;
             raycast.continuous = raycastValue.continuous;
             raycast.queryType = raycastValue.queryType;
+            raycast.shape = raycastValue.shape;
+            raycast.includeWorld = raycastValue.includeWorld;
             entitiesCallbackResultMap.set(entity, { callback: callback });
         };
         nextTickRaycasts.push(onNextTick);

package/dist-cjs/components/extended/AvatarEquippedData.d.ts

@@ -0,0 +1,10 @@
+import { IEngine, LastWriteWinElementSetComponentDefinition } from '../../engine';
+import { PBAvatarEquippedData } from '../generated/pb/decentraland/sdk/components/avatar_equipped_data.gen';
+/**
+ * @public
+ */
+export type AvatarEquippedDataComponentDefinitionExtended = LastWriteWinElementSetComponentDefinition<AvatarEquippedDataType>;
+export type AvatarEquippedDataType = Omit<PBAvatarEquippedData, 'forceRender'> & {
+    forceRender?: string[] | undefined;
+};
+export declare function defineAvatarEquippedDataComponent(engine: Pick<IEngine, 'defineComponentFromSchema'>): AvatarEquippedDataComponentDefinitionExtended;

package/dist-cjs/components/extended/AvatarEquippedData.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineAvatarEquippedDataComponent = void 0;
+const AvatarEquippedData_gen_1 = require("../generated/AvatarEquippedData.gen");
+function defineAvatarEquippedDataComponent(engine) {
+    const patchedSchema = { ...AvatarEquippedData_gen_1.AvatarEquippedDataSchema };
+    const origSerialize = patchedSchema.serialize;
+    patchedSchema.serialize = (value, builder) => {
+        if (value.forceRender === undefined) {
+            origSerialize({ forceRender: [], ...value }, builder);
+        }
+        else {
+            origSerialize(value, builder);
+        }
+    };
+    const theComponent = engine.defineComponentFromSchema('core::AvatarEquippedData', patchedSchema);
+    return theComponent;
+}
+exports.defineAvatarEquippedDataComponent = defineAvatarEquippedDataComponent;

package/dist-cjs/components/extended/AvatarShape.d.ts

@@ -0,0 +1,10 @@
+import { IEngine, LastWriteWinElementSetComponentDefinition } from '../../engine';
+import { PBAvatarShape } from '../generated/pb/decentraland/sdk/components/avatar_shape.gen';
+/**
+ * @public
+ */
+export type AvatarShapeComponentDefinitionExtended = LastWriteWinElementSetComponentDefinition<AvatarShapeType>;
+export type AvatarShapeType = Omit<PBAvatarShape, 'forceRender'> & {
+    forceRender?: string[] | undefined;
+};
+export declare function defineAvatarShapeComponent(engine: Pick<IEngine, 'defineComponentFromSchema'>): AvatarShapeComponentDefinitionExtended;

package/dist-cjs/components/extended/AvatarShape.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineAvatarShapeComponent = void 0;
+const AvatarShape_gen_1 = require("../generated/AvatarShape.gen");
+function defineAvatarShapeComponent(engine) {
+    const patchedSchema = { ...AvatarShape_gen_1.AvatarShapeSchema };
+    const origSerialize = patchedSchema.serialize;
+    patchedSchema.serialize = (value, builder) => {
+        if (value.forceRender === undefined) {
+            origSerialize({ forceRender: [], ...value }, builder);
+        }
+        else {
+            origSerialize(value, builder);
+        }
+    };
+    const theComponent = engine.defineComponentFromSchema('core::AvatarShape', patchedSchema);
+    return theComponent;
+}
+exports.defineAvatarShapeComponent = defineAvatarShapeComponent;

package/dist-cjs/components/extended/MeshCollider.d.ts

@@ -34,5 +34,13 @@ export interface MeshColliderComponentDefinitionExtended extends LastWriteWinEle
      * @param colliderMask - the set of layer where the collider reacts, default: Physics and Pointer
      */
     setSphere(entity: Entity, colliderLayers?: ColliderLayer | ColliderLayer[]): void;
+    /**
+     * @public
+     * Set a gltf internal mesh in the MeshCollider component
+     * @param entity - entity to create or replace the MeshRenderer component
+     * @param source - the path to the gltf
+     * @param meshName - the name of the mesh in the gltf
+     */
+    setGltfMesh(entity: Entity, source: string, meshName: string, colliderLayers?: ColliderLayer | ColliderLayer[]): void;
 }
 export declare function defineMeshColliderComponent(engine: Pick<IEngine, 'defineComponentFromSchema'>): MeshColliderComponentDefinitionExtended;

package/dist-cjs/components/extended/MeshCollider.js

@@ -37,6 +37,12 @@ function defineMeshColliderComponent(engine) {
                 mesh: { $case: 'sphere', sphere: {} },
                 collisionMask: getCollisionMask(colliderLayers)
             });
+        },
+        setGltfMesh(entity, source, meshName, colliderLayers) {
+            theComponent.createOrReplace(entity, {
+                mesh: { $case: 'gltf', gltf: { gltfSrc: source, name: meshName } },
+                collisionMask: getCollisionMask(colliderLayers)
+            });
         }
     };
 }

package/dist-cjs/components/extended/MeshRenderer.d.ts

@@ -32,5 +32,13 @@ export interface MeshRendererComponentDefinitionExtended extends LastWriteWinEle
      * @param entity - entity to create or replace the MeshRenderer component
      */
     setSphere(entity: Entity): void;
+    /**
+     * @public
+     * Set a gltf internal mesh in the MeshRenderer component
+     * @param entity - entity to create or replace the MeshRenderer component
+     * @param source - the path to the gltf
+     * @param meshName - the name of the mesh in the gltf
+     */
+    setGltfMesh(entity: Entity, source: string, meshName: string): void;
 }
 export declare function defineMeshRendererComponent(engine: Pick<IEngine, 'defineComponentFromSchema'>): MeshRendererComponentDefinitionExtended;

package/dist-cjs/components/extended/MeshRenderer.js

@@ -25,6 +25,11 @@ function defineMeshRendererComponent(engine) {
             theComponent.createOrReplace(entity, {
                 mesh: { $case: 'sphere', sphere: {} }
             });
+        },
+        setGltfMesh(entity, source, meshName) {
+            theComponent.createOrReplace(entity, {
+                mesh: { $case: 'gltf', gltf: { gltfSrc: source, name: meshName } }
+            });
         }
     };
 }

package/dist-cjs/components/extended/Tween.d.ts

@@ -1,38 +1,6 @@
 import { Entity, IEngine, LastWriteWinElementSetComponentDefinition } from '../../engine';
 import { Quaternion, Vector2, Vector3 } from '../generated/pb/decentraland/common/vectors.gen';
 import { EasingFunction, Move, MoveContinuous, PBTween, Rotate, RotateContinuous, Scale, TextureMove, TextureMoveContinuous, TextureMovementType } 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;
-}
 /**
  * @public
  */
@@ -65,18 +33,13 @@ 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> {
     /**
-     * Helpers with constructor
+     * Texture helpers with constructor
      */
     Mode: TweenHelper;
     /**
@@ -155,15 +118,5 @@ export interface TweenComponentDefinitionExtended extends LastWriteWinElementSet
      * @param duration - duration of the tween in milliseconds (defaults to 0 for infinite)
      */
     setTextureMoveContinuous(entity: Entity, direction: Vector2, speed: number, 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;
 }
 export declare function defineTweenComponent(engine: Pick<IEngine, 'defineComponentFromSchema'>): TweenComponentDefinitionExtended;

package/dist-cjs/components/extended/Tween.js

@@ -2,35 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defineTweenComponent = void 0;
 const index_gen_1 = require("../generated/index.gen");
-function assertDuration(duration, apiName) {
-    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, apiName) {
-    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`);
-        }
-    }
-}
 const TweenHelper = {
     Move(move) {
         return {
@@ -73,21 +44,6 @@ const TweenHelper = {
             $case: 'textureMoveContinuous',
             textureMoveContinuous
         };
-    },
-    MoveRotateScale(params) {
-        assertMoveRotateScaleAxesStartEnd(params, 'Tween.Mode.MoveRotateScale');
-        const 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
-        };
     }
 };
 function defineTweenComponent(engine) {
@@ -194,28 +150,6 @@ function defineTweenComponent(engine) {
                 easingFunction: 0 /* EasingFunction.EF_LINEAR */,
                 playing: true
             });
-        },
-        setMoveRotateScale(entity, params) {
-            assertMoveRotateScaleAxesStartEnd(params, 'setMoveRotateScale');
-            assertDuration(params.duration, 'setMoveRotateScale');
-            const { position, rotation, scale, duration, easingFunction = 0 /* EasingFunction.EF_LINEAR */ } = params;
-            const 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
-            });
         }
     };
 }