@asor-studio/asor-core 1.0.9 → 1.0.11

package/index.d.ts

@@ -191,7 +191,7 @@ declare abstract class ConfigConst {
  *   }
  * }
  */
-declare abstract class BaseMolecule implements IComp, IConsoleLoggable {
+declare abstract class BaseMolecule implements IBaseMolecule, IConsoleLoggable, OnInit, OnDestroy {
     static readonly className: string;
     /**
      * Injected ActivatedRoute for accessing route data and parameters.
@@ -263,6 +263,36 @@ declare abstract class BaseMolecule implements IComp, IConsoleLoggable {
      * }
      */
     baseCompViewLeave(): void;
+    /**
+     * Lifecycle hook called when the component view is about to enter.
+     * Must be implemented by derived classes to define component-specific initialization logic.
+     *
+     * @throws Error if not implemented by the extending class
+     *
+     * @example
+     * export class MyMolecule extends BaseMolecule {
+     *   baseCompViewWillEnter(): void {
+     *     console.log('Component is entering view');
+     *     this.loadData();
+     *   }
+     * }
+     */
+    baseMoleculeViewWillEnter(): void;
+    /**
+     * Lifecycle hook called when the component view is about to leave.
+     * Must be implemented by derived classes to define component-specific cleanup logic.
+     *
+     * @throws Error if not implemented by the extending class
+     *
+     * @example
+     * export class MyMolecule extends BaseMolecule {
+     *   baseCompViewWillLeave(): void {
+     *     console.log('Component is leaving view');
+     *     this.cleanup();
+     *   }
+     * }
+     */
+    baseMoleculeViewWillLeave(): void;
     /**
      * Returns the name of the current component class.
      * Used internally to match the component with its configuration in route data.
@@ -274,6 +304,28 @@ declare abstract class BaseMolecule implements IComp, IConsoleLoggable {
      * console.log(this.getClassName()); // Outputs: "UserCardComponent"
      */
     getClassName(): string;
+    /**
+     * Lifecycle hook called when the component is initialized.
+     * Calls the baseMoleculeViewWillEnter() method.
+     */
+    ngOnInit(): void;
+    /**
+     * Lifecycle hook called when the component is destroyed.
+     * Calls the baseMoleculeViewWillLeave() method.
+     */
+    ngOnDestroy(): void;
+    /**
+     * Ionic lifecycle hook called when the view is about to enter and become the active view.
+     * This is called regardless of whether it is the first load or cached view.
+     * Delegates to baseCompViewWillEnter() for consistency across Angular and Ionic.
+     */
+    ionViewWillEnter(): void;
+    /**
+     * Ionic lifecycle hook called when the view is about to leave and no longer be the active view.
+     * This is called when navigating away from the current view.
+     * Delegates to baseCompViewWillLeave() for consistency across Angular and Ionic.
+     */
+    ionViewWillLeave(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BaseMolecule, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<BaseMolecule, never, never, {}, {}, never, never, true, never>;
 }
@@ -592,6 +644,13 @@ interface DataElement {
 interface RegistryEntry<T = any> {
     propsIsUpdated: (props: T) => void;
 }
+/**
+ * Registry element structure for component registrations
+ */
+interface RegistryElement {
+    componentName: string;
+    destroy: () => void;
+}
 
 /**
  * Base abstract class for Page/Component-level components following the Atomic Design pattern.
@@ -863,6 +922,9 @@ interface IComponent {
 interface ICompStatic {
     readonly className: string;
 }
+/**
+ * Interface for BaseComponent
+ */
 interface IComp {
     /** Array of i18n translation paths for this component */
     I18nPath: string[];
@@ -871,6 +933,19 @@ interface IComp {
     /** Called when the component view is about to leave/destroy */
     baseCompViewLeave(): void;
 }
+/**
+ * Interface for BaseMolecule
+ */
+interface IBaseMolecule extends IComp {
+    /**
+     * Called when the molecule view is about to enter/initialize
+     */
+    baseMoleculeViewWillEnter(): void;
+    /**
+     * Called when the molecule view is about to leave/destroy
+     */
+    baseMoleculeViewWillLeave(): void;
+}
 /**
  * Interface for authorization response from the backend API.
  * Contains the authorization status indicating if the user is allowed to perform an action.
@@ -1980,6 +2055,7 @@ type Constructor<T = {}> = abstract new (...args: any[]) => T;
  */
 interface IStorageHandler<T = any> {
     propsStore: T;
+    registryElement?: RegistryElement;
     storageHandlerDataChanges(prev: any, curr: any): void;
 }
 /**
@@ -2014,6 +2090,7 @@ interface IStorageHandler<T = any> {
  */
 declare function BaseHandlerMixin<T extends object = any, TBase extends Constructor = Constructor>(Base: TBase): Constructor<IStorageHandler<T> & {
     propsStore: T;
+    registryElement: RegistryElement;
     storageHandlerDataChanges(prev: T, curr: T): void;
 }> & TBase;
 /**
@@ -2034,6 +2111,7 @@ declare function createFlattenedReactiveProxy<T>(propsStore: Record<string, any>
 
 declare const BaseStorageComponent_base: _asor_studio_asor_core.Constructor<IStorageHandler<any> & {
     propsStore: any;
+    registryElement: _asor_studio_asor_core.RegistryElement;
     storageHandlerDataChanges(prev: any, curr: any): void;
 }> & typeof BaseComponent;
 /**
@@ -2101,6 +2179,10 @@ declare abstract class BaseStorageComponent<T extends object = Record<string, an
      * are forwarded through the reactive proxy, triggering state updates.
      */
     get props(): T;
+    /**
+     * Override baseCompViewLeave to unregister from store
+     */
+    baseCompViewLeave(): void;
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<BaseStorageComponent<any>, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<BaseStorageComponent<any>, never, never, {}, {}, never, never, true, never>;
@@ -2108,6 +2190,7 @@ declare abstract class BaseStorageComponent<T extends object = Record<string, an
 
 declare const BaseStorageMolecule_base: _asor_studio_asor_core.Constructor<IStorageHandler<any> & {
     propsStore: any;
+    registryElement: _asor_studio_asor_core.RegistryElement;
     storageHandlerDataChanges(prev: any, curr: any): void;
 }> & typeof BaseMolecule;
 /**
@@ -2189,6 +2272,14 @@ declare abstract class BaseStorageMolecule<T extends object = Record<string, any
      * are forwarded through the reactive proxy, triggering state updates.
      */
     get props(): T;
+    /**
+     * Override baseCompViewLeave to unregister from store
+     */
+    baseCompViewLeave(): void;
+    /**
+     * Override baseMoleculeViewWillLeave to unregister from store
+     */
+    baseMoleculeViewWillLeave(): void;
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<BaseStorageMolecule<any>, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<BaseStorageMolecule<any>, never, never, {}, {}, never, never, true, never>;
@@ -2450,7 +2541,7 @@ declare class StateService implements IConsoleLoggable {
      */
     registry<T = any>(componentName: string, propStructure: {
         [key: string]: string;
-    }, callback: (props: T) => void): void;
+    }, callback: (props: T) => void): RegistryElement;
     /**
      * Resolve properties from state based on mapping structure
      * @param propStructure Object mapping property names to state paths
@@ -2550,4 +2641,4 @@ declare class AsorWidgetComponent {
 }
 
 export { GlobalEnum_d as AsorGlobalEnum, StateConstants_d as AsorStorage, AsorWidgetComponent, AuthGuard, AuthUtility, BaseComponent, BaseHandlerMixin, BaseMolecule, BaseStorageComponent, BaseStorageMolecule, CacheInterceptor, CachePathUtility, CacheUtility, CollectionUtils, ConfigCache, ConfigConst, ConsoleLogsConfig, ConsoleLogsUtility, CookieUtils, ErrorInterceptor, HttpRequestHandler, NotifyErrorService, ObjectUtils, RandomUtils, RoutingUtility, StateConst, StateService, StringUtils, TranslatePipe, TranslateUtility, createFlattenedReactiveProxy };
-export type { AsorWidgetMode, Constructor, CreateDataSetOption, DataElement, DataMethod, EncryptType, GenerateType, IAsorRoute, IAuth, IComp, ICompStatic, IComponent, IConnectDataSet, IConsoleLoggable, ICreateDataSet, IHttpAuthSubscribe, IHttpFormError, IHttpRequest, IHttpRequestHandlerConfig, IHttpResponseError, IHttpSubscribe, IMolecule, IPath, IStorageHandler, LogClassConfig, LogEntry, LogLevel, RegistryEntry, StateHandlerConfig, StoreType, UpdateDataSetOption };
+export type { AsorWidgetMode, Constructor, CreateDataSetOption, DataElement, DataMethod, EncryptType, GenerateType, IAsorRoute, IAuth, IBaseMolecule, IComp, ICompStatic, IComponent, IConnectDataSet, IConsoleLoggable, ICreateDataSet, IHttpAuthSubscribe, IHttpFormError, IHttpRequest, IHttpRequestHandlerConfig, IHttpResponseError, IHttpSubscribe, IMolecule, IPath, IStorageHandler, LogClassConfig, LogEntry, LogLevel, RegistryElement, RegistryEntry, StateHandlerConfig, StoreType, UpdateDataSetOption };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asor-studio/asor-core",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "peerDependencies": {
     "@angular/common": "^20.3.0 || ^21.0.0",
     "@angular/core": "^20.3.0 || ^21.0.0",