ngx-easy-state-manager 0.0.4 → 1.0.0

package/README.md

@@ -11,15 +11,21 @@ npm install ngx-easy-state-manager
 ```
 
 ## Versions
-| Version  | Option                      |
-|----------|-----------------------------|
-| ^0.0.4  | Angular 19.                 |
 
+| Version | Option                                        |
+| ------- | --------------------------------------------- |
+| ^0.0.4  | Angular 19.                                   |
+| ^1.0.0  | Added angular support from ^18.0.0 to ^21.0.0,|
+|         | and converted to use signals.                 |
 ## Usage
 
+EasyStateManagerService (Signals Version)
+A lightweight and resilient state management service for Angular using Signals. It supports dynamic keys, immutable updates, and persistent subscriptions.
+
 1. **Import the EasyStateManagerService**
+This library now supports Angular Signals for better performance. However, the classic Observable-based version is still available for backward compatibility.
 
-First, import the EasyStateManagerService into your component or service where you want to manage the state.
+Signals Version (Recommended for Angular 16+)
 
 app.module.ts
 
@@ -27,111 +33,173 @@ app.module.ts
 import { EasyStateManagerService } from "ngx-easy-state-manage";
 
 @NgModule({
-  providers: [{ provide: EasyStateManagerService }],
+  providers: [EasyStateManagerService], // Simplified registration
 })
 export class AppModule {}
 ```
+Observable Version (Classic)
+If you prefer using RxJS Observables, use the original service:
 
-2. **Inject the Service**
+```typescript
+import { EasyStateManagerService } from "ngx-easy-state-manage";
+
+@NgModule({
+  providers: [EasyStateManagerService],
+})
+export class AppModule {}
+```
 
-Inject EasyStateManagerService in the constructor of your component or service.
+2. **Inject the Service**
+   Inject the service into your component or another service:
 
 ```typescript
 constructor(private easyStateManager: EasyStateManagerService) {}
 ```
 
 3. **Assign State**
-
-You can assign a new state using the assignState method. Optionally, you can also associate the state with a specific component name.
+   Create or update state using assignState. It automatically handles Immutable updates for objects and arrays (creating new references to trigger change detection).
 
 ```typescript
-this.easyStateManager.assignState("exampleKey", "exampleValue", "ExampleComponentName");
-```
+// Assign a primitive
+this.easyStateManager.assignState("title", "My App");
 
-4. **Retrieve State**
+// Assign/Update an object (performs a shallow merge)
+this.easyStateManager.assignState("user", { id: 1, name: "John" });
+```
 
-To get the current state associated with a specific key, use the getState method.
+4. **Retrieve State (Snapshot)**
+   To get the current value of a state key once (without subscription), use getState:
 
 ```typescript
-const currentState = this.easyStateManager.getState("exampleKey");
-console.log(currentState); // Output: 'exampleValue'
+const currentTitle = this.easyStateManager.getState<string>("title");
+console.log(currentTitle); // Output: 'My App'
 ```
 
-5. **Subscribe to State Changes**
-
-You can subscribe to state changes using the selectStateChange method, which returns an Observable.
+5. **Subscribe to State Changes (Signals)**
+   The selectStateChange method returns a Read-only Signal. It is "resilient": if you delete the key and recreate it later, the signal will automatically reconnect and provide the new values.
 
 ```typescript
-this.easyStateManager.selectStateChange("exampleKey").subscribe((newValue) => {
-  console.log("State has changed:", newValue);
-});
+// In your component
+public title = this.easyStateManager.selectStateChange<string>("title");
+
+constructor() {
+  effect(() => {
+    console.log("Title updated:", this.title());
+  });
+}
+```
+
+In your HTML template:
+
+```html
+<h1>{{ title() || 'Loading...' }}</h1>
 ```
 
 6. **Delete State**
 
-To delete a state associated with a specific key, use the deleteState method.
+To remove a state key. All active subscribers to this key will immediately receive null.
 
 ```typescript
-this.easyStateManager.deleteState("exampleKey");
+this.easyStateManager.deleteState("title");
 ```
 
-## API
+7. **Clear All**
+   To reset the entire store and notify all active subscribers.
 
-assignState(key: string, value: any, componentName?: string): void
-Assigns a value to the state with an optional component name.
-
-getState(key?: string): any
-Retrieves the current value of the state associated with the specified key.
+```typescript
+this.easyStateManager.clearAll();
+```
 
-selectStateChange(key: string): Observable<any>
-Returns an Observable that emits whenever the state associated with the specified key changes.
+## API
 
+assignState<T>(key: string, value: T): void
+Assigns a value to the state.
+Immutable updates: If the value is an object or an array, the service creates a new reference (shallow copy) to ensure Angular's change detection is triggered.
+Dynamic: If the key doesn't exist, it will be created.
+selectStateChange<T>(key: string): Signal<T | null>
+Returns a Read-only Signal for the specified key.
+Resilient: If the state is deleted and then recreated with the same key, this signal will automatically "reconnect" to the new value.
+Reactive: Perfect for use in templates or effect(). Returns null if the key does not exist or was deleted.
+getState<T>(key: string): T | null
+Retrieves a snapshot of the current value associated with the specified key.
+Does not create a subscription.
+Returns null if the key is not found.
 deleteState(key: string): void
-Deletes the state associated with the specified key.
+Removes the state associated with the specified key.
+All active signals created via selectStateChange for this key will be updated to null.
+clearAll(): void
+Completely resets the store.
+All keys are removed, and all active subscribers are notified with null.
+
+| Feature     |	EasyStateManagerServiceSignal	| EasyStateManagerService      |
+|----------------------------------------------------------------------------|
+|Reactive Type |	Signal<T>	                   | Observable<T>               |
+|Update Logic	 |Immutable (Shallow Copy)	     | Direct / Manual             |
+|Resilience	   |Reconnects after deleteState	 | Subscription ends on delete*|
+|Template Usage|	{{ state() }}	               | `${{state}}`                |
+
+Note: The new EasyStateManagerServiceSignal is specifically designed to work with Angular's new reactivity model.
+ It provides "resilient" connections, meaning if a key is deleted and recreated, your UI components will automatically pick up the new value without needing to re-subscribe.
 
 ## Example
 
-stateTypes
+stateTypes.ts
 
 ```typescript
 export const SELECTED_EMOJI = "selectedEmoji";
+
+export interface EmojiState {
+  emoji: string;
+}
 ```
 
 app.compoinent
 
 ```typescript
-import { Component, OnInit } from "@angular/core";
+import { Component, effect, Signal } from "@angular/core";
 import { EmojiPicker } from "ngx-easy-emoji-picker";
-import { EasyStateManagerService } from "ngx-easy-state-manager";
-
-import { SELECTED_EMOJI } from "./stateTypes";
+import { EasyStateManagerService } from "ngx-easy-state-manage";
+import { SELECTED_EMOJI, EmojiState } from "./stateTypes";
 
 @Component({
   selector: "app-root",
   standalone: true,
   imports: [EmojiPicker],
-  templateUrl: "./app.component.html",
-  styleUrl: "./app.component.css",
-  providers: [EasyStateManagerService],
+  template: `
+    <!-- Direct usage of signal in template -->
+    <div class="display">Selected: {{ emojiState()?.emoji || "None" }}</div>
+
+    <ngx-easy-emoji-picker (onEmojiSelected)="onEmojiSelected($event)">
+    </ngx-easy-emoji-picker>
+  `,
+  // Service is providedIn: 'root', but can be added to providers if needed locally
 })
-export class AppComponent implements OnInit {
-  title = "my-project";
-
-  selectedEmoji = "";
-
-  constructor(private _stateManager: EasyStateManagerService) {}
-
-  ngOnInit() {
-    this._stateManager.selectStateChange(SELECTED_EMOJI).subscribe((state) => {
-      if (state) this.selectedEmoji = state.emoji;
-
-      console.log("Selected emoji:", this.selectedEmoji);
+export class AppComponent {
+  // 1. Get a Read-only Signal for the state
+  public emojiState: Signal<EmojiState | null>;
+
+  constructor(private _stateManager: EasyStateManagerService) {
+    this.emojiState =
+      this._stateManager.selectStateChange<EmojiState>(SELECTED_EMOJI);
+
+    // 2. React to changes in logic (optional)
+    effect(() => {
+      const current = this.emojiState();
+      if (current) {
+        console.log("Emoji updated in state:", current.emoji);
+      }
     });
   }
 
   onEmojiSelected(emoji: string) {
+    // 3. Assign new state (it will trigger the signal above)
     this._stateManager.assignState(SELECTED_EMOJI, { emoji: emoji });
   }
+
+  removeEmoji() {
+    // 4. Delete state - emojiState() will automatically become 'null'
+    this._stateManager.deleteState(SELECTED_EMOJI);
+  }
 }
 ```
 

package/fesm2022/ngx-easy-state-manager.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Injectable } from '@angular/core';
+import { Injectable, signal, computed } from '@angular/core';
 import { BehaviorSubject } from 'rxjs';
 
 class EasyStateManagerService {
@@ -37,16 +37,103 @@ class EasyStateManagerService {
             delete this._store[key];
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.18", ngImport: i0, type: EasyStateManagerService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.18", ngImport: i0, type: EasyStateManagerService, providedIn: "root" }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.16", ngImport: i0, type: EasyStateManagerService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.16", ngImport: i0, type: EasyStateManagerService, providedIn: "root" }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.18", ngImport: i0, type: EasyStateManagerService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.16", ngImport: i0, type: EasyStateManagerService, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: "root",
                 }]
         }] });
 
+class EasyStateManagerServiceSignal {
+    constructor() {
+        /**
+         * Main store holding signals for each state key.
+         * Wrapped in a signal to track adding/removing keys dynamically.
+         */
+        this._store = signal({}, ...(ngDevMode ? [{ debugName: "_store" }] : []));
+    }
+    /**
+     * Sets or updates state for a specific key.
+     * Implements immutable update logic for objects and arrays to ensure change detection.
+     * @param key Unique identifier for the state slice.
+     * @param value New value to assign or merge.
+     */
+    assignState(key, value) {
+        const currentStore = this._store();
+        const existingSignal = currentStore[key];
+        if (existingSignal) {
+            // If signal exists, update its value using immutable patterns
+            existingSignal.update(oldValue => {
+                if (Array.isArray(value))
+                    return [...value];
+                if (value !== null && typeof value === 'object') {
+                    return { ...oldValue, ...value };
+                }
+                return value;
+            });
+        }
+        else {
+            // Create a new signal and trigger store structure update
+            const newSignal = signal(value, ...(ngDevMode ? [{ debugName: "newSignal" }] : []));
+            this._store.update(store => ({
+                ...store,
+                [key]: newSignal
+            }));
+        }
+    }
+    /**
+     * Returns a "resilient" Read-only signal for a specific key.
+     * It tracks the store structure: if a key is deleted and recreated,
+     * the subscriber automatically reconnects to the new signal.
+     * @param key Key to watch.
+     */
+    selectStateChange(key) {
+        return computed(() => {
+            // Subscribes to the store's dictionary changes
+            const s = this._store()[key];
+            // Returns signal value if key exists, otherwise null
+            return s ? s() : null;
+        });
+    }
+    /**
+     * Returns a current snapshot of the state without subscription.
+     */
+    getState(key) {
+        const s = this._store()[key];
+        return s ? s() : null;
+    }
+    /**
+     * Removes a key from the store.
+     * All subscribers to this key will immediately receive 'null'.
+     */
+    deleteState(key) {
+        if (this._store()[key]) {
+            this._store.update(store => {
+                const newStore = { ...store };
+                delete newStore[key];
+                return newStore;
+            });
+        }
+    }
+    /**
+     * Resets the entire store to an empty state.
+     */
+    clearAll() {
+        this._store.set({});
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.16", ngImport: i0, type: EasyStateManagerServiceSignal, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.16", ngImport: i0, type: EasyStateManagerServiceSignal, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.16", ngImport: i0, type: EasyStateManagerServiceSignal, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }] });
+
 /*
  * Public API Surface of ngx-easy-state-manager
  */
@@ -55,5 +142,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.18", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { EasyStateManagerService };
+export { EasyStateManagerService, EasyStateManagerServiceSignal };
 //# sourceMappingURL=ngx-easy-state-manager.mjs.map

package/fesm2022/ngx-easy-state-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngx-easy-state-manager.mjs","sources":["../../../projects/ngx-easy-state-manager/src/lib/ngx-easy-state-manager.service.ts","../../../projects/ngx-easy-state-manager/src/public-api.ts","../../../projects/ngx-easy-state-manager/src/ngx-easy-state-manager.ts"],"sourcesContent":["import { Injectable } from \"@angular/core\";\r\nimport { BehaviorSubject, Observable } from \"rxjs\";\r\n\r\n@Injectable({\r\n  providedIn: \"root\",\r\n})\r\nexport class EasyStateManagerService {\r\n  private _store: Store = {};\r\n\r\n  public assignState<T>(key: string, value: T): void {\r\n    if ((key as string) in this._store) {\r\n      const storeValue = this._store[key].value;\r\n      // check type mismatch\r\n      if (storeValue && typeof storeValue !== typeof value) {\r\n        throw new Error(\r\n          `Type mismatch: ${typeof this._store[key].value} !== ${typeof value}`\r\n        );\r\n      }\r\n\r\n      this._store[key].next(value);\r\n    } else {\r\n      this._store[key] = new BehaviorSubject<T>(value);\r\n    }\r\n  }\r\n\r\n  public getState<T>(key?: string): T | undefined {\r\n    if (key && (key as string) in this._store) {\r\n      return this._store[key].value;\r\n    }\r\n    return undefined;\r\n  }\r\n\r\n  public selectStateChange<T>(key: string): BehaviorSubject<any> {\r\n    if (key in this._store) {\r\n      return this._store[key] as BehaviorSubject<T>;\r\n    }\r\n\r\n    this._store[key] = new BehaviorSubject<T>(null as T);\r\n\r\n    return this._store[key];\r\n  }\r\n\r\n  public deleteState(key: string): void {\r\n    if (key in this._store) {\r\n      delete this._store[key];\r\n    }\r\n  }\r\n}\r\n\r\ntype Store = {\r\n  [key: string]: BehaviorSubject<any>;\r\n};\r\n","/*\r\n * Public API Surface of ngx-easy-state-manager\r\n */\r\n\r\nexport * from './lib/ngx-easy-state-manager.service';\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;MAMa,uBAAuB,CAAA;AAHpC,IAAA,WAAA,GAAA;QAIU,IAAM,CAAA,MAAA,GAAU,EAAE;AAwC3B;IAtCQ,WAAW,CAAI,GAAW,EAAE,KAAQ,EAAA;AACzC,QAAA,IAAK,GAAc,IAAI,IAAI,CAAC,MAAM,EAAE;YAClC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK;;YAEzC,IAAI,UAAU,IAAI,OAAO,UAAU,KAAK,OAAO,KAAK,EAAE;AACpD,gBAAA,MAAM,IAAI,KAAK,CACb,kBAAkB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAA,KAAA,EAAQ,OAAO,KAAK,CAAA,CAAE,CACtE;;YAGH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;;aACvB;YACL,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,eAAe,CAAI,KAAK,CAAC;;;AAI7C,IAAA,QAAQ,CAAI,GAAY,EAAA;QAC7B,IAAI,GAAG,IAAK,GAAc,IAAI,IAAI,CAAC,MAAM,EAAE;YACzC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK;;AAE/B,QAAA,OAAO,SAAS;;AAGX,IAAA,iBAAiB,CAAI,GAAW,EAAA;AACrC,QAAA,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE;AACtB,YAAA,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAuB;;QAG/C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,eAAe,CAAI,IAAS,CAAC;AAEpD,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;;AAGlB,IAAA,WAAW,CAAC,GAAW,EAAA;AAC5B,QAAA,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE;AACtB,YAAA,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;;;+GAtChB,uBAAuB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAAvB,IAAA,SAAA,IAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,SAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,uBAAuB,cAFtB,MAAM,EAAA,CAAA,CAAA;;4FAEP,uBAAuB,EAAA,UAAA,EAAA,CAAA;kBAHnC,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,UAAU,EAAE,MAAM;AACnB,iBAAA;;;ACLD;;AAEG;;ACFH;;AAEG;;;;"}
+{"version":3,"file":"ngx-easy-state-manager.mjs","sources":["../../../projects/ngx-easy-state-manager/src/lib/ngx-easy-state-manager.service.ts","../../../projects/ngx-easy-state-manager/src/lib/ngx-easy-state-manager-signal.service.ts","../../../projects/ngx-easy-state-manager/src/public-api.ts","../../../projects/ngx-easy-state-manager/src/ngx-easy-state-manager.ts"],"sourcesContent":["import { Injectable } from \"@angular/core\";\r\nimport { BehaviorSubject } from \"rxjs\";\r\n\r\n@Injectable({\r\n  providedIn: \"root\",\r\n})\r\nexport class EasyStateManagerService {\r\n  private _store: Store = {};\r\n\r\n  public assignState<T>(key: string, value: T): void {\r\n    if (key in this._store) {\r\n      const storeValue = this._store[key].value;\r\n      // check type mismatch\r\n      if (storeValue && typeof storeValue !== typeof value) {\r\n        throw new Error(\r\n          `Type mismatch: ${typeof this._store[key].value} !== ${typeof value}`\r\n        );\r\n      }\r\n\r\n      this._store[key].next(value);\r\n    } else {\r\n      this._store[key] = new BehaviorSubject<T>(value);\r\n    }\r\n  }\r\n\r\n  public getState<T>(key?: string): T | undefined {\r\n    if (key && key in this._store) {\r\n      return this._store[key].value;\r\n    }\r\n    return undefined;\r\n  }\r\n\r\n  public selectStateChange<T>(key: string): BehaviorSubject<any> {\r\n    if (key in this._store) {\r\n      return this._store[key] as BehaviorSubject<T>;\r\n    }\r\n\r\n    this._store[key] = new BehaviorSubject<T>(null as T);\r\n\r\n    return this._store[key];\r\n  }\r\n\r\n  public deleteState(key: string): void {\r\n    if (key in this._store) {\r\n      delete this._store[key];\r\n    }\r\n  }\r\n}\r\n\r\ntype Store = {\r\n  [key: string]: BehaviorSubject<any>;\r\n};\r\n","import { Injectable, signal, computed, Signal, WritableSignal } from '@angular/core';\r\n\r\n@Injectable({\r\n  providedIn: 'root'\r\n})\r\nexport class EasyStateManagerServiceSignal {\r\n  /**\r\n   * Main store holding signals for each state key.\r\n   * Wrapped in a signal to track adding/removing keys dynamically.\r\n   */\r\n  private readonly _store = signal<Record<string, WritableSignal<any>>>({});\r\n\r\n  /**\r\n   * Sets or updates state for a specific key.\r\n   * Implements immutable update logic for objects and arrays to ensure change detection.\r\n   * @param key Unique identifier for the state slice.\r\n   * @param value New value to assign or merge.\r\n   */\r\n  public assignState<T>(key: string, value: T): void {\r\n    const currentStore = this._store();\r\n    const existingSignal = currentStore[key];\r\n\r\n    if (existingSignal) {\r\n      // If signal exists, update its value using immutable patterns\r\n      existingSignal.update(oldValue => {\r\n        if (Array.isArray(value)) return [...value];\r\n        if (value !== null && typeof value === 'object') {\r\n          return { ...oldValue, ...value };\r\n        }\r\n        return value;\r\n      });\r\n    } else {\r\n      // Create a new signal and trigger store structure update\r\n      const newSignal = signal(value);\r\n      this._store.update(store => ({\r\n        ...store,\r\n        [key]: newSignal\r\n      }));\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Returns a \"resilient\" Read-only signal for a specific key.\r\n   * It tracks the store structure: if a key is deleted and recreated, \r\n   * the subscriber automatically reconnects to the new signal.\r\n   * @param key Key to watch.\r\n   */\r\n  public selectStateChange<T>(key: string): Signal<T | null> {\r\n    return computed(() => {\r\n      // Subscribes to the store's dictionary changes\r\n      const s = this._store()[key];\r\n      // Returns signal value if key exists, otherwise null\r\n      return s ? s() : null;\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Returns a current snapshot of the state without subscription.\r\n   */\r\n  public getState<T>(key: string): T | null {\r\n    const s = this._store()[key];\r\n    return s ? s() : null;\r\n  }\r\n\r\n  /**\r\n   * Removes a key from the store.\r\n   * All subscribers to this key will immediately receive 'null'.\r\n   */\r\n  public deleteState(key: string): void {\r\n    if (this._store()[key]) {\r\n      this._store.update(store => {\r\n        const newStore = { ...store };\r\n        delete newStore[key];\r\n        return newStore;\r\n      });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Resets the entire store to an empty state.\r\n   */\r\n  public clearAll(): void {\r\n    this._store.set({});\r\n  }\r\n}\r\n","/*\r\n * Public API Surface of ngx-easy-state-manager\r\n */\r\n\r\nexport * from './lib/ngx-easy-state-manager.service';\r\nexport * from './lib/ngx-easy-state-manager-signal.service';\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -1,5 +1,52 @@
-/**
- * Generated bundle index. Do not edit.
- */
-/// <amd-module name="ngx-easy-state-manager" />
-export * from './public-api';
+import { BehaviorSubject } from 'rxjs';
+import * as i0 from '@angular/core';
+import { Signal } from '@angular/core';
+
+declare class EasyStateManagerService {
+    private _store;
+    assignState<T>(key: string, value: T): void;
+    getState<T>(key?: string): T | undefined;
+    selectStateChange<T>(key: string): BehaviorSubject<any>;
+    deleteState(key: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EasyStateManagerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EasyStateManagerService>;
+}
+
+declare class EasyStateManagerServiceSignal {
+    /**
+     * Main store holding signals for each state key.
+     * Wrapped in a signal to track adding/removing keys dynamically.
+     */
+    private readonly _store;
+    /**
+     * Sets or updates state for a specific key.
+     * Implements immutable update logic for objects and arrays to ensure change detection.
+     * @param key Unique identifier for the state slice.
+     * @param value New value to assign or merge.
+     */
+    assignState<T>(key: string, value: T): void;
+    /**
+     * Returns a "resilient" Read-only signal for a specific key.
+     * It tracks the store structure: if a key is deleted and recreated,
+     * the subscriber automatically reconnects to the new signal.
+     * @param key Key to watch.
+     */
+    selectStateChange<T>(key: string): Signal<T | null>;
+    /**
+     * Returns a current snapshot of the state without subscription.
+     */
+    getState<T>(key: string): T | null;
+    /**
+     * Removes a key from the store.
+     * All subscribers to this key will immediately receive 'null'.
+     */
+    deleteState(key: string): void;
+    /**
+     * Resets the entire store to an empty state.
+     */
+    clearAll(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EasyStateManagerServiceSignal, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EasyStateManagerServiceSignal>;
+}
+
+export { EasyStateManagerService, EasyStateManagerServiceSignal };

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "ngx-easy-state-manager",
-  "version": "0.0.4",
+  "version": "1.0.0",
   "author": "Alex Voronin <alex.varonin@gmail.com>",
   "license": "MIT",
   "peerDependencies": {
-    "@angular/common": "^19.0.0",
-    "@angular/core": "^19.0.0"
+    "@angular/common": "^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0",
+    "@angular/core": "^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0",
+    "rxjs": "^7.8.0",
+    "zone.js": "~0.14.0 || ~0.15.0"
   },
   "description": "ngx-easy-state-manager is a lightweight, intuitive library for managing state in Angular applications. It simplifies state management by providing a straightforward API for creating, updating, and accessing state, without the complexity of traditional approaches.",
   "dependencies": {

package/lib/ngx-easy-state-manager.service.d.ts

@@ -1,11 +0,0 @@
-import { BehaviorSubject } from "rxjs";
-import * as i0 from "@angular/core";
-export declare class EasyStateManagerService {
-    private _store;
-    assignState<T>(key: string, value: T): void;
-    getState<T>(key?: string): T | undefined;
-    selectStateChange<T>(key: string): BehaviorSubject<any>;
-    deleteState(key: string): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<EasyStateManagerService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<EasyStateManagerService>;
-}

package/public-api.d.ts

@@ -1 +0,0 @@
-export * from './lib/ngx-easy-state-manager.service';