@dcl/playground-assets 7.8.9 → 7.8.10-15468321387.commit-ea03486

package/dist/alpha.d.ts

@@ -1309,6 +1309,7 @@ export declare const componentDefinitionByName: {
     "core::GltfContainer": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainer>>;
     "core::GltfContainerLoadingState": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainerLoadingState>>;
     "core::InputModifier": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBInputModifier>>;
+    "core::LightSource": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBLightSource>>;
     "core::MainCamera": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMainCamera>>;
     "core::Material": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMaterial>>;
     "core::MeshCollider": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMeshCollider>>;
@@ -1318,6 +1319,7 @@ export declare const componentDefinitionByName: {
     "core::PointerEvents": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPointerEvents>>;
     "core::PointerEventsResult": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBPointerEventsResult>>;
     "core::PointerLock": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPointerLock>>;
+    "core::PrimaryPointerInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPrimaryPointerInfo>>;
     "core::Raycast": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRaycast>>;
     "core::RaycastResult": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRaycastResult>>;
     "core::RealmInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRealmInfo>>;
@@ -2674,6 +2676,32 @@ export declare interface LastWriteWinElementSetComponentDefinition<T> extends Ba
     getOrCreateMutable(entity: Entity, initialValue?: T): T;
 }
 
+export declare const LightSource: LightSourceComponentDefinitionExtended;
+
+/**
+ * @public
+ */
+export declare interface LightSourceComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBLightSource> {
+    /**
+     * LightSource helper with constructor
+     */
+    Type: LightSourceHelper;
+}
+
+/**
+ * @public
+ */
+export declare interface LightSourceHelper {
+    /**
+     * @returns a Light Source type
+     */
+    Point: (point: PBLightSource_Point) => PBLightSource['type'];
+    /**
+     * @returns a Light Source type
+     */
+    Spot: (spot: PBLightSource_Spot) => PBLightSource['type'];
+}
+
 /**
  * User key event Listeners
  * @public
@@ -4549,6 +4577,85 @@ export declare namespace PBInputModifier_StandardInput {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBInputModifier_StandardInput;
 }
 
+/**
+ * @public
+ */
+export declare interface PBLightSource {
+    /** default = true, whether the lightSource is active or not. */
+    active?: boolean | undefined;
+    /** default = Color.white, the tint of the light, in RGB format where each component is a floating point value with a range from 0 to 1. */
+    color?: PBColor3 | undefined;
+    /** default = 250, ranges from 1 (dim) to 100,000 (very bright), expressed in Lumens for Point and Spot. */
+    brightness?: number | undefined;
+    /** default = 10, how far the light travels, expressed in meters. */
+    range?: number | undefined;
+    type?: {
+        $case: "point";
+        point: PBLightSource_Point;
+    } | {
+        $case: "spot";
+        spot: PBLightSource_Spot;
+    } | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBLightSource {
+    export function encode(message: PBLightSource, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBLightSource;
+}
+
+/**
+ * @public
+ */
+export declare interface PBLightSource_Point {
+    /** default = ShadowType.ST_NONE The type of shadow the light source supports. */
+    shadow?: PBLightSource_ShadowType | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBLightSource_Point {
+    export function encode(message: PBLightSource_Point, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBLightSource_Point;
+}
+
+/**
+ * @public
+ */
+export declare const enum PBLightSource_ShadowType {
+    /** ST_NONE - No shadows are cast from this LightSource. */
+    ST_NONE = 0,
+    /** ST_SOFT - More realistic type of shadow that reduces block artifacts, noise or pixelation, but requires more processing. */
+    ST_SOFT = 1,
+    /** ST_HARD - Less realistic type of shadow but more performant, uses hard edges. */
+    ST_HARD = 2
+}
+
+/**
+ * @public
+ */
+export declare interface PBLightSource_Spot {
+    /** default = 21.8. Inner angle can't be higher than outer angle, otherwise will default to same value. Min value is 0. Max value is 179. */
+    innerAngle?: number | undefined;
+    /** default = 30. Outer angle can't be lower than inner angle, otherwise will inner angle will be set to same value. Max value is 179. */
+    outerAngle?: number | undefined;
+    /** default = ShadowType.ST_NONE The type of shadow the light source supports. */
+    shadow?: PBLightSource_ShadowType | undefined;
+    /** Texture mask through which shadows are cast to simulate caustics, soft shadows, and light shapes such as light entering from a window. */
+    shadowMaskTexture?: TextureUnion | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBLightSource_Spot {
+    export function encode(message: PBLightSource_Spot, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBLightSource_Spot;
+}
+
 /**
  * PBMainCamera.virtualCameraEntity defines which VirtualCamera entity is active at the moment.
  * This component may hold 'repeated common.CameraTransition' transitionOverrides in the future
@@ -5052,6 +5159,48 @@ export declare namespace PBPosition {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBPosition;
 }
 
+/**
+ * The PBPrimaryPointerInfo component provides information about the current state of the primary
+ * pointer input device (mouse, touch, gamepad, or VR controller). It tracks the pointer's position,
+ * movement, and interaction capabilities in both 2D screen space and 3D world space.
+ *
+ * This component is essential for:
+ * - Tracking cursor/pointer position and movement
+ * - Converting 2D screen coordinates to 3D world space interactions
+ * - Supporting multiple input methods (mouse, touch, gamepad, VR)
+ * - Enabling ray-based interactions for 3D object selection
+ *
+ * The component can be used to:
+ * - Implement drag-and-drop functionality
+ * - Handle touch interactions on mobile devices
+ * - Support gamepad navigation
+ * - Enable VR controller interactions
+ * - Convert screen coordinates to world space rays for 3D interactions
+ *
+ * Note: Touch, Pad, and Wand support, as well as dragging, will be added later.
+ */
+/**
+ * @public
+ */
+export declare interface PBPrimaryPointerInfo {
+    /** The type of input device being used */
+    pointerType?: PointerType | undefined;
+    /** Current position in screen space (pixels) */
+    screenCoordinates?: PBVector2 | undefined;
+    /** Movement since last frame (pixels) */
+    screenDelta?: PBVector2 | undefined;
+    /** Direction vector for 3D ray casting */
+    worldRayDirection?: PBVector3 | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBPrimaryPointerInfo {
+    export function encode(message: PBPrimaryPointerInfo, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBPrimaryPointerInfo;
+}
+
 /**
  * @public
  */
@@ -5156,12 +5305,19 @@ export declare namespace PBRaycastResult {
  * @public
  */
 export declare interface PBRealmInfo {
+    /** the domain of the realm server */
     baseUrl: string;
+    /** the name of the realm server (more info https://adr.decentraland.org/adr/ADR-110) */
     realmName: string;
+    /** the network id (1=Ethereum, more info https://chainlist.org/) */
     networkId: number;
+    /** comms adapter (more info https://adr.decentraland.org/adr/ADR-180) */
     commsAdapter: string;
+    /** true if the scene is running as a local preview, instead of published in Decentraland. */
     isPreview: boolean;
+    /** the room session id. */
     room?: string | undefined;
+    /** true if the user is connected to the scene room. */
     isConnectedSceneRoom?: boolean | undefined;
 }
 
@@ -5679,6 +5835,7 @@ export declare namespace PBVideoPlayer {
  * an 'instant' transition (like using speed/time = 0)
  * * The lookAtEntity defines to which entity the Camera has to look at constantly (independent from
  * the holding entity transform).
+ * * The fov defines the Field of View of the virtual camera
  */
 /**
  * @public
@@ -5686,6 +5843,8 @@ export declare namespace PBVideoPlayer {
 export declare interface PBVirtualCamera {
     defaultTransition?: CameraTransition | undefined;
     lookAtEntity?: number | undefined;
+    /** default: 60 */
+    fov?: number | undefined;
 }
 
 /**
@@ -5957,6 +6116,20 @@ export declare type PointerFilterType = 'none' | 'block';
 /** @public */
 export declare const PointerLock: LastWriteWinElementSetComponentDefinition<PBPointerLock>;
 
+/**
+ * PointerType enumerates the different input devices that can be used for pointer interactions.
+ * Each type has specific characteristics and use cases in the virtual world.
+ */
+/**
+ * @public
+ */
+export declare const enum PointerType {
+    /** POT_NONE - No pointer input */
+    POT_NONE = 0,
+    /** POT_MOUSE - Traditional mouse input */
+    POT_MOUSE = 1
+}
+
 /**
  * Type used for defining the position of the element. i.e. margin, padding
  * @public
@@ -5994,6 +6167,9 @@ export declare type PositionType = 'absolute' | 'relative';
  */
 export declare type PositionUnit = `${number}px` | `${number}%` | number | `${number}` | ScaleUnit;
 
+/** @public */
+export declare const PrimaryPointerInfo: LastWriteWinElementSetComponentDefinition<PBPrimaryPointerInfo>;
+
 export declare enum ProcessMessageResultType {
     /**
      * Typical message and new state set.

package/dist/beta.d.ts

@@ -1309,6 +1309,7 @@ export declare const componentDefinitionByName: {
     "core::GltfContainer": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainer>>;
     "core::GltfContainerLoadingState": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainerLoadingState>>;
     "core::InputModifier": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBInputModifier>>;
+    "core::LightSource": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBLightSource>>;
     "core::MainCamera": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMainCamera>>;
     "core::Material": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMaterial>>;
     "core::MeshCollider": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBMeshCollider>>;
@@ -1318,6 +1319,7 @@ export declare const componentDefinitionByName: {
     "core::PointerEvents": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPointerEvents>>;
     "core::PointerEventsResult": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBPointerEventsResult>>;
     "core::PointerLock": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPointerLock>>;
+    "core::PrimaryPointerInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBPrimaryPointerInfo>>;
     "core::Raycast": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRaycast>>;
     "core::RaycastResult": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRaycastResult>>;
     "core::RealmInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBRealmInfo>>;
@@ -2665,6 +2667,32 @@ export declare interface LastWriteWinElementSetComponentDefinition<T> extends Ba
     getOrCreateMutable(entity: Entity, initialValue?: T): T;
 }
 
+export declare const LightSource: LightSourceComponentDefinitionExtended;
+
+/**
+ * @public
+ */
+export declare interface LightSourceComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBLightSource> {
+    /**
+     * LightSource helper with constructor
+     */
+    Type: LightSourceHelper;
+}
+
+/**
+ * @public
+ */
+export declare interface LightSourceHelper {
+    /**
+     * @returns a Light Source type
+     */
+    Point: (point: PBLightSource_Point) => PBLightSource['type'];
+    /**
+     * @returns a Light Source type
+     */
+    Spot: (spot: PBLightSource_Spot) => PBLightSource['type'];
+}
+
 /**
  * User key event Listeners
  * @public
@@ -4521,6 +4549,85 @@ export declare namespace PBInputModifier_StandardInput {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBInputModifier_StandardInput;
 }
 
+/**
+ * @public
+ */
+export declare interface PBLightSource {
+    /** default = true, whether the lightSource is active or not. */
+    active?: boolean | undefined;
+    /** default = Color.white, the tint of the light, in RGB format where each component is a floating point value with a range from 0 to 1. */
+    color?: PBColor3 | undefined;
+    /** default = 250, ranges from 1 (dim) to 100,000 (very bright), expressed in Lumens for Point and Spot. */
+    brightness?: number | undefined;
+    /** default = 10, how far the light travels, expressed in meters. */
+    range?: number | undefined;
+    type?: {
+        $case: "point";
+        point: PBLightSource_Point;
+    } | {
+        $case: "spot";
+        spot: PBLightSource_Spot;
+    } | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBLightSource {
+    export function encode(message: PBLightSource, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBLightSource;
+}
+
+/**
+ * @public
+ */
+export declare interface PBLightSource_Point {
+    /** default = ShadowType.ST_NONE The type of shadow the light source supports. */
+    shadow?: PBLightSource_ShadowType | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBLightSource_Point {
+    export function encode(message: PBLightSource_Point, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBLightSource_Point;
+}
+
+/**
+ * @public
+ */
+export declare const enum PBLightSource_ShadowType {
+    /** ST_NONE - No shadows are cast from this LightSource. */
+    ST_NONE = 0,
+    /** ST_SOFT - More realistic type of shadow that reduces block artifacts, noise or pixelation, but requires more processing. */
+    ST_SOFT = 1,
+    /** ST_HARD - Less realistic type of shadow but more performant, uses hard edges. */
+    ST_HARD = 2
+}
+
+/**
+ * @public
+ */
+export declare interface PBLightSource_Spot {
+    /** default = 21.8. Inner angle can't be higher than outer angle, otherwise will default to same value. Min value is 0. Max value is 179. */
+    innerAngle?: number | undefined;
+    /** default = 30. Outer angle can't be lower than inner angle, otherwise will inner angle will be set to same value. Max value is 179. */
+    outerAngle?: number | undefined;
+    /** default = ShadowType.ST_NONE The type of shadow the light source supports. */
+    shadow?: PBLightSource_ShadowType | undefined;
+    /** Texture mask through which shadows are cast to simulate caustics, soft shadows, and light shapes such as light entering from a window. */
+    shadowMaskTexture?: TextureUnion | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBLightSource_Spot {
+    export function encode(message: PBLightSource_Spot, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBLightSource_Spot;
+}
+
 /**
  * PBMainCamera.virtualCameraEntity defines which VirtualCamera entity is active at the moment.
  * This component may hold 'repeated common.CameraTransition' transitionOverrides in the future
@@ -5024,6 +5131,48 @@ export declare namespace PBPosition {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBPosition;
 }
 
+/**
+ * The PBPrimaryPointerInfo component provides information about the current state of the primary
+ * pointer input device (mouse, touch, gamepad, or VR controller). It tracks the pointer's position,
+ * movement, and interaction capabilities in both 2D screen space and 3D world space.
+ *
+ * This component is essential for:
+ * - Tracking cursor/pointer position and movement
+ * - Converting 2D screen coordinates to 3D world space interactions
+ * - Supporting multiple input methods (mouse, touch, gamepad, VR)
+ * - Enabling ray-based interactions for 3D object selection
+ *
+ * The component can be used to:
+ * - Implement drag-and-drop functionality
+ * - Handle touch interactions on mobile devices
+ * - Support gamepad navigation
+ * - Enable VR controller interactions
+ * - Convert screen coordinates to world space rays for 3D interactions
+ *
+ * Note: Touch, Pad, and Wand support, as well as dragging, will be added later.
+ */
+/**
+ * @public
+ */
+export declare interface PBPrimaryPointerInfo {
+    /** The type of input device being used */
+    pointerType?: PointerType | undefined;
+    /** Current position in screen space (pixels) */
+    screenCoordinates?: PBVector2 | undefined;
+    /** Movement since last frame (pixels) */
+    screenDelta?: PBVector2 | undefined;
+    /** Direction vector for 3D ray casting */
+    worldRayDirection?: PBVector3 | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBPrimaryPointerInfo {
+    export function encode(message: PBPrimaryPointerInfo, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBPrimaryPointerInfo;
+}
+
 /**
  * @public
  */
@@ -5128,12 +5277,19 @@ export declare namespace PBRaycastResult {
  * @public
  */
 export declare interface PBRealmInfo {
+    /** the domain of the realm server */
     baseUrl: string;
+    /** the name of the realm server (more info https://adr.decentraland.org/adr/ADR-110) */
     realmName: string;
+    /** the network id (1=Ethereum, more info https://chainlist.org/) */
     networkId: number;
+    /** comms adapter (more info https://adr.decentraland.org/adr/ADR-180) */
     commsAdapter: string;
+    /** true if the scene is running as a local preview, instead of published in Decentraland. */
     isPreview: boolean;
+    /** the room session id. */
     room?: string | undefined;
+    /** true if the user is connected to the scene room. */
     isConnectedSceneRoom?: boolean | undefined;
 }
 
@@ -5651,6 +5807,7 @@ export declare namespace PBVideoPlayer {
  * an 'instant' transition (like using speed/time = 0)
  * * The lookAtEntity defines to which entity the Camera has to look at constantly (independent from
  * the holding entity transform).
+ * * The fov defines the Field of View of the virtual camera
  */
 /**
  * @public
@@ -5658,6 +5815,8 @@ export declare namespace PBVideoPlayer {
 export declare interface PBVirtualCamera {
     defaultTransition?: CameraTransition | undefined;
     lookAtEntity?: number | undefined;
+    /** default: 60 */
+    fov?: number | undefined;
 }
 
 /**
@@ -5929,6 +6088,20 @@ export declare type PointerFilterType = 'none' | 'block';
 /** @public */
 export declare const PointerLock: LastWriteWinElementSetComponentDefinition<PBPointerLock>;
 
+/**
+ * PointerType enumerates the different input devices that can be used for pointer interactions.
+ * Each type has specific characteristics and use cases in the virtual world.
+ */
+/**
+ * @public
+ */
+export declare const enum PointerType {
+    /** POT_NONE - No pointer input */
+    POT_NONE = 0,
+    /** POT_MOUSE - Traditional mouse input */
+    POT_MOUSE = 1
+}
+
 /**
  * Type used for defining the position of the element. i.e. margin, padding
  * @public
@@ -5966,6 +6139,9 @@ export declare type PositionType = 'absolute' | 'relative';
  */
 export declare type PositionUnit = `${number}px` | `${number}%` | number | `${number}` | ScaleUnit;
 
+/** @public */
+export declare const PrimaryPointerInfo: LastWriteWinElementSetComponentDefinition<PBPrimaryPointerInfo>;
+
 export declare enum ProcessMessageResultType {
     /**
      * Typical message and new state set.