@oxog/vld 1.5.0 → 2.0.2

package/CHANGELOG.md

@@ -5,6 +5,174 @@ All notable changes to VLD will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.2] - 2026-02-27
+
+### ⚡ Performance Optimizations
+
+#### **VldString - Pre-compiled Validation Functions**
+- **File**: `src/validators/string.ts`
+- **Optimization**: Added pre-compiled validator functions with fast paths for 0-3 transforms/checks
+- **Impact**: Eliminates loop overhead and enables better JIT optimization
+- **Details**: Unrolled loops for common cases (1-2-3 transforms/checks) reduce function call overhead
+
+#### **VldObject - Consolidated Object.keys() Calls**
+- **File**: `src/validators/object.ts`
+- **Optimization**: Reduced from 3 separate `Object.keys()` calls to 1 shared call
+- **Impact**: ~66% reduction in key enumeration overhead for strict/passthrough/catchall modes
+- **Details**: Single `Object.keys()` call shared across all three modes
+
+#### **VldArray - WeakMap Caching for stableStringify**
+- **File**: `src/validators/array.ts`
+- **Optimization**: Added `WeakMap<object, string>` cache for object serialization
+- **Impact**: Significant performance improvement for arrays with duplicate object references
+- **Details**: Avoids repeated `stableStringify` calls for the same object references
+
+#### **VldLazy - Memory Leak Prevention**
+- **File**: `src/validators/lazy.ts`
+- **Optimization**: Implemented `WeakRef` caching with strong reference fallback
+- **Impact**: Allows garbage collection when validators are no longer in use
+- **Details**: Prevents memory leaks in long-running applications with dynamic schemas
+
+### 🔧 Type Safety Improvements
+
+#### **VldDiscriminatedUnion - Removed `any` Usage**
+- **File**: `src/validators/discriminated-union.ts`
+- **Changes**:
+  - Added public `literal` getter to `VldLiteral` class
+  - Added public `values` getter to `VldEnum` class
+  - Replaced `(value as any)` with `(value as Record<string, unknown>)`
+- **Impact**: Improved type safety without breaking changes
+
+### 📦 Build System
+
+#### **ES2021 WeakRef Support**
+- **File**: `tsconfig.json`
+- **Change**: Updated `"lib": ["ES2020"]` to `"lib": ["ES2021"]`
+- **Impact**: Native `WeakRef` support for memory optimizations
+
+### 🧪 Testing
+- **All 1858 tests passing** - 100% success rate maintained
+- **98.99% code coverage** - Comprehensive test coverage
+- **No breaking changes** - Full backwards compatibility
+
+---
+
+## [2.0.1] - 2026-01-25
+
+### 🧪 Test Coverage Improvements
+- **99.23% Statement Coverage**: Up from previous release
+- **1,858 Tests Passing**: Comprehensive test suite with 100% success rate
+- **Coverage Gap Tests**: Added dedicated test file for edge cases
+
+### 🔧 Bug Fixes
+- Fixed TypeScript errors in test files
+- Fixed lazy locale loader edge cases
+- Improved codec error handling tests
+
+### 📚 Documentation
+- Updated version references across documentation
+- Improved test coverage documentation
+
+---
+
+## [2.0.0] - 2026-01-20
+
+### 🚀 **Major Release - Modular Architecture**
+
+This release introduces a completely new modular architecture for better tree-shaking, lazy locale loading, and dual ESM/CJS support.
+
+### ✨ New Features
+
+#### **Tree-Shakable Mini API** (`@oxog/vld/mini`)
+New functional API that enables proper tree-shaking:
+```typescript
+import { string, number, object, optional } from '@oxog/vld/mini';
+
+const schema = object({
+  name: string().min(1),
+  age: optional(number().positive()),
+});
+```
+- **82% bundle size reduction** when using only needed validators
+- Individual factory functions instead of monolithic `v` object
+- Full TypeScript support with identical type inference
+
+#### **Lazy Locale Loading** (`@oxog/vld/locales`)
+Async locale loading to reduce initial bundle size:
+```typescript
+import { setLocaleAsync } from '@oxog/vld/locales';
+await setLocaleAsync('tr'); // Loads Turkish on demand
+```
+- **92% bundle reduction** - Only English bundled by default
+- `preloadLocales()` for SSR/batch loading
+- `registerLocale()` for static imports
+- Full backwards compatibility with existing `setLocale()`
+
+#### **Dual ESM/CJS Build System**
+- ESM builds for modern bundlers (Vite, esbuild, webpack 5+)
+- CJS builds for Node.js and legacy environments
+- Proper `exports` field in package.json with conditional exports
+
+#### **New Coercion Module** (`@oxog/vld/coercion`)
+Dedicated coercion validators export:
+```typescript
+import { VldCoerceString, VldCoerceNumber } from '@oxog/vld/coercion';
+```
+
+### 📦 Package Exports
+
+New conditional exports for optimal imports:
+```json
+{
+  "@oxog/vld": "Full API (backwards compatible)",
+  "@oxog/vld/mini": "Tree-shakable functional API",
+  "@oxog/vld/locales": "Lazy locale loader",
+  "@oxog/vld/locales/*": "Individual locale files",
+  "@oxog/vld/validators/*": "Individual validators",
+  "@oxog/vld/codecs": "Codec utilities",
+  "@oxog/vld/errors": "Error formatting utilities"
+}
+```
+
+### 🔧 Build System Changes
+- Migrated to Rollup with `@rollup/plugin-typescript`
+- Removed duplicate `rollup-plugin-typescript2`
+- Added `tsconfig.build.json` for type declarations
+- Inline dynamic imports for CJS lazy locale build
+
+### 📊 Bundle Size Comparison
+
+| Scenario | v1.x | v2.0 | Improvement |
+|----------|------|------|-------------|
+| Full API import | 45KB | 45KB | - |
+| Mini API (string + object) | 45KB | ~8KB | **82%** |
+| Single validator | 45KB | ~3KB | **93%** |
+| With 1 locale only | 108KB+ | ~8KB | **92%** |
+
+### 🧪 Testing
+- **1,858 tests** - All passing
+- **99.23% coverage** - Comprehensive test suite
+- Added tests for mini API, lazy locales, and coverage gaps
+
+### ⚠️ Migration Guide
+
+**No breaking changes** - v2.0 is fully backwards compatible:
+
+```typescript
+// Old way (still works)
+import { v, setLocale } from '@oxog/vld';
+setLocale('tr');
+const schema = v.string().min(1);
+
+// New way (tree-shakable)
+import { string } from '@oxog/vld/mini';
+import { setLocaleAsync } from '@oxog/vld/locales';
+await setLocaleAsync('tr');
+const schema = string().min(1);
+```
+
+---
+
 ## [1.4.0] - 2026-01-02
 
 ### 🚀 **Zod 4 Full API Parity Achieved**

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Ersin Koc
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2025 Ersin Koc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.