@dcl/playground-assets 7.25.1-30447792919.commit-c06a494 → 7.25.1-30570000030.commit-eaa1fa5

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

@@ -1,7 +1,7 @@
 {
   "name": "@dcl/sdk",
   "description": "",
-  "version": "7.25.1-30447792919.commit-c06a494",
+  "version": "7.25.1-30570000030.commit-eaa1fa5",
   "author": "Decentraland",
   "dependencies": {
     "@dcl/ecs": "file:../ecs",
@@ -34,5 +34,5 @@
   },
   "types": "./index.d.ts",
   "typings": "./index.d.ts",
-  "commit": "c06a4949a4e3dd50ed906d35304aefa6baebfc0d"
+  "commit": "eaa1fa58d4deeb7a4102151ad91bd857be38023b"
 }

package/dist/playground-assets.d.ts

@@ -263,15 +263,6 @@ export declare const AvatarBase: LastWriteWinElementSetComponentDefinition<PBAva
 /** @public */
 export declare const AvatarEmoteCommand: GrowOnlyValueSetComponentDefinition<PBAvatarEmoteCommand>;
 
-/** Mask for which bones an animation applies to. */
-/**
- * @public
- */
-export declare const enum AvatarEmoteMask {
-    AEM_FULL_BODY = 0,
-    AEM_UPPER_BODY = 1
-}
-
 /** @public */
 export declare const AvatarEquippedData: LastWriteWinElementSetComponentDefinition<PBAvatarEquippedData>;
 
@@ -2063,6 +2054,7 @@ export declare type EntityComponents = {
     uiBackground: PBUiBackground;
     uiInput: PBUiInput;
     uiDropdown: PBUiDropdown;
+    uiInputBinding: PBUiInputBinding;
     onMouseDown: Callback;
     onMouseUp: Callback;
     onMouseEnter: Callback;
@@ -2085,6 +2077,8 @@ export declare interface EntityPropTypes extends Listeners {
     uiTransform?: UiTransformProps;
     /** To define a background color or image */
     uiBackground?: UiBackgroundProps;
+    /** Bind input actions to this element, held down while it's pressed (touch or pointer) */
+    uiInputBinding?: PBUiInputBinding;
     /** Uinique key to identiy elments when iterating arrays */
     key?: Key;
 }
@@ -9136,8 +9130,34 @@ export declare const ToLinearSpace = 2.2;
  */
 export declare type ToOptional<T> = OnlyOptionalUndefinedTypes<T> & OnlyNonUndefinedTypes<T>;
 
-/** @public */
-export declare const TouchScreenControls: LastWriteWinElementSetComponentDefinition<PBTouchScreenControls>;
+export declare const TouchScreenControls: TouchScreenControlsComponentDefinitionExtended;
+
+/**
+ * @public
+ * TouchScreenControls with convenience helpers. All helpers write the component onto the
+ * RootEntity (where the client reads it) and merge with the current value.
+ */
+export declare interface TouchScreenControlsComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBTouchScreenControls> {
+    /** Hide every on-screen gamepad button. */
+    hideAll(): void;
+    /**
+     * Show every on-screen gamepad button (clears the button hide list).
+     * Does NOT change the joystick/crosshair — use `showJoystick()` / `showCrosshair()` for those.
+     */
+    showAll(): void;
+    /** Hide the given on-screen buttons (merged into the current config). */
+    hide(actions: InputAction[]): void;
+    /** Set which action the large central button triggers. */
+    setMainAction(action: InputAction): void;
+    /** Hide the native virtual joystick. */
+    hideJoystick(): void;
+    /** Show the native virtual joystick. */
+    showJoystick(): void;
+    /** Hide the on-screen crosshair / reticle. */
+    hideCrosshair(): void;
+    /** Show the on-screen crosshair / reticle. */
+    showCrosshair(): void;
+}
 
 export declare const Transform: TransformComponentExtended;
 

package/etc/playground-assets.api.json

@@ -2616,65 +2616,6 @@
             "endIndex": 5
           }
         },
-        {
-          "kind": "Enum",
-          "canonicalReference": "@dcl/playground-assets!AvatarEmoteMask:enum",
-          "docComment": "/**\n * @public\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export declare const enum AvatarEmoteMask "
-            }
-          ],
-          "fileUrlPath": "../ecs/dist/components/generated/pb/decentraland/sdk/components/avatar_shape.gen.d.ts",
-          "releaseTag": "Public",
-          "name": "AvatarEmoteMask",
-          "preserveMemberOrder": false,
-          "members": [
-            {
-              "kind": "EnumMember",
-              "canonicalReference": "@dcl/playground-assets!AvatarEmoteMask.AEM_FULL_BODY:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "AEM_FULL_BODY = "
-                },
-                {
-                  "kind": "Content",
-                  "text": "0"
-                }
-              ],
-              "initializerTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Public",
-              "name": "AEM_FULL_BODY"
-            },
-            {
-              "kind": "EnumMember",
-              "canonicalReference": "@dcl/playground-assets!AvatarEmoteMask.AEM_UPPER_BODY:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "AEM_UPPER_BODY = "
-                },
-                {
-                  "kind": "Content",
-                  "text": "1"
-                }
-              ],
-              "initializerTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Public",
-              "name": "AEM_UPPER_BODY"
-            }
-          ]
-        },
         {
           "kind": "Variable",
           "canonicalReference": "@dcl/playground-assets!AvatarEquippedData:var",
@@ -20186,6 +20127,15 @@
               "text": "PBUiDropdown",
               "canonicalReference": "@dcl/playground-assets!PBUiDropdown"
             },
+            {
+              "kind": "Content",
+              "text": ";\n    uiInputBinding: "
+            },
+            {
+              "kind": "Reference",
+              "text": "PBUiInputBinding",
+              "canonicalReference": "@dcl/playground-assets!PBUiInputBinding"
+            },
             {
               "kind": "Content",
               "text": ";\n    onMouseDown: "
@@ -20236,7 +20186,7 @@
           "name": "EntityComponents",
           "typeTokenRange": {
             "startIndex": 1,
-            "endIndex": 20
+            "endIndex": 22
           }
         },
         {
@@ -20399,6 +20349,34 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@dcl/playground-assets!EntityPropTypes#uiInputBinding:member",
+              "docComment": "/**\n * Bind input actions to this element, held down while it's pressed (touch or pointer)\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "uiInputBinding?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PBUiInputBinding",
+                  "canonicalReference": "@dcl/playground-assets!PBUiInputBinding"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "uiInputBinding",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@dcl/playground-assets!EntityPropTypes#uiTransform:member",
@@ -86184,12 +86162,36 @@
         {
           "kind": "Variable",
           "canonicalReference": "@dcl/playground-assets!TouchScreenControls:var",
-          "docComment": "/**\n * @public\n */\n",
+          "docComment": "",
           "excerptTokens": [
             {
               "kind": "Content",
               "text": "TouchScreenControls: "
             },
+            {
+              "kind": "Reference",
+              "text": "TouchScreenControlsComponentDefinitionExtended",
+              "canonicalReference": "@dcl/playground-assets!TouchScreenControlsComponentDefinitionExtended:interface"
+            }
+          ],
+          "fileUrlPath": "../ecs/dist/index.d.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "TouchScreenControls",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@dcl/playground-assets!TouchScreenControlsComponentDefinitionExtended:interface",
+          "docComment": "/**\n * TouchScreenControls with convenience helpers. All helpers write the component onto the RootEntity (where the client reads it) and merge with the current value.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface TouchScreenControlsComponentDefinitionExtended extends "
+            },
             {
               "kind": "Reference",
               "text": "LastWriteWinElementSetComponentDefinition",
@@ -86207,16 +86209,288 @@
             {
               "kind": "Content",
               "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": " "
             }
           ],
-          "fileUrlPath": "../ecs/dist/components/generated/global.gen.d.ts",
-          "isReadonly": true,
+          "fileUrlPath": "../ecs/dist/components/extended/TouchScreenControls.d.ts",
           "releaseTag": "Public",
-          "name": "TouchScreenControls",
-          "variableTypeTokenRange": {
-            "startIndex": 1,
-            "endIndex": 5
-          }
+          "name": "TouchScreenControlsComponentDefinitionExtended",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@dcl/playground-assets!TouchScreenControlsComponentDefinitionExtended#hide:member(1)",
+              "docComment": "/**\n * Hide the given on-screen buttons (merged into the current config).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "hide(actions: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "InputAction",
+                  "canonicalReference": "@dcl/playground-assets!InputAction:enum"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 4,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "actions",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 3
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "hide"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@dcl/playground-assets!TouchScreenControlsComponentDefinitionExtended#hideAll:member(1)",
+              "docComment": "/**\n * Hide every on-screen gamepad button.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "hideAll(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "hideAll"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@dcl/playground-assets!TouchScreenControlsComponentDefinitionExtended#hideCrosshair:member(1)",
+              "docComment": "/**\n * Hide the on-screen crosshair / reticle.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "hideCrosshair(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "hideCrosshair"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@dcl/playground-assets!TouchScreenControlsComponentDefinitionExtended#hideJoystick:member(1)",
+              "docComment": "/**\n * Hide the native virtual joystick.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "hideJoystick(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "hideJoystick"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@dcl/playground-assets!TouchScreenControlsComponentDefinitionExtended#setMainAction:member(1)",
+              "docComment": "/**\n * Set which action the large central button triggers.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "setMainAction(action: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "InputAction",
+                  "canonicalReference": "@dcl/playground-assets!InputAction:enum"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "action",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "setMainAction"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@dcl/playground-assets!TouchScreenControlsComponentDefinitionExtended#showAll:member(1)",
+              "docComment": "/**\n * Show every on-screen gamepad button (clears the button hide list). Does NOT change the joystick/crosshair — use `showJoystick()` / `showCrosshair()` for those.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "showAll(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "showAll"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@dcl/playground-assets!TouchScreenControlsComponentDefinitionExtended#showCrosshair:member(1)",
+              "docComment": "/**\n * Show the on-screen crosshair / reticle.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "showCrosshair(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "showCrosshair"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@dcl/playground-assets!TouchScreenControlsComponentDefinitionExtended#showJoystick:member(1)",
+              "docComment": "/**\n * Show the native virtual joystick.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "showJoystick(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "showJoystick"
+            }
+          ],
+          "extendsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 5
+            }
+          ]
         },
         {
           "kind": "Variable",

package/etc/playground-assets.api.md

@@ -184,14 +184,6 @@ export const AvatarBase: LastWriteWinElementSetComponentDefinition<PBAvatarBase>
 // @public (undocumented)
 export const AvatarEmoteCommand: GrowOnlyValueSetComponentDefinition<PBAvatarEmoteCommand>;
 
-// @public (undocumented)
-export const enum AvatarEmoteMask {
-    // (undocumented)
-    AEM_FULL_BODY = 0,
-    // (undocumented)
-    AEM_UPPER_BODY = 1
-}
-
 // @public (undocumented)
 export const AvatarEquippedData: LastWriteWinElementSetComponentDefinition<PBAvatarEquippedData>;
 
@@ -1195,6 +1187,7 @@ export type EntityComponents = {
     uiBackground: PBUiBackground;
     uiInput: PBUiInput;
     uiDropdown: PBUiDropdown;
+    uiInputBinding: PBUiInputBinding;
     onMouseDown: Callback;
     onMouseUp: Callback;
     onMouseEnter: Callback;
@@ -1215,6 +1208,7 @@ export enum EntityMappingMode {
 export interface EntityPropTypes extends Listeners {
     key?: Key;
     uiBackground?: UiBackgroundProps;
+    uiInputBinding?: PBUiInputBinding;
     uiTransform?: UiTransformProps;
 }
 
@@ -5111,8 +5105,22 @@ export const ToLinearSpace = 2.2;
 // @public (undocumented)
 export type ToOptional<T> = OnlyOptionalUndefinedTypes<T> & OnlyNonUndefinedTypes<T>;
 
+// Warning: (ae-missing-release-tag) "TouchScreenControls" is part of the package's API, but it is missing a release tag (@alpha, @beta, @public, or @internal)
+//
 // @public (undocumented)
-export const TouchScreenControls: LastWriteWinElementSetComponentDefinition<PBTouchScreenControls>;
+export const TouchScreenControls: TouchScreenControlsComponentDefinitionExtended;
+
+// @public
+export interface TouchScreenControlsComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBTouchScreenControls> {
+    hide(actions: InputAction[]): void;
+    hideAll(): void;
+    hideCrosshair(): void;
+    hideJoystick(): void;
+    setMainAction(action: InputAction): void;
+    showAll(): void;
+    showCrosshair(): void;
+    showJoystick(): void;
+}
 
 // Warning: (ae-missing-release-tag) "Transform" is part of the package's API, but it is missing a release tag (@alpha, @beta, @public, or @internal)
 //

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dcl/playground-assets",
   "description": "",
-  "version": "7.25.1-30447792919.commit-c06a494",
+  "version": "7.25.1-30570000030.commit-eaa1fa5",
   "author": "Decentraland",
   "dependencies": {
-    "@dcl/js-runtime": "7.25.1-30447792919.commit-c06a494",
-    "@dcl/sdk": "7.25.1-30447792919.commit-c06a494"
+    "@dcl/js-runtime": "7.25.1-30570000030.commit-eaa1fa5",
+    "@dcl/sdk": "7.25.1-30570000030.commit-eaa1fa5"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.33.8"
@@ -32,5 +32,5 @@
   },
   "types": "./dist/index.d.ts",
   "typings": "./dist/index.d.ts",
-  "commit": "c06a4949a4e3dd50ed906d35304aefa6baebfc0d"
+  "commit": "eaa1fa58d4deeb7a4102151ad91bd857be38023b"
 }