@utilix-tech/sdk 0.93.0 → 0.95.0

package/dist/index.cjs

@@ -9372,6 +9372,7 @@ __export(units_exports, {
   decimalToIpCidr: () => decimalToIpCidr,
   describePermissions: () => describePermissions,
   detectNegativeAmortization: () => detectNegativeAmortization,
+  estimateAudioFileSize: () => estimateAudioFileSize,
   fitIntoBox: () => fitIntoBox,
   formatNumber: () => formatNumber,
   formatValue: () => formatValue,
@@ -12468,6 +12469,56 @@ function detectNegativeAmortization(input) {
     capCrossedMonth
   };
 }
+var AUDIO_FILE_SIZE_WAV_HEADER_BYTES = 44;
+function estimateAudioFileSize(input) {
+  const { mode, durationSeconds } = input;
+  if (!Number.isFinite(durationSeconds) || durationSeconds <= 0) {
+    return { error: "durationSeconds must be a positive number" };
+  }
+  const round23 = (n) => Math.round(n * 100) / 100;
+  if (mode === "pcm") {
+    const { sampleRateHz, bitDepth, channels } = input;
+    if (!Number.isFinite(sampleRateHz) || sampleRateHz <= 0) {
+      return { error: 'sampleRateHz must be a positive number for mode "pcm"' };
+    }
+    if (!Number.isFinite(bitDepth) || bitDepth <= 0) {
+      return { error: 'bitDepth must be a positive number for mode "pcm"' };
+    }
+    if (!Number.isInteger(channels) || channels <= 0) {
+      return { error: 'channels must be a positive whole number for mode "pcm"' };
+    }
+    const dataBytes = sampleRateHz * (bitDepth / 8) * channels * durationSeconds;
+    const fileSizeBytes = dataBytes + AUDIO_FILE_SIZE_WAV_HEADER_BYTES;
+    return {
+      mode,
+      durationSeconds,
+      sampleRateHz,
+      bitDepth,
+      channels,
+      dataBytes: Math.round(dataBytes),
+      fileSizeBytes: Math.round(fileSizeBytes),
+      fileSizeMB: round23(fileSizeBytes / 1e6),
+      fileSizeMiB: round23(fileSizeBytes / 1048576)
+    };
+  }
+  if (mode === "compressed") {
+    const { bitrateKbps } = input;
+    if (!Number.isFinite(bitrateKbps) || bitrateKbps <= 0) {
+      return { error: 'bitrateKbps must be a positive number for mode "compressed"' };
+    }
+    const dataBytes = bitrateKbps * 1e3 * durationSeconds / 8;
+    return {
+      mode,
+      durationSeconds,
+      bitrateKbps,
+      dataBytes: Math.round(dataBytes),
+      fileSizeBytes: Math.round(dataBytes),
+      fileSizeMB: round23(dataBytes / 1e6),
+      fileSizeMiB: round23(dataBytes / 1048576)
+    };
+  }
+  return { error: 'mode must be "pcm" or "compressed"' };
+}
 
 // src/tools/network.ts
 var network_exports = {};
@@ -12483,6 +12534,7 @@ __export(network_exports, {
   analyzeEmailHeaders: () => analyzeEmailHeaders,
   assessContentTypeRisk: () => assessContentTypeRisk,
   buildAcceptLanguage: () => buildAcceptLanguage,
+  buildAltSvcHeader: () => buildAltSvcHeader,
   buildCacheControl: () => buildCacheControl,
   buildClearSiteData: () => buildClearSiteData,
   buildClientHints: () => buildClientHints,
@@ -12525,6 +12577,7 @@ __export(network_exports, {
   lookupCloseCode: () => lookupCloseCode,
   lookupOpcode: () => lookupOpcode,
   parseAcceptLanguage: () => parseAcceptLanguage,
+  parseAltSvcHeader: () => parseAltSvcHeader,
   parseClearSiteData: () => parseClearSiteData,
   parseClientHintHeaders: () => parseClientHintHeaders,
   parseContentDisposition: () => parseContentDisposition,
@@ -16180,6 +16233,114 @@ function parseClearSiteData(raw) {
   }
   return buildClearSiteData(directives);
 }
+var ALT_SVC_DEFAULT_MAX_AGE = 86400;
+var ALT_SVC_DEPRECATED_H3_DRAFTS = /* @__PURE__ */ new Set(["h3-29", "h3-27", "h3-25", "h3-24", "h3-23", "h3-22"]);
+var ALT_SVC_PROTOCOL_NOTES = {
+  "h3": "HTTP/3 over QUIC, the current protocol ID clients should be offered.",
+  "h3-29": 'An outdated HTTP/3 draft version (draft-29); modern clients only match "h3".',
+  "h3-27": 'An outdated HTTP/3 draft version (draft-27); modern clients only match "h3".',
+  "h3-25": 'An outdated HTTP/3 draft version (draft-25); modern clients only match "h3".',
+  "h2": "HTTP/2 over TLS.",
+  "h2c": "HTTP/2 over cleartext TCP; rarely advertised via Alt-Svc since it needs an out-of-band upgrade rather than ALPN negotiation.",
+  "http/1.1": "Plain HTTP/1.1; advertising it via Alt-Svc is unusual since it is already the universal fallback."
+};
+function buildAltSvcHeader(alternatives) {
+  if (!Array.isArray(alternatives) || alternatives.length === 0) {
+    return { error: "At least one alternative service is required" };
+  }
+  const warnings = [];
+  const entries = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const alt of alternatives) {
+    const protocolId = typeof alt.protocolId === "string" ? alt.protocolId.trim() : "";
+    if (!protocolId) return { error: 'Each alternative needs a protocol-id (e.g. "h3")' };
+    if (!Number.isInteger(alt.port) || alt.port < 1 || alt.port > 65535) {
+      return { error: `Each alternative needs a valid port (1-65535), got ${JSON.stringify(alt.port)}` };
+    }
+    const host = alt.host?.trim();
+    const authority = `${host ?? ""}:${alt.port}`;
+    const maxAge = alt.maxAge !== void 0 ? alt.maxAge : ALT_SVC_DEFAULT_MAX_AGE;
+    if (!Number.isFinite(maxAge) || maxAge < 0) return { error: "maxAge must be a non-negative number of seconds" };
+    const persist = alt.persist === true;
+    const dedupeKey = `${protocolId.toLowerCase()}|${authority.toLowerCase()}`;
+    if (seen.has(dedupeKey)) {
+      warnings.push(`duplicate alternative "${protocolId}=${JSON.stringify(authority)}" was removed`);
+      continue;
+    }
+    seen.add(dedupeKey);
+    if (maxAge === 0) warnings.push(`"${protocolId}" has ma=0, so clients should treat it as already expired`);
+    if (persist && maxAge === 0) warnings.push(`"${protocolId}" sets persist=1 with ma=0, which is contradictory: the entry expires immediately`);
+    if (ALT_SVC_DEPRECATED_H3_DRAFTS.has(protocolId.toLowerCase())) {
+      warnings.push(`"${protocolId}" is an outdated HTTP/3 draft protocol-id; modern clients only match "h3"`);
+    }
+    const note = ALT_SVC_PROTOCOL_NOTES[protocolId.toLowerCase()] ?? `Advertises "${protocolId}" as an alternative protocol clients may switch to for this authority.`;
+    entries.push({ protocolId, authority, maxAge, persist, note });
+  }
+  if (entries.length === 0) return { error: "At least one alternative service is required" };
+  const headerValue = entries.map((e) => {
+    let s = `${e.protocolId}="${e.authority}"; ma=${e.maxAge}`;
+    if (e.persist) s += "; persist=1";
+    return s;
+  }).join(", ");
+  return { header: `Alt-Svc: ${headerValue}`, headerValue, entries, cleared: false, warnings };
+}
+function altSvcSplitTopLevel(s, sep) {
+  const out = [];
+  let inQuotes = false;
+  let current = "";
+  for (const ch of s) {
+    if (ch === '"') inQuotes = !inQuotes;
+    if (ch === sep && !inQuotes) {
+      out.push(current);
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  out.push(current);
+  return out;
+}
+function parseAltSvcHeader(raw) {
+  if (!raw || raw.trim() === "") return { error: "Input is empty" };
+  const withoutLabel = raw.trim().replace(/^alt-svc:\s*/i, "");
+  if (withoutLabel.toLowerCase() === "clear") {
+    return { header: "Alt-Svc: clear", headerValue: "clear", entries: [], cleared: true, warnings: [] };
+  }
+  const parts = altSvcSplitTopLevel(withoutLabel, ",");
+  const alternatives = [];
+  for (const part of parts) {
+    const trimmedPart = part.trim();
+    if (!trimmedPart) continue;
+    const eq = trimmedPart.indexOf("=");
+    if (eq === -1) return { error: `Could not parse alternative: "${trimmedPart}"` };
+    const protocolId = trimmedPart.slice(0, eq).trim();
+    const rest = trimmedPart.slice(eq + 1).trim();
+    const segments = altSvcSplitTopLevel(rest, ";").map((s) => s.trim());
+    const authorityMatch = segments[0]?.match(/^"(.*)"$/);
+    if (!authorityMatch) return { error: `Alternative "${protocolId}" is missing a quoted authority (e.g. ":443")` };
+    const authority = authorityMatch[1];
+    const colonIdx = authority.lastIndexOf(":");
+    if (colonIdx === -1) return { error: `Alternative "${protocolId}" has an authority with no port: "${authority}"` };
+    const host = authority.slice(0, colonIdx) || void 0;
+    const portStr = authority.slice(colonIdx + 1);
+    const port = Number(portStr);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) return { error: `Alternative "${protocolId}" has an invalid port: "${portStr}"` };
+    let maxAge;
+    let persist = false;
+    for (const seg of segments.slice(1)) {
+      const sepIdx = seg.indexOf("=");
+      if (sepIdx === -1) continue;
+      const key = seg.slice(0, sepIdx).trim().toLowerCase();
+      const value = seg.slice(sepIdx + 1).trim();
+      if (key === "ma") maxAge = Number(value);
+      if (key === "persist") persist = value === "1";
+    }
+    if (maxAge !== void 0 && !Number.isFinite(maxAge)) return { error: `Alternative "${protocolId}" has a non-numeric ma value` };
+    alternatives.push({ protocolId, host, port, maxAge, persist });
+  }
+  if (alternatives.length === 0) return { error: "No alternative services found" };
+  return buildAltSvcHeader(alternatives);
+}
 
 // src/tools/api.ts
 var api_exports = {};
@@ -27224,6 +27385,7 @@ __export(media_exports, {
   readPdfMetadata: () => readPdfMetadata,
   readPdfOutline: () => readPdfOutline,
   readPdfPageDimensions: () => readPdfPageDimensions,
+  readPngChunks: () => readPngChunks,
   readVideoInfo: () => readVideoInfo,
   readWavInfo: () => readWavInfo
 });
@@ -28717,6 +28879,116 @@ function readMidiInfo(bytes) {
     tracks
   };
 }
+var PNG_SIGNATURE = [137, 80, 78, 71, 13, 10, 26, 10];
+var PNG_CRC_TABLE = null;
+function getPngCrcTable() {
+  if (PNG_CRC_TABLE) return PNG_CRC_TABLE;
+  const table = new Uint32Array(256);
+  for (let n = 0; n < 256; n++) {
+    let c = n;
+    for (let k = 0; k < 8; k++) {
+      c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
+    }
+    table[n] = c;
+  }
+  PNG_CRC_TABLE = table;
+  return table;
+}
+function pngCrc32(bytes) {
+  const table = getPngCrcTable();
+  let crc = 4294967295;
+  for (let i = 0; i < bytes.length; i++) {
+    crc = table[(crc ^ bytes[i]) & 255] ^ crc >>> 8;
+  }
+  return (crc ^ 4294967295) >>> 0;
+}
+function pad2(n) {
+  return n < 10 ? `0${n}` : `${n}`;
+}
+function readPngChunks(bytes) {
+  if (bytes.length < 8) return { error: "File too small to be a valid PNG file" };
+  for (let i = 0; i < 8; i++) {
+    if (bytes[i] !== PNG_SIGNATURE[i]) return { error: "Not a valid PNG file (bad 8-byte signature)" };
+  }
+  const chunks = [];
+  const textChunks = [];
+  let header = null;
+  let physicalDimensions = null;
+  let gamma = null;
+  let lastModified = null;
+  let isAnimated = false;
+  let offset = 8;
+  while (offset + 8 <= bytes.length) {
+    const dataLength = readU32BE(bytes, offset);
+    const type = String.fromCharCode(bytes[offset + 4], bytes[offset + 5], bytes[offset + 6], bytes[offset + 7]);
+    const dataStart = offset + 8;
+    const dataEnd = dataStart + dataLength;
+    const crcOffset = dataEnd;
+    if (crcOffset + 4 > bytes.length) {
+      return { error: `Truncated chunk "${type}" at offset ${offset}` };
+    }
+    const data = bytes.subarray(dataStart, dataEnd);
+    const expectedCrc = readU32BE(bytes, crcOffset);
+    const actualCrc = pngCrc32(bytes.subarray(offset + 4, dataEnd));
+    const firstChar = type.charCodeAt(0);
+    const critical = firstChar >= 65 && firstChar <= 90;
+    chunks.push({ type, offset, dataLength, crcValid: actualCrc === expectedCrc, critical });
+    if (type === "IHDR" && data.length >= 13) {
+      const colorTypeNum = data[9];
+      header = {
+        width: readU32BE(data, 0),
+        height: readU32BE(data, 4),
+        bitDepth: data[8],
+        colorType: PNG_COLOR_TYPES[colorTypeNum] ?? "unknown",
+        hasAlpha: colorTypeNum === 4 || colorTypeNum === 6,
+        interlace: data[12] === 1
+      };
+    } else if (type === "tEXt") {
+      const nullIdx = data.indexOf(0);
+      if (nullIdx !== -1) {
+        textChunks.push({
+          keyword: Buffer.from(data.subarray(0, nullIdx)).toString("latin1"),
+          text: Buffer.from(data.subarray(nullIdx + 1)).toString("latin1"),
+          compressed: false
+        });
+      }
+    } else if (type === "zTXt" || type === "iTXt") {
+      const nullIdx = data.indexOf(0);
+      if (nullIdx !== -1) {
+        textChunks.push({ keyword: Buffer.from(data.subarray(0, nullIdx)).toString("latin1"), text: null, compressed: true });
+      }
+    } else if (type === "pHYs" && data.length >= 9) {
+      physicalDimensions = {
+        pixelsPerUnitX: readU32BE(data, 0),
+        pixelsPerUnitY: readU32BE(data, 4),
+        unit: data[8] === 1 ? "meter" : "unknown"
+      };
+    } else if (type === "gAMA" && data.length >= 4) {
+      gamma = readU32BE(data, 0) / 1e5;
+    } else if (type === "tIME" && data.length >= 7) {
+      const year = data[0] << 8 | data[1];
+      lastModified = `${year}-${pad2(data[2])}-${pad2(data[3])}T${pad2(data[4])}:${pad2(data[5])}:${pad2(data[6])}Z`;
+    } else if (type === "acTL") {
+      isAnimated = true;
+    }
+    offset = crcOffset + 4;
+    if (type === "IEND") break;
+  }
+  if (chunks.length === 0) return { error: "No chunks found after the PNG signature" };
+  if (!header) return { error: "Missing required IHDR chunk" };
+  return {
+    valid: true,
+    fileSize: bytes.length,
+    chunkCount: chunks.length,
+    chunks,
+    header,
+    textChunks,
+    physicalDimensions,
+    gamma,
+    lastModified,
+    isAnimated
+  };
+}
 
 // src/index.ts
 var version = "0.1.0";

package/dist/index.d.cts

@@ -5,15 +5,15 @@ export { t as text } from './text-DOopHoK3.cjs';
 export { d as data } from './data-3qMdFIF5.cjs';
 export { g as generators } from './generators-DAXXrMvG.cjs';
 export { t as time } from './time-VMAy_SrV.cjs';
-export { u as units } from './units-DnWrOTSV.cjs';
-export { n as network } from './network-9j5aKpoR.cjs';
+export { u as units } from './units-BBzv0VIt.cjs';
+export { n as network } from './network-B6fQrsCc.cjs';
 export { a as api } from './api-CQnIUrVB.cjs';
 export { c as code } from './code-CZHElFHu.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-B9wWLBDf.cjs';
-export { m as media } from './media-DF8BS-iA.cjs';
+export { m as media } from './media-C8Y67lUI.cjs';
 
 declare const version = "0.1.0";
 

package/dist/index.d.ts

@@ -5,15 +5,15 @@ export { t as text } from './text-DOopHoK3.js';
 export { d as data } from './data-3qMdFIF5.js';
 export { g as generators } from './generators-DAXXrMvG.js';
 export { t as time } from './time-VMAy_SrV.js';
-export { u as units } from './units-DnWrOTSV.js';
-export { n as network } from './network-9j5aKpoR.js';
+export { u as units } from './units-BBzv0VIt.js';
+export { n as network } from './network-B6fQrsCc.js';
 export { a as api } from './api-CQnIUrVB.js';
 export { c as code } from './code-CZHElFHu.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-B9wWLBDf.js';
-export { m as media } from './media-DF8BS-iA.js';
+export { m as media } from './media-C8Y67lUI.js';
 
 declare const version = "0.1.0";
 

package/dist/index.js

@@ -1,6 +1,6 @@
-export { media_exports as media } from './chunk-ZWFZRDQ4.js';
-export { units_exports as units } from './chunk-XAPHAUPI.js';
-export { network_exports as network } from './chunk-K3B4JTHN.js';
+export { media_exports as media } from './chunk-YSS4VVZU.js';
+export { units_exports as units } from './chunk-G5NUC5MV.js';
+export { network_exports as network } from './chunk-K242OOF4.js';
 export { api_exports as api } from './chunk-U2HREMZU.js';
 export { code_exports as code } from './chunk-KRPIOHJ4.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';

package/dist/{media-DF8BS-iA.d.ts → media-C8Y67lUI.d.cts}

@@ -289,6 +289,59 @@ interface MidiInfoError {
  * frames-per-second/ticks-per-frame rate instead.
  */
 declare function readMidiInfo(bytes: Uint8Array): MidiInfo | MidiInfoError;
+interface PngChunkEntry {
+    type: string;
+    offset: number;
+    dataLength: number;
+    crcValid: boolean;
+    /** A chunk type is "critical" (decoders must understand it) when its
+     *  first letter is uppercase, e.g. IHDR vs. an ancillary tEXt. */
+    critical: boolean;
+}
+interface PngHeaderInfo {
+    width: number;
+    height: number;
+    bitDepth: number;
+    colorType: string;
+    hasAlpha: boolean;
+    interlace: boolean;
+}
+interface PngTextChunk {
+    keyword: string;
+    text: string | null;
+    /** True for zTXt/iTXt, whose text this function does not decode. */
+    compressed: boolean;
+}
+interface PngPhysicalDimensions {
+    pixelsPerUnitX: number;
+    pixelsPerUnitY: number;
+    unit: 'meter' | 'unknown';
+}
+interface PngChunkInfo {
+    valid: true;
+    fileSize: number;
+    chunkCount: number;
+    chunks: PngChunkEntry[];
+    header: PngHeaderInfo | null;
+    textChunks: PngTextChunk[];
+    physicalDimensions: PngPhysicalDimensions | null;
+    gamma: number | null;
+    lastModified: string | null;
+    isAnimated: boolean;
+}
+interface PngChunkInfoError {
+    error: string;
+}
+/**
+ * Walk a PNG file's full chunk stream directly from its bytes: every
+ * chunk's type, byte offset, data length, and whether its stored CRC-32
+ * matches the type+data it covers, plus the decoded IHDR header and a
+ * handful of common ancillary chunks (tEXt, pHYs, gAMA, tIME, and acTL for
+ * APNG animation). No image library or pixel decoding is involved, and
+ * zTXt/iTXt text is listed but not zlib-inflated, so the result is
+ * identical in a browser tool and on a server.
+ */
+declare function readPngChunks(bytes: Uint8Array): PngChunkInfo | PngChunkInfoError;
 
 type media_ExifData = ExifData;
 type media_ExifError = ExifError;
@@ -318,6 +371,12 @@ type media_PdfOutlineResult = PdfOutlineResult;
 type media_PdfPageDimension = PdfPageDimension;
 type media_PdfPageDimensionsResult = PdfPageDimensionsResult;
 type media_PdfPageOrientation = PdfPageOrientation;
+type media_PngChunkEntry = PngChunkEntry;
+type media_PngChunkInfo = PngChunkInfo;
+type media_PngChunkInfoError = PngChunkInfoError;
+type media_PngHeaderInfo = PngHeaderInfo;
+type media_PngPhysicalDimensions = PngPhysicalDimensions;
+type media_PngTextChunk = PngTextChunk;
 type media_VideoInfo = VideoInfo;
 type media_VideoInfoError = VideoInfoError;
 type media_WavInfo = WavInfo;
@@ -332,10 +391,11 @@ declare const media_readMidiInfo: typeof readMidiInfo;
 declare const media_readPdfMetadata: typeof readPdfMetadata;
 declare const media_readPdfOutline: typeof readPdfOutline;
 declare const media_readPdfPageDimensions: typeof readPdfPageDimensions;
+declare const media_readPngChunks: typeof readPngChunks;
 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_GifInfo as GifInfo, type media_GifInfoError as GifInfoError, 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_MidiDivision as MidiDivision, type media_MidiInfo as MidiInfo, type media_MidiInfoError as MidiInfoError, type media_MidiTimeSignature as MidiTimeSignature, type media_MidiTrackInfo as MidiTrackInfo, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_PdfOutlineDestType as PdfOutlineDestType, type media_PdfOutlineError as PdfOutlineError, type media_PdfOutlineItem as PdfOutlineItem, type media_PdfOutlineResult as PdfOutlineResult, 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_inspectGifFrames as inspectGifFrames, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readMidiInfo as readMidiInfo, media_readPdfMetadata as readPdfMetadata, media_readPdfOutline as readPdfOutline, media_readPdfPageDimensions as readPdfPageDimensions, 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_GifInfo as GifInfo, type media_GifInfoError as GifInfoError, 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_MidiDivision as MidiDivision, type media_MidiInfo as MidiInfo, type media_MidiInfoError as MidiInfoError, type media_MidiTimeSignature as MidiTimeSignature, type media_MidiTrackInfo as MidiTrackInfo, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_PdfOutlineDestType as PdfOutlineDestType, type media_PdfOutlineError as PdfOutlineError, type media_PdfOutlineItem as PdfOutlineItem, type media_PdfOutlineResult as PdfOutlineResult, type media_PdfPageDimension as PdfPageDimension, type media_PdfPageDimensionsResult as PdfPageDimensionsResult, type media_PdfPageOrientation as PdfPageOrientation, type media_PngChunkEntry as PngChunkEntry, type media_PngChunkInfo as PngChunkInfo, type media_PngChunkInfoError as PngChunkInfoError, type media_PngHeaderInfo as PngHeaderInfo, type media_PngPhysicalDimensions as PngPhysicalDimensions, type media_PngTextChunk as PngTextChunk, type media_VideoInfo as VideoInfo, type media_VideoInfoError as VideoInfoError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_inspectGifFrames as inspectGifFrames, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readMidiInfo as readMidiInfo, media_readPdfMetadata as readPdfMetadata, media_readPdfOutline as readPdfOutline, media_readPdfPageDimensions as readPdfPageDimensions, media_readPngChunks as readPngChunks, media_readVideoInfo as readVideoInfo, media_readWavInfo as readWavInfo };
 }
 
-export { readExifData as A, readFlacInfo as B, readIcoInfo as C, readId3Tags as D, type ExifData as E, type FlacInfo as F, type GifInfo as G, readImageInfo as H, type IcoImageEntry as I, readMidiInfo as J, readPdfMetadata as K, readPdfOutline as L, type MidiDivision as M, readPdfPageDimensions as N, readVideoInfo as O, type PdfMetadata as P, readWavInfo as Q, type VideoInfo as V, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type GifInfoError as c, type IcoInfo as d, type IcoInfoError as e, type Id3Tags as f, type Id3TagsError as g, type ImageFormat as h, type ImageInfo as i, type ImageInfoError as j, type MidiInfo as k, type MidiInfoError as l, media as m, type MidiTimeSignature as n, type MidiTrackInfo as o, type PdfMetadataError as p, type PdfOutlineDestType as q, type PdfOutlineError as r, type PdfOutlineItem as s, type PdfOutlineResult as t, type PdfPageDimension as u, type PdfPageDimensionsResult as v, type PdfPageOrientation as w, type VideoInfoError as x, type WavInfoError as y, inspectGifFrames as z };
+export { type PngHeaderInfo as A, type PngPhysicalDimensions as B, type PngTextChunk as C, type VideoInfoError as D, type ExifData as E, type FlacInfo as F, type GifInfo as G, type WavInfoError as H, type IcoImageEntry as I, inspectGifFrames as J, readExifData as K, readFlacInfo as L, type MidiDivision as M, readIcoInfo as N, readId3Tags as O, type PdfMetadata as P, readImageInfo as Q, readMidiInfo as R, readPdfMetadata as S, readPdfOutline as T, readPdfPageDimensions as U, type VideoInfo as V, type WavInfo as W, readPngChunks as X, readVideoInfo as Y, readWavInfo as Z, type ExifError as a, type FlacInfoError as b, type GifInfoError as c, type IcoInfo as d, type IcoInfoError as e, type Id3Tags as f, type Id3TagsError as g, type ImageFormat as h, type ImageInfo as i, type ImageInfoError as j, type MidiInfo as k, type MidiInfoError as l, media as m, type MidiTimeSignature as n, type MidiTrackInfo as o, type PdfMetadataError as p, type PdfOutlineDestType as q, type PdfOutlineError as r, type PdfOutlineItem as s, type PdfOutlineResult as t, type PdfPageDimension as u, type PdfPageDimensionsResult as v, type PdfPageOrientation as w, type PngChunkEntry as x, type PngChunkInfo as y, type PngChunkInfoError as z };

package/dist/{media-DF8BS-iA.d.cts → media-C8Y67lUI.d.ts}

@@ -289,6 +289,59 @@ interface MidiInfoError {
  * frames-per-second/ticks-per-frame rate instead.
  */
 declare function readMidiInfo(bytes: Uint8Array): MidiInfo | MidiInfoError;
+interface PngChunkEntry {
+    type: string;
+    offset: number;
+    dataLength: number;
+    crcValid: boolean;
+    /** A chunk type is "critical" (decoders must understand it) when its
+     *  first letter is uppercase, e.g. IHDR vs. an ancillary tEXt. */
+    critical: boolean;
+}
+interface PngHeaderInfo {
+    width: number;
+    height: number;
+    bitDepth: number;
+    colorType: string;
+    hasAlpha: boolean;
+    interlace: boolean;
+}
+interface PngTextChunk {
+    keyword: string;
+    text: string | null;
+    /** True for zTXt/iTXt, whose text this function does not decode. */
+    compressed: boolean;
+}
+interface PngPhysicalDimensions {
+    pixelsPerUnitX: number;
+    pixelsPerUnitY: number;
+    unit: 'meter' | 'unknown';
+}
+interface PngChunkInfo {
+    valid: true;
+    fileSize: number;
+    chunkCount: number;
+    chunks: PngChunkEntry[];
+    header: PngHeaderInfo | null;
+    textChunks: PngTextChunk[];
+    physicalDimensions: PngPhysicalDimensions | null;
+    gamma: number | null;
+    lastModified: string | null;
+    isAnimated: boolean;
+}
+interface PngChunkInfoError {
+    error: string;
+}
+/**
+ * Walk a PNG file's full chunk stream directly from its bytes: every
+ * chunk's type, byte offset, data length, and whether its stored CRC-32
+ * matches the type+data it covers, plus the decoded IHDR header and a
+ * handful of common ancillary chunks (tEXt, pHYs, gAMA, tIME, and acTL for
+ * APNG animation). No image library or pixel decoding is involved, and
+ * zTXt/iTXt text is listed but not zlib-inflated, so the result is
+ * identical in a browser tool and on a server.
+ */
+declare function readPngChunks(bytes: Uint8Array): PngChunkInfo | PngChunkInfoError;
 
 type media_ExifData = ExifData;
 type media_ExifError = ExifError;
@@ -318,6 +371,12 @@ type media_PdfOutlineResult = PdfOutlineResult;
 type media_PdfPageDimension = PdfPageDimension;
 type media_PdfPageDimensionsResult = PdfPageDimensionsResult;
 type media_PdfPageOrientation = PdfPageOrientation;
+type media_PngChunkEntry = PngChunkEntry;
+type media_PngChunkInfo = PngChunkInfo;
+type media_PngChunkInfoError = PngChunkInfoError;
+type media_PngHeaderInfo = PngHeaderInfo;
+type media_PngPhysicalDimensions = PngPhysicalDimensions;
+type media_PngTextChunk = PngTextChunk;
 type media_VideoInfo = VideoInfo;
 type media_VideoInfoError = VideoInfoError;
 type media_WavInfo = WavInfo;
@@ -332,10 +391,11 @@ declare const media_readMidiInfo: typeof readMidiInfo;
 declare const media_readPdfMetadata: typeof readPdfMetadata;
 declare const media_readPdfOutline: typeof readPdfOutline;
 declare const media_readPdfPageDimensions: typeof readPdfPageDimensions;
+declare const media_readPngChunks: typeof readPngChunks;
 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_GifInfo as GifInfo, type media_GifInfoError as GifInfoError, 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_MidiDivision as MidiDivision, type media_MidiInfo as MidiInfo, type media_MidiInfoError as MidiInfoError, type media_MidiTimeSignature as MidiTimeSignature, type media_MidiTrackInfo as MidiTrackInfo, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_PdfOutlineDestType as PdfOutlineDestType, type media_PdfOutlineError as PdfOutlineError, type media_PdfOutlineItem as PdfOutlineItem, type media_PdfOutlineResult as PdfOutlineResult, 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_inspectGifFrames as inspectGifFrames, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readMidiInfo as readMidiInfo, media_readPdfMetadata as readPdfMetadata, media_readPdfOutline as readPdfOutline, media_readPdfPageDimensions as readPdfPageDimensions, 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_GifInfo as GifInfo, type media_GifInfoError as GifInfoError, 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_MidiDivision as MidiDivision, type media_MidiInfo as MidiInfo, type media_MidiInfoError as MidiInfoError, type media_MidiTimeSignature as MidiTimeSignature, type media_MidiTrackInfo as MidiTrackInfo, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_PdfOutlineDestType as PdfOutlineDestType, type media_PdfOutlineError as PdfOutlineError, type media_PdfOutlineItem as PdfOutlineItem, type media_PdfOutlineResult as PdfOutlineResult, type media_PdfPageDimension as PdfPageDimension, type media_PdfPageDimensionsResult as PdfPageDimensionsResult, type media_PdfPageOrientation as PdfPageOrientation, type media_PngChunkEntry as PngChunkEntry, type media_PngChunkInfo as PngChunkInfo, type media_PngChunkInfoError as PngChunkInfoError, type media_PngHeaderInfo as PngHeaderInfo, type media_PngPhysicalDimensions as PngPhysicalDimensions, type media_PngTextChunk as PngTextChunk, type media_VideoInfo as VideoInfo, type media_VideoInfoError as VideoInfoError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_inspectGifFrames as inspectGifFrames, media_readExifData as readExifData, media_readFlacInfo as readFlacInfo, media_readIcoInfo as readIcoInfo, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readMidiInfo as readMidiInfo, media_readPdfMetadata as readPdfMetadata, media_readPdfOutline as readPdfOutline, media_readPdfPageDimensions as readPdfPageDimensions, media_readPngChunks as readPngChunks, media_readVideoInfo as readVideoInfo, media_readWavInfo as readWavInfo };
 }
 
-export { readExifData as A, readFlacInfo as B, readIcoInfo as C, readId3Tags as D, type ExifData as E, type FlacInfo as F, type GifInfo as G, readImageInfo as H, type IcoImageEntry as I, readMidiInfo as J, readPdfMetadata as K, readPdfOutline as L, type MidiDivision as M, readPdfPageDimensions as N, readVideoInfo as O, type PdfMetadata as P, readWavInfo as Q, type VideoInfo as V, type WavInfo as W, type ExifError as a, type FlacInfoError as b, type GifInfoError as c, type IcoInfo as d, type IcoInfoError as e, type Id3Tags as f, type Id3TagsError as g, type ImageFormat as h, type ImageInfo as i, type ImageInfoError as j, type MidiInfo as k, type MidiInfoError as l, media as m, type MidiTimeSignature as n, type MidiTrackInfo as o, type PdfMetadataError as p, type PdfOutlineDestType as q, type PdfOutlineError as r, type PdfOutlineItem as s, type PdfOutlineResult as t, type PdfPageDimension as u, type PdfPageDimensionsResult as v, type PdfPageOrientation as w, type VideoInfoError as x, type WavInfoError as y, inspectGifFrames as z };
+export { type PngHeaderInfo as A, type PngPhysicalDimensions as B, type PngTextChunk as C, type VideoInfoError as D, type ExifData as E, type FlacInfo as F, type GifInfo as G, type WavInfoError as H, type IcoImageEntry as I, inspectGifFrames as J, readExifData as K, readFlacInfo as L, type MidiDivision as M, readIcoInfo as N, readId3Tags as O, type PdfMetadata as P, readImageInfo as Q, readMidiInfo as R, readPdfMetadata as S, readPdfOutline as T, readPdfPageDimensions as U, type VideoInfo as V, type WavInfo as W, readPngChunks as X, readVideoInfo as Y, readWavInfo as Z, type ExifError as a, type FlacInfoError as b, type GifInfoError as c, type IcoInfo as d, type IcoInfoError as e, type Id3Tags as f, type Id3TagsError as g, type ImageFormat as h, type ImageInfo as i, type ImageInfoError as j, type MidiInfo as k, type MidiInfoError as l, media as m, type MidiTimeSignature as n, type MidiTrackInfo as o, type PdfMetadataError as p, type PdfOutlineDestType as q, type PdfOutlineError as r, type PdfOutlineItem as s, type PdfOutlineResult as t, type PdfPageDimension as u, type PdfPageDimensionsResult as v, type PdfPageOrientation as w, type PngChunkEntry as x, type PngChunkInfo as y, type PngChunkInfoError as z };