@utilix-tech/sdk 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.11.0
+- Added IBAN Validator / Formatter (`validateIban`) and Loan / Mortgage Calculator (`calculateLoan`).
+- (npm publish for this version was retried after fixing a CI pin: `npm install -g npm@latest` started pulling npm 12, which requires Node >=22 and broke on this job's pinned Node 20 — now pinned to the npm 11 line.)
+
 ## 0.10.0
 - Added robots.txt Validator and Credit Card Number Validator.
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**531 developer utility functions for Node.js: runs locally, no API key required.**
+**533 developer utility functions for Node.js: runs locally, no API key required.**
 
 [![npm version](https://img.shields.io/npm/v/@utilix-tech/sdk?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@utilix-tech/sdk)
 [![npm downloads](https://img.shields.io/npm/dm/@utilix-tech/sdk?style=flat-square)](https://www.npmjs.com/package/@utilix-tech/sdk)
@@ -242,7 +242,7 @@ getNextRuns("*/5 * * * *", 5);  // next 5 run timestamps
 ### `/units`: Conversions
 
 ```ts
-import { convertBytes, pxToAll, convert, formatValue, validateCardNumber } from "@utilix-tech/sdk/units";
+import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -264,6 +264,14 @@ formatValue(1234567.89, { locale: "en-US", currency: "USD" });
 // Credit card Luhn checksum + network detection
 validateCardNumber("4111 1111 1111 1111");
 // { valid: true, network: "Visa", length: 16, formatted: "4111 1111 1111 1111" }
+
+// IBAN mod-97 checksum + formatting
+validateIban("DE89 3704 0044 0532 0130 00");
+// { valid: true, countryCode: "DE", checksumValid: true, formatted: "DE89 3704 0044 0532 0130 00", ... }
+
+// Loan / mortgage amortization
+calculateLoan(200000, 6.5, 360);
+// { monthlyPayment: 1264.14, totalInterest: 255085.82, termMonths: 360, schedule: [...] }
 ```
 
 ---

package/dist/{chunk-YVFM5WYI.js → chunk-GGDDCTFM.js}

@@ -16,6 +16,7 @@ __export(units_exports, {
   bumpVersion: () => bumpVersion,
   calcAspectRatio: () => calcAspectRatio,
   calcSubnet: () => calcSubnet,
+  calculateLoan: () => calculateLoan,
   compareSemver: () => compareSemver,
   convert: () => convert,
   convertBytes: () => convertBytes,
@@ -61,6 +62,7 @@ __export(units_exports, {
   splitSubnet: () => splitSubnet,
   symbolicToPermissions: () => symbolicToPermissions,
   validateCardNumber: () => validateCardNumber,
+  validateIban: () => validateIban,
   viewportToPx: () => viewportToPx
 });
 function pxToAll(px, baseFontSize = 16, viewportWidth = 1440, viewportHeight = 900) {
@@ -953,5 +955,165 @@ function validateCardNumber(input) {
   const formatted = formatCardNumber(digits, network);
   return { valid, network, length: digits.length, formatted };
 }
+var IBAN_COUNTRY_LENGTHS = {
+  AD: 24,
+  AE: 23,
+  AL: 28,
+  AT: 20,
+  AZ: 28,
+  BA: 20,
+  BE: 16,
+  BG: 22,
+  BH: 22,
+  BR: 29,
+  BY: 28,
+  CH: 21,
+  CR: 22,
+  CY: 28,
+  CZ: 24,
+  DE: 22,
+  DK: 18,
+  DO: 28,
+  EE: 20,
+  EG: 29,
+  ES: 24,
+  FI: 18,
+  FO: 18,
+  FR: 27,
+  GB: 22,
+  GE: 22,
+  GI: 23,
+  GL: 18,
+  GR: 27,
+  GT: 28,
+  HR: 21,
+  HU: 28,
+  IE: 22,
+  IL: 23,
+  IQ: 23,
+  IS: 26,
+  IT: 27,
+  JO: 30,
+  KW: 30,
+  KZ: 20,
+  LB: 28,
+  LC: 32,
+  LI: 21,
+  LT: 20,
+  LU: 20,
+  LV: 21,
+  LY: 25,
+  MC: 27,
+  MD: 24,
+  ME: 22,
+  MK: 19,
+  MR: 27,
+  MT: 31,
+  MU: 30,
+  NL: 18,
+  NO: 15,
+  PK: 24,
+  PL: 28,
+  PS: 29,
+  PT: 25,
+  QA: 29,
+  RO: 24,
+  RS: 22,
+  SA: 24,
+  SC: 31,
+  SE: 24,
+  SI: 19,
+  SK: 24,
+  SM: 27,
+  ST: 25,
+  SV: 28,
+  TL: 23,
+  TN: 24,
+  TR: 26,
+  UA: 29,
+  VA: 22,
+  VG: 24,
+  XK: 20
+};
+function ibanMod97(numeric) {
+  let remainder = 0;
+  for (let i = 0; i < numeric.length; i += 7) {
+    remainder = parseInt(String(remainder) + numeric.substr(i, 7), 10) % 97;
+  }
+  return remainder;
+}
+function formatIban(cleaned) {
+  return cleaned.match(/.{1,4}/g)?.join(" ") ?? cleaned;
+}
+function validateIban(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const cleaned = input.replace(/\s/g, "").toUpperCase();
+  if (!/^[A-Z0-9]+$/.test(cleaned)) return { error: "IBAN must contain only letters and digits" };
+  if (cleaned.length < 4 || cleaned.length > 34) {
+    return { error: `IBAN length (${cleaned.length}) is outside the valid range of 4-34 characters` };
+  }
+  if (!/^[A-Z]{2}\d{2}/.test(cleaned)) {
+    return { error: "IBAN must start with a 2-letter country code followed by 2 check digits" };
+  }
+  const countryCode = cleaned.slice(0, 2);
+  const checkDigits = cleaned.slice(2, 4);
+  const bban = cleaned.slice(4);
+  const rearranged = cleaned.slice(4) + cleaned.slice(0, 4);
+  const numeric = rearranged.split("").map((ch) => /[A-Z]/.test(ch) ? String(ch.charCodeAt(0) - 55) : ch).join("");
+  const checksumValid = ibanMod97(numeric) === 1;
+  const expectedLength = IBAN_COUNTRY_LENGTHS[countryCode] ?? null;
+  const lengthValid = expectedLength === null ? null : cleaned.length === expectedLength;
+  const valid = checksumValid && lengthValid !== false;
+  return {
+    valid,
+    formatted: formatIban(cleaned),
+    countryCode,
+    checkDigits,
+    bban,
+    length: cleaned.length,
+    expectedLength,
+    checksumValid,
+    lengthValid
+  };
+}
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function calculateLoan(principal, annualRatePercent, termMonths) {
+  if (!Number.isFinite(principal) || principal <= 0) return { error: "Principal must be a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (!Number.isInteger(termMonths) || termMonths <= 0) {
+    return { error: "Term must be a positive whole number of months" };
+  }
+  const monthlyRate = annualRatePercent / 100 / 12;
+  let monthlyPayment;
+  if (monthlyRate === 0) {
+    monthlyPayment = principal / termMonths;
+  } else {
+    const factor = Math.pow(1 + monthlyRate, termMonths);
+    monthlyPayment = principal * monthlyRate * factor / (factor - 1);
+  }
+  const schedule = [];
+  let balance = round2(principal);
+  let totalPayment = 0;
+  for (let month = 1; month <= termMonths; month++) {
+    const interest = monthlyRate === 0 ? 0 : round2(balance * monthlyRate);
+    let principalPortion = round2(monthlyPayment) - interest;
+    if (month === termMonths || principalPortion > balance) principalPortion = balance;
+    const payment = round2(principalPortion + interest);
+    balance = round2(balance - principalPortion);
+    totalPayment += payment;
+    schedule.push({ month, payment, principal: round2(principalPortion), interest, balance: Math.max(balance, 0) });
+  }
+  return {
+    monthlyPayment: round2(monthlyPayment),
+    totalPayment: round2(totalPayment),
+    totalInterest: round2(totalPayment - principal),
+    termMonths,
+    schedule
+  };
+}
 
-export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateCardNumber, viewportToPx };
+export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateLoan, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateCardNumber, validateIban, viewportToPx };

package/dist/index.cjs

@@ -6621,6 +6621,7 @@ __export(units_exports, {
   bumpVersion: () => bumpVersion,
   calcAspectRatio: () => calcAspectRatio,
   calcSubnet: () => calcSubnet,
+  calculateLoan: () => calculateLoan,
   compareSemver: () => compareSemver,
   convert: () => convert,
   convertBytes: () => convertBytes,
@@ -6666,6 +6667,7 @@ __export(units_exports, {
   splitSubnet: () => splitSubnet,
   symbolicToPermissions: () => symbolicToPermissions,
   validateCardNumber: () => validateCardNumber,
+  validateIban: () => validateIban,
   viewportToPx: () => viewportToPx
 });
 function pxToAll(px, baseFontSize = 16, viewportWidth = 1440, viewportHeight = 900) {
@@ -7558,6 +7560,166 @@ function validateCardNumber(input) {
   const formatted = formatCardNumber(digits, network);
   return { valid, network, length: digits.length, formatted };
 }
+var IBAN_COUNTRY_LENGTHS = {
+  AD: 24,
+  AE: 23,
+  AL: 28,
+  AT: 20,
+  AZ: 28,
+  BA: 20,
+  BE: 16,
+  BG: 22,
+  BH: 22,
+  BR: 29,
+  BY: 28,
+  CH: 21,
+  CR: 22,
+  CY: 28,
+  CZ: 24,
+  DE: 22,
+  DK: 18,
+  DO: 28,
+  EE: 20,
+  EG: 29,
+  ES: 24,
+  FI: 18,
+  FO: 18,
+  FR: 27,
+  GB: 22,
+  GE: 22,
+  GI: 23,
+  GL: 18,
+  GR: 27,
+  GT: 28,
+  HR: 21,
+  HU: 28,
+  IE: 22,
+  IL: 23,
+  IQ: 23,
+  IS: 26,
+  IT: 27,
+  JO: 30,
+  KW: 30,
+  KZ: 20,
+  LB: 28,
+  LC: 32,
+  LI: 21,
+  LT: 20,
+  LU: 20,
+  LV: 21,
+  LY: 25,
+  MC: 27,
+  MD: 24,
+  ME: 22,
+  MK: 19,
+  MR: 27,
+  MT: 31,
+  MU: 30,
+  NL: 18,
+  NO: 15,
+  PK: 24,
+  PL: 28,
+  PS: 29,
+  PT: 25,
+  QA: 29,
+  RO: 24,
+  RS: 22,
+  SA: 24,
+  SC: 31,
+  SE: 24,
+  SI: 19,
+  SK: 24,
+  SM: 27,
+  ST: 25,
+  SV: 28,
+  TL: 23,
+  TN: 24,
+  TR: 26,
+  UA: 29,
+  VA: 22,
+  VG: 24,
+  XK: 20
+};
+function ibanMod97(numeric) {
+  let remainder = 0;
+  for (let i = 0; i < numeric.length; i += 7) {
+    remainder = parseInt(String(remainder) + numeric.substr(i, 7), 10) % 97;
+  }
+  return remainder;
+}
+function formatIban(cleaned) {
+  return cleaned.match(/.{1,4}/g)?.join(" ") ?? cleaned;
+}
+function validateIban(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const cleaned = input.replace(/\s/g, "").toUpperCase();
+  if (!/^[A-Z0-9]+$/.test(cleaned)) return { error: "IBAN must contain only letters and digits" };
+  if (cleaned.length < 4 || cleaned.length > 34) {
+    return { error: `IBAN length (${cleaned.length}) is outside the valid range of 4-34 characters` };
+  }
+  if (!/^[A-Z]{2}\d{2}/.test(cleaned)) {
+    return { error: "IBAN must start with a 2-letter country code followed by 2 check digits" };
+  }
+  const countryCode = cleaned.slice(0, 2);
+  const checkDigits = cleaned.slice(2, 4);
+  const bban = cleaned.slice(4);
+  const rearranged = cleaned.slice(4) + cleaned.slice(0, 4);
+  const numeric = rearranged.split("").map((ch) => /[A-Z]/.test(ch) ? String(ch.charCodeAt(0) - 55) : ch).join("");
+  const checksumValid = ibanMod97(numeric) === 1;
+  const expectedLength = IBAN_COUNTRY_LENGTHS[countryCode] ?? null;
+  const lengthValid = expectedLength === null ? null : cleaned.length === expectedLength;
+  const valid = checksumValid && lengthValid !== false;
+  return {
+    valid,
+    formatted: formatIban(cleaned),
+    countryCode,
+    checkDigits,
+    bban,
+    length: cleaned.length,
+    expectedLength,
+    checksumValid,
+    lengthValid
+  };
+}
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function calculateLoan(principal, annualRatePercent, termMonths) {
+  if (!Number.isFinite(principal) || principal <= 0) return { error: "Principal must be a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (!Number.isInteger(termMonths) || termMonths <= 0) {
+    return { error: "Term must be a positive whole number of months" };
+  }
+  const monthlyRate = annualRatePercent / 100 / 12;
+  let monthlyPayment;
+  if (monthlyRate === 0) {
+    monthlyPayment = principal / termMonths;
+  } else {
+    const factor = Math.pow(1 + monthlyRate, termMonths);
+    monthlyPayment = principal * monthlyRate * factor / (factor - 1);
+  }
+  const schedule = [];
+  let balance = round2(principal);
+  let totalPayment = 0;
+  for (let month = 1; month <= termMonths; month++) {
+    const interest = monthlyRate === 0 ? 0 : round2(balance * monthlyRate);
+    let principalPortion = round2(monthlyPayment) - interest;
+    if (month === termMonths || principalPortion > balance) principalPortion = balance;
+    const payment = round2(principalPortion + interest);
+    balance = round2(balance - principalPortion);
+    totalPayment += payment;
+    schedule.push({ month, payment, principal: round2(principalPortion), interest, balance: Math.max(balance, 0) });
+  }
+  return {
+    monthlyPayment: round2(monthlyPayment),
+    totalPayment: round2(totalPayment),
+    totalInterest: round2(totalPayment - principal),
+    termMonths,
+    schedule
+  };
+}
 
 // src/tools/network.ts
 var network_exports = {};
@@ -17452,12 +17614,12 @@ function readGpsCoordinate(r, entries, valueTag, refTag) {
 function gcd2(a, b) {
   return b === 0 ? a : gcd2(b, a % b);
 }
-function round2(n) {
+function round22(n) {
   return Math.round(n * 100) / 100;
 }
 function formatExposureTime(num, den) {
   if (num === 0) return "0s";
-  if (num >= den) return `${round2(num / den)}s`;
+  if (num >= den) return `${round22(num / den)}s`;
   const divisor = gcd2(num, den) || 1;
   const n = num / divisor;
   const d = den / divisor;
@@ -17546,14 +17708,14 @@ function readExifData(bytes) {
       const fEntry = findEntry(sub.entries, 33437);
       if (fEntry) {
         const rat = readRational(r, fEntry);
-        if (rat && rat.den !== 0) result.fNumber = round2(rat.num / rat.den);
+        if (rat && rat.den !== 0) result.fNumber = round22(rat.num / rat.den);
       }
       const isoEntry = findEntry(sub.entries, 34855);
       if (isoEntry) result.isoSpeed = tu16(r, isoEntry.valueOffsetField);
       const focalEntry = findEntry(sub.entries, 37386);
       if (focalEntry) {
         const rat = readRational(r, focalEntry);
-        if (rat && rat.den !== 0) result.focalLength = round2(rat.num / rat.den);
+        if (rat && rat.den !== 0) result.focalLength = round22(rat.num / rat.den);
       }
     }
   }

package/dist/index.d.cts

@@ -5,7 +5,7 @@ export { t as text } from './text-Bbx-tZ43.cjs';
 export { d as data } from './data-D8XTI7Du.cjs';
 export { g as generators } from './generators-BGtRGpJZ.cjs';
 export { t as time } from './time-DbT8fjaF.cjs';
-export { u as units } from './units-DRT6W-vu.cjs';
+export { u as units } from './units-BG387sch.cjs';
 export { n as network } from './network-DaNoZ5ER.cjs';
 export { a as api } from './api-Xl7OzIgq.cjs';
 export { c as code } from './code-BUqyaofO.cjs';

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { t as text } from './text-Bbx-tZ43.js';
 export { d as data } from './data-D8XTI7Du.js';
 export { g as generators } from './generators-BGtRGpJZ.js';
 export { t as time } from './time-DbT8fjaF.js';
-export { u as units } from './units-DRT6W-vu.js';
+export { u as units } from './units-BG387sch.js';
 export { n as network } from './network-DaNoZ5ER.js';
 export { a as api } from './api-Xl7OzIgq.js';
 export { c as code } from './code-BUqyaofO.js';

package/dist/index.js

@@ -1,5 +1,5 @@
 export { media_exports as media } from './chunk-GUUYEIU6.js';
-export { units_exports as units } from './chunk-YVFM5WYI.js';
+export { units_exports as units } from './chunk-GGDDCTFM.js';
 export { network_exports as network } from './chunk-OB56VNKJ.js';
 export { api_exports as api } from './chunk-Q3B3YWOA.js';
 export { code_exports as code } from './chunk-V5S6OJ4A.js';

package/dist/tools/units.cjs

@@ -891,6 +891,166 @@ function validateCardNumber(input) {
   const formatted = formatCardNumber(digits, network);
   return { valid, network, length: digits.length, formatted };
 }
+var IBAN_COUNTRY_LENGTHS = {
+  AD: 24,
+  AE: 23,
+  AL: 28,
+  AT: 20,
+  AZ: 28,
+  BA: 20,
+  BE: 16,
+  BG: 22,
+  BH: 22,
+  BR: 29,
+  BY: 28,
+  CH: 21,
+  CR: 22,
+  CY: 28,
+  CZ: 24,
+  DE: 22,
+  DK: 18,
+  DO: 28,
+  EE: 20,
+  EG: 29,
+  ES: 24,
+  FI: 18,
+  FO: 18,
+  FR: 27,
+  GB: 22,
+  GE: 22,
+  GI: 23,
+  GL: 18,
+  GR: 27,
+  GT: 28,
+  HR: 21,
+  HU: 28,
+  IE: 22,
+  IL: 23,
+  IQ: 23,
+  IS: 26,
+  IT: 27,
+  JO: 30,
+  KW: 30,
+  KZ: 20,
+  LB: 28,
+  LC: 32,
+  LI: 21,
+  LT: 20,
+  LU: 20,
+  LV: 21,
+  LY: 25,
+  MC: 27,
+  MD: 24,
+  ME: 22,
+  MK: 19,
+  MR: 27,
+  MT: 31,
+  MU: 30,
+  NL: 18,
+  NO: 15,
+  PK: 24,
+  PL: 28,
+  PS: 29,
+  PT: 25,
+  QA: 29,
+  RO: 24,
+  RS: 22,
+  SA: 24,
+  SC: 31,
+  SE: 24,
+  SI: 19,
+  SK: 24,
+  SM: 27,
+  ST: 25,
+  SV: 28,
+  TL: 23,
+  TN: 24,
+  TR: 26,
+  UA: 29,
+  VA: 22,
+  VG: 24,
+  XK: 20
+};
+function ibanMod97(numeric) {
+  let remainder = 0;
+  for (let i = 0; i < numeric.length; i += 7) {
+    remainder = parseInt(String(remainder) + numeric.substr(i, 7), 10) % 97;
+  }
+  return remainder;
+}
+function formatIban(cleaned) {
+  return cleaned.match(/.{1,4}/g)?.join(" ") ?? cleaned;
+}
+function validateIban(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const cleaned = input.replace(/\s/g, "").toUpperCase();
+  if (!/^[A-Z0-9]+$/.test(cleaned)) return { error: "IBAN must contain only letters and digits" };
+  if (cleaned.length < 4 || cleaned.length > 34) {
+    return { error: `IBAN length (${cleaned.length}) is outside the valid range of 4-34 characters` };
+  }
+  if (!/^[A-Z]{2}\d{2}/.test(cleaned)) {
+    return { error: "IBAN must start with a 2-letter country code followed by 2 check digits" };
+  }
+  const countryCode = cleaned.slice(0, 2);
+  const checkDigits = cleaned.slice(2, 4);
+  const bban = cleaned.slice(4);
+  const rearranged = cleaned.slice(4) + cleaned.slice(0, 4);
+  const numeric = rearranged.split("").map((ch) => /[A-Z]/.test(ch) ? String(ch.charCodeAt(0) - 55) : ch).join("");
+  const checksumValid = ibanMod97(numeric) === 1;
+  const expectedLength = IBAN_COUNTRY_LENGTHS[countryCode] ?? null;
+  const lengthValid = expectedLength === null ? null : cleaned.length === expectedLength;
+  const valid = checksumValid && lengthValid !== false;
+  return {
+    valid,
+    formatted: formatIban(cleaned),
+    countryCode,
+    checkDigits,
+    bban,
+    length: cleaned.length,
+    expectedLength,
+    checksumValid,
+    lengthValid
+  };
+}
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function calculateLoan(principal, annualRatePercent, termMonths) {
+  if (!Number.isFinite(principal) || principal <= 0) return { error: "Principal must be a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (!Number.isInteger(termMonths) || termMonths <= 0) {
+    return { error: "Term must be a positive whole number of months" };
+  }
+  const monthlyRate = annualRatePercent / 100 / 12;
+  let monthlyPayment;
+  if (monthlyRate === 0) {
+    monthlyPayment = principal / termMonths;
+  } else {
+    const factor = Math.pow(1 + monthlyRate, termMonths);
+    monthlyPayment = principal * monthlyRate * factor / (factor - 1);
+  }
+  const schedule = [];
+  let balance = round2(principal);
+  let totalPayment = 0;
+  for (let month = 1; month <= termMonths; month++) {
+    const interest = monthlyRate === 0 ? 0 : round2(balance * monthlyRate);
+    let principalPortion = round2(monthlyPayment) - interest;
+    if (month === termMonths || principalPortion > balance) principalPortion = balance;
+    const payment = round2(principalPortion + interest);
+    balance = round2(balance - principalPortion);
+    totalPayment += payment;
+    schedule.push({ month, payment, principal: round2(principalPortion), interest, balance: Math.max(balance, 0) });
+  }
+  return {
+    monthlyPayment: round2(monthlyPayment),
+    totalPayment: round2(totalPayment),
+    totalInterest: round2(totalPayment - principal),
+    termMonths,
+    schedule
+  };
+}
 
 exports.BASE_LABELS = BASE_LABELS;
 exports.BASE_PREFIXES = BASE_PREFIXES;
@@ -905,6 +1065,7 @@ exports.autoFormat = autoFormat;
 exports.bumpVersion = bumpVersion;
 exports.calcAspectRatio = calcAspectRatio;
 exports.calcSubnet = calcSubnet;
+exports.calculateLoan = calculateLoan;
 exports.compareSemver = compareSemver;
 exports.convert = convert;
 exports.convertBytes = convertBytes;
@@ -950,4 +1111,5 @@ exports.sortVersions = sortVersions;
 exports.splitSubnet = splitSubnet;
 exports.symbolicToPermissions = symbolicToPermissions;
 exports.validateCardNumber = validateCardNumber;
+exports.validateIban = validateIban;
 exports.viewportToPx = viewportToPx;

package/dist/tools/units.d.cts

@@ -1 +1 @@
-export { A as AspectRatioResult, B as BASE_LABELS, a as BASE_PREFIXES, b as BYTE_UNITS, c as BaseConvertResult, d as ByteConvertResult, e as ByteUnit, C as COMMON_CURRENCIES, f as COMMON_LOCALES, g as COMMON_PERMISSIONS, h as COMMON_RATIOS, i as COMMON_SIZES, j as COMMON_VIEWPORTS, k as CardValidationResult, D as Dimensions, F as FilePermissions, l as FormatOptions, I as IpConversion, N as NotationStyle, m as NumberBase, P as Permission, n as PxConvertResult, S as SemverVersion, o as SubnetInfo, V as ViewportConvertResult, p as autoFormat, q as bumpVersion, r as calcAspectRatio, s as calcSubnet, t as compareSemver, v as convert, w as convertBytes, x as convertIp, y as coverBox, z as decimalToIp, E as decimalToIpCidr, G as describePermissions, H as fitIntoBox, J as formatNumber, K as formatValue, L as formatVwValue, M as formatWithSeparator, O as gcd, Q as ipFromBinary, R as ipFromDecimal, T as ipFromHex, U as ipToBinary, W as ipToDecimal, X as ipToDecimalCidr, Y as ipToHex, Z as ipToOctal, _ as isValid, $ as isValidCidr, a0 as isValidIp, a1 as isValidIpv4, a2 as octalToPermissions, a3 as parseFileSize, a4 as parseInput, a5 as parseNumberString, a6 as parseSemver, a7 as permissionsToChmod, a8 as permissionsToOctal, a9 as permissionsToSymbolic, aa as ptToPx, ab as pxToAll, ac as pxToViewport, ad as remToPx, ae as satisfiesRange, af as scaleByHeight, ag as scaleByWidth, ah as sortVersions, ai as splitSubnet, aj as symbolicToPermissions, ak as validateCardNumber, al as viewportToPx } from '../units-DRT6W-vu.cjs';
+export { A as AmortizationRow, a as AspectRatioResult, B as BASE_LABELS, b as BASE_PREFIXES, c as BYTE_UNITS, d as BaseConvertResult, e as ByteConvertResult, f as ByteUnit, C as COMMON_CURRENCIES, g as COMMON_LOCALES, h as COMMON_PERMISSIONS, i as COMMON_RATIOS, j as COMMON_SIZES, k as COMMON_VIEWPORTS, l as CardValidationResult, D as Dimensions, F as FilePermissions, m as FormatOptions, I as IbanValidationResult, n as IpConversion, L as LoanResult, N as NotationStyle, o as NumberBase, P as Permission, p as PxConvertResult, S as SemverVersion, q as SubnetInfo, V as ViewportConvertResult, r as autoFormat, s as bumpVersion, t as calcAspectRatio, v as calcSubnet, w as calculateLoan, x as compareSemver, y as convert, z as convertBytes, E as convertIp, G as coverBox, H as decimalToIp, J as decimalToIpCidr, K as describePermissions, M as fitIntoBox, O as formatNumber, Q as formatValue, R as formatVwValue, T as formatWithSeparator, U as gcd, W as ipFromBinary, X as ipFromDecimal, Y as ipFromHex, Z as ipToBinary, _ as ipToDecimal, $ as ipToDecimalCidr, a0 as ipToHex, a1 as ipToOctal, a2 as isValid, a3 as isValidCidr, a4 as isValidIp, a5 as isValidIpv4, a6 as octalToPermissions, a7 as parseFileSize, a8 as parseInput, a9 as parseNumberString, aa as parseSemver, ab as permissionsToChmod, ac as permissionsToOctal, ad as permissionsToSymbolic, ae as ptToPx, af as pxToAll, ag as pxToViewport, ah as remToPx, ai as satisfiesRange, aj as scaleByHeight, ak as scaleByWidth, al as sortVersions, am as splitSubnet, an as symbolicToPermissions, ao as validateCardNumber, ap as validateIban, aq as viewportToPx } from '../units-BG387sch.cjs';

package/dist/tools/units.d.ts

@@ -1 +1 @@
-export { A as AspectRatioResult, B as BASE_LABELS, a as BASE_PREFIXES, b as BYTE_UNITS, c as BaseConvertResult, d as ByteConvertResult, e as ByteUnit, C as COMMON_CURRENCIES, f as COMMON_LOCALES, g as COMMON_PERMISSIONS, h as COMMON_RATIOS, i as COMMON_SIZES, j as COMMON_VIEWPORTS, k as CardValidationResult, D as Dimensions, F as FilePermissions, l as FormatOptions, I as IpConversion, N as NotationStyle, m as NumberBase, P as Permission, n as PxConvertResult, S as SemverVersion, o as SubnetInfo, V as ViewportConvertResult, p as autoFormat, q as bumpVersion, r as calcAspectRatio, s as calcSubnet, t as compareSemver, v as convert, w as convertBytes, x as convertIp, y as coverBox, z as decimalToIp, E as decimalToIpCidr, G as describePermissions, H as fitIntoBox, J as formatNumber, K as formatValue, L as formatVwValue, M as formatWithSeparator, O as gcd, Q as ipFromBinary, R as ipFromDecimal, T as ipFromHex, U as ipToBinary, W as ipToDecimal, X as ipToDecimalCidr, Y as ipToHex, Z as ipToOctal, _ as isValid, $ as isValidCidr, a0 as isValidIp, a1 as isValidIpv4, a2 as octalToPermissions, a3 as parseFileSize, a4 as parseInput, a5 as parseNumberString, a6 as parseSemver, a7 as permissionsToChmod, a8 as permissionsToOctal, a9 as permissionsToSymbolic, aa as ptToPx, ab as pxToAll, ac as pxToViewport, ad as remToPx, ae as satisfiesRange, af as scaleByHeight, ag as scaleByWidth, ah as sortVersions, ai as splitSubnet, aj as symbolicToPermissions, ak as validateCardNumber, al as viewportToPx } from '../units-DRT6W-vu.js';
+export { A as AmortizationRow, a as AspectRatioResult, B as BASE_LABELS, b as BASE_PREFIXES, c as BYTE_UNITS, d as BaseConvertResult, e as ByteConvertResult, f as ByteUnit, C as COMMON_CURRENCIES, g as COMMON_LOCALES, h as COMMON_PERMISSIONS, i as COMMON_RATIOS, j as COMMON_SIZES, k as COMMON_VIEWPORTS, l as CardValidationResult, D as Dimensions, F as FilePermissions, m as FormatOptions, I as IbanValidationResult, n as IpConversion, L as LoanResult, N as NotationStyle, o as NumberBase, P as Permission, p as PxConvertResult, S as SemverVersion, q as SubnetInfo, V as ViewportConvertResult, r as autoFormat, s as bumpVersion, t as calcAspectRatio, v as calcSubnet, w as calculateLoan, x as compareSemver, y as convert, z as convertBytes, E as convertIp, G as coverBox, H as decimalToIp, J as decimalToIpCidr, K as describePermissions, M as fitIntoBox, O as formatNumber, Q as formatValue, R as formatVwValue, T as formatWithSeparator, U as gcd, W as ipFromBinary, X as ipFromDecimal, Y as ipFromHex, Z as ipToBinary, _ as ipToDecimal, $ as ipToDecimalCidr, a0 as ipToHex, a1 as ipToOctal, a2 as isValid, a3 as isValidCidr, a4 as isValidIp, a5 as isValidIpv4, a6 as octalToPermissions, a7 as parseFileSize, a8 as parseInput, a9 as parseNumberString, aa as parseSemver, ab as permissionsToChmod, ac as permissionsToOctal, ad as permissionsToSymbolic, ae as ptToPx, af as pxToAll, ag as pxToViewport, ah as remToPx, ai as satisfiesRange, aj as scaleByHeight, ak as scaleByWidth, al as sortVersions, am as splitSubnet, an as symbolicToPermissions, ao as validateCardNumber, ap as validateIban, aq as viewportToPx } from '../units-BG387sch.js';

package/dist/tools/units.js

@@ -1,2 +1,2 @@
-export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, validateCardNumber, viewportToPx } from '../chunk-YVFM5WYI.js';
+export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateLoan, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, validateCardNumber, validateIban, viewportToPx } from '../chunk-GGDDCTFM.js';
 import '../chunk-MLKGABMK.js';

package/dist/{units-DRT6W-vu.d.cts → units-BG387sch.d.cts}

@@ -13,6 +13,8 @@
  *  - cidr-calc     : calcSubnet, splitSubnet, isValidCidr, isValidIp, ipToDecimal (cidr), decimalToIp (cidr)
  *  - semver        : parseSemver, isValid, compareSemver, satisfiesRange, bumpVersion, sortVersions
  *  - credit-card-validator : validateCardNumber
+ *  - iban-validator : validateIban
+ *  - loan-calculator : calculateLoan
  */
 interface PxConvertResult {
     px: number;
@@ -236,7 +238,49 @@ interface CardValidationResult {
 declare function validateCardNumber(input: string): CardValidationResult | {
     error: string;
 };
+interface IbanValidationResult {
+    valid: boolean;
+    formatted: string;
+    countryCode: string;
+    checkDigits: string;
+    bban: string;
+    length: number;
+    expectedLength: number | null;
+    checksumValid: boolean;
+    lengthValid: boolean | null;
+}
+/**
+ * Validate an IBAN via the mod-97 checksum defined by ISO 13616 and format
+ * it into the standard human-readable grouped form. Also cross-checks the
+ * total length against the country's registered fixed length where known.
+ */
+declare function validateIban(input: string): IbanValidationResult | {
+    error: string;
+};
+interface AmortizationRow {
+    month: number;
+    payment: number;
+    principal: number;
+    interest: number;
+    balance: number;
+}
+interface LoanResult {
+    monthlyPayment: number;
+    totalPayment: number;
+    totalInterest: number;
+    termMonths: number;
+    schedule: AmortizationRow[];
+}
+/**
+ * Compute the monthly payment, total interest, and full amortization
+ * schedule for a fixed-rate loan or mortgage, given the principal, annual
+ * interest rate (as a percent, e.g. 6.5), and term in months.
+ */
+declare function calculateLoan(principal: number, annualRatePercent: number, termMonths: number): LoanResult | {
+    error: string;
+};
 
+type units_AmortizationRow = AmortizationRow;
 type units_AspectRatioResult = AspectRatioResult;
 declare const units_BASE_LABELS: typeof BASE_LABELS;
 declare const units_BASE_PREFIXES: typeof BASE_PREFIXES;
@@ -254,7 +298,9 @@ type units_CardValidationResult = CardValidationResult;
 type units_Dimensions = Dimensions;
 type units_FilePermissions = FilePermissions;
 type units_FormatOptions = FormatOptions;
+type units_IbanValidationResult = IbanValidationResult;
 type units_IpConversion = IpConversion;
+type units_LoanResult = LoanResult;
 type units_NotationStyle = NotationStyle;
 type units_NumberBase = NumberBase;
 type units_Permission = Permission;
@@ -266,6 +312,7 @@ declare const units_autoFormat: typeof autoFormat;
 declare const units_bumpVersion: typeof bumpVersion;
 declare const units_calcAspectRatio: typeof calcAspectRatio;
 declare const units_calcSubnet: typeof calcSubnet;
+declare const units_calculateLoan: typeof calculateLoan;
 declare const units_compareSemver: typeof compareSemver;
 declare const units_convert: typeof convert;
 declare const units_convertBytes: typeof convertBytes;
@@ -311,9 +358,10 @@ declare const units_sortVersions: typeof sortVersions;
 declare const units_splitSubnet: typeof splitSubnet;
 declare const units_symbolicToPermissions: typeof symbolicToPermissions;
 declare const units_validateCardNumber: typeof validateCardNumber;
+declare const units_validateIban: typeof validateIban;
 declare const units_viewportToPx: typeof viewportToPx;
 declare namespace units {
-  export { type units_AspectRatioResult as AspectRatioResult, units_BASE_LABELS as BASE_LABELS, units_BASE_PREFIXES as BASE_PREFIXES, units_BYTE_UNITS as BYTE_UNITS, type units_BaseConvertResult as BaseConvertResult, type units_ByteConvertResult as ByteConvertResult, type units_ByteUnit as ByteUnit, units_COMMON_CURRENCIES as COMMON_CURRENCIES, units_COMMON_LOCALES as COMMON_LOCALES, units_COMMON_PERMISSIONS as COMMON_PERMISSIONS, units_COMMON_RATIOS as COMMON_RATIOS, units_COMMON_SIZES as COMMON_SIZES, units_COMMON_VIEWPORTS as COMMON_VIEWPORTS, type units_CardValidationResult as CardValidationResult, type units_Dimensions as Dimensions, type units_FilePermissions as FilePermissions, type units_FormatOptions as FormatOptions, type units_IpConversion as IpConversion, type units_NotationStyle as NotationStyle, type units_NumberBase as NumberBase, type units_Permission as Permission, type units_PxConvertResult as PxConvertResult, type units_SemverVersion as SemverVersion, type units_SubnetInfo as SubnetInfo, type units_ViewportConvertResult as ViewportConvertResult, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_compareSemver as compareSemver, units_convert as convert, units_convertBytes as convertBytes, units_convertIp as convertIp, units_coverBox as coverBox, units_decimalToIp as decimalToIp, units_decimalToIpCidr as decimalToIpCidr, units_describePermissions as describePermissions, units_fitIntoBox as fitIntoBox, units_formatNumber as formatNumber, units_formatValue as formatValue, units_formatVwValue as formatVwValue, units_formatWithSeparator as formatWithSeparator, units_gcd as gcd, units_ipFromBinary as ipFromBinary, units_ipFromDecimal as ipFromDecimal, units_ipFromHex as ipFromHex, units_ipToBinary as ipToBinary, units_ipToDecimal as ipToDecimal, units_ipToDecimalCidr as ipToDecimalCidr, units_ipToHex as ipToHex, units_ipToOctal as ipToOctal, units_isValid as isValid, units_isValidCidr as isValidCidr, units_isValidIp as isValidIp, units_isValidIpv4 as isValidIpv4, units_octalToPermissions as octalToPermissions, units_parseFileSize as parseFileSize, units_parseInput as parseInput, units_parseNumberString as parseNumberString, units_parseSemver as parseSemver, units_permissionsToChmod as permissionsToChmod, units_permissionsToOctal as permissionsToOctal, units_permissionsToSymbolic as permissionsToSymbolic, units_ptToPx as ptToPx, units_pxToAll as pxToAll, units_pxToViewport as pxToViewport, units_remToPx as remToPx, units_satisfiesRange as satisfiesRange, units_scaleByHeight as scaleByHeight, units_scaleByWidth as scaleByWidth, units_sortVersions as sortVersions, units_splitSubnet as splitSubnet, units_symbolicToPermissions as symbolicToPermissions, units_validateCardNumber as validateCardNumber, units_viewportToPx as viewportToPx };
+  export { type units_AmortizationRow as AmortizationRow, type units_AspectRatioResult as AspectRatioResult, units_BASE_LABELS as BASE_LABELS, units_BASE_PREFIXES as BASE_PREFIXES, units_BYTE_UNITS as BYTE_UNITS, type units_BaseConvertResult as BaseConvertResult, type units_ByteConvertResult as ByteConvertResult, type units_ByteUnit as ByteUnit, units_COMMON_CURRENCIES as COMMON_CURRENCIES, units_COMMON_LOCALES as COMMON_LOCALES, units_COMMON_PERMISSIONS as COMMON_PERMISSIONS, units_COMMON_RATIOS as COMMON_RATIOS, units_COMMON_SIZES as COMMON_SIZES, units_COMMON_VIEWPORTS as COMMON_VIEWPORTS, type units_CardValidationResult as CardValidationResult, type units_Dimensions as Dimensions, type units_FilePermissions as FilePermissions, type units_FormatOptions as FormatOptions, type units_IbanValidationResult as IbanValidationResult, type units_IpConversion as IpConversion, type units_LoanResult as LoanResult, type units_NotationStyle as NotationStyle, type units_NumberBase as NumberBase, type units_Permission as Permission, type units_PxConvertResult as PxConvertResult, type units_SemverVersion as SemverVersion, type units_SubnetInfo as SubnetInfo, type units_ViewportConvertResult as ViewportConvertResult, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateLoan as calculateLoan, units_compareSemver as compareSemver, units_convert as convert, units_convertBytes as convertBytes, units_convertIp as convertIp, units_coverBox as coverBox, units_decimalToIp as decimalToIp, units_decimalToIpCidr as decimalToIpCidr, units_describePermissions as describePermissions, units_fitIntoBox as fitIntoBox, units_formatNumber as formatNumber, units_formatValue as formatValue, units_formatVwValue as formatVwValue, units_formatWithSeparator as formatWithSeparator, units_gcd as gcd, units_ipFromBinary as ipFromBinary, units_ipFromDecimal as ipFromDecimal, units_ipFromHex as ipFromHex, units_ipToBinary as ipToBinary, units_ipToDecimal as ipToDecimal, units_ipToDecimalCidr as ipToDecimalCidr, units_ipToHex as ipToHex, units_ipToOctal as ipToOctal, units_isValid as isValid, units_isValidCidr as isValidCidr, units_isValidIp as isValidIp, units_isValidIpv4 as isValidIpv4, units_octalToPermissions as octalToPermissions, units_parseFileSize as parseFileSize, units_parseInput as parseInput, units_parseNumberString as parseNumberString, units_parseSemver as parseSemver, units_permissionsToChmod as permissionsToChmod, units_permissionsToOctal as permissionsToOctal, units_permissionsToSymbolic as permissionsToSymbolic, units_ptToPx as ptToPx, units_pxToAll as pxToAll, units_pxToViewport as pxToViewport, units_remToPx as remToPx, units_satisfiesRange as satisfiesRange, units_scaleByHeight as scaleByHeight, units_scaleByWidth as scaleByWidth, units_sortVersions as sortVersions, units_splitSubnet as splitSubnet, units_symbolicToPermissions as symbolicToPermissions, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, units_viewportToPx as viewportToPx };
 }
 
-export { isValidCidr as $, type AspectRatioResult as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, decimalToIpCidr as E, type FilePermissions as F, describePermissions as G, fitIntoBox as H, type IpConversion as I, formatNumber as J, formatValue as K, formatVwValue as L, formatWithSeparator as M, type NotationStyle as N, gcd as O, type Permission as P, ipFromBinary as Q, ipFromDecimal as R, type SemverVersion as S, ipFromHex as T, ipToBinary as U, type ViewportConvertResult as V, ipToDecimal as W, ipToDecimalCidr as X, ipToHex as Y, ipToOctal as Z, isValid as _, BASE_PREFIXES as a, isValidIp as a0, isValidIpv4 as a1, octalToPermissions as a2, parseFileSize as a3, parseInput as a4, parseNumberString as a5, parseSemver as a6, permissionsToChmod as a7, permissionsToOctal as a8, permissionsToSymbolic as a9, ptToPx as aa, pxToAll as ab, pxToViewport as ac, remToPx as ad, satisfiesRange as ae, scaleByHeight as af, scaleByWidth as ag, sortVersions as ah, splitSubnet as ai, symbolicToPermissions as aj, validateCardNumber as ak, viewportToPx as al, BYTE_UNITS as b, type BaseConvertResult as c, type ByteConvertResult as d, type ByteUnit as e, COMMON_LOCALES as f, COMMON_PERMISSIONS as g, COMMON_RATIOS as h, COMMON_SIZES as i, COMMON_VIEWPORTS as j, type CardValidationResult as k, type FormatOptions as l, type NumberBase as m, type PxConvertResult as n, type SubnetInfo as o, autoFormat as p, bumpVersion as q, calcAspectRatio as r, calcSubnet as s, compareSemver as t, units as u, convert as v, convertBytes as w, convertIp as x, coverBox as y, decimalToIp as z };
+export { ipToDecimalCidr as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, convertIp as E, type FilePermissions as F, coverBox as G, decimalToIp as H, type IbanValidationResult as I, decimalToIpCidr as J, describePermissions as K, type LoanResult as L, fitIntoBox as M, type NotationStyle as N, formatNumber as O, type Permission as P, formatValue as Q, formatVwValue as R, type SemverVersion as S, formatWithSeparator as T, gcd as U, type ViewportConvertResult as V, ipFromBinary as W, ipFromDecimal as X, ipFromHex as Y, ipToBinary as Z, ipToDecimal as _, type AspectRatioResult as a, ipToHex as a0, ipToOctal as a1, isValid as a2, isValidCidr as a3, isValidIp as a4, isValidIpv4 as a5, octalToPermissions as a6, parseFileSize as a7, parseInput as a8, parseNumberString as a9, parseSemver as aa, permissionsToChmod as ab, permissionsToOctal as ac, permissionsToSymbolic as ad, ptToPx as ae, pxToAll as af, pxToViewport as ag, remToPx as ah, satisfiesRange as ai, scaleByHeight as aj, scaleByWidth as ak, sortVersions as al, splitSubnet as am, symbolicToPermissions as an, validateCardNumber as ao, validateIban as ap, viewportToPx as aq, BASE_PREFIXES as b, BYTE_UNITS as c, type BaseConvertResult as d, type ByteConvertResult as e, type ByteUnit as f, COMMON_LOCALES as g, COMMON_PERMISSIONS as h, COMMON_RATIOS as i, COMMON_SIZES as j, COMMON_VIEWPORTS as k, type CardValidationResult as l, type FormatOptions as m, type IpConversion as n, type NumberBase as o, type PxConvertResult as p, type SubnetInfo as q, autoFormat as r, bumpVersion as s, calcAspectRatio as t, units as u, calcSubnet as v, calculateLoan as w, compareSemver as x, convert as y, convertBytes as z };

package/dist/{units-DRT6W-vu.d.ts → units-BG387sch.d.ts}

@@ -13,6 +13,8 @@
  *  - cidr-calc     : calcSubnet, splitSubnet, isValidCidr, isValidIp, ipToDecimal (cidr), decimalToIp (cidr)
  *  - semver        : parseSemver, isValid, compareSemver, satisfiesRange, bumpVersion, sortVersions
  *  - credit-card-validator : validateCardNumber
+ *  - iban-validator : validateIban
+ *  - loan-calculator : calculateLoan
  */
 interface PxConvertResult {
     px: number;
@@ -236,7 +238,49 @@ interface CardValidationResult {
 declare function validateCardNumber(input: string): CardValidationResult | {
     error: string;
 };
+interface IbanValidationResult {
+    valid: boolean;
+    formatted: string;
+    countryCode: string;
+    checkDigits: string;
+    bban: string;
+    length: number;
+    expectedLength: number | null;
+    checksumValid: boolean;
+    lengthValid: boolean | null;
+}
+/**
+ * Validate an IBAN via the mod-97 checksum defined by ISO 13616 and format
+ * it into the standard human-readable grouped form. Also cross-checks the
+ * total length against the country's registered fixed length where known.
+ */
+declare function validateIban(input: string): IbanValidationResult | {
+    error: string;
+};
+interface AmortizationRow {
+    month: number;
+    payment: number;
+    principal: number;
+    interest: number;
+    balance: number;
+}
+interface LoanResult {
+    monthlyPayment: number;
+    totalPayment: number;
+    totalInterest: number;
+    termMonths: number;
+    schedule: AmortizationRow[];
+}
+/**
+ * Compute the monthly payment, total interest, and full amortization
+ * schedule for a fixed-rate loan or mortgage, given the principal, annual
+ * interest rate (as a percent, e.g. 6.5), and term in months.
+ */
+declare function calculateLoan(principal: number, annualRatePercent: number, termMonths: number): LoanResult | {
+    error: string;
+};
 
+type units_AmortizationRow = AmortizationRow;
 type units_AspectRatioResult = AspectRatioResult;
 declare const units_BASE_LABELS: typeof BASE_LABELS;
 declare const units_BASE_PREFIXES: typeof BASE_PREFIXES;
@@ -254,7 +298,9 @@ type units_CardValidationResult = CardValidationResult;
 type units_Dimensions = Dimensions;
 type units_FilePermissions = FilePermissions;
 type units_FormatOptions = FormatOptions;
+type units_IbanValidationResult = IbanValidationResult;
 type units_IpConversion = IpConversion;
+type units_LoanResult = LoanResult;
 type units_NotationStyle = NotationStyle;
 type units_NumberBase = NumberBase;
 type units_Permission = Permission;
@@ -266,6 +312,7 @@ declare const units_autoFormat: typeof autoFormat;
 declare const units_bumpVersion: typeof bumpVersion;
 declare const units_calcAspectRatio: typeof calcAspectRatio;
 declare const units_calcSubnet: typeof calcSubnet;
+declare const units_calculateLoan: typeof calculateLoan;
 declare const units_compareSemver: typeof compareSemver;
 declare const units_convert: typeof convert;
 declare const units_convertBytes: typeof convertBytes;
@@ -311,9 +358,10 @@ declare const units_sortVersions: typeof sortVersions;
 declare const units_splitSubnet: typeof splitSubnet;
 declare const units_symbolicToPermissions: typeof symbolicToPermissions;
 declare const units_validateCardNumber: typeof validateCardNumber;
+declare const units_validateIban: typeof validateIban;
 declare const units_viewportToPx: typeof viewportToPx;
 declare namespace units {
-  export { type units_AspectRatioResult as AspectRatioResult, units_BASE_LABELS as BASE_LABELS, units_BASE_PREFIXES as BASE_PREFIXES, units_BYTE_UNITS as BYTE_UNITS, type units_BaseConvertResult as BaseConvertResult, type units_ByteConvertResult as ByteConvertResult, type units_ByteUnit as ByteUnit, units_COMMON_CURRENCIES as COMMON_CURRENCIES, units_COMMON_LOCALES as COMMON_LOCALES, units_COMMON_PERMISSIONS as COMMON_PERMISSIONS, units_COMMON_RATIOS as COMMON_RATIOS, units_COMMON_SIZES as COMMON_SIZES, units_COMMON_VIEWPORTS as COMMON_VIEWPORTS, type units_CardValidationResult as CardValidationResult, type units_Dimensions as Dimensions, type units_FilePermissions as FilePermissions, type units_FormatOptions as FormatOptions, type units_IpConversion as IpConversion, type units_NotationStyle as NotationStyle, type units_NumberBase as NumberBase, type units_Permission as Permission, type units_PxConvertResult as PxConvertResult, type units_SemverVersion as SemverVersion, type units_SubnetInfo as SubnetInfo, type units_ViewportConvertResult as ViewportConvertResult, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_compareSemver as compareSemver, units_convert as convert, units_convertBytes as convertBytes, units_convertIp as convertIp, units_coverBox as coverBox, units_decimalToIp as decimalToIp, units_decimalToIpCidr as decimalToIpCidr, units_describePermissions as describePermissions, units_fitIntoBox as fitIntoBox, units_formatNumber as formatNumber, units_formatValue as formatValue, units_formatVwValue as formatVwValue, units_formatWithSeparator as formatWithSeparator, units_gcd as gcd, units_ipFromBinary as ipFromBinary, units_ipFromDecimal as ipFromDecimal, units_ipFromHex as ipFromHex, units_ipToBinary as ipToBinary, units_ipToDecimal as ipToDecimal, units_ipToDecimalCidr as ipToDecimalCidr, units_ipToHex as ipToHex, units_ipToOctal as ipToOctal, units_isValid as isValid, units_isValidCidr as isValidCidr, units_isValidIp as isValidIp, units_isValidIpv4 as isValidIpv4, units_octalToPermissions as octalToPermissions, units_parseFileSize as parseFileSize, units_parseInput as parseInput, units_parseNumberString as parseNumberString, units_parseSemver as parseSemver, units_permissionsToChmod as permissionsToChmod, units_permissionsToOctal as permissionsToOctal, units_permissionsToSymbolic as permissionsToSymbolic, units_ptToPx as ptToPx, units_pxToAll as pxToAll, units_pxToViewport as pxToViewport, units_remToPx as remToPx, units_satisfiesRange as satisfiesRange, units_scaleByHeight as scaleByHeight, units_scaleByWidth as scaleByWidth, units_sortVersions as sortVersions, units_splitSubnet as splitSubnet, units_symbolicToPermissions as symbolicToPermissions, units_validateCardNumber as validateCardNumber, units_viewportToPx as viewportToPx };
+  export { type units_AmortizationRow as AmortizationRow, type units_AspectRatioResult as AspectRatioResult, units_BASE_LABELS as BASE_LABELS, units_BASE_PREFIXES as BASE_PREFIXES, units_BYTE_UNITS as BYTE_UNITS, type units_BaseConvertResult as BaseConvertResult, type units_ByteConvertResult as ByteConvertResult, type units_ByteUnit as ByteUnit, units_COMMON_CURRENCIES as COMMON_CURRENCIES, units_COMMON_LOCALES as COMMON_LOCALES, units_COMMON_PERMISSIONS as COMMON_PERMISSIONS, units_COMMON_RATIOS as COMMON_RATIOS, units_COMMON_SIZES as COMMON_SIZES, units_COMMON_VIEWPORTS as COMMON_VIEWPORTS, type units_CardValidationResult as CardValidationResult, type units_Dimensions as Dimensions, type units_FilePermissions as FilePermissions, type units_FormatOptions as FormatOptions, type units_IbanValidationResult as IbanValidationResult, type units_IpConversion as IpConversion, type units_LoanResult as LoanResult, type units_NotationStyle as NotationStyle, type units_NumberBase as NumberBase, type units_Permission as Permission, type units_PxConvertResult as PxConvertResult, type units_SemverVersion as SemverVersion, type units_SubnetInfo as SubnetInfo, type units_ViewportConvertResult as ViewportConvertResult, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateLoan as calculateLoan, units_compareSemver as compareSemver, units_convert as convert, units_convertBytes as convertBytes, units_convertIp as convertIp, units_coverBox as coverBox, units_decimalToIp as decimalToIp, units_decimalToIpCidr as decimalToIpCidr, units_describePermissions as describePermissions, units_fitIntoBox as fitIntoBox, units_formatNumber as formatNumber, units_formatValue as formatValue, units_formatVwValue as formatVwValue, units_formatWithSeparator as formatWithSeparator, units_gcd as gcd, units_ipFromBinary as ipFromBinary, units_ipFromDecimal as ipFromDecimal, units_ipFromHex as ipFromHex, units_ipToBinary as ipToBinary, units_ipToDecimal as ipToDecimal, units_ipToDecimalCidr as ipToDecimalCidr, units_ipToHex as ipToHex, units_ipToOctal as ipToOctal, units_isValid as isValid, units_isValidCidr as isValidCidr, units_isValidIp as isValidIp, units_isValidIpv4 as isValidIpv4, units_octalToPermissions as octalToPermissions, units_parseFileSize as parseFileSize, units_parseInput as parseInput, units_parseNumberString as parseNumberString, units_parseSemver as parseSemver, units_permissionsToChmod as permissionsToChmod, units_permissionsToOctal as permissionsToOctal, units_permissionsToSymbolic as permissionsToSymbolic, units_ptToPx as ptToPx, units_pxToAll as pxToAll, units_pxToViewport as pxToViewport, units_remToPx as remToPx, units_satisfiesRange as satisfiesRange, units_scaleByHeight as scaleByHeight, units_scaleByWidth as scaleByWidth, units_sortVersions as sortVersions, units_splitSubnet as splitSubnet, units_symbolicToPermissions as symbolicToPermissions, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, units_viewportToPx as viewportToPx };
 }
 
-export { isValidCidr as $, type AspectRatioResult as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, decimalToIpCidr as E, type FilePermissions as F, describePermissions as G, fitIntoBox as H, type IpConversion as I, formatNumber as J, formatValue as K, formatVwValue as L, formatWithSeparator as M, type NotationStyle as N, gcd as O, type Permission as P, ipFromBinary as Q, ipFromDecimal as R, type SemverVersion as S, ipFromHex as T, ipToBinary as U, type ViewportConvertResult as V, ipToDecimal as W, ipToDecimalCidr as X, ipToHex as Y, ipToOctal as Z, isValid as _, BASE_PREFIXES as a, isValidIp as a0, isValidIpv4 as a1, octalToPermissions as a2, parseFileSize as a3, parseInput as a4, parseNumberString as a5, parseSemver as a6, permissionsToChmod as a7, permissionsToOctal as a8, permissionsToSymbolic as a9, ptToPx as aa, pxToAll as ab, pxToViewport as ac, remToPx as ad, satisfiesRange as ae, scaleByHeight as af, scaleByWidth as ag, sortVersions as ah, splitSubnet as ai, symbolicToPermissions as aj, validateCardNumber as ak, viewportToPx as al, BYTE_UNITS as b, type BaseConvertResult as c, type ByteConvertResult as d, type ByteUnit as e, COMMON_LOCALES as f, COMMON_PERMISSIONS as g, COMMON_RATIOS as h, COMMON_SIZES as i, COMMON_VIEWPORTS as j, type CardValidationResult as k, type FormatOptions as l, type NumberBase as m, type PxConvertResult as n, type SubnetInfo as o, autoFormat as p, bumpVersion as q, calcAspectRatio as r, calcSubnet as s, compareSemver as t, units as u, convert as v, convertBytes as w, convertIp as x, coverBox as y, decimalToIp as z };
+export { ipToDecimalCidr as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, convertIp as E, type FilePermissions as F, coverBox as G, decimalToIp as H, type IbanValidationResult as I, decimalToIpCidr as J, describePermissions as K, type LoanResult as L, fitIntoBox as M, type NotationStyle as N, formatNumber as O, type Permission as P, formatValue as Q, formatVwValue as R, type SemverVersion as S, formatWithSeparator as T, gcd as U, type ViewportConvertResult as V, ipFromBinary as W, ipFromDecimal as X, ipFromHex as Y, ipToBinary as Z, ipToDecimal as _, type AspectRatioResult as a, ipToHex as a0, ipToOctal as a1, isValid as a2, isValidCidr as a3, isValidIp as a4, isValidIpv4 as a5, octalToPermissions as a6, parseFileSize as a7, parseInput as a8, parseNumberString as a9, parseSemver as aa, permissionsToChmod as ab, permissionsToOctal as ac, permissionsToSymbolic as ad, ptToPx as ae, pxToAll as af, pxToViewport as ag, remToPx as ah, satisfiesRange as ai, scaleByHeight as aj, scaleByWidth as ak, sortVersions as al, splitSubnet as am, symbolicToPermissions as an, validateCardNumber as ao, validateIban as ap, viewportToPx as aq, BASE_PREFIXES as b, BYTE_UNITS as c, type BaseConvertResult as d, type ByteConvertResult as e, type ByteUnit as f, COMMON_LOCALES as g, COMMON_PERMISSIONS as h, COMMON_RATIOS as i, COMMON_SIZES as j, COMMON_VIEWPORTS as k, type CardValidationResult as l, type FormatOptions as m, type IpConversion as n, type NumberBase as o, type PxConvertResult as p, type SubnetInfo as q, autoFormat as r, bumpVersion as s, calcAspectRatio as t, units as u, calcSubnet as v, calculateLoan as w, compareSemver as x, convert as y, convertBytes as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "154+ developer utility tools for Node.js: JSON, encoding, hashing, color, CSS, network and more. Runs locally, no API key required.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",