@praxisjs/core 2.1.0 → 2.3.0

package/dist/signal/index.js

@@ -5,4 +5,5 @@ export { computed, writableComputed } from "./computed";
 export { persistedSignal } from "./persisted";
 export { syncedSignal } from "./synced";
 export { effect, untrack } from "./effect";
+export { selector } from "./selector";
 //# sourceMappingURL=index.js.map

package/dist/signal/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/signal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAA+B,eAAe,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAqB,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/signal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAqD,eAAe,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAqB,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAsC,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/signal/peek.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"peek.d.ts","sourceRoot":"","sources":["../../src/signal/peek.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAIzD,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAQ1D"}
+{"version":3,"file":"peek.d.ts","sourceRoot":"","sources":["../../src/signal/peek.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAIzD,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAE1D"}

package/dist/signal/peek.js

@@ -1,12 +1,5 @@
-import { activeEffect, runEffect } from "./effect";
+import { untrack } from "./effect";
 export function peek(source) {
-    const prev = activeEffect;
-    runEffect(null);
-    try {
-        return source();
-    }
-    finally {
-        runEffect(prev);
-    }
+    return untrack(source);
 }
 //# sourceMappingURL=peek.js.map

package/dist/signal/peek.js.map

@@ -1 +1 @@
-{"version":3,"file":"peek.js","sourceRoot":"","sources":["../../src/signal/peek.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,UAAU,IAAI,CAAI,MAA+B;IACrD,MAAM,IAAI,GAAG,YAAY,CAAC;IAC1B,SAAS,CAAC,IAAI,CAAC,CAAC;IAChB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"peek.js","sourceRoot":"","sources":["../../src/signal/peek.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,UAAU,IAAI,CAAI,MAA+B;IACrD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC"}

package/dist/signal/persisted.d.ts

@@ -3,6 +3,16 @@ export interface PersistedSignalOptions<T> {
     serialize?: (value: T) => string;
     deserialize?: (value: string) => T;
     syncTabs?: boolean;
+    /**
+     * Milliseconds to hold back writes to `localStorage`. Writes within the window are coalesced
+     * into one, using the latest value; pending data is flushed on `pagehide` and `close()`.
+     * `0` (default) writes on every `set`.
+     */
+    writeDelay?: number;
 }
-export declare function persistedSignal<T>(key: string, initialValue: T, options?: PersistedSignalOptions<T>): Signal<T>;
+export interface PersistedSignal<T> extends Signal<T> {
+    /** Stops listening for `storage` events from other tabs. The signal keeps working locally. */
+    close(): void;
+}
+export declare function persistedSignal<T>(key: string, initialValue: T, options?: PersistedSignalOptions<T>): PersistedSignal<T>;
 //# sourceMappingURL=persisted.d.ts.map

package/dist/signal/persisted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persisted.d.ts","sourceRoot":"","sources":["../../src/signal/persisted.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI/C,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,sBAAsB,CAAC,CAAC,CAAM,aAwExC"}
+{"version":3,"file":"persisted.d.ts","sourceRoot":"","sources":["../../src/signal/persisted.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI/C,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IACnD,8FAA8F;IAC9F,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,sBAAsB,CAAC,CAAC,CAAM,sBA8GxC"}

package/dist/signal/persisted.js

@@ -1,6 +1,6 @@
 import { signal } from "./signal";
 export function persistedSignal(key, initialValue, options = {}) {
-    const { serialize = JSON.stringify, deserialize = JSON.parse, syncTabs = true, } = options;
+    const { serialize = JSON.stringify, deserialize = JSON.parse, syncTabs = true, writeDelay = 0, } = options;
     function getStoredValue() {
         try {
             const stored = localStorage.getItem(key);
@@ -24,23 +24,47 @@ export function persistedSignal(key, initialValue, options = {}) {
             console.warn(`Failed to serialize value for key "${key}":`, e);
         }
     }
+    let pendingWrite;
+    let writeTimer;
+    function flushWrite() {
+        clearTimeout(writeTimer);
+        writeTimer = undefined;
+        if (!pendingWrite)
+            return;
+        const { value } = pendingWrite;
+        pendingWrite = undefined;
+        setStoredValue(value);
+    }
+    // The timer starts at the first write of a burst (throttle, not debounce) so a value that keeps
+    // changing still reaches storage within `writeDelay`.
+    function scheduleWrite(value) {
+        if (writeDelay <= 0) {
+            setStoredValue(value);
+            return;
+        }
+        pendingWrite = { value };
+        writeTimer ??= setTimeout(flushWrite, writeDelay);
+    }
     const inner = signal(getStoredValue());
     function read() {
         return inner();
     }
     function set(value) {
-        setStoredValue(value);
+        scheduleWrite(value);
         inner.set(value);
     }
     function update(fh) {
         const newValue = fh(inner());
-        setStoredValue(newValue);
+        scheduleWrite(newValue);
         inner.set(newValue);
     }
+    let removeStorageListener;
     if (syncTabs) {
-        window.addEventListener("storage", (event) => {
+        const onStorage = (event) => {
             if (event.key !== key || event.storageArea !== localStorage)
                 return;
+            // Another tab's value wins; a still-pending local write would overwrite it later.
+            pendingWrite = undefined;
             try {
                 const newValue = event.newValue
                     ? deserialize(event.newValue)
@@ -51,13 +75,23 @@ export function persistedSignal(key, initialValue, options = {}) {
                 console.warn(`Failed to deserialize value for key "${key}" from storage event:`, e);
                 inner.set(initialValue);
             }
-        });
+        };
+        window.addEventListener("storage", onStorage);
+        removeStorageListener = () => { window.removeEventListener("storage", onStorage); };
     }
+    if (writeDelay > 0)
+        window.addEventListener("pagehide", flushWrite);
     const source = read;
     source.set = set;
     source.update = update;
     source.subscribe = inner.subscribe.bind(inner);
     source.__isSignal = true;
+    source.close = () => {
+        removeStorageListener?.();
+        removeStorageListener = undefined;
+        window.removeEventListener("pagehide", flushWrite);
+        flushWrite();
+    };
     return source;
 }
 //# sourceMappingURL=persisted.js.map

package/dist/signal/persisted.js.map

@@ -1 +1 @@
-{"version":3,"file":"persisted.js","sourceRoot":"","sources":["../../src/signal/persisted.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQlC,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,YAAe,EACf,UAAqC,EAAE;IAEvC,MAAM,EACJ,SAAS,GAAG,IAAI,CAAC,SAAS,EAC1B,WAAW,GAAG,IAAI,CAAC,KAA6B,EAChD,QAAQ,GAAG,IAAI,GAChB,GAAG,OAAO,CAAC;IAEZ,SAAS,cAAc;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACzC,OAAO,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QACrD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,wCAAwC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;YACjE,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAED,SAAS,cAAc,CAAC,KAAQ;QAC9B,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,sCAAsC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IAEvC,SAAS,IAAI;QACX,OAAO,KAAK,EAAE,CAAC;IACjB,CAAC;IAED,SAAS,GAAG,CAAC,KAAQ;QACnB,cAAc,CAAC,KAAK,CAAC,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,SAAS,MAAM,CAAC,EAAkB;QAChC,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7B,cAAc,CAAC,QAAQ,CAAC,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3C,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,KAAK,YAAY;gBAAE,OAAO;YACpE,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ;oBAC7B,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC;oBAC7B,CAAC,CAAC,YAAY,CAAC;gBACjB,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CACV,wCAAwC,GAAG,uBAAuB,EAClE,CAAC,CACF,CAAC;gBACF,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,IAAiB,CAAC;IACjC,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;IAEzB,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"persisted.js","sourceRoot":"","sources":["../../src/signal/persisted.ts"],"names":[],"mappings":"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"}

package/dist/signal/selector.d.ts

@@ -0,0 +1,5 @@
+export type Selector<K> = (key: K) => boolean;
+export type SelectorEquals<K, T> = (key: K, value: T) => boolean;
+export declare function selector<T>(source: () => T): Selector<T>;
+export declare function selector<T, K>(source: () => T, equals: SelectorEquals<K, T>): Selector<K>;
+//# sourceMappingURL=selector.d.ts.map

package/dist/signal/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/signal/selector.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;AAC9C,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;AAyCjE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC1D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC"}

package/dist/signal/selector.js

@@ -0,0 +1,128 @@
+import { activeSub, createEffect, DIRTY, disposeEffect, endBatch, notify, PENDING, startBatch, track, WatchedNode } from "./graph";
+// Keys live in a Map, so the default comparison has to be the Map's own (SameValueZero): a key
+// that compares equal must be the one the lookup finds, or a bucket would never be notified.
+function sameValueZero(a, b) {
+    return a === b || (Number.isNaN(a) && Number.isNaN(b));
+}
+// One class for every selector's buckets (rather than one declared per selector call), so the
+// graph code that reads and links them always sees the same shape.
+// Declared and assigned rather than parameter properties, which compile to class fields that are
+// defined one by one and make buckets (one per row reading a selector) slower to create.
+class Bucket extends WatchedNode {
+    constructor(key, owner) {
+        super();
+        this.key = key;
+        this.owner = owner;
+    }
+    // A bucket drops itself from its selector once its last subscriber unlinks (re-run or disposal).
+    unwatched() {
+        this.owner.drop(this.key);
+    }
+}
+// Keeps the bucket shape alive across full GCs; see the shape keepers in graph.ts.
+Object.defineProperty(Bucket, "shapeKeeper", {
+    value: new Bucket(undefined, {
+        drop() {
+            // Never called: the keeper has no subscriber to lose.
+        },
+    }),
+});
+export function selector(source, equals) {
+    const compare = equals ?? sameValueZero;
+    const buckets = new Map();
+    let current;
+    let sourceEffect = null;
+    let releaseScheduled = false;
+    // The source subscription goes with the last bucket, so removed rows leave nothing behind.
+    const owner = {
+        drop(key) {
+            buckets.delete(key);
+            if (buckets.size === 0)
+                scheduleRelease();
+        },
+    };
+    function changedBuckets(prev, next) {
+        const changed = [];
+        if (equals === undefined) {
+            if (sameValueZero(prev, next))
+                return changed;
+            const prevBucket = buckets.get(prev);
+            const nextBucket = buckets.get(next);
+            if (prevBucket !== undefined)
+                changed.push(prevBucket);
+            if (nextBucket !== undefined)
+                changed.push(nextBucket);
+            return changed;
+        }
+        for (const [key, bucket] of buckets) {
+            if (compare(key, prev) !== compare(key, next))
+                changed.push(bucket);
+        }
+        return changed;
+    }
+    // Batched so an effect reading several affected keys re-runs once, and so no subscriber runs
+    // (and unlinks) while the buckets are still being walked.
+    function notifyChanged(prev, next) {
+        const changed = changedBuckets(prev, next);
+        if (changed.length === 0)
+            return;
+        startBatch();
+        try {
+            for (const bucket of changed) {
+                bucket.version++;
+                notify(bucket);
+            }
+        }
+        finally {
+            endBatch();
+        }
+    }
+    function activate() {
+        let initialized = false;
+        sourceEffect = createEffect(() => {
+            const next = source();
+            const prev = current;
+            current = next;
+            if (!initialized) {
+                initialized = true;
+                return;
+            }
+            notifyChanged(prev, next);
+        });
+    }
+    // An effect re-running unlinks its bucket right before reading the key again, and a list
+    // re-render unlinks every bucket before the new rows subscribe. Waiting a microtask keeps the
+    // source subscribed through both instead of stopping and re-reading it each time.
+    function scheduleRelease() {
+        if (releaseScheduled)
+            return;
+        releaseScheduled = true;
+        queueMicrotask(() => {
+            releaseScheduled = false;
+            if (buckets.size > 0)
+                return;
+            const stop = sourceEffect;
+            sourceEffect = null;
+            disposeEffect(stop);
+        });
+    }
+    return function select(key) {
+        if (activeSub === undefined) {
+            // `current` lags the source while the source effect waits to run (a write inside a batch, or
+            // a computed source, whose effects run a microtask later). A tracked read keeps the cached
+            // value, which the effect's run then corrects through the buckets; nothing corrects this one.
+            const fresh = sourceEffect !== null && (sourceEffect.flags & (DIRTY | PENDING)) === 0;
+            return compare(key, fresh ? current : source());
+        }
+        if (sourceEffect === null)
+            activate();
+        let bucket = buckets.get(key);
+        if (bucket === undefined) {
+            bucket = new Bucket(key, owner);
+            buckets.set(key, bucket);
+        }
+        track(bucket);
+        return compare(key, current);
+    };
+}
+//# sourceMappingURL=selector.js.map

package/dist/signal/selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.js","sourceRoot":"","sources":["../../src/signal/selector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAmB,MAAM,SAAS,CAAC;AAKpJ,+FAA+F;AAC/F,6FAA6F;AAC7F,SAAS,aAAa,CAAC,CAAU,EAAE,CAAU;IAC3C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAMD,8FAA8F;AAC9F,mEAAmE;AACnE,iGAAiG;AACjG,yFAAyF;AACzF,MAAM,MAAU,SAAQ,WAAW;IAIjC,YAAY,GAAM,EAAE,KAAqB;QACvC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,iGAAiG;IACjG,SAAS;QACP,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE;IAC3C,KAAK,EAAE,IAAI,MAAM,CAAU,SAAS,EAAE;QACpC,IAAI;YACF,sDAAsD;QACxD,CAAC;KACF,CAAC;CACH,CAAC,CAAC;AAIH,MAAM,UAAU,QAAQ,CAAO,MAAe,EAAE,MAA6B;IAC3E,MAAM,OAAO,GAAG,MAAM,IAAK,aAAsC,CAAC;IAClE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,IAAI,OAAU,CAAC;IACf,IAAI,YAAY,GAAsB,IAAI,CAAC;IAC3C,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAE7B,2FAA2F;IAC3F,MAAM,KAAK,GAAmB;QAC5B,IAAI,CAAC,GAAG;YACN,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;gBAAE,eAAe,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC;IAEF,SAAS,cAAc,CAAC,IAAO,EAAE,IAAO;QACtC,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC;gBAAE,OAAO,OAAO,CAAC;YAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,IAAoB,CAAC,CAAC;YACrD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,IAAoB,CAAC,CAAC;YACrD,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACvD,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACvD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,6FAA6F;IAC7F,0DAA0D;IAC1D,SAAS,aAAa,CAAC,IAAO,EAAE,IAAO;QACrC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACjC,UAAU,EAAE,CAAC;QACb,IAAI,CAAC;YACH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,CAAC,MAAM,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAED,SAAS,QAAQ;QACf,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,YAAY,GAAG,YAAY,CAAC,GAAG,EAAE;YAC/B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,OAAO,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC;gBACnB,OAAO;YACT,CAAC;YACD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yFAAyF;IACzF,8FAA8F;IAC9F,kFAAkF;IAClF,SAAS,eAAe;QACtB,IAAI,gBAAgB;YAAE,OAAO;QAC7B,gBAAgB,GAAG,IAAI,CAAC;QACxB,cAAc,CAAC,GAAG,EAAE;YAClB,gBAAgB,GAAG,KAAK,CAAC;YACzB,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC;gBAAE,OAAO;YAC7B,MAAM,IAAI,GAAG,YAA0B,CAAC;YACxC,YAAY,GAAG,IAAI,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,MAAM,CAAC,GAAM;QAC3B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,6FAA6F;YAC7F,2FAA2F;YAC3F,8FAA8F;YAC9F,MAAM,KAAK,GAAG,YAAY,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;YACtF,OAAO,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,YAAY,KAAK,IAAI;YAAE,QAAQ,EAAE,CAAC;QACtC,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,OAAO,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC"}

package/dist/signal/signal.d.ts

@@ -1,8 +1,3 @@
 import type { Signal } from "@praxisjs/shared";
-import { type Effect, type SubList, type SubscriberHolder } from "./effect";
-export type { SubList } from "./effect";
-export declare function addSub(holder: SubscriberHolder, eff: Effect): void;
-export declare function removeSub(holder: SubscriberHolder, eff: Effect): void;
-export declare function notifySubs(subs: Exclude<SubList, null>, batching: boolean): void;
 export declare function signal<T>(initialValue: T): Signal<T>;
 //# sourceMappingURL=signal.d.ts.map

package/dist/signal/signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/signal/signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACtB,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,wBAAgB,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAUlE;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAUrE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAqBhF;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CA4BpD"}
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/signal/signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAK/C,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAepD"}

package/dist/signal/signal.js

@@ -1,86 +1,16 @@
-import { isBatching, enqueueEffect } from "./batch";
-import { activeEffect, recordDependency, } from "./effect";
-export function addSub(holder, eff) {
-    const subs = holder.subs;
-    if (subs === null) {
-        holder.subs = eff;
-    }
-    else if (typeof subs === "function") {
-        if (subs !== eff)
-            holder.subs = [subs, eff];
-    }
-    else {
-        if (!subs.includes(eff))
-            subs.push(eff);
-    }
-    recordDependency(eff, holder);
-}
-export function removeSub(holder, eff) {
-    const subs = holder.subs;
-    if (subs === null)
-        return;
-    if (typeof subs === "function") {
-        if (subs === eff)
-            holder.subs = null;
-    }
-    else {
-        const idx = subs.indexOf(eff);
-        if (idx >= 0)
-            subs.splice(idx, 1);
-        if (subs.length === 0)
-            holder.subs = null;
-    }
-}
-export function notifySubs(subs, batching) {
-    if (typeof subs === "function") {
-        if (batching)
-            enqueueEffect(subs);
-        else
-            subs();
-        return;
-    }
-    const snapshot = [...subs];
-    if (batching) {
-        for (const sub of snapshot)
-            enqueueEffect(sub);
-        return;
-    }
-    let lastError;
-    let hasError = false;
-    for (const sub of snapshot) {
-        try {
-            sub();
-        }
-        catch (e) {
-            lastError = e;
-            hasError = true;
-        }
-    }
-    if (hasError)
-        throw lastError;
-}
+import { untrack } from "./effect";
+import { createEffect, disposeEffect, readSignal, SignalNode, writeSignal } from "./graph";
 export function signal(initialValue) {
-    let value = initialValue;
-    const holder = { subs: null };
-    function read() {
-        if (activeEffect !== null)
-            addSub(holder, activeEffect);
-        return value;
-    }
-    const s = read;
-    s.set = (newValue) => {
-        if (Object.is(value, newValue))
-            return;
-        value = newValue;
-        if (holder.subs !== null)
-            notifySubs(holder.subs, isBatching());
-    };
-    s.update = (fn) => { s.set(fn(value)); };
+    const node = new SignalNode(initialValue);
+    const s = (() => readSignal(node));
+    s.set = (newValue) => { writeSignal(node, newValue); };
+    s.update = (fn) => { writeSignal(node, fn(node.value)); };
     s.subscribe = (fn) => {
-        const wrapped = () => { fn(value); };
-        addSub(holder, wrapped);
-        wrapped();
-        return () => { removeSub(holder, wrapped); };
+        const sub = createEffect(() => {
+            const value = readSignal(node);
+            untrack(() => { fn(value); });
+        });
+        return () => { disposeEffect(sub); };
     };
     s.__isSignal = true;
     return s;

package/dist/signal/signal.js.map

@@ -1 +1 @@
-{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../src/signal/signal.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,gBAAgB,GAIjB,MAAM,UAAU,CAAC;AAIlB,MAAM,UAAU,MAAM,CAAC,MAAwB,EAAE,GAAW;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;IACpB,CAAC;SAAM,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QACtC,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAwB,EAAE,GAAW;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO;IAC1B,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAA4B,EAAE,QAAiB;IACxE,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,IAAI,QAAQ;YAAE,aAAa,CAAC,IAAI,CAAC,CAAC;;YAAM,IAAI,EAAE,CAAC;QAC/C,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3B,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,GAAG,IAAI,QAAQ;YAAE,aAAa,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IACD,IAAI,SAAkB,CAAC;IACvB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,GAAG,EAAE,CAAC;QACR,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,SAAS,GAAG,CAAC,CAAC;YACd,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,IAAI,QAAQ;QAAE,MAAM,SAAS,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,MAAM,CAAI,YAAe;IACvC,IAAI,KAAK,GAAG,YAAY,CAAC;IACzB,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,IAAe,EAAE,CAAC;IAEzC,SAAS,IAAI;QACX,IAAI,YAAY,KAAK,IAAI;YAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,GAAG,IAAiB,CAAC;IAE5B,CAAC,CAAC,GAAG,GAAG,CAAC,QAAW,EAAE,EAAE;QACtB,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO;QACvC,KAAK,GAAG,QAAQ,CAAC;QACjB,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;YAAE,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC;IAEF,CAAC,CAAC,MAAM,GAAG,CAAC,EAAkB,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzD,CAAC,CAAC,SAAS,GAAG,CAAC,EAAsB,EAAE,EAAE;QACvC,MAAM,OAAO,GAAW,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxB,OAAO,EAAE,CAAC;QACV,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC;IAEF,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../src/signal/signal.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3F,MAAM,UAAU,MAAM,CAAI,YAAe;IACvC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;IAE1C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAc,CAAC;IAChD,CAAC,CAAC,GAAG,GAAG,CAAC,QAAW,EAAE,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,MAAM,GAAG,CAAC,EAAkB,EAAE,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,SAAS,GAAG,CAAC,EAAsB,EAAE,EAAE;QACvC,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE;YAC5B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC;IACF,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,CAAC;AACX,CAAC"}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@praxisjs/core",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -14,14 +15,22 @@
       "types": "./dist/internal.d.ts"
     }
   },
+  "files": [
+    "dist",
+    "src",
+    "!dist/**/__tests__",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
   "devDependencies": {
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@praxisjs/shared": "0.3.1"
+    "@praxisjs/shared": "0.3.2"
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch"
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit"
   }
 }

package/src/component/internals.ts

@@ -3,15 +3,22 @@ export const componentPropsType: unique symbol = Symbol("praxis.componentPropsTy
 interface ComponentInternals<T extends object> {
   rawProps: T;
   mounted: boolean;
-  anchor?: Comment;
+  anchor: Node | undefined;
+  start: Comment | undefined;
   defaults: Record<string, unknown>;
   stateDirty: boolean;
 }
 
-const componentInternals = new WeakMap<object, ComponentInternals<object>>();
+// Kept on the instance under a symbol rather than in a WeakMap: every @Prop read goes through
+// here, and a property load is much cheaper than a WeakMap lookup.
+const INTERNALS: unique symbol = Symbol("praxis.internals");
+
+interface InternalsHost {
+  [INTERNALS]?: ComponentInternals<object>;
+}
 
 function getInternals(instance: object): ComponentInternals<object> {
-  const internals = componentInternals.get(instance);
+  const internals = (instance as InternalsHost)[INTERNALS];
   if (!internals) {
     throw new TypeError("Expected a PraxisJS component instance.");
   }
@@ -22,12 +29,14 @@ export function initComponentInternals(
   instance: object,
   props: object,
 ): void {
-  componentInternals.set(instance, {
+  (instance as InternalsHost)[INTERNALS] = {
     rawProps: { ...props },
     mounted: false,
+    anchor: undefined,
+    start: undefined,
     defaults: {},
     stateDirty: false,
-  });
+  };
 }
 
 export function getComponentProps(instance: object): object {
@@ -73,13 +82,17 @@ export function getComponentDefaults(
   return getInternals(instance).defaults;
 }
 
-export function getComponentAnchor(instance: object): Comment | undefined {
+/**
+ * A node of the mounted component's output: its only root node, or the comment that closes its
+ * region when it renders several nodes. Its `parentElement` is the element the component sits in.
+ */
+export function getComponentAnchor(instance: object): Node | undefined {
   return getInternals(instance).anchor;
 }
 
 export function setComponentAnchor(
   instance: object,
-  anchor: Comment | undefined,
+  anchor: Node | undefined,
 ): void {
   getInternals(instance).anchor = anchor;
 }
@@ -96,14 +109,14 @@ export function setComponentMounted(
 }
 
 export function markStateDirty(instance: object): void {
-  const internals = componentInternals.get(instance);
+  const internals = (instance as InternalsHost)[INTERNALS];
   if (internals) {
     internals.stateDirty = true;
   }
 }
 
 export function isStateDirty(instance: object): boolean {
-  const internals = componentInternals.get(instance);
+  const internals = (instance as InternalsHost)[INTERNALS];
   if (internals) return internals.stateDirty;
   return false;
 }
@@ -112,8 +125,20 @@ export function setStateDirty(
   instance: object,
   stateDirty: boolean,
 ): void {
-  const internals = componentInternals.get(instance);
+  const internals = (instance as InternalsHost)[INTERNALS];
   if (internals) {
     internals.stateDirty = stateDirty;
   }
 }
+
+/**
+ * The comment that opens a component's region, when it has one: a component whose render sets it
+ * (with the closing comment as its anchor) brings its own boundaries, and mountComponent adds none.
+ */
+export function getComponentStart(instance: object): Comment | undefined {
+  return getInternals(instance).start;
+}
+
+export function setComponentStart(instance: object, start: Comment | undefined): void {
+  getInternals(instance).start = start;
+}

package/src/internal.ts

@@ -15,10 +15,35 @@ export {
   batch,
   effect,
   untrack,
+  selector,
+  type Selector,
+  type SelectorEquals,
   type PersistedSignalOptions,
+  type PersistedSignal,
   type SyncedSignal,
 } from "./signal";
 export { RootComponent } from "./component";
+export {
+  createEffect,
+  createContextEffect,
+  disposeEffect,
+  startBatch,
+  endBatch,
+  EffectNode,
+  SignalNode,
+  readSignal,
+  writeSignal,
+  ComputedNode,
+  readComputed,
+  type ReactiveNode,
+  pauseTracking,
+  resumeTracking,
+  setReactiveObserver,
+  setCurrentOwner,
+  getEffectOwner,
+  type ReactiveObserver,
+  type EffectCleanup,
+} from "./signal/graph";
 export {
   componentPropsType,
   getComponentAnchor,
@@ -26,6 +51,8 @@ export {
   getComponentDefaults,
   getComponentProps,
   getComponentRawProp,
+  getComponentStart,
+  setComponentStart,
   isComponentMounted,
   isStateDirty,
   markStateDirty,

package/src/reactive/history.ts

@@ -12,6 +12,8 @@ export interface HistoryElement<T> {
   undo(): void;
   redo(): void;
   clear(): void;
+  /** Stops tracking the source. Existing entries stay readable; no new ones are recorded. */
+  destroy(): void;
 }
 
 export function history<T>(
@@ -25,7 +27,7 @@ export function history<T>(
   let _ignoreNext = false;
   let _initialized = false;
 
-  effect(() => {
+  const stop = effect(() => {
     const value = source();
 
     if (!_initialized) {
@@ -83,5 +85,6 @@ export function history<T>(
       _past.set([]);
       _future.set([]);
     },
+    destroy: stop,
   };
 }