@sergeydus/ng-signals-utils 0.0.1

package/README.md

@@ -0,0 +1,261 @@
+# ng-signals-utils
+
+[![npm version](https://img.shields.io/npm/v/ng-signals-utils.svg)](https://www.npmjs.com/package/ng-signals-utils)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+[![Angular](https://img.shields.io/badge/Angular-17+-red.svg)](https://angular.io/)
+
+**Powerful utility functions for Angular signals that make reactive programming easier and more intuitive.**
+
+Stop writing repetitive signal manipulation code. `ng-signals-utils` provides a comprehensive set of utilities for transforming, filtering, and managing signals in your Angular applications.
+
+## 🚀 Why ng-signals-utils?
+
+Angular's signals are powerful, but common operations require boilerplate code. This library provides:
+
+- ✅ **Signal Transformations** - Map, filter, debounce, and combine signals effortlessly
+- ✅ **Array Operations** - Work with array signals using familiar array methods
+- ✅ **Object Utilities** - Update and transform object signals with ease
+- ✅ **Effect Helpers** - Advanced effect management with debouncing, throttling, and more
+- ✅ **Type-Safe** - Full TypeScript support with proper type inference
+- ✅ **Tree-Shakeable** - Only bundle what you use
+- ✅ **Zero Dependencies** - Except Angular core, of course
+
+## 📦 Installation
+
+```bash
+npm install ng-signals-utils
+```
+
+```bash
+yarn add ng-signals-utils
+```
+
+```bash
+pnpm add ng-signals-utils
+```
+
+## 🎯 Quick Examples
+
+### Before vs After
+
+**Without ng-signals-utils:**
+```typescript
+// Debouncing a search signal
+const searchTerm = signal('');
+const debouncedSearch = signal('');
+let timeoutId: any;
+
+effect(() => {
+  const value = searchTerm();
+  clearTimeout(timeoutId);
+  timeoutId = setTimeout(() => {
+    debouncedSearch.set(value);
+  }, 300);
+});
+```
+
+**With ng-signals-utils:**
+```typescript
+import { debounceSignal } from 'ng-signals-utils';
+
+const searchTerm = signal('');
+const debouncedSearch = debounceSignal(searchTerm, 300);
+// Done! 🎉
+```
+
+---
+
+**Without ng-signals-utils:**
+```typescript
+// Filtering an array signal
+const allTodos = signal<Todo[]>([]);
+const completedTodos = computed(() => 
+  allTodos().filter(todo => todo.completed)
+);
+```
+
+**With ng-signals-utils:**
+```typescript
+import { arraySignalFilter } from 'ng-signals-utils';
+
+const allTodos = signal<Todo[]>([]);
+const completedTodos = arraySignalFilter(allTodos, todo => todo.completed);
+// More expressive and reusable! ✨
+```
+
+## 💡 Common Use Cases
+
+### Real-time Search with Debouncing
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { debounceSignal } from 'ng-signals-utils';
+
+@Component({
+  selector: 'app-search',
+  template: `
+    <input [value]="searchTerm()" (input)="onSearch($event)" />
+    <p>Searching for: {{ debouncedSearch() }}</p>
+  `
+})
+export class SearchComponent {
+  searchTerm = signal('');
+  debouncedSearch = debounceSignal(this.searchTerm, 300);
+  
+  // API calls automatically debounced!
+  constructor() {
+    effect(() => {
+      const query = this.debouncedSearch();
+      if (query) this.searchAPI(query);
+    });
+  }
+}
+```
+
+### Managing Todo Lists
+
+```typescript
+import { arraySignalPush, arraySignalRemoveAt, arraySignalFilter } from 'ng-signals-utils';
+
+export class TodoComponent {
+  todos = signal<Todo[]>([]);
+  completedTodos = arraySignalFilter(this.todos, t => t.completed);
+  pendingTodos = arraySignalFilter(this.todos, t => !t.completed);
+  
+  addTodo(text: string) {
+    arraySignalPush(this.todos, { id: Date.now(), text, completed: false });
+  }
+  
+  removeTodo(index: number) {
+    arraySignalRemoveAt(this.todos, index);
+  }
+}
+```
+
+### Form State Management
+
+```typescript
+import { patchSignal, pickSignal } from 'ng-signals-utils';
+
+export class UserFormComponent {
+  user = signal({
+    id: 1,
+    name: '',
+    email: '',
+    password: '',
+    role: 'user'
+  });
+  
+  // Only expose safe fields
+  publicUser = pickSignal(this.user, 'id', 'name', 'email');
+  
+  updateField(field: string, value: any) {
+    patchSignal(this.user, { [field]: value });
+  }
+}
+```
+
+### Combining Multiple Signals
+
+```typescript
+import { combineSignals } from 'ng-signals-utils';
+
+export class CheckoutComponent {
+  items = signal<Item[]>([]);
+  tax = signal(0.08);
+  shipping = signal(10);
+  
+  // Automatically recalculates when any signal changes
+  orderSummary = computed(() => {
+    const [itemList, taxRate, shippingCost] = combineSignals([
+      this.items,
+      this.tax,
+      this.shipping
+    ])();
+    
+    const subtotal = itemList.reduce((sum, item) => sum + item.price, 0);
+    return {
+      subtotal,
+      tax: subtotal * taxRate,
+      shipping: shippingCost,
+      total: subtotal * (1 + taxRate) + shippingCost
+    };
+  });
+}
+```
+
+## 📚 API Reference
+
+### Signal Transformations
+
+| Function | Description |
+|----------|-------------|
+| `mapSignal<T, R>(source, fn)` | Transform signal values to another type |
+| `filterSignal<T>(source, predicate, initial)` | Filter signal updates based on a condition |
+| `debounceSignal<T>(source, ms)` | Debounce signal updates |
+| `combineSignals<T>(signals)` | Combine multiple signals into one |
+| `distinctSignal<T>(source, compareFn?)` | Emit only distinct consecutive values |
+
+### Array Utilities
+
+| Function | Description |
+|----------|-------------|
+| `arraySignalPush<T>(signal, item)` | Add item to array signal |
+| `arraySignalRemoveAt<T>(signal, index)` | Remove item at index |
+| `arraySignalFilter<T>(signal, predicate)` | Create filtered computed signal |
+| `arraySignalMap<T, R>(signal, fn)` | Create mapped computed signal |
+| `arraySignalSort<T>(signal, compareFn?)` | Create sorted computed signal |
+| `arraySignalFind<T>(signal, predicate)` | Find item in array signal |
+| `arraySignalLength<T>(signal)` | Get array length as signal |
+| `arraySignalIsEmpty<T>(signal)` | Check if array is empty |
+
+### Object Utilities
+
+| Function | Description |
+|----------|-------------|
+| `patchSignal<T>(signal, partial)` | Update object signal with partial values |
+| `pickSignal<T, K>(signal, ...keys)` | Pick specific keys from object |
+| `omitSignal<T, K>(signal, ...keys)` | Omit specific keys from object |
+| `pluckSignal<T, K>(signal, key)` | Extract single property as signal |
+| `objectSignalKeys<T>(signal)` | Get object keys as signal |
+| `objectSignalValues<T>(signal)` | Get object values as signal |
+| `objectSignalEntries<T>(signal)` | Get object entries as signal |
+
+### Effect Helpers
+
+| Function | Description |
+|----------|-------------|
+| `watchSignal<T>(source, fn, options?)` | Watch signal with access to previous value |
+| `watchUntil<T>(source, predicate, fn, options?)` | Run effect once when condition is met |
+| `throttleEffect<T>(source, fn, ms, options?)` | Throttle effect execution |
+| `debounceEffect<T>(source, fn, ms, options?)` | Debounce effect execution |
+
+## 📖 Full Documentation
+
+For comprehensive examples and advanced usage patterns, see [EXAMPLES.md](./EXAMPLES.md).
+
+## 🔧 Requirements
+
+- Angular 17.0.0 or higher
+- TypeScript 5.0 or higher
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+MIT © [Your Name]
+
+## 🌟 Show Your Support
+
+If you find this library helpful, please give it a star on GitHub!
+
+## 📮 Feedback & Issues
+
+Found a bug or have a feature request? [Open an issue](https://github.com/yourusername/ng-signals-utils/issues)
+
+---
+
+Made with ❤️ for the Angular community

package/fesm2022/ng-signals-utils.mjs

@@ -0,0 +1,303 @@
+import { computed, signal, effect } from '@angular/core';
+
+/**
+ * Maps a signal value to another type
+ * @param source - Source signal
+ * @param fn - Mapping function
+ * @returns Computed signal with mapped value
+ */
+function mapSignal(source, fn) {
+    return computed(() => fn(source()));
+}
+/**
+ * Filters signal updates based on a predicate
+ * @param source - Source signal
+ * @param predicate - Filter predicate
+ * @param initialValue - Initial value to use if predicate fails
+ * @returns Signal that only updates when predicate returns true
+ */
+function filterSignal(source, predicate, initialValue) {
+    const filtered = signal(initialValue, ...(ngDevMode ? [{ debugName: "filtered" }] : []));
+    effect(() => {
+        const value = source();
+        if (predicate(value)) {
+            filtered.set(value);
+        }
+    });
+    return filtered.asReadonly();
+}
+/**
+ * Debounces signal updates
+ * @param source - Source signal
+ * @param ms - Debounce delay in milliseconds
+ * @returns Debounced signal
+ */
+function debounceSignal(source, ms) {
+    const debounced = signal(source(), ...(ngDevMode ? [{ debugName: "debounced" }] : []));
+    let timeoutId;
+    effect(() => {
+        const value = source();
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => {
+            debounced.set(value);
+        }, ms);
+    });
+    return debounced.asReadonly();
+}
+/**
+ * Combines multiple signals into a single signal
+ * @param signals - Array of signals to combine
+ * @returns Combined signal with array of values
+ */
+function combineSignals(signals) {
+    return computed(() => signals.map(s => s()));
+}
+/**
+ * Creates a signal that emits distinct values only
+ * @param source - Source signal
+ * @param compareFn - Optional comparison function
+ * @returns Signal that only updates on distinct values
+ */
+function distinctSignal(source, compareFn = (a, b) => a === b) {
+    const distinct = signal(source(), ...(ngDevMode ? [{ debugName: "distinct" }] : []));
+    let lastValue = source();
+    effect(() => {
+        const value = source();
+        if (!compareFn(value, lastValue)) {
+            lastValue = value;
+            distinct.set(value);
+        }
+    });
+    return distinct.asReadonly();
+}
+
+/**
+ * Pushes an item to an array signal
+ * @param arraySignal - Writable array signal
+ * @param item - Item to push
+ */
+function arraySignalPush(arraySignal, item) {
+    arraySignal.update(arr => [...arr, item]);
+}
+/**
+ * Removes an item from an array signal at the specified index
+ * @param arraySignal - Writable array signal
+ * @param index - Index to remove
+ */
+function arraySignalRemoveAt(arraySignal, index) {
+    arraySignal.update(arr => arr.filter((_, i) => i !== index));
+}
+/**
+ * Filters an array signal
+ * @param arraySignal - Array signal
+ * @param predicate - Filter predicate
+ * @returns Computed signal with filtered array
+ */
+function arraySignalFilter(arraySignal, predicate) {
+    return computed(() => arraySignal().filter(predicate));
+}
+/**
+ * Maps an array signal
+ * @param arraySignal - Array signal
+ * @param fn - Mapping function
+ * @returns Computed signal with mapped array
+ */
+function arraySignalMap(arraySignal, fn) {
+    return computed(() => arraySignal().map(fn));
+}
+/**
+ * Sorts an array signal
+ * @param arraySignal - Array signal
+ * @param compareFn - Optional comparison function
+ * @returns Computed signal with sorted array
+ */
+function arraySignalSort(arraySignal, compareFn) {
+    return computed(() => [...arraySignal()].sort(compareFn));
+}
+/**
+ * Finds an item in an array signal
+ * @param arraySignal - Array signal
+ * @param predicate - Find predicate
+ * @returns Computed signal with found item or undefined
+ */
+function arraySignalFind(arraySignal, predicate) {
+    return computed(() => arraySignal().find(predicate));
+}
+/**
+ * Gets the length of an array signal
+ * @param arraySignal - Array signal
+ * @returns Computed signal with array length
+ */
+function arraySignalLength(arraySignal) {
+    return computed(() => arraySignal().length);
+}
+/**
+ * Checks if an array signal is empty
+ * @param arraySignal - Array signal
+ * @returns Computed signal indicating if array is empty
+ */
+function arraySignalIsEmpty(arraySignal) {
+    return computed(() => arraySignal().length === 0);
+}
+
+/**
+ * Patches an object signal with partial values
+ * @param objectSignal - Writable object signal
+ * @param partial - Partial object to merge
+ */
+function patchSignal(objectSignal, partial) {
+    objectSignal.update(obj => ({ ...obj, ...partial }));
+}
+/**
+ * Picks specific keys from an object signal
+ * @param objectSignal - Object signal
+ * @param keys - Keys to pick
+ * @returns Computed signal with picked keys
+ */
+function pickSignal(objectSignal, ...keys) {
+    return computed(() => {
+        const obj = objectSignal();
+        const result = {};
+        for (const key of keys) {
+            result[key] = obj[key];
+        }
+        return result;
+    });
+}
+/**
+ * Omits specific keys from an object signal
+ * @param objectSignal - Object signal
+ * @param keys - Keys to omit
+ * @returns Computed signal with omitted keys
+ */
+function omitSignal(objectSignal, ...keys) {
+    return computed(() => {
+        const obj = objectSignal();
+        const result = { ...obj };
+        for (const key of keys) {
+            delete result[key];
+        }
+        return result;
+    });
+}
+/**
+ * Gets a property value from an object signal
+ * @param objectSignal - Object signal
+ * @param key - Property key
+ * @returns Computed signal with property value
+ */
+function pluckSignal(objectSignal, key) {
+    return computed(() => objectSignal()[key]);
+}
+/**
+ * Gets the keys of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object keys
+ */
+function objectSignalKeys(objectSignal) {
+    return computed(() => Object.keys(objectSignal()));
+}
+/**
+ * Gets the values of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object values
+ */
+function objectSignalValues(objectSignal) {
+    return computed(() => Object.values(objectSignal()));
+}
+/**
+ * Gets the entries of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object entries
+ */
+function objectSignalEntries(objectSignal) {
+    return computed(() => Object.entries(objectSignal()));
+}
+
+/**
+ * Creates an effect that runs only when the signal value changes
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+function watchSignal(source, fn, options) {
+    let previousValue = undefined;
+    let isFirst = true;
+    return effect(() => {
+        const value = source();
+        if (!isFirst) {
+            fn(value, previousValue);
+        }
+        previousValue = value;
+        isFirst = false;
+    }, options);
+}
+/**
+ * Creates an effect that runs once when the signal meets a condition
+ * @param source - Source signal to watch
+ * @param predicate - Condition to check
+ * @param fn - Effect function
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+function watchUntil(source, predicate, fn, options) {
+    let hasRun = false;
+    const effectRef = effect(() => {
+        if (hasRun)
+            return;
+        const value = source();
+        if (predicate(value)) {
+            fn(value);
+            hasRun = true;
+            effectRef.destroy();
+        }
+    }, options);
+    return effectRef;
+}
+/**
+ * Creates a throttled effect
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param ms - Throttle delay in milliseconds
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+function throttleEffect(source, fn, ms, options) {
+    let lastRun = 0;
+    return effect(() => {
+        const value = source();
+        const now = Date.now();
+        if (now - lastRun >= ms) {
+            fn(value);
+            lastRun = now;
+        }
+    }, options);
+}
+/**
+ * Creates a debounced effect
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param ms - Debounce delay in milliseconds
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+function debounceEffect(source, fn, ms, options) {
+    let timeoutId;
+    return effect(() => {
+        const value = source();
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => fn(value), ms);
+    }, options);
+}
+
+/*
+ * Public API Surface of ng-signals-utils
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { arraySignalFilter, arraySignalFind, arraySignalIsEmpty, arraySignalLength, arraySignalMap, arraySignalPush, arraySignalRemoveAt, arraySignalSort, combineSignals, debounceEffect, debounceSignal, distinctSignal, filterSignal, mapSignal, objectSignalEntries, objectSignalKeys, objectSignalValues, omitSignal, patchSignal, pickSignal, pluckSignal, throttleEffect, watchSignal, watchUntil };
+//# sourceMappingURL=ng-signals-utils.mjs.map

package/fesm2022/ng-signals-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-signals-utils.mjs","sources":["../../../projects/ng-signals-utils/src/lib/signal-transformations.ts","../../../projects/ng-signals-utils/src/lib/signal-array-utils.ts","../../../projects/ng-signals-utils/src/lib/signal-object-utils.ts","../../../projects/ng-signals-utils/src/lib/signal-effect-utils.ts","../../../projects/ng-signals-utils/src/public-api.ts","../../../projects/ng-signals-utils/src/ng-signals-utils.ts"],"sourcesContent":["import { Signal, computed, signal, WritableSignal, effect } from '@angular/core';\r\n\r\n/**\r\n * Maps a signal value to another type\r\n * @param source - Source signal\r\n * @param fn - Mapping function\r\n * @returns Computed signal with mapped value\r\n */\r\nexport function mapSignal<T, R>(\r\n  source: Signal<T>,\r\n  fn: (value: T) => R\r\n): Signal<R> {\r\n  return computed(() => fn(source()));\r\n}\r\n\r\n/**\r\n * Filters signal updates based on a predicate\r\n * @param source - Source signal\r\n * @param predicate - Filter predicate\r\n * @param initialValue - Initial value to use if predicate fails\r\n * @returns Signal that only updates when predicate returns true\r\n */\r\nexport function filterSignal<T>(\r\n  source: Signal<T>,\r\n  predicate: (value: T) => boolean,\r\n  initialValue: T\r\n): Signal<T> {\r\n  const filtered = signal(initialValue);\r\n  \r\n  effect(() => {\r\n    const value = source();\r\n    if (predicate(value)) {\r\n      (filtered as WritableSignal<T>).set(value);\r\n    }\r\n  });\r\n  \r\n  return filtered.asReadonly();\r\n}\r\n\r\n/**\r\n * Debounces signal updates\r\n * @param source - Source signal\r\n * @param ms - Debounce delay in milliseconds\r\n * @returns Debounced signal\r\n */\r\nexport function debounceSignal<T>(\r\n  source: Signal<T>,\r\n  ms: number\r\n): Signal<T> {\r\n  const debounced = signal(source());\r\n  let timeoutId: any;\r\n  \r\n  effect(() => {\r\n    const value = source();\r\n    clearTimeout(timeoutId);\r\n    timeoutId = setTimeout(() => {\r\n      (debounced as WritableSignal<T>).set(value);\r\n    }, ms);\r\n  });\r\n  \r\n  return debounced.asReadonly();\r\n}\r\n\r\n/**\r\n * Combines multiple signals into a single signal\r\n * @param signals - Array of signals to combine\r\n * @returns Combined signal with array of values\r\n */\r\nexport function combineSignals<T extends readonly Signal<any>[]>(\r\n  signals: T\r\n): Signal<{ [K in keyof T]: T[K] extends Signal<infer U> ? U : never }> {\r\n  return computed(() => signals.map(s => s()) as any);\r\n}\r\n\r\n/**\r\n * Creates a signal that emits distinct values only\r\n * @param source - Source signal\r\n * @param compareFn - Optional comparison function\r\n * @returns Signal that only updates on distinct values\r\n */\r\nexport function distinctSignal<T>(\r\n  source: Signal<T>,\r\n  compareFn: (a: T, b: T) => boolean = (a, b) => a === b\r\n): Signal<T> {\r\n  const distinct = signal(source());\r\n  let lastValue = source();\r\n  \r\n  effect(() => {\r\n    const value = source();\r\n    if (!compareFn(value, lastValue)) {\r\n      lastValue = value;\r\n      (distinct as WritableSignal<T>).set(value);\r\n    }\r\n  });\r\n  \r\n  return distinct.asReadonly();\r\n}\r\n","import { Signal, WritableSignal, computed } from '@angular/core';\r\n\r\n/**\r\n * Pushes an item to an array signal\r\n * @param arraySignal - Writable array signal\r\n * @param item - Item to push\r\n */\r\nexport function arraySignalPush<T>(\r\n  arraySignal: WritableSignal<T[]>,\r\n  item: T\r\n): void {\r\n  arraySignal.update(arr => [...arr, item]);\r\n}\r\n\r\n/**\r\n * Removes an item from an array signal at the specified index\r\n * @param arraySignal - Writable array signal\r\n * @param index - Index to remove\r\n */\r\nexport function arraySignalRemoveAt<T>(\r\n  arraySignal: WritableSignal<T[]>,\r\n  index: number\r\n): void {\r\n  arraySignal.update(arr => arr.filter((_, i) => i !== index));\r\n}\r\n\r\n/**\r\n * Filters an array signal\r\n * @param arraySignal - Array signal\r\n * @param predicate - Filter predicate\r\n * @returns Computed signal with filtered array\r\n */\r\nexport function arraySignalFilter<T>(\r\n  arraySignal: Signal<T[]>,\r\n  predicate: (item: T, index: number) => boolean\r\n): Signal<T[]> {\r\n  return computed(() => arraySignal().filter(predicate));\r\n}\r\n\r\n/**\r\n * Maps an array signal\r\n * @param arraySignal - Array signal\r\n * @param fn - Mapping function\r\n * @returns Computed signal with mapped array\r\n */\r\nexport function arraySignalMap<T, R>(\r\n  arraySignal: Signal<T[]>,\r\n  fn: (item: T, index: number) => R\r\n): Signal<R[]> {\r\n  return computed(() => arraySignal().map(fn));\r\n}\r\n\r\n/**\r\n * Sorts an array signal\r\n * @param arraySignal - Array signal\r\n * @param compareFn - Optional comparison function\r\n * @returns Computed signal with sorted array\r\n */\r\nexport function arraySignalSort<T>(\r\n  arraySignal: Signal<T[]>,\r\n  compareFn?: (a: T, b: T) => number\r\n): Signal<T[]> {\r\n  return computed(() => [...arraySignal()].sort(compareFn));\r\n}\r\n\r\n/**\r\n * Finds an item in an array signal\r\n * @param arraySignal - Array signal\r\n * @param predicate - Find predicate\r\n * @returns Computed signal with found item or undefined\r\n */\r\nexport function arraySignalFind<T>(\r\n  arraySignal: Signal<T[]>,\r\n  predicate: (item: T, index: number) => boolean\r\n): Signal<T | undefined> {\r\n  return computed(() => arraySignal().find(predicate));\r\n}\r\n\r\n/**\r\n * Gets the length of an array signal\r\n * @param arraySignal - Array signal\r\n * @returns Computed signal with array length\r\n */\r\nexport function arraySignalLength<T>(\r\n  arraySignal: Signal<T[]>\r\n): Signal<number> {\r\n  return computed(() => arraySignal().length);\r\n}\r\n\r\n/**\r\n * Checks if an array signal is empty\r\n * @param arraySignal - Array signal\r\n * @returns Computed signal indicating if array is empty\r\n */\r\nexport function arraySignalIsEmpty<T>(\r\n  arraySignal: Signal<T[]>\r\n): Signal<boolean> {\r\n  return computed(() => arraySignal().length === 0);\r\n}\r\n","import { Signal, WritableSignal, computed } from '@angular/core';\r\n\r\n/**\r\n * Patches an object signal with partial values\r\n * @param objectSignal - Writable object signal\r\n * @param partial - Partial object to merge\r\n */\r\nexport function patchSignal<T extends object>(\r\n  objectSignal: WritableSignal<T>,\r\n  partial: Partial<T>\r\n): void {\r\n  objectSignal.update(obj => ({ ...obj, ...partial }));\r\n}\r\n\r\n/**\r\n * Picks specific keys from an object signal\r\n * @param objectSignal - Object signal\r\n * @param keys - Keys to pick\r\n * @returns Computed signal with picked keys\r\n */\r\nexport function pickSignal<T extends object, K extends keyof T>(\r\n  objectSignal: Signal<T>,\r\n  ...keys: K[]\r\n): Signal<Pick<T, K>> {\r\n  return computed(() => {\r\n    const obj = objectSignal();\r\n    const result = {} as Pick<T, K>;\r\n    for (const key of keys) {\r\n      result[key] = obj[key];\r\n    }\r\n    return result;\r\n  });\r\n}\r\n\r\n/**\r\n * Omits specific keys from an object signal\r\n * @param objectSignal - Object signal\r\n * @param keys - Keys to omit\r\n * @returns Computed signal with omitted keys\r\n */\r\nexport function omitSignal<T extends object, K extends keyof T>(\r\n  objectSignal: Signal<T>,\r\n  ...keys: K[]\r\n): Signal<Omit<T, K>> {\r\n  return computed(() => {\r\n    const obj = objectSignal();\r\n    const result = { ...obj } as any;\r\n    for (const key of keys) {\r\n      delete result[key];\r\n    }\r\n    return result;\r\n  });\r\n}\r\n\r\n/**\r\n * Gets a property value from an object signal\r\n * @param objectSignal - Object signal\r\n * @param key - Property key\r\n * @returns Computed signal with property value\r\n */\r\nexport function pluckSignal<T extends object, K extends keyof T>(\r\n  objectSignal: Signal<T>,\r\n  key: K\r\n): Signal<T[K]> {\r\n  return computed(() => objectSignal()[key]);\r\n}\r\n\r\n/**\r\n * Gets the keys of an object signal\r\n * @param objectSignal - Object signal\r\n * @returns Computed signal with object keys\r\n */\r\nexport function objectSignalKeys<T extends object>(\r\n  objectSignal: Signal<T>\r\n): Signal<(keyof T)[]> {\r\n  return computed(() => Object.keys(objectSignal()) as (keyof T)[]);\r\n}\r\n\r\n/**\r\n * Gets the values of an object signal\r\n * @param objectSignal - Object signal\r\n * @returns Computed signal with object values\r\n */\r\nexport function objectSignalValues<T extends object>(\r\n  objectSignal: Signal<T>\r\n): Signal<T[keyof T][]> {\r\n  return computed(() => Object.values(objectSignal()) as T[keyof T][]);\r\n}\r\n\r\n/**\r\n * Gets the entries of an object signal\r\n * @param objectSignal - Object signal\r\n * @returns Computed signal with object entries\r\n */\r\nexport function objectSignalEntries<T extends object>(\r\n  objectSignal: Signal<T>\r\n): Signal<[keyof T, T[keyof T]][]> {\r\n  return computed(() => Object.entries(objectSignal()) as [keyof T, T[keyof T]][]);\r\n}\r\n","import { Signal, effect, EffectRef, CreateEffectOptions } from '@angular/core';\r\n\r\n/**\r\n * Creates an effect that runs only when the signal value changes\r\n * @param source - Source signal to watch\r\n * @param fn - Effect function\r\n * @param options - Effect options\r\n * @returns EffectRef\r\n */\r\nexport function watchSignal<T>(\r\n  source: Signal<T>,\r\n  fn: (value: T, previousValue: T | undefined) => void,\r\n  options?: CreateEffectOptions\r\n): EffectRef {\r\n  let previousValue: T | undefined = undefined;\r\n  let isFirst = true;\r\n  \r\n  return effect(() => {\r\n    const value = source();\r\n    if (!isFirst) {\r\n      fn(value, previousValue);\r\n    }\r\n    previousValue = value;\r\n    isFirst = false;\r\n  }, options);\r\n}\r\n\r\n/**\r\n * Creates an effect that runs once when the signal meets a condition\r\n * @param source - Source signal to watch\r\n * @param predicate - Condition to check\r\n * @param fn - Effect function\r\n * @param options - Effect options\r\n * @returns EffectRef\r\n */\r\nexport function watchUntil<T>(\r\n  source: Signal<T>,\r\n  predicate: (value: T) => boolean,\r\n  fn: (value: T) => void,\r\n  options?: CreateEffectOptions\r\n): EffectRef {\r\n  let hasRun = false;\r\n  \r\n  const effectRef = effect(() => {\r\n    if (hasRun) return;\r\n    \r\n    const value = source();\r\n    if (predicate(value)) {\r\n      fn(value);\r\n      hasRun = true;\r\n      effectRef.destroy();\r\n    }\r\n  }, options);\r\n  \r\n  return effectRef;\r\n}\r\n\r\n/**\r\n * Creates a throttled effect\r\n * @param source - Source signal to watch\r\n * @param fn - Effect function\r\n * @param ms - Throttle delay in milliseconds\r\n * @param options - Effect options\r\n * @returns EffectRef\r\n */\r\nexport function throttleEffect<T>(\r\n  source: Signal<T>,\r\n  fn: (value: T) => void,\r\n  ms: number,\r\n  options?: CreateEffectOptions\r\n): EffectRef {\r\n  let lastRun = 0;\r\n  \r\n  return effect(() => {\r\n    const value = source();\r\n    const now = Date.now();\r\n    \r\n    if (now - lastRun >= ms) {\r\n      fn(value);\r\n      lastRun = now;\r\n    }\r\n  }, options);\r\n}\r\n\r\n/**\r\n * Creates a debounced effect\r\n * @param source - Source signal to watch\r\n * @param fn - Effect function\r\n * @param ms - Debounce delay in milliseconds\r\n * @param options - Effect options\r\n * @returns EffectRef\r\n */\r\nexport function debounceEffect<T>(\r\n  source: Signal<T>,\r\n  fn: (value: T) => void,\r\n  ms: number,\r\n  options?: CreateEffectOptions\r\n): EffectRef {\r\n  let timeoutId: any;\r\n  \r\n  return effect(() => {\r\n    const value = source();\r\n    clearTimeout(timeoutId);\r\n    timeoutId = setTimeout(() => fn(value), ms);\r\n  }, options);\r\n}\r\n","/*\r\n * Public API Surface of ng-signals-utils\r\n */\r\n\r\nexport * from './lib/signal-transformations';\r\nexport * from './lib/signal-array-utils';\r\nexport * from './lib/signal-object-utils';\r\nexport * from './lib/signal-effect-utils';\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/fesm2022/sergeydus-ng-signals-utils.mjs

@@ -0,0 +1,303 @@
+import { computed, signal, effect } from '@angular/core';
+
+/**
+ * Maps a signal value to another type
+ * @param source - Source signal
+ * @param fn - Mapping function
+ * @returns Computed signal with mapped value
+ */
+function mapSignal(source, fn) {
+    return computed(() => fn(source()));
+}
+/**
+ * Filters signal updates based on a predicate
+ * @param source - Source signal
+ * @param predicate - Filter predicate
+ * @param initialValue - Initial value to use if predicate fails
+ * @returns Signal that only updates when predicate returns true
+ */
+function filterSignal(source, predicate, initialValue) {
+    const filtered = signal(initialValue, ...(ngDevMode ? [{ debugName: "filtered" }] : []));
+    effect(() => {
+        const value = source();
+        if (predicate(value)) {
+            filtered.set(value);
+        }
+    });
+    return filtered.asReadonly();
+}
+/**
+ * Debounces signal updates
+ * @param source - Source signal
+ * @param ms - Debounce delay in milliseconds
+ * @returns Debounced signal
+ */
+function debounceSignal(source, ms) {
+    const debounced = signal(source(), ...(ngDevMode ? [{ debugName: "debounced" }] : []));
+    let timeoutId;
+    effect(() => {
+        const value = source();
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => {
+            debounced.set(value);
+        }, ms);
+    });
+    return debounced.asReadonly();
+}
+/**
+ * Combines multiple signals into a single signal
+ * @param signals - Array of signals to combine
+ * @returns Combined signal with array of values
+ */
+function combineSignals(signals) {
+    return computed(() => signals.map(s => s()));
+}
+/**
+ * Creates a signal that emits distinct values only
+ * @param source - Source signal
+ * @param compareFn - Optional comparison function
+ * @returns Signal that only updates on distinct values
+ */
+function distinctSignal(source, compareFn = (a, b) => a === b) {
+    const distinct = signal(source(), ...(ngDevMode ? [{ debugName: "distinct" }] : []));
+    let lastValue = source();
+    effect(() => {
+        const value = source();
+        if (!compareFn(value, lastValue)) {
+            lastValue = value;
+            distinct.set(value);
+        }
+    });
+    return distinct.asReadonly();
+}
+
+/**
+ * Pushes an item to an array signal
+ * @param arraySignal - Writable array signal
+ * @param item - Item to push
+ */
+function arraySignalPush(arraySignal, item) {
+    arraySignal.update(arr => [...arr, item]);
+}
+/**
+ * Removes an item from an array signal at the specified index
+ * @param arraySignal - Writable array signal
+ * @param index - Index to remove
+ */
+function arraySignalRemoveAt(arraySignal, index) {
+    arraySignal.update(arr => arr.filter((_, i) => i !== index));
+}
+/**
+ * Filters an array signal
+ * @param arraySignal - Array signal
+ * @param predicate - Filter predicate
+ * @returns Computed signal with filtered array
+ */
+function arraySignalFilter(arraySignal, predicate) {
+    return computed(() => arraySignal().filter(predicate));
+}
+/**
+ * Maps an array signal
+ * @param arraySignal - Array signal
+ * @param fn - Mapping function
+ * @returns Computed signal with mapped array
+ */
+function arraySignalMap(arraySignal, fn) {
+    return computed(() => arraySignal().map(fn));
+}
+/**
+ * Sorts an array signal
+ * @param arraySignal - Array signal
+ * @param compareFn - Optional comparison function
+ * @returns Computed signal with sorted array
+ */
+function arraySignalSort(arraySignal, compareFn) {
+    return computed(() => [...arraySignal()].sort(compareFn));
+}
+/**
+ * Finds an item in an array signal
+ * @param arraySignal - Array signal
+ * @param predicate - Find predicate
+ * @returns Computed signal with found item or undefined
+ */
+function arraySignalFind(arraySignal, predicate) {
+    return computed(() => arraySignal().find(predicate));
+}
+/**
+ * Gets the length of an array signal
+ * @param arraySignal - Array signal
+ * @returns Computed signal with array length
+ */
+function arraySignalLength(arraySignal) {
+    return computed(() => arraySignal().length);
+}
+/**
+ * Checks if an array signal is empty
+ * @param arraySignal - Array signal
+ * @returns Computed signal indicating if array is empty
+ */
+function arraySignalIsEmpty(arraySignal) {
+    return computed(() => arraySignal().length === 0);
+}
+
+/**
+ * Patches an object signal with partial values
+ * @param objectSignal - Writable object signal
+ * @param partial - Partial object to merge
+ */
+function patchSignal(objectSignal, partial) {
+    objectSignal.update(obj => ({ ...obj, ...partial }));
+}
+/**
+ * Picks specific keys from an object signal
+ * @param objectSignal - Object signal
+ * @param keys - Keys to pick
+ * @returns Computed signal with picked keys
+ */
+function pickSignal(objectSignal, ...keys) {
+    return computed(() => {
+        const obj = objectSignal();
+        const result = {};
+        for (const key of keys) {
+            result[key] = obj[key];
+        }
+        return result;
+    });
+}
+/**
+ * Omits specific keys from an object signal
+ * @param objectSignal - Object signal
+ * @param keys - Keys to omit
+ * @returns Computed signal with omitted keys
+ */
+function omitSignal(objectSignal, ...keys) {
+    return computed(() => {
+        const obj = objectSignal();
+        const result = { ...obj };
+        for (const key of keys) {
+            delete result[key];
+        }
+        return result;
+    });
+}
+/**
+ * Gets a property value from an object signal
+ * @param objectSignal - Object signal
+ * @param key - Property key
+ * @returns Computed signal with property value
+ */
+function pluckSignal(objectSignal, key) {
+    return computed(() => objectSignal()[key]);
+}
+/**
+ * Gets the keys of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object keys
+ */
+function objectSignalKeys(objectSignal) {
+    return computed(() => Object.keys(objectSignal()));
+}
+/**
+ * Gets the values of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object values
+ */
+function objectSignalValues(objectSignal) {
+    return computed(() => Object.values(objectSignal()));
+}
+/**
+ * Gets the entries of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object entries
+ */
+function objectSignalEntries(objectSignal) {
+    return computed(() => Object.entries(objectSignal()));
+}
+
+/**
+ * Creates an effect that runs only when the signal value changes
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+function watchSignal(source, fn, options) {
+    let previousValue = undefined;
+    let isFirst = true;
+    return effect(() => {
+        const value = source();
+        if (!isFirst) {
+            fn(value, previousValue);
+        }
+        previousValue = value;
+        isFirst = false;
+    }, options);
+}
+/**
+ * Creates an effect that runs once when the signal meets a condition
+ * @param source - Source signal to watch
+ * @param predicate - Condition to check
+ * @param fn - Effect function
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+function watchUntil(source, predicate, fn, options) {
+    let hasRun = false;
+    const effectRef = effect(() => {
+        if (hasRun)
+            return;
+        const value = source();
+        if (predicate(value)) {
+            fn(value);
+            hasRun = true;
+            effectRef.destroy();
+        }
+    }, options);
+    return effectRef;
+}
+/**
+ * Creates a throttled effect
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param ms - Throttle delay in milliseconds
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+function throttleEffect(source, fn, ms, options) {
+    let lastRun = 0;
+    return effect(() => {
+        const value = source();
+        const now = Date.now();
+        if (now - lastRun >= ms) {
+            fn(value);
+            lastRun = now;
+        }
+    }, options);
+}
+/**
+ * Creates a debounced effect
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param ms - Debounce delay in milliseconds
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+function debounceEffect(source, fn, ms, options) {
+    let timeoutId;
+    return effect(() => {
+        const value = source();
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => fn(value), ms);
+    }, options);
+}
+
+/*
+ * Public API Surface of ng-signals-utils
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { arraySignalFilter, arraySignalFind, arraySignalIsEmpty, arraySignalLength, arraySignalMap, arraySignalPush, arraySignalRemoveAt, arraySignalSort, combineSignals, debounceEffect, debounceSignal, distinctSignal, filterSignal, mapSignal, objectSignalEntries, objectSignalKeys, objectSignalValues, omitSignal, patchSignal, pickSignal, pluckSignal, throttleEffect, watchSignal, watchUntil };
+//# sourceMappingURL=sergeydus-ng-signals-utils.mjs.map

package/fesm2022/sergeydus-ng-signals-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sergeydus-ng-signals-utils.mjs","sources":["../../../projects/ng-signals-utils/src/lib/signal-transformations.ts","../../../projects/ng-signals-utils/src/lib/signal-array-utils.ts","../../../projects/ng-signals-utils/src/lib/signal-object-utils.ts","../../../projects/ng-signals-utils/src/lib/signal-effect-utils.ts","../../../projects/ng-signals-utils/src/public-api.ts","../../../projects/ng-signals-utils/src/sergeydus-ng-signals-utils.ts"],"sourcesContent":["import { Signal, computed, signal, WritableSignal, effect } from '@angular/core';\r\n\r\n/**\r\n * Maps a signal value to another type\r\n * @param source - Source signal\r\n * @param fn - Mapping function\r\n * @returns Computed signal with mapped value\r\n */\r\nexport function mapSignal<T, R>(\r\n  source: Signal<T>,\r\n  fn: (value: T) => R\r\n): Signal<R> {\r\n  return computed(() => fn(source()));\r\n}\r\n\r\n/**\r\n * Filters signal updates based on a predicate\r\n * @param source - Source signal\r\n * @param predicate - Filter predicate\r\n * @param initialValue - Initial value to use if predicate fails\r\n * @returns Signal that only updates when predicate returns true\r\n */\r\nexport function filterSignal<T>(\r\n  source: Signal<T>,\r\n  predicate: (value: T) => boolean,\r\n  initialValue: T\r\n): Signal<T> {\r\n  const filtered = signal(initialValue);\r\n  \r\n  effect(() => {\r\n    const value = source();\r\n    if (predicate(value)) {\r\n      (filtered as WritableSignal<T>).set(value);\r\n    }\r\n  });\r\n  \r\n  return filtered.asReadonly();\r\n}\r\n\r\n/**\r\n * Debounces signal updates\r\n * @param source - Source signal\r\n * @param ms - Debounce delay in milliseconds\r\n * @returns Debounced signal\r\n */\r\nexport function debounceSignal<T>(\r\n  source: Signal<T>,\r\n  ms: number\r\n): Signal<T> {\r\n  const debounced = signal(source());\r\n  let timeoutId: any;\r\n  \r\n  effect(() => {\r\n    const value = source();\r\n    clearTimeout(timeoutId);\r\n    timeoutId = setTimeout(() => {\r\n      (debounced as WritableSignal<T>).set(value);\r\n    }, ms);\r\n  });\r\n  \r\n  return debounced.asReadonly();\r\n}\r\n\r\n/**\r\n * Combines multiple signals into a single signal\r\n * @param signals - Array of signals to combine\r\n * @returns Combined signal with array of values\r\n */\r\nexport function combineSignals<T extends readonly Signal<any>[]>(\r\n  signals: T\r\n): Signal<{ [K in keyof T]: T[K] extends Signal<infer U> ? U : never }> {\r\n  return computed(() => signals.map(s => s()) as any);\r\n}\r\n\r\n/**\r\n * Creates a signal that emits distinct values only\r\n * @param source - Source signal\r\n * @param compareFn - Optional comparison function\r\n * @returns Signal that only updates on distinct values\r\n */\r\nexport function distinctSignal<T>(\r\n  source: Signal<T>,\r\n  compareFn: (a: T, b: T) => boolean = (a, b) => a === b\r\n): Signal<T> {\r\n  const distinct = signal(source());\r\n  let lastValue = source();\r\n  \r\n  effect(() => {\r\n    const value = source();\r\n    if (!compareFn(value, lastValue)) {\r\n      lastValue = value;\r\n      (distinct as WritableSignal<T>).set(value);\r\n    }\r\n  });\r\n  \r\n  return distinct.asReadonly();\r\n}\r\n","import { Signal, WritableSignal, computed } from '@angular/core';\r\n\r\n/**\r\n * Pushes an item to an array signal\r\n * @param arraySignal - Writable array signal\r\n * @param item - Item to push\r\n */\r\nexport function arraySignalPush<T>(\r\n  arraySignal: WritableSignal<T[]>,\r\n  item: T\r\n): void {\r\n  arraySignal.update(arr => [...arr, item]);\r\n}\r\n\r\n/**\r\n * Removes an item from an array signal at the specified index\r\n * @param arraySignal - Writable array signal\r\n * @param index - Index to remove\r\n */\r\nexport function arraySignalRemoveAt<T>(\r\n  arraySignal: WritableSignal<T[]>,\r\n  index: number\r\n): void {\r\n  arraySignal.update(arr => arr.filter((_, i) => i !== index));\r\n}\r\n\r\n/**\r\n * Filters an array signal\r\n * @param arraySignal - Array signal\r\n * @param predicate - Filter predicate\r\n * @returns Computed signal with filtered array\r\n */\r\nexport function arraySignalFilter<T>(\r\n  arraySignal: Signal<T[]>,\r\n  predicate: (item: T, index: number) => boolean\r\n): Signal<T[]> {\r\n  return computed(() => arraySignal().filter(predicate));\r\n}\r\n\r\n/**\r\n * Maps an array signal\r\n * @param arraySignal - Array signal\r\n * @param fn - Mapping function\r\n * @returns Computed signal with mapped array\r\n */\r\nexport function arraySignalMap<T, R>(\r\n  arraySignal: Signal<T[]>,\r\n  fn: (item: T, index: number) => R\r\n): Signal<R[]> {\r\n  return computed(() => arraySignal().map(fn));\r\n}\r\n\r\n/**\r\n * Sorts an array signal\r\n * @param arraySignal - Array signal\r\n * @param compareFn - Optional comparison function\r\n * @returns Computed signal with sorted array\r\n */\r\nexport function arraySignalSort<T>(\r\n  arraySignal: Signal<T[]>,\r\n  compareFn?: (a: T, b: T) => number\r\n): Signal<T[]> {\r\n  return computed(() => [...arraySignal()].sort(compareFn));\r\n}\r\n\r\n/**\r\n * Finds an item in an array signal\r\n * @param arraySignal - Array signal\r\n * @param predicate - Find predicate\r\n * @returns Computed signal with found item or undefined\r\n */\r\nexport function arraySignalFind<T>(\r\n  arraySignal: Signal<T[]>,\r\n  predicate: (item: T, index: number) => boolean\r\n): Signal<T | undefined> {\r\n  return computed(() => arraySignal().find(predicate));\r\n}\r\n\r\n/**\r\n * Gets the length of an array signal\r\n * @param arraySignal - Array signal\r\n * @returns Computed signal with array length\r\n */\r\nexport function arraySignalLength<T>(\r\n  arraySignal: Signal<T[]>\r\n): Signal<number> {\r\n  return computed(() => arraySignal().length);\r\n}\r\n\r\n/**\r\n * Checks if an array signal is empty\r\n * @param arraySignal - Array signal\r\n * @returns Computed signal indicating if array is empty\r\n */\r\nexport function arraySignalIsEmpty<T>(\r\n  arraySignal: Signal<T[]>\r\n): Signal<boolean> {\r\n  return computed(() => arraySignal().length === 0);\r\n}\r\n","import { Signal, WritableSignal, computed } from '@angular/core';\r\n\r\n/**\r\n * Patches an object signal with partial values\r\n * @param objectSignal - Writable object signal\r\n * @param partial - Partial object to merge\r\n */\r\nexport function patchSignal<T extends object>(\r\n  objectSignal: WritableSignal<T>,\r\n  partial: Partial<T>\r\n): void {\r\n  objectSignal.update(obj => ({ ...obj, ...partial }));\r\n}\r\n\r\n/**\r\n * Picks specific keys from an object signal\r\n * @param objectSignal - Object signal\r\n * @param keys - Keys to pick\r\n * @returns Computed signal with picked keys\r\n */\r\nexport function pickSignal<T extends object, K extends keyof T>(\r\n  objectSignal: Signal<T>,\r\n  ...keys: K[]\r\n): Signal<Pick<T, K>> {\r\n  return computed(() => {\r\n    const obj = objectSignal();\r\n    const result = {} as Pick<T, K>;\r\n    for (const key of keys) {\r\n      result[key] = obj[key];\r\n    }\r\n    return result;\r\n  });\r\n}\r\n\r\n/**\r\n * Omits specific keys from an object signal\r\n * @param objectSignal - Object signal\r\n * @param keys - Keys to omit\r\n * @returns Computed signal with omitted keys\r\n */\r\nexport function omitSignal<T extends object, K extends keyof T>(\r\n  objectSignal: Signal<T>,\r\n  ...keys: K[]\r\n): Signal<Omit<T, K>> {\r\n  return computed(() => {\r\n    const obj = objectSignal();\r\n    const result = { ...obj } as any;\r\n    for (const key of keys) {\r\n      delete result[key];\r\n    }\r\n    return result;\r\n  });\r\n}\r\n\r\n/**\r\n * Gets a property value from an object signal\r\n * @param objectSignal - Object signal\r\n * @param key - Property key\r\n * @returns Computed signal with property value\r\n */\r\nexport function pluckSignal<T extends object, K extends keyof T>(\r\n  objectSignal: Signal<T>,\r\n  key: K\r\n): Signal<T[K]> {\r\n  return computed(() => objectSignal()[key]);\r\n}\r\n\r\n/**\r\n * Gets the keys of an object signal\r\n * @param objectSignal - Object signal\r\n * @returns Computed signal with object keys\r\n */\r\nexport function objectSignalKeys<T extends object>(\r\n  objectSignal: Signal<T>\r\n): Signal<(keyof T)[]> {\r\n  return computed(() => Object.keys(objectSignal()) as (keyof T)[]);\r\n}\r\n\r\n/**\r\n * Gets the values of an object signal\r\n * @param objectSignal - Object signal\r\n * @returns Computed signal with object values\r\n */\r\nexport function objectSignalValues<T extends object>(\r\n  objectSignal: Signal<T>\r\n): Signal<T[keyof T][]> {\r\n  return computed(() => Object.values(objectSignal()) as T[keyof T][]);\r\n}\r\n\r\n/**\r\n * Gets the entries of an object signal\r\n * @param objectSignal - Object signal\r\n * @returns Computed signal with object entries\r\n */\r\nexport function objectSignalEntries<T extends object>(\r\n  objectSignal: Signal<T>\r\n): Signal<[keyof T, T[keyof T]][]> {\r\n  return computed(() => Object.entries(objectSignal()) as [keyof T, T[keyof T]][]);\r\n}\r\n","import { Signal, effect, EffectRef, CreateEffectOptions } from '@angular/core';\r\n\r\n/**\r\n * Creates an effect that runs only when the signal value changes\r\n * @param source - Source signal to watch\r\n * @param fn - Effect function\r\n * @param options - Effect options\r\n * @returns EffectRef\r\n */\r\nexport function watchSignal<T>(\r\n  source: Signal<T>,\r\n  fn: (value: T, previousValue: T | undefined) => void,\r\n  options?: CreateEffectOptions\r\n): EffectRef {\r\n  let previousValue: T | undefined = undefined;\r\n  let isFirst = true;\r\n  \r\n  return effect(() => {\r\n    const value = source();\r\n    if (!isFirst) {\r\n      fn(value, previousValue);\r\n    }\r\n    previousValue = value;\r\n    isFirst = false;\r\n  }, options);\r\n}\r\n\r\n/**\r\n * Creates an effect that runs once when the signal meets a condition\r\n * @param source - Source signal to watch\r\n * @param predicate - Condition to check\r\n * @param fn - Effect function\r\n * @param options - Effect options\r\n * @returns EffectRef\r\n */\r\nexport function watchUntil<T>(\r\n  source: Signal<T>,\r\n  predicate: (value: T) => boolean,\r\n  fn: (value: T) => void,\r\n  options?: CreateEffectOptions\r\n): EffectRef {\r\n  let hasRun = false;\r\n  \r\n  const effectRef = effect(() => {\r\n    if (hasRun) return;\r\n    \r\n    const value = source();\r\n    if (predicate(value)) {\r\n      fn(value);\r\n      hasRun = true;\r\n      effectRef.destroy();\r\n    }\r\n  }, options);\r\n  \r\n  return effectRef;\r\n}\r\n\r\n/**\r\n * Creates a throttled effect\r\n * @param source - Source signal to watch\r\n * @param fn - Effect function\r\n * @param ms - Throttle delay in milliseconds\r\n * @param options - Effect options\r\n * @returns EffectRef\r\n */\r\nexport function throttleEffect<T>(\r\n  source: Signal<T>,\r\n  fn: (value: T) => void,\r\n  ms: number,\r\n  options?: CreateEffectOptions\r\n): EffectRef {\r\n  let lastRun = 0;\r\n  \r\n  return effect(() => {\r\n    const value = source();\r\n    const now = Date.now();\r\n    \r\n    if (now - lastRun >= ms) {\r\n      fn(value);\r\n      lastRun = now;\r\n    }\r\n  }, options);\r\n}\r\n\r\n/**\r\n * Creates a debounced effect\r\n * @param source - Source signal to watch\r\n * @param fn - Effect function\r\n * @param ms - Debounce delay in milliseconds\r\n * @param options - Effect options\r\n * @returns EffectRef\r\n */\r\nexport function debounceEffect<T>(\r\n  source: Signal<T>,\r\n  fn: (value: T) => void,\r\n  ms: number,\r\n  options?: CreateEffectOptions\r\n): EffectRef {\r\n  let timeoutId: any;\r\n  \r\n  return effect(() => {\r\n    const value = source();\r\n    clearTimeout(timeoutId);\r\n    timeoutId = setTimeout(() => fn(value), ms);\r\n  }, options);\r\n}\r\n","/*\r\n * Public API Surface of ng-signals-utils\r\n */\r\n\r\nexport * from './lib/signal-transformations';\r\nexport * from './lib/signal-array-utils';\r\nexport * from './lib/signal-object-utils';\r\nexport * from './lib/signal-effect-utils';\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@sergeydus/ng-signals-utils",
+  "version": "0.0.1",
+  "description": "Utility functions for Angular signals",
+  "keywords": [
+    "angular",
+    "signals",
+    "utilities",
+    "reactive"
+  ],
+  "peerDependencies": {
+    "@angular/common": "^17.0.0 || ^18.0.0",
+    "@angular/core": "^17.0.0 || ^18.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/sergeydus-ng-signals-utils.mjs",
+  "typings": "types/sergeydus-ng-signals-utils.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/sergeydus-ng-signals-utils.d.ts",
+      "default": "./fesm2022/sergeydus-ng-signals-utils.mjs"
+    }
+  }
+}

package/types/ng-signals-utils.d.ts

@@ -0,0 +1,176 @@
+import { Signal, WritableSignal, CreateEffectOptions, EffectRef } from '@angular/core';
+
+/**
+ * Maps a signal value to another type
+ * @param source - Source signal
+ * @param fn - Mapping function
+ * @returns Computed signal with mapped value
+ */
+declare function mapSignal<T, R>(source: Signal<T>, fn: (value: T) => R): Signal<R>;
+/**
+ * Filters signal updates based on a predicate
+ * @param source - Source signal
+ * @param predicate - Filter predicate
+ * @param initialValue - Initial value to use if predicate fails
+ * @returns Signal that only updates when predicate returns true
+ */
+declare function filterSignal<T>(source: Signal<T>, predicate: (value: T) => boolean, initialValue: T): Signal<T>;
+/**
+ * Debounces signal updates
+ * @param source - Source signal
+ * @param ms - Debounce delay in milliseconds
+ * @returns Debounced signal
+ */
+declare function debounceSignal<T>(source: Signal<T>, ms: number): Signal<T>;
+/**
+ * Combines multiple signals into a single signal
+ * @param signals - Array of signals to combine
+ * @returns Combined signal with array of values
+ */
+declare function combineSignals<T extends readonly Signal<any>[]>(signals: T): Signal<{
+    [K in keyof T]: T[K] extends Signal<infer U> ? U : never;
+}>;
+/**
+ * Creates a signal that emits distinct values only
+ * @param source - Source signal
+ * @param compareFn - Optional comparison function
+ * @returns Signal that only updates on distinct values
+ */
+declare function distinctSignal<T>(source: Signal<T>, compareFn?: (a: T, b: T) => boolean): Signal<T>;
+
+/**
+ * Pushes an item to an array signal
+ * @param arraySignal - Writable array signal
+ * @param item - Item to push
+ */
+declare function arraySignalPush<T>(arraySignal: WritableSignal<T[]>, item: T): void;
+/**
+ * Removes an item from an array signal at the specified index
+ * @param arraySignal - Writable array signal
+ * @param index - Index to remove
+ */
+declare function arraySignalRemoveAt<T>(arraySignal: WritableSignal<T[]>, index: number): void;
+/**
+ * Filters an array signal
+ * @param arraySignal - Array signal
+ * @param predicate - Filter predicate
+ * @returns Computed signal with filtered array
+ */
+declare function arraySignalFilter<T>(arraySignal: Signal<T[]>, predicate: (item: T, index: number) => boolean): Signal<T[]>;
+/**
+ * Maps an array signal
+ * @param arraySignal - Array signal
+ * @param fn - Mapping function
+ * @returns Computed signal with mapped array
+ */
+declare function arraySignalMap<T, R>(arraySignal: Signal<T[]>, fn: (item: T, index: number) => R): Signal<R[]>;
+/**
+ * Sorts an array signal
+ * @param arraySignal - Array signal
+ * @param compareFn - Optional comparison function
+ * @returns Computed signal with sorted array
+ */
+declare function arraySignalSort<T>(arraySignal: Signal<T[]>, compareFn?: (a: T, b: T) => number): Signal<T[]>;
+/**
+ * Finds an item in an array signal
+ * @param arraySignal - Array signal
+ * @param predicate - Find predicate
+ * @returns Computed signal with found item or undefined
+ */
+declare function arraySignalFind<T>(arraySignal: Signal<T[]>, predicate: (item: T, index: number) => boolean): Signal<T | undefined>;
+/**
+ * Gets the length of an array signal
+ * @param arraySignal - Array signal
+ * @returns Computed signal with array length
+ */
+declare function arraySignalLength<T>(arraySignal: Signal<T[]>): Signal<number>;
+/**
+ * Checks if an array signal is empty
+ * @param arraySignal - Array signal
+ * @returns Computed signal indicating if array is empty
+ */
+declare function arraySignalIsEmpty<T>(arraySignal: Signal<T[]>): Signal<boolean>;
+
+/**
+ * Patches an object signal with partial values
+ * @param objectSignal - Writable object signal
+ * @param partial - Partial object to merge
+ */
+declare function patchSignal<T extends object>(objectSignal: WritableSignal<T>, partial: Partial<T>): void;
+/**
+ * Picks specific keys from an object signal
+ * @param objectSignal - Object signal
+ * @param keys - Keys to pick
+ * @returns Computed signal with picked keys
+ */
+declare function pickSignal<T extends object, K extends keyof T>(objectSignal: Signal<T>, ...keys: K[]): Signal<Pick<T, K>>;
+/**
+ * Omits specific keys from an object signal
+ * @param objectSignal - Object signal
+ * @param keys - Keys to omit
+ * @returns Computed signal with omitted keys
+ */
+declare function omitSignal<T extends object, K extends keyof T>(objectSignal: Signal<T>, ...keys: K[]): Signal<Omit<T, K>>;
+/**
+ * Gets a property value from an object signal
+ * @param objectSignal - Object signal
+ * @param key - Property key
+ * @returns Computed signal with property value
+ */
+declare function pluckSignal<T extends object, K extends keyof T>(objectSignal: Signal<T>, key: K): Signal<T[K]>;
+/**
+ * Gets the keys of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object keys
+ */
+declare function objectSignalKeys<T extends object>(objectSignal: Signal<T>): Signal<(keyof T)[]>;
+/**
+ * Gets the values of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object values
+ */
+declare function objectSignalValues<T extends object>(objectSignal: Signal<T>): Signal<T[keyof T][]>;
+/**
+ * Gets the entries of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object entries
+ */
+declare function objectSignalEntries<T extends object>(objectSignal: Signal<T>): Signal<[keyof T, T[keyof T]][]>;
+
+/**
+ * Creates an effect that runs only when the signal value changes
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+declare function watchSignal<T>(source: Signal<T>, fn: (value: T, previousValue: T | undefined) => void, options?: CreateEffectOptions): EffectRef;
+/**
+ * Creates an effect that runs once when the signal meets a condition
+ * @param source - Source signal to watch
+ * @param predicate - Condition to check
+ * @param fn - Effect function
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+declare function watchUntil<T>(source: Signal<T>, predicate: (value: T) => boolean, fn: (value: T) => void, options?: CreateEffectOptions): EffectRef;
+/**
+ * Creates a throttled effect
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param ms - Throttle delay in milliseconds
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+declare function throttleEffect<T>(source: Signal<T>, fn: (value: T) => void, ms: number, options?: CreateEffectOptions): EffectRef;
+/**
+ * Creates a debounced effect
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param ms - Debounce delay in milliseconds
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+declare function debounceEffect<T>(source: Signal<T>, fn: (value: T) => void, ms: number, options?: CreateEffectOptions): EffectRef;
+
+export { arraySignalFilter, arraySignalFind, arraySignalIsEmpty, arraySignalLength, arraySignalMap, arraySignalPush, arraySignalRemoveAt, arraySignalSort, combineSignals, debounceEffect, debounceSignal, distinctSignal, filterSignal, mapSignal, objectSignalEntries, objectSignalKeys, objectSignalValues, omitSignal, patchSignal, pickSignal, pluckSignal, throttleEffect, watchSignal, watchUntil };

package/types/sergeydus-ng-signals-utils.d.ts

@@ -0,0 +1,176 @@
+import { Signal, WritableSignal, CreateEffectOptions, EffectRef } from '@angular/core';
+
+/**
+ * Maps a signal value to another type
+ * @param source - Source signal
+ * @param fn - Mapping function
+ * @returns Computed signal with mapped value
+ */
+declare function mapSignal<T, R>(source: Signal<T>, fn: (value: T) => R): Signal<R>;
+/**
+ * Filters signal updates based on a predicate
+ * @param source - Source signal
+ * @param predicate - Filter predicate
+ * @param initialValue - Initial value to use if predicate fails
+ * @returns Signal that only updates when predicate returns true
+ */
+declare function filterSignal<T>(source: Signal<T>, predicate: (value: T) => boolean, initialValue: T): Signal<T>;
+/**
+ * Debounces signal updates
+ * @param source - Source signal
+ * @param ms - Debounce delay in milliseconds
+ * @returns Debounced signal
+ */
+declare function debounceSignal<T>(source: Signal<T>, ms: number): Signal<T>;
+/**
+ * Combines multiple signals into a single signal
+ * @param signals - Array of signals to combine
+ * @returns Combined signal with array of values
+ */
+declare function combineSignals<T extends readonly Signal<any>[]>(signals: T): Signal<{
+    [K in keyof T]: T[K] extends Signal<infer U> ? U : never;
+}>;
+/**
+ * Creates a signal that emits distinct values only
+ * @param source - Source signal
+ * @param compareFn - Optional comparison function
+ * @returns Signal that only updates on distinct values
+ */
+declare function distinctSignal<T>(source: Signal<T>, compareFn?: (a: T, b: T) => boolean): Signal<T>;
+
+/**
+ * Pushes an item to an array signal
+ * @param arraySignal - Writable array signal
+ * @param item - Item to push
+ */
+declare function arraySignalPush<T>(arraySignal: WritableSignal<T[]>, item: T): void;
+/**
+ * Removes an item from an array signal at the specified index
+ * @param arraySignal - Writable array signal
+ * @param index - Index to remove
+ */
+declare function arraySignalRemoveAt<T>(arraySignal: WritableSignal<T[]>, index: number): void;
+/**
+ * Filters an array signal
+ * @param arraySignal - Array signal
+ * @param predicate - Filter predicate
+ * @returns Computed signal with filtered array
+ */
+declare function arraySignalFilter<T>(arraySignal: Signal<T[]>, predicate: (item: T, index: number) => boolean): Signal<T[]>;
+/**
+ * Maps an array signal
+ * @param arraySignal - Array signal
+ * @param fn - Mapping function
+ * @returns Computed signal with mapped array
+ */
+declare function arraySignalMap<T, R>(arraySignal: Signal<T[]>, fn: (item: T, index: number) => R): Signal<R[]>;
+/**
+ * Sorts an array signal
+ * @param arraySignal - Array signal
+ * @param compareFn - Optional comparison function
+ * @returns Computed signal with sorted array
+ */
+declare function arraySignalSort<T>(arraySignal: Signal<T[]>, compareFn?: (a: T, b: T) => number): Signal<T[]>;
+/**
+ * Finds an item in an array signal
+ * @param arraySignal - Array signal
+ * @param predicate - Find predicate
+ * @returns Computed signal with found item or undefined
+ */
+declare function arraySignalFind<T>(arraySignal: Signal<T[]>, predicate: (item: T, index: number) => boolean): Signal<T | undefined>;
+/**
+ * Gets the length of an array signal
+ * @param arraySignal - Array signal
+ * @returns Computed signal with array length
+ */
+declare function arraySignalLength<T>(arraySignal: Signal<T[]>): Signal<number>;
+/**
+ * Checks if an array signal is empty
+ * @param arraySignal - Array signal
+ * @returns Computed signal indicating if array is empty
+ */
+declare function arraySignalIsEmpty<T>(arraySignal: Signal<T[]>): Signal<boolean>;
+
+/**
+ * Patches an object signal with partial values
+ * @param objectSignal - Writable object signal
+ * @param partial - Partial object to merge
+ */
+declare function patchSignal<T extends object>(objectSignal: WritableSignal<T>, partial: Partial<T>): void;
+/**
+ * Picks specific keys from an object signal
+ * @param objectSignal - Object signal
+ * @param keys - Keys to pick
+ * @returns Computed signal with picked keys
+ */
+declare function pickSignal<T extends object, K extends keyof T>(objectSignal: Signal<T>, ...keys: K[]): Signal<Pick<T, K>>;
+/**
+ * Omits specific keys from an object signal
+ * @param objectSignal - Object signal
+ * @param keys - Keys to omit
+ * @returns Computed signal with omitted keys
+ */
+declare function omitSignal<T extends object, K extends keyof T>(objectSignal: Signal<T>, ...keys: K[]): Signal<Omit<T, K>>;
+/**
+ * Gets a property value from an object signal
+ * @param objectSignal - Object signal
+ * @param key - Property key
+ * @returns Computed signal with property value
+ */
+declare function pluckSignal<T extends object, K extends keyof T>(objectSignal: Signal<T>, key: K): Signal<T[K]>;
+/**
+ * Gets the keys of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object keys
+ */
+declare function objectSignalKeys<T extends object>(objectSignal: Signal<T>): Signal<(keyof T)[]>;
+/**
+ * Gets the values of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object values
+ */
+declare function objectSignalValues<T extends object>(objectSignal: Signal<T>): Signal<T[keyof T][]>;
+/**
+ * Gets the entries of an object signal
+ * @param objectSignal - Object signal
+ * @returns Computed signal with object entries
+ */
+declare function objectSignalEntries<T extends object>(objectSignal: Signal<T>): Signal<[keyof T, T[keyof T]][]>;
+
+/**
+ * Creates an effect that runs only when the signal value changes
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+declare function watchSignal<T>(source: Signal<T>, fn: (value: T, previousValue: T | undefined) => void, options?: CreateEffectOptions): EffectRef;
+/**
+ * Creates an effect that runs once when the signal meets a condition
+ * @param source - Source signal to watch
+ * @param predicate - Condition to check
+ * @param fn - Effect function
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+declare function watchUntil<T>(source: Signal<T>, predicate: (value: T) => boolean, fn: (value: T) => void, options?: CreateEffectOptions): EffectRef;
+/**
+ * Creates a throttled effect
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param ms - Throttle delay in milliseconds
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+declare function throttleEffect<T>(source: Signal<T>, fn: (value: T) => void, ms: number, options?: CreateEffectOptions): EffectRef;
+/**
+ * Creates a debounced effect
+ * @param source - Source signal to watch
+ * @param fn - Effect function
+ * @param ms - Debounce delay in milliseconds
+ * @param options - Effect options
+ * @returns EffectRef
+ */
+declare function debounceEffect<T>(source: Signal<T>, fn: (value: T) => void, ms: number, options?: CreateEffectOptions): EffectRef;
+
+export { arraySignalFilter, arraySignalFind, arraySignalIsEmpty, arraySignalLength, arraySignalMap, arraySignalPush, arraySignalRemoveAt, arraySignalSort, combineSignals, debounceEffect, debounceSignal, distinctSignal, filterSignal, mapSignal, objectSignalEntries, objectSignalKeys, objectSignalValues, omitSignal, patchSignal, pickSignal, pluckSignal, throttleEffect, watchSignal, watchUntil };