@praxisjs/core 2.2.0 → 2.3.0

package/dist/signal/graph.d.ts

@@ -0,0 +1,111 @@
+export declare const DIRTY = 1;
+export declare const PENDING = 2;
+export declare const QUEUED = 4;
+export declare const RUNNING = 8;
+export declare const DISPOSED = 16;
+export declare const COMPUTED = 32;
+export declare const EFFECT = 64;
+export declare const HAS_ERROR = 128;
+/** The node is a WatchedNode: it wants to know when its last subscriber goes away. */
+export declare const WATCHED = 256;
+/** An effect waiting for the deferred pass (see `defer`). */
+export declare const DEFERRED = 512;
+export declare class Link {
+    dep: ReactiveNode;
+    sub: ReactiveNode;
+    version: number;
+    nextDep: Link | undefined;
+    prevSub: Link | undefined;
+    nextSub: Link | undefined;
+    constructor(dep: ReactiveNode, sub: ReactiveNode, nextDep: Link | undefined, prevSub: Link | undefined);
+}
+export declare class ReactiveNode {
+    flags: number;
+    version: number;
+    subs: Link | undefined;
+    subsTail: Link | undefined;
+    deps: Link | undefined;
+    depsTail: Link | undefined;
+    constructor(flags: number);
+}
+export declare abstract class WatchedNode extends ReactiveNode {
+    constructor();
+    abstract unwatched(): void;
+}
+export declare class SignalNode<T = unknown> extends ReactiveNode {
+    value: T;
+    constructor(value: T);
+}
+export declare class ComputedNode<T = unknown> extends ReactiveNode {
+    value: T | undefined;
+    error: unknown;
+    getter: () => T;
+    constructor(getter: () => T);
+}
+export type EffectCleanup = (() => void) | void;
+type EffectFn<Ctx> = {
+    run(this: EffectNode<Ctx>): EffectCleanup;
+}["run"];
+export declare class EffectNode<Ctx = unknown> extends ReactiveNode {
+    /** Called as a method, so `this` is the node: a function shared by many effects reads `ctx`. */
+    fn: EffectFn<Ctx>;
+    cleanup: EffectCleanup;
+    /** What was rendering when the effect was created (see setCurrentOwner), for tooling. */
+    owner: object | undefined;
+    /** State of an effect whose `fn` is shared, kept here instead of in a closure per effect. */
+    ctx: Ctx;
+    constructor(fn: EffectFn<Ctx>, owner?: object, ctx?: Ctx);
+}
+export declare let activeSub: ReactiveNode | undefined;
+/**
+ * Receives what the graph does, for tooling (devtools profiling). While none is set the graph pays
+ * one flag check per write, computed run and effect run, and production bundles of an app that
+ * never sets one none at all.
+ */
+export interface ReactiveObserver {
+    /** A signal (or selector bucket) was written and its subscribers marked. */
+    write?(node: ReactiveNode): void;
+    /** A computed recomputed, taking `ms`. */
+    compute?(node: ComputedNode, ms: number): void;
+    /** An effect ran, taking `ms`; `owner` is what was rendering when it was created, if known. */
+    effect?(node: EffectNode, ms: number, owner: object | undefined): void;
+}
+/** Installs an observer (null removes it) and returns the previous one. */
+export declare function setReactiveObserver(next: ReactiveObserver | null): ReactiveObserver | null;
+/**
+ * Marks what is being rendered, so effects created meanwhile are attributed to it, whether or not
+ * an observer is installed yet. Returns the previous owner, to restore afterwards.
+ */
+export declare function setCurrentOwner(owner: object | undefined): object | undefined;
+export declare function getEffectOwner(node: EffectNode): object | undefined;
+export declare function setActiveSub(sub: ReactiveNode | undefined): ReactiveNode | undefined;
+/** Stops dependency tracking until `resumeTracking(prev)`; the closure-free form of untrack(). */
+export declare function pauseTracking(): ReactiveNode | undefined;
+export declare function resumeTracking(prev: ReactiveNode | undefined): void;
+export declare function track(dep: ReactiveNode): void;
+export declare function startTracking(sub: ReactiveNode): ReactiveNode | undefined;
+export declare function endTracking(sub: ReactiveNode, prev: ReactiveNode | undefined): void;
+/** Removes every dependency of `sub`. */
+export declare function unlinkDeps(sub: ReactiveNode): void;
+export declare function isBatching(): boolean;
+export declare function startBatch(): void;
+export declare function endBatch(): void;
+/** Marks the direct subscribers of a changed source and runs the effects that became stale. */
+export declare function notify(dep: ReactiveNode): void;
+export declare function flush(): void;
+/** Whether a subscriber has to re-run: DIRTY, or PENDING with a source that really changed. */
+export declare function isStale(node: ReactiveNode): boolean;
+export declare function refreshComputed(node: ComputedNode): void;
+export declare function readComputed<T>(node: ComputedNode<T>): T;
+export declare function runEffect(node: EffectNode): void;
+export declare function disposeEffect(node: EffectNode): void;
+export declare function createEffect(fn: () => EffectCleanup): EffectNode;
+/**
+ * Creates and runs an effect whose `fn` reads its state from `this.ctx`: one function can serve
+ * every effect of a kind (each DOM binding of a render), and each effect allocates no closure.
+ */
+export declare function createContextEffect<Ctx>(fn: (this: EffectNode<Ctx>) => EffectCleanup, ctx: Ctx): EffectNode<Ctx>;
+export declare function readSignal<T>(node: SignalNode<T>): T;
+export declare function writeSignal<T>(node: SignalNode<T>, value: T): void;
+export {};
+//# sourceMappingURL=graph.d.ts.map

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

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

package/dist/signal/graph.js

@@ -0,0 +1,513 @@
+// Push-pull reactive graph. Sources (signals, computeds, selector buckets) keep a doubly linked
+// list of subscriber links, subscribers (computeds, effects) keep a singly linked list of the
+// same links in read order. A re-run walks its previous links in order and reuses every link
+// whose source is read again in the same position, so a binding that reads the same sources on
+// every run allocates nothing and never unsubscribes. Writes push DIRTY to direct subscribers
+// and PENDING further down; reads pull, recomputing a computed only when one of its sources
+// actually changed (tracked with per-node versions).
+export const DIRTY = 1;
+export const PENDING = 2;
+export const QUEUED = 4;
+export const RUNNING = 8;
+export const DISPOSED = 16;
+export const COMPUTED = 32;
+export const EFFECT = 64;
+export const HAS_ERROR = 128;
+/** The node is a WatchedNode: it wants to know when its last subscriber goes away. */
+export const WATCHED = 256;
+/** An effect waiting for the deferred pass (see `defer`). */
+export const DEFERRED = 512;
+// Fields are declared with `declare` and assigned in the constructors: class field initializers
+// define each property one by one, which makes these objects (created by the thousand per render)
+// about twice as slow to allocate.
+export class Link {
+    constructor(dep, sub, nextDep, prevSub) {
+        this.dep = dep;
+        this.sub = sub;
+        this.version = dep.version;
+        this.nextDep = nextDep;
+        this.prevSub = prevSub;
+        this.nextSub = undefined;
+    }
+}
+export class ReactiveNode {
+    constructor(flags) {
+        this.flags = flags;
+        this.version = 0;
+        this.subs = undefined;
+        this.subsTail = undefined;
+        this.deps = undefined;
+        this.depsTail = undefined;
+    }
+}
+export class WatchedNode extends ReactiveNode {
+    constructor() {
+        super(WATCHED);
+    }
+}
+export class SignalNode extends ReactiveNode {
+    constructor(value) {
+        super(0);
+        this.value = value;
+    }
+}
+export class ComputedNode extends ReactiveNode {
+    constructor(getter) {
+        super(COMPUTED | DIRTY);
+        this.value = undefined;
+        this.error = undefined;
+        this.getter = getter;
+    }
+}
+export class EffectNode extends ReactiveNode {
+    constructor(fn, owner, ctx) {
+        super(EFFECT);
+        this.fn = fn;
+        this.cleanup = undefined;
+        this.owner = owner;
+        this.ctx = ctx;
+    }
+}
+// ── Shape keepers ───────────────────────────────────────────────────────────
+// V8 holds map transitions weakly: once every instance of a class is collected (a list cleared
+// right before a full GC), the hidden class its constructor builds dies with them, and the
+// optimized code and inline caches that embedded it are thrown away, so the next render runs cold.
+// One inert instance of each hot class, never linked into a graph, keeps those shapes alive. Its
+// fields get the same assignments, in the same order, as real instances; values a user may supply
+// start as undefined, which no later value forces off the shared map (a number would, for one).
+// Stored with Object.defineProperty because bundlers drop a module-level instance nothing reads.
+function noop() {
+    // The keepers never run: their functions only fill the field.
+}
+const signalKeeper = new SignalNode(undefined);
+const effectKeeper = new EffectNode(noop);
+Object.defineProperty(SignalNode, "shapeKeeper", { value: signalKeeper });
+Object.defineProperty(ComputedNode, "shapeKeeper", { value: new ComputedNode(noop) });
+Object.defineProperty(EffectNode, "shapeKeeper", { value: effectKeeper });
+Object.defineProperty(Link, "shapeKeeper", { value: new Link(signalKeeper, effectKeeper, undefined, undefined) });
+export let activeSub = undefined;
+let observer = null;
+// The checks read this flag, not `observer`: minifiers fold a boolean that nothing ever sets to true
+// (no observer is installed in an app without devtools), which drops the instrumentation from
+// production bundles. A null check is not folded.
+let observing = false;
+let currentOwner = undefined;
+/** Installs an observer (null removes it) and returns the previous one. */
+export function setReactiveObserver(next) {
+    const prev = observer;
+    observer = next;
+    observing = next !== null;
+    return prev;
+}
+/**
+ * Marks what is being rendered, so effects created meanwhile are attributed to it, whether or not
+ * an observer is installed yet. Returns the previous owner, to restore afterwards.
+ */
+export function setCurrentOwner(owner) {
+    const prev = currentOwner;
+    currentOwner = owner;
+    return prev;
+}
+export function getEffectOwner(node) {
+    return node.owner;
+}
+export function setActiveSub(sub) {
+    const prev = activeSub;
+    activeSub = sub;
+    return prev;
+}
+/** Stops dependency tracking until `resumeTracking(prev)`; the closure-free form of untrack(). */
+export function pauseTracking() {
+    return setActiveSub(undefined);
+}
+export function resumeTracking(prev) {
+    activeSub = prev;
+}
+// ── Tracking ────────────────────────────────────────────────────────────────
+export function track(dep) {
+    const sub = activeSub;
+    if (sub === undefined)
+        return;
+    const prevDep = sub.depsTail;
+    if (prevDep?.dep === dep) {
+        prevDep.version = dep.version;
+        return;
+    }
+    const nextDep = prevDep !== undefined ? prevDep.nextDep : sub.deps;
+    if (nextDep?.dep === dep) {
+        nextDep.version = dep.version;
+        sub.depsTail = nextDep;
+        return;
+    }
+    // Read again out of order within the same run: the link already exists among the ones kept
+    // so far, so another one would only notify the subscriber twice.
+    const depsTail = dep.subsTail;
+    if (depsTail?.sub === sub && isTrackedLink(depsTail, sub)) {
+        depsTail.version = dep.version;
+        return;
+    }
+    const link = new Link(dep, sub, nextDep, dep.subsTail);
+    if (prevDep !== undefined)
+        prevDep.nextDep = link;
+    else
+        sub.deps = link;
+    sub.depsTail = link;
+    if (dep.subsTail !== undefined)
+        dep.subsTail.nextSub = link;
+    else
+        dep.subs = link;
+    dep.subsTail = link;
+}
+// Whether `link` is among the ones `sub` has read so far in its current run (deps up to depsTail).
+function isTrackedLink(link, sub) {
+    const tail = sub.depsTail;
+    if (tail === undefined)
+        return false;
+    let current = sub.deps;
+    for (;;) {
+        if (current === link)
+            return true;
+        if (current === tail)
+            return false;
+        current = current.nextDep;
+    }
+}
+export function startTracking(sub) {
+    sub.depsTail = undefined;
+    sub.flags = (sub.flags & ~(DIRTY | PENDING)) | RUNNING;
+    return setActiveSub(sub);
+}
+export function endTracking(sub, prev) {
+    activeSub = prev;
+    sub.flags &= ~RUNNING;
+    // Disposed during its own run (its scope went away): whatever it read after that must not keep it.
+    if ((sub.flags & DISPOSED) !== 0) {
+        unlinkDeps(sub);
+        return;
+    }
+    const tail = sub.depsTail;
+    let stale = tail !== undefined ? tail.nextDep : sub.deps;
+    if (stale !== undefined) {
+        if (tail !== undefined)
+            tail.nextDep = undefined;
+        else
+            sub.deps = undefined;
+        while (stale !== undefined)
+            stale = unlink(stale);
+    }
+}
+/** Removes every dependency of `sub`. */
+export function unlinkDeps(sub) {
+    let link = sub.deps;
+    sub.deps = undefined;
+    sub.depsTail = undefined;
+    while (link !== undefined)
+        link = unlink(link);
+}
+function unlink(link) {
+    const dep = link.dep;
+    const next = link.nextDep;
+    const prevSub = link.prevSub;
+    const nextSub = link.nextSub;
+    if (prevSub !== undefined)
+        prevSub.nextSub = nextSub;
+    else
+        dep.subs = nextSub;
+    if (nextSub !== undefined)
+        nextSub.prevSub = prevSub;
+    else
+        dep.subsTail = prevSub;
+    if (dep.subs === undefined && (dep.flags & WATCHED) !== 0)
+        dep.unwatched();
+    return next;
+}
+// ── Propagation ─────────────────────────────────────────────────────────────
+let batchDepth = 0;
+let flushing = false;
+const queue = [];
+let queueIndex = 0;
+export function isBatching() {
+    return batchDepth > 0;
+}
+export function startBatch() {
+    batchDepth++;
+}
+export function endBatch() {
+    if (--batchDepth === 0)
+        flush();
+}
+/** Marks the direct subscribers of a changed source and runs the effects that became stale. */
+export function notify(dep) {
+    let link = dep.subs;
+    if (link === undefined)
+        return;
+    do {
+        mark(link, DIRTY);
+        link = link.nextSub;
+    } while (link !== undefined);
+    if (batchDepth === 0)
+        flush();
+}
+function mark(link, flag) {
+    const node = link.sub;
+    const flags = node.flags;
+    // A subscriber that is running only depends on what it has read so far in this run: a write to
+    // a source it has not read again yet does not make the run stale.
+    if ((flags & RUNNING) !== 0 && !isTrackedLink(link, node))
+        return;
+    if ((flags & (DIRTY | PENDING)) !== 0) {
+        // Already stale: only an upgrade from PENDING to DIRTY changes anything, and its
+        // subscribers were marked when it first went stale. An effect upgraded this way read a signal
+        // that changed, so it joins the synchronous pass instead of waiting for the deferred one.
+        if (flag === DIRTY) {
+            node.flags = flags | DIRTY;
+            if ((flags & EFFECT) !== 0 && (flags & (QUEUED | RUNNING)) === 0)
+                enqueue(node);
+        }
+        return;
+    }
+    node.flags = flags | flag;
+    if ((flags & EFFECT) !== 0) {
+        // A running effect that invalidates itself is queued again once it finishes.
+        if ((flags & (QUEUED | RUNNING)) !== 0)
+            return;
+        if (flag === DIRTY)
+            enqueue(node);
+        else
+            defer(node);
+        return;
+    }
+    let sub = node.subs;
+    while (sub !== undefined) {
+        mark(sub, PENDING);
+        sub = sub.nextSub;
+    }
+}
+function enqueue(node) {
+    node.flags |= QUEUED;
+    queue.push(node);
+}
+// Effects that only depend on a change through a computed run in a microtask, so every write of the
+// same synchronous block reaches them as one update with the final values. They pull fresh values
+// when they run, and one that already re-ran for a direct change in the meantime is skipped.
+const deferred = [];
+let deferredScheduled = false;
+function defer(node) {
+    if ((node.flags & DEFERRED) !== 0)
+        return;
+    node.flags |= DEFERRED;
+    deferred.push(node);
+    if (deferredScheduled)
+        return;
+    deferredScheduled = true;
+    queueMicrotask(flushDeferred);
+}
+function flushDeferred() {
+    deferredScheduled = false;
+    // The synchronous queue always drains before a microtask, so none of these is queued already.
+    for (const node of deferred) {
+        node.flags &= ~DEFERRED;
+        enqueue(node);
+    }
+    deferred.length = 0;
+    flush();
+}
+export function flush() {
+    if (flushing)
+        return;
+    flushing = true;
+    let error;
+    let hasError = false;
+    try {
+        while (queueIndex < queue.length) {
+            const node = queue[queueIndex++];
+            node.flags &= ~QUEUED;
+            try {
+                if (isStale(node))
+                    runEffect(node);
+            }
+            catch (e) {
+                error = e;
+                hasError = true;
+            }
+        }
+    }
+    finally {
+        queue.length = 0;
+        queueIndex = 0;
+        flushing = false;
+    }
+    if (hasError)
+        throw error;
+}
+// ── Pull ────────────────────────────────────────────────────────────────────
+/** Whether a subscriber has to re-run: DIRTY, or PENDING with a source that really changed. */
+export function isStale(node) {
+    const flags = node.flags;
+    if ((flags & DISPOSED) !== 0)
+        return false;
+    if ((flags & (DIRTY | HAS_ERROR)) !== 0)
+        return true;
+    if ((flags & PENDING) === 0)
+        return false;
+    let link = node.deps;
+    while (link !== undefined) {
+        const dep = link.dep;
+        if ((dep.flags & COMPUTED) !== 0)
+            refreshComputed(dep);
+        if (link.version !== dep.version) {
+            node.flags |= DIRTY;
+            return true;
+        }
+        link = link.nextDep;
+    }
+    node.flags &= ~PENDING;
+    return false;
+}
+export function refreshComputed(node) {
+    if ((node.flags & RUNNING) !== 0)
+        throw new Error("[PraxisJS] Cycle detected while computing a value");
+    if (!isStale(node))
+        return;
+    const prev = startTracking(node);
+    let value;
+    let threw = false;
+    const start = observing ? performance.now() : 0;
+    try {
+        value = node.getter();
+    }
+    catch (e) {
+        value = e;
+        threw = true;
+    }
+    finally {
+        endTracking(node, prev);
+        if (observing)
+            observer.compute?.(node, performance.now() - start);
+    }
+    if (threw) {
+        // HAS_ERROR keeps it stale so the next read retries, without the DIRTY flag that would stop
+        // later source changes from reaching its subscribers. The error is rethrown to every reader.
+        node.flags |= HAS_ERROR;
+        node.error = value;
+        node.version++;
+        return;
+    }
+    const hadError = (node.flags & HAS_ERROR) !== 0;
+    node.flags &= ~HAS_ERROR;
+    node.error = undefined;
+    if (hadError || node.version === 0 || !Object.is(node.value, value)) {
+        node.value = value;
+        node.version++;
+    }
+}
+export function readComputed(node) {
+    refreshComputed(node);
+    track(node);
+    if ((node.flags & HAS_ERROR) !== 0)
+        throw node.error;
+    return node.value;
+}
+// ── Effects ─────────────────────────────────────────────────────────────────
+export function runEffect(node) {
+    const cleanup = node.cleanup;
+    if (cleanup !== undefined) {
+        node.cleanup = undefined;
+        const prevSub = setActiveSub(undefined);
+        try {
+            cleanup();
+        }
+        finally {
+            activeSub = prevSub;
+        }
+    }
+    const prev = startTracking(node);
+    // Effects created while this one runs (a reactive child rendering its content) inherit its owner.
+    const prevOwner = currentOwner;
+    if (node.owner !== undefined)
+        currentOwner = node.owner;
+    try {
+        if (!observing)
+            node.cleanup = node.fn();
+        else
+            runObserved(node);
+    }
+    finally {
+        currentOwner = prevOwner;
+        endTracking(node, prev);
+        // Invalidated while it ran: run again with the pass its invalidation calls for.
+        const flags = node.flags;
+        if ((flags & (DISPOSED | QUEUED)) === 0) {
+            if ((flags & DIRTY) !== 0) {
+                enqueue(node);
+                if (batchDepth === 0)
+                    flush();
+            }
+            else if ((flags & PENDING) !== 0) {
+                defer(node);
+            }
+        }
+    }
+}
+function runObserved(node) {
+    const start = performance.now();
+    try {
+        node.cleanup = node.fn();
+    }
+    finally {
+        observer.effect?.(node, performance.now() - start, node.owner);
+    }
+}
+export function disposeEffect(node) {
+    if ((node.flags & DISPOSED) !== 0)
+        return;
+    node.flags |= DISPOSED;
+    unlinkDeps(node);
+    const cleanup = node.cleanup;
+    node.cleanup = undefined;
+    if (cleanup !== undefined) {
+        const prevSub = setActiveSub(undefined);
+        try {
+            cleanup();
+        }
+        finally {
+            activeSub = prevSub;
+        }
+    }
+}
+export function createEffect(fn) {
+    const node = new EffectNode(fn, currentOwner);
+    runEffect(node);
+    return node;
+}
+/**
+ * Creates and runs an effect whose `fn` reads its state from `this.ctx`: one function can serve
+ * every effect of a kind (each DOM binding of a render), and each effect allocates no closure.
+ */
+export function createContextEffect(fn, ctx) {
+    const node = new EffectNode(fn, currentOwner, ctx);
+    runEffect(node);
+    return node;
+}
+// ── Signals ─────────────────────────────────────────────────────────────────
+export function readSignal(node) {
+    if (activeSub !== undefined)
+        track(node);
+    return node.value;
+}
+export function writeSignal(node, value) {
+    const prev = node.value;
+    // Object.is, inline: writes are hot and often run before the graph code is optimized, where a
+    // builtin call costs more than these comparisons.
+    if (prev === value ? value !== 0 || 1 / value === 1 / prev : value !== value && prev !== prev) {
+        return;
+    }
+    node.value = value;
+    node.version++;
+    if (observing)
+        observer.write?.(node);
+    // A signal nothing reads yet (a model being built) needs no notification pass.
+    if (node.subs !== undefined)
+        notify(node);
+}
+//# sourceMappingURL=graph.js.map

package/dist/signal/graph.js.map

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

package/dist/signal/index.d.ts

@@ -5,4 +5,5 @@ export { computed, writableComputed } from "./computed";
 export { type PersistedSignalOptions, type PersistedSignal, persistedSignal } from "./persisted";
 export { type SyncedSignal, syncedSignal } from "./synced";
 export { effect, untrack } from "./effect";
+export { type Selector, type SelectorEquals, selector } from "./selector";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","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,EAAE,KAAK,sBAAsB,EAAE,KAAK,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,KAAK,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","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,EAAE,KAAK,sBAAsB,EAAE,KAAK,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,KAAK,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

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