@needle-tools/engine 3.28.7-beta → 3.28.7-beta.1

package/lib/engine/engine_serialization_core.js

@@ -1,577 +1,577 @@
-import { getParam } from "./engine_utils.js";
-import { AnimationClip, Material, Mesh, Texture } from "three";
-import { isPersistentAsset } from "./extensions/NEEDLE_persistent_assets.js";
-import { debugExtension } from "../engine/engine_default_parameters.js";
-import { LogType, addLog } from "./debug/debug_overlay.js";
-import { isLocalNetwork } from "./engine_networking_utils.js";
-import { $BuiltInTypeFlag } from "./engine_typestore.js";
-const debug = getParam("debugserializer");
-// internal helper class that we can ask for registered type serializers
-// register your own type by deriving from ITypeSerializer and calling helper.register
-class SerializationHelper {
-    register(type, ser) {
-        if (this.typeMap[type] !== undefined) {
-            if (this.typeMap[type] === ser)
-                return;
-            console.warn("Type " + type + " is already registered", ser, this.typeMap[type]);
-        }
-        if (debug)
-            console.log("Register type serializer for " + type, ser);
-        this.typeMap[type] = ser;
-    }
-    typeMap = {};
-    getSerializer(type) {
-        if (!type)
-            return undefined;
-        return this.typeMap[type];
-    }
-    getSerializerForConstructor(type, level = 0) {
-        if (level > 20)
-            return undefined;
-        if (!type || !type.constructor) {
-            if (debug)
-                console.log("invalid type");
-            return undefined;
-        }
-        const name = type.name ?? type.constructor?.name;
-        if (!name) {
-            if (debug)
-                console.log("invalid name", name);
-            return undefined;
-        }
-        const res = this.getSerializer(name);
-        if (res !== undefined) {
-            if (debug)
-                console.log("FOUND " + name, type.name, type.constructor.name, res, this.typeMap);
-            return res;
-        }
-        const parent = Object.getPrototypeOf(type);
-        const hasPrototypeOrConstructor = parent.prototype || parent.constructor;
-        // console.log(name, type, parent);
-        if (!hasPrototypeOrConstructor) {
-            if (debug)
-                console.warn("No prototype for " + name, type, type.name, type.prototype, type.constructor.name);
-            // console.log(type.constructor);
-            // console.dir(type);
-            // console.log(Object.getPrototypeOf(type))
-            // console.dir(parent, Object.getPrototypeOf(type));
-            // if(level <= 0){
-            //     const t = TypeStore.get(type.name);
-            //     console.log(type['__proto__'].name);
-            //     if(t) return this.getSerializerForConstructor(t, level + 1);
-            // }
-            return undefined;
-        }
-        const prot = parent.prototype ?? parent.constructor;
-        if (prot !== type) {
-            const resultFromChildren = this.getSerializerForConstructor(prot, ++level);
-            if (resultFromChildren) {
-                if (debug)
-                    console.log("FOUND " + prot.constructor.name, prot.name, prot, resultFromChildren);
-                // register sub type
-                const typeName = prot.name ?? prot.constructor.name;
-                if (typeName === "Function") {
-                    console.error("Registering Function is not allowed, something went wrong", type, prot, resultFromChildren);
-                }
-                else
-                    this.register(typeName, resultFromChildren);
-            }
-            return resultFromChildren;
-        }
-        return undefined;
-    }
-}
-export const helper = new SerializationHelper();
-/**
- * implement and call super(<type string or array>) with the type names this serializer can handle
- * for example:
- * class ColorSerializer extends TypeSerializer {
- *  constructor() {
- *      super("Color")
- *  }
- * }
-*/
-export class TypeSerializer {
-    // register<T>(c: Constructor<T> | Constructor<T>[])
-    // {
-    //     if (Array.isArray(c)) {
-    //         for (const t of c) {
-    //             helper.register(t.name, this);
-    //         }
-    //     }
-    //     else {
-    //         helper.register(c.name, this);
-    //     }
-    // }
-    constructor(type) {
-        if (Array.isArray(type)) {
-            for (const key of type)
-                helper.register(key.name, this);
-        }
-        else
-            helper.register(type.name, this);
-    }
-}
-/** holds information if a field was undefined before serialization. This gives us info if we might want to warn the user about missing attributes */
-export class ImplementationInformation {
-    isDevMode = isLocalNetwork();
-    cache = {};
-    /** only call when assigning values for the very first time */
-    registerDefinedKeys(typeName, type) {
-        if (!this.isDevMode)
-            return;
-        if (this.cache[typeName] === undefined) {
-            this.cache[typeName] = Object.keys(type);
-        }
-    }
-    getDefinedKey(typeName, key) {
-        if (this.cache[typeName] === undefined)
-            return false;
-        const keys = this.cache[typeName];
-        const res = keys.includes(key);
-        return res;
-    }
-}
-// passed to serializers
-export class SerializationContext {
-    root;
-    gltf;
-    /** the url of the glb that is currently being loaded */
-    gltfId;
-    object;
-    target;
-    nodeId;
-    nodeToObject;
-    objectToNode;
-    context;
-    path;
-    type;
-    /** the serializable attribute for this field (target.path) */
-    serializable;
-    /** holds information if a field was undefined before serialization. This gives us info if we might want to warn the user about missing attributes */
-    implementationInformation;
-    constructor(root) {
-        this.root = root;
-    }
-}
-;
-export function serializeObject(obj, context) {
-    const types = obj.$serializedTypes;
-    if (types === undefined)
-        return null;
-    const res = {};
-    for (const key in types) {
-        const val = obj[key];
-        // if the object bein serialized is some type of object check if we have special handling registered for it
-        if (val !== undefined && val !== null && typeof val === "object") {
-            // get type name
-            // get registered serialization handler
-            const ser = helper.getSerializerForConstructor(val);
-            if (ser) {
-                // serialize data using that handler
-                res[key] = ser.onSerialize(val, context);
-                continue;
-            }
-        }
-        res[key] = val;
-    }
-    // name is the component type
-    res["name"] = obj.constructor.name;
-    // serialize guid
-    if (typeof obj["guid"] === "string")
-        res["guid"] = obj["guid"];
-    return res;
-}
-const buffer = [];
-function collectSerializedTypesInBaseTypes(obj, typeInfoObject) {
-    if (!obj)
-        return typeInfoObject;
-    if (typeof obj.$serializedTypes === "object") {
-        if (!typeInfoObject)
-            typeInfoObject = {};
-        Object.assign(typeInfoObject, obj.$serializedTypes);
-    }
-    const parentTarget = Object.getPrototypeOf(obj);
-    return collectSerializedTypesInBaseTypes(parentTarget, typeInfoObject);
-}
-export function deserializeObject(obj, serializedData, context) {
-    if (!obj)
-        return false;
-    context.target = obj;
-    if (obj.onBeforeDeserialize !== undefined) {
-        const res = obj.onBeforeDeserialize(serializedData, context);
-        if (typeof res === "boolean")
-            return res;
-    }
-    // const typeInfo = obj.$serializedTypes;
-    const typeInfo = collectSerializedTypesInBaseTypes(obj);
-    if (serializedData) {
-        // restore guid (see serializeObject)
-        if (typeof serializedData["guid"] === "string")
-            obj["guid"] = serializedData["guid"];
-        if (typeInfo) {
-            for (const key in typeInfo) {
-                const serializedEntryInfo = typeInfo[key];
-                const data = serializedData[key];
-                if (debug)
-                    console.log(key, data, obj, serializedEntryInfo);
-                if (obj[key] !== undefined && data === undefined) {
-                    // if a field is marked as serialized and has some default value
-                    // but no data was serialized do not override the default value with undefined
-                    continue;
-                }
-                context.type = undefined;
-                context.path = key;
-                context.serializable = serializedEntryInfo;
-                if (obj.onBeforeDeserializeMember !== undefined) {
-                    // callback to the instance, if it returns true assume it's done all the things itself
-                    if (obj.onBeforeDeserializeMember(key, data, context) === true)
-                        continue;
-                }
-                if (serializedEntryInfo === null) {
-                    obj[key] = data;
-                    // if(typeof data === "string"){
-                    //     const serializer = helper.getSerializerForConstructor(String);
-                    //     const res = serializer?.onDeserialize(data, context);
-                    //     if(res !== undefined) obj[key] = res;
-                    // }
-                }
-                else {
-                    if (Array.isArray(serializedEntryInfo)) {
-                        for (let i = 0; i < serializedEntryInfo.length; i++) {
-                            const typeInfoOrConstructor = serializedEntryInfo[i];
-                            const res = tryResolve(typeInfoOrConstructor);
-                            if (res !== undefined || i === serializedEntryInfo.length - 1) {
-                                obj[key] = res;
-                                break;
-                            }
-                        }
-                    }
-                    else {
-                        obj[key] = tryResolve(serializedEntryInfo);
-                    }
-                    buffer.length = 0;
-                }
-                if (obj.onAfterDeserializeMember !== undefined) {
-                    obj.onAfterDeserializeMember(key, data, context);
-                }
-                function tryResolve(typeInfoOrConstructor) {
-                    const typeInformationOrConstructor = typeInfoOrConstructor;
-                    // if the entry does specify an object of type ITypeInformation and has the type field set
-                    const type = typeInformationOrConstructor.type;
-                    if (type) {
-                        return deserializeObjectWithType(data, type, context, undefined, obj[key]);
-                    }
-                    // it can also just contain a constructor
-                    else {
-                        const constructor = typeInfoOrConstructor;
-                        return deserializeObjectWithType(data, constructor, context, undefined, obj[key]);
-                    }
-                }
-            }
-        }
-        // ***
-        // the code below could be used to implictly assign serialized data if they are primitive types
-        // if we decide not to do this we always have to write out all the $serializedTypes
-        // *** 
-        implictlyAssignPrimitiveTypes(obj, serializedData);
-    }
-    checkObjectAssignments(obj, serializedData, context.implementationInformation);
-    if (obj.onAfterDeserialize !== undefined) {
-        obj.onAfterDeserialize(serializedData, context);
-    }
-    context.path = undefined;
-    return true;
-}
-const blockChecks = getParam("noerrors");
-function checkObjectAssignments(obj, serializedData, implementationInformation) {
-    if (blockChecks)
-        return;
-    if (!serializedData)
-        return;
-    if (isLocalNetwork() === false)
-        return;
-    if (!obj)
-        return;
-    // ignore builtin components that we dont want to check
-    if (obj.constructor && obj.constructor[$BuiltInTypeFlag] === true)
-        return;
-    const typeName = obj.constructor?.name;
-    // test if any object reference is missing serializable
-    const ownKeys = Object.getOwnPropertyNames(serializedData);
-    for (const key of ownKeys) {
-        if (key === "sourceId")
-            continue;
-        const value = obj[key];
-        if (value == null)
-            continue;
-        const serialized = serializedData[key];
-        // check if the field is defined in the class
-        if (implementationInformation?.getDefinedKey(typeName, key) === false) {
-            // if the field is defined but the defined key is uppercase we need to show a warning
-            // because all fields are serialized in lowercase
-            const firstCharUppercase = key.charAt(0).toUpperCase() + key.slice(1);
-            if (implementationInformation.getDefinedKey(typeName, firstCharUppercase)) {
-                addLog(LogType.Warn, "<strong>Please rename</strong> \"" + firstCharUppercase + "\" to \"" + key + "\" in " + typeName);
-                console.warn("Please use lowercase for field: \"" + firstCharUppercase + "\" in " + typeName, serialized, obj);
-            }
-            continue;
-        }
-        if (serialized === undefined || serialized === null)
-            continue;
-        if (typeof serialized === "object") {
-            if (value === undefined || !value.isObject3D) {
-                if (typeof serialized["node"] === "number" || typeof serialized["guid"] === "string") {
-                    if (serialized["could_not_resolve"]) {
-                        continue;
-                    }
-                    const hasOtherKeys = value !== undefined && Object.keys(value).length > 1;
-                    if (!hasOtherKeys) {
-                        addLog(LogType.Warn, `<strong>Missing serialization for object reference!</strong>\n\nPlease change to: \n@serializable(Object3D)\n${key}? : Object3D;\n\nin script ${typeName}.ts\n<a href="https://docs.needle.tools/serializable" target="_blank">documentation</a>`);
-                        console.warn(typeName, key, obj[key], obj);
-                        continue;
-                    }
-                }
-            }
-        }
-        if (typeof value === "string") {
-            if (serialized.endsWith(".gltf") || serialized.endsWith(".glb")) {
-                addLog(LogType.Warn, `<strong>Missing serialization for object reference!</strong>\n\nPlease change to: \n@serializable(AssetReference)\n${key}? : AssetReference;\n\nin script ${typeName}.ts\n<a href="https://docs.needle.tools/serializable" target="_blank">documentation</a>`);
-                console.warn(typeName, key, obj[key], obj);
-                continue;
-            }
-        }
-    }
-}
-function implictlyAssignPrimitiveTypes(obj, serializedData) {
-    // implictly assign serialized primitive fields
-    for (const key of Object.keys(serializedData)) {
-        const data = serializedData[key];
-        if (typeof data === "object" && data !== null && data !== undefined) {
-            const member = obj[key];
-            if (!member) {
-                if (debug)
-                    console.log(key, "is undefined on", obj);
-                continue;
-            }
-            for (const key of Object.keys(data)) {
-                const targetMember = member[key];
-                // implictly assign number, string, boolean if they are undefined
-                if (targetMember !== undefined)
-                    continue;
-                // resolve serialized primitive types
-                if (isPrimitiveType(data[key]) && !isPrimitiveType(member)) {
-                    const prop = tryFindPropertyDescriptor(member, key);
-                    if (prop && (prop?.writable === undefined || prop?.writable === false) && (prop.set === undefined)) {
-                        if (debug)
-                            console.warn("Property is not writable \"" + key + "\"", member, prop, data[key], member[key]);
-                        continue;
-                    }
-                    // console.log("ASSIGN", key, member, member[key], targetMember, data[key], prop);
-                    member[key] = data[key];
-                }
-            }
-        }
-    }
-}
-function tryFindPropertyDescriptor(obj, key) {
-    while (obj) {
-        const desc = Object.getOwnPropertyDescriptor(obj, key);
-        if (desc)
-            return desc;
-        obj = Object.getPrototypeOf(obj);
-    }
-    return undefined;
-}
-function isPrimitiveType(val) {
-    switch (typeof val) {
-        case "number":
-        case "string":
-        case "boolean":
-            return true;
-    }
-    return false;
-}
-function deserializeObjectWithType(data, typeOrConstructor, context, typeContext, currentValue) {
-    // e.g. @serializable((data) => { })
-    let typeIsFunction = typeof typeOrConstructor === "function" && (typeOrConstructor.prototype === undefined);
-    let type = typeOrConstructor;
-    if (typeIsFunction) {
-        // it's possible to assign a function to serializable to dynamically say which type we expect
-        // e.g. if you have an array of types and you want the array to be resolved with different class instances
-        try {
-            const resolvedType = typeOrConstructor?.call(typeOrConstructor, currentValue);
-            type = resolvedType;
-            typeIsFunction = false;
-            if (type === null || type === undefined)
-                return;
-        }
-        catch (err) {
-            console.error("Error in callback", err, data);
-        }
-    }
-    context.type = type;
-    // e.g. when @serializable(Texture) and the texture is already resolved via json pointer from gltf
-    // then we dont need to do anything else
-    if (!typeIsFunction && currentValue instanceof type)
-        return currentValue;
-    // try to resolve the serializer for a type only once
-    if (!typeContext) {
-        typeContext = {
-            serializer: helper.getSerializerForConstructor(type)
-        };
-    }
-    // if the value was already resolved via the persistent asset extension dont try to override that again
-    if (currentValue && typeof currentValue === "object" && isPersistentAsset(currentValue)) {
-        // if the persistent asset was already resolved to a concrete instance we dont need to do anything anymore
-        if (currentValue["__concreteInstance"]) {
-            return currentValue["__concreteInstance"];
-        }
-        const serializableInstance = currentValue;
-        if (!serializableInstance.$serializedTypes && type.prototype.$serializedTypes)
-            serializableInstance.$serializedTypes = type.prototype.$serializedTypes;
-        if (serializableInstance.$serializedTypes) {
-            deserializeObject(serializableInstance, data, context);
-        }
-        if (currentValue && type !== undefined) {
-            try {
-                let instance = null;
-                // It's still possible that the type has an explicit serializer
-                // e.g. AnimatorController (or if a user registers a serializer for an arbitrary type and then marks a persistent asset with @serializable)
-                // we have this for @serializable(AnimatorController)
-                if (typeContext.serializer) {
-                    instance = typeContext.serializer.onDeserialize(data, context);
-                }
-                if (!instance) {
-                    // we create a concrete instance for a persistent asset here
-                    // hence we want to have the same instance across all usages of this asset
-                    instance = new type();
-                    if (debugExtension)
-                        console.log("Create concrete instance for persistent asset", currentValue, "instance:", instance);
-                    assign(instance, currentValue);
-                }
-                // save it so if another component references the same persistent asset it will automatically use the concrete instance
-                currentValue["__concreteInstance"] = instance;
-                currentValue = instance;
-            }
-            catch (err) {
-                console.error("Error creating instance or creating values on instance", err, currentValue, type);
-            }
-        }
-        return currentValue;
-    }
-    // if the type is an array resolve each entries recursively
-    if (Array.isArray(data)) {
-        const newArr = [];
-        for (let i = 0; i < data.length; i++) {
-            const obj = data[i];
-            // debugger;
-            const res = deserializeObjectWithType(obj, typeOrConstructor, context, typeContext, obj);
-            newArr.push(res);
-        }
-        // return value;
-        return newArr;
-    }
-    const ser = typeContext?.serializer;
-    if (ser) {
-        return ser.onDeserialize(data, context);
-    }
-    // console.log(type.prototype.get("$serializedTypes"));
-    let instance = undefined;
-    if (data && (data.isMaterial || data.isTexture || data.isObject3D)) {
-        // if the data is already a threejs object we dont want to create a new instance
-        // e.g. if we have a serialized class with a serializable(Material)
-        instance = data;
-    }
-    else {
-        // happens when exporting e.g. Animation component with only clip assigned (clips array is marked as serialized but it might be undefined if no clips are assigned in e.g. blender)
-        if (data === undefined)
-            return undefined;
-        if (data === null) {
-            // Dont implictly create instances for three types that are not assigned
-            // see: https://github.com/needle-tools/needle-tiny/issues/637
-            if (type === Material || type === Texture || type === Mesh || type === AnimationClip) {
-                return null;
-            }
-        }
-        try {
-            // the fallback - this assumes that the type has a constructor that accepts the serialized arguments
-            // made originally with THREE.Vector3 in mind but SHOULD actually not be used/called anymore
-            instance = new type(...setBuffer(data));
-        }
-        catch (err) {
-            console.error("Error creating " + context.path, context.target, err);
-            return;
-        }
-    }
-    // recurse if the deserialized member also implements Iserializable
-    const serializableInstance = instance;
-    if (serializableInstance.$serializedTypes) {
-        deserializeObject(serializableInstance, data, context);
-    }
-    return instance;
-}
-function setBuffer(value) {
-    buffer.length = 0;
-    if (typeof value === "object" && value !== null && value !== undefined) {
-        for (const key of Object.keys(value)) {
-            buffer.push(value[key]);
-        }
-    }
-    return buffer;
-}
-/** set to true while assigning properties during instantiation.
- * Used for validate decorator to not invoke callbacks on components that are currently in the process of being built */
-export const $isAssigningProperties = Symbol("assigned component properties");
-// const developmentMode = getParam("dev")
-/** Object.assign behaviour but check if property is writeable (e.g. getter only properties are skipped) */
-export function assign(target, source, info) {
-    if (source === undefined || source === null)
-        return;
-    if (target === undefined || target === null)
-        return;
-    const onlyDeclared = false;
-    // if (onlyDeclared === true && target.constructor) {
-    //     if (target.constructor[ALL_PROPERTIES_MARKER] === true)
-    //         onlyDeclared = false;
-    // }
-    // if (onlyDeclared !== true && target.constructor) {
-    //     if (target.constructor[STRICT_MARKER] === true)
-    //         onlyDeclared = true;
-    // }
-    // if (onlyDeclared === undefined)
-    //     onlyDeclared = true;
-    // if (developmentMode)
-    //     onlyDeclared = false;
-    target[$isAssigningProperties] = true;
-    const typeName = target.constructor?.name ?? "unknown";
-    // register the keys that the actual type has defined
-    // this will be used later when checking if deserialization has assigned all properties
-    // or if anything could not be deserialized to warn the user
-    info?.registerDefinedKeys(typeName, target);
-    for (const key of Object.keys(source)) {
-        const desc = getPropertyDescriptor(target, key);
-        if (onlyDeclared && desc === undefined)
-            continue;
-        if (typeof desc?.value == "function") {
-            // arrow functions are defined as properties on the object
-            continue;
-        }
-        if (!desc || desc.writable === true) {
-            target[key] = source[key];
-        }
-        else if (desc?.set !== undefined) {
-            target[key] = source[key];
-        }
-    }
-    delete target[$isAssigningProperties];
-}
-// we need to recurse because the property might be defined in a base class
-function getPropertyDescriptor(obj, prop) {
-    let desc;
-    do {
-        desc = Object.getOwnPropertyDescriptor(obj, prop);
-    } while (!desc && (obj = Object.getPrototypeOf(obj)));
-    return desc;
-}
+import { getParam } from "./engine_utils.js";
+import { AnimationClip, Material, Mesh, Texture } from "three";
+import { isPersistentAsset } from "./extensions/NEEDLE_persistent_assets.js";
+import { debugExtension } from "../engine/engine_default_parameters.js";
+import { LogType, addLog } from "./debug/debug_overlay.js";
+import { isLocalNetwork } from "./engine_networking_utils.js";
+import { $BuiltInTypeFlag } from "./engine_typestore.js";
+const debug = getParam("debugserializer");
+// internal helper class that we can ask for registered type serializers
+// register your own type by deriving from ITypeSerializer and calling helper.register
+class SerializationHelper {
+    register(type, ser) {
+        if (this.typeMap[type] !== undefined) {
+            if (this.typeMap[type] === ser)
+                return;
+            console.warn("Type " + type + " is already registered", ser, this.typeMap[type]);
+        }
+        if (debug)
+            console.log("Register type serializer for " + type, ser);
+        this.typeMap[type] = ser;
+    }
+    typeMap = {};
+    getSerializer(type) {
+        if (!type)
+            return undefined;
+        return this.typeMap[type];
+    }
+    getSerializerForConstructor(type, level = 0) {
+        if (level > 20)
+            return undefined;
+        if (!type || !type.constructor) {
+            if (debug)
+                console.log("invalid type");
+            return undefined;
+        }
+        const name = type.name ?? type.constructor?.name;
+        if (!name) {
+            if (debug)
+                console.log("invalid name", name);
+            return undefined;
+        }
+        const res = this.getSerializer(name);
+        if (res !== undefined) {
+            if (debug)
+                console.log("FOUND " + name, type.name, type.constructor.name, res, this.typeMap);
+            return res;
+        }
+        const parent = Object.getPrototypeOf(type);
+        const hasPrototypeOrConstructor = parent.prototype || parent.constructor;
+        // console.log(name, type, parent);
+        if (!hasPrototypeOrConstructor) {
+            if (debug)
+                console.warn("No prototype for " + name, type, type.name, type.prototype, type.constructor.name);
+            // console.log(type.constructor);
+            // console.dir(type);
+            // console.log(Object.getPrototypeOf(type))
+            // console.dir(parent, Object.getPrototypeOf(type));
+            // if(level <= 0){
+            //     const t = TypeStore.get(type.name);
+            //     console.log(type['__proto__'].name);
+            //     if(t) return this.getSerializerForConstructor(t, level + 1);
+            // }
+            return undefined;
+        }
+        const prot = parent.prototype ?? parent.constructor;
+        if (prot !== type) {
+            const resultFromChildren = this.getSerializerForConstructor(prot, ++level);
+            if (resultFromChildren) {
+                if (debug)
+                    console.log("FOUND " + prot.constructor.name, prot.name, prot, resultFromChildren);
+                // register sub type
+                const typeName = prot.name ?? prot.constructor.name;
+                if (typeName === "Function") {
+                    console.error("Registering Function is not allowed, something went wrong", type, prot, resultFromChildren);
+                }
+                else
+                    this.register(typeName, resultFromChildren);
+            }
+            return resultFromChildren;
+        }
+        return undefined;
+    }
+}
+export const helper = new SerializationHelper();
+/**
+ * implement and call super(<type string or array>) with the type names this serializer can handle
+ * for example:
+ * class ColorSerializer extends TypeSerializer {
+ *  constructor() {
+ *      super("Color")
+ *  }
+ * }
+*/
+export class TypeSerializer {
+    // register<T>(c: Constructor<T> | Constructor<T>[])
+    // {
+    //     if (Array.isArray(c)) {
+    //         for (const t of c) {
+    //             helper.register(t.name, this);
+    //         }
+    //     }
+    //     else {
+    //         helper.register(c.name, this);
+    //     }
+    // }
+    constructor(type) {
+        if (Array.isArray(type)) {
+            for (const key of type)
+                helper.register(key.name, this);
+        }
+        else
+            helper.register(type.name, this);
+    }
+}
+/** holds information if a field was undefined before serialization. This gives us info if we might want to warn the user about missing attributes */
+export class ImplementationInformation {
+    isDevMode = isLocalNetwork();
+    cache = {};
+    /** only call when assigning values for the very first time */
+    registerDefinedKeys(typeName, type) {
+        if (!this.isDevMode)
+            return;
+        if (this.cache[typeName] === undefined) {
+            this.cache[typeName] = Object.keys(type);
+        }
+    }
+    getDefinedKey(typeName, key) {
+        if (this.cache[typeName] === undefined)
+            return false;
+        const keys = this.cache[typeName];
+        const res = keys.includes(key);
+        return res;
+    }
+}
+// passed to serializers
+export class SerializationContext {
+    root;
+    gltf;
+    /** the url of the glb that is currently being loaded */
+    gltfId;
+    object;
+    target;
+    nodeId;
+    nodeToObject;
+    objectToNode;
+    context;
+    path;
+    type;
+    /** the serializable attribute for this field (target.path) */
+    serializable;
+    /** holds information if a field was undefined before serialization. This gives us info if we might want to warn the user about missing attributes */
+    implementationInformation;
+    constructor(root) {
+        this.root = root;
+    }
+}
+;
+export function serializeObject(obj, context) {
+    const types = obj.$serializedTypes;
+    if (types === undefined)
+        return null;
+    const res = {};
+    for (const key in types) {
+        const val = obj[key];
+        // if the object bein serialized is some type of object check if we have special handling registered for it
+        if (val !== undefined && val !== null && typeof val === "object") {
+            // get type name
+            // get registered serialization handler
+            const ser = helper.getSerializerForConstructor(val);
+            if (ser) {
+                // serialize data using that handler
+                res[key] = ser.onSerialize(val, context);
+                continue;
+            }
+        }
+        res[key] = val;
+    }
+    // name is the component type
+    res["name"] = obj.constructor.name;
+    // serialize guid
+    if (typeof obj["guid"] === "string")
+        res["guid"] = obj["guid"];
+    return res;
+}
+const buffer = [];
+function collectSerializedTypesInBaseTypes(obj, typeInfoObject) {
+    if (!obj)
+        return typeInfoObject;
+    if (typeof obj.$serializedTypes === "object") {
+        if (!typeInfoObject)
+            typeInfoObject = {};
+        Object.assign(typeInfoObject, obj.$serializedTypes);
+    }
+    const parentTarget = Object.getPrototypeOf(obj);
+    return collectSerializedTypesInBaseTypes(parentTarget, typeInfoObject);
+}
+export function deserializeObject(obj, serializedData, context) {
+    if (!obj)
+        return false;
+    context.target = obj;
+    if (obj.onBeforeDeserialize !== undefined) {
+        const res = obj.onBeforeDeserialize(serializedData, context);
+        if (typeof res === "boolean")
+            return res;
+    }
+    // const typeInfo = obj.$serializedTypes;
+    const typeInfo = collectSerializedTypesInBaseTypes(obj);
+    if (serializedData) {
+        // restore guid (see serializeObject)
+        if (typeof serializedData["guid"] === "string")
+            obj["guid"] = serializedData["guid"];
+        if (typeInfo) {
+            for (const key in typeInfo) {
+                const serializedEntryInfo = typeInfo[key];
+                const data = serializedData[key];
+                if (debug)
+                    console.log(key, data, obj, serializedEntryInfo);
+                if (obj[key] !== undefined && data === undefined) {
+                    // if a field is marked as serialized and has some default value
+                    // but no data was serialized do not override the default value with undefined
+                    continue;
+                }
+                context.type = undefined;
+                context.path = key;
+                context.serializable = serializedEntryInfo;
+                if (obj.onBeforeDeserializeMember !== undefined) {
+                    // callback to the instance, if it returns true assume it's done all the things itself
+                    if (obj.onBeforeDeserializeMember(key, data, context) === true)
+                        continue;
+                }
+                if (serializedEntryInfo === null) {
+                    obj[key] = data;
+                    // if(typeof data === "string"){
+                    //     const serializer = helper.getSerializerForConstructor(String);
+                    //     const res = serializer?.onDeserialize(data, context);
+                    //     if(res !== undefined) obj[key] = res;
+                    // }
+                }
+                else {
+                    if (Array.isArray(serializedEntryInfo)) {
+                        for (let i = 0; i < serializedEntryInfo.length; i++) {
+                            const typeInfoOrConstructor = serializedEntryInfo[i];
+                            const res = tryResolve(typeInfoOrConstructor);
+                            if (res !== undefined || i === serializedEntryInfo.length - 1) {
+                                obj[key] = res;
+                                break;
+                            }
+                        }
+                    }
+                    else {
+                        obj[key] = tryResolve(serializedEntryInfo);
+                    }
+                    buffer.length = 0;
+                }
+                if (obj.onAfterDeserializeMember !== undefined) {
+                    obj.onAfterDeserializeMember(key, data, context);
+                }
+                function tryResolve(typeInfoOrConstructor) {
+                    const typeInformationOrConstructor = typeInfoOrConstructor;
+                    // if the entry does specify an object of type ITypeInformation and has the type field set
+                    const type = typeInformationOrConstructor.type;
+                    if (type) {
+                        return deserializeObjectWithType(data, type, context, undefined, obj[key]);
+                    }
+                    // it can also just contain a constructor
+                    else {
+                        const constructor = typeInfoOrConstructor;
+                        return deserializeObjectWithType(data, constructor, context, undefined, obj[key]);
+                    }
+                }
+            }
+        }
+        // ***
+        // the code below could be used to implictly assign serialized data if they are primitive types
+        // if we decide not to do this we always have to write out all the $serializedTypes
+        // *** 
+        implictlyAssignPrimitiveTypes(obj, serializedData);
+    }
+    checkObjectAssignments(obj, serializedData, context.implementationInformation);
+    if (obj.onAfterDeserialize !== undefined) {
+        obj.onAfterDeserialize(serializedData, context);
+    }
+    context.path = undefined;
+    return true;
+}
+const blockChecks = getParam("noerrors");
+function checkObjectAssignments(obj, serializedData, implementationInformation) {
+    if (blockChecks)
+        return;
+    if (!serializedData)
+        return;
+    if (isLocalNetwork() === false)
+        return;
+    if (!obj)
+        return;
+    // ignore builtin components that we dont want to check
+    if (obj.constructor && obj.constructor[$BuiltInTypeFlag] === true)
+        return;
+    const typeName = obj.constructor?.name;
+    // test if any object reference is missing serializable
+    const ownKeys = Object.getOwnPropertyNames(serializedData);
+    for (const key of ownKeys) {
+        if (key === "sourceId")
+            continue;
+        const value = obj[key];
+        if (value == null)
+            continue;
+        const serialized = serializedData[key];
+        // check if the field is defined in the class
+        if (implementationInformation?.getDefinedKey(typeName, key) === false) {
+            // if the field is defined but the defined key is uppercase we need to show a warning
+            // because all fields are serialized in lowercase
+            const firstCharUppercase = key.charAt(0).toUpperCase() + key.slice(1);
+            if (implementationInformation.getDefinedKey(typeName, firstCharUppercase)) {
+                addLog(LogType.Warn, "<strong>Please rename</strong> \"" + firstCharUppercase + "\" to \"" + key + "\" in " + typeName);
+                console.warn("Please use lowercase for field: \"" + firstCharUppercase + "\" in " + typeName, serialized, obj);
+            }
+            continue;
+        }
+        if (serialized === undefined || serialized === null)
+            continue;
+        if (typeof serialized === "object") {
+            if (value === undefined || !value.isObject3D) {
+                if (typeof serialized["node"] === "number" || typeof serialized["guid"] === "string") {
+                    if (serialized["could_not_resolve"]) {
+                        continue;
+                    }
+                    const hasOtherKeys = value !== undefined && Object.keys(value).length > 1;
+                    if (!hasOtherKeys) {
+                        addLog(LogType.Warn, `<strong>Missing serialization for object reference!</strong>\n\nPlease change to: \n@serializable(Object3D)\n${key}? : Object3D;\n\nin script ${typeName}.ts\n<a href="https://docs.needle.tools/serializable" target="_blank">documentation</a>`);
+                        console.warn(typeName, key, obj[key], obj);
+                        continue;
+                    }
+                }
+            }
+        }
+        if (typeof value === "string") {
+            if (serialized.endsWith(".gltf") || serialized.endsWith(".glb")) {
+                addLog(LogType.Warn, `<strong>Missing serialization for object reference!</strong>\n\nPlease change to: \n@serializable(AssetReference)\n${key}? : AssetReference;\n\nin script ${typeName}.ts\n<a href="https://docs.needle.tools/serializable" target="_blank">documentation</a>`);
+                console.warn(typeName, key, obj[key], obj);
+                continue;
+            }
+        }
+    }
+}
+function implictlyAssignPrimitiveTypes(obj, serializedData) {
+    // implictly assign serialized primitive fields
+    for (const key of Object.keys(serializedData)) {
+        const data = serializedData[key];
+        if (typeof data === "object" && data !== null && data !== undefined) {
+            const member = obj[key];
+            if (!member) {
+                if (debug)
+                    console.log(key, "is undefined on", obj);
+                continue;
+            }
+            for (const key of Object.keys(data)) {
+                const targetMember = member[key];
+                // implictly assign number, string, boolean if they are undefined
+                if (targetMember !== undefined)
+                    continue;
+                // resolve serialized primitive types
+                if (isPrimitiveType(data[key]) && !isPrimitiveType(member)) {
+                    const prop = tryFindPropertyDescriptor(member, key);
+                    if (prop && (prop?.writable === undefined || prop?.writable === false) && (prop.set === undefined)) {
+                        if (debug)
+                            console.warn("Property is not writable \"" + key + "\"", member, prop, data[key], member[key]);
+                        continue;
+                    }
+                    // console.log("ASSIGN", key, member, member[key], targetMember, data[key], prop);
+                    member[key] = data[key];
+                }
+            }
+        }
+    }
+}
+function tryFindPropertyDescriptor(obj, key) {
+    while (obj) {
+        const desc = Object.getOwnPropertyDescriptor(obj, key);
+        if (desc)
+            return desc;
+        obj = Object.getPrototypeOf(obj);
+    }
+    return undefined;
+}
+function isPrimitiveType(val) {
+    switch (typeof val) {
+        case "number":
+        case "string":
+        case "boolean":
+            return true;
+    }
+    return false;
+}
+function deserializeObjectWithType(data, typeOrConstructor, context, typeContext, currentValue) {
+    // e.g. @serializable((data) => { })
+    let typeIsFunction = typeof typeOrConstructor === "function" && (typeOrConstructor.prototype === undefined);
+    let type = typeOrConstructor;
+    if (typeIsFunction) {
+        // it's possible to assign a function to serializable to dynamically say which type we expect
+        // e.g. if you have an array of types and you want the array to be resolved with different class instances
+        try {
+            const resolvedType = typeOrConstructor?.call(typeOrConstructor, currentValue);
+            type = resolvedType;
+            typeIsFunction = false;
+            if (type === null || type === undefined)
+                return;
+        }
+        catch (err) {
+            console.error("Error in callback", err, data);
+        }
+    }
+    context.type = type;
+    // e.g. when @serializable(Texture) and the texture is already resolved via json pointer from gltf
+    // then we dont need to do anything else
+    if (!typeIsFunction && currentValue instanceof type)
+        return currentValue;
+    // try to resolve the serializer for a type only once
+    if (!typeContext) {
+        typeContext = {
+            serializer: helper.getSerializerForConstructor(type)
+        };
+    }
+    // if the value was already resolved via the persistent asset extension dont try to override that again
+    if (currentValue && typeof currentValue === "object" && isPersistentAsset(currentValue)) {
+        // if the persistent asset was already resolved to a concrete instance we dont need to do anything anymore
+        if (currentValue["__concreteInstance"]) {
+            return currentValue["__concreteInstance"];
+        }
+        const serializableInstance = currentValue;
+        if (!serializableInstance.$serializedTypes && type.prototype.$serializedTypes)
+            serializableInstance.$serializedTypes = type.prototype.$serializedTypes;
+        if (serializableInstance.$serializedTypes) {
+            deserializeObject(serializableInstance, data, context);
+        }
+        if (currentValue && type !== undefined) {
+            try {
+                let instance = null;
+                // It's still possible that the type has an explicit serializer
+                // e.g. AnimatorController (or if a user registers a serializer for an arbitrary type and then marks a persistent asset with @serializable)
+                // we have this for @serializable(AnimatorController)
+                if (typeContext.serializer) {
+                    instance = typeContext.serializer.onDeserialize(data, context);
+                }
+                if (!instance) {
+                    // we create a concrete instance for a persistent asset here
+                    // hence we want to have the same instance across all usages of this asset
+                    instance = new type();
+                    if (debugExtension)
+                        console.log("Create concrete instance for persistent asset", currentValue, "instance:", instance);
+                    assign(instance, currentValue);
+                }
+                // save it so if another component references the same persistent asset it will automatically use the concrete instance
+                currentValue["__concreteInstance"] = instance;
+                currentValue = instance;
+            }
+            catch (err) {
+                console.error("Error creating instance or creating values on instance", err, currentValue, type);
+            }
+        }
+        return currentValue;
+    }
+    // if the type is an array resolve each entries recursively
+    if (Array.isArray(data)) {
+        const newArr = [];
+        for (let i = 0; i < data.length; i++) {
+            const obj = data[i];
+            // debugger;
+            const res = deserializeObjectWithType(obj, typeOrConstructor, context, typeContext, obj);
+            newArr.push(res);
+        }
+        // return value;
+        return newArr;
+    }
+    const ser = typeContext?.serializer;
+    if (ser) {
+        return ser.onDeserialize(data, context);
+    }
+    // console.log(type.prototype.get("$serializedTypes"));
+    let instance = undefined;
+    if (data && (data.isMaterial || data.isTexture || data.isObject3D)) {
+        // if the data is already a threejs object we dont want to create a new instance
+        // e.g. if we have a serialized class with a serializable(Material)
+        instance = data;
+    }
+    else {
+        // happens when exporting e.g. Animation component with only clip assigned (clips array is marked as serialized but it might be undefined if no clips are assigned in e.g. blender)
+        if (data === undefined)
+            return undefined;
+        if (data === null) {
+            // Dont implictly create instances for three types that are not assigned
+            // see: https://github.com/needle-tools/needle-tiny/issues/637
+            if (type === Material || type === Texture || type === Mesh || type === AnimationClip) {
+                return null;
+            }
+        }
+        try {
+            // the fallback - this assumes that the type has a constructor that accepts the serialized arguments
+            // made originally with THREE.Vector3 in mind but SHOULD actually not be used/called anymore
+            instance = new type(...setBuffer(data));
+        }
+        catch (err) {
+            console.error("Error creating " + context.path, context.target, err);
+            return;
+        }
+    }
+    // recurse if the deserialized member also implements Iserializable
+    const serializableInstance = instance;
+    if (serializableInstance.$serializedTypes) {
+        deserializeObject(serializableInstance, data, context);
+    }
+    return instance;
+}
+function setBuffer(value) {
+    buffer.length = 0;
+    if (typeof value === "object" && value !== null && value !== undefined) {
+        for (const key of Object.keys(value)) {
+            buffer.push(value[key]);
+        }
+    }
+    return buffer;
+}
+/** set to true while assigning properties during instantiation.
+ * Used for validate decorator to not invoke callbacks on components that are currently in the process of being built */
+export const $isAssigningProperties = Symbol("assigned component properties");
+// const developmentMode = getParam("dev")
+/** Object.assign behaviour but check if property is writeable (e.g. getter only properties are skipped) */
+export function assign(target, source, info) {
+    if (source === undefined || source === null)
+        return;
+    if (target === undefined || target === null)
+        return;
+    const onlyDeclared = false;
+    // if (onlyDeclared === true && target.constructor) {
+    //     if (target.constructor[ALL_PROPERTIES_MARKER] === true)
+    //         onlyDeclared = false;
+    // }
+    // if (onlyDeclared !== true && target.constructor) {
+    //     if (target.constructor[STRICT_MARKER] === true)
+    //         onlyDeclared = true;
+    // }
+    // if (onlyDeclared === undefined)
+    //     onlyDeclared = true;
+    // if (developmentMode)
+    //     onlyDeclared = false;
+    target[$isAssigningProperties] = true;
+    const typeName = target.constructor?.name ?? "unknown";
+    // register the keys that the actual type has defined
+    // this will be used later when checking if deserialization has assigned all properties
+    // or if anything could not be deserialized to warn the user
+    info?.registerDefinedKeys(typeName, target);
+    for (const key of Object.keys(source)) {
+        const desc = getPropertyDescriptor(target, key);
+        if (onlyDeclared && desc === undefined)
+            continue;
+        if (typeof desc?.value == "function") {
+            // arrow functions are defined as properties on the object
+            continue;
+        }
+        if (!desc || desc.writable === true) {
+            target[key] = source[key];
+        }
+        else if (desc?.set !== undefined) {
+            target[key] = source[key];
+        }
+    }
+    delete target[$isAssigningProperties];
+}
+// we need to recurse because the property might be defined in a base class
+function getPropertyDescriptor(obj, prop) {
+    let desc;
+    do {
+        desc = Object.getOwnPropertyDescriptor(obj, prop);
+    } while (!desc && (obj = Object.getPrototypeOf(obj)));
+    return desc;
+}
 //# sourceMappingURL=engine_serialization_core.js.map