@lab206/core 0.1.0

package/LICENSE

@@ -0,0 +1,114 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Scott Powers
+
+Licensed Work:        Powers
+                      The Licensed Work is (c) 2026 Scott Powers
+
+Additional Use Grant: You may make production use of the Licensed Work,
+                      provided You do not use the Licensed Work for a
+                      Competing Offering.
+
+                      A “Competing Offering” is a product, hosted service,
+                      library, framework, design system, or documentation
+                      site whose primary purpose is to provide a
+                      general-purpose UI runtime, component library, or
+                      design-system kit that substitutes for the Licensed
+                      Work (including rebranded or forked distributions
+                      marketed as a competing UI kit or “Powers
+                      alternative”).
+
+                      Building end-user applications, internal tools, or
+                      client project work *with* the Licensed Work is
+                      allowed and is not a Competing Offering.
+
+Change Date:          Four years from the first public release of each
+                      version of the Licensed Work, or 2030-08-15,
+                      whichever is earlier for that version
+
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Software,
+see LICENSE-COMMERCIAL.md or contact the Licensor.
+
+Notice
+
+The Business Source License (this document, or the “License”) is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+“Business Source License” is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark “Business Source License”,
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the “Business
+Source License” name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where “compatible” means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text “None”.
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/README.md

@@ -0,0 +1,6 @@
+# @lab206/core
+
+Part of [Powers](https://github.com/spowers2/powers) — fine-grained UI kit with a design system built in.
+
+- Docs: https://lab206.com/docs
+- License: BUSL-1.1 (source-available)

package/dist/effect.d.ts

@@ -0,0 +1,31 @@
+import { type ReactiveNode } from "./graph.js";
+import type { Dispose, EffectFn } from "./types.js";
+export interface EffectOptions {
+    name?: string;
+    /** Local error handler (runs before owner `onError` handlers). */
+    onError?: (error: unknown) => void;
+}
+/**
+ * Run `fn` immediately, track reactive reads, and re-run when they change.
+ * Returns a dispose function. `fn` may return a cleanup called before the
+ * next run and on dispose.
+ *
+ * Errors are caught so one bad effect cannot tear down the whole graph.
+ * Handle them with `options.onError` or owner-level `onError()`.
+ *
+ * @example
+ * ```ts
+ * const stop = effect(() => {
+ *   console.log(count());
+ *   return () => console.log("cleanup");
+ * });
+ * stop();
+ * ```
+ */
+export declare function effect(fn: EffectFn, options?: EffectOptions): Dispose;
+/**
+ * Schedule an effect run without running it now.
+ * Primarily for internal/testing use.
+ */
+export declare function scheduleEffect(node: ReactiveNode): void;
+//# sourceMappingURL=effect.d.ts.map

package/dist/effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../src/effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAyDrE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAEvD"}

package/dist/effect.js

@@ -0,0 +1,85 @@
+import { clearSources, createNode, disposeNode, getActiveOwner, setActiveNode, } from "./graph.js";
+import { reportError } from "./errors.js";
+import { enqueue } from "./scheduler.js";
+/**
+ * Run `fn` immediately, track reactive reads, and re-run when they change.
+ * Returns a dispose function. `fn` may return a cleanup called before the
+ * next run and on dispose.
+ *
+ * Errors are caught so one bad effect cannot tear down the whole graph.
+ * Handle them with `options.onError` or owner-level `onError()`.
+ *
+ * @example
+ * ```ts
+ * const stop = effect(() => {
+ *   console.log(count());
+ *   return () => console.log("cleanup");
+ * });
+ * stop();
+ * ```
+ */
+export function effect(fn, options) {
+    const node = createNode("effect", options?.name);
+    const owner = getActiveOwner();
+    const localOnError = options?.onError;
+    const run = () => {
+        if (node.disposed)
+            return;
+        if (node.cleanup) {
+            const c = node.cleanup;
+            node.cleanup = undefined;
+            try {
+                c();
+            }
+            catch (err) {
+                handle(err);
+            }
+        }
+        clearSources(node);
+        const prev = setActiveNode(node);
+        try {
+            const cleanup = fn();
+            if (typeof cleanup === "function") {
+                node.cleanup = cleanup;
+            }
+        }
+        catch (err) {
+            handle(err);
+        }
+        finally {
+            setActiveNode(prev);
+        }
+    };
+    function handle(err) {
+        if (localOnError) {
+            try {
+                localOnError(err);
+                return;
+            }
+            catch (handlerError) {
+                // Fall through to owner handlers with the handler error.
+                if (reportError(handlerError, owner))
+                    return;
+                console.error("[powers] effect onError handler threw:", handlerError);
+                return;
+            }
+        }
+        if (reportError(err, owner))
+            return;
+        console.error("[powers] Unhandled effect error:", err);
+    }
+    node.run = run;
+    // Initial run is synchronous so first paint / first log is immediate.
+    run();
+    return () => {
+        disposeNode(node);
+    };
+}
+/**
+ * Schedule an effect run without running it now.
+ * Primarily for internal/testing use.
+ */
+export function scheduleEffect(node) {
+    enqueue(node);
+}
+//# sourceMappingURL=effect.js.map

package/dist/effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.js","sourceRoot":"","sources":["../src/effect.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,GAEd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AASzC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,MAAM,CAAC,EAAY,EAAE,OAAuB;IAC1D,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,OAAO,EAAE,OAAO,CAAC;IAEtC,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE1B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC;gBACH,CAAC,EAAE,CAAC;YACN,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;QACH,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,CAAC;QAEnB,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,EAAE,CAAC;YACrB,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IAEF,SAAS,MAAM,CAAC,GAAY;QAC1B,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,YAAY,CAAC,GAAG,CAAC,CAAC;gBAClB,OAAO;YACT,CAAC;YAAC,OAAO,YAAY,EAAE,CAAC;gBACtB,yDAAyD;gBACzD,IAAI,WAAW,CAAC,YAAY,EAAE,KAAK,CAAC;oBAAE,OAAO;gBAC7C,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,YAAY,CAAC,CAAC;gBACtE,OAAO;YACT,CAAC;QACH,CAAC;QACD,IAAI,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC;YAAE,OAAO;QACpC,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IAEf,sEAAsE;IACtE,GAAG,EAAE,CAAC;IAEN,OAAO,GAAG,EAAE;QACV,WAAW,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+import { type Owner } from "./graph.js";
+import type { Dispose } from "./types.js";
+type ErrorHandler = (error: unknown) => void;
+/**
+ * Register an error handler for the **current owner** (from `createRoot`).
+ * Effect errors bubble to these handlers instead of crashing the graph.
+ *
+ * @example
+ * ```ts
+ * createRoot(() => {
+ *   onError((err) => console.error("caught", err));
+ *   effect(() => { throw new Error("boom"); });
+ * });
+ * ```
+ */
+export declare function onError(fn: ErrorHandler): Dispose;
+/**
+ * Report an error to the nearest owner handlers, then parent owners,
+ * then the global handler. Returns true if anyone handled it.
+ */
+export declare function reportError(error: unknown, owner: Owner | null): boolean;
+/** @internal */
+export declare function clearGlobalErrorHandler(): void;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAQ7C;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAqBjD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CA4BxE;AAED,gBAAgB;AAChB,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/errors.js

@@ -0,0 +1,76 @@
+import { getActiveOwner } from "./graph.js";
+/** Owner → handlers registered while that owner is active. */
+const ownerHandlers = new WeakMap();
+/** Fallback when no owner handler claims the error. */
+let globalHandler = null;
+/**
+ * Register an error handler for the **current owner** (from `createRoot`).
+ * Effect errors bubble to these handlers instead of crashing the graph.
+ *
+ * @example
+ * ```ts
+ * createRoot(() => {
+ *   onError((err) => console.error("caught", err));
+ *   effect(() => { throw new Error("boom"); });
+ * });
+ * ```
+ */
+export function onError(fn) {
+    const owner = getActiveOwner();
+    if (!owner) {
+        // No owner — install as process-local global for this call site's lifetime.
+        const prev = globalHandler;
+        globalHandler = fn;
+        return () => {
+            if (globalHandler === fn)
+                globalHandler = prev;
+        };
+    }
+    let set = ownerHandlers.get(owner);
+    if (!set) {
+        set = new Set();
+        ownerHandlers.set(owner, set);
+    }
+    set.add(fn);
+    return () => {
+        set.delete(fn);
+    };
+}
+/**
+ * Report an error to the nearest owner handlers, then parent owners,
+ * then the global handler. Returns true if anyone handled it.
+ */
+export function reportError(error, owner) {
+    let current = owner;
+    while (current) {
+        const set = ownerHandlers.get(current);
+        if (set && set.size > 0) {
+            for (const handler of set) {
+                try {
+                    handler(error);
+                }
+                catch (handlerError) {
+                    // Handler bugs should not recurse forever.
+                    console.error("[powers] onError handler threw:", handlerError);
+                }
+            }
+            return true;
+        }
+        current = current.parent;
+    }
+    if (globalHandler) {
+        try {
+            globalHandler(error);
+        }
+        catch (handlerError) {
+            console.error("[powers] onError handler threw:", handlerError);
+        }
+        return true;
+    }
+    return false;
+}
+/** @internal */
+export function clearGlobalErrorHandler() {
+    globalHandler = null;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAc,MAAM,YAAY,CAAC;AAKxD,8DAA8D;AAC9D,MAAM,aAAa,GAAG,IAAI,OAAO,EAA4B,CAAC;AAE9D,uDAAuD;AACvD,IAAI,aAAa,GAAwB,IAAI,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO,CAAC,EAAgB;IACtC,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,4EAA4E;QAC5E,MAAM,IAAI,GAAG,aAAa,CAAC;QAC3B,aAAa,GAAG,EAAE,CAAC;QACnB,OAAO,GAAG,EAAE;YACV,IAAI,aAAa,KAAK,EAAE;gBAAE,aAAa,GAAG,IAAI,CAAC;QACjD,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QAChB,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IACD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEZ,OAAO,GAAG,EAAE;QACV,GAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,KAAmB;IAC7D,IAAI,OAAO,GAAiB,KAAK,CAAC;IAClC,OAAO,OAAO,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,OAAO,CAAC,KAAK,CAAC,CAAC;gBACjB,CAAC;gBAAC,OAAO,YAAY,EAAE,CAAC;oBACtB,2CAA2C;oBAC3C,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,YAAY,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,YAAY,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,YAAY,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,uBAAuB;IACrC,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/dist/graph.d.ts

@@ -0,0 +1,62 @@
+import type { Dispose, NodeKind } from "./types.js";
+/** A node in the reactive dependency graph. */
+export interface ReactiveNode {
+    kind: NodeKind;
+    name?: string;
+    disposed: boolean;
+    pending: boolean;
+    /** Sources this node currently depends on. */
+    sources: Set<ReactiveNode>;
+    /** Nodes that depend on this node. */
+    observers: Set<ReactiveNode>;
+    /** For computed: dirty when a source may have changed. */
+    dirty: boolean;
+    /** Recompute value (computed) or re-run body (effect). */
+    run?: () => void;
+    /** Cleanup registered by the last effect run. */
+    cleanup?: (() => void) | undefined;
+    /** Owner that created this node (for disposal trees). */
+    owner: Owner | null;
+    /** Child nodes owned by this owner-like node (effects/roots). */
+    children?: Set<ReactiveNode>;
+}
+/** Ownership scope — disposing a root disposes all owned nodes. */
+export interface Owner {
+    parent: Owner | null;
+    nodes: Set<ReactiveNode>;
+    disposed: boolean;
+}
+export declare function getActiveNode(): ReactiveNode | null;
+export declare function setActiveNode(node: ReactiveNode | null): ReactiveNode | null;
+export declare function getActiveOwner(): Owner | null;
+export declare function setActiveOwner(owner: Owner | null): Owner | null;
+export declare function isTracking(): boolean;
+/** Run `fn` without collecting dependencies. */
+export declare function untrack<T>(fn: () => T): T;
+export declare function createOwner(parent?: Owner | null): Owner;
+export declare function createNode(kind: NodeKind, name?: string, owner?: Owner | null): ReactiveNode;
+/** Register `source` as a dependency of the active consumer. */
+export declare function track(source: ReactiveNode): void;
+/** Drop all current source links for a node (before re-running). */
+export declare function clearSources(node: ReactiveNode): void;
+/** Notify observers that `source` changed. */
+export declare function notify(source: ReactiveNode): void;
+/** Dispose a single node and unlink it from the graph. */
+export declare function disposeNode(node: ReactiveNode): void;
+/** Dispose an owner and every node it owns (depth-first). */
+export declare function disposeOwner(owner: Owner): void;
+/**
+ * Create a reactive root. All signals/effects created inside are owned by
+ * this root and disposed when the returned dispose function is called.
+ *
+ * Clears the active *tracking* node while `fn` runs so parent effects (e.g.
+ * a router outlet) do not accidentally subscribe to signals read during
+ * component setup — that would remount the whole page on first keystroke.
+ */
+export declare function createRoot<T>(fn: (dispose: Dispose) => T): T;
+/**
+ * Run `fn` under a fresh owner nested under the current owner.
+ * Useful for scoped components later.
+ */
+export declare function runWithOwner<T>(owner: Owner | null, fn: () => T): T;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGpD,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IAC3B,sCAAsC;IACtC,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7B,0DAA0D;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,iDAAiD;IACjD,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnC,yDAAyD;IACzD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;CAC9B;AAED,mEAAmE;AACnE,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAMD,wBAAgB,aAAa,IAAI,YAAY,GAAG,IAAI,CAEnD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAI5E;AAED,wBAAgB,cAAc,IAAI,KAAK,GAAG,IAAI,CAE7C;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAIhE;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,gDAAgD;AAChD,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQzC;AAED,wBAAgB,WAAW,CAAC,MAAM,GAAE,KAAK,GAAG,IAAkB,GAAG,KAAK,CAMrE;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,GAAE,KAAK,GAAG,IAAkB,GAChC,YAAY,CAmBd;AAED,gEAAgE;AAChE,wBAAgB,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAMhD;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAKrD;AAED,8CAA8C;AAC9C,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAcjD;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CA2BpD;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAU/C;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAe5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAOnE"}

package/dist/graph.js

@@ -0,0 +1,165 @@
+import { enqueue } from "./scheduler.js";
+let activeNode = null;
+let activeOwner = null;
+let tracking = true;
+export function getActiveNode() {
+    return activeNode;
+}
+export function setActiveNode(node) {
+    const prev = activeNode;
+    activeNode = node;
+    return prev;
+}
+export function getActiveOwner() {
+    return activeOwner;
+}
+export function setActiveOwner(owner) {
+    const prev = activeOwner;
+    activeOwner = owner;
+    return prev;
+}
+export function isTracking() {
+    return tracking;
+}
+/** Run `fn` without collecting dependencies. */
+export function untrack(fn) {
+    const prev = tracking;
+    tracking = false;
+    try {
+        return fn();
+    }
+    finally {
+        tracking = prev;
+    }
+}
+export function createOwner(parent = activeOwner) {
+    return {
+        parent,
+        nodes: new Set(),
+        disposed: false,
+    };
+}
+export function createNode(kind, name, owner = activeOwner) {
+    const node = {
+        kind,
+        disposed: false,
+        pending: false,
+        sources: new Set(),
+        observers: new Set(),
+        dirty: true,
+        owner,
+    };
+    if (name !== undefined) {
+        node.name = name;
+    }
+    if (owner && !owner.disposed) {
+        owner.nodes.add(node);
+    }
+    return node;
+}
+/** Register `source` as a dependency of the active consumer. */
+export function track(source) {
+    if (!tracking || !activeNode || activeNode === source || source.disposed) {
+        return;
+    }
+    source.observers.add(activeNode);
+    activeNode.sources.add(source);
+}
+/** Drop all current source links for a node (before re-running). */
+export function clearSources(node) {
+    for (const source of node.sources) {
+        source.observers.delete(node);
+    }
+    node.sources.clear();
+}
+/** Notify observers that `source` changed. */
+export function notify(source) {
+    for (const observer of source.observers) {
+        if (observer.disposed)
+            continue;
+        if (observer.kind === "computed") {
+            if (!observer.dirty) {
+                observer.dirty = true;
+                // Propagate dirty flags through computed chains.
+                notify(observer);
+            }
+        }
+        else if (observer.kind === "effect") {
+            enqueue(observer);
+        }
+    }
+}
+/** Dispose a single node and unlink it from the graph. */
+export function disposeNode(node) {
+    if (node.disposed)
+        return;
+    node.disposed = true;
+    if (node.cleanup) {
+        const c = node.cleanup;
+        node.cleanup = undefined;
+        c();
+    }
+    clearSources(node);
+    for (const observer of node.observers) {
+        observer.sources.delete(node);
+    }
+    node.observers.clear();
+    if (node.children) {
+        for (const child of node.children) {
+            disposeNode(child);
+        }
+        node.children.clear();
+    }
+    if (node.owner) {
+        node.owner.nodes.delete(node);
+    }
+}
+/** Dispose an owner and every node it owns (depth-first). */
+export function disposeOwner(owner) {
+    if (owner.disposed)
+        return;
+    owner.disposed = true;
+    // Snapshot — disposal mutates the set.
+    const nodes = [...owner.nodes];
+    for (const node of nodes) {
+        disposeNode(node);
+    }
+    owner.nodes.clear();
+}
+/**
+ * Create a reactive root. All signals/effects created inside are owned by
+ * this root and disposed when the returned dispose function is called.
+ *
+ * Clears the active *tracking* node while `fn` runs so parent effects (e.g.
+ * a router outlet) do not accidentally subscribe to signals read during
+ * component setup — that would remount the whole page on first keystroke.
+ */
+export function createRoot(fn) {
+    const owner = createOwner(activeOwner);
+    const prevOwner = setActiveOwner(owner);
+    const prevNode = setActiveNode(null);
+    const dispose = () => {
+        disposeOwner(owner);
+    };
+    try {
+        return fn(dispose);
+    }
+    finally {
+        setActiveOwner(prevOwner);
+        setActiveNode(prevNode);
+    }
+}
+/**
+ * Run `fn` under a fresh owner nested under the current owner.
+ * Useful for scoped components later.
+ */
+export function runWithOwner(owner, fn) {
+    const prev = setActiveOwner(owner);
+    try {
+        return fn();
+    }
+    finally {
+        setActiveOwner(prev);
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @lab206/core
+ *
+ * Fine-grained reactivity primitives.
+ * No DOM. No framework. Just a correct reactive graph.
+ *
+ * Learning order (intentionally short):
+ *   1. signal  2. computed  3. effect  4. store  5. resource / createQuery
+ */
+export { signal, computed } from "./signal.js";
+export { effect } from "./effect.js";
+export type { EffectOptions } from "./effect.js";
+export { batch, flush, isBatching } from "./scheduler.js";
+export { createRoot, untrack, getActiveOwner, runWithOwner, createOwner, disposeOwner, } from "./graph.js";
+export { store, cell } from "./store.js";
+export type { Store, StoreFields, StoreOptions } from "./store.js";
+export { resource } from "./resource.js";
+export type { Resource, ResourceState, ResourceOptions, ResourceFetcher, ResourceFetcherInfo, } from "./resource.js";
+export { createQuery } from "./query.js";
+export type { CreateQueryOptions, QueryKey } from "./query.js";
+export { onError } from "./errors.js";
+export type { Signal, ReadonlySignal, SignalOptions, EffectFn, Dispose, } from "./types.js";
+export type { Owner } from "./graph.js";
+//# 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;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,UAAU,EACV,OAAO,EACP,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,YAAY,EACV,MAAM,EACN,cAAc,EACd,aAAa,EACb,QAAQ,EACR,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @lab206/core
+ *
+ * Fine-grained reactivity primitives.
+ * No DOM. No framework. Just a correct reactive graph.
+ *
+ * Learning order (intentionally short):
+ *   1. signal  2. computed  3. effect  4. store  5. resource / createQuery
+ */
+export { signal, computed } from "./signal.js";
+export { effect } from "./effect.js";
+export { batch, flush, isBatching } from "./scheduler.js";
+export { createRoot, untrack, getActiveOwner, runWithOwner, createOwner, disposeOwner, } from "./graph.js";
+export { store, cell } from "./store.js";
+export { resource } from "./resource.js";
+export { createQuery } from "./query.js";
+export { onError } from "./errors.js";
+//# 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;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,UAAU,EACV,OAAO,EACP,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAQzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}