@alaarab/ogrid-angular 2.0.2 → 2.0.4

package/dist/types/utils/debounce.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Debounce utilities for Angular using signals.
+ * Provides functional parity with React's useDebounce and useDebouncedCallback.
+ */
+import { type Signal } from '@angular/core';
+/**
+ * Creates a debounced signal that updates after the specified delay when the source value changes.
+ *
+ * @param source - The signal to debounce
+ * @param delayMs - Delay in milliseconds
+ * @returns A signal containing the debounced value
+ *
+ * @example
+ * ```typescript
+ * const searchQuery = signal('');
+ * const debouncedQuery = createDebouncedSignal(searchQuery, 300);
+ *
+ * effect(() => {
+ *   console.log('Debounced search:', debouncedQuery());
+ * });
+ * ```
+ */
+export declare function createDebouncedSignal<T>(source: Signal<T>, delayMs: number): Signal<T>;
+/**
+ * Creates a debounced function that delays invoking the provided function
+ * until after `delayMs` milliseconds have elapsed since the last time it was invoked.
+ *
+ * @param fn - The function to debounce
+ * @param delayMs - Delay in milliseconds
+ * @returns A debounced version of the function
+ *
+ * @example
+ * ```typescript
+ * const saveData = (value: string) => {
+ *   console.log('Saving:', value);
+ * };
+ *
+ * const debouncedSave = createDebouncedCallback(saveData, 500);
+ *
+ * // Multiple rapid calls will only trigger once after 500ms
+ * debouncedSave('hello');
+ * debouncedSave('world');  // Only this will execute after 500ms
+ * ```
+ */
+export declare function createDebouncedCallback<T extends (...args: unknown[]) => void>(fn: T, delayMs: number): T;
+/**
+ * Simple debounce function (non-Angular-specific, can be used anywhere).
+ * Returns a debounced version of the provided function.
+ *
+ * @param fn - The function to debounce
+ * @param delayMs - Delay in milliseconds
+ * @returns A debounced version of the function with a `cancel()` method
+ *
+ * @example
+ * ```typescript
+ * const handleResize = debounce(() => {
+ *   console.log('Window resized');
+ * }, 200);
+ *
+ * window.addEventListener('resize', handleResize);
+ *
+ * // Later, cancel pending execution
+ * handleResize.cancel();
+ * ```
+ */
+export declare function debounce<T extends (...args: unknown[]) => void>(fn: T, delayMs: number): T & {
+    cancel: () => void;
+};

package/dist/types/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared utilities for Angular DataGridTable view layer.
+ */
+export type { HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, } from './dataGridViewModel';
+export { getHeaderFilterConfig, getCellRenderDescriptor, resolveCellDisplayContent, resolveCellStyle, } from './dataGridViewModel';
+export { createDebouncedSignal, createDebouncedCallback, debounce, } from './debounce';
+export { createLatestRef, createLatestCallback, } from './latestRef';

package/dist/types/utils/latestRef.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Latest ref utility for Angular using signals.
+ * Provides functional parity with React's useLatestRef.
+ */
+import { type Signal } from '@angular/core';
+/**
+ * Creates a stable wrapper function that always calls the latest version of the provided function.
+ * Useful for event handlers and callbacks where you want a stable reference but need to call
+ * the latest implementation.
+ *
+ * @param fn - Signal containing the function to wrap
+ * @returns A stable function that always invokes the latest version
+ *
+ * @example
+ * ```typescript
+ * class MyService {
+ *   readonly onSave = signal<(value: string) => void>((val) => console.log('Default:', val));
+ *   readonly stableOnSave = createLatestCallback(this.onSave);
+ *
+ *   constructor() {
+ *     // Setup event listener with stable reference
+ *     effect((onCleanup) => {
+ *       // stableOnSave never changes, so this effect only runs once
+ *       const callback = () => this.stableOnSave('data');
+ *       window.addEventListener('click', callback);
+ *       onCleanup(() => window.removeEventListener('click', callback));
+ *     });
+ *   }
+ *
+ *   updateHandler(newFn: (value: string) => void) {
+ *     // Even though we change the function, the callback reference stays stable
+ *     this.onSave.set(newFn);
+ *   }
+ * }
+ * ```
+ */
+export declare function createLatestCallback<T extends (...args: unknown[]) => unknown>(fn: Signal<T>): T;
+/**
+ * Alias for createLatestCallback for consistency with React/Vue naming.
+ * @deprecated Use createLatestCallback instead
+ */
+export declare const createLatestRef: typeof createLatestCallback;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alaarab/ogrid-angular",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "OGrid Angular – Angular services, signals, and headless components for OGrid data grids.",
   "main": "dist/esm/index.js",
   "module": "dist/esm/index.js",
@@ -22,7 +22,7 @@
   "files": ["dist", "README.md", "LICENSE"],
   "engines": { "node": ">=18" },
   "dependencies": {
-    "@alaarab/ogrid-core": "2.0.2"
+    "@alaarab/ogrid-core": "2.0.4"
   },
   "peerDependencies": {
     "@angular/core": "^21.0.0",