taglib-wasm 0.2.8 → 0.3.2

package/README.md

@@ -1,32 +1,52 @@
 # taglib-wasm
 
-This is the Wasm version of [**TagLib**](https://taglib.org/), the most robust, de-facto standard for reading and editing metadata tags (Title, Album, Artist, etc.) in all popular audio formats. `taglib-wasm` exists because the JavaScipt/TypeScipt ecosystem had no battle-tested audio tagging library that supports reading and writing music metadata to all popular audio formats — until now!
-
-`taglib-wasm` stands on the shoulders of giants, including [TagLib](https://taglib.org/) itself, [Emscripten](https://emscripten.org/), and [Wasm](https://webassembly.org/) ([WebAssembly](https://webassembly.org/)).
-
-`taglib-wasm` aspires to be a universal solution for **JavaScript/TypeScript** platforms — Deno, Node.js, Bun, web browsers, and Cloudflare Workers. Note: This project is a baby, and you’re likely to experience some surprises at this stage of its development. I’m extremely motivated to help address them, since I’ll also be depending on this project.
+This is the Wasm version of [**TagLib**](https://taglib.org/), the most robust,
+de-facto standard for reading and editing metadata tags (Title, Album, Artist,
+etc.) in all popular audio formats. `taglib-wasm` exists because the
+JavaScipt/TypeScipt ecosystem had no battle-tested audio tagging library that
+supports reading and writing music metadata to all popular audio formats — until
+now!
+
+`taglib-wasm` stands on the shoulders of giants, including
+[TagLib](https://taglib.org/) itself, [Emscripten](https://emscripten.org/), and
+[Wasm](https://webassembly.org/) ([WebAssembly](https://webassembly.org/)).
+
+`taglib-wasm` aspires to be a universal solution for **JavaScript/TypeScript**
+platforms — Deno, Node.js, Bun, web browsers, and Cloudflare Workers. Note: This
+project is a baby, and you’re likely to experience some surprises at this stage
+of its development. I’m extremely motivated to help address them, since I’ll
+also be depending on this project.
 
 ## 🤔 Why?
 
-Because there’s nothing like it. [`mp3tag.js`](https://mp3tag.js.org/) is mature and active, but only supports MP3 files and ID3 tags. TagLib was an ideal choice from a maturity and capabilities point of view, but wrappers like `node-taglib` appeared to be dormant, and I wanted to avoid making users install platform-specific dependencies whenever possible.
+Because there’s nothing like it. [`mp3tag.js`](https://mp3tag.js.org/) is mature
+and active, but only supports MP3 files and ID3 tags. TagLib was an ideal choice
+from a maturity and capabilities point of view, but wrappers like `node-taglib`
+appeared to be dormant, and I wanted to avoid making users install
+platform-specific dependencies whenever possible.
 
 ## 🎯 Features
 
-- **✅ Universal compatibility** – Works with Deno, Node.js, Bun, web browsers, and Cloudflare Workers
+- **✅ Universal compatibility** – Works with Deno, Node.js, Bun, web browsers,
+  and Cloudflare Workers
 - **✅ TypeScript first** – Complete type definitions and modern API
-- **✅ Full audio format support** – Supports all audio formats supported by TagLib
-- **✅ Format abstraction** – `taglib-wasm` deals with how tags are read from/written to in different file formats
+- **✅ Full audio format support** – Supports all audio formats supported by
+  TagLib
+- **✅ Format abstraction** – `taglib-wasm` deals with how tags are read
+  from/written to in different file formats
 - **✅ Zero dependencies** – Self-contained WASM bundle
 - **✅ Memory efficient** – In-memory processing without filesystem access
-- **✅ Production ready** – Growing test suite helps ensure safety and reliability
-- **🆕 Two API styles** – Choose between Simple (3 functions) or Core (full control) APIs
+- **✅ Production ready** – Growing test suite helps ensure safety and
+  reliability
+- **🆕 Two API styles** – Choose between Simple (3 functions) or Core (full
+  control) APIs
 
 ## 📦 Installation
 
 ### Deno
 
 ```typescript
-import { TagLib } from "jsr:@charleswiltgen/taglib-wasm";
+import { TagLib } from "npm:taglib-wasm";
 ```
 
 ### Node.js
@@ -35,7 +55,19 @@ import { TagLib } from "jsr:@charleswiltgen/taglib-wasm";
 npm install taglib-wasm
 ```
 
-**Note:** The NPM package ships TypeScript source files. Use a TypeScript loader like [`tsx`](https://github.com/privatenumber/tsx):
+The package uses TypeScript. You have two options:
+
+#### Option 1: Use Node’s native TypeScript support
+
+```bash
+# Node.js 22.6.0+ with experimental flag
+node --experimental-strip-types your-script.ts
+
+# Node.js 23.6.0+ (no flag needed)
+node your-script.ts
+```
+
+#### Option 2: TypeScript loader (recommended for production)
 
 ```bash
 npm install --save-dev tsx
@@ -52,16 +84,17 @@ bun add taglib-wasm
 
 ### Simple API
 
-Inspired by [go-taglib](https://github.com/sentriz/go-taglib)’s excellent developer experience:
+This was inspired by [go-taglib](https://github.com/sentriz/go-taglib), a
+similar project for Go created at about the same time.
 
 ```typescript
 import { readProperties, readTags, writeTags } from "taglib-wasm/simple";
 
-// Read tags - just one function call!
+// Read tags
 const tags = await readTags("song.mp3");
 console.log(tags.title, tags.artist, tags.album);
 
-// Write tags - simple as can be
+// Write tags
 await writeTags("song.mp3", {
   title: "New Title",
   artist: "New Artist",
@@ -75,16 +108,16 @@ console.log(`Duration: ${props.length}s, Bitrate: ${props.bitrate} kbps`);
 
 ### Core API
 
-Full control when you need it:
+The Core API provides full control for more advanced applications.
 
 ```typescript
-import { TagLib } from "jsr:@charleswiltgen/taglib-wasm";
+import { TagLib } from "taglib-wasm";
 
 // Initialize taglib-wasm
 const taglib = await TagLib.initialize();
 
 // Load audio file from buffer
-const audioData = await Deno.readFile("song.mp3");
+const audioData = await readFile("song.mp3"); // Node.js/Bun: fs.readFile, Deno: Deno.readFile
 const file = taglib.openFile(audioData);
 
 // Read metadata
@@ -97,23 +130,90 @@ console.log(`Duration: ${props.length}s`);
 console.log(`Bitrate: ${props.bitrate} kbps`);
 
 // Write metadata
-file.setTitle("New Title");
-file.setArtist("New Artist");
-file.setAlbum("New Album");
+const tag = file.tag();
+tag.setTitle("New Title");
+tag.setArtist("New Artist");
+tag.setAlbum("New Album");
 
-console.log("Updated tags:", file.tag());
+// Save changes
+file.save();
 
-// Automatic tag mapping (format-agnostic)
-file.setAcoustidFingerprint("AQADtMmybfGO8NCNEESLnzHyXNOHeHnG...");
-file.setAcoustidId("e7359e88-f1f7-41ed-b9f6-16e58e906997");
-file.setMusicBrainzTrackId("f4d1b6b8-8c1e-4d9a-9f2a-1234567890ab");
+console.log("Updated tags:", file.tag());
 
 // Clean up
 file.dispose();
 ```
 
+### Tag Constants
+
+taglib-wasm provides type-safe tag constants with IDE autocomplete:
+
+```typescript
+import { Tags } from "taglib-wasm";
+
+// Use constants for better type safety and autocomplete
+const properties = file.properties();
+
+// Read properties
+const title = properties[Tags.Title]?.[0];
+const albumArtist = properties[Tags.AlbumArtist]?.[0];
+const musicBrainzId = properties[Tags.MusicBrainzArtistId]?.[0];
+
+// Write properties
+file.setProperties({
+  [Tags.Title]: ["My Song"],
+  [Tags.AlbumArtist]: ["Various Artists"],
+  [Tags.Bpm]: ["128"]
+});
+
+// All constants provide IDE autocomplete
+Tags.Title         // → "TITLE"
+Tags.Artist        // → "ARTIST"
+Tags.AlbumArtist   // → "ALBUMARTIST"
+Tags.TrackGain     // → "REPLAYGAIN_TRACK_GAIN"
+// ... and many more
+```
+
+See [Tag Name Constants](docs/Tag-Name-Constants.md) for the complete list of available tags and format-specific mappings.
+
 ## Platform examples
 
+### Deno
+
+```typescript
+import { TagLib } from "npm:taglib-wasm";
+
+// Initialize taglib-wasm
+const taglib = await TagLib.initialize();
+
+// Load audio file from filesystem
+const audioData = await Deno.readFile("song.mp3");
+const file = taglib.openFile(audioData);
+
+// Read metadata
+const tags = file.tag();
+const props = file.audioProperties();
+
+console.log(`Title: ${tags.title}`);
+console.log(`Artist: ${tags.artist}`);
+console.log(`Duration: ${props.length}s`);
+console.log(`Bitrate: ${props.bitrate} kbps`);
+
+// Write metadata
+const tag = file.tag();
+tag.setTitle("New Title");
+tag.setArtist("New Artist");
+tag.setAlbum("New Album");
+
+// Save changes
+file.save();
+
+console.log("Updated tags:", file.tag());
+
+// Clean up
+file.dispose();
+```
+
 ### Node.js
 
 ```typescript
@@ -137,16 +237,15 @@ console.log(`Duration: ${props.length}s`);
 console.log(`Bitrate: ${props.bitrate} kbps`);
 
 // Write metadata
-file.setTitle("New Title");
-file.setArtist("New Artist");
-file.setAlbum("New Album");
+const tag = file.tag();
+tag.setTitle("New Title");
+tag.setArtist("New Artist");
+tag.setAlbum("New Album");
 
-console.log("Updated tags:", file.tag());
+// Save changes
+file.save();
 
-// Automatic tag mapping (format-agnostic)
-file.setAcoustidFingerprint("AQADtMmybfGO8NCNEESLnzHyXNOHeHnG...");
-file.setAcoustidId("e7359e88-f1f7-41ed-b9f6-16e58e906997");
-file.setMusicBrainzTrackId("f4d1b6b8-8c1e-4d9a-9f2a-1234567890ab");
+console.log("Updated tags:", file.tag());
 
 // Clean up
 file.dispose();
@@ -174,16 +273,15 @@ console.log(`Duration: ${props.length}s`);
 console.log(`Bitrate: ${props.bitrate} kbps`);
 
 // Write metadata
-file.setTitle("New Title");
-file.setArtist("New Artist");
-file.setAlbum("New Album");
+const tag = file.tag();
+tag.setTitle("New Title");
+tag.setArtist("New Artist");
+tag.setAlbum("New Album");
 
-console.log("Updated tags:", file.tag());
+// Save changes
+file.save();
 
-// Automatic tag mapping (format-agnostic)
-file.setAcoustidFingerprint("AQADtMmybfGO8NCNEESLnzHyXNOHeHnG...");
-file.setAcoustidId("e7359e88-f1f7-41ed-b9f6-16e58e906997");
-file.setMusicBrainzTrackId("f4d1b6b8-8c1e-4d9a-9f2a-1234567890ab");
+console.log("Updated tags:", file.tag());
 
 // Clean up
 file.dispose();
@@ -213,16 +311,15 @@ console.log(`Duration: ${props.length}s`);
 console.log(`Bitrate: ${props.bitrate} kbps`);
 
 // Write metadata
-file.setTitle("New Title");
-file.setArtist("New Artist");
-file.setAlbum("New Album");
+const tag = file.tag();
+tag.setTitle("New Title");
+tag.setArtist("New Artist");
+tag.setAlbum("New Album");
 
-console.log("Updated tags:", file.tag());
+// Save changes
+file.save();
 
-// Automatic tag mapping (format-agnostic)
-file.setAcoustidFingerprint("AQADtMmybfGO8NCNEESLnzHyXNOHeHnG...");
-file.setAcoustidId("e7359e88-f1f7-41ed-b9f6-16e58e906997");
-file.setMusicBrainzTrackId("f4d1b6b8-8c1e-4d9a-9f2a-1234567890ab");
+console.log("Updated tags:", file.tag());
 
 // Clean up
 file.dispose();
@@ -237,7 +334,8 @@ export default {
   async fetch(request: Request): Promise<Response> {
     if (request.method === "POST") {
       try {
-        // Initialize taglib-wasm
+        // Initialize taglib-wasm with Workers-specific configuration
+        // See docs/Cloudflare-Workers.md for memory configuration details
         const taglib = await TagLib.initialize({
           memory: { initial: 8 * 1024 * 1024 }, // 8MB for Workers
         });
@@ -287,69 +385,79 @@ export default {
 
 `tag-wasm` is designed to support all formats supported by TagLib:
 
-- ✅ **.m4a (.mp4)** – Standard MPEG-4/AAC metadata for AAC and Apple Lossless audio
+- ✅ **.m4a (.mp4)** – Standard MPEG-4/AAC metadata for AAC and Apple Lossless
+  audio
 - ✅ **.mp3** – ID3v2 and ID3v1 tags
 - ✅ **.flac** – Vorbis comments and audio properties
 - ✅ **.wav** – INFO chunk metadata
-- ✅ **Legacy formats**: Opus, APE, MPC, WavPack, TrueAudio, and more
+- ✅ **Legacy formats** – Opus, APE, MPC, WavPack, TrueAudio, and more
 
-## 🎯 Automatic Tag Mapping
+## 🎯 Extended Metadata with PropertyMap
 
-`taglib-wasm` supports **automatic tag mapping** so you don’t have to worry about how the same tag is stored differently in different audio container formats.
+`taglib-wasm` provides a **PropertyMap API** for accessing extended metadata
+beyond the basic tags. This allows you to read and write format-specific fields
+and custom metadata.
 
 ### AcoustID example
 
 ```typescript
-// Single API works for ALL formats (MP3, FLAC, OGG, MP4)
-file.setAcoustidFingerprint("AQADtMmybfGO8NCNEESLnzHyXNOHeHnG...");
-file.setAcoustidId("e7359e88-f1f7-41ed-b9f6-16e58e906997");
-
-// Automatically stores in format-specific locations:
-// • MP3: TXXX frames with proper descriptions
-// • FLAC/OGG: ACOUSTID_FINGERPRINT and ACOUSTID_ID Vorbis comments
-// • MP4: ----:com.apple.iTunes:Acoustid... freeform atoms
+import { Tags } from "taglib-wasm";
+
+// Using PropertyMap API to set extended metadata with tag constants
+file.setProperty(Tags.AcoustidFingerprint, "AQADtMmybfGO8NCNEESLnzHyXNOHeHnG...");
+file.setProperty(Tags.AcoustidId, "e7359e88-f1f7-41ed-b9f6-16e58e906997");
+
+// Or using string property names
+file.setProperty("ACOUSTID_FINGERPRINT", "AQADtMmybfGO8NCNEESLnzHyXNOHeHnG...");
+
+// Note: Property keys may vary by format
+// Use file.properties() to see all available properties
+file.save(); // Don't forget to save!
 ```
 
 ### MusicBrainz example
 
 ```typescript
-// Professional music database integration
-file.setMusicBrainzTrackId("f4d1b6b8-8c1e-4d9a-9f2a-1234567890ab");
-file.setMusicBrainzReleaseId("a1b2c3d4-e5f6-7890-abcd-ef1234567890");
-file.setMusicBrainzArtistId("12345678-90ab-cdef-1234-567890abcdef");
+// MusicBrainz metadata using PropertyMap with tag constants
+file.setProperty(Tags.MusicBrainzTrackId, "f4d1b6b8-8c1e-4d9a-9f2a-1234567890ab");
+file.setProperty(Tags.MusicBrainzAlbumId, "a1b2c3d4-e5f6-7890-abcd-ef1234567890");
+file.setProperty(
+  Tags.MusicBrainzArtistId,
+  "12345678-90ab-cdef-1234-567890abcdef",
+);
 ```
 
 ### Volume example
 
 ```typescript
-// ReplayGain support (automatic format mapping)
-file.setReplayGainTrackGain("-6.54 dB");
-file.setReplayGainTrackPeak("0.987654");
-file.setReplayGainAlbumGain("-8.12 dB");
-file.setReplayGainAlbumPeak("0.995432");
-
-// Apple Sound Check support
-file.setAppleSoundCheck("00000150 00000150 00000150 00000150...");
+// ReplayGain volume normalization with tag constants
+file.setProperty(Tags.TrackGain, "-6.54 dB");
+file.setProperty(Tags.TrackPeak, "0.987654");
+file.setProperty(Tags.AlbumGain, "-8.12 dB");
+file.setProperty(Tags.AlbumPeak, "0.995432");
 ```
 
 ### Extended fields
 
 ```typescript
-// Advanced metadata fields
-file.setExtendedTag({
-  albumArtist: "Various Artists",
-  composer: "Composer Name",
-  bpm: 120,
-  compilation: true,
-  discNumber: 1,
-  totalTracks: 12,
-  // Volume normalization
-  replayGainTrackGain: "-6.54 dB",
-  appleSoundCheck: "00000150...",
+// Using PropertyMap to set multiple properties at once
+const properties = file.properties(); // Get current properties
+
+// Set extended metadata with tag constants
+file.setProperties({
+  [Tags.AlbumArtist]: ["Various Artists"],
+  [Tags.Composer]: ["Composer Name"],
+  [Tags.Bpm]: ["120"],
+  [Tags.Compilation]: ["1"],
+  [Tags.DiscNumber]: ["1"],
+  [Tags.TrackTotal]: ["12"],
+  // Note: Property keys vary by format
 });
-```
 
-**📖 See [docs/Automatic-Tag-Mapping.md](docs/Automatic-Tag-Mapping.md) for complete documentation**
+// Or set individual properties
+file.setProperty(Tags.AlbumArtist, "Various Artists");
+file.setProperty(Tags.Composer, "Composer Name");
+```
 
 ## 🏗️ Development
 
@@ -384,8 +492,7 @@ build/
 ├── taglib.js       # Generated Emscripten JavaScript
 └── taglib.wasm     # Compiled WebAssembly module
 
-tests/              # Test files and sample audio files
-tests/              # Test suite
+tests/              # Test suite and sample audio files
 examples/           # Usage examples for different runtimes
 ├── deno/           # Deno-specific examples
 ├── bun/            # Bun-specific examples
@@ -412,23 +519,29 @@ npm test
 # ✅ MP3  - ID3v1/v2 tag support
 # ✅ FLAC - Vorbis comments and properties
 # ✅ OGG  - Vorbis comments
-# ✅ M4A  - iTunes-compatible metadata atoms
+# ✅ M4A  - MPEG-4 (AAC and Apple Lossless) metadata
 ```
 
 ## 🔧 Technical Implementation
 
 ### Key architecture decisions
 
-1. **Memory Management**: Uses Emscripten's `allocate()` for reliable JS↔WASM data transfer
-2. **Buffer-Based Processing**: `TagLib::ByteVectorStream` enables in-memory file processing
+1. **Memory Management**: Uses Emscripten's `allocate()` for reliable JS↔WASM
+   data transfer
+2. **Buffer-Based Processing**: `TagLib::ByteVectorStream` enables in-memory
+   file processing
 3. **C++ Wrapper**: Custom C functions bridge TagLib's C++ API to WASM exports
-4. **Type Safety**: Complete TypeScript definitions for all audio formats and metadata
+4. **Type Safety**: Complete TypeScript definitions for all audio formats and
+   metadata
 
 ### Critical implementation details
 
-- **ByteVectorStream**: Enables processing audio files from memory buffers without filesystem
-- **ID-based Object Management**: C++ objects managed via integer IDs for memory safety
-- **Emscripten allocate()**: Ensures proper memory synchronization between JS and WASM
+- **ByteVectorStream**: Enables processing audio files from memory buffers
+  without filesystem
+- **ID-based Object Management**: C++ objects managed via integer IDs for memory
+  safety
+- **Emscripten allocate()**: Ensures proper memory synchronization between JS
+  and WASM
 - **UTF-8 String Handling**: Proper encoding for international metadata
 
 ## 📚 API Reference
@@ -449,98 +562,101 @@ class TagLib {
 class AudioFile {
   // Validation
   isValid(): boolean;
-  format(): string;
+  getFormat(): string;
 
   // Properties
   audioProperties(): AudioProperties;
-  tag(): TagData;
 
-  // Tag Writing
-  setTitle(title: string): void;
-  setArtist(artist: string): void;
-  setAlbum(album: string): void;
-  setComment(comment: string): void;
-  setGenre(genre: string): void;
-  setYear(year: number): void;
-  setTrack(track: number): void;
+  // Tag Access (returns Tag object with getters and setters)
+  tag(): Tag;
+
+  // PropertyMap API for extended metadata
+  properties(): PropertyMap;
+  setProperties(properties: PropertyMap): void;
+  getProperty(key: string): string | undefined;
+  setProperty(key: string, value: string): void;
+
+  // MP4-specific methods
+  isMP4(): boolean;
+  getMP4Item(key: string): string | undefined;
+  setMP4Item(key: string, value: string): void;
+  removeMP4Item(key: string): void;
 
   // File Operations
   save(): boolean;
+  getFileBuffer(): Uint8Array;
   dispose(): void;
-
-  // Automatic Tag Mapping (Format-Agnostic)
-  extendedTag(): ExtendedTag;
-  setExtendedTag(tag: Partial<ExtendedTag>): void;
-
-  // AcoustID Integration
-  setAcoustidFingerprint(fingerprint: string): void;
-  getAcoustidFingerprint(): string | undefined;
-  setAcoustidId(id: string): void;
-  getAcoustidId(): string | undefined;
-
-  // MusicBrainz Integration
-  setMusicBrainzTrackId(id: string): void;
-  getMusicBrainzTrackId(): string | undefined;
-
-  // Volume Normalization
-  setReplayGainTrackGain(gain: string): void;
-  getReplayGainTrackGain(): string | undefined;
-  setReplayGainTrackPeak(peak: string): void;
-  getReplayGainTrackPeak(): string | undefined;
-  setReplayGainAlbumGain(gain: string): void;
-  getReplayGainAlbumGain(): string | undefined;
-  setReplayGainAlbumPeak(peak: string): void;
-  getReplayGainAlbumPeak(): string | undefined;
-  setAppleSoundCheck(iTunNORM: string): void;
-  getAppleSoundCheck(): string | undefined;
 }
 ```
 
-## 🎛️ Configuration
+### Tag interface
 
 ```typescript
-interface TagLibConfig {
-  memory?: {
-    initial?: number; // Initial memory size (default: 16MB)
-    maximum?: number; // Maximum memory size (default: 256MB)
-  };
-  debug?: boolean; // Enable debug output
+interface Tag {
+  // Basic metadata (getters)
+  title: string;
+  artist: string;
+  album: string;
+  comment: string;
+  genre: string;
+  year: number;
+  track: number;
+
+  // Setters
+  setTitle(value: string): void;
+  setArtist(value: string): void;
+  setAlbum(value: string): void;
+  setComment(value: string): void;
+  setGenre(value: string): void;
+  setYear(value: number): void;
+  setTrack(value: number): void;
 }
 ```
 
+### PropertyMap type
+
+```typescript
+type PropertyMap = { [key: string]: string[] };
+```
+
+## 📖 Additional Documentation
+
+- [**Tag Name Constants**](docs/Tag-Name-Constants.md) - Comprehensive reference for standard tag names and cross-format mapping
+- [**Automatic Tag Mapping**](docs/Automatic-Tag-Mapping.md) - How taglib-wasm handles format-specific tag differences
+- [**Implementation Details**](docs/Implementation.md) - Technical details about the Wasm implementation
+- [**Runtime Compatibility**](docs/Runtime-Compatibility.md) - Platform-specific setup and considerations
+
 ## 🌐 Runtime Compatibility
 
-`taglib-wasm` works seamlessly across all major JavaScript runtimes:
+`taglib-wasm` works across all major JavaScript runtimes:
 
-| Runtime     | Status  | Installation                      | Performance | TypeScript |
-| ----------- | ------- | --------------------------------- | ----------- | ---------- |
-| **Deno**    | ✅ Full | `jsr:@charleswiltgen/taglib-wasm` | Excellent   | Native     |
-| **Bun**     | ✅ Full | `bun add taglib-wasm`             | Excellent   | Native     |
-| **Node.js** | ✅ Full | `npm install taglib-wasm`         | Good        | Via loader |
-| **Browser** | ✅ Full | CDN/bundler                       | Good        | Via build  |
+| Runtime     | Status  | Installation              | Performance | TypeScript |
+| ----------- | ------- | ------------------------- | ----------- | ---------- |
+| **Deno**    | ✅ Full | `npm:taglib-wasm`         | Excellent   | Native     |
+| **Bun**     | ✅ Full | `bun add taglib-wasm`     | Excellent   | Native     |
+| **Node.js** | ✅ Full | `npm install taglib-wasm` | Good        | Native/tsx |
+| **Browser** | ✅ Full | CDN/bundler               | Good        | Via build  |
 
-**📖 See [docs/Runtime-Compatibility.md](docs/Runtime-Compatibility.md) for detailed runtime information**
+**📖 See [docs/Runtime-Compatibility.md](docs/Runtime-Compatibility.md) for
+detailed runtime information**
 
 ## 🚧 Known Limitations
 
-- **File Writing**: Saves only affect in-memory representation (no filesystem persistence)
-- **Large Files**: Memory usage scales with file size (entire file loaded into memory)
-- **Concurrent Access**: Not thread-safe (JavaScript single-threaded nature)
+- **File Writing** – Saves only affect in-memory representation (no filesystem
+  persistence)
+- **Large Files** – Memory usage scales with file size (entire file loaded into
+  memory)
+- **Concurrent Access** – Not thread-safe (JavaScript single-threaded nature)
 
 ## 🤝 Contributing
 
-Contributions welcome! Areas of interest:
-
-- Additional format support (DSF, DSDIFF, etc.)
-- Advanced metadata implementation (PropertyMap integration)
-- Performance optimizations
-- Runtime-specific optimizations
-- Documentation improvements
+Contributions welcome!
 
 ## 📄 License
 
 - **This project**: MIT License (see [LICENSE](LICENSE))
-- **TagLib library**: LGPL/MPL dual license (see [lib/taglib/COPYING.LGPL](lib/taglib/COPYING.LGPL))
+- **TagLib library**: LGPL/MPL dual license (see
+  [lib/taglib/COPYING.LGPL](lib/taglib/COPYING.LGPL))
 
 ## 🙏 Acknowledgments