@adaas/a-utils 0.2.8 → 0.3.1

package/dist/node/lib/A-Signal/components/A-SignalBus.component.mjs

@@ -0,0 +1,122 @@
+import { __decorateClass, __decorateParam } from '../../../chunk-EQQGB2QZ.mjs';
+import { A_Component, A_Scope, A_Context, A_Error, A_Feature, A_Inject, A_Dependency } from '@adaas/a-concept';
+import { A_SignalState } from '../context/A-SignalState.context';
+import { A_SignalConfig } from '../context/A-SignalConfig.context';
+import { A_Signal } from '../entities/A-Signal.entity';
+import { A_Config } from '@adaas/a-utils/a-config';
+import { A_Logger } from '@adaas/a-utils/a-logger';
+import { A_Frame } from '@adaas/a-frame';
+import { A_SignalBusFeatures } from './A-SignalBus.constants';
+import { A_SignalBusError } from './A-SignalBus.error';
+
+var _a, _b, _c;
+let A_SignalBus = class extends A_Component {
+  async next(...signals) {
+    const scope = new A_Scope({
+      name: `A_SignalBus-Next-Scope`,
+      entities: signals
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_SignalBusFeatures.onBeforeNext, scope);
+      await this.call(A_SignalBusFeatures.onNext, scope);
+      scope.destroy();
+    } catch (error) {
+      let wrappedError;
+      switch (true) {
+        case error instanceof A_SignalBusError:
+          wrappedError = error;
+          break;
+        case (error instanceof A_Error && error.originalError instanceof A_SignalBusError):
+          wrappedError = error.originalError;
+          break;
+        default:
+          wrappedError = new A_SignalBusError({
+            title: A_SignalBusError.SignalProcessingError,
+            description: `An error occurred while processing the signal.`,
+            originalError: error
+          });
+          break;
+      }
+      scope.register(wrappedError);
+      await this.call(A_SignalBusFeatures.onError);
+      scope.destroy();
+    }
+  }
+  async [_c = A_SignalBusFeatures.onError](error, logger, ...args) {
+    logger?.error(error);
+  }
+  async [_b = A_SignalBusFeatures.onBeforeNext](scope, globalConfig, state, logger, config) {
+    const componentContext = A_Context.scope(this);
+    if (!config) {
+      config = new A_SignalConfig({
+        stringStructure: globalConfig?.get("A_SIGNAL_VECTOR_STRUCTURE") || void 0
+      });
+      componentContext.register(config);
+    }
+    if (!config.ready)
+      await config.initialize();
+    if (!state) {
+      state = new A_SignalState(config.structure);
+      componentContext.register(state);
+    }
+  }
+  async [_a = A_SignalBusFeatures.onNext](signals, scope, state, globalConfig, logger, config) {
+    for (const signal of signals) {
+      if (!state.has(signal))
+        return;
+      logger?.debug(`A_SignalBus: Updating state for signal '${signal.constructor.name}' with data:`, signal.data);
+      state.set(signal);
+    }
+    const vector = state.toVector();
+    scope.register(vector);
+  }
+};
+__decorateClass([
+  A_Frame.Method({
+    description: "Emit multiple signals through the signal bus."
+  })
+], A_SignalBus.prototype, "next", 1);
+__decorateClass([
+  A_Feature.Extend({
+    before: /.*/
+  }),
+  __decorateParam(0, A_Inject(A_Error)),
+  __decorateParam(1, A_Inject(A_Logger))
+], A_SignalBus.prototype, _c, 1);
+__decorateClass([
+  A_Feature.Extend({
+    scope: [A_SignalBus],
+    before: /.*/
+  }),
+  __decorateParam(0, A_Inject(A_Scope)),
+  __decorateParam(1, A_Inject(A_Config)),
+  __decorateParam(2, A_Inject(A_SignalState)),
+  __decorateParam(3, A_Inject(A_Logger)),
+  __decorateParam(4, A_Inject(A_SignalConfig))
+], A_SignalBus.prototype, _b, 1);
+__decorateClass([
+  A_Feature.Extend({
+    scope: [A_SignalBus],
+    before: /.*/
+  }),
+  __decorateParam(0, A_Dependency.Flat()),
+  __decorateParam(0, A_Dependency.All()),
+  __decorateParam(0, A_Inject(A_Signal)),
+  __decorateParam(1, A_Inject(A_Scope)),
+  __decorateParam(2, A_Dependency.Required()),
+  __decorateParam(2, A_Inject(A_SignalState)),
+  __decorateParam(3, A_Inject(A_Config)),
+  __decorateParam(4, A_Inject(A_Logger)),
+  __decorateParam(5, A_Inject(A_SignalConfig))
+], A_SignalBus.prototype, _a, 1);
+A_SignalBus = __decorateClass([
+  A_Frame.Component({
+    namespace: "A-Utils",
+    name: "A-SignalBus",
+    description: "Signal bus component that manages the emission and state of signals within a given scope. It listens for emitted signals, updates their state, and forwards them to registered watchers. The bus ensures a consistent signal vector structure based on the defined configuration, facilitating signal management across multiple components."
+  })
+], A_SignalBus);
+
+export { A_SignalBus };
+//# sourceMappingURL=A-SignalBus.component.mjs.map
+//# sourceMappingURL=A-SignalBus.component.mjs.map

package/dist/node/lib/A-Signal/components/A-SignalBus.component.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/lib/A-Signal/components/A-SignalBus.component.ts"],"names":[],"mappings":"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","file":"A-SignalBus.component.mjs","sourcesContent":["import { A_Caller, A_Component, A_Context, A_Dependency, A_Error, A_Feature, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_SignalState } from \"../context/A-SignalState.context\";\nimport { A_SignalConfig } from \"../context/A-SignalConfig.context\";\nimport { A_Signal } from \"../entities/A-Signal.entity\";\nimport { A_Config } from \"@adaas/a-utils/a-config\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { A_SignalBusFeatures } from \"./A-SignalBus.constants\";\nimport { A_SignalBusError } from \"./A-SignalBus.error\";\n\n\n\n/**\n * This component should listen for all available signal watchers components in this and all parent scopes. \n * When a signal is emitted, it should forward the signal to all registered watchers.\n * \n * A_SignalBus should always return the same vector structure of the signals, and that's why it should store the state of the latest behavior. \n * For example if there are 3 watchers registered, the bus should always return a vector of 3 elements, based on the A_SignalConfig structure.\n * \n * \n * The component itself is stateless and all methods uses only parameters (context) is provided with.\n */\n@A_Frame.Component({\n    namespace: 'A-Utils',\n    name: 'A-SignalBus',\n    description: 'Signal bus component that manages the emission and state of signals within a given scope. It listens for emitted signals, updates their state, and forwards them to registered watchers. The bus ensures a consistent signal vector structure based on the defined configuration, facilitating signal management across multiple components.'\n})\nexport class A_SignalBus extends A_Component {\n\n\n    @A_Frame.Method({\n        description: 'Emit multiple signals through the signal bus.'\n    })\n    async next(...signals: A_Signal[]) {\n        const scope = new A_Scope({\n            name: `A_SignalBus-Next-Scope`,\n            entities: signals\n        })\n            .inherit(A_Context.scope(this));\n\n        try {\n            await this.call(A_SignalBusFeatures.onBeforeNext, scope);\n\n            await this.call(A_SignalBusFeatures.onNext, scope);\n\n            scope.destroy();\n\n        } catch (error) {\n\n            let wrappedError;\n\n            switch (true) {\n                case error instanceof A_SignalBusError:\n                    wrappedError = error;\n                    break;\n\n                case error instanceof A_Error && error.originalError instanceof A_SignalBusError:\n                    wrappedError = error.originalError;\n                    break;\n\n                default:\n                    wrappedError = new A_SignalBusError({\n                        title: A_SignalBusError.SignalProcessingError,\n                        description: `An error occurred while processing the signal.`,\n                        originalError: error\n                    })\n                    break;\n            }\n\n            scope.register(wrappedError);\n\n            await this.call(A_SignalBusFeatures.onError);\n\n            scope.destroy();\n        }\n    }\n\n\n    @A_Feature.Extend({\n        before: /.*/\n    })\n    protected async [A_SignalBusFeatures.onError](\n        @A_Inject(A_Error) error: A_Error,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ) {\n        logger?.error(error);\n    }\n\n    @A_Feature.Extend({\n        scope: [A_SignalBus],\n        before: /.*/\n    })\n    async [A_SignalBusFeatures.onBeforeNext](\n        @A_Inject(A_Scope) scope: A_Scope,\n\n        @A_Inject(A_Config) globalConfig?: A_Config<['A_SIGNAL_VECTOR_STRUCTURE']>,\n        @A_Inject(A_SignalState) state?: A_SignalState,\n\n        @A_Inject(A_Logger) logger?: A_Logger,\n        @A_Inject(A_SignalConfig) config?: A_SignalConfig,\n    ) {\n        /**\n         * We need a context where component is registered, to prevent any duplicate registrations\n         */\n        const componentContext = A_Context.scope(this);\n\n        if (!config) {\n            config = new A_SignalConfig({\n                stringStructure: globalConfig?.get('A_SIGNAL_VECTOR_STRUCTURE') || undefined\n            });\n\n            componentContext.register(config);\n        }\n\n        if (!config.ready)\n            await config.initialize();\n\n        if (!state) {\n            state = new A_SignalState(config.structure);\n            componentContext.register(state);\n        }\n    }\n\n    /**\n     * This methods extends A-Signal Emit feature to handle signal emission within the bus.\n     * \n     * It updates the signal state and emits the updated signal vector.\n     * \n     * @param signal \n     * @param globalConfig \n     * @param logger \n     * @param state \n     * @param config \n     * @returns \n     */\n    @A_Feature.Extend({\n        scope: [A_SignalBus],\n        before: /.*/\n    })\n    async [A_SignalBusFeatures.onNext](\n        @A_Dependency.Flat()\n        @A_Dependency.All()\n        @A_Inject(A_Signal) signals: A_Signal[],\n        @A_Inject(A_Scope) scope: A_Scope,\n\n        @A_Dependency.Required()\n        @A_Inject(A_SignalState) state: A_SignalState,\n\n        @A_Inject(A_Config) globalConfig?: A_Config<['A_SIGNAL_VECTOR_STRUCTURE']>,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        @A_Inject(A_SignalConfig) config?: A_SignalConfig,\n    ) {\n        /*\n        1) create a signal when it occurs via new A_Signal('somedata')\n        2) emit a signal when needed via bus.next(signal)\n        3) the bus should listen for all emitted signals within the scope\n        4) when a signal is emitted, the bus should store a signal in some place (probably it's memory)\n        */\n        // const signals = scope.resolveFlatAll<A_Signal>(A_Signal);\n\n        for (const signal of signals) {\n\n            if (!state.has(signal))\n                return;\n\n            //  ------------------------------------------------------------------\n            //  And finally if all checks are passed, we can update the state\n            //  ------------------------------------------------------------------\n\n            logger?.debug(`A_SignalBus: Updating state for signal '${signal.constructor.name}' with data:`, signal.data);\n\n            state.set(signal);\n        }\n\n        const vector = state.toVector();\n\n        scope.register(vector);\n    }\n}\n"]}

package/dist/node/lib/A-Signal/components/A-SignalBus.constants.d.mts

@@ -0,0 +1,7 @@
+declare enum A_SignalBusFeatures {
+    onBeforeNext = "_A_SignalBusFeatures_onBeforeNext",
+    onNext = "_A_SignalBusFeatures_onNext",
+    onError = "_A_SignalBusFeatures_onError"
+}
+
+export { A_SignalBusFeatures };

package/dist/node/lib/A-Signal/components/A-SignalBus.constants.d.ts

@@ -0,0 +1,7 @@
+declare enum A_SignalBusFeatures {
+    onBeforeNext = "_A_SignalBusFeatures_onBeforeNext",
+    onNext = "_A_SignalBusFeatures_onNext",
+    onError = "_A_SignalBusFeatures_onError"
+}
+
+export { A_SignalBusFeatures };

package/dist/node/lib/A-Signal/components/A-SignalBus.constants.js

@@ -0,0 +1,12 @@
+'use strict';
+
+var A_SignalBusFeatures = /* @__PURE__ */ ((A_SignalBusFeatures2) => {
+  A_SignalBusFeatures2["onBeforeNext"] = "_A_SignalBusFeatures_onBeforeNext";
+  A_SignalBusFeatures2["onNext"] = "_A_SignalBusFeatures_onNext";
+  A_SignalBusFeatures2["onError"] = "_A_SignalBusFeatures_onError";
+  return A_SignalBusFeatures2;
+})(A_SignalBusFeatures || {});
+
+exports.A_SignalBusFeatures = A_SignalBusFeatures;
+//# sourceMappingURL=A-SignalBus.constants.js.map
+//# sourceMappingURL=A-SignalBus.constants.js.map

package/dist/node/lib/A-Signal/components/A-SignalBus.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/lib/A-Signal/components/A-SignalBus.constants.ts"],"names":["A_SignalBusFeatures"],"mappings":";;AACO,IAAK,mBAAA,qBAAAA,oBAAAA,KAAL;AACH,EAAAA,qBAAA,cAAA,CAAA,GAAe,mCAAA;AACf,EAAAA,qBAAA,QAAA,CAAA,GAAS,6BAAA;AAET,EAAAA,qBAAA,SAAA,CAAA,GAAU,8BAAA;AAJF,EAAA,OAAAA,oBAAAA;AAAA,CAAA,EAAA,mBAAA,IAAA,EAAA","file":"A-SignalBus.constants.js","sourcesContent":["\nexport enum A_SignalBusFeatures {\n    onBeforeNext = '_A_SignalBusFeatures_onBeforeNext',\n    onNext = '_A_SignalBusFeatures_onNext',\n\n    onError = '_A_SignalBusFeatures_onError',\n}"]}

package/dist/node/lib/A-Signal/components/A-SignalBus.constants.mjs

@@ -0,0 +1,12 @@
+import '../../../chunk-EQQGB2QZ.mjs';
+
+var A_SignalBusFeatures = /* @__PURE__ */ ((A_SignalBusFeatures2) => {
+  A_SignalBusFeatures2["onBeforeNext"] = "_A_SignalBusFeatures_onBeforeNext";
+  A_SignalBusFeatures2["onNext"] = "_A_SignalBusFeatures_onNext";
+  A_SignalBusFeatures2["onError"] = "_A_SignalBusFeatures_onError";
+  return A_SignalBusFeatures2;
+})(A_SignalBusFeatures || {});
+
+export { A_SignalBusFeatures };
+//# sourceMappingURL=A-SignalBus.constants.mjs.map
+//# sourceMappingURL=A-SignalBus.constants.mjs.map

package/dist/node/lib/A-Signal/components/A-SignalBus.constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/lib/A-Signal/components/A-SignalBus.constants.ts"],"names":["A_SignalBusFeatures"],"mappings":";;AACO,IAAK,mBAAA,qBAAAA,oBAAAA,KAAL;AACH,EAAAA,qBAAA,cAAA,CAAA,GAAe,mCAAA;AACf,EAAAA,qBAAA,QAAA,CAAA,GAAS,6BAAA;AAET,EAAAA,qBAAA,SAAA,CAAA,GAAU,8BAAA;AAJF,EAAA,OAAAA,oBAAAA;AAAA,CAAA,EAAA,mBAAA,IAAA,EAAA","file":"A-SignalBus.constants.mjs","sourcesContent":["\nexport enum A_SignalBusFeatures {\n    onBeforeNext = '_A_SignalBusFeatures_onBeforeNext',\n    onNext = '_A_SignalBusFeatures_onNext',\n\n    onError = '_A_SignalBusFeatures_onError',\n}"]}

package/dist/node/lib/A-Signal/components/A-SignalBus.error.d.mts

@@ -0,0 +1,7 @@
+import { A_Error } from '@adaas/a-concept';
+
+declare class A_SignalBusError extends A_Error {
+    static readonly SignalProcessingError = "Signal processing error";
+}
+
+export { A_SignalBusError };

package/dist/node/lib/A-Signal/components/A-SignalBus.error.d.ts

@@ -0,0 +1,7 @@
+import { A_Error } from '@adaas/a-concept';
+
+declare class A_SignalBusError extends A_Error {
+    static readonly SignalProcessingError = "Signal processing error";
+}
+
+export { A_SignalBusError };

package/dist/node/lib/A-Signal/components/A-SignalBus.error.js

@@ -0,0 +1,11 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+
+class A_SignalBusError extends aConcept.A_Error {
+}
+A_SignalBusError.SignalProcessingError = "Signal processing error";
+
+exports.A_SignalBusError = A_SignalBusError;
+//# sourceMappingURL=A-SignalBus.error.js.map
+//# sourceMappingURL=A-SignalBus.error.js.map

package/dist/node/lib/A-Signal/components/A-SignalBus.error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/lib/A-Signal/components/A-SignalBus.error.ts"],"names":["A_Error"],"mappings":";;;;AAIO,MAAM,yBAAyBA,gBAAA,CAAQ;AAI9C;AAJa,gBAAA,CAGO,qBAAA,GAAwB,yBAAA","file":"A-SignalBus.error.js","sourcesContent":["import { A_Error } from \"@adaas/a-concept\";\n\n\n\nexport class A_SignalBusError extends A_Error {\n\n\n    static readonly SignalProcessingError = 'Signal processing error';\n}"]}

package/dist/node/lib/A-Signal/components/A-SignalBus.error.mjs

@@ -0,0 +1,10 @@
+import '../../../chunk-EQQGB2QZ.mjs';
+import { A_Error } from '@adaas/a-concept';
+
+class A_SignalBusError extends A_Error {
+}
+A_SignalBusError.SignalProcessingError = "Signal processing error";
+
+export { A_SignalBusError };
+//# sourceMappingURL=A-SignalBus.error.mjs.map
+//# sourceMappingURL=A-SignalBus.error.mjs.map

package/dist/node/lib/A-Signal/components/A-SignalBus.error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/lib/A-Signal/components/A-SignalBus.error.ts"],"names":[],"mappings":";;;AAIO,MAAM,yBAAyB,OAAA,CAAQ;AAI9C;AAJa,gBAAA,CAGO,qBAAA,GAAwB,yBAAA","file":"A-SignalBus.error.mjs","sourcesContent":["import { A_Error } from \"@adaas/a-concept\";\n\n\n\nexport class A_SignalBusError extends A_Error {\n\n\n    static readonly SignalProcessingError = 'Signal processing error';\n}"]}

package/dist/node/lib/A-Signal/components/A-SignalBus.types.d.mts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/node/lib/A-Signal/components/A-SignalBus.types.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/node/lib/A-Signal/components/A-SignalBus.types.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=A-SignalBus.types.js.map
+//# sourceMappingURL=A-SignalBus.types.js.map

package/dist/node/lib/A-Signal/components/A-SignalBus.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"A-SignalBus.types.js"}

package/dist/node/lib/A-Signal/components/A-SignalBus.types.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=A-SignalBus.types.mjs.map
+//# sourceMappingURL=A-SignalBus.types.mjs.map

package/dist/node/lib/A-Signal/components/A-SignalBus.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"A-SignalBus.types.mjs"}

package/dist/node/lib/A-Signal/context/A-SignalConfig.context.d.mts

@@ -0,0 +1,36 @@
+import { A_Fragment, A_TYPES__Entity_Constructor } from '@adaas/a-concept';
+import { A as A_Signal, a as A_SignalConfig_Init } from '../../../A-Signal.types-P5VKMKMs.mjs';
+
+/**
+ * This component should dictate a structure of the vector for all signals within a given scope.
+ * so if there're multiple signals it should say what type at what position should be expected.
+ *
+ * e.g. [A_RouterWatcher, A_ScopeWatcher, A_LoggerWatcher]
+ * This structure then should be used for any further processing of signals within the scope.
+ */
+declare class A_SignalConfig extends A_Fragment {
+    protected _structure?: Array<A_TYPES__Entity_Constructor<A_Signal>>;
+    protected _config: A_SignalConfig_Init;
+    protected _ready?: Promise<void>;
+    get structure(): Array<A_TYPES__Entity_Constructor<A_Signal>>;
+    /**
+     * Uses for synchronization to ensure the config is initialized.
+     *
+     * @returns True if the configuration has been initialized.
+     */
+    get ready(): Promise<void> | undefined;
+    constructor(params: A_SignalConfig_Init);
+    /**
+     * Initializes the signal configuration if not already initialized.
+     *
+     * @returns
+     */
+    initialize(): Promise<void>;
+    /**
+     * Initializes the signal configuration by processing the provided structure or string representation.
+     * This method sets up the internal structure of signal constructors based on the configuration.
+     */
+    protected _initialize(): Promise<void>;
+}
+
+export { A_SignalConfig };

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

@@ -0,0 +1,36 @@
+import { A_Fragment, A_TYPES__Entity_Constructor } from '@adaas/a-concept';
+import { A as A_Signal, a as A_SignalConfig_Init } from '../../../A-Signal.types-P5VKMKMs.js';
+
+/**
+ * This component should dictate a structure of the vector for all signals within a given scope.
+ * so if there're multiple signals it should say what type at what position should be expected.
+ *
+ * e.g. [A_RouterWatcher, A_ScopeWatcher, A_LoggerWatcher]
+ * This structure then should be used for any further processing of signals within the scope.
+ */
+declare class A_SignalConfig extends A_Fragment {
+    protected _structure?: Array<A_TYPES__Entity_Constructor<A_Signal>>;
+    protected _config: A_SignalConfig_Init;
+    protected _ready?: Promise<void>;
+    get structure(): Array<A_TYPES__Entity_Constructor<A_Signal>>;
+    /**
+     * Uses for synchronization to ensure the config is initialized.
+     *
+     * @returns True if the configuration has been initialized.
+     */
+    get ready(): Promise<void> | undefined;
+    constructor(params: A_SignalConfig_Init);
+    /**
+     * Initializes the signal configuration if not already initialized.
+     *
+     * @returns
+     */
+    initialize(): Promise<void>;
+    /**
+     * Initializes the signal configuration by processing the provided structure or string representation.
+     * This method sets up the internal structure of signal constructors based on the configuration.
+     */
+    protected _initialize(): Promise<void>;
+}
+
+export { A_SignalConfig };

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

@@ -0,0 +1,68 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var ASignal_entity = require('../entities/A-Signal.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_SignalConfig = class A_SignalConfig extends aConcept.A_Fragment {
+  get structure() {
+    if (this._structure) {
+      return this._structure;
+    }
+    const scope = aConcept.A_Context.scope(this);
+    const constructors = [...scope.allowedEntities].filter((e) => aConcept.A_CommonHelper.isInheritedFrom(e, ASignal_entity.A_Signal)).sort((a, b) => a.constructor.name.localeCompare(b.name)).map((s) => scope.resolveConstructor(s.name));
+    return constructors.filter((s) => s);
+  }
+  /**
+   * Uses for synchronization to ensure the config is initialized.
+   * 
+   * @returns True if the configuration has been initialized.
+   */
+  get ready() {
+    return this._ready;
+  }
+  constructor(params) {
+    super({ name: "A_SignalConfig" });
+    this._config = params;
+  }
+  /**
+   * Initializes the signal configuration if not already initialized.
+   * 
+   * @returns 
+   */
+  async initialize() {
+    if (!this._ready) {
+      this._ready = this._initialize();
+    }
+    return this._ready;
+  }
+  /**
+   * Initializes the signal configuration by processing the provided structure or string representation.
+   * This method sets up the internal structure of signal constructors based on the configuration.
+   */
+  async _initialize() {
+    if (this._config.structure) {
+      this._structure = this._config.structure;
+    } else if (this._config.stringStructure) {
+      const stringStructure = this._config.stringStructure.split(",").map((s) => s.trim());
+      this._structure = stringStructure.map((name) => aConcept.A_Context.scope(this).resolveConstructor(name)).filter((s) => s);
+    }
+  }
+};
+exports.A_SignalConfig = __decorateClass([
+  aFrame.A_Frame.Fragment({
+    namespace: "A-Utils",
+    name: "A-SignalConfig",
+    description: "Signal configuration fragment that defines the structure and types of signals within a given scope. It allows specifying the expected signal constructors and their order, facilitating consistent signal management and processing across components that emit or listen to signals."
+  })
+], exports.A_SignalConfig);
+//# sourceMappingURL=A-SignalConfig.context.js.map
+//# sourceMappingURL=A-SignalConfig.context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/lib/A-Signal/context/A-SignalConfig.context.ts"],"names":["A_SignalConfig","A_Fragment","A_Context","A_CommonHelper","A_Signal","A_Frame"],"mappings":";;;;;;;;;;;;;;AAmBaA,sBAAA,GAAN,6BAA6BC,mBAAA,CAAW;AAAA,EAQ3C,IAAI,SAAA,GAA0D;AAC1D,IAAA,IAAI,KAAK,UAAA,EAAY;AACjB,MAAA,OAAO,IAAA,CAAK,UAAA;AAAA,IAChB;AAEA,IAAA,MAAM,KAAA,GAAQC,kBAAA,CAAU,KAAA,CAAM,IAAI,CAAA;AAGlC,IAAA,MAAM,YAAA,GAAe,CAAC,GAAG,KAAA,CAAM,eAAe,CAAA,CACzC,MAAA,CAAO,CAAA,CAAA,KAAKC,uBAAA,CAAe,eAAA,CAAgB,CAAA,EAAGC,uBAAQ,CAAC,EACvD,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,WAAA,CAAY,IAAA,CAAK,aAAA,CAAc,EAAE,IAAI,CAAC,CAAA,CACvD,GAAA,CAAI,CAAA,CAAA,KAAK,KAAA,CAAM,kBAAA,CAA6B,CAAA,CAAE,IAAI,CAAC,CAAA;AAExD,IAAA,OAAO,YAAA,CAAa,MAAA,CAAO,CAAA,CAAA,KAAK,CAAC,CAAA;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,KAAA,GAAQ;AACR,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EAChB;AAAA,EAEA,YACI,MAAA,EACF;AACE,IAAA,KAAA,CAAM,EAAE,IAAA,EAAM,gBAAA,EAAkB,CAAA;AAChC,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,UAAA,GAAa;AACf,IAAA,IAAI,CAAC,KAAK,MAAA,EAAQ;AACd,MAAA,IAAA,CAAK,MAAA,GAAS,KAAK,WAAA,EAAY;AAAA,IACnC;AACA,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAgB,WAAA,GAAc;AAC1B,IAAA,IAAI,IAAA,CAAK,QAAQ,SAAA,EAAW;AACxB,MAAA,IAAA,CAAK,UAAA,GAAa,KAAK,OAAA,CAAQ,SAAA;AAAA,IACnC,CAAA,MAAA,IAAW,IAAA,CAAK,OAAA,CAAQ,eAAA,EAAiB;AACrC,MAAA,MAAM,eAAA,GAAkB,IAAA,CAAK,OAAA,CAAQ,eAAA,CAAgB,KAAA,CAAM,GAAG,CAAA,CAAE,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,CAAE,IAAA,EAAM,CAAA;AACjF,MAAA,IAAA,CAAK,UAAA,GAAa,eAAA,CACb,GAAA,CAAI,CAAA,IAAA,KAAQF,mBAAU,KAAA,CAAM,IAAI,CAAA,CAAE,kBAAA,CAA6B,IAAI,CAAC,CAAA,CACpE,MAAA,CAAO,OAAK,CAAC,CAAA;AAAA,IACtB;AAAA,EAEJ;AAEJ;AArEaF,sBAAA,GAAN,eAAA,CAAA;AAAA,EALNK,eAAQ,QAAA,CAAS;AAAA,IACd,SAAA,EAAW,SAAA;AAAA,IACX,IAAA,EAAM,gBAAA;AAAA,IACN,WAAA,EAAa;AAAA,GAChB;AAAA,CAAA,EACYL,sBAAA,CAAA","file":"A-SignalConfig.context.js","sourcesContent":["import { A_CommonHelper, A_Context, A_Fragment, A_TYPES__Component_Constructor, A_TYPES__Entity_Constructor } from \"@adaas/a-concept\";\nimport { A_SignalConfig_Init } from \"../A-Signal.types\";\nimport { A_Signal } from \"../entities/A-Signal.entity\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n\n\n/**\n * This component should dictate a structure of the vector for all signals within a given scope.\n * so if there're multiple signals it should say what type at what position should be expected.\n * \n * e.g. [A_RouterWatcher, A_ScopeWatcher, A_LoggerWatcher]\n * This structure then should be used for any further processing of signals within the scope.\n */\n@A_Frame.Fragment({\n    namespace: 'A-Utils',\n    name: 'A-SignalConfig',\n    description: 'Signal configuration fragment that defines the structure and types of signals within a given scope. It allows specifying the expected signal constructors and their order, facilitating consistent signal management and processing across components that emit or listen to signals.'\n})\nexport class A_SignalConfig extends A_Fragment {\n\n    protected _structure?: Array<A_TYPES__Entity_Constructor<A_Signal>>;\n\n    protected _config: A_SignalConfig_Init\n\n    protected _ready?: Promise<void>;\n\n    get structure(): Array<A_TYPES__Entity_Constructor<A_Signal>> {\n        if (this._structure) {\n            return this._structure;\n        }\n\n        const scope = A_Context.scope(this);\n\n        //  just sort by constructor name to have consistent order\n        const constructors = [...scope.allowedEntities]\n            .filter(e => A_CommonHelper.isInheritedFrom(e, A_Signal))\n            .sort((a, b) => a.constructor.name.localeCompare(b.name))\n            .map(s => scope.resolveConstructor<A_Signal>(s.name));\n\n        return constructors.filter(s => s) as Array<A_TYPES__Entity_Constructor<A_Signal>>;\n    }\n\n    /**\n     * Uses for synchronization to ensure the config is initialized.\n     * \n     * @returns True if the configuration has been initialized.\n     */\n    get ready() {\n        return this._ready;\n    }\n\n    constructor(\n        params: A_SignalConfig_Init\n    ) {\n        super({ name: \"A_SignalConfig\" });\n        this._config = params;\n    }\n\n\n    /**\n     * Initializes the signal configuration if not already initialized.\n     * \n     * @returns \n     */\n    async initialize() {\n        if (!this._ready) {\n            this._ready = this._initialize();\n        }\n        return this._ready;\n    }\n\n    /**\n     * Initializes the signal configuration by processing the provided structure or string representation.\n     * This method sets up the internal structure of signal constructors based on the configuration.\n     */\n    protected async _initialize() {\n        if (this._config.structure) {\n            this._structure = this._config.structure;\n        } else if (this._config.stringStructure) {\n            const stringStructure = this._config.stringStructure.split(',').map(s => s.trim());\n            this._structure = stringStructure\n                .map(name => A_Context.scope(this).resolveConstructor<A_Signal>(name))\n                .filter(s => s);\n        }\n\n    }\n\n}"]}

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

@@ -0,0 +1,61 @@
+import { __decorateClass } from '../../../chunk-EQQGB2QZ.mjs';
+import { A_Fragment, A_Context, A_CommonHelper } from '@adaas/a-concept';
+import { A_Signal } from '../entities/A-Signal.entity';
+import { A_Frame } from '@adaas/a-frame';
+
+let A_SignalConfig = class extends A_Fragment {
+  get structure() {
+    if (this._structure) {
+      return this._structure;
+    }
+    const scope = A_Context.scope(this);
+    const constructors = [...scope.allowedEntities].filter((e) => A_CommonHelper.isInheritedFrom(e, A_Signal)).sort((a, b) => a.constructor.name.localeCompare(b.name)).map((s) => scope.resolveConstructor(s.name));
+    return constructors.filter((s) => s);
+  }
+  /**
+   * Uses for synchronization to ensure the config is initialized.
+   * 
+   * @returns True if the configuration has been initialized.
+   */
+  get ready() {
+    return this._ready;
+  }
+  constructor(params) {
+    super({ name: "A_SignalConfig" });
+    this._config = params;
+  }
+  /**
+   * Initializes the signal configuration if not already initialized.
+   * 
+   * @returns 
+   */
+  async initialize() {
+    if (!this._ready) {
+      this._ready = this._initialize();
+    }
+    return this._ready;
+  }
+  /**
+   * Initializes the signal configuration by processing the provided structure or string representation.
+   * This method sets up the internal structure of signal constructors based on the configuration.
+   */
+  async _initialize() {
+    if (this._config.structure) {
+      this._structure = this._config.structure;
+    } else if (this._config.stringStructure) {
+      const stringStructure = this._config.stringStructure.split(",").map((s) => s.trim());
+      this._structure = stringStructure.map((name) => A_Context.scope(this).resolveConstructor(name)).filter((s) => s);
+    }
+  }
+};
+A_SignalConfig = __decorateClass([
+  A_Frame.Fragment({
+    namespace: "A-Utils",
+    name: "A-SignalConfig",
+    description: "Signal configuration fragment that defines the structure and types of signals within a given scope. It allows specifying the expected signal constructors and their order, facilitating consistent signal management and processing across components that emit or listen to signals."
+  })
+], A_SignalConfig);
+
+export { A_SignalConfig };
+//# sourceMappingURL=A-SignalConfig.context.mjs.map
+//# sourceMappingURL=A-SignalConfig.context.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/lib/A-Signal/context/A-SignalConfig.context.ts"],"names":[],"mappings":";;;;;AAmBO,IAAM,cAAA,GAAN,cAA6B,UAAA,CAAW;AAAA,EAQ3C,IAAI,SAAA,GAA0D;AAC1D,IAAA,IAAI,KAAK,UAAA,EAAY;AACjB,MAAA,OAAO,IAAA,CAAK,UAAA;AAAA,IAChB;AAEA,IAAA,MAAM,KAAA,GAAQ,SAAA,CAAU,KAAA,CAAM,IAAI,CAAA;AAGlC,IAAA,MAAM,YAAA,GAAe,CAAC,GAAG,KAAA,CAAM,eAAe,CAAA,CACzC,MAAA,CAAO,CAAA,CAAA,KAAK,cAAA,CAAe,eAAA,CAAgB,CAAA,EAAG,QAAQ,CAAC,EACvD,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,WAAA,CAAY,IAAA,CAAK,aAAA,CAAc,EAAE,IAAI,CAAC,CAAA,CACvD,GAAA,CAAI,CAAA,CAAA,KAAK,KAAA,CAAM,kBAAA,CAA6B,CAAA,CAAE,IAAI,CAAC,CAAA;AAExD,IAAA,OAAO,YAAA,CAAa,MAAA,CAAO,CAAA,CAAA,KAAK,CAAC,CAAA;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,KAAA,GAAQ;AACR,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EAChB;AAAA,EAEA,YACI,MAAA,EACF;AACE,IAAA,KAAA,CAAM,EAAE,IAAA,EAAM,gBAAA,EAAkB,CAAA;AAChC,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,UAAA,GAAa;AACf,IAAA,IAAI,CAAC,KAAK,MAAA,EAAQ;AACd,MAAA,IAAA,CAAK,MAAA,GAAS,KAAK,WAAA,EAAY;AAAA,IACnC;AACA,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAgB,WAAA,GAAc;AAC1B,IAAA,IAAI,IAAA,CAAK,QAAQ,SAAA,EAAW;AACxB,MAAA,IAAA,CAAK,UAAA,GAAa,KAAK,OAAA,CAAQ,SAAA;AAAA,IACnC,CAAA,MAAA,IAAW,IAAA,CAAK,OAAA,CAAQ,eAAA,EAAiB;AACrC,MAAA,MAAM,eAAA,GAAkB,IAAA,CAAK,OAAA,CAAQ,eAAA,CAAgB,KAAA,CAAM,GAAG,CAAA,CAAE,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,CAAE,IAAA,EAAM,CAAA;AACjF,MAAA,IAAA,CAAK,UAAA,GAAa,eAAA,CACb,GAAA,CAAI,CAAA,IAAA,KAAQ,UAAU,KAAA,CAAM,IAAI,CAAA,CAAE,kBAAA,CAA6B,IAAI,CAAC,CAAA,CACpE,MAAA,CAAO,OAAK,CAAC,CAAA;AAAA,IACtB;AAAA,EAEJ;AAEJ;AArEa,cAAA,GAAN,eAAA,CAAA;AAAA,EALN,QAAQ,QAAA,CAAS;AAAA,IACd,SAAA,EAAW,SAAA;AAAA,IACX,IAAA,EAAM,gBAAA;AAAA,IACN,WAAA,EAAa;AAAA,GAChB;AAAA,CAAA,EACY,cAAA,CAAA","file":"A-SignalConfig.context.mjs","sourcesContent":["import { A_CommonHelper, A_Context, A_Fragment, A_TYPES__Component_Constructor, A_TYPES__Entity_Constructor } from \"@adaas/a-concept\";\nimport { A_SignalConfig_Init } from \"../A-Signal.types\";\nimport { A_Signal } from \"../entities/A-Signal.entity\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n\n\n/**\n * This component should dictate a structure of the vector for all signals within a given scope.\n * so if there're multiple signals it should say what type at what position should be expected.\n * \n * e.g. [A_RouterWatcher, A_ScopeWatcher, A_LoggerWatcher]\n * This structure then should be used for any further processing of signals within the scope.\n */\n@A_Frame.Fragment({\n    namespace: 'A-Utils',\n    name: 'A-SignalConfig',\n    description: 'Signal configuration fragment that defines the structure and types of signals within a given scope. It allows specifying the expected signal constructors and their order, facilitating consistent signal management and processing across components that emit or listen to signals.'\n})\nexport class A_SignalConfig extends A_Fragment {\n\n    protected _structure?: Array<A_TYPES__Entity_Constructor<A_Signal>>;\n\n    protected _config: A_SignalConfig_Init\n\n    protected _ready?: Promise<void>;\n\n    get structure(): Array<A_TYPES__Entity_Constructor<A_Signal>> {\n        if (this._structure) {\n            return this._structure;\n        }\n\n        const scope = A_Context.scope(this);\n\n        //  just sort by constructor name to have consistent order\n        const constructors = [...scope.allowedEntities]\n            .filter(e => A_CommonHelper.isInheritedFrom(e, A_Signal))\n            .sort((a, b) => a.constructor.name.localeCompare(b.name))\n            .map(s => scope.resolveConstructor<A_Signal>(s.name));\n\n        return constructors.filter(s => s) as Array<A_TYPES__Entity_Constructor<A_Signal>>;\n    }\n\n    /**\n     * Uses for synchronization to ensure the config is initialized.\n     * \n     * @returns True if the configuration has been initialized.\n     */\n    get ready() {\n        return this._ready;\n    }\n\n    constructor(\n        params: A_SignalConfig_Init\n    ) {\n        super({ name: \"A_SignalConfig\" });\n        this._config = params;\n    }\n\n\n    /**\n     * Initializes the signal configuration if not already initialized.\n     * \n     * @returns \n     */\n    async initialize() {\n        if (!this._ready) {\n            this._ready = this._initialize();\n        }\n        return this._ready;\n    }\n\n    /**\n     * Initializes the signal configuration by processing the provided structure or string representation.\n     * This method sets up the internal structure of signal constructors based on the configuration.\n     */\n    protected async _initialize() {\n        if (this._config.structure) {\n            this._structure = this._config.structure;\n        } else if (this._config.stringStructure) {\n            const stringStructure = this._config.stringStructure.split(',').map(s => s.trim());\n            this._structure = stringStructure\n                .map(name => A_Context.scope(this).resolveConstructor<A_Signal>(name))\n                .filter(s => s);\n        }\n\n    }\n\n}"]}

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

@@ -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.mjs';
+import { A_SignalVector } from '../entities/A-SignalVector.entity.mjs';
+
+/**
+ * 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 };