@adaas/a-utils 0.2.7 → 0.2.9

package/dist/browser/a-service.d.mts

@@ -0,0 +1,40 @@
+import { A_Container, A_Error } from '@adaas/a-concept';
+import { A as A_Logger } from './A-Logger.component-Be-LMV3I.mjs';
+import { A_Polyfill } from './a-polyfill.mjs';
+import './a-execution.mjs';
+
+declare enum A_ServiceFeatures {
+    onBeforeLoad = "_A_Service_onBeforeLoad",
+    onLoad = "_A_Service_onLoad",
+    onAfterLoad = "_A_Service_onAfterLoad",
+    onBeforeStart = "_A_Service_onBeforeStart",
+    onStart = "_A_Service_onStart",
+    onAfterStart = "_A_Service_onAfterStart",
+    onBeforeStop = "_A_Service_onBeforeStop",
+    onStop = "_A_Service_onStop",
+    onAfterStop = "_A_Service_onAfterStop",
+    onError = "_A_Service_onError"
+}
+
+/**
+ * A-Service is a container that can run different types of services, such as HTTP servers, workers, etc.
+ * Depending on the provided config and configuration, it will load the necessary components and start the service.
+ *
+ */
+declare class A_Service extends A_Container {
+    load(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    protected [A_ServiceFeatures.onBeforeLoad](polyfill: A_Polyfill, ...args: any[]): Promise<void>;
+    protected [A_ServiceFeatures.onLoad](...args: any[]): Promise<void>;
+    protected [A_ServiceFeatures.onAfterLoad](...args: any[]): Promise<void>;
+    protected [A_ServiceFeatures.onBeforeStart](...args: any[]): Promise<void>;
+    protected [A_ServiceFeatures.onStart](...args: any[]): Promise<void>;
+    protected [A_ServiceFeatures.onAfterStart](...args: any[]): Promise<void>;
+    protected [A_ServiceFeatures.onBeforeStop](...args: any[]): Promise<void>;
+    protected [A_ServiceFeatures.onStop](...args: any[]): Promise<void>;
+    protected [A_ServiceFeatures.onAfterStop](...args: any[]): Promise<void>;
+    protected [A_ServiceFeatures.onError](error: A_Error, logger?: A_Logger, ...args: any[]): Promise<void>;
+}
+
+export { A_Service, A_ServiceFeatures };

package/dist/browser/a-service.mjs

@@ -0,0 +1,197 @@
+import { A_Logger } from './chunk-TK5UEYMZ.mjs';
+import './chunk-ECSGFDRQ.mjs';
+import { A_Polyfill } from './chunk-J6CLHXFQ.mjs';
+import './chunk-TQ5UON22.mjs';
+import { __decorateClass, __decorateParam } from './chunk-EQQGB2QZ.mjs';
+import { A_Concept, A_Feature, A_Inject, A_Error, A_Container } from '@adaas/a-concept';
+import { A_Frame } from '@adaas/a-frame';
+
+// src/lib/A-Service/A-Service.constants.ts
+var A_ServiceFeatures = /* @__PURE__ */ ((A_ServiceFeatures2) => {
+  A_ServiceFeatures2["onBeforeLoad"] = "_A_Service_onBeforeLoad";
+  A_ServiceFeatures2["onLoad"] = "_A_Service_onLoad";
+  A_ServiceFeatures2["onAfterLoad"] = "_A_Service_onAfterLoad";
+  A_ServiceFeatures2["onBeforeStart"] = "_A_Service_onBeforeStart";
+  A_ServiceFeatures2["onStart"] = "_A_Service_onStart";
+  A_ServiceFeatures2["onAfterStart"] = "_A_Service_onAfterStart";
+  A_ServiceFeatures2["onBeforeStop"] = "_A_Service_onBeforeStop";
+  A_ServiceFeatures2["onStop"] = "_A_Service_onStop";
+  A_ServiceFeatures2["onAfterStop"] = "_A_Service_onAfterStop";
+  A_ServiceFeatures2["onError"] = "_A_Service_onError";
+  return A_ServiceFeatures2;
+})(A_ServiceFeatures || {});
+var A_Service_Error = class extends A_Error {
+};
+A_Service_Error.ServiceLoadError = "Service load error";
+A_Service_Error.ServiceStartError = "Service start error";
+A_Service_Error.ServiceStopError = "Service stop error";
+var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+var A_Service = class extends A_Container {
+  /**
+   * Load the service
+   */
+  async load() {
+    try {
+      await this.call("_A_Service_onBeforeLoad" /* onBeforeLoad */);
+      await this.call("_A_Service_onLoad" /* onLoad */);
+      await this.call("_A_Service_onAfterLoad" /* onAfterLoad */);
+    } catch (error) {
+      let wrappedError;
+      switch (true) {
+        case error instanceof A_Service_Error:
+          wrappedError = error;
+          break;
+        case (error instanceof A_Error && error.originalError instanceof A_Service_Error):
+          wrappedError = error.originalError;
+          break;
+        default:
+          wrappedError = new A_Service_Error({
+            title: A_Service_Error.ServiceLoadError,
+            description: "An error occurred while processing the request.",
+            originalError: error
+          });
+          break;
+      }
+      this.scope.register(wrappedError);
+      await this.call("_A_Service_onError" /* onError */);
+    }
+  }
+  /**
+   * Start the server
+   */
+  async start() {
+    try {
+      await this.call("_A_Service_onBeforeStart" /* onBeforeStart */);
+      await this.call("_A_Service_onStart" /* onStart */);
+      await this.call("_A_Service_onAfterStart" /* onAfterStart */);
+    } catch (error) {
+      let wrappedError;
+      switch (true) {
+        case error instanceof A_Service_Error:
+          wrappedError = error;
+          break;
+        case (error instanceof A_Error && error.originalError instanceof A_Service_Error):
+          wrappedError = error.originalError;
+          break;
+        default:
+          wrappedError = new A_Service_Error({
+            title: A_Service_Error.ServiceStartError,
+            description: "An error occurred while processing the request.",
+            originalError: error
+          });
+          break;
+      }
+      this.scope.register(wrappedError);
+      await this.call("_A_Service_onError" /* onError */);
+    }
+  }
+  /**
+   * Stop the server
+   */
+  async stop() {
+    try {
+      await this.call("_A_Service_onBeforeStop" /* onBeforeStop */);
+      await this.call("_A_Service_onStop" /* onStop */);
+      await this.call("_A_Service_onAfterStop" /* onAfterStop */);
+    } catch (error) {
+      let wrappedError;
+      switch (true) {
+        case error instanceof A_Service_Error:
+          wrappedError = error;
+          break;
+        case (error instanceof A_Error && error.originalError instanceof A_Service_Error):
+          wrappedError = error.originalError;
+          break;
+        default:
+          wrappedError = new A_Service_Error({
+            title: A_Service_Error.ServiceStopError,
+            description: "An error occurred while processing the request.",
+            originalError: error
+          });
+          break;
+      }
+      this.scope.register(wrappedError);
+      await this.call("_A_Service_onError" /* onError */);
+    }
+  }
+  async [_j = "_A_Service_onBeforeLoad" /* onBeforeLoad */](polyfill, ...args) {
+    if (!polyfill) {
+      this.scope.register(A_Polyfill);
+      polyfill = this.scope.resolve(A_Polyfill);
+    }
+  }
+  async [_i = "_A_Service_onLoad" /* onLoad */](...args) {
+  }
+  async [_h = "_A_Service_onAfterLoad" /* onAfterLoad */](...args) {
+  }
+  async [_g = "_A_Service_onBeforeStart" /* onBeforeStart */](...args) {
+  }
+  async [_f = "_A_Service_onStart" /* onStart */](...args) {
+  }
+  async [_e = "_A_Service_onAfterStart" /* onAfterStart */](...args) {
+  }
+  async [_d = "_A_Service_onBeforeStop" /* onBeforeStop */](...args) {
+  }
+  async [_c = "_A_Service_onStop" /* onStop */](...args) {
+  }
+  async [_b = "_A_Service_onAfterStop" /* onAfterStop */](...args) {
+  }
+  async [_a = "_A_Service_onError" /* onError */](error, logger, ...args) {
+    logger?.error(error);
+  }
+};
+__decorateClass([
+  A_Concept.Load()
+], A_Service.prototype, "load", 1);
+__decorateClass([
+  A_Concept.Start()
+], A_Service.prototype, "start", 1);
+__decorateClass([
+  A_Concept.Stop()
+], A_Service.prototype, "stop", 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Inject(A_Polyfill))
+], A_Service.prototype, _j, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_Service.prototype, _i, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_Service.prototype, _h, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_Service.prototype, _g, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_Service.prototype, _f, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_Service.prototype, _e, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_Service.prototype, _d, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_Service.prototype, _c, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_Service.prototype, _b, 1);
+__decorateClass([
+  A_Feature.Extend({
+    before: /.*/
+  }),
+  __decorateParam(0, A_Inject(A_Error)),
+  __decorateParam(1, A_Inject(A_Logger))
+], A_Service.prototype, _a, 1);
+A_Service = __decorateClass([
+  A_Frame.Container({
+    namespace: "A-Utils",
+    name: "A-Service",
+    description: "Service container that manages the lifecycle of various types of services, such as HTTP servers and workers or UI loader. It dynamically loads necessary components based on the provided configuration and orchestrates the start and stop processes, ensuring proper error handling and extensibility through feature hooks."
+  })
+], A_Service);
+
+export { A_Service, A_ServiceFeatures };
+//# sourceMappingURL=a-service.mjs.map
+//# sourceMappingURL=a-service.mjs.map

package/dist/browser/a-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-Service/A-Service.constants.ts","../../src/lib/A-Service/A-Service.error.ts","../../src/lib/A-Service/A-Service.container.ts"],"names":["A_ServiceFeatures","A_Error"],"mappings":"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","file":"a-service.mjs","sourcesContent":["export enum A_ServiceFeatures {\n\n    onBeforeLoad = '_A_Service_onBeforeLoad',\n    onLoad = '_A_Service_onLoad',\n    onAfterLoad = '_A_Service_onAfterLoad',\n\n    onBeforeStart = '_A_Service_onBeforeStart',\n    onStart = '_A_Service_onStart',\n    onAfterStart = '_A_Service_onAfterStart',\n\n    onBeforeStop = '_A_Service_onBeforeStop',\n    onStop = '_A_Service_onStop',\n    onAfterStop = '_A_Service_onAfterStop',\n\n\n    onError = '_A_Service_onError',\n}","import { A_Error } from \"@adaas/a-concept\";\n\n\n\nexport class A_Service_Error extends A_Error {\n\n    static readonly ServiceLoadError = 'Service load error';\n\n    static readonly ServiceStartError = 'Service start error';\n\n    static readonly ServiceStopError = 'Service stop error';\n\n    \n\n}","import { A_Concept, A_Container, A_Error, A_Feature, A_Inject } from \"@adaas/a-concept\";\nimport { A_ServiceFeatures } from \"./A-Service.constants\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { A_Service_Error } from \"./A-Service.error\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { A_Polyfill } from '@adaas/a-utils/a-polyfill';\n\n\n\n/**\n * A-Service is a container that can run different types of services, such as HTTP servers, workers, etc.\n * Depending on the provided config and configuration, it will load the necessary components and start the service.\n * \n */\n@A_Frame.Container({\n    namespace: 'A-Utils',\n    name: 'A-Service',\n    description: 'Service container that manages the lifecycle of various types of services, such as HTTP servers and workers or UI loader. It dynamically loads necessary components based on the provided configuration and orchestrates the start and stop processes, ensuring proper error handling and extensibility through feature hooks.'\n})\nexport class A_Service extends A_Container {\n\n\n    @A_Concept.Load()\n    /**\n     * Load the service\n     */\n    async load() {\n        try {\n            await this.call(A_ServiceFeatures.onBeforeLoad);\n\n            await this.call(A_ServiceFeatures.onLoad);\n\n            await this.call(A_ServiceFeatures.onAfterLoad);\n\n        } catch (error) {\n\n            let wrappedError;\n\n            switch (true) {\n                case error instanceof A_Service_Error:\n                    wrappedError = error;\n                    break;\n\n                case error instanceof A_Error && error.originalError instanceof A_Service_Error:\n                    wrappedError = error.originalError;\n                    break;\n\n                default:\n                    wrappedError = new A_Service_Error({\n                        title: A_Service_Error.ServiceLoadError,\n                        description: 'An error occurred while processing the request.',\n                        originalError: error\n                    })\n                    break;\n            }\n\n            this.scope.register(wrappedError);\n\n            await this.call(A_ServiceFeatures.onError);\n        }\n\n    }\n\n\n    @A_Concept.Start()\n    /**\n     * Start the server\n     */\n    async start() {\n        try {\n            await this.call(A_ServiceFeatures.onBeforeStart);\n\n            await this.call(A_ServiceFeatures.onStart);\n\n            await this.call(A_ServiceFeatures.onAfterStart);\n\n        } catch (error) {\n\n            let wrappedError;\n\n            switch (true) {\n                case error instanceof A_Service_Error:\n                    wrappedError = error;\n                    break;\n\n                case error instanceof A_Error && error.originalError instanceof A_Service_Error:\n                    wrappedError = error.originalError;\n                    break;\n\n                default:\n                    wrappedError = new A_Service_Error({\n                        title: A_Service_Error.ServiceStartError,\n                        description: 'An error occurred while processing the request.',\n                        originalError: error\n                    })\n                    break;\n            }\n\n            this.scope.register(wrappedError);\n\n            await this.call(A_ServiceFeatures.onError);\n        }\n\n    }\n\n    @A_Concept.Stop()\n    /**\n     * Stop the server\n     */\n    async stop() {\n        try {\n            await this.call(A_ServiceFeatures.onBeforeStop);\n\n            await this.call(A_ServiceFeatures.onStop);\n\n            await this.call(A_ServiceFeatures.onAfterStop);\n\n        } catch (error) {\n\n            let wrappedError;\n\n            switch (true) {\n                case error instanceof A_Service_Error:\n                    wrappedError = error;\n                    break;\n\n                case error instanceof A_Error && error.originalError instanceof A_Service_Error:\n                    wrappedError = error.originalError;\n                    break;\n\n                default:\n                    wrappedError = new A_Service_Error({\n                        title: A_Service_Error.ServiceStopError,\n                        description: 'An error occurred while processing the request.',\n                        originalError: error\n                    })\n                    break;\n            }\n\n            this.scope.register(wrappedError);\n\n            await this.call(A_ServiceFeatures.onError);\n        }\n    }\n\n\n\n\n    // ======================================================================================\n    // ============================= A-Service Lifecycle =================================\n    // ======================================================================================\n\n    @A_Feature.Extend()\n    protected async [A_ServiceFeatures.onBeforeLoad](\n        @A_Inject(A_Polyfill) polyfill: A_Polyfill,\n        ...args: any[]\n    ): Promise<void> {\n        // Initialize Polyfill\n        if (!polyfill) {\n            this.scope.register(A_Polyfill);\n            polyfill = this.scope.resolve(A_Polyfill)!\n        }\n    }\n\n    @A_Feature.Extend()\n    protected async [A_ServiceFeatures.onLoad](...args: any[]) { }\n\n    @A_Feature.Extend()\n    protected async [A_ServiceFeatures.onAfterLoad](...args: any[]) { }\n\n\n    @A_Feature.Extend()\n    protected async [A_ServiceFeatures.onBeforeStart](...args: any[]) { }\n\n    @A_Feature.Extend()\n    protected async [A_ServiceFeatures.onStart](...args: any[]) { }\n\n    @A_Feature.Extend()\n    protected async  [A_ServiceFeatures.onAfterStart](...args: any[]) { }\n\n\n\n    @A_Feature.Extend()\n    protected async [A_ServiceFeatures.onBeforeStop](...args: any[]) { }\n\n    @A_Feature.Extend()\n    protected async [A_ServiceFeatures.onStop](...args: any[]) { }\n\n    @A_Feature.Extend()\n    protected async [A_ServiceFeatures.onAfterStop](...args: any[]) { }\n\n\n\n    @A_Feature.Extend({\n        before: /.*/\n    })\n    protected async [A_ServiceFeatures.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}\n\n\n\n\n\n\n\n\n"]}

package/dist/browser/a-signal.d.mts

@@ -0,0 +1,402 @@
+import { A_TYPES__Entity_Serialized, A_TYPES__Entity_Constructor, A_Entity, A_Fragment, A_TYPES__Component_Constructor, A_Component, A_Error, A_Scope } from '@adaas/a-concept';
+import { A as A_Logger, f as A_Config } from './A-Logger.component-Be-LMV3I.mjs';
+import './a-execution.mjs';
+
+type A_SignalConfig_Init<TSignals extends Array<A_Signal> = Array<A_Signal>> = {
+    /**
+     * An array defining the structure of the signal vector.
+     *
+     * Each entry corresponds to a signal component constructor.
+     */
+    structure?: A_Signal_TSignalsConstructors<TSignals>;
+    /**
+     * A string representation of the structure for easier DI resolution.
+     * Each signal's constructor name is used to form this string.
+     * e.g. "['A_RouterWatcher', 'A_ScopeWatcher', 'A_LoggerWatcher']"
+     * OR "A_RouterWatcher,A_ScopeWatcher,A_LoggerWatcher"
+     */
+    stringStructure?: string;
+    propagateSignals?: boolean;
+};
+type A_Signal_TSignalsConstructors<T extends Array<A_Signal> = Array<A_Signal>> = T extends Array<infer U> ? U extends A_Signal ? A_TYPES__Entity_Constructor<U>[] : never : never;
+type A_SignalTValue<T extends A_Signal> = T extends A_Signal<infer U> ? U : never;
+type A_SignalTValueArray<T extends Array<A_Signal>> = {
+    [K in keyof T]: T[K] extends A_Signal<infer U> ? U : never;
+};
+type A_SignalVector_Init<_TSignals extends Array<A_Signal> = Array<A_Signal>> = {
+    structure: A_Signal_TSignalsConstructors<_TSignals>;
+    values: _TSignals;
+};
+type A_SignalVector_Serialized = A_TYPES__Entity_Serialized & {
+    structure: string[];
+    values: Array<Record<string, any>>;
+} & A_TYPES__Entity_Serialized;
+type A_Signal_Init<T extends Record<string, any> = Record<string, any>> = {
+    /**
+     * Possible signal id
+     *
+     * [!] used for identification only, all properties will be participating in the hash calculation for deduplication
+     */
+    id?: Array<any>;
+    /**
+     * The signal name
+     */
+    name?: string;
+    /**
+     * The signal data
+     */
+    data: T;
+};
+type A_Signal_Serialized<T extends Record<string, any> = Record<string, any>> = {
+    /**
+     * The signal data
+     */
+    data: T;
+} & A_TYPES__Entity_Serialized;
+
+/**
+ * A Signal Entity is an individual signal instance that carries data.
+ * Signals is a event types that uses for vectors of signals to be used for further processing.
+ *
+ * Comparing to standard events, signals should be used in case when the event impacts some "state"
+ * and the state should be used instead of the event itself.
+ *
+ * For example, a signal can represent the current status of a user (online/offline/away),
+ * while an event would represent a single action (user logged in/logged out).
+ *
+ * Signals are typically used in scenarios where the current state is more important than individual events,
+ * such as monitoring systems, real-time dashboards, or stateful applications.
+ */
+declare class A_Signal<_TSignalDataType extends Record<string, any> = Record<string, any>> extends A_Entity<A_Signal_Init<_TSignalDataType>, A_Signal_Serialized<_TSignalDataType>> {
+    /**
+     * Allows to define default data for the signal.
+     *
+     * If no data is provided during initialization, the default data will be used.
+     *
+     * @returns
+     */
+    static default(): Promise<A_Signal | undefined>;
+    /**
+     * The actual data carried by the 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;
+    /**
+     * 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: A_Signal<_TSignalDataType>): boolean;
+    fromJSON(serializedEntity: A_Signal_Serialized<_TSignalDataType>): void;
+    fromNew(newEntity: A_Signal_Init<_TSignalDataType>): void;
+    toJSON(): A_Signal_Serialized<_TSignalDataType>;
+}
+
+/**
+ * A Signal Vector Entity is a collection of signals structured in a specific way.
+ * It allows grouping multiple signals together for batch processing or transmission.
+ *
+ * Signal Vectors are useful in scenarios where multiple related signals need to be handled together,
+ * as a state of the system or a snapshot of various parameters at a given time.
+ *
+ * @template TSignalsConstructors - Array of signal constructor types (e.g., [typeof MySignal, typeof CustomSignal])
+ * @template TSignals - Array of signal instances derived from constructors
+ */
+declare class A_SignalVector<TSignals extends A_Signal[] = A_Signal[]> extends A_Entity<A_SignalVector_Init<TSignals>> {
+    /**
+     * The structure of the signal vector, defining the types of signals it contains.
+     *
+     * For example:
+     * [UserSignInSignal, UserStatusSignal, UserActivitySignal]
+     *
+     * [!] if not provided, it will be derived from the signals values.
+     */
+    protected _structure?: A_Signal_TSignalsConstructors<TSignals>;
+    /**
+     * It's actual vector Values of Signals like :
+     * [UserActionSignal, UserMousePositionSignal, ExternalDependencySignal]
+     */
+    protected _signals: TSignals;
+    constructor(values: TSignals, structure?: {
+        [K in keyof TSignals]: TSignals[K] extends A_Signal ? A_TYPES__Entity_Constructor<TSignals[K]> : never;
+    });
+    constructor(serialized: A_SignalVector_Serialized);
+    fromNew(newEntity: A_SignalVector_Init<TSignals>): void;
+    /**
+     * The structure of the signal vector, defining the types of signals it contains.
+     *
+     * For example:
+     * [UserSignInSignal, UserStatusSignal, UserActivitySignal]
+     *
+     */
+    get structure(): A_Signal_TSignalsConstructors<TSignals>;
+    get length(): number;
+    /**
+     * Enables iteration over the signals in the vector.
+     *
+     * @returns
+     */
+    [Symbol.iterator](): Iterator<TSignals[number]>;
+    /**
+     * Allows to match the current Signal Vector with another Signal Vector by comparing each signal in the structure.
+     * This method returns true if all signals in the vector match the corresponding signals in the other vector.
+     *
+     * @param other
+     * @returns
+     */
+    match(other: A_SignalVector<TSignals>): boolean;
+    /**
+     * This method should ensure that the current Signal Vector contains all signals from the provided Signal Vector.
+     *
+     * @param signal
+     */
+    contains(signal: A_SignalVector): boolean;
+    /**
+     * Checks if the vector contains a signal of the specified type.
+     *
+     * @param signal
+     */
+    has(signal: A_Signal): boolean;
+    has(signalConstructor: A_TYPES__Entity_Constructor<A_Signal>): boolean;
+    /**
+     * Retrieves the signal of the specified type from the vector.
+     *
+     * @param signal
+     */
+    get<T extends A_Signal>(signal: T): T | undefined;
+    get<T extends A_Signal>(signalConstructor: A_TYPES__Entity_Constructor<T>): T | undefined;
+    /**
+     * Converts to Array of values of signals in the vector
+     * Maintains the order specified in the structure/generic type
+     *
+     * @param structure - Optional structure to override the default ordering
+     * @returns Array of signal instances in the specified order
+     */
+    toVector<T extends Array<A_Signal> = TSignals>(structure?: A_Signal_TSignalsConstructors<T>): Promise<T>;
+    /**
+     * Converts to Array of data of signals in the vector
+     * Maintains the order specified in the structure/generic type
+     *
+     * @param structure - Optional structure to override the default ordering
+     * @returns Array of serialized signal data in the specified order
+     */
+    toDataVector<T extends A_Signal[] = TSignals>(structure?: A_Signal_TSignalsConstructors<T>): Promise<A_SignalTValueArray<T>>;
+    /**
+     * Converts to Object with signal constructor names as keys and their corresponding data values
+     * Uses the structure ordering to ensure consistent key ordering
+     *
+     * @returns Object with signal constructor names as keys and signal data as values
+     */
+    toObject<T extends Array<A_Signal> = TSignals>(structure?: {
+        [K in keyof T]: T[K] extends A_Signal ? A_TYPES__Entity_Constructor<T[K]> : never;
+    }): Promise<{
+        [key: string]: T[number] extends A_Signal<infer D> ? D | undefined : never;
+    }>;
+    /**
+     * Serializes the Signal Vector to a JSON-compatible format.
+     *
+     *
+     * @returns
+     */
+    toJSON(): A_SignalVector_Serialized;
+}
+
+/**
+ * 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>;
+}
+
+/**
+ * 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>;
+}
+
+declare enum A_SignalBusFeatures {
+    onBeforeNext = "_A_SignalBusFeatures_onBeforeNext",
+    onNext = "_A_SignalBusFeatures_onNext",
+    onError = "_A_SignalBusFeatures_onError"
+}
+
+/**
+ * This component should listen for all available signal watchers components in this and all parent scopes.
+ * When a signal is emitted, it should forward the signal to all registered watchers.
+ *
+ * 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.
+ * For example if there are 3 watchers registered, the bus should always return a vector of 3 elements, based on the A_SignalConfig structure.
+ *
+ *
+ * The component itself is stateless and all methods uses only parameters (context) is provided with.
+ */
+declare class A_SignalBus extends A_Component {
+    next(...signals: A_Signal[]): Promise<void>;
+    protected [A_SignalBusFeatures.onError](error: A_Error, logger?: A_Logger, ...args: any[]): Promise<void>;
+    [A_SignalBusFeatures.onBeforeNext](scope: A_Scope, globalConfig?: A_Config<['A_SIGNAL_VECTOR_STRUCTURE']>, state?: A_SignalState, logger?: A_Logger, config?: A_SignalConfig): Promise<void>;
+    /**
+     * This methods extends A-Signal Emit feature to handle signal emission within the bus.
+     *
+     * It updates the signal state and emits the updated signal vector.
+     *
+     * @param signal
+     * @param globalConfig
+     * @param logger
+     * @param state
+     * @param config
+     * @returns
+     */
+    [A_SignalBusFeatures.onNext](signals: A_Signal[], scope: A_Scope, state: A_SignalState, globalConfig?: A_Config<['A_SIGNAL_VECTOR_STRUCTURE']>, logger?: A_Logger, config?: A_SignalConfig): Promise<void>;
+}
+
+declare class A_SignalBusError extends A_Error {
+    static readonly SignalProcessingError = "Signal processing error";
+}
+
+export { A_Signal, A_SignalBus, A_SignalBusError, A_SignalBusFeatures, A_SignalConfig, type A_SignalConfig_Init, A_SignalState, type A_SignalTValue, type A_SignalTValueArray, A_SignalVector, type A_SignalVector_Init, type A_SignalVector_Serialized, type A_Signal_Init, type A_Signal_Serialized, type A_Signal_TSignalsConstructors };