@utilix-tech/sdk 0.6.0 → 0.8.0

package/dist/media-C3ZvGyKc.d.ts

@@ -0,0 +1,132 @@
+type ImageFormat = 'png' | 'jpeg' | 'gif' | 'webp' | 'bmp';
+interface ImageInfo {
+    format: ImageFormat;
+    width: number;
+    height: number;
+    bitDepth?: number;
+    colorType?: string;
+    hasAlpha?: boolean;
+}
+interface ImageInfoError {
+    error: string;
+}
+/**
+ * Read image format, dimensions, and basic color info straight from file
+ * bytes — no decoding, no image library, no canvas. Supports PNG, JPEG,
+ * GIF, WebP, and BMP.
+ */
+declare function readImageInfo(bytes: Uint8Array): ImageInfo | ImageInfoError;
+interface ExifData {
+    make?: string;
+    model?: string;
+    software?: string;
+    orientation?: number;
+    orientationLabel?: string;
+    dateTime?: string;
+    dateTimeOriginal?: string;
+    exposureTime?: string;
+    fNumber?: number;
+    isoSpeed?: number;
+    focalLength?: number;
+    gpsLatitude?: number;
+    gpsLongitude?: number;
+    tagCount: number;
+}
+interface ExifError {
+    error: string;
+}
+/**
+ * Read common EXIF tags (make, model, orientation, timestamps, exposure
+ * settings, GPS coordinates) directly from a JPEG's APP1 segment. Only
+ * JPEG is supported: PNG, WebP, and other formats don't carry EXIF the
+ * same way and are rejected with an error.
+ */
+declare function readExifData(bytes: Uint8Array): ExifData | ExifError;
+interface PdfMetadata {
+    version: string | null;
+    pageCount: number | null;
+    title: string | null;
+    author: string | null;
+    subject: string | null;
+    keywords: string | null;
+    creator: string | null;
+    producer: string | null;
+    creationDate: string | null;
+    modDate: string | null;
+    encrypted: boolean;
+}
+interface PdfMetadataError {
+    error: string;
+}
+/**
+ * Read PDF metadata (title, author, dates, page count, encryption flag)
+ * straight from the file's trailer/Info dictionary and page tree — no
+ * pdf.js or other PDF rendering library required.
+ */
+declare function readPdfMetadata(bytes: Uint8Array): PdfMetadata | PdfMetadataError;
+interface WavInfo {
+    audioFormat: number;
+    audioFormatLabel: string;
+    channels: number;
+    sampleRate: number;
+    byteRate: number;
+    blockAlign: number;
+    bitsPerSample: number;
+    dataSize: number;
+    durationSeconds: number;
+    fileSize: number;
+}
+interface WavInfoError {
+    error: string;
+}
+/**
+ * Read a WAV file's RIFF/fmt/data chunk headers to report sample rate,
+ * channel count, bit depth, and duration, without decoding any audio
+ * samples. Only the canonical RIFF/WAVE container is supported (not the
+ * rarer RF64 variant used for files over 4GB).
+ */
+declare function readWavInfo(bytes: Uint8Array): WavInfo | WavInfoError;
+interface Id3Tags {
+    version: string;
+    title?: string;
+    artist?: string;
+    album?: string;
+    year?: string;
+    genre?: string;
+    comment?: string;
+    trackNumber?: string;
+    frameCount?: number;
+}
+interface Id3TagsError {
+    error: string;
+}
+/**
+ * Read ID3 tags (title, artist, album, year, genre, comment, track number)
+ * directly from an MP3 file's bytes, without any audio-decoding library.
+ * Prefers an ID3v2.3/2.4 header at the start of the file; falls back to a
+ * classic ID3v1/1.1 128-byte trailer if no ID3v2 text frames are found.
+ * ID3v2.2 tags are detected but their 3-character frame IDs are not decoded.
+ */
+declare function readId3Tags(bytes: Uint8Array): Id3Tags | Id3TagsError;
+
+type media_ExifData = ExifData;
+type media_ExifError = ExifError;
+type media_Id3Tags = Id3Tags;
+type media_Id3TagsError = Id3TagsError;
+type media_ImageFormat = ImageFormat;
+type media_ImageInfo = ImageInfo;
+type media_ImageInfoError = ImageInfoError;
+type media_PdfMetadata = PdfMetadata;
+type media_PdfMetadataError = PdfMetadataError;
+type media_WavInfo = WavInfo;
+type media_WavInfoError = WavInfoError;
+declare const media_readExifData: typeof readExifData;
+declare const media_readId3Tags: typeof readId3Tags;
+declare const media_readImageInfo: typeof readImageInfo;
+declare const media_readPdfMetadata: typeof readPdfMetadata;
+declare const media_readWavInfo: typeof readWavInfo;
+declare namespace media {
+  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_Id3Tags as Id3Tags, type media_Id3TagsError as Id3TagsError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, type media_WavInfo as WavInfo, type media_WavInfoError as WavInfoError, media_readExifData as readExifData, media_readId3Tags as readId3Tags, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata, media_readWavInfo as readWavInfo };
+}
+
+export { type ExifData as E, type Id3Tags as I, type PdfMetadata as P, type WavInfo as W, type ExifError as a, type Id3TagsError as b, type ImageFormat as c, type ImageInfo as d, type ImageInfoError as e, type PdfMetadataError as f, type WavInfoError as g, readId3Tags as h, readImageInfo as i, readPdfMetadata as j, readWavInfo as k, media as m, readExifData as r };

package/dist/{text-CI7JAl7F.d.cts → text-Bbx-tZ43.d.cts}

@@ -256,6 +256,25 @@ interface PassiveVoiceResult {
  * "was written", "is being reviewed", "were quickly approved by the team".
  */
 declare function detectPassiveVoice(text: string): PassiveVoiceResult;
+interface ReadabilityResult {
+    wordCount: number;
+    sentenceCount: number;
+    syllableCount: number;
+    complexWordCount: number;
+    avgWordsPerSentence: number;
+    avgSyllablesPerWord: number;
+    fleschReadingEase: number;
+    fleschKincaidGrade: number;
+    gunningFog: number;
+    readingLevel: string;
+}
+/**
+ * Score pasted text with Flesch Reading Ease, Flesch-Kincaid Grade Level,
+ * and Gunning Fog Index, using a heuristic syllable counter (vowel-group
+ * counting with common English spelling adjustments) rather than a
+ * dictionary lookup, so scores are an estimate rather than exact.
+ */
+declare function scoreReadability(text: string): ReadabilityResult;
 
 type text_AsciiFont = AsciiFont;
 type text_AsciiOptions = AsciiOptions;
@@ -283,6 +302,7 @@ type text_ParsedTable = ParsedTable;
 type text_PassiveVoiceMatch = PassiveVoiceMatch;
 type text_PassiveVoiceResult = PassiveVoiceResult;
 type text_PassiveVoiceSentence = PassiveVoiceSentence;
+type text_ReadabilityResult = ReadabilityResult;
 type text_ReadabilityScore = ReadabilityScore;
 type text_SlugSeparator = SlugSeparator;
 type text_TableOptions = TableOptions;
@@ -330,6 +350,7 @@ declare const text_parseTableData: typeof parseTableData;
 declare const text_readabilityScore: typeof readabilityScore;
 declare const text_renderMarkdown: typeof renderMarkdown;
 declare const text_romanToNumber: typeof romanToNumber;
+declare const text_scoreReadability: typeof scoreReadability;
 declare const text_sentenceCount: typeof sentenceCount;
 declare const text_slugify: typeof slugify;
 declare const text_slugifyAll: typeof slugifyAll;
@@ -339,7 +360,7 @@ declare const text_textToMorse: typeof textToMorse;
 declare const text_unescapeString: typeof unescapeString;
 declare const text_wordFrequency: typeof wordFrequency;
 declare namespace text {
-  export { type text_AsciiFont as AsciiFont, type text_AsciiOptions as AsciiOptions, text_CASE_FORMATS as CASE_FORMATS, type text_CaseFormat as CaseFormat, type text_ConvertOptions as ConvertOptions, text_DEFAULT_CONVERT_OPTIONS as DEFAULT_CONVERT_OPTIONS, type text_DiffFile as DiffFile, type text_DiffHunk as DiffHunk, type text_DiffLine as DiffLine, type text_DiffResult as DiffResult, type text_DiffType as DiffType, type text_DiffViewerLine as DiffViewerLine, text_ESCAPE_MODES as ESCAPE_MODES, type text_EscapeMode as EscapeMode, text_LINE_OPS as LINE_OPS, type text_LineOp as LineOp, type text_LineType as LineType, type text_LoremUnit as LoremUnit, text_MORSE_CODE as MORSE_CODE, type text_MarkdownResult as MarkdownResult, type text_MorseOptions as MorseOptions, type text_ParsedDiff as ParsedDiff, type text_ParsedTable as ParsedTable, type text_PassiveVoiceMatch as PassiveVoiceMatch, type text_PassiveVoiceResult as PassiveVoiceResult, type text_PassiveVoiceSentence as PassiveVoiceSentence, type text_ReadabilityScore as ReadabilityScore, type text_SlugSeparator as SlugSeparator, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, text_centerText as centerText, text_convertAll as convertAll, text_convertCase as convertCase, text_countWords as countWords, text_csvToHtml as csvToHtml, text_csvToMarkdown as csvToMarkdown, text_detectDelimiter as detectDelimiter, text_detectPassiveVoice as detectPassiveVoice, text_diffLines as diffLines, text_diffLinesSimple as diffLinesSimple, text_diffStats as diffStats, text_escapeAll as escapeAll, text_escapeString as escapeString, text_extractHeadings as extractHeadings, text_formatReadingTime as formatReadingTime, text_generate as generate, text_generateDiff as generateDiff, text_generateHtmlTable as generateHtmlTable, text_generateMarkdownTable as generateMarkdownTable, text_generateParagraphs as generateParagraphs, text_generateSentences as generateSentences, text_generateWords as generateWords, text_getAvailableFonts as getAvailableFonts, text_getMorseForChar as getMorseForChar, text_getMorseTiming as getMorseTiming, text_htmlToMarkdown as htmlToMarkdown, text_isValidMorse as isValidMorse, text_markdownToHtml as markdownToHtml, text_morseToText as morseToText, text_numberToOrdinal as numberToOrdinal, text_numberToRoman as numberToRoman, text_numberToWords as numberToWords, text_ordinalWords as ordinalWords, text_parseDiff as parseDiff, text_parseTableData as parseTableData, text_readabilityScore as readabilityScore, text_renderMarkdown as renderMarkdown, text_romanToNumber as romanToNumber, text_sentenceCount as sentenceCount, text_slugify as slugify, text_slugifyAll as slugifyAll, text_syllableCount as syllableCount, text_textToAscii as textToAscii, text_textToMorse as textToMorse, text_unescapeString as unescapeString, text_wordFrequency as wordFrequency };
+  export { type text_AsciiFont as AsciiFont, type text_AsciiOptions as AsciiOptions, text_CASE_FORMATS as CASE_FORMATS, type text_CaseFormat as CaseFormat, type text_ConvertOptions as ConvertOptions, text_DEFAULT_CONVERT_OPTIONS as DEFAULT_CONVERT_OPTIONS, type text_DiffFile as DiffFile, type text_DiffHunk as DiffHunk, type text_DiffLine as DiffLine, type text_DiffResult as DiffResult, type text_DiffType as DiffType, type text_DiffViewerLine as DiffViewerLine, text_ESCAPE_MODES as ESCAPE_MODES, type text_EscapeMode as EscapeMode, text_LINE_OPS as LINE_OPS, type text_LineOp as LineOp, type text_LineType as LineType, type text_LoremUnit as LoremUnit, text_MORSE_CODE as MORSE_CODE, type text_MarkdownResult as MarkdownResult, type text_MorseOptions as MorseOptions, type text_ParsedDiff as ParsedDiff, type text_ParsedTable as ParsedTable, type text_PassiveVoiceMatch as PassiveVoiceMatch, type text_PassiveVoiceResult as PassiveVoiceResult, type text_PassiveVoiceSentence as PassiveVoiceSentence, type text_ReadabilityResult as ReadabilityResult, type text_ReadabilityScore as ReadabilityScore, type text_SlugSeparator as SlugSeparator, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, text_centerText as centerText, text_convertAll as convertAll, text_convertCase as convertCase, text_countWords as countWords, text_csvToHtml as csvToHtml, text_csvToMarkdown as csvToMarkdown, text_detectDelimiter as detectDelimiter, text_detectPassiveVoice as detectPassiveVoice, text_diffLines as diffLines, text_diffLinesSimple as diffLinesSimple, text_diffStats as diffStats, text_escapeAll as escapeAll, text_escapeString as escapeString, text_extractHeadings as extractHeadings, text_formatReadingTime as formatReadingTime, text_generate as generate, text_generateDiff as generateDiff, text_generateHtmlTable as generateHtmlTable, text_generateMarkdownTable as generateMarkdownTable, text_generateParagraphs as generateParagraphs, text_generateSentences as generateSentences, text_generateWords as generateWords, text_getAvailableFonts as getAvailableFonts, text_getMorseForChar as getMorseForChar, text_getMorseTiming as getMorseTiming, text_htmlToMarkdown as htmlToMarkdown, text_isValidMorse as isValidMorse, text_markdownToHtml as markdownToHtml, text_morseToText as morseToText, text_numberToOrdinal as numberToOrdinal, text_numberToRoman as numberToRoman, text_numberToWords as numberToWords, text_ordinalWords as ordinalWords, text_parseDiff as parseDiff, text_parseTableData as parseTableData, text_readabilityScore as readabilityScore, text_renderMarkdown as renderMarkdown, text_romanToNumber as romanToNumber, text_scoreReadability as scoreReadability, text_sentenceCount as sentenceCount, text_slugify as slugify, text_slugifyAll as slugifyAll, text_syllableCount as syllableCount, text_textToAscii as textToAscii, text_textToMorse as textToMorse, text_unescapeString as unescapeString, text_wordFrequency as wordFrequency };
 }
 
-export { generateHtmlTable as $, type AsciiFont as A, convertAll as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, convertCase as F, countWords as G, csvToHtml as H, csvToMarkdown as I, detectDelimiter as J, detectPassiveVoice as K, LINE_OPS as L, MORSE_CODE as M, diffLines as N, diffLinesSimple as O, type ParsedDiff as P, diffStats as Q, type ReadabilityScore as R, type SlugSeparator as S, type TableOptions as T, escapeAll as U, escapeString as V, type WordCountResult as W, extractHeadings as X, formatReadingTime as Y, generate as Z, generateDiff as _, type AsciiOptions as a, generateMarkdownTable as a0, generateParagraphs as a1, generateSentences as a2, generateWords as a3, getAvailableFonts as a4, getMorseForChar as a5, getMorseTiming as a6, htmlToMarkdown as a7, isValidMorse as a8, markdownToHtml as a9, morseToText as aa, numberToOrdinal as ab, numberToRoman as ac, numberToWords as ad, ordinalWords as ae, parseDiff as af, parseTableData as ag, readabilityScore as ah, renderMarkdown as ai, romanToNumber as aj, sentenceCount as ak, slugify as al, slugifyAll as am, syllableCount as an, textToAscii as ao, textToMorse as ap, unescapeString as aq, wordFrequency as ar, type CaseFormat as b, type ConvertOptions as c, type DiffFile as d, type DiffHunk as e, type DiffLine as f, type DiffResult as g, type DiffType as h, type DiffViewerLine as i, type EscapeMode as j, type LineOp as k, type LineType as l, type LoremUnit as m, type MarkdownResult as n, type MorseOptions as o, type ParsedTable as p, type PassiveVoiceMatch as q, type PassiveVoiceResult as r, type PassiveVoiceSentence as s, text as t, type TextAnalysis as u, addBorder as v, analyzeText as w, applyOp as x, applyOps as y, centerText as z };
+export { generateDiff as $, type AsciiFont as A, centerText as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, convertAll as F, convertCase as G, countWords as H, csvToHtml as I, csvToMarkdown as J, detectDelimiter as K, LINE_OPS as L, MORSE_CODE as M, detectPassiveVoice as N, diffLines as O, type ParsedDiff as P, diffLinesSimple as Q, type ReadabilityResult as R, type SlugSeparator as S, type TableOptions as T, diffStats as U, escapeAll as V, type WordCountResult as W, escapeString as X, extractHeadings as Y, formatReadingTime as Z, generate as _, type AsciiOptions as a, generateHtmlTable as a0, generateMarkdownTable as a1, generateParagraphs as a2, generateSentences as a3, generateWords as a4, getAvailableFonts as a5, getMorseForChar as a6, getMorseTiming as a7, htmlToMarkdown as a8, isValidMorse as a9, markdownToHtml as aa, morseToText as ab, numberToOrdinal as ac, numberToRoman as ad, numberToWords as ae, ordinalWords as af, parseDiff as ag, parseTableData as ah, readabilityScore as ai, renderMarkdown as aj, romanToNumber as ak, scoreReadability as al, sentenceCount as am, slugify as an, slugifyAll as ao, syllableCount as ap, textToAscii as aq, textToMorse as ar, unescapeString as as, wordFrequency as at, type CaseFormat as b, type ConvertOptions as c, type DiffFile as d, type DiffHunk as e, type DiffLine as f, type DiffResult as g, type DiffType as h, type DiffViewerLine as i, type EscapeMode as j, type LineOp as k, type LineType as l, type LoremUnit as m, type MarkdownResult as n, type MorseOptions as o, type ParsedTable as p, type PassiveVoiceMatch as q, type PassiveVoiceResult as r, type PassiveVoiceSentence as s, text as t, type ReadabilityScore as u, type TextAnalysis as v, addBorder as w, analyzeText as x, applyOp as y, applyOps as z };

package/dist/{text-CI7JAl7F.d.ts → text-Bbx-tZ43.d.ts}

@@ -256,6 +256,25 @@ interface PassiveVoiceResult {
  * "was written", "is being reviewed", "were quickly approved by the team".
  */
 declare function detectPassiveVoice(text: string): PassiveVoiceResult;
+interface ReadabilityResult {
+    wordCount: number;
+    sentenceCount: number;
+    syllableCount: number;
+    complexWordCount: number;
+    avgWordsPerSentence: number;
+    avgSyllablesPerWord: number;
+    fleschReadingEase: number;
+    fleschKincaidGrade: number;
+    gunningFog: number;
+    readingLevel: string;
+}
+/**
+ * Score pasted text with Flesch Reading Ease, Flesch-Kincaid Grade Level,
+ * and Gunning Fog Index, using a heuristic syllable counter (vowel-group
+ * counting with common English spelling adjustments) rather than a
+ * dictionary lookup, so scores are an estimate rather than exact.
+ */
+declare function scoreReadability(text: string): ReadabilityResult;
 
 type text_AsciiFont = AsciiFont;
 type text_AsciiOptions = AsciiOptions;
@@ -283,6 +302,7 @@ type text_ParsedTable = ParsedTable;
 type text_PassiveVoiceMatch = PassiveVoiceMatch;
 type text_PassiveVoiceResult = PassiveVoiceResult;
 type text_PassiveVoiceSentence = PassiveVoiceSentence;
+type text_ReadabilityResult = ReadabilityResult;
 type text_ReadabilityScore = ReadabilityScore;
 type text_SlugSeparator = SlugSeparator;
 type text_TableOptions = TableOptions;
@@ -330,6 +350,7 @@ declare const text_parseTableData: typeof parseTableData;
 declare const text_readabilityScore: typeof readabilityScore;
 declare const text_renderMarkdown: typeof renderMarkdown;
 declare const text_romanToNumber: typeof romanToNumber;
+declare const text_scoreReadability: typeof scoreReadability;
 declare const text_sentenceCount: typeof sentenceCount;
 declare const text_slugify: typeof slugify;
 declare const text_slugifyAll: typeof slugifyAll;
@@ -339,7 +360,7 @@ declare const text_textToMorse: typeof textToMorse;
 declare const text_unescapeString: typeof unescapeString;
 declare const text_wordFrequency: typeof wordFrequency;
 declare namespace text {
-  export { type text_AsciiFont as AsciiFont, type text_AsciiOptions as AsciiOptions, text_CASE_FORMATS as CASE_FORMATS, type text_CaseFormat as CaseFormat, type text_ConvertOptions as ConvertOptions, text_DEFAULT_CONVERT_OPTIONS as DEFAULT_CONVERT_OPTIONS, type text_DiffFile as DiffFile, type text_DiffHunk as DiffHunk, type text_DiffLine as DiffLine, type text_DiffResult as DiffResult, type text_DiffType as DiffType, type text_DiffViewerLine as DiffViewerLine, text_ESCAPE_MODES as ESCAPE_MODES, type text_EscapeMode as EscapeMode, text_LINE_OPS as LINE_OPS, type text_LineOp as LineOp, type text_LineType as LineType, type text_LoremUnit as LoremUnit, text_MORSE_CODE as MORSE_CODE, type text_MarkdownResult as MarkdownResult, type text_MorseOptions as MorseOptions, type text_ParsedDiff as ParsedDiff, type text_ParsedTable as ParsedTable, type text_PassiveVoiceMatch as PassiveVoiceMatch, type text_PassiveVoiceResult as PassiveVoiceResult, type text_PassiveVoiceSentence as PassiveVoiceSentence, type text_ReadabilityScore as ReadabilityScore, type text_SlugSeparator as SlugSeparator, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, text_centerText as centerText, text_convertAll as convertAll, text_convertCase as convertCase, text_countWords as countWords, text_csvToHtml as csvToHtml, text_csvToMarkdown as csvToMarkdown, text_detectDelimiter as detectDelimiter, text_detectPassiveVoice as detectPassiveVoice, text_diffLines as diffLines, text_diffLinesSimple as diffLinesSimple, text_diffStats as diffStats, text_escapeAll as escapeAll, text_escapeString as escapeString, text_extractHeadings as extractHeadings, text_formatReadingTime as formatReadingTime, text_generate as generate, text_generateDiff as generateDiff, text_generateHtmlTable as generateHtmlTable, text_generateMarkdownTable as generateMarkdownTable, text_generateParagraphs as generateParagraphs, text_generateSentences as generateSentences, text_generateWords as generateWords, text_getAvailableFonts as getAvailableFonts, text_getMorseForChar as getMorseForChar, text_getMorseTiming as getMorseTiming, text_htmlToMarkdown as htmlToMarkdown, text_isValidMorse as isValidMorse, text_markdownToHtml as markdownToHtml, text_morseToText as morseToText, text_numberToOrdinal as numberToOrdinal, text_numberToRoman as numberToRoman, text_numberToWords as numberToWords, text_ordinalWords as ordinalWords, text_parseDiff as parseDiff, text_parseTableData as parseTableData, text_readabilityScore as readabilityScore, text_renderMarkdown as renderMarkdown, text_romanToNumber as romanToNumber, text_sentenceCount as sentenceCount, text_slugify as slugify, text_slugifyAll as slugifyAll, text_syllableCount as syllableCount, text_textToAscii as textToAscii, text_textToMorse as textToMorse, text_unescapeString as unescapeString, text_wordFrequency as wordFrequency };
+  export { type text_AsciiFont as AsciiFont, type text_AsciiOptions as AsciiOptions, text_CASE_FORMATS as CASE_FORMATS, type text_CaseFormat as CaseFormat, type text_ConvertOptions as ConvertOptions, text_DEFAULT_CONVERT_OPTIONS as DEFAULT_CONVERT_OPTIONS, type text_DiffFile as DiffFile, type text_DiffHunk as DiffHunk, type text_DiffLine as DiffLine, type text_DiffResult as DiffResult, type text_DiffType as DiffType, type text_DiffViewerLine as DiffViewerLine, text_ESCAPE_MODES as ESCAPE_MODES, type text_EscapeMode as EscapeMode, text_LINE_OPS as LINE_OPS, type text_LineOp as LineOp, type text_LineType as LineType, type text_LoremUnit as LoremUnit, text_MORSE_CODE as MORSE_CODE, type text_MarkdownResult as MarkdownResult, type text_MorseOptions as MorseOptions, type text_ParsedDiff as ParsedDiff, type text_ParsedTable as ParsedTable, type text_PassiveVoiceMatch as PassiveVoiceMatch, type text_PassiveVoiceResult as PassiveVoiceResult, type text_PassiveVoiceSentence as PassiveVoiceSentence, type text_ReadabilityResult as ReadabilityResult, type text_ReadabilityScore as ReadabilityScore, type text_SlugSeparator as SlugSeparator, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, text_centerText as centerText, text_convertAll as convertAll, text_convertCase as convertCase, text_countWords as countWords, text_csvToHtml as csvToHtml, text_csvToMarkdown as csvToMarkdown, text_detectDelimiter as detectDelimiter, text_detectPassiveVoice as detectPassiveVoice, text_diffLines as diffLines, text_diffLinesSimple as diffLinesSimple, text_diffStats as diffStats, text_escapeAll as escapeAll, text_escapeString as escapeString, text_extractHeadings as extractHeadings, text_formatReadingTime as formatReadingTime, text_generate as generate, text_generateDiff as generateDiff, text_generateHtmlTable as generateHtmlTable, text_generateMarkdownTable as generateMarkdownTable, text_generateParagraphs as generateParagraphs, text_generateSentences as generateSentences, text_generateWords as generateWords, text_getAvailableFonts as getAvailableFonts, text_getMorseForChar as getMorseForChar, text_getMorseTiming as getMorseTiming, text_htmlToMarkdown as htmlToMarkdown, text_isValidMorse as isValidMorse, text_markdownToHtml as markdownToHtml, text_morseToText as morseToText, text_numberToOrdinal as numberToOrdinal, text_numberToRoman as numberToRoman, text_numberToWords as numberToWords, text_ordinalWords as ordinalWords, text_parseDiff as parseDiff, text_parseTableData as parseTableData, text_readabilityScore as readabilityScore, text_renderMarkdown as renderMarkdown, text_romanToNumber as romanToNumber, text_scoreReadability as scoreReadability, text_sentenceCount as sentenceCount, text_slugify as slugify, text_slugifyAll as slugifyAll, text_syllableCount as syllableCount, text_textToAscii as textToAscii, text_textToMorse as textToMorse, text_unescapeString as unescapeString, text_wordFrequency as wordFrequency };
 }
 
-export { generateHtmlTable as $, type AsciiFont as A, convertAll as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, convertCase as F, countWords as G, csvToHtml as H, csvToMarkdown as I, detectDelimiter as J, detectPassiveVoice as K, LINE_OPS as L, MORSE_CODE as M, diffLines as N, diffLinesSimple as O, type ParsedDiff as P, diffStats as Q, type ReadabilityScore as R, type SlugSeparator as S, type TableOptions as T, escapeAll as U, escapeString as V, type WordCountResult as W, extractHeadings as X, formatReadingTime as Y, generate as Z, generateDiff as _, type AsciiOptions as a, generateMarkdownTable as a0, generateParagraphs as a1, generateSentences as a2, generateWords as a3, getAvailableFonts as a4, getMorseForChar as a5, getMorseTiming as a6, htmlToMarkdown as a7, isValidMorse as a8, markdownToHtml as a9, morseToText as aa, numberToOrdinal as ab, numberToRoman as ac, numberToWords as ad, ordinalWords as ae, parseDiff as af, parseTableData as ag, readabilityScore as ah, renderMarkdown as ai, romanToNumber as aj, sentenceCount as ak, slugify as al, slugifyAll as am, syllableCount as an, textToAscii as ao, textToMorse as ap, unescapeString as aq, wordFrequency as ar, type CaseFormat as b, type ConvertOptions as c, type DiffFile as d, type DiffHunk as e, type DiffLine as f, type DiffResult as g, type DiffType as h, type DiffViewerLine as i, type EscapeMode as j, type LineOp as k, type LineType as l, type LoremUnit as m, type MarkdownResult as n, type MorseOptions as o, type ParsedTable as p, type PassiveVoiceMatch as q, type PassiveVoiceResult as r, type PassiveVoiceSentence as s, text as t, type TextAnalysis as u, addBorder as v, analyzeText as w, applyOp as x, applyOps as y, centerText as z };
+export { generateDiff as $, type AsciiFont as A, centerText as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, convertAll as F, convertCase as G, countWords as H, csvToHtml as I, csvToMarkdown as J, detectDelimiter as K, LINE_OPS as L, MORSE_CODE as M, detectPassiveVoice as N, diffLines as O, type ParsedDiff as P, diffLinesSimple as Q, type ReadabilityResult as R, type SlugSeparator as S, type TableOptions as T, diffStats as U, escapeAll as V, type WordCountResult as W, escapeString as X, extractHeadings as Y, formatReadingTime as Z, generate as _, type AsciiOptions as a, generateHtmlTable as a0, generateMarkdownTable as a1, generateParagraphs as a2, generateSentences as a3, generateWords as a4, getAvailableFonts as a5, getMorseForChar as a6, getMorseTiming as a7, htmlToMarkdown as a8, isValidMorse as a9, markdownToHtml as aa, morseToText as ab, numberToOrdinal as ac, numberToRoman as ad, numberToWords as ae, ordinalWords as af, parseDiff as ag, parseTableData as ah, readabilityScore as ai, renderMarkdown as aj, romanToNumber as ak, scoreReadability as al, sentenceCount as am, slugify as an, slugifyAll as ao, syllableCount as ap, textToAscii as aq, textToMorse as ar, unescapeString as as, wordFrequency as at, type CaseFormat as b, type ConvertOptions as c, type DiffFile as d, type DiffHunk as e, type DiffLine as f, type DiffResult as g, type DiffType as h, type DiffViewerLine as i, type EscapeMode as j, type LineOp as k, type LineType as l, type LoremUnit as m, type MarkdownResult as n, type MorseOptions as o, type ParsedTable as p, type PassiveVoiceMatch as q, type PassiveVoiceResult as r, type PassiveVoiceSentence as s, text as t, type ReadabilityScore as u, type TextAnalysis as v, addBorder as w, analyzeText as x, applyOp as y, applyOps as z };

package/dist/tools/data.cjs

@@ -1064,6 +1064,23 @@ function envToExport(input) {
 function validateEnvKey(key) {
   return /^[A-Za-z_][A-Za-z0-9_]*$/.test(key);
 }
+function diffEnvExample(envInput, exampleInput) {
+  const envParsed = parseEnv(envInput);
+  if (envParsed.errors.length > 0) {
+    return { error: `.env: ${envParsed.errors.map((e) => `Line ${e.line}: ${e.message}`).join("; ")}` };
+  }
+  const exampleParsed = parseEnv(exampleInput);
+  if (exampleParsed.errors.length > 0) {
+    return { error: `.env.example: ${exampleParsed.errors.map((e) => `Line ${e.line}: ${e.message}`).join("; ")}` };
+  }
+  const envKeys = new Set(envParsed.entries.map((e) => e.key));
+  const exampleValues = new Map(exampleParsed.entries.map((e) => [e.key, e.value]));
+  const missingInExample = [...envKeys].filter((k) => !exampleValues.has(k)).sort();
+  const missingInEnv = [...exampleValues.keys()].filter((k) => !envKeys.has(k)).sort();
+  const emptyValueInExample = [...exampleValues.entries()].filter(([k, v]) => envKeys.has(k) && v === "").map(([k]) => k).sort();
+  const keysInBoth = [...envKeys].filter((k) => exampleValues.has(k)).length;
+  return { missingInExample, missingInEnv, emptyValueInExample, keysInBoth };
+}
 function validateNdjson(input) {
   const rawLines = input.split("\n");
   const lines = [];
@@ -1125,6 +1142,7 @@ function jsonArrayToNdjson(input) {
 
 exports.csvToJson = csvToJson;
 exports.detectDelimiter = detectDelimiter;
+exports.diffEnvExample = diffEnvExample;
 exports.envToExport = envToExport;
 exports.envToJson = envToJson;
 exports.formatNdjson = formatNdjson;

package/dist/tools/data.d.cts

@@ -1 +1 @@
-export { C as CsvParseResult, E as EnvEntry, a as EnvParseResult, I as IniSection, N as NdjsonLineResult, b as NdjsonValidateResult, P as ParseOptions, c as ParsedIni, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, e as XmlToJsonOptions, f as csvToJson, g as detectDelimiter, h as envToExport, i as envToJson, j as formatNdjson, k as formatToml, l as formatXml, m as getSection, n as getSectionNames, o as getTomlStats, p as getXmlStats, q as getYamlStats, r as iniToJson, s as jsonArrayToNdjson, t as jsonToIni, u as jsonToToml, v as jsonToXml, w as minifyNdjson, x as minifyToml, y as minifyXml, z as ndjsonToJsonArray, A as parseCsv, B as parseEnv, D as parseIni, F as parseXmlToObject, G as stringifyIni, H as toCsvString, J as tomlToJson, K as validateEnvKey, L as validateIni, M as validateNdjson, O as validateToml, Q as validateXml, R as validateYaml, S as xmlToJson } from '../data-CakDxAcT.cjs';
+export { C as CsvParseResult, E as EnvDiffError, a as EnvDiffResult, b as EnvEntry, c as EnvParseResult, I as IniSection, N as NdjsonLineResult, e as NdjsonValidateResult, P as ParseOptions, f as ParsedIni, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, g as XmlToJsonOptions, h as csvToJson, i as detectDelimiter, j as diffEnvExample, k as envToExport, l as envToJson, m as formatNdjson, n as formatToml, o as formatXml, p as getSection, q as getSectionNames, r as getTomlStats, s as getXmlStats, t as getYamlStats, u as iniToJson, v as jsonArrayToNdjson, w as jsonToIni, x as jsonToToml, y as jsonToXml, z as minifyNdjson, A as minifyToml, B as minifyXml, D as ndjsonToJsonArray, F as parseCsv, G as parseEnv, H as parseIni, J as parseXmlToObject, K as stringifyIni, L as toCsvString, M as tomlToJson, O as validateEnvKey, Q as validateIni, R as validateNdjson, S as validateToml, U as validateXml, W as validateYaml, Y as xmlToJson } from '../data-D8XTI7Du.cjs';

package/dist/tools/data.d.ts

@@ -1 +1 @@
-export { C as CsvParseResult, E as EnvEntry, a as EnvParseResult, I as IniSection, N as NdjsonLineResult, b as NdjsonValidateResult, P as ParseOptions, c as ParsedIni, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, e as XmlToJsonOptions, f as csvToJson, g as detectDelimiter, h as envToExport, i as envToJson, j as formatNdjson, k as formatToml, l as formatXml, m as getSection, n as getSectionNames, o as getTomlStats, p as getXmlStats, q as getYamlStats, r as iniToJson, s as jsonArrayToNdjson, t as jsonToIni, u as jsonToToml, v as jsonToXml, w as minifyNdjson, x as minifyToml, y as minifyXml, z as ndjsonToJsonArray, A as parseCsv, B as parseEnv, D as parseIni, F as parseXmlToObject, G as stringifyIni, H as toCsvString, J as tomlToJson, K as validateEnvKey, L as validateIni, M as validateNdjson, O as validateToml, Q as validateXml, R as validateYaml, S as xmlToJson } from '../data-CakDxAcT.js';
+export { C as CsvParseResult, E as EnvDiffError, a as EnvDiffResult, b as EnvEntry, c as EnvParseResult, I as IniSection, N as NdjsonLineResult, e as NdjsonValidateResult, P as ParseOptions, f as ParsedIni, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, g as XmlToJsonOptions, h as csvToJson, i as detectDelimiter, j as diffEnvExample, k as envToExport, l as envToJson, m as formatNdjson, n as formatToml, o as formatXml, p as getSection, q as getSectionNames, r as getTomlStats, s as getXmlStats, t as getYamlStats, u as iniToJson, v as jsonArrayToNdjson, w as jsonToIni, x as jsonToToml, y as jsonToXml, z as minifyNdjson, A as minifyToml, B as minifyXml, D as ndjsonToJsonArray, F as parseCsv, G as parseEnv, H as parseIni, J as parseXmlToObject, K as stringifyIni, L as toCsvString, M as tomlToJson, O as validateEnvKey, Q as validateIni, R as validateNdjson, S as validateToml, U as validateXml, W as validateYaml, Y as xmlToJson } from '../data-D8XTI7Du.js';

package/dist/tools/data.js

@@ -1,2 +1,2 @@
-export { csvToJson, detectDelimiter, envToExport, envToJson, formatNdjson, formatToml, formatXml, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToJsonArray, parseCsv, parseEnv, parseIni, parseXmlToObject, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson } from '../chunk-DNCOIO5N.js';
+export { csvToJson, detectDelimiter, diffEnvExample, envToExport, envToJson, formatNdjson, formatToml, formatXml, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToJsonArray, parseCsv, parseEnv, parseIni, parseXmlToObject, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson } from '../chunk-TINQFTLO.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/media.cjs

@@ -457,7 +457,274 @@ function readPdfMetadata(bytes) {
     encrypted
   };
 }
+var AUDIO_FORMAT_LABELS = {
+  1: "PCM",
+  3: "IEEE float",
+  6: "A-law",
+  7: "mu-law",
+  65534: "Extensible"
+};
+function readAscii4(bytes, offset) {
+  return String.fromCharCode(bytes[offset], bytes[offset + 1], bytes[offset + 2], bytes[offset + 3]);
+}
+function readWavInfo(bytes) {
+  if (bytes.length < 12) return { error: "File is too small to be a valid WAV file" };
+  if (readAscii4(bytes, 0) !== "RIFF") return { error: 'Not a RIFF file (missing "RIFF" header)' };
+  if (readAscii4(bytes, 8) !== "WAVE") return { error: 'Not a WAVE file (missing "WAVE" format marker)' };
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const fileSize = view.getUint32(4, true) + 8;
+  let offset = 12;
+  let fmt = null;
+  let dataSize = null;
+  while (offset + 8 <= bytes.length) {
+    const chunkId = readAscii4(bytes, offset);
+    const chunkSize = view.getUint32(offset + 4, true);
+    const dataOffset = offset + 8;
+    if (chunkId === "fmt ") {
+      if (dataOffset + 16 > bytes.length) return { error: 'Truncated "fmt " chunk' };
+      fmt = {
+        audioFormat: view.getUint16(dataOffset, true),
+        channels: view.getUint16(dataOffset + 2, true),
+        sampleRate: view.getUint32(dataOffset + 4, true),
+        byteRate: view.getUint32(dataOffset + 8, true),
+        blockAlign: view.getUint16(dataOffset + 12, true),
+        bitsPerSample: view.getUint16(dataOffset + 14, true)
+      };
+    } else if (chunkId === "data") {
+      dataSize = Math.min(chunkSize, bytes.length - dataOffset);
+    }
+    offset = dataOffset + chunkSize + chunkSize % 2;
+    if (fmt && dataSize !== null) break;
+  }
+  if (!fmt) return { error: 'No "fmt " chunk found in this WAV file' };
+  if (dataSize === null) return { error: 'No "data" chunk found in this WAV file' };
+  if (fmt.byteRate <= 0) return { error: 'Invalid byte rate in "fmt " chunk' };
+  const durationSeconds = Math.round(dataSize / fmt.byteRate * 1e3) / 1e3;
+  return {
+    audioFormat: fmt.audioFormat,
+    audioFormatLabel: AUDIO_FORMAT_LABELS[fmt.audioFormat] ?? `Unknown (0x${fmt.audioFormat.toString(16)})`,
+    channels: fmt.channels,
+    sampleRate: fmt.sampleRate,
+    byteRate: fmt.byteRate,
+    blockAlign: fmt.blockAlign,
+    bitsPerSample: fmt.bitsPerSample,
+    dataSize,
+    durationSeconds,
+    fileSize
+  };
+}
+var ID3V1_GENRES = [
+  "Blues",
+  "Classic Rock",
+  "Country",
+  "Dance",
+  "Disco",
+  "Funk",
+  "Grunge",
+  "Hip-Hop",
+  "Jazz",
+  "Metal",
+  "New Age",
+  "Oldies",
+  "Other",
+  "Pop",
+  "R&B",
+  "Rap",
+  "Reggae",
+  "Rock",
+  "Techno",
+  "Industrial",
+  "Alternative",
+  "Ska",
+  "Death Metal",
+  "Pranks",
+  "Soundtrack",
+  "Euro-Techno",
+  "Ambient",
+  "Trip-Hop",
+  "Vocal",
+  "Jazz+Funk",
+  "Fusion",
+  "Trance",
+  "Classical",
+  "Instrumental",
+  "Acid",
+  "House",
+  "Game",
+  "Sound Clip",
+  "Gospel",
+  "Noise",
+  "AlternRock",
+  "Bass",
+  "Soul",
+  "Punk",
+  "Space",
+  "Meditative",
+  "Instrumental Pop",
+  "Instrumental Rock",
+  "Ethnic",
+  "Gothic",
+  "Darkwave",
+  "Techno-Industrial",
+  "Electronic",
+  "Pop-Folk",
+  "Eurodance",
+  "Dream",
+  "Southern Rock",
+  "Comedy",
+  "Cult",
+  "Gangsta",
+  "Top 40",
+  "Christian Rap",
+  "Pop/Funk",
+  "Jungle",
+  "Native American",
+  "Cabaret",
+  "New Wave",
+  "Psychedelic",
+  "Rave",
+  "Showtunes",
+  "Trailer",
+  "Lo-Fi",
+  "Tribal",
+  "Acid Punk",
+  "Acid Jazz",
+  "Polka",
+  "Retro",
+  "Musical",
+  "Rock & Roll",
+  "Hard Rock"
+];
+function readSynchsafeUInt32(bytes, offset) {
+  return (bytes[offset] & 127) << 21 | (bytes[offset + 1] & 127) << 14 | (bytes[offset + 2] & 127) << 7 | bytes[offset + 3] & 127;
+}
+function readUInt32BE(bytes, offset) {
+  return (bytes[offset] << 24 | bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3]) >>> 0;
+}
+function decodeId3Text(frameBytes) {
+  if (frameBytes.length === 0) return "";
+  const encodingByte = frameBytes[0];
+  const content = frameBytes.subarray(1);
+  let out = "";
+  if (encodingByte === 3) {
+    out = Buffer.from(content).toString("utf8");
+  } else if (encodingByte === 1 || encodingByte === 2) {
+    let little = encodingByte === 1;
+    let start = 0;
+    if (encodingByte === 1 && content.length >= 2) {
+      if (content[0] === 255 && content[1] === 254) {
+        little = true;
+        start = 2;
+      } else if (content[0] === 254 && content[1] === 255) {
+        little = false;
+        start = 2;
+      }
+    }
+    for (let i = start; i + 1 < content.length; i += 2) {
+      const code = little ? content[i] | content[i + 1] << 8 : content[i] << 8 | content[i + 1];
+      if (code === 0) break;
+      out += String.fromCharCode(code);
+    }
+  } else {
+    for (const b of content) {
+      if (b === 0) break;
+      out += String.fromCharCode(b);
+    }
+  }
+  return out.replace(/\0+$/, "").trim();
+}
+function readId3v2(bytes) {
+  if (bytes.length < 10 || bytes[0] !== 73 || bytes[1] !== 68 || bytes[2] !== 51) return null;
+  const majorVersion = bytes[3];
+  const revision = bytes[4];
+  const tagSize = readSynchsafeUInt32(bytes, 6);
+  const version = `ID3v2.${majorVersion}.${revision}`;
+  if (majorVersion !== 3 && majorVersion !== 4) {
+    return { version, frames: {}, frameCount: 0 };
+  }
+  const frames = {};
+  let offset = 10;
+  const end = Math.min(10 + tagSize, bytes.length);
+  let frameCount = 0;
+  while (offset + 10 <= end) {
+    const frameId = String.fromCharCode(bytes[offset], bytes[offset + 1], bytes[offset + 2], bytes[offset + 3]);
+    if (frameId === "\0\0\0\0") break;
+    const frameSize = majorVersion === 4 ? readSynchsafeUInt32(bytes, offset + 4) : readUInt32BE(bytes, offset + 4);
+    const frameStart = offset + 10;
+    if (frameSize <= 0 || frameStart + frameSize > bytes.length) break;
+    const frameBytes = bytes.subarray(frameStart, frameStart + frameSize);
+    if (frameId[0] === "T" && frameId !== "TXXX") {
+      frames[frameId] = decodeId3Text(frameBytes);
+    } else if (frameId === "COMM" && frameBytes.length > 4) {
+      const rebuilt = new Uint8Array(frameBytes.length - 3);
+      rebuilt[0] = frameBytes[0];
+      rebuilt.set(frameBytes.subarray(4), 1);
+      const decoded = decodeId3Text(rebuilt);
+      const parts = decoded.split("\0");
+      frames["COMM"] = (parts[parts.length - 1] || decoded).trim();
+    }
+    frameCount++;
+    offset = frameStart + frameSize;
+  }
+  return { version, frames, frameCount };
+}
+function readId3v1(bytes) {
+  if (bytes.length < 128) return null;
+  const start = bytes.length - 128;
+  if (String.fromCharCode(bytes[start], bytes[start + 1], bytes[start + 2]) !== "TAG") return null;
+  const readField = (offset, length) => {
+    let s = "";
+    for (let i = 0; i < length; i++) {
+      const b = bytes[start + offset + i];
+      if (b === 0) break;
+      s += String.fromCharCode(b);
+    }
+    return s.trim();
+  };
+  const title = readField(3, 30);
+  const artist = readField(33, 30);
+  const album = readField(63, 30);
+  const year = readField(93, 4);
+  const isV11 = bytes[start + 125] === 0 && bytes[start + 126] !== 0;
+  const comment = readField(97, isV11 ? 28 : 30);
+  const genreIndex = bytes[start + 127];
+  const genre = ID3V1_GENRES[genreIndex] ?? `Unknown (${genreIndex})`;
+  const result = { genre };
+  if (title) result.title = title;
+  if (artist) result.artist = artist;
+  if (album) result.album = album;
+  if (year) result.year = year;
+  if (comment) result.comment = comment;
+  if (isV11) result.trackNumber = String(bytes[start + 126]);
+  return result;
+}
+function readId3Tags(bytes) {
+  const v2 = readId3v2(bytes);
+  const v1 = readId3v1(bytes);
+  if (v2 && Object.keys(v2.frames).length > 0) {
+    const f = v2.frames;
+    const result = { version: v2.version, frameCount: v2.frameCount };
+    if (f["TIT2"]) result.title = f["TIT2"];
+    if (f["TPE1"]) result.artist = f["TPE1"];
+    if (f["TALB"]) result.album = f["TALB"];
+    const year = f["TYER"] || f["TDRC"];
+    if (year) result.year = year;
+    if (f["TCON"]) result.genre = f["TCON"];
+    if (f["COMM"]) result.comment = f["COMM"];
+    if (f["TRCK"]) result.trackNumber = f["TRCK"];
+    return result;
+  }
+  if (v1) {
+    return { version: v1.trackNumber !== void 0 ? "ID3v1.1" : "ID3v1", ...v1 };
+  }
+  if (v2) {
+    return { error: `Unsupported ID3 tag version: ${v2.version} (only ID3v2.3, ID3v2.4, and ID3v1/1.1 are supported)` };
+  }
+  return { error: "No ID3v1 or ID3v2.3/2.4 tags found in this file" };
+}
 
 exports.readExifData = readExifData;
+exports.readId3Tags = readId3Tags;
 exports.readImageInfo = readImageInfo;
 exports.readPdfMetadata = readPdfMetadata;
+exports.readWavInfo = readWavInfo;

package/dist/tools/media.d.cts

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

package/dist/tools/media.d.ts

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

package/dist/tools/media.js

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