@hoosk/minisignals 1.1.0 → 1.1.1

package/README.md

@@ -63,4 +63,4 @@ computed-batched-writes-then-read 706.54K ops/s   1.42 µs/op
 
 Run `npm run bench` to reproduce locally.
 
-For full documentation and advanced features, please refer to the [main repository README](../../README.md).
+For full documentation and advanced features, please refer to the [main repository README](https://github.com/Hoosk/minisignals#readme).

package/dist/computed.js

@@ -1,4 +1,4 @@
-import { cleanupSubscriber, createDependencySource, getActiveSubscriber, scheduleSource, trackDependency, trackSubscriber, } from './effect.js';
+import { cleanupSubscriber, createDependencySource, getActiveSubscriber, PENDING, scheduleSource, trackDependency, trackSubscriber, } from './effect.js';
 /**
  * Creates a computed signal that derives its value from other signals.
  * It only calculates and subscribes when its value is read for the first time.
@@ -18,18 +18,18 @@ export function computed(fn) {
         depsHead: null,
         depsTail: null,
         trackId: 0,
-        pending: false,
+        flags: 0,
     };
     let initialized = false;
     let isDisposed = false;
     let dirty = true;
     let cachedValue;
     function refreshValue() {
-        // Clear pending so a batch flush after an eager read inside the same batch
+        // Clear PENDING so a batch flush after an eager read inside the same batch
         // does not re-trigger notify() on an already-fresh computed.
         // We do NOT call cleanupSubscriber here: trackSubscriber increments trackId
         // and pruneStaleDependencies removes only stale links, reusing stable ones.
-        observer.pending = false;
+        observer.flags &= ~PENDING;
         cachedValue = trackSubscriber(observer, fn);
         initialized = true;
         dirty = false;

package/dist/effect.d.ts

@@ -1,3 +1,6 @@
+export declare const PENDING: number;
+export declare const RUNNING: number;
+export declare const NEEDS_RERUN: number;
 export interface DependencySource {
     subsHead: DependencyLink | null;
     currentLink: DependencyLink | null;
@@ -17,7 +20,7 @@ export interface Subscriber {
     depsHead: DependencyLink | null;
     depsTail: DependencyLink | null;
     trackId: number;
-    pending: boolean;
+    flags: number;
 }
 declare let _activeSubscriber: Subscriber | null;
 export { _activeSubscriber };

package/dist/effect.js

@@ -1,4 +1,7 @@
-// ─── Dependency graph types ───────────────────────────────────────────────────
+// ─── Subscriber flags ───────────────────────────────────────────────────────
+export const PENDING = 1 << 0; // queued in _pendingNotifications
+export const RUNNING = 1 << 1; // effect is currently executing
+export const NEEDS_RERUN = 1 << 2; // dependency changed while RUNNING
 let _activeSubscriber = null;
 // Exported so signal.ts can do an inline null-check in the getter hot path,
 // avoiding a function call when there is no active subscriber.
@@ -120,15 +123,15 @@ export function cleanupSubscriber(subscriber) {
         unlinkDependency(link);
         link = next;
     }
-    subscriber.pending = false;
+    subscriber.flags &= ~PENDING;
 }
 // ─── Batch scheduling ────────────────────────────────────────────────────────
 let _batchDepth = 0;
 const _pendingNotifications = [];
 function queueSubscriber(subscriber) {
     if (_batchDepth > 0) {
-        if (!subscriber.pending) {
-            subscriber.pending = true;
+        if (!(subscriber.flags & PENDING)) {
+            subscriber.flags |= PENDING;
             _pendingNotifications.push(subscriber);
         }
     }
@@ -154,9 +157,9 @@ export function batch(fn) {
         if (_batchDepth === 0) {
             const pending = _pendingNotifications.splice(0);
             for (const sub of pending) {
-                if (!sub.pending)
+                if (!(sub.flags & PENDING))
                     continue;
-                sub.pending = false;
+                sub.flags &= ~PENDING;
                 sub.notify();
             }
         }
@@ -183,31 +186,29 @@ const MAX_EFFECT_ITERATIONS = 100;
 export function effect(fn) {
     const effectObj = {};
     effectObj.notify = () => {
-        if (effectObj.isRunning) {
-            effectObj.needsRerun = true;
+        if (effectObj.flags & RUNNING) {
+            effectObj.flags |= NEEDS_RERUN;
             return;
         }
-        effectObj.isRunning = true;
+        effectObj.flags |= RUNNING;
         let iterations = 0;
         try {
             do {
                 if (++iterations > MAX_EFFECT_ITERATIONS) {
                     throw new Error('Circular dependency detected: effect exceeded maximum re-run limit');
                 }
-                effectObj.needsRerun = false;
+                effectObj.flags &= ~NEEDS_RERUN;
                 trackSubscriber(effectObj, fn);
-            } while (effectObj.needsRerun);
+            } while (effectObj.flags & NEEDS_RERUN);
         }
         finally {
-            effectObj.isRunning = false;
+            effectObj.flags &= ~RUNNING;
         }
     };
     effectObj.depsHead = null;
     effectObj.depsTail = null;
     effectObj.trackId = 0;
-    effectObj.pending = false;
-    effectObj.isRunning = false;
-    effectObj.needsRerun = false;
+    effectObj.flags = 0;
     effectObj.notify();
     return () => cleanupSubscriber(effectObj);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hoosk/minisignals",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Minimal agnostic signals library",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -22,7 +22,7 @@
     "test": "vitest run",
     "bench": "npm run build && node ./bench/core.bench.mjs"
   },
-  "keywords": [],
+  "keywords": ["signals", "reactive", "reactivity", "state", "computed", "effect", "signal", "observable", "framework-agnostic"],
   "author": "Hoosk",
   "license": "MIT"
 }