@asor-studio/asor-core 1.0.8 → 1.0.10

package/index.d.ts

@@ -592,6 +592,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.
@@ -1980,6 +1987,7 @@ type Constructor<T = {}> = abstract new (...args: any[]) => T;
  */
 interface IStorageHandler<T = any> {
     propsStore: T;
+    registryElement?: RegistryElement;
     storageHandlerDataChanges(prev: any, curr: any): void;
 }
 /**
@@ -2014,11 +2022,28 @@ 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;
+/**
+ * Creates a flattened reactive proxy over a nested propsStore structure.
+ *
+ * The propsStore has shape: { rootKey1: { prop1: val, prop2: val }, rootKey2: { ... } }
+ * This proxy flattens it so that accessing `proxy.prop1` reads from the correct rootKey,
+ * and — critically — setting `proxy.prop1 = newValue` writes through the reactive proxy
+ * on propsStore, triggering onChange and state updates.
+ *
+ * Without this proxy, `this.props.x = value` would write to a throwaway plain object
+ * and the reactive set trap would never fire.
+ *
+ * @param propsStore - The reactive proxy wrapping the nested props structure
+ * @returns A flattened proxy typed as T
+ */
+declare function createFlattenedReactiveProxy<T>(propsStore: Record<string, any>): T;
 
 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;
 /**
@@ -2033,6 +2058,7 @@ declare const BaseStorageComponent_base: _asor_studio_asor_core.Constructor<ISto
  * - Reactive connection to state store
  * - Proxy-based prop-to-store synchronization
  * - Support for nested object updates
+ * - Full object/array assignment reactivity (e.g. this.props.list = [...])
  *
  * @Directive - Can be extended by Angular components
  * @abstract - Must be extended, cannot be instantiated directly
@@ -2080,11 +2106,15 @@ declare const BaseStorageComponent_base: _asor_studio_asor_core.Constructor<ISto
 declare abstract class BaseStorageComponent<T extends object = Record<string, any>> extends BaseStorageComponent_base implements IStorageHandler<T> {
     /**
      * Typed props object for type-safe state management.
-     * This provides strongly-typed access to the propsStore from the mixin.
-     * The propsStore is flattened from a nested structure grouped by dataset root
-     * to a flat structure with direct property access while maintaining proxy reactivity.
+     * Returns a flattened reactive proxy over propsStore so that both
+     * read and write operations (including full object/array assignment)
+     * 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>;
@@ -2092,6 +2122,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;
 /**
@@ -2106,6 +2137,7 @@ declare const BaseStorageMolecule_base: _asor_studio_asor_core.Constructor<IStor
  * - Reactive connection to state store
  * - Proxy-based prop-to-store synchronization
  * - Support for nested object updates
+ * - Full object/array assignment reactivity (e.g. this.props.list = [...])
  *
  * @Directive - Can be extended by Angular components
  * @abstract - Must be extended, cannot be instantiated directly
@@ -2167,11 +2199,15 @@ declare const BaseStorageMolecule_base: _asor_studio_asor_core.Constructor<IStor
 declare abstract class BaseStorageMolecule<T extends object = Record<string, any>> extends BaseStorageMolecule_base implements IStorageHandler<T> {
     /**
      * Typed props object for type-safe state management.
-     * This provides strongly-typed access to the propsStore from the mixin.
-     * The propsStore is flattened from a nested structure grouped by dataset root
-     * to a flat structure with direct property access while maintaining proxy reactivity.
+     * Returns a flattened reactive proxy over propsStore so that both
+     * read and write operations (including full object/array assignment)
+     * 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<BaseStorageMolecule<any>, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<BaseStorageMolecule<any>, never, never, {}, {}, never, never, true, never>;
@@ -2433,7 +2469,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
@@ -2532,5 +2568,5 @@ declare class AsorWidgetComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<AsorWidgetComponent, "asor-core-widget", never, { "mode": { "alias": "mode"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-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 };
-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 { 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, RegistryElement, RegistryEntry, StateHandlerConfig, StoreType, UpdateDataSetOption };

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@asor-studio/asor-core",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "peerDependencies": {
-    "@angular/common": "^20.3.0",
-    "@angular/core": "^20.3.0"
+    "@angular/common": "^20.3.0 || ^21.0.0",
+    "@angular/core": "^20.3.0 || ^21.0.0",
+    "crypto-js": "^4.2.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"