@dcl/playground-assets 7.8.9-15283822925.commit-b281f0c → 7.8.10-15453890617.commit-9dc90d3

package/dist/playground/sdk/apis.d.ts

@@ -1320,12 +1320,19 @@ declare module "~system/Runtime" {
 
 	// Function declaration section
         export 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;
     }
 

package/dist/playground/sdk/dcl-sdk.package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dcl/sdk",
   "description": "",
-  "version": "7.8.9-15283822925.commit-b281f0c",
+  "version": "7.8.10-15453890617.commit-9dc90d3",
   "author": "Decentraland",
   "dependencies": {
     "@dcl/ecs": "file:../ecs",
@@ -35,5 +35,5 @@
   },
   "types": "./index.d.ts",
   "typings": "./index.d.ts",
-  "commit": "b281f0c54bee6b279799177fbb3f4d86d837a497"
+  "commit": "9dc90d36557df03682c958b70d7edcc81c1ba711"
 }

package/dist/playground-assets.d.ts

@@ -1318,6 +1318,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>>;
@@ -5052,6 +5053,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 +5199,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;
 }
 
@@ -5957,6 +6007,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 +6058,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/etc/playground-assets.api.json

@@ -13005,6 +13005,33 @@
               "text": "PBPointerLock",
               "canonicalReference": "@dcl/playground-assets!PBPointerLock"
             },
+            {
+              "kind": "Content",
+              "text": ">>;\n    \"core::PrimaryPointerInfo\": "
+            },
+            {
+              "kind": "Reference",
+              "text": "LwwComponentGetter",
+              "canonicalReference": "@dcl/playground-assets!LwwComponentGetter:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "LastWriteWinElementSetComponentDefinition",
+              "canonicalReference": "@dcl/playground-assets!LastWriteWinElementSetComponentDefinition:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "PBPrimaryPointerInfo",
+              "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo"
+            },
             {
               "kind": "Content",
               "text": ">>;\n    \"core::Raycast\": "
@@ -13529,7 +13556,7 @@
           "name": "componentDefinitionByName",
           "variableTypeTokenRange": {
             "startIndex": 1,
-            "endIndex": 272
+            "endIndex": 278
           }
         },
         {
@@ -47282,6 +47309,303 @@
             }
           ]
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo:interface",
+          "docComment": "/**\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface PBPrimaryPointerInfo "
+            }
+          ],
+          "fileUrlPath": "../ecs/dist/components/generated/pb/decentraland/sdk/components/primary_pointer_info.gen.d.ts",
+          "releaseTag": "Public",
+          "name": "PBPrimaryPointerInfo",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo#pointerType:member",
+              "docComment": "/**\n * The type of input device being used\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "pointerType?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PointerType",
+                  "canonicalReference": "@dcl/playground-assets!PointerType:enum"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "pointerType",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo#screenCoordinates:member",
+              "docComment": "/**\n * Current position in screen space (pixels)\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "screenCoordinates?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Vector2",
+                  "canonicalReference": "@dcl/playground-assets!Vector2"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "screenCoordinates",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo#screenDelta:member",
+              "docComment": "/**\n * Movement since last frame (pixels)\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "screenDelta?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Vector2",
+                  "canonicalReference": "@dcl/playground-assets!Vector2"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "screenDelta",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo#worldRayDirection:member",
+              "docComment": "/**\n * Direction vector for 3D ray casting\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "worldRayDirection?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Vector3",
+                  "canonicalReference": "@dcl/playground-assets!Vector3"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "worldRayDirection",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Namespace",
+          "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo:namespace",
+          "docComment": "/**\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare namespace PBPrimaryPointerInfo "
+            }
+          ],
+          "fileUrlPath": "../ecs/dist/components/generated/pb/decentraland/sdk/components/primary_pointer_info.gen.d.ts",
+          "releaseTag": "Public",
+          "name": "PBPrimaryPointerInfo",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "Function",
+              "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo.decode:function(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "function decode(input: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "_m0.Reader",
+                  "canonicalReference": "protobufjs!Reader:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Uint8Array",
+                  "canonicalReference": "!Uint8Array:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", length?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PBPrimaryPointerInfo",
+                  "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "returnTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 8
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "input",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "length",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "decode"
+            },
+            {
+              "kind": "Function",
+              "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo.encode:function(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "function encode(message: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PBPrimaryPointerInfo",
+                  "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", writer?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "_m0.Writer",
+                  "canonicalReference": "protobufjs!Writer:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "_m0.Writer",
+                  "canonicalReference": "protobufjs!Writer:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "message",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "writer",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "encode"
+            }
+          ]
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@dcl/playground-assets!PBQuaternion:interface",
@@ -48287,7 +48611,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@dcl/playground-assets!PBRealmInfo#baseUrl:member",
-              "docComment": "",
+              "docComment": "/**\n * the domain of the realm server\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -48314,7 +48638,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@dcl/playground-assets!PBRealmInfo#commsAdapter:member",
-              "docComment": "",
+              "docComment": "/**\n * comms adapter (more info https://adr.decentraland.org/adr/ADR-180)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -48341,7 +48665,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@dcl/playground-assets!PBRealmInfo#isConnectedSceneRoom:member",
-              "docComment": "",
+              "docComment": "/**\n * true if the user is connected to the scene room.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -48368,7 +48692,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@dcl/playground-assets!PBRealmInfo#isPreview:member",
-              "docComment": "",
+              "docComment": "/**\n * true if the scene is running as a local preview, instead of published in Decentraland.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -48395,7 +48719,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@dcl/playground-assets!PBRealmInfo#networkId:member",
-              "docComment": "",
+              "docComment": "/**\n * the network id (1=Ethereum, more info https://chainlist.org/)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -48422,7 +48746,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@dcl/playground-assets!PBRealmInfo#realmName:member",
-              "docComment": "",
+              "docComment": "/**\n * the name of the realm server (more info https://adr.decentraland.org/adr/ADR-110)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -48449,7 +48773,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@dcl/playground-assets!PBRealmInfo#room:member",
-              "docComment": "",
+              "docComment": "/**\n * the room session id.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -58223,6 +58547,65 @@
             "endIndex": 5
           }
         },
+        {
+          "kind": "Enum",
+          "canonicalReference": "@dcl/playground-assets!PointerType:enum",
+          "docComment": "/**\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare const enum PointerType "
+            }
+          ],
+          "fileUrlPath": "../ecs/dist/components/generated/pb/decentraland/sdk/components/primary_pointer_info.gen.d.ts",
+          "releaseTag": "Public",
+          "name": "PointerType",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "EnumMember",
+              "canonicalReference": "@dcl/playground-assets!PointerType.POT_MOUSE:member",
+              "docComment": "/**\n * POT_MOUSE - Traditional mouse input\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "POT_MOUSE = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "1"
+                }
+              ],
+              "initializerTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "name": "POT_MOUSE"
+            },
+            {
+              "kind": "EnumMember",
+              "canonicalReference": "@dcl/playground-assets!PointerType.POT_NONE:member",
+              "docComment": "/**\n * POT_NONE - No pointer input\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "POT_NONE = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "0"
+                }
+              ],
+              "initializerTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "name": "POT_NONE"
+            }
+          ]
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@dcl/playground-assets!Position:interface",
@@ -58522,6 +58905,43 @@
             "endIndex": 3
           }
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@dcl/playground-assets!PrimaryPointerInfo:var",
+          "docComment": "/**\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "PrimaryPointerInfo: "
+            },
+            {
+              "kind": "Reference",
+              "text": "LastWriteWinElementSetComponentDefinition",
+              "canonicalReference": "@dcl/playground-assets!LastWriteWinElementSetComponentDefinition:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "PBPrimaryPointerInfo",
+              "canonicalReference": "@dcl/playground-assets!PBPrimaryPointerInfo"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            }
+          ],
+          "fileUrlPath": "../ecs/dist/components/generated/global.gen.d.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "PrimaryPointerInfo",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 5
+          }
+        },
         {
           "kind": "Enum",
           "canonicalReference": "@dcl/playground-assets!ProcessMessageResultType:enum",