@adaas/a-utils 0.2.8 → 0.3.1

package/dist/node/lib/A-Signal/context/A-SignalState.context.d.ts

@@ -0,0 +1,111 @@
+import { A_Fragment, A_TYPES__Component_Constructor } from '@adaas/a-concept';
+import { A as A_Signal } from '../../../A-Signal.types-P5VKMKMs.js';
+import { A_SignalVector } from '../entities/A-SignalVector.entity.js';
+
+/**
+ * A_SignalState manages the latest state of all signals within a given scope.
+ *
+ * This class maintains a mapping between signal constructors and their most recently emitted values,
+ * providing a centralized state store for signal management within an application context.
+ *
+ * @template TSignalData - Union type of all possible signal data types that can be stored (must extend Record<string, any>)
+ *
+ * The generic ensures type safety by maintaining correspondence between:
+ * - Signal constructor types and their data types
+ * - Signal instances and their emitted value types
+ * - Vector structure and the data it contains
+ */
+declare class A_SignalState<TSignalData extends Record<string, any> = Record<string, any>> extends A_Fragment {
+    /**
+     * Internal map storing the relationship between signal constructors and their latest values
+     * Key: Signal constructor function
+     * Value: Latest emitted data from that signal type
+     */
+    protected _state: Map<A_TYPES__Component_Constructor<A_Signal>, A_Signal>;
+    /**
+     * Previous state map to track changes between signal emissions
+     * Key: Signal constructor function
+     * Value: Previous emitted data from that signal type
+     */
+    protected _prevState: Map<A_TYPES__Component_Constructor<A_Signal>, A_Signal>;
+    /**
+     * Optional structure defining the ordered list of signal constructors
+     * Used for vector operations and initialization
+     */
+    protected _structure: Array<A_TYPES__Component_Constructor<A_Signal>>;
+    /**
+     * Gets the ordered structure of signal constructors
+     * @returns Array of signal constructors in their defined order
+     */
+    get structure(): Array<A_TYPES__Component_Constructor<A_Signal>>;
+    /**
+     * Creates a new A_SignalState instance
+     *
+     * @param structure - Optional array defining the ordered structure of signal constructors
+     *                   This structure is used for vector operations and determines the order
+     *                   in which signals are processed and serialized
+     */
+    constructor(structure: A_TYPES__Component_Constructor<A_Signal>[]);
+    /**
+     * Sets the latest value for a specific signal type
+     *
+     * @param signal - The signal constructor to associate the value with
+     * @param value - The data value emitted by the signal
+     */
+    set(signal: A_Signal, value: A_Signal): void;
+    set(signal: A_Signal): void;
+    set(signal: A_TYPES__Component_Constructor<A_Signal>, value: A_Signal): void;
+    /**
+     * Retrieves the latest value for a specific signal type
+     *
+     * @param signal - The signal constructor to get the value for
+     * @returns The latest data value or undefined if no value has been set
+     */
+    get(signal: A_Signal): A_Signal | undefined;
+    get(signal: A_TYPES__Component_Constructor<A_Signal>): A_Signal | undefined;
+    /**
+     * Retrieves the previous value for a specific signal type
+     *
+     * @param signal
+     */
+    getPrev(signal: A_Signal): A_Signal | undefined;
+    getPrev(signal: A_TYPES__Component_Constructor<A_Signal>): A_Signal | undefined;
+    /**
+     * Checks if a signal type has been registered in the state
+     *
+     * @param signal - The signal constructor to check for
+     * @returns True if the signal type exists in the state map
+     */
+    has(signal: A_Signal): boolean;
+    has(signal: A_TYPES__Component_Constructor<A_Signal>): boolean;
+    /**
+     * Removes a signal type and its associated value from the state
+     *
+     * @param signal - The signal constructor to remove
+     * @returns True if the signal was successfully deleted, false if it didn't exist
+     */
+    delete(signal: A_Signal): boolean;
+    delete(signal: A_TYPES__Component_Constructor<A_Signal>): boolean;
+    /**
+     * Converts the current state to a vector (ordered array) format
+     *
+     * The order is determined by the structure array provided during construction.
+     * Each position in the vector corresponds to a specific signal type's latest value.
+     *
+     * @returns Array of signal values in the order defined by the structure
+     * @throws Error if structure is not defined or if any signal value is undefined
+     */
+    toVector(): A_SignalVector;
+    /**
+     * Converts the current state to an object with signal constructor names as keys
+     *
+     * This provides a more readable representation of the state where each signal
+     * type is identified by its constructor name.
+     *
+     * @returns Object mapping signal constructor names to their latest values
+     * @throws Error if any signal value is undefined
+     */
+    toObject(): Record<string, A_Signal>;
+}
+
+export { A_SignalState };

package/dist/node/lib/A-Signal/context/A-SignalState.context.js

@@ -0,0 +1,114 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var ASignal_entity = require('../entities/A-Signal.entity');
+var ASignalVector_entity = require('../entities/A-SignalVector.entity');
+var aFrame = require('@adaas/a-frame');
+
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(result)) || result;
+  return result;
+};
+exports.A_SignalState = class A_SignalState extends aConcept.A_Fragment {
+  /**
+   * Creates a new A_SignalState instance
+   * 
+   * @param structure - Optional array defining the ordered structure of signal constructors
+   *                   This structure is used for vector operations and determines the order
+   *                   in which signals are processed and serialized
+   */
+  constructor(structure) {
+    super({ name: "A_SignalState" });
+    /**
+     * Internal map storing the relationship between signal constructors and their latest values
+     * Key: Signal constructor function
+     * Value: Latest emitted data from that signal type
+     */
+    this._state = /* @__PURE__ */ new Map();
+    /**
+     * Previous state map to track changes between signal emissions
+     * Key: Signal constructor function
+     * Value: Previous emitted data from that signal type
+     */
+    this._prevState = /* @__PURE__ */ new Map();
+    this._structure = structure;
+  }
+  /**
+   * Gets the ordered structure of signal constructors
+   * @returns Array of signal constructors in their defined order
+   */
+  get structure() {
+    return this._structure || [];
+  }
+  set(param1, param2) {
+    const signal = param1 instanceof ASignal_entity.A_Signal ? param1.constructor : param1;
+    const value = param1 instanceof ASignal_entity.A_Signal ? param1 : param2;
+    this._prevState.set(signal, this._state.get(signal));
+    this._state.set(signal, value);
+  }
+  get(param) {
+    const signal = param instanceof ASignal_entity.A_Signal ? param.constructor : param;
+    return this._state.get(signal);
+  }
+  getPrev(param) {
+    const signal = param instanceof ASignal_entity.A_Signal ? param.constructor : param;
+    return this._prevState.get(signal);
+  }
+  has(param) {
+    const signal = param instanceof ASignal_entity.A_Signal ? param.constructor : param;
+    return this.structure.includes(signal);
+  }
+  delete(param) {
+    const signal = param instanceof ASignal_entity.A_Signal ? param.constructor : param;
+    return this._state.delete(signal);
+  }
+  /**
+   * Converts the current state to a vector (ordered array) format
+   * 
+   * The order is determined by the structure array provided during construction.
+   * Each position in the vector corresponds to a specific signal type's latest value.
+   * 
+   * @returns Array of signal values in the order defined by the structure
+   * @throws Error if structure is not defined or if any signal value is undefined
+   */
+  toVector() {
+    const vector = [];
+    this._state.forEach((value, key) => {
+      vector.push(value);
+    });
+    return new ASignalVector_entity.A_SignalVector(vector, this.structure);
+  }
+  /**
+   * Converts the current state to an object with signal constructor names as keys
+   * 
+   * This provides a more readable representation of the state where each signal
+   * type is identified by its constructor name.
+   * 
+   * @returns Object mapping signal constructor names to their latest values
+   * @throws Error if any signal value is undefined
+   */
+  toObject() {
+    const obj = {};
+    this.structure.forEach((signalConstructor) => {
+      const value = this._state.get(signalConstructor);
+      if (value === void 0) {
+        throw new Error(`Signal ${signalConstructor.name} has no value in state`);
+      }
+      obj[signalConstructor.name] = value;
+    });
+    return obj;
+  }
+};
+exports.A_SignalState = __decorateClass([
+  aFrame.A_Frame.Fragment({
+    namespace: "A-Utils",
+    name: "A-SignalState",
+    description: "Manages the latest state of all signals within a given scope, maintaining a mapping between signal constructors and their most recently emitted values."
+  })
+], exports.A_SignalState);
+//# sourceMappingURL=A-SignalState.context.js.map
+//# sourceMappingURL=A-SignalState.context.js.map

package/dist/node/lib/A-Signal/context/A-SignalState.context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/lib/A-Signal/context/A-SignalState.context.ts"],"names":["A_SignalState","A_Fragment","A_Signal","A_SignalVector","A_Frame"],"mappings":";;;;;;;;;;;;;;;AAuBaA,qBAAA,GAAN,4BAEGC,mBAAA,CAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsCjB,YACI,SAAA,EACF;AACE,IAAA,KAAA,CAAM,EAAE,IAAA,EAAM,eAAA,EAAiB,CAAA;AAlCnC;AAAA;AAAA;AAAA;AAAA;AAAA,IAAA,IAAA,CAAU,MAAA,uBAAsE,GAAA,EAAI;AAOpF;AAAA;AAAA;AAAA;AAAA;AAAA,IAAA,IAAA,CAAU,UAAA,uBAA0E,GAAA,EAAI;AA6BpF,IAAA,IAAA,CAAK,UAAA,GAAa,SAAA;AAAA,EAKtB;AAAA;AAAA;AAAA;AAAA;AAAA,EArBA,IAAI,SAAA,GAA6D;AAC7D,IAAA,OAAO,IAAA,CAAK,cAAc,EAAC;AAAA,EAC/B;AAAA,EAuCA,GAAA,CACI,QACA,MAAA,EACI;AACJ,IAAA,MAAM,MAAA,GAAS,MAAA,YAAkBC,uBAAA,GAAW,MAAA,CAAO,WAAA,GAA0D,MAAA;AAC7G,IAAA,MAAM,KAAA,GAAQ,MAAA,YAAkBA,uBAAA,GAAW,MAAA,GAAS,MAAA;AAEpD,IAAA,IAAA,CAAK,WAAW,GAAA,CAAI,MAAA,EAAQ,KAAK,MAAA,CAAO,GAAA,CAAI,MAAM,CAAE,CAAA;AACpD,IAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,MAAA,EAAQ,KAAK,CAAA;AAAA,EACjC;AAAA,EAcA,IACI,KAAA,EACoB;AACpB,IAAA,MAAM,MAAA,GAAS,KAAA,YAAiBA,uBAAA,GAAW,KAAA,CAAM,WAAA,GAA0D,KAAA;AAC3G,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,MAAM,CAAA;AAAA,EACjC;AAAA,EAaA,QACI,KAAA,EACoB;AACpB,IAAA,MAAM,MAAA,GAAS,KAAA,YAAiBA,uBAAA,GAAW,KAAA,CAAM,WAAA,GAA0D,KAAA;AAC3G,IAAA,OAAO,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,MAAM,CAAA;AAAA,EACrC;AAAA,EAcA,IACI,KAAA,EACO;AACP,IAAA,MAAM,MAAA,GAAS,KAAA,YAAiBA,uBAAA,GAAW,KAAA,CAAM,WAAA,GAA0D,KAAA;AAE3G,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,QAAA,CAAS,MAAM,CAAA;AAAA,EACzC;AAAA,EAcA,OACI,KAAA,EACO;AACP,IAAA,MAAM,MAAA,GAAS,KAAA,YAAiBA,uBAAA,GAAW,KAAA,CAAM,WAAA,GAA0D,KAAA;AAC3G,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,QAAA,GAA2B;AACvB,IAAA,MAAM,SAA0B,EAAC;AAEjC,IAAA,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,CAAC,KAAA,EAAO,GAAA,KAAQ;AAChC,MAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,IACrB,CAAC,CAAA;AAED,IAAA,OAAO,IAAIC,mCAAA,CAAe,MAAA,EAAQ,IAAA,CAAK,SAAS,CAAA;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,QAAA,GAAqC;AACjC,IAAA,MAAM,MAAgC,EAAC;AAEvC,IAAA,IAAA,CAAK,SAAA,CAAU,OAAA,CAAQ,CAAC,iBAAA,KAAsB;AAC1C,MAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,iBAAiB,CAAA;AAC/C,MAAA,IAAI,UAAU,MAAA,EAAW;AACrB,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,OAAA,EAAU,iBAAA,CAAkB,IAAI,CAAA,sBAAA,CAAwB,CAAA;AAAA,MAC5E;AACA,MAAA,GAAA,CAAI,iBAAA,CAAkB,IAAI,CAAA,GAAI,KAAA;AAAA,IAClC,CAAC,CAAA;AAED,IAAA,OAAO,GAAA;AAAA,EACX;AAEJ;AAxMaH,qBAAA,GAAN,eAAA,CAAA;AAAA,EALNI,eAAQ,QAAA,CAAS;AAAA,IACd,SAAA,EAAW,SAAA;AAAA,IACX,IAAA,EAAM,eAAA;AAAA,IACN,WAAA,EAAa;AAAA,GAChB;AAAA,CAAA,EACYJ,qBAAA,CAAA","file":"A-SignalState.context.js","sourcesContent":["import { A_Context, A_Fragment, A_TYPES__Component_Constructor } from \"@adaas/a-concept\";\nimport { A_Signal } from \"../entities/A-Signal.entity\";\nimport { A_SignalVector } from \"../entities/A-SignalVector.entity\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n/**\n * A_SignalState manages the latest state of all signals within a given scope.\n * \n * This class maintains a mapping between signal constructors and their most recently emitted values,\n * providing a centralized state store for signal management within an application context.\n * \n * @template TSignalData - Union type of all possible signal data types that can be stored (must extend Record<string, any>)\n * \n * The generic ensures type safety by maintaining correspondence between:\n * - Signal constructor types and their data types\n * - Signal instances and their emitted value types\n * - Vector structure and the data it contains\n */\n@A_Frame.Fragment({\n    namespace: 'A-Utils',\n    name: 'A-SignalState',\n    description: 'Manages the latest state of all signals within a given scope, maintaining a mapping between signal constructors and their most recently emitted values.'\n})\nexport class A_SignalState<\n    TSignalData extends Record<string, any> = Record<string, any>\n> extends A_Fragment {\n\n    /**\n     * Internal map storing the relationship between signal constructors and their latest values\n     * Key: Signal constructor function\n     * Value: Latest emitted data from that signal type\n     */\n    protected _state: Map<A_TYPES__Component_Constructor<A_Signal>, A_Signal> = new Map();\n\n    /**\n     * Previous state map to track changes between signal emissions\n     * Key: Signal constructor function\n     * Value: Previous emitted data from that signal type\n     */\n    protected _prevState: Map<A_TYPES__Component_Constructor<A_Signal>, A_Signal> = new Map();\n\n    /**\n     * Optional structure defining the ordered list of signal constructors\n     * Used for vector operations and initialization\n     */\n    protected _structure: Array<A_TYPES__Component_Constructor<A_Signal>>;\n\n\n    /**\n     * Gets the ordered structure of signal constructors\n     * @returns Array of signal constructors in their defined order\n     */\n    get structure(): Array<A_TYPES__Component_Constructor<A_Signal>> {\n        return this._structure || [];\n    }\n\n    /**\n     * Creates a new A_SignalState instance\n     * \n     * @param structure - Optional array defining the ordered structure of signal constructors\n     *                   This structure is used for vector operations and determines the order\n     *                   in which signals are processed and serialized\n     */\n    constructor(\n        structure: A_TYPES__Component_Constructor<A_Signal>[]\n    ) {\n        super({ name: \"A_SignalState\" });\n\n        this._structure = structure;\n\n        // Initialize the state map with undefined values for each signal in the structure\n        // This ensures all expected signals have entries in the state map from the start\n      \n    }\n\n\n    /**\n     * Sets the latest value for a specific signal type\n     * \n     * @param signal - The signal constructor to associate the value with\n     * @param value - The data value emitted by the signal\n     */\n    set(\n        signal: A_Signal,\n        value: A_Signal\n    ): void\n    set(\n        signal: A_Signal\n    ): void\n    set(\n        signal: A_TYPES__Component_Constructor<A_Signal>,\n        value: A_Signal\n    ): void\n    set(\n        param1: A_TYPES__Component_Constructor<A_Signal> | A_Signal,\n        param2?: A_Signal\n    ): void {\n        const signal = param1 instanceof A_Signal ? param1.constructor as A_TYPES__Component_Constructor<A_Signal> : param1;\n        const value = param1 instanceof A_Signal ? param1 : param2!;\n\n        this._prevState.set(signal, this._state.get(signal)!);\n        this._state.set(signal, value);\n    }\n\n    /**\n     * Retrieves the latest value for a specific signal type\n     * \n     * @param signal - The signal constructor to get the value for\n     * @returns The latest data value or undefined if no value has been set\n     */\n    get(\n        signal: A_Signal\n    ): A_Signal | undefined\n    get(\n        signal: A_TYPES__Component_Constructor<A_Signal>\n    ): A_Signal | undefined\n    get(\n        param: A_TYPES__Component_Constructor<A_Signal> | A_Signal\n    ): A_Signal | undefined {\n        const signal = param instanceof A_Signal ? param.constructor as A_TYPES__Component_Constructor<A_Signal> : param;\n        return this._state.get(signal);\n    }\n\n    /**\n     * Retrieves the previous value for a specific signal type\n     * \n     * @param signal \n     */\n    getPrev(\n        signal: A_Signal\n    ): A_Signal | undefined\n    getPrev(\n        signal: A_TYPES__Component_Constructor<A_Signal>\n    ): A_Signal | undefined\n    getPrev(\n        param: A_TYPES__Component_Constructor<A_Signal> | A_Signal\n    ): A_Signal | undefined {\n        const signal = param instanceof A_Signal ? param.constructor as A_TYPES__Component_Constructor<A_Signal> : param;\n        return this._prevState.get(signal);\n    }   \n\n    /**\n     * Checks if a signal type has been registered in the state\n     * \n     * @param signal - The signal constructor to check for\n     * @returns True if the signal type exists in the state map\n     */\n    has(\n        signal: A_Signal\n    ): boolean\n    has(\n        signal: A_TYPES__Component_Constructor<A_Signal>\n    ): boolean\n    has(\n        param: A_TYPES__Component_Constructor<A_Signal> | A_Signal\n    ): boolean {\n        const signal = param instanceof A_Signal ? param.constructor as A_TYPES__Component_Constructor<A_Signal> : param;\n\n        return this.structure.includes(signal);\n    }\n\n    /**\n     * Removes a signal type and its associated value from the state\n     * \n     * @param signal - The signal constructor to remove\n     * @returns True if the signal was successfully deleted, false if it didn't exist\n     */\n    delete(\n        signal: A_Signal\n    ): boolean\n    delete(\n        signal: A_TYPES__Component_Constructor<A_Signal>\n    ): boolean\n    delete(\n        param: A_TYPES__Component_Constructor<A_Signal> | A_Signal\n    ): boolean {\n        const signal = param instanceof A_Signal ? param.constructor as A_TYPES__Component_Constructor<A_Signal> : param;\n        return this._state.delete(signal);\n    }\n\n\n    /**\n     * Converts the current state to a vector (ordered array) format\n     * \n     * The order is determined by the structure array provided during construction.\n     * Each position in the vector corresponds to a specific signal type's latest value.\n     * \n     * @returns Array of signal values in the order defined by the structure\n     * @throws Error if structure is not defined or if any signal value is undefined\n     */\n    toVector(): A_SignalVector {\n        const vector: Array<A_Signal> = [];\n\n        this._state.forEach((value, key) => {\n            vector.push(value);\n        });\n\n        return new A_SignalVector(vector, this.structure);\n    }\n\n    /**\n     * Converts the current state to an object with signal constructor names as keys\n     * \n     * This provides a more readable representation of the state where each signal\n     * type is identified by its constructor name.\n     * \n     * @returns Object mapping signal constructor names to their latest values\n     * @throws Error if any signal value is undefined\n     */\n    toObject(): Record<string, A_Signal> {\n        const obj: Record<string, A_Signal> = {};\n\n        this.structure.forEach((signalConstructor) => {\n            const value = this._state.get(signalConstructor);\n            if (value === undefined) {\n                throw new Error(`Signal ${signalConstructor.name} has no value in state`);\n            }\n            obj[signalConstructor.name] = value;\n        });\n\n        return obj;\n    }\n\n}"]}

package/dist/node/lib/A-Signal/context/A-SignalState.context.mjs

@@ -0,0 +1,107 @@
+import { __decorateClass } from '../../../chunk-EQQGB2QZ.mjs';
+import { A_Fragment } from '@adaas/a-concept';
+import { A_Signal } from '../entities/A-Signal.entity';
+import { A_SignalVector } from '../entities/A-SignalVector.entity';
+import { A_Frame } from '@adaas/a-frame';
+
+let A_SignalState = class extends A_Fragment {
+  /**
+   * Creates a new A_SignalState instance
+   * 
+   * @param structure - Optional array defining the ordered structure of signal constructors
+   *                   This structure is used for vector operations and determines the order
+   *                   in which signals are processed and serialized
+   */
+  constructor(structure) {
+    super({ name: "A_SignalState" });
+    /**
+     * Internal map storing the relationship between signal constructors and their latest values
+     * Key: Signal constructor function
+     * Value: Latest emitted data from that signal type
+     */
+    this._state = /* @__PURE__ */ new Map();
+    /**
+     * Previous state map to track changes between signal emissions
+     * Key: Signal constructor function
+     * Value: Previous emitted data from that signal type
+     */
+    this._prevState = /* @__PURE__ */ new Map();
+    this._structure = structure;
+  }
+  /**
+   * Gets the ordered structure of signal constructors
+   * @returns Array of signal constructors in their defined order
+   */
+  get structure() {
+    return this._structure || [];
+  }
+  set(param1, param2) {
+    const signal = param1 instanceof A_Signal ? param1.constructor : param1;
+    const value = param1 instanceof A_Signal ? param1 : param2;
+    this._prevState.set(signal, this._state.get(signal));
+    this._state.set(signal, value);
+  }
+  get(param) {
+    const signal = param instanceof A_Signal ? param.constructor : param;
+    return this._state.get(signal);
+  }
+  getPrev(param) {
+    const signal = param instanceof A_Signal ? param.constructor : param;
+    return this._prevState.get(signal);
+  }
+  has(param) {
+    const signal = param instanceof A_Signal ? param.constructor : param;
+    return this.structure.includes(signal);
+  }
+  delete(param) {
+    const signal = param instanceof A_Signal ? param.constructor : param;
+    return this._state.delete(signal);
+  }
+  /**
+   * Converts the current state to a vector (ordered array) format
+   * 
+   * The order is determined by the structure array provided during construction.
+   * Each position in the vector corresponds to a specific signal type's latest value.
+   * 
+   * @returns Array of signal values in the order defined by the structure
+   * @throws Error if structure is not defined or if any signal value is undefined
+   */
+  toVector() {
+    const vector = [];
+    this._state.forEach((value, key) => {
+      vector.push(value);
+    });
+    return new A_SignalVector(vector, this.structure);
+  }
+  /**
+   * Converts the current state to an object with signal constructor names as keys
+   * 
+   * This provides a more readable representation of the state where each signal
+   * type is identified by its constructor name.
+   * 
+   * @returns Object mapping signal constructor names to their latest values
+   * @throws Error if any signal value is undefined
+   */
+  toObject() {
+    const obj = {};
+    this.structure.forEach((signalConstructor) => {
+      const value = this._state.get(signalConstructor);
+      if (value === void 0) {
+        throw new Error(`Signal ${signalConstructor.name} has no value in state`);
+      }
+      obj[signalConstructor.name] = value;
+    });
+    return obj;
+  }
+};
+A_SignalState = __decorateClass([
+  A_Frame.Fragment({
+    namespace: "A-Utils",
+    name: "A-SignalState",
+    description: "Manages the latest state of all signals within a given scope, maintaining a mapping between signal constructors and their most recently emitted values."
+  })
+], A_SignalState);
+
+export { A_SignalState };
+//# sourceMappingURL=A-SignalState.context.mjs.map
+//# sourceMappingURL=A-SignalState.context.mjs.map

package/dist/node/lib/A-Signal/context/A-SignalState.context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/lib/A-Signal/context/A-SignalState.context.ts"],"names":[],"mappings":"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","file":"A-SignalState.context.mjs","sourcesContent":["import { A_Context, A_Fragment, A_TYPES__Component_Constructor } from \"@adaas/a-concept\";\nimport { A_Signal } from \"../entities/A-Signal.entity\";\nimport { A_SignalVector } from \"../entities/A-SignalVector.entity\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n/**\n * A_SignalState manages the latest state of all signals within a given scope.\n * \n * This class maintains a mapping between signal constructors and their most recently emitted values,\n * providing a centralized state store for signal management within an application context.\n * \n * @template TSignalData - Union type of all possible signal data types that can be stored (must extend Record<string, any>)\n * \n * The generic ensures type safety by maintaining correspondence between:\n * - Signal constructor types and their data types\n * - Signal instances and their emitted value types\n * - Vector structure and the data it contains\n */\n@A_Frame.Fragment({\n    namespace: 'A-Utils',\n    name: 'A-SignalState',\n    description: 'Manages the latest state of all signals within a given scope, maintaining a mapping between signal constructors and their most recently emitted values.'\n})\nexport class A_SignalState<\n    TSignalData extends Record<string, any> = Record<string, any>\n> extends A_Fragment {\n\n    /**\n     * Internal map storing the relationship between signal constructors and their latest values\n     * Key: Signal constructor function\n     * Value: Latest emitted data from that signal type\n     */\n    protected _state: Map<A_TYPES__Component_Constructor<A_Signal>, A_Signal> = new Map();\n\n    /**\n     * Previous state map to track changes between signal emissions\n     * Key: Signal constructor function\n     * Value: Previous emitted data from that signal type\n     */\n    protected _prevState: Map<A_TYPES__Component_Constructor<A_Signal>, A_Signal> = new Map();\n\n    /**\n     * Optional structure defining the ordered list of signal constructors\n     * Used for vector operations and initialization\n     */\n    protected _structure: Array<A_TYPES__Component_Constructor<A_Signal>>;\n\n\n    /**\n     * Gets the ordered structure of signal constructors\n     * @returns Array of signal constructors in their defined order\n     */\n    get structure(): Array<A_TYPES__Component_Constructor<A_Signal>> {\n        return this._structure || [];\n    }\n\n    /**\n     * Creates a new A_SignalState instance\n     * \n     * @param structure - Optional array defining the ordered structure of signal constructors\n     *                   This structure is used for vector operations and determines the order\n     *                   in which signals are processed and serialized\n     */\n    constructor(\n        structure: A_TYPES__Component_Constructor<A_Signal>[]\n    ) {\n        super({ name: \"A_SignalState\" });\n\n        this._structure = structure;\n\n        // Initialize the state map with undefined values for each signal in the structure\n        // This ensures all expected signals have entries in the state map from the start\n      \n    }\n\n\n    /**\n     * Sets the latest value for a specific signal type\n     * \n     * @param signal - The signal constructor to associate the value with\n     * @param value - The data value emitted by the signal\n     */\n    set(\n        signal: A_Signal,\n        value: A_Signal\n    ): void\n    set(\n        signal: A_Signal\n    ): void\n    set(\n        signal: A_TYPES__Component_Constructor<A_Signal>,\n        value: A_Signal\n    ): void\n    set(\n        param1: A_TYPES__Component_Constructor<A_Signal> | A_Signal,\n        param2?: A_Signal\n    ): void {\n        const signal = param1 instanceof A_Signal ? param1.constructor as A_TYPES__Component_Constructor<A_Signal> : param1;\n        const value = param1 instanceof A_Signal ? param1 : param2!;\n\n        this._prevState.set(signal, this._state.get(signal)!);\n        this._state.set(signal, value);\n    }\n\n    /**\n     * Retrieves the latest value for a specific signal type\n     * \n     * @param signal - The signal constructor to get the value for\n     * @returns The latest data value or undefined if no value has been set\n     */\n    get(\n        signal: A_Signal\n    ): A_Signal | undefined\n    get(\n        signal: A_TYPES__Component_Constructor<A_Signal>\n    ): A_Signal | undefined\n    get(\n        param: A_TYPES__Component_Constructor<A_Signal> | A_Signal\n    ): A_Signal | undefined {\n        const signal = param instanceof A_Signal ? param.constructor as A_TYPES__Component_Constructor<A_Signal> : param;\n        return this._state.get(signal);\n    }\n\n    /**\n     * Retrieves the previous value for a specific signal type\n     * \n     * @param signal \n     */\n    getPrev(\n        signal: A_Signal\n    ): A_Signal | undefined\n    getPrev(\n        signal: A_TYPES__Component_Constructor<A_Signal>\n    ): A_Signal | undefined\n    getPrev(\n        param: A_TYPES__Component_Constructor<A_Signal> | A_Signal\n    ): A_Signal | undefined {\n        const signal = param instanceof A_Signal ? param.constructor as A_TYPES__Component_Constructor<A_Signal> : param;\n        return this._prevState.get(signal);\n    }   \n\n    /**\n     * Checks if a signal type has been registered in the state\n     * \n     * @param signal - The signal constructor to check for\n     * @returns True if the signal type exists in the state map\n     */\n    has(\n        signal: A_Signal\n    ): boolean\n    has(\n        signal: A_TYPES__Component_Constructor<A_Signal>\n    ): boolean\n    has(\n        param: A_TYPES__Component_Constructor<A_Signal> | A_Signal\n    ): boolean {\n        const signal = param instanceof A_Signal ? param.constructor as A_TYPES__Component_Constructor<A_Signal> : param;\n\n        return this.structure.includes(signal);\n    }\n\n    /**\n     * Removes a signal type and its associated value from the state\n     * \n     * @param signal - The signal constructor to remove\n     * @returns True if the signal was successfully deleted, false if it didn't exist\n     */\n    delete(\n        signal: A_Signal\n    ): boolean\n    delete(\n        signal: A_TYPES__Component_Constructor<A_Signal>\n    ): boolean\n    delete(\n        param: A_TYPES__Component_Constructor<A_Signal> | A_Signal\n    ): boolean {\n        const signal = param instanceof A_Signal ? param.constructor as A_TYPES__Component_Constructor<A_Signal> : param;\n        return this._state.delete(signal);\n    }\n\n\n    /**\n     * Converts the current state to a vector (ordered array) format\n     * \n     * The order is determined by the structure array provided during construction.\n     * Each position in the vector corresponds to a specific signal type's latest value.\n     * \n     * @returns Array of signal values in the order defined by the structure\n     * @throws Error if structure is not defined or if any signal value is undefined\n     */\n    toVector(): A_SignalVector {\n        const vector: Array<A_Signal> = [];\n\n        this._state.forEach((value, key) => {\n            vector.push(value);\n        });\n\n        return new A_SignalVector(vector, this.structure);\n    }\n\n    /**\n     * Converts the current state to an object with signal constructor names as keys\n     * \n     * This provides a more readable representation of the state where each signal\n     * type is identified by its constructor name.\n     * \n     * @returns Object mapping signal constructor names to their latest values\n     * @throws Error if any signal value is undefined\n     */\n    toObject(): Record<string, A_Signal> {\n        const obj: Record<string, A_Signal> = {};\n\n        this.structure.forEach((signalConstructor) => {\n            const value = this._state.get(signalConstructor);\n            if (value === undefined) {\n                throw new Error(`Signal ${signalConstructor.name} has no value in state`);\n            }\n            obj[signalConstructor.name] = value;\n        });\n\n        return obj;\n    }\n\n}"]}

package/dist/node/lib/A-Signal/entities/A-Signal.entity.d.mts

@@ -0,0 +1,2 @@
+import '@adaas/a-concept';
+export { A as A_Signal } from '../../../A-Signal.types-P5VKMKMs.mjs';

package/dist/node/lib/A-Signal/entities/A-Signal.entity.d.ts

@@ -0,0 +1,2 @@
+import '@adaas/a-concept';
+export { A as A_Signal } from '../../../A-Signal.types-P5VKMKMs.js';

package/dist/node/lib/A-Signal/entities/A-Signal.entity.js

@@ -0,0 +1,120 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var aFrame = require('@adaas/a-frame');
+
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(result)) || result;
+  return result;
+};
+exports.A_Signal = class A_Signal extends aConcept.A_Entity {
+  // ========================================================================
+  // ========================== 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 async default() {
+    return void 0;
+  }
+  createHash(str) {
+    let hashSource;
+    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;
+    }
+    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.
+   * 
+   * example: 
+   * * const signalA = new A_Signal({ id: ['user-status', 'user123'], data: { status: 'online' } });
+   * * const signalB = new A_Signal({ id: ['user-status', 'user123'], data: { status: 'offline' } });
+   * 
+   * signalA.compare(signalB) // true because both signals have the same deduplication ID
+   * 
+   * @param other 
+   * @returns 
+   */
+  compare(other) {
+    if (this.aseid.id !== other.aseid.id) {
+      return false;
+    }
+    return true;
+  }
+  fromJSON(serializedEntity) {
+    super.fromJSON(serializedEntity);
+    this.data = serializedEntity.data;
+  }
+  fromNew(newEntity) {
+    this.data = newEntity.data;
+    const identity = newEntity.id || {
+      name: newEntity.name,
+      data: this.data
+    };
+    const id = this.createHash(identity);
+    this.aseid = this.generateASEID({
+      entity: newEntity.name,
+      id
+    });
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      data: this.data
+    };
+  }
+};
+exports.A_Signal = __decorateClass([
+  aFrame.A_Frame.Entity({
+    namespace: "A-Utils",
+    name: "A-Signal",
+    description: "A Signal Entity represents an individual signal instance that carries data, used for managing state within an application context. Signals are designed to reflect the current state rather than individual events, making them suitable for scenarios where state monitoring and real-time updates are essential."
+  })
+], exports.A_Signal);
+//# sourceMappingURL=A-Signal.entity.js.map
+//# sourceMappingURL=A-Signal.entity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/lib/A-Signal/entities/A-Signal.entity.ts"],"names":["A_Signal","A_Entity","A_Frame"],"mappings":"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","file":"A-Signal.entity.js","sourcesContent":["import { A_Entity, A_Scope } from \"@adaas/a-concept\";\nimport { A_Signal_Init, A_Signal_Serialized } from \"../A-Signal.types\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n/**\n * A Signal Entity is an individual signal instance that carries data.\n * Signals is a event types that uses for vectors of signals to be used for further processing. \n * \n * Comparing to standard events, signals should be used in case when the event impacts some \"state\" \n * and the state should be used instead of the event itself.\n * \n * For example, a signal can represent the current status of a user (online/offline/away), \n * while an event would represent a single action (user logged in/logged out).\n * \n * Signals are typically used in scenarios where the current state is more important than individual events, \n * such as monitoring systems, real-time dashboards, or stateful applications.\n */\n@A_Frame.Entity({\n    namespace: 'A-Utils',\n    name: 'A-Signal',\n    description: 'A Signal Entity represents an individual signal instance that carries data, used for managing state within an application context. Signals are designed to reflect the current state rather than individual events, making them suitable for scenarios where state monitoring and real-time updates are essential.'\n})\nexport class A_Signal<\n    _TSignalDataType extends Record<string, any> = Record<string, any>\n> extends A_Entity<A_Signal_Init<_TSignalDataType>, A_Signal_Serialized<_TSignalDataType>> {\n\n\n    // ========================================================================\n    // ========================== Static Methods ==============================\n    // ========================================================================\n    /**\n     * Allows to define default data for the signal.\n     * \n     * If no data is provided during initialization, the default data will be used.\n     * \n     * @returns \n     */\n    static async default(): Promise<A_Signal | undefined> {\n        return undefined;\n    }\n\n    // ========================================================================\n    // ========================== Instance Properties ========================\n    // ========================================================================\n\n    /**\n     * The actual data carried by the signal.\n     */\n    data!: _TSignalDataType;\n\n    /**\n      * Generates signal hash uses for comparison\n      * \n      * @param str \n      */\n    protected createHash(str?: string): string\n    protected createHash(str?: undefined): string\n    protected createHash(str?: Record<string, any>): string\n    protected createHash(str?: Array<any>): string\n    protected createHash(str?: number): string\n    protected createHash(str?: boolean): string\n    protected createHash(str?: null): string\n    protected createHash(map?: Map<any, any>): string\n    protected createHash(set?: Set<any>): string\n    protected createHash(str?: any): string {\n        let hashSource: string;\n\n        if (str instanceof Map) {\n            hashSource = JSON.stringify(Array.from(str.entries()));\n        } else if (str instanceof Set) {\n            hashSource = JSON.stringify(Array.from(str.values()));\n        } else {\n            switch (typeof str) {\n                case 'string':\n                    hashSource = str;\n                    break;\n                case 'undefined':\n                    hashSource = 'undefined';\n                    break;\n\n                case 'object':\n                    if ('toJSON' in str)\n                        hashSource = JSON.stringify(str.toJSON());\n\n                    else\n                        hashSource = JSON.stringify(str);\n                    break;\n                case 'number':\n                    hashSource = str.toString();\n                    break;\n                case 'boolean':\n                    hashSource = str ? 'true' : 'false';\n                    break;\n                case 'function':\n                    hashSource = str.toString();\n                    break;\n                default:\n                    hashSource = String(str);\n            }\n        }\n\n        let hash = 0, i, chr;\n        for (i = 0; i < hashSource.length; i++) {\n            chr = hashSource.charCodeAt(i);\n            hash = ((hash << 5) - hash) + chr;\n            hash |= 0; // Convert to 32bit integer\n        }\n\n        const hashString = hash.toString();\n\n        return hashString;\n    }\n\n    /**\n     * This method compares the current signal with another signal instance by deduplication ID\n     * this id can be configured during initialization with the \"id\" property.\n     * \n     * example: \n     * * const signalA = new A_Signal({ id: ['user-status', 'user123'], data: { status: 'online' } });\n     * * const signalB = new A_Signal({ id: ['user-status', 'user123'], data: { status: 'offline' } });\n     * \n     * signalA.compare(signalB) // true because both signals have the same deduplication ID\n     * \n     * @param other \n     * @returns \n     */\n    compare(other: A_Signal<_TSignalDataType>): boolean {\n        if (this.aseid.id !== other.aseid.id) {\n            return false;\n        }\n\n        return true;\n    }\n    \n\n\n    fromJSON(serializedEntity: A_Signal_Serialized<_TSignalDataType>): void {\n        super.fromJSON(serializedEntity);\n        this.data = serializedEntity.data;\n    }\n\n\n    fromNew(newEntity: A_Signal_Init<_TSignalDataType>): void {\n        this.data = newEntity.data;\n\n        const identity = newEntity.id || {\n            name: newEntity.name,\n            data: this.data\n        };\n\n        const id = this.createHash(identity);\n\n        this.aseid = this.generateASEID({\n            entity: newEntity.name,\n            id: id,\n        });\n    }\n\n\n    toJSON(): A_Signal_Serialized<_TSignalDataType> {\n        return {\n            ...super.toJSON(),\n            data: this.data\n        };\n    }\n\n}"]}

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

@@ -0,0 +1,113 @@
+import { __decorateClass } from '../../../chunk-EQQGB2QZ.mjs';
+import { A_Entity } from '@adaas/a-concept';
+import { A_Frame } from '@adaas/a-frame';
+
+let A_Signal = class extends A_Entity {
+  // ========================================================================
+  // ========================== 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 async default() {
+    return void 0;
+  }
+  createHash(str) {
+    let hashSource;
+    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;
+    }
+    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.
+   * 
+   * example: 
+   * * const signalA = new A_Signal({ id: ['user-status', 'user123'], data: { status: 'online' } });
+   * * const signalB = new A_Signal({ id: ['user-status', 'user123'], data: { status: 'offline' } });
+   * 
+   * signalA.compare(signalB) // true because both signals have the same deduplication ID
+   * 
+   * @param other 
+   * @returns 
+   */
+  compare(other) {
+    if (this.aseid.id !== other.aseid.id) {
+      return false;
+    }
+    return true;
+  }
+  fromJSON(serializedEntity) {
+    super.fromJSON(serializedEntity);
+    this.data = serializedEntity.data;
+  }
+  fromNew(newEntity) {
+    this.data = newEntity.data;
+    const identity = newEntity.id || {
+      name: newEntity.name,
+      data: this.data
+    };
+    const id = this.createHash(identity);
+    this.aseid = this.generateASEID({
+      entity: newEntity.name,
+      id
+    });
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      data: this.data
+    };
+  }
+};
+A_Signal = __decorateClass([
+  A_Frame.Entity({
+    namespace: "A-Utils",
+    name: "A-Signal",
+    description: "A Signal Entity represents an individual signal instance that carries data, used for managing state within an application context. Signals are designed to reflect the current state rather than individual events, making them suitable for scenarios where state monitoring and real-time updates are essential."
+  })
+], A_Signal);
+
+export { A_Signal };
+//# sourceMappingURL=A-Signal.entity.mjs.map
+//# sourceMappingURL=A-Signal.entity.mjs.map