@dcl/playground-assets 7.27.1-33533530571.commit-451d001 → 7.27.1-33533891406.commit-6a98834

package/dist/alpha.d.ts

@@ -245,42 +245,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
@@ -453,22 +417,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 */
@@ -1710,12 +1658,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
@@ -1770,8 +1718,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
 }
 
 /**
@@ -1779,8 +1726,6 @@ export declare enum CrdtMessageType {
  */
 export declare type CrdtNetworkMessageBody = PutNetworkComponentMessageBody | DeleteComponentNetworkMessageBody | DeleteEntityNetworkMessageBody;
 
-export declare const CreatedBy: ICreatedBy;
-
 /**
  * @public
  */
@@ -2237,8 +2182,10 @@ export declare type EventSystemOptions = {
     maxDistance?: number;
     showFeedback?: boolean;
     showHighlight?: boolean;
+    /** @deprecated use `maxDistance` instead (same semantics: distance from the player) */
     maxPlayerDistance?: number;
     priority?: number;
+    maxCameraDistance?: number;
 };
 
 /**
@@ -2550,12 +2497,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
  */
@@ -3038,35 +2979,6 @@ export declare const enum InteractionType {
     PROXIMITY = 1
 }
 
-/**
- * Internal component interface that exposes all internal methods for SDK use
- * This is not exposed to users, only for internal SDK operations
- */
-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;
-}
-
 /**
  * @public
  */
@@ -6268,24 +6180,27 @@ export declare namespace PBPlayerIdentityData {
  * --------------
  * PointerEvents can enforce interaction range using two independent distance checks:
  *
- * - Camera distance (`max_distance`): distance from the active camera to the target entity.
- * - Player distance (`max_player_distance`): distance from the avatar/player position to the target entity.
+ * - Player distance (`max_distance`): distance from the avatar/player position to the target entity.
+ * - Camera distance (`max_camera_distance`): distance from the active camera to the target entity.
+ *
+ * `max_player_distance` is deprecated: it is an alias for `max_distance` (both are player distance).
+ * If both are present, the larger of the two is used as the player distance threshold.
  *
  * How the interaction checks are combined:
  *
  * 1) Only `max_distance` is present
- *    - The interaction is allowed only if the camera distance is <= `max_distance`.
+ *    - The interaction is allowed only if the player distance is <= `max_distance`.
  *
- * 2) Only `max_player_distance` is present
- *    - The interaction is allowed only if the player distance is <= `max_player_distance`.
+ * 2) Only `max_camera_distance` is present
+ *    - The interaction is allowed only if the camera distance is <= `max_camera_distance`.
  *
- * 3) Both `max_distance` and `max_player_distance` are present
+ * 3) Both `max_distance` and `max_camera_distance` are present
  *    - The interaction is allowed if ANY of the checks passes (OR logic):
- *      (camera distance <= `max_distance`) OR (player distance <= `max_player_distance`).
+ *      (player distance <= `max_distance`) OR (camera distance <= `max_camera_distance`).
  *
- * 4) Neither `max_distance` nor `max_player_distance` is present
+ * 4) Neither `max_distance` nor `max_camera_distance` is present
  *    - The system behaves as if `max_distance` were set to its default value (10),
- *      i.e., it uses the camera distance check with a threshold of 10.
+ *      i.e., it uses the player distance check with a threshold of 10.
  */
 /**
  * @public
@@ -6331,16 +6246,18 @@ export declare interface PBPointerEvents_Info {
     button?: InputAction | undefined;
     /** feedback on hover (default 'Interact') */
     hoverText?: string | undefined;
-    /** range of interaction (default 10) */
+    /** range of interaction from the avatar's position (default 10) */
     maxDistance?: number | undefined;
     /** enable or disable hover text and highlight (default true) */
     showFeedback?: boolean | undefined;
     /** enable or disable hover highlight (default true) */
     showHighlight?: boolean | undefined;
-    /** range of interaction from the avatar's position (default 0) */
+    /** @deprecated use `max_distance` instead (same semantics) */
     maxPlayerDistance?: number | undefined;
     /** resolution order when multiple events overlap, higher wins (default 0) */
     priority?: number | undefined;
+    /** range of interaction from the active camera's position (default none) */
+    maxCameraDistance?: number | undefined;
 }
 
 /**
@@ -9480,16 +9397,6 @@ export declare type Transport = {
     onmessage?(message: Uint8Array): void;
     filter(message: Omit<TransportMessage, 'messageBuffer'>): boolean;
     type?: string;
-    /**
-     * Whether this transport is allowed to mutate reserved-range entities
-     * (root/player/camera + avatars, entity number below `RESERVED_STATIC_ENTITIES`).
-     * Only the trusted host/renderer transport sets this. An inbound DELETE_ENTITY
-     * or component operation (PUT_COMPONENT, DELETE_COMPONENT, APPEND_VALUE,
-     * AUTHORITATIVE_PUT_COMPONENT) on a reserved entity from a transport without
-     * this flag (a comms peer, or any scene-added transport) is rejected — see
-     * `receiveMessages`.
-     */
-    allowReservedEntities?: boolean;
 };
 
 /**
@@ -10058,14 +9965,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
  */

package/dist/beta.d.ts

@@ -245,42 +245,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
@@ -453,22 +417,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 */
@@ -1710,12 +1658,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
@@ -1770,8 +1718,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
 }
 
 /**
@@ -1779,8 +1726,6 @@ export declare enum CrdtMessageType {
  */
 export declare type CrdtNetworkMessageBody = PutNetworkComponentMessageBody | DeleteComponentNetworkMessageBody | DeleteEntityNetworkMessageBody;
 
-export declare const CreatedBy: ICreatedBy;
-
 /**
  * @public
  */
@@ -2237,8 +2182,10 @@ export declare type EventSystemOptions = {
     maxDistance?: number;
     showFeedback?: boolean;
     showHighlight?: boolean;
+    /** @deprecated use `maxDistance` instead (same semantics: distance from the player) */
     maxPlayerDistance?: number;
     priority?: number;
+    maxCameraDistance?: number;
 };
 
 /**
@@ -2550,12 +2497,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
  */
@@ -3029,35 +2970,6 @@ export declare const enum InteractionType {
     PROXIMITY = 1
 }
 
-/**
- * Internal component interface that exposes all internal methods for SDK use
- * This is not exposed to users, only for internal SDK operations
- */
-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;
-}
-
 /**
  * @public
  */
@@ -6240,24 +6152,27 @@ export declare namespace PBPlayerIdentityData {
  * --------------
  * PointerEvents can enforce interaction range using two independent distance checks:
  *
- * - Camera distance (`max_distance`): distance from the active camera to the target entity.
- * - Player distance (`max_player_distance`): distance from the avatar/player position to the target entity.
+ * - Player distance (`max_distance`): distance from the avatar/player position to the target entity.
+ * - Camera distance (`max_camera_distance`): distance from the active camera to the target entity.
+ *
+ * `max_player_distance` is deprecated: it is an alias for `max_distance` (both are player distance).
+ * If both are present, the larger of the two is used as the player distance threshold.
  *
  * How the interaction checks are combined:
  *
  * 1) Only `max_distance` is present
- *    - The interaction is allowed only if the camera distance is <= `max_distance`.
+ *    - The interaction is allowed only if the player distance is <= `max_distance`.
  *
- * 2) Only `max_player_distance` is present
- *    - The interaction is allowed only if the player distance is <= `max_player_distance`.
+ * 2) Only `max_camera_distance` is present
+ *    - The interaction is allowed only if the camera distance is <= `max_camera_distance`.
  *
- * 3) Both `max_distance` and `max_player_distance` are present
+ * 3) Both `max_distance` and `max_camera_distance` are present
  *    - The interaction is allowed if ANY of the checks passes (OR logic):
- *      (camera distance <= `max_distance`) OR (player distance <= `max_player_distance`).
+ *      (player distance <= `max_distance`) OR (camera distance <= `max_camera_distance`).
  *
- * 4) Neither `max_distance` nor `max_player_distance` is present
+ * 4) Neither `max_distance` nor `max_camera_distance` is present
  *    - The system behaves as if `max_distance` were set to its default value (10),
- *      i.e., it uses the camera distance check with a threshold of 10.
+ *      i.e., it uses the player distance check with a threshold of 10.
  */
 /**
  * @public
@@ -6303,16 +6218,18 @@ export declare interface PBPointerEvents_Info {
     button?: InputAction | undefined;
     /** feedback on hover (default 'Interact') */
     hoverText?: string | undefined;
-    /** range of interaction (default 10) */
+    /** range of interaction from the avatar's position (default 10) */
     maxDistance?: number | undefined;
     /** enable or disable hover text and highlight (default true) */
     showFeedback?: boolean | undefined;
     /** enable or disable hover highlight (default true) */
     showHighlight?: boolean | undefined;
-    /** range of interaction from the avatar's position (default 0) */
+    /** @deprecated use `max_distance` instead (same semantics) */
     maxPlayerDistance?: number | undefined;
     /** resolution order when multiple events overlap, higher wins (default 0) */
     priority?: number | undefined;
+    /** range of interaction from the active camera's position (default none) */
+    maxCameraDistance?: number | undefined;
 }
 
 /**
@@ -9447,16 +9364,6 @@ export declare type Transport = {
     onmessage?(message: Uint8Array): void;
     filter(message: Omit<TransportMessage, 'messageBuffer'>): boolean;
     type?: string;
-    /**
-     * Whether this transport is allowed to mutate reserved-range entities
-     * (root/player/camera + avatars, entity number below `RESERVED_STATIC_ENTITIES`).
-     * Only the trusted host/renderer transport sets this. An inbound DELETE_ENTITY
-     * or component operation (PUT_COMPONENT, DELETE_COMPONENT, APPEND_VALUE,
-     * AUTHORITATIVE_PUT_COMPONENT) on a reserved entity from a transport without
-     * this flag (a comms peer, or any scene-added transport) is rejected — see
-     * `receiveMessages`.
-     */
-    allowReservedEntities?: boolean;
 };
 
 /**
@@ -10025,14 +9932,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
  */