@alwatr/signal 5.2.1 → 6.0.0

package/CHANGELOG.md

@@ -3,6 +3,47 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [6.0.0](https://github.com/Alwatr/flux/compare/v5.2.2...v6.0.0) (2025-09-19)
+
+### ✨ Features
+
+* add asReadonly method to StateSignal for improved interface exposure ([e8be13a](https://github.com/Alwatr/flux/commit/e8be13aa1b49c0e67b8022b0bef02fb80e5499f4))
+
+### 🐛 Bug Fixes
+
+* remove space in logger initialization for signal classes ([6e3b071](https://github.com/Alwatr/flux/commit/6e3b0710b67f67849c4dce390e9bfa7b2f80a9f7))
+
+### 🔨 Code Refactoring
+
+* enhance logging during EffectSignal construction for dependency subscriptions ([062da7e](https://github.com/Alwatr/flux/commit/062da7e5a91070576579731ac21870ffcafa7033))
+* enhance logging in update method to track value changes ([5b0bb00](https://github.com/Alwatr/flux/commit/5b0bb000a7aeb37ab90405f34959b230ca575232))
+* replace signalId with name in signal implementation ([0c2f065](https://github.com/Alwatr/flux/commit/0c2f065bb0afa49980537e42773cbbf21013a2a3))
+* update internal signal name format and enhance logging during dependency subscription ([1670726](https://github.com/Alwatr/flux/commit/1670726059b77b058b9daa3841bb7bb1ded61af3))
+
+### 🔗 Dependencies update
+
+* update @alwatr/logger to version 6.0.2 and @types/node to version 22.18.6; upgrade esbuild and other dependencies ([95dfaba](https://github.com/Alwatr/flux/commit/95dfabab2a4d4ea2b0e42a70bee1f3e68a67bffc))
+* update dependencies for logger, nano-build, type-helper, and node types ([23fe723](https://github.com/Alwatr/flux/commit/23fe7236ffa0bfd2551a6dfc52c23689ce4b036e))
+* update package dependencies for improved compatibility and performance ([1e91063](https://github.com/Alwatr/flux/commit/1e9106343d01330089c33d9591969a66625a1e7b))
+
+## [5.2.2](https://github.com/Alwatr/flux/compare/v5.2.1...v5.2.2) (2025-09-15)
+
+### 🐛 Bug Fixes
+
+* update subscription to prevent receiving previous value in debounced signal ([044780d](https://github.com/Alwatr/flux/commit/044780d35427a97711788224e60e209fb53dea53))
+* update subscription to trigger debouncer with value from source signal ([a7e8eff](https://github.com/Alwatr/flux/commit/a7e8effd7e963aaf905afae08a652d7abe222c3a))
+
+### 🔨 Code Refactoring
+
+* improve logging in subscribe method to pass options directly ([e026dbf](https://github.com/Alwatr/flux/commit/e026dbf74ca96ec6d878bd5fb08f4939c46d08f2))
+* simplify signalId assignment using nullish coalescing operator ([0578c85](https://github.com/Alwatr/flux/commit/0578c854677df2fe0a62e5fbbfa017856d82b611))
+* update logging in subscribe method to pass options directly ([a7e32f2](https://github.com/Alwatr/flux/commit/a7e32f20df6b12c1c9dd06feaf01fca8170a5346))
+
+### 🧹 Miscellaneous Chores
+
+* update @alwatr/debounce dependency to version 1.1.1 ([c2e2ae4](https://github.com/Alwatr/flux/commit/c2e2ae4fe54f8fdd482bd53b598f5e88570a26f2))
+* update package dependencies to latest versions ([a517c82](https://github.com/Alwatr/flux/commit/a517c82b99073a65a8470da428dfd288080b7ea5))
+
 ## [5.2.1](https://github.com/Alwatr/flux/compare/v5.2.0...v5.2.1) (2025-09-15)
 
 ### ⚡ Performance Improvements

package/README.md

@@ -4,6 +4,12 @@ Alwatr Signal is a powerful, lightweight, and modern reactive programming librar
 
 It's designed to be simple to learn, yet capable of handling complex state management scenarios.
 
+[](https://www.google.com/search?q=https://www.npmjs.com/package/%40alwatr/signal)
+[](https://www.google.com/search?q=https://www.npmjs.com/package/%40alwatr/flux)
+[](https://www.google.com/search?q=alwatr+signal)
+[](https://www.google.com/search?q=alwatr+flux)
+[](https://www.google.com/search?q=alwatr)
+
 ## Features
 
 - **Type-Safe**: Fully implemented in TypeScript for robust, type-safe code.
@@ -11,7 +17,7 @@ It's designed to be simple to learn, yet capable of handling complex state manag
 - **Performant**: Smart change detection and batched updates prevent unnecessary computations and re-renders.
 - **Predictable**: Asynchronous, non-blocking notifications ensure a consistent and understandable data flow.
 - **Lifecycle Management**: Built-in `destroy()` methods for easy cleanup and memory leak prevention.
-- **Easy to Debug**: Unique `signalId` for each signal makes logging and tracing a breeze.
+- **Easy to Debug**: Unique `name` for each signal makes logging and tracing a breeze.
 
 ## Core Concepts
 
@@ -48,13 +54,13 @@ import {StateSignal} from '@alwatr/signal';
 
 // A signal to hold the user's first name.
 const firstName = new StateSignal<string>({
-  signalId: 'user-firstName',
+  name: 'user-firstName',
   initialValue: 'John',
 });
 
 // A signal to hold a simple counter.
 const counter = new StateSignal<number>({
-  signalId: 'app-counter',
+  name: 'app-counter',
   initialValue: 0,
 });
 ```
@@ -67,7 +73,7 @@ A `ComputedSignal` combines other signals into a new, read-only value. Let's cre
 import {ComputedSignal} from '@alwatr/signal';
 
 const fullName = new ComputedSignal<string>({
-  signalId: 'user-fullName',
+  name: 'user-fullName',
   deps: [firstName], // This computed signal depends on firstName.
   get: () => `User: ${firstName.get()}`,
 });
@@ -165,7 +171,7 @@ The `subscribe` method accepts an optional second argument to customize its beha
 ### `StateSignal<T>`
 
 - **`constructor(config)`**: Creates a new state signal.
-  - `config.signalId`: `string`
+  - `config.name`: `string`
   - `config.initialValue`: `T`
 - **`.get()`**: `T` - Gets the current value.
 - **`.set(newValue: T)`**: Sets a new value and notifies listeners.
@@ -173,7 +179,7 @@ The `subscribe` method accepts an optional second argument to customize its beha
 ### `ComputedSignal<T>`
 
 - **`constructor(config)`**: Creates a new computed signal.
-  - `config.signalId`: `string`
+  - `config.name`: `string`
   - `config.deps`: `IReadonlySignal<unknown>[]` - Array of dependency signals.
   - `config.get`: `() => T` - The function to compute the value.
 - **`.get()`**: `T` - Gets the current (memoized) value.
@@ -190,7 +196,7 @@ The `subscribe` method accepts an optional second argument to customize its beha
 ### `EventSignal<T>`
 
 - **`constructor(config)`**: Creates a new event signal.
-  - `config.signalId`: `string`
+  - `config.name`: `string`
 - **`.dispatch(payload: T)`**: Dispatches an event to all listeners.
 
 ### Common Methods
@@ -219,6 +225,12 @@ Contributions are welcome! Please read our [contribution guidelines](https://git
 
 طراحی آن به گونه‌ای است که یادگیری آن ساده باشد، اما در عین حال قادر به مدیریت سناریوهای پیچیده مدیریت وضعیت نیز باشد.
 
+[](https://www.google.com/search?q=https://www.npmjs.com/package/%40alwatr/signal)
+[](https://www.google.com/search?q=https://www.npmjs.com/package/%40alwatr/flux)
+[](https://www.google.com/search?q=alwatr+signal)
+[](https://www.google.com/search?q=alwatr+flux)
+[](https://www.google.com/search?q=alwatr)
+
 ## ویژگی‌ها
 
 - **ایمنی نوع (Type-Safe)**: به طور کامل با TypeScript پیاده‌سازی شده تا کدی قوی و ایمن از نظر نوع داشته باشید.
@@ -226,7 +238,7 @@ Contributions are welcome! Please read our [contribution guidelines](https://git
 - **عملکرد بالا**: تشخیص هوشمند تغییرات و به‌روزرسانی‌های دسته‌ای از محاسبات و رندرهای غیرضروری جلوگیری می‌کند.
 - **پیش‌بینی‌پذیر**: نوتیفیکیشن‌های ناهمزمان (asynchronous) و غیرمسدودکننده (non-blocking) جریان داده‌ای سازگار و قابل فهم را تضمین می‌کنند.
 - **مدیریت چرخه حیات (Lifecycle)**: متدهای داخلی `destroy()` برای پاک‌سازی آسان و جلوگیری از نشت حافظه (memory leak).
-- **اشکال‌زدایی آسان**: شناسه‌های منحصر به فرد (`signalId`) برای هر سیگنال، لاگ‌گیری و ردیابی را بسیار ساده می‌کند.
+- **اشکال‌زدایی آسان**: شناسه‌های منحصر به فرد (`name`) برای هر سیگنال، لاگ‌گیری و ردیابی را بسیار ساده می‌کند.
 
 ## مفاهیم اصلی
 
@@ -263,13 +275,13 @@ import {StateSignal} from '@alwatr/signal';
 
 // سیگنالی برای نگهداری نام کوچک کاربر
 const firstName = new StateSignal<string>({
-  signalId: 'user-firstName',
+  name: 'user-firstName',
   initialValue: 'John',
 });
 
 // سیگنالی برای نگهداری یک شمارنده ساده
 const counter = new StateSignal<number>({
-  signalId: 'app-counter',
+  name: 'app-counter',
   initialValue: 0,
 });
 ```
@@ -282,7 +294,7 @@ const counter = new StateSignal<number>({
 import {ComputedSignal} from '@alwatr/signal';
 
 const fullName = new ComputedSignal<string>({
-  signalId: 'user-fullName',
+  name: 'user-fullName',
   deps: [firstName], // این سیگنال محاسباتی به firstName وابسته است
   get: () => `User: ${firstName.get()}`,
 });
@@ -380,7 +392,7 @@ Alwatr Signal از یک مدل ناهمزمان قابل پیش‌بینی بر
 ### `StateSignal<T>`
 
 - **`constructor(config)`**: یک سیگنال وضعیت جدید ایجاد می‌کند.
-  - `config.signalId`: `string`
+  - `config.name`: `string`
   - `config.initialValue`: `T`
 - **`.get()`**: `T` - مقدار فعلی را دریافت می‌کند.
 - **`.set(newValue: T)`**: مقدار جدیدی را تنظیم کرده و شنوندگان را مطلع می‌کند.
@@ -388,7 +400,7 @@ Alwatr Signal از یک مدل ناهمزمان قابل پیش‌بینی بر
 ### `ComputedSignal<T>`
 
 - **`constructor(config)`**: یک سیگنال محاسباتی جدید ایجاد می‌کند.
-  - `config.signalId`: `string`
+  - `config.name`: `string`
   - `config.deps`: `IReadonlySignal<unknown>[]` - آرایه‌ای از سیگنال‌های وابسته.
   - `config.get`: `() => T` - تابعی برای محاسبه مقدار.
 - **`.get()`**: `T` - مقدار فعلی (کش شده) را دریافت می‌کند.
@@ -405,7 +417,7 @@ Alwatr Signal از یک مدل ناهمزمان قابل پیش‌بینی بر
 ### `EventSignal<T>`
 
 - **`constructor(config)`**: یک سیگنال رویداد جدید ایجاد می‌کند.
-  - `config.signalId`: `string`
+  - `config.name`: `string`
 - **`.dispatch(payload: T)`**: یک رویداد را به تمام شنوندگان ارسال می‌کند.
 
 ### متدهای مشترک

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

@@ -14,12 +14,12 @@ import type { ComputedSignalConfig, IReadonlySignal, SubscribeResult, SubscribeO
  *
  * @example
  * // --- Create dependency signals ---
- * const firstName = new StateSignal({ signalId: 'firstName', initialValue: 'John' });
- * const lastName = new StateSignal({ signalId: 'lastName', initialValue: 'Doe' });
+ * const firstName = new StateSignal({ name: 'firstName', initialValue: 'John' });
+ * const lastName = new StateSignal({ name: 'lastName', initialValue: 'Doe' });
  *
  * // --- Create a computed signal ---
  * const fullName = new ComputedSignal({
- *   signalId: 'fullName',
+ *   name: 'fullName',
  *   deps: [firstName, lastName],
  *   get: () => `${firstName.get()} ${lastName.get()}`,
  * });
@@ -43,7 +43,7 @@ export declare class ComputedSignal<T> implements IReadonlySignal<T> {
     /**
      * The unique identifier for this signal instance.
      */
-    readonly signalId: string;
+    readonly name: string;
     /**
      * The logger instance for this signal.
      * @protected

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,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"}
+{"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,IAAI,SAAqB;IAEzC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,wCAAgD;IAE1E;;;;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;IAW7D;;;;;;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

@@ -14,12 +14,12 @@ import type { EffectSignalConfig, IEffectSignal } from '../type.js';
  *
  * @example
  * // --- Create dependency signals ---
- * const counter = new StateSignal({ initialValue: 0, signalId: 'counter' });
- * const user = new StateSignal({ initialValue: 'guest', signalId: 'user' });
+ * const counter = new StateSignal({ initialValue: 0, name: 'counter' });
+ * const user = new StateSignal({ initialValue: 'guest', name: 'user' });
  *
  * // --- Create an effect ---
  * const analyticsEffect = new EffectSignal({
- *   signalId: 'analytics-effect',
+ *   name: 'analytics-effect',
  *   deps: [counter, user],
  *   run: () => {
  *     console.log(`Analytics: User '${user.get()}' clicked ${counter.get()} times.`);
@@ -43,7 +43,7 @@ export declare class EffectSignal implements IEffectSignal {
     /**
      * The unique identifier for this signal instance.
      */
-    readonly signalId: string;
+    readonly name: string;
     /**
      * The logger instance for this signal.
      * @protected

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"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,IAAI,SAAmF;IAEvG;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,wCAA8C;IAExE;;;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;IAmBxD;;;;;;;OAOG;cACa,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCnD;;;;;;OAMG;IACI,OAAO,IAAI,IAAI;CAmBvB"}

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

@@ -12,7 +12,7 @@ import type { SignalConfig } from '../type.js';
  *
  * @example
  * // Create a signal for user click events.
- * const onUserClick = new EventSignal<{ x: number, y: number }>({ signalId: 'on-user-click' });
+ * const onUserClick = new EventSignal<{ x: number, y: number }>({ name: 'on-user-click' });
  *
  * // Subscribe to the event.
  * onUserClick.subscribe(clickPosition => {
@@ -23,7 +23,7 @@ import type { SignalConfig } from '../type.js';
  * onUserClick.dispatch({ x: 100, y: 250 }); // Notifies the listener.
  *
  * // --- Example with no payload ---
- * const onAppReady = new EventSignal({ signalId: 'on-app-ready' });
+ * const onAppReady = new EventSignal({ name: 'on-app-ready' });
  * onAppReady.subscribe(() => console.log('Application is ready!'));
  * onAppReady.dispatch(); // Notifies the listener.
  */

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;;;OAGG;IACH,SAAS,CAAC,OAAO,wCAAkD;gBAEhD,MAAM,EAAE,YAAY;IAKvC;;;;;;OAMG;IACI,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI;CAMlC"}
+{"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,wCAA6C;gBAE3C,MAAM,EAAE,YAAY;IAKvC;;;;;;OAMG;IACI,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI;CAMlC"}

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

@@ -12,7 +12,7 @@ export declare abstract class SignalBase<T> {
      * The unique identifier for this signal instance.
      * Useful for debugging and logging.
      */
-    readonly signalId: string;
+    readonly name: string;
     /**
      * The logger instance for this signal.
      * @protected

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;;;;;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"}
+{"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,IAAI,SAAqB;IAEzC;;;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

@@ -12,7 +12,7 @@ import type { StateSignalConfig, ListenerCallback, SubscribeOptions, SubscribeRe
  * @example
  * // Create a new state signal with an initial value.
  * const counter = new StateSignal<number>({
- *   signalId: 'counter-signal',
+ *   name: 'counter-signal',
  *   initialValue: 0,
  * });
  *
@@ -102,5 +102,6 @@ export declare class StateSignal<T> extends SignalBase<T> implements IReadonlySi
      * This is crucial for memory management to prevent leaks.
      */
     destroy(): void;
+    asReadonly(): IReadonlySignal<T>;
 }
 //# sourceMappingURL=state-signal.d.ts.map

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;;;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"}
+{"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,wCAA6C;gBAE3C,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;IAOrD;;;;;;;;;OASG;IACa,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe;IA2BzG;;;OAGG;IACa,OAAO,IAAI,IAAI;IAKxB,UAAU,IAAI,eAAe,CAAC,CAAC,CAAC;CAGxC"}

package/dist/creators/computed.d.ts

@@ -16,11 +16,11 @@ import type { ComputedSignalConfig } from '../type.js';
  * @returns A new, read-only computed signal.
  *
  * @example
- * const firstName = createStateSignal({ signalId: 'firstName', initialValue: 'John' });
- * const lastName = createStateSignal({ signalId: 'lastName', initialValue: 'Doe' });
+ * const firstName = createStateSignal({ name: 'firstName', initialValue: 'John' });
+ * const lastName = createStateSignal({ name: 'lastName', initialValue: 'Doe' });
  *
  * const fullName = createComputedSignal({
- *   signalId: 'fullName',
+ *   name: 'fullName',
  *   deps: [firstName, lastName],
  *   get: () => `${firstName.get()} ${lastName.get()}`,
  * });

package/dist/creators/effect.d.ts

@@ -16,8 +16,8 @@ import type { EffectSignalConfig } from '../type.js';
  *
  * @example
  * // --- Create dependency signals ---
- * const counter = createStateSignal({ initialValue: 0, signalId: 'counter' });
- * const user = createStateSignal({ initialValue: 'guest', signalId: 'user' });
+ * const counter = createStateSignal({ initialValue: 0, name: 'counter' });
+ * const user = createStateSignal({ initialValue: 'guest', name: 'user' });
  *
  * // --- Create an effect ---
  * const analyticsEffect = createEffect({

package/dist/creators/event.d.ts

@@ -15,7 +15,7 @@ import type { SignalConfig } from '../type.js';
  *
  * @example
  * const onUserClick = createEventSignal<{ x: number, y: number }>({
- *   signalId: 'on-user-click'
+ *   name: 'on-user-click'
  * });
  *
  * onUserClick.subscribe(pos => {

package/dist/creators/state.d.ts

@@ -13,7 +13,7 @@ import type { StateSignalConfig } from '../type.js';
  *
  * @example
  * const counter = createStateSignal({
- *   signalId: 'counter-signal',
+ *   name: 'counter-signal',
  *   initialValue: 0,
  * });
  *