ind-utils-pro 1.0.0

package/README.md

@@ -0,0 +1,35 @@
+# 🇮🇳 Ind-Utils-Pro
+A professional, lightweight, and framework-agnostic Indian utility library for Angular, React, Vue, and Node.js.
+
+## 🚀 Features
+- **Identity:** PAN, GST, Aadhar, VoterID, Passport, Driving License.
+- **Finance:** IFSC, Account Number, TAN, DIN, CIN, Currency to Words.
+- **Location:** Pincode, Mobile, Vehicle Registration.
+- **Formatting:** Indian Rupee (INR) formatting.
+
+## 📦 Installation
+```bash
+npm install ind-utils-pro
+
+
+# ================= In React / Vue / Vanilla JS =================
+# import { IndUtils } from 'ind-utils-pro';
+
+# const isPanValid = IndUtils.isValidPAN('ABCDE1234F'); // true
+# const amountInWords = IndUtils.toIndianWords(5000); // Five Thousand Rupees Only
+
+
+# ================= In Angular =================
+# import { IndUtils } from 'ind-utils-pro';
+
+# export class AppComponent {
+#   checkGst() {
+#     const isValid = IndUtils.isValidGST('24AAAAA0000A1Z5');
+#     console.log(isValid);
+#   }
+# }
+
+
+# ================= In Node.js =================
+# const { IndUtils } = require('ind-utils-pro');
+# console.log(IndUtils.isValidPincode('380001'));

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "ind-utils-pro",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Universal Indian Utility Library",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --clean --minify && tsc --emitDeclarationOnly",
+    "dev": "tsup src/index.ts --format cjs,esm --watch --dts"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.57.7",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/constants/patterns.ts

@@ -0,0 +1,23 @@
+export const REGEX = {
+  // Identity
+  PAN: /^[A-Z]{5}[0-9]{4}[A-Z]{1}$/,
+  GST: /^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z]{1}[1-9A-Z]{1}Z[0-9A-Z]{1}$/,
+  AADHAR: /^[2-9]{1}[0-9]{11}$/,
+  VOTER_ID: /^[A-Z]{3}[0-9]{7}$/,
+  PASSPORT: /^[A-Z][0-9]{7}$/,
+  DRIVING_LICENSE: /^(([A-Z]{2}[0-9]{2})( )|([A-Z]{2}-[0-9]{2}))((19|20)[0-9][0-9])[0-9]{7}$/,
+  
+  // Finance & Business
+  IFSC: /^[A-Z]{4}0[A-Z0-9]{6}$/,
+  TAN: /^[A-Z]{4}[0-9]{5}[A-Z]{1}$/,
+  DIN: /^[0-9]{8}$/,
+  CIN: /^([LUu])([0-9]{5})([A-Z]{2})([0-9]{4})([A-Z]{3})([0-9]{6})$/,
+  
+  // Contact & Location
+  PINCODE: /^[1-9][0-9]{5}$/,
+  MOBILE: /^[6-9]\d{9}$/,
+  STD_CODE: /^0[0-9]{2,4}$/,
+  
+  // Vehicles (General Format)
+  VEHICLE_NO: /^[A-Z]{2}[0-9]{2}[A-Z]{1,2}[0-9]{4}$/
+};

package/src/formatters/currency.ts

@@ -0,0 +1,28 @@
+export const toINR = (amount: number): string => {
+  if (isNaN(amount)) return '₹0.00';
+  return new Intl.NumberFormat('en-IN', {
+    style: 'currency',
+    currency: 'INR',
+  }).format(amount);
+};
+
+export const toIndianWords = (num: number): string => {
+  const a = ['', 'One ', 'Two ', 'Three ', 'Four ', 'Five ', 'Six ', 'Seven ', 'Eight ', 'Nine ', 'Ten ', 'Eleven ', 'Twelve ', 'Thirteen ', 'Fourteen ', 'Fifteen ', 'Sixteen ', 'Seventeen ', 'Eighteen ', 'Nineteen '];
+  const b = ['', '', 'Twenty', 'Thirty', 'Forty', 'Fifty', 'Sixty', 'Seventy', 'Eighty', 'Ninety'];
+
+  // સંખ્યાને સ્ટ્રિંગમાં કન્વર્ટ કરવા માટે નવો વેરીએબલ વાપરો (Error Fix)
+  const numStr = num.toString();
+  if (numStr.length > 9) return 'Overflow';
+
+  const n = ('000000000' + numStr).substr(-9).match(/^(\d{2})(\d{2})(\d{2})(\d{1})(\d{2})$/);
+  if (!n) return ''; 
+
+  let str = '';
+  str += (Number(n[1]) !== 0) ? (a[Number(n[1])] || b[parseInt(n[1][0])] + ' ' + a[parseInt(n[1][1])]) + 'Crore ' : '';
+  str += (Number(n[2]) !== 0) ? (a[Number(n[2])] || b[parseInt(n[2][0])] + ' ' + a[parseInt(n[2][1])]) + 'Lakh ' : '';
+  str += (Number(n[3]) !== 0) ? (a[Number(n[3])] || b[parseInt(n[3][0])] + ' ' + a[parseInt(n[3][1])]) + 'Thousand ' : '';
+  str += (Number(n[4]) !== 0) ? (a[Number(n[4])] || b[parseInt(n[4][0])] + ' ' + a[parseInt(n[4][1])]) + 'Hundred ' : '';
+  str += (Number(n[5]) !== 0) ? ((str !== '') ? 'and ' : '') + (a[Number(n[5])] || b[parseInt(n[5][0])] + ' ' + a[parseInt(n[5][1])]) + 'Rupees Only' : '';
+  
+  return str.trim();
+};

package/src/index.ts

@@ -0,0 +1,11 @@
+export * from './validators/identity';
+export * from './constants/patterns';
+export * from './formatters/currency';
+
+import * as identity from './validators/identity';
+import * as currency from './formatters/currency';
+
+export const IndUtils = {
+  ...identity,
+  ...currency
+};

package/src/validators/identity.ts

@@ -0,0 +1,23 @@
+import { REGEX } from '../constants/patterns';
+
+// --- Government IDs ---
+export const isValidPAN = (v: string) => REGEX.PAN.test(v?.toUpperCase());
+export const isValidGST = (v: string) => REGEX.GST.test(v?.toUpperCase());
+export const isValidAadhar = (v: string) => REGEX.AADHAR.test(v);
+export const isValidVoterID = (v: string) => REGEX.VOTER_ID.test(v?.toUpperCase());
+export const isValidPassport = (v: string) => REGEX.PASSPORT.test(v?.toUpperCase());
+export const isValidDrivingLicense = (v: string) => REGEX.DRIVING_LICENSE.test(v?.toUpperCase());
+
+// --- Business & Finance ---
+export const isValidIFSC = (v: string) => REGEX.IFSC.test(v?.toUpperCase());
+export const isValidTAN = (v: string) => REGEX.TAN.test(v?.toUpperCase());
+export const isValidDIN = (v: string) => REGEX.DIN.test(v);
+export const isValidCIN = (v: string) => REGEX.CIN.test(v?.toUpperCase());
+
+// --- Contact ---
+export const isValidPincode = (v: string) => REGEX.PINCODE.test(v);
+export const isValidMobile = (v: string) => REGEX.MOBILE.test(v);
+export const isValidVehicleNo = (v: string) => REGEX.VEHICLE_NO.test(v?.toUpperCase());
+
+// --- Specialized Checks ---
+export const isUPIDeposited = (v: string) => /^[a-zA-Z0-9.\-_]{2,256}@[a-zA-Z]{2,64}$/.test(v);

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "declaration": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "dist"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}