Function validateNic

validateNic(rawNic: unknown, options?: NicOptions): ValidationResult<NicInfo>
Comprehensive NIC validation returning structured ValidationResult with error messages and codes.
Parameters
- rawNic: unknown
  NIC number, old or new format. Strings and finite numbers are accepted; other types return a failure without throwing.
- Optionaloptions: NicOptions
  Optional { referenceDate } used for age and future-date checks. Defaults to today.
Returns ValidationResult<NicInfo>
{ isValid: true, data } with NicInfo, or { isValid: false, error, errors, code }.
Example
```
validateNic('921234567V').isValid; // true
validateNic('92123456').code; // 'NIC_INVALID_FORMAT'
```
- Defined in nic/validator.ts:73