@karaplay/file-coder 1.5.0 → 1.5.2

package/DEMO_ENHANCED.md

@@ -1,168 +1,241 @@
-# ✨ Demo Enhanced with EMK Analysis & Comparison
-
-## 🎯 New Features Added
-
-### 1. **EMK File Analysis** (Before Conversion)
-When you select an EMK file, it now automatically analyzes:
-- ✅ Title and Artist (Thai encoding)
-- ✅ Format type (ZXIO or MThd)
-- ✅ **Original Tempo** (BPM)
-- ✅ **Original Duration** (seconds and minutes)
-- ✅ PPQ (Ticks per beat)
-- ✅ Number of tracks
-- ✅ Number of notes
-- ✅ Lyric and cursor data size
-
-### 2. **Comparison Table** (EMK vs KAR)
-After conversion, see a detailed comparison:
-- 📊 Format changes
-- 📊 Tempo ratio (e.g., 2.78x for ZXIO, 4x for MThd)
-- 📊 Duration changes
-- 📊 Tempo verification (✅ or ⚠️)
-- 📊 Track and note count
-- 📊 Visual indicators for increases/decreases
-
-## 🚀 How to Use
-
-### Step 1: Open Demo
-```
-http://localhost:3000/demo-simple.html
-```
+# Demo Page Enhanced - MIDI Player
 
-### Step 2: Select EMK File
-- Click on any EMK file
-- **Wait for automatic analysis** (1-2 seconds)
-- See original EMK info displayed
+**Date:** 2026-01-13  
+**Version:** v1.5.0 with MIDI Player
 
-### Step 3: Convert to KAR
-- Click "Convert to KAR"
-- Wait for conversion
-- See converted KAR info
+## 🎵 New Feature: MIDI Player
 
-### Step 4: View Comparison Table
-- Automatically displays after conversion
-- Compare original vs converted values
-- Verify tempo ratio is correct
+### Added to `demo-simple.html`
 
-### Step 5: Download & Test
-- Click "Download KAR" to save file
-- Test with external karaoke player
+#### 1. **UI Components**
+- ▶️ **Play Button** - Start MIDI playback
+- ⏸️ **Pause Button** - Pause playback (currently restarts on resume)
+- ⏹️ **Stop Button** - Stop and reset playback
+- **Progress Bar** - Visual playback progress
+- **Time Display** - Current time / Total duration
+- **Status Display** - Shows player state and messages
 
-## 📊 Sample Comparison Table
+#### 2. **Libraries Used**
+```html
+<!-- MIDI Parser -->
+<script src="https://cdn.jsdelivr.net/npm/midi-parser-js@4.0.4/src/main.min.js"></script>
+
+<!-- Soundfont Player for audio synthesis -->
+<script src="https://cdn.jsdelivr.net/npm/soundfont-player@0.12.0/dist/soundfont-player.min.js"></script>
+```
 
+#### 3. **Features**
+- ✅ **Auto-initialize** - Loads instrument on first play
+- ✅ **Parse MIDI** - Converts base64 KAR data to playable MIDI
+- ✅ **Tempo-aware** - Respects MIDI tempo events
+- ✅ **Real-time progress** - Updates every 100ms
+- ✅ **Multi-track support** - Plays all MIDI tracks simultaneously
+- ✅ **Note scheduling** - Uses Web Audio API for precise timing
+- ✅ **Piano soundfont** - Uses Acoustic Grand Piano (MusyngKite)
+
+#### 4. **How It Works**
+
+**Step 1: Initialization**
+```javascript
+await initMidiPlayer();
+// Creates AudioContext
+// Loads soundfont from: https://gleitz.github.io/midi-js-soundfonts/
 ```
-┌──────────────────────┬─────────────────┬─────────────────┬─────────────────┐
-│ Property             │ Original EMK    │ Converted KAR   │ Change          │
-├──────────────────────┼─────────────────┼─────────────────┼─────────────────┤
-│ Format               │ ZXIO            │ ZXIO            │ Same            │
-│ Tempo (BPM)          │ 64.00           │ 178.09          │ ×2.78 (increase)│
-│ Duration (seconds)   │ 351.56          │ 126.34          │ ×0.36 (decrease)│
-│ Duration (minutes)   │ 5.86            │ 2.11            │ 64.1% shorter   │
-│ PPQ                  │ 96              │ Same            │ Unchanged       │
-│ Tracks               │ 25              │ Same + Karaoke  │ +1 (lyrics)     │
-│ Notes                │ 6313            │ 6313            │ Same            │
-│ Tempo Ratio          │ -               │ 2.78x           │ ✅ Correct      │
-└──────────────────────┴─────────────────┴─────────────────┴─────────────────┘
+
+**Step 2: Parse MIDI**
+```javascript
+parseMidiData(base64Data);
+// Decodes base64 → Uint8Array
+// Parses with MidiParser.js
+// Extracts tempo, PPQ, notes
 ```
 
-## 🎯 What to Verify
+**Step 3: Schedule Notes**
+```javascript
+// Converts ticks to seconds
+ticksToSeconds(ticks, tempo, ppq);
+
+// Schedules note events
+instrument.play(midiNote, scheduleTime, options);
+```
 
-### ZXIO Format (001.emk, failed01.emk)
-**Original EMK:**
-- Tempo: 64 BPM
-- Duration: ~5.86 minutes (351 seconds)
+**Step 4: Playback Control**
+```javascript
+playMidi()   // Start playback
+pauseMidi()  // Stop all notes
+stopMidi()   // Reset to beginning
+```
 
-**Converted KAR:**
-- Tempo: **178.09 BPM** (2.78x)
-- Duration: **~2.11 minutes** (126 seconds)
-- Tempo Ratio: ✅ **Correct (2.78x)**
+## 🎯 Usage
 
-### MThd Format (Z2510001.emk)
-**Original EMK:**
-- Tempo: 67 BPM
-- Duration: Variable
+### 1. Convert EMK to KAR
+1. Select an EMK file from the list
+2. Click "🔄 Convert to KAR"
+3. Wait for conversion to complete
 
-**Converted KAR:**
-- Tempo: **268 BPM** (4x)
-- Duration: Adjusted proportionally
-- Tempo Ratio: ✅ **Correct (4x)**
+### 2. Play Converted KAR
+1. After successful conversion, MIDI Player appears
+2. Click "▶️ Play" to start playback
+3. Use "⏸️ Pause" or "⏹️ Stop" to control playback
 
-## 🔍 New API Endpoint
+### 3. Monitor Playback
+- **Progress Bar** - Shows current position
+- **Time Display** - Shows current time / total duration
+- **Status** - Shows player state (Playing, Paused, Stopped)
 
-### POST `/api/analyze-emk`
-Analyze EMK file before conversion
+## 🔧 Technical Details
 
-**Request:**
-```json
-{
-  "filename": "001.emk"
-}
+### MIDI Processing
+
+**Tempo Calculation:**
+```javascript
+microsecondsPerBeat = (data[0] << 16) | (data[1] << 8) | data[2];
 ```
 
-**Response:**
-```json
-{
-  "success": true,
-  "emkInfo": {
-    "format": "ZXIO",
-    "title": "คนกระจอก",
-    "artist": "บุ๊ค ศุภกาญจน์",
-    "tempo": "64.00",
-    "duration": "351.56",
-    "durationMinutes": "5.86",
-    "ppq": 96,
-    "tracks": 25,
-    "notes": 6313,
-    "hasLyrics": 3456,
-    "hasCursor": 3742
-  }
-}
+**Time Conversion:**
+```javascript
+seconds = (ticks × microsecondsPerBeat) / (ppq × 1000000)
 ```
 
-## 📈 Visual Indicators
+**Note Events:**
+- **Type 9 (Note On):** data[0] = note, data[1] = velocity
+- **Type 8 (Note Off):** data[0] = note
+- **Type 255, Meta 81:** Set Tempo event
+
+### Audio Synthesis
+
+**Soundfont:**
+- Source: `https://gleitz.github.io/midi-js-soundfonts/`
+- Format: MusyngKite (high quality)
+- Instrument: Acoustic Grand Piano
+
+**Web Audio API:**
+- Uses `AudioContext` for precise timing
+- Schedules notes in advance
+- Supports dynamic gain (velocity)
 
-### Tempo Ratio Status
-- ✅ **Correct (2.78x)** - ZXIO format with correct tempo
-- ✅ **Correct (~4x)** - MThd format with correct tempo
-- ⚠️ **Unexpected** - Tempo ratio doesn't match expected value
+## 📊 Testing
 
-### Change Indicators
-- 🟡 **Yellow badge** - Increase (tempo, duration)
-- 🟢 **Green badge** - Decrease (expected for ZXIO duration)
-- ⚪ **Gray badge** - Same/Unchanged
+### Test File: `001_original_emk.emk`
+
+**Expected Results:**
+```
+Format:   ZXIO
+Tempo:    79 BPM
+Duration: 4:43 (283 seconds)
+Tracks:   25
+Notes:    6313
+```
 
-## 🎉 Benefits
+**Playback:**
+- ✅ Should play piano notes
+- ✅ Should follow correct tempo (79 BPM)
+- ✅ Should complete in ~4:43
+- ✅ Progress bar should update smoothly
+- ✅ Time display should increment correctly
 
-### For Testing
-1. **Before/After Comparison** - See exact changes from conversion
-2. **Tempo Verification** - Confirm correct ratio is applied
-3. **Duration Accuracy** - Verify music length is correct
-4. **Format Detection** - Ensure ZXIO vs MThd is identified correctly
+## 🐛 Known Limitations
 
-### For Documentation
-1. **Clear Evidence** - Shows conversion works correctly
-2. **Ratio Validation** - Proves 2.78x (ZXIO) and 4x (MThd) formulas
-3. **Quality Assurance** - Demonstrates accurate metadata preservation
+1. **Pause/Resume**
+   - Currently restarts playback from beginning
+   - Full resume from pause position requires state tracking
 
-### For Debugging
-1. **Original Values** - Reference point for troubleshooting
-2. **Detailed Metrics** - Track count, note count, PPQ
-3. **Format Info** - Identify which conversion path was used
+2. **Instrument**
+   - Only uses piano soundfont
+   - Does not respect MIDI program changes (instrument selection)
 
-## 🚀 Ready to Test!
+3. **Performance**
+   - Large MIDI files (>10,000 notes) may cause lag
+   - All notes are scheduled at once
 
-**Server is running at:**
+4. **Browser Support**
+   - Requires Web Audio API support
+   - Tested on Chrome, Firefox, Safari
+
+## 🚀 Future Improvements
+
+1. **Lyrics Display**
+   - Show synchronized lyrics during playback
+   - Highlight current lyric line
+
+2. **Multiple Instruments**
+   - Load different soundfonts per track
+   - Respect MIDI program changes
+
+3. **Better Pause**
+   - Resume from exact pause position
+   - Maintain note states
+
+4. **Visualization**
+   - Piano roll display
+   - Waveform visualization
+   - Spectrum analyzer
+
+5. **Playback Controls**
+   - Speed control (0.5x, 1x, 2x)
+   - Volume control
+   - Seek bar (click to jump)
+
+## 📝 Code Structure
+
+```
+demo-simple.html
+├── UI Components
+│   ├── Play/Pause/Stop buttons
+│   ├── Progress bar
+│   ├── Time display
+│   └── Status panel
+│
+├── MIDI Player Object
+│   ├── ac: AudioContext
+│   ├── instrument: Soundfont instance
+│   ├── midiData: Parsed MIDI
+│   └── State: isPlaying, isPaused, etc.
+│
+└── Functions
+    ├── initMidiPlayer() - Initialize audio
+    ├── parseMidiData() - Parse MIDI from base64
+    ├── playMidi() - Start playback
+    ├── pauseMidi() - Pause playback
+    ├── stopMidi() - Stop playback
+    └── ticksToSeconds() - Convert MIDI ticks to time
 ```
-http://localhost:3000/demo-simple.html
+
+## ✅ Verification
+
+### Server Running
+```bash
+npm run demo
+# Server: http://localhost:3000
+# Demo: http://localhost:3000/demo-simple.html
 ```
 
-**Try it now:**
-1. Select **001.emk** (ZXIO format)
-2. See original info: 64 BPM, 5.86 minutes
-3. Convert to KAR
-4. See comparison: 178.09 BPM, 2.11 minutes
-5. Verify: ✅ Tempo Ratio 2.78x Correct!
+### Test Conversion
+1. Open: `http://localhost:3000/demo-simple.html`
+2. Select: `001_original_emk.emk`
+3. Click: "🔄 Convert to KAR"
+4. Verify: Tempo = 79 BPM, Duration = 4:43
+
+### Test Playback
+1. Click: "▶️ Play"
+2. Verify: Piano notes play
+3. Verify: Progress bar moves
+4. Verify: Time display updates
+5. Click: "⏹️ Stop"
+6. Verify: Playback stops, progress resets
 
 ---
 
-**Perfect for demonstrating v1.4.9 fixes! 🎤✨**
+## 🎊 Status: ✅ Complete
+
+**Demo Page Features:**
+- ✅ EMK file list
+- ✅ File selection
+- ✅ EMK analysis (before conversion)
+- ✅ EMK to KAR conversion
+- ✅ Metadata display
+- ✅ Comparison table (EMK vs KAR)
+- ✅ KAR file download
+- ✅ **MIDI Player** (NEW!)
+
+**Ready for testing and demonstration!** 🎉

package/DOCUMENTATION_INDEX.md

@@ -0,0 +1,317 @@
+# 📚 Documentation Index
+
+**@karaplay/file-coder v1.5.1+**  
+Complete guide to EMK/KAR conversion and testing
+
+---
+
+## 🚀 Getting Started
+
+### For Users
+
+1. **[README.md](./README.md)** ⭐ START HERE
+   - Installation and quick start
+   - Main API documentation
+   - Features and examples
+   - Browser/Server usage
+
+2. **[BROWSER_API.md](./BROWSER_API.md)**
+   - Client-side conversion guide
+   - Next.js integration
+   - Browser examples
+
+---
+
+## 🎵 Song Conversion
+
+### Main Workflow
+
+3. **[EMK_TO_KAR_WORKFLOW.md](./EMK_TO_KAR_WORKFLOW.md)**
+   - Complete EMK → KAR pipeline
+   - Step-by-step guide
+   - Advanced options
+
+4. **[HOWTOEMKTONCN.md](./HOWTOEMKTONCN.md)**
+   - EMK to NCN conversion
+   - Technical details
+
+---
+
+## ⏱️ Tempo & Duration
+
+### Understanding Tempo
+
+5. **[TEMPO_TRICKS_SUMMARY.md](./TEMPO_TRICKS_SUMMARY.md)** ⭐ BEST PRACTICES
+   - How to use @tonejs/midi correctly
+   - Common pitfalls and solutions
+   - ZXIO vs MThd formats
+   - Why duration decreases when tempo increases
+
+6. **[WHY_DURATION_DECREASES.md](./WHY_DURATION_DECREASES.md)**
+   - Mathematical explanation
+   - Tempo-duration relationship
+
+---
+
+## 🧪 Testing & Validation
+
+### Test Suite
+
+7. **[EMK_TEST_SUITE_README.md](./EMK_TEST_SUITE_README.md)** ⭐ TESTING GUIDE
+   - Complete test suite documentation
+   - How to run tests
+   - Debugging failed tests
+   - Best practices
+
+8. **[EMK_SONGS_INFO.md](./EMK_SONGS_INFO.md)**
+   - Song information database
+   - Expected results for each file
+   - Format statistics
+   - Verification checklist
+
+9. **[EMK_TEST_SUITE_SUMMARY.txt](./EMK_TEST_SUITE_SUMMARY.txt)**
+   - Quick reference summary
+   - Test results overview
+   - Statistics
+
+10. **[EMK_REFERENCE_DATA.json](./EMK_REFERENCE_DATA.json)**
+    - Machine-readable reference data
+    - Used by test scripts
+    - Auto-generated from conversions
+
+---
+
+## 🔧 Technical Details
+
+### Problem Solving
+
+11. **[KAR_FILE_VALIDATION_SOLUTION.md](./KAR_FILE_VALIDATION_SOLUTION.md)**
+    - KAR file validation
+    - Quality checks
+
+12. **[BROWSER_KAR_CORRUPTION_FIX.md](./BROWSER_KAR_CORRUPTION_FIX.md)**
+    - Browser-specific issues
+    - Corruption fixes
+
+13. **[BUG_FIX_SUMMARY.md](./BUG_FIX_SUMMARY.md)**
+    - Historical bug fixes
+    - Solutions applied
+
+---
+
+## 🎭 Demo & Examples
+
+### Live Demo
+
+14. **[DEMO_ENHANCED.md](./DEMO_ENHANCED.md)**
+    - Demo page documentation
+    - Features and usage
+
+15. **[demo-simple.html](./demo-simple.html)**
+    - Live demo page
+    - Run: `npm run demo`
+    - Browser: http://localhost:3000
+
+16. **[examples/NextJSComponent.tsx](./examples/NextJSComponent.tsx)**
+    - React/Next.js example
+    - Client-side conversion
+
+---
+
+## 📋 Release Notes
+
+### Version History
+
+17. **[RELEASE_v1.5.1.md](./RELEASE_v1.5.1.md)** ⭐ LATEST
+    - Validation utilities
+    - Enhanced documentation
+    - Test suite
+
+18. **[RELEASE_v1.5.0.md](./RELEASE_v1.5.0.md)**
+    - ZXIO tempo fix (1.24x)
+    - Duration accuracy improvements
+
+19. **[RELEASE_v1.4.9.md](./RELEASE_v1.4.9.md)**
+    - ZXIO format support improvements
+
+20. **[RELEASE_v1.4.7.md](./RELEASE_v1.4.7.md)**
+    - ZXIO "zxio" header support
+
+21. **Previous Releases:**
+    - v1.4.0 - v1.4.6: See individual release notes
+    - v1.3.0 - v1.3.9: See individual release notes
+    - v1.1.1 - v1.2.0: See individual release notes
+
+---
+
+## 🎯 Quick Reference
+
+### Common Tasks
+
+| Task | Documentation | Command |
+|------|---------------|---------|
+| **Convert EMK to KAR** | [README.md](./README.md#emk-to-kar-workflow-complete-pipeline) | `convertEmkToKar()` |
+| **Validate KAR file** | [TEMPO_TRICKS_SUMMARY.md](./TEMPO_TRICKS_SUMMARY.md#4-validation-functions) | `validateKarTempo()` |
+| **Run tests** | [EMK_TEST_SUITE_README.md](./EMK_TEST_SUITE_README.md#-quick-start) | `npm run test:emk` |
+| **Fix tempo issues** | [TEMPO_TRICKS_SUMMARY.md](./TEMPO_TRICKS_SUMMARY.md#6-common-pitfalls) | Auto-fixed in v1.5.0+ |
+| **Browser usage** | [BROWSER_API.md](./BROWSER_API.md) | `convertEmkFileToKar()` |
+| **Run demo** | [DEMO_ENHANCED.md](./DEMO_ENHANCED.md) | `npm run demo` |
+
+---
+
+## 🔍 By Topic
+
+### For Developers
+
+**Converting Files:**
+- [README.md](./README.md) - Main API
+- [EMK_TO_KAR_WORKFLOW.md](./EMK_TO_KAR_WORKFLOW.md) - Complete workflow
+- [BROWSER_API.md](./BROWSER_API.md) - Client-side
+
+**Understanding Tempo:**
+- [TEMPO_TRICKS_SUMMARY.md](./TEMPO_TRICKS_SUMMARY.md) - ⭐ Best practices
+- [WHY_DURATION_DECREASES.md](./WHY_DURATION_DECREASES.md) - Explanation
+- [RELEASE_v1.5.0.md](./RELEASE_v1.5.0.md) - ZXIO fix
+
+**Testing:**
+- [EMK_TEST_SUITE_README.md](./EMK_TEST_SUITE_README.md) - ⭐ Complete guide
+- [EMK_SONGS_INFO.md](./EMK_SONGS_INFO.md) - Reference data
+- [EMK_REFERENCE_DATA.json](./EMK_REFERENCE_DATA.json) - Test data
+
+### For QA / Testing
+
+**Quality Assurance:**
+- [EMK_TEST_SUITE_README.md](./EMK_TEST_SUITE_README.md) - Test procedures
+- [EMK_SONGS_INFO.md](./EMK_SONGS_INFO.md) - Expected results
+- [KAR_FILE_VALIDATION_SOLUTION.md](./KAR_FILE_VALIDATION_SOLUTION.md) - Validation
+
+**Troubleshooting:**
+- [TEMPO_TRICKS_SUMMARY.md](./TEMPO_TRICKS_SUMMARY.md) - Common issues
+- [BUG_FIX_SUMMARY.md](./BUG_FIX_SUMMARY.md) - Known bugs & fixes
+- [EMK_TEST_SUITE_README.md](./EMK_TEST_SUITE_README.md#-debugging-failed-tests) - Debugging
+
+### For End Users
+
+**Getting Started:**
+1. [README.md](./README.md) - Install and basic usage
+2. [DEMO_ENHANCED.md](./DEMO_ENHANCED.md) - Try the demo
+3. [examples/NextJSComponent.tsx](./examples/NextJSComponent.tsx) - Code examples
+
+**Understanding Results:**
+- [WHY_DURATION_DECREASES.md](./WHY_DURATION_DECREASES.md) - Why duration changes
+- [EMK_SONGS_INFO.md](./EMK_SONGS_INFO.md) - Song information
+
+---
+
+## 📊 Statistics
+
+### Documentation Coverage
+
+- **Total Documents:** 21+ files
+- **API Documentation:** 3 files
+- **Technical Guides:** 7 files
+- **Testing Documentation:** 4 files
+- **Release Notes:** 15+ files
+- **Examples:** 2 files
+
+### Lines of Documentation
+
+- **README.md:** ~290 lines
+- **Test Suite Docs:** ~1,200 lines
+- **Tempo Guides:** ~500 lines
+- **Release Notes:** ~3,000 lines
+- **Total:** ~5,000+ lines
+
+---
+
+## 🎓 Learning Paths
+
+### Path 1: Basic User (15 minutes)
+
+1. Read [README.md](./README.md) - Quick Start section
+2. Try the demo: `npm run demo`
+3. Copy example from [examples/NextJSComponent.tsx](./examples/NextJSComponent.tsx)
+
+### Path 2: Integration Developer (1 hour)
+
+1. [README.md](./README.md) - Full API
+2. [BROWSER_API.md](./BROWSER_API.md) - Client-side API
+3. [EMK_TO_KAR_WORKFLOW.md](./EMK_TO_KAR_WORKFLOW.md) - Workflow
+4. [TEMPO_TRICKS_SUMMARY.md](./TEMPO_TRICKS_SUMMARY.md) - Best practices
+
+### Path 3: Library Contributor (3 hours)
+
+1. [README.md](./README.md) - Overview
+2. [TEMPO_TRICKS_SUMMARY.md](./TEMPO_TRICKS_SUMMARY.md) - Technical details
+3. [EMK_TEST_SUITE_README.md](./EMK_TEST_SUITE_README.md) - Testing
+4. [RELEASE_v1.5.0.md](./RELEASE_v1.5.0.md) - Recent changes
+5. Source code in `src/`
+
+### Path 4: QA Tester (2 hours)
+
+1. [EMK_TEST_SUITE_README.md](./EMK_TEST_SUITE_README.md) - Test suite
+2. [EMK_SONGS_INFO.md](./EMK_SONGS_INFO.md) - Expected results
+3. Run: `npm run test:emk`
+4. [TEMPO_TRICKS_SUMMARY.md](./TEMPO_TRICKS_SUMMARY.md) - Debugging
+
+---
+
+## 🆘 Getting Help
+
+### If you need to...
+
+**Convert a file:**
+→ See [README.md](./README.md#emk-to-kar-workflow-complete-pipeline)
+
+**Fix tempo issues:**
+→ See [TEMPO_TRICKS_SUMMARY.md](./TEMPO_TRICKS_SUMMARY.md#6-common-pitfalls)
+
+**Run tests:**
+→ See [EMK_TEST_SUITE_README.md](./EMK_TEST_SUITE_README.md#-quick-start)
+
+**Understand duration changes:**
+→ See [WHY_DURATION_DECREASES.md](./WHY_DURATION_DECREASES.md)
+
+**Debug a conversion:**
+→ See [EMK_TEST_SUITE_README.md](./EMK_TEST_SUITE_README.md#-debugging-failed-tests)
+
+**Use in browser:**
+→ See [BROWSER_API.md](./BROWSER_API.md)
+
+**Check song info:**
+→ See [EMK_SONGS_INFO.md](./EMK_SONGS_INFO.md)
+
+---
+
+## 📝 Document Status
+
+| Document | Status | Last Updated |
+|----------|--------|--------------|
+| README.md | ✅ Current | 2026-01-13 |
+| TEMPO_TRICKS_SUMMARY.md | ✅ Current | 2026-01-13 |
+| EMK_TEST_SUITE_README.md | ✅ Current | 2026-01-13 |
+| EMK_SONGS_INFO.md | ✅ Current | 2026-01-13 |
+| RELEASE_v1.5.1.md | ✅ Current | 2026-01-13 |
+| Other docs | ✅ Current | Various |
+
+---
+
+## 🔗 External Resources
+
+### npm Package
+
+- **Package:** [@karaplay/file-coder](https://www.npmjs.com/package/@karaplay/file-coder)
+- **Version:** 1.5.1+
+- **License:** ISC
+
+### Dependencies
+
+- [@tonejs/midi](https://www.npmjs.com/package/@tonejs/midi) - MIDI parsing (recommended)
+- [karaoke-player](https://www.npmjs.com/package/karaoke-player) - KAR playback
+- [iconv-lite](https://www.npmjs.com/package/iconv-lite) - TIS-620 encoding
+
+---
+
+**Last Updated:** 2026-01-13  
+**Maintained by:** @karaplay/file-coder team  
+**Status:** ✅ Complete and Up-to-Date