chore: update documentation (#61)

* feat: Enhance troubleshooting and documentation for geospatial and datetime operators

- Updated troubleshooting guide with detailed solutions for geospatial and datetime query issues.
- Added new sections for geospatial queries, datetime filters, and performance optimizations.
- Expanded operators implementation summary to include new geospatial and datetime operators.
- Updated installation instructions to include yarn and pnpm.
- Revised changelog to reflect the addition of 30+ operators and enhanced type system.
- Updated roadmap with release details for v5.6.0 focusing on geospatial and datetime features.

* feat: add comprehensive TypeScript type safety documentation

- Introduced a new guide on TypeScript type safety in @mcabreradev/filter, covering features like dot notation paths, operator autocomplete, and advanced type patterns.
- Added examples demonstrating basic type inference, explicit generic types, and dot notation type safety.
- Included advanced type utilities such as NestedKeyOf, PathValue, and DeepPartial for enhanced type safety in filtering operations.

refactor: enhance type helpers and utilities

- Created a new file for type helpers, implementing NestedKeyOf, PathValue, DeepPartial, PrimitiveKeys, ObjectKeys, and NestedPaths.
- Implemented utility functions for nested key access, validation, and manipulation of nested objects.

fix: improve object predicate matching with case-insensitive comparison

- Updated the createObjectPredicate function to handle case-insensitive string comparisons when caseSensitive is false.

feat: introduce typed filter utilities

- Added typedFilter function for type-safe filtering with dot notation support.
- Created a TypedFilterBuilder class for building filter expressions with type safety.

test: update vitest configuration for improved test coverage

- Modified vitest configuration to include tests from the __test__ directory.

* feat: enhance TypeScript type safety documentation with examples and best practices

* Refactor code structure for improved readability and maintainability

* feat(errors): introduce comprehensive error handling for filter operations

- Added a new `error-helpers.ts` module to provide utility functions for error management.
- Created a set of specific error classes (`InvalidExpressionError`, `OperatorError`, `ValidationError`, `TypeMismatchError`, `GeospatialError`, `ConfigurationError`, `PerformanceLimitError`) to represent various filter-related errors.
- Implemented functions to create and format error messages, check for filter errors, and extract error details for logging.
- Developed unit tests for the new error handling functionality to ensure robustness and correctness.

feat(performance): implement performance monitoring for filter operations

- Introduced a `PerformanceMonitor` class to track and log performance metrics for filter operations.
- Added methods to start tracking operations, record durations, and retrieve metrics.
- Implemented a global performance monitor instance for easy access and management.
- Created unit tests to validate the performance monitoring functionality.

fix(validation): improve error handling in validation functions

- Updated `validateExpression` and `validateOptions` functions to throw specific errors (`InvalidExpressionError` and `ConfigurationError`) instead of generic errors.
- Enhanced error messages to include detailed information about validation issues.

* feat: enhance documentation and examples for @mcabreradev/filter

- Updated React, Svelte, and Vue documentation to include modular import recommendations for reduced bundle size.
- Added a comprehensive installation guide covering various package managers.
- Introduced a new guide on modular imports detailing import styles and best practices.
- Expanded the quick start guide with installation and import style sections.
- Added new examples for analytics dashboard and e-commerce search scenarios.
- Created new files for lazy evaluation functions and operators, improving modularity.
- Updated core index to export relevant hooks for React integration.
- Added missing operator files for array, comparison, datetime, geospatial, logical, and string operations.

* fix(ci): update workflows to pnpm 10 and regenerate lockfile

- Update all GitHub Actions workflows to use pnpm 10
- Regenerate pnpm-lock.yaml with compatible version
- Fix CI frozen-lockfile compatibility error

* chore: update bundle size limit to 66 KB

- Increased from 65 KB to 66 KB to accommodate new features
- Current size: 65.63 KB (within new limit)
- Growth due to geospatial operators, datetime operators, and enhanced documentation

* fix(ci): remove incompatible size-limit-action

- Remove andresz1/size-limit-action@v1 (incompatible with pnpm)
- Use direct pnpm size command instead
- Fixes JSON parsing error in CI

* perf: reduce bundle size from 65.63 KB to 12.02 KB (81% reduction)

- Move zod to optional peer dependency (user installs if needed)
- Move @vercel/analytics, @vue-leaflet, leaflet to devDependencies
- Update size limit from 66 KB to 15 KB
- All dependencies now excluded from main bundle
- Core library is now truly zero-dependency

BREAKING CHANGE: zod is now a peer dependency. Users who need runtime
validation must install zod separately: pnpm add zod

* perf: reduce bundle size from 65.63 KB to 12.02 KB (81% reduction)

- Move zod to optional peer dependency (user installs if needed)
- Move @vercel/analytics, @vue-leaflet, leaflet to devDependencies
- Update size limit from 66 KB to 15 KB
- All dependencies now excluded from main bundle
- Core library is now truly zero-dependency

BREAKING CHANGE: zod is now a peer dependency. Users who need runtime
validation must install zod separately: pnpm add zod

* docs: update VitePress documentation for zero dependencies

- Update installation.md: Add note about optional Zod peer dependency
- Update bundle size metrics from ~10 KB to ~12 KB throughout
- Update index.md: Change to 'truly zero dependencies' messaging
- Add v5.6.1 migration guide section in migration.md
- Clarify validation features are optional and require Zod
- Update bundle-size.md with new percentages (75%, 83%)
- Emphasize 81% bundle size reduction achievement

Author: mcabreradev

.editorconfig

@@ -0,0 +1,27 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+max_line_length = off
+
+[*.{json,yml,yaml}]
+indent_size = 2
+
+[*.ts]
+indent_size = 2
+max_line_length = 120
+
+[*.tsx]
+indent_size = 2
+max_line_length = 120
+
+[{package.json,*.yml,*.yaml}]
+indent_size = 2

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,68 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+
+A clear and concise description of what the bug is.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+## Code Example
+
+```typescript
+// Minimal code to reproduce the issue
+import { filter } from '@mcabreradev/filter';
+
+const data = [
+  { name: 'Alice', age: 30 },
+  { name: 'Bob', age: 25 }
+];
+
+const result = filter(data, { age: { $gte: 18 } });
+console.log(result);
+```
+
+## Expected Behavior
+
+A clear and concise description of what you expected to happen.
+
+## Actual Behavior
+
+A clear and concise description of what actually happened.
+
+## Error Messages
+
+```
+If applicable, paste any error messages here
+```
+
+## Environment
+
+- **@mcabreradev/filter version:** [e.g. 5.6.1]
+- **Node.js version:** [e.g. 20.0.0]
+- **TypeScript version:** [e.g. 5.0.0]
+- **Package manager:** [e.g. npm 10.0.0, yarn 1.22.0, pnpm 8.0.0]
+- **Operating System:** [e.g. macOS 14.0, Ubuntu 22.04, Windows 11]
+
+## Additional Context
+
+Add any other context about the problem here (screenshots, related issues, etc.)
+
+## Checklist
+
+- [ ] I have searched existing issues to ensure this is not a duplicate
+- [ ] I have provided a minimal code example to reproduce the issue
+- [ ] I have included my environment information
+- [ ] I am using the latest version of @mcabreradev/filter

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,62 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Feature Description
+
+A clear and concise description of the feature you'd like to see.
+
+## Problem Statement
+
+**Is your feature request related to a problem? Please describe.**
+
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+## Proposed Solution
+
+**Describe the solution you'd like**
+
+A clear and concise description of what you want to happen.
+
+## Usage Example
+
+```typescript
+// How you envision using this feature
+import { filter } from '@mcabreradev/filter';
+
+const result = filter(data, {
+  // Your proposed syntax here
+});
+```
+
+## Alternatives Considered
+
+**Describe alternatives you've considered**
+
+A clear and concise description of any alternative solutions or features you've considered.
+
+## Additional Context
+
+Add any other context, screenshots, or examples about the feature request here.
+
+## Benefits
+
+- Benefit 1
+- Benefit 2
+- Benefit 3
+
+## Potential Drawbacks
+
+- Drawback 1 (if any)
+- Drawback 2 (if any)
+
+## Checklist
+
+- [ ] I have searched existing issues/PRs to ensure this is not a duplicate
+- [ ] I have provided a clear use case for this feature
+- [ ] I have considered backwards compatibility
+- [ ] I am willing to contribute to the implementation

.github/dependabot.yml

@@ -8,28 +8,46 @@ updates:
       day: "monday"
       time: "09:00"
     open-pull-requests-limit: 10
+    reviewers:
+      - "mcabreradev"
     assignees:
       - "mcabreradev"
     commit-message:
       prefix: "chore"
       include: "scope"
     labels:
       - "dependencies"
-      - "security"
+      - "automated"
+    groups:
+      # Group all production dependencies
+      production-dependencies:
+        dependency-type: "production"
+        update-types:
+          - "minor"
+          - "patch"
+      # Group all development dependencies
+      development-dependencies:
+        dependency-type: "development"
+        update-types:
+          - "minor"
+          - "patch"
+    # Ignore specific packages if needed
+    ignore:
+      - dependency-name: "zod"
+        update-types: ["version-update:semver-major"]
 
   # GitHub Actions
   - package-ecosystem: "github-actions"
     directory: "/"
     schedule:
       interval: "weekly"
       day: "monday"
-      time: "09:00"
-    open-pull-requests-limit: 5
+    reviewers:
+      - "mcabreradev"
     assignees:
       - "mcabreradev"
     commit-message:
-      prefix: "chore(ci)"
-      include: "scope"
+      prefix: "ci"
     labels:
-      - "dependencies"
-      - "ci"
+      - "github-actions"
+      - "automated"

.github/workflows/npm-publish-manual.yml

@@ -34,7 +34,7 @@ jobs:
       - name: 📥 Setup pnpm
         uses: pnpm/action-setup@v4
         with:
-          version: 9
+          version: 10
           run_install: false
 
       - name: 📦 Install dependencies

.github/workflows/size-check.yml

@@ -0,0 +1,34 @@
+name: Bundle Size Check
+
+on:
+  pull_request:
+    branches: [main, develop]
+  push:
+    branches: [main, develop]
+
+jobs:
+  size:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 10
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build project
+        run: pnpm build
+
+      - name: Check bundle size
+        run: pnpm size

.github/workflows/testing.yml

@@ -34,7 +34,7 @@ jobs:
       - name: 📦 Setup pnpm
         uses: pnpm/action-setup@v4
         with:
-          version: 9
+          version: 10
 
       - name: ⎔ Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v6

.npmignore

@@ -0,0 +1,56 @@
+# Source files
+src/
+__test__/
+__tests__/
+
+# Documentation
+docs/
+examples/
+.vitepress/
+
+# Config files
+tsconfig.json
+tsconfig.tsd.json
+tsd.json
+vitest.config.ts
+vitest.docs.config.ts
+eslint.config.js
+typedoc.json
+.prettierrc
+.editorconfig
+
+# CI/CD
+.github/
+.husky/
+
+# Development files
+*.test.ts
+*.test.tsx
+*.spec.ts
+*.spec.tsx
+test-d/
+
+# Misc
+.DS_Store
+*.log
+.env
+.env.local
+coverage/
+.nyc_output/
+
+# Documentation files
+CONTRIBUTING.md
+CLAUDE.md
+FIXED_ISSUES.md
+GEOSPATIAL_EXAMPLES_UPDATE.md
+PLAYGROUND_FIX.md
+techstack.md
+techstack.yml
+TYPESCRIPT_IMPLEMENTATION_SUMMARY.md
+RESTRUCTURING.md
+
+# Keep only build output and essential files
+!build/
+!package.json
+!README.md
+!LICENSE.md

.size-limit.json

@@ -0,0 +1,58 @@
+[
+  {
+    "name": "Full Library (no dependencies)",
+    "path": "build/index.js",
+    "limit": "15 KB",
+    "gzip": true,
+    "ignore": ["zod", "@vercel/analytics", "@vue-leaflet/vue-leaflet", "leaflet"]
+  },
+  {
+    "name": "Operators - All",
+    "path": "build/operators/index.js",
+    "limit": "5 KB",
+    "gzip": true,
+    "ignore": ["zod"]
+  },
+  {
+    "name": "Operators - Comparison",
+    "path": "build/operators/comparison.operators.js",
+    "limit": "500 B",
+    "gzip": true,
+    "ignore": ["zod"]
+  },
+  {
+    "name": "Operators - String",
+    "path": "build/operators/string.operators.js",
+    "limit": "1.5 KB",
+    "gzip": true,
+    "ignore": ["zod"]
+  },
+  {
+    "name": "Operators - Array",
+    "path": "build/operators/array.operators.js",
+    "limit": "300 B",
+    "gzip": true,
+    "ignore": ["zod"]
+  },
+  {
+    "name": "Operators - Logical",
+    "path": "build/operators/logical.operators.js",
+    "limit": "5 KB",
+    "gzip": true,
+    "ignore": ["zod"]
+  },
+  {
+    "name": "Operators - Geospatial",
+    "path": "build/operators/geospatial.operators.js",
+    "limit": "1 KB",
+    "gzip": true,
+    "ignore": ["zod"]
+  },
+  {
+    "name": "Operators - DateTime",
+    "path": "build/operators/datetime.operators.js",
+    "limit": "1 KB",
+    "gzip": true,
+    "ignore": ["zod"]
+  }
+]