@alwatr/signal 5.1.0 → 5.2.1

package/CHANGELOG.md

@@ -3,6 +3,38 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [5.2.1](https://github.com/Alwatr/flux/compare/v5.2.0...v5.2.1) (2025-09-15)
+
+### ⚡ Performance Improvements
+
+* To improve readability and avoid calling sourceSignal.get() twice, used temporary variable before using it. ([2aaa3bd](https://github.com/Alwatr/flux/commit/2aaa3bdd06745885495ca64a71c4040b9ec57cea))
+
+### 🔨 Code Refactoring
+
+* change the `signal.value` to `signal.get()` ([fcdcb6c](https://github.com/Alwatr/flux/commit/fcdcb6caf82747b8e6d7ad846d6babead385c603))
+* rename run_ method to scheduleExecution_ for clarity in EffectSignal ([402af2f](https://github.com/Alwatr/flux/commit/402af2f7b84357ade4f79b33611d6968ec6b8efd))
+
+## [5.2.0](https://github.com/Alwatr/flux/compare/v5.1.0...v5.2.0) (2025-09-15)
+
+### ✨ Features
+
+* Add comprehensive documentation to the repository ([d5569e6](https://github.com/Alwatr/flux/commit/d5569e63acd0aa926c34d9a61b2fff5139b9d3cc))
+* Update EffectSignalConfig to allow optional signalId and add documentation ([6aab97e](https://github.com/Alwatr/flux/commit/6aab97e6e223f822f66cacb78c9d194fa5e2df9d))
+
+### 🐛 Bug Fixes
+
+* Refactor logger initialization and ensure checkDestroyed_ is called in relevant methods ([a17884d](https://github.com/Alwatr/flux/commit/a17884d5df097d62353e5b4110d3a83a5ae093b3))
+
+### 🔨 Code Refactoring
+
+* Ensure isRunning__ is reset when destroyed during delay in EffectSignal ([ff9a590](https://github.com/Alwatr/flux/commit/ff9a5905f7875e7dcb675cbdbb44869b0743e954))
+* Improve signal management by consolidating destruction checks and enhancing logging ([8765ba2](https://github.com/Alwatr/flux/commit/8765ba2f701f10db89ef11a3045065442360d193))
+* Remove unnecessary binding of notify_ in EventSignal constructor ([eb3be32](https://github.com/Alwatr/flux/commit/eb3be3211b13c21aa4f5c16a37f5c9fc59144951))
+* Simplify ComputedSignal implementation and improve logging for lifecycle methods ([bc35e91](https://github.com/Alwatr/flux/commit/bc35e91d5871669cc22c6c92ee2b83c4d940194e))
+* Simplify EffectSignal implementation and improve logging for lifecycle methods ([a5cad04](https://github.com/Alwatr/flux/commit/a5cad04469efd929e2ce7da42b371d4c054e5eaf))
+* Simplify EventSignal logger initialization and constructor ([b515315](https://github.com/Alwatr/flux/commit/b515315428e8ba0c70a7ef5ede49916e899b6fcd))
+* Update logger step identifiers for recalculation in ComputedSignal ([8de799f](https://github.com/Alwatr/flux/commit/8de799f40d90c2cdc3440d90bc1f2b6ce22f7013))
+
 ## [5.1.0](https://github.com/Alwatr/flux/compare/v5.0.0...v5.1.0) (2025-09-14)
 
 ### ✨ Features

package/README.md

@@ -69,10 +69,10 @@ import {ComputedSignal} from '@alwatr/signal';
 const fullName = new ComputedSignal<string>({
   signalId: 'user-fullName',
   deps: [firstName], // This computed signal depends on firstName.
-  get: () => `User: ${firstName.value}`,
+  get: () => `User: ${firstName.get()}`,
 });
 
-console.log(fullName.value); // Outputs: "User: John"
+console.log(fullName.get()); // Outputs: "User: John"
 ```
 
 ### 4. Create an Effect Signal
@@ -85,7 +85,7 @@ import {EffectSignal} from '@alwatr/signal';
 const loggerEffect = new EffectSignal({
   deps: [fullName, counter], // This effect depends on fullName and counter.
   run: () => {
-    console.log(`${fullName.value} has clicked ${counter.value} times.`);
+    console.log(`${fullName.get()} has clicked ${counter.get()} times.`);
   },
 });
 ```
@@ -134,7 +134,7 @@ Signals that depend on other signals (like `ComputedSignal` and `EffectSignal`)
 // Create a computed signal
 const isEven = new ComputedSignal({
   deps: [counter],
-  get: () => counter.value % 2 === 0,
+  get: () => counter.get() % 2 === 0,
 });
 
 // ... use it for a while ...
@@ -167,7 +167,7 @@ The `subscribe` method accepts an optional second argument to customize its beha
 - **`constructor(config)`**: Creates a new state signal.
   - `config.signalId`: `string`
   - `config.initialValue`: `T`
-- **`.value`**: `T` - Gets the current value.
+- **`.get()`**: `T` - Gets the current value.
 - **`.set(newValue: T)`**: Sets a new value and notifies listeners.
 
 ### `ComputedSignal<T>`
@@ -176,7 +176,7 @@ The `subscribe` method accepts an optional second argument to customize its beha
   - `config.signalId`: `string`
   - `config.deps`: `IReadonlySignal<unknown>[]` - Array of dependency signals.
   - `config.get`: `() => T` - The function to compute the value.
-- **`.value`**: `T` - Gets the current (memoized) value.
+- **`.get()`**: `T` - Gets the current (memoized) value.
 - **`.destroy()`**: Cleans up the signal's subscriptions. **(Important!)**
 
 ### `EffectSignal`
@@ -284,10 +284,10 @@ import {ComputedSignal} from '@alwatr/signal';
 const fullName = new ComputedSignal<string>({
   signalId: 'user-fullName',
   deps: [firstName], // این سیگنال محاسباتی به firstName وابسته است
-  get: () => `User: ${firstName.value}`,
+  get: () => `User: ${firstName.get()}`,
 });
 
-console.log(fullName.value); // خروجی: "User: John"
+console.log(fullName.get()); // خروجی: "User: John"
 ```
 
 ### ۴. ایجاد `EffectSignal`
@@ -300,7 +300,7 @@ import {EffectSignal} from '@alwatr/signal';
 const loggerEffect = new EffectSignal({
   deps: [fullName, counter], // این افکت به fullName و counter وابسته است
   run: () => {
-    console.log(`${fullName.value} has clicked ${counter.value} times.`);
+    console.log(`${fullName.get()} has clicked ${counter.get()} times.`);
   },
 });
 ```
@@ -349,7 +349,7 @@ User: Jane has clicked 1 times.
 // یک سیگنال محاسباتی ایجاد کنید
 const isEven = new ComputedSignal({
   deps: [counter],
-  get: () => counter.value % 2 === 0,
+  get: () => counter.get() % 2 === 0,
 });
 
 // ... مدتی از آن استفاده کنید ...
@@ -382,7 +382,7 @@ Alwatr Signal از یک مدل ناهمزمان قابل پیش‌بینی بر
 - **`constructor(config)`**: یک سیگنال وضعیت جدید ایجاد می‌کند.
   - `config.signalId`: `string`
   - `config.initialValue`: `T`
-- **`.value`**: `T` - مقدار فعلی را دریافت می‌کند.
+- **`.get()`**: `T` - مقدار فعلی را دریافت می‌کند.
 - **`.set(newValue: T)`**: مقدار جدیدی را تنظیم کرده و شنوندگان را مطلع می‌کند.
 
 ### `ComputedSignal<T>`
@@ -391,7 +391,7 @@ Alwatr Signal از یک مدل ناهمزمان قابل پیش‌بینی بر
   - `config.signalId`: `string`
   - `config.deps`: `IReadonlySignal<unknown>[]` - آرایه‌ای از سیگنال‌های وابسته.
   - `config.get`: `() => T` - تابعی برای محاسبه مقدار.
-- **`.value`**: `T` - مقدار فعلی (کش شده) را دریافت می‌کند.
+- **`.get()`**: `T` - مقدار فعلی (کش شده) را دریافت می‌کند.
 - **`.destroy()`**: اشتراک‌های سیگنال را پاک‌سازی می‌کند. **(مهم!)**
 
 ### `EffectSignal`

package/dist/core/computed-signal.d.ts

@@ -1,5 +1,5 @@
 import { StateSignal } from './state-signal.js';
-import type { ComputedSignalConfig, IReadonlySignal, SubscribeResult } from '../type.js';
+import type { ComputedSignalConfig, IReadonlySignal, SubscribeResult, SubscribeOptions } from '../type.js';
 /**
  * A read-only signal that derives its value from a set of dependency signals.
  *
@@ -11,7 +11,6 @@ import type { ComputedSignalConfig, IReadonlySignal, SubscribeResult } from '../
  * needed to prevent memory leaks from its subscriptions to dependency signals.
  *
  * @template T The type of the computed value.
- * @implements {IComputedSignal<T>}
  *
  * @example
  * // --- Create dependency signals ---
@@ -22,10 +21,10 @@ import type { ComputedSignalConfig, IReadonlySignal, SubscribeResult } from '../
  * const fullName = new ComputedSignal({
  *   signalId: 'fullName',
  *   deps: [firstName, lastName],
- *   get: () => `${firstName.value} ${lastName.value}`,
+ *   get: () => `${firstName.get()} ${lastName.get()}`,
  * });
  *
- * console.log(fullName.value); // Outputs: "John Doe"
+ * console.log(fullName.get()); // Outputs: "John Doe"
  *
  * // --- Subscribe to the computed value ---
  * fullName.subscribe(newFullName => {
@@ -34,22 +33,37 @@ import type { ComputedSignalConfig, IReadonlySignal, SubscribeResult } from '../
  *
  * // --- Update a dependency ---
  * lastName.set('Smith'); // Recalculates and logs: "Name changed to: John Smith"
- * console.log(fullName.value); // Outputs: "John Smith"
+ * console.log(fullName.get()); // Outputs: "John Smith"
  *
  * // --- IMPORTANT: Clean up when done ---
  * fullName.destroy();
  */
 export declare class ComputedSignal<T> implements IReadonlySignal<T> {
     protected config_: ComputedSignalConfig<T>;
+    /**
+     * The unique identifier for this signal instance.
+     */
     readonly signalId: string;
+    /**
+     * The logger instance for this signal.
+     * @protected
+     */
     protected readonly logger_: import("@alwatr/logger").AlwatrLogger;
     /**
      * The internal `StateSignal` that holds the computed value.
-     * This is how the computed signal provides `.value` and `.subscribe()` methods.
+     * This is how the computed signal provides `.get()` and `.subscribe()` methods.
      * @protected
      */
     protected readonly internalSignal_: StateSignal<T>;
-    private readonly subscriptionList__;
+    /**
+     * A list of subscriptions to dependency signals.
+     * @private
+     */
+    private readonly dependencySubscriptions__;
+    /**
+     * A flag to prevent concurrent recalculations.
+     * @private
+     */
     private isRecalculating__;
     constructor(config_: ComputedSignalConfig<T>);
     /**
@@ -59,15 +73,28 @@ export declare class ComputedSignal<T> implements IReadonlySignal<T> {
      * @returns The current computed value.
      * @throws {Error} If accessed after the signal has been destroyed.
      */
-    get value(): T;
+    get(): T;
     /**
      * Indicates whether the computed signal has been destroyed.
      * A destroyed signal cannot be used and will throw an error if interacted with.
      * @returns `true` if the signal is destroyed, `false` otherwise.
      */
     get isDestroyed(): boolean;
-    readonly subscribe: (callback: import("../type.js").ListenerCallback<T>, options?: import("../type.js").SubscribeOptions) => SubscribeResult;
-    readonly untilNext: () => Promise<T>;
+    /**
+     * Subscribes a listener to this signal.
+     * The listener will be called whenever the computed value changes.
+     *
+     * @param callback The function to be called with the new value.
+     * @param options Subscription options.
+     * @returns A `SubscribeResult` object with an `unsubscribe` method.
+     */
+    subscribe(callback: (value: T) => void, options?: SubscribeOptions): SubscribeResult;
+    /**
+     * Returns a Promise that resolves with the next computed value.
+     *
+     * @returns A Promise that resolves with the next value.
+     */
+    untilNext(): Promise<T>;
     /**
      * Permanently disposes of the computed signal.
      *
@@ -75,7 +102,7 @@ export declare class ComputedSignal<T> implements IReadonlySignal<T> {
      * stopping future recalculations and allowing the signal to be garbage collected.
      * Failure to call `destroy()` will result in memory leaks.
      *
-     * After `destroy()` is called, any attempt to access `.value` or `.subscribe()` will throw an error.
+     * After `destroy()` is called, any attempt to access `.get()` or `.subscribe()` will throw an error.
      */
     destroy(): void;
     /**

package/dist/core/computed-signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"computed-signal.d.ts","sourceRoot":"","sources":["../../src/core/computed-signal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,EAAC,oBAAoB,EAAE,eAAe,EAAE,eAAe,EAAC,MAAM,YAAY,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAkBvC,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAjB7D,SAAgB,QAAQ,SAAyB;IAEjD,SAAS,CAAC,QAAQ,CAAC,OAAO,wCAAqD;IAE/E;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,iBAG/B;IAEH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyB;IAC5D,OAAO,CAAC,iBAAiB,CAAS;gBAEL,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAU7D;;;;;;OAMG;IACH,IAAW,KAAK,IAAI,CAAC,CAEpB;IAED;;;;OAIG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED,SAAgB,SAAS,2HAA6D;IAEtF,SAAgB,SAAS,mBAA6D;IAEtF;;;;;;;;OAQG;IACI,OAAO,IAAI,IAAI;IAsBtB;;;;;;;OAOG;cACa,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAqC9C"}
+{"version":3,"file":"computed-signal.d.ts","sourceRoot":"","sources":["../../src/core/computed-signal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,EAAC,oBAAoB,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAEzG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAmCvC,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAlC7D;;OAEG;IACH,SAAgB,QAAQ,SAAyB;IAEjD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,wCAAqD;IAE/E;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,iBAG/B;IAEH;;;OAGG;IAEH,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAyB;IAEnE;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAAS;gBAEL,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAU7D;;;;;;OAMG;IACI,GAAG,IAAI,CAAC;IAIf;;;;OAIG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;;;;;OAOG;IACI,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe;IAI3F;;;;OAIG;IACI,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC;IAI9B;;;;;;;;OAQG;IACI,OAAO,IAAI,IAAI;IAqBtB;;;;;;;OAOG;cACa,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAwC9C"}

package/dist/core/effect-signal.d.ts

@@ -19,9 +19,10 @@ import type { EffectSignalConfig, IEffectSignal } from '../type.js';
  *
  * // --- Create an effect ---
  * const analyticsEffect = new EffectSignal({
+ *   signalId: 'analytics-effect',
  *   deps: [counter, user],
  *   run: () => {
- *     console.log(`Analytics: User '${user.value}' clicked ${counter.value} times.`);
+ *     console.log(`Analytics: User '${user.get()}' clicked ${counter.get()} times.`);
  *   },
  *   runImmediately: true, // Optional: run once on creation
  * });
@@ -39,13 +40,34 @@ import type { EffectSignalConfig, IEffectSignal } from '../type.js';
  */
 export declare class EffectSignal implements IEffectSignal {
     protected config_: EffectSignalConfig;
+    /**
+     * The unique identifier for this signal instance.
+     */
+    readonly signalId: string;
+    /**
+     * The logger instance for this signal.
+     * @protected
+     */
     protected readonly logger_: import("@alwatr/logger").AlwatrLogger;
-    private readonly subscriptionList__;
+    /**
+     * A list of subscriptions to dependency signals.
+     * @private
+     */
+    private readonly dependencySubscriptions__;
+    /**
+     * A flag to prevent concurrent executions of the effect.
+     * @private
+     */
     private isRunning__;
+    /**
+     * A flag indicating whether the effect has been destroyed.
+     * @private
+     */
     private isDestroyed__;
     /**
      * Indicates whether the effect signal has been destroyed.
-     * A destroyed signal cannot be used and will throw an error if interacted with.
+     * A destroyed signal will no longer execute its effect and cannot be reused.
+     *
      * @returns `true` if the signal is destroyed, `false` otherwise.
      */
     get isDestroyed(): boolean;
@@ -58,7 +80,7 @@ export declare class EffectSignal implements IEffectSignal {
      * dependencies change simultaneously.
      * @protected
      */
-    protected run_(): Promise<void>;
+    protected scheduleExecution_(): Promise<void>;
     /**
      * Permanently disposes of the effect signal.
      *

package/dist/core/effect-signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effect-signal.d.ts","sourceRoot":"","sources":["../../src/core/effect-signal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,YAAa,YAAW,aAAa;IAgB7B,SAAS,CAAC,OAAO,EAAE,kBAAkB;IAfxD,SAAS,CAAC,QAAQ,CAAC,OAAO,wCAAiC;IAE3D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyB;IAC5D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAS;IAE9B;;;;OAIG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;gBAE4B,OAAO,EAAE,kBAAkB;IAiBxD;;;;;;;OAOG;cACa,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCrC;;;;;;OAMG;IACI,OAAO,IAAI,IAAI;CAmBvB"}
+{"version":3,"file":"effect-signal.d.ts","sourceRoot":"","sources":["../../src/core/effect-signal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,YAAa,YAAW,aAAa;IAwC7B,SAAS,CAAC,OAAO,EAAE,kBAAkB;IAvCxD;;OAEG;IACH,SAAgB,QAAQ,SAAkH;IAE1I;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,wCAAmD;IAE7E;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAyB;IAEnE;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAS;IAE9B;;;;;OAKG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;gBAE4B,OAAO,EAAE,kBAAkB;IAiBxD;;;;;;;OAOG;cACa,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCnD;;;;;;OAMG;IACI,OAAO,IAAI,IAAI;CAmBvB"}

package/dist/core/event-signal.d.ts

@@ -28,6 +28,10 @@ import type { SignalConfig } from '../type.js';
  * onAppReady.dispatch(); // Notifies the listener.
  */
 export declare class EventSignal<T = void> extends SignalBase<T> {
+    /**
+     * The logger instance for this signal.
+     * @protected
+     */
     protected logger_: import("@alwatr/logger").AlwatrLogger;
     constructor(config: SignalConfig);
     /**

package/dist/core/event-signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-signal.d.ts","sourceRoot":"","sources":["../../src/core/event-signal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,IAAI,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACtD,SAAS,CAAC,OAAO,wCAAkD;gBAEhD,MAAM,EAAE,YAAY;IAKvC;;;;;;OAMG;IACI,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI;CAQlC"}
+{"version":3,"file":"event-signal.d.ts","sourceRoot":"","sources":["../../src/core/event-signal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,IAAI,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACtD;;;OAGG;IACH,SAAS,CAAC,OAAO,wCAAkD;gBAEhD,MAAM,EAAE,YAAY;IAKvC;;;;;;OAMG;IACI,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI;CAMlC"}

package/dist/core/signal-base.d.ts

@@ -2,35 +2,43 @@ import type { Observer_, SubscribeOptions, SubscribeResult, ListenerCallback, Si
 import type { AlwatrLogger } from '@alwatr/logger';
 /**
  * An abstract base class for signal implementations.
+ * It provides the core functionality for managing subscriptions (observers).
  *
- * `SignalBase` provides the core functionality for managing subscriptions (observers).
- * It handles adding, removing, and notifying listeners. The responsibility of *when* to notify
- * is left to the concrete subclasses (`StateSignal`, `EventSignal`, etc.).
- *
- * @template T The type of data the signal will handle.
+ * @template T The type of data that the signal holds or dispatches.
  */
 export declare abstract class SignalBase<T> {
     protected config_: SignalConfig;
     /**
-     * The unique identifier for this signal instance. Useful for debugging.
+     * The unique identifier for this signal instance.
+     * Useful for debugging and logging.
      */
     readonly signalId: string;
+    /**
+     * The logger instance for this signal.
+     * @protected
+     */
     protected abstract logger_: AlwatrLogger;
     /**
      * The list of observers (listeners) subscribed to this signal.
      * @protected
      */
     protected readonly observers_: Observer_<T>[];
-    protected isDestroyed_: boolean;
+    /**
+     * A flag indicating whether the signal has been destroyed.
+     * @private
+     */
+    private isDestroyed__;
     /**
      * Indicates whether the signal has been destroyed.
      * A destroyed signal cannot be used and will throw an error if interacted with.
+     *
      * @returns `true` if the signal is destroyed, `false` otherwise.
      */
     get isDestroyed(): boolean;
     constructor(config_: SignalConfig);
     /**
      * Removes a specific observer from the observers list.
+     *
      * @param observer The observer instance to remove.
      * @protected
      */
@@ -82,6 +90,6 @@ export declare abstract class SignalBase<T> {
      * This is a safeguard to prevent interaction with a defunct signal.
      * @protected
      */
-    protected checkDestroyed_: () => void;
+    protected checkDestroyed_(): void;
 }
 //# sourceMappingURL=signal-base.d.ts.map

package/dist/core/signal-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signal-base.d.ts","sourceRoot":"","sources":["../../src/core/signal-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAC,MAAM,YAAY,CAAC;AAC7G,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAGjD;;;;;;;;GAQG;AACH,8BAAsB,UAAU,CAAC,CAAC;IAyBb,SAAS,CAAC,OAAO,EAAE,YAAY;IAxBlD;;OAEG;IACH,SAAgB,QAAQ,EAAE,MAAM,CAAyB;IAEzD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAEzC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAM;IAEnD,SAAS,CAAC,YAAY,UAAS;IAE/B;;;;OAIG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;gBAE4B,OAAO,EAAE,YAAY;IAElD;;;;OAIG;IACH,SAAS,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAYvD;;;;;;;;OAQG;IACI,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe;IAoB5F;;;;;;;;OAQG;IACH,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAkCjC;;;;;;;;;;;;OAYG;IACI,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC;IAY9B;;;;;;OAMG;IACI,OAAO,IAAI,IAAI;IAStB;;;;OAIG;IACH,SAAS,CAAC,eAAe,QAAO,IAAI,CAKlC;CACH"}
+{"version":3,"file":"signal-base.d.ts","sourceRoot":"","sources":["../../src/core/signal-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAC,MAAM,YAAY,CAAC;AAC7G,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAGjD;;;;;GAKG;AACH,8BAAsB,UAAU,CAAC,CAAC;IAmCb,SAAS,CAAC,OAAO,EAAE,YAAY;IAlClD;;;OAGG;IACH,SAAgB,QAAQ,SAAyB;IAEjD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAEzC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAM;IAEnD;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAS;IAE9B;;;;;OAKG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;gBAE4B,OAAO,EAAE,YAAY;IAElD;;;;;OAKG;IACH,SAAS,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAcvD;;;;;;;;OAQG;IACI,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe;IAoB5F;;;;;;;;OAQG;IACH,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IA6BjC;;;;;;;;;;;;OAYG;IACI,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC;IAY9B;;;;;;OAMG;IACI,OAAO,IAAI,IAAI;IAYtB;;;;OAIG;IACH,SAAS,CAAC,eAAe,IAAI,IAAI;CAMlC"}

package/dist/core/state-signal.d.ts

@@ -17,7 +17,7 @@ import type { StateSignalConfig, ListenerCallback, SubscribeOptions, SubscribeRe
  * });
  *
  * // Get the current value.
- * console.log(counter.value); // Outputs: 0
+ * console.log(counter.get()); // Outputs: 0
  *
  * // Subscribe to changes.
  * const subscription = counter.subscribe(newValue => {
@@ -34,7 +34,15 @@ import type { StateSignalConfig, ListenerCallback, SubscribeOptions, SubscribeRe
  * subscription.unsubscribe();
  */
 export declare class StateSignal<T> extends SignalBase<T> implements IReadonlySignal<T> {
+    /**
+     * The current value of the signal.
+     * @private
+     */
     private value__;
+    /**
+     * The logger instance for this signal.
+     * @protected
+     */
     protected logger_: import("@alwatr/logger").AlwatrLogger;
     constructor(config: StateSignalConfig<T>);
     /**
@@ -43,9 +51,9 @@ export declare class StateSignal<T> extends SignalBase<T> implements IReadonlySi
      * @returns The current value.
      *
      * @example
-     * console.log(mySignal.value);
+     * console.log(mySignal.get());
      */
-    get value(): T;
+    get(): T;
     /**
      * Updates the signal's value and notifies all active listeners.
      *
@@ -59,7 +67,7 @@ export declare class StateSignal<T> extends SignalBase<T> implements IReadonlySi
      * mySignal.set(42);
      *
      * // For object types, it's best practice to set an immutable new object.
-     * mySignal.set({ ...mySignal.value, property: 'new-value' });
+     * mySignal.set({ ...mySignal.get(), property: 'new-value' });
      */
     set(newValue: T): void;
     /**

package/dist/core/state-signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-signal.d.ts","sourceRoot":"","sources":["../../src/core/state-signal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,EAAC,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAC,MAAM,YAAY,CAAC;AAExH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAC7E,OAAO,CAAC,OAAO,CAAI;IACnB,SAAS,CAAC,OAAO,wCAAkD;gBAEhD,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAM/C;;;;;;;OAOG;IACH,IAAW,KAAK,IAAI,CAAC,CAGpB;IAED;;;;;;;;;;;;;;OAcG;IACI,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI;IAe7B;;;;;;;;;;;;;;OAcG;IACI,MAAM,CAAC,OAAO,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI;IAQrD;;;;;;;;;OASG;IACa,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe;IA4BzG;;;OAGG;IACa,OAAO,IAAI,IAAI;CAKhC"}
+{"version":3,"file":"state-signal.d.ts","sourceRoot":"","sources":["../../src/core/state-signal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,EAAC,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAC,MAAM,YAAY,CAAC;AAExH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAC7E;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAI;IAEnB;;;OAGG;IACH,SAAS,CAAC,OAAO,wCAAkD;gBAEhD,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAM/C;;;;;;;OAOG;IACI,GAAG,IAAI,CAAC;IAKf;;;;;;;;;;;;;;OAcG;IACI,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI;IAe7B;;;;;;;;;;;;;;OAcG;IACI,MAAM,CAAC,OAAO,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI;IAQrD;;;;;;;;;OASG;IACa,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe;IAwBzG;;;OAGG;IACa,OAAO,IAAI,IAAI;CAIhC"}

package/dist/creators/computed.d.ts

@@ -22,10 +22,10 @@ import type { ComputedSignalConfig } from '../type.js';
  * const fullName = createComputedSignal({
  *   signalId: 'fullName',
  *   deps: [firstName, lastName],
- *   get: () => `${firstName.value} ${lastName.value}`,
+ *   get: () => `${firstName.get()} ${lastName.get()}`,
  * });
  *
- * console.log(fullName.value); // "John Doe"
+ * console.log(fullName.get()); // "John Doe"
  *
  * // IMPORTANT: Always destroy a computed signal when no longer needed.
  * // fullName.destroy();

package/dist/creators/effect.d.ts

@@ -23,7 +23,7 @@ import type { EffectSignalConfig } from '../type.js';
  * const analyticsEffect = createEffect({
  *   deps: [counter, user],
  *   run: () => {
- *     console.log(`Analytics: User '${user.value}' clicked ${counter.value} times.`);
+ *     console.log(`Analytics: User '${user.get()}' clicked ${counter.get()} times.`);
  *   },
  *   runImmediately: true, // Optional: run once on creation
  * });

package/dist/creators/state.d.ts

@@ -17,9 +17,9 @@ import type { StateSignalConfig } from '../type.js';
  *   initialValue: 0,
  * });
  *
- * console.log(counter.value); // Outputs: 0
+ * console.log(counter.get()); // Outputs: 0
  * counter.set(1);
- * console.log(counter.value); // Outputs: 1
+ * console.log(counter.get()); // Outputs: 1
  */
 export declare function createStateSignal<T>(config: StateSignalConfig<T>): StateSignal<T>;
 //# sourceMappingURL=state.d.ts.map