@adaas/a-concept 0.3.2 → 0.3.4

package/dist/node/index.d.mts

@@ -738,6 +738,12 @@ declare class A_Meta<_StorageItems extends Record<any, any> = any, _SerializedTy
      * @returns
      */
     from(meta: A_Meta<_StorageItems>): A_Meta<_StorageItems>;
+    /**
+     * Allows to create a copy of the meta object with the same values, this is needed to ensure that when we inherit meta from the parent component, we create a copy of it, not a reference to the same object. This allows us to modify the meta of the child component without affecting the meta of the parent component.
+     *
+     * @returns
+     */
+    clone(): A_Meta<_StorageItems>;
     /**
      * Method to set values in the map
      *
@@ -813,7 +819,18 @@ declare class A_Meta<_StorageItems extends Record<any, any> = any, _SerializedTy
      * Method to clear the map
      */
     clear(): void;
+    /**
+     * Method to convert the meta to an array of key-value pairs
+     *
+     * @returns
+     */
     toArray(): Array<[keyof _StorageItems, _StorageItems[keyof _StorageItems]]>;
+    /**
+     * Helper method to recursively convert the meta object to a JSON-compatible format. It handles nested A_Meta instances, Maps, Arrays, and plain objects.
+     *
+     * @param value
+     * @returns
+     */
     protected recursiveToJSON(value: any): any;
     /**
      * Serializes the meta to a JSON object
@@ -839,11 +856,11 @@ declare enum A_TYPES__EntityMetaKey {
     ABSTRACTIONS = "a-component-abstractions",
     INJECTIONS = "a-component-injections"
 }
-declare enum A_TYPES__EntityFeatures {
-    SAVE = "save",
-    DESTROY = "destroy",
-    LOAD = "load"
-}
+declare const A_TYPES__EntityFeatures: {
+    readonly SAVE: "_A_Entity__Save";
+    readonly DESTROY: "_A_Entity__Destroy";
+    readonly LOAD: "_A_Entity__Load";
+};
 
 /**
  * Entity interface
@@ -907,6 +924,7 @@ type A_TYPES__EntityMeta = {
         [Key: string]: A_TYPES__A_InjectDecorator_Meta;
     }>;
 };
+type A_TYPES__EntityFeatureNames = typeof A_TYPES__EntityFeatures[keyof typeof A_TYPES__EntityFeatures];
 
 /**
  * A_Entity is another abstraction that describes all major participants in the system business logic.
@@ -1065,15 +1083,15 @@ declare class A_Entity<_ConstructorType extends A_TYPES__Entity_Init = A_TYPES__
     /**
      * The default method that can be called and extended to load entity data.
      */
-    load(scope?: A_Scope): Promise<any>;
+    load(scope?: A_Scope): Promise<void> | void;
     /**
      * The default method that can be called and extended to destroy entity data.
      */
-    destroy(scope?: A_Scope): Promise<any>;
+    destroy(scope?: A_Scope): Promise<void> | void;
     /**
      * The default method that can be called and extended to save entity data.
      */
-    save(scope?: A_Scope): Promise<any>;
+    save(scope?: A_Scope): Promise<void> | void;
     /**
      * Create a new entity from ASEID string or instance
      * [!] Executed when the constructor is called with a string or ASEID instance that represents the ASEID
@@ -1129,7 +1147,7 @@ declare class A_Entity<_ConstructorType extends A_TYPES__Entity_Init = A_TYPES__
     toString(): string;
 }
 
-declare class A_EntityMeta extends A_Meta<A_TYPES__EntityMeta> {
+declare class A_EntityMeta<T extends A_TYPES__EntityMeta = A_TYPES__EntityMeta> extends A_Meta<T> {
     /**
      * Returns all features defined in the Container
      *
@@ -2844,7 +2862,7 @@ declare class A_Container {
     scope?: A_Scope): Promise<void>;
 }
 
-declare class A_ContainerMeta extends A_Meta<A_TYPES__ContainerMeta> {
+declare class A_ContainerMeta<T extends A_TYPES__ContainerMeta = A_TYPES__ContainerMeta> extends A_Meta<T> {
     /**
      * Allows to get all the injections for a given handler
      *
@@ -3330,7 +3348,27 @@ declare class A_Scope<_MetaItems extends Record<string, any> = any, _ComponentTy
      * Provide the fragment name in PascalCase to retrieve its constructor
      */
     name: string): A_TYPES__Fragment_Constructor<T>;
-    resolveConstructor<T extends A_TYPES__A_DependencyInjectable>(name: string): A_TYPES__Entity_Constructor<T> | A_TYPES__Component_Constructor<T> | A_TYPES__Fragment_Constructor<T> | undefined;
+    resolveConstructor<T extends A_Component>(
+    /**
+     * Provide the component constructor or its name to retrieve its constructor
+     */
+    component: A_TYPES__Ctor<T>): A_TYPES__Component_Constructor<T> | undefined;
+    resolveConstructor<T extends A_Entity>(
+    /**
+     * Provide the entity constructor or its name to retrieve its constructor
+     */
+    entity: A_TYPES__Ctor<T>): A_TYPES__Entity_Constructor<T> | undefined;
+    resolveConstructor<T extends A_Fragment>(
+    /**
+     * Provide the fragment constructor or its name to retrieve its constructor
+     */
+    fragment: A_TYPES__Ctor<T>): A_TYPES__Fragment_Constructor<T> | undefined;
+    resolveConstructor<T extends A_Error>(
+    /**
+     * Provide the error constructor or its name to retrieve its constructor
+     */
+    error: A_TYPES__Ctor<T>): A_TYPES__Error_Constructor<T> | undefined;
+    resolveConstructor<T extends A_TYPES__A_DependencyInjectable>(name: string | A_TYPES__Ctor<T>): A_TYPES__Entity_Constructor<T> | A_TYPES__Component_Constructor<T> | A_TYPES__Fragment_Constructor<T> | undefined;
     /**
      * This method should resolve all instances of the components, or entities within the scope, by provided parent class
      * So in case of providing a base class it should return all instances that extends this base class
@@ -3692,6 +3730,11 @@ declare class A_Scope<_MetaItems extends Record<string, any> = any, _ComponentTy
      * Provide an entity instance to deregister it in the scope
      */
     entity: A_Entity): void;
+    deregister<T extends A_TYPES__A_DependencyInjectable>(
+    /**
+     * Provide an entity instance to register it in the scope
+     */
+    component: T): void;
     /**
      * This method is useful when you want to serialize the scope to JSON
      *
@@ -4200,17 +4243,17 @@ declare class A_Context {
      * Get meta for the specific entity class by constructor.
      */
     entity: A_TYPES__Entity_Constructor): T;
-    static meta<T extends A_EntityMeta>(
+    static meta<T extends A_EntityMeta, E extends A_Entity>(
     /**
      * Get meta for the specific entity instance.
      */
-    entity: A_Entity): T;
+    entity: E): T;
     static meta<T extends A_ComponentMeta>(
     /**
      * Get meta for the specific component class by constructor.
      */
     component: A_TYPES__Component_Constructor): T;
-    static meta<T extends A_ComponentMeta, S extends A_Component>(
+    static meta<T extends A_ComponentMeta<any>, S extends A_Component>(
     /**
      * Get meta for the specific component instance.
      */
@@ -4990,4 +5033,4 @@ declare const A_CONSTANTS__DEFAULT_ENV_VARIABLES: {
 type A_TYPES__ConceptENVVariables = (typeof A_CONSTANTS__DEFAULT_ENV_VARIABLES)[keyof typeof A_CONSTANTS__DEFAULT_ENV_VARIABLES][];
 declare const A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY: readonly ["A_CONCEPT_NAME", "A_CONCEPT_ROOT_SCOPE", "A_CONCEPT_ENVIRONMENT", "A_CONCEPT_RUNTIME_ENVIRONMENT", "A_CONCEPT_ROOT_FOLDER", "A_ERROR_DEFAULT_DESCRIPTION"];
 
-export { ASEID, A_Abstraction, A_AbstractionError, A_Abstraction_Extend, A_BasicTypeGuards, A_CONCEPT_ENV, A_CONSTANTS__DEFAULT_ENV_VARIABLES, A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY, A_CONSTANTS__ERROR_CODES, A_CONSTANTS__ERROR_DESCRIPTION, A_Caller, A_CallerError, A_CommonHelper, A_Component, A_ComponentMeta, A_Concept, A_ConceptMeta, A_Container, A_ContainerMeta, A_Context, A_ContextError, A_Dependency, A_DependencyError, A_Dependency_All, A_Dependency_Default, A_Dependency_Flat, A_Dependency_Load, A_Dependency_Parent, A_Dependency_Query, A_Dependency_Require, A_Entity, A_EntityError, A_EntityMeta, A_Error, A_Feature, A_FeatureError, A_Feature_Define, A_Feature_Extend, A_FormatterHelper, A_Fragment, type A_ID_TYPES__TimeId_Parts, A_IdentityHelper, A_Inject, A_InjectError, A_Meta, A_MetaDecorator, A_Scope, A_ScopeError, A_Stage, A_StageError, A_StepManagerError, A_StepsManager, type A_TYPES_ScopeDependentComponents, type A_TYPES_ScopeIndependentComponents, type A_TYPES_StageExecutionBehavior, type A_TYPES__ASEID_Constructor, type A_TYPES__ASEID_ConstructorConfig, type A_TYPES__ASEID_JSON, type A_TYPES__A_DependencyConstructor, type A_TYPES__A_DependencyInjectable, type A_TYPES__A_DependencyResolutionStrategy, type A_TYPES__A_DependencyResolutionType, type A_TYPES__A_Dependency_AllDecoratorReturn, type A_TYPES__A_Dependency_DefaultDecoratorReturn, type A_TYPES__A_Dependency_EntityInjectionPagination, type A_TYPES__A_Dependency_EntityInjectionQuery, type A_TYPES__A_Dependency_EntityResolutionConfig, type A_TYPES__A_Dependency_FlatDecoratorReturn, type A_TYPES__A_Dependency_LoadDecoratorReturn, type A_TYPES__A_Dependency_ParentDecoratorReturn, type A_TYPES__A_Dependency_QueryDecoratorReturn, type A_TYPES__A_Dependency_QueryTarget, type A_TYPES__A_Dependency_RequireDecoratorReturn, type A_TYPES__A_Dependency_Serialized, type A_TYPES__A_InjectDecoratorDescriptor, type A_TYPES__A_InjectDecoratorReturn, type A_TYPES__A_InjectDecorator_Meta, type A_TYPES__A_StageStep, type A_TYPES__A_StageStepProcessingExtraParams, A_TYPES__A_Stage_Status, type A_TYPES__AbstractionAvailableComponents, type A_TYPES__AbstractionDecoratorConfig, type A_TYPES__AbstractionDecoratorDescriptor, type A_TYPES__Abstraction_Constructor, type A_TYPES__Abstraction_Init, type A_TYPES__Abstraction_Serialized, type A_TYPES__CallerComponent, type A_TYPES__Caller_Constructor, type A_TYPES__Caller_Init, type A_TYPES__Caller_Serialized, type A_TYPES__ComponentMeta, type A_TYPES__ComponentMetaExtension, A_TYPES__ComponentMetaKey, type A_TYPES__Component_Constructor, type A_TYPES__Component_Init, type A_TYPES__Component_Serialized, type A_TYPES__ConceptAbstraction, type A_TYPES__ConceptAbstractionMeta, A_TYPES__ConceptAbstractions, type A_TYPES__ConceptENVVariables, A_TYPES__ConceptMetaKey, type A_TYPES__Concept_Constructor, type A_TYPES__Concept_Init, type A_TYPES__Concept_Serialized, type A_TYPES__ContainerMeta, type A_TYPES__ContainerMetaExtension, A_TYPES__ContainerMetaKey, type A_TYPES__Container_Constructor, type A_TYPES__Container_Init, type A_TYPES__Container_Serialized, type A_TYPES__ContextEnvironment, type A_TYPES__Ctor, type A_TYPES__DeepPartial, type A_TYPES__Dictionary, A_TYPES__EntityFeatures, type A_TYPES__EntityMeta, A_TYPES__EntityMetaKey, type A_TYPES__Entity_Constructor, type A_TYPES__Entity_Init, type A_TYPES__Entity_Serialized, type A_TYPES__Error_Constructor, type A_TYPES__Error_Init, type A_TYPES__Error_Serialized, type A_TYPES__ExtractNested, type A_TYPES__ExtractProperties, type A_TYPES__FeatureAvailableComponents, type A_TYPES__FeatureAvailableConstructors, type A_TYPES__FeatureDefineDecoratorConfig, type A_TYPES__FeatureDefineDecoratorDescriptor, type A_TYPES__FeatureDefineDecoratorMeta, type A_TYPES__FeatureDefineDecoratorTarget, type A_TYPES__FeatureDefineDecoratorTemplateItem, type A_TYPES__FeatureError_Init, type A_TYPES__FeatureExtendDecoratorConfig, type A_TYPES__FeatureExtendDecoratorDescriptor, type A_TYPES__FeatureExtendDecoratorMeta, type A_TYPES__FeatureExtendDecoratorScopeConfig, type A_TYPES__FeatureExtendDecoratorScopeItem, type A_TYPES__FeatureExtendDecoratorTarget, type A_TYPES__FeatureExtendableMeta, A_TYPES__FeatureState, type A_TYPES__Feature_Constructor, type A_TYPES__Feature_Init, type A_TYPES__Feature_InitWithComponent, type A_TYPES__Feature_InitWithTemplate, type A_TYPES__Feature_Serialized, type A_TYPES__Fragment_Constructor, type A_TYPES__Fragment_Init, type A_TYPES__Fragment_Serialized, type A_TYPES__IEntity, type A_TYPES__InjectableTargets, type A_TYPES__MetaLinkedComponentConstructors, type A_TYPES__MetaLinkedComponents, type A_TYPES__Meta_Constructor, type A_TYPES__NonObjectPaths, type A_TYPES__ObjectKeyEnum, type A_TYPES__Paths, type A_TYPES__PathsToObject, type A_TYPES__Required, type A_TYPES__ScopeConfig, type A_TYPES__ScopeLinkedComponents, type A_TYPES__ScopeLinkedConstructors, type A_TYPES__Scope_Constructor, type A_TYPES__Scope_Init, type A_TYPES__Scope_Serialized, type A_TYPES__Stage_Serialized, type A_TYPES__UnionToIntersection, A_TypeGuards };
+export { ASEID, A_Abstraction, A_AbstractionError, A_Abstraction_Extend, A_BasicTypeGuards, A_CONCEPT_ENV, A_CONSTANTS__DEFAULT_ENV_VARIABLES, A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY, A_CONSTANTS__ERROR_CODES, A_CONSTANTS__ERROR_DESCRIPTION, A_Caller, A_CallerError, A_CommonHelper, A_Component, A_ComponentMeta, A_Concept, A_ConceptMeta, A_Container, A_ContainerMeta, A_Context, A_ContextError, A_Dependency, A_DependencyError, A_Dependency_All, A_Dependency_Default, A_Dependency_Flat, A_Dependency_Load, A_Dependency_Parent, A_Dependency_Query, A_Dependency_Require, A_Entity, A_EntityError, A_EntityMeta, A_Error, A_Feature, A_FeatureError, A_Feature_Define, A_Feature_Extend, A_FormatterHelper, A_Fragment, type A_ID_TYPES__TimeId_Parts, A_IdentityHelper, A_Inject, A_InjectError, A_Meta, A_MetaDecorator, A_Scope, A_ScopeError, A_Stage, A_StageError, A_StepManagerError, A_StepsManager, type A_TYPES_ScopeDependentComponents, type A_TYPES_ScopeIndependentComponents, type A_TYPES_StageExecutionBehavior, type A_TYPES__ASEID_Constructor, type A_TYPES__ASEID_ConstructorConfig, type A_TYPES__ASEID_JSON, type A_TYPES__A_DependencyConstructor, type A_TYPES__A_DependencyInjectable, type A_TYPES__A_DependencyResolutionStrategy, type A_TYPES__A_DependencyResolutionType, type A_TYPES__A_Dependency_AllDecoratorReturn, type A_TYPES__A_Dependency_DefaultDecoratorReturn, type A_TYPES__A_Dependency_EntityInjectionPagination, type A_TYPES__A_Dependency_EntityInjectionQuery, type A_TYPES__A_Dependency_EntityResolutionConfig, type A_TYPES__A_Dependency_FlatDecoratorReturn, type A_TYPES__A_Dependency_LoadDecoratorReturn, type A_TYPES__A_Dependency_ParentDecoratorReturn, type A_TYPES__A_Dependency_QueryDecoratorReturn, type A_TYPES__A_Dependency_QueryTarget, type A_TYPES__A_Dependency_RequireDecoratorReturn, type A_TYPES__A_Dependency_Serialized, type A_TYPES__A_InjectDecoratorDescriptor, type A_TYPES__A_InjectDecoratorReturn, type A_TYPES__A_InjectDecorator_Meta, type A_TYPES__A_StageStep, type A_TYPES__A_StageStepProcessingExtraParams, A_TYPES__A_Stage_Status, type A_TYPES__AbstractionAvailableComponents, type A_TYPES__AbstractionDecoratorConfig, type A_TYPES__AbstractionDecoratorDescriptor, type A_TYPES__Abstraction_Constructor, type A_TYPES__Abstraction_Init, type A_TYPES__Abstraction_Serialized, type A_TYPES__CallerComponent, type A_TYPES__Caller_Constructor, type A_TYPES__Caller_Init, type A_TYPES__Caller_Serialized, type A_TYPES__ComponentMeta, type A_TYPES__ComponentMetaExtension, A_TYPES__ComponentMetaKey, type A_TYPES__Component_Constructor, type A_TYPES__Component_Init, type A_TYPES__Component_Serialized, type A_TYPES__ConceptAbstraction, type A_TYPES__ConceptAbstractionMeta, A_TYPES__ConceptAbstractions, type A_TYPES__ConceptENVVariables, A_TYPES__ConceptMetaKey, type A_TYPES__Concept_Constructor, type A_TYPES__Concept_Init, type A_TYPES__Concept_Serialized, type A_TYPES__ContainerMeta, type A_TYPES__ContainerMetaExtension, A_TYPES__ContainerMetaKey, type A_TYPES__Container_Constructor, type A_TYPES__Container_Init, type A_TYPES__Container_Serialized, type A_TYPES__ContextEnvironment, type A_TYPES__Ctor, type A_TYPES__DeepPartial, type A_TYPES__Dictionary, type A_TYPES__EntityFeatureNames, A_TYPES__EntityFeatures, type A_TYPES__EntityMeta, A_TYPES__EntityMetaKey, type A_TYPES__Entity_Constructor, type A_TYPES__Entity_Init, type A_TYPES__Entity_Serialized, type A_TYPES__Error_Constructor, type A_TYPES__Error_Init, type A_TYPES__Error_Serialized, type A_TYPES__ExtractNested, type A_TYPES__ExtractProperties, type A_TYPES__FeatureAvailableComponents, type A_TYPES__FeatureAvailableConstructors, type A_TYPES__FeatureDefineDecoratorConfig, type A_TYPES__FeatureDefineDecoratorDescriptor, type A_TYPES__FeatureDefineDecoratorMeta, type A_TYPES__FeatureDefineDecoratorTarget, type A_TYPES__FeatureDefineDecoratorTemplateItem, type A_TYPES__FeatureError_Init, type A_TYPES__FeatureExtendDecoratorConfig, type A_TYPES__FeatureExtendDecoratorDescriptor, type A_TYPES__FeatureExtendDecoratorMeta, type A_TYPES__FeatureExtendDecoratorScopeConfig, type A_TYPES__FeatureExtendDecoratorScopeItem, type A_TYPES__FeatureExtendDecoratorTarget, type A_TYPES__FeatureExtendableMeta, A_TYPES__FeatureState, type A_TYPES__Feature_Constructor, type A_TYPES__Feature_Init, type A_TYPES__Feature_InitWithComponent, type A_TYPES__Feature_InitWithTemplate, type A_TYPES__Feature_Serialized, type A_TYPES__Fragment_Constructor, type A_TYPES__Fragment_Init, type A_TYPES__Fragment_Serialized, type A_TYPES__IEntity, type A_TYPES__InjectableTargets, type A_TYPES__MetaLinkedComponentConstructors, type A_TYPES__MetaLinkedComponents, type A_TYPES__Meta_Constructor, type A_TYPES__NonObjectPaths, type A_TYPES__ObjectKeyEnum, type A_TYPES__Paths, type A_TYPES__PathsToObject, type A_TYPES__Required, type A_TYPES__ScopeConfig, type A_TYPES__ScopeLinkedComponents, type A_TYPES__ScopeLinkedConstructors, type A_TYPES__Scope_Constructor, type A_TYPES__Scope_Init, type A_TYPES__Scope_Serialized, type A_TYPES__Stage_Serialized, type A_TYPES__UnionToIntersection, A_TypeGuards };

package/dist/node/index.d.ts

@@ -738,6 +738,12 @@ declare class A_Meta<_StorageItems extends Record<any, any> = any, _SerializedTy
      * @returns
      */
     from(meta: A_Meta<_StorageItems>): A_Meta<_StorageItems>;
+    /**
+     * Allows to create a copy of the meta object with the same values, this is needed to ensure that when we inherit meta from the parent component, we create a copy of it, not a reference to the same object. This allows us to modify the meta of the child component without affecting the meta of the parent component.
+     *
+     * @returns
+     */
+    clone(): A_Meta<_StorageItems>;
     /**
      * Method to set values in the map
      *
@@ -813,7 +819,18 @@ declare class A_Meta<_StorageItems extends Record<any, any> = any, _SerializedTy
      * Method to clear the map
      */
     clear(): void;
+    /**
+     * Method to convert the meta to an array of key-value pairs
+     *
+     * @returns
+     */
     toArray(): Array<[keyof _StorageItems, _StorageItems[keyof _StorageItems]]>;
+    /**
+     * Helper method to recursively convert the meta object to a JSON-compatible format. It handles nested A_Meta instances, Maps, Arrays, and plain objects.
+     *
+     * @param value
+     * @returns
+     */
     protected recursiveToJSON(value: any): any;
     /**
      * Serializes the meta to a JSON object
@@ -839,11 +856,11 @@ declare enum A_TYPES__EntityMetaKey {
     ABSTRACTIONS = "a-component-abstractions",
     INJECTIONS = "a-component-injections"
 }
-declare enum A_TYPES__EntityFeatures {
-    SAVE = "save",
-    DESTROY = "destroy",
-    LOAD = "load"
-}
+declare const A_TYPES__EntityFeatures: {
+    readonly SAVE: "_A_Entity__Save";
+    readonly DESTROY: "_A_Entity__Destroy";
+    readonly LOAD: "_A_Entity__Load";
+};
 
 /**
  * Entity interface
@@ -907,6 +924,7 @@ type A_TYPES__EntityMeta = {
         [Key: string]: A_TYPES__A_InjectDecorator_Meta;
     }>;
 };
+type A_TYPES__EntityFeatureNames = typeof A_TYPES__EntityFeatures[keyof typeof A_TYPES__EntityFeatures];
 
 /**
  * A_Entity is another abstraction that describes all major participants in the system business logic.
@@ -1065,15 +1083,15 @@ declare class A_Entity<_ConstructorType extends A_TYPES__Entity_Init = A_TYPES__
     /**
      * The default method that can be called and extended to load entity data.
      */
-    load(scope?: A_Scope): Promise<any>;
+    load(scope?: A_Scope): Promise<void> | void;
     /**
      * The default method that can be called and extended to destroy entity data.
      */
-    destroy(scope?: A_Scope): Promise<any>;
+    destroy(scope?: A_Scope): Promise<void> | void;
     /**
      * The default method that can be called and extended to save entity data.
      */
-    save(scope?: A_Scope): Promise<any>;
+    save(scope?: A_Scope): Promise<void> | void;
     /**
      * Create a new entity from ASEID string or instance
      * [!] Executed when the constructor is called with a string or ASEID instance that represents the ASEID
@@ -1129,7 +1147,7 @@ declare class A_Entity<_ConstructorType extends A_TYPES__Entity_Init = A_TYPES__
     toString(): string;
 }
 
-declare class A_EntityMeta extends A_Meta<A_TYPES__EntityMeta> {
+declare class A_EntityMeta<T extends A_TYPES__EntityMeta = A_TYPES__EntityMeta> extends A_Meta<T> {
     /**
      * Returns all features defined in the Container
      *
@@ -2844,7 +2862,7 @@ declare class A_Container {
     scope?: A_Scope): Promise<void>;
 }
 
-declare class A_ContainerMeta extends A_Meta<A_TYPES__ContainerMeta> {
+declare class A_ContainerMeta<T extends A_TYPES__ContainerMeta = A_TYPES__ContainerMeta> extends A_Meta<T> {
     /**
      * Allows to get all the injections for a given handler
      *
@@ -3330,7 +3348,27 @@ declare class A_Scope<_MetaItems extends Record<string, any> = any, _ComponentTy
      * Provide the fragment name in PascalCase to retrieve its constructor
      */
     name: string): A_TYPES__Fragment_Constructor<T>;
-    resolveConstructor<T extends A_TYPES__A_DependencyInjectable>(name: string): A_TYPES__Entity_Constructor<T> | A_TYPES__Component_Constructor<T> | A_TYPES__Fragment_Constructor<T> | undefined;
+    resolveConstructor<T extends A_Component>(
+    /**
+     * Provide the component constructor or its name to retrieve its constructor
+     */
+    component: A_TYPES__Ctor<T>): A_TYPES__Component_Constructor<T> | undefined;
+    resolveConstructor<T extends A_Entity>(
+    /**
+     * Provide the entity constructor or its name to retrieve its constructor
+     */
+    entity: A_TYPES__Ctor<T>): A_TYPES__Entity_Constructor<T> | undefined;
+    resolveConstructor<T extends A_Fragment>(
+    /**
+     * Provide the fragment constructor or its name to retrieve its constructor
+     */
+    fragment: A_TYPES__Ctor<T>): A_TYPES__Fragment_Constructor<T> | undefined;
+    resolveConstructor<T extends A_Error>(
+    /**
+     * Provide the error constructor or its name to retrieve its constructor
+     */
+    error: A_TYPES__Ctor<T>): A_TYPES__Error_Constructor<T> | undefined;
+    resolveConstructor<T extends A_TYPES__A_DependencyInjectable>(name: string | A_TYPES__Ctor<T>): A_TYPES__Entity_Constructor<T> | A_TYPES__Component_Constructor<T> | A_TYPES__Fragment_Constructor<T> | undefined;
     /**
      * This method should resolve all instances of the components, or entities within the scope, by provided parent class
      * So in case of providing a base class it should return all instances that extends this base class
@@ -3692,6 +3730,11 @@ declare class A_Scope<_MetaItems extends Record<string, any> = any, _ComponentTy
      * Provide an entity instance to deregister it in the scope
      */
     entity: A_Entity): void;
+    deregister<T extends A_TYPES__A_DependencyInjectable>(
+    /**
+     * Provide an entity instance to register it in the scope
+     */
+    component: T): void;
     /**
      * This method is useful when you want to serialize the scope to JSON
      *
@@ -4200,17 +4243,17 @@ declare class A_Context {
      * Get meta for the specific entity class by constructor.
      */
     entity: A_TYPES__Entity_Constructor): T;
-    static meta<T extends A_EntityMeta>(
+    static meta<T extends A_EntityMeta, E extends A_Entity>(
     /**
      * Get meta for the specific entity instance.
      */
-    entity: A_Entity): T;
+    entity: E): T;
     static meta<T extends A_ComponentMeta>(
     /**
      * Get meta for the specific component class by constructor.
      */
     component: A_TYPES__Component_Constructor): T;
-    static meta<T extends A_ComponentMeta, S extends A_Component>(
+    static meta<T extends A_ComponentMeta<any>, S extends A_Component>(
     /**
      * Get meta for the specific component instance.
      */
@@ -4990,4 +5033,4 @@ declare const A_CONSTANTS__DEFAULT_ENV_VARIABLES: {
 type A_TYPES__ConceptENVVariables = (typeof A_CONSTANTS__DEFAULT_ENV_VARIABLES)[keyof typeof A_CONSTANTS__DEFAULT_ENV_VARIABLES][];
 declare const A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY: readonly ["A_CONCEPT_NAME", "A_CONCEPT_ROOT_SCOPE", "A_CONCEPT_ENVIRONMENT", "A_CONCEPT_RUNTIME_ENVIRONMENT", "A_CONCEPT_ROOT_FOLDER", "A_ERROR_DEFAULT_DESCRIPTION"];
 
-export { ASEID, A_Abstraction, A_AbstractionError, A_Abstraction_Extend, A_BasicTypeGuards, A_CONCEPT_ENV, A_CONSTANTS__DEFAULT_ENV_VARIABLES, A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY, A_CONSTANTS__ERROR_CODES, A_CONSTANTS__ERROR_DESCRIPTION, A_Caller, A_CallerError, A_CommonHelper, A_Component, A_ComponentMeta, A_Concept, A_ConceptMeta, A_Container, A_ContainerMeta, A_Context, A_ContextError, A_Dependency, A_DependencyError, A_Dependency_All, A_Dependency_Default, A_Dependency_Flat, A_Dependency_Load, A_Dependency_Parent, A_Dependency_Query, A_Dependency_Require, A_Entity, A_EntityError, A_EntityMeta, A_Error, A_Feature, A_FeatureError, A_Feature_Define, A_Feature_Extend, A_FormatterHelper, A_Fragment, type A_ID_TYPES__TimeId_Parts, A_IdentityHelper, A_Inject, A_InjectError, A_Meta, A_MetaDecorator, A_Scope, A_ScopeError, A_Stage, A_StageError, A_StepManagerError, A_StepsManager, type A_TYPES_ScopeDependentComponents, type A_TYPES_ScopeIndependentComponents, type A_TYPES_StageExecutionBehavior, type A_TYPES__ASEID_Constructor, type A_TYPES__ASEID_ConstructorConfig, type A_TYPES__ASEID_JSON, type A_TYPES__A_DependencyConstructor, type A_TYPES__A_DependencyInjectable, type A_TYPES__A_DependencyResolutionStrategy, type A_TYPES__A_DependencyResolutionType, type A_TYPES__A_Dependency_AllDecoratorReturn, type A_TYPES__A_Dependency_DefaultDecoratorReturn, type A_TYPES__A_Dependency_EntityInjectionPagination, type A_TYPES__A_Dependency_EntityInjectionQuery, type A_TYPES__A_Dependency_EntityResolutionConfig, type A_TYPES__A_Dependency_FlatDecoratorReturn, type A_TYPES__A_Dependency_LoadDecoratorReturn, type A_TYPES__A_Dependency_ParentDecoratorReturn, type A_TYPES__A_Dependency_QueryDecoratorReturn, type A_TYPES__A_Dependency_QueryTarget, type A_TYPES__A_Dependency_RequireDecoratorReturn, type A_TYPES__A_Dependency_Serialized, type A_TYPES__A_InjectDecoratorDescriptor, type A_TYPES__A_InjectDecoratorReturn, type A_TYPES__A_InjectDecorator_Meta, type A_TYPES__A_StageStep, type A_TYPES__A_StageStepProcessingExtraParams, A_TYPES__A_Stage_Status, type A_TYPES__AbstractionAvailableComponents, type A_TYPES__AbstractionDecoratorConfig, type A_TYPES__AbstractionDecoratorDescriptor, type A_TYPES__Abstraction_Constructor, type A_TYPES__Abstraction_Init, type A_TYPES__Abstraction_Serialized, type A_TYPES__CallerComponent, type A_TYPES__Caller_Constructor, type A_TYPES__Caller_Init, type A_TYPES__Caller_Serialized, type A_TYPES__ComponentMeta, type A_TYPES__ComponentMetaExtension, A_TYPES__ComponentMetaKey, type A_TYPES__Component_Constructor, type A_TYPES__Component_Init, type A_TYPES__Component_Serialized, type A_TYPES__ConceptAbstraction, type A_TYPES__ConceptAbstractionMeta, A_TYPES__ConceptAbstractions, type A_TYPES__ConceptENVVariables, A_TYPES__ConceptMetaKey, type A_TYPES__Concept_Constructor, type A_TYPES__Concept_Init, type A_TYPES__Concept_Serialized, type A_TYPES__ContainerMeta, type A_TYPES__ContainerMetaExtension, A_TYPES__ContainerMetaKey, type A_TYPES__Container_Constructor, type A_TYPES__Container_Init, type A_TYPES__Container_Serialized, type A_TYPES__ContextEnvironment, type A_TYPES__Ctor, type A_TYPES__DeepPartial, type A_TYPES__Dictionary, A_TYPES__EntityFeatures, type A_TYPES__EntityMeta, A_TYPES__EntityMetaKey, type A_TYPES__Entity_Constructor, type A_TYPES__Entity_Init, type A_TYPES__Entity_Serialized, type A_TYPES__Error_Constructor, type A_TYPES__Error_Init, type A_TYPES__Error_Serialized, type A_TYPES__ExtractNested, type A_TYPES__ExtractProperties, type A_TYPES__FeatureAvailableComponents, type A_TYPES__FeatureAvailableConstructors, type A_TYPES__FeatureDefineDecoratorConfig, type A_TYPES__FeatureDefineDecoratorDescriptor, type A_TYPES__FeatureDefineDecoratorMeta, type A_TYPES__FeatureDefineDecoratorTarget, type A_TYPES__FeatureDefineDecoratorTemplateItem, type A_TYPES__FeatureError_Init, type A_TYPES__FeatureExtendDecoratorConfig, type A_TYPES__FeatureExtendDecoratorDescriptor, type A_TYPES__FeatureExtendDecoratorMeta, type A_TYPES__FeatureExtendDecoratorScopeConfig, type A_TYPES__FeatureExtendDecoratorScopeItem, type A_TYPES__FeatureExtendDecoratorTarget, type A_TYPES__FeatureExtendableMeta, A_TYPES__FeatureState, type A_TYPES__Feature_Constructor, type A_TYPES__Feature_Init, type A_TYPES__Feature_InitWithComponent, type A_TYPES__Feature_InitWithTemplate, type A_TYPES__Feature_Serialized, type A_TYPES__Fragment_Constructor, type A_TYPES__Fragment_Init, type A_TYPES__Fragment_Serialized, type A_TYPES__IEntity, type A_TYPES__InjectableTargets, type A_TYPES__MetaLinkedComponentConstructors, type A_TYPES__MetaLinkedComponents, type A_TYPES__Meta_Constructor, type A_TYPES__NonObjectPaths, type A_TYPES__ObjectKeyEnum, type A_TYPES__Paths, type A_TYPES__PathsToObject, type A_TYPES__Required, type A_TYPES__ScopeConfig, type A_TYPES__ScopeLinkedComponents, type A_TYPES__ScopeLinkedConstructors, type A_TYPES__Scope_Constructor, type A_TYPES__Scope_Init, type A_TYPES__Scope_Serialized, type A_TYPES__Stage_Serialized, type A_TYPES__UnionToIntersection, A_TypeGuards };
+export { ASEID, A_Abstraction, A_AbstractionError, A_Abstraction_Extend, A_BasicTypeGuards, A_CONCEPT_ENV, A_CONSTANTS__DEFAULT_ENV_VARIABLES, A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY, A_CONSTANTS__ERROR_CODES, A_CONSTANTS__ERROR_DESCRIPTION, A_Caller, A_CallerError, A_CommonHelper, A_Component, A_ComponentMeta, A_Concept, A_ConceptMeta, A_Container, A_ContainerMeta, A_Context, A_ContextError, A_Dependency, A_DependencyError, A_Dependency_All, A_Dependency_Default, A_Dependency_Flat, A_Dependency_Load, A_Dependency_Parent, A_Dependency_Query, A_Dependency_Require, A_Entity, A_EntityError, A_EntityMeta, A_Error, A_Feature, A_FeatureError, A_Feature_Define, A_Feature_Extend, A_FormatterHelper, A_Fragment, type A_ID_TYPES__TimeId_Parts, A_IdentityHelper, A_Inject, A_InjectError, A_Meta, A_MetaDecorator, A_Scope, A_ScopeError, A_Stage, A_StageError, A_StepManagerError, A_StepsManager, type A_TYPES_ScopeDependentComponents, type A_TYPES_ScopeIndependentComponents, type A_TYPES_StageExecutionBehavior, type A_TYPES__ASEID_Constructor, type A_TYPES__ASEID_ConstructorConfig, type A_TYPES__ASEID_JSON, type A_TYPES__A_DependencyConstructor, type A_TYPES__A_DependencyInjectable, type A_TYPES__A_DependencyResolutionStrategy, type A_TYPES__A_DependencyResolutionType, type A_TYPES__A_Dependency_AllDecoratorReturn, type A_TYPES__A_Dependency_DefaultDecoratorReturn, type A_TYPES__A_Dependency_EntityInjectionPagination, type A_TYPES__A_Dependency_EntityInjectionQuery, type A_TYPES__A_Dependency_EntityResolutionConfig, type A_TYPES__A_Dependency_FlatDecoratorReturn, type A_TYPES__A_Dependency_LoadDecoratorReturn, type A_TYPES__A_Dependency_ParentDecoratorReturn, type A_TYPES__A_Dependency_QueryDecoratorReturn, type A_TYPES__A_Dependency_QueryTarget, type A_TYPES__A_Dependency_RequireDecoratorReturn, type A_TYPES__A_Dependency_Serialized, type A_TYPES__A_InjectDecoratorDescriptor, type A_TYPES__A_InjectDecoratorReturn, type A_TYPES__A_InjectDecorator_Meta, type A_TYPES__A_StageStep, type A_TYPES__A_StageStepProcessingExtraParams, A_TYPES__A_Stage_Status, type A_TYPES__AbstractionAvailableComponents, type A_TYPES__AbstractionDecoratorConfig, type A_TYPES__AbstractionDecoratorDescriptor, type A_TYPES__Abstraction_Constructor, type A_TYPES__Abstraction_Init, type A_TYPES__Abstraction_Serialized, type A_TYPES__CallerComponent, type A_TYPES__Caller_Constructor, type A_TYPES__Caller_Init, type A_TYPES__Caller_Serialized, type A_TYPES__ComponentMeta, type A_TYPES__ComponentMetaExtension, A_TYPES__ComponentMetaKey, type A_TYPES__Component_Constructor, type A_TYPES__Component_Init, type A_TYPES__Component_Serialized, type A_TYPES__ConceptAbstraction, type A_TYPES__ConceptAbstractionMeta, A_TYPES__ConceptAbstractions, type A_TYPES__ConceptENVVariables, A_TYPES__ConceptMetaKey, type A_TYPES__Concept_Constructor, type A_TYPES__Concept_Init, type A_TYPES__Concept_Serialized, type A_TYPES__ContainerMeta, type A_TYPES__ContainerMetaExtension, A_TYPES__ContainerMetaKey, type A_TYPES__Container_Constructor, type A_TYPES__Container_Init, type A_TYPES__Container_Serialized, type A_TYPES__ContextEnvironment, type A_TYPES__Ctor, type A_TYPES__DeepPartial, type A_TYPES__Dictionary, type A_TYPES__EntityFeatureNames, A_TYPES__EntityFeatures, type A_TYPES__EntityMeta, A_TYPES__EntityMetaKey, type A_TYPES__Entity_Constructor, type A_TYPES__Entity_Init, type A_TYPES__Entity_Serialized, type A_TYPES__Error_Constructor, type A_TYPES__Error_Init, type A_TYPES__Error_Serialized, type A_TYPES__ExtractNested, type A_TYPES__ExtractProperties, type A_TYPES__FeatureAvailableComponents, type A_TYPES__FeatureAvailableConstructors, type A_TYPES__FeatureDefineDecoratorConfig, type A_TYPES__FeatureDefineDecoratorDescriptor, type A_TYPES__FeatureDefineDecoratorMeta, type A_TYPES__FeatureDefineDecoratorTarget, type A_TYPES__FeatureDefineDecoratorTemplateItem, type A_TYPES__FeatureError_Init, type A_TYPES__FeatureExtendDecoratorConfig, type A_TYPES__FeatureExtendDecoratorDescriptor, type A_TYPES__FeatureExtendDecoratorMeta, type A_TYPES__FeatureExtendDecoratorScopeConfig, type A_TYPES__FeatureExtendDecoratorScopeItem, type A_TYPES__FeatureExtendDecoratorTarget, type A_TYPES__FeatureExtendableMeta, A_TYPES__FeatureState, type A_TYPES__Feature_Constructor, type A_TYPES__Feature_Init, type A_TYPES__Feature_InitWithComponent, type A_TYPES__Feature_InitWithTemplate, type A_TYPES__Feature_Serialized, type A_TYPES__Fragment_Constructor, type A_TYPES__Fragment_Init, type A_TYPES__Fragment_Serialized, type A_TYPES__IEntity, type A_TYPES__InjectableTargets, type A_TYPES__MetaLinkedComponentConstructors, type A_TYPES__MetaLinkedComponents, type A_TYPES__Meta_Constructor, type A_TYPES__NonObjectPaths, type A_TYPES__ObjectKeyEnum, type A_TYPES__Paths, type A_TYPES__PathsToObject, type A_TYPES__Required, type A_TYPES__ScopeConfig, type A_TYPES__ScopeLinkedComponents, type A_TYPES__ScopeLinkedConstructors, type A_TYPES__Scope_Constructor, type A_TYPES__Scope_Init, type A_TYPES__Scope_Serialized, type A_TYPES__Stage_Serialized, type A_TYPES__UnionToIntersection, A_TypeGuards };

package/dist/node/index.mjs

@@ -962,6 +962,20 @@ var A_EntityError = class extends A_Error {
  */
 A_EntityError.ValidationError = "A-Entity Validation Error";
 
+// src/lib/A-Entity/A-Entity.constants.ts
+var A_TYPES__EntityMetaKey = /* @__PURE__ */ ((A_TYPES__EntityMetaKey2) => {
+  A_TYPES__EntityMetaKey2["EXTENSIONS"] = "a-component-extensions";
+  A_TYPES__EntityMetaKey2["FEATURES"] = "a-component-features";
+  A_TYPES__EntityMetaKey2["ABSTRACTIONS"] = "a-component-abstractions";
+  A_TYPES__EntityMetaKey2["INJECTIONS"] = "a-component-injections";
+  return A_TYPES__EntityMetaKey2;
+})(A_TYPES__EntityMetaKey || {});
+var A_TYPES__EntityFeatures = {
+  SAVE: "_A_Entity__Save",
+  DESTROY: "_A_Entity__Destroy",
+  LOAD: "_A_Entity__Load"
+};
+
 // src/lib/A-Entity/A-Entity.class.ts
 var A_Entity = class {
   // ====================================================================
@@ -1117,20 +1131,20 @@ var A_Entity = class {
   /**
    * The default method that can be called and extended to load entity data.
    */
-  async load(scope) {
-    return this.call("load", scope);
+  load(scope) {
+    return this.call(A_TYPES__EntityFeatures.LOAD, scope);
   }
   /**
    * The default method that can be called and extended to destroy entity data.
    */
-  async destroy(scope) {
-    return this.call("destroy", scope);
+  destroy(scope) {
+    return this.call(A_TYPES__EntityFeatures.DESTROY, scope);
   }
   /**
    * The default method that can be called and extended to save entity data.
    */
-  async save(scope) {
-    return this.call("save", scope);
+  save(scope) {
+    return this.call(A_TYPES__EntityFeatures.SAVE, scope);
   }
   // ====================================================================
   // ================== Entity Serialization ============================
@@ -1256,6 +1270,17 @@ var A_Meta = class _A_Meta {
     this.meta = new Map(meta.meta);
     return this;
   }
+  /**
+   * Allows to create a copy of the meta object with the same values, this is needed to ensure that when we inherit meta from the parent component, we create a copy of it, not a reference to the same object. This allows us to modify the meta of the child component without affecting the meta of the parent component.
+   * 
+   * @returns 
+   */
+  clone() {
+    const ctor = this.constructor;
+    const copy = new ctor();
+    copy.meta = new Map(this.meta);
+    return copy;
+  }
   /**
    * Method to set values in the map
    * 
@@ -1367,9 +1392,20 @@ var A_Meta = class _A_Meta {
   clear() {
     this.meta.clear();
   }
+  /**
+   * Method to convert the meta to an array of key-value pairs
+   * 
+   * @returns 
+   */
   toArray() {
     return Array.from(this.meta.entries());
   }
+  /**
+   * Helper method to recursively convert the meta object to a JSON-compatible format. It handles nested A_Meta instances, Maps, Arrays, and plain objects.
+   * 
+   * @param value 
+   * @returns 
+   */
   recursiveToJSON(value) {
     switch (true) {
       case value instanceof _A_Meta:
@@ -1407,21 +1443,6 @@ var A_Meta = class _A_Meta {
   }
 };
 
-// src/lib/A-Entity/A-Entity.constants.ts
-var A_TYPES__EntityMetaKey = /* @__PURE__ */ ((A_TYPES__EntityMetaKey2) => {
-  A_TYPES__EntityMetaKey2["EXTENSIONS"] = "a-component-extensions";
-  A_TYPES__EntityMetaKey2["FEATURES"] = "a-component-features";
-  A_TYPES__EntityMetaKey2["ABSTRACTIONS"] = "a-component-abstractions";
-  A_TYPES__EntityMetaKey2["INJECTIONS"] = "a-component-injections";
-  return A_TYPES__EntityMetaKey2;
-})(A_TYPES__EntityMetaKey || {});
-var A_TYPES__EntityFeatures = /* @__PURE__ */ ((A_TYPES__EntityFeatures2) => {
-  A_TYPES__EntityFeatures2["SAVE"] = "save";
-  A_TYPES__EntityFeatures2["DESTROY"] = "destroy";
-  A_TYPES__EntityFeatures2["LOAD"] = "load";
-  return A_TYPES__EntityFeatures2;
-})(A_TYPES__EntityFeatures || {});
-
 // src/lib/A-Entity/A-Entity.meta.ts
 var A_EntityMeta = class extends A_Meta {
   /**
@@ -4122,6 +4143,21 @@ var A_Scope = class {
     return slice.length === 1 && count !== -1 ? slice[0] : slice.length ? slice : void 0;
   }
   resolveConstructor(name) {
+    switch (true) {
+      case A_TypeGuards.isComponentConstructor(name):
+        return Array.from(this.allowedComponents).find((c) => A_CommonHelper.isInheritedFrom(c, name));
+      case A_TypeGuards.isEntityConstructor(name):
+        return Array.from(this.allowedEntities).find((e) => A_CommonHelper.isInheritedFrom(e, name));
+      case A_TypeGuards.isFragmentConstructor(name):
+        return Array.from(this.allowedFragments).find((f) => A_CommonHelper.isInheritedFrom(f, name));
+      case A_TypeGuards.isErrorConstructor(name):
+        return Array.from(this.allowedErrors).find((e) => A_CommonHelper.isInheritedFrom(e, name));
+    }
+    if (!A_TypeGuards.isString(name))
+      throw new A_ScopeError(
+        A_ScopeError.ResolutionError,
+        `Invalid constructor name provided: ${name}`
+      );
     const component = Array.from(this.allowedComponents).find(
       (c) => c.name === name || c.name === A_FormatterHelper.toPascalCase(name)
     );
@@ -5024,7 +5060,7 @@ var A_Context = class _A_Context {
       }
       if (!inheritedMeta)
         inheritedMeta = new metaType();
-      instance._metaStorage.set(property, new metaType().from(inheritedMeta));
+      instance._metaStorage.set(property, inheritedMeta.clone());
     }
     return instance._metaStorage.get(property);
   }