@utilix-tech/sdk 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 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.14.0
+- Added Compound Interest Calculator (`calculateCompoundInterest`) and ISBN Validator / Converter (`validateIsbn`).
+
 ## 0.13.0
 - Added VAT / Sales Tax Calculator (`calculateTax`).
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**537 developer utility functions for Node.js: runs locally, no API key required.**
+**539 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, validateIban, calculateLoan, validateBarcode, calculateTax } from "@utilix-tech/sdk/units";
+import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan, validateBarcode, calculateTax, calculateCompoundInterest, validateIsbn } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -280,6 +280,14 @@ validateBarcode("4006381333931");
 // VAT / sales tax: add or remove tax in either direction
 calculateTax(100, 20, "add");
 // { netAmount: 100, taxAmount: 20, grossAmount: 120, ratePercent: 20, direction: "add" }
+
+// Compound interest: future value with an optional recurring contribution
+calculateCompoundInterest(1000, 5, 10, 1);
+// { futureValue: 1628.89, totalInterest: 628.89, years: 10, compoundsPerYear: 1, schedule: [...] }
+
+// ISBN-10 / ISBN-13 checksum validation + format conversion
+validateIsbn("0-306-40615-2");
+// { valid: true, format: "ISBN-10", converted: "9780306406157", ... }
 ```
 
 ---
@@ -510,7 +518,7 @@ readIcoInfo(new Uint8Array(icoBytes));
 | `@utilix-tech/sdk/data` | CSV, YAML, TOML, XML, INI, NDJSON parse and convert |
 | `@utilix-tech/sdk/generators` | UUID v4/v7, ULID, passwords, strength check, fake data |
 | `@utilix-tech/sdk/time` | Date diff, timezone convert, cron parse, relative time |
-| `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode validation, loan calculator, VAT/sales tax calculator |
+| `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN validation, loan calculator, compound interest calculator, VAT/sales tax calculator |
 | `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing |
 | `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, JWKS parse, CORS headers, CSP header |
 | `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format |

package/dist/{chunk-BI3SOWM7.js → chunk-2TQTKZCN.js}

@@ -17,6 +17,7 @@ __export(units_exports, {
   bumpVersion: () => bumpVersion,
   calcAspectRatio: () => calcAspectRatio,
   calcSubnet: () => calcSubnet,
+  calculateCompoundInterest: () => calculateCompoundInterest,
   calculateLoan: () => calculateLoan,
   calculateTax: () => calculateTax,
   compareSemver: () => compareSemver,
@@ -66,6 +67,7 @@ __export(units_exports, {
   validateBarcode: () => validateBarcode,
   validateCardNumber: () => validateCardNumber,
   validateIban: () => validateIban,
+  validateIsbn: () => validateIsbn,
   viewportToPx: () => viewportToPx
 });
 function pxToAll(px, baseFontSize = 16, viewportWidth = 1440, viewportHeight = 900) {
@@ -1167,5 +1169,94 @@ function calculateTax(amount, ratePercent, direction) {
   const taxAmount = round22(grossAmount - netAmount);
   return { netAmount, taxAmount, grossAmount, ratePercent, direction };
 }
+function calculateCompoundInterest(principal, annualRatePercent, years, compoundsPerYear, contributionPerPeriod = 0) {
+  if (!Number.isFinite(principal) || principal < 0) return { error: "Principal must be zero or a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (!Number.isInteger(years) || years <= 0) return { error: "Years must be a positive whole number" };
+  if (!Number.isInteger(compoundsPerYear) || compoundsPerYear <= 0) {
+    return { error: "Compounding frequency must be a positive whole number of periods per year" };
+  }
+  if (!Number.isFinite(contributionPerPeriod) || contributionPerPeriod < 0) {
+    return { error: "Contribution per period must be zero or a positive number" };
+  }
+  if (principal === 0 && contributionPerPeriod === 0) return { error: "Enter a principal or a recurring contribution" };
+  const round22 = (n) => Math.round(n * 100) / 100;
+  const ratePerPeriod = annualRatePercent / 100 / compoundsPerYear;
+  function futureValueAtPeriod(periods) {
+    const growth = ratePerPeriod === 0 ? 1 : Math.pow(1 + ratePerPeriod, periods);
+    const fvPrincipal = principal * growth;
+    const fvContributions = contributionPerPeriod === 0 ? 0 : ratePerPeriod === 0 ? contributionPerPeriod * periods : contributionPerPeriod * ((growth - 1) / ratePerPeriod);
+    return fvPrincipal + fvContributions;
+  }
+  const schedule = [];
+  for (let year = 1; year <= years; year++) {
+    const periods = year * compoundsPerYear;
+    const balance = round22(futureValueAtPeriod(periods));
+    const contributions = round22(contributionPerPeriod * periods);
+    schedule.push({ year, balance, contributions, interest: round22(balance - principal - contributions) });
+  }
+  const totalPeriods = years * compoundsPerYear;
+  const futureValue = round22(futureValueAtPeriod(totalPeriods));
+  const totalContributions = round22(contributionPerPeriod * totalPeriods);
+  const totalInterest = round22(futureValue - principal - totalContributions);
+  return {
+    futureValue,
+    totalPrincipal: round22(principal),
+    totalContributions,
+    totalInterest,
+    years,
+    compoundsPerYear,
+    schedule
+  };
+}
+function computeIsbn10CheckDigit(dataDigits) {
+  let sum = 0;
+  for (let i = 0; i < 9; i++) sum += dataDigits[i] * (10 - i);
+  const check = (11 - sum % 11) % 11;
+  return check === 10 ? "X" : String(check);
+}
+function computeIsbn13CheckDigit(dataDigits) {
+  let sum = 0;
+  const n = dataDigits.length;
+  for (let i = 0; i < n; i++) {
+    const distanceFromEnd = n - 1 - i;
+    const weight = distanceFromEnd % 2 === 0 ? 3 : 1;
+    sum += dataDigits[i] * weight;
+  }
+  return String((10 - sum % 10) % 10);
+}
+function validateIsbn(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const cleaned = input.replace(/[\s-]/g, "").toUpperCase();
+  if (cleaned.length === 10) {
+    if (!/^\d{9}[\dX]$/.test(cleaned)) {
+      return { error: 'ISBN-10 must be 9 digits followed by a digit or "X" check digit' };
+    }
+    const dataDigits = cleaned.slice(0, 9).split("").map(Number);
+    const checkDigit = cleaned[9];
+    const expectedCheckDigit = computeIsbn10CheckDigit(dataDigits);
+    const valid = checkDigit === expectedCheckDigit;
+    const isbn13Digits = [9, 7, 8, ...dataDigits];
+    const isbn13Check = computeIsbn13CheckDigit(isbn13Digits);
+    const converted = valid ? isbn13Digits.join("") + isbn13Check : null;
+    return { valid, format: "ISBN-10", digits: cleaned, checkDigit, expectedCheckDigit, converted };
+  }
+  if (cleaned.length === 13) {
+    if (!/^\d{13}$/.test(cleaned)) return { error: "ISBN-13 must contain only digits" };
+    const dataDigits = cleaned.slice(0, 12).split("").map(Number);
+    const checkDigit = cleaned[12];
+    const expectedCheckDigit = computeIsbn13CheckDigit(dataDigits);
+    const valid = checkDigit === expectedCheckDigit;
+    let converted = null;
+    if (valid && cleaned.startsWith("978")) {
+      const isbn10Digits = dataDigits.slice(3);
+      converted = isbn10Digits.join("") + computeIsbn10CheckDigit(isbn10Digits);
+    }
+    return { valid, format: "ISBN-13", digits: cleaned, checkDigit, expectedCheckDigit, converted };
+  }
+  return { error: `Unsupported length (${cleaned.length} characters); expected 10 (ISBN-10) or 13 (ISBN-13)` };
+}
 
-export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_TAX_RATES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateLoan, calculateTax, 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, validateBarcode, validateCardNumber, validateIban, viewportToPx };
+export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_TAX_RATES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateCompoundInterest, calculateLoan, calculateTax, 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, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx };

package/dist/index.cjs

@@ -6622,6 +6622,7 @@ __export(units_exports, {
   bumpVersion: () => bumpVersion,
   calcAspectRatio: () => calcAspectRatio,
   calcSubnet: () => calcSubnet,
+  calculateCompoundInterest: () => calculateCompoundInterest,
   calculateLoan: () => calculateLoan,
   calculateTax: () => calculateTax,
   compareSemver: () => compareSemver,
@@ -6671,6 +6672,7 @@ __export(units_exports, {
   validateBarcode: () => validateBarcode,
   validateCardNumber: () => validateCardNumber,
   validateIban: () => validateIban,
+  validateIsbn: () => validateIsbn,
   viewportToPx: () => viewportToPx
 });
 function pxToAll(px, baseFontSize = 16, viewportWidth = 1440, viewportHeight = 900) {
@@ -7772,6 +7774,95 @@ function calculateTax(amount, ratePercent, direction) {
   const taxAmount = round23(grossAmount - netAmount);
   return { netAmount, taxAmount, grossAmount, ratePercent, direction };
 }
+function calculateCompoundInterest(principal, annualRatePercent, years, compoundsPerYear, contributionPerPeriod = 0) {
+  if (!Number.isFinite(principal) || principal < 0) return { error: "Principal must be zero or a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (!Number.isInteger(years) || years <= 0) return { error: "Years must be a positive whole number" };
+  if (!Number.isInteger(compoundsPerYear) || compoundsPerYear <= 0) {
+    return { error: "Compounding frequency must be a positive whole number of periods per year" };
+  }
+  if (!Number.isFinite(contributionPerPeriod) || contributionPerPeriod < 0) {
+    return { error: "Contribution per period must be zero or a positive number" };
+  }
+  if (principal === 0 && contributionPerPeriod === 0) return { error: "Enter a principal or a recurring contribution" };
+  const round23 = (n) => Math.round(n * 100) / 100;
+  const ratePerPeriod = annualRatePercent / 100 / compoundsPerYear;
+  function futureValueAtPeriod(periods) {
+    const growth = ratePerPeriod === 0 ? 1 : Math.pow(1 + ratePerPeriod, periods);
+    const fvPrincipal = principal * growth;
+    const fvContributions = contributionPerPeriod === 0 ? 0 : ratePerPeriod === 0 ? contributionPerPeriod * periods : contributionPerPeriod * ((growth - 1) / ratePerPeriod);
+    return fvPrincipal + fvContributions;
+  }
+  const schedule = [];
+  for (let year = 1; year <= years; year++) {
+    const periods = year * compoundsPerYear;
+    const balance = round23(futureValueAtPeriod(periods));
+    const contributions = round23(contributionPerPeriod * periods);
+    schedule.push({ year, balance, contributions, interest: round23(balance - principal - contributions) });
+  }
+  const totalPeriods = years * compoundsPerYear;
+  const futureValue = round23(futureValueAtPeriod(totalPeriods));
+  const totalContributions = round23(contributionPerPeriod * totalPeriods);
+  const totalInterest = round23(futureValue - principal - totalContributions);
+  return {
+    futureValue,
+    totalPrincipal: round23(principal),
+    totalContributions,
+    totalInterest,
+    years,
+    compoundsPerYear,
+    schedule
+  };
+}
+function computeIsbn10CheckDigit(dataDigits) {
+  let sum = 0;
+  for (let i = 0; i < 9; i++) sum += dataDigits[i] * (10 - i);
+  const check = (11 - sum % 11) % 11;
+  return check === 10 ? "X" : String(check);
+}
+function computeIsbn13CheckDigit(dataDigits) {
+  let sum = 0;
+  const n = dataDigits.length;
+  for (let i = 0; i < n; i++) {
+    const distanceFromEnd = n - 1 - i;
+    const weight = distanceFromEnd % 2 === 0 ? 3 : 1;
+    sum += dataDigits[i] * weight;
+  }
+  return String((10 - sum % 10) % 10);
+}
+function validateIsbn(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const cleaned = input.replace(/[\s-]/g, "").toUpperCase();
+  if (cleaned.length === 10) {
+    if (!/^\d{9}[\dX]$/.test(cleaned)) {
+      return { error: 'ISBN-10 must be 9 digits followed by a digit or "X" check digit' };
+    }
+    const dataDigits = cleaned.slice(0, 9).split("").map(Number);
+    const checkDigit = cleaned[9];
+    const expectedCheckDigit = computeIsbn10CheckDigit(dataDigits);
+    const valid = checkDigit === expectedCheckDigit;
+    const isbn13Digits = [9, 7, 8, ...dataDigits];
+    const isbn13Check = computeIsbn13CheckDigit(isbn13Digits);
+    const converted = valid ? isbn13Digits.join("") + isbn13Check : null;
+    return { valid, format: "ISBN-10", digits: cleaned, checkDigit, expectedCheckDigit, converted };
+  }
+  if (cleaned.length === 13) {
+    if (!/^\d{13}$/.test(cleaned)) return { error: "ISBN-13 must contain only digits" };
+    const dataDigits = cleaned.slice(0, 12).split("").map(Number);
+    const checkDigit = cleaned[12];
+    const expectedCheckDigit = computeIsbn13CheckDigit(dataDigits);
+    const valid = checkDigit === expectedCheckDigit;
+    let converted = null;
+    if (valid && cleaned.startsWith("978")) {
+      const isbn10Digits = dataDigits.slice(3);
+      converted = isbn10Digits.join("") + computeIsbn10CheckDigit(isbn10Digits);
+    }
+    return { valid, format: "ISBN-13", digits: cleaned, checkDigit, expectedCheckDigit, converted };
+  }
+  return { error: `Unsupported length (${cleaned.length} characters); expected 10 (ISBN-10) or 13 (ISBN-13)` };
+}
 
 // src/tools/network.ts
 var network_exports = {};

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-CKS5W_ih.cjs';
+export { u as units } from './units-C4N1Dq7_.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-CKS5W_ih.js';
+export { u as units } from './units-C4N1Dq7_.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-XMKJYVKB.js';
-export { units_exports as units } from './chunk-BI3SOWM7.js';
+export { units_exports as units } from './chunk-2TQTKZCN.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

@@ -1100,6 +1100,95 @@ function calculateTax(amount, ratePercent, direction) {
   const taxAmount = round22(grossAmount - netAmount);
   return { netAmount, taxAmount, grossAmount, ratePercent, direction };
 }
+function calculateCompoundInterest(principal, annualRatePercent, years, compoundsPerYear, contributionPerPeriod = 0) {
+  if (!Number.isFinite(principal) || principal < 0) return { error: "Principal must be zero or a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (!Number.isInteger(years) || years <= 0) return { error: "Years must be a positive whole number" };
+  if (!Number.isInteger(compoundsPerYear) || compoundsPerYear <= 0) {
+    return { error: "Compounding frequency must be a positive whole number of periods per year" };
+  }
+  if (!Number.isFinite(contributionPerPeriod) || contributionPerPeriod < 0) {
+    return { error: "Contribution per period must be zero or a positive number" };
+  }
+  if (principal === 0 && contributionPerPeriod === 0) return { error: "Enter a principal or a recurring contribution" };
+  const round22 = (n) => Math.round(n * 100) / 100;
+  const ratePerPeriod = annualRatePercent / 100 / compoundsPerYear;
+  function futureValueAtPeriod(periods) {
+    const growth = ratePerPeriod === 0 ? 1 : Math.pow(1 + ratePerPeriod, periods);
+    const fvPrincipal = principal * growth;
+    const fvContributions = contributionPerPeriod === 0 ? 0 : ratePerPeriod === 0 ? contributionPerPeriod * periods : contributionPerPeriod * ((growth - 1) / ratePerPeriod);
+    return fvPrincipal + fvContributions;
+  }
+  const schedule = [];
+  for (let year = 1; year <= years; year++) {
+    const periods = year * compoundsPerYear;
+    const balance = round22(futureValueAtPeriod(periods));
+    const contributions = round22(contributionPerPeriod * periods);
+    schedule.push({ year, balance, contributions, interest: round22(balance - principal - contributions) });
+  }
+  const totalPeriods = years * compoundsPerYear;
+  const futureValue = round22(futureValueAtPeriod(totalPeriods));
+  const totalContributions = round22(contributionPerPeriod * totalPeriods);
+  const totalInterest = round22(futureValue - principal - totalContributions);
+  return {
+    futureValue,
+    totalPrincipal: round22(principal),
+    totalContributions,
+    totalInterest,
+    years,
+    compoundsPerYear,
+    schedule
+  };
+}
+function computeIsbn10CheckDigit(dataDigits) {
+  let sum = 0;
+  for (let i = 0; i < 9; i++) sum += dataDigits[i] * (10 - i);
+  const check = (11 - sum % 11) % 11;
+  return check === 10 ? "X" : String(check);
+}
+function computeIsbn13CheckDigit(dataDigits) {
+  let sum = 0;
+  const n = dataDigits.length;
+  for (let i = 0; i < n; i++) {
+    const distanceFromEnd = n - 1 - i;
+    const weight = distanceFromEnd % 2 === 0 ? 3 : 1;
+    sum += dataDigits[i] * weight;
+  }
+  return String((10 - sum % 10) % 10);
+}
+function validateIsbn(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const cleaned = input.replace(/[\s-]/g, "").toUpperCase();
+  if (cleaned.length === 10) {
+    if (!/^\d{9}[\dX]$/.test(cleaned)) {
+      return { error: 'ISBN-10 must be 9 digits followed by a digit or "X" check digit' };
+    }
+    const dataDigits = cleaned.slice(0, 9).split("").map(Number);
+    const checkDigit = cleaned[9];
+    const expectedCheckDigit = computeIsbn10CheckDigit(dataDigits);
+    const valid = checkDigit === expectedCheckDigit;
+    const isbn13Digits = [9, 7, 8, ...dataDigits];
+    const isbn13Check = computeIsbn13CheckDigit(isbn13Digits);
+    const converted = valid ? isbn13Digits.join("") + isbn13Check : null;
+    return { valid, format: "ISBN-10", digits: cleaned, checkDigit, expectedCheckDigit, converted };
+  }
+  if (cleaned.length === 13) {
+    if (!/^\d{13}$/.test(cleaned)) return { error: "ISBN-13 must contain only digits" };
+    const dataDigits = cleaned.slice(0, 12).split("").map(Number);
+    const checkDigit = cleaned[12];
+    const expectedCheckDigit = computeIsbn13CheckDigit(dataDigits);
+    const valid = checkDigit === expectedCheckDigit;
+    let converted = null;
+    if (valid && cleaned.startsWith("978")) {
+      const isbn10Digits = dataDigits.slice(3);
+      converted = isbn10Digits.join("") + computeIsbn10CheckDigit(isbn10Digits);
+    }
+    return { valid, format: "ISBN-13", digits: cleaned, checkDigit, expectedCheckDigit, converted };
+  }
+  return { error: `Unsupported length (${cleaned.length} characters); expected 10 (ISBN-10) or 13 (ISBN-13)` };
+}
 
 exports.BASE_LABELS = BASE_LABELS;
 exports.BASE_PREFIXES = BASE_PREFIXES;
@@ -1115,6 +1204,7 @@ exports.autoFormat = autoFormat;
 exports.bumpVersion = bumpVersion;
 exports.calcAspectRatio = calcAspectRatio;
 exports.calcSubnet = calcSubnet;
+exports.calculateCompoundInterest = calculateCompoundInterest;
 exports.calculateLoan = calculateLoan;
 exports.calculateTax = calculateTax;
 exports.compareSemver = compareSemver;
@@ -1164,4 +1254,5 @@ exports.symbolicToPermissions = symbolicToPermissions;
 exports.validateBarcode = validateBarcode;
 exports.validateCardNumber = validateCardNumber;
 exports.validateIban = validateIban;
+exports.validateIsbn = validateIsbn;
 exports.viewportToPx = viewportToPx;

package/dist/tools/units.d.cts

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

package/dist/tools/units.d.ts

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

package/dist/{units-CKS5W_ih.d.cts → units-C4N1Dq7_.d.cts}

@@ -15,6 +15,10 @@
  *  - credit-card-validator : validateCardNumber
  *  - iban-validator : validateIban
  *  - loan-calculator : calculateLoan
+ *  - barcode-validator : validateBarcode
+ *  - vat-calculator : calculateTax
+ *  - compound-interest-calculator : calculateCompoundInterest
+ *  - isbn-validator : validateIsbn
  */
 interface PxConvertResult {
     px: number;
@@ -318,6 +322,50 @@ declare const COMMON_TAX_RATES: Array<{
 declare function calculateTax(amount: number, ratePercent: number, direction: TaxDirection): TaxResult | {
     error: string;
 };
+interface CompoundYearRow {
+    year: number;
+    balance: number;
+    contributions: number;
+    interest: number;
+}
+interface CompoundInterestResult {
+    futureValue: number;
+    totalPrincipal: number;
+    totalContributions: number;
+    totalInterest: number;
+    years: number;
+    compoundsPerYear: number;
+    schedule: CompoundYearRow[];
+}
+/**
+ * Compute the future value of a principal (plus an optional recurring
+ * contribution made at the end of each compounding period) under compound
+ * interest, given an annual interest rate (as a percent, e.g. 5), a term in
+ * years, and a compounding frequency (periods per year, e.g. 1 = annually,
+ * 12 = monthly, 365 = daily).
+ */
+declare function calculateCompoundInterest(principal: number, annualRatePercent: number, years: number, compoundsPerYear: number, contributionPerPeriod?: number): CompoundInterestResult | {
+    error: string;
+};
+type IsbnFormat = "ISBN-10" | "ISBN-13";
+interface IsbnResult {
+    valid: boolean;
+    format: IsbnFormat;
+    digits: string;
+    checkDigit: string;
+    expectedCheckDigit: string;
+    converted: string | null;
+}
+/**
+ * Validate an ISBN-10 or ISBN-13 number via its checksum, inferred from the
+ * character count (10 or 13) once spaces and hyphens are stripped, and
+ * convert it to the other format where possible: ISBN-10 always converts to
+ * ISBN-13 by prefixing "978" and recomputing the check digit, but an
+ * ISBN-13 only converts back to ISBN-10 if it starts with the "978" prefix.
+ */
+declare function validateIsbn(input: string): IsbnResult | {
+    error: string;
+};
 
 type units_AmortizationRow = AmortizationRow;
 type units_AspectRatioResult = AspectRatioResult;
@@ -337,11 +385,15 @@ declare const units_COMMON_SIZES: typeof COMMON_SIZES;
 declare const units_COMMON_TAX_RATES: typeof COMMON_TAX_RATES;
 declare const units_COMMON_VIEWPORTS: typeof COMMON_VIEWPORTS;
 type units_CardValidationResult = CardValidationResult;
+type units_CompoundInterestResult = CompoundInterestResult;
+type units_CompoundYearRow = CompoundYearRow;
 type units_Dimensions = Dimensions;
 type units_FilePermissions = FilePermissions;
 type units_FormatOptions = FormatOptions;
 type units_IbanValidationResult = IbanValidationResult;
 type units_IpConversion = IpConversion;
+type units_IsbnFormat = IsbnFormat;
+type units_IsbnResult = IsbnResult;
 type units_LoanResult = LoanResult;
 type units_NotationStyle = NotationStyle;
 type units_NumberBase = NumberBase;
@@ -356,6 +408,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_calculateCompoundInterest: typeof calculateCompoundInterest;
 declare const units_calculateLoan: typeof calculateLoan;
 declare const units_calculateTax: typeof calculateTax;
 declare const units_compareSemver: typeof compareSemver;
@@ -405,9 +458,10 @@ declare const units_symbolicToPermissions: typeof symbolicToPermissions;
 declare const units_validateBarcode: typeof validateBarcode;
 declare const units_validateCardNumber: typeof validateCardNumber;
 declare const units_validateIban: typeof validateIban;
+declare const units_validateIsbn: typeof validateIsbn;
 declare const units_viewportToPx: typeof viewportToPx;
 declare namespace units {
-  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_BarcodeFormat as BarcodeFormat, type units_BarcodeValidationResult as BarcodeValidationResult, 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_TAX_RATES as COMMON_TAX_RATES, 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_TaxDirection as TaxDirection, type units_TaxResult as TaxResult, 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_calculateTax as calculateTax, 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_validateBarcode as validateBarcode, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, 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_BarcodeFormat as BarcodeFormat, type units_BarcodeValidationResult as BarcodeValidationResult, 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_TAX_RATES as COMMON_TAX_RATES, units_COMMON_VIEWPORTS as COMMON_VIEWPORTS, type units_CardValidationResult as CardValidationResult, type units_CompoundInterestResult as CompoundInterestResult, type units_CompoundYearRow as CompoundYearRow, 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_IsbnFormat as IsbnFormat, type units_IsbnResult as IsbnResult, 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_TaxDirection as TaxDirection, type units_TaxResult as TaxResult, type units_ViewportConvertResult as ViewportConvertResult, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateCompoundInterest as calculateCompoundInterest, units_calculateLoan as calculateLoan, units_calculateTax as calculateTax, 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_validateBarcode as validateBarcode, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, units_validateIsbn as validateIsbn, units_viewportToPx as viewportToPx };
 }
 
-export { gcd as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, calculateLoan as E, type FilePermissions as F, calculateTax as G, compareSemver as H, type IbanValidationResult as I, convert as J, convertBytes as K, type LoanResult as L, convertIp as M, type NotationStyle as N, coverBox as O, type Permission as P, decimalToIp as Q, decimalToIpCidr as R, type SemverVersion as S, type TaxDirection as T, describePermissions as U, type ViewportConvertResult as V, fitIntoBox as W, formatNumber as X, formatValue as Y, formatVwValue as Z, formatWithSeparator as _, type AspectRatioResult as a, ipFromBinary as a0, ipFromDecimal as a1, ipFromHex as a2, ipToBinary as a3, ipToDecimal as a4, ipToDecimalCidr as a5, ipToHex as a6, ipToOctal as a7, isValid as a8, isValidCidr as a9, isValidIp as aa, isValidIpv4 as ab, octalToPermissions as ac, parseFileSize as ad, parseInput as ae, parseNumberString as af, parseSemver as ag, permissionsToChmod as ah, permissionsToOctal as ai, permissionsToSymbolic as aj, ptToPx as ak, pxToAll as al, pxToViewport as am, remToPx as an, satisfiesRange as ao, scaleByHeight as ap, scaleByWidth as aq, sortVersions as ar, splitSubnet as as, symbolicToPermissions as at, validateBarcode as au, validateCardNumber as av, validateIban as aw, viewportToPx as ax, BASE_PREFIXES as b, BYTE_UNITS as c, type BarcodeFormat as d, type BarcodeValidationResult as e, type BaseConvertResult as f, type ByteConvertResult as g, type ByteUnit as h, COMMON_LOCALES as i, COMMON_PERMISSIONS as j, COMMON_RATIOS as k, COMMON_SIZES as l, COMMON_TAX_RATES as m, COMMON_VIEWPORTS as n, type CardValidationResult as o, type FormatOptions as p, type IpConversion as q, type NumberBase as r, type PxConvertResult as s, type SubnetInfo as t, units as u, type TaxResult as v, autoFormat as w, bumpVersion as x, calcAspectRatio as y, calcSubnet as z };
+export { fitIntoBox as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, autoFormat as E, type FilePermissions as F, bumpVersion as G, calcAspectRatio as H, type IbanValidationResult as I, calcSubnet as J, calculateCompoundInterest as K, type LoanResult as L, calculateLoan as M, type NotationStyle as N, calculateTax as O, type Permission as P, compareSemver as Q, convert as R, type SemverVersion as S, type TaxDirection as T, convertBytes as U, type ViewportConvertResult as V, convertIp as W, coverBox as X, decimalToIp as Y, decimalToIpCidr as Z, describePermissions as _, type AspectRatioResult as a, formatNumber as a0, formatValue as a1, formatVwValue as a2, formatWithSeparator as a3, gcd as a4, ipFromBinary as a5, ipFromDecimal as a6, ipFromHex as a7, ipToBinary as a8, ipToDecimal as a9, validateCardNumber as aA, validateIban as aB, validateIsbn as aC, viewportToPx as aD, ipToDecimalCidr as aa, ipToHex as ab, ipToOctal as ac, isValid as ad, isValidCidr as ae, isValidIp as af, isValidIpv4 as ag, octalToPermissions as ah, parseFileSize as ai, parseInput as aj, parseNumberString as ak, parseSemver as al, permissionsToChmod as am, permissionsToOctal as an, permissionsToSymbolic as ao, ptToPx as ap, pxToAll as aq, pxToViewport as ar, remToPx as as, satisfiesRange as at, scaleByHeight as au, scaleByWidth as av, sortVersions as aw, splitSubnet as ax, symbolicToPermissions as ay, validateBarcode as az, BASE_PREFIXES as b, BYTE_UNITS as c, type BarcodeFormat as d, type BarcodeValidationResult as e, type BaseConvertResult as f, type ByteConvertResult as g, type ByteUnit as h, COMMON_LOCALES as i, COMMON_PERMISSIONS as j, COMMON_RATIOS as k, COMMON_SIZES as l, COMMON_TAX_RATES as m, COMMON_VIEWPORTS as n, type CardValidationResult as o, type CompoundInterestResult as p, type CompoundYearRow as q, type FormatOptions as r, type IpConversion as s, type IsbnFormat as t, units as u, type IsbnResult as v, type NumberBase as w, type PxConvertResult as x, type SubnetInfo as y, type TaxResult as z };

package/dist/{units-CKS5W_ih.d.ts → units-C4N1Dq7_.d.ts}

@@ -15,6 +15,10 @@
  *  - credit-card-validator : validateCardNumber
  *  - iban-validator : validateIban
  *  - loan-calculator : calculateLoan
+ *  - barcode-validator : validateBarcode
+ *  - vat-calculator : calculateTax
+ *  - compound-interest-calculator : calculateCompoundInterest
+ *  - isbn-validator : validateIsbn
  */
 interface PxConvertResult {
     px: number;
@@ -318,6 +322,50 @@ declare const COMMON_TAX_RATES: Array<{
 declare function calculateTax(amount: number, ratePercent: number, direction: TaxDirection): TaxResult | {
     error: string;
 };
+interface CompoundYearRow {
+    year: number;
+    balance: number;
+    contributions: number;
+    interest: number;
+}
+interface CompoundInterestResult {
+    futureValue: number;
+    totalPrincipal: number;
+    totalContributions: number;
+    totalInterest: number;
+    years: number;
+    compoundsPerYear: number;
+    schedule: CompoundYearRow[];
+}
+/**
+ * Compute the future value of a principal (plus an optional recurring
+ * contribution made at the end of each compounding period) under compound
+ * interest, given an annual interest rate (as a percent, e.g. 5), a term in
+ * years, and a compounding frequency (periods per year, e.g. 1 = annually,
+ * 12 = monthly, 365 = daily).
+ */
+declare function calculateCompoundInterest(principal: number, annualRatePercent: number, years: number, compoundsPerYear: number, contributionPerPeriod?: number): CompoundInterestResult | {
+    error: string;
+};
+type IsbnFormat = "ISBN-10" | "ISBN-13";
+interface IsbnResult {
+    valid: boolean;
+    format: IsbnFormat;
+    digits: string;
+    checkDigit: string;
+    expectedCheckDigit: string;
+    converted: string | null;
+}
+/**
+ * Validate an ISBN-10 or ISBN-13 number via its checksum, inferred from the
+ * character count (10 or 13) once spaces and hyphens are stripped, and
+ * convert it to the other format where possible: ISBN-10 always converts to
+ * ISBN-13 by prefixing "978" and recomputing the check digit, but an
+ * ISBN-13 only converts back to ISBN-10 if it starts with the "978" prefix.
+ */
+declare function validateIsbn(input: string): IsbnResult | {
+    error: string;
+};
 
 type units_AmortizationRow = AmortizationRow;
 type units_AspectRatioResult = AspectRatioResult;
@@ -337,11 +385,15 @@ declare const units_COMMON_SIZES: typeof COMMON_SIZES;
 declare const units_COMMON_TAX_RATES: typeof COMMON_TAX_RATES;
 declare const units_COMMON_VIEWPORTS: typeof COMMON_VIEWPORTS;
 type units_CardValidationResult = CardValidationResult;
+type units_CompoundInterestResult = CompoundInterestResult;
+type units_CompoundYearRow = CompoundYearRow;
 type units_Dimensions = Dimensions;
 type units_FilePermissions = FilePermissions;
 type units_FormatOptions = FormatOptions;
 type units_IbanValidationResult = IbanValidationResult;
 type units_IpConversion = IpConversion;
+type units_IsbnFormat = IsbnFormat;
+type units_IsbnResult = IsbnResult;
 type units_LoanResult = LoanResult;
 type units_NotationStyle = NotationStyle;
 type units_NumberBase = NumberBase;
@@ -356,6 +408,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_calculateCompoundInterest: typeof calculateCompoundInterest;
 declare const units_calculateLoan: typeof calculateLoan;
 declare const units_calculateTax: typeof calculateTax;
 declare const units_compareSemver: typeof compareSemver;
@@ -405,9 +458,10 @@ declare const units_symbolicToPermissions: typeof symbolicToPermissions;
 declare const units_validateBarcode: typeof validateBarcode;
 declare const units_validateCardNumber: typeof validateCardNumber;
 declare const units_validateIban: typeof validateIban;
+declare const units_validateIsbn: typeof validateIsbn;
 declare const units_viewportToPx: typeof viewportToPx;
 declare namespace units {
-  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_BarcodeFormat as BarcodeFormat, type units_BarcodeValidationResult as BarcodeValidationResult, 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_TAX_RATES as COMMON_TAX_RATES, 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_TaxDirection as TaxDirection, type units_TaxResult as TaxResult, 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_calculateTax as calculateTax, 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_validateBarcode as validateBarcode, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, 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_BarcodeFormat as BarcodeFormat, type units_BarcodeValidationResult as BarcodeValidationResult, 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_TAX_RATES as COMMON_TAX_RATES, units_COMMON_VIEWPORTS as COMMON_VIEWPORTS, type units_CardValidationResult as CardValidationResult, type units_CompoundInterestResult as CompoundInterestResult, type units_CompoundYearRow as CompoundYearRow, 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_IsbnFormat as IsbnFormat, type units_IsbnResult as IsbnResult, 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_TaxDirection as TaxDirection, type units_TaxResult as TaxResult, type units_ViewportConvertResult as ViewportConvertResult, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateCompoundInterest as calculateCompoundInterest, units_calculateLoan as calculateLoan, units_calculateTax as calculateTax, 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_validateBarcode as validateBarcode, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, units_validateIsbn as validateIsbn, units_viewportToPx as viewportToPx };
 }
 
-export { gcd as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, calculateLoan as E, type FilePermissions as F, calculateTax as G, compareSemver as H, type IbanValidationResult as I, convert as J, convertBytes as K, type LoanResult as L, convertIp as M, type NotationStyle as N, coverBox as O, type Permission as P, decimalToIp as Q, decimalToIpCidr as R, type SemverVersion as S, type TaxDirection as T, describePermissions as U, type ViewportConvertResult as V, fitIntoBox as W, formatNumber as X, formatValue as Y, formatVwValue as Z, formatWithSeparator as _, type AspectRatioResult as a, ipFromBinary as a0, ipFromDecimal as a1, ipFromHex as a2, ipToBinary as a3, ipToDecimal as a4, ipToDecimalCidr as a5, ipToHex as a6, ipToOctal as a7, isValid as a8, isValidCidr as a9, isValidIp as aa, isValidIpv4 as ab, octalToPermissions as ac, parseFileSize as ad, parseInput as ae, parseNumberString as af, parseSemver as ag, permissionsToChmod as ah, permissionsToOctal as ai, permissionsToSymbolic as aj, ptToPx as ak, pxToAll as al, pxToViewport as am, remToPx as an, satisfiesRange as ao, scaleByHeight as ap, scaleByWidth as aq, sortVersions as ar, splitSubnet as as, symbolicToPermissions as at, validateBarcode as au, validateCardNumber as av, validateIban as aw, viewportToPx as ax, BASE_PREFIXES as b, BYTE_UNITS as c, type BarcodeFormat as d, type BarcodeValidationResult as e, type BaseConvertResult as f, type ByteConvertResult as g, type ByteUnit as h, COMMON_LOCALES as i, COMMON_PERMISSIONS as j, COMMON_RATIOS as k, COMMON_SIZES as l, COMMON_TAX_RATES as m, COMMON_VIEWPORTS as n, type CardValidationResult as o, type FormatOptions as p, type IpConversion as q, type NumberBase as r, type PxConvertResult as s, type SubnetInfo as t, units as u, type TaxResult as v, autoFormat as w, bumpVersion as x, calcAspectRatio as y, calcSubnet as z };
+export { fitIntoBox as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, autoFormat as E, type FilePermissions as F, bumpVersion as G, calcAspectRatio as H, type IbanValidationResult as I, calcSubnet as J, calculateCompoundInterest as K, type LoanResult as L, calculateLoan as M, type NotationStyle as N, calculateTax as O, type Permission as P, compareSemver as Q, convert as R, type SemverVersion as S, type TaxDirection as T, convertBytes as U, type ViewportConvertResult as V, convertIp as W, coverBox as X, decimalToIp as Y, decimalToIpCidr as Z, describePermissions as _, type AspectRatioResult as a, formatNumber as a0, formatValue as a1, formatVwValue as a2, formatWithSeparator as a3, gcd as a4, ipFromBinary as a5, ipFromDecimal as a6, ipFromHex as a7, ipToBinary as a8, ipToDecimal as a9, validateCardNumber as aA, validateIban as aB, validateIsbn as aC, viewportToPx as aD, ipToDecimalCidr as aa, ipToHex as ab, ipToOctal as ac, isValid as ad, isValidCidr as ae, isValidIp as af, isValidIpv4 as ag, octalToPermissions as ah, parseFileSize as ai, parseInput as aj, parseNumberString as ak, parseSemver as al, permissionsToChmod as am, permissionsToOctal as an, permissionsToSymbolic as ao, ptToPx as ap, pxToAll as aq, pxToViewport as ar, remToPx as as, satisfiesRange as at, scaleByHeight as au, scaleByWidth as av, sortVersions as aw, splitSubnet as ax, symbolicToPermissions as ay, validateBarcode as az, BASE_PREFIXES as b, BYTE_UNITS as c, type BarcodeFormat as d, type BarcodeValidationResult as e, type BaseConvertResult as f, type ByteConvertResult as g, type ByteUnit as h, COMMON_LOCALES as i, COMMON_PERMISSIONS as j, COMMON_RATIOS as k, COMMON_SIZES as l, COMMON_TAX_RATES as m, COMMON_VIEWPORTS as n, type CardValidationResult as o, type CompoundInterestResult as p, type CompoundYearRow as q, type FormatOptions as r, type IpConversion as s, type IsbnFormat as t, units as u, type IsbnResult as v, type NumberBase as w, type PxConvertResult as x, type SubnetInfo as y, type TaxResult as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.13.0",
+  "version": "0.14.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",