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

package/dist/alpha.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/dist/beta.d.ts

@@ -2251,6 +2251,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;
 }
 
 /**
@@ -5108,6 +5115,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/dist/index.bundled.d.ts

@@ -2251,6 +2251,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;
 }
 
 /**
@@ -5108,6 +5115,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;
 }
 
 /**