@rlabs-inc/signals 0.2.0 → 1.0.0

package/dist/collections/map.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A reactive Map with per-key granularity
+ *
+ * Three levels of reactivity:
+ * 1. Per-key signals: map.get('key') only tracks that specific key
+ * 2. Version signal: Tracks structural changes (add/delete)
+ * 3. Size signal: Tracks map size changes
+ *
+ * @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' }) // Doesn't trigger above effect
+ * users.set('alice', { name: 'Alice Updated' }) // Triggers effect
+ * ```
+ */
+export declare class ReactiveMap<K, V> extends Map<K, V> {
+    #private;
+    constructor(entries?: Iterable<readonly [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;
+    keys(): MapIterator<K>;
+    values(): MapIterator<V>;
+    entries(): MapIterator<[K, V]>;
+    forEach(callbackfn: (value: V, key: K, map: Map<K, V>) => void, thisArg?: unknown): void;
+    [Symbol.iterator](): MapIterator<[K, V]>;
+}
+//# sourceMappingURL=map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/collections/map.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,WAAW,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;;gBAUlC,OAAO,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI;IA4BtD,IAAI,IAAI,IAAI,MAAM,CAGjB;IAMD,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAwBpB,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IA0B1B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAsC3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAwBvB,KAAK,IAAI,IAAI;IAmBb,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC;IAKtB,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC;IAKxB,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAK9B,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAKxF,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAGzC"}

package/dist/collections/set.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A reactive Set with per-item granularity
+ *
+ * Three levels of reactivity:
+ * 1. Per-item signals: set.has(item) only tracks that specific item
+ * 2. Version signal: Tracks structural changes (add/delete)
+ * 3. Size signal: Tracks set size changes
+ *
+ * @example
+ * ```ts
+ * const tags = new ReactiveSet<string>()
+ *
+ * effect(() => {
+ *   // Only re-runs when 'important' membership changes
+ *   console.log('Is important:', tags.has('important'))
+ * })
+ *
+ * tags.add('todo') // Doesn't trigger above effect
+ * tags.add('important') // Triggers effect
+ * ```
+ */
+export declare class ReactiveSet<T> extends Set<T> {
+    #private;
+    constructor(values?: Iterable<T> | null);
+    get size(): number;
+    has(item: T): boolean;
+    add(item: T): this;
+    delete(item: T): boolean;
+    clear(): void;
+    keys(): SetIterator<T>;
+    values(): SetIterator<T>;
+    entries(): SetIterator<[T, T]>;
+    forEach(callbackfn: (value: T, value2: T, set: Set<T>) => void, thisArg?: unknown): void;
+    [Symbol.iterator](): SetIterator<T>;
+}
+//# sourceMappingURL=set.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/collections/set.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,CAAC;;gBAU5B,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IA4BvC,IAAI,IAAI,IAAI,MAAM,CAGjB;IAMD,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IA0BrB,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAmBlB,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IAuBxB,KAAK,IAAI,IAAI;IAmBb,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC;IAKtB,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC;IAKxB,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAK9B,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAKxF,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC;CAGpC"}

package/dist/core/constants.d.ts

@@ -0,0 +1,47 @@
+/** Signal is a derived value (computed) */
+export declare const DERIVED: number;
+/** Signal is an effect */
+export declare const EFFECT: number;
+/** Effect is a render effect ($effect.pre) - runs before DOM updates */
+export declare const RENDER_EFFECT: number;
+/** Effect is a root effect (created via effect.root()) */
+export declare const ROOT_EFFECT: number;
+/** Effect is a branch effect (if/each blocks) */
+export declare const BRANCH_EFFECT: number;
+/** Effect is a user effect ($effect) */
+export declare const USER_EFFECT: number;
+/** Effect is a block effect */
+export declare const BLOCK_EFFECT: number;
+/** Signal/reaction is clean (up-to-date) */
+export declare const CLEAN: number;
+/** Signal/reaction is dirty (definitely needs update) */
+export declare const DIRTY: number;
+/** Signal/reaction might be dirty (needs to check dependencies) */
+export declare const MAYBE_DIRTY: number;
+/** Reaction is currently being updated */
+export declare const REACTION_IS_UPDATING: number;
+/** Effect has been destroyed */
+export declare const DESTROYED: number;
+/** Effect is inert (paused) */
+export declare const INERT: number;
+/** Effect has run at least once */
+export declare const EFFECT_RAN: number;
+/** Effect is preserved (not destroyed with parent) */
+export declare const EFFECT_PRESERVED: number;
+/** Derived has no owner (created outside effect) */
+export declare const UNOWNED: number;
+/** Derived is disconnected (no reactions, can be GC'd) */
+export declare const DISCONNECTED: number;
+/** Effect is an inspect effect (for $inspect) */
+export declare const INSPECT_EFFECT: number;
+/** Sentinel for uninitialized values (deleted properties, new deriveds) */
+export declare const UNINITIALIZED: unique symbol;
+/** Sentinel for stale reactions (aborted async work) */
+export declare const STALE_REACTION: unique symbol;
+/** Symbol to identify reactive proxies */
+export declare const STATE_SYMBOL: unique symbol;
+/** Symbol to mark reactive proxies */
+export declare const REACTIVE_MARKER: unique symbol;
+/** Mask to clear all status bits (CLEAN, DIRTY, MAYBE_DIRTY) */
+export declare const STATUS_MASK: number;
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AASA,2CAA2C;AAC3C,eAAO,MAAM,OAAO,QAAS,CAAA;AAE7B,0BAA0B;AAC1B,eAAO,MAAM,MAAM,QAAS,CAAA;AAE5B,wEAAwE;AACxE,eAAO,MAAM,aAAa,QAAS,CAAA;AAEnC,0DAA0D;AAC1D,eAAO,MAAM,WAAW,QAAS,CAAA;AAEjC,iDAAiD;AACjD,eAAO,MAAM,aAAa,QAAS,CAAA;AAEnC,wCAAwC;AACxC,eAAO,MAAM,WAAW,QAAS,CAAA;AAEjC,+BAA+B;AAC/B,eAAO,MAAM,YAAY,QAAS,CAAA;AAMlC,4CAA4C;AAC5C,eAAO,MAAM,KAAK,QAAU,CAAA;AAE5B,yDAAyD;AACzD,eAAO,MAAM,KAAK,QAAU,CAAA;AAE5B,mEAAmE;AACnE,eAAO,MAAM,WAAW,QAAU,CAAA;AAElC,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,QAAU,CAAA;AAE3C,gCAAgC;AAChC,eAAO,MAAM,SAAS,QAAU,CAAA;AAEhC,+BAA+B;AAC/B,eAAO,MAAM,KAAK,QAAU,CAAA;AAE5B,mCAAmC;AACnC,eAAO,MAAM,UAAU,QAAU,CAAA;AAEjC,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,QAAU,CAAA;AAMvC,oDAAoD;AACpD,eAAO,MAAM,OAAO,QAAS,CAAA;AAE7B,0DAA0D;AAC1D,eAAO,MAAM,YAAY,QAAS,CAAA;AAMlC,iDAAiD;AACjD,eAAO,MAAM,cAAc,QAAU,CAAA;AAMrC,2EAA2E;AAC3E,eAAO,MAAM,aAAa,EAAE,OAAO,MAAkD,CAAA;AAErF,wDAAwD;AACxD,eAAO,MAAM,cAAc,EAAE,OAAO,MAAmD,CAAA;AAEvF,0CAA0C;AAC1C,eAAO,MAAM,YAAY,EAAE,OAAO,MAA0C,CAAA;AAE5E,sCAAsC;AACtC,eAAO,MAAM,eAAe,EAAE,OAAO,MAA6C,CAAA;AAMlF,gEAAgE;AAChE,eAAO,MAAM,WAAW,QAAiC,CAAA"}

package/dist/core/globals.d.ts

@@ -0,0 +1,45 @@
+import type { Reaction, Effect, Source } from './types.js';
+/** Currently executing reaction (effect or derived) */
+export declare let activeReaction: Reaction | null;
+/** Currently executing effect */
+export declare let activeEffect: Effect | null;
+/** Whether we're currently untracking (reading without creating dependencies) */
+export declare let untracking: boolean;
+/** Global write version - incremented on every signal write */
+export declare let writeVersion: number;
+/** Global read version - incremented on every reaction run */
+export declare let readVersion: number;
+/** New dependencies collected during current reaction execution */
+export declare let newDeps: Source[] | null;
+/** Number of existing dependencies that matched (optimization) */
+export declare let skippedDeps: number;
+/** Signals written to during current reaction (for self-invalidation) */
+export declare let untrackedWrites: Source[] | null;
+/** Current batch depth (for nested batches) */
+export declare let batchDepth: number;
+/** Pending reactions to run after batch completes */
+export declare let pendingReactions: Set<Reaction>;
+/** Queued root effects to process */
+export declare let queuedRootEffects: Effect[];
+/** Whether we're currently flushing synchronously */
+export declare let isFlushingSync: boolean;
+export declare function setActiveReaction(reaction: Reaction | null): Reaction | null;
+export declare function setActiveEffect(effect: Effect | null): Effect | null;
+export declare function setUntracking(value: boolean): boolean;
+export declare function incrementWriteVersion(): number;
+export declare function incrementReadVersion(): number;
+export declare function setNewDeps(deps: Source[] | null): Source[] | null;
+export declare function setSkippedDeps(count: number): number;
+export declare function setUntrackedWrites(writes: Source[] | null): Source[] | null;
+export declare function addUntrackedWrite(signal: Source): void;
+export declare function incrementBatchDepth(): number;
+export declare function decrementBatchDepth(): number;
+export declare function setIsFlushingSync(value: boolean): boolean;
+export declare function clearPendingReactions(): void;
+export declare function addPendingReaction(reaction: Reaction): void;
+export declare function clearQueuedRootEffects(): Effect[];
+export declare function addQueuedRootEffect(effect: Effect): void;
+export declare function getReadVersion(): number;
+export declare function getWriteVersion(): number;
+export declare function getBatchDepth(): number;
+//# sourceMappingURL=globals.d.ts.map

package/dist/core/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../src/core/globals.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAM1D,uDAAuD;AACvD,eAAO,IAAI,cAAc,EAAE,QAAQ,GAAG,IAAW,CAAA;AAEjD,iCAAiC;AACjC,eAAO,IAAI,YAAY,EAAE,MAAM,GAAG,IAAW,CAAA;AAE7C,iFAAiF;AACjF,eAAO,IAAI,UAAU,SAAQ,CAAA;AAM7B,+DAA+D;AAC/D,eAAO,IAAI,YAAY,QAAI,CAAA;AAE3B,8DAA8D;AAC9D,eAAO,IAAI,WAAW,QAAI,CAAA;AAM1B,mEAAmE;AACnE,eAAO,IAAI,OAAO,EAAE,MAAM,EAAE,GAAG,IAAW,CAAA;AAE1C,kEAAkE;AAClE,eAAO,IAAI,WAAW,QAAI,CAAA;AAE1B,yEAAyE;AACzE,eAAO,IAAI,eAAe,EAAE,MAAM,EAAE,GAAG,IAAW,CAAA;AAMlD,+CAA+C;AAC/C,eAAO,IAAI,UAAU,QAAI,CAAA;AAEzB,qDAAqD;AACrD,eAAO,IAAI,gBAAgB,EAAE,GAAG,CAAC,QAAQ,CAAa,CAAA;AAEtD,qCAAqC;AACrC,eAAO,IAAI,iBAAiB,EAAE,MAAM,EAAO,CAAA;AAE3C,qDAAqD;AACrD,eAAO,IAAI,cAAc,SAAQ,CAAA;AAMjC,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAI5E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAIpE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIrD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,IAAI,CAIjE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,IAAI,CAI3E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAMtD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIzD;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAE3D;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAIjD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAExD;AAMD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/core/types.d.ts

@@ -0,0 +1,76 @@
+import type { UNINITIALIZED } from './constants.js';
+/** Equality function for comparing signal values */
+export type Equals<T = any> = (oldValue: any, newValue: any) => boolean;
+/** Base interface for all reactive values */
+export interface Signal {
+    /** Flags bitmask for state tracking */
+    f: number;
+    /** Write version - incremented when signal is written */
+    wv: number;
+}
+/** A reactive source (basic signal) */
+export interface Source<T = unknown> extends Signal {
+    /** Current value */
+    v: T;
+    /** Equality function for comparing values */
+    equals: Equals<T>;
+    /** Reactions (effects/deriveds) that depend on this source */
+    reactions: Reaction[] | null;
+    /** Read version - for dependency deduplication */
+    rv: number;
+}
+/** Base interface for reactions (effects and deriveds) */
+export interface Reaction extends Signal {
+    /** The function to execute */
+    fn: Function | null;
+    /** Dependencies (sources/deriveds this reaction reads) */
+    deps: Source[] | null;
+}
+/** A derived (computed) value */
+export interface Derived<T = unknown> extends Source<T>, Reaction {
+    /** Computation function */
+    fn: () => T;
+    /** Child effects created inside this derived */
+    effects: Effect[] | null;
+    /** Parent effect or derived */
+    parent: Effect | Derived | null;
+}
+/** Cleanup function returned by effects */
+export type CleanupFn = () => void;
+/** Effect function signature */
+export type EffectFn = () => void | CleanupFn;
+/** An effect (side effect) */
+export interface Effect extends Reaction {
+    /** Effect function */
+    fn: EffectFn | null;
+    /** Teardown/cleanup function from last run */
+    teardown: CleanupFn | null;
+    /** Parent effect in the effect tree */
+    parent: Effect | null;
+    /** First child effect */
+    first: Effect | null;
+    /** Last child effect */
+    last: Effect | null;
+    /** Previous sibling effect */
+    prev: Effect | null;
+    /** Next sibling effect */
+    next: Effect | null;
+}
+/** A value that can be read (source or derived) */
+export type Value<T = unknown> = Source<T> | Derived<T>;
+/** Read-only signal interface (public API) */
+export interface ReadableSignal<T> {
+    readonly value: T;
+}
+/** Writable signal interface (public API) */
+export interface WritableSignal<T> extends ReadableSignal<T> {
+    value: T;
+}
+/** Derived signal interface (public API) */
+export interface DerivedSignal<T> extends ReadableSignal<T> {
+}
+/** Dispose function for effects */
+export type DisposeFn = () => void;
+/** Type for uninitialized values */
+export type Uninitialized = typeof UNINITIALIZED;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAMnD,oDAAoD;AAGpD,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAA;AAMvE,6CAA6C;AAC7C,MAAM,WAAW,MAAM;IACrB,uCAAuC;IACvC,CAAC,EAAE,MAAM,CAAA;IAET,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAA;CACX;AAMD,uCAAuC;AACvC,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,MAAM;IACjD,oBAAoB;IACpB,CAAC,EAAE,CAAC,CAAA;IAEJ,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAEjB,8DAA8D;IAC9D,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAA;IAE5B,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAA;CACX;AAMD,0DAA0D;AAC1D,MAAM,WAAW,QAAS,SAAQ,MAAM;IACtC,8BAA8B;IAC9B,EAAE,EAAE,QAAQ,GAAG,IAAI,CAAA;IAEnB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;CACtB;AAMD,iCAAiC;AACjC,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ;IAC/D,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC,CAAA;IAEX,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAExB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;CAChC;AAMD,2CAA2C;AAC3C,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,CAAA;AAElC,gCAAgC;AAChC,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,GAAG,SAAS,CAAA;AAE7C,8BAA8B;AAC9B,MAAM,WAAW,MAAO,SAAQ,QAAQ;IACtC,sBAAsB;IACtB,EAAE,EAAE,QAAQ,GAAG,IAAI,CAAA;IAEnB,8CAA8C;IAC9C,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAA;IAE1B,uCAAuC;IACvC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAErB,yBAAyB;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpB,wBAAwB;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAMD,mDAAmD;AACnD,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAMvD,8CAA8C;AAC9C,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAA;CACT;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;CAAG;AAE9D,mCAAmC;AACnC,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,CAAA;AAMlC,oCAAoC;AACpC,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAA"}

package/dist/deep/proxy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Create a deeply reactive proxy for an object or array
+ *
+ * Key features:
+ * 1. Per-property signals (lazy creation)
+ * 2. Version signal for structural changes (add/delete)
+ * 3. Recursive proxying of nested objects
+ * 4. Fine-grained reactivity at every level
+ */
+export declare function proxy<T extends object>(value: T): T;
+/**
+ * Get the raw (non-reactive) value from a proxy
+ */
+export declare function toRaw<T>(value: T): T;
+/**
+ * Check if a value is a reactive proxy
+ */
+export declare function isReactive(value: unknown): boolean;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/deep/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/deep/proxy.ts"],"names":[],"mappings":"AAoDA;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CA2PnD;AAMD;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAKpC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAElD"}

package/dist/index.d.ts

@@ -1,278 +1,15 @@
-/** Cleanup function returned by effects */
-export type CleanupFn = () => void;
-/** Effect function that may return a cleanup */
-export type EffectFn = () => void | CleanupFn;
-/** Equality function for comparing values */
-export type EqualityFn<T> = (a: T, b: T) => boolean;
-/** A reactive signal that holds a value */
-export interface Signal<T> {
-    readonly value: T;
-}
-/** A writable reactive signal */
-export interface WritableSignal<T> extends Signal<T> {
-    value: T;
-}
-/** A derived/computed signal (read-only) */
-export interface Derived<T> extends Signal<T> {
-    readonly value: T;
-}
-/** Options for creating a signal */
-export interface SignalOptions<T> {
-    equals?: EqualityFn<T>;
-}
-/** Default equality check using Object.is */
-export declare const defaultEquals: <T>(a: T, b: T) => boolean;
-/** Shallow equality for objects/arrays */
-export declare const shallowEquals: <T>(a: T, b: T) => boolean;
-/**
- * Create a reactive signal
- *
- * For objects and arrays, the signal is deeply reactive - mutations at any
- * depth will trigger effects.
- *
- * @example
- * ```ts
- * const count = signal(0)
- * console.log(count.value) // 0
- * count.value = 1
- * console.log(count.value) // 1
- *
- * // Deep reactivity for objects/arrays
- * const user = signal({ name: 'John', address: { city: 'NYC' } })
- * user.value.address.city = 'LA' // Triggers effects!
- *
- * const items = signal([[1, 2], [3, 4]])
- * items.value[0][1] = 99 // Triggers effects!
- * ```
- */
-export declare function signal<T>(initial: T, options?: SignalOptions<T>): WritableSignal<T>;
-/**
- * Create a reactive effect that re-runs when dependencies change
- *
- * @returns Dispose function to stop the effect
- *
- * @example
- * ```ts
- * const count = signal(0)
- * const dispose = effect(() => {
- *   console.log('Count:', count.value)
- * })
- * // Logs: "Count: 0"
- *
- * count.value = 1
- * // Logs: "Count: 1"
- *
- * dispose() // Stop the effect
- * ```
- */
-export declare function effect(fn: EffectFn): CleanupFn;
-/**
- * Create a derived/computed value that automatically updates
- *
- * @example
- * ```ts
- * const count = signal(0)
- * const doubled = derived(() => count.value * 2)
- * console.log(doubled.value) // 0
- *
- * count.value = 5
- * console.log(doubled.value) // 10
- * ```
- */
-export declare function derived<T>(fn: () => T, options?: SignalOptions<T>): Derived<T>;
-export declare namespace derived {
-    var by: typeof derived;
-}
-/**
- * Batch multiple updates into a single reaction cycle
- *
- * @example
- * ```ts
- * const a = signal(1)
- * const b = signal(2)
- *
- * effect(() => console.log(a.value + b.value))
- * // Logs: 3
- *
- * batch(() => {
- *   a.value = 10
- *   b.value = 20
- * })
- * // Logs: 30 (only once, not twice)
- * ```
- */
-export declare function batch<T>(fn: () => T): T;
-/**
- * Read signals without creating dependencies
- *
- * @example
- * ```ts
- * const a = signal(1)
- * const b = signal(2)
- *
- * effect(() => {
- *   console.log(a.value) // Creates dependency
- *   untrack(() => {
- *     console.log(b.value) // Does NOT create dependency
- *   })
- * })
- * ```
- */
-export declare function untrack<T>(fn: () => T): T;
-/**
- * Create a deeply reactive state object
- * All nested properties are automatically reactive
- *
- * @example
- * ```ts
- * const user = state({
- *   name: 'John',
- *   address: {
- *     city: 'NYC'
- *   }
- * })
- *
- * effect(() => {
- *   console.log(user.address.city)
- * })
- * // Logs: "NYC"
- *
- * user.address.city = 'LA'
- * // Logs: "LA"
- * ```
- */
-export declare function state<T extends object>(initial: T): T;
-/**
- * Get the raw (non-reactive) version of a reactive object
- */
-export declare function toRaw<T>(proxy: T): T;
-/**
- * Check if a value is a reactive proxy
- */
-export declare function isReactive(value: unknown): boolean;
-/**
- * A reactive Map that triggers updates on modifications
- *
- * @example
- * ```ts
- * const map = new ReactiveMap<string, number>()
- *
- * effect(() => {
- *   console.log('Size:', map.size)
- *   console.log('Has foo:', map.has('foo'))
- * })
- *
- * map.set('foo', 42) // Triggers effect
- * ```
- */
-export declare class ReactiveMap<K, V> extends Map<K, V> {
-    #private;
-    constructor(entries?: Iterable<readonly [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(callbackfn: (value: V, key: K, map: Map<K, V>) => void, thisArg?: any): void;
-    keys(): MapIterator<K>;
-    values(): MapIterator<V>;
-    entries(): MapIterator<[K, V]>;
-    [Symbol.iterator](): MapIterator<[K, V]>;
-}
-/**
- * A reactive Set that triggers updates on modifications
- *
- * @example
- * ```ts
- * const set = new ReactiveSet<string>()
- *
- * effect(() => {
- *   console.log('Size:', set.size)
- *   console.log('Has foo:', set.has('foo'))
- * })
- *
- * set.add('foo') // Triggers effect
- * ```
- */
-export declare class ReactiveSet<T> extends Set<T> {
-    #private;
-    constructor(values?: Iterable<T> | null);
-    get size(): number;
-    has(value: T): boolean;
-    add(value: T): this;
-    delete(value: T): boolean;
-    clear(): void;
-    forEach(callbackfn: (value: T, value2: T, set: Set<T>) => void, thisArg?: any): void;
-    keys(): SetIterator<T>;
-    values(): SetIterator<T>;
-    entries(): SetIterator<[T, T]>;
-    [Symbol.iterator](): SetIterator<T>;
-}
-/**
- * Create a reactive array with fine-grained reactivity
- *
- * @example
- * ```ts
- * const items = reactiveArray([1, 2, 3])
- *
- * effect(() => {
- *   console.log('Length:', items.length)
- *   console.log('First:', items[0])
- * })
- *
- * items.push(4)    // Triggers effect
- * items[0] = 10    // Triggers effect
- * ```
- */
-export declare function reactiveArray<T>(initial?: T[]): T[];
-/**
- * Create an effect scope for grouping and disposing multiple effects
- *
- * @example
- * ```ts
- * const scope = effectScope()
- *
- * scope.run(() => {
- *   effect(() => console.log('Effect 1'))
- *   effect(() => console.log('Effect 2'))
- * })
- *
- * scope.stop() // Disposes all effects in the scope
- * ```
- */
-export declare function effectScope(): {
-    run<T>(fn: () => T): T | undefined;
-    stop(): void;
-    readonly active: boolean;
-};
-/**
- * Watch a signal or derived and call callback when it changes
- * Like effect but only runs the callback, not for initial subscription
- *
- * @example
- * ```ts
- * const count = signal(0)
- *
- * watch(
- *   () => count.value,
- *   (newValue, oldValue) => {
- *     console.log(`Changed from ${oldValue} to ${newValue}`)
- *   }
- * )
- *
- * count.value = 1 // Logs: "Changed from 0 to 1"
- * ```
- */
-export declare function watch<T>(source: () => T, callback: (newValue: T, oldValue: T | undefined) => void | CleanupFn, options?: {
-    immediate?: boolean;
-}): CleanupFn;
-/**
- * Create a readonly signal from a writable signal
- */
-export declare function readonly<T>(sig: WritableSignal<T>): Signal<T>;
-/**
- * Compute a value once without reactivity
- */
-export declare function peek<T>(fn: () => T): T;
+export { signal, source, mutableSource, state, stateRaw } from './primitives/signal.js';
+export { derived, createDerived, disconnectDerived } from './primitives/derived.js';
+export { effect, createEffect, updateEffect, destroyEffect } from './primitives/effect.js';
+export { proxy, toRaw, isReactive } from './deep/proxy.js';
+export { batch, untrack, peek } from './reactivity/batching.js';
+export { flushSync, tick } from './reactivity/scheduling.js';
+export { equals, safeEquals, safeNotEqual, shallowEquals, createEquals, neverEquals, alwaysEquals, } from './reactivity/equality.js';
+export { ReactiveMap } from './collections/map.js';
+export { ReactiveSet } from './collections/set.js';
+export { ReactiveDate } from './collections/date.js';
+export { get, set, isDirty, setSignalStatus, markReactions, updateReaction, removeReactions, } from './reactivity/tracking.js';
+export { DERIVED, EFFECT, RENDER_EFFECT, ROOT_EFFECT, BRANCH_EFFECT, USER_EFFECT, BLOCK_EFFECT, CLEAN, DIRTY, MAYBE_DIRTY, REACTION_IS_UPDATING, DESTROYED, INERT, EFFECT_RAN, EFFECT_PRESERVED, UNOWNED, DISCONNECTED, UNINITIALIZED, STALE_REACTION, STATE_SYMBOL, REACTIVE_MARKER, } from './core/constants.js';
+export { activeReaction, activeEffect, untracking, writeVersion, readVersion, batchDepth, setActiveReaction, setActiveEffect, setUntracking, incrementWriteVersion, incrementReadVersion, incrementBatchDepth, decrementBatchDepth, getReadVersion, getWriteVersion, getBatchDepth, } from './core/globals.js';
+export type { Signal, Source, Reaction, Derived, Effect, Value, ReadableSignal, WritableSignal, DerivedSignal, DisposeFn, CleanupFn, EffectFn, Equals, Uninitialized, } from './core/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACvF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AACnF,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAM1F,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAM1D,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAA;AAM5D,OAAO,EACL,MAAM,EACN,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,0BAA0B,CAAA;AAMjC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAMpD,OAAO,EACL,GAAG,EACH,GAAG,EACH,OAAO,EACP,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,0BAA0B,CAAA;AAMjC,OAAO,EAEL,OAAO,EACP,MAAM,EACN,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EAGZ,KAAK,EACL,KAAK,EACL,WAAW,EACX,oBAAoB,EACpB,SAAS,EACT,KAAK,EACL,UAAU,EACV,gBAAgB,EAGhB,OAAO,EACP,YAAY,EAGZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAM5B,OAAO,EACL,cAAc,EACd,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EAGV,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EAGnB,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,mBAAmB,CAAA;AAM1B,YAAY,EAEV,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,KAAK,EAGL,cAAc,EACd,cAAc,EACd,aAAa,EACb,SAAS,EACT,SAAS,EACT,QAAQ,EAGR,MAAM,EACN,aAAa,GACd,MAAM,iBAAiB,CAAA"}