@fluixi/reactive 1.0.0-alpha.82 → 1.0.0-alpha.84

package/dist/lib/signal/utilities.d.ts

@@ -1,18 +1,7 @@
-/**
- * @fileoverview Signal Utility Functions
- * @description Common utility functions for transforming and combining signals
- * @version 1.0.0
- */
 import { type Accessor, type MemoOptions, type EnhancedSignal } from './signal.js';
 import { Observable } from '../observable/observable.js';
 /**
  * Transform a signal value through a mapping function
- * @template T - Input signal type
- * @template U - Output signal type
- * @param signal - Source signal to transform
- * @param fn - Mapping function to apply to signal value
- * @param options - Memo options for equality checking
- * @returns New accessor with transformed value
  *
  * @example
  * ```typescript
@@ -24,11 +13,6 @@ import { Observable } from '../observable/observable.js';
 export declare function mapSignal<T, U>(signal: Accessor<T>, fn: (value: T) => U, options?: MemoOptions<U>): Accessor<U>;
 /**
  * Filter an array signal using a predicate function
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param predicate - Filter function to test each element
- * @param options - Memo options for equality checking
- * @returns New accessor with filtered array
  *
  * @example
  * ```typescript
@@ -40,13 +24,6 @@ export declare function mapSignal<T, U>(signal: Accessor<T>, fn: (value: T) => U
 export declare function filterSignal<T>(signal: Accessor<T[]>, predicate: (value: T, index: number) => boolean, options?: MemoOptions<T[]>): Accessor<T[]>;
 /**
  * Reduce an array signal to a single value
- * @template T - Array element type
- * @template U - Accumulator type
- * @param signal - Source signal containing array
- * @param reducer - Reducer function
- * @param initialValue - Initial accumulator value
- * @param options - Memo options for equality checking
- * @returns New accessor with reduced value
  *
  * @example
  * ```typescript
@@ -58,11 +35,6 @@ export declare function filterSignal<T>(signal: Accessor<T[]>, predicate: (value
 export declare function reduceSignal<T, U>(signal: Accessor<T[]>, reducer: (accumulator: U, current: T, index: number) => U, initialValue: U, options?: MemoOptions<U>): Accessor<U>;
 /**
  * Find first element in array signal matching predicate
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param predicate - Predicate function to test elements
- * @param options - Memo options for equality checking
- * @returns New accessor with found element or undefined
  *
  * @example
  * ```typescript
@@ -74,11 +46,6 @@ export declare function reduceSignal<T, U>(signal: Accessor<T[]>, reducer: (accu
 export declare function findSignal<T>(signal: Accessor<T[]>, predicate: (value: T, index: number) => boolean, options?: MemoOptions<T | undefined>): Accessor<T | undefined>;
 /**
  * Check if any element in array signal matches predicate
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param predicate - Predicate function to test elements
- * @param options - Memo options for equality checking
- * @returns New accessor returning boolean
  *
  * @example
  * ```typescript
@@ -90,11 +57,6 @@ export declare function findSignal<T>(signal: Accessor<T[]>, predicate: (value:
 export declare function someSignal<T>(signal: Accessor<T[]>, predicate: (value: T, index: number) => boolean, options?: MemoOptions<boolean>): Accessor<boolean>;
 /**
  * Check if all elements in array signal match predicate
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param predicate - Predicate function to test elements
- * @param options - Memo options for equality checking
- * @returns New accessor returning boolean
  *
  * @example
  * ```typescript
@@ -106,11 +68,6 @@ export declare function someSignal<T>(signal: Accessor<T[]>, predicate: (value:
 export declare function everySignal<T>(signal: Accessor<T[]>, predicate: (value: T, index: number) => boolean, options?: MemoOptions<boolean>): Accessor<boolean>;
 /**
  * Sort an array signal
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param compareFn - Optional compare function for sorting
- * @param options - Memo options for equality checking
- * @returns New accessor with sorted array
  *
  * @example
  * ```typescript
@@ -122,10 +79,6 @@ export declare function everySignal<T>(signal: Accessor<T[]>, predicate: (value:
 export declare function sortSignal<T>(signal: Accessor<T[]>, compareFn?: (a: T, b: T) => number, options?: MemoOptions<T[]>): Accessor<T[]>;
 /**
  * Get unique values from array signal
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param options - Memo options for equality checking
- * @returns New accessor with unique values
  *
  * @example
  * ```typescript
@@ -137,12 +90,6 @@ export declare function sortSignal<T>(signal: Accessor<T[]>, compareFn?: (a: T,
 export declare function distinctSignal<T>(signal: Accessor<T[]>, options?: MemoOptions<T[]>): Accessor<T[]>;
 /**
  * Combine multiple signals into a single computed signal
- * @template T - Tuple type of signal values
- * @template U - Result type
- * @param signals - Array of signals to combine
- * @param combiner - Function to combine signal values
- * @param options - Memo options for equality checking
- * @returns New accessor with combined value
  *
  * @example
  * ```typescript
@@ -163,11 +110,6 @@ export declare function combineSignals<T extends any[]>(...signals: {
 }): Observable<T>;
 /**
  * Merge two signals, returning value from first truthy signal
- * @template T - Signal value type
- * @param primary - Primary signal
- * @param fallback - Fallback signal if primary is falsy
- * @param options - Memo options for equality checking
- * @returns New accessor with merged value
  *
  * @example
  * ```typescript
@@ -180,14 +122,6 @@ export declare function combineSignals<T extends any[]>(...signals: {
 export declare function mergeSignal<T>(primary: Accessor<T>, fallback: Accessor<T>, options?: MemoOptions<T>): Accessor<T>;
 /**
  * Combine two signals using a binary operator
- * @template T - First signal type
- * @template U - Second signal type
- * @template V - Result type
- * @param a - First signal
- * @param b - Second signal
- * @param operator - Binary operator function
- * @param options - Memo options for equality checking
- * @returns New accessor with combined value
  *
  * @example
  * ```typescript
@@ -201,12 +135,6 @@ export declare function zipSignal<T, U, V>(a: Accessor<T>, b: Accessor<U>, opera
 /**
  * Select a derived value from a signal with custom equality
  * Only updates when selected value changes according to equals function
- * @template T - Signal type
- * @template U - Selected value type
- * @param signal - Source signal
- * @param selector - Function to select value from signal
- * @param equals - Optional equality function (defaults to Object.is)
- * @returns New accessor with selected value
  *
  * @example
  * ```typescript
@@ -218,12 +146,6 @@ export declare function zipSignal<T, U, V>(a: Accessor<T>, b: Accessor<U>, opera
 export declare function selectSignal<T, U>(signal: Accessor<T>, selector: (value: T) => U, equals?: (a: U, b: U) => boolean): Accessor<U>;
 /**
  * Pick specific properties from an object signal
- * @template T - Object type
- * @template K - Property keys
- * @param signal - Source signal containing object
- * @param keys - Array of property keys to pick
- * @param options - Memo options for equality checking
- * @returns New accessor with picked properties
  *
  * @example
  * ```typescript
@@ -235,12 +157,6 @@ export declare function selectSignal<T, U>(signal: Accessor<T>, selector: (value
 export declare function pickSignal<T extends Record<string, any>, K extends keyof T>(signal: Accessor<T>, keys: K[], options?: MemoOptions<Pick<T, K>>): Accessor<Pick<T, K>>;
 /**
  * Omit specific properties from an object signal
- * @template T - Object type
- * @template K - Property keys to omit
- * @param signal - Source signal containing object
- * @param keys - Array of property keys to omit
- * @param options - Memo options for equality checking
- * @returns New accessor with omitted properties
  *
  * @example
  * ```typescript
@@ -252,12 +168,6 @@ export declare function pickSignal<T extends Record<string, any>, K extends keyo
 export declare function omitSignal<T extends Record<string, any>, K extends keyof T>(signal: Accessor<T>, keys: K[], options?: MemoOptions<Omit<T, K>>): Accessor<Omit<T, K>>;
 /**
  * Conditionally compute signal based on condition
- * @template T - Result type
- * @param condition - Condition signal or accessor
- * @param whenTrue - Accessor to use when condition is true
- * @param whenFalse - Accessor to use when condition is false
- * @param options - Memo options for equality checking
- * @returns New accessor with conditional value
  *
  * @example
  * ```typescript
@@ -271,11 +181,6 @@ export declare function omitSignal<T extends Record<string, any>, K extends keyo
 export declare function whenSignal<T>(condition: Accessor<boolean>, whenTrue: Accessor<T>, whenFalse: Accessor<T>, options?: MemoOptions<T>): Accessor<T>;
 /**
  * Compute signal only when condition is true, otherwise return undefined
- * @template T - Result type
- * @param condition - Condition signal or accessor
- * @param accessor - Accessor to use when condition is true
- * @param options - Memo options for equality checking
- * @returns New accessor with conditional value or undefined
  *
  * @example
  * ```typescript
@@ -288,11 +193,6 @@ export declare function whenSignal<T>(condition: Accessor<boolean>, whenTrue: Ac
 export declare function guardSignal<T>(condition: Accessor<boolean>, accessor: Accessor<T>, options?: MemoOptions<T | undefined>): Accessor<T | undefined>;
 /**
  * Debounce a signal - only update after delay period with no changes
- * @template T - Signal type
- * @param signal - Source signal to debounce
- * @param delay - Delay in milliseconds
- * @param options - Memo options for equality checking
- * @returns New accessor with debounced value
  *
  * @example
  * ```typescript
@@ -304,11 +204,6 @@ export declare function guardSignal<T>(condition: Accessor<boolean>, accessor: A
 export declare function debounceSignal<T>(signal: Accessor<T>, delay: number, options?: MemoOptions<T>): Accessor<T>;
 /**
  * Throttle a signal - limit update frequency
- * @template T - Signal type
- * @param signal - Source signal to throttle
- * @param delay - Minimum delay between updates in milliseconds
- * @param options - Memo options for equality checking
- * @returns New accessor with throttled value
  *
  * @example
  * ```typescript
@@ -327,9 +222,6 @@ export { type Accessor, type MemoOptions } from './signal.js';
  * Useful for converting callback-based APIs to promises, implementing timeouts,
  * or coordinating complex async flows.
  *
- * @template T - The type of the value the promise resolves with
- * @returns An object containing the promise, resolve function, and reject function
- *
  * @example
  * ```typescript
  * // Create a promise with external controls

package/dist/lib/signal/utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../src/lib/signal/utilities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../src/lib/signal/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAMzD;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAC5B,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EACnB,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,QAAQ,CAAC,CAAC,CAAC,CAEb;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EACrB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,EAC/C,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,GACzB,QAAQ,CAAC,CAAC,EAAE,CAAC,CAEf;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAC/B,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EACrB,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,EACzD,YAAY,EAAE,CAAC,EACf,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,QAAQ,CAAC,CAAC,CAAC,CAMb;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EACrB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,EAC/C,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,SAAS,CAAC,GACnC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,CAEzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EACrB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,EAC/C,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAC7B,QAAQ,CAAC,OAAO,CAAC,CAEnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EACrB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,EAC/C,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAC7B,QAAQ,CAAC,OAAO,CAAC,CAEnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EACrB,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,EAClC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,GACzB,QAAQ,CAAC,CAAC,EAAE,CAAC,CAEf;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EACrB,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,GACzB,QAAQ,CAAC,CAAC,EAAE,CAAC,CAEf;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,EAC9C,OAAO,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,EAC3C,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAC1B,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,QAAQ,CAAC,CAAC,CAAC,CASb;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,GAAG,EAAE,EAC5C,GAAG,OAAO,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACpE,UAAU,CAAC,CAAC,CAAC,CAkCf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EACpB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,QAAQ,CAAC,CAAC,CAAC,CAEb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC/B,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EACd,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EACd,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,EAC3B,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,QAAQ,CAAC,CAAC,CAAC,CAEb;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAC/B,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EACzB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,GAC/B,QAAQ,CAAC,CAAC,CAAC,CAKb;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACzE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAChC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAatB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACzE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAChC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAatB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC5B,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,QAAQ,CAAC,CAAC,CAAC,CAMb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC5B,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,SAAS,CAAC,GACnC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,CAMzB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,QAAQ,CAAC,CAAC,CAAC,CAWb;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,QAAQ,CAAC,CAAC,CAAC,CAsBb;AAGD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAI,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE5P,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAI5E"}

package/dist/lib/signal/utilities.js

@@ -1,8 +1,3 @@
-/**
- * @fileoverview Signal Utility Functions
- * @description Common utility functions for transforming and combining signals
- * @version 1.0.0
- */
 import { createSignal, createMemo, createEffect } from './graph/compat.js';
 import { Observable } from '../observable/observable.js';
 // ============================================================================
@@ -10,12 +5,6 @@ import { Observable } from '../observable/observable.js';
 // ============================================================================
 /**
  * Transform a signal value through a mapping function
- * @template T - Input signal type
- * @template U - Output signal type
- * @param signal - Source signal to transform
- * @param fn - Mapping function to apply to signal value
- * @param options - Memo options for equality checking
- * @returns New accessor with transformed value
  *
  * @example
  * ```typescript
@@ -29,11 +18,6 @@ export function mapSignal(signal, fn, options) {
 }
 /**
  * Filter an array signal using a predicate function
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param predicate - Filter function to test each element
- * @param options - Memo options for equality checking
- * @returns New accessor with filtered array
  *
  * @example
  * ```typescript
@@ -47,13 +31,6 @@ export function filterSignal(signal, predicate, options) {
 }
 /**
  * Reduce an array signal to a single value
- * @template T - Array element type
- * @template U - Accumulator type
- * @param signal - Source signal containing array
- * @param reducer - Reducer function
- * @param initialValue - Initial accumulator value
- * @param options - Memo options for equality checking
- * @returns New accessor with reduced value
  *
  * @example
  * ```typescript
@@ -67,11 +44,6 @@ export function reduceSignal(signal, reducer, initialValue, options) {
 }
 /**
  * Find first element in array signal matching predicate
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param predicate - Predicate function to test elements
- * @param options - Memo options for equality checking
- * @returns New accessor with found element or undefined
  *
  * @example
  * ```typescript
@@ -85,11 +57,6 @@ export function findSignal(signal, predicate, options) {
 }
 /**
  * Check if any element in array signal matches predicate
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param predicate - Predicate function to test elements
- * @param options - Memo options for equality checking
- * @returns New accessor returning boolean
  *
  * @example
  * ```typescript
@@ -103,11 +70,6 @@ export function someSignal(signal, predicate, options) {
 }
 /**
  * Check if all elements in array signal match predicate
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param predicate - Predicate function to test elements
- * @param options - Memo options for equality checking
- * @returns New accessor returning boolean
  *
  * @example
  * ```typescript
@@ -121,11 +83,6 @@ export function everySignal(signal, predicate, options) {
 }
 /**
  * Sort an array signal
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param compareFn - Optional compare function for sorting
- * @param options - Memo options for equality checking
- * @returns New accessor with sorted array
  *
  * @example
  * ```typescript
@@ -139,10 +96,6 @@ export function sortSignal(signal, compareFn, options) {
 }
 /**
  * Get unique values from array signal
- * @template T - Array element type
- * @param signal - Source signal containing array
- * @param options - Memo options for equality checking
- * @returns New accessor with unique values
  *
  * @example
  * ```typescript
@@ -159,12 +112,6 @@ export function distinctSignal(signal, options) {
 // ============================================================================
 /**
  * Combine multiple signals into a single computed signal
- * @template T - Tuple type of signal values
- * @template U - Result type
- * @param signals - Array of signals to combine
- * @param combiner - Function to combine signal values
- * @param options - Memo options for equality checking
- * @returns New accessor with combined value
  *
  * @example
  * ```typescript
@@ -211,72 +158,14 @@ export function combineSignals(...signals) {
             });
         };
     });
-    //   return {
-    //     subscribe(
-    //       observerOrNext?: ((value: T) => void) | Partial<SignalObserver<T>>,
-    //       error?: (error: any) => void,
-    //       complete?: () => void
-    //     ): Subscription {
-    //       const observer = typeof observerOrNext === 'function'
-    //         ? { next: observerOrNext, error, complete }
-    //         : observerOrNext || {};
-    //       const getValues = () => signals.map(s =>
-    //         typeof s === 'function' ? s() : s.get()
-    //       ) as T;
-    //       if (observer.next) {
-    //         observer.next(getValues());
-    //       }
-    //       const disposers = signals.map(signal => {
-    //         if (typeof signal === 'function' && (signal as any).subscribe) {
-    //           return (signal as any).subscribe(() => {
-    //             if (observer.next) {
-    //               observer.next(getValues());
-    //             }
-    //           });
-    //         } else if (typeof signal !== 'function') {
-    //           return signal.subscribe(() => {
-    //             if (observer.next) {
-    //               observer.next(getValues());
-    //             }
-    //           });
-    //         }
-    //         return createEffect(() => {
-    //           getValues();
-    //           if (observer.next) {
-    //             observer.next(getValues());
-    //           }
-    //         });
-    //       });
-    //       return {
-    //         unsubscribe: () => {
-    //           disposers.forEach(dispose => {
-    //             if (typeof dispose === 'function') dispose();
-    //             else if (dispose && typeof dispose.unsubscribe === 'function') {
-    //               dispose.unsubscribe();
-    //             }
-    //           });
-    //         },
-    //         closed: false
-    //       };
     //     },
     //     pipe(...operators: any[]): Observable<any> {
     //       throw new Error('Pipe requires RxJS');
     //     }
     //   };
 }
-// export function isSignal<T>(fn: any): fn is () => T {
-//   return typeof fn === 'function' && fn.length === 0;
-// }
-// export function isEffect(fn: any): fn is SignalObserver {
-//   return typeof fn === 'function' && 'dependencies' in fn;
-// }
 /**
  * Merge two signals, returning value from first truthy signal
- * @template T - Signal value type
- * @param primary - Primary signal
- * @param fallback - Fallback signal if primary is falsy
- * @param options - Memo options for equality checking
- * @returns New accessor with merged value
  *
  * @example
  * ```typescript
@@ -291,14 +180,6 @@ export function mergeSignal(primary, fallback, options) {
 }
 /**
  * Combine two signals using a binary operator
- * @template T - First signal type
- * @template U - Second signal type
- * @template V - Result type
- * @param a - First signal
- * @param b - Second signal
- * @param operator - Binary operator function
- * @param options - Memo options for equality checking
- * @returns New accessor with combined value
  *
  * @example
  * ```typescript
@@ -317,12 +198,6 @@ export function zipSignal(a, b, operator, options) {
 /**
  * Select a derived value from a signal with custom equality
  * Only updates when selected value changes according to equals function
- * @template T - Signal type
- * @template U - Selected value type
- * @param signal - Source signal
- * @param selector - Function to select value from signal
- * @param equals - Optional equality function (defaults to Object.is)
- * @returns New accessor with selected value
  *
  * @example
  * ```typescript
@@ -339,12 +214,6 @@ export function selectSignal(signal, selector, equals) {
 }
 /**
  * Pick specific properties from an object signal
- * @template T - Object type
- * @template K - Property keys
- * @param signal - Source signal containing object
- * @param keys - Array of property keys to pick
- * @param options - Memo options for equality checking
- * @returns New accessor with picked properties
  *
  * @example
  * ```typescript
@@ -365,12 +234,6 @@ export function pickSignal(signal, keys, options) {
 }
 /**
  * Omit specific properties from an object signal
- * @template T - Object type
- * @template K - Property keys to omit
- * @param signal - Source signal containing object
- * @param keys - Array of property keys to omit
- * @param options - Memo options for equality checking
- * @returns New accessor with omitted properties
  *
  * @example
  * ```typescript
@@ -394,12 +257,6 @@ export function omitSignal(signal, keys, options) {
 // ============================================================================
 /**
  * Conditionally compute signal based on condition
- * @template T - Result type
- * @param condition - Condition signal or accessor
- * @param whenTrue - Accessor to use when condition is true
- * @param whenFalse - Accessor to use when condition is false
- * @param options - Memo options for equality checking
- * @returns New accessor with conditional value
  *
  * @example
  * ```typescript
@@ -415,11 +272,6 @@ export function whenSignal(condition, whenTrue, whenFalse, options) {
 }
 /**
  * Compute signal only when condition is true, otherwise return undefined
- * @template T - Result type
- * @param condition - Condition signal or accessor
- * @param accessor - Accessor to use when condition is true
- * @param options - Memo options for equality checking
- * @returns New accessor with conditional value or undefined
  *
  * @example
  * ```typescript
@@ -437,11 +289,6 @@ export function guardSignal(condition, accessor, options) {
 // ============================================================================
 /**
  * Debounce a signal - only update after delay period with no changes
- * @template T - Signal type
- * @param signal - Source signal to debounce
- * @param delay - Delay in milliseconds
- * @param options - Memo options for equality checking
- * @returns New accessor with debounced value
  *
  * @example
  * ```typescript
@@ -462,11 +309,6 @@ export function debounceSignal(signal, delay, options) {
 }
 /**
  * Throttle a signal - limit update frequency
- * @template T - Signal type
- * @param signal - Source signal to throttle
- * @param delay - Minimum delay between updates in milliseconds
- * @param options - Memo options for equality checking
- * @returns New accessor with throttled value
  *
  * @example
  * ```typescript