@lab206/core 0.1.0

package/dist/query.d.ts

@@ -0,0 +1,35 @@
+import type { Resource } from "./resource.js";
+export type QueryKey = string | number | false | null | undefined;
+export type CreateQueryOptions<T> = {
+    /**
+     * Reactive key. When `false` / `null` / `undefined`, the query is idle
+     * (no fetch). Change the key to re-run — same mental model as signals.
+     */
+    queryKey: () => QueryKey;
+    /** Async work for the current key. */
+    queryFn: (key: string) => Promise<T> | T;
+    /** Seed UI before the first success. */
+    initialData?: T;
+    /** Debug name for the underlying resource. */
+    name?: string;
+};
+/**
+ * Signal-native async query — thin, intentional ergonomics on `resource`.
+ *
+ * Why it feels great with Powers:
+ * - The key is a **function of signals** — no dependency arrays
+ * - `data()` / `loading()` / `error()` are fine-grained
+ * - `refetch()` re-runs without remounting the page
+ *
+ * @example
+ * ```ts
+ * const q = signal("design");
+ * const art = createQuery({
+ *   queryKey: () => q(),
+ *   queryFn: (key) => fetch(`/api/search?q=${key}`).then((r) => r.json()),
+ * });
+ * // art() · art.loading() · art.error() · art.refetch()
+ * ```
+ */
+export declare function createQuery<T>(options: CreateQueryOptions<T>): Resource<T>;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,eAAe,CAAC;AAE/D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;IAClC;;;OAGG;IACH,QAAQ,EAAE,MAAM,QAAQ,CAAC;IACzB,sCAAsC;IACtC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACzC,wCAAwC;IACxC,WAAW,CAAC,EAAE,CAAC,CAAC;IAChB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,QAAQ,CAAC,CAAC,CAAC,CAkBb"}

package/dist/query.js

@@ -0,0 +1,35 @@
+import { resource } from "./resource.js";
+/**
+ * Signal-native async query — thin, intentional ergonomics on `resource`.
+ *
+ * Why it feels great with Powers:
+ * - The key is a **function of signals** — no dependency arrays
+ * - `data()` / `loading()` / `error()` are fine-grained
+ * - `refetch()` re-runs without remounting the page
+ *
+ * @example
+ * ```ts
+ * const q = signal("design");
+ * const art = createQuery({
+ *   queryKey: () => q(),
+ *   queryFn: (key) => fetch(`/api/search?q=${key}`).then((r) => r.json()),
+ * });
+ * // art() · art.loading() · art.error() · art.refetch()
+ * ```
+ */
+export function createQuery(options) {
+    const opts = {
+        name: options.name ?? "query",
+    };
+    if (options.initialData !== undefined) {
+        opts.initialValue = options.initialData;
+    }
+    // Source is `string | false` so resource can idle; fetcher only runs when key is string.
+    return resource(() => {
+        const k = options.queryKey();
+        if (k === false || k === null || k === undefined)
+            return false;
+        return String(k);
+    }, (key) => options.queryFn(key), opts);
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAmBzC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CACzB,OAA8B;IAE9B,MAAM,IAAI,GAAuB;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO;KAC9B,CAAC;IACF,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAC1C,CAAC;IAED,yFAAyF;IACzF,OAAO,QAAQ,CACb,GAAmB,EAAE;QACnB,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC/D,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAa,CAAC,EACvC,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/resource.d.ts

@@ -0,0 +1,55 @@
+import type { ReadonlySignal, SignalOptions } from "./types.js";
+/** Lifecycle of a resource fetch. */
+export type ResourceState = "pending" | "ready" | "errored";
+export interface ResourceFetcherInfo<T> {
+    /** Previous successful value, if any. */
+    value: T | undefined;
+    /** True when we already had data and are fetching again. */
+    refetching: boolean;
+}
+export type ResourceFetcher<T, S> = (source: S, info: ResourceFetcherInfo<T>) => T | Promise<T>;
+export interface ResourceOptions<T> extends SignalOptions<T | undefined> {
+    /** Initial value before the first fetch settles. */
+    initialValue?: T;
+}
+/**
+ * Async-friendly reactive value.
+ *
+ * Learn it in 30 seconds:
+ * - `user()` → data (or `undefined` while loading the first time)
+ * - `user.loading()` → is a fetch in flight?
+ * - `user.error()` → last error, if any
+ * - `user.refetch()` → run again
+ *
+ * @example Fetcher only
+ * ```ts
+ * const users = resource(async () => {
+ *   const res = await fetch("/api/users");
+ *   return res.json() as Promise<User[]>;
+ * });
+ * ```
+ *
+ * @example Reactive source + fetcher (re-runs when source changes)
+ * ```ts
+ * const id = signal(1);
+ * const user = resource(
+ *   () => id(),
+ *   async (id) => (await fetch(`/api/users/${id}`)).json(),
+ * );
+ * ```
+ */
+export interface Resource<T> extends ReadonlySignal<T | undefined> {
+    /** True while a fetch is in flight. */
+    readonly loading: ReadonlySignal<boolean>;
+    /** Last error from the fetcher (cleared on success). */
+    readonly error: ReadonlySignal<unknown>;
+    /** Last successful value — kept during refetch so UI can stay stable. */
+    readonly latest: ReadonlySignal<T | undefined>;
+    /** Coarse lifecycle state. */
+    readonly state: ReadonlySignal<ResourceState>;
+    /** Re-run the fetcher with the current source. */
+    refetch(): void;
+}
+export declare function resource<T>(fetcher: (source: true, info: ResourceFetcherInfo<T>) => T | Promise<T>, options?: ResourceOptions<T>): Resource<T>;
+export declare function resource<T, S>(source: () => S, fetcher: ResourceFetcher<T, S>, options?: ResourceOptions<T>): Resource<T>;
+//# sourceMappingURL=resource.d.ts.map

package/dist/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,yCAAyC;IACzC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,4DAA4D;IAC5D,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAClC,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,KACzB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpB,MAAM,WAAW,eAAe,CAAC,CAAC,CAAE,SAAQ,aAAa,CAAC,CAAC,GAAG,SAAS,CAAC;IACtE,oDAAoD;IACpD,YAAY,CAAC,EAAE,CAAC,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,GAAG,SAAS,CAAC;IAChE,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC/C,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAC9C,kDAAkD;IAClD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,QAAQ,CAAC,CAAC,EACxB,OAAO,EAAE,CACP,MAAM,EAAE,IAAI,EACZ,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,KACzB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACnB,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,QAAQ,CAAC,CAAC,CAAC,CAAC;AAEf,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,MAAM,EAAE,MAAM,CAAC,EACf,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,QAAQ,CAAC,CAAC,CAAC,CAAC"}

package/dist/resource.js

@@ -0,0 +1,128 @@
+import { untrack } from "./graph.js";
+import { batch } from "./scheduler.js";
+import { computed, signal } from "./signal.js";
+import { effect } from "./effect.js";
+export function resource(sourceOrFetcher, fetcherOrOptions, maybeOptions) {
+    const hasSource = typeof fetcherOrOptions === "function";
+    const source = (hasSource ? sourceOrFetcher : () => true);
+    const fetcher = (hasSource
+        ? fetcherOrOptions
+        : sourceOrFetcher);
+    const options = (hasSource ? maybeOptions : fetcherOrOptions);
+    const initial = options?.initialValue;
+    const data = signal(initial, {
+        name: options?.name ? `${options.name}:data` : "resource:data",
+        ...(options?.equals ? { equals: options.equals } : {}),
+    });
+    const loading = signal(true, { name: "resource:loading" });
+    const error = signal(undefined, { name: "resource:error" });
+    const latest = signal(initial, { name: "resource:latest" });
+    const tick = signal(0, { name: "resource:tick" });
+    const state = computed(() => {
+        if (error() !== undefined)
+            return "errored";
+        if (loading())
+            return "pending";
+        return "ready";
+    }, { name: "resource:state" });
+    let currentToken = 0;
+    let disposed = false;
+    let hasSucceeded = initial !== undefined;
+    const runFetch = () => {
+        if (disposed)
+            return;
+        const token = ++currentToken;
+        const sourceValue = untrack(() => source());
+        // Skip until the source is ready (null | undefined | false).
+        if (sourceValue === false || sourceValue === null || sourceValue === undefined) {
+            batch(() => {
+                loading.set(false);
+            });
+            return;
+        }
+        const refetching = hasSucceeded;
+        batch(() => {
+            loading.set(true);
+            error.set(undefined);
+        });
+        let result;
+        try {
+            result = fetcher(sourceValue, {
+                value: latest.peek(),
+                refetching,
+            });
+        }
+        catch (err) {
+            if (token !== currentToken || disposed)
+                return;
+            batch(() => {
+                error.set(err);
+                loading.set(false);
+            });
+            return;
+        }
+        const settle = (ok, value) => {
+            if (token !== currentToken || disposed)
+                return;
+            batch(() => {
+                if (ok) {
+                    data.set(value);
+                    latest.set(value);
+                    error.set(undefined);
+                    hasSucceeded = true;
+                }
+                else {
+                    error.set(value);
+                }
+                loading.set(false);
+            });
+        };
+        if (isThenable(result)) {
+            result.then((value) => settle(true, value), (err) => settle(false, err));
+        }
+        else {
+            settle(true, result);
+        }
+    };
+    effect(() => {
+        source();
+        tick();
+        runFetch();
+        return () => {
+            // Invalidate in-flight work when deps change or the effect disposes.
+            currentToken++;
+        };
+    }, { name: options?.name ? `${options.name}:effect` : "resource:effect" });
+    // When the owner disposes all effects, in-flight promises must no-op.
+    // The cleanup above bumps the token on each re-run; final dispose also runs it.
+    // Additionally guard with a disposed flag via a zero-dep lifetime effect:
+    effect(() => {
+        return () => {
+            disposed = true;
+            currentToken++;
+        };
+    }, { name: "resource:lifetime" });
+    const read = Object.assign((() => data()), {
+        peek: () => data.peek(),
+        loading,
+        error,
+        latest,
+        state,
+        refetch: () => {
+            if (disposed)
+                return;
+            tick.update((v) => v + 1);
+        },
+    });
+    if (options?.name !== undefined) {
+        Object.defineProperty(read, "name", { value: options.name });
+    }
+    return read;
+}
+function isThenable(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "then" in value &&
+        typeof value.then === "function");
+}
+//# sourceMappingURL=resource.js.map

package/dist/resource.js.map

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

package/dist/scheduler.d.ts

@@ -0,0 +1,13 @@
+import type { ReactiveNode } from "./graph.js";
+/** Queue an effect node for execution. */
+export declare function enqueue(node: ReactiveNode): void;
+/** Run all queued effects. Nested enqueues during flush are drained too. */
+export declare function flush(): void;
+/**
+ * Batch multiple writes so dependents run once after the callback.
+ * Nested batches collapse into the outermost boundary.
+ */
+export declare function batch<T>(fn: () => T): T;
+/** True when currently inside `batch()`. */
+export declare function isBatching(): boolean;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAe/C,0CAA0C;AAC1C,wBAAgB,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAKhD;AAED,4EAA4E;AAC5E,wBAAgB,KAAK,IAAI,IAAI,CAiB5B;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAUvC;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,IAAI,OAAO,CAEpC"}

package/dist/scheduler.js

@@ -0,0 +1,62 @@
+/** Effects queued during the current flush cycle. */
+const queue = [];
+let scheduled = false;
+let flushing = false;
+let batchDepth = 0;
+function scheduleFlush() {
+    // While flushing, newly enqueued work is drained by the active for-loop.
+    if (scheduled || batchDepth > 0 || flushing)
+        return;
+    scheduled = true;
+    queueMicrotask(flush);
+}
+/** Queue an effect node for execution. */
+export function enqueue(node) {
+    if (node.pending)
+        return;
+    node.pending = true;
+    queue.push(node);
+    scheduleFlush();
+}
+/** Run all queued effects. Nested enqueues during flush are drained too. */
+export function flush() {
+    if (flushing)
+        return;
+    flushing = true;
+    scheduled = false;
+    try {
+        // Index loop so effects enqueued during a run are drained in this pass.
+        for (let i = 0; i < queue.length; i++) {
+            const node = queue[i];
+            node.pending = false;
+            if (node.disposed || !node.run)
+                continue;
+            node.run();
+        }
+    }
+    finally {
+        queue.length = 0;
+        flushing = false;
+    }
+}
+/**
+ * Batch multiple writes so dependents run once after the callback.
+ * Nested batches collapse into the outermost boundary.
+ */
+export function batch(fn) {
+    batchDepth++;
+    try {
+        return fn();
+    }
+    finally {
+        batchDepth--;
+        if (batchDepth === 0 && queue.length > 0) {
+            flush();
+        }
+    }
+}
+/** True when currently inside `batch()`. */
+export function isBatching() {
+    return batchDepth > 0;
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,MAAM,KAAK,GAAmB,EAAE,CAAC;AACjC,IAAI,SAAS,GAAG,KAAK,CAAC;AACtB,IAAI,QAAQ,GAAG,KAAK,CAAC;AACrB,IAAI,UAAU,GAAG,CAAC,CAAC;AAEnB,SAAS,aAAa;IACpB,yEAAyE;IACzE,IAAI,SAAS,IAAI,UAAU,GAAG,CAAC,IAAI,QAAQ;QAAE,OAAO;IACpD,SAAS,GAAG,IAAI,CAAC;IACjB,cAAc,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,OAAO,CAAC,IAAkB;IACxC,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO;IACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,aAAa,EAAE,CAAC;AAClB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,KAAK;IACnB,IAAI,QAAQ;QAAE,OAAO;IACrB,QAAQ,GAAG,IAAI,CAAC;IAChB,SAAS,GAAG,KAAK,CAAC;IAElB,IAAI,CAAC;QACH,wEAAwE;QACxE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACrB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,SAAS;YACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;IACH,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACjB,QAAQ,GAAG,KAAK,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAI,EAAW;IAClC,UAAU,EAAE,CAAC;IACb,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;YAAS,CAAC;QACT,UAAU,EAAE,CAAC;QACb,IAAI,UAAU,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;AACH,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,UAAU;IACxB,OAAO,UAAU,GAAG,CAAC,CAAC;AACxB,CAAC"}

package/dist/signal.d.ts

@@ -0,0 +1,25 @@
+import type { ReadonlySignal, Signal, SignalOptions } from "./types.js";
+/**
+ * Create a writable fine-grained reactive value.
+ *
+ * @example
+ * ```ts
+ * const count = signal(0);
+ * count();           // 0 (tracked read)
+ * count.set(1);
+ * count.update(n => n + 1);
+ * count.peek();      // untracked read
+ * ```
+ */
+export declare function signal<T>(initial: T, options?: SignalOptions<T>): Signal<T>;
+/**
+ * Create a derived readonly value that recomputes only when dependencies change.
+ *
+ * @example
+ * ```ts
+ * const double = computed(() => count() * 2);
+ * double(); // tracked
+ * ```
+ */
+export declare function computed<T>(fn: () => T, options?: SignalOptions<T>): ReadonlySignal<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":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIxE;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,MAAM,CAAC,CAAC,CAAC,CA2BX;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,EAAE,EAAE,MAAM,CAAC,EACX,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,cAAc,CAAC,CAAC,CAAC,CAqDnB"}

package/dist/signal.js

@@ -0,0 +1,94 @@
+import { createNode, notify, setActiveNode, track } from "./graph.js";
+const defaultEquals = Object.is;
+/**
+ * Create a writable fine-grained reactive value.
+ *
+ * @example
+ * ```ts
+ * const count = signal(0);
+ * count();           // 0 (tracked read)
+ * count.set(1);
+ * count.update(n => n + 1);
+ * count.peek();      // untracked read
+ * ```
+ */
+export function signal(initial, options) {
+    const equals = options?.equals ?? defaultEquals;
+    const node = createNode("signal", options?.name);
+    let value = initial;
+    const read = (() => {
+        track(node);
+        return value;
+    });
+    read.peek = () => value;
+    read.set = (next) => {
+        if (equals(value, next))
+            return;
+        value = next;
+        notify(node);
+    };
+    read.update = (fn) => {
+        read.set(fn(value));
+    };
+    if (options?.name !== undefined) {
+        Object.defineProperty(read, "name", { value: options.name });
+    }
+    return read;
+}
+/**
+ * Create a derived readonly value that recomputes only when dependencies change.
+ *
+ * @example
+ * ```ts
+ * const double = computed(() => count() * 2);
+ * double(); // tracked
+ * ```
+ */
+export function computed(fn, options) {
+    const equals = options?.equals ?? defaultEquals;
+    const node = createNode("computed", options?.name);
+    let value;
+    let hasValue = false;
+    const recompute = () => {
+        // Drop previous source links before re-tracking.
+        for (const source of node.sources) {
+            source.observers.delete(node);
+        }
+        node.sources.clear();
+        const prev = setActiveNode(node);
+        try {
+            const next = fn();
+            const changed = !hasValue || !equals(value, next);
+            value = next;
+            hasValue = true;
+            node.dirty = false;
+            // If value is unchanged after a dirty cycle, suppress further
+            // effect churn by not re-notifying. Effects already enqueued will
+            // still run once and see the same value — acceptable for v0.1.
+            void changed;
+        }
+        finally {
+            setActiveNode(prev);
+        }
+    };
+    node.run = recompute;
+    const ensure = () => {
+        if (node.disposed)
+            return value;
+        if (node.dirty || !hasValue) {
+            recompute();
+        }
+        return value;
+    };
+    const read = (() => {
+        const v = ensure();
+        track(node);
+        return v;
+    });
+    read.peek = () => ensure();
+    if (options?.name !== undefined) {
+        Object.defineProperty(read, "name", { value: options.name });
+    }
+    return read;
+}
+//# 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/store.d.ts

@@ -0,0 +1,52 @@
+import type { Signal, SignalOptions } from "./types.js";
+type PlainObject = Record<string, unknown>;
+/** Per-key signal accessors on a store. */
+export type StoreFields<T extends PlainObject> = {
+    readonly [K in keyof T]: Signal<T[K]>;
+};
+/**
+ * Shallow reactive object — each top-level key is a signal.
+ *
+ * This is the easiest multi-field state model to learn:
+ * ```ts
+ * const app = store({ count: 0, name: "Ada" });
+ * app.count();           // read
+ * app.count.set(1);      // write one field
+ * app.set({ count: 2, name: "Grace" }); // write many (batched)
+ * app();                 // snapshot { count, name } (tracks all keys)
+ * ```
+ */
+export type Store<T extends PlainObject> = StoreFields<T> & {
+    /** Reactive snapshot of all fields. */
+    (): {
+        [K in keyof T]: T[K];
+    };
+    /** Untracked snapshot. */
+    peek(): {
+        [K in keyof T]: T[K];
+    };
+    /** Batch-update one or more fields. */
+    set(partial: Partial<{
+        [K in keyof T]: T[K];
+    }>): void;
+    /** Replace every field from a full object. */
+    replace(next: {
+        [K in keyof T]: T[K];
+    }): void;
+};
+export interface StoreOptions {
+    name?: string;
+}
+/**
+ * Create a shallow store from a plain object.
+ * Nested objects are treated as single values (replace the whole nest to update).
+ * Prefer nesting `store()` calls if you need deep fine-grained fields.
+ */
+export declare function store<T extends PlainObject>(initial: T, options?: StoreOptions): Store<T>;
+/**
+ * Convenience: create a single named signal with the same options shape.
+ * Prefer `signal()` — this exists for API symmetry with `store`.
+ */
+export declare function cell<T>(initial: T, options?: SignalOptions<T>): Signal<T>;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C,2CAA2C;AAC3C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,WAAW,IAAI;IAC/C,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,WAAW,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IAC1D,uCAAuC;IACvC,IAAI;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IAC7B,0BAA0B;IAC1B,IAAI,IAAI;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IACjC,uCAAuC;IACvC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC,GAAG,IAAI,CAAC;IACtD,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAAE,GAAG,IAAI,CAAC;CAC/C,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,WAAW,EACzC,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,YAAY,GACrB,KAAK,CAAC,CAAC,CAAC,CA+DV;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEzE"}

package/dist/store.js

@@ -0,0 +1,70 @@
+import { batch } from "./scheduler.js";
+import { signal } from "./signal.js";
+/**
+ * Create a shallow store from a plain object.
+ * Nested objects are treated as single values (replace the whole nest to update).
+ * Prefer nesting `store()` calls if you need deep fine-grained fields.
+ */
+export function store(initial, options) {
+    const keys = Object.keys(initial);
+    const fields = {};
+    for (const key of keys) {
+        fields[key] = signal(initial[key], {
+            name: options?.name ? `${options.name}.${String(key)}` : String(key),
+        });
+    }
+    const snapshot = () => {
+        const out = {};
+        for (const key of keys) {
+            out[key] = fields[key]();
+        }
+        return out;
+    };
+    const peek = () => {
+        const out = {};
+        for (const key of keys) {
+            out[key] = fields[key].peek();
+        }
+        return out;
+    };
+    const set = (partial) => {
+        batch(() => {
+            for (const key of Object.keys(partial)) {
+                if (Object.prototype.hasOwnProperty.call(fields, key)) {
+                    fields[key].set(partial[key]);
+                }
+            }
+        });
+    };
+    const replace = (next) => {
+        batch(() => {
+            for (const key of keys) {
+                fields[key].set(next[key]);
+            }
+        });
+    };
+    // Callable store + field properties.
+    const api = snapshot;
+    api.peek = peek;
+    api.set = set;
+    api.replace = replace;
+    for (const key of keys) {
+        Object.defineProperty(api, key, {
+            enumerable: true,
+            configurable: false,
+            get: () => fields[key],
+        });
+    }
+    if (options?.name !== undefined) {
+        Object.defineProperty(api, "name", { value: options.name });
+    }
+    return api;
+}
+/**
+ * Convenience: create a single named signal with the same options shape.
+ * Prefer `signal()` — this exists for API symmetry with `store`.
+ */
+export function cell(initial, options) {
+    return signal(initial, options);
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+/** A function that reads reactive sources and may return a cleanup. */
+export type EffectFn = () => void | (() => void);
+/** Dispose callback that tears down an owner subtree or effect. */
+export type Dispose = () => void;
+/** Options for creating a writable signal. */
+export interface SignalOptions<T> {
+    /**
+     * Equality check. Defaults to `Object.is`.
+     * Return true when the next value should be treated as unchanged.
+     */
+    equals?: (prev: T, next: T) => boolean;
+    /** Optional debug name for DevTools / error messages. */
+    name?: string;
+}
+/** Readable reactive value. */
+export interface ReadonlySignal<T> {
+    /** Tracked read — registers the active effect/computed as a dependent. */
+    (): T;
+    /** Untracked read — does not register a dependency. */
+    peek(): T;
+    readonly name?: string;
+}
+/** Writable reactive value. */
+export interface Signal<T> extends ReadonlySignal<T> {
+    set(value: T): void;
+    update(fn: (prev: T) => T): void;
+}
+/** Internal node kinds used by the graph. */
+export type NodeKind = "signal" | "computed" | "effect";
+//# sourceMappingURL=types.d.ts.map