@oxog/vld 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,113 @@
+# Changelog
+
+All notable changes to this project 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).
+
+## [1.0.0] - 2025-08-10
+
+### Added
+
+**Core Features**
+- Complete validation engine with JIT compilation for 2x performance boost
+- Trait-based plugin architecture for maximum extensibility
+- Zero runtime dependencies with < 8KB bundle size (minified + gzipped)
+- Full TypeScript support with perfect type inference and IntelliSense
+- Comprehensive error system with detailed formatting and debugging
+
+**Schema Types**
+- **Primitive schemas**: `string`, `number`, `boolean`, `bigint`, `null`, `undefined`, `literal`
+- **Complex types**: `object`, `array`, `tuple`, `union`, `intersection`, `record`, `map`, `set`
+- **Advanced types**: `lazy` (recursive), `promise`, `function`, `discriminatedUnion`
+- **Branded types**: Create distinct types that prevent value mixing
+- **Template literal support**: Advanced string pattern validation
+
+**String Validation**
+- Email validation (RFC 5322 compliant)
+- URL validation (supports http/https/ftp)
+- UUID validation (v1-v5 supported)
+- CUID and CUID2 support
+- ULID format validation
+- Custom regex patterns
+- DateTime and IP address formats
+- Base64 encoding validation
+- Length, content, and format constraints
+
+**Number Validation**
+- Integer and float validation
+- Range validation (min/max/gt/lt)
+- Safe integer validation
+- Finite number checks
+- Multiple/step validation
+- Precision constraints
+- Special number handling (NaN, Infinity)
+
+**Object & Array Features**
+- Nested object validation with strict/passthrough/strip modes
+- Array length constraints and element validation
+- Tuple validation with exact type inference
+- Record validation with key/value constraints
+- Deep object merging and extension
+- Partial and required modifiers
+- Pick and omit operations
+
+**Union & Intersection Types**
+- Standard unions with type inference
+- **Discriminated unions with O(1) performance** (up to 12x faster than regular unions)
+- Intersection types for combining schemas
+- Enum validation with compile-time safety
+
+**Modifiers & Transformations**
+- `optional()`: Make fields optional (T | undefined)
+- `nullable()`: Allow null values (T | null)  
+- `nullish()`: Allow null or undefined (T | null | undefined)
+- `default()`: Provide default values
+- `catch()`: Fallback values on validation errors
+- `transform()`: Data transformation pipeline
+- `refine()` and `superRefine()`: Custom validation logic
+- `pipe()`: Sequential transformation chains
+
+**Async Support**
+- `parseAsync()` and `safeParseAsync()` methods
+- Async refinement functions
+- Promise schema validation
+- Async transform functions
+
+**Plugin System**
+- Built-in plugins: DateTime, i18n, Custom Formats
+- Plugin hooks: beforeParse, afterParse, onError
+- Custom schema registration
+- Transform and validator registration
+- Configurable plugin loading
+
+**Built-in Plugins**
+- **DateTime Plugin**: Date, time, and datetime validation with timezone support
+- **i18n Plugin**: Multi-language error messages (English, Spanish, French, German, Chinese, Japanese)
+- **Custom Formats Plugin**: Credit cards, IP addresses, hex colors, Base64, MAC addresses, ISBN/EAN
+
+**Error Handling**
+- Detailed error paths and messages
+- Error formatting and flattening utilities
+- Custom error messages with interpolation
+- Structured error reporting
+- Error caching for performance
+
+**Security Features**
+- Automatic prototype pollution protection
+- Input sanitization safeguards  
+- DoS attack mitigation with size limits
+- Safe error messages (no sensitive data leakage)
+- Schema validation prevents code execution
+
+### Performance
+- 2x faster than Zod v4 in object validation benchmarks
+- < 8KB core bundle size (minified + gzipped)
+- Optimized validation paths with JIT compilation
+- Memory-efficient with object pooling
+
+### Documentation
+- Complete API documentation
+- Migration guide from Zod
+- Performance optimization guide
+- TypeScript integration examples

package/LICENSE

@@ -0,0 +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
+SOFTWARE.