@pithyjs/signals 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PithyJS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,162 @@
+# @pithyjs/signals
+
+Fine-grained reactive signal system for the PithyJS framework. Signals provide O(1) reactive state with automatic dependency tracking — no virtual DOM, no re-renders, only the exact DOM nodes that depend on a signal update.
+
+## Installation
+
+<!-- @codex:auto install="@pithyjs/signals" -->
+```bash
+npm install @pithyjs/signals
+```
+
+```bash
+pnpm add @pithyjs/signals
+```
+
+```bash
+yarn add @pithyjs/signals
+```
+<!-- @codex:end -->
+
+```typescript
+import { signal, computed, effect, batch, onCleanup, isSignal } from '@pithyjs/signals';
+```
+
+## Quick Start
+
+<!-- @codex:auto examples="pithy.feature.signals" limit="1" -->
+**creates a reactive signal with initial value**
+
+```typescript
+const count = signal(0);
+count(); // → 0
+count.set(1);
+count(); // → 1
+```
+<!-- @codex:end -->
+
+## API Reference
+
+<!-- @codex:auto api="pithy.feature.signals" format="table" -->
+| API | Signature | Stability | Description |
+| --- | --- | --- | --- |
+| isSignal | `(value: unknown) => value is Signal<any>` | stable | - |
+| onCleanup | `(fn: () => void) => void` | stable | - |
+| effect | `(fn: () => void) => () => void` | stable | - |
+| batch | `(fn: () => void) => void` | stable | - |
+| signal | `<T>(initial: T) => Signal<T>` | stable | - |
+| computed | `<T>(compute: () => T) => () => T` | stable | - |
+<!-- @codex:end -->
+
+## Examples
+
+<!-- @codex:auto examples="pithy.feature.signals" -->
+**creates a reactive signal with initial value**
+
+```typescript
+const count = signal(0);
+count(); // → 0
+count.set(1);
+count(); // → 1
+```
+
+**supports functional updates via .set()**
+
+```typescript
+const count = signal(0);
+count.set(n => n + 1);
+count(); // → 1
+count.set(n => n * 10);
+count(); // → 10
+```
+
+**tracks signal dependencies and re-runs**
+
+```typescript
+const count = signal(0);
+let observed = -1;
+effect(() => {
+  observed = count();
+});
+observed; // → 0
+count.set(5);
+observed; // → 5
+```
+
+**derives a value from other signals**
+
+```typescript
+const a = signal(2);
+const b = signal(3);
+const sum = computed(() => a() + b());
+sum(); // → 5
+a.set(10);
+sum(); // → 13
+```
+
+**defers effect execution until batch completes**
+
+```typescript
+const a = signal(1);
+const b = signal(2);
+let runCount = 0;
+effect(() => {
+  a();
+  b();
+  runCount++;
+});
+runCount; // → 1
+
+batch(() => {
+  a.set(10);
+  b.set(20);
+});
+// Effect should have run only once after batch, not twice
+runCount; // → 2
+```
+
+**runs cleanup on disposal**
+
+```typescript
+const count = signal(0);
+let cleaned = false;
+
+const dispose = effect(() => {
+  count();
+  onCleanup(() => {
+    cleaned = true;
+  });
+});
+
+cleaned; // → false
+dispose();
+cleaned; // → true
+```
+
+**detects signal values at runtime**
+
+```typescript
+const count = signal(0);
+isSignal(count); // → true
+isSignal(42); // → false
+isSignal(() => {}); // → false
+isSignal(null); // → false
+```
+<!-- @codex:end -->
+
+## Testing
+
+<!-- @codex:auto testing="pithy.feature.signals" format="table" -->
+| Feature | Unit | Integration | E2E | Status |
+| --- | --- | --- | --- | --- |
+| isSignal | ✓ | - | - | Missing integration |
+| onCleanup | ✓ | - | - | Missing integration |
+| effect | ✓ | - | - | Missing integration |
+| batch | ✓ | - | - | Missing integration |
+| signal | ✓ | - | - | Missing integration |
+| computed | ✓ | - | - | Missing integration |
+<!-- @codex:end -->
+
+## License
+
+MIT

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './signal';
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/signal.d.ts

@@ -0,0 +1,58 @@
+/** @codex
+{
+  "id": "pithy.feature.signals",
+  "title": "Reactive Signal System",
+  "category": "feature"
+}
+*/
+import { Signal } from './types';
+/**
+ * Checks if a value is a Signal at runtime.
+ * @param value - The value to check.
+ * @returns True if the value is a Signal.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"isSignal","stability":"stable","signature":"(value: unknown) => value is Signal<any>"} */
+export declare function isSignal(value: unknown): value is Signal<unknown>;
+/**
+ * Registers a cleanup callback that will be executed
+ * before the current effect is re-run.
+ *
+ * @param fn - The cleanup function.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"onCleanup","stability":"stable","signature":"(fn: () => void) => void"} */
+export declare function onCleanup(fn: () => void): void;
+/**
+ * Creates a reactive effect that automatically tracks
+ * signals it reads and re-runs when any of them change.
+ *
+ * @param fn - The effect function to run reactively.
+ * @returns A disposer function to stop tracking this effect.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"effect","stability":"stable","signature":"(fn: () => void) => () => void"} */
+export declare function effect(fn: () => void): () => void;
+/**
+ * Batches multiple signal updates together.
+ * Effects triggered during the batch are deferred and executed once after the batch.
+ *
+ * @param fn - The function performing multiple signal updates.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"batch","stability":"stable","signature":"(fn: () => void) => void"} */
+export declare function batch(fn: () => void): void;
+/**
+ * Creates a signal: a reactive function holding a value and supporting subscriptions.
+ *
+ * @param initial - Initial value of the signal.
+ * @returns A getter function with `.set()` and `.subscribe()` attached.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"signal","stability":"stable","signature":"<T>(initial: T) => Signal<T>"} */
+export declare function signal<T>(initial: T): Signal<T>;
+/**
+ * Creates a derived signal (computed value) that automatically
+ * recalculates when its dependencies change.
+ *
+ * @param compute - A function returning the computed value.
+ * @returns A readonly function returning the latest computed value.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"computed","stability":"stable","signature":"<T>(compute: () => T) => () => T"} */
+export declare function computed<T>(compute: () => T): () => T;
+//# sourceMappingURL=signal.d.ts.map

package/dist/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,EAAE,MAAM,EAAiB,MAAM,SAAS,CAAC;AAmChD;;;;GAIG;AACH,iJAAiJ;AACjJ,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAKjE;AAiBD;;;;;GAKG;AACH,kIAAkI;AAClI,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAK9C;AAED;;;;;;GAMG;AACH,qIAAqI;AACrI,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAajD;AAED;;;;;GAKG;AACH,8HAA8H;AAC9H,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAa1C;AAED;;;;;GAKG;AACH,mIAAmI;AACnI,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAoE/C;AAED;;;;;;GAMG;AACH,yIAAyI;AACzI,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAmBrD"}

package/dist/signal.js

@@ -0,0 +1,230 @@
+/** @codex
+{
+  "id": "pithy.feature.signals",
+  "title": "Reactive Signal System",
+  "category": "feature"
+}
+*/
+import { SIGNAL_SYMBOL } from './types';
+/**
+ * Tracks the current reactive effect being registered.
+ * Used to record dependencies when a signal is read.
+ */
+let currentEffect = null;
+/**
+ * Internal cleanup registry to track cleanup functions for each registered effect.
+ * Each effect can have multiple cleanups that are called before re-execution.
+ */
+const cleanupMap = new WeakMap();
+/**
+ * Flag to indicate if we are currently inside a batched update.
+ */
+let isBatching = false;
+/**
+ * Set of effect wrappers scheduled to run after a batch ends.
+ */
+const pendingEffects = new Set();
+/**
+ * Indicates whether we are currently inside a tracking context (effect or computed).
+ * Used to suppress signal read warnings in appropriate scopes.
+ */
+let isTrackingContext = false;
+/**
+ * Tracks suppression depth for temporarily suppressing signal read warnings.
+ */
+let suppressionDepth = 0;
+/**
+ * Checks if a value is a Signal at runtime.
+ * @param value - The value to check.
+ * @returns True if the value is a Signal.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"isSignal","stability":"stable","signature":"(value: unknown) => value is Signal<any>"} */
+export function isSignal(value) {
+    return (typeof value === 'function' &&
+        value[SIGNAL_SYMBOL] === true);
+}
+/**
+ * Temporarily suppresses signal read warnings inside the given function.
+ * Handles nested suppression correctly.
+ * @param fn - Function during which warnings should be suppressed.
+ * @returns The return value of the function.
+ */
+function suppressWarnings(fn) {
+    suppressionDepth++;
+    try {
+        return fn();
+    }
+    finally {
+        suppressionDepth--;
+    }
+}
+/**
+ * Registers a cleanup callback that will be executed
+ * before the current effect is re-run.
+ *
+ * @param fn - The cleanup function.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"onCleanup","stability":"stable","signature":"(fn: () => void) => void"} */
+export function onCleanup(fn) {
+    if (currentEffect) {
+        const stack = cleanupMap.get(currentEffect);
+        if (stack)
+            stack.push(fn);
+    }
+}
+/**
+ * Creates a reactive effect that automatically tracks
+ * signals it reads and re-runs when any of them change.
+ *
+ * @param fn - The effect function to run reactively.
+ * @returns A disposer function to stop tracking this effect.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"effect","stability":"stable","signature":"(fn: () => void) => () => void"} */
+export function effect(fn) {
+    const wrapped = () => runEffect(wrapped, fn);
+    // Run immediately to establish dependencies
+    wrapped();
+    // Return disposer to manually stop the effect
+    const disposer = () => {
+        cleanupMap.get(wrapped)?.forEach(fn => fn());
+        cleanupMap.delete(wrapped);
+    };
+    return disposer;
+}
+/**
+ * Batches multiple signal updates together.
+ * Effects triggered during the batch are deferred and executed once after the batch.
+ *
+ * @param fn - The function performing multiple signal updates.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"batch","stability":"stable","signature":"(fn: () => void) => void"} */
+export function batch(fn) {
+    isBatching = true;
+    try {
+        fn();
+    }
+    finally {
+        isBatching = false;
+        // Execute all pending effects once
+        const effects = Array.from(pendingEffects);
+        pendingEffects.clear();
+        effects.forEach(run => run());
+    }
+}
+/**
+ * Creates a signal: a reactive function holding a value and supporting subscriptions.
+ *
+ * @param initial - Initial value of the signal.
+ * @returns A getter function with `.set()` and `.subscribe()` attached.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"signal","stability":"stable","signature":"<T>(initial: T) => Signal<T>"} */
+export function signal(initial) {
+    let value = initial;
+    const subscribers = new Set();
+    const listeners = new Set();
+    const read = () => suppressWarnings(() => {
+        if (currentEffect) {
+            // Register currentEffect as a subscriber
+            subscribers.add(currentEffect);
+            // IMPORTANT: Capture currentEffect NOW, not when cleanup runs!
+            // Otherwise, if cleanup runs while a different effect is active,
+            // we'd delete the wrong effect from subscribers.
+            const effectToRemove = currentEffect;
+            onCleanup(() => {
+                subscribers.delete(effectToRemove);
+            });
+        }
+        else {
+            // Warn if a signal is read outside of reactive context (in dev mode)
+            if (!isTrackingContext &&
+                suppressionDepth === 0 &&
+                import.meta.env?.DEV &&
+                !import.meta.env?.TEST) {
+                const error = new Error();
+                const stack = error.stack ?? '';
+                console.warn(`[PithyJS] ❗ Signal (value: ${value}) was read outside of a reactive context.\n` +
+                    `  • This might lead to missed updates in the UI.\n\n` +
+                    `🔎 Where it happened:\n${stack.split('\n').slice(2).join('\n')}`);
+            }
+        }
+        return value;
+    });
+    read.set = (next) => {
+        const newValue = suppressWarnings(() => typeof next === 'function' ? next(value) : next);
+        if (value !== newValue) {
+            value = newValue;
+            // Notify all reactive subscribers
+            subscribers.forEach(fn => {
+                if (isBatching) {
+                    pendingEffects.add(fn);
+                }
+                else {
+                    fn();
+                }
+            });
+            // Notify all external listeners (subscriptions)
+            listeners.forEach(fn => fn(value));
+        }
+    };
+    read.subscribe = (fn) => {
+        listeners.add(fn);
+        fn(value); // Immediately call with current value
+        return () => listeners.delete(fn);
+    };
+    read[SIGNAL_SYMBOL] =
+        true;
+    return read;
+}
+/**
+ * Creates a derived signal (computed value) that automatically
+ * recalculates when its dependencies change.
+ *
+ * @param compute - A function returning the computed value.
+ * @returns A readonly function returning the latest computed value.
+ */
+/** @codexApi {"parent":"pithy.feature.signals","name":"computed","stability":"stable","signature":"<T>(compute: () => T) => () => T"} */
+export function computed(compute) {
+    isTrackingContext = true; // Allow first compute() call to access signals without warnings
+    let initial;
+    try {
+        initial = compute();
+    }
+    finally {
+        isTrackingContext = false;
+    }
+    const result = signal(initial);
+    const owner = currentEffect;
+    const dispose = effect(() => {
+        result.set(compute());
+    });
+    if (owner) {
+        cleanupMap.get(owner)?.push(dispose);
+    }
+    return result;
+}
+/**
+ * Runs the provided effect function, setting up the current tracking context,
+ * managing cleanups, and allowing signal dependencies to be re-collected.
+ *
+ * @param wrapped - The wrapper function associated with the effect.
+ * @param fn - The effect body function.
+ */
+function runEffect(wrapped, fn) {
+    isTrackingContext = true;
+    if (isBatching) {
+        // Defer running effect until after batch completes
+        pendingEffects.add(() => runEffect(wrapped, fn));
+        return;
+    }
+    // Prepare new cleanup stack
+    cleanupMap.set(wrapped, []);
+    currentEffect = wrapped;
+    try {
+        fn(); // Run the effect
+    }
+    finally {
+        currentEffect = null;
+        isTrackingContext = false;
+    }
+}
+//# sourceMappingURL=signal.js.map

package/dist/signal.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,11 @@
+export type EffectFn = () => void;
+export type Signal<T> = (() => T) & {
+    set: (value: T | ((prev: T) => T)) => void;
+    subscribe: (fn: (value: T) => void) => () => void;
+};
+/** Read-only accessor for a signal's value. Compatible with effects for dependency tracking. */
+export type ReadonlySignal<T> = () => T;
+/** The signature of the `effect()` function from @pithyjs/signals. */
+export type EffectRunner = (fn: EffectFn) => () => void;
+export declare const SIGNAL_SYMBOL: unique symbol;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAElC,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG;IAClC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3C,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACnD,CAAC;AAEF,gGAAgG;AAChG,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;AAExC,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,QAAQ,KAAK,MAAM,IAAI,CAAC;AAExD,eAAO,MAAM,aAAa,eAAyB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export const SIGNAL_SYMBOL = Symbol('pithy-signal');
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@pithyjs/signals",
+  "version": "0.1.0-beta.0",
+  "description": "Reactive signal system for PithyJS framework",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest"
+  }
+}