@hoosk/minisignals 1.0.4 → 1.0.5

package/README.md

@@ -1,8 +1,8 @@
 # @hoosk/minisignals
 
-The framework-agnostic core of the `minisignals` library. 
+The framework-agnostic core of the `minisignals` library.
 
-This package provides the fundamental reactive primitives: `signal`, `effect`, and `computed`. It has zero dependencies and is built for maximum performance and a minimal footprint.
+This package provides the fundamental reactive primitives: `signal`, `effect`, `computed`, `batch`, and `untracked`. It has zero dependencies and is built for maximum performance and a minimal footprint.
 
 ## Installation
 
@@ -13,7 +13,7 @@ npm install @hoosk/minisignals
 ## Basic Usage
 
 ```typescript
-import { signal, effect, computed } from '@hoosk/minisignals';
+import { signal, effect, computed, batch, untracked } from '@hoosk/minisignals';
 
 const count = signal(0);
 const double = computed(() => count.value * 2);
@@ -23,6 +23,12 @@ effect(() => {
 });
 
 count.value = 1; // Logs: Count: 1, Double: 2
+
+// Batch multiple writes into a single notification pass
+batch(() => {
+  count.value = 10;
+  count.value = 20;
+}); // Logs once: Count: 20, Double: 40
 ```
 
-For full documentation and advanced features (like Lazy Evaluation and Memory Safety), please refer to the [main repository README](../../README.md).
+For full documentation and advanced features, please refer to the [main repository README](../../README.md).

package/dist/computed.d.ts

@@ -1,5 +1,5 @@
-export interface Computed<T> {
-    readonly value: T;
+import { ReadonlySignal } from './signal';
+export interface Computed<T> extends ReadonlySignal<T> {
     /**
      * Stops the internal effect from observing dependencies.
      * Call this when the computed signal is no longer needed to prevent memory leaks.
@@ -14,4 +14,3 @@ export interface Computed<T> {
  * @returns A read-only signal with a dispose method.
  */
 export declare function computed<T>(fn: () => T): Computed<T>;
-//# sourceMappingURL=computed.d.ts.map

package/dist/computed.js

@@ -9,14 +9,16 @@ import { effect } from './effect';
  */
 export function computed(fn) {
     let initialized = false;
-    let internalSignal;
+    let internalSignal = null;
     let unsubscribe = null;
     let isDisposed = false;
     return {
         get value() {
             if (isDisposed) {
-                if (!initialized)
-                    return fn();
+                if (!initialized) {
+                    internalSignal = signal(fn());
+                    initialized = true;
+                }
                 return internalSignal.value;
             }
             if (!initialized) {

package/dist/effect.d.ts

@@ -2,13 +2,12 @@ export type SubscriberSet = Set<() => void>;
 interface ActiveEffect {
     run: () => void;
     deps: Set<SubscriberSet>;
+    isRunning: boolean;
+    needsRerun: boolean;
 }
-export declare let activeEffect: ActiveEffect | null;
-/**
- * Creates an effect that runs immediately and tracks dependencies.
- * @param fn The function to execute.
- * @returns An unsubscribe function.
- */
+export declare function getActiveEffect(): ActiveEffect | null;
+export declare function scheduleSubs(subscribers: SubscriberSet): void;
+export declare function batch<T>(fn: () => T): T;
+export declare function untracked<T>(fn: () => T): T;
 export declare function effect(fn: () => void): () => void;
 export {};
-//# sourceMappingURL=effect.d.ts.map

package/dist/effect.js

@@ -1,29 +1,96 @@
-export let activeEffect = null;
+let _activeEffect = null;
+export function getActiveEffect() {
+    return _activeEffect;
+}
+// --- Batch scheduling ---
+let _batchDepth = 0;
+const _pendingNotifications = new Set();
+export function scheduleSubs(subscribers) {
+    if (_batchDepth > 0) {
+        for (const sub of subscribers) {
+            _pendingNotifications.add(sub);
+        }
+    }
+    else {
+        for (const sub of [...subscribers]) {
+            sub();
+        }
+    }
+}
+export function batch(fn) {
+    _batchDepth++;
+    try {
+        return fn();
+    }
+    finally {
+        _batchDepth--;
+        if (_batchDepth === 0) {
+            const pending = [..._pendingNotifications];
+            _pendingNotifications.clear();
+            for (const sub of pending) {
+                sub();
+            }
+        }
+    }
+}
+// --- Untracked read ---
+export function untracked(fn) {
+    const previous = _activeEffect;
+    _activeEffect = null;
+    try {
+        return fn();
+    }
+    finally {
+        _activeEffect = previous;
+    }
+}
+// --- Effect ---
 /**
  * Creates an effect that runs immediately and tracks dependencies.
  * @param fn The function to execute.
  * @returns An unsubscribe function.
  */
+const MAX_EFFECT_ITERATIONS = 100;
 export function effect(fn) {
     const effectObj = {
         run() {
-            cleanup(effectObj);
-            const previousEffect = activeEffect;
-            activeEffect = effectObj;
+            if (effectObj.isRunning) {
+                effectObj.needsRerun = true;
+                return;
+            }
+            effectObj.isRunning = true;
+            let iterations = 0;
             try {
-                fn();
+                do {
+                    if (++iterations > MAX_EFFECT_ITERATIONS) {
+                        throw new Error('Circular dependency detected: effect exceeded maximum re-run limit');
+                    }
+                    effectObj.needsRerun = false;
+                    cleanup(effectObj);
+                    const previousEffect = _activeEffect;
+                    _activeEffect = effectObj;
+                    try {
+                        fn();
+                    }
+                    finally {
+                        _activeEffect = previousEffect;
+                    }
+                } while (effectObj.needsRerun);
             }
             finally {
-                activeEffect = previousEffect;
+                effectObj.isRunning = false;
             }
         },
-        deps: new Set()
+        deps: new Set(),
+        isRunning: false,
+        needsRerun: false,
     };
     function cleanup(eff) {
         for (const depSet of eff.deps) {
             depSet.delete(eff.run);
         }
         eff.deps.clear();
+        _pendingNotifications.delete(eff.run);
     }
     effectObj.run();
     return () => cleanup(effectObj);

package/dist/index.d.ts

@@ -1,4 +1,3 @@
 export * from './signal';
 export * from './effect';
 export * from './computed';
-//# sourceMappingURL=index.d.ts.map

package/dist/signal.d.ts

@@ -1,4 +1,7 @@
-export interface Signal<T> {
+export interface ReadonlySignal<T> {
+    readonly value: T;
+}
+export interface Signal<T> extends ReadonlySignal<T> {
     value: T;
 }
 /**
@@ -7,4 +10,3 @@ export interface Signal<T> {
  * @returns An object with a reactive .value property.
  */
 export declare function signal<T>(initialValue: T): Signal<T>;
-//# sourceMappingURL=signal.d.ts.map

package/dist/signal.js

@@ -1,4 +1,4 @@
-import { activeEffect } from './effect';
+import { getActiveEffect, scheduleSubs } from './effect';
 /**
  * Creates a reactive signal.
  * @param initialValue The starting value.
@@ -9,16 +9,17 @@ export function signal(initialValue) {
     let _value = initialValue;
     return {
         get value() {
-            if (activeEffect) {
-                subscribers.add(activeEffect.run);
-                activeEffect.deps.add(subscribers);
+            const active = getActiveEffect();
+            if (active) {
+                subscribers.add(active.run);
+                active.deps.add(subscribers);
             }
             return _value;
         },
         set value(newValue) {
             if (_value !== newValue) {
                 _value = newValue;
-                [...subscribers].forEach(sub => sub());
+                scheduleSubs(subscribers);
             }
         }
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hoosk/minisignals",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Minimal agnostic signals library",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/dist/computed.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../src/computed.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB;;;OAGG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAmCpD"}

package/dist/effect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../src/effect.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;AAE5C,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,IAAI,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;CAC1B;AAED,eAAO,IAAI,YAAY,EAAE,YAAY,GAAG,IAAW,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAyBjD"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/signal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC;CACV;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAmBpD"}