taglib-wasm 0.3.3 → 0.3.9

package/dist/index.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Main module exports for taglib-wasm
+ *
+ * TagLib v2.1 compiled to WebAssembly with TypeScript bindings
+ * for universal audio metadata handling across all JavaScript runtimes.
+ *
+ * @module taglib-wasm
+ *
+ * @example
+ * ```typescript
+ * // Using the Core API
+ * import { TagLib } from "taglib-wasm";
+ *
+ * const taglib = await TagLib.initialize();
+ * const file = await taglib.open(audioBuffer);
+ * const tag = file.tag();
+ * console.log(tag.title);
+ * file.dispose();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using the Simple API
+ * import { readTags, applyTags } from "taglib-wasm";
+ *
+ * const tags = await readTags("song.mp3");
+ * console.log(tags.artist);
+ *
+ * const modified = await applyTags("song.mp3", {
+ *   artist: "New Artist",
+ *   album: "New Album"
+ * });
+ * ```
+ */
+/**
+ * Core API exports for advanced usage with full control.
+ * @see {@link TagLib} - Main TagLib class
+ * @see {@link AudioFile} - Audio file interface
+ * @see {@link createTagLib} - Factory function for creating TagLib instances
+ */
+export { AudioFileImpl as AudioFile, createTagLib, TagLib, } from "./src/taglib.ts";
+/**
+ * Error types for proper error handling and debugging.
+ * @see {@link TagLibError} - Base error class for all TagLib errors
+ * @see {@link TagLibInitializationError} - Wasm initialization failures
+ * @see {@link InvalidFormatError} - Invalid or corrupted file format
+ * @see {@link UnsupportedFormatError} - Valid but unsupported format
+ * @see {@link FileOperationError} - File read/write/save failures
+ * @see {@link MetadataError} - Tag reading/writing failures
+ * @see {@link MemoryError} - Wasm memory allocation issues
+ * @see {@link EnvironmentError} - Runtime/environment issues
+ */
+export { EnvironmentError, FileOperationError, InvalidFormatError, isEnvironmentError, isFileOperationError, isInvalidFormatError, isMemoryError, isMetadataError, isTagLibError, isUnsupportedFormatError, MemoryError, MetadataError, SUPPORTED_FORMATS, TagLibError, TagLibInitializationError, UnsupportedFormatError, } from "./src/errors.ts";
+/**
+ * Simple API exports for easy tag reading and writing.
+ * @see {@link readTags} - Read metadata from audio files
+ * @see {@link applyTags} - Apply metadata changes and return modified buffer
+ * @see {@link updateTags} - Update metadata and save to disk
+ * @see {@link writeTags} - Deprecated alias for applyTags
+ * @see {@link readProperties} - Read audio properties
+ * @see {@link readPictures} - Read cover art/pictures
+ * @see {@link applyPictures} - Apply pictures to audio files
+ * @see {@link getCoverArt} - Get primary cover art data
+ * @see {@link setCoverArt} - Set primary cover art
+ */
+export { readProperties, readTags, applyTags, updateTags, writeTags, // Deprecated but exported for backward compatibility
+readPictures, applyPictures, addPicture, clearPictures, getCoverArt, setCoverArt, findPictureByType, replacePictureByType, getPictureMetadata, isValidAudioFile, getFormat, clearTags } from "./src/simple.ts";
+/**
+ * Constants and utilities for tag name validation.
+ * @see {@link Tags} - Standard tag name constants
+ * @see {@link FormatMappings} - Format-specific field mappings
+ * @see {@link isValidTagName} - Validate tag names
+ * @see {@link getAllTagNames} - Get all valid tag names
+ */
+export { FormatMappings, getAllTagNames, isValidTagName, Tags, } from "./src/constants.ts";
+/**
+ * File I/O utilities for cover art operations.
+ * @see {@link exportCoverArt} - Export cover art to file
+ * @see {@link importCoverArt} - Import cover art from file
+ * @see {@link copyCoverArt} - Copy cover art between files
+ */
+export { exportCoverArt, exportPictureByType, exportAllPictures, importCoverArt, importPictureWithType, loadPictureFromFile, savePictureToFile, copyCoverArt, findCoverArtFiles } from "./src/file-utils.ts";
+/**
+ * Web browser utilities for cover art operations.
+ * @see {@link pictureToDataURL} - Convert picture to data URL
+ * @see {@link setCoverArtFromCanvas} - Set cover art from HTML canvas
+ * @see {@link displayPicture} - Display picture in HTML img element
+ */
+export { pictureToDataURL, dataURLToPicture, setCoverArtFromCanvas, canvasToPicture, imageFileToPicture, displayPicture, createPictureDownloadURL, createPictureGallery } from "./src/web-utils.ts";
+/**
+ * Type exports for TypeScript users.
+ * These types define the structure of metadata, audio properties,
+ * and configuration options used throughout the library.
+ *
+ * @see {@link Tag} - Basic metadata structure
+ * @see {@link ExtendedTag} - Extended metadata with advanced fields
+ * @see {@link AudioProperties} - Audio technical properties
+ * @see {@link TagLibConfig} - Configuration options
+ */
+export type { AudioFormat, AudioProperties, ExtendedTag, FieldMapping, FileType, Picture, PropertyMap, Tag, TagLibConfig, TagName, } from "./src/types.ts";
+/**
+ * Enum exports
+ */
+export { PictureType } from "./src/types.ts";
+/**
+ * Wasm module types for advanced usage.
+ * @see {@link TagLibModule} - Full TagLib Wasm module interface
+ * @see {@link WasmModule} - Base Emscripten module interface
+ */
+export type { TagLibModule, WasmModule } from "./src/wasm.ts";
+import type { TagLibModule } from "./src/wasm.ts";
+/**
+ * Load the TagLib Wasm module.
+ * This function initializes the WebAssembly module and returns
+ * the loaded module for use with the Core API.
+ *
+ * @returns Promise resolving to the initialized TagLib module
+ *
+ * @example
+ * ```typescript
+ * import { loadTagLibModule, createTagLib } from "taglib-wasm";
+ *
+ * // Manual module loading for advanced configuration
+ * const module = await loadTagLibModule();
+ * const taglib = await createTagLib(module);
+ * ```
+ *
+ * @note Most users should use `TagLib.initialize()` instead,
+ * which handles module loading automatically.
+ */
+export declare function loadTagLibModule(): Promise<TagLibModule>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;;GAKG;AACH,OAAO,EACL,aAAa,IAAI,SAAS,EAC1B,YAAY,EACZ,MAAM,GACP,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;GAUG;AACH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,OAAO,EACL,cAAc,EACd,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EAAG,qDAAqD;AACjE,YAAY,EACZ,aAAa,EACb,UAAU,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB;;;;;;GAMG;AACH,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,IAAI,GACL,MAAM,oBAAoB,CAAC;AAC5B;;;;;GAKG;AACH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AACH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;GASG;AACH,YAAY,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,WAAW,EACX,GAAG,EACH,YAAY,EACZ,OAAO,GACR,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AACH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAK9D"}

package/dist/index.js

@@ -0,0 +1,137 @@
+// index.ts
+import {
+  AudioFileImpl,
+  createTagLib,
+  TagLib
+} from "./src/taglib.ts";
+import {
+  EnvironmentError,
+  FileOperationError,
+  InvalidFormatError,
+  isEnvironmentError,
+  isFileOperationError,
+  isInvalidFormatError,
+  isMemoryError,
+  isMetadataError,
+  isTagLibError,
+  isUnsupportedFormatError,
+  MemoryError,
+  MetadataError,
+  SUPPORTED_FORMATS,
+  TagLibError,
+  TagLibInitializationError,
+  UnsupportedFormatError
+} from "./src/errors.ts";
+import {
+  readProperties,
+  readTags,
+  applyTags,
+  updateTags,
+  writeTags,
+  readPictures,
+  applyPictures,
+  addPicture,
+  clearPictures,
+  getCoverArt,
+  setCoverArt,
+  findPictureByType,
+  replacePictureByType,
+  getPictureMetadata,
+  isValidAudioFile,
+  getFormat,
+  clearTags
+} from "./src/simple.ts";
+import {
+  FormatMappings,
+  getAllTagNames,
+  isValidTagName,
+  Tags
+} from "./src/constants.ts";
+import {
+  exportCoverArt,
+  exportPictureByType,
+  exportAllPictures,
+  importCoverArt,
+  importPictureWithType,
+  loadPictureFromFile,
+  savePictureToFile,
+  copyCoverArt,
+  findCoverArtFiles
+} from "./src/file-utils.ts";
+import {
+  pictureToDataURL,
+  dataURLToPicture,
+  setCoverArtFromCanvas,
+  canvasToPicture,
+  imageFileToPicture,
+  displayPicture,
+  createPictureDownloadURL,
+  createPictureGallery
+} from "./src/web-utils.ts";
+import { PictureType } from "./src/types.ts";
+async function loadTagLibModule() {
+  const { default: createTagLibModule } = await import("./build/taglib-wrapper.js");
+  const module = await createTagLibModule();
+  return module;
+}
+export {
+  AudioFileImpl as AudioFile,
+  EnvironmentError,
+  FileOperationError,
+  FormatMappings,
+  InvalidFormatError,
+  MemoryError,
+  MetadataError,
+  PictureType,
+  SUPPORTED_FORMATS,
+  TagLib,
+  TagLibError,
+  TagLibInitializationError,
+  Tags,
+  UnsupportedFormatError,
+  addPicture,
+  applyPictures,
+  applyTags,
+  canvasToPicture,
+  clearPictures,
+  clearTags,
+  copyCoverArt,
+  createPictureDownloadURL,
+  createPictureGallery,
+  createTagLib,
+  dataURLToPicture,
+  displayPicture,
+  exportAllPictures,
+  exportCoverArt,
+  exportPictureByType,
+  findCoverArtFiles,
+  findPictureByType,
+  getAllTagNames,
+  getCoverArt,
+  getFormat,
+  getPictureMetadata,
+  imageFileToPicture,
+  importCoverArt,
+  importPictureWithType,
+  isEnvironmentError,
+  isFileOperationError,
+  isInvalidFormatError,
+  isMemoryError,
+  isMetadataError,
+  isTagLibError,
+  isUnsupportedFormatError,
+  isValidAudioFile,
+  isValidTagName,
+  loadPictureFromFile,
+  loadTagLibModule,
+  pictureToDataURL,
+  readPictures,
+  readProperties,
+  readTags,
+  replacePictureByType,
+  savePictureToFile,
+  setCoverArt,
+  setCoverArtFromCanvas,
+  updateTags,
+  writeTags
+};

package/dist/index.ts

@@ -0,0 +1,220 @@
+/**
+ * @fileoverview Main module exports for taglib-wasm
+ *
+ * TagLib v2.1 compiled to WebAssembly with TypeScript bindings
+ * for universal audio metadata handling across all JavaScript runtimes.
+ *
+ * @module taglib-wasm
+ *
+ * @example
+ * ```typescript
+ * // Using the Core API
+ * import { TagLib } from "taglib-wasm";
+ *
+ * const taglib = await TagLib.initialize();
+ * const file = await taglib.open(audioBuffer);
+ * const tag = file.tag();
+ * console.log(tag.title);
+ * file.dispose();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using the Simple API
+ * import { readTags, applyTags } from "taglib-wasm";
+ *
+ * const tags = await readTags("song.mp3");
+ * console.log(tags.artist);
+ *
+ * const modified = await applyTags("song.mp3", {
+ *   artist: "New Artist",
+ *   album: "New Album"
+ * });
+ * ```
+ */
+
+/**
+ * Core API exports for advanced usage with full control.
+ * @see {@link TagLib} - Main TagLib class
+ * @see {@link AudioFile} - Audio file interface
+ * @see {@link createTagLib} - Factory function for creating TagLib instances
+ */
+export {
+  AudioFileImpl as AudioFile,
+  createTagLib,
+  TagLib,
+} from "./src/taglib.ts";
+
+/**
+ * Error types for proper error handling and debugging.
+ * @see {@link TagLibError} - Base error class for all TagLib errors
+ * @see {@link TagLibInitializationError} - Wasm initialization failures
+ * @see {@link InvalidFormatError} - Invalid or corrupted file format
+ * @see {@link UnsupportedFormatError} - Valid but unsupported format
+ * @see {@link FileOperationError} - File read/write/save failures
+ * @see {@link MetadataError} - Tag reading/writing failures
+ * @see {@link MemoryError} - Wasm memory allocation issues
+ * @see {@link EnvironmentError} - Runtime/environment issues
+ */
+export {
+  EnvironmentError,
+  FileOperationError,
+  InvalidFormatError,
+  isEnvironmentError,
+  isFileOperationError,
+  isInvalidFormatError,
+  isMemoryError,
+  isMetadataError,
+  isTagLibError,
+  isUnsupportedFormatError,
+  MemoryError,
+  MetadataError,
+  SUPPORTED_FORMATS,
+  TagLibError,
+  TagLibInitializationError,
+  UnsupportedFormatError,
+} from "./src/errors.ts";
+
+/**
+ * Simple API exports for easy tag reading and writing.
+ * @see {@link readTags} - Read metadata from audio files
+ * @see {@link applyTags} - Apply metadata changes and return modified buffer
+ * @see {@link updateTags} - Update metadata and save to disk
+ * @see {@link writeTags} - Deprecated alias for applyTags
+ * @see {@link readProperties} - Read audio properties
+ * @see {@link readPictures} - Read cover art/pictures
+ * @see {@link applyPictures} - Apply pictures to audio files
+ * @see {@link getCoverArt} - Get primary cover art data
+ * @see {@link setCoverArt} - Set primary cover art
+ */
+export { 
+  readProperties, 
+  readTags, 
+  applyTags,
+  updateTags,
+  writeTags,  // Deprecated but exported for backward compatibility
+  readPictures,
+  applyPictures,
+  addPicture,
+  clearPictures,
+  getCoverArt,
+  setCoverArt,
+  findPictureByType,
+  replacePictureByType,
+  getPictureMetadata,
+  isValidAudioFile,
+  getFormat,
+  clearTags
+} from "./src/simple.ts";
+
+/**
+ * Constants and utilities for tag name validation.
+ * @see {@link Tags} - Standard tag name constants
+ * @see {@link FormatMappings} - Format-specific field mappings
+ * @see {@link isValidTagName} - Validate tag names
+ * @see {@link getAllTagNames} - Get all valid tag names
+ */
+export {
+  FormatMappings,
+  getAllTagNames,
+  isValidTagName,
+  Tags,
+} from "./src/constants.ts";
+/**
+ * File I/O utilities for cover art operations.
+ * @see {@link exportCoverArt} - Export cover art to file
+ * @see {@link importCoverArt} - Import cover art from file
+ * @see {@link copyCoverArt} - Copy cover art between files
+ */
+export {
+  exportCoverArt,
+  exportPictureByType,
+  exportAllPictures,
+  importCoverArt,
+  importPictureWithType,
+  loadPictureFromFile,
+  savePictureToFile,
+  copyCoverArt,
+  findCoverArtFiles
+} from "./src/file-utils.ts";
+
+/**
+ * Web browser utilities for cover art operations.
+ * @see {@link pictureToDataURL} - Convert picture to data URL
+ * @see {@link setCoverArtFromCanvas} - Set cover art from HTML canvas
+ * @see {@link displayPicture} - Display picture in HTML img element
+ */
+export {
+  pictureToDataURL,
+  dataURLToPicture,
+  setCoverArtFromCanvas,
+  canvasToPicture,
+  imageFileToPicture,
+  displayPicture,
+  createPictureDownloadURL,
+  createPictureGallery
+} from "./src/web-utils.ts";
+
+/**
+ * Type exports for TypeScript users.
+ * These types define the structure of metadata, audio properties,
+ * and configuration options used throughout the library.
+ *
+ * @see {@link Tag} - Basic metadata structure
+ * @see {@link ExtendedTag} - Extended metadata with advanced fields
+ * @see {@link AudioProperties} - Audio technical properties
+ * @see {@link TagLibConfig} - Configuration options
+ */
+export type {
+  AudioFormat,
+  AudioProperties,
+  ExtendedTag,
+  FieldMapping,
+  FileType,
+  Picture,
+  PropertyMap,
+  Tag,
+  TagLibConfig,
+  TagName,
+} from "./src/types.ts";
+
+/**
+ * Enum exports
+ */
+export { PictureType } from "./src/types.ts";
+
+/**
+ * Wasm module types for advanced usage.
+ * @see {@link TagLibModule} - Full TagLib Wasm module interface
+ * @see {@link WasmModule} - Base Emscripten module interface
+ */
+export type { TagLibModule, WasmModule } from "./src/wasm.ts";
+
+// Import the type for use in this file
+import type { TagLibModule } from "./src/wasm.ts";
+
+/**
+ * Load the TagLib Wasm module.
+ * This function initializes the WebAssembly module and returns
+ * the loaded module for use with the Core API.
+ *
+ * @returns Promise resolving to the initialized TagLib module
+ *
+ * @example
+ * ```typescript
+ * import { loadTagLibModule, createTagLib } from "taglib-wasm";
+ *
+ * // Manual module loading for advanced configuration
+ * const module = await loadTagLibModule();
+ * const taglib = await createTagLib(module);
+ * ```
+ *
+ * @note Most users should use `TagLib.initialize()` instead,
+ * which handles module loading automatically.
+ */
+export async function loadTagLibModule(): Promise<TagLibModule> {
+  // Now that we're using ES6 modules, we can use dynamic import directly
+  const { default: createTagLibModule } = await import("./build/taglib-wrapper.js");
+  const module = await createTagLibModule();
+  return module as TagLibModule;
+}

package/dist/src/constants.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Standard tag property names used by TagLib.
+ * These constants provide type-safe access to tag properties with IDE autocomplete.
+ *
+ * @example
+ * ```typescript
+ * import { Tags } from 'taglib-wasm';
+ *
+ * // Read tags
+ * const title = file.tag.properties.get(Tags.Title);
+ * const artist = file.tag.properties.get(Tags.Artist);
+ *
+ * // Write tags
+ * file.tag.properties.set(Tags.Album, "Dark Side of the Moon");
+ * file.tag.properties.set(Tags.Year, "1973");
+ * ```
+ */
+export declare const Tags: {
+    /** Track/song title */
+    readonly Title: "TITLE";
+    /** Primary performer(s) */
+    readonly Artist: "ARTIST";
+    /** Album/collection name */
+    readonly Album: "ALBUM";
+    /** Date of recording (year) */
+    readonly Date: "DATE";
+    /** Track number on album */
+    readonly TrackNumber: "TRACKNUMBER";
+    /** Musical genre */
+    readonly Genre: "GENRE";
+    /** Comments/notes */
+    readonly Comment: "COMMENT";
+    /** Band/orchestra/ensemble */
+    readonly AlbumArtist: "ALBUMARTIST";
+    /** Original composer(s) */
+    readonly Composer: "COMPOSER";
+    /** Copyright information */
+    readonly Copyright: "COPYRIGHT";
+    /** Encoding software/person */
+    readonly EncodedBy: "ENCODEDBY";
+    /** Disc number for multi-disc sets */
+    readonly DiscNumber: "DISCNUMBER";
+    /** Beats per minute */
+    readonly Bpm: "BPM";
+    /** Lyrics/text writer(s) */
+    readonly Lyricist: "LYRICIST";
+    /** Conductor */
+    readonly Conductor: "CONDUCTOR";
+    /** Person who remixed */
+    readonly Remixer: "REMIXEDBY";
+    /** Language of vocals/lyrics */
+    readonly Language: "LANGUAGE";
+    /** Publisher */
+    readonly Publisher: "PUBLISHER";
+    /** Mood/atmosphere */
+    readonly Mood: "MOOD";
+    /** Media type (CD, vinyl, etc.) */
+    readonly Media: "MEDIA";
+    /** Radio station owner */
+    readonly RadioStationOwner: "RADIOSTATIONOWNER";
+    /** Producer */
+    readonly Producer: "PRODUCER";
+    /** Album subtitle */
+    readonly Subtitle: "SUBTITLE";
+    /** Release label */
+    readonly Label: "LABEL";
+    /** Sort name for title */
+    readonly TitleSort: "TITLESORT";
+    /** Sort name for artist */
+    readonly ArtistSort: "ARTISTSORT";
+    /** Sort name for album artist */
+    readonly AlbumArtistSort: "ALBUMARTISTSORT";
+    /** Sort name for album */
+    readonly AlbumSort: "ALBUMSORT";
+    /** Sort name for composer */
+    readonly ComposerSort: "COMPOSERSORT";
+    /** International Standard Recording Code */
+    readonly Isrc: "ISRC";
+    /** Amazon Standard Identification Number */
+    readonly Asin: "ASIN";
+    /** Catalog number */
+    readonly CatalogNumber: "CATALOGNUMBER";
+    /** Barcode (EAN/UPC) */
+    readonly Barcode: "BARCODE";
+    /** MusicBrainz Artist ID */
+    readonly MusicBrainzArtistId: "MUSICBRAINZ_ARTISTID";
+    /** MusicBrainz Release Artist ID */
+    readonly MusicBrainzReleaseArtistId: "MUSICBRAINZ_ALBUMARTISTID";
+    /** MusicBrainz Work ID */
+    readonly MusicBrainzWorkId: "MUSICBRAINZ_WORKID";
+    /** MusicBrainz Release ID */
+    readonly MusicBrainzReleaseId: "MUSICBRAINZ_ALBUMID";
+    /** MusicBrainz Recording ID */
+    readonly MusicBrainzRecordingId: "MUSICBRAINZ_TRACKID";
+    /** MusicBrainz Track ID (deprecated, use RecordingId) */
+    readonly MusicBrainzTrackId: "MUSICBRAINZ_TRACKID";
+    /** MusicBrainz Release Group ID */
+    readonly MusicBrainzReleaseGroupId: "MUSICBRAINZ_RELEASEGROUPID";
+    /** MusicBrainz Release Track ID */
+    readonly MusicBrainzReleaseTrackId: "MUSICBRAINZ_RELEASETRACKID";
+    /** Podcast identifier */
+    readonly PodcastId: "PODCASTID";
+    /** Podcast URL */
+    readonly PodcastUrl: "PODCASTURL";
+    /** Content group/work */
+    readonly Grouping: "GROUPING";
+    /** Work name */
+    readonly Work: "WORK";
+    /** Lyrics content */
+    readonly Lyrics: "LYRICS";
+    /** Album gain (ReplayGain) */
+    readonly AlbumGain: "REPLAYGAIN_ALBUM_GAIN";
+    /** Album peak (ReplayGain) */
+    readonly AlbumPeak: "REPLAYGAIN_ALBUM_PEAK";
+    /** Track gain (ReplayGain) */
+    readonly TrackGain: "REPLAYGAIN_TRACK_GAIN";
+    /** Track peak (ReplayGain) */
+    readonly TrackPeak: "REPLAYGAIN_TRACK_PEAK";
+    /** Original artist for covers */
+    readonly OriginalArtist: "ORIGINALARTIST";
+    /** Original album */
+    readonly OriginalAlbum: "ORIGINALALBUM";
+    /** Original release date */
+    readonly OriginalDate: "ORIGINALDATE";
+    /** Script/writing system */
+    readonly Script: "SCRIPT";
+    /** Involved people list */
+    readonly InvolvedPeopleList: "INVOLVEDPEOPLELIST";
+    /** Encoder settings/software */
+    readonly EncoderSettings: "ENCODERSETTINGS";
+    /** Source media */
+    readonly SourceMedia: "SOURCEMEDIA";
+};
+/**
+ * Type representing all valid tag property names
+ */
+export type TagName = typeof Tags[keyof typeof Tags];
+/**
+ * Type guard to check if a string is a valid tag name
+ */
+export declare function isValidTagName(name: string): name is TagName;
+/**
+ * Get all available tag names as an array
+ */
+export declare function getAllTagNames(): readonly TagName[];
+/**
+ * Format-specific tag mappings (for reference only - TagLib handles these automatically)
+ * This shows how standard property names map to format-specific identifiers.
+ */
+export declare const FormatMappings: {
+    readonly Title: {
+        readonly id3v2: "TIT2";
+        readonly mp4: "©nam";
+        readonly vorbis: "TITLE";
+        readonly ape: "Title";
+        readonly riff: "INAM";
+    };
+    readonly Artist: {
+        readonly id3v2: "TPE1";
+        readonly mp4: "©ART";
+        readonly vorbis: "ARTIST";
+        readonly ape: "Artist";
+        readonly riff: "IART";
+    };
+    readonly Album: {
+        readonly id3v2: "TALB";
+        readonly mp4: "©alb";
+        readonly vorbis: "ALBUM";
+        readonly ape: "Album";
+        readonly riff: "IPRD";
+    };
+    readonly Date: {
+        readonly id3v2: "TDRC";
+        readonly mp4: "©day";
+        readonly vorbis: "DATE";
+        readonly ape: "Year";
+        readonly riff: "ICRD";
+    };
+    readonly Genre: {
+        readonly id3v2: "TCON";
+        readonly mp4: "©gen";
+        readonly vorbis: "GENRE";
+        readonly ape: "Genre";
+        readonly riff: "IGNR";
+    };
+    readonly Comment: {
+        readonly id3v2: "COMM";
+        readonly mp4: "©cmt";
+        readonly vorbis: "COMMENT";
+        readonly ape: "Comment";
+        readonly riff: "ICMT";
+    };
+    readonly TrackNumber: {
+        readonly id3v2: "TRCK";
+        readonly mp4: "trkn";
+        readonly vorbis: "TRACKNUMBER";
+        readonly ape: "Track";
+        readonly riff: "ITRK";
+    };
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,IAAI;IAEf,uBAAuB;;IAEvB,2BAA2B;;IAE3B,4BAA4B;;IAE5B,+BAA+B;;IAE/B,4BAA4B;;IAE5B,oBAAoB;;IAEpB,qBAAqB;;IAIrB,8BAA8B;;IAE9B,2BAA2B;;IAE3B,4BAA4B;;IAE5B,+BAA+B;;IAE/B,sCAAsC;;IAEtC,uBAAuB;;IAEvB,4BAA4B;;IAE5B,gBAAgB;;IAEhB,yBAAyB;;IAEzB,gCAAgC;;IAEhC,gBAAgB;;IAEhB,sBAAsB;;IAEtB,mCAAmC;;IAEnC,0BAA0B;;IAE1B,eAAe;;IAEf,qBAAqB;;IAErB,oBAAoB;;IAIpB,0BAA0B;;IAE1B,2BAA2B;;IAE3B,iCAAiC;;IAEjC,0BAA0B;;IAE1B,6BAA6B;;IAI7B,4CAA4C;;IAE5C,4CAA4C;;IAE5C,qBAAqB;;IAErB,wBAAwB;;IAIxB,4BAA4B;;IAE5B,oCAAoC;;IAEpC,0BAA0B;;IAE1B,6BAA6B;;IAE7B,+BAA+B;;IAE/B,yDAAyD;;IAEzD,mCAAmC;;IAEnC,mCAAmC;;IAInC,yBAAyB;;IAEzB,kBAAkB;;IAIlB,yBAAyB;;IAEzB,gBAAgB;;IAIhB,qBAAqB;;IAErB,8BAA8B;;IAE9B,8BAA8B;;IAE9B,8BAA8B;;IAE9B,8BAA8B;;IAI9B,iCAAiC;;IAEjC,qBAAqB;;IAErB,4BAA4B;;IAE5B,4BAA4B;;IAE5B,2BAA2B;;IAI3B,gCAAgC;;IAEhC,mBAAmB;;CAEX,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,CAAC;AAErD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,SAAS,OAAO,EAAE,CAEnD;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDjB,CAAC"}