@utilix-tech/sdk 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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.12.0
+- Added ICO Favicon Inspector (`readIcoInfo`) and Barcode Checksum Validator (`validateBarcode`).
+
+## 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.**
+**535 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, validateBarcode } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -264,6 +264,18 @@ 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: [...] }
+
+// EAN-13 / EAN-8 / UPC-A barcode checksum validation
+validateBarcode("4006381333931");
+// { valid: true, format: "EAN-13", digits: "4006381333931", checkDigit: 1, expectedCheckDigit: 1 }
 ```
 
 ---
@@ -436,10 +448,10 @@ analyzeString("café");          // { length: 4, codePoints: [...], ... }
 
 ---
 
-### `/media`: Image Header Parsing, EXIF, PDF, WAV & ID3 Metadata
+### `/media`: Image Header Parsing, EXIF, PDF, WAV, ID3 & ICO Metadata
 
 ```ts
-import { readImageInfo, readExifData, readPdfMetadata, readWavInfo, readId3Tags } from "@utilix-tech/sdk/media";
+import { readImageInfo, readExifData, readPdfMetadata, readWavInfo, readId3Tags, readIcoInfo } from "@utilix-tech/sdk/media";
 
 // Reads format, dimensions, bit depth, and alpha channel straight from
 // file bytes: no decoding, no canvas, no image library.
@@ -471,9 +483,15 @@ readWavInfo(new Uint8Array(wavBytes));
 const mp3Bytes = await fs.promises.readFile("track.mp3");
 readId3Tags(new Uint8Array(mp3Bytes));
 // { version: "ID3v2.3.0", title: "Track Name", artist: "Artist Name", genre: "Rock", ... }
+
+// Reads how many images a .ico file embeds and each one's dimensions, color
+// depth, and size directly from its ICONDIR/ICONDIRENTRY header table.
+const icoBytes = await fs.promises.readFile("favicon.ico");
+readIcoInfo(new Uint8Array(icoBytes));
+// { imageCount: 3, images: [{ width: 16, height: 16, bitCount: 32, bytesInRes: 1128, ... }, ...] }
 ```
 
-`readImageInfo` supports PNG, JPEG, GIF, WebP, and BMP. `readExifData` supports JPEG only. `readWavInfo` supports the canonical RIFF/WAVE container only. `readId3Tags` decodes ID3v2.3/2.4 and ID3v1/1.1 only (ID3v2.2 is detected but not decoded).
+`readImageInfo` supports PNG, JPEG, GIF, WebP, and BMP. `readExifData` supports JPEG only. `readWavInfo` supports the canonical RIFF/WAVE container only. `readId3Tags` decodes ID3v2.3/2.4 and ID3v1/1.1 only (ID3v2.2 is detected but not decoded). `readIcoInfo` reads .ico icon files only and rejects .cur cursor files.
 
 ---
 
@@ -488,7 +506,7 @@ readId3Tags(new Uint8Array(mp3Bytes));
 | `@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 |
+| `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode validation, loan 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 |
@@ -496,7 +514,7 @@ readId3Tags(new Uint8Array(mp3Bytes));
 | `@utilix-tech/sdk/css` | CSS gradient, box-shadow, border-radius, keyframe animation generators |
 | `@utilix-tech/sdk/misc` | SVG optimize/sanitize, file size format, Unicode inspector |
 | `@utilix-tech/sdk/ai_agent` | Token estimate/trim, chunk text, extract URLs/JSON/keywords, sanitize HTML, flatten/merge JSON, dedupe lines, validate schema, PII/secret/injection detect |
-| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; WAV audio info |
+| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; WAV audio info; ID3 tags; ICO favicon inspection |
 
 ---
 

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

@@ -16,6 +16,7 @@ __export(units_exports, {
   bumpVersion: () => bumpVersion,
   calcAspectRatio: () => calcAspectRatio,
   calcSubnet: () => calcSubnet,
+  calculateLoan: () => calculateLoan,
   compareSemver: () => compareSemver,
   convert: () => convert,
   convertBytes: () => convertBytes,
@@ -60,7 +61,9 @@ __export(units_exports, {
   sortVersions: () => sortVersions,
   splitSubnet: () => splitSubnet,
   symbolicToPermissions: () => symbolicToPermissions,
+  validateBarcode: () => validateBarcode,
   validateCardNumber: () => validateCardNumber,
+  validateIban: () => validateIban,
   viewportToPx: () => viewportToPx
 });
 function pxToAll(px, baseFontSize = 16, viewportWidth = 1440, viewportHeight = 900) {
@@ -953,5 +956,189 @@ 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
+  };
+}
+var BARCODE_FORMAT_BY_LENGTH = { 8: "EAN-8", 12: "UPC-A", 13: "EAN-13" };
+function computeBarcodeCheckDigit(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 (10 - sum % 10) % 10;
+}
+function validateBarcode(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const digits = input.replace(/[\s-]/g, "");
+  if (!/^\d+$/.test(digits)) return { error: "Barcode must contain only digits (spaces and hyphens are ignored)" };
+  const format = BARCODE_FORMAT_BY_LENGTH[digits.length];
+  if (!format) {
+    return { error: `Unsupported barcode length (${digits.length} digits); expected 8 (EAN-8), 12 (UPC-A), or 13 (EAN-13)` };
+  }
+  const dataDigits = digits.slice(0, -1).split("").map(Number);
+  const checkDigit = Number(digits[digits.length - 1]);
+  const expectedCheckDigit = computeBarcodeCheckDigit(dataDigits);
+  return { valid: checkDigit === expectedCheckDigit, format, digits, checkDigit, expectedCheckDigit };
+}
 
-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, validateBarcode, validateCardNumber, validateIban, viewportToPx };

package/dist/{chunk-GUUYEIU6.js → chunk-XMKJYVKB.js}

@@ -4,6 +4,7 @@ import { __export } from './chunk-MLKGABMK.js';
 var media_exports = {};
 __export(media_exports, {
   readExifData: () => readExifData,
+  readIcoInfo: () => readIcoInfo,
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
   readPdfMetadata: () => readPdfMetadata,
@@ -730,5 +731,38 @@ function readId3Tags(bytes) {
   }
   return { error: "No ID3v1 or ID3v2.3/2.4 tags found in this file" };
 }
+function readU16LE(bytes, offset) {
+  return bytes[offset] | bytes[offset + 1] << 8;
+}
+function readU32LE(bytes, offset) {
+  return (bytes[offset] | bytes[offset + 1] << 8 | bytes[offset + 2] << 16 | bytes[offset + 3] << 24) >>> 0;
+}
+function readIcoInfo(bytes) {
+  if (bytes.length < 6) return { error: "File too small to be a valid ICO file" };
+  if (readU16LE(bytes, 0) !== 0) return { error: "Not a valid ICO file (reserved header field must be 0)" };
+  const type = readU16LE(bytes, 2);
+  if (type === 2) return { error: "This is a .cur cursor file (type 2), not a .ico icon file" };
+  if (type !== 1) return { error: `Unrecognized ICONDIR type (${type}); expected 1 for an icon file` };
+  const count = readU16LE(bytes, 4);
+  if (count === 0) return { error: "ICO file declares zero embedded images" };
+  const images = [];
+  for (let i = 0; i < count; i++) {
+    const offset = 6 + i * 16;
+    if (offset + 16 > bytes.length) return { error: `Truncated ICONDIRENTRY for image ${i}` };
+    const widthRaw = bytes[offset];
+    const heightRaw = bytes[offset + 1];
+    const colorCountRaw = bytes[offset + 2];
+    images.push({
+      width: widthRaw === 0 ? 256 : widthRaw,
+      height: heightRaw === 0 ? 256 : heightRaw,
+      colorCount: colorCountRaw === 0 ? null : colorCountRaw,
+      planes: readU16LE(bytes, offset + 4),
+      bitCount: readU16LE(bytes, offset + 6),
+      bytesInRes: readU32LE(bytes, offset + 8),
+      imageOffset: readU32LE(bytes, offset + 12)
+    });
+  }
+  return { imageCount: count, images };
+}
 
-export { media_exports, readExifData, readId3Tags, readImageInfo, readPdfMetadata, readWavInfo };
+export { media_exports, readExifData, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readWavInfo };

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,
@@ -6665,7 +6666,9 @@ __export(units_exports, {
   sortVersions: () => sortVersions,
   splitSubnet: () => splitSubnet,
   symbolicToPermissions: () => symbolicToPermissions,
+  validateBarcode: () => validateBarcode,
   validateCardNumber: () => validateCardNumber,
+  validateIban: () => validateIban,
   viewportToPx: () => viewportToPx
 });
 function pxToAll(px, baseFontSize = 16, viewportWidth = 1440, viewportHeight = 900) {
@@ -7558,6 +7561,190 @@ 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
+  };
+}
+var BARCODE_FORMAT_BY_LENGTH = { 8: "EAN-8", 12: "UPC-A", 13: "EAN-13" };
+function computeBarcodeCheckDigit(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 (10 - sum % 10) % 10;
+}
+function validateBarcode(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const digits = input.replace(/[\s-]/g, "");
+  if (!/^\d+$/.test(digits)) return { error: "Barcode must contain only digits (spaces and hyphens are ignored)" };
+  const format = BARCODE_FORMAT_BY_LENGTH[digits.length];
+  if (!format) {
+    return { error: `Unsupported barcode length (${digits.length} digits); expected 8 (EAN-8), 12 (UPC-A), or 13 (EAN-13)` };
+  }
+  const dataDigits = digits.slice(0, -1).split("").map(Number);
+  const checkDigit = Number(digits[digits.length - 1]);
+  const expectedCheckDigit = computeBarcodeCheckDigit(dataDigits);
+  return { valid: checkDigit === expectedCheckDigit, format, digits, checkDigit, expectedCheckDigit };
+}
 
 // src/tools/network.ts
 var network_exports = {};
@@ -17251,6 +17438,7 @@ function summarizeForLlm(text, maxTokens = 200, strategy = "extractive") {
 var media_exports = {};
 __export(media_exports, {
   readExifData: () => readExifData,
+  readIcoInfo: () => readIcoInfo,
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
   readPdfMetadata: () => readPdfMetadata,
@@ -17452,12 +17640,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 +17734,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);
       }
     }
   }
@@ -17977,6 +18165,39 @@ function readId3Tags(bytes) {
   }
   return { error: "No ID3v1 or ID3v2.3/2.4 tags found in this file" };
 }
+function readU16LE(bytes, offset) {
+  return bytes[offset] | bytes[offset + 1] << 8;
+}
+function readU32LE(bytes, offset) {
+  return (bytes[offset] | bytes[offset + 1] << 8 | bytes[offset + 2] << 16 | bytes[offset + 3] << 24) >>> 0;
+}
+function readIcoInfo(bytes) {
+  if (bytes.length < 6) return { error: "File too small to be a valid ICO file" };
+  if (readU16LE(bytes, 0) !== 0) return { error: "Not a valid ICO file (reserved header field must be 0)" };
+  const type = readU16LE(bytes, 2);
+  if (type === 2) return { error: "This is a .cur cursor file (type 2), not a .ico icon file" };
+  if (type !== 1) return { error: `Unrecognized ICONDIR type (${type}); expected 1 for an icon file` };
+  const count = readU16LE(bytes, 4);
+  if (count === 0) return { error: "ICO file declares zero embedded images" };
+  const images = [];
+  for (let i = 0; i < count; i++) {
+    const offset = 6 + i * 16;
+    if (offset + 16 > bytes.length) return { error: `Truncated ICONDIRENTRY for image ${i}` };
+    const widthRaw = bytes[offset];
+    const heightRaw = bytes[offset + 1];
+    const colorCountRaw = bytes[offset + 2];
+    images.push({
+      width: widthRaw === 0 ? 256 : widthRaw,
+      height: heightRaw === 0 ? 256 : heightRaw,
+      colorCount: colorCountRaw === 0 ? null : colorCountRaw,
+      planes: readU16LE(bytes, offset + 4),
+      bitCount: readU16LE(bytes, offset + 6),
+      bytesInRes: readU32LE(bytes, offset + 8),
+      imageOffset: readU32LE(bytes, offset + 12)
+    });
+  }
+  return { imageCount: count, images };
+}
 
 // src/index.ts
 var version = "0.1.0";

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-Dt80-S2j.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';
@@ -13,7 +13,7 @@ export { c as color } from './color-tPwZCr9H.cjs';
 export { c as css } from './css-Cf7AMGM-.cjs';
 export { m as misc } from './misc-CA3N198T.cjs';
 export { a as ai_agent } from './ai_agent-CcpkV2DR.cjs';
-export { m as media } from './media-C3ZvGyKc.cjs';
+export { m as media } from './media-9HEpTPGA.cjs';
 
 declare const version = "0.1.0";
 

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-Dt80-S2j.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';
@@ -13,7 +13,7 @@ export { c as color } from './color-tPwZCr9H.js';
 export { c as css } from './css-Cf7AMGM-.js';
 export { m as misc } from './misc-CA3N198T.js';
 export { a as ai_agent } from './ai_agent-CcpkV2DR.js';
-export { m as media } from './media-C3ZvGyKc.js';
+export { m as media } from './media-9HEpTPGA.js';
 
 declare const version = "0.1.0";
 

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 { media_exports as media } from './chunk-XMKJYVKB.js';
+export { units_exports as units } from './chunk-CJGHHS5M.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';