Function createIranianNationalId

createIranianNationalId(options?: NationalIdGenerationOptions): string
Generates a random valid Iranian National ID (کد ملی)

Iranian National IDs are 10-digit numbers where:
- First 9 digits can be any combination
- 10th digit is a check digit calculated using a weighted sum algorithm
- The validation formula: sum(digit[i] * weight[i]) % 11
- If remainder < 2, check digit = remainder; otherwise check digit = 11 - remainder
Parameters
- options: NationalIdGenerationOptions = {}
  Configuration options for generation
Returns string
A valid 10-digit Iranian National ID string
Example
```
// Generate a basic National ID
createIranianNationalId(); // "0499370899"

// Generate with repeated digits prevention
createIranianNationalId({ preventRepeatedDigits: true }); // "1234567890"

// Get detailed generation result
const result = createIranianNationalIdDetailed();
console.log(result.nationalId); // "0499370899"
console.log(result.checkDigit); // 9
```
- Defined in nationalId/create-national-id.ts:53