const results = data.filter(item => item.age >= 18 && item.status === 'active' && (item.role === 'admin' || item.role === 'moderator') && item.email.endsWith('@company.com') && item.createdAt >= thirtyDaysAgo );

const results = filter(data, { age: { $gte: 18 }, status: 'active', role: ['admin', 'moderator'], email: { $endsWith: '@company.com' }, createdAt: { $gte: thirtyDaysAgo } });

import { filter } from '@mcabreradev/filter'; const users = [ { name: 'Alice', age: 30, city: 'Berlin', active: true }, { name: 'Bob', age: 25, city: 'London', active: false }, { name: 'Charlie', age: 35, city: 'Berlin', active: true } ]; // Simple string search const berlinUsers = filter(users, 'Berlin'); // → [{ name: 'Alice', ... }, { name: 'Charlie', ... }] // Object-based filtering const activeBerlinUsers = filter(users, { city: 'Berlin', active: true }); // → [{ name: 'Alice', ... }] // MongoDB-style operators const adults = filter(users, { age: { $gte: 18 } }); // → All users (all are 18+) // That's it! You're filtering like a pro.

// String matching - searches all properties filter(products, 'Laptop'); // Object matching - AND logic filter(products, { category: 'Electronics', price: { $lt: 1000 } }); // Wildcard patterns (SQL-like) filter(users, '%alice%'); // Contains 'alice' filter(users, 'Al%'); // Starts with 'Al' filter(users, '%son'); // Ends with 'son'

// Comparison operators filter(products, { price: { $gte: 100, $lte: 500 } }); // Array operators filter(products, { category: { $in: ['Electronics', 'Books'] }, tags: { $contains: 'sale' } }); // String operators filter(users, { email: { $endsWith: '@company.com' }, name: { $startsWith: 'John' } }); // Logical operators filter(products, { $and: [ { inStock: true }, { $or: [ { rating: { $gte: 4.5 } }, { price: { $lt: 50 } } ] } ] });

// Clean array syntax - no $in needed! filter(products, { category: ['Electronics', 'Books'] }); // Equivalent to: { category: { $in: ['Electronics', 'Books'] } } // Multiple properties filter(users, { city: ['Berlin', 'Paris'], role: ['admin', 'moderator'] });

import { filter, type GeoPoint } from '@mcabreradev/filter'; const userLocation: GeoPoint = { lat: 52.52, lng: 13.405 }; // Find restaurants within 5km filter(restaurants, { location: { $near: { center: userLocation, maxDistanceMeters: 5000 } }, rating: { $gte: 4.5 } });

// Events in next 7 days filter(events, { date: { $upcoming: { days: 7 } } }); // Recent events (last 24 hours) filter(events, { date: { $recent: { hours: 24 } } }); // Weekday events during business hours filter(events, { date: { $dayOfWeek: [1, 2, 3, 4, 5] }, startTime: { $timeOfDay: { start: 9, end: 17 } } }); // Users who logged in recently (last 7 days) filter(users, { lastLogin: { $recent: { days: 7 } } }); // Upcoming meetings in next 2 hours filter(meetings, { startTime: { $upcoming: { hours: 2 } } }); // Weekend events only filter(events, { date: { $isWeekend: true } }); // Calculate age (users over 18) filter(users, { birthDate: { $age: { $gte: 18 } } }); // Events before a specific date filter(events, { date: { $isBefore: new Date('2025-12-31') } });

// Enable caching for repeated queries const results = filter(largeDataset, expression, { enableCache: true, orderBy: { field: 'price', direction: 'desc' }, limit: 100 }); // Lazy evaluation for large datasets import { filterFirst } from '@mcabreradev/filter'; const first10 = filterFirst(users, { premium: true }, 10);

interface Product { id: number; name: string; price: number; category: string; brand: string; rating: number; inStock: boolean; tags: string[]; } const products: Product[] = [...]; // Find affordable, highly-rated electronics in stock const affordableElectronics = filter(products, { category: 'Electronics', price: { $lte: 1000 }, rating: { $gte: 4.5 }, inStock: true }); // Search with multiple filters const searchResults = filter(products, { name: { $contains: 'laptop' }, brand: { $in: ['Apple', 'Dell', 'HP'] }, price: { $gte: 500, $lte: 2000 } }); // Sort results const sortedProducts = filter(products, { category: 'Electronics', inStock: true }, { orderBy: [ { field: 'price', direction: 'asc' }, { field: 'rating', direction: 'desc' } ], limit: 20 });

import { useFilter } from '@mcabreradev/filter/react'; function UserList() { const { filtered, isFiltering } = useFilter(users, { active: true }); return <div>{filtered.map(u => <User key={u.id} {...u} />)}</div>; }

import { FilterService } from '@mcabreradev/filter/angular'; @Component({ providers: [FilterService], template: `  @for (user of filterService.filtered(); track user.id) {  <div>{{ user.name }}</div>  }  ` }) export class UserListComponent { filterService = inject(FilterService<User>); }

interface Product { name: string; price: number; tags: string[]; } filter<Product>(products, { price: { }, // Autocomplete: $gt, $gte, $lt, $lte, $eq, $ne name: { }, // Autocomplete: $startsWith, $endsWith, $contains, $regex tags: { } // Autocomplete: $in, $nin, $contains, $size });

filter(data, expression, { caseSensitive: false, // Case-sensitive string matching maxDepth: 3, // Max depth for nested objects enableCache: true, // Enable result caching (530x faster) orderBy: 'price', // Sort results limit: 10, // Limit number of results debug: true // Visual debugging mode });

import { filterLazy, filterFirst, filterExists, filterCount } from '@mcabreradev/filter'; // Process items on-demand const filtered = filterLazy(millionRecords, { active: true }); for (const item of filtered) { process(item); if (shouldStop) break; // Early exit } // Find first N matches const first10 = filterFirst(users, { premium: true }, 10); // Check existence without processing all items const hasAdmin = filterExists(users, { role: 'admin' }); // Count matches const activeCount = filterCount(users, { active: true });

// First call - processes data const results = filter(largeDataset, { age: { $gte: 18 } }, { enableCache: true }); // Second call - returns cached result instantly const sameResults = filter(largeDataset, { age: { $gte: 18 } }, { enableCache: true });

filter(users, { city: 'Berlin' }, { debug: true }); // Console output: // ┌─ Filter Debug Tree // │ Expression: {"city":"Berlin"} // │ Matched: 3/10 (30.0%) // │ Execution time: 0.42ms // └─ ✓ city = "Berlin"

// ✅ Fast: Operators with early exit filter(data, { age: { $gte: 18 } }); // ✅ Fast with caching for repeated queries filter(largeData, expression, { enableCache: true }); // ✅ Fast with lazy evaluation for large datasets const result = filterFirst(millionRecords, { active: true }, 100);

// ✅ All v3.x syntax still works filter(data, 'string'); filter(data, { prop: 'value' }); filter(data, (item) => true); filter(data, '%pattern%'); // ✅ New in v5.x filter(data, { age: { $gte: 18 } }); filter(data, expression, { enableCache: true });