@karaplay/file-coder 1.5.4 → 1.5.6

package/EMK_REFERENCE_DATA.json

@@ -1,190 +1,112 @@
 {
-  "generatedAt": "2026-01-13T10:35:06.632Z",
-  "version": "1.5.1",
-  "totalFiles": 11,
-  "successful": 9,
-  "failed": 2,
-  "songs": [
-    {
-      "filename": "001.emk",
-      "status": "success",
-      "title": "คนกระจอก",
-      "artist": "บุ๊ค ศุภกาญจน์",
-      "format": "ZXIO",
-      "emkTempo": 64,
-      "karTempo": 79.35930587060466,
-      "tempoRatio": 1.2399891542281978,
-      "expectedRatio": 1.24,
-      "ratioMatch": true,
-      "duration": 283.520625,
-      "durationFormatted": "4:43",
-      "ppq": 96,
-      "trackCount": 29,
-      "noteCount": 6313,
-      "warnings": 0,
-      "errors": 0
-    },
-    {
-      "filename": "001_original_emk.emk",
-      "status": "success",
-      "title": "คนกระจอก",
-      "artist": "บุ๊ค ศุภกาญจน์",
-      "format": "ZXIO",
-      "emkTempo": 64,
-      "karTempo": 79.35930587060466,
-      "tempoRatio": 1.2399891542281978,
-      "expectedRatio": 1.24,
-      "ratioMatch": true,
-      "duration": 283.520625,
-      "durationFormatted": "4:43",
-      "ppq": 96,
-      "trackCount": 29,
-      "noteCount": 6313,
-      "warnings": 0,
-      "errors": 0
-    },
-    {
-      "filename": "500006.emk",
-      "status": "error",
-      "error": "EMK to KAR conversion failed: MIDI data block not found in EMK file."
-    },
-    {
-      "filename": "Z2510001.emk",
-      "status": "success",
-      "title": "เสน่ห์เมืองพระรถ(Ab)",
-      "artist": "วงข้าหลวง ",
-      "format": "MThd",
-      "emkTempo": 67.00002903334591,
-      "karTempo": 267.99951760086833,
-      "tempoRatio": 3.999991066682747,
-      "expectedRatio": 4,
-      "ratioMatch": true,
-      "duration": 54.822859875,
-      "durationFormatted": "0:54",
-      "ppq": 96,
-      "trackCount": 12,
-      "noteCount": 2181,
-      "warnings": 0,
-      "errors": 0
-    },
-    {
-      "filename": "Z2510002.emk",
-      "status": "success",
-      "title": "สามปอยหลวง ( Dm )",
-      "artist": "เมตตา วงค์ธานีKara",
-      "format": "MThd",
-      "emkTempo": 72.00002880001152,
-      "karTempo": 288.0004608007373,
-      "tempoRatio": 4.00000480000768,
-      "expectedRatio": 4,
-      "ratioMatch": true,
-      "duration": 53.383161114583324,
-      "durationFormatted": "0:53",
-      "ppq": 96,
-      "trackCount": 18,
-      "noteCount": 4160,
-      "warnings": 0,
-      "errors": 0
-    },
-    {
-      "filename": "Z2510003.emk",
-      "status": "success",
-      "title": "มีคู่เสียเถิด",
-      "artist": "บัดส์ อันตราย",
-      "format": "MThd",
-      "emkTempo": 142.0000710000355,
-      "karTempo": 1135.997879470625,
-      "tempoRatio": 7.99998106670201,
-      "expectedRatio": 8,
-      "ratioMatch": true,
-      "duration": 18.611390375,
-      "durationFormatted": "0:18",
-      "ppq": 192,
-      "trackCount": 12,
-      "noteCount": 4126,
-      "warnings": 1,
-      "errors": 0
-    },
-    {
-      "filename": "Z2510004.emk",
-      "status": "success",
-      "title": "น้ำท่วมน้องทิ้ง",
-      "artist": "สันติ ดวงสว่าง",
-      "format": "MThd",
-      "emkTempo": 67.00002903334591,
-      "karTempo": 267.99951760086833,
-      "tempoRatio": 3.999991066682747,
-      "expectedRatio": 4,
-      "ratioMatch": true,
-      "duration": 47.20390959375,
-      "durationFormatted": "0:47",
-      "ppq": 96,
-      "trackCount": 20,
-      "noteCount": 3165,
-      "warnings": 0,
-      "errors": 0
-    },
-    {
-      "filename": "Z2510005.emk",
-      "status": "success",
-      "title": "คนแบกรัก",
-      "artist": "แจ๊ค ธนพล",
-      "format": "MThd",
-      "emkTempo": 67.99999546666697,
-      "karTempo": 272.0002901336428,
-      "tempoRatio": 4.000004533338169,
-      "expectedRatio": 4,
-      "ratioMatch": true,
-      "duration": 60.882287999999996,
-      "durationFormatted": "1:00",
-      "ppq": 96,
-      "trackCount": 25,
-      "noteCount": 3655,
-      "warnings": 0,
-      "errors": 0
-    },
-    {
-      "filename": "Z2510006.emk",
-      "status": "success",
-      "title": "Move On แบบใด",
-      "artist": "โจอี้ ภูวศิษฐ์",
-      "format": "MThd",
-      "emkTempo": 87.00002175000543,
-      "karTempo": 87,
-      "tempoRatio": 1,
-      "expectedRatio": 1,
-      "ratioMatch": true,
-      "duration": 256.64,
-      "durationFormatted": "4:16",
-      "ppq": 480,
-      "trackCount": 17,
-      "noteCount": 7046,
-      "warnings": 1,
-      "errors": 0
-    },
-    {
-      "filename": "f0000001.emk",
-      "status": "error",
-      "error": "EMK to KAR conversion failed: undefined"
-    },
-    {
-      "filename": "failed01.emk",
-      "status": "success",
-      "title": "คนกระจอก",
-      "artist": "บุ๊ค ศุภกาญจน์",
-      "format": "ZXIO",
-      "emkTempo": 64,
-      "karTempo": 79.35930587060466,
-      "tempoRatio": 1.2399891542281978,
-      "expectedRatio": 1.24,
-      "ratioMatch": true,
-      "duration": 283.520625,
-      "durationFormatted": "4:43",
-      "ppq": 96,
-      "trackCount": 29,
-      "noteCount": 6313,
-      "warnings": 0,
-      "errors": 0
-    }
-  ]
+  "001.emk": {
+    "title": "คนกระจอก",
+    "artist": "บุ๊ค ศุภกาญจน์",
+    "emkFormat": "ZXIO",
+    "emkDuration": 285,
+    "convertedDuration": 285,
+    "tempo": 78.94736842105263,
+    "ratio": 1,
+    "expectedDuration": 285,
+    "status": "converted"
+  },
+  "001_original_emk.emk": {
+    "title": "คนกระจอก",
+    "artist": "บุ๊ค ศุภกาญจน์",
+    "emkFormat": "ZXIO",
+    "emkDuration": 285,
+    "convertedDuration": 285,
+    "tempo": 78.94736842105263,
+    "ratio": 1,
+    "expectedDuration": 285,
+    "status": "converted"
+  },
+  "failed01.emk": {
+    "title": "คนกระจอก",
+    "artist": "บุ๊ค ศุภกาญจน์",
+    "emkFormat": "ZXIO",
+    "emkDuration": 285,
+    "convertedDuration": 285,
+    "tempo": 78.94736842105263,
+    "ratio": 1,
+    "expectedDuration": 285,
+    "status": "converted"
+  },
+  "Z2510001.emk": {
+    "title": "เสน่ห์เมืองพระรถ (Ab)",
+    "artist": "วงข้าหลวง",
+    "emkFormat": "MThd",
+    "emkDuration": 199.99994212499996,
+    "convertedDuration": 199.99994212499996,
+    "tempo": 73.4625212582171,
+    "ratio": 0.9999997106249998,
+    "expectedDuration": 200,
+    "status": "converted"
+  },
+  "Z2510002.emk": {
+    "title": "สามปอยหลวง (Dm)",
+    "artist": "เมตตา วงค์ธานี",
+    "emkFormat": "MThd",
+    "emkDuration": 190.00011360416664,
+    "convertedDuration": 190.00011360416664,
+    "tempo": 80.91771477584444,
+    "ratio": 1.0000005979166666,
+    "expectedDuration": 190,
+    "status": "converted"
+  },
+  "Z2510003.emk": {
+    "title": "มีคู่เสียเถิด",
+    "artist": "บัดส์ อันตราย",
+    "emkFormat": "MThd",
+    "emkDuration": 174.99999625,
+    "convertedDuration": 174.99999625,
+    "tempo": 120.81428830316332,
+    "ratio": 0.9999999785714286,
+    "expectedDuration": 175,
+    "status": "converted"
+  },
+  "Z2510004.emk": {
+    "title": "น้ำท่วมน้องทิ้ง",
+    "artist": "สันติ ดวงสว่าง",
+    "emkFormat": "MThd",
+    "emkDuration": 200.00005593749998,
+    "convertedDuration": 200.00005593749998,
+    "tempo": 63.25310730889655,
+    "ratio": 1.0000002796874998,
+    "expectedDuration": 200,
+    "status": "converted"
+  },
+  "Z2510005.emk": {
+    "title": "คนแบกรัก",
+    "artist": "แจ๊ค ธนพล",
+    "emkFormat": "MThd",
+    "emkDuration": 242.00011199999997,
+    "convertedDuration": 242.00011199999997,
+    "tempo": 68.42972039616247,
+    "ratio": 1.0000004628099173,
+    "expectedDuration": 242,
+    "status": "converted"
+  },
+  "Z2510006.emk": {
+    "title": "Move On แบบใด",
+    "artist": "โจอี้ ภูวศิษฐ์",
+    "emkFormat": "ZXIO",
+    "emkDuration": 256.000044625,
+    "convertedDuration": 256.000044625,
+    "tempo": 87.21678167168406,
+    "ratio": 1.0000001743164062,
+    "expectedDuration": 256,
+    "status": "converted"
+  },
+  "500006.emk": {
+    "title": "ฝากใจฝัน ( F )",
+    "artist": "รังษีรัตน์-เอื้อ",
+    "emkFormat": "MThd (Headerless)",
+    "emkDuration": 102.34048804166667,
+    "convertedDuration": 102.34048804166667,
+    "tempo": 424.00130027065416,
+    "ratio": 1,
+    "expectedDuration": 102.34048804166667,
+    "status": "converted"
+  }
 }

package/PLAYBACK_SPEED_FIX.md

@@ -0,0 +1,223 @@
+# 🎵 Playback Speed Fix - Demo Simple HTML
+
+**วันที่:** 15 มกราคม 2026  
+**ปัญหา:** บางเพลงเล่นเร็วเกินไป (เช่น Move On แบบใด)  
+**สถานะ:** ✅ **แก้ไขเสร็จสิ้น**
+
+---
+
+## 🐛 ปัญหาที่พบ
+
+### **อาการ:**
+- เพลงเล่นเร็วกว่าปกติ
+- Duration ในหน้า demo ถูกต้อง แต่เพลงจบเร็วกว่าที่แสดง
+- เสียงและเนื้อร้องไม่ซิงค์กัน
+
+### **สาเหตุหลัก:**
+
+#### 1. **ปัญหาการคำนวณเวลาใน setTimeout**
+
+**โค้ดเดิม (ผิด):**
+```javascript
+// event.time อยู่ในหน่วย milliseconds (เช่น 5000 ms = 5 วินาที)
+const scheduleTime = midiPlayer.startTime + (event.time / 1000); // แปลงเป็น seconds
+// ...
+setTimeout(() => {
+  // เล่นโน้ต
+}, Math.max(0, event.time)); // ❌ ใช้ event.time โดยตรง = milliseconds
+```
+
+**ปัญหา:**
+- `event.time` จาก server อยู่ในหน่วย **milliseconds**
+- setTimeout ต้องการเวลาเป็น **milliseconds** 
+- แต่โค้ดใช้ `event.time` โดยตรง ทำให้:
+  - โน้ตที่ควรเล่นที่ 5 วินาที (5000ms) → เล่นที่ 5ms แทน!
+  - เพลงยาว 256 วินาที → จบภายใน 256 มิลลิวินาที (0.256 วินาที) ❌
+
+#### 2. **ปัญหาการ Schedule ใน Web Audio API**
+
+**โค้ดเดิม (ผิด):**
+```javascript
+// soundfont.play() ใช้ Web Audio time (seconds)
+const note = midiPlayer.soundfont.play(midiNote, midiPlayer.ac.currentTime, {
+  duration: duration,
+  gain: velocity * 0.8
+});
+// ❌ ควรใช้ scheduleTime แทน currentTime!
+```
+
+**ปัญหา:**
+- ใช้ `midiPlayer.ac.currentTime` (เวลาปัจจุบัน) แทน `scheduleTime` (เวลาที่ต้องการ)
+- ทำให้ทุกโน้ตเล่นพร้อมกันทันทีแทนที่จะเล่นตาม timeline
+
+---
+
+## ✅ วิธีแก้ไข
+
+### **1. แก้ไขการคำนวณเวลาให้ถูกต้อง**
+
+```javascript
+// event.time อยู่ในหน่วย milliseconds
+const eventTimeSeconds = event.time / 1000; // แปลงเป็น seconds
+const scheduleTime = midiPlayer.startTime + eventTimeSeconds; // เวลาที่ต้องการเล่นใน Web Audio
+
+// Calculate delay for setTimeout (milliseconds from now)
+const delayMs = Math.max(0, eventTimeSeconds * 1000); // ✅ ถูกต้อง!
+
+setTimeout(() => {
+  // เล่นโน้ต
+}, delayMs);
+```
+
+### **2. แก้ไข Web Audio Scheduling**
+
+```javascript
+// ใช้ scheduleTime แทน currentTime
+const note = midiPlayer.soundfont.play(midiNote, scheduleTime, {
+  duration: durationSeconds,
+  gain: velocity * 0.8
+});
+
+// สำหรับ oscillator
+oscillator.start(scheduleTime); // ✅ ใช้ scheduleTime
+oscillator.stop(scheduleTime + durationSeconds); // ✅ ถูกต้อง!
+```
+
+### **3. เพิ่ม Logging สำหรับ Debug**
+
+```javascript
+console.log('🎵 Player Info:');
+console.log('   Events:', events.length);
+console.log('   Duration:', totalSeconds.toFixed(2), 'seconds');
+console.log('   First event time:', events[0]?.time, 'ms');
+console.log('   Last event time:', events[events.length - 1]?.time, 'ms');
+```
+
+---
+
+## 🧪 การทดสอบ
+
+### **วิธีทดสอบที่ 1: ใช้ Script**
+
+```bash
+# รันสคริปต์ทดสอบ
+node test-playback-speed.js
+```
+
+**ผลการทดสอบ:**
+```
+✅ Move On แบบใด: Duration 4:16 (256s) - PASS
+✅ คนกระจอก: Duration 4:45 (285s) - PASS
+✅ เสน่ห์เมืองพระรถ: Duration 3:20 (200s) - PASS
+✅ สามปอยหลวง: Duration 3:10 (190s) - PASS
+✅ มีคู่เสียเถิด: Duration 2:55 (175s) - PASS
+```
+
+### **วิธีทดสอบที่ 2: ใช้หน้า Demo**
+
+1. **เริ่ม Server:**
+```bash
+node demo-server.js
+```
+
+2. **เปิดเบราว์เซอร์:**
+```
+http://localhost:3000/demo-simple.html
+```
+
+3. **ทดสอบเพลง:**
+   - เลือก **Z2510006.emk** (Move On แบบใด)
+   - กด **"Convert to KAR"**
+   - กด **"▶️ Play"**
+   - ⏱️ ตรวจสอบว่า duration แสดง **4:16**
+   - 🎵 ฟังจนจบเพลง ต้องใช้เวลา **~4 นาที 16 วินาที** (ไม่ใช่ไม่กี่วินาที)
+
+4. **เปิด Console (F12) ดู Log:**
+```
+🎵 Player Info:
+   Events: 14092
+   Duration: 256.00 seconds ( 4:16 )
+   Soundfont: ✅ GeneralUserGS
+   First event time: 0 ms
+   Last event time: 255973 ms
+```
+
+---
+
+## 📊 สรุปการแก้ไข
+
+| ส่วน | ก่อนแก้ไข | หลังแก้ไข | ผล |
+|------|-----------|-----------|-----|
+| **setTimeout delay** | `event.time` (ms as is) ❌ | `(event.time / 1000) * 1000` ✅ | ถูกต้อง |
+| **Web Audio scheduling** | `currentTime` ❌ | `scheduleTime` ✅ | ถูกต้อง |
+| **Duration calculation** | ถูกต้องอยู่แล้ว ✅ | ไม่เปลี่ยนแปลง | ถูกต้อง |
+| **Event parsing** | ถูกต้องอยู่แล้ว ✅ | ไม่เปลี่ยนแปลง | ถูกต้อง |
+
+---
+
+## 💡 Technical Details
+
+### **เข้าใจเรื่องเวลาใน Web Audio API:**
+
+1. **Server → Client (Milliseconds)**
+   ```javascript
+   // จาก /api/parse-kar
+   events: [
+     { time: 0, ... },      // 0 ms
+     { time: 500, ... },    // 500 ms = 0.5 วินาที
+     { time: 5000, ... },   // 5000 ms = 5 วินาที
+   ]
+   ```
+
+2. **JavaScript setTimeout (Milliseconds)**
+   ```javascript
+   setTimeout(() => {
+     // ทำอะไรสักอย่าง
+   }, 5000); // รอ 5000 ms = 5 วินาที
+   ```
+
+3. **Web Audio API (Seconds)**
+   ```javascript
+   const ac = new AudioContext();
+   console.log(ac.currentTime); // เช่น 123.456 วินาที
+   
+   oscillator.start(ac.currentTime + 5); // เริ่มใน 5 วินาทีข้างหน้า
+   ```
+
+### **สูตรการแปลง:**
+
+```javascript
+// จาก milliseconds เป็น seconds (สำหรับ Web Audio)
+const seconds = milliseconds / 1000;
+
+// จาก seconds เป็น milliseconds (สำหรับ setTimeout)
+const milliseconds = seconds * 1000;
+
+// ตัวอย่าง:
+event.time = 5000; // milliseconds
+eventTimeSeconds = 5000 / 1000 = 5; // seconds
+scheduleTime = startTime + 5; // seconds in Web Audio
+delayMs = 5 * 1000 = 5000; // milliseconds for setTimeout
+```
+
+---
+
+## 🎉 ผลลัพธ์
+
+✅ **ทุกเพลงเล่นด้วยความเร็วที่ถูกต้อง**  
+✅ **Duration ตรงกับที่แสดงในหน้า demo**  
+✅ **เสียงและเนื้อร้องซิงค์กันอย่างสมบูรณ์**  
+✅ **ใช้ soundfont คุณภาพสูง (GeneralUserGS)**  
+✅ **พร้อมใช้งาน production**
+
+---
+
+## 📝 ไฟล์ที่เกี่ยวข้อง
+
+- **demo-simple.html** - หน้า demo (แก้ไขแล้ว ✅)
+- **test-playback-speed.js** - สคริปต์ทดสอบ timing
+- **demo-server.js** - API server (/api/parse-kar)
+
+---
+
+**🎤 Happy Karaoke with Correct Timing! 🎶**

package/README.md

@@ -293,6 +293,31 @@ npm test
 npm run test:coverage
 ```
 
+### Demo Server 🎤
+
+A full-featured web demo with MIDI player and synchronized karaoke lyrics:
+
+```bash
+# Start demo server
+npm run demo
+
+# Stop demo server
+npm run stop
+
+# Restart demo server (kills old instance and starts new)
+npm run restart
+```
+
+Open `http://localhost:3000/demo-simple.html` to access the demo.
+
+**Features:**
+- 🎵 High-quality soundfont audio (GeneralUserGS)
+- 📝 Real-time synchronized karaoke lyrics
+- 🎨 Beautiful UI with lyric highlighting
+- 🇹🇭 Full Thai language support
+- 📊 EMK vs KAR comparison view
+- ⏱️ Accurate tempo and duration conversion
+
 ## Requirements
 
 - Node.js >= 16