taglib-wasm 0.3.13 → 0.3.15

package/package.json

@@ -1,34 +1,31 @@
 {
   "name": "taglib-wasm",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "description": "TagLib for TypeScript platforms: Deno, Node.js, Bun, Electron, browsers, and Cloudflare Workers",
-  "main": "index.ts",
-  "types": "index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./index.ts",
+      "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
     "./workers": {
-      "types": "./src/workers.ts",
+      "types": "./dist/src/workers.d.ts",
       "default": "./dist/src/workers.js"
     },
     "./simple": {
-      "types": "./src/simple.ts",
+      "types": "./dist/src/simple.d.ts",
       "default": "./dist/src/simple.js"
     }
   },
   "files": [
-    "index.ts",
-    "src/**/*",
     "dist/**/*",
-    "lib/taglib/COPYING*",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "build:wasm": "./build/build-wasm.sh",
-    "build:ts": "tsc && node scripts/build-js.js",
+    "build:ts": "tsc",
     "postbuild": "node scripts/postbuild.js",
     "build": "npm run build:wasm && npm run build:ts && npm run postbuild",
     "test": "deno test --allow-read --allow-write tests/",

package/dist/index.ts

@@ -1,221 +0,0 @@
-/**
- * @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/simple";
- *
- * 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 {
-  addPicture,
-  applyPictures,
-  applyTags,
-  clearPictures,
-  clearTags,
-  findPictureByType,
-  getCoverArt,
-  getFormat,
-  getPictureMetadata,
-  isValidAudioFile,
-  readPictures,
-  readProperties,
-  readTags,
-  replacePictureByType,
-  setCoverArt,
-  updateTags
-} 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 {
-  copyCoverArt,
-  exportAllPictures,
-  exportCoverArt,
-  exportPictureByType,
-  findCoverArtFiles,
-  importCoverArt,
-  importPictureWithType,
-  loadPictureFromFile,
-  savePictureToFile,
-} 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 {
-  canvasToPicture,
-  createPictureDownloadURL,
-  createPictureGallery,
-  dataURLToPicture,
-  displayPicture,
-  imageFileToPicture,
-  pictureToDataURL,
-  setCoverArtFromCanvas,
-} 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.ts

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