@adaas/a-concept 0.0.64 → 0.1.1

package/dist/src/global/A-Feature/A-Feature.types.d.ts

@@ -1,38 +1,261 @@
 import { A_TYPES__A_StageStep } from "../A-Stage/A-Stage.types";
-import { A_Fragment } from "../A-Fragment/A-Fragment.class";
 import { A_Entity } from "../A-Entity/A-Entity.class";
-import { A_Scope } from "../A-Scope/A-Scope.class";
 import { A_Container } from "../A-Container/A-Container.class";
 import { A_Component } from "../A-Component/A-Component.class";
-export type A_TYPES__FeatureIteratorReturn<T extends any = any> = () => Promise<T>;
-export type A_TYPES__FeatureCallParams = {
-    fragments: Array<A_Fragment>;
-    entities: Array<A_Entity<any, any>>;
-    components: Array<{
-        new (...args: any[]): any;
-    }>;
-};
-export type A_TYPES__FeatureConstructor = {
+import { A_TYPES__Component_Constructor } from "../A-Component/A-Component.types";
+import { A_TYPES__Container_Constructor } from "../A-Container/A-Container.types";
+import { A_TYPES__Entity_Constructor } from "../A-Entity/A-Entity.types";
+import { A_Feature } from "./A-Feature.class";
+import { A_TYPES__Required } from "../../types/A_Common.types";
+import { A_Scope } from "../A-Scope/A-Scope.class";
+/**
+ * Feature constructor type
+ * Uses the generic type T to specify the type of the feature
+ */
+export type A_TYPES__Feature_Constructor<T = A_Feature> = new (...args: any[]) => T;
+/**
+ * Feature initialization type
+ */
+export type A_TYPES__Feature_Init<T extends A_TYPES__FeatureAvailableComponents = A_TYPES__FeatureAvailableComponents> = A_TYPES__Feature_InitWithComponent<T> | A_TYPES__Feature_InitWithTemplate;
+/**
+ * Feature initialization type using component
+ */
+export type A_TYPES__Feature_InitWithComponent<T extends A_TYPES__FeatureAvailableComponents = A_TYPES__FeatureAvailableComponents> = {
     /**
-     * Name of the A-Feature
+     * Feature Name
      */
     name: string;
     /**
-     * Steps that compose the A-Feature
+     * The component from where the feature is calling. It's important for proper scoping.
+     * Based on the component would be retrieved connected components, entities and containers.
+     *
+     * [!] Could be Container, Entity, Component or Command
+     */
+    component: T;
+};
+/**
+ * Feature initialization type using template
+ */
+export type A_TYPES__Feature_InitWithTemplate = {
+    /**
+     * Feature Name
      */
-    steps: A_TYPES__A_StageStep[];
+    name: string;
     /**
-     * Scope in which the A-Feature will be executed
+     * The scope from where to retrieve dependent components, entities and containers.
+     *
+     * [!] Important for proper scoping.
      */
     scope: A_Scope;
     /**
-     *
+     * Optional Feature template to be used instead of building it from decorators
      */
-    caller: A_Component | A_Entity | A_Container;
+    template: Array<A_TYPES__FeatureDefineDecoratorTemplateItem>;
 };
+/**
+ * Feature serialized type
+ */
+export type A_TYPES__Feature_Serialized = {};
+/**
+ * Feature lifecycle states
+ */
 export declare enum A_TYPES__FeatureState {
+    /**
+     * The feature has been initialized
+     */
     INITIALIZED = "INITIALIZED",
+    /**
+     * The feature is currently being processed
+     */
     PROCESSING = "PROCESSING",
+    /**
+     * The feature has been completed
+     */
     COMPLETED = "COMPLETED",
-    FAILED = "FAILED"
+    /**
+     * The feature has been interrupted
+     */
+    INTERRUPTED = "INTERRUPTED"
 }
+/**
+ * A list of component where features can be Defined
+ *
+ * [!] On this component Feature Definition is Available
+ */
+export type A_TYPES__FeatureAvailableComponents = InstanceType<A_TYPES__FeatureAvailableConstructors>;
+/**
+ * A list of constructors where features can be Defined
+ *
+ * [!] On this component Feature Definition is Available
+ */
+export type A_TYPES__FeatureAvailableConstructors = A_TYPES__Component_Constructor | A_TYPES__Entity_Constructor | A_TYPES__Container_Constructor;
+/**
+ * Indicates a type of Feature Define decorator
+ */
+export type A_TYPES__FeatureDefineDecoratorDescriptor = TypedPropertyDescriptor<() => any> | TypedPropertyDescriptor<(...args: any[]) => any> | TypedPropertyDescriptor<(...args: any[]) => Promise<any>> | TypedPropertyDescriptor<() => Promise<any>>;
+/**
+ * Describes additional configuration properties to be used in Feature Define decorator
+ */
+export type A_TYPES__FeatureDefineDecoratorConfig = {
+    /**
+     * Feature name
+     *
+     * [!] By default uses the method name
+     */
+    name: string;
+    /**
+     * Indicates a default behavior of the feature. If true the feature will be automatically attached to the execution.
+     *
+     * [!] Before feature execution the method itself will be called to prepare the feature template
+     * [!] Default is false
+     */
+    invoke: boolean;
+    /**
+     * Allows to add a default behavior or number of steps that will be part of the feature
+     */
+    template: Array<A_TYPES__FeatureDefineDecoratorTemplateItem>;
+};
+/**
+ * Describes a single template item used in Feature Define decorator
+ */
+export type A_TYPES__FeatureDefineDecoratorTemplateItem = A_TYPES__Required<Partial<A_TYPES__A_StageStep>, ['name', 'handler', 'component']>;
+/**
+ * Describes a target where Feature Define decorator can be applied
+ *
+ * [!] The feature can be defined on Container, Entity, Component or Command
+ */
+export type A_TYPES__FeatureDefineDecoratorTarget = A_Container | A_Entity | A_Component;
+/**
+ * A type of Meta information stored by Feature Define decorator
+ * This information then uses by A-Context to build a proper feature template
+ */
+export type A_TYPES__FeatureDefineDecoratorMeta = {
+    /**
+     * Feature name
+     * mainly it's a unique combination of the class name and method name
+     */
+    name: string;
+    /**
+     * Actual method name in the class
+     */
+    handler: string;
+    /**
+     * Indicates a default behavior of the feature. If true the feature will be automatically attached to the execution.
+     *
+     * [!] Before feature execution the method itself will be called to prepare the feature template
+     * [!] Default is false
+     */
+    invoke: boolean;
+    /**
+     * Allows to add a default behavior or number of steps that will be part of the feature
+     */
+    template: Array<A_TYPES__A_StageStep>;
+};
+/**
+ * Descriptor type for A_Extend decorator
+ */
+export type A_TYPES__FeatureExtendDecoratorDescriptor = TypedPropertyDescriptor<() => any> | TypedPropertyDescriptor<(...args: any[]) => any> | TypedPropertyDescriptor<(...args: any[]) => Promise<any>> | TypedPropertyDescriptor<() => Promise<any>>;
+/**
+ * Target type for A_Extend decorator
+ *
+ * [!] Can be applied only on A-Components
+ */
+export type A_TYPES__FeatureExtendDecoratorTarget = A_Component;
+/**
+ * Meta type for A_Extend decorator
+ */
+export type A_TYPES__FeatureExtendDecoratorMeta = {
+    /**
+     * Original Feature Extension name
+     *
+     * [!] could be string or regex
+     */
+    name: string;
+    /**
+     * Actual method name in the class
+     */
+    handler: string;
+} & A_TYPES__FeatureExtendDecoratorBehaviorConfig;
+/**
+ * Configuration type for A_Extend decorator
+ */
+export type A_TYPES__FeatureExtendDecoratorConfig = {
+    /**
+     * Name of the container Lifecycle method to be extended.
+     *
+     * [!] If not provided will be used the name of the method.
+     * [!!] If name contains "." dot it will be considered as a path to the method.
+     */
+    name: string;
+    /**
+     * Container class or container name uses to identify the proper container in case when the name is not unique.
+     *
+     * [!] If not provided will be applied to all containers with the same name.
+     * [!!] By default uses OR to join all provided items. If you need more complex Logic, please use Regexp instead
+     *
+     * [!!!] In case if you need to exclude some containers, entities or components, please use "exclude" property
+     *
+     * Example:
+     *
+     * ```ts
+     *  @A_Feature.Extend({
+     *      name: 'load',
+     *      scope: {
+     *          include: [A_Container1, A_Entity1],
+     *          exclude: [A_Component1]
+     *      }
+     *  })
+     * ```
+     */
+    scope: Array<A_TYPES__FeatureExtendDecoratorScopeItem> | Partial<A_TYPES__FeatureExtendDecoratorScopeConfig>;
+} & A_TYPES__FeatureExtendDecoratorBehaviorConfig;
+/**
+ * Scope item that can be used in A_Extend decorator configuration
+ */
+export type A_TYPES__FeatureExtendDecoratorScopeConfig = {
+    /**
+     * A list of components, entities or containers to include in the scope of the extension
+     */
+    include?: Array<A_TYPES__FeatureExtendDecoratorScopeItem>;
+    /**
+     * A list of components, entities or containers to exclude from the scope of the extension
+     */
+    exclude?: Array<A_TYPES__FeatureExtendDecoratorScopeItem>;
+};
+/**
+ * A single item that can be used in scope configuration
+ */
+export type A_TYPES__FeatureExtendDecoratorScopeItem = {
+    new (...args: any[]): A_Container;
+} | {
+    new (...args: any[]): A_Entity;
+} | {
+    new (...args: any[]): A_Component;
+};
+/**
+ * Behavior configuration for A_Extend decorator
+ */
+export type A_TYPES__FeatureExtendDecoratorBehaviorConfig = {
+    /**
+     * The behavior of the method.
+     * In case its async it will be executed independently from the main thread.
+     *
+     * [!] However, in case of sync, it will be executed in the main thread.in the order of the declaration.
+     *
+     */
+    behavior: 'async' | 'sync';
+    /**
+     * Allows to define the order of the execution of the method.
+     *
+     * [!] In case the method has circular dependencies it will Throw an error.
+     *
+     */
+    before: string[];
+    /**
+     * Allows to define the order of the execution of the method.
+     *
+     * [!] In case the method has circular dependencies it will Throw an error.
+     *
+     */
+    after: string[];
+};

package/dist/src/global/A-Feature/A-Feature.types.js

@@ -1,32 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.A_TYPES__FeatureState = void 0;
+/**
+ * Feature lifecycle states
+ */
 var A_TYPES__FeatureState;
 (function (A_TYPES__FeatureState) {
+    /**
+     * The feature has been initialized
+     */
     A_TYPES__FeatureState["INITIALIZED"] = "INITIALIZED";
+    /**
+     * The feature is currently being processed
+     */
     A_TYPES__FeatureState["PROCESSING"] = "PROCESSING";
+    /**
+     * The feature has been completed
+     */
     A_TYPES__FeatureState["COMPLETED"] = "COMPLETED";
-    A_TYPES__FeatureState["FAILED"] = "FAILED";
+    /**
+     * The feature has been interrupted
+     */
+    A_TYPES__FeatureState["INTERRUPTED"] = "INTERRUPTED";
 })(A_TYPES__FeatureState || (exports.A_TYPES__FeatureState = A_TYPES__FeatureState = {}));
-// export type A_TYPES__FeatureStep = {
-//     /**
-//      * The component to be called
-//      */
-//     component: typeof A_Component,
-//     /**
-//      * The method to be called on the component
-//      */
-//     handler: string,
-//     /**
-//      * Original Feature Extension name
-//      * 
-//      * [!] could be string or regex
-//      * 
-//      */
-//     name: string,
-//     /**
-//      * Arguments to be passed to the method
-//      */
-//     args: A_TYPES__A_InjectDecorator_Meta
-// }
 //# sourceMappingURL=A-Feature.types.js.map

package/dist/src/global/A-Feature/A-Feature.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"A-Feature.types.js","sourceRoot":"","sources":["../../../../src/global/A-Feature/A-Feature.types.ts"],"names":[],"mappings":";;;AAuCA,IAAY,qBAMX;AAND,WAAY,qBAAqB;IAC7B,oDAA2B,CAAA;IAC3B,kDAAyB,CAAA;IAEzB,gDAAuB,CAAA;IACvB,0CAAiB,CAAA;AACrB,CAAC,EANW,qBAAqB,qCAArB,qBAAqB,QAMhC;AAGD,uCAAuC;AACvC,UAAU;AACV,oCAAoC;AACpC,UAAU;AACV,qCAAqC;AACrC,UAAU;AACV,kDAAkD;AAClD,UAAU;AACV,uBAAuB;AACvB,UAAU;AACV,yCAAyC;AACzC,UAAU;AACV,sCAAsC;AACtC,UAAU;AACV,UAAU;AACV,oBAAoB;AACpB,UAAU;AACV,8CAA8C;AAC9C,UAAU;AACV,4CAA4C;AAC5C,IAAI"}
+{"version":3,"file":"A-Feature.types.js","sourceRoot":"","sources":["../../../../src/global/A-Feature/A-Feature.types.ts"],"names":[],"mappings":";;;AAmEA;;GAEG;AACH,IAAY,qBAiBX;AAjBD,WAAY,qBAAqB;IAC7B;;OAEG;IACH,oDAA2B,CAAA;IAC3B;;OAEG;IACH,kDAAyB,CAAA;IACzB;;OAEG;IACH,gDAAuB,CAAA;IACvB;;OAEG;IACH,oDAA2B,CAAA;AAC/B,CAAC,EAjBW,qBAAqB,qCAArB,qBAAqB,QAiBhC"}

package/dist/src/global/A-Fragment/A-Fragment.class.d.ts

@@ -1,44 +1,36 @@
-import { A_TYPES__FragmentConstructor } from "./A-Fragment.types";
-/**
- * A-Fragment = Context Fragments is a set of arguments that can be used to define a Context for the pipeline.
- * In other words it is a dynamic context that will be created on pipeline start and destroyed on pipeline end.
- * During the execution of the pipeline, the Context Fragments can be used to pass the data between the pipeline steps.
- *
- * Or to store the data that is required for the pipeline execution
- *
- */
-export declare class A_Fragment {
-    name: string;
+import { A_Meta } from "../A-Meta/A-Meta.class";
+import { A_TYPES__Fragment_Init } from "./A-Fragment.types";
+export declare class A_Fragment<_MemoryItems extends Record<string, any> = any> {
     /**
-     * Indicates that Context Fragment is ready to use
+     * Fragment Name
      */
-    ready: Promise<void>;
-    constructor(params?: Partial<A_TYPES__FragmentConstructor>);
-    private hasInherited;
+    name: string;
     /**
-     * Initializes the Namespace or can be used to reinitialize the Namespace
+     * Memory storage for the Fragment instance
      */
-    private init;
+    protected _meta: A_Meta<_MemoryItems>;
     /**
-     *  Before init hook to be used in inherited classes
+     * A-Fragment is a singleton, a piece of execution Context that can be shared between the Components/Entities/Commands
+     * For every A_Scope can be defined only One A_Fragment of the same type.
+     * This class is useful for the design purpose and maintainance of the application
      *
-     * @returns
-     */
-    protected onBeforeInit(): Promise<void>;
-    /**
-     * Main initialization method for the SDK
+     *
+     * [!] Every A_Fragment is a Memory Class that can store data in memory between the steps of the pipeline.
+     * [!] So if it necessary to store some information in the Execution Context - use memory of the Fragment
      */
-    protected onInit(): Promise<void>;
+    constructor(params?: Partial<A_TYPES__Fragment_Init>);
     /**
-     *  After init hook to be used in inherited classes
+     * Returns the Meta object that allows to store data in the Fragment memory
      *
      * @returns
      */
-    protected onAfterInit(): Promise<void>;
+    get memory(): A_Meta<_MemoryItems>;
     /**
      * Returns the JSON representation of the Fragment
      *
      * @returns
      */
-    toJSON(): Record<string, any>;
+    toJSON(): _MemoryItems & {
+        name: string;
+    };
 }

package/dist/src/global/A-Fragment/A-Fragment.class.js

@@ -1,105 +1,34 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.A_Fragment = void 0;
-const A_Context_class_1 = require("../A-Context/A-Context.class");
-/**
- * A-Fragment = Context Fragments is a set of arguments that can be used to define a Context for the pipeline.
- * In other words it is a dynamic context that will be created on pipeline start and destroyed on pipeline end.
- * During the execution of the pipeline, the Context Fragments can be used to pass the data between the pipeline steps.
- *
- * Or to store the data that is required for the pipeline execution
- *
- */
+const A_Meta_class_1 = require("../A-Meta/A-Meta.class");
 class A_Fragment {
+    /**
+     * A-Fragment is a singleton, a piece of execution Context that can be shared between the Components/Entities/Commands
+     * For every A_Scope can be defined only One A_Fragment of the same type.
+     * This class is useful for the design purpose and maintainance of the application
+     *
+     *
+     * [!] Every A_Fragment is a Memory Class that can store data in memory between the steps of the pipeline.
+     * [!] So if it necessary to store some information in the Execution Context - use memory of the Fragment
+     */
     constructor(params = {}) {
-        this.name = params.name || this.constructor.name;
         /**
-         * Register the Namespace in the global Namespace provider
+         * Memory storage for the Fragment instance
          */
-        this.name = params.name || this.constructor.name;
+        this._meta = new A_Meta_class_1.A_Meta();
         /**
-         * Run Async Initialization
+         * Register the Namespace in the global Namespace provider
          */
-        this.init();
-    }
-    hasInherited(cl) {
-        return this.constructor === cl
-            ? false
-            : true;
-    }
-    /**
-     * Initializes the Namespace or can be used to reinitialize the Namespace
-     */
-    init() {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!this.ready)
-                this.ready = new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
-                    try {
-                        yield this.onBeforeInit();
-                        yield this.onInit();
-                        yield this.onAfterInit();
-                        return resolve();
-                    }
-                    catch (error) {
-                        return reject(error);
-                    }
-                }));
-            else
-                yield this.ready;
-        });
-    }
-    // ==============================================================
-    // ======================= HOOKS ================================
-    // ==============================================================
-    /**
-     *  Before init hook to be used in inherited classes
-     *
-     * @returns
-     */
-    onBeforeInit() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return;
-        });
-    }
-    /**
-     * Main initialization method for the SDK
-     */
-    onInit() {
-        return __awaiter(this, void 0, void 0, function* () {
-            // global logger configuration
-            if (A_Context_class_1.A_Context.environment === 'server' && !this.hasInherited(A_Fragment)) {
-                // eslint-disable-next-line no-use-before-define
-                // process.on('uncaughtException', (error) => {
-                //     // log only in case of A_AUTH_Error
-                //     if (error instanceof A_Error)
-                //         this.Logger.error(error);
-                // });
-                // // eslint-disable-next-line no-use-before-define
-                // process.on('unhandledRejection', (error) => {
-                //     if (error instanceof A_Error)
-                //         this.Logger.error(error);
-                // });
-            }
-        });
+        this.name = params.name || this.constructor.name;
     }
     /**
-     *  After init hook to be used in inherited classes
+     * Returns the Meta object that allows to store data in the Fragment memory
      *
      * @returns
      */
-    onAfterInit() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return;
-        });
+    get memory() {
+        return this._meta;
     }
     /**
      * Returns the JSON representation of the Fragment
@@ -107,9 +36,10 @@ class A_Fragment {
      * @returns
      */
     toJSON() {
-        return {
-            name: this.name,
-        };
+        return Object.assign({ name: this.name }, this.memory.toArray().reduce((acc, [key, value]) => {
+            acc[key] = value;
+            return acc;
+        }, {}));
     }
 }
 exports.A_Fragment = A_Fragment;

package/dist/src/global/A-Fragment/A-Fragment.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"A-Fragment.class.js","sourceRoot":"","sources":["../../../../src/global/A-Fragment/A-Fragment.class.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,kEAAyD;AAIzD;;;;;;;GAOG;AACH,MAAa,UAAU;IAWnB,YAAY,SAAgD,EAAE;QAE1D,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAEjD;;WAEG;QACH,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAEjD;;WAEG;QACH,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAKO,YAAY,CAAC,EAA2B;QAC5C,OAAO,IAAI,CAAC,WAAW,KAAK,EAAE;YAC1B,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,CAAA;IACd,CAAC;IAED;;OAEG;IACW,IAAI;;YACd,IAAI,CAAC,IAAI,CAAC,KAAK;gBACX,IAAI,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;oBAC/C,IAAI,CAAC;wBACD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;wBAE1B,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;wBAEpB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;wBAEzB,OAAO,OAAO,EAAE,CAAC;oBACrB,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACb,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;oBACzB,CAAC;gBACL,CAAC,CAAA,CAAC,CAAC;;gBAEH,MAAM,IAAI,CAAC,KAAK,CAAC;QACzB,CAAC;KAAA;IAQD,iEAAiE;IACjE,iEAAiE;IACjE,iEAAiE;IAEjE;;;;OAIG;IACa,YAAY;;YACxB,OAAO;QACX,CAAC;KAAA;IAED;;OAEG;IACa,MAAM;;YAClB,8BAA8B;YAC9B,IAAI,2BAAS,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;gBACvE,gDAAgD;gBAChD,+CAA+C;gBAC/C,0CAA0C;gBAC1C,oCAAoC;gBACpC,oCAAoC;gBACpC,MAAM;gBACN,mDAAmD;gBACnD,gDAAgD;gBAChD,oCAAoC;gBACpC,oCAAoC;gBACpC,MAAM;YACV,CAAC;QACL,CAAC;KAAA;IAED;;;;OAIG;IACa,WAAW;;YACvB,OAAO;QACX,CAAC;KAAA;IAMD;;;;OAIG;IACH,MAAM;QACF,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;SAClB,CAAC;IACN,CAAC;CAEJ;AAxHD,gCAwHC"}
+{"version":3,"file":"A-Fragment.class.js","sourceRoot":"","sources":["../../../../src/global/A-Fragment/A-Fragment.class.ts"],"names":[],"mappings":";;;AAAA,yDAAgD;AAKhD,MAAa,UAAU;IAanB;;;;;;;;OAQG;IACH,YAAY,SAA0C,EAAE;QAfxD;;WAEG;QACO,UAAK,GAAyB,IAAI,qBAAM,EAAgB,CAAC;QAa/D;;WAEG;QACH,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACrD,CAAC;IAED;;;;OAIG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAKD;;;;OAIG;IACH,MAAM;QACF,uBACI,IAAI,EAAE,IAAI,CAAC,IAAI,IACZ,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAClD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACjB,OAAO,GAAG,CAAC;QACf,CAAC,EAAE,EAAkB,CAAC,EACxB;IACN,CAAC;CAEJ;AAxDD,gCAwDC"}

package/dist/src/global/A-Fragment/A-Fragment.types.d.ts

@@ -1,3 +1,21 @@
-export type A_TYPES__FragmentConstructor = {
+import { A_Fragment } from "./A-Fragment.class";
+/**
+ * Fragment constructor type
+ * Uses the generic type T to specify the type of the fragment
+ */
+export type A_TYPES__Fragment_Constructor<T = A_Fragment> = new (...args: any[]) => T;
+/**
+ * Fragment initialization type
+ */
+export type A_TYPES__Fragment_Init = {
     name: string;
 };
+/**
+ * Fragment serialized type
+ */
+export type A_TYPES__Fragment_Serialized = {
+    /**
+     * The ASEID of the fragment
+     */
+    aseid: string;
+};

package/dist/src/global/A-Fragment/A-Fragment.types.js

@@ -1,3 +1,6 @@
 "use strict";
+// ============================================================================
+// --------------------------- Primary Types ----------------------------------
+// ============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=A-Fragment.types.js.map

package/dist/src/global/A-Fragment/A-Fragment.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"A-Fragment.types.js","sourceRoot":"","sources":["../../../../src/global/A-Fragment/A-Fragment.types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"A-Fragment.types.js","sourceRoot":"","sources":["../../../../src/global/A-Fragment/A-Fragment.types.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E"}

package/dist/src/global/A-Inject/A-Inject.decorator.d.ts

@@ -0,0 +1,80 @@
+import { A_TYPES__A_InjectDecorator_EntityInjectionInstructions, A_TYPES__A_InjectDecoratorReturn } from "./A-Inject.types";
+import { A_Component } from "../A-Component/A-Component.class";
+import { A_Fragment } from "../A-Fragment/A-Fragment.class";
+import { A_TYPES__Component_Constructor } from "../A-Component/A-Component.types";
+import { A_Entity } from "../A-Entity/A-Entity.class";
+import { A_TYPES__Feature_Constructor } from "../A-Feature/A-Feature.types";
+import { A_Caller } from "../A-Caller/A_Caller.class";
+import { A_TYPES__Entity_Constructor } from "../A-Entity/A-Entity.types";
+import { A_TYPES__Fragment_Constructor } from "../A-Fragment/A-Fragment.types";
+import { A_Scope } from "../A-Scope/A-Scope.class";
+import { A_TYPES__Scope_Constructor } from "../A-Scope/A-Scope.types";
+import { A_Feature } from "../A-Feature/A-Feature.class";
+/**
+ * A-Inject decorator
+ *
+ * This Decorator allows to inject dependencies into the module like
+ * - Namespaces
+ * - Other Concepts
+ * - or maybe Components
+ *
+ * @param params - see overloads
+ * @returns - decorator function
+ */
+export declare function A_Inject<T extends A_Scope>(
+/***
+ * Provide the Scope constructor that will be associated with the injection.
+ *
+ * [!] It returns an instance of the Scope where the Entity/Component/Container is defined.
+ */
+scope: A_TYPES__Scope_Constructor<T>): A_TYPES__A_InjectDecoratorReturn;
+export declare function A_Inject<T extends A_Feature>(
+/**
+ * Provide the Feature constructor that will be associated with the injection.
+ *
+ * [!] It returns an Instance of the Feature what is executed.
+ */
+feature: A_TYPES__Feature_Constructor<T>): A_TYPES__A_InjectDecoratorReturn;
+export declare function A_Inject<T extends A_Component>(
+/**
+ * Provide the Component constructor that will be associated with the injection.
+ *
+ * [!] It returns an Instance of the Component from current Scope or from Parent Scopes.
+ */
+component: A_TYPES__Component_Constructor<T>): A_TYPES__A_InjectDecoratorReturn;
+export declare function A_Inject(
+/**
+ * Provide the A_Caller constructor to inject the Caller instance
+ *
+ * [!] It returns initiator of the call, e.g. Container/Component/Command who called Feature
+ */
+caller: typeof A_Caller): A_TYPES__A_InjectDecoratorReturn;
+export declare function A_Inject<T extends A_Fragment>(
+/**
+ * Provide the Fragment constructor to inject the Fragment instance
+ *
+ * [!] It returns the Fragment instance from current Scope or from Parent Scopes.
+ */
+fragment: A_TYPES__Fragment_Constructor<T>): A_TYPES__A_InjectDecoratorReturn;
+export declare function A_Inject<T extends A_Entity>(
+/**
+ * Provide the Entity constructor to inject the Entity instance
+ *
+ * [!] Note: It returns the Entity instance from current Scope or from Parent Scopes.
+ * [!] Note: If instance has more than one Entity of the same type It returns FIRST found Entity
+ * [!] Note: Use 'config' to specify to inject specific one or even Array of Entities
+ */
+entity: A_TYPES__Entity_Constructor<T>, 
+/**
+ * Provide additional instructions on how to perform the injection
+ *
+ * [!] Default Pagination is 1 if it's necessary to get multiple Entities please customize it in the instructions
+ */
+config?: Partial<A_TYPES__A_InjectDecorator_EntityInjectionInstructions<T>>): A_TYPES__A_InjectDecoratorReturn<T>;
+export declare function A_Inject<T extends A_Component>(
+/**
+ * Provide the name of Component constructor to inject the Component instance
+ *
+ * [!] You can use both customized one or original depending on your overriding strategy
+ */
+ctor: string): A_TYPES__A_InjectDecoratorReturn;