@dcl/playground-assets 7.1.4-4671625513.commit-bfff9b1 → 7.1.4-4672664161.commit-7ba5d40

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

@@ -1,7 +1,7 @@
 {
   "name": "@dcl/sdk",
   "description": "",
-  "version": "7.1.4-4671625513.commit-bfff9b1",
+  "version": "7.1.4-4672664161.commit-7ba5d40",
   "author": "Decentraland",
   "dependencies": {
     "@dcl/ecs": "file:../ecs",
@@ -30,5 +30,5 @@
   },
   "types": "./index.d.ts",
   "typings": "./index.d.ts",
-  "commit": "bfff9b1815c70f7f3a90fa6d8fa5dfd2934f3db1"
+  "commit": "7ba5d4034c725e90e5c8ca8e37275bbb5e20b297"
 }

package/dist/playground-assets.d.ts

@@ -2255,6 +2255,13 @@ export declare interface LastWriteWinElementSetComponentDefinition<T> extends Ba
      * @param entity - Entity to get the component from
      */
     getMutableOrNull(entity: Entity): T | null;
+    /**
+     * Get the mutable component of the entity. If the entity doesn't have the component, it's created.
+     * - Internal comment: This method adds the &lt;entity,component&gt; to the list to be reviewed next frame
+     * @param entity - Entity to get the component from
+     * @param val - The initial value if it doesn't exist
+     */
+    getOrCreateMutable(entity: Entity, initialValue?: T): T;
 }
 
 /**
@@ -5112,6 +5119,23 @@ export declare namespace Schemas {
      * @returns a ISchema or fail for unsupported json-schema
      */
     const fromJson: (json: JsonSchemaExtended) => ISchema<unknown>;
+    /**
+     * @public
+     *
+     * Traverses and mutates values in a JSON schema-based structure, applying the given mutation function to each value.
+     * The function is designed to work with nested maps and arrays, recursively processing each element.
+     *
+     * @param jsonSchema - The JSON schema object that describes the structure of the value.
+     *                   It must have a serializationType of 'map', 'array', or other custom types like 'entity'.
+     * @param value - The value to be mutated, which should conform to the provided JSON schema.
+     * @param mutateFn - A function that takes a value and its corresponding valueType (JsonSchemaExtended) as arguments
+     *                   and returns a tuple [boolean, any]. The boolean indicates whether the mutation should be applied,
+     *                   and the second element is the mutated value.
+     */
+    const mutateNestedValues: (jsonSchema: JsonSchemaExtended, value: unknown, mutateFn: (value: unknown, valueType: JsonSchemaExtended) => {
+        changed: boolean;
+        value?: any;
+    }) => void;
 }
 
 /**

package/etc/playground-assets.api.json

@@ -19349,6 +19349,68 @@
               ],
               "name": "getMutableOrNull"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@dcl/playground-assets!LastWriteWinElementSetComponentDefinition#getOrCreateMutable:member(1)",
+              "docComment": "/**\n * Get the mutable component of the entity. If the entity doesn't have the component, it's created. - Internal comment: This method adds the <entity,component> to the list to be reviewed next frame\n *\n * @param entity - Entity to get the component from\n *\n * @param val - The initial value if it doesn't exist\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getOrCreateMutable(entity: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Entity",
+                  "canonicalReference": "@dcl/playground-assets!Entity:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", initialValue?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "T"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "T"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "entity",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "initialValue",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "getOrCreateMutable"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@dcl/playground-assets!LastWriteWinElementSetComponentDefinition#getOrNull:member(1)",
@@ -44810,6 +44872,46 @@
                 "endIndex": 12
               }
             },
+            {
+              "kind": "Variable",
+              "canonicalReference": "@dcl/playground-assets!Schemas.mutateNestedValues:var",
+              "docComment": "/**\n * Traverses and mutates values in a JSON schema-based structure, applying the given mutation function to each value. The function is designed to work with nested maps and arrays, recursively processing each element.\n *\n * @param jsonSchema - The JSON schema object that describes the structure of the value. It must have a serializationType of 'map', 'array', or other custom types like 'entity'.\n *\n * @param value - The value to be mutated, which should conform to the provided JSON schema.\n *\n * @param mutateFn - A function that takes a value and its corresponding valueType (JsonSchemaExtended) as arguments and returns a tuple [boolean, any]. The boolean indicates whether the mutation should be applied, and the second element is the mutated value.\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "mutateNestedValues: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(jsonSchema: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "JsonSchemaExtended",
+                  "canonicalReference": "@dcl/playground-assets!JsonSchemaExtended:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", value: unknown, mutateFn: (value: unknown, valueType: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "JsonSchemaExtended",
+                  "canonicalReference": "@dcl/playground-assets!JsonSchemaExtended:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ") => {\n        changed: boolean;\n        value?: any;\n    }) => void"
+                }
+              ],
+              "isReadonly": true,
+              "releaseTag": "Public",
+              "name": "mutateNestedValues",
+              "variableTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 6
+              }
+            },
             {
               "kind": "Variable",
               "canonicalReference": "@dcl/playground-assets!Schemas.Number:var",

package/etc/playground-assets.api.md

@@ -1284,6 +1284,7 @@ export interface LastWriteWinElementSetComponentDefinition<T> extends BaseCompon
     get(entity: Entity): DeepReadonly<T>;
     getMutable(entity: Entity): T;
     getMutableOrNull(entity: Entity): T | null;
+    getOrCreateMutable(entity: Entity, initialValue?: T): T;
     getOrNull(entity: Entity): DeepReadonly<T> | null;
 }
 
@@ -2607,6 +2608,10 @@ export namespace Schemas {
     Optional: <T>(spec: ISchema<T>) => ISchema<T | undefined>;
     const // Warning: (tsdoc-param-tag-missing-hyphen) The @param block should be followed by a parameter name and then a hyphen
     fromJson: (json: JsonSchemaExtended) => ISchema<unknown>;
+    const mutateNestedValues: (jsonSchema: JsonSchemaExtended, value: unknown, mutateFn: (value: unknown, valueType: JsonSchemaExtended) => {
+        changed: boolean;
+        value?: any;
+    }) => void;
 }
 
 // @public (undocumented)

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dcl/playground-assets",
   "description": "",
-  "version": "7.1.4-4671625513.commit-bfff9b1",
+  "version": "7.1.4-4672664161.commit-7ba5d40",
   "author": "Decentraland",
   "dependencies": {
-    "@dcl/js-runtime": "7.1.4-4671625513.commit-bfff9b1",
-    "@dcl/sdk": "7.1.4-4671625513.commit-bfff9b1"
+    "@dcl/js-runtime": "7.1.4-4672664161.commit-7ba5d40",
+    "@dcl/sdk": "7.1.4-4672664161.commit-7ba5d40"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.33.8"
@@ -28,5 +28,5 @@
   },
   "types": "./dist/index.d.ts",
   "typings": "./dist/index.d.ts",
-  "commit": "bfff9b1815c70f7f3a90fa6d8fa5dfd2934f3db1"
+  "commit": "7ba5d4034c725e90e5c8ca8e37275bbb5e20b297"
 }