@adaas/a-utils 0.3.6 → 0.3.7

package/dist/node/lib/A-Signal/entities/A-SignalVector.entity.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/A-Signal/entities/A-SignalVector.entity.ts"],"names":[],"mappings":"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","file":"A-SignalVector.entity.mjs","sourcesContent":["import { A_Entity, A_Scope, A_TypeGuards, A_TYPES__Component_Constructor, A_TYPES__Entity_Constructor } from \"@adaas/a-concept\";\nimport { A_SignalVector_Serialized, A_SignalVector_Init, A_Signal_TSignalsConstructors, A_SignalTValue, A_SignalTValueArray } from \"../A-Signal.types\";\nimport { A_Signal } from \"./A-Signal.entity\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n\n/**\n * A Signal Vector Entity is a collection of signals structured in a specific way.\n * It allows grouping multiple signals together for batch processing or transmission.\n * \n * Signal Vectors are useful in scenarios where multiple related signals need to be handled together,\n * as a state of the system or a snapshot of various parameters at a given time.\n * \n * @template TSignalsConstructors - Array of signal constructor types (e.g., [typeof MySignal, typeof CustomSignal])\n * @template TSignals - Array of signal instances derived from constructors\n */\n@A_Frame.Entity({\n    namespace: 'A-Utils',\n    name: 'A-SignalVector',\n    description: 'A Signal Vector Entity represents a collection of signals structured in a specific way, allowing for batch processing and transmission of related signals as a unified state representation.'\n})\nexport class A_SignalVector<\n    TSignals extends A_Signal[] = A_Signal[],\n> extends A_Entity<A_SignalVector_Init<TSignals>> {\n\n    /**\n     * The structure of the signal vector, defining the types of signals it contains.\n     * \n     * For example:\n     * [UserSignInSignal, UserStatusSignal, UserActivitySignal]\n     * \n     * [!] if not provided, it will be derived from the signals values.\n     */\n    protected _structure?: A_Signal_TSignalsConstructors<TSignals>;\n    /**\n     * It's actual vector Values of Signals like :\n     * [UserActionSignal, UserMousePositionSignal, ExternalDependencySignal]\n     */\n    protected _signals!: TSignals\n\n    constructor(values: TSignals, structure?: { [K in keyof TSignals]: TSignals[K] extends A_Signal ? A_TYPES__Entity_Constructor<TSignals[K]> : never })\n    constructor(serialized: A_SignalVector_Serialized)\n    constructor(param1: TSignals | A_SignalVector_Serialized, param2?: A_Signal_TSignalsConstructors<TSignals>) {\n\n        if ('aseid' in param1) {\n            // Handle serialized case\n            super(param1 as A_SignalVector_Serialized);\n        } else {\n            // Handle init case  \n            super({\n                structure: param2 ? param2 : (param1 as TSignals).map(s => s.constructor as A_TYPES__Entity_Constructor<TSignals[number]>) as A_Signal_TSignalsConstructors<TSignals>,\n                values: param1 as TSignals\n            } as A_SignalVector_Init<TSignals>);\n        }\n    }\n\n\n    fromNew(newEntity: A_SignalVector_Init<TSignals>): void {\n        super.fromNew(newEntity);\n        this._structure = newEntity.structure;\n        this._signals = newEntity.values;\n    }\n\n    /**\n     * The structure of the signal vector, defining the types of signals it contains.\n     * \n     * For example:\n     * [UserSignInSignal, UserStatusSignal, UserActivitySignal]\n     * \n     */\n    get structure(): A_Signal_TSignalsConstructors<TSignals> {\n        return this._structure || this._signals.map(s => s.constructor as A_TYPES__Entity_Constructor<TSignals[number]>) as A_Signal_TSignalsConstructors<TSignals>;\n    }\n\n\n    get length(): number {\n        return this.structure.length;\n    }\n\n\n    /**\n     * Enables iteration over the signals in the vector.\n     * \n     * @returns \n     */\n    [Symbol.iterator](): Iterator<TSignals[number]> {\n        let pointer = 0;\n        const signals = this.structure.map((signalConstructor) => {\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n            return signalIndex !== -1 ? this._signals[signalIndex] : undefined;\n        }) as TSignals[number][];\n\n        return {\n            next(): IteratorResult<TSignals[number]> {\n                if (pointer < signals.length) {\n                    return {\n                        done: false,\n                        value: signals[pointer++]\n                    };\n                } else {\n                    return {\n                        done: true,\n                        value: undefined as any\n                    };\n                }\n            }\n        };\n    }\n\n    /**\n     * Checks that 2 vectors are identical by types and data \n     * \n     * e.g. [UserSignInSignal, UserStatusSignal] is equal to [UserSignInSignal, UserStatusSignal] with the same data, \n     * but not equal to [UserStatusSignal, UserSignInSignal] or [UserSignInSignal, UserStatusSignal] with different data.\n     * \n     * @param other \n     * @returns \n     */\n    equals(other: A_SignalVector<TSignals>): boolean {\n        if (this.structure.length !== other.structure.length) {\n            return false;\n        }\n\n        for (let i = 0; i < this.structure.length; i++) {\n            const thisSignalConstructor = this.structure[i];\n            const otherSignalConstructor = other.structure[i];\n\n            if (thisSignalConstructor !== otherSignalConstructor) {\n                return false;\n            }\n\n            const thisSignalIndex = this._signals.findIndex(s => s.constructor === thisSignalConstructor);\n            const otherSignalIndex = other._signals.findIndex(s => s.constructor === otherSignalConstructor);\n\n            if (thisSignalIndex !== otherSignalIndex) {\n                return false;\n            }\n\n            const thisSignal = thisSignalIndex !== -1 ? this._signals[thisSignalIndex] : undefined;\n            const otherSignal = otherSignalIndex !== -1 ? other._signals[otherSignalIndex] : undefined;\n\n            if (thisSignal && otherSignal) {\n                if (!thisSignal.compare(otherSignal)) {\n                    return false;\n                }\n            } else if (thisSignal || otherSignal) {\n                return false;\n            }\n        }\n\n        return true;\n    }\n\n\n    /**\n     * Allows to match the current Signal Vector with another Signal Vector by comparing each signal in the structure.\n     * This method returns true if all signals in the vector A match the corresponding signals in vector B, and false otherwise.\n     * \n     * \n     * e.g. [UserSignInSignal, UserStatusSignal] matches [UserStatusSignal, UserSignInSignal] with the same data,\n     * \n     * but not matches [UserSignInSignal, UserStatusSignal] with different data or [UserSignInSignal] or [UserSignInSignal, UserStatusSignal, UserActivitySignal].\n     * \n     * \n     * @param other \n     * @returns \n     */\n    match(other: A_SignalVector<TSignals>): boolean {\n        if (this.length !== other.length) {\n            return false;\n        }\n\n        for (let i = 0; i < this.length; i++) {\n            const thisSignalConstructor = this.structure[i];\n            const otherSignalConstructor = other.structure[i];\n\n            if (thisSignalConstructor !== otherSignalConstructor) {\n                return false;\n            }\n\n            const thisSignalIndex = this._signals.findIndex(s => s.constructor === thisSignalConstructor);\n            const otherSignalIndex = other._signals.findIndex(s => s.constructor === otherSignalConstructor);\n\n            const thisSignal = thisSignalIndex !== -1 ? this._signals[thisSignalIndex] : undefined;\n            const otherSignal = otherSignalIndex !== -1 ? other._signals[otherSignalIndex] : undefined;\n\n            if (thisSignal && otherSignal) {\n                if (!thisSignal.compare(otherSignal)) {\n                    return false;\n                }\n            } else if (thisSignal || otherSignal) {\n                return false;\n            }\n        }\n\n        return true;\n    }\n\n\n    /**\n     * Checks if the current Signal Vector includes all signals from another Signal Vector, regardless of order.\n     * \n     * e.g. [UserSignInSignal, UserStatusSignal] includes [UserStatusSignal] with the same data,\n     * but not includes [UserStatusSignal] with different data or [UserActivitySignal].\n     * \n     * @param other \n     */\n    includes(other: A_SignalVector<TSignals>): boolean {\n        for (const signalConstructor of other.structure) {\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n            if (signalIndex === -1) {\n                return false;\n            }\n        }\n        return true;\n    }\n\n\n    /**\n     * This method should ensure that the current Signal Vector contains all signals from the provided Signal Vector.\n     * \n     * @param signal \n     */\n    contains(signal: A_SignalVector): boolean {\n        for (const signalConstructor of signal.structure) {\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n            if (signalIndex === -1) {\n                return false;\n            }\n        }\n        return true;\n    }\n\n    /**\n     * Checks if the vector contains a signal of the specified type.\n     * \n     * @param signal \n     */\n    has(signal: A_Signal): boolean\n    has(signalConstructor: A_TYPES__Entity_Constructor<A_Signal>): boolean\n    has(param1: A_Signal | A_TYPES__Entity_Constructor<A_Signal>): boolean {\n        let signalConstructor: A_TYPES__Entity_Constructor<A_Signal>;\n        if (A_TypeGuards.isEntityInstance(param1)) {\n            signalConstructor = param1.constructor as A_TYPES__Entity_Constructor<A_Signal>;\n        } else {\n            signalConstructor = param1;\n        }\n        return this.structure.includes(signalConstructor);\n    }\n\n    /**\n     * Retrieves the signal of the specified type from the vector.\n     * \n     * @param signal \n     */\n    get<T extends A_Signal>(signal: T): T | undefined\n    get<T extends A_Signal>(signalConstructor: A_TYPES__Entity_Constructor<T>): T | undefined\n    get<T extends A_Signal>(param1: T | A_TYPES__Entity_Constructor<T>): T | undefined {\n        let signalConstructor: A_TYPES__Entity_Constructor<A_Signal>;\n\n        if (param1 instanceof A_Entity) {\n            signalConstructor = param1.constructor as A_TYPES__Entity_Constructor<A_Signal>;\n        } else {\n            signalConstructor = param1 as A_TYPES__Entity_Constructor<A_Signal>;\n        }\n\n        const index = this._signals.findIndex(s => s.constructor === signalConstructor);\n        if (index === -1) {\n            return undefined;\n        }\n        return this._signals[index] as T;\n    }\n\n\n    /**\n     * Converts to Array of values of signals in the vector\n     * Maintains the order specified in the structure/generic type\n     * \n     * @param structure - Optional structure to override the default ordering\n     * @returns Array of signal instances in the specified order\n     */\n    toVector<\n        T extends Array<A_Signal> = TSignals,\n    >(\n        structure?: A_Signal_TSignalsConstructors<T>\n    ): T {\n        const usedStructure = structure || this.structure;\n\n        return usedStructure.map((signalConstructor) => {\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n            return signalIndex !== -1 ? this._signals[signalIndex] : undefined;\n        }) as T;\n    }\n\n\n    /**\n     * Converts to Array of data of signals in the vector\n     * Maintains the order specified in the structure/generic type\n     * \n     * @param structure - Optional structure to override the default ordering\n     * @returns Array of serialized signal data in the specified order\n     */\n    toDataVector<\n        T extends A_Signal[] = TSignals,\n    >(\n        structure?: A_Signal_TSignalsConstructors<T>\n    ): A_SignalTValueArray<T> {\n\n        const usedStructure = structure || this.structure;\n\n        const results: Array<any> = [];\n\n        for (const signalConstructor of usedStructure) {\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n            let data: any;\n            if (signalIndex === -1) {\n\n                data = (signalConstructor as typeof A_Signal).default()\n\n            } else {\n                const signal = this._signals[signalIndex];\n                data = signal;\n            }\n\n\n            results.push(data?.toJSON().data);\n        }\n\n        return results as A_SignalTValueArray<T>;\n    }\n\n    /**\n     * Converts to Object with signal constructor names as keys and their corresponding data values\n     * Uses the structure ordering to ensure consistent key ordering\n     * \n     * @returns Object with signal constructor names as keys and signal data as values\n     */\n    async toObject<\n        T extends Array<A_Signal> = TSignals,\n    >(\n        structure?: { [K in keyof T]: T[K] extends A_Signal ? A_TYPES__Entity_Constructor<T[K]> : never }\n    ): Promise<{ [key: string]: T[number] extends A_Signal<infer D> ? D | undefined : never }> {\n\n        const usedStructure = structure || this.structure;\n\n        const obj: { [key: string]: T[number] extends A_Signal<infer D> ? D | undefined : never } = {};\n        usedStructure.forEach((signalConstructor) => {\n            const signalName = signalConstructor.name;\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n\n            if (signalIndex !== -1) {\n                const signal = this._signals[signalIndex];\n                obj[signalName] = signal.toJSON().data as any;\n            } else {\n                obj[signalName] = undefined as any;\n            }\n        });\n\n        return obj;\n    }\n\n\n    /**\n     * Serializes the Signal Vector to a JSON-compatible format.\n     * \n     * \n     * @returns \n     */\n    toJSON(): A_SignalVector_Serialized {\n        return {\n            ...super.toJSON(),\n            structure: this.structure.map(s => s.name),\n            values: this._signals.map(s => s.toJSON())\n        };\n    }\n}\n"]}
+{"version":3,"sources":["../../../../../src/lib/A-Signal/entities/A-SignalVector.entity.ts"],"names":[],"mappings":"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","file":"A-SignalVector.entity.mjs","sourcesContent":["import { A_Entity, A_Scope, A_TypeGuards, A_TYPES__Component_Constructor, A_TYPES__Entity_Constructor } from \"@adaas/a-concept\";\nimport { A_SignalVector_Serialized, A_SignalVector_Init, A_Signal_TSignalsConstructors, A_SignalTValue, A_SignalTValueArray } from \"../A-Signal.types\";\nimport { A_Signal } from \"./A-Signal.entity\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n\n/**\n * A Signal Vector Entity is a collection of signals structured in a specific way.\n * It allows grouping multiple signals together for batch processing or transmission.\n * \n * Signal Vectors are useful in scenarios where multiple related signals need to be handled together,\n * as a state of the system or a snapshot of various parameters at a given time.\n * \n * @template TSignalsConstructors - Array of signal constructor types (e.g., [typeof MySignal, typeof CustomSignal])\n * @template TSignals - Array of signal instances derived from constructors\n */\n@A_Frame.Entity({\n    namespace: 'A-Utils',\n    name: 'A-SignalVector',\n    description: 'A Signal Vector Entity represents a collection of signals structured in a specific way, allowing for batch processing and transmission of related signals as a unified state representation.'\n})\nexport class A_SignalVector<\n    TSignals extends A_Signal[] = A_Signal[],\n> extends A_Entity<A_SignalVector_Init<TSignals>> {\n\n    /**\n     * The structure of the signal vector, defining the types of signals it contains.\n     * \n     * For example:\n     * [UserSignInSignal, UserStatusSignal, UserActivitySignal]\n     * \n     * [!] if not provided, it will be derived from the signals values.\n     */\n    protected _structure?: A_Signal_TSignalsConstructors<TSignals>;\n    /**\n     * It's actual vector Values of Signals like :\n     * [UserActionSignal, UserMousePositionSignal, ExternalDependencySignal]\n     */\n    protected _signals!: TSignals\n\n    constructor(values: TSignals, structure?: { [K in keyof TSignals]: TSignals[K] extends A_Signal ? A_TYPES__Entity_Constructor<TSignals[K]> : never })\n    constructor(serialized: A_SignalVector_Serialized)\n    constructor(param1: TSignals | A_SignalVector_Serialized, param2?: A_Signal_TSignalsConstructors<TSignals>) {\n\n        if ('aseid' in param1) {\n            // Handle serialized case\n            super(param1 as A_SignalVector_Serialized);\n        } else {\n            // Handle init case  \n            super({\n                structure: param2 ? param2 : (param1 as TSignals).map(s => s.constructor as A_TYPES__Entity_Constructor<TSignals[number]>) as A_Signal_TSignalsConstructors<TSignals>,\n                values: param1 as TSignals\n            } as A_SignalVector_Init<TSignals>);\n        }\n    }\n\n\n    fromNew(newEntity: A_SignalVector_Init<TSignals>): void {\n        super.fromNew(newEntity);\n        this._structure = newEntity.structure;\n        this._signals = newEntity.values;\n    }\n\n    /**\n     * The structure of the signal vector, defining the types of signals it contains.\n     * \n     * For example:\n     * [UserSignInSignal, UserStatusSignal, UserActivitySignal]\n     * \n     */\n    get structure(): A_Signal_TSignalsConstructors<TSignals> {\n        return this._structure || this._signals.map(s => s.constructor as A_TYPES__Entity_Constructor<TSignals[number]>) as A_Signal_TSignalsConstructors<TSignals>;\n    }\n\n\n    get length(): number {\n        return this.structure.length;\n    }\n\n\n    /**\n     * Enables iteration over the signals in the vector.\n     * \n     * @returns \n     */\n    [Symbol.iterator](): Iterator<TSignals[number]> {\n        let pointer = 0;\n        const signals = this.structure.map((signalConstructor) => {\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n            return signalIndex !== -1 ? this._signals[signalIndex] : undefined;\n        }) as TSignals[number][];\n\n        return {\n            next(): IteratorResult<TSignals[number]> {\n                if (pointer < signals.length) {\n                    return {\n                        done: false,\n                        value: signals[pointer++]\n                    };\n                } else {\n                    return {\n                        done: true,\n                        value: undefined as any\n                    };\n                }\n            }\n        };\n    }\n\n    /**\n     * Checks that 2 vectors are identical by types and data \n     * \n     * e.g. [UserSignInSignal, UserStatusSignal] is equal to [UserSignInSignal, UserStatusSignal] with the same data, \n     * but not equal to [UserStatusSignal, UserSignInSignal] or [UserSignInSignal, UserStatusSignal] with different data.\n     * \n     * @param other \n     * @returns \n     */\n    equals(other: A_SignalVector<TSignals>): boolean {\n        if (this.structure.length !== other.structure.length) {\n            return false;\n        }\n\n        for (let i = 0; i < this.structure.length; i++) {\n            const thisSignalConstructor = this.structure[i];\n            const otherSignalConstructor = other.structure[i];\n\n            if (thisSignalConstructor !== otherSignalConstructor) {\n                return false;\n            }\n\n            const thisSignalIndex = this._signals.findIndex(s => s.constructor === thisSignalConstructor);\n            const otherSignalIndex = other._signals.findIndex(s => s.constructor === otherSignalConstructor);\n\n            if (thisSignalIndex !== otherSignalIndex) {\n                return false;\n            }\n\n            const thisSignal = thisSignalIndex !== -1 ? this._signals[thisSignalIndex] : undefined;\n            const otherSignal = otherSignalIndex !== -1 ? other._signals[otherSignalIndex] : undefined;\n\n            if (thisSignal && otherSignal) {\n                if (!thisSignal.compare(otherSignal)) {\n                    return false;\n                }\n            } else if (thisSignal || otherSignal) {\n                return false;\n            }\n        }\n\n        return true;\n    }\n\n\n    /**\n     * Allows to match the current Signal Vector with another Signal Vector by comparing each signal in the structure.\n     * This method returns true if all signals in the vector A match the corresponding signals in vector B, and false otherwise.\n     * \n     * \n     * e.g. [UserSignInSignal, UserStatusSignal] matches [UserStatusSignal, UserSignInSignal] with the same data,\n     * \n     * but not matches [UserSignInSignal, UserStatusSignal] with different data or [UserSignInSignal] or [UserSignInSignal, UserStatusSignal, UserActivitySignal].\n     * \n     * \n     * @param other \n     * @returns \n     */\n    match(other: A_SignalVector<TSignals>): boolean {\n        if (this.length !== other.length) {\n            return false;\n        }\n\n        for (let i = 0; i < this.length; i++) {\n            const thisSignalConstructor = this.structure[i];\n            const otherSignalConstructor = other.structure[i];\n\n            if (thisSignalConstructor !== otherSignalConstructor) {\n                return false;\n            }\n\n            const thisSignalIndex = this._signals.findIndex(s => s.constructor === thisSignalConstructor);\n            const otherSignalIndex = other._signals.findIndex(s => s.constructor === otherSignalConstructor);\n\n            const thisSignal = thisSignalIndex !== -1 ? this._signals[thisSignalIndex] : undefined;\n            const otherSignal = otherSignalIndex !== -1 ? other._signals[otherSignalIndex] : undefined;\n\n            if (thisSignal && otherSignal) {\n                if (!thisSignal.compare(otherSignal)) {\n                    return false;\n                }\n            } else if (thisSignal || otherSignal) {\n                return false;\n            }\n        }\n\n        return true;\n    }\n\n\n    /**\n     * Checks if the current Signal Vector includes all signals from another Signal Vector, regardless of order.\n     * \n     * e.g. [UserSignInSignal, UserStatusSignal] includes [UserStatusSignal] with the same data,\n     * but not includes [UserStatusSignal] with different data or [UserActivitySignal].\n     * \n     * @param other \n     */\n    includes(other: A_SignalVector<TSignals>): boolean {\n        for (const signalConstructor of other.structure) {\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n            if (signalIndex === -1) {\n                return false;\n            }\n        }\n        return true;\n    }\n\n\n    /**\n     * This method should ensure that the current Signal Vector contains all signals from the provided Signal Vector.\n     * \n     * @param signal \n     */\n    contains(signal: A_SignalVector): boolean {\n        for (const signalConstructor of signal.structure) {\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n            if (signalIndex === -1) {\n                return false;\n            }\n        }\n        return true;\n    }\n\n    /**\n     * Checks if the vector contains a signal of the specified type.\n     * \n     * @param signal \n     */\n    has(signal: A_Signal): boolean\n    has(signalConstructor: A_TYPES__Entity_Constructor<A_Signal>): boolean\n    has(param1: A_Signal | A_TYPES__Entity_Constructor<A_Signal>): boolean {\n        let signalConstructor: A_TYPES__Entity_Constructor<A_Signal>;\n        if (A_TypeGuards.isEntityInstance(param1)) {\n            signalConstructor = param1.constructor as A_TYPES__Entity_Constructor<A_Signal>;\n        } else {\n            signalConstructor = param1;\n        }\n        return this.structure.includes(signalConstructor);\n    }\n\n    /**\n     * Retrieves the signal of the specified type from the vector.\n     * \n     * @param signal \n     */\n    get<T extends A_Signal>(signal: T): T | undefined\n    get<T extends A_Signal>(signalConstructor: A_TYPES__Entity_Constructor<T>): T | undefined\n    get<T extends A_Signal>(param1: T | A_TYPES__Entity_Constructor<T>): T | undefined {\n        let signalConstructor: A_TYPES__Entity_Constructor<A_Signal>;\n\n        if (param1 instanceof A_Entity) {\n            signalConstructor = param1.constructor as A_TYPES__Entity_Constructor<A_Signal>;\n        } else {\n            signalConstructor = param1 as A_TYPES__Entity_Constructor<A_Signal>;\n        }\n\n        const index = this._signals.findIndex(s => s.constructor === signalConstructor);\n        if (index === -1) {\n            return undefined;\n        }\n        return this._signals[index] as T;\n    }\n\n\n    /**\n     * Converts to Array of values of signals in the vector\n     * Maintains the order specified in the structure/generic type\n     * \n     * @param structure - Optional structure to override the default ordering\n     * @returns Array of signal instances in the specified order\n     */\n    toVector<\n        T extends Array<A_Signal> = TSignals,\n    >(\n        structure?: A_Signal_TSignalsConstructors<T>\n    ): T {\n        const usedStructure = structure || this.structure;\n\n        return usedStructure.map((signalConstructor) => {\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n            return signalIndex !== -1 ? this._signals[signalIndex] : undefined;\n        }) as T;\n    }\n\n\n    /**\n     * Converts to Array of data of signals in the vector\n     * Maintains the order specified in the structure/generic type\n     * \n     * @param structure - Optional structure to override the default ordering\n     * @returns Array of serialized signal data in the specified order\n     */\n    toDataVector<\n        T extends A_Signal[] = TSignals,\n    >(\n        structure?: A_Signal_TSignalsConstructors<T>\n    ): A_SignalTValueArray<T> {\n\n        const usedStructure = structure || this.structure;\n\n        const results: Array<any> = [];\n\n        for (const signalConstructor of usedStructure) {\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n            let data: any;\n            if (signalIndex === -1) {\n\n                data = new (signalConstructor as typeof A_Signal)()\n\n            } else {\n                const signal = this._signals[signalIndex];\n                data = signal;\n            }\n\n\n            results.push(data?.toJSON().data);\n        }\n\n        return results as A_SignalTValueArray<T>;\n    }\n\n    /**\n     * Converts to Object with signal constructor names as keys and their corresponding data values\n     * Uses the structure ordering to ensure consistent key ordering\n     * \n     * @returns Object with signal constructor names as keys and signal data as values\n     */\n    async toObject<\n        T extends Array<A_Signal> = TSignals,\n    >(\n        structure?: { [K in keyof T]: T[K] extends A_Signal ? A_TYPES__Entity_Constructor<T[K]> : never }\n    ): Promise<{ [key: string]: T[number] extends A_Signal<infer D> ? D | undefined : never }> {\n\n        const usedStructure = structure || this.structure;\n\n        const obj: { [key: string]: T[number] extends A_Signal<infer D> ? D | undefined : never } = {};\n        usedStructure.forEach((signalConstructor) => {\n            const signalName = signalConstructor.name;\n            const signalIndex = this._signals.findIndex(s => s.constructor === signalConstructor);\n\n            if (signalIndex !== -1) {\n                const signal = this._signals[signalIndex];\n                obj[signalName] = signal.toJSON().data as any;\n            } else {\n                obj[signalName] = undefined as any;\n            }\n        });\n\n        return obj;\n    }\n\n\n    /**\n     * Serializes the Signal Vector to a JSON-compatible format.\n     * \n     * \n     * @returns \n     */\n    toJSON(): A_SignalVector_Serialized {\n        return {\n            ...super.toJSON(),\n            structure: this.structure.map(s => s.name),\n            values: this._signals.map(s => s.toJSON())\n        };\n    }\n}\n"]}

package/dist/node/lib/A-Signal/index.d.mts

@@ -1,4 +1,4 @@
-export { A as A_Signal, a as A_SignalConfig_Init, b as A_SignalTValue, c as A_SignalTValueArray, d as A_SignalVector_Init, e as A_SignalVector_Serialized, f as A_Signal_Init, g as A_Signal_Serialized, h as A_Signal_TSignalsConstructors } from '../../A-Signal.types-C0Ta5Unp.mjs';
+export { A as A_Signal, a as A_SignalConfig_Init, b as A_SignalTValue, c as A_SignalTValueArray, d as A_SignalVector_Init, e as A_SignalVector_Serialized, f as A_Signal_Init, g as A_Signal_Serialized, h as A_Signal_TSignalsConstructors } from '../../A-Signal.types-DxQHmPm6.mjs';
 export { A_SignalVector } from './entities/A-SignalVector.entity.mjs';
 export { A_SignalBus } from './components/A-SignalBus.component.mjs';
 export { A_SignalBusError } from './components/A-SignalBus.error.mjs';

package/dist/node/lib/A-Signal/index.d.ts

@@ -1,4 +1,4 @@
-export { A as A_Signal, a as A_SignalConfig_Init, b as A_SignalTValue, c as A_SignalTValueArray, d as A_SignalVector_Init, e as A_SignalVector_Serialized, f as A_Signal_Init, g as A_Signal_Serialized, h as A_Signal_TSignalsConstructors } from '../../A-Signal.types-C0Ta5Unp.js';
+export { A as A_Signal, a as A_SignalConfig_Init, b as A_SignalTValue, c as A_SignalTValueArray, d as A_SignalVector_Init, e as A_SignalVector_Serialized, f as A_Signal_Init, g as A_Signal_Serialized, h as A_Signal_TSignalsConstructors } from '../../A-Signal.types-DxQHmPm6.js';
 export { A_SignalVector } from './entities/A-SignalVector.entity.js';
 export { A_SignalBus } from './components/A-SignalBus.component.js';
 export { A_SignalBusError } from './components/A-SignalBus.error.js';

package/jest.config.ts

@@ -26,7 +26,9 @@ const config: Config.InitialOptions = {
         '^@adaas/a-utils/a-schedule$': '<rootDir>/src/lib/A-Schedule',
         '^@adaas/a-utils/a-service$': '<rootDir>/src/lib/A-Service',
         '^@adaas/a-utils/a-signal$': '<rootDir>/src/lib/A-Signal',
-        '^@adaas/a-utils/a-state-machine$': '<rootDir>/src/lib/A-StateMachine'
+        '^@adaas/a-utils/a-state-machine$': '<rootDir>/src/lib/A-StateMachine',
+
+        '^@adaas/a-utils/helpers/(.*)$': '<rootDir>/src/helpers/$1',
     }
 };
 export default config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaas/a-utils",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "A-Utils is a set of utilities that are used across the ADAAS ecosystem. This package is designed to be a collection of utilities that are used across the ADAAS ecosystem.",
   "license": "Apache-2.0",
   "author": {
@@ -231,6 +231,22 @@
         "import": "./dist/node/lib/A-StateMachine/index.mjs",
         "require": "./dist/node/lib/A-StateMachine/index.js"
       }
+    },
+    "./helpers": {
+      "browser": {
+        "types": "./dist/browser/helpers/index.d.ts",
+        "import": "./dist/browser/helpers/index.mjs"
+      },
+      "node": {
+        "types": "./dist/node/helpers/index.d.ts",
+        "import": "./dist/node/helpers/index.mjs",
+        "require": "./dist/node/helpers/index.js"
+      },
+      "default": {
+        "types": "./dist/node/helpers/index.d.ts",
+        "import": "./dist/node/helpers/index.mjs",
+        "require": "./dist/node/helpers/index.js"
+      }
     }
   },
   "keywords": [

package/src/helpers/A-Utils.helper.ts

@@ -0,0 +1,186 @@
+import { A_Caller, A_Component, A_Feature, A_Inject } from "@adaas/a-concept";
+import { A_Frame } from "@adaas/a-frame";
+import { A_ExecutionContext } from "@adaas/a-utils/a-execution";
+
+
+
+@A_Frame.Component({
+    namespace: 'A-Utils',
+    name: 'A-UtilsHelper',
+    description: 'Utility helper class providing common functions for A-Utils library, such as hashing and serialization.'
+})
+export class A_UtilsHelper extends A_Component {
+
+    // ─────────────────────────────────────────────────────────────────────────────
+    // ── Hashing ──────────────────────────────────────────────────────────────────
+    // ─────────────────────────────────────────────────────────────────────────────
+
+    /**
+     * Produces a deterministic, collision-resistant hash string for any JS value.
+     * 
+     * Improvements over the legacy `createHash`:
+     *  - **Null-safe** — handles `null` without throwing  
+     *  - **Function-aware serialization** — functions inside objects / arrays are
+     *    serialized via `.toString()` so `{ fn: () => 1 }` ≠ `{}`  
+     *  - **FNV-1a 52-bit** — better avalanche / distribution than DJB2-32,
+     *    and uses the safe JS integer range so the result is always positive  
+     *  - **Hex output** — compact, URL-safe, fixed-width (13 chars)
+     * 
+     * @param value  Any value: string, number, boolean, null, undefined,
+     *               object, array, Map, Set, function, or a mix of these.
+     * @returns      A 13-character lower-hex string (52-bit FNV-1a).
+     */
+    static hash(value?: any): string {
+        const source = A_UtilsHelper.serialize(value);
+        return A_UtilsHelper.fnv1a52(source);
+    }
+
+
+    // ─────────────────────────────────────────────────────────────────────────────
+    // ── Serialization ────────────────────────────────────────────────────────────
+    // ─────────────────────────────────────────────────────────────────────────────
+
+    /**
+     * Converts any JS value into a deterministic string representation
+     * suitable for hashing.
+     * 
+     * Key properties:
+     *  - **Deterministic**: same logical value → same string every time
+     *  - **Injective-ish**: structurally different values produce different
+     *    strings (type tags prevent `"3"` vs `3` collisions)
+     *  - **Recursive**: handles nested objects, arrays, Maps, Sets
+     *  - **Function-aware**: serializes functions via `.toString()`
+     * 
+     * @param value  Anything.
+     * @returns      A deterministic string.
+     */
+    static serialize(value: any): string {
+        // Primitives & null/undefined
+        if (value === null) return '<null>';
+        if (value === undefined) return '<undefined>';
+
+        switch (typeof value) {
+            case 'string':
+                return `s:${value}`;
+            case 'number':
+                return `n:${value}`;
+            case 'boolean':
+                return `b:${value}`;
+            case 'bigint':
+                return `bi:${value}`;
+            case 'symbol':
+                return `sym:${value.toString()}`;
+            case 'function':
+                return `fn:${value.toString()}`;
+        }
+
+        // Map
+        if (value instanceof Map) {
+            const entries = Array.from(value.entries())
+                .map(([k, v]) => `${A_UtilsHelper.serialize(k)}=>${A_UtilsHelper.serialize(v)}`)
+                .sort()
+                .join(',');
+            return `Map{${entries}}`;
+        }
+
+        // Set
+        if (value instanceof Set) {
+            const items = Array.from(value.values())
+                .map(v => A_UtilsHelper.serialize(v))
+                .sort()
+                .join(',');
+            return `Set{${items}}`;
+        }
+
+        // Date
+        if (value instanceof Date) {
+            return `Date:${value.toISOString()}`;
+        }
+
+        // RegExp
+        if (value instanceof RegExp) {
+            return `RegExp:${value.toString()}`;
+        }
+
+        // Array
+        if (Array.isArray(value)) {
+            const items = value.map(v => A_UtilsHelper.serialize(v)).join(',');
+            return `[${items}]`;
+        }
+
+        // toJSON support (e.g. custom entities, ASEID, etc.)
+        if (typeof value.toJSON === 'function') {
+            return `json:${A_UtilsHelper.serialize(value.toJSON())}`;
+        }
+
+        // Plain object — sort keys for determinism, serialize functions too
+        const keys = Object.keys(value).sort();
+        const pairs = keys.map(k => `${k}:${A_UtilsHelper.serialize(value[k])}`).join(',');
+        return `{${pairs}}`;
+    }
+
+
+    // ─────────────────────────────────────────────────────────────────────────────
+    // ── FNV-1a (pure Number, no BigInt) ──────────────────────────────────────────
+    // ─────────────────────────────────────────────────────────────────────────────
+
+    /**
+     * FNV-1a hash using two 32-bit halves to simulate a 52-bit space,
+     * without requiring BigInt.
+     * 
+     * Works identically in:
+     *  - All browsers (including Safari 13, IE11 polyfill targets, React Native)
+     *  - Node.js (any version)
+     *  - Web Workers, Service Workers, Deno, Bun
+     * 
+     * - Better avalanche than DJB2 (each input bit affects many output bits)
+     * - ~52-bit effective space — vastly fewer collisions than 32-bit
+     * - Always produces a **positive** hex string of 13 characters
+     * 
+     * @param input  Pre-serialized string.
+     * @returns      13-character lower-hex string.
+     */
+    private static fnv1a52(input: string): string {
+        // FNV-1a offset basis split into two 32-bit halves
+        let h1 = 0x811c9dc5;  // low 32 bits
+        let h2 = 0x00000842;  // high 20 bits (keeps us in 52-bit range)
+
+        // FNV prime = 0x01000193
+        const PRIME = 0x01000193;
+
+        for (let i = 0; i < input.length; i++) {
+            h1 ^= input.charCodeAt(i);
+
+            // Multiply h1 by prime (32-bit, unsigned)
+            const product = Math.imul(h1, PRIME);
+            h1 = product >>> 0;
+
+            // Carry overflow into h2, keep h2 within 20 bits
+            h2 = ((Math.imul(h2, PRIME) + (product / 0x100000000 >>> 0)) & 0xFFFFF) >>> 0;
+        }
+
+        // Combine: h2 (20 bits) << 32 | h1 (32 bits) → 52-bit number
+        // Since 2^52 fits in Number.MAX_SAFE_INTEGER, this is exact.
+        const combined = h2 * 0x100000000 + h1;
+
+        return combined.toString(16).padStart(13, '0');
+    }
+
+
+
+    // ==============================================================================
+    // =============== Instance methods for used for Injection ======================
+    // ==============================================================================
+    @A_Frame.Method({
+        description: 'Instance method wrapper for the static hash function, allowing it to be injected as a dependency.'
+    })
+    hash(
+        @A_Inject(A_Caller) caller: any,
+        @A_Inject(A_ExecutionContext) context: A_ExecutionContext,
+        @A_Inject(A_Feature) feature: A_Feature
+    ) {
+        const hash = A_UtilsHelper.hash(caller);
+
+        context.set(feature.name, hash);
+    }
+}

package/src/helpers/index.ts

@@ -0,0 +1 @@
+export { A_UtilsHelper } from './A-Utils.helper';

package/src/lib/A-Signal/entities/A-Signal.entity.ts

@@ -1,6 +1,7 @@
-import { A_Entity, A_Scope } from "@adaas/a-concept";
+import { A_Entity } from "@adaas/a-concept";
 import { A_Signal_Init, A_Signal_Serialized } from "../A-Signal.types";
 import { A_Frame } from "@adaas/a-frame";
+import { A_UtilsHelper } from "@adaas/a-utils/helpers";
 
 /**
  * A Signal Entity is an individual signal instance that carries data.
@@ -29,16 +30,6 @@ export class A_Signal<
     // ========================================================================
     // ========================== Static Methods ==============================
     // ========================================================================
-    /**
-     * Allows to define default data for the signal.
-     * 
-     * If no data is provided during initialization, the default data will be used.
-     * 
-     * @returns 
-     */
-    static default(): A_Signal | undefined {
-        return undefined;
-    }
 
     // ========================================================================
     // ========================== Instance Properties ========================
@@ -49,69 +40,6 @@ export class A_Signal<
      */
     data!: _TSignalDataType;
 
-    /**
-      * Generates signal hash uses for comparison
-      * 
-      * @param str 
-      */
-    protected createHash(str?: string): string
-    protected createHash(str?: undefined): string
-    protected createHash(str?: Record<string, any>): string
-    protected createHash(str?: Array<any>): string
-    protected createHash(str?: number): string
-    protected createHash(str?: boolean): string
-    protected createHash(str?: null): string
-    protected createHash(map?: Map<any, any>): string
-    protected createHash(set?: Set<any>): string
-    protected createHash(str?: any): string {
-        let hashSource: string;
-
-        if (str instanceof Map) {
-            hashSource = JSON.stringify(Array.from(str.entries()));
-        } else if (str instanceof Set) {
-            hashSource = JSON.stringify(Array.from(str.values()));
-        } else {
-            switch (typeof str) {
-                case 'string':
-                    hashSource = str;
-                    break;
-                case 'undefined':
-                    hashSource = 'undefined';
-                    break;
-
-                case 'object':
-                    if ('toJSON' in str)
-                        hashSource = JSON.stringify(str.toJSON());
-
-                    else
-                        hashSource = JSON.stringify(str);
-                    break;
-                case 'number':
-                    hashSource = str.toString();
-                    break;
-                case 'boolean':
-                    hashSource = str ? 'true' : 'false';
-                    break;
-                case 'function':
-                    hashSource = str.toString();
-                    break;
-                default:
-                    hashSource = String(str);
-            }
-        }
-
-        let hash = 0, i, chr;
-        for (i = 0; i < hashSource.length; i++) {
-            chr = hashSource.charCodeAt(i);
-            hash = ((hash << 5) - hash) + chr;
-            hash |= 0; // Convert to 32bit integer
-        }
-
-        const hashString = hash.toString();
-
-        return hashString;
-    }
-
     /**
      * This method compares the current signal with another signal instance by deduplication ID
      * this id can be configured during initialization with the "id" property.
@@ -133,14 +61,36 @@ export class A_Signal<
         return true;
     }
 
+    /**
+     * Allows to define default data for the signal.
+     * 
+     * If no data is provided during initialization, the default data will be used.
+     * 
+     * @returns 
+     */
+    fromUndefined(): void {
+        const name = (this.constructor as typeof A_Entity).entity;
+
+        this.data = undefined as unknown as _TSignalDataType;
 
+        const identity = {
+            name: name,
+            data: this.data
+        };
 
-    fromJSON(serializedEntity: A_Signal_Serialized<_TSignalSerializedDataType>): void {
-        super.fromJSON(serializedEntity);
-        this.data = serializedEntity.data as unknown as _TSignalDataType;
-    }
+        const id = A_UtilsHelper.hash(identity);
 
+        this.aseid = this.generateASEID({
+            entity: name,
+            id: id,
+        });
+    }
 
+    /**
+     * Allows to initialize the signal from a new signal entity. This is useful for example when we want to create a new instance of the signal entity with the same data as another instance, but with a different ASEID.
+     * 
+     * @param newEntity 
+     */
     fromNew(newEntity: A_Signal_Init<_TSignalDataType>): void {
         this.data = newEntity.data;
 
@@ -149,7 +99,7 @@ export class A_Signal<
             data: this.data
         };
 
-        const id = this.createHash(identity);
+        const id = A_UtilsHelper.hash(identity);
 
         this.aseid = this.generateASEID({
             entity: newEntity.name,
@@ -157,6 +107,15 @@ export class A_Signal<
         });
     }
 
+    /**
+     * Allows to initialize the signal from a serialized version of the signal. This is useful for example when we receive a signal from the server and we want to create an instance of the signal entity from the received data.
+     * 
+     * @param serializedEntity 
+     */
+    fromJSON(serializedEntity: A_Signal_Serialized<_TSignalSerializedDataType>): void {
+        super.fromJSON(serializedEntity);
+        this.data = serializedEntity.data as unknown as _TSignalDataType;
+    }
 
     toJSON(): A_Signal_Serialized<_TSignalSerializedDataType> {
         return {

package/src/lib/A-Signal/entities/A-SignalVector.entity.ts

@@ -315,7 +315,7 @@ export class A_SignalVector<
             let data: any;
             if (signalIndex === -1) {
 
-                data = (signalConstructor as typeof A_Signal).default()
+                data = new (signalConstructor as typeof A_Signal)()
 
             } else {
                 const signal = this._signals[signalIndex];

package/tests/A-Signal.test.ts

@@ -150,10 +150,14 @@ describe('A-Signal tests', () => {
         class UserIntentionSignal extends A_Signal<{ buttonId: string }> { }
 
         class UserMousePositionSignal extends A_Signal<{ x: number, y: number }> {
-            static default(): A_Signal | undefined {
-                return new UserMousePositionSignal({
-                    data: { x: 0, y: 0 }
-                });
+            fromUndefined(): void {
+                super.fromNew({
+                    name: 'UserMousePositionSignal',
+                    data: {
+                        x: 0,
+                        y: 0
+                    }
+                })
             }
         }
         class UserElementHoverSignal extends A_Signal<{ elementId: string }> { }

package/tsconfig.json

@@ -19,7 +19,10 @@
          "@adaas/a-utils/a-schedule": ["src/lib/A-Schedule"],
          "@adaas/a-utils/a-service": ["src/lib/A-Service"],
          "@adaas/a-utils/a-signal": ["src/lib/A-Signal"],
-         "@adaas/a-utils/a-state-machine": ["src/lib/A-StateMachine"]
+         "@adaas/a-utils/a-state-machine": ["src/lib/A-StateMachine"],
+
+
+         "@adaas/a-utils/helpers": ["src/helpers"]
       },
       "types": [
          "node",

package/tsup.config.ts

@@ -32,6 +32,8 @@ export default defineConfig([
       "a-service": "src/lib/A-Service/index.ts",
       "a-signal": "src/lib/A-Signal/index.ts",
       "a-state-machine": "src/lib/A-StateMachine/index.ts",
+
+      "helpers": "src/helpers/index.ts",
     },
 
     // Output directory for browser bundle