@dcl/playground-assets 7.22.5-24836126953.commit-ddc8da1 → 7.22.5

package/dist/beta.d.ts

@@ -163,42 +163,6 @@ export declare interface AudioStreamComponentDefinitionExtended extends LastWrit
     getAudioState(entity: Entity): PBAudioEvent | undefined;
 }
 
-/**
- * @public
- */
-export declare type AuthoritativePutComponentMessage = CrdtMessageHeader & AuthoritativePutComponentMessageBody;
-
-/**
- * Server authoritative message - identical to PutComponentMessageBody but with forced processing
- * Min. length = header (8 bytes) + 16 bytes = 24 bytes
- *
- * @param entity - Uint32 number of the entity
- * @param componentId - Uint32 number of id
- * @param timestamp - Uint32 Lamport timestamp (server's authoritative timestamp)
- * @param data - Uint8[] data of component => length(4 bytes) + block of bytes[0..length-1]
- * @public
- */
-export declare type AuthoritativePutComponentMessageBody = {
-    type: CrdtMessageType.AUTHORITATIVE_PUT_COMPONENT;
-    entityId: Entity;
-    componentId: number;
-    timestamp: number;
-    data: Uint8Array;
-};
-
-/**
- * @public
- */
-export declare namespace AuthoritativePutComponentOperation {
-    const MESSAGE_HEADER_LENGTH = 16;
-    /**
-     * Call this function for an optimal writing data passing the ByteBuffer
-     *  already allocated
-     */
-    export function write(entity: Entity, timestamp: number, componentId: number, data: Uint8Array, buf: ByteBuffer): void;
-    export function read(buf: ByteBuffer): AuthoritativePutComponentMessage | null;
-}
-
 /** AvatarAnchorPointType determines the part of the avatar's body that anchors the Entity. */
 /**
  * @public
@@ -358,22 +322,6 @@ export declare interface BaseComponent<T> {
      * If the value is undefined, the component was deleted.
      */
     onChange(entity: Entity, cb: (value: T | undefined) => void): void;
-    /**
-     * @public
-     *
-     */
-    validateBeforeChange(entity: Entity, cb: ValidateCallback<T>): void;
-    validateBeforeChange(cb: ValidateCallback<T>): void;
-    /**
-     * Get the CRDT state for an entity (serialized data and timestamp)
-     * @param entity - Entity to get the CRDT state for
-     * @returns Object with serialized data and timestamp, or null if entity doesn't have the component
-     * @public
-     */
-    getCrdtState(entity: Entity): {
-        data: Uint8Array;
-        timestamp: number;
-    } | null;
 }
 
 /** @public */
@@ -1340,6 +1288,23 @@ export declare type Color4Type = {
     a: number;
 };
 
+/** A range of Color4 values. Randomized or lerped between start and end. */
+/**
+ * @public
+ */
+export declare interface ColorRange {
+    start: PBColor4 | undefined;
+    end: PBColor4 | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace ColorRange {
+    export function encode(message: ColorRange, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): ColorRange;
+}
+
 /**
  * @public
  */
@@ -1396,6 +1361,7 @@ export declare const componentDefinitionByName: {
     "core::MeshCollider": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMeshCollider>>;
     "core::MeshRenderer": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMeshRenderer>>;
     "core::NftShape": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBNftShape>>;
+    "core::ParticleSystem": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBParticleSystem>>;
     "core::PhysicsCombinedForce": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPhysicsCombinedForce>>;
     "core::PhysicsCombinedImpulse": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPhysicsCombinedImpulse>>;
     "core::PlayerIdentityData": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPlayerIdentityData>>;
@@ -1584,12 +1550,12 @@ export declare const CRDT_MESSAGE_HEADER_LENGTH = 8;
 /**
  * @public
  */
-export declare type CrdtMessage = PutComponentMessage | AuthoritativePutComponentMessage | DeleteComponentMessage | AppendValueMessage | DeleteEntityMessage | PutNetworkComponentMessage | DeleteComponentNetworkMessage | DeleteEntityNetworkMessage;
+export declare type CrdtMessage = PutComponentMessage | DeleteComponentMessage | AppendValueMessage | DeleteEntityMessage | PutNetworkComponentMessage | DeleteComponentNetworkMessage | DeleteEntityNetworkMessage;
 
 /**
  * @public
  */
-export declare type CrdtMessageBody = PutComponentMessageBody | AuthoritativePutComponentMessageBody | DeleteComponentMessageBody | DeleteEntityMessageBody | AppendValueMessageBody | CrdtNetworkMessageBody;
+export declare type CrdtMessageBody = PutComponentMessageBody | DeleteComponentMessageBody | DeleteEntityMessageBody | AppendValueMessageBody | CrdtNetworkMessageBody;
 
 /**
  * Min length = 8 bytes
@@ -1644,8 +1610,7 @@ export declare enum CrdtMessageType {
     PUT_COMPONENT_NETWORK = 5,
     DELETE_COMPONENT_NETWORK = 6,
     DELETE_ENTITY_NETWORK = 7,
-    AUTHORITATIVE_PUT_COMPONENT = 8,
-    MAX_MESSAGE_TYPE = 9
+    MAX_MESSAGE_TYPE = 8
 }
 
 /**
@@ -1653,8 +1618,6 @@ export declare enum CrdtMessageType {
  */
 export declare type CrdtNetworkMessageBody = PutNetworkComponentMessageBody | DeleteComponentNetworkMessageBody | DeleteEntityNetworkMessageBody;
 
-export declare const CreatedBy: ICreatedBy;
-
 /**
  * @public
  */
@@ -2089,6 +2052,7 @@ export declare type EventSystemOptions = {
     showFeedback?: boolean;
     showHighlight?: boolean;
     maxPlayerDistance?: number;
+    priority?: number;
 };
 
 /**
@@ -2202,6 +2166,23 @@ export declare type FlexWrapType = 'wrap' | 'nowrap' | 'wrap-reverse';
 /** @public */
 export declare type FloatArray = number[];
 
+/** A range of float values. Randomized or lerped between start and end. */
+/**
+ * @public
+ */
+export declare interface FloatRange {
+    start: number;
+    end: number;
+}
+
+/**
+ * @public
+ */
+export declare namespace FloatRange {
+    export function encode(message: FloatRange, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): FloatRange;
+}
+
 /**
  * @public
  */
@@ -2356,12 +2337,6 @@ export declare interface GrowOnlyValueSetComponentDefinition<T> extends BaseComp
 
 export declare type GSetComponentGetter<T extends GrowOnlyValueSetComponentDefinition<any>> = (engine: Pick<IEngine, 'defineValueSetComponentFromSchema'>) => T;
 
-export declare type ICreatedBy = LastWriteWinElementSetComponentDefinition<ICreatedByType>;
-
-export declare interface ICreatedByType {
-    address: string;
-}
-
 /**
  * @public
  */
@@ -2797,32 +2772,11 @@ export declare type InstanceCompositeOptions = {
 };
 
 /**
- * Internal component interface that exposes all internal methods for SDK use
- * This is not exposed to users, only for internal SDK operations
+ * @public
  */
-export declare interface InternalBaseComponent<T> extends BaseComponent<T> {
-    /**
-     * @public
-     * Dry run update to check if a CRDT message would be accepted without actually applying it
-     */
-    __dry_run_updateFromCrdt(body: CrdtMessageBody): ProcessMessageResultType;
-    /**
-     * @public
-     * Get the iterator to every entity has the component
-     */
-    iterator(): Iterable<[Entity, any]>;
-    /**
-     * @public
-     */
-    dirtyIterator(): Iterable<Entity>;
-    /**
-     * @public
-     */
-    __onChangeCallbacks(entity: Entity, value: T): void;
-    /**
-     * @public
-     */
-    __run_validateBeforeChange(entity: Entity, newValue: T | undefined, senderAddress: string, createdBy: string): boolean;
+export declare const enum InteractionType {
+    CURSOR = 0,
+    PROXIMITY = 1
 }
 
 /**
@@ -2903,6 +2857,19 @@ export declare type JustifyType = 'flex-start' | 'center' | 'flex-end' | 'space-
  */
 export declare type Key = number | string;
 
+/**
+ * @public
+ * Falloff mode for knockback force over distance.
+ */
+export declare enum KnockbackFalloff {
+    /** Same force at any distance within radius */
+    CONSTANT = 0,
+    /** Smooth linear decrease to 0 at radius edge: F = magnitude * (1 - distance / radius) */
+    LINEAR = 1,
+    /** Sharp drop-off, physically realistic: F = magnitude / (distance^2 + 1) */
+    INVERSE_SQUARE = 2
+}
+
 /**
  *
  * @public
@@ -4413,6 +4380,30 @@ export declare const onVideoEvent: Observable<{
  */
 export declare type OverflowType = 'hidden' | 'scroll' | 'visible';
 
+export declare const ParticleSystem: ParticleSystemComponentDefinitionExtended;
+
+/**
+ * @public
+ */
+export declare interface ParticleSystemComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBParticleSystem> {
+    /** Helpers for constructing emitter shapes */
+    Shape: ParticleSystemHelper;
+}
+
+/**
+ * @public
+ */
+export declare interface ParticleSystemHelper {
+    /** Emit from a single point */
+    Point: (point?: PBParticleSystem_Point) => PBParticleSystem['shape'];
+    /** Emit from the surface or volume of a sphere */
+    Sphere: (sphere?: PBParticleSystem_Sphere) => PBParticleSystem['shape'];
+    /** Emit from the base of a cone, projecting outward */
+    Cone: (cone?: PBParticleSystem_Cone) => PBParticleSystem['shape'];
+    /** Emit from the surface or volume of a box */
+    Box: (box?: PBParticleSystem_Box) => PBParticleSystem['shape'];
+}
+
 /** AnimationState indicates the status and configuration of one available animation. */
 /**
  * @public
@@ -5464,6 +5455,267 @@ export declare namespace PBNftShape {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBNftShape;
 }
 
+/**
+ * @public
+ */
+export declare interface PBParticleSystem {
+    /** --- Emission --- */
+    active?: boolean | undefined;
+    /** default = 10. Particles emitted per second. */
+    rate?: number | undefined;
+    /** default = 1000. Maximum number of live particles. */
+    maxParticles?: number | undefined;
+    /** default = 5. Particle lifetime in seconds. */
+    lifetime?: number | undefined;
+    /** --- Motion --- */
+    gravity?: number | undefined;
+    /** Constant force vector applied to each particle (world space). */
+    additionalForce?: PBVector3 | undefined;
+    /** --- Size --- */
+    initialSize?: FloatRange | undefined;
+    /** default = {1, 1}. Particle size lerped from start to end over its lifetime. */
+    sizeOverTime?: FloatRange | undefined;
+    /** --- Rotation --- */
+    initialRotation?: PBQuaternion | undefined;
+    /** default = identity (0,0,0,1). Per-axis angular velocity as quaternion; converted to Euler XYZ. */
+    rotationOverTime?: PBQuaternion | undefined;
+    /** default = false. Particles orient along their velocity direction. */
+    faceTravelDirection?: boolean | undefined;
+    /** --- Color --- */
+    initialColor?: ColorRange | undefined;
+    /** default = {white, white}. Particle color lerped from start to end over its lifetime. */
+    colorOverTime?: ColorRange | undefined;
+    /** --- Velocity --- */
+    initialVelocitySpeed?: FloatRange | undefined;
+    /** --- Rendering --- */
+    texture?: Texture | undefined;
+    /** default = PSB_ALPHA */
+    blendMode?: PBParticleSystem_BlendMode | undefined;
+    /** default = true */
+    billboard?: boolean | undefined;
+    /** --- Sprite Sheet Animation --- */
+    spriteSheet?: PBParticleSystem_SpriteSheetAnimation | undefined;
+    shape?: {
+        $case: "point";
+        point: PBParticleSystem_Point;
+    } | {
+        $case: "sphere";
+        sphere: PBParticleSystem_Sphere;
+    } | {
+        $case: "cone";
+        cone: PBParticleSystem_Cone;
+    } | {
+        $case: "box";
+        box: PBParticleSystem_Box;
+    } | undefined;
+    /** --- Simulation --- */
+    loop?: boolean | undefined;
+    /** default = false. Start as if already simulated for one full loop cycle. Requires loop = true. */
+    prewarm?: boolean | undefined;
+    /** default = PSS_LOCAL. Controls whether particles simulate in local or world space. */
+    simulationSpace?: PBParticleSystem_SimulationSpace | undefined;
+    /** --- Limit Velocity Over Lifetime --- */
+    limitVelocity?: PBParticleSystem_LimitVelocity | undefined;
+    /** --- Playback --- */
+    playbackState?: PBParticleSystem_PlaybackState | undefined;
+    /** --- Emission Bursts --- */
+    bursts?: PBParticleSystem_BurstConfiguration | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBParticleSystem {
+    export function encode(message: PBParticleSystem, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBParticleSystem;
+}
+
+/**
+ * @public
+ */
+declare const enum PBParticleSystem_BlendMode {
+    /** PSB_ALPHA - Standard alpha transparency. */
+    PSB_ALPHA = 0,
+    /** PSB_ADD - Additive blending (brightens underlying pixels). */
+    PSB_ADD = 1,
+    /** PSB_MULTIPLY - Multiply blending (darkens underlying pixels). */
+    PSB_MULTIPLY = 2
+}
+export { PBParticleSystem_BlendMode }
+export { PBParticleSystem_BlendMode as ParticleSystemBlendMode }
+
+/** Emitter spawns particles from the surface or volume of a box. */
+/**
+ * @public
+ */
+export declare interface PBParticleSystem_Box {
+    /** default = {1, 1, 1} */
+    size?: PBVector3 | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBParticleSystem_Box {
+    export function encode(message: PBParticleSystem_Box, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBParticleSystem_Box;
+}
+
+/**
+ * @public
+ */
+export declare interface PBParticleSystem_Burst {
+    /** Seconds from start of cycle. */
+    time: number;
+    /** Particles to emit. */
+    count: number;
+    /** default = 1. Repeat count (0 = infinite). */
+    cycles?: number | undefined;
+    /** default = 0.01. Seconds between cycles. */
+    interval?: number | undefined;
+    /** default = 1.0. Emission chance [0,1]. */
+    probability?: number | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBParticleSystem_Burst {
+    export function encode(message: PBParticleSystem_Burst, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBParticleSystem_Burst;
+}
+
+/** Emission burst configuration. */
+/**
+ * @public
+ */
+export declare interface PBParticleSystem_BurstConfiguration {
+    values: PBParticleSystem_Burst[];
+}
+
+/**
+ * @public
+ */
+export declare namespace PBParticleSystem_BurstConfiguration {
+    export function encode(message: PBParticleSystem_BurstConfiguration, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBParticleSystem_BurstConfiguration;
+}
+
+/** Emitter spawns particles from the base of a cone and projects them outward. */
+/**
+ * @public
+ */
+export declare interface PBParticleSystem_Cone {
+    /** default = 25. Half-angle of the cone in degrees. */
+    angle?: number | undefined;
+    /** default = 1. Base radius in meters. */
+    radius?: number | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBParticleSystem_Cone {
+    export function encode(message: PBParticleSystem_Cone, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBParticleSystem_Cone;
+}
+
+/** Clamps particle speed over lifetime. */
+/**
+ * @public
+ */
+export declare interface PBParticleSystem_LimitVelocity {
+    /** Maximum particle speed (m/s). */
+    speed: number;
+    /** default = 1. Fraction (0–1) of excess velocity removed per frame. 1 = hard clamp. */
+    dampen?: number | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBParticleSystem_LimitVelocity {
+    export function encode(message: PBParticleSystem_LimitVelocity, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBParticleSystem_LimitVelocity;
+}
+
+/**
+ * @public
+ */
+declare const enum PBParticleSystem_PlaybackState {
+    /** PS_PLAYING - Particle system is emitting and simulating. */
+    PS_PLAYING = 0,
+    /** PS_PAUSED - Simulation is frozen; no new particles are emitted. */
+    PS_PAUSED = 1,
+    /** PS_STOPPED - Simulation stopped and existing particles cleared. */
+    PS_STOPPED = 2
+}
+export { PBParticleSystem_PlaybackState }
+export { PBParticleSystem_PlaybackState as ParticleSystemPlaybackState }
+
+/** Emitter spawns particles from a single point. */
+/**
+ * @public
+ */
+export declare interface PBParticleSystem_Point {
+}
+
+/**
+ * @public
+ */
+export declare namespace PBParticleSystem_Point {
+    export function encode(_: PBParticleSystem_Point, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBParticleSystem_Point;
+}
+
+/**
+ * @public
+ */
+export declare const enum PBParticleSystem_SimulationSpace {
+    /** PSS_LOCAL - Particles move with the entity transform. */
+    PSS_LOCAL = 0,
+    /** PSS_WORLD - Particles stay in world position after emission. */
+    PSS_WORLD = 1
+}
+
+/** Emitter spawns particles from the surface or volume of a sphere. */
+/**
+ * @public
+ */
+export declare interface PBParticleSystem_Sphere {
+    /** default = 1 */
+    radius?: number | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBParticleSystem_Sphere {
+    export function encode(message: PBParticleSystem_Sphere, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBParticleSystem_Sphere;
+}
+
+/** Sprite sheet (texture atlas) animation settings. */
+/**
+ * @public
+ */
+export declare interface PBParticleSystem_SpriteSheetAnimation {
+    /** Number of columns in the sprite sheet. */
+    tilesX: number;
+    /** Number of rows in the sprite sheet. */
+    tilesY: number;
+    /** default = 30. Playback speed in frames per second. */
+    framesPerSecond?: number | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBParticleSystem_SpriteSheetAnimation {
+    export function encode(message: PBParticleSystem_SpriteSheetAnimation, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBParticleSystem_SpriteSheetAnimation;
+}
+
 /**
  * This component applies a continuous physics force.
  *
@@ -5601,6 +5853,8 @@ export declare interface PBPointerEvents_Entry {
     eventType: PointerEventType;
     /** additional configuration for this detection */
     eventInfo: PBPointerEvents_Info | undefined;
+    /** the type of interaction source (default 0 == CURSOR) */
+    interactionType?: InteractionType | undefined;
 }
 
 /**
@@ -5627,6 +5881,8 @@ export declare interface PBPointerEvents_Info {
     showHighlight?: boolean | undefined;
     /** range of interaction from the avatar's position (default 0) */
     maxPlayerDistance?: number | undefined;
+    /** resolution order when multiple events overlap, higher wins (default 0) */
+    priority?: number | undefined;
 }
 
 /**
@@ -6544,12 +6800,92 @@ export declare namespace PBVisibilityComponent {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBVisibilityComponent;
 }
 
+/**
+ * @public
+ * Physics helpers for applying impulses and forces to the player.
+ */
+export declare const Physics: PhysicsSystem;
+
 /** @public */
 export declare const PhysicsCombinedForce: LastWriteWinElementSetComponentDefinition<PBPhysicsCombinedForce>;
 
 /** @public */
 export declare const PhysicsCombinedImpulse: LastWriteWinElementSetComponentDefinition<PBPhysicsCombinedImpulse>;
 
+/**
+ * @public
+ */
+export declare interface PhysicsSystem {
+    /**
+     * Apply a one-shot impulse to the player entity.
+     * Multiple calls within the same frame are accumulated (summed).
+     *
+     * @param vector - a single `vector` whose length encodes the strength.
+     * or use overload for `direction` with a separate `magnitude` — the direction will be normalized before scaling.
+     */
+    applyImpulseToPlayer(vector: Vector3Type): void;
+    applyImpulseToPlayer(direction: Vector3Type, magnitude: number): void;
+    /**
+     * Apply a continuous force to the player from a given source entity.
+     * Multiple sources are accumulated: the registry sums all active forces
+     * and writes a single PBPhysicsCombinedForce component.
+     * Calling again with the same source replaces its previous force.
+     *
+     * @param source - Entity key identifying this force source
+     * @param vector - single `vector` whose length encodes the strength
+     * or use overload for `direction` with a separate `magnitude` — the direction will be normalized before scaling.
+     */
+    applyForceToPlayer(source: Entity, vector: Vector3Type): void;
+    applyForceToPlayer(source: Entity, direction: Vector3Type, magnitude: number): void;
+    /**
+     * Remove a continuous force from the player. Remaining sources are
+     * re-summed; if none remain the force is cleared. No-op if the source
+     * is not registered.
+     *
+     * @param source - Entity key identifying the force source to remove
+     */
+    removeForceFromPlayer(source: Entity): void;
+    /**
+     * Push the player away from a point. Computes direction from
+     * `fromPosition` to the player, applies falloff, and delegates
+     * to applyImpulseToPlayer.
+     *
+     * If the player is exactly at `fromPosition`, pushes upward.
+     *
+     * @param fromPosition - world-space origin of the knockback (explosion center, enemy position, etc.)
+     * @param magnitude - base impulse strength
+     * @param radius - max distance of effect (default: Infinity)
+     * @param falloff - how force decreases with distance (default: CONSTANT)
+     */
+    applyKnockbackToPlayer(fromPosition: Vector3Type, magnitude: number, radius?: number, falloff?: KnockbackFalloff): void;
+    /**
+     * Apply a continuous force to the player for a limited duration.
+     * After `duration` seconds the force is automatically removed.
+     * Calling again with the same source resets the timer.
+     *
+     * @param source - Entity key identifying this force source
+     * @param duration - how long the force lasts, in seconds
+     * @param vector - single `vector` whose length encodes the strength
+     * or use overload for `direction` with a separate `magnitude` — the direction will be normalized before scaling.
+     */
+    applyForceToPlayerForDuration(source: Entity, duration: number, vector: Vector3Type): void;
+    applyForceToPlayerForDuration(source: Entity, duration: number, direction: Vector3Type, magnitude: number): void;
+    /**
+     * Apply a continuous repulsion force that pushes the player away from a point,
+     * recalculating direction every tick as the player moves.
+     * Remove with `removeForceFromPlayer(source)`.
+     *
+     * Negative magnitude = attraction (pulls toward the source).
+     *
+     * @param source - Entity key identifying this force source
+     * @param fromPosition - world-space origin of repulsion
+     * @param magnitude - base force strength
+     * @param radius - max distance of effect (default: Infinity)
+     * @param falloff - how force decreases with distance (default: CONSTANT)
+     */
+    applyRepulsionForceToPlayer(source: Entity, fromPosition: Vector3Type, magnitude: number, radius?: number, falloff?: KnockbackFalloff): void;
+}
+
 /**
  * Represens a plane by the equation ax + by + cz + d = 0
  * @public
@@ -6705,6 +7041,30 @@ export declare interface PointerEventsSystem {
      * @param entity - Entity where the callback was attached
      */
     removeOnPointerHoverLeave(entity: Entity): void;
+    /**
+     * @public
+     * Remove the callback for onProximityDown event
+     * @param entity - Entity where the callback was attached
+     */
+    removeOnProximityDown(entity: Entity): void;
+    /**
+     * @public
+     * Remove the callback for onProximityUp event
+     * @param entity - Entity where the callback was attached
+     */
+    removeOnProximityUp(entity: Entity): void;
+    /**
+     * @public
+     * Remove the callback for onProximityEnter event
+     * @param entity - Entity where the callback was attached
+     */
+    removeOnProximityEnter(entity: Entity): void;
+    /**
+     * @public
+     * Remove the callback for onProximityLeave event
+     * @param entity - Entity where the callback was attached
+     */
+    removeOnProximityLeave(entity: Entity): void;
     /**
      * @public
      * Execute callback when the user press the InputButton pointing at the entity
@@ -6759,6 +7119,46 @@ export declare interface PointerEventsSystem {
         entity: Entity;
         opts?: Partial<EventSystemOptions>;
     }, cb: EventSystemCallback): void;
+    /**
+     * @public
+     * Execute callback when the user presses the proximity button on the entity
+     * @param pointerData - Entity to attach the callback - Opts to trigger Feedback and Button
+     * @param cb - Function to execute when click fires
+     */
+    onProximityDown(pointerData: {
+        entity: Entity;
+        opts?: Partial<EventSystemOptions>;
+    }, cb: EventSystemCallback): void;
+    /**
+     * @public
+     * Execute callback when the user releases the proximity button on the entity
+     * @param pointerData - Entity to attach the callback - Opts to trigger Feedback and Button
+     * @param cb - Function to execute when event fires
+     */
+    onProximityUp(pointerData: {
+        entity: Entity;
+        opts?: Partial<EventSystemOptions>;
+    }, cb: EventSystemCallback): void;
+    /**
+     * @public
+     * Execute callback when the entity enters the proximity zone of the user
+     * @param pointerData - Entity to attach the callback - Opts to trigger Feedback and Button
+     * @param cb - Function to execute when event fires
+     */
+    onProximityEnter(pointerData: {
+        entity: Entity;
+        opts?: Partial<EventSystemOptions>;
+    }, cb: EventSystemCallback): void;
+    /**
+     * @public
+     * Execute callback when the entity leaves the proximity zone of the user
+     * @param pointerData - Entity to attach the callback - Opts to trigger Feedback and Button
+     * @param cb - Function to execute when event fires
+     */
+    onProximityLeave(pointerData: {
+        entity: Entity;
+        opts?: Partial<EventSystemOptions>;
+    }, cb: EventSystemCallback): void;
 }
 
 /**
@@ -6775,7 +7175,9 @@ export declare const enum PointerEventType {
     PET_UP = 0,
     PET_DOWN = 1,
     PET_HOVER_ENTER = 2,
-    PET_HOVER_LEAVE = 3
+    PET_HOVER_LEAVE = 3,
+    PET_PROXIMITY_ENTER = 4,
+    PET_PROXIMITY_LEAVE = 5
 }
 
 /**
@@ -7670,6 +8072,13 @@ export declare namespace RotateContinuous {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): RotateContinuous;
 }
 
+/**
+ * @public
+ * Rotate a vector by a quaternion
+ * Uses the formula: v' = q * v * q^(-1), optimized version
+ */
+export declare function rotateVectorByQuaternion(v: Vector3Type, q: QuaternionType): Vector3Type;
+
 export declare type RPCSendableMessage = {
     jsonrpc: '2.0';
     id: number;
@@ -8361,6 +8770,18 @@ export declare type TransformComponent = LastWriteWinElementSetComponentDefiniti
 export declare interface TransformComponentExtended extends TransformComponent {
     create(entity: Entity, val?: TransformTypeWithOptionals): TransformType;
     createOrReplace(entity: Entity, val?: TransformTypeWithOptionals): TransformType;
+    /**
+     * Transforms a direction vector from an entity's local coordinate space
+     * to world space, accounting for the full parent hierarchy.
+     *
+     * This applies only rotation (not translation or scale) — suitable for
+     * direction vectors like force/impulse directions.
+     *
+     * @param entity - The source entity whose local space defines the direction
+     * @param localDirection - Direction vector in the entity's local coordinates
+     * @returns The direction vector in world coordinates
+     */
+    localToWorldDirection(entity: Entity, localDirection: Vector3Type): Vector3Type;
 }
 
 /**
@@ -8911,14 +9332,6 @@ export declare interface UiTransformProps {
  */
 export declare type Unpacked<T> = T extends (infer U)[] ? U : T;
 
-export declare type ValidateCallback<T> = (value: {
-    entity: Entity;
-    currentValue: T | undefined;
-    newValue: T | undefined;
-    senderAddress: string;
-    createdBy: string;
-}) => boolean;
-
 /**
  * @public
  */