@dcl/playground-assets 7.27.1-33756439818.commit-3a236ab → 7.27.1-34487041135.commit-2a59cb6

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

@@ -1303,7 +1303,14 @@ declare module "~system/RestrictedActions" {
         duration?: number | undefined;
     }
     export interface TeleportToRequest {
-        worldCoordinates: Vector2 | undefined;
+        /** The parcel to land on. Omitted: the realm's default spawn (only meaningful with `realm`). */
+        worldCoordinates?: Vector2 | undefined;
+        /**
+         * The realm the parcel belongs to: a world name (`foo.dcl.eth`) or a realm url. When set, the
+         * client changes realm (a full reconnect, even to the realm the player is in) and lands on the
+         * parcel there. Omitted: the parcel is in the player's current realm.
+         */
+        realm?: string | undefined;
     }
     export interface TriggerEmoteRequest {
         predefinedEmote: string;
@@ -1365,7 +1372,10 @@ declare module "~system/RestrictedActions" {
     export function teleportTo(body: TeleportToRequest): Promise<TeleportToResponse>;
     /** TriggerEmote will trigger an emote in this current user */
     export function triggerEmote(body: TriggerEmoteRequest): Promise<TriggerEmoteResponse>;
-    /** ChangeRealm prompts the user to change to a specific realm */
+    /**
+     * @deprecated, use TeleportTo with `realm` (and no `world_coordinates` for the realm's default spawn)
+     * ChangeRealm prompts the user to change to a specific realm
+     */
     export function changeRealm(body: ChangeRealmRequest): Promise<SuccessResponse>;
     /** OpenExternalUrl prompts the user to open an external link */
     export function openExternalUrl(body: OpenExternalUrlRequest): Promise<SuccessResponse>;

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

@@ -1,7 +1,7 @@
 {
   "name": "@dcl/sdk",
   "description": "",
-  "version": "7.27.1-33756439818.commit-3a236ab",
+  "version": "7.27.1-34487041135.commit-2a59cb6",
   "author": "Decentraland",
   "dependencies": {
     "@dcl/ecs": "file:../ecs",
@@ -33,5 +33,5 @@
   },
   "types": "./index.d.ts",
   "typings": "./index.d.ts",
-  "commit": "3a236ab909c08dc265a66125c7f118402ab3f3c9"
+  "commit": "2a59cb6c6005b4f6b5c2391d6138778e85e1ae65"
 }

package/dist/playground-assets.d.ts

@@ -318,6 +318,9 @@ export declare const enum AvatarModifierType {
     AMT_HIDE_NAMETAGS = 2
 }
 
+/** @public */
+export declare const AvatarNametag: LastWriteWinElementSetComponentDefinition<PBAvatarNametag>;
+
 /** @public */
 export declare const AvatarShape: LastWriteWinElementSetComponentDefinition<PBAvatarShape>;
 
@@ -1444,6 +1447,7 @@ export declare const componentDefinitionByName: {
     "core::AvatarEquippedData": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarEquippedData>>;
     "core::AvatarLocomotionSettings": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarLocomotionSettings>>;
     "core::AvatarModifierArea": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarModifierArea>>;
+    "core::AvatarNametag": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarNametag>>;
     "core::AvatarShape": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarShape>>;
     "core::Billboard": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBBillboard>>;
     "core::CameraMode": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraMode>>;
@@ -5020,6 +5024,48 @@ export declare namespace PBAvatarModifierArea {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBAvatarModifierArea;
 }
 
+/**
+ * The AvatarNametag component adds a plate with scene-provided text above an avatar's nametag,
+ * for example to show a rank or a role that the scene assigns to that player.
+ *
+ * Valid only on an avatar-bearing entity:
+ * - the local player: `engine.PlayerEntity`
+ * - another player in the scene: that player's entity
+ * - an NPC: any entity with an AvatarShape
+ * Writes to any other entity are ignored.
+ *
+ * Player entity ids are not stable across disconnects: a write to a stale entity lands on
+ * whoever holds that id next. Resolve the entity from the user id on every write, and remove
+ * the component when the player leaves the scene.
+ *
+ * The plate is local to the client that renders it; it is never relayed to other players.
+ */
+/**
+ * @public
+ */
+export declare interface PBAvatarNametag {
+    /**
+     * The plate text: a single line, for example "Club Owner". Empty draws the plate without text,
+     * and spaces are preserved: a label of spaces widens a text-less plate. For a plate sized
+     * exactly to a word without showing it, set label_color equal to background_color instead.
+     */
+    label: string;
+    /** (default: the client's native nametag text color) */
+    labelColor?: PBColor3 | undefined;
+    /** (default: the client's native nametag background color) */
+    backgroundColor?: PBColor3 | undefined;
+    /** (default: background_color, so the plate carries no visible border) */
+    borderColor?: PBColor3 | undefined;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBAvatarNametag {
+    export function encode(message: PBAvatarNametag, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBAvatarNametag;
+}
+
 /**
  * The AvatarShape component contains the information required to draw and animate avatar, acting as
  * a simplified GLTF container for this specific case.
@@ -8494,7 +8540,7 @@ export declare type ReadOnlyLastWriteWinElementSetComponentDefinition<T> = Omit<
 /**
  * @public
  */
-export declare type ReadonlyPrimitive = number | string | number[] | string[] | boolean | boolean[];
+export declare type ReadonlyPrimitive = number | string | boolean;
 
 /** @public */
 export declare const RealmInfo: LastWriteWinElementSetComponentDefinition<PBRealmInfo>;

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.59.0"
+      "packageVersion": "7.59.1"
     }
   ]
 }

package/etc/playground-assets.api.json

@@ -1,7 +1,7 @@
 {
   "metadata": {
     "toolPackage": "@microsoft/api-extractor",
-    "toolVersion": "7.59.0",
+    "toolVersion": "7.59.1",
     "schemaVersion": 1011,
     "oldestForwardsCompatibleVersion": 1001,
     "tsdocConfig": {
@@ -3146,6 +3146,43 @@
             }
           ]
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@dcl/playground-assets!AvatarNametag:var",
+          "docComment": "/**\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "AvatarNametag: "
+            },
+            {
+              "kind": "Reference",
+              "text": "LastWriteWinElementSetComponentDefinition",
+              "canonicalReference": "@dcl/playground-assets!LastWriteWinElementSetComponentDefinition:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "PBAvatarNametag",
+              "canonicalReference": "@dcl/playground-assets!PBAvatarNametag"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            }
+          ],
+          "fileUrlPath": "../ecs/dist/components/generated/global.gen.d.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "AvatarNametag",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 5
+          }
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@dcl/playground-assets!AvatarShape:var",
@@ -13980,6 +14017,33 @@
               "text": "PBAvatarModifierArea",
               "canonicalReference": "@dcl/playground-assets!PBAvatarModifierArea"
             },
+            {
+              "kind": "Content",
+              "text": ">>;\n    \"core::AvatarNametag\": "
+            },
+            {
+              "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": "PBAvatarNametag",
+              "canonicalReference": "@dcl/playground-assets!PBAvatarNametag"
+            },
             {
               "kind": "Content",
               "text": ">>;\n    \"core::AvatarShape\": "
@@ -15287,7 +15351,7 @@
           "name": "componentDefinitionByName",
           "variableTypeTokenRange": {
             "startIndex": 1,
-            "endIndex": 368
+            "endIndex": 374
           }
         },
         {
@@ -45612,6 +45676,298 @@
             }
           ]
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@dcl/playground-assets!PBAvatarNametag:interface",
+          "docComment": "/**\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface PBAvatarNametag "
+            }
+          ],
+          "fileUrlPath": "../ecs/dist/components/generated/pb/decentraland/sdk/components/avatar_nametag.gen.d.ts",
+          "releaseTag": "Public",
+          "name": "PBAvatarNametag",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@dcl/playground-assets!PBAvatarNametag#backgroundColor:member",
+              "docComment": "/**\n * (default: the client's native nametag background color)\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "backgroundColor?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Color3",
+                  "canonicalReference": "@dcl/playground-assets!Color3"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "backgroundColor",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@dcl/playground-assets!PBAvatarNametag#borderColor:member",
+              "docComment": "/**\n * (default: background_color, so the plate carries no visible border)\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "borderColor?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Color3",
+                  "canonicalReference": "@dcl/playground-assets!Color3"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "borderColor",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@dcl/playground-assets!PBAvatarNametag#label:member",
+              "docComment": "/**\n * The plate text: a single line, for example \"Club Owner\". Empty draws the plate without text, and spaces are preserved: a label of spaces widens a text-less plate. For a plate sized exactly to a word without showing it, set label_color equal to background_color instead.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "label: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "label",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@dcl/playground-assets!PBAvatarNametag#labelColor:member",
+              "docComment": "/**\n * (default: the client's native nametag text color)\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "labelColor?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Color3",
+                  "canonicalReference": "@dcl/playground-assets!Color3"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "labelColor",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Namespace",
+          "canonicalReference": "@dcl/playground-assets!PBAvatarNametag:namespace",
+          "docComment": "/**\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare namespace PBAvatarNametag "
+            }
+          ],
+          "fileUrlPath": "../ecs/dist/components/generated/pb/decentraland/sdk/components/avatar_nametag.gen.d.ts",
+          "releaseTag": "Public",
+          "name": "PBAvatarNametag",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "Function",
+              "canonicalReference": "@dcl/playground-assets!PBAvatarNametag.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": "PBAvatarNametag",
+                  "canonicalReference": "@dcl/playground-assets!PBAvatarNametag: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!PBAvatarNametag.encode:function(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "function encode(message: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PBAvatarNametag",
+                  "canonicalReference": "@dcl/playground-assets!PBAvatarNametag: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!PBAvatarShape:interface",
@@ -80554,7 +80910,7 @@
             },
             {
               "kind": "Content",
-              "text": "number | string | number[] | string[] | boolean | boolean[]"
+              "text": "number | string | boolean"
             },
             {
               "kind": "Content",

package/etc/playground-assets.api.md

@@ -223,6 +223,9 @@ export const enum AvatarModifierType {
     AMT_HIDE_NAMETAGS = 2
 }
 
+// @public (undocumented)
+export const AvatarNametag: LastWriteWinElementSetComponentDefinition<PBAvatarNametag>;
+
 // @public (undocumented)
 export const AvatarShape: LastWriteWinElementSetComponentDefinition<PBAvatarShape>;
 
@@ -721,6 +724,7 @@ export const componentDefinitionByName: {
     "core::AvatarEquippedData": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarEquippedData>>;
     "core::AvatarLocomotionSettings": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarLocomotionSettings>>;
     "core::AvatarModifierArea": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarModifierArea>>;
+    "core::AvatarNametag": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarNametag>>;
     "core::AvatarShape": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarShape>>;
     "core::Billboard": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBBillboard>>;
     "core::CameraMode": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraMode>>;
@@ -2652,6 +2656,22 @@ export namespace PBAvatarModifierArea {
     export function encode(message: PBAvatarModifierArea, writer?: _m0.Writer): _m0.Writer;
 }
 
+// @public (undocumented)
+export interface PBAvatarNametag {
+    backgroundColor?: PBColor3 | undefined;
+    borderColor?: PBColor3 | undefined;
+    label: string;
+    labelColor?: PBColor3 | undefined;
+}
+
+// @public (undocumented)
+export namespace PBAvatarNametag {
+    // (undocumented)
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBAvatarNametag;
+    // (undocumented)
+    export function encode(message: PBAvatarNametag, writer?: _m0.Writer): _m0.Writer;
+}
+
 // @public (undocumented)
 export interface PBAvatarShape {
     bodyShape?: string | undefined;
@@ -4721,7 +4741,7 @@ export type ReadOnlyGrowOnlyValueSetComponentDefinition<T> = Omit<GrowOnlyValueS
 export type ReadOnlyLastWriteWinElementSetComponentDefinition<T> = Omit<LastWriteWinElementSetComponentDefinition<T>, 'create' | 'createOrReplace' | 'deleteFrom' | 'getMutable' | 'getMutableOrNull' | 'getOrCreateMutable'>;
 
 // @public (undocumented)
-export type ReadonlyPrimitive = number | string | number[] | string[] | boolean | boolean[];
+export type ReadonlyPrimitive = number | string | boolean;
 
 // @public (undocumented)
 export const RealmInfo: LastWriteWinElementSetComponentDefinition<PBRealmInfo>;

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dcl/playground-assets",
   "description": "",
-  "version": "7.27.1-33756439818.commit-3a236ab",
+  "version": "7.27.1-34487041135.commit-2a59cb6",
   "author": "Decentraland",
   "dependencies": {
-    "@dcl/js-runtime": "7.27.1-33756439818.commit-3a236ab",
-    "@dcl/sdk": "7.27.1-33756439818.commit-3a236ab"
+    "@dcl/js-runtime": "7.27.1-34487041135.commit-2a59cb6",
+    "@dcl/sdk": "7.27.1-34487041135.commit-2a59cb6"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.33.8"
@@ -32,5 +32,5 @@
   },
   "types": "./dist/index.d.ts",
   "typings": "./dist/index.d.ts",
-  "commit": "3a236ab909c08dc265a66125c7f118402ab3f3c9"
+  "commit": "2a59cb6c6005b4f6b5c2391d6138778e85e1ae65"
 }