@utilix-tech/sdk 0.11.0 → 0.12.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.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.)

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**533 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, validateIban, calculateLoan } 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
@@ -272,6 +272,10 @@ validateIban("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 }
 ```
 
 ---
@@ -444,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.
@@ -479,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.
 
 ---
 
@@ -496,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 |
@@ -504,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-GGDDCTFM.js → chunk-CJGHHS5M.js}

@@ -61,6 +61,7 @@ __export(units_exports, {
   sortVersions: () => sortVersions,
   splitSubnet: () => splitSubnet,
   symbolicToPermissions: () => symbolicToPermissions,
+  validateBarcode: () => validateBarcode,
   validateCardNumber: () => validateCardNumber,
   validateIban: () => validateIban,
   viewportToPx: () => viewportToPx
@@ -1115,5 +1116,29 @@ function calculateLoan(principal, annualRatePercent, 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, 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 };
+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

@@ -6666,6 +6666,7 @@ __export(units_exports, {
   sortVersions: () => sortVersions,
   splitSubnet: () => splitSubnet,
   symbolicToPermissions: () => symbolicToPermissions,
+  validateBarcode: () => validateBarcode,
   validateCardNumber: () => validateCardNumber,
   validateIban: () => validateIban,
   viewportToPx: () => viewportToPx
@@ -7720,6 +7721,30 @@ function calculateLoan(principal, annualRatePercent, 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 = {};
@@ -17413,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,
@@ -18139,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-BG387sch.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-BG387sch.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-GGDDCTFM.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';

package/dist/{media-C3ZvGyKc.d.cts → media-9HEpTPGA.d.cts}

@@ -108,9 +108,35 @@ interface Id3TagsError {
  * ID3v2.2 tags are detected but their 3-character frame IDs are not decoded.
  */
 declare function readId3Tags(bytes: Uint8Array): Id3Tags | Id3TagsError;
+interface IcoImageEntry {
+    width: number;
+    height: number;
+    colorCount: number | null;
+    planes: number;
+    bitCount: number;
+    bytesInRes: number;
+    imageOffset: number;
+}
+interface IcoInfo {
+    imageCount: number;
+    images: IcoImageEntry[];
+}
+interface IcoInfoError {
+    error: string;
+}
+/**
+ * Read a .ico file's ICONDIR/ICONDIRENTRY header table to report how many
+ * images it embeds and each one's width, height, color depth, and size,
+ * without decoding any pixel data. Rejects .cur cursor files, which share
+ * the same container format but a different type flag.
+ */
+declare function readIcoInfo(bytes: Uint8Array): IcoInfo | IcoInfoError;
 
 type media_ExifData = ExifData;
 type media_ExifError = ExifError;
+type media_IcoImageEntry = IcoImageEntry;
+type media_IcoInfo = IcoInfo;
+type media_IcoInfoError = IcoInfoError;
 type media_Id3Tags = Id3Tags;
 type media_Id3TagsError = Id3TagsError;
 type media_ImageFormat = ImageFormat;
@@ -121,12 +147,13 @@ type media_PdfMetadataError = PdfMetadataError;
 type media_WavInfo = WavInfo;
 type media_WavInfoError = WavInfoError;
 declare const media_readExifData: typeof readExifData;
+declare const media_readIcoInfo: typeof readIcoInfo;
 declare const media_readId3Tags: typeof readId3Tags;
 declare const media_readImageInfo: typeof readImageInfo;
 declare const media_readPdfMetadata: typeof readPdfMetadata;
 declare const media_readWavInfo: typeof readWavInfo;
 declare namespace media {
-  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_Id3Tags as Id3Tags, type media_Id3TagsError as Id3TagsError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readWavInfo as readWavInfo };
+  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_IcoImageEntry as IcoImageEntry, type media_IcoInfo as IcoInfo, type media_IcoInfoError as IcoInfoError, type media_Id3Tags as Id3Tags, type media_Id3TagsError as Id3TagsError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readWavInfo as readWavInfo };
 }
 
-export { type ExifData as E, type Id3Tags as I, type PdfMetadata as P, type WavInfo as W, type ExifError as a, type Id3TagsError as b, type ImageFormat as c, type ImageInfo as d, type ImageInfoError as e, type PdfMetadataError as f, type WavInfoError as g, readId3Tags as h, readImageInfo as i, readPdfMetadata as j, readWavInfo as k, media as m, readExifData as r };
+export { type ExifData as E, type IcoImageEntry as I, type PdfMetadata as P, type WavInfo as W, type ExifError as a, type IcoInfo as b, type IcoInfoError as c, type Id3Tags as d, type Id3TagsError as e, type ImageFormat as f, type ImageInfo as g, type ImageInfoError as h, type PdfMetadataError as i, type WavInfoError as j, readIcoInfo as k, readId3Tags as l, media as m, readImageInfo as n, readPdfMetadata as o, readWavInfo as p, readExifData as r };

package/dist/{media-C3ZvGyKc.d.ts → media-9HEpTPGA.d.ts}

@@ -108,9 +108,35 @@ interface Id3TagsError {
  * ID3v2.2 tags are detected but their 3-character frame IDs are not decoded.
  */
 declare function readId3Tags(bytes: Uint8Array): Id3Tags | Id3TagsError;
+interface IcoImageEntry {
+    width: number;
+    height: number;
+    colorCount: number | null;
+    planes: number;
+    bitCount: number;
+    bytesInRes: number;
+    imageOffset: number;
+}
+interface IcoInfo {
+    imageCount: number;
+    images: IcoImageEntry[];
+}
+interface IcoInfoError {
+    error: string;
+}
+/**
+ * Read a .ico file's ICONDIR/ICONDIRENTRY header table to report how many
+ * images it embeds and each one's width, height, color depth, and size,
+ * without decoding any pixel data. Rejects .cur cursor files, which share
+ * the same container format but a different type flag.
+ */
+declare function readIcoInfo(bytes: Uint8Array): IcoInfo | IcoInfoError;
 
 type media_ExifData = ExifData;
 type media_ExifError = ExifError;
+type media_IcoImageEntry = IcoImageEntry;
+type media_IcoInfo = IcoInfo;
+type media_IcoInfoError = IcoInfoError;
 type media_Id3Tags = Id3Tags;
 type media_Id3TagsError = Id3TagsError;
 type media_ImageFormat = ImageFormat;
@@ -121,12 +147,13 @@ type media_PdfMetadataError = PdfMetadataError;
 type media_WavInfo = WavInfo;
 type media_WavInfoError = WavInfoError;
 declare const media_readExifData: typeof readExifData;
+declare const media_readIcoInfo: typeof readIcoInfo;
 declare const media_readId3Tags: typeof readId3Tags;
 declare const media_readImageInfo: typeof readImageInfo;
 declare const media_readPdfMetadata: typeof readPdfMetadata;
 declare const media_readWavInfo: typeof readWavInfo;
 declare namespace media {
-  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_Id3Tags as Id3Tags, type media_Id3TagsError as Id3TagsError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readWavInfo as readWavInfo };
+  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_IcoImageEntry as IcoImageEntry, type media_IcoInfo as IcoInfo, type media_IcoInfoError as IcoInfoError, type media_Id3Tags as Id3Tags, type media_Id3TagsError as Id3TagsError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readWavInfo as readWavInfo };
 }
 
-export { type ExifData as E, type Id3Tags as I, type PdfMetadata as P, type WavInfo as W, type ExifError as a, type Id3TagsError as b, type ImageFormat as c, type ImageInfo as d, type ImageInfoError as e, type PdfMetadataError as f, type WavInfoError as g, readId3Tags as h, readImageInfo as i, readPdfMetadata as j, readWavInfo as k, media as m, readExifData as r };
+export { type ExifData as E, type IcoImageEntry as I, type PdfMetadata as P, type WavInfo as W, type ExifError as a, type IcoInfo as b, type IcoInfoError as c, type Id3Tags as d, type Id3TagsError as e, type ImageFormat as f, type ImageInfo as g, type ImageInfoError as h, type PdfMetadataError as i, type WavInfoError as j, readIcoInfo as k, readId3Tags as l, media as m, readImageInfo as n, readPdfMetadata as o, readWavInfo as p, readExifData as r };

package/dist/tools/media.cjs

@@ -722,8 +722,42 @@ 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 };
+}
 
 exports.readExifData = readExifData;
+exports.readIcoInfo = readIcoInfo;
 exports.readId3Tags = readId3Tags;
 exports.readImageInfo = readImageInfo;
 exports.readPdfMetadata = readPdfMetadata;

package/dist/tools/media.d.cts

@@ -1 +1 @@
-export { E as ExifData, a as ExifError, I as Id3Tags, b as Id3TagsError, c as ImageFormat, d as ImageInfo, e as ImageInfoError, P as PdfMetadata, f as PdfMetadataError, W as WavInfo, g as WavInfoError, r as readExifData, h as readId3Tags, i as readImageInfo, j as readPdfMetadata, k as readWavInfo } from '../media-C3ZvGyKc.cjs';
+export { E as ExifData, a as ExifError, I as IcoImageEntry, b as IcoInfo, c as IcoInfoError, d as Id3Tags, e as Id3TagsError, f as ImageFormat, g as ImageInfo, h as ImageInfoError, P as PdfMetadata, i as PdfMetadataError, W as WavInfo, j as WavInfoError, r as readExifData, k as readIcoInfo, l as readId3Tags, n as readImageInfo, o as readPdfMetadata, p as readWavInfo } from '../media-9HEpTPGA.cjs';

package/dist/tools/media.d.ts

@@ -1 +1 @@
-export { E as ExifData, a as ExifError, I as Id3Tags, b as Id3TagsError, c as ImageFormat, d as ImageInfo, e as ImageInfoError, P as PdfMetadata, f as PdfMetadataError, W as WavInfo, g as WavInfoError, r as readExifData, h as readId3Tags, i as readImageInfo, j as readPdfMetadata, k as readWavInfo } from '../media-C3ZvGyKc.js';
+export { E as ExifData, a as ExifError, I as IcoImageEntry, b as IcoInfo, c as IcoInfoError, d as Id3Tags, e as Id3TagsError, f as ImageFormat, g as ImageInfo, h as ImageInfoError, P as PdfMetadata, i as PdfMetadataError, W as WavInfo, j as WavInfoError, r as readExifData, k as readIcoInfo, l as readId3Tags, n as readImageInfo, o as readPdfMetadata, p as readWavInfo } from '../media-9HEpTPGA.js';

package/dist/tools/media.js

@@ -1,2 +1,2 @@
-export { readExifData, readId3Tags, readImageInfo, readPdfMetadata, readWavInfo } from '../chunk-GUUYEIU6.js';
+export { readExifData, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readWavInfo } from '../chunk-XMKJYVKB.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/units.cjs

@@ -1051,6 +1051,30 @@ function calculateLoan(principal, annualRatePercent, 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 };
+}
 
 exports.BASE_LABELS = BASE_LABELS;
 exports.BASE_PREFIXES = BASE_PREFIXES;
@@ -1110,6 +1134,7 @@ exports.scaleByWidth = scaleByWidth;
 exports.sortVersions = sortVersions;
 exports.splitSubnet = splitSubnet;
 exports.symbolicToPermissions = symbolicToPermissions;
+exports.validateBarcode = validateBarcode;
 exports.validateCardNumber = validateCardNumber;
 exports.validateIban = validateIban;
 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 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';
+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_VIEWPORTS, n as CardValidationResult, D as Dimensions, F as FilePermissions, o as FormatOptions, I as IbanValidationResult, p as IpConversion, L as LoanResult, N as NotationStyle, q as NumberBase, P as Permission, r as PxConvertResult, S as SemverVersion, s as SubnetInfo, V as ViewportConvertResult, t as autoFormat, v as bumpVersion, w as calcAspectRatio, x as calcSubnet, y as calculateLoan, z as compareSemver, E as convert, G as convertBytes, H as convertIp, J as coverBox, K as decimalToIp, M as decimalToIpCidr, O as describePermissions, Q as fitIntoBox, R as formatNumber, T as formatValue, U as formatVwValue, W as formatWithSeparator, X as gcd, Y as ipFromBinary, Z as ipFromDecimal, _ as ipFromHex, $ as ipToBinary, a0 as ipToDecimal, a1 as ipToDecimalCidr, a2 as ipToHex, a3 as ipToOctal, a4 as isValid, a5 as isValidCidr, a6 as isValidIp, a7 as isValidIpv4, a8 as octalToPermissions, a9 as parseFileSize, aa as parseInput, ab as parseNumberString, ac as parseSemver, ad as permissionsToChmod, ae as permissionsToOctal, af as permissionsToSymbolic, ag as ptToPx, ah as pxToAll, ai as pxToViewport, aj as remToPx, ak as satisfiesRange, al as scaleByHeight, am as scaleByWidth, an as sortVersions, ao as splitSubnet, ap as symbolicToPermissions, aq as validateBarcode, ar as validateCardNumber, as as validateIban, at as viewportToPx } from '../units-Dt80-S2j.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 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';
+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_VIEWPORTS, n as CardValidationResult, D as Dimensions, F as FilePermissions, o as FormatOptions, I as IbanValidationResult, p as IpConversion, L as LoanResult, N as NotationStyle, q as NumberBase, P as Permission, r as PxConvertResult, S as SemverVersion, s as SubnetInfo, V as ViewportConvertResult, t as autoFormat, v as bumpVersion, w as calcAspectRatio, x as calcSubnet, y as calculateLoan, z as compareSemver, E as convert, G as convertBytes, H as convertIp, J as coverBox, K as decimalToIp, M as decimalToIpCidr, O as describePermissions, Q as fitIntoBox, R as formatNumber, T as formatValue, U as formatVwValue, W as formatWithSeparator, X as gcd, Y as ipFromBinary, Z as ipFromDecimal, _ as ipFromHex, $ as ipToBinary, a0 as ipToDecimal, a1 as ipToDecimalCidr, a2 as ipToHex, a3 as ipToOctal, a4 as isValid, a5 as isValidCidr, a6 as isValidIp, a7 as isValidIpv4, a8 as octalToPermissions, a9 as parseFileSize, aa as parseInput, ab as parseNumberString, ac as parseSemver, ad as permissionsToChmod, ae as permissionsToOctal, af as permissionsToSymbolic, ag as ptToPx, ah as pxToAll, ai as pxToViewport, aj as remToPx, ak as satisfiesRange, al as scaleByHeight, am as scaleByWidth, an as sortVersions, ao as splitSubnet, ap as symbolicToPermissions, aq as validateBarcode, ar as validateCardNumber, as as validateIban, at as viewportToPx } from '../units-Dt80-S2j.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, 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';
+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, validateBarcode, validateCardNumber, validateIban, viewportToPx } from '../chunk-CJGHHS5M.js';
 import '../chunk-MLKGABMK.js';

package/dist/{units-BG387sch.d.cts → units-Dt80-S2j.d.cts}

@@ -279,12 +279,30 @@ interface LoanResult {
 declare function calculateLoan(principal: number, annualRatePercent: number, termMonths: number): LoanResult | {
     error: string;
 };
+type BarcodeFormat = "EAN-13" | "EAN-8" | "UPC-A";
+interface BarcodeValidationResult {
+    valid: boolean;
+    format: BarcodeFormat;
+    digits: string;
+    checkDigit: number;
+    expectedCheckDigit: number;
+}
+/**
+ * Validate an EAN-13, EAN-8, or UPC-A barcode number via its weighted
+ * mod-10 check digit algorithm. The format is inferred from the digit
+ * count (8, 12, or 13) once spaces and hyphens are stripped.
+ */
+declare function validateBarcode(input: string): BarcodeValidationResult | {
+    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;
 declare const units_BYTE_UNITS: typeof BYTE_UNITS;
+type units_BarcodeFormat = BarcodeFormat;
+type units_BarcodeValidationResult = BarcodeValidationResult;
 type units_BaseConvertResult = BaseConvertResult;
 type units_ByteConvertResult = ByteConvertResult;
 type units_ByteUnit = ByteUnit;
@@ -357,11 +375,12 @@ declare const units_scaleByWidth: typeof scaleByWidth;
 declare const units_sortVersions: typeof sortVersions;
 declare const units_splitSubnet: typeof splitSubnet;
 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_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_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 { 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_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_validateBarcode as validateBarcode, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, units_viewportToPx as viewportToPx };
 }
 
-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 };
+export { ipToBinary as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, convert as E, type FilePermissions as F, convertBytes as G, convertIp as H, type IbanValidationResult as I, coverBox as J, decimalToIp as K, type LoanResult as L, decimalToIpCidr as M, type NotationStyle as N, describePermissions as O, type Permission as P, fitIntoBox as Q, formatNumber as R, type SemverVersion as S, formatValue as T, formatVwValue as U, type ViewportConvertResult as V, formatWithSeparator as W, gcd as X, ipFromBinary as Y, ipFromDecimal as Z, ipFromHex as _, type AspectRatioResult as a, ipToDecimal as a0, ipToDecimalCidr as a1, ipToHex as a2, ipToOctal as a3, isValid as a4, isValidCidr as a5, isValidIp as a6, isValidIpv4 as a7, octalToPermissions as a8, parseFileSize as a9, parseInput as aa, parseNumberString as ab, parseSemver as ac, permissionsToChmod as ad, permissionsToOctal as ae, permissionsToSymbolic as af, ptToPx as ag, pxToAll as ah, pxToViewport as ai, remToPx as aj, satisfiesRange as ak, scaleByHeight as al, scaleByWidth as am, sortVersions as an, splitSubnet as ao, symbolicToPermissions as ap, validateBarcode as aq, validateCardNumber as ar, validateIban as as, viewportToPx as at, 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_VIEWPORTS as m, type CardValidationResult as n, type FormatOptions as o, type IpConversion as p, type NumberBase as q, type PxConvertResult as r, type SubnetInfo as s, autoFormat as t, units as u, bumpVersion as v, calcAspectRatio as w, calcSubnet as x, calculateLoan as y, compareSemver as z };

package/dist/{units-BG387sch.d.ts → units-Dt80-S2j.d.ts}

@@ -279,12 +279,30 @@ interface LoanResult {
 declare function calculateLoan(principal: number, annualRatePercent: number, termMonths: number): LoanResult | {
     error: string;
 };
+type BarcodeFormat = "EAN-13" | "EAN-8" | "UPC-A";
+interface BarcodeValidationResult {
+    valid: boolean;
+    format: BarcodeFormat;
+    digits: string;
+    checkDigit: number;
+    expectedCheckDigit: number;
+}
+/**
+ * Validate an EAN-13, EAN-8, or UPC-A barcode number via its weighted
+ * mod-10 check digit algorithm. The format is inferred from the digit
+ * count (8, 12, or 13) once spaces and hyphens are stripped.
+ */
+declare function validateBarcode(input: string): BarcodeValidationResult | {
+    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;
 declare const units_BYTE_UNITS: typeof BYTE_UNITS;
+type units_BarcodeFormat = BarcodeFormat;
+type units_BarcodeValidationResult = BarcodeValidationResult;
 type units_BaseConvertResult = BaseConvertResult;
 type units_ByteConvertResult = ByteConvertResult;
 type units_ByteUnit = ByteUnit;
@@ -357,11 +375,12 @@ declare const units_scaleByWidth: typeof scaleByWidth;
 declare const units_sortVersions: typeof sortVersions;
 declare const units_splitSubnet: typeof splitSubnet;
 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_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_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 { 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_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_validateBarcode as validateBarcode, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, units_viewportToPx as viewportToPx };
 }
 
-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 };
+export { ipToBinary as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, convert as E, type FilePermissions as F, convertBytes as G, convertIp as H, type IbanValidationResult as I, coverBox as J, decimalToIp as K, type LoanResult as L, decimalToIpCidr as M, type NotationStyle as N, describePermissions as O, type Permission as P, fitIntoBox as Q, formatNumber as R, type SemverVersion as S, formatValue as T, formatVwValue as U, type ViewportConvertResult as V, formatWithSeparator as W, gcd as X, ipFromBinary as Y, ipFromDecimal as Z, ipFromHex as _, type AspectRatioResult as a, ipToDecimal as a0, ipToDecimalCidr as a1, ipToHex as a2, ipToOctal as a3, isValid as a4, isValidCidr as a5, isValidIp as a6, isValidIpv4 as a7, octalToPermissions as a8, parseFileSize as a9, parseInput as aa, parseNumberString as ab, parseSemver as ac, permissionsToChmod as ad, permissionsToOctal as ae, permissionsToSymbolic as af, ptToPx as ag, pxToAll as ah, pxToViewport as ai, remToPx as aj, satisfiesRange as ak, scaleByHeight as al, scaleByWidth as am, sortVersions as an, splitSubnet as ao, symbolicToPermissions as ap, validateBarcode as aq, validateCardNumber as ar, validateIban as as, viewportToPx as at, 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_VIEWPORTS as m, type CardValidationResult as n, type FormatOptions as o, type IpConversion as p, type NumberBase as q, type PxConvertResult as r, type SubnetInfo as s, autoFormat as t, units as u, bumpVersion as v, calcAspectRatio as w, calcSubnet as x, calculateLoan as y, compareSemver as z };

package/package.json

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