Feat/add new feats (#65)

* feat: Implement filtering and pagination services for Angular, Preact, and SolidJS

- Added FilterService, DebouncedFilterService, and PaginatedFilterService for Angular.
- Created corresponding tests for filtering and pagination functionalities in Angular.
- Introduced useFilter, useFilteredState, useDebouncedFilter, and usePaginatedFilter hooks for Preact.
- Developed tests for Preact filtering and pagination hooks.
- Implemented useFilter, useDebouncedFilter, and usePaginatedFilter hooks for SolidJS.
- Added tests for SolidJS filtering and pagination hooks.
- Enhanced operator exports in the operators module for better usability.

* feat: Enhance build process and optimize package size by adding integration options and cleanup scripts

* feat: Add orderBy functionality to filter, enabling sorting of results by specified fields
feat: Implement sorting utilities and integrate with filter function

feat: Enhance API documentation to include orderBy options and examples
test: Add comprehensive tests for orderBy functionality in filter
refactor: Update memoization to support orderBy in cache key generation
refactor: Improve validation schemas to include orderBy field structures

* feat: Add support for Angular, SolidJS, and Preact frameworks in documentation and API

- Updated framework integrations in the documentation to include Angular, SolidJS, and Preact.
- Added new sections for Angular integration, including FilterService, DebouncedFilterService, and PaginatedFilterService.
- Introduced SolidJS and Preact integration examples with corresponding hooks.
- Updated version number in the framework guide to 5.7.0.
- Enhanced filtering options with `orderBy` and `limit` features in the configuration guide.
- Implemented `limit` functionality in the core filter logic to restrict the number of results returned.
- Updated operator processing to handle array operations more effectively.
- Added TypeScript support for new configuration options.

* feat: Update Angular integration with new FilterService, DebouncedFilterService, and PaginatedFilterService; enhance documentation and testing

* feat: Refactor filtering logic and enhance utility functions for improved performance and readability; integrate new validation and post-processing methods

* feat(geospatial): add geospatial operators for evaluating proximity, bounding boxes, and polygons

feat(logical): implement logical operators with comprehensive tests

feat(string): introduce string operators with support for regex and case sensitivity

refactor: reorganize operator imports for better structure

test(logical): add extensive tests for logical operators including nested scenarios

test(string): create tests for string operators covering various edge cases and combinations

* feat(tests): add comprehensive tests for operator exports and structure validation

* feat: add performance monitoring utility

- Introduced PerformanceMonitor class for tracking operation durations and metrics.
- Added methods for starting, tracking, and retrieving performance metrics.
- Implemented global performance monitor instance and utility functions for easy access.
- Added decorator for performance tracking on methods.

feat: implement sorting utilities

- Created sorting utilities including normalizeOrderBy, compareValues, and sortByFields.
- Added type definitions for sorting operations.

feat: add string helper functions

- Implemented lowercase and equals functions for string manipulation.

feat: introduce type guards

- Added type guard utilities for checking types such as isString, isObject, and isFunction.
- Implemented tests for type guard functions.

feat: create typed filter utilities

- Developed typedFilter function for type-safe filtering with dot notation support.
- Introduced TypedFilterBuilder class for building filter expressions fluently.

feat: enhance validation schemas and validators

- Created validation schemas for expressions and filter options using zod.
- Implemented validateExpression and validateOptions functions for input validation.
- Added comprehensive tests for validation logic and operator schemas.

Author: mcabreradev

.size-limit.json

@@ -1,58 +1,98 @@
 [
   {
-    "name": "Full Library (no dependencies)",
+    "name": "Full Library",
     "path": "build/index.js",
     "limit": "15 KB",
-    "gzip": true,
-    "ignore": ["zod", "@vercel/analytics", "@vue-leaflet/vue-leaflet", "leaflet"]
+    "gzip": true
+  },
+  {
+    "name": "Core only",
+    "path": "build/core/index.js",
+    "limit": "10 KB",
+    "gzip": true
   },
   {
     "name": "Operators - All",
     "path": "build/operators/index.js",
-    "limit": "5 KB",
-    "gzip": true,
-    "ignore": ["zod"]
+    "limit": "10 KB",
+    "gzip": true
   },
   {
     "name": "Operators - Comparison",
-    "path": "build/operators/comparison.operators.js",
+    "path": "build/operators/comparison/comparison.operators.js",
     "limit": "500 B",
-    "gzip": true,
-    "ignore": ["zod"]
+    "gzip": true
   },
   {
     "name": "Operators - String",
-    "path": "build/operators/string.operators.js",
-    "limit": "1.5 KB",
-    "gzip": true,
-    "ignore": ["zod"]
+    "path": "build/operators/string/string.operators.js",
+    "limit": "2 KB",
+    "gzip": true
   },
   {
     "name": "Operators - Array",
-    "path": "build/operators/array.operators.js",
-    "limit": "300 B",
-    "gzip": true,
-    "ignore": ["zod"]
+    "path": "build/operators/array/array.operators.js",
+    "limit": "500 B",
+    "gzip": true
   },
   {
     "name": "Operators - Logical",
-    "path": "build/operators/logical.operators.js",
+    "path": "build/operators/logical/logical.operators.js",
     "limit": "5 KB",
-    "gzip": true,
-    "ignore": ["zod"]
+    "gzip": true
   },
   {
     "name": "Operators - Geospatial",
-    "path": "build/operators/geospatial.operators.js",
-    "limit": "1 KB",
-    "gzip": true,
-    "ignore": ["zod"]
+    "path": "build/operators/geospatial/geospatial.operators.js",
+    "limit": "2 KB",
+    "gzip": true
   },
   {
     "name": "Operators - DateTime",
-    "path": "build/operators/datetime.operators.js",
-    "limit": "1 KB",
-    "gzip": true,
-    "ignore": ["zod"]
+    "path": "build/operators/datetime/datetime.operators.js",
+    "limit": "2 KB",
+    "gzip": true
+  },
+  {
+    "name": "React integration",
+    "path": "build/integrations/react/index.js",
+    "limit": "10 KB",
+    "gzip": true
+  },
+  {
+    "name": "Vue integration",
+    "path": "build/integrations/vue/index.js",
+    "limit": "10 KB",
+    "gzip": true
+  },
+  {
+    "name": "Svelte integration",
+    "path": "build/integrations/svelte/index.js",
+    "limit": "10 KB",
+    "gzip": true
+  },
+  {
+    "name": "Angular integration",
+    "path": "build/integrations/angular/index.js",
+    "limit": "10 KB",
+    "gzip": true
+  },
+  {
+    "name": "SolidJS integration",
+    "path": "build/integrations/solidjs/index.js",
+    "limit": "10 KB",
+    "gzip": true
+  },
+  {
+    "name": "Preact integration",
+    "path": "build/integrations/preact/index.js",
+    "limit": "10 KB",
+    "gzip": true
+  },
+  {
+    "name": "Lazy evaluation",
+    "path": "build/core/lazy/filter-lazy.js",
+    "limit": "6 KB",
+    "gzip": true
   }
 ]