@estjs/signals 0.0.15-beta.8 → 0.0.15

package/dist/signals.d.cts

@@ -125,11 +125,17 @@ interface Link {
      * Examples: Effect, Computed
      */
     subNode: ReactiveNode;
-    /** Previous subscriber Link */
+    /**
+     * Connects multiple subscribers of the same depNode.
+     * Previous subscriber Link
+     */
     prevSubLink?: Link;
     /** Next subscriber Link */
     nextSubLink?: Link;
-    /** Previous dependency Link */
+    /**
+     * Connects multiple dependencies of the same subNode.
+     * Previous dependency Link
+     */
     prevDepLink?: Link;
     /** Next dependency Link */
     nextDepLink?: Link;
@@ -210,13 +216,8 @@ interface ReactiveNode {
      * @see ReactiveFlags
      */
     flag: ReactiveFlags;
-    /**
-     * Optional debugging hook called when dependencies are tracked
-     */
+    _triggerVersion?: number;
     onTrack?: (event: DebuggerEvent) => void;
-    /**
-     * Optional debugging hook called when reactive changes are triggered
-     */
     onTrigger?: (event: DebuggerEvent) => void;
 }
 /**
@@ -348,6 +349,7 @@ type SignalType<T> = T extends Signal<infer V> ? V : never;
  * const empty = signal(); // undefined
  * ```
  */
+declare function signal<T>(value: Signal<T>): Signal<T>;
 declare function signal<T>(value?: T): Signal<T>;
 /**
  * Create a new shallow signal with the given initial value.
@@ -473,7 +475,7 @@ declare class ComputedImpl<T = any> implements Computed<T>, ReactiveNode {
     /**
      * Recompute the value
      *
-     *  computation logic:
+     * computation logic:
      * 1. Start tracking dependencies
      * 2. Execute getter function
      * 3. Check if value changed using optimized comparison
@@ -616,8 +618,9 @@ type FlushTiming = 'pre' | 'post' | 'sync';
 /**
  * Schedules a function to be executed in the next microtask
  *
- * If no function is provided, returns a Promise that resolves in the next microtask.
- * This is useful for waiting until the DOM is update or deferring execution.
+ * Returns a Promise that resolves in the next microtask.
+ * Passing fn chains it onto the shared resolved promise — cheaper than
+ * constructing a new Promise + queueMicrotask pair.
  *
  * @param fn - Optional function to execute
  * @returns A Promise that resolves after the function execution
@@ -748,12 +751,11 @@ declare class EffectImpl<T = any> implements ReactiveNode {
     flag: ReactiveFlags;
     private readonly [SignalFlags.IS_EFFECT];
     readonly fn: EffectFunction<T>;
-    readonly scheduler?: EffectScheduler | FlushTiming;
-    readonly onStop?: () => void;
-    readonly onTrack?: (event: DebuggerEvent) => void;
-    readonly onTrigger?: (event: DebuggerEvent) => void;
-    readonly flash?: 'sync' | 'pre' | 'post';
-    private _active;
+    private _flushScheduler?;
+    _active: boolean;
+    onTrack?: (event: DebuggerEvent) => void;
+    onTrigger?: (event: DebuggerEvent) => void;
+    onStop?: () => void;
     /**
      * Create an Effect instance
      *
@@ -767,7 +769,6 @@ declare class EffectImpl<T = any> implements ReactiveNode {
     get active(): boolean;
     /**
      * Check if the Effect is dirty (needs re-execution)
-  
      */
     get dirty(): boolean;
     /**
@@ -1203,6 +1204,7 @@ interface WatchOptions {
     immediate?: boolean;
     deep?: boolean;
 }
+/** Watch source type, can be value, ref/signal, getter function or array. */
 type WatchSource<T = any> = T | {
     value: T;
 } | (() => T);

package/dist/signals.d.ts

@@ -125,11 +125,17 @@ interface Link {
      * Examples: Effect, Computed
      */
     subNode: ReactiveNode;
-    /** Previous subscriber Link */
+    /**
+     * Connects multiple subscribers of the same depNode.
+     * Previous subscriber Link
+     */
     prevSubLink?: Link;
     /** Next subscriber Link */
     nextSubLink?: Link;
-    /** Previous dependency Link */
+    /**
+     * Connects multiple dependencies of the same subNode.
+     * Previous dependency Link
+     */
     prevDepLink?: Link;
     /** Next dependency Link */
     nextDepLink?: Link;
@@ -210,13 +216,8 @@ interface ReactiveNode {
      * @see ReactiveFlags
      */
     flag: ReactiveFlags;
-    /**
-     * Optional debugging hook called when dependencies are tracked
-     */
+    _triggerVersion?: number;
     onTrack?: (event: DebuggerEvent) => void;
-    /**
-     * Optional debugging hook called when reactive changes are triggered
-     */
     onTrigger?: (event: DebuggerEvent) => void;
 }
 /**
@@ -348,6 +349,7 @@ type SignalType<T> = T extends Signal<infer V> ? V : never;
  * const empty = signal(); // undefined
  * ```
  */
+declare function signal<T>(value: Signal<T>): Signal<T>;
 declare function signal<T>(value?: T): Signal<T>;
 /**
  * Create a new shallow signal with the given initial value.
@@ -473,7 +475,7 @@ declare class ComputedImpl<T = any> implements Computed<T>, ReactiveNode {
     /**
      * Recompute the value
      *
-     *  computation logic:
+     * computation logic:
      * 1. Start tracking dependencies
      * 2. Execute getter function
      * 3. Check if value changed using optimized comparison
@@ -616,8 +618,9 @@ type FlushTiming = 'pre' | 'post' | 'sync';
 /**
  * Schedules a function to be executed in the next microtask
  *
- * If no function is provided, returns a Promise that resolves in the next microtask.
- * This is useful for waiting until the DOM is update or deferring execution.
+ * Returns a Promise that resolves in the next microtask.
+ * Passing fn chains it onto the shared resolved promise — cheaper than
+ * constructing a new Promise + queueMicrotask pair.
  *
  * @param fn - Optional function to execute
  * @returns A Promise that resolves after the function execution
@@ -748,12 +751,11 @@ declare class EffectImpl<T = any> implements ReactiveNode {
     flag: ReactiveFlags;
     private readonly [SignalFlags.IS_EFFECT];
     readonly fn: EffectFunction<T>;
-    readonly scheduler?: EffectScheduler | FlushTiming;
-    readonly onStop?: () => void;
-    readonly onTrack?: (event: DebuggerEvent) => void;
-    readonly onTrigger?: (event: DebuggerEvent) => void;
-    readonly flash?: 'sync' | 'pre' | 'post';
-    private _active;
+    private _flushScheduler?;
+    _active: boolean;
+    onTrack?: (event: DebuggerEvent) => void;
+    onTrigger?: (event: DebuggerEvent) => void;
+    onStop?: () => void;
     /**
      * Create an Effect instance
      *
@@ -767,7 +769,6 @@ declare class EffectImpl<T = any> implements ReactiveNode {
     get active(): boolean;
     /**
      * Check if the Effect is dirty (needs re-execution)
-  
      */
     get dirty(): boolean;
     /**
@@ -1203,6 +1204,7 @@ interface WatchOptions {
     immediate?: boolean;
     deep?: boolean;
 }
+/** Watch source type, can be value, ref/signal, getter function or array. */
 type WatchSource<T = any> = T | {
     value: T;
 } | (() => T);