lanka-kit 0.0.0-stage → 1.1.0

package/lib/currency.js

@@ -0,0 +1,251 @@
+/**
+ * LKR currency formatting and amount-to-words converter.
+ */
+const ONES_EN = [
+    '',
+    'One',
+    'Two',
+    'Three',
+    'Four',
+    'Five',
+    'Six',
+    'Seven',
+    'Eight',
+    'Nine',
+    'Ten',
+    'Eleven',
+    'Twelve',
+    'Thirteen',
+    'Fourteen',
+    'Fifteen',
+    'Sixteen',
+    'Seventeen',
+    'Eighteen',
+    'Nineteen',
+];
+const TENS_EN = [
+    '',
+    '',
+    'Twenty',
+    'Thirty',
+    'Forty',
+    'Fifty',
+    'Sixty',
+    'Seventy',
+    'Eighty',
+    'Ninety',
+];
+function convertThreeDigitsEn(num) {
+    let result = '';
+    const hundreds = Math.floor(num / 100);
+    const remainder = num % 100;
+    if (hundreds > 0) {
+        result += ONES_EN[hundreds] + ' Hundred';
+        if (remainder > 0) {
+            result += ' ';
+        }
+    }
+    if (remainder > 0) {
+        if (remainder < 20) {
+            result += ONES_EN[remainder];
+        }
+        else {
+            const tens = Math.floor(remainder / 10);
+            const ones = remainder % 10;
+            result += TENS_EN[tens];
+            if (ones > 0) {
+                result += ' ' + ONES_EN[ones];
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Format a numeric amount to Sri Lankan Rupee standard display.
+ * Example: 1540000.5 -> "Rs. 1,540,000.50"
+ */
+export function formatLkr(amount, options = {}) {
+    if (typeof amount !== 'number' || isNaN(amount)) {
+        return 'Rs. 0.00';
+    }
+    const prefix = options.prefix !== undefined ? options.prefix : 'Rs. ';
+    const suffix = options.suffix || '';
+    const decimals = options.decimals !== undefined ? options.decimals : 2;
+    const isNegative = amount < 0;
+    const absAmount = Math.abs(amount);
+    const parts = absAmount.toFixed(decimals).split('.');
+    const intPart = parts[0];
+    const decPart = parts[1];
+    // International grouping format
+    const withCommas = intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+    const formattedNum = decimals > 0 ? `${withCommas}.${decPart}` : withCommas;
+    const sign = isNegative ? '-' : '';
+    return `${sign}${prefix}${formattedNum}${suffix}`;
+}
+/**
+ * Convert a numeric monetary amount to English words for cheques and invoices.
+ * Example: 1540.50 -> "One Thousand Five Hundred Forty Rupees and Fifty Cents Only"
+ */
+function integerToWordsEn(num) {
+    if (num === 0)
+        return 'Zero';
+    const scales = ['', 'Thousand', 'Million', 'Billion', 'Trillion'];
+    let chunks = [];
+    let temp = num;
+    while (temp > 0) {
+        chunks.push(temp % 1000);
+        temp = Math.floor(temp / 1000);
+    }
+    let words = [];
+    for (let i = chunks.length - 1; i >= 0; i--) {
+        const chunk = chunks[i];
+        if (chunk > 0) {
+            const chunkWords = convertThreeDigitsEn(chunk);
+            const scale = scales[i];
+            words.push(scale ? `${chunkWords} ${scale}` : chunkWords);
+        }
+    }
+    return words.join(' ');
+}
+// Sinhala Numbers Data
+const SI_ONES = {
+    0: 'බිංදුව',
+    1: 'එක',
+    2: 'දෙක',
+    3: 'තුන',
+    4: 'හතර',
+    5: 'පහ',
+    6: 'හය',
+    7: 'හත',
+    8: 'අට',
+    9: 'නවය',
+    10: 'දහය',
+    11: 'එකොළහ',
+    12: 'දොළහ',
+    13: 'දහතුන',
+    14: 'දාහතර',
+    15: 'පහළොව',
+    16: 'දාසය',
+    17: 'දාහත',
+    18: 'දහඅට',
+    19: 'දහනවය',
+    20: 'විස්ස',
+    30: 'තිහ',
+    40: 'හතළිහ',
+    50: 'පනහ',
+    60: 'හැට',
+    70: 'හැත්තෑව',
+    80: 'අසූව',
+    90: 'අනූව',
+};
+const SI_PREFIX = {
+    1: 'එක්',
+    2: 'දෙ',
+    3: 'තුන්',
+    4: 'හාර',
+    5: 'පන්',
+    6: 'හය',
+    7: 'හත්',
+    8: 'අට',
+    9: 'නවසීය',
+};
+function integerToWordsSi(num) {
+    if (num === 0)
+        return 'බිංදුව';
+    if (num < 0)
+        return 'සෘණ ' + integerToWordsSi(Math.abs(num));
+    if (num <= 20) {
+        return SI_ONES[num];
+    }
+    if (num < 100) {
+        const tens = Math.floor(num / 10) * 10;
+        const remainder = num % 10;
+        if (remainder === 0)
+            return SI_ONES[tens];
+        const tensPrefix = {
+            20: 'විසි',
+            30: 'තිස්',
+            40: 'හතළිස්',
+            50: 'පනස්',
+            60: 'හැට',
+            70: 'හැත්තෑ',
+            80: 'අසූ',
+            90: 'අනූ',
+        };
+        return (tensPrefix[tens] || '') + ' ' + SI_ONES[remainder];
+    }
+    if (num < 1000) {
+        const hundreds = Math.floor(num / 100);
+        const remainder = num % 100;
+        const hText = hundreds === 1 ? 'එක්සිය' : (SI_PREFIX[hundreds] || SI_ONES[hundreds]) + 'සිය';
+        if (remainder === 0)
+            return hText + 'යයි';
+        return hText + ' ' + integerToWordsSi(remainder);
+    }
+    if (num < 1000000) {
+        const thousands = Math.floor(num / 1000);
+        const remainder = num % 1000;
+        const tText = thousands === 1 ? 'එක්දහස්' : integerToWordsSi(thousands) + ' දහස්';
+        if (remainder === 0)
+            return thousands === 1 ? 'එක්දහසයි' : tText + 'යි';
+        return tText + ' ' + integerToWordsSi(remainder);
+    }
+    const millions = Math.floor(num / 1000000);
+    const remainder = num % 1000000;
+    const mText = integerToWordsSi(millions) + ' මිලියන';
+    if (remainder === 0)
+        return mText;
+    return mText + ' ' + integerToWordsSi(remainder);
+}
+/**
+ * Convert numeric amount into formal words.
+ *
+ * @param amount - Monetary number (e.g., 1540.50)
+ * @param options - Language and formatting options
+ * @returns Standard phrase (e.g., "One Thousand Five Hundred Forty Rupees and Fifty Cents Only")
+ */
+export function amountToWords(amount, options = {}) {
+    if (typeof amount !== 'number' || isNaN(amount)) {
+        return options.language === 'si' ? 'රුපියල් බිංදුවයි පමණි' : 'Zero Rupees Only';
+    }
+    const lang = options.language || 'en';
+    const includeCurrency = options.includeCurrency !== false;
+    const isNegative = amount < 0;
+    const absAmount = Math.abs(amount);
+    const rupees = Math.floor(absAmount);
+    const cents = Math.round((absAmount - rupees) * 100);
+    if (lang === 'si') {
+        let result = '';
+        if (rupees > 0) {
+            result += 'රුපියල් ' + integerToWordsSi(rupees);
+        }
+        else {
+            result += 'රුපියල් බිංදුවයි';
+        }
+        if (cents > 0) {
+            result += ' ශත ' + integerToWordsSi(cents);
+        }
+        result += ' පමණි';
+        return isNegative ? 'සෘණ ' + result : result;
+    }
+    // English
+    const rupeesWords = integerToWordsEn(rupees);
+    let result = '';
+    if (includeCurrency) {
+        const rupeeText = rupees === 1 ? 'Rupee' : 'Rupees';
+        result = `${rupeesWords} ${rupeeText}`;
+        if (cents > 0) {
+            const centsWords = integerToWordsEn(cents);
+            const centText = cents === 1 ? 'Cent' : 'Cents';
+            result += ` and ${centsWords} ${centText}`;
+        }
+        result += ' Only';
+    }
+    else {
+        result = rupeesWords;
+        if (cents > 0) {
+            result += ` Point ${integerToWordsEn(cents)}`;
+        }
+    }
+    return isNegative ? `Negative ${result}` : result;
+}

package/lib/geo.d.ts

@@ -0,0 +1,18 @@
+import { DistrictInfo, PostalLocation } from './types';
+/**
+ * 25 Administrative Districts of Sri Lanka mapped to their 9 Provinces.
+ */
+export declare const SRI_LANKA_DISTRICTS: DistrictInfo[];
+export declare const SRI_LANKA_PROVINCES: readonly ["Western", "Central", "Southern", "Northern", "Eastern", "North Western", "North Central", "Uva", "Sabaragamuwa"];
+/**
+ * Look up location information by Sri Lankan postal code.
+ */
+export declare function lookupPostalCode(postalCode: string | number): PostalLocation | null;
+/**
+ * Returns all districts in a given province.
+ */
+export declare function getDistrictsByProvince(provinceName: string): DistrictInfo[];
+/**
+ * Searches Sri Lankan cities and postal codes by keyword.
+ */
+export declare function searchLocations(query: string): PostalLocation[];

package/lib/geo.js

@@ -0,0 +1,197 @@
+/**
+ * 25 Administrative Districts of Sri Lanka mapped to their 9 Provinces.
+ */
+export const SRI_LANKA_DISTRICTS = [
+    // Western Province
+    { name: 'Colombo', code: 'COL', province: 'Western', postalCodeRange: [0, 10999] },
+    { name: 'Gampaha', code: 'GAM', province: 'Western', postalCodeRange: [11000, 11999] },
+    { name: 'Kalutara', code: 'KAL', province: 'Western', postalCodeRange: [12000, 12999] },
+    // Central Province
+    { name: 'Kandy', code: 'KAN', province: 'Central', postalCodeRange: [20000, 20999] },
+    { name: 'Matale', code: 'MTL', province: 'Central', postalCodeRange: [21000, 21999] },
+    { name: 'Nuwara Eliya', code: 'NEL', province: 'Central', postalCodeRange: [22000, 22999] },
+    // Southern Province
+    { name: 'Galle', code: 'GAL', province: 'Southern', postalCodeRange: [80000, 80999] },
+    { name: 'Matara', code: 'MAT', province: 'Southern', postalCodeRange: [81000, 81999] },
+    { name: 'Hambantota', code: 'HAM', province: 'Southern', postalCodeRange: [82000, 82999] },
+    // Northern Province
+    { name: 'Jaffna', code: 'JAF', province: 'Northern', postalCodeRange: [40000, 40999] },
+    { name: 'Kilinochchi', code: 'KIL', province: 'Northern', postalCodeRange: [44000, 44999] },
+    { name: 'Mannar', code: 'MAN', province: 'Northern', postalCodeRange: [41000, 41999] },
+    { name: 'Vavuniya', code: 'VAV', province: 'Northern', postalCodeRange: [43000, 43999] },
+    { name: 'Mullaitivu', code: 'MUL', province: 'Northern', postalCodeRange: [42000, 42999] },
+    // Eastern Province
+    { name: 'Batticaloa', code: 'BAT', province: 'Eastern', postalCodeRange: [30000, 30999] },
+    { name: 'Ampara', code: 'AMP', province: 'Eastern', postalCodeRange: [32000, 32999] },
+    { name: 'Trincomalee', code: 'TRI', province: 'Eastern', postalCodeRange: [31000, 31999] },
+    // North Western Province
+    { name: 'Kurunegala', code: 'KUR', province: 'North Western', postalCodeRange: [60000, 60999] },
+    { name: 'Puttalam', code: 'PUT', province: 'North Western', postalCodeRange: [61000, 61999] },
+    // North Central Province
+    { name: 'Anuradhapura', code: 'ANU', province: 'North Central', postalCodeRange: [50000, 50999] },
+    { name: 'Polonnaruwa', code: 'POL', province: 'North Central', postalCodeRange: [51000, 51999] },
+    // Uva Province
+    { name: 'Badulla', code: 'BAD', province: 'Uva', postalCodeRange: [90000, 90999] },
+    { name: 'Monaragala', code: 'MON', province: 'Uva', postalCodeRange: [91000, 91999] },
+    // Sabaragamuwa Province
+    { name: 'Ratnapura', code: 'RAT', province: 'Sabaragamuwa', postalCodeRange: [70000, 70999] },
+    { name: 'Kegalle', code: 'KEG', province: 'Sabaragamuwa', postalCodeRange: [71000, 71999] },
+];
+export const SRI_LANKA_PROVINCES = [
+    'Western',
+    'Central',
+    'Southern',
+    'Northern',
+    'Eastern',
+    'North Western',
+    'North Central',
+    'Uva',
+    'Sabaragamuwa',
+];
+/**
+ * Key Sri Lankan Postal Codes Registry
+ */
+const POSTAL_CODES = {
+    // Colombo postal zones (00100 - 01500)
+    '00100': { city: 'Colombo 01 (Fort)', district: 'Colombo', province: 'Western' },
+    '00200': { city: 'Colombo 02 (Slave Island)', district: 'Colombo', province: 'Western' },
+    '00300': { city: 'Colombo 03 (Kollupitiya)', district: 'Colombo', province: 'Western' },
+    '00400': { city: 'Colombo 04 (Bambalapitiya)', district: 'Colombo', province: 'Western' },
+    '00500': { city: 'Colombo 05 (Havelock Town / Kirulapone)', district: 'Colombo', province: 'Western' },
+    '00600': { city: 'Colombo 06 (Wellawatte / Pamankada)', district: 'Colombo', province: 'Western' },
+    '00700': { city: 'Colombo 07 (Cinnamon Gardens)', district: 'Colombo', province: 'Western' },
+    '00800': { city: 'Colombo 08 (Borella)', district: 'Colombo', province: 'Western' },
+    '00900': { city: 'Colombo 09 (Dematagoda)', district: 'Colombo', province: 'Western' },
+    '01000': { city: 'Colombo 10 (Maradana / Panchikawatte)', district: 'Colombo', province: 'Western' },
+    '01100': { city: 'Colombo 11 (Pettah)', district: 'Colombo', province: 'Western' },
+    '01200': { city: 'Colombo 12 (Hultsdorf)', district: 'Colombo', province: 'Western' },
+    '01300': { city: 'Colombo 13 (Kotahena / Bloemendhal)', district: 'Colombo', province: 'Western' },
+    '01400': { city: 'Colombo 14 (Grandpass)', district: 'Colombo', province: 'Western' },
+    '01500': { city: 'Colombo 15 (Mutwal / Modara / Mattakkuliya)', district: 'Colombo', province: 'Western' },
+    // Colombo Suburbs
+    '10100': { city: 'Battaramulla', district: 'Colombo', province: 'Western' },
+    '10115': { city: 'Rajagiriya', district: 'Colombo', province: 'Western' },
+    '10120': { city: 'Kotte (Sri Jayawardenepura)', district: 'Colombo', province: 'Western' },
+    '10200': { city: 'Malabe', district: 'Colombo', province: 'Western' },
+    '10230': { city: 'Kottawa', district: 'Colombo', province: 'Western' },
+    '10250': { city: 'Nugegoda', district: 'Colombo', province: 'Western' },
+    '10280': { city: 'Maharagama', district: 'Colombo', province: 'Western' },
+    '10300': { city: 'Piliyandala', district: 'Colombo', province: 'Western' },
+    '10350': { city: 'Dehiwala', district: 'Colombo', province: 'Western' },
+    '10370': { city: 'Mount Lavinia', district: 'Colombo', province: 'Western' },
+    '10400': { city: 'Moratuwa', district: 'Colombo', province: 'Western' },
+    '10500': { city: 'Homagama', district: 'Colombo', province: 'Western' },
+    '10640': { city: 'Avissawella', district: 'Colombo', province: 'Western' },
+    // Gampaha District
+    '11000': { city: 'Gampaha', district: 'Gampaha', province: 'Western' },
+    '11300': { city: 'Kelaniya', district: 'Gampaha', province: 'Western' },
+    '11500': { city: 'Negombo', district: 'Gampaha', province: 'Western' },
+    '11540': { city: 'Katunayake (BIA)', district: 'Gampaha', province: 'Western' },
+    '11600': { city: 'Ja-Ela', district: 'Gampaha', province: 'Western' },
+    '11700': { city: 'Wattala', district: 'Gampaha', province: 'Western' },
+    '11850': { city: 'Kiribathgoda', district: 'Gampaha', province: 'Western' },
+    // Kalutara District
+    '12000': { city: 'Kalutara', district: 'Kalutara', province: 'Western' },
+    '12500': { city: 'Panadura', district: 'Kalutara', province: 'Western' },
+    '12580': { city: 'Horana', district: 'Kalutara', province: 'Western' },
+    '12070': { city: 'Beruwala', district: 'Kalutara', province: 'Western' },
+    '12090': { city: 'Aluthgama', district: 'Kalutara', province: 'Western' },
+    // Kandy District
+    '20000': { city: 'Kandy', district: 'Kandy', province: 'Central' },
+    '20400': { city: 'Peradeniya', district: 'Kandy', province: 'Central' },
+    '20500': { city: 'Gampola', district: 'Kandy', province: 'Central' },
+    '20100': { city: 'Katugastota', district: 'Kandy', province: 'Central' },
+    // Galle District
+    '80000': { city: 'Galle', district: 'Galle', province: 'Southern' },
+    '80240': { city: 'Hikkaduwa', district: 'Galle', province: 'Southern' },
+    '80300': { city: 'Ambalangoda', district: 'Galle', province: 'Southern' },
+    '80480': { city: 'Karapitiya', district: 'Galle', province: 'Southern' },
+    // Matara District
+    '81000': { city: 'Matara', district: 'Matara', province: 'Southern' },
+    '81100': { city: 'Mirissa', district: 'Matara', province: 'Southern' },
+    '81200': { city: 'Weligama', district: 'Matara', province: 'Southern' },
+    // Hambantota District
+    '82000': { city: 'Hambantota', district: 'Hambantota', province: 'Southern' },
+    '82200': { city: 'Tangalle', district: 'Hambantota', province: 'Southern' },
+    // Jaffna District
+    '40000': { city: 'Jaffna', district: 'Jaffna', province: 'Northern' },
+    '40030': { city: 'Nallur', district: 'Jaffna', province: 'Northern' },
+    '40080': { city: 'Chavakachcheri', district: 'Jaffna', province: 'Northern' },
+    '40200': { city: 'Point Pedro', district: 'Jaffna', province: 'Northern' },
+    // Kurunegala District
+    '60000': { city: 'Kurunegala', district: 'Kurunegala', province: 'North Western' },
+    '60200': { city: 'Kuliyapitiya', district: 'Kurunegala', province: 'North Western' },
+    // Anuradhapura District
+    '50000': { city: 'Anuradhapura', district: 'Anuradhapura', province: 'North Central' },
+    // Ratnapura District
+    '70000': { city: 'Ratnapura', district: 'Ratnapura', province: 'Sabaragamuwa' },
+    // Badulla District
+    '90000': { city: 'Badulla', district: 'Badulla', province: 'Uva' },
+    '90100': { city: 'Bandarawela', district: 'Badulla', province: 'Uva' },
+    '90090': { city: 'Ella', district: 'Badulla', province: 'Uva' },
+    // Batticaloa & Trincomalee
+    '30000': { city: 'Batticaloa', district: 'Batticaloa', province: 'Eastern' },
+    '31000': { city: 'Trincomalee', district: 'Trincomalee', province: 'Eastern' },
+    '32000': { city: 'Ampara', district: 'Ampara', province: 'Eastern' },
+};
+/**
+ * Look up location information by Sri Lankan postal code.
+ */
+export function lookupPostalCode(postalCode) {
+    const code = String(postalCode).trim().padStart(5, '0');
+    const found = POSTAL_CODES[code];
+    if (found) {
+        return {
+            postalCode: code,
+            city: found.city,
+            district: found.district,
+            province: found.province,
+        };
+    }
+    // Fallback: estimate district and province from postal code range
+    const numCode = parseInt(code, 10);
+    if (!isNaN(numCode)) {
+        const matchedDistrict = SRI_LANKA_DISTRICTS.find((d) => d.postalCodeRange &&
+            numCode >= d.postalCodeRange[0] &&
+            numCode <= d.postalCodeRange[1]);
+        if (matchedDistrict) {
+            return {
+                postalCode: code,
+                city: `${matchedDistrict.name} Region`,
+                district: matchedDistrict.name,
+                province: matchedDistrict.province,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Returns all districts in a given province.
+ */
+export function getDistrictsByProvince(provinceName) {
+    const norm = provinceName.trim().toLowerCase();
+    return SRI_LANKA_DISTRICTS.filter((d) => d.province.toLowerCase() === norm);
+}
+/**
+ * Searches Sri Lankan cities and postal codes by keyword.
+ */
+export function searchLocations(query) {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return [];
+    const results = [];
+    for (const [code, info] of Object.entries(POSTAL_CODES)) {
+        if (code.includes(q) ||
+            info.city.toLowerCase().includes(q) ||
+            info.district.toLowerCase().includes(q) ||
+            info.province.toLowerCase().includes(q)) {
+            results.push({
+                postalCode: code,
+                city: info.city,
+                district: info.district,
+                province: info.province,
+            });
+        }
+    }
+    return results;
+}

package/lib/identity-extra.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Validation for Sri Lankan passports, TIN, and business registration numbers.
+ */
+export interface PassportResult {
+    isValid: boolean;
+    clean: string;
+    type: 'Regular (N-Series)' | 'Diplomatic (D-Series)' | 'Official (O-Series)' | 'Legacy (M-Series)' | 'Biometric (PA-Series)' | 'Unknown';
+    error?: string;
+}
+export interface TinResult {
+    isValid: boolean;
+    clean: string;
+    format: 'NEW_10_DIGIT' | 'LEGACY_9_DIGIT' | 'UNKNOWN';
+    error?: string;
+}
+export interface BrnResult {
+    isValid: boolean;
+    clean: string;
+    type: 'Private Limited (PV)' | 'Public Limited (PB)' | 'Guarantee (GA/GL)' | 'Foreign/Other' | 'Unknown';
+    registrationNumber: string;
+    error?: string;
+}
+/**
+ * Validates a Sri Lankan Passport Number.
+ * Standard citizen passports start with 'N' followed by 7 digits (e.g., N1234567).
+ * Diplomatic ('D'), Official ('O'), Legacy ('M'), and new e-passports ('PA') are also supported.
+ */
+export declare function validatePassport(input: string): PassportResult;
+/**
+ * Validates an Inland Revenue Department (IRD) Taxpayer Identification Number (TIN).
+ * Mandatory in Sri Lanka for opening bank accounts, motor vehicle registrations, etc.
+ * Formats: 9-digit or modern 10-digit numeric.
+ */
+export declare function validateTin(input: string): TinResult;
+/**
+ * Validates a Sri Lankan Business Registration Number (Registrar of Companies - ROC).
+ * Examples:
+ * - PV 12345 / PV 00123456 (Private Limited)
+ * - PB 1234 (Public Limited)
+ * - GA 1234 / GL 1234 (Company Limited by Guarantee)
+ */
+export declare function validateBrn(input: string): BrnResult;

package/lib/identity-extra.js

@@ -0,0 +1,146 @@
+/**
+ * Validation for Sri Lankan passports, TIN, and business registration numbers.
+ */
+/**
+ * Validates a Sri Lankan Passport Number.
+ * Standard citizen passports start with 'N' followed by 7 digits (e.g., N1234567).
+ * Diplomatic ('D'), Official ('O'), Legacy ('M'), and new e-passports ('PA') are also supported.
+ */
+export function validatePassport(input) {
+    if (!input || typeof input !== 'string') {
+        return { isValid: false, clean: '', type: 'Unknown', error: 'Input must be a non-empty string' };
+    }
+    const clean = input.trim().toUpperCase().replace(/[\s-]/g, '');
+    // 1. Regular N-series: N + 7 digits (e.g., N1234567)
+    if (/^N\d{7}$/.test(clean)) {
+        return {
+            isValid: true,
+            clean,
+            type: 'Regular (N-Series)',
+        };
+    }
+    // 2. Biometric PA-series: PA + 7 digits
+    if (/^PA\d{7}$/.test(clean)) {
+        return {
+            isValid: true,
+            clean,
+            type: 'Biometric (PA-Series)',
+        };
+    }
+    // 3. Diplomatic D-series: D + 7 digits
+    if (/^D\d{7}$/.test(clean)) {
+        return {
+            isValid: true,
+            clean,
+            type: 'Diplomatic (D-Series)',
+        };
+    }
+    // 4. Official O-series: O + 7 digits
+    if (/^O\d{7}$/.test(clean)) {
+        return {
+            isValid: true,
+            clean,
+            type: 'Official (O-Series)',
+        };
+    }
+    // 5. Legacy M-series: M + 7 digits
+    if (/^M\d{7}$/.test(clean)) {
+        return {
+            isValid: true,
+            clean,
+            type: 'Legacy (M-Series)',
+        };
+    }
+    return {
+        isValid: false,
+        clean,
+        type: 'Unknown',
+        error: 'Invalid Sri Lankan passport number format. Expected format like N1234567 or PA1234567.',
+    };
+}
+/**
+ * Validates an Inland Revenue Department (IRD) Taxpayer Identification Number (TIN).
+ * Mandatory in Sri Lanka for opening bank accounts, motor vehicle registrations, etc.
+ * Formats: 9-digit or modern 10-digit numeric.
+ */
+export function validateTin(input) {
+    if (!input || typeof input !== 'string') {
+        return { isValid: false, clean: '', format: 'UNKNOWN', error: 'Input must be a non-empty string' };
+    }
+    const clean = input.trim().replace(/[\s-]/g, '');
+    if (!/^\d+$/.test(clean)) {
+        return {
+            isValid: false,
+            clean,
+            format: 'UNKNOWN',
+            error: 'TIN must contain only numeric digits',
+        };
+    }
+    if (clean.length === 10) {
+        return {
+            isValid: true,
+            clean,
+            format: 'NEW_10_DIGIT',
+        };
+    }
+    if (clean.length === 9) {
+        return {
+            isValid: true,
+            clean,
+            format: 'LEGACY_9_DIGIT',
+        };
+    }
+    return {
+        isValid: false,
+        clean,
+        format: 'UNKNOWN',
+        error: `Invalid TIN length (${clean.length} digits). Expected 9 or 10 digits.`,
+    };
+}
+/**
+ * Validates a Sri Lankan Business Registration Number (Registrar of Companies - ROC).
+ * Examples:
+ * - PV 12345 / PV 00123456 (Private Limited)
+ * - PB 1234 (Public Limited)
+ * - GA 1234 / GL 1234 (Company Limited by Guarantee)
+ */
+export function validateBrn(input) {
+    if (!input || typeof input !== 'string') {
+        return {
+            isValid: false,
+            clean: '',
+            type: 'Unknown',
+            registrationNumber: '',
+            error: 'Input must be a non-empty string',
+        };
+    }
+    const clean = input.trim().toUpperCase().replace(/\s+/g, ' ');
+    // Match ROC formats: PV 12345, PV00123456, PB 1234, GA 1234
+    const rocRegex = /^(PV|PB|GA|GL)\s*(\d{4,8})$/;
+    const match = clean.match(rocRegex);
+    if (match) {
+        const prefix = match[1];
+        const number = match[2];
+        const standardized = `${prefix} ${number}`;
+        let type = 'Foreign/Other';
+        if (prefix === 'PV')
+            type = 'Private Limited (PV)';
+        else if (prefix === 'PB')
+            type = 'Public Limited (PB)';
+        else if (prefix === 'GA' || prefix === 'GL')
+            type = 'Guarantee (GA/GL)';
+        return {
+            isValid: true,
+            clean: standardized,
+            type,
+            registrationNumber: number,
+        };
+    }
+    return {
+        isValid: false,
+        clean,
+        type: 'Unknown',
+        registrationNumber: '',
+        error: 'Invalid Sri Lankan ROC registration number. Expected format like PV 12345 or PB 00123456.',
+    };
+}

package/lib/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * lanka-kit
+ * Sri Lankan developer utility toolkit.
+ */
+export * from './types';
+export * from './nic';
+export * from './phone';
+export * from './geo';
+export * from './license';
+export * from './lankaqr';
+export * from './banks';
+export * from './currency';
+export * from './vehicle';
+export * from './identity-extra';
+export * from './unicode';
+export * from './zod';