@utilix-tech/sdk 0.28.0 → 0.29.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.29.0
+- Add `readPdfPageDimensions` (pdf-page-dimensions): each page's MediaBox width/height (points and inches), rotation, and orientation, walking the Root -> Pages -> Kids tree and inheriting from ancestor nodes, plus a common paper size match (Letter, A4, etc.).
+- Add `parseIpv6Address` (ipv6-compressor): expand an IPv6 address to its full 8-group form or compress it to its RFC 5952 canonical shortest form, classify its address type, and handle an embedded IPv4 suffix or zone ID.
+
 ## 0.28.0
 - Add `readVideoInfo` (mp4-webm-video-info): duration, resolution, and video/audio codec identifiers from an MP4 (ISO BMFF moov box) or WebM (EBML/Matroska Segment) container header, with no frame decoding or transcoding.
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**579 developer utility functions for Node.js: runs locally, no API key required.**
+**581 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)
@@ -372,7 +372,7 @@ calculateRuleOf72(8, "rate-to-years");
 import { getStatusCode, isValidIp, isValidIpv4, isValidIpv6,
          searchStatusCodes, buildGeoUrl, countryCodeToFlag,
          parseHar, validateSitemap, validateRobotsTxt,
-         parseUserAgent, buildCacheControl } from "@utilix-tech/sdk/network";
+         parseUserAgent, buildCacheControl, parseIpv6Address } from "@utilix-tech/sdk/network";
 
 getStatusCode(404);
 // { code: 404, text: "Not Found", description: "...", category: "Client Error" }
@@ -406,6 +406,11 @@ validateRobotsTxt("User-agent: *\nDisallow: /admin\nSitemap: https://example.com
 // Build and explain a Cache-Control response header from directives
 buildCacheControl({ visibility: "public", maxAge: 3600, mustRevalidate: true });
 // { header: "public, max-age=3600, must-revalidate", directives: [...], warnings: [] }
+
+// Expand/compress an IPv6 address (RFC 5952) and classify its address type
+parseIpv6Address("2001:db8::ff00:42:8329");
+// { expanded: "2001:0db8:0000:0000:0000:ff00:0042:8329", compressed: "2001:db8::ff00:42:8329",
+//   groups: [...], zoneId: null, addressType: "documentation" }
 ```
 
 ---
@@ -561,10 +566,10 @@ analyzeString("café");          // { length: 4, codePoints: [...], ... }
 
 ---
 
-### `/media`: Image Header Parsing, EXIF, PDF, WAV, ID3, ICO, FLAC & Video Metadata
+### `/media`: Image Header Parsing, EXIF, PDF Metadata & Page Dimensions, WAV, ID3, ICO, FLAC & Video Metadata
 
 ```ts
-import { readImageInfo, readExifData, readPdfMetadata, readWavInfo, readId3Tags, readIcoInfo, readFlacInfo, readVideoInfo } from "@utilix-tech/sdk/media";
+import { readImageInfo, readExifData, readPdfMetadata, readPdfPageDimensions, readWavInfo, readId3Tags, readIcoInfo, readFlacInfo, readVideoInfo } from "@utilix-tech/sdk/media";
 
 // Reads format, dimensions, bit depth, and alpha channel straight from
 // file bytes: no decoding, no canvas, no image library.
@@ -584,6 +589,12 @@ const pdfBytes = await fs.promises.readFile("report.pdf");
 readPdfMetadata(new Uint8Array(pdfBytes));
 // { version: "1.7", pageCount: 12, title: "Q3 Report", author: "Jane Doe", ... }
 
+// Lists each page's MediaBox width/height (points and inches), rotation, and
+// orientation by walking the Root -> Pages -> Kids tree, inheriting from
+// ancestor nodes as the PDF spec requires. Also flags common paper sizes.
+readPdfPageDimensions(new Uint8Array(pdfBytes));
+// { version: "1.7", pageCount: 12, pages: [{ pageNumber: 1, widthPt: 612, heightPt: 792, rotation: 0, orientation: "portrait", paperSize: "Letter" }, ...] }
+
 // Reads sample rate, channels, bit depth, and duration from a WAV file's
 // RIFF/fmt/data chunk headers: no audio library required.
 const wavBytes = await fs.promises.readFile("recording.wav");
@@ -634,14 +645,14 @@ readVideoInfo(new Uint8Array(videoBytes));
 | `@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/ISBN validation, loan calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator |
-| `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing, User-Agent parsing |
+| `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing, User-Agent parsing, IPv6 address compress/expand |
 | `@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, MIME type lookup, GitHub URL parsing |
 | `@utilix-tech/sdk/color` | Hex/RGB/HSL/HSV/CMYK convert, palette generation, contrast check |
 | `@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, vector similarity |
-| `@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; FLAC metadata reading; MP4/WebM video info |
+| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; PDF page dimension/orientation listing; WAV audio info; ID3 tags; ICO favicon inspection; FLAC metadata reading; MP4/WebM video info |
 
 ---
 

package/dist/{chunk-Y5OOP6WN.js → chunk-CSNTHZHF.js}

@@ -27,6 +27,7 @@ __export(network_exports, {
   parseDnsResponse: () => parseDnsResponse,
   parseGeoResponse: () => parseGeoResponse,
   parseHar: () => parseHar,
+  parseIpv6Address: () => parseIpv6Address,
   parseUserAgent: () => parseUserAgent,
   searchHeaders: () => searchHeaders,
   searchStatusCodes: () => searchStatusCodes,
@@ -1814,5 +1815,93 @@ function buildCacheControl(options = {}) {
   const snippet = `Cache-Control: ${header}`;
   return { header, headerName: "Cache-Control", snippet, directives, warnings };
 }
+function isValidIpv6HexGroup(g) {
+  return /^[0-9a-fA-F]{1,4}$/.test(g);
+}
+function isValidIpv6Ipv4Quad(quad) {
+  const parts = quad.split(".");
+  if (parts.length !== 4) return false;
+  return parts.every((p) => /^\d{1,3}$/.test(p) && Number(p) <= 255);
+}
+function classifyIpv6(groups) {
+  const first = parseInt(groups[0], 16);
+  if (groups.every((g) => g === "0000")) return "unspecified";
+  if (groups.slice(0, 7).every((g) => g === "0000") && groups[7] === "0001") return "loopback";
+  if (groups.slice(0, 4).every((g) => g === "0000") && groups[4] === "0000" && groups[5] === "ffff") return "ipv4-mapped";
+  if (groups[0] === "2001" && groups[1] === "0db8") return "documentation";
+  if ((first & 65280) === 65280) return "multicast";
+  if ((first & 65472) === 65152) return "link-local";
+  if ((first & 65024) === 64512) return "unique-local";
+  return "global-unicast";
+}
+function compressIpv6Groups(groups) {
+  const short = groups.map((g) => g.replace(/^0+(?=.)/, ""));
+  let bestStart = -1;
+  let bestLen = 0;
+  let curStart = -1;
+  let curLen = 0;
+  for (let i = 0; i < short.length; i++) {
+    if (short[i] === "0") {
+      if (curStart === -1) curStart = i;
+      curLen++;
+      if (curLen > bestLen) {
+        bestLen = curLen;
+        bestStart = curStart;
+      }
+    } else {
+      curStart = -1;
+      curLen = 0;
+    }
+  }
+  if (bestLen < 2) return short.join(":");
+  const before = short.slice(0, bestStart).join(":");
+  const after = short.slice(bestStart + bestLen).join(":");
+  return `${before}::${after}`;
+}
+function parseIpv6Address(input) {
+  let s = input.trim();
+  if (s.startsWith("[") && s.includes("]")) s = s.slice(1, s.indexOf("]"));
+  let zoneId = null;
+  const pctIdx = s.indexOf("%");
+  if (pctIdx !== -1) {
+    zoneId = s.slice(pctIdx + 1);
+    s = s.slice(0, pctIdx);
+  }
+  if (!s) return { error: "Empty address" };
+  const doubleColonCount = (s.match(/::/g) ?? []).length;
+  if (doubleColonCount > 1) return { error: 'Address contains more than one "::"' };
+  const ipv4Match = s.match(/(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/);
+  if (ipv4Match) {
+    const quad = ipv4Match[1];
+    if (!isValidIpv6Ipv4Quad(quad)) return { error: `Invalid embedded IPv4 address: ${quad}` };
+    const parts = quad.split(".").map(Number);
+    const hi = (parts[0] << 8 | parts[1]).toString(16);
+    const lo = (parts[2] << 8 | parts[3]).toString(16);
+    s = s.slice(0, s.length - quad.length) + `${hi}:${lo}`;
+  }
+  let groups;
+  if (s.includes("::")) {
+    const [left, right] = s.split("::");
+    const leftGroups = left ? left.split(":") : [];
+    const rightGroups = right ? right.split(":") : [];
+    const missing = 8 - (leftGroups.length + rightGroups.length);
+    if (missing < 1) return { error: 'The "::" shorthand must represent at least one group of zeros' };
+    if (![...leftGroups, ...rightGroups].every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+    groups = [...leftGroups, ...Array(missing).fill("0"), ...rightGroups];
+  } else {
+    groups = s.split(":");
+    if (groups.length !== 8) return { error: `Expected 8 groups, got ${groups.length}` };
+    if (!groups.every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+  }
+  const expandedGroups = groups.map((g) => g.padStart(4, "0").toLowerCase());
+  const suffix = zoneId ? `%${zoneId}` : "";
+  return {
+    expanded: expandedGroups.join(":") + suffix,
+    compressed: compressIpv6Groups(expandedGroups) + suffix,
+    groups: expandedGroups,
+    zoneId,
+    addressType: classifyIpv6(expandedGroups)
+  };
+}
 
-export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseDnsResponse, parseGeoResponse, parseHar, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };
+export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };

package/dist/{chunk-47DTCCQJ.js → chunk-L6V4W4SU.js}

@@ -9,6 +9,7 @@ __export(media_exports, {
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
   readPdfMetadata: () => readPdfMetadata,
+  readPdfPageDimensions: () => readPdfPageDimensions,
   readVideoInfo: () => readVideoInfo,
   readWavInfo: () => readWavInfo
 });
@@ -468,6 +469,116 @@ function readPdfMetadata(bytes) {
     encrypted
   };
 }
+var PDF_COMMON_PAPER_SIZES = [
+  { name: "Letter", widthPt: 612, heightPt: 792 },
+  { name: "Legal", widthPt: 612, heightPt: 1008 },
+  { name: "Tabloid", widthPt: 792, heightPt: 1224 },
+  { name: "A3", widthPt: 842, heightPt: 1191 },
+  { name: "A4", widthPt: 595, heightPt: 842 },
+  { name: "A5", widthPt: 420, heightPt: 595 },
+  { name: "B5", widthPt: 499, heightPt: 709 }
+];
+function matchPaperSize(widthPt, heightPt) {
+  for (const size of PDF_COMMON_PAPER_SIZES) {
+    const w = Math.abs(widthPt - size.widthPt) <= 1;
+    const h = Math.abs(heightPt - size.heightPt) <= 1;
+    const wSwapped = Math.abs(widthPt - size.heightPt) <= 1;
+    const hSwapped = Math.abs(heightPt - size.widthPt) <= 1;
+    if (w && h || wSwapped && hSwapped) return size.name;
+  }
+  return null;
+}
+function parsePdfMediaBox(dict) {
+  const m = dict.match(/\/MediaBox\s*\[\s*(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s*\]/);
+  if (!m) return null;
+  return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
+}
+function parsePdfRotate(dict) {
+  const m = dict.match(/\/Rotate\s+(-?\d+)/);
+  return m ? Number(m[1]) : null;
+}
+function buildPdfPageDimension(pageNumber, mediaBox, rotate) {
+  const rotation = (rotate % 360 + 360) % 360;
+  if (!mediaBox) {
+    return { pageNumber, widthPt: null, heightPt: null, widthIn: null, heightIn: null, rotation, orientation: null, paperSize: null };
+  }
+  const [llx, lly, urx, ury] = mediaBox;
+  let widthPt = Math.abs(urx - llx);
+  let heightPt = Math.abs(ury - lly);
+  if (rotation === 90 || rotation === 270) [widthPt, heightPt] = [heightPt, widthPt];
+  const orientation = widthPt === heightPt ? "square" : widthPt > heightPt ? "landscape" : "portrait";
+  return {
+    pageNumber,
+    widthPt: round2(widthPt),
+    heightPt: round2(heightPt),
+    widthIn: round2(widthPt / 72),
+    heightIn: round2(heightPt / 72),
+    rotation,
+    orientation,
+    paperSize: matchPaperSize(widthPt, heightPt)
+  };
+}
+function walkPdfPageTree(objMap, nodeBody, inherited, visited, nodeKey, out) {
+  if (visited.has(nodeKey)) return;
+  visited.add(nodeKey);
+  const mediaBox = parsePdfMediaBox(nodeBody) ?? inherited.mediaBox;
+  const rotateMatch = parsePdfRotate(nodeBody);
+  const rotate = rotateMatch !== null ? rotateMatch : inherited.rotate;
+  if (/\/Type\s*\/Page(?!s)\b/.test(nodeBody)) {
+    out.push(buildPdfPageDimension(out.length + 1, mediaBox, rotate));
+    return;
+  }
+  const kidsMatch = nodeBody.match(/\/Kids\s*\[([^\]]*)\]/);
+  if (!kidsMatch) return;
+  const kidRefs = [...kidsMatch[1].matchAll(/(\d+)\s+(\d+)\s+R/g)];
+  for (const ref of kidRefs) {
+    const key = `${ref[1]} ${ref[2]}`;
+    const body = objMap.get(key);
+    if (body) walkPdfPageTree(objMap, body, { mediaBox, rotate }, visited, key, out);
+  }
+}
+function readPdfPageDimensions(bytes) {
+  if (bytes.length < 8) return { error: "File too small to be a PDF" };
+  const header = bytesToLatin1(bytes.subarray(0, 16));
+  const versionMatch = header.match(/%PDF-(\d\.\d)/);
+  if (!versionMatch) return { error: "Not a valid PDF file (missing %PDF header)" };
+  const version = versionMatch[1];
+  const text = bytesToLatin1(bytes);
+  const objBlocks = [...text.matchAll(/(\d+)\s+(\d+)\s+obj([\s\S]*?)endobj/g)];
+  const objMap = /* @__PURE__ */ new Map();
+  for (const b of objBlocks) objMap.set(`${b[1]} ${b[2]}`, b[3]);
+  const out = [];
+  const visited = /* @__PURE__ */ new Set();
+  let pagesRootBody = null;
+  const trailerMatches = [...text.matchAll(/trailer\s*<<([\s\S]*?)>>/g)];
+  if (trailerMatches.length > 0) {
+    const trailer = trailerMatches[trailerMatches.length - 1][1];
+    const rootRef = trailer.match(/\/Root\s+(\d+)\s+(\d+)\s+R/);
+    if (rootRef) {
+      const catalogBody = objMap.get(`${rootRef[1]} ${rootRef[2]}`);
+      const pagesRef = catalogBody?.match(/\/Pages\s+(\d+)\s+(\d+)\s+R/);
+      if (pagesRef) pagesRootBody = objMap.get(`${pagesRef[1]} ${pagesRef[2]}`) ?? null;
+    }
+  }
+  if (!pagesRootBody) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Pages\b/.test(b[3]) && !/\/Parent\s+\d+\s+\d+\s+R/.test(b[3])) {
+        pagesRootBody = b[3];
+        break;
+      }
+    }
+  }
+  if (pagesRootBody) walkPdfPageTree(objMap, pagesRootBody, { mediaBox: null, rotate: 0 }, visited, "root", out);
+  if (out.length === 0) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Page(?!s)\b/.test(b[3])) {
+        out.push(buildPdfPageDimension(out.length + 1, parsePdfMediaBox(b[3]), parsePdfRotate(b[3]) ?? 0));
+      }
+    }
+  }
+  if (out.length === 0) return { error: "Could not locate any page objects in this PDF" };
+  return { version, pageCount: out.length, pages: out };
+}
 var AUDIO_FORMAT_LABELS = {
   1: "PCM",
   3: "IEEE float",
@@ -1110,4 +1221,4 @@ function parseWebm(bytes) {
   return result;
 }
 
-export { media_exports, readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readVideoInfo, readWavInfo };
+export { media_exports, readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readPdfPageDimensions, readVideoInfo, readWavInfo };

package/dist/index.cjs

@@ -8833,6 +8833,7 @@ __export(network_exports, {
   parseDnsResponse: () => parseDnsResponse,
   parseGeoResponse: () => parseGeoResponse,
   parseHar: () => parseHar,
+  parseIpv6Address: () => parseIpv6Address,
   parseUserAgent: () => parseUserAgent,
   searchHeaders: () => searchHeaders,
   searchStatusCodes: () => searchStatusCodes,
@@ -10620,6 +10621,94 @@ function buildCacheControl(options = {}) {
   const snippet = `Cache-Control: ${header}`;
   return { header, headerName: "Cache-Control", snippet, directives, warnings };
 }
+function isValidIpv6HexGroup(g) {
+  return /^[0-9a-fA-F]{1,4}$/.test(g);
+}
+function isValidIpv6Ipv4Quad(quad) {
+  const parts = quad.split(".");
+  if (parts.length !== 4) return false;
+  return parts.every((p) => /^\d{1,3}$/.test(p) && Number(p) <= 255);
+}
+function classifyIpv6(groups) {
+  const first = parseInt(groups[0], 16);
+  if (groups.every((g) => g === "0000")) return "unspecified";
+  if (groups.slice(0, 7).every((g) => g === "0000") && groups[7] === "0001") return "loopback";
+  if (groups.slice(0, 4).every((g) => g === "0000") && groups[4] === "0000" && groups[5] === "ffff") return "ipv4-mapped";
+  if (groups[0] === "2001" && groups[1] === "0db8") return "documentation";
+  if ((first & 65280) === 65280) return "multicast";
+  if ((first & 65472) === 65152) return "link-local";
+  if ((first & 65024) === 64512) return "unique-local";
+  return "global-unicast";
+}
+function compressIpv6Groups(groups) {
+  const short = groups.map((g) => g.replace(/^0+(?=.)/, ""));
+  let bestStart = -1;
+  let bestLen = 0;
+  let curStart = -1;
+  let curLen = 0;
+  for (let i = 0; i < short.length; i++) {
+    if (short[i] === "0") {
+      if (curStart === -1) curStart = i;
+      curLen++;
+      if (curLen > bestLen) {
+        bestLen = curLen;
+        bestStart = curStart;
+      }
+    } else {
+      curStart = -1;
+      curLen = 0;
+    }
+  }
+  if (bestLen < 2) return short.join(":");
+  const before = short.slice(0, bestStart).join(":");
+  const after = short.slice(bestStart + bestLen).join(":");
+  return `${before}::${after}`;
+}
+function parseIpv6Address(input) {
+  let s = input.trim();
+  if (s.startsWith("[") && s.includes("]")) s = s.slice(1, s.indexOf("]"));
+  let zoneId = null;
+  const pctIdx = s.indexOf("%");
+  if (pctIdx !== -1) {
+    zoneId = s.slice(pctIdx + 1);
+    s = s.slice(0, pctIdx);
+  }
+  if (!s) return { error: "Empty address" };
+  const doubleColonCount = (s.match(/::/g) ?? []).length;
+  if (doubleColonCount > 1) return { error: 'Address contains more than one "::"' };
+  const ipv4Match = s.match(/(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/);
+  if (ipv4Match) {
+    const quad = ipv4Match[1];
+    if (!isValidIpv6Ipv4Quad(quad)) return { error: `Invalid embedded IPv4 address: ${quad}` };
+    const parts = quad.split(".").map(Number);
+    const hi = (parts[0] << 8 | parts[1]).toString(16);
+    const lo = (parts[2] << 8 | parts[3]).toString(16);
+    s = s.slice(0, s.length - quad.length) + `${hi}:${lo}`;
+  }
+  let groups;
+  if (s.includes("::")) {
+    const [left, right] = s.split("::");
+    const leftGroups = left ? left.split(":") : [];
+    const rightGroups = right ? right.split(":") : [];
+    const missing = 8 - (leftGroups.length + rightGroups.length);
+    if (missing < 1) return { error: 'The "::" shorthand must represent at least one group of zeros' };
+    if (![...leftGroups, ...rightGroups].every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+    groups = [...leftGroups, ...Array(missing).fill("0"), ...rightGroups];
+  } else {
+    groups = s.split(":");
+    if (groups.length !== 8) return { error: `Expected 8 groups, got ${groups.length}` };
+    if (!groups.every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+  }
+  const expandedGroups = groups.map((g) => g.padStart(4, "0").toLowerCase());
+  const suffix = zoneId ? `%${zoneId}` : "";
+  return {
+    expanded: expandedGroups.join(":") + suffix,
+    compressed: compressIpv6Groups(expandedGroups) + suffix,
+    groups: expandedGroups,
+    zoneId,
+    addressType: classifyIpv6(expandedGroups)
+  };
+}
 
 // src/tools/api.ts
 var api_exports = {};
@@ -19237,6 +19326,7 @@ __export(media_exports, {
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
   readPdfMetadata: () => readPdfMetadata,
+  readPdfPageDimensions: () => readPdfPageDimensions,
   readVideoInfo: () => readVideoInfo,
   readWavInfo: () => readWavInfo
 });
@@ -19696,6 +19786,116 @@ function readPdfMetadata(bytes) {
     encrypted
   };
 }
+var PDF_COMMON_PAPER_SIZES = [
+  { name: "Letter", widthPt: 612, heightPt: 792 },
+  { name: "Legal", widthPt: 612, heightPt: 1008 },
+  { name: "Tabloid", widthPt: 792, heightPt: 1224 },
+  { name: "A3", widthPt: 842, heightPt: 1191 },
+  { name: "A4", widthPt: 595, heightPt: 842 },
+  { name: "A5", widthPt: 420, heightPt: 595 },
+  { name: "B5", widthPt: 499, heightPt: 709 }
+];
+function matchPaperSize(widthPt, heightPt) {
+  for (const size of PDF_COMMON_PAPER_SIZES) {
+    const w = Math.abs(widthPt - size.widthPt) <= 1;
+    const h = Math.abs(heightPt - size.heightPt) <= 1;
+    const wSwapped = Math.abs(widthPt - size.heightPt) <= 1;
+    const hSwapped = Math.abs(heightPt - size.widthPt) <= 1;
+    if (w && h || wSwapped && hSwapped) return size.name;
+  }
+  return null;
+}
+function parsePdfMediaBox(dict) {
+  const m = dict.match(/\/MediaBox\s*\[\s*(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s*\]/);
+  if (!m) return null;
+  return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
+}
+function parsePdfRotate(dict) {
+  const m = dict.match(/\/Rotate\s+(-?\d+)/);
+  return m ? Number(m[1]) : null;
+}
+function buildPdfPageDimension(pageNumber, mediaBox, rotate) {
+  const rotation = (rotate % 360 + 360) % 360;
+  if (!mediaBox) {
+    return { pageNumber, widthPt: null, heightPt: null, widthIn: null, heightIn: null, rotation, orientation: null, paperSize: null };
+  }
+  const [llx, lly, urx, ury] = mediaBox;
+  let widthPt = Math.abs(urx - llx);
+  let heightPt = Math.abs(ury - lly);
+  if (rotation === 90 || rotation === 270) [widthPt, heightPt] = [heightPt, widthPt];
+  const orientation = widthPt === heightPt ? "square" : widthPt > heightPt ? "landscape" : "portrait";
+  return {
+    pageNumber,
+    widthPt: round22(widthPt),
+    heightPt: round22(heightPt),
+    widthIn: round22(widthPt / 72),
+    heightIn: round22(heightPt / 72),
+    rotation,
+    orientation,
+    paperSize: matchPaperSize(widthPt, heightPt)
+  };
+}
+function walkPdfPageTree(objMap, nodeBody, inherited, visited, nodeKey, out) {
+  if (visited.has(nodeKey)) return;
+  visited.add(nodeKey);
+  const mediaBox = parsePdfMediaBox(nodeBody) ?? inherited.mediaBox;
+  const rotateMatch = parsePdfRotate(nodeBody);
+  const rotate = rotateMatch !== null ? rotateMatch : inherited.rotate;
+  if (/\/Type\s*\/Page(?!s)\b/.test(nodeBody)) {
+    out.push(buildPdfPageDimension(out.length + 1, mediaBox, rotate));
+    return;
+  }
+  const kidsMatch = nodeBody.match(/\/Kids\s*\[([^\]]*)\]/);
+  if (!kidsMatch) return;
+  const kidRefs = [...kidsMatch[1].matchAll(/(\d+)\s+(\d+)\s+R/g)];
+  for (const ref of kidRefs) {
+    const key = `${ref[1]} ${ref[2]}`;
+    const body = objMap.get(key);
+    if (body) walkPdfPageTree(objMap, body, { mediaBox, rotate }, visited, key, out);
+  }
+}
+function readPdfPageDimensions(bytes) {
+  if (bytes.length < 8) return { error: "File too small to be a PDF" };
+  const header = bytesToLatin1(bytes.subarray(0, 16));
+  const versionMatch = header.match(/%PDF-(\d\.\d)/);
+  if (!versionMatch) return { error: "Not a valid PDF file (missing %PDF header)" };
+  const version2 = versionMatch[1];
+  const text = bytesToLatin1(bytes);
+  const objBlocks = [...text.matchAll(/(\d+)\s+(\d+)\s+obj([\s\S]*?)endobj/g)];
+  const objMap = /* @__PURE__ */ new Map();
+  for (const b of objBlocks) objMap.set(`${b[1]} ${b[2]}`, b[3]);
+  const out = [];
+  const visited = /* @__PURE__ */ new Set();
+  let pagesRootBody = null;
+  const trailerMatches = [...text.matchAll(/trailer\s*<<([\s\S]*?)>>/g)];
+  if (trailerMatches.length > 0) {
+    const trailer = trailerMatches[trailerMatches.length - 1][1];
+    const rootRef = trailer.match(/\/Root\s+(\d+)\s+(\d+)\s+R/);
+    if (rootRef) {
+      const catalogBody = objMap.get(`${rootRef[1]} ${rootRef[2]}`);
+      const pagesRef = catalogBody?.match(/\/Pages\s+(\d+)\s+(\d+)\s+R/);
+      if (pagesRef) pagesRootBody = objMap.get(`${pagesRef[1]} ${pagesRef[2]}`) ?? null;
+    }
+  }
+  if (!pagesRootBody) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Pages\b/.test(b[3]) && !/\/Parent\s+\d+\s+\d+\s+R/.test(b[3])) {
+        pagesRootBody = b[3];
+        break;
+      }
+    }
+  }
+  if (pagesRootBody) walkPdfPageTree(objMap, pagesRootBody, { mediaBox: null, rotate: 0 }, visited, "root", out);
+  if (out.length === 0) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Page(?!s)\b/.test(b[3])) {
+        out.push(buildPdfPageDimension(out.length + 1, parsePdfMediaBox(b[3]), parsePdfRotate(b[3]) ?? 0));
+      }
+    }
+  }
+  if (out.length === 0) return { error: "Could not locate any page objects in this PDF" };
+  return { version: version2, pageCount: out.length, pages: out };
+}
 var AUDIO_FORMAT_LABELS = {
   1: "PCM",
   3: "IEEE float",

package/dist/index.d.cts

@@ -6,14 +6,14 @@ export { d as data } from './data-XRb0D7Zn.cjs';
 export { g as generators } from './generators-BGtRGpJZ.cjs';
 export { t as time } from './time-KqJjdqII.cjs';
 export { u as units } from './units-COt5uI20.cjs';
-export { n as network } from './network-BJOjJnmY.cjs';
+export { n as network } from './network-D7Epuerc.cjs';
 export { a as api } from './api-DmTNE4c1.cjs';
 export { c as code } from './code-DaRvff2v.cjs';
 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-B-c59NXD.cjs';
-export { m as media } from './media-cuxfzXxw.cjs';
+export { m as media } from './media-fD8dJ5qR.cjs';
 
 declare const version = "0.1.0";
 

package/dist/index.d.ts

@@ -6,14 +6,14 @@ export { d as data } from './data-XRb0D7Zn.js';
 export { g as generators } from './generators-BGtRGpJZ.js';
 export { t as time } from './time-KqJjdqII.js';
 export { u as units } from './units-COt5uI20.js';
-export { n as network } from './network-BJOjJnmY.js';
+export { n as network } from './network-D7Epuerc.js';
 export { a as api } from './api-DmTNE4c1.js';
 export { c as code } from './code-DaRvff2v.js';
 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-B-c59NXD.js';
-export { m as media } from './media-cuxfzXxw.js';
+export { m as media } from './media-fD8dJ5qR.js';
 
 declare const version = "0.1.0";
 

package/dist/index.js

@@ -1,6 +1,6 @@
-export { media_exports as media } from './chunk-47DTCCQJ.js';
+export { media_exports as media } from './chunk-L6V4W4SU.js';
 export { units_exports as units } from './chunk-I63BCOAG.js';
-export { network_exports as network } from './chunk-Y5OOP6WN.js';
+export { network_exports as network } from './chunk-CSNTHZHF.js';
 export { api_exports as api } from './chunk-52ZDKSIX.js';
 export { code_exports as code } from './chunk-LXKIPPDG.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';

package/dist/{media-cuxfzXxw.d.cts → media-fD8dJ5qR.d.cts}

@@ -64,6 +64,29 @@ interface PdfMetadataError {
  * pdf.js or other PDF rendering library required.
  */
 declare function readPdfMetadata(bytes: Uint8Array): PdfMetadata | PdfMetadataError;
+type PdfPageOrientation = 'portrait' | 'landscape' | 'square' | null;
+interface PdfPageDimension {
+    pageNumber: number;
+    widthPt: number | null;
+    heightPt: number | null;
+    widthIn: number | null;
+    heightIn: number | null;
+    rotation: number;
+    orientation: PdfPageOrientation;
+    paperSize: string | null;
+}
+interface PdfPageDimensionsResult {
+    version: string | null;
+    pageCount: number;
+    pages: PdfPageDimension[];
+}
+/**
+ * List each page's MediaBox width/height (in points and inches), rotation,
+ * and orientation, in document order — walking the Root -> Pages -> Kids
+ * tree and inheriting /MediaBox / /Rotate from ancestor nodes the way the
+ * PDF spec requires. No PDF rendering library required.
+ */
+declare function readPdfPageDimensions(bytes: Uint8Array): PdfPageDimensionsResult | PdfMetadataError;
 interface WavInfo {
     audioFormat: number;
     audioFormatLabel: string;
@@ -194,6 +217,9 @@ type media_ImageInfo = ImageInfo;
 type media_ImageInfoError = ImageInfoError;
 type media_PdfMetadata = PdfMetadata;
 type media_PdfMetadataError = PdfMetadataError;
+type media_PdfPageDimension = PdfPageDimension;
+type media_PdfPageDimensionsResult = PdfPageDimensionsResult;
+type media_PdfPageOrientation = PdfPageOrientation;
 type media_VideoInfo = VideoInfo;
 type media_VideoInfoError = VideoInfoError;
 type media_WavInfo = WavInfo;
@@ -204,10 +230,11 @@ 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_readPdfPageDimensions: typeof readPdfPageDimensions;
 declare const media_readVideoInfo: typeof readVideoInfo;
 declare const media_readWavInfo: typeof readWavInfo;
 declare namespace media {
-  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_FlacInfo as FlacInfo, type media_FlacInfoError as FlacInfoError, 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_VideoInfo as VideoInfo, type media_VideoInfoError as VideoInfoError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readVideoInfo as readVideoInfo, media_readWavInfo as readWavInfo };
+  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_FlacInfo as FlacInfo, type media_FlacInfoError as FlacInfoError, 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_PdfPageDimension as PdfPageDimension, type media_PdfPageDimensionsResult as PdfPageDimensionsResult, type media_PdfPageOrientation as PdfPageOrientation, type media_VideoInfo as VideoInfo, type media_VideoInfoError as VideoInfoError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readPdfPageDimensions as readPdfPageDimensions, media_readVideoInfo as readVideoInfo, media_readWavInfo as readWavInfo };
 }
 
-export { type ExifData as E, type FlacInfo as F, type IcoImageEntry as I, type PdfMetadata as P, type VideoInfo as V, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type IcoInfo as c, type IcoInfoError as d, type Id3Tags as e, type Id3TagsError as f, type ImageFormat as g, type ImageInfo as h, type ImageInfoError as i, type PdfMetadataError as j, type VideoInfoError as k, type WavInfoError as l, media as m, readFlacInfo as n, readIcoInfo as o, readId3Tags as p, readImageInfo as q, readExifData as r, readPdfMetadata as s, readVideoInfo as t, readWavInfo as u };
+export { type ExifData as E, type FlacInfo as F, type IcoImageEntry as I, type PdfMetadata as P, type VideoInfo as V, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type IcoInfo as c, type IcoInfoError as d, type Id3Tags as e, type Id3TagsError as f, type ImageFormat as g, type ImageInfo as h, type ImageInfoError as i, type PdfMetadataError as j, type PdfPageDimension as k, type PdfPageDimensionsResult as l, media as m, type PdfPageOrientation as n, type VideoInfoError as o, type WavInfoError as p, readFlacInfo as q, readExifData as r, readIcoInfo as s, readId3Tags as t, readImageInfo as u, readPdfMetadata as v, readPdfPageDimensions as w, readVideoInfo as x, readWavInfo as y };

package/dist/{media-cuxfzXxw.d.ts → media-fD8dJ5qR.d.ts}

@@ -64,6 +64,29 @@ interface PdfMetadataError {
  * pdf.js or other PDF rendering library required.
  */
 declare function readPdfMetadata(bytes: Uint8Array): PdfMetadata | PdfMetadataError;
+type PdfPageOrientation = 'portrait' | 'landscape' | 'square' | null;
+interface PdfPageDimension {
+    pageNumber: number;
+    widthPt: number | null;
+    heightPt: number | null;
+    widthIn: number | null;
+    heightIn: number | null;
+    rotation: number;
+    orientation: PdfPageOrientation;
+    paperSize: string | null;
+}
+interface PdfPageDimensionsResult {
+    version: string | null;
+    pageCount: number;
+    pages: PdfPageDimension[];
+}
+/**
+ * List each page's MediaBox width/height (in points and inches), rotation,
+ * and orientation, in document order — walking the Root -> Pages -> Kids
+ * tree and inheriting /MediaBox / /Rotate from ancestor nodes the way the
+ * PDF spec requires. No PDF rendering library required.
+ */
+declare function readPdfPageDimensions(bytes: Uint8Array): PdfPageDimensionsResult | PdfMetadataError;
 interface WavInfo {
     audioFormat: number;
     audioFormatLabel: string;
@@ -194,6 +217,9 @@ type media_ImageInfo = ImageInfo;
 type media_ImageInfoError = ImageInfoError;
 type media_PdfMetadata = PdfMetadata;
 type media_PdfMetadataError = PdfMetadataError;
+type media_PdfPageDimension = PdfPageDimension;
+type media_PdfPageDimensionsResult = PdfPageDimensionsResult;
+type media_PdfPageOrientation = PdfPageOrientation;
 type media_VideoInfo = VideoInfo;
 type media_VideoInfoError = VideoInfoError;
 type media_WavInfo = WavInfo;
@@ -204,10 +230,11 @@ 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_readPdfPageDimensions: typeof readPdfPageDimensions;
 declare const media_readVideoInfo: typeof readVideoInfo;
 declare const media_readWavInfo: typeof readWavInfo;
 declare namespace media {
-  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_FlacInfo as FlacInfo, type media_FlacInfoError as FlacInfoError, 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_VideoInfo as VideoInfo, type media_VideoInfoError as VideoInfoError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readVideoInfo as readVideoInfo, media_readWavInfo as readWavInfo };
+  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_FlacInfo as FlacInfo, type media_FlacInfoError as FlacInfoError, 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_PdfPageDimension as PdfPageDimension, type media_PdfPageDimensionsResult as PdfPageDimensionsResult, type media_PdfPageOrientation as PdfPageOrientation, type media_VideoInfo as VideoInfo, type media_VideoInfoError as VideoInfoError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readPdfPageDimensions as readPdfPageDimensions, media_readVideoInfo as readVideoInfo, media_readWavInfo as readWavInfo };
 }
 
-export { type ExifData as E, type FlacInfo as F, type IcoImageEntry as I, type PdfMetadata as P, type VideoInfo as V, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type IcoInfo as c, type IcoInfoError as d, type Id3Tags as e, type Id3TagsError as f, type ImageFormat as g, type ImageInfo as h, type ImageInfoError as i, type PdfMetadataError as j, type VideoInfoError as k, type WavInfoError as l, media as m, readFlacInfo as n, readIcoInfo as o, readId3Tags as p, readImageInfo as q, readExifData as r, readPdfMetadata as s, readVideoInfo as t, readWavInfo as u };
+export { type ExifData as E, type FlacInfo as F, type IcoImageEntry as I, type PdfMetadata as P, type VideoInfo as V, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type IcoInfo as c, type IcoInfoError as d, type Id3Tags as e, type Id3TagsError as f, type ImageFormat as g, type ImageInfo as h, type ImageInfoError as i, type PdfMetadataError as j, type PdfPageDimension as k, type PdfPageDimensionsResult as l, media as m, type PdfPageOrientation as n, type VideoInfoError as o, type WavInfoError as p, readFlacInfo as q, readExifData as r, readIcoInfo as s, readId3Tags as t, readImageInfo as u, readPdfMetadata as v, readPdfPageDimensions as w, readVideoInfo as x, readWavInfo as y };

package/dist/{network-BJOjJnmY.d.cts → network-D7Epuerc.d.cts}

@@ -12,6 +12,7 @@
  *   - robots-txt-validator: validateRobotsTxt
  *   - user-agent-parser: parseUserAgent
  *   - cache-control-builder: buildCacheControl
+ *   - ipv6-compressor: parseIpv6Address
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -291,6 +292,23 @@ interface CacheControlResult {
 declare function buildCacheControl(options?: CacheControlOptions): CacheControlResult | {
     error: string;
 };
+type Ipv6AddressType = 'unspecified' | 'loopback' | 'link-local' | 'unique-local' | 'multicast' | 'ipv4-mapped' | 'documentation' | 'global-unicast';
+interface Ipv6ParseResult {
+    expanded: string;
+    compressed: string;
+    groups: string[];
+    zoneId: string | null;
+    addressType: Ipv6AddressType;
+}
+/**
+ * Parse an IPv6 address into its expanded (full 8-group) and compressed
+ * (RFC 5952 canonical shortest) forms, classify its address type, and
+ * separate out an optional zone ID. Understands "::" shorthand and an
+ * embedded IPv4 suffix like "::ffff:192.168.1.1".
+ */
+declare function parseIpv6Address(input: string): Ipv6ParseResult | {
+    error: string;
+};
 
 type network_CacheControlDirective = CacheControlDirective;
 type network_CacheControlOptions = CacheControlOptions;
@@ -306,6 +324,8 @@ type network_HarParseResult = HarParseResult;
 type network_HarSummary = HarSummary;
 type network_HeaderCategory = HeaderCategory;
 type network_HttpHeader = HttpHeader;
+type network_Ipv6AddressType = Ipv6AddressType;
+type network_Ipv6ParseResult = Ipv6ParseResult;
 type network_ParsedDnsResult = ParsedDnsResult;
 type network_ParsedGeoResult = ParsedGeoResult;
 type network_RobotsGroup = RobotsGroup;
@@ -341,6 +361,7 @@ declare const network_isValidIpv6: typeof isValidIpv6;
 declare const network_parseDnsResponse: typeof parseDnsResponse;
 declare const network_parseGeoResponse: typeof parseGeoResponse;
 declare const network_parseHar: typeof parseHar;
+declare const network_parseIpv6Address: typeof parseIpv6Address;
 declare const network_parseUserAgent: typeof parseUserAgent;
 declare const network_searchHeaders: typeof searchHeaders;
 declare const network_searchStatusCodes: typeof searchStatusCodes;
@@ -352,7 +373,7 @@ declare const network_validateHeaderValue: typeof validateHeaderValue;
 declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  export { type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_Ipv6AddressType as Ipv6AddressType, type network_Ipv6ParseResult as Ipv6ParseResult, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseIpv6Address as parseIpv6Address, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { statusCodeToText as $, formatCoordinates as A, formatTtl as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, getByCategory as E, getHeader as F, type GeoResult as G, HTTP_HEADERS as H, getHeadersByCategory as I, getStatusByCategory as J, getStatusCode as K, isClientError as L, isServerError as M, isSuccess as N, isValidIp as O, type ParsedDnsResult as P, isValidIpv4 as Q, type RobotsGroup as R, STATUS_CODES as S, isValidIpv6 as T, type UaDeviceType as U, parseDnsResponse as V, parseGeoResponse as W, parseHar as X, parseUserAgent as Y, searchHeaders as Z, searchStatusCodes as _, type CacheControlOptions as a, typeNumberToLabel as a0, validateDomain as a1, validateHeaderName as a2, validateHeaderValue as a3, validateRobotsTxt as a4, validateSitemap as a5, type CacheControlResult as b, type DnsRecord as c, type DnsRecordType as d, type DnsResponse as e, type HarEntry as f, type HarParseResult as g, type HarSummary as h, type HeaderCategory as i, type HttpHeader as j, type ParsedGeoResult as k, type RobotsIssue as l, type RobotsRule as m, network as n, type RobotsValidationResult as o, type SitemapIndexEntry as p, type SitemapIssue as q, type SitemapUrlEntry as r, type SitemapValidationResult as s, type StatusCode as t, type UserAgentInfo as u, buildCacheControl as v, buildDnsQueryUrl as w, buildGeoUrl as x, buildMapUrl as y, countryCodeToFlag as z };
+export { parseUserAgent as $, countryCodeToFlag as A, formatCoordinates as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, formatTtl as E, getByCategory as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, getHeader as J, getHeadersByCategory as K, getStatusByCategory as L, getStatusCode as M, isClientError as N, isServerError as O, type ParsedDnsResult as P, isSuccess as Q, type RobotsGroup as R, STATUS_CODES as S, isValidIp as T, type UaDeviceType as U, isValidIpv4 as V, isValidIpv6 as W, parseDnsResponse as X, parseGeoResponse as Y, parseHar as Z, parseIpv6Address as _, type CacheControlOptions as a, searchHeaders as a0, searchStatusCodes as a1, statusCodeToText as a2, typeNumberToLabel as a3, validateDomain as a4, validateHeaderName as a5, validateHeaderValue as a6, validateRobotsTxt as a7, validateSitemap as a8, type CacheControlResult as b, type DnsRecord as c, type DnsRecordType as d, type DnsResponse as e, type HarEntry as f, type HarParseResult as g, type HarSummary as h, type HeaderCategory as i, type HttpHeader as j, type Ipv6ParseResult as k, type ParsedGeoResult as l, type RobotsIssue as m, network as n, type RobotsRule as o, type RobotsValidationResult as p, type SitemapIndexEntry as q, type SitemapIssue as r, type SitemapUrlEntry as s, type SitemapValidationResult as t, type StatusCode as u, type UserAgentInfo as v, buildCacheControl as w, buildDnsQueryUrl as x, buildGeoUrl as y, buildMapUrl as z };

package/dist/{network-BJOjJnmY.d.ts → network-D7Epuerc.d.ts}

@@ -12,6 +12,7 @@
  *   - robots-txt-validator: validateRobotsTxt
  *   - user-agent-parser: parseUserAgent
  *   - cache-control-builder: buildCacheControl
+ *   - ipv6-compressor: parseIpv6Address
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -291,6 +292,23 @@ interface CacheControlResult {
 declare function buildCacheControl(options?: CacheControlOptions): CacheControlResult | {
     error: string;
 };
+type Ipv6AddressType = 'unspecified' | 'loopback' | 'link-local' | 'unique-local' | 'multicast' | 'ipv4-mapped' | 'documentation' | 'global-unicast';
+interface Ipv6ParseResult {
+    expanded: string;
+    compressed: string;
+    groups: string[];
+    zoneId: string | null;
+    addressType: Ipv6AddressType;
+}
+/**
+ * Parse an IPv6 address into its expanded (full 8-group) and compressed
+ * (RFC 5952 canonical shortest) forms, classify its address type, and
+ * separate out an optional zone ID. Understands "::" shorthand and an
+ * embedded IPv4 suffix like "::ffff:192.168.1.1".
+ */
+declare function parseIpv6Address(input: string): Ipv6ParseResult | {
+    error: string;
+};
 
 type network_CacheControlDirective = CacheControlDirective;
 type network_CacheControlOptions = CacheControlOptions;
@@ -306,6 +324,8 @@ type network_HarParseResult = HarParseResult;
 type network_HarSummary = HarSummary;
 type network_HeaderCategory = HeaderCategory;
 type network_HttpHeader = HttpHeader;
+type network_Ipv6AddressType = Ipv6AddressType;
+type network_Ipv6ParseResult = Ipv6ParseResult;
 type network_ParsedDnsResult = ParsedDnsResult;
 type network_ParsedGeoResult = ParsedGeoResult;
 type network_RobotsGroup = RobotsGroup;
@@ -341,6 +361,7 @@ declare const network_isValidIpv6: typeof isValidIpv6;
 declare const network_parseDnsResponse: typeof parseDnsResponse;
 declare const network_parseGeoResponse: typeof parseGeoResponse;
 declare const network_parseHar: typeof parseHar;
+declare const network_parseIpv6Address: typeof parseIpv6Address;
 declare const network_parseUserAgent: typeof parseUserAgent;
 declare const network_searchHeaders: typeof searchHeaders;
 declare const network_searchStatusCodes: typeof searchStatusCodes;
@@ -352,7 +373,7 @@ declare const network_validateHeaderValue: typeof validateHeaderValue;
 declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  export { type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_Ipv6AddressType as Ipv6AddressType, type network_Ipv6ParseResult as Ipv6ParseResult, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseIpv6Address as parseIpv6Address, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { statusCodeToText as $, formatCoordinates as A, formatTtl as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, getByCategory as E, getHeader as F, type GeoResult as G, HTTP_HEADERS as H, getHeadersByCategory as I, getStatusByCategory as J, getStatusCode as K, isClientError as L, isServerError as M, isSuccess as N, isValidIp as O, type ParsedDnsResult as P, isValidIpv4 as Q, type RobotsGroup as R, STATUS_CODES as S, isValidIpv6 as T, type UaDeviceType as U, parseDnsResponse as V, parseGeoResponse as W, parseHar as X, parseUserAgent as Y, searchHeaders as Z, searchStatusCodes as _, type CacheControlOptions as a, typeNumberToLabel as a0, validateDomain as a1, validateHeaderName as a2, validateHeaderValue as a3, validateRobotsTxt as a4, validateSitemap as a5, type CacheControlResult as b, type DnsRecord as c, type DnsRecordType as d, type DnsResponse as e, type HarEntry as f, type HarParseResult as g, type HarSummary as h, type HeaderCategory as i, type HttpHeader as j, type ParsedGeoResult as k, type RobotsIssue as l, type RobotsRule as m, network as n, type RobotsValidationResult as o, type SitemapIndexEntry as p, type SitemapIssue as q, type SitemapUrlEntry as r, type SitemapValidationResult as s, type StatusCode as t, type UserAgentInfo as u, buildCacheControl as v, buildDnsQueryUrl as w, buildGeoUrl as x, buildMapUrl as y, countryCodeToFlag as z };
+export { parseUserAgent as $, countryCodeToFlag as A, formatCoordinates as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, formatTtl as E, getByCategory as F, type GeoResult as G, HTTP_HEADERS as H, type Ipv6AddressType as I, getHeader as J, getHeadersByCategory as K, getStatusByCategory as L, getStatusCode as M, isClientError as N, isServerError as O, type ParsedDnsResult as P, isSuccess as Q, type RobotsGroup as R, STATUS_CODES as S, isValidIp as T, type UaDeviceType as U, isValidIpv4 as V, isValidIpv6 as W, parseDnsResponse as X, parseGeoResponse as Y, parseHar as Z, parseIpv6Address as _, type CacheControlOptions as a, searchHeaders as a0, searchStatusCodes as a1, statusCodeToText as a2, typeNumberToLabel as a3, validateDomain as a4, validateHeaderName as a5, validateHeaderValue as a6, validateRobotsTxt as a7, validateSitemap as a8, type CacheControlResult as b, type DnsRecord as c, type DnsRecordType as d, type DnsResponse as e, type HarEntry as f, type HarParseResult as g, type HarSummary as h, type HeaderCategory as i, type HttpHeader as j, type Ipv6ParseResult as k, type ParsedGeoResult as l, type RobotsIssue as m, network as n, type RobotsRule as o, type RobotsValidationResult as p, type SitemapIndexEntry as q, type SitemapIssue as r, type SitemapUrlEntry as s, type SitemapValidationResult as t, type StatusCode as u, type UserAgentInfo as v, buildCacheControl as w, buildDnsQueryUrl as x, buildGeoUrl as y, buildMapUrl as z };

package/dist/tools/media.cjs

@@ -457,6 +457,116 @@ function readPdfMetadata(bytes) {
     encrypted
   };
 }
+var PDF_COMMON_PAPER_SIZES = [
+  { name: "Letter", widthPt: 612, heightPt: 792 },
+  { name: "Legal", widthPt: 612, heightPt: 1008 },
+  { name: "Tabloid", widthPt: 792, heightPt: 1224 },
+  { name: "A3", widthPt: 842, heightPt: 1191 },
+  { name: "A4", widthPt: 595, heightPt: 842 },
+  { name: "A5", widthPt: 420, heightPt: 595 },
+  { name: "B5", widthPt: 499, heightPt: 709 }
+];
+function matchPaperSize(widthPt, heightPt) {
+  for (const size of PDF_COMMON_PAPER_SIZES) {
+    const w = Math.abs(widthPt - size.widthPt) <= 1;
+    const h = Math.abs(heightPt - size.heightPt) <= 1;
+    const wSwapped = Math.abs(widthPt - size.heightPt) <= 1;
+    const hSwapped = Math.abs(heightPt - size.widthPt) <= 1;
+    if (w && h || wSwapped && hSwapped) return size.name;
+  }
+  return null;
+}
+function parsePdfMediaBox(dict) {
+  const m = dict.match(/\/MediaBox\s*\[\s*(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s*\]/);
+  if (!m) return null;
+  return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
+}
+function parsePdfRotate(dict) {
+  const m = dict.match(/\/Rotate\s+(-?\d+)/);
+  return m ? Number(m[1]) : null;
+}
+function buildPdfPageDimension(pageNumber, mediaBox, rotate) {
+  const rotation = (rotate % 360 + 360) % 360;
+  if (!mediaBox) {
+    return { pageNumber, widthPt: null, heightPt: null, widthIn: null, heightIn: null, rotation, orientation: null, paperSize: null };
+  }
+  const [llx, lly, urx, ury] = mediaBox;
+  let widthPt = Math.abs(urx - llx);
+  let heightPt = Math.abs(ury - lly);
+  if (rotation === 90 || rotation === 270) [widthPt, heightPt] = [heightPt, widthPt];
+  const orientation = widthPt === heightPt ? "square" : widthPt > heightPt ? "landscape" : "portrait";
+  return {
+    pageNumber,
+    widthPt: round2(widthPt),
+    heightPt: round2(heightPt),
+    widthIn: round2(widthPt / 72),
+    heightIn: round2(heightPt / 72),
+    rotation,
+    orientation,
+    paperSize: matchPaperSize(widthPt, heightPt)
+  };
+}
+function walkPdfPageTree(objMap, nodeBody, inherited, visited, nodeKey, out) {
+  if (visited.has(nodeKey)) return;
+  visited.add(nodeKey);
+  const mediaBox = parsePdfMediaBox(nodeBody) ?? inherited.mediaBox;
+  const rotateMatch = parsePdfRotate(nodeBody);
+  const rotate = rotateMatch !== null ? rotateMatch : inherited.rotate;
+  if (/\/Type\s*\/Page(?!s)\b/.test(nodeBody)) {
+    out.push(buildPdfPageDimension(out.length + 1, mediaBox, rotate));
+    return;
+  }
+  const kidsMatch = nodeBody.match(/\/Kids\s*\[([^\]]*)\]/);
+  if (!kidsMatch) return;
+  const kidRefs = [...kidsMatch[1].matchAll(/(\d+)\s+(\d+)\s+R/g)];
+  for (const ref of kidRefs) {
+    const key = `${ref[1]} ${ref[2]}`;
+    const body = objMap.get(key);
+    if (body) walkPdfPageTree(objMap, body, { mediaBox, rotate }, visited, key, out);
+  }
+}
+function readPdfPageDimensions(bytes) {
+  if (bytes.length < 8) return { error: "File too small to be a PDF" };
+  const header = bytesToLatin1(bytes.subarray(0, 16));
+  const versionMatch = header.match(/%PDF-(\d\.\d)/);
+  if (!versionMatch) return { error: "Not a valid PDF file (missing %PDF header)" };
+  const version = versionMatch[1];
+  const text = bytesToLatin1(bytes);
+  const objBlocks = [...text.matchAll(/(\d+)\s+(\d+)\s+obj([\s\S]*?)endobj/g)];
+  const objMap = /* @__PURE__ */ new Map();
+  for (const b of objBlocks) objMap.set(`${b[1]} ${b[2]}`, b[3]);
+  const out = [];
+  const visited = /* @__PURE__ */ new Set();
+  let pagesRootBody = null;
+  const trailerMatches = [...text.matchAll(/trailer\s*<<([\s\S]*?)>>/g)];
+  if (trailerMatches.length > 0) {
+    const trailer = trailerMatches[trailerMatches.length - 1][1];
+    const rootRef = trailer.match(/\/Root\s+(\d+)\s+(\d+)\s+R/);
+    if (rootRef) {
+      const catalogBody = objMap.get(`${rootRef[1]} ${rootRef[2]}`);
+      const pagesRef = catalogBody?.match(/\/Pages\s+(\d+)\s+(\d+)\s+R/);
+      if (pagesRef) pagesRootBody = objMap.get(`${pagesRef[1]} ${pagesRef[2]}`) ?? null;
+    }
+  }
+  if (!pagesRootBody) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Pages\b/.test(b[3]) && !/\/Parent\s+\d+\s+\d+\s+R/.test(b[3])) {
+        pagesRootBody = b[3];
+        break;
+      }
+    }
+  }
+  if (pagesRootBody) walkPdfPageTree(objMap, pagesRootBody, { mediaBox: null, rotate: 0 }, visited, "root", out);
+  if (out.length === 0) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Page(?!s)\b/.test(b[3])) {
+        out.push(buildPdfPageDimension(out.length + 1, parsePdfMediaBox(b[3]), parsePdfRotate(b[3]) ?? 0));
+      }
+    }
+  }
+  if (out.length === 0) return { error: "Could not locate any page objects in this PDF" };
+  return { version, pageCount: out.length, pages: out };
+}
 var AUDIO_FORMAT_LABELS = {
   1: "PCM",
   3: "IEEE float",
@@ -1105,5 +1215,6 @@ exports.readIcoInfo = readIcoInfo;
 exports.readId3Tags = readId3Tags;
 exports.readImageInfo = readImageInfo;
 exports.readPdfMetadata = readPdfMetadata;
+exports.readPdfPageDimensions = readPdfPageDimensions;
 exports.readVideoInfo = readVideoInfo;
 exports.readWavInfo = readWavInfo;

package/dist/tools/media.d.cts

@@ -1 +1 @@
-export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, V as VideoInfo, k as VideoInfoError, W as WavInfo, l as WavInfoError, r as readExifData, n as readFlacInfo, o as readIcoInfo, p as readId3Tags, q as readImageInfo, s as readPdfMetadata, t as readVideoInfo, u as readWavInfo } from '../media-cuxfzXxw.cjs';
+export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, k as PdfPageDimension, l as PdfPageDimensionsResult, n as PdfPageOrientation, V as VideoInfo, o as VideoInfoError, W as WavInfo, p as WavInfoError, r as readExifData, q as readFlacInfo, s as readIcoInfo, t as readId3Tags, u as readImageInfo, v as readPdfMetadata, w as readPdfPageDimensions, x as readVideoInfo, y as readWavInfo } from '../media-fD8dJ5qR.cjs';

package/dist/tools/media.d.ts

@@ -1 +1 @@
-export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, V as VideoInfo, k as VideoInfoError, W as WavInfo, l as WavInfoError, r as readExifData, n as readFlacInfo, o as readIcoInfo, p as readId3Tags, q as readImageInfo, s as readPdfMetadata, t as readVideoInfo, u as readWavInfo } from '../media-cuxfzXxw.js';
+export { E as ExifData, a as ExifError, F as FlacInfo, b as FlacInfoError, I as IcoImageEntry, c as IcoInfo, d as IcoInfoError, e as Id3Tags, f as Id3TagsError, g as ImageFormat, h as ImageInfo, i as ImageInfoError, P as PdfMetadata, j as PdfMetadataError, k as PdfPageDimension, l as PdfPageDimensionsResult, n as PdfPageOrientation, V as VideoInfo, o as VideoInfoError, W as WavInfo, p as WavInfoError, r as readExifData, q as readFlacInfo, s as readIcoInfo, t as readId3Tags, u as readImageInfo, v as readPdfMetadata, w as readPdfPageDimensions, x as readVideoInfo, y as readWavInfo } from '../media-fD8dJ5qR.js';

package/dist/tools/media.js

@@ -1,2 +1,2 @@
-export { readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readVideoInfo, readWavInfo } from '../chunk-47DTCCQJ.js';
+export { readExifData, readFlacInfo, readIcoInfo, readId3Tags, readImageInfo, readPdfMetadata, readPdfPageDimensions, readVideoInfo, readWavInfo } from '../chunk-L6V4W4SU.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/network.cjs

@@ -1777,6 +1777,94 @@ function buildCacheControl(options = {}) {
   const snippet = `Cache-Control: ${header}`;
   return { header, headerName: "Cache-Control", snippet, directives, warnings };
 }
+function isValidIpv6HexGroup(g) {
+  return /^[0-9a-fA-F]{1,4}$/.test(g);
+}
+function isValidIpv6Ipv4Quad(quad) {
+  const parts = quad.split(".");
+  if (parts.length !== 4) return false;
+  return parts.every((p) => /^\d{1,3}$/.test(p) && Number(p) <= 255);
+}
+function classifyIpv6(groups) {
+  const first = parseInt(groups[0], 16);
+  if (groups.every((g) => g === "0000")) return "unspecified";
+  if (groups.slice(0, 7).every((g) => g === "0000") && groups[7] === "0001") return "loopback";
+  if (groups.slice(0, 4).every((g) => g === "0000") && groups[4] === "0000" && groups[5] === "ffff") return "ipv4-mapped";
+  if (groups[0] === "2001" && groups[1] === "0db8") return "documentation";
+  if ((first & 65280) === 65280) return "multicast";
+  if ((first & 65472) === 65152) return "link-local";
+  if ((first & 65024) === 64512) return "unique-local";
+  return "global-unicast";
+}
+function compressIpv6Groups(groups) {
+  const short = groups.map((g) => g.replace(/^0+(?=.)/, ""));
+  let bestStart = -1;
+  let bestLen = 0;
+  let curStart = -1;
+  let curLen = 0;
+  for (let i = 0; i < short.length; i++) {
+    if (short[i] === "0") {
+      if (curStart === -1) curStart = i;
+      curLen++;
+      if (curLen > bestLen) {
+        bestLen = curLen;
+        bestStart = curStart;
+      }
+    } else {
+      curStart = -1;
+      curLen = 0;
+    }
+  }
+  if (bestLen < 2) return short.join(":");
+  const before = short.slice(0, bestStart).join(":");
+  const after = short.slice(bestStart + bestLen).join(":");
+  return `${before}::${after}`;
+}
+function parseIpv6Address(input) {
+  let s = input.trim();
+  if (s.startsWith("[") && s.includes("]")) s = s.slice(1, s.indexOf("]"));
+  let zoneId = null;
+  const pctIdx = s.indexOf("%");
+  if (pctIdx !== -1) {
+    zoneId = s.slice(pctIdx + 1);
+    s = s.slice(0, pctIdx);
+  }
+  if (!s) return { error: "Empty address" };
+  const doubleColonCount = (s.match(/::/g) ?? []).length;
+  if (doubleColonCount > 1) return { error: 'Address contains more than one "::"' };
+  const ipv4Match = s.match(/(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/);
+  if (ipv4Match) {
+    const quad = ipv4Match[1];
+    if (!isValidIpv6Ipv4Quad(quad)) return { error: `Invalid embedded IPv4 address: ${quad}` };
+    const parts = quad.split(".").map(Number);
+    const hi = (parts[0] << 8 | parts[1]).toString(16);
+    const lo = (parts[2] << 8 | parts[3]).toString(16);
+    s = s.slice(0, s.length - quad.length) + `${hi}:${lo}`;
+  }
+  let groups;
+  if (s.includes("::")) {
+    const [left, right] = s.split("::");
+    const leftGroups = left ? left.split(":") : [];
+    const rightGroups = right ? right.split(":") : [];
+    const missing = 8 - (leftGroups.length + rightGroups.length);
+    if (missing < 1) return { error: 'The "::" shorthand must represent at least one group of zeros' };
+    if (![...leftGroups, ...rightGroups].every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+    groups = [...leftGroups, ...Array(missing).fill("0"), ...rightGroups];
+  } else {
+    groups = s.split(":");
+    if (groups.length !== 8) return { error: `Expected 8 groups, got ${groups.length}` };
+    if (!groups.every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+  }
+  const expandedGroups = groups.map((g) => g.padStart(4, "0").toLowerCase());
+  const suffix = zoneId ? `%${zoneId}` : "";
+  return {
+    expanded: expandedGroups.join(":") + suffix,
+    compressed: compressIpv6Groups(expandedGroups) + suffix,
+    groups: expandedGroups,
+    zoneId,
+    addressType: classifyIpv6(expandedGroups)
+  };
+}
 
 exports.DNS_RECORD_TYPES = DNS_RECORD_TYPES;
 exports.HTTP_HEADERS = HTTP_HEADERS;
@@ -1802,6 +1890,7 @@ exports.isValidIpv6 = isValidIpv6;
 exports.parseDnsResponse = parseDnsResponse;
 exports.parseGeoResponse = parseGeoResponse;
 exports.parseHar = parseHar;
+exports.parseIpv6Address = parseIpv6Address;
 exports.parseUserAgent = parseUserAgent;
 exports.searchHeaders = searchHeaders;
 exports.searchStatusCodes = searchStatusCodes;

package/dist/tools/network.d.cts

@@ -1 +1 @@
-export { C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, D as DNS_RECORD_TYPES, c as DnsRecord, d as DnsRecordType, e as DnsResponse, G as GeoResult, H as HTTP_HEADERS, f as HarEntry, g as HarParseResult, h as HarSummary, i as HeaderCategory, j as HttpHeader, P as ParsedDnsResult, k as ParsedGeoResult, R as RobotsGroup, l as RobotsIssue, m as RobotsRule, o as RobotsValidationResult, S as STATUS_CODES, p as SitemapIndexEntry, q as SitemapIssue, r as SitemapUrlEntry, s as SitemapValidationResult, t as StatusCode, U as UaDeviceType, u as UserAgentInfo, v as buildCacheControl, w as buildDnsQueryUrl, x as buildGeoUrl, y as buildMapUrl, z as countryCodeToFlag, A as formatCoordinates, B as formatTtl, E as getByCategory, F as getHeader, I as getHeadersByCategory, J as getStatusByCategory, K as getStatusCode, L as isClientError, M as isServerError, N as isSuccess, O as isValidIp, Q as isValidIpv4, T as isValidIpv6, V as parseDnsResponse, W as parseGeoResponse, X as parseHar, Y as parseUserAgent, Z as searchHeaders, _ as searchStatusCodes, $ as statusCodeToText, a0 as typeNumberToLabel, a1 as validateDomain, a2 as validateHeaderName, a3 as validateHeaderValue, a4 as validateRobotsTxt, a5 as validateSitemap } from '../network-BJOjJnmY.cjs';
+export { C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, D as DNS_RECORD_TYPES, c as DnsRecord, d as DnsRecordType, e as DnsResponse, G as GeoResult, H as HTTP_HEADERS, f as HarEntry, g as HarParseResult, h as HarSummary, i as HeaderCategory, j as HttpHeader, I as Ipv6AddressType, k as Ipv6ParseResult, P as ParsedDnsResult, l as ParsedGeoResult, R as RobotsGroup, m as RobotsIssue, o as RobotsRule, p as RobotsValidationResult, S as STATUS_CODES, q as SitemapIndexEntry, r as SitemapIssue, s as SitemapUrlEntry, t as SitemapValidationResult, u as StatusCode, U as UaDeviceType, v as UserAgentInfo, w as buildCacheControl, x as buildDnsQueryUrl, y as buildGeoUrl, z as buildMapUrl, A as countryCodeToFlag, B as formatCoordinates, E as formatTtl, F as getByCategory, J as getHeader, K as getHeadersByCategory, L as getStatusByCategory, M as getStatusCode, N as isClientError, O as isServerError, Q as isSuccess, T as isValidIp, V as isValidIpv4, W as isValidIpv6, X as parseDnsResponse, Y as parseGeoResponse, Z as parseHar, _ as parseIpv6Address, $ as parseUserAgent, a0 as searchHeaders, a1 as searchStatusCodes, a2 as statusCodeToText, a3 as typeNumberToLabel, a4 as validateDomain, a5 as validateHeaderName, a6 as validateHeaderValue, a7 as validateRobotsTxt, a8 as validateSitemap } from '../network-D7Epuerc.cjs';

package/dist/tools/network.d.ts

@@ -1 +1 @@
-export { C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, D as DNS_RECORD_TYPES, c as DnsRecord, d as DnsRecordType, e as DnsResponse, G as GeoResult, H as HTTP_HEADERS, f as HarEntry, g as HarParseResult, h as HarSummary, i as HeaderCategory, j as HttpHeader, P as ParsedDnsResult, k as ParsedGeoResult, R as RobotsGroup, l as RobotsIssue, m as RobotsRule, o as RobotsValidationResult, S as STATUS_CODES, p as SitemapIndexEntry, q as SitemapIssue, r as SitemapUrlEntry, s as SitemapValidationResult, t as StatusCode, U as UaDeviceType, u as UserAgentInfo, v as buildCacheControl, w as buildDnsQueryUrl, x as buildGeoUrl, y as buildMapUrl, z as countryCodeToFlag, A as formatCoordinates, B as formatTtl, E as getByCategory, F as getHeader, I as getHeadersByCategory, J as getStatusByCategory, K as getStatusCode, L as isClientError, M as isServerError, N as isSuccess, O as isValidIp, Q as isValidIpv4, T as isValidIpv6, V as parseDnsResponse, W as parseGeoResponse, X as parseHar, Y as parseUserAgent, Z as searchHeaders, _ as searchStatusCodes, $ as statusCodeToText, a0 as typeNumberToLabel, a1 as validateDomain, a2 as validateHeaderName, a3 as validateHeaderValue, a4 as validateRobotsTxt, a5 as validateSitemap } from '../network-BJOjJnmY.js';
+export { C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, D as DNS_RECORD_TYPES, c as DnsRecord, d as DnsRecordType, e as DnsResponse, G as GeoResult, H as HTTP_HEADERS, f as HarEntry, g as HarParseResult, h as HarSummary, i as HeaderCategory, j as HttpHeader, I as Ipv6AddressType, k as Ipv6ParseResult, P as ParsedDnsResult, l as ParsedGeoResult, R as RobotsGroup, m as RobotsIssue, o as RobotsRule, p as RobotsValidationResult, S as STATUS_CODES, q as SitemapIndexEntry, r as SitemapIssue, s as SitemapUrlEntry, t as SitemapValidationResult, u as StatusCode, U as UaDeviceType, v as UserAgentInfo, w as buildCacheControl, x as buildDnsQueryUrl, y as buildGeoUrl, z as buildMapUrl, A as countryCodeToFlag, B as formatCoordinates, E as formatTtl, F as getByCategory, J as getHeader, K as getHeadersByCategory, L as getStatusByCategory, M as getStatusCode, N as isClientError, O as isServerError, Q as isSuccess, T as isValidIp, V as isValidIpv4, W as isValidIpv6, X as parseDnsResponse, Y as parseGeoResponse, Z as parseHar, _ as parseIpv6Address, $ as parseUserAgent, a0 as searchHeaders, a1 as searchStatusCodes, a2 as statusCodeToText, a3 as typeNumberToLabel, a4 as validateDomain, a5 as validateHeaderName, a6 as validateHeaderValue, a7 as validateRobotsTxt, a8 as validateSitemap } from '../network-D7Epuerc.js';

package/dist/tools/network.js

@@ -1,2 +1,2 @@
-export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, parseDnsResponse, parseGeoResponse, parseHar, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap } from '../chunk-Y5OOP6WN.js';
+export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, parseDnsResponse, parseGeoResponse, parseHar, parseIpv6Address, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap } from '../chunk-CSNTHZHF.js';
 import '../chunk-MLKGABMK.js';

package/package.json

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