@alwatr/signal 5.2.2 → 6.0.0

package/dist/type.d.ts

@@ -93,7 +93,7 @@ export interface SignalConfig {
      * 'user-profile-signal'
      * 'app-theme-signal'
      */
-    signalId: string;
+    name: string;
     /**
      * An optional callback function that will be executed when the signal's `destroy` method is called.
      * This is useful for cleaning up additional resources used by the signal,
@@ -122,7 +122,7 @@ export interface IReadonlySignal<T> {
     /**
      * The unique identifier for this signal instance. Useful for debugging.
      */
-    readonly signalId: string;
+    readonly name: string;
     /**
      * The current value of the signal.
      */
@@ -207,7 +207,7 @@ export interface EffectSignalConfig {
      * 'user-profile-signal'
      * 'app-theme-signal'
      */
-    signalId?: string;
+    name?: string;
     /**
      * An array of dependency signals (`StateSignal` or `ComputedSignal` instances).
      * The effect's `run` function will be executed whenever any of these signals change.
@@ -246,7 +246,7 @@ export interface IEffectSignal {
     /**
      * The unique identifier for this signal instance.
      */
-    signalId: string;
+    name: string;
     /**
      * Permanently disposes of the effect, unsubscribing from all dependencies
      * and stopping any future executions. This is crucial for preventing memory leaks
@@ -270,9 +270,9 @@ export interface DebounceSignalConfig extends Omit<DebouncerConfig<never>, 'func
     /**
      * A unique identifier for the signal. This is crucial for debugging and differentiating signals.
      *
-     * @default `${sourceSignal.signalId}-debounced`
+     * @default `${sourceSignal.name}-debounced`
      */
-    signalId?: string;
+    name?: string;
     /**
      * An optional callback executed when the signal's `destroy` method is called.
      * Useful for cleaning up resources tied to the debounced signal.

package/dist/type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,21 +1,21 @@
 {
   "name": "@alwatr/signal",
   "description": "Alwatr Signal is a powerful, lightweight, and modern reactive programming library. It is inspired by the best concepts from major reactive libraries but engineered to be faster and more efficient than all of them. It provides a robust and elegant way to manage application state through a system of signals, offering fine-grained reactivity, predictability, and excellent performance.",
-  "version": "5.2.2",
+  "version": "6.0.0",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "bugs": "https://github.com/Alwatr/flux/issues",
   "dependencies": {
-    "@alwatr/debounce": "^1.1.2",
-    "@alwatr/delay": "^6.0.5",
-    "@alwatr/logger": "^6.0.1"
+    "@alwatr/debounce": "^1.1.3",
+    "@alwatr/delay": "^6.0.6",
+    "@alwatr/logger": "^6.0.3"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "^6.2.0",
+    "@alwatr/nano-build": "^6.2.1",
     "@alwatr/prettier-config": "^5.0.3",
     "@alwatr/tsconfig-base": "^6.0.1",
-    "@alwatr/type-helper": "^6.0.2",
+    "@alwatr/type-helper": "^6.1.0",
     "@jest/globals": "^30.1.2",
-    "@types/node": "^22.18.3",
+    "@types/node": "^22.18.6",
     "jest": "^30.1.3",
     "typescript": "^5.9.2"
   },
@@ -68,5 +68,5 @@
   },
   "type": "module",
   "types": "./dist/main.d.ts",
-  "gitHead": "c166edf9ae27929a21678ea65d23556cb7d9286a"
+  "gitHead": "ca38674339f4836ffcce1e1801c7ccb6b58c90f2"
 }

package/src/core/computed-signal.test.js

@@ -9,13 +9,13 @@ describe('ComputedSignal', () => {
   let dep2;
   /** @type {ComputedSignal<number>} */
   let signal;
-  const signalId = 'test-computed-signal';
+  const name = 'test-computed-signal';
 
   beforeEach(() => {
-    dep1 = new StateSignal({signalId: 'dep1', initialValue: 1});
-    dep2 = new StateSignal({signalId: 'dep2', initialValue: 2});
+    dep1 = new StateSignal({name: 'dep1', initialValue: 1});
+    dep2 = new StateSignal({name: 'dep2', initialValue: 2});
     signal = new ComputedSignal({
-      signalId,
+      name,
       deps: [dep1, dep2],
       get: () => dep1.get() + dep2.get(),
     });
@@ -27,10 +27,10 @@ describe('ComputedSignal', () => {
     dep2.destroy();
   });
 
-  it('should be defined and have the correct signalId and initial value', () => {
+  it('should be defined and have the correct name and initial value', () => {
     expect(ComputedSignal).toBeDefined();
     expect(signal).toBeInstanceOf(ComputedSignal);
-    expect(signal.signalId).toBe(signalId);
+    expect(signal.name).toBe(name);
     expect(signal.get()).toBe(3); // 1 + 2
   });
 
@@ -120,7 +120,7 @@ describe('ComputedSignal', () => {
 
   it('should handle no dependencies', () => {
     const noDepSignal = new ComputedSignal({
-      signalId: 'no-dep',
+      name: 'no-dep',
       deps: [],
       get: () => 42,
     });

package/src/core/effect-signal.test.js

@@ -9,7 +9,7 @@ describe('EffectSignal', () => {
   let effectSignal;
 
   beforeEach(() => {
-    depSignal = new StateSignal({signalId: 'dep', initialValue: 0});
+    depSignal = new StateSignal({name: 'dep', initialValue: 0});
   });
 
   afterEach(() => {
@@ -79,7 +79,7 @@ describe('EffectSignal', () => {
   });
 
   it('should handle multiple dependencies', async () => {
-    const depSignal2 = new StateSignal({signalId: 'dep2', initialValue: 'a'});
+    const depSignal2 = new StateSignal({name: 'dep2', initialValue: 'a'});
     const runFn = jest.fn();
     effectSignal = new EffectSignal({
       deps: [depSignal, depSignal2],

package/src/core/event-signal.test.js

@@ -5,20 +5,20 @@ import {delay} from '@alwatr/delay';
 describe('EventSignal', () => {
   /** @type {EventSignal<unknown>} */
   let signal;
-  const signalId = 'test-event-signal';
+  const name = 'test-event-signal';
 
   beforeEach(() => {
-    signal = new EventSignal({signalId});
+    signal = new EventSignal({name});
   });
 
   afterEach(() => {
     signal.destroy();
   });
 
-  it('should be defined and have the correct signalId', () => {
+  it('should be defined and have the correct name', () => {
     expect(EventSignal).toBeDefined();
     expect(signal).toBeInstanceOf(EventSignal);
-    expect(signal.signalId).toBe(signalId);
+    expect(signal.name).toBe(name);
   });
 
   it('should dispatch an event and notify a subscriber with the correct payload', async () => {
@@ -85,7 +85,7 @@ describe('EventSignal', () => {
   });
 
   it('should handle dispatching without a payload (void)', async () => {
-    const voidSignal = new EventSignal({signalId: 'void-signal'});
+    const voidSignal = new EventSignal({name: 'void-signal'});
     const callback = jest.fn();
     voidSignal.subscribe(callback);
 
@@ -162,25 +162,41 @@ describe('EventSignal', () => {
     await expect(secondPromise).resolves.toBe(payload);
   });
 
+  it('should multiple dispatch calls notify subscribers each time', async () => {
+    const callback = jest.fn();
+    signal.subscribe(callback);
+
+    signal.dispatch(1);
+    signal.dispatch(2);
+    signal.dispatch(3);
+
+    await delay.nextMacrotask();
+
+    expect(callback).toHaveBeenCalledTimes(3);
+    expect(callback).toHaveBeenNthCalledWith(1, 1);
+    expect(callback).toHaveBeenNthCalledWith(2, 2);
+    expect(callback).toHaveBeenNthCalledWith(3, 3);
+  });
+
   describe('destroyed signal', () => {
     beforeEach(() => {
       signal.destroy();
     });
 
     it('should throw an error when dispatch is called on a destroyed signal', () => {
-      expect(() => signal.dispatch('test')).toThrow(`Cannot interact with a destroyed signal (id: ${signalId})`);
+      expect(() => signal.dispatch('test')).toThrow(`Cannot interact with a destroyed signal (id: ${name})`);
     });
 
     it('should throw an error when subscribe is called on a destroyed signal', () => {
-      expect(() => signal.subscribe(jest.fn())).toThrow(`Cannot interact with a destroyed signal (id: ${signalId})`);
+      expect(() => signal.subscribe(jest.fn())).toThrow(`Cannot interact with a destroyed signal (id: ${name})`);
     });
 
     it('should throw an error when untilNext is called on a destroyed signal', () => {
-      expect(() => signal.untilNext()).toThrow(`Cannot interact with a destroyed signal (id: ${signalId})`);
+      expect(() => signal.untilNext()).toThrow(`Cannot interact with a destroyed signal (id: ${name})`);
     });
 
     it('should not notify any listeners after being destroyed', async () => {
-      const localSignal = new EventSignal({signalId: 'local'});
+      const localSignal = new EventSignal({name: 'local'});
       const callback = jest.fn();
       localSignal.subscribe(callback);
 

package/src/core/state-signal.test.js

@@ -5,20 +5,20 @@ import {delay} from '@alwatr/delay';
 describe('StateSignal', () => {
   /** @type {StateSignal<number>} */
   let signal;
-  const signalId = 'test-state-signal';
+  const name = 'test-state-signal';
 
   beforeEach(() => {
-    signal = new StateSignal({signalId, initialValue: 0});
+    signal = new StateSignal({name, initialValue: 0});
   });
 
   afterEach(() => {
     signal.destroy();
   });
 
-  it('should be defined and have the correct signalId and initial value', () => {
+  it('should be defined and have the correct name and initial value', () => {
     expect(StateSignal).toBeDefined();
     expect(signal).toBeInstanceOf(StateSignal);
-    expect(signal.signalId).toBe(signalId);
+    expect(signal.name).toBe(name);
     expect(signal.get()).toBe(0);
   });
 
@@ -154,7 +154,7 @@ describe('StateSignal', () => {
   it('should notify subscribers multiple times for object values when they change', async () => {
     const callback = jest.fn();
     const value = {a: 1};
-    const signal = new StateSignal({signalId: 'object-signal', initialValue: value});
+    const signal = new StateSignal({name: 'object-signal', initialValue: value});
     
     signal.subscribe(callback, {receivePrevious: false});
 
@@ -221,23 +221,23 @@ describe('StateSignal', () => {
     });
 
     it('should throw an error when set is called on a destroyed signal', () => {
-      expect(() => signal.set(1)).toThrow(`Cannot interact with a destroyed signal (id: ${signalId})`);
+      expect(() => signal.set(1)).toThrow(`Cannot interact with a destroyed signal (id: ${name})`);
     });
 
     it('should throw an error when subscribe is called on a destroyed signal', () => {
-      expect(() => signal.subscribe(jest.fn())).toThrow(`Cannot interact with a destroyed signal (id: ${signalId})`);
+      expect(() => signal.subscribe(jest.fn())).toThrow(`Cannot interact with a destroyed signal (id: ${name})`);
     });
 
     it('should throw an error when untilNext is called on a destroyed signal', () => {
-      expect(() => signal.untilNext()).toThrow(`Cannot interact with a destroyed signal (id: ${signalId})`);
+      expect(() => signal.untilNext()).toThrow(`Cannot interact with a destroyed signal (id: ${name})`);
     });
 
     it('should throw an error when accessing value on a destroyed signal', () => {
-      expect(() => signal.get()).toThrow(`Cannot interact with a destroyed signal (id: ${signalId})`);
+      expect(() => signal.get()).toThrow(`Cannot interact with a destroyed signal (id: ${name})`);
     });
 
     it('should not notify any listeners after being destroyed', async () => {
-      const localSignal = new StateSignal({signalId: 'local', initialValue: 0});
+      const localSignal = new StateSignal({name: 'local', initialValue: 0});
       const callback = jest.fn();
       localSignal.subscribe(callback, {receivePrevious: false});
 

package/src/operators/debounce.test.js

@@ -6,7 +6,7 @@ describe('createDebouncedSignal', () => {
   let debouncedSignal;
   /** @type {StateSignal<number>} */
   let sourceSignal;
-  const signalId = 'test-debounce-signal';
+  const name = 'test-debounce-signal';
   /**
    * @type {import("jest-mock").Mock<import("jest-mock").UnknownFunction>}
    */
@@ -15,7 +15,7 @@ describe('createDebouncedSignal', () => {
   beforeEach(() => {
     mockFunc = jest.fn();
     jest.useFakeTimers();
-    sourceSignal = new StateSignal({signalId, initialValue: 0});
+    sourceSignal = new StateSignal({name, initialValue: 0});
   });
 
   afterEach(() => {
@@ -28,7 +28,7 @@ describe('createDebouncedSignal', () => {
   it('should create a debounced signal with default config', () => {
     debouncedSignal = createDebouncedSignal(sourceSignal, {delay: 100});
     expect(debouncedSignal.get()).toBe(0);
-    expect(debouncedSignal.signalId).toBe(`${signalId}-debounced`);
+    expect(debouncedSignal.name).toBe(`${name}-debounced`);
   });
 
   it('should debounce updates with trailing edge', async () => {
@@ -81,9 +81,9 @@ describe('createDebouncedSignal', () => {
     expect(onDestroyMock).toHaveBeenCalled();
   });
 
-  it('should use custom signalId if provided', () => {
-    debouncedSignal = createDebouncedSignal(sourceSignal, {delay: 100, signalId: 'custom-debounced'});
-    expect(debouncedSignal.signalId).toBe('custom-debounced');
+  it('should use custom name if provided', () => {
+    debouncedSignal = createDebouncedSignal(sourceSignal, {delay: 100, name: 'custom-debounced'});
+    expect(debouncedSignal.name).toBe('custom-debounced');
   });
 
   it('should handle multiple rapid updates correctly', async () => {