@rlabs-inc/signals 1.2.1 → 1.4.0

package/dist/v2/primitives.d.ts

@@ -0,0 +1,120 @@
+import { defaultEquals, type EqualsFn } from './registry.js';
+export interface Signal<T> {
+    value: T;
+}
+export interface ReadonlySignal<T> {
+    readonly value: T;
+}
+export interface SignalOptions<T> {
+    equals?: EqualsFn;
+}
+/**
+ * Create a reactive signal.
+ *
+ * For primitives: creates a simple reactive value
+ * For objects/arrays: creates a deep reactive proxy with fine-grained tracking
+ *
+ * @example
+ * ```ts
+ * // Primitive
+ * const count = signal(0)
+ * count.value++
+ *
+ * // Object (automatically deep reactive)
+ * const user = signal({ name: 'Rusty', age: 43 })
+ * user.value.age = 44  // Fine-grained update
+ *
+ * // Array
+ * const items = signal([1, 2, 3])
+ * items.value.push(4)  // Tracked
+ * items.value[0] = 10  // Fine-grained
+ * ```
+ */
+export declare function signal<T>(initial: T, options?: SignalOptions<T>): Signal<T>;
+export { signal as state };
+/**
+ * Create a derived (computed) signal.
+ *
+ * Deriveds are lazy - they only compute when read.
+ * They cache their value and recompute when dependencies change.
+ *
+ * @example
+ * ```ts
+ * const count = signal(1)
+ * const doubled = derived(() => count.value * 2)
+ *
+ * console.log(doubled.value)  // 2
+ * count.value = 5
+ * console.log(doubled.value)  // 10
+ * ```
+ */
+export declare function derived<T>(fn: () => T, options?: SignalOptions<T>): ReadonlySignal<T>;
+export declare namespace derived {
+    var by: typeof derived;
+}
+export interface EffectOptions {
+    /** Run synchronously instead of scheduling */
+    sync?: boolean;
+}
+/**
+ * Create a reactive effect.
+ *
+ * Effects run whenever their dependencies change.
+ * Return a cleanup function to run before re-execution.
+ *
+ * @example
+ * ```ts
+ * const count = signal(0)
+ *
+ * const dispose = effect(() => {
+ *   console.log('Count is', count.value)
+ *   return () => console.log('Cleanup')
+ * })
+ *
+ * count.value = 1  // Logs: "Cleanup", then "Count is 1"
+ * dispose()        // Stops the effect
+ * ```
+ */
+export declare function effect(fn: () => void | (() => void), options?: EffectOptions): () => void;
+export declare namespace effect {
+    var pre: (fn: () => void | (() => void)) => () => void;
+    var root: (fn: () => void | (() => void)) => () => void;
+}
+/**
+ * Batch multiple updates into a single flush.
+ *
+ * @example
+ * ```ts
+ * batch(() => {
+ *   count.value++
+ *   name.value = 'new'
+ *   // Effects only run once after batch completes
+ * })
+ * ```
+ */
+export declare function batch<T>(fn: () => T): T;
+/**
+ * Read values without creating dependencies.
+ *
+ * @example
+ * ```ts
+ * effect(() => {
+ *   // This creates a dependency
+ *   const a = count.value
+ *
+ *   // This does NOT create a dependency
+ *   const b = untrack(() => other.value)
+ * })
+ * ```
+ */
+export declare function untrack<T>(fn: () => T): T;
+/**
+ * Synchronously flush all pending effects.
+ */
+export declare function flushSync(): void;
+export { defaultEquals };
+/** Never equal - always triggers updates */
+export declare function neverEquals(): boolean;
+/** Shallow equality for objects/arrays */
+export declare function shallowEquals(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=primitives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/v2/primitives.ts"],"names":[],"mappings":"AAKA,OAAO,EAeL,aAAa,EACb,KAAK,QAAQ,EACd,MAAM,eAAe,CAAA;AA0BtB,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAA;CACT;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAClB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,QAAQ,CAAA;CAClB;AAUD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CA4C3E;AAGD,OAAO,EAAE,MAAM,IAAI,KAAK,EAAE,CAAA;AAM1B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAarF;yBAbe,OAAO;;;AAsBvB,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,IAAI,CAezF;yBAfe,MAAM;kBAqBc,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,KAAG,MAAM,IAAI;mBAQpC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,KAAG,MAAM,IAAI;;AAU5E;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAOvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEzC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAMD,OAAO,EAAE,aAAa,EAAE,CAAA;AAExB,4CAA4C;AAC5C,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAiB7D"}

package/dist/v2/proxy.d.ts

@@ -0,0 +1,10 @@
+export declare const TARGET_SYMBOL: unique symbol;
+export declare const PROXY_SYMBOL: unique symbol;
+export declare function isProxied(value: unknown): boolean;
+export declare function createProxy<T extends object>(target: T): T;
+/**
+ * Get the raw target object from a proxy.
+ * Useful when you need the original object without reactivity.
+ */
+export declare function toRaw<T>(value: T): T;
+//# sourceMappingURL=proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/v2/proxy.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,aAAa,eAA4B,CAAA;AACtD,eAAO,MAAM,YAAY,eAA2B,CAAA;AAgBpD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEjD;AA6BD,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAoK1D;AAmGD;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAKpC"}

package/dist/v2/registry.d.ts

@@ -0,0 +1,35 @@
+export declare const enum NodeType {
+    SOURCE = 0,
+    DERIVED = 1,
+    EFFECT = 2
+}
+export declare const enum Flags {
+    CLEAN = 0,
+    MAYBE_DIRTY = 1,
+    DIRTY = 2,
+    RUNNING = 4,
+    NOTIFIED = 8,
+    DEAD = 16
+}
+export type EqualsFn = (a: unknown, b: unknown) => boolean;
+export declare function allocateId(): number;
+export declare function releaseId(id: number): void;
+export declare function defaultEquals(a: unknown, b: unknown): boolean;
+export declare function createSource(value: unknown, equals?: EqualsFn): number;
+export declare function createDerived(fn: () => unknown, equals?: EqualsFn): number;
+export declare function createEffect(fn: () => void | (() => void), parentId?: number): number;
+export declare function getActiveEffect(): number;
+export declare function getActiveReaction(): number;
+export declare function isCurrentlyTracking(): boolean;
+export declare function getValue(id: number): unknown;
+export declare function setValue(id: number, value: unknown): void;
+export declare function runEffect(id: number): void;
+export declare function destroyNode(id: number): void;
+export declare function scheduleEffectRun(id: number): void;
+export declare function flushSync(): void;
+export declare function startBatch(): void;
+export declare function endBatch(): void;
+export declare function untrack<T>(fn: () => T): T;
+export declare function getNodeInfo(id: number): object;
+export declare function getStats(): object;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/v2/registry.ts"],"names":[],"mappings":"AASA,0BAAkB,QAAQ;IACxB,MAAM,IAAI;IACV,OAAO,IAAI;IACX,MAAM,IAAI;CACX;AAED,0BAAkB,KAAK;IACrB,KAAK,IAAI;IACT,WAAW,IAAI;IACf,KAAK,IAAI;IACT,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,IAAI,KAAK;CACV;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,KAAK,OAAO,CAAA;AA0F1D,wBAAgB,UAAU,IAAI,MAAM,CAOnC;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAgC1C;AAMD,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAE7D;AAMD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,QAAwB,GAAG,MAAM,CAiBrF;AAMD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,OAAO,EAAE,MAAM,GAAE,QAAwB,GAAG,MAAM,CAqBzF;AA4CD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,QAAQ,GAAE,MAAqB,GAAG,MAAM,CAuBnG;AA4DD,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAMD,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAY5C;AAqBD,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAYzD;AA6KD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CA2C1C;AAaD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAiC5C;AA2ED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAQlD;AA4BD,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAMD,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,wBAAgB,QAAQ,IAAI,IAAI,CAM/B;AAMD,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQzC;AAMD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAW9C;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAOjC"}

package/dist/v2/stress.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @rlabs-inc/signals v2 - STRESS TEST
+ *
+ * Testing the parallel arrays architecture
+ */
+export {};
+//# sourceMappingURL=stress.d.ts.map

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

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

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

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

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

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

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rlabs-inc/signals",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "Production-grade fine-grained reactivity for TypeScript. A complete standalone mirror of Svelte 5's reactivity system - signals, effects, derived values, deep reactivity, reactive collections, and reactive bindings.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -40,7 +40,13 @@
     "bind",
     "binding",
     "two-way-binding",
+    "linkedSignal",
+    "createSelector",
+    "effectScope",
     "svelte",
+    "angular",
+    "solid",
+    "vue",
     "typescript"
   ],
   "author": "RLabs Inc.",