@rlabs-inc/signals 1.3.0 → 1.4.0

package/dist/primitives/linked.d.ts

@@ -0,0 +1,73 @@
+import type { WritableSignal, Equals } from '../core/types.js';
+/**
+ * Configuration for linkedSignal with explicit source and computation.
+ */
+export interface LinkedSignalOptions<S, D> {
+    source: () => S;
+    computation: (source: S, previous?: {
+        source: S;
+        value: D;
+    }) => D;
+    equal?: Equals<D>;
+}
+/**
+ * Short form: just a function that computes the value.
+ * The function itself is both source and computation.
+ */
+export type LinkedSignalShortForm<D> = () => D;
+/**
+ * Configuration can be either short form or full options.
+ */
+export type LinkedSignalConfig<S, D> = LinkedSignalShortForm<D> | LinkedSignalOptions<S, D>;
+/**
+ * Create a linked signal that derives from a source but can be manually overridden.
+ * When the source changes, the linked signal resets to the computed value.
+ *
+ * @example Simple form (derives directly from source)
+ * ```ts
+ * const options = signal(['a', 'b', 'c'])
+ * const selected = linkedSignal(() => options.value[0])
+ *
+ * console.log(selected.value) // 'a'
+ * selected.value = 'b' // Manual override
+ * console.log(selected.value) // 'b'
+ *
+ * options.value = ['x', 'y', 'z'] // Source changes
+ * console.log(selected.value) // 'x' (reset to new first item)
+ * ```
+ *
+ * @example Advanced form (with previous value tracking)
+ * ```ts
+ * const options = signal(['a', 'b', 'c'])
+ * const selected = linkedSignal({
+ *   source: () => options.value,
+ *   computation: (opts, prev) => {
+ *     // Keep selection if still valid
+ *     if (prev && opts.includes(prev.value)) {
+ *       return prev.value
+ *     }
+ *     return opts[0]
+ *   }
+ * })
+ * ```
+ *
+ * @example Form input with reset
+ * ```ts
+ * const user = signal({ name: 'Alice' })
+ * const editName = linkedSignal(() => user.value.name)
+ *
+ * // User types in input
+ * editName.value = 'Bob'
+ *
+ * // When user data reloads, form resets
+ * user.value = { name: 'Charlie' }
+ * console.log(editName.value) // 'Charlie'
+ * ```
+ */
+export declare function linkedSignal<D>(config: LinkedSignalShortForm<D>): WritableSignal<D>;
+export declare function linkedSignal<S, D>(config: LinkedSignalOptions<S, D>): WritableSignal<D>;
+/**
+ * Check if a value is a LinkedSignal.
+ */
+export declare function isLinkedSignal(value: unknown): value is WritableSignal<unknown>;
+//# sourceMappingURL=linked.d.ts.map

package/dist/primitives/linked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked.d.ts","sourceRoot":"","sources":["../../src/primitives/linked.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAY9D;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,EAAE,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC,CAAA;IACf,WAAW,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,KAAK,CAAC,CAAA;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,MAAM,CAAC,CAAA;AAE9C;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAM3F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;AACpF,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;AA4GxF;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAAC,OAAO,CAAC,CAM/E"}

package/dist/primitives/scope.d.ts

@@ -0,0 +1,96 @@
+import type { Effect, CleanupFn } from '../core/types.js';
+/**
+ * An effect scope that groups effects for batch disposal.
+ */
+export interface EffectScope {
+    /** Whether the scope is still active (not stopped) */
+    readonly active: boolean;
+    /** Whether the scope is paused */
+    readonly paused: boolean;
+    /**
+     * Run a function within this scope.
+     * Effects created during execution are tracked by this scope.
+     */
+    run<R>(fn: () => R): R | undefined;
+    /**
+     * Stop the scope, disposing all tracked effects.
+     */
+    stop(): void;
+    /**
+     * Pause all effects in this scope.
+     * Paused effects won't run until resumed.
+     */
+    pause(): void;
+    /**
+     * Resume all paused effects in this scope.
+     * Dirty effects will be scheduled for execution.
+     */
+    resume(): void;
+}
+/**
+ * Get the currently active scope.
+ */
+export declare function getCurrentScope(): EffectScope | null;
+/**
+ * Create an effect scope.
+ * Effects created within the scope can be disposed together.
+ *
+ * @example
+ * ```ts
+ * const scope = effectScope()
+ *
+ * scope.run(() => {
+ *   // These effects are tracked by the scope
+ *   effect(() => console.log(count.value))
+ *   effect(() => console.log(name.value))
+ * })
+ *
+ * // Later, dispose all effects at once
+ * scope.stop()
+ * ```
+ *
+ * @example With pause/resume
+ * ```ts
+ * const scope = effectScope()
+ *
+ * scope.run(() => {
+ *   effect(() => console.log(count.value))
+ * })
+ *
+ * // Pause effects (they won't run while paused)
+ * scope.pause()
+ *
+ * count.value++ // Effect doesn't run
+ *
+ * // Resume effects (pending updates will run)
+ * scope.resume()
+ * ```
+ *
+ * @param detached - If true, scope won't be collected by parent scope
+ */
+export declare function effectScope(detached?: boolean): EffectScope;
+/**
+ * Register a cleanup function on the current scope.
+ * Will be called when the scope is stopped.
+ *
+ * @example
+ * ```ts
+ * scope.run(() => {
+ *   const timer = setInterval(() => console.log('tick'), 1000)
+ *
+ *   onScopeDispose(() => {
+ *     clearInterval(timer)
+ *   })
+ * })
+ *
+ * // Later...
+ * scope.stop() // Timer is cleared
+ * ```
+ */
+export declare function onScopeDispose(fn: CleanupFn): void;
+/**
+ * Register an effect with the current scope.
+ * Called internally when an effect is created.
+ */
+export declare function registerEffectWithScope(effect: Effect): void;
+//# sourceMappingURL=scope.d.ts.map

package/dist/primitives/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/primitives/scope.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAUzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IAExB,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IAExB;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA;IAElC;;OAEG;IACH,IAAI,IAAI,IAAI,CAAA;IAEZ;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAA;IAEb;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAA;CACf;AAQD;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAEpD;AAoJD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,WAAW,CAE3D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAMlD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAI5D"}

package/dist/primitives/selector.d.ts

@@ -0,0 +1,46 @@
+import type { Reaction } from '../core/types.js';
+/**
+ * A selector function that returns whether a key matches the current selection.
+ */
+export type SelectorFn<T, U = T> = (key: U) => boolean;
+/**
+ * Create a selector function for efficient list selection tracking.
+ *
+ * Instead of each list item effect depending on the full selection state,
+ * only items whose selection status changed will re-run.
+ *
+ * This turns O(n) updates into O(2) updates: only the previously selected
+ * and newly selected items' effects run.
+ *
+ * @example
+ * ```ts
+ * const selectedId = signal(1)
+ * const isSelected = createSelector(() => selectedId.value)
+ *
+ * // In a list of 1000 items:
+ * items.forEach(item => {
+ *   effect(() => {
+ *     // Only runs when THIS item's selection state changes!
+ *     // When selectedId changes from 1 to 2:
+ *     // - Only item 1's effect runs (was selected, now not)
+ *     // - Only item 2's effect runs (was not selected, now is)
+ *     // - Other 998 items' effects DON'T run
+ *     if (isSelected(item.id)) {
+ *       highlight(item)
+ *     } else {
+ *       unhighlight(item)
+ *     }
+ *   })
+ * })
+ * ```
+ *
+ * @param source - Function returning the current selection value
+ * @param fn - Optional comparison function (defaults to strict equality)
+ */
+export declare function createSelector<T, U = T>(source: () => T, fn?: (key: U, value: T) => boolean): SelectorFn<T, U>;
+/**
+ * Cleanup helper - call this to manually clean up a selector's subscriptions.
+ * Usually not needed as destroyed reactions are automatically filtered.
+ */
+export declare function cleanupSelector<T, U>(selector: SelectorFn<T, U>, subscribers: Map<U, Set<Reaction>>): void;
+//# sourceMappingURL=selector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/primitives/selector.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAYhD;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAA;AAMtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EACrC,MAAM,EAAE,MAAM,CAAC,EACf,EAAE,GAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,OAAwC,GACjE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAwFlB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAClC,QAAQ,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,GACjC,IAAI,CAWN"}

package/dist/reactivity/scheduling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../src/reactivity/scheduling.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAkBxD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAmCvD;AAWD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAExE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAYnC;AAwBD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAc5C;AASD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CA6CxD;AAMD;;;GAGG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C"}
+{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../src/reactivity/scheduling.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAkBxD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAmCvD;AAWD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAExE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAiBnC;AAyBD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAmB5C;AASD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAkDxD;AAMD;;;GAGG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C"}

package/dist/reactivity/tracking.d.ts

@@ -6,6 +6,7 @@ import type { Source, Reaction, Derived } from '../core/types.js';
  * Key optimizations:
  * 1. Version-based deduplication (rv) prevents duplicate dependencies
  * 2. skippedDeps optimization reuses existing dependency arrays
+ * 3. ITERATIVE derived chain updates to avoid stack overflow
  */
 export declare function get<T>(signal: Source<T>): T;
 /**
@@ -16,6 +17,8 @@ export declare function set<T>(signal: Source<T>, value: T): T;
  * Mark all reactions of a signal with the given status
  * For effects: schedule them for execution
  * For deriveds: cascade MAYBE_DIRTY to their reactions
+ *
+ * ITERATIVE VERSION: Uses explicit stack to avoid stack overflow on deep chains
  */
 export declare function markReactions(signal: Source, status: number): void;
 /**
@@ -30,6 +33,8 @@ export declare function setSignalStatus(signal: {
  * DIRTY: definitely needs update
  * MAYBE_DIRTY: check dependencies to see if any actually changed
  * CLEAN: no update needed
+ *
+ * ITERATIVE VERSION: Uses explicit stack to avoid stack overflow on deep chains
  */
 export declare function isDirty(reaction: Reaction): boolean;
 export declare function updateDerived(derived: Derived): void;

package/dist/reactivity/tracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/reactivity/tracking.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAkCjE;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAmD3C;AAQD;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CA8BrD;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAuBlE;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3E;AAMD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAiCnD;AAWD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEpD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAE3E;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOvE;AA8BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAmG1D"}
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/reactivity/tracking.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAkCjE;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAiD3C;AAoGD;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CA8BrD;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA8BlE;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3E;AAMD;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAoGnD;AAWD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEpD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAE3E;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOvE;AA8BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAmG1D"}

package/dist/v2/bench-compare.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bench-compare.d.ts.map

package/dist/v2/bench-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bench-compare.d.ts","sourceRoot":"","sources":["../../src/v2/bench-compare.ts"],"names":[],"mappings":""}

package/dist/v2/bench.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @rlabs-inc/signals v2 - Performance Benchmarks
+ */
+export {};
+//# sourceMappingURL=bench.d.ts.map

package/dist/v2/bench.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bench.d.ts","sourceRoot":"","sources":["../../src/v2/bench.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/v2/bind.d.ts

@@ -0,0 +1,94 @@
+import type { Signal, ReadonlySignal } from './primitives.js';
+declare const BINDING_SYMBOL: unique symbol;
+export interface Binding<T> {
+    value: T;
+    readonly [BINDING_SYMBOL]: true;
+}
+export interface ReadonlyBinding<T> {
+    readonly value: T;
+    readonly [BINDING_SYMBOL]: true;
+}
+/**
+ * Check if a value is a binding.
+ */
+export declare function isBinding(value: unknown): value is Binding<unknown> | ReadonlyBinding<unknown>;
+/**
+ * Unwrap a binding to get its value, or return the value directly if not a binding.
+ */
+export declare function unwrap<T>(value: T | Binding<T>): T;
+/**
+ * Create a two-way binding to a signal.
+ *
+ * Changes to the binding update the source signal.
+ * Changes to the source signal update the binding.
+ *
+ * @example
+ * ```ts
+ * const count = signal(0)
+ * const binding = bind(count)
+ *
+ * binding.value = 5  // count.value is now 5
+ * count.value = 10   // binding.value is now 10
+ * ```
+ */
+export declare function bind<T>(source: Signal<T>): Binding<T>;
+export declare namespace bind {
+    var to: <T extends object, K extends keyof T>(source: Signal<T>, key: K) => Binding<T[K]>;
+}
+/**
+ * Create a one-way (readonly) binding to a signal.
+ *
+ * The binding tracks the source but cannot modify it.
+ *
+ * @example
+ * ```ts
+ * const count = signal(0)
+ * const readonly = bindReadonly(count)
+ *
+ * console.log(readonly.value)  // 0
+ * // readonly.value = 5  // Error: cannot assign
+ * ```
+ */
+export declare function bindReadonly<T>(source: Signal<T> | ReadonlySignal<T>): ReadonlyBinding<T>;
+export declare namespace bindReadonly {
+    var to: <T extends object, K extends keyof T>(source: Signal<T>, key: K) => ReadonlyBinding<T[K]>;
+}
+/**
+ * Create a computed binding with a getter and optional setter.
+ *
+ * @example
+ * ```ts
+ * const firstName = signal('Rodrigo')
+ * const lastName = signal('Santos')
+ *
+ * const fullName = bindComputed(
+ *   () => `${firstName.value} ${lastName.value}`,
+ *   (name) => {
+ *     const [first, ...rest] = name.split(' ')
+ *     firstName.value = first
+ *     lastName.value = rest.join(' ')
+ *   }
+ * )
+ *
+ * console.log(fullName.value)  // 'Rodrigo Santos'
+ * fullName.value = 'Rusty Developer'  // Updates both signals
+ * ```
+ */
+export declare function bindComputed<T>(getter: () => T, setter?: (value: T) => void): Binding<T> | ReadonlyBinding<T>;
+/**
+ * Extract signal wrappers from an object's properties.
+ *
+ * @example
+ * ```ts
+ * const user = signal({ name: 'Rusty', age: 43 })
+ * const { name, age } = signals(user)
+ *
+ * name.value = 'Rodrigo'  // user.value.name is now 'Rodrigo'
+ * console.log(age.value)  // 43
+ * ```
+ */
+export declare function signals<T extends object>(source: Signal<T>): {
+    [K in keyof T]: Binding<T[K]>;
+};
+export {};
+//# sourceMappingURL=bind.d.ts.map

package/dist/v2/bind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../src/v2/bind.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAM7D,QAAA,MAAM,cAAc,eAAoB,CAAA;AAExC,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,CAAA;IACR,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;CAChC;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;CAChC;AAMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAE9F;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAKlD;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUrD;yBAVe,IAAI;aAuBM,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,UACnD,MAAM,CAAC,CAAC,CAAC,OACZ,CAAC,KACL,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;;AAgBhB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAOzF;yBAPe,YAAY;aAoBc,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,UACnE,MAAM,CAAC,CAAC,CAAC,OACZ,CAAC,KACL,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;;AAaxB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,EAAE,MAAM,CAAC,EACf,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC1B,OAAO,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAqBjC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG;KAC3D,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9B,CA0CA"}

package/dist/v2/collections.d.ts

@@ -0,0 +1,133 @@
+/**
+ * A reactive Map with fine-grained per-key tracking.
+ *
+ * @example
+ * ```ts
+ * const users = new ReactiveMap<string, User>()
+ *
+ * effect(() => {
+ *   // Only re-runs when 'alice' changes
+ *   console.log(users.get('alice'))
+ * })
+ *
+ * users.set('bob', { name: 'Bob' })  // Effect doesn't run
+ * users.set('alice', { name: 'Alice' })  // Effect runs
+ * ```
+ */
+export declare class ReactiveMap<K, V> implements Map<K, V> {
+    private readonly map;
+    private readonly signals;
+    private readonly sizeSignalId;
+    private readonly keysSignalId;
+    constructor(entries?: Iterable<[K, V]> | null);
+    get size(): number;
+    has(key: K): boolean;
+    get(key: K): V | undefined;
+    set(key: K, value: V): this;
+    delete(key: K): boolean;
+    clear(): void;
+    forEach(callback: (value: V, key: K, map: Map<K, V>) => void, thisArg?: unknown): void;
+    keys(): MapIterator<K>;
+    values(): MapIterator<V>;
+    entries(): MapIterator<[K, V]>;
+    [Symbol.iterator](): MapIterator<[K, V]>;
+    get [Symbol.toStringTag](): string;
+}
+/**
+ * A reactive Set with fine-grained per-item tracking.
+ *
+ * @example
+ * ```ts
+ * const selected = new ReactiveSet<string>()
+ *
+ * effect(() => {
+ *   // Only re-runs when 'itemA' membership changes
+ *   console.log(selected.has('itemA'))
+ * })
+ *
+ * selected.add('itemB')  // Effect doesn't run
+ * selected.add('itemA')  // Effect runs
+ * ```
+ */
+export declare class ReactiveSet<T> implements Set<T> {
+    private readonly set;
+    private readonly signals;
+    private readonly sizeSignalId;
+    private readonly keysSignalId;
+    constructor(values?: Iterable<T> | null);
+    get size(): number;
+    has(value: T): boolean;
+    add(value: T): this;
+    delete(value: T): boolean;
+    clear(): void;
+    forEach(callback: (value: T, value2: T, set: Set<T>) => void, thisArg?: unknown): void;
+    keys(): SetIterator<T>;
+    values(): SetIterator<T>;
+    entries(): SetIterator<[T, T]>;
+    [Symbol.iterator](): SetIterator<T>;
+    get [Symbol.toStringTag](): string;
+}
+/**
+ * A reactive Date with tracked mutations.
+ *
+ * @example
+ * ```ts
+ * const deadline = new ReactiveDate()
+ *
+ * effect(() => {
+ *   console.log('Deadline:', deadline.toISOString())
+ * })
+ *
+ * deadline.setDate(deadline.getDate() + 1)  // Effect runs
+ * ```
+ */
+export declare class ReactiveDate extends Date {
+    private readonly timeSignalId;
+    constructor(...args: ConstructorParameters<typeof Date>);
+    private updateTime;
+    private trackTime;
+    getTime(): number;
+    getFullYear(): number;
+    getMonth(): number;
+    getDate(): number;
+    getDay(): number;
+    getHours(): number;
+    getMinutes(): number;
+    getSeconds(): number;
+    getMilliseconds(): number;
+    getUTCFullYear(): number;
+    getUTCMonth(): number;
+    getUTCDate(): number;
+    getUTCDay(): number;
+    getUTCHours(): number;
+    getUTCMinutes(): number;
+    getUTCSeconds(): number;
+    getUTCMilliseconds(): number;
+    getTimezoneOffset(): number;
+    toISOString(): string;
+    toJSON(): string;
+    toString(): string;
+    toDateString(): string;
+    toTimeString(): string;
+    toLocaleString(): string;
+    toLocaleDateString(): string;
+    toLocaleTimeString(): string;
+    toUTCString(): string;
+    valueOf(): number;
+    setTime(time: number): number;
+    setFullYear(year: number, month?: number, date?: number): number;
+    setMonth(month: number, date?: number): number;
+    setDate(date: number): number;
+    setHours(hours: number, min?: number, sec?: number, ms?: number): number;
+    setMinutes(min: number, sec?: number, ms?: number): number;
+    setSeconds(sec: number, ms?: number): number;
+    setMilliseconds(ms: number): number;
+    setUTCFullYear(year: number, month?: number, date?: number): number;
+    setUTCMonth(month: number, date?: number): number;
+    setUTCDate(date: number): number;
+    setUTCHours(hours: number, min?: number, sec?: number, ms?: number): number;
+    setUTCMinutes(min: number, sec?: number, ms?: number): number;
+    setUTCSeconds(sec: number, ms?: number): number;
+    setUTCMilliseconds(ms: number): number;
+}
+//# sourceMappingURL=collections.d.ts.map

package/dist/v2/collections.d.ts.map

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

package/dist/v2/compat-test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compat-test.d.ts.map

package/dist/v2/compat-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat-test.d.ts","sourceRoot":"","sources":["../../src/v2/compat-test.ts"],"names":[],"mappings":""}

package/dist/v2/debug-array.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=debug-array.d.ts.map

package/dist/v2/debug-array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-array.d.ts","sourceRoot":"","sources":["../../src/v2/debug-array.ts"],"names":[],"mappings":""}

package/dist/v2/debug-diamond.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=debug-diamond.d.ts.map

package/dist/v2/debug-diamond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-diamond.d.ts","sourceRoot":"","sources":["../../src/v2/debug-diamond.ts"],"names":[],"mappings":""}

package/dist/v2/index.d.ts

@@ -0,0 +1,7 @@
+export { signal, state, // Alias for signal (backwards compatibility)
+derived, effect, batch, untrack, flushSync, defaultEquals, neverEquals, shallowEquals, type Signal, type ReadonlySignal, type SignalOptions, type EffectOptions, } from './primitives.js';
+export { bind, bindReadonly, bindComputed, signals, isBinding, unwrap, type Binding, type ReadonlyBinding, } from './bind.js';
+export { ReactiveMap, ReactiveSet, ReactiveDate, } from './collections.js';
+export { isProxied, toRaw, } from './proxy.js';
+export { getNodeInfo, getStats, } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v2/index.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,MAAM,EACN,KAAK,EAAG,6CAA6C;AACrD,OAAO,EACP,MAAM,EAGN,KAAK,EACL,OAAO,EACP,SAAS,EAGT,aAAa,EACb,WAAW,EACX,aAAa,EAGb,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAA;AAMxB,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,SAAS,EACT,MAAM,EAGN,KAAK,OAAO,EACZ,KAAK,eAAe,GACrB,MAAM,WAAW,CAAA;AAMlB,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,kBAAkB,CAAA;AAMzB,OAAO,EACL,SAAS,EACT,KAAK,GACN,MAAM,YAAY,CAAA;AAMnB,OAAO,EACL,WAAW,EACX,QAAQ,GACT,MAAM,eAAe,CAAA"}