signalium 0.2.7 → 0.3.0

package/dist/esm/signals.d.ts

@@ -1,31 +1,11 @@
+import { VisualizerNodeType } from './trace.js';
+import { AsyncResult, AsyncSignal, AsyncTask, Signal, SignalAsyncCompute, SignalCompute, SignalEquals, SignalOptions, SignalOptionsWithInit, SignalSubscribe, Watcher, WatcherListenerOptions } from './types.js';
 declare const enum SignalType {
     Computed = 0,
     Subscription = 1,
     Async = 2,
     Watcher = 3
 }
-export interface Signal<T = unknown> {
-    get(): T;
-}
-export interface WriteableSignal<T> extends Signal<T> {
-    set(value: T): void;
-}
-export type AsyncSignal<T> = Signal<AsyncResult<T>>;
-export type SignalCompute<T> = (prev: T | undefined) => T;
-export type SignalAsyncCompute<T> = (prev: T | undefined) => T | Promise<T>;
-export type SignalWatcherEffect = () => void;
-export type SignalEquals<T> = (prev: T, next: T) => boolean;
-export type SignalSubscription = {
-    update?(): void;
-    unsubscribe?(): void;
-};
-export type SignalSubscribe<T> = (get: () => T, set: (value: T) => void) => SignalSubscription | undefined | void;
-export interface SignalOptions<T> {
-    equals?: SignalEquals<T>;
-}
-export interface SignalOptionsWithInit<T> extends SignalOptions<T> {
-    initValue: T;
-}
 declare const enum SignalState {
     Clean = 0,
     MaybeDirty = 1,
@@ -39,8 +19,13 @@ interface Link {
     consumedAt: number;
     nextDirty: Link | undefined;
 }
+export declare function signalTypeToVisualizerType(type: SignalType): VisualizerNodeType;
+interface InternalSignalOptions<T> extends SignalOptions<T, unknown[]> {
+    equals: SignalEquals<T>;
+    id: string;
+    subscribers?: ((value: T) => void)[];
+}
 export declare class ComputedSignal<T> {
-    _id: number;
     _type: SignalType;
     _deps: Map<ComputedSignal<any>, Link>;
     _dirtyDep: Link | undefined;
@@ -50,60 +35,38 @@ export declare class ComputedSignal<T> {
     _computedCount: number;
     _connectedCount: number;
     _currentValue: T | AsyncResult<T> | undefined;
-    _compute: SignalCompute<T> | SignalAsyncCompute<T> | SignalSubscribe<T> | undefined;
-    _equals: SignalEquals<T>;
+    _compute: SignalCompute<T> | SignalAsyncCompute<T> | SignalSubscribe<T>;
+    _opts: InternalSignalOptions<T>;
     _ref: WeakRef<ComputedSignal<T>>;
-    constructor(type: SignalType, compute: SignalCompute<T> | SignalAsyncCompute<T> | SignalSubscribe<T> | undefined, equals?: SignalEquals<T>, initValue?: T);
+    constructor(type: SignalType, compute: SignalCompute<T> | SignalAsyncCompute<T> | SignalSubscribe<T>, opts: InternalSignalOptions<T>, initValue?: T);
     get(): T | AsyncResult<T>;
-    _check(shouldWatch?: boolean): number;
-    _run(wasConnected: boolean, shouldConnect: boolean): void;
+    _check(shouldWatch?: boolean, connectCount?: number, immediate?: boolean): number;
+    _run(wasConnected: boolean, shouldConnect: boolean, immediate?: boolean): void;
     _resetDirty(): void;
     _dirty(): void;
     _dirtyConsumers(): void;
     _disconnect(count?: number): void;
+    _runEffects(): void;
+    addListener(subscriber: (value: T) => void, opts?: WatcherListenerOptions): () => void;
 }
-export interface AsyncBaseResult<T> {
-    invalidate(): void;
-    await(): T;
-}
-export interface AsyncPending<T> extends AsyncBaseResult<T> {
-    result: undefined;
-    error: unknown;
-    isPending: boolean;
-    isReady: false;
-    isError: boolean;
-    isSuccess: boolean;
-    didResolve: boolean;
-}
-export interface AsyncReady<T> extends AsyncBaseResult<T> {
-    result: T;
-    error: unknown;
-    isPending: boolean;
-    isReady: true;
-    isError: boolean;
-    isSuccess: boolean;
-    didResolve: boolean;
-}
-export type AsyncResult<T> = AsyncPending<T> | AsyncReady<T>;
-declare class StateSignal<T> implements StateSignal<T> {
+export declare class StateSignal<T> implements StateSignal<T> {
     private _value;
     private _equals;
-    private _subs;
-    constructor(_value: T, _equals?: SignalEquals<T>);
+    _subs: WeakRef<ComputedSignal<unknown>>[];
+    _desc: string;
+    constructor(_value: T, _equals?: SignalEquals<T>, desc?: string);
     get(): T;
     set(value: T): void;
 }
-export declare function state<T>(initialValue: T, opts?: SignalOptions<T>): StateSignal<T>;
-export declare function computed<T>(compute: (prev: T | undefined) => T, opts?: SignalOptions<T>): Signal<T>;
-export declare function asyncComputed<T>(compute: (prev: T | undefined) => Promise<T>, opts?: SignalOptions<T>): AsyncSignal<T>;
-export declare function asyncComputed<T>(compute: (prev: T | undefined) => Promise<T>, opts: SignalOptionsWithInit<T>): AsyncSignal<T>;
-export declare function subscription<T>(subscribe: SignalSubscribe<T>, opts?: SignalOptions<T>): Signal<T | undefined>;
-export declare function subscription<T>(subscribe: SignalSubscribe<T>, opts: SignalOptionsWithInit<T>): Signal<T>;
-export interface Watcher {
-    disconnect(): void;
-    subscribe(subscriber: () => void): () => void;
-}
-export declare function watcher(fn: () => void): Watcher;
+export declare function createStateSignal<T>(initialValue: T, opts?: Omit<SignalOptions<T, unknown[]>, 'paramKey'>): StateSignal<T>;
+export declare function createComputedSignal<T>(compute: (prev: T | undefined) => T, opts?: SignalOptions<T, unknown[]>): Signal<T>;
+export declare function createAsyncComputedSignal<T>(compute: (prev: T | undefined) => Promise<T>, opts?: SignalOptions<T, unknown[]>): AsyncSignal<T>;
+export declare function createAsyncComputedSignal<T>(compute: (prev: T | undefined) => Promise<T>, opts: SignalOptionsWithInit<T, unknown[]>): AsyncSignal<T>;
+export declare function createSubscriptionSignal<T>(subscribe: SignalSubscribe<T>, opts?: SignalOptions<T, unknown[]>): Signal<T | undefined>;
+export declare function createSubscriptionSignal<T>(subscribe: SignalSubscribe<T>, opts: SignalOptionsWithInit<T, unknown[]>): Signal<T>;
+export declare function createAsyncTaskSignal<T, Args extends unknown[]>(fn: (...args: Args) => Promise<T>): Signal<AsyncTask<T, Args>>;
+export declare function createWatcherSignal<T>(fn: (prev: T | undefined) => T, opts?: SignalOptions<T, unknown[]>): Watcher<T>;
+export declare function getCurrentConsumer(): ComputedSignal<any> | undefined;
 export declare function isTracking(): boolean;
 export declare function untrack<T = void>(fn: () => T): T;
 export {};

package/dist/esm/signals.d.ts.map

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

package/dist/esm/signals.js

@@ -1,14 +1,26 @@
-import { scheduleDirty, scheduleDisconnect, schedulePull, scheduleWatcher } from './scheduling.js';
+import { scheduleConnect, scheduleDirty, scheduleDisconnect, scheduleEffect, schedulePull, scheduleWatcher, } from './scheduling.js';
 import WeakRef from './weakref.js';
+import { TRACER as TRACER, TracerEventType, VisualizerNodeType } from './trace.js';
 let CURRENT_ORD = 0;
 let CURRENT_CONSUMER;
 let CURRENT_IS_WAITING = false;
-let ID = 0;
 const SUBSCRIPTIONS = new WeakMap();
 const ACTIVE_ASYNCS = new WeakMap();
 const WAITING = Symbol();
+const FALSE_EQUALS = () => false;
+export function signalTypeToVisualizerType(type) {
+    switch (type) {
+        case 0 /* SignalType.Computed */:
+            return VisualizerNodeType.Computed;
+        case 1 /* SignalType.Subscription */:
+            return VisualizerNodeType.Subscription;
+        case 2 /* SignalType.Async */:
+            return VisualizerNodeType.AsyncComputed;
+        case 3 /* SignalType.Watcher */:
+            return VisualizerNodeType.Watcher;
+    }
+}
 export class ComputedSignal {
-    _id = ID++;
     _type;
     _deps = new Map();
     _dirtyDep = undefined;
@@ -19,13 +31,12 @@ export class ComputedSignal {
     _connectedCount = 0;
     _currentValue;
     _compute;
-    _equals;
+    _opts;
     _ref = new WeakRef(this);
-    constructor(type, compute, equals, initValue) {
+    constructor(type, compute, opts, initValue) {
         this._type = type;
         this._compute = compute;
-        this._equals = equals ?? ((a, b) => a === b);
-        this._connectedCount = type === 3 /* SignalType.Watcher */ ? 1 : 0;
+        this._opts = opts;
         this._currentValue =
             type !== 2 /* SignalType.Async */
                 ? initValue
@@ -45,6 +56,10 @@ export class ComputedSignal {
                         if (CURRENT_CONSUMER === undefined || CURRENT_CONSUMER._type !== 2 /* SignalType.Async */) {
                             throw new Error('Cannot await an async signal outside of an async signal. If you are using an async function, you must use signal.await() for all async signals _before_ the first language-level `await` keyword statement (e.g. it must be synchronous).');
                         }
+                        TRACER?.emit({
+                            type: TracerEventType.StartLoading,
+                            id: CURRENT_CONSUMER._opts.id,
+                        });
                         const value = this._currentValue;
                         if (value.isPending) {
                             const currentConsumer = CURRENT_CONSUMER;
@@ -63,6 +78,16 @@ export class ComputedSignal {
         if (CURRENT_CONSUMER !== undefined) {
             const { _deps: deps, _computedCount: computedCount, _connectedCount: connectedCount } = CURRENT_CONSUMER;
             const prevLink = deps.get(this);
+            if (prevLink === undefined) {
+                TRACER?.emit({
+                    type: TracerEventType.Connected,
+                    id: CURRENT_CONSUMER._opts.id,
+                    childId: this._opts.id,
+                    name: this._opts.desc,
+                    params: this._opts.params,
+                    nodeType: signalTypeToVisualizerType(this._type),
+                });
+            }
             const ord = CURRENT_ORD++;
             this._check(!prevLink && connectedCount > 0);
             if (prevLink === undefined) {
@@ -81,7 +106,6 @@ export class ComputedSignal {
                 prevLink.ord = ord;
                 prevLink.version = this._version;
                 prevLink.consumedAt = computedCount;
-                // prevLink.nextDirty = undefined;
                 this._subs.add(prevLink);
             }
         }
@@ -90,14 +114,13 @@ export class ComputedSignal {
         }
         return this._currentValue;
     }
-    _check(shouldWatch = false) {
-        // COUNTS.checks++;
+    _check(shouldWatch = false, connectCount = 1, immediate = false) {
         let state = this._state;
         let connectedCount = this._connectedCount;
         const wasConnected = connectedCount > 0;
         const shouldConnect = shouldWatch && !wasConnected;
         if (shouldWatch) {
-            this._connectedCount = connectedCount = connectedCount + 1;
+            this._connectedCount = connectedCount = connectedCount + connectCount;
         }
         if (shouldConnect) {
             if (this._type === 1 /* SignalType.Subscription */) {
@@ -127,7 +150,7 @@ export class ComputedSignal {
             }
         }
         if (state === 2 /* SignalState.Dirty */) {
-            this._run(wasConnected, shouldConnect);
+            this._run(wasConnected, shouldConnect, immediate);
         }
         else {
             this._resetDirty();
@@ -136,7 +159,11 @@ export class ComputedSignal {
         this._dirtyDep = undefined;
         return this._version;
     }
-    _run(wasConnected, shouldConnect) {
+    _run(wasConnected, shouldConnect, immediate = false) {
+        TRACER?.emit({
+            type: TracerEventType.StartUpdate,
+            id: this._opts.id,
+        });
         const { _type: type } = this;
         const prevConsumer = CURRENT_CONSUMER;
         try {
@@ -145,11 +172,12 @@ export class ComputedSignal {
             this._computedCount++;
             switch (type) {
                 case 0 /* SignalType.Computed */: {
+                    const version = this._version;
                     const prevValue = this._currentValue;
                     const nextValue = this._compute(prevValue);
-                    if (!this._equals(prevValue, nextValue)) {
+                    if (version === 0 || !this._opts.equals(prevValue, nextValue)) {
                         this._currentValue = nextValue;
-                        this._version++;
+                        this._version = version + 1;
                     }
                     break;
                 }
@@ -189,7 +217,12 @@ export class ComputedSignal {
                     }
                     else if (nextValue instanceof Promise) {
                         const currentVersion = ++this._version;
-                        nextValue = nextValue.then(result => {
+                        TRACER?.emit({
+                            type: TracerEventType.StartLoading,
+                            id: this._opts.id,
+                        });
+                        nextValue = nextValue
+                            .then(result => {
                             if (currentVersion !== this._version) {
                                 return;
                             }
@@ -209,6 +242,13 @@ export class ComputedSignal {
                             value.isError = true;
                             this._version++;
                             scheduleDirty(this);
+                        })
+                            .finally(() => {
+                            TRACER?.emit({
+                                type: TracerEventType.EndLoading,
+                                id: this._opts.id,
+                                value: value,
+                            });
                         });
                         ACTIVE_ASYNCS.set(this, nextValue);
                         value.isPending = true;
@@ -222,18 +262,34 @@ export class ComputedSignal {
                         value.isSuccess = true;
                         value.isError = false;
                         this._version++;
+                        TRACER?.emit({
+                            type: TracerEventType.EndLoading,
+                            id: this._opts.id,
+                            value: value,
+                        });
                     }
                     break;
                 }
                 case 1 /* SignalType.Subscription */: {
                     if (shouldConnect) {
                         const subscription = this._compute(() => this._currentValue, value => {
-                            if (this._equals(value, this._currentValue)) {
+                            const version = this._version;
+                            if (version !== 0 && this._opts.equals(value, this._currentValue)) {
                                 return;
                             }
+                            TRACER?.emit({
+                                type: TracerEventType.StartUpdate,
+                                id: this._opts.id,
+                            });
                             this._currentValue = value;
-                            this._version++;
+                            this._version = version + 1;
                             this._dirtyConsumers();
+                            TRACER?.emit({
+                                type: TracerEventType.EndUpdate,
+                                id: this._opts.id,
+                                value: this._currentValue,
+                                preserveChildren: true,
+                            });
                         });
                         SUBSCRIPTIONS.set(this, subscription);
                     }
@@ -244,30 +300,53 @@ export class ComputedSignal {
                     break;
                 }
                 default: {
-                    this._compute();
+                    const version = this._version;
+                    const prevValue = this._currentValue;
+                    const nextValue = this._compute(prevValue);
+                    if (version === 0 || !this._opts.equals(prevValue, nextValue)) {
+                        this._currentValue = nextValue;
+                        this._version = version + 1;
+                        if (immediate) {
+                            this._runEffects();
+                        }
+                        else {
+                            scheduleEffect(this);
+                        }
+                    }
+                    break;
                 }
             }
         }
         finally {
-            const deps = this._deps;
-            for (const link of deps.values()) {
-                if (link.consumedAt === this._computedCount)
-                    continue;
-                const dep = link.dep;
-                if (wasConnected) {
-                    scheduleDisconnect(dep);
+            TRACER?.emit({
+                type: TracerEventType.EndUpdate,
+                id: this._opts.id,
+                value: this._currentValue,
+            });
+            if (this._type !== 3 /* SignalType.Watcher */) {
+                const deps = this._deps;
+                for (const link of deps.values()) {
+                    if (link.consumedAt === this._computedCount)
+                        continue;
+                    const dep = link.dep;
+                    if (wasConnected) {
+                        scheduleDisconnect(dep);
+                    }
+                    TRACER?.emit({
+                        type: TracerEventType.Disconnected,
+                        id: this._opts.id,
+                        childId: dep._opts.id,
+                    });
+                    deps.delete(dep);
+                    dep._subs.delete(link);
                 }
-                deps.delete(dep);
-                dep._subs.delete(link);
             }
             CURRENT_CONSUMER = prevConsumer;
         }
     }
     _resetDirty() {
         let dirty = this._dirtyDep;
-        // COUNTS.dirtyResetIterations++;
         while (dirty !== undefined) {
-            // COUNTS.dirtyResetIterations++;
             dirty.dep._subs.add(dirty);
             let nextDirty = dirty.nextDirty;
             dirty.nextDirty = undefined;
@@ -304,7 +383,6 @@ export class ComputedSignal {
                     else {
                         let nextDirty = dirty.nextDirty;
                         while (nextDirty !== undefined && nextDirty.ord < ord) {
-                            // COUNTS.dirtyInsertIterations++;
                             dirty = nextDirty;
                             nextDirty = dirty.nextDirty;
                         }
@@ -343,17 +421,54 @@ export class ComputedSignal {
             dep._disconnect();
         }
     }
+    _runEffects() {
+        for (const subscriber of this._opts.subscribers) {
+            subscriber(this._currentValue);
+        }
+    }
+    addListener(subscriber, opts) {
+        const subscribers = this._opts.subscribers;
+        const index = subscribers.indexOf(subscriber);
+        if (index === -1) {
+            subscribers.push(subscriber);
+            if (opts?.immediate) {
+                this._check(true, 1, true);
+            }
+            else {
+                scheduleConnect(this);
+            }
+        }
+        return () => {
+            const index = subscribers.indexOf(subscriber);
+            if (index !== -1) {
+                subscribers.splice(index, 1);
+                scheduleDisconnect(this);
+            }
+        };
+    }
 }
-class StateSignal {
+let STATE_ID = 0;
+export class StateSignal {
     _value;
     _equals;
     _subs = [];
-    constructor(_value, _equals = (a, b) => a === b) {
+    _desc;
+    constructor(_value, _equals = (a, b) => a === b, desc = 'state') {
         this._value = _value;
         this._equals = _equals;
+        this._desc = `${desc}${STATE_ID++}`;
     }
     get() {
         if (CURRENT_CONSUMER !== undefined) {
+            TRACER?.emit({
+                type: TracerEventType.ConsumeState,
+                id: CURRENT_CONSUMER._opts.id,
+                childId: this._desc,
+                value: this._value,
+                setValue: (value) => {
+                    this.set(value);
+                },
+            });
             this._subs.push(CURRENT_CONSUMER._ref);
         }
         return this._value;
@@ -383,40 +498,80 @@ class StateSignal {
         this._subs = [];
     }
 }
-export function state(initialValue, opts) {
-    return new StateSignal(initialValue, opts?.equals);
+let UNKNOWN_SIGNAL_ID = 0;
+const normalizeOpts = (opts) => {
+    return {
+        equals: opts?.equals === false ? FALSE_EQUALS : (opts?.equals ?? ((a, b) => a === b)),
+        id: opts?.id ?? `unknownSignal${UNKNOWN_SIGNAL_ID++}`,
+        desc: opts?.desc,
+        params: opts?.params,
+    };
+};
+export function createStateSignal(initialValue, opts) {
+    const equals = opts?.equals === false ? FALSE_EQUALS : (opts?.equals ?? ((a, b) => a === b));
+    return new StateSignal(initialValue, equals, opts?.desc);
 }
-export function computed(compute, opts) {
-    return new ComputedSignal(0 /* SignalType.Computed */, compute, opts?.equals);
+export function createComputedSignal(compute, opts) {
+    return new ComputedSignal(0 /* SignalType.Computed */, compute, normalizeOpts(opts));
 }
-export function asyncComputed(compute, opts) {
-    return new ComputedSignal(2 /* SignalType.Async */, compute, opts?.equals, opts?.initValue);
+export function createAsyncComputedSignal(compute, opts) {
+    return new ComputedSignal(2 /* SignalType.Async */, compute, normalizeOpts(opts), opts?.initValue);
 }
-export function subscription(subscribe, opts) {
-    return new ComputedSignal(1 /* SignalType.Subscription */, subscribe, opts?.equals, opts?.initValue);
+export function createSubscriptionSignal(subscribe, opts) {
+    return new ComputedSignal(1 /* SignalType.Subscription */, subscribe, normalizeOpts(opts), opts?.initValue);
 }
-export function watcher(fn) {
-    const subscribers = [];
-    const watcher = new ComputedSignal(3 /* SignalType.Watcher */, () => {
-        fn();
-        untrack(() => {
-            for (const subscriber of subscribers) {
-                subscriber();
+export function createAsyncTaskSignal(fn) {
+    let currentPromise;
+    const task = {
+        result: undefined,
+        error: undefined,
+        isPending: false,
+        isSuccess: false,
+        isError: false,
+        isReady: false,
+        async run(...params) {
+            if (!task.isPending) {
+                currentPromise = run(...params);
             }
-        });
-    });
-    scheduleWatcher(watcher);
-    return {
-        disconnect() {
-            scheduleDisconnect(watcher);
-        },
-        subscribe(subscriber) {
-            subscribers.push(subscriber);
-            return () => {
-                subscribers.splice(subscribers.indexOf(subscriber), 1);
-            };
+            return currentPromise;
         },
     };
+    const run = async (...params) => {
+        try {
+            task.isPending = true;
+            task.isError = false;
+            task.isSuccess = false;
+            signal.set(task);
+            const result = await fn(...params);
+            task.result = result;
+            task.isSuccess = true;
+            task.isReady = true;
+            return result;
+        }
+        catch (error) {
+            task.error = error;
+            task.isError = true;
+            throw error;
+        }
+        finally {
+            task.isPending = false;
+            signal.set(task);
+        }
+    };
+    const signal = createStateSignal(task, { equals: false });
+    return signal;
+}
+export function createWatcherSignal(fn, opts) {
+    const normalizedOpts = normalizeOpts({
+        equals: FALSE_EQUALS,
+        subscribers: [],
+        ...opts,
+    });
+    normalizedOpts.subscribers = [];
+    return new ComputedSignal(3 /* SignalType.Watcher */, fn, normalizedOpts);
+}
+export function getCurrentConsumer() {
+    return CURRENT_CONSUMER;
 }
 export function isTracking() {
     return CURRENT_CONSUMER !== undefined;
@@ -425,7 +580,6 @@ export function untrack(fn) {
     const prevConsumer = CURRENT_CONSUMER;
     try {
         CURRENT_CONSUMER = undefined;
-        // LAST_CONSUMED = undefined;
         return fn();
     }
     finally {