@lacspace/nepali-utils 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lacspace
+
+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.

package/README.md

@@ -0,0 +1,74 @@
+# @lacspace/nepali-utils
+
+[![npm](https://img.shields.io/npm/v/@lacspace/nepali-utils.svg)](https://www.npmjs.com/package/@lacspace/nepali-utils) [![license](https://img.shields.io/npm/l/@lacspace/nepali-utils.svg)](https://github.com/lacspace/npm-packages/blob/main/LICENSE)
+
+Everyday helpers for building Nepal-facing apps: NPR currency formatting with the South-Asian (lakh/crore) grouping, Devanagari numerals, amount-in-words for invoices, common validators, and province data. Zero dependencies, isomorphic, fully typed.
+
+## Install
+
+```bash
+npm install @lacspace/nepali-utils
+```
+
+## Currency & numbers
+
+```ts
+import { formatNPR, groupNepali, toDevanagari, fromDevanagari } from "@lacspace/nepali-utils";
+
+formatNPR(1234567.5);                       // "Rs. 12,34,567.50"
+formatNPR(1234567.5, { symbol: "रू " , devanagari: true }); // "रू १२,३४,५६७.५०"
+formatNPR(50000, { decimals: 0, symbol: "" });             // "50,000"
+
+groupNepali(1234567);      // "12,34,567"  (South-Asian grouping)
+toDevanagari("2081");      // "२०८१"
+fromDevanagari("२०८१");    // "2081"
+```
+
+## Amount in words (for invoices)
+
+```ts
+import { numberToWords, amountInWords } from "@lacspace/nepali-utils";
+
+numberToWords(1234567);
+// "Twelve Lakh Thirty Four Thousand Five Hundred Sixty Seven"
+
+amountInWords(1234567.75);
+// "Rupees Twelve Lakh Thirty Four Thousand Five Hundred Sixty Seven and Seventy Five Paisa Only"
+```
+
+## Validators
+
+```ts
+import { isValidNepaliMobile, isValidPAN } from "@lacspace/nepali-utils";
+
+isValidNepaliMobile("9812345678");     // true
+isValidNepaliMobile("+9779812345678"); // true
+isValidNepaliMobile("1234567890");     // false
+
+isValidPAN("123456789");               // true (9 digits)
+```
+
+## Provinces
+
+```ts
+import { PROVINCES } from "@lacspace/nepali-utils";
+
+PROVINCES[2];
+// { number: 3, name: "Bagmati", nameNp: "बागमती", capital: "Hetauda" }
+```
+
+## API
+
+| Function | Description |
+| --- | --- |
+| `formatNPR(amount, opts?)` | NPR currency string; opts: `symbol`, `decimals`, `devanagari` |
+| `groupNepali(value)` | South-Asian digit grouping |
+| `toDevanagari(x)` / `fromDevanagari(x)` | numeral conversion |
+| `numberToWords(n)` | South-Asian words (Lakh/Crore/Arab) |
+| `amountInWords(n)` | "Rupees … only" wrapper |
+| `isValidNepaliMobile(s)` / `isValidPAN(s)` | validators |
+| `PROVINCES` | the 7 federal provinces |
+
+## License
+
+MIT © [Lacspace](https://lacspace.com)

package/dist/index.cjs

@@ -0,0 +1,112 @@
+'use strict';
+
+// src/index.ts
+var DEVANAGARI = ["\u0966", "\u0967", "\u0968", "\u0969", "\u096A", "\u096B", "\u096C", "\u096D", "\u096E", "\u096F"];
+function toDevanagari(input) {
+  return String(input).replace(/[0-9]/g, (d) => DEVANAGARI[Number(d)]);
+}
+function fromDevanagari(input) {
+  return input.replace(/[०-९]/g, (d) => String(DEVANAGARI.indexOf(d)));
+}
+function groupNepali(value) {
+  const s = String(value).replace(/[^\d]/g, "");
+  if (s.length <= 3) return s;
+  const last3 = s.slice(-3);
+  const rest = s.slice(0, -3);
+  return rest.replace(/\B(?=(\d{2})+(?!\d))/g, ",") + "," + last3;
+}
+function formatNPR(amount, options = {}) {
+  const { symbol = "Rs. ", decimals = 2, devanagari = false } = options;
+  const negative = amount < 0;
+  const fixed = Math.abs(amount).toFixed(decimals);
+  const [intPart, decPart] = fixed.split(".");
+  let out = groupNepali(intPart);
+  if (decPart) out += "." + decPart;
+  if (devanagari) out = toDevanagari(out);
+  return (negative ? "-" : "") + symbol + out;
+}
+var ONES = [
+  "",
+  "One",
+  "Two",
+  "Three",
+  "Four",
+  "Five",
+  "Six",
+  "Seven",
+  "Eight",
+  "Nine",
+  "Ten",
+  "Eleven",
+  "Twelve",
+  "Thirteen",
+  "Fourteen",
+  "Fifteen",
+  "Sixteen",
+  "Seventeen",
+  "Eighteen",
+  "Nineteen"
+];
+var TENS = ["", "", "Twenty", "Thirty", "Forty", "Fifty", "Sixty", "Seventy", "Eighty", "Ninety"];
+function twoDigitWords(n) {
+  if (n < 20) return ONES[n];
+  const t = Math.floor(n / 10);
+  const o = n % 10;
+  return TENS[t] + (o ? " " + ONES[o] : "");
+}
+function numberToWords(value) {
+  let n = Math.floor(Math.abs(value));
+  if (n === 0) return "Zero";
+  const parts = [];
+  const units = [
+    [1e9, "Arab"],
+    [1e7, "Crore"],
+    [1e5, "Lakh"],
+    [1e3, "Thousand"],
+    [100, "Hundred"]
+  ];
+  for (const [size, name] of units) {
+    if (n >= size) {
+      const count = Math.floor(n / size);
+      parts.push((size === 100 ? ONES[count] : twoDigitWords(count)) + " " + name);
+      n %= size;
+    }
+  }
+  if (n > 0) parts.push(twoDigitWords(n));
+  return (value < 0 ? "Minus " : "") + parts.join(" ");
+}
+function amountInWords(amount) {
+  const rupees = Math.floor(Math.abs(amount));
+  const paisa = Math.round((Math.abs(amount) - rupees) * 100);
+  let out = "Rupees " + numberToWords(rupees);
+  if (paisa > 0) out += " and " + numberToWords(paisa) + " Paisa";
+  return (amount < 0 ? "Minus " : "") + out + " Only";
+}
+function isValidNepaliMobile(input) {
+  const s = input.replace(/[\s-]/g, "");
+  return /^(\+?977)?9[678]\d{8}$/.test(s);
+}
+function isValidPAN(input) {
+  return /^\d{9}$/.test(input.trim());
+}
+var PROVINCES = [
+  { number: 1, name: "Koshi", nameNp: "\u0915\u094B\u0936\u0940", capital: "Biratnagar" },
+  { number: 2, name: "Madhesh", nameNp: "\u092E\u0927\u0947\u0936", capital: "Janakpur" },
+  { number: 3, name: "Bagmati", nameNp: "\u092C\u093E\u0917\u092E\u0924\u0940", capital: "Hetauda" },
+  { number: 4, name: "Gandaki", nameNp: "\u0917\u0923\u094D\u0921\u0915\u0940", capital: "Pokhara" },
+  { number: 5, name: "Lumbini", nameNp: "\u0932\u0941\u092E\u094D\u092C\u093F\u0928\u0940", capital: "Deukhuri" },
+  { number: 6, name: "Karnali", nameNp: "\u0915\u0930\u094D\u0923\u093E\u0932\u0940", capital: "Birendranagar" },
+  { number: 7, name: "Sudurpashchim", nameNp: "\u0938\u0941\u0926\u0942\u0930\u092A\u0936\u094D\u091A\u093F\u092E", capital: "Godawari" }
+];
+
+exports.PROVINCES = PROVINCES;
+exports.amountInWords = amountInWords;
+exports.formatNPR = formatNPR;
+exports.fromDevanagari = fromDevanagari;
+exports.groupNepali = groupNepali;
+exports.isValidNepaliMobile = isValidNepaliMobile;
+exports.isValidPAN = isValidPAN;
+exports.numberToWords = numberToWords;
+exports.toDevanagari = toDevanagari;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @lacspace/nepali-utils — everyday Nepal helpers: NPR currency formatting,\n * Nepali (South-Asian) digit grouping, Devanagari numerals, amount-in-words,\n * common validators, and province data. Zero-dependency, isomorphic.\n */\n\nconst DEVANAGARI = [\"०\", \"१\", \"२\", \"३\", \"४\", \"५\", \"६\", \"७\", \"८\", \"९\"] as const;\n\n/** Convert Arabic numerals to Devanagari: `\"2081\"` → `\"२०८१\"`. */\nexport function toDevanagari(input: string | number): string {\n  return String(input).replace(/[0-9]/g, (d) => DEVANAGARI[Number(d)]!);\n}\n\n/** Convert Devanagari numerals to Arabic: `\"२०८१\"` → `\"2081\"`. */\nexport function fromDevanagari(input: string): string {\n  return input.replace(/[०-९]/g, (d) => String(DEVANAGARI.indexOf(d as (typeof DEVANAGARI)[number])));\n}\n\n/**\n * Group an integer with the South-Asian (Nepali) system: the last three digits,\n * then groups of two. `1234567` → `\"12,34,567\"`.\n */\nexport function groupNepali(value: number | string): string {\n  const s = String(value).replace(/[^\\d]/g, \"\");\n  if (s.length <= 3) return s;\n  const last3 = s.slice(-3);\n  const rest = s.slice(0, -3);\n  return rest.replace(/\\B(?=(\\d{2})+(?!\\d))/g, \",\") + \",\" + last3;\n}\n\nexport interface FormatNprOptions {\n  /** Show a symbol/prefix. Default `\"Rs. \"`. Use `\"\"` for none. */\n  symbol?: string;\n  /** Number of decimal places. Default `2`. */\n  decimals?: number;\n  /** Render digits in Devanagari. Default `false`. */\n  devanagari?: boolean;\n}\n\n/**\n * Format an amount as Nepalese Rupees with South-Asian grouping.\n * `formatNPR(1234567.5)` → `\"Rs. 12,34,567.50\"`.\n */\nexport function formatNPR(amount: number, options: FormatNprOptions = {}): string {\n  const { symbol = \"Rs. \", decimals = 2, devanagari = false } = options;\n  const negative = amount < 0;\n  const fixed = Math.abs(amount).toFixed(decimals);\n  const [intPart, decPart] = fixed.split(\".\");\n  let out = groupNepali(intPart!);\n  if (decPart) out += \".\" + decPart;\n  if (devanagari) out = toDevanagari(out);\n  return (negative ? \"-\" : \"\") + symbol + out;\n}\n\nconst ONES = [\n  \"\", \"One\", \"Two\", \"Three\", \"Four\", \"Five\", \"Six\", \"Seven\", \"Eight\", \"Nine\",\n  \"Ten\", \"Eleven\", \"Twelve\", \"Thirteen\", \"Fourteen\", \"Fifteen\", \"Sixteen\",\n  \"Seventeen\", \"Eighteen\", \"Nineteen\",\n];\nconst TENS = [\"\", \"\", \"Twenty\", \"Thirty\", \"Forty\", \"Fifty\", \"Sixty\", \"Seventy\", \"Eighty\", \"Ninety\"];\n\nfunction twoDigitWords(n: number): string {\n  if (n < 20) return ONES[n]!;\n  const t = Math.floor(n / 10);\n  const o = n % 10;\n  return TENS[t]! + (o ? \" \" + ONES[o] : \"\");\n}\n\n/**\n * Amount in words using the South-Asian system (Thousand, Lakh, Crore, Arab) —\n * perfect for invoices. `numberToWords(1234567)` →\n * `\"Twelve Lakh Thirty Four Thousand Five Hundred Sixty Seven\"`.\n */\nexport function numberToWords(value: number): string {\n  let n = Math.floor(Math.abs(value));\n  if (n === 0) return \"Zero\";\n  const parts: string[] = [];\n  const units: [number, string][] = [\n    [1e9, \"Arab\"],\n    [1e7, \"Crore\"],\n    [1e5, \"Lakh\"],\n    [1e3, \"Thousand\"],\n    [1e2, \"Hundred\"],\n  ];\n  for (const [size, name] of units) {\n    if (n >= size) {\n      const count = Math.floor(n / size);\n      // Hundreds are 1–9; the higher units take up to two digits.\n      parts.push((size === 100 ? ONES[count] : twoDigitWords(count)) + \" \" + name);\n      n %= size;\n    }\n  }\n  if (n > 0) parts.push(twoDigitWords(n));\n  return (value < 0 ? \"Minus \" : \"\") + parts.join(\" \");\n}\n\n/** `numberToWords` plus a \"Rupees … only\" wrapper for invoices. */\nexport function amountInWords(amount: number): string {\n  const rupees = Math.floor(Math.abs(amount));\n  const paisa = Math.round((Math.abs(amount) - rupees) * 100);\n  let out = \"Rupees \" + numberToWords(rupees);\n  if (paisa > 0) out += \" and \" + numberToWords(paisa) + \" Paisa\";\n  return (amount < 0 ? \"Minus \" : \"\") + out + \" Only\";\n}\n\n/** True for a valid Nepali mobile number (10 digits starting 96–98, optional +977). */\nexport function isValidNepaliMobile(input: string): boolean {\n  const s = input.replace(/[\\s-]/g, \"\");\n  return /^(\\+?977)?9[678]\\d{8}$/.test(s);\n}\n\n/** True for a valid Nepal PAN / VAT number (9 digits). */\nexport function isValidPAN(input: string): boolean {\n  return /^\\d{9}$/.test(input.trim());\n}\n\nexport interface Province {\n  number: number;\n  name: string;\n  nameNp: string;\n  capital: string;\n}\n\n/** Nepal's seven federal provinces. */\nexport const PROVINCES: readonly Province[] = [\n  { number: 1, name: \"Koshi\", nameNp: \"कोशी\", capital: \"Biratnagar\" },\n  { number: 2, name: \"Madhesh\", nameNp: \"मधेश\", capital: \"Janakpur\" },\n  { number: 3, name: \"Bagmati\", nameNp: \"बागमती\", capital: \"Hetauda\" },\n  { number: 4, name: \"Gandaki\", nameNp: \"गण्डकी\", capital: \"Pokhara\" },\n  { number: 5, name: \"Lumbini\", nameNp: \"लुम्बिनी\", capital: \"Deukhuri\" },\n  { number: 6, name: \"Karnali\", nameNp: \"कर्णाली\", capital: \"Birendranagar\" },\n  { number: 7, name: \"Sudurpashchim\", nameNp: \"सुदूरपश्चिम\", capital: \"Godawari\" },\n];\n"]}

package/dist/index.d.cts

@@ -0,0 +1,49 @@
+/**
+ * @lacspace/nepali-utils — everyday Nepal helpers: NPR currency formatting,
+ * Nepali (South-Asian) digit grouping, Devanagari numerals, amount-in-words,
+ * common validators, and province data. Zero-dependency, isomorphic.
+ */
+/** Convert Arabic numerals to Devanagari: `"2081"` → `"२०८१"`. */
+declare function toDevanagari(input: string | number): string;
+/** Convert Devanagari numerals to Arabic: `"२०८१"` → `"2081"`. */
+declare function fromDevanagari(input: string): string;
+/**
+ * Group an integer with the South-Asian (Nepali) system: the last three digits,
+ * then groups of two. `1234567` → `"12,34,567"`.
+ */
+declare function groupNepali(value: number | string): string;
+interface FormatNprOptions {
+    /** Show a symbol/prefix. Default `"Rs. "`. Use `""` for none. */
+    symbol?: string;
+    /** Number of decimal places. Default `2`. */
+    decimals?: number;
+    /** Render digits in Devanagari. Default `false`. */
+    devanagari?: boolean;
+}
+/**
+ * Format an amount as Nepalese Rupees with South-Asian grouping.
+ * `formatNPR(1234567.5)` → `"Rs. 12,34,567.50"`.
+ */
+declare function formatNPR(amount: number, options?: FormatNprOptions): string;
+/**
+ * Amount in words using the South-Asian system (Thousand, Lakh, Crore, Arab) —
+ * perfect for invoices. `numberToWords(1234567)` →
+ * `"Twelve Lakh Thirty Four Thousand Five Hundred Sixty Seven"`.
+ */
+declare function numberToWords(value: number): string;
+/** `numberToWords` plus a "Rupees … only" wrapper for invoices. */
+declare function amountInWords(amount: number): string;
+/** True for a valid Nepali mobile number (10 digits starting 96–98, optional +977). */
+declare function isValidNepaliMobile(input: string): boolean;
+/** True for a valid Nepal PAN / VAT number (9 digits). */
+declare function isValidPAN(input: string): boolean;
+interface Province {
+    number: number;
+    name: string;
+    nameNp: string;
+    capital: string;
+}
+/** Nepal's seven federal provinces. */
+declare const PROVINCES: readonly Province[];
+
+export { type FormatNprOptions, PROVINCES, type Province, amountInWords, formatNPR, fromDevanagari, groupNepali, isValidNepaliMobile, isValidPAN, numberToWords, toDevanagari };

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @lacspace/nepali-utils — everyday Nepal helpers: NPR currency formatting,
+ * Nepali (South-Asian) digit grouping, Devanagari numerals, amount-in-words,
+ * common validators, and province data. Zero-dependency, isomorphic.
+ */
+/** Convert Arabic numerals to Devanagari: `"2081"` → `"२०८१"`. */
+declare function toDevanagari(input: string | number): string;
+/** Convert Devanagari numerals to Arabic: `"२०८१"` → `"2081"`. */
+declare function fromDevanagari(input: string): string;
+/**
+ * Group an integer with the South-Asian (Nepali) system: the last three digits,
+ * then groups of two. `1234567` → `"12,34,567"`.
+ */
+declare function groupNepali(value: number | string): string;
+interface FormatNprOptions {
+    /** Show a symbol/prefix. Default `"Rs. "`. Use `""` for none. */
+    symbol?: string;
+    /** Number of decimal places. Default `2`. */
+    decimals?: number;
+    /** Render digits in Devanagari. Default `false`. */
+    devanagari?: boolean;
+}
+/**
+ * Format an amount as Nepalese Rupees with South-Asian grouping.
+ * `formatNPR(1234567.5)` → `"Rs. 12,34,567.50"`.
+ */
+declare function formatNPR(amount: number, options?: FormatNprOptions): string;
+/**
+ * Amount in words using the South-Asian system (Thousand, Lakh, Crore, Arab) —
+ * perfect for invoices. `numberToWords(1234567)` →
+ * `"Twelve Lakh Thirty Four Thousand Five Hundred Sixty Seven"`.
+ */
+declare function numberToWords(value: number): string;
+/** `numberToWords` plus a "Rupees … only" wrapper for invoices. */
+declare function amountInWords(amount: number): string;
+/** True for a valid Nepali mobile number (10 digits starting 96–98, optional +977). */
+declare function isValidNepaliMobile(input: string): boolean;
+/** True for a valid Nepal PAN / VAT number (9 digits). */
+declare function isValidPAN(input: string): boolean;
+interface Province {
+    number: number;
+    name: string;
+    nameNp: string;
+    capital: string;
+}
+/** Nepal's seven federal provinces. */
+declare const PROVINCES: readonly Province[];
+
+export { type FormatNprOptions, PROVINCES, type Province, amountInWords, formatNPR, fromDevanagari, groupNepali, isValidNepaliMobile, isValidPAN, numberToWords, toDevanagari };

package/dist/index.js

@@ -0,0 +1,102 @@
+// src/index.ts
+var DEVANAGARI = ["\u0966", "\u0967", "\u0968", "\u0969", "\u096A", "\u096B", "\u096C", "\u096D", "\u096E", "\u096F"];
+function toDevanagari(input) {
+  return String(input).replace(/[0-9]/g, (d) => DEVANAGARI[Number(d)]);
+}
+function fromDevanagari(input) {
+  return input.replace(/[०-९]/g, (d) => String(DEVANAGARI.indexOf(d)));
+}
+function groupNepali(value) {
+  const s = String(value).replace(/[^\d]/g, "");
+  if (s.length <= 3) return s;
+  const last3 = s.slice(-3);
+  const rest = s.slice(0, -3);
+  return rest.replace(/\B(?=(\d{2})+(?!\d))/g, ",") + "," + last3;
+}
+function formatNPR(amount, options = {}) {
+  const { symbol = "Rs. ", decimals = 2, devanagari = false } = options;
+  const negative = amount < 0;
+  const fixed = Math.abs(amount).toFixed(decimals);
+  const [intPart, decPart] = fixed.split(".");
+  let out = groupNepali(intPart);
+  if (decPart) out += "." + decPart;
+  if (devanagari) out = toDevanagari(out);
+  return (negative ? "-" : "") + symbol + out;
+}
+var ONES = [
+  "",
+  "One",
+  "Two",
+  "Three",
+  "Four",
+  "Five",
+  "Six",
+  "Seven",
+  "Eight",
+  "Nine",
+  "Ten",
+  "Eleven",
+  "Twelve",
+  "Thirteen",
+  "Fourteen",
+  "Fifteen",
+  "Sixteen",
+  "Seventeen",
+  "Eighteen",
+  "Nineteen"
+];
+var TENS = ["", "", "Twenty", "Thirty", "Forty", "Fifty", "Sixty", "Seventy", "Eighty", "Ninety"];
+function twoDigitWords(n) {
+  if (n < 20) return ONES[n];
+  const t = Math.floor(n / 10);
+  const o = n % 10;
+  return TENS[t] + (o ? " " + ONES[o] : "");
+}
+function numberToWords(value) {
+  let n = Math.floor(Math.abs(value));
+  if (n === 0) return "Zero";
+  const parts = [];
+  const units = [
+    [1e9, "Arab"],
+    [1e7, "Crore"],
+    [1e5, "Lakh"],
+    [1e3, "Thousand"],
+    [100, "Hundred"]
+  ];
+  for (const [size, name] of units) {
+    if (n >= size) {
+      const count = Math.floor(n / size);
+      parts.push((size === 100 ? ONES[count] : twoDigitWords(count)) + " " + name);
+      n %= size;
+    }
+  }
+  if (n > 0) parts.push(twoDigitWords(n));
+  return (value < 0 ? "Minus " : "") + parts.join(" ");
+}
+function amountInWords(amount) {
+  const rupees = Math.floor(Math.abs(amount));
+  const paisa = Math.round((Math.abs(amount) - rupees) * 100);
+  let out = "Rupees " + numberToWords(rupees);
+  if (paisa > 0) out += " and " + numberToWords(paisa) + " Paisa";
+  return (amount < 0 ? "Minus " : "") + out + " Only";
+}
+function isValidNepaliMobile(input) {
+  const s = input.replace(/[\s-]/g, "");
+  return /^(\+?977)?9[678]\d{8}$/.test(s);
+}
+function isValidPAN(input) {
+  return /^\d{9}$/.test(input.trim());
+}
+var PROVINCES = [
+  { number: 1, name: "Koshi", nameNp: "\u0915\u094B\u0936\u0940", capital: "Biratnagar" },
+  { number: 2, name: "Madhesh", nameNp: "\u092E\u0927\u0947\u0936", capital: "Janakpur" },
+  { number: 3, name: "Bagmati", nameNp: "\u092C\u093E\u0917\u092E\u0924\u0940", capital: "Hetauda" },
+  { number: 4, name: "Gandaki", nameNp: "\u0917\u0923\u094D\u0921\u0915\u0940", capital: "Pokhara" },
+  { number: 5, name: "Lumbini", nameNp: "\u0932\u0941\u092E\u094D\u092C\u093F\u0928\u0940", capital: "Deukhuri" },
+  { number: 6, name: "Karnali", nameNp: "\u0915\u0930\u094D\u0923\u093E\u0932\u0940", capital: "Birendranagar" },
+  { number: 7, name: "Sudurpashchim", nameNp: "\u0938\u0941\u0926\u0942\u0930\u092A\u0936\u094D\u091A\u093F\u092E", capital: "Godawari" }
+];
+
+export { PROVINCES, amountInWords, formatNPR, fromDevanagari, groupNepali, isValidNepaliMobile, isValidPAN, numberToWords, toDevanagari };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @lacspace/nepali-utils — everyday Nepal helpers: NPR currency formatting,\n * Nepali (South-Asian) digit grouping, Devanagari numerals, amount-in-words,\n * common validators, and province data. Zero-dependency, isomorphic.\n */\n\nconst DEVANAGARI = [\"०\", \"१\", \"२\", \"३\", \"४\", \"५\", \"६\", \"७\", \"८\", \"९\"] as const;\n\n/** Convert Arabic numerals to Devanagari: `\"2081\"` → `\"२०८१\"`. */\nexport function toDevanagari(input: string | number): string {\n  return String(input).replace(/[0-9]/g, (d) => DEVANAGARI[Number(d)]!);\n}\n\n/** Convert Devanagari numerals to Arabic: `\"२०८१\"` → `\"2081\"`. */\nexport function fromDevanagari(input: string): string {\n  return input.replace(/[०-९]/g, (d) => String(DEVANAGARI.indexOf(d as (typeof DEVANAGARI)[number])));\n}\n\n/**\n * Group an integer with the South-Asian (Nepali) system: the last three digits,\n * then groups of two. `1234567` → `\"12,34,567\"`.\n */\nexport function groupNepali(value: number | string): string {\n  const s = String(value).replace(/[^\\d]/g, \"\");\n  if (s.length <= 3) return s;\n  const last3 = s.slice(-3);\n  const rest = s.slice(0, -3);\n  return rest.replace(/\\B(?=(\\d{2})+(?!\\d))/g, \",\") + \",\" + last3;\n}\n\nexport interface FormatNprOptions {\n  /** Show a symbol/prefix. Default `\"Rs. \"`. Use `\"\"` for none. */\n  symbol?: string;\n  /** Number of decimal places. Default `2`. */\n  decimals?: number;\n  /** Render digits in Devanagari. Default `false`. */\n  devanagari?: boolean;\n}\n\n/**\n * Format an amount as Nepalese Rupees with South-Asian grouping.\n * `formatNPR(1234567.5)` → `\"Rs. 12,34,567.50\"`.\n */\nexport function formatNPR(amount: number, options: FormatNprOptions = {}): string {\n  const { symbol = \"Rs. \", decimals = 2, devanagari = false } = options;\n  const negative = amount < 0;\n  const fixed = Math.abs(amount).toFixed(decimals);\n  const [intPart, decPart] = fixed.split(\".\");\n  let out = groupNepali(intPart!);\n  if (decPart) out += \".\" + decPart;\n  if (devanagari) out = toDevanagari(out);\n  return (negative ? \"-\" : \"\") + symbol + out;\n}\n\nconst ONES = [\n  \"\", \"One\", \"Two\", \"Three\", \"Four\", \"Five\", \"Six\", \"Seven\", \"Eight\", \"Nine\",\n  \"Ten\", \"Eleven\", \"Twelve\", \"Thirteen\", \"Fourteen\", \"Fifteen\", \"Sixteen\",\n  \"Seventeen\", \"Eighteen\", \"Nineteen\",\n];\nconst TENS = [\"\", \"\", \"Twenty\", \"Thirty\", \"Forty\", \"Fifty\", \"Sixty\", \"Seventy\", \"Eighty\", \"Ninety\"];\n\nfunction twoDigitWords(n: number): string {\n  if (n < 20) return ONES[n]!;\n  const t = Math.floor(n / 10);\n  const o = n % 10;\n  return TENS[t]! + (o ? \" \" + ONES[o] : \"\");\n}\n\n/**\n * Amount in words using the South-Asian system (Thousand, Lakh, Crore, Arab) —\n * perfect for invoices. `numberToWords(1234567)` →\n * `\"Twelve Lakh Thirty Four Thousand Five Hundred Sixty Seven\"`.\n */\nexport function numberToWords(value: number): string {\n  let n = Math.floor(Math.abs(value));\n  if (n === 0) return \"Zero\";\n  const parts: string[] = [];\n  const units: [number, string][] = [\n    [1e9, \"Arab\"],\n    [1e7, \"Crore\"],\n    [1e5, \"Lakh\"],\n    [1e3, \"Thousand\"],\n    [1e2, \"Hundred\"],\n  ];\n  for (const [size, name] of units) {\n    if (n >= size) {\n      const count = Math.floor(n / size);\n      // Hundreds are 1–9; the higher units take up to two digits.\n      parts.push((size === 100 ? ONES[count] : twoDigitWords(count)) + \" \" + name);\n      n %= size;\n    }\n  }\n  if (n > 0) parts.push(twoDigitWords(n));\n  return (value < 0 ? \"Minus \" : \"\") + parts.join(\" \");\n}\n\n/** `numberToWords` plus a \"Rupees … only\" wrapper for invoices. */\nexport function amountInWords(amount: number): string {\n  const rupees = Math.floor(Math.abs(amount));\n  const paisa = Math.round((Math.abs(amount) - rupees) * 100);\n  let out = \"Rupees \" + numberToWords(rupees);\n  if (paisa > 0) out += \" and \" + numberToWords(paisa) + \" Paisa\";\n  return (amount < 0 ? \"Minus \" : \"\") + out + \" Only\";\n}\n\n/** True for a valid Nepali mobile number (10 digits starting 96–98, optional +977). */\nexport function isValidNepaliMobile(input: string): boolean {\n  const s = input.replace(/[\\s-]/g, \"\");\n  return /^(\\+?977)?9[678]\\d{8}$/.test(s);\n}\n\n/** True for a valid Nepal PAN / VAT number (9 digits). */\nexport function isValidPAN(input: string): boolean {\n  return /^\\d{9}$/.test(input.trim());\n}\n\nexport interface Province {\n  number: number;\n  name: string;\n  nameNp: string;\n  capital: string;\n}\n\n/** Nepal's seven federal provinces. */\nexport const PROVINCES: readonly Province[] = [\n  { number: 1, name: \"Koshi\", nameNp: \"कोशी\", capital: \"Biratnagar\" },\n  { number: 2, name: \"Madhesh\", nameNp: \"मधेश\", capital: \"Janakpur\" },\n  { number: 3, name: \"Bagmati\", nameNp: \"बागमती\", capital: \"Hetauda\" },\n  { number: 4, name: \"Gandaki\", nameNp: \"गण्डकी\", capital: \"Pokhara\" },\n  { number: 5, name: \"Lumbini\", nameNp: \"लुम्बिनी\", capital: \"Deukhuri\" },\n  { number: 6, name: \"Karnali\", nameNp: \"कर्णाली\", capital: \"Birendranagar\" },\n  { number: 7, name: \"Sudurpashchim\", nameNp: \"सुदूरपश्चिम\", capital: \"Godawari\" },\n];\n"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@lacspace/nepali-utils",
+  "version": "1.0.0",
+  "description": "Everyday Nepal helpers — NPR currency formatting, Devanagari numerals, amount-in-words, validators, provinces. Zero-dependency.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": ["dist"],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["nepal", "nepali", "npr", "currency", "devanagari", "amount-in-words", "validator", "typescript"],
+  "author": "Lacspace <contact@lacspace.com>",
+  "license": "MIT",
+  "homepage": "https://lacspace.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lacspace/npm-packages.git",
+    "directory": "nepali-utils"
+  },
+  "bugs": {
+    "url": "https://github.com/lacspace/npm-packages/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}