@karaplay/file-coder 1.5.5 → 1.5.6

package/full-debug-timing.js

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { decodeEmkServer, convertEmkToKar } = require('./dist/index.js');
+const { Midi } = require('@tonejs/midi');
+const iconv = require('iconv-lite');
+
+const emkFile = process.argv[2] || 'songs/emk/Z2510006.emk';
+
+console.log('='.repeat(80));
+console.log('🔍 FULL DEBUG: EMK → KAR → Play Timeline');
+console.log('='.repeat(80));
+console.log('File:', emkFile);
+console.log('');
+
+// ============================================================================
+// STEP 1: Decode EMK
+// ============================================================================
+console.log('📦 STEP 1: Decoding EMK file...');
+const emkBuffer = fs.readFileSync(emkFile);
+const decoded = decodeEmkServer(emkBuffer);
+
+console.log('  ✅ Decoded successfully');
+console.log('  Format:', decoded.isZxioFormat ? 'ZXIO' : 'MThd');
+console.log('');
+
+// ============================================================================
+// STEP 2: Analyze Original MIDI Timing
+// ============================================================================
+console.log('🎵 STEP 2: Analyzing ORIGINAL EMK MIDI timing...');
+const originalMidi = new Midi(decoded.midi);
+const originalTempo = originalMidi.header.tempos[0]?.bpm || 120;
+const ppq = originalMidi.header.ppq;
+
+console.log('  Tempo:', originalTempo.toFixed(2), 'BPM');
+console.log('  PPQ:', ppq);
+console.log('  Duration:', originalMidi.duration.toFixed(2), 's');
+
+// Find first notes
+const firstNotes = [];
+originalMidi.tracks.forEach((track, idx) => {
+  if (track.notes.length > 0 && idx > 0) {
+    const first = track.notes[0];
+    if (first.time < 10) {
+      firstNotes.push({ track: idx, time: first.time, midi: first.midi });
+    }
+  }
+});
+firstNotes.sort((a, b) => a.time - b.time);
+
+console.log('  First 5 notes:');
+for (let i = 0; i < Math.min(5, firstNotes.length); i++) {
+  console.log(`    Track ${firstNotes[i].track}: ${firstNotes[i].time.toFixed(3)}s (note ${firstNotes[i].midi})`);
+}
+
+// Find first vocal note (skip intro drums)
+let firstVocalTime = Infinity;
+for (let i = 0; i < firstNotes.length; i++) {
+  if (firstNotes[i].time > 1 && firstNotes[i].time < 10) {
+    firstVocalTime = firstNotes[i].time;
+    break;
+  }
+}
+console.log(`  → First vocal note: ${firstVocalTime.toFixed(3)}s`);
+console.log('');
+
+// ============================================================================
+// STEP 3: Analyze Cursor Raw Data
+// ============================================================================
+console.log('⏱️  STEP 3: Analyzing CURSOR raw data...');
+const cursorBuffer = decoded.cursor;
+
+// Read first 50 cursor values (U16LE)
+const cursorValues = [];
+for (let i = 0; i < Math.min(100, cursorBuffer.length - 1); i += 2) {
+  const value = cursorBuffer.readUInt16LE(i);
+  if (value !== 0xFFFF) {
+    cursorValues.push({ index: i / 2, rawValue: value });
+  }
+}
+
+console.log(`  Total cursor entries: ${cursorValues.length}`);
+console.log('  First 10 raw cursor values (U16LE):');
+for (let i = 0; i < Math.min(10, cursorValues.length); i++) {
+  const entry = cursorValues[i];
+  // Calculate what this SHOULD be in seconds based on PPQ
+  const ticksWithMultiplier = entry.rawValue * (ppq / 24);
+  const secondsWithOriginalTempo = (ticksWithMultiplier / ppq) * (60 / originalTempo);
+  console.log(`    [${entry.index}] raw=${entry.rawValue}, ticks=${ticksWithMultiplier.toFixed(0)}, seconds=${secondsWithOriginalTempo.toFixed(3)}`);
+}
+console.log('');
+
+// ============================================================================
+// STEP 4: Analyze Lyric Content
+// ============================================================================
+console.log('📝 STEP 4: Analyzing LYRIC file...');
+const lyricText = iconv.decode(decoded.lyric, 'tis-620');
+const lyricLines = lyricText.split('\n');
+
+console.log(`  Total lines: ${lyricLines.length}`);
+console.log('  Lines 0-9 (should be: title, artist, key, blank, then lyrics):');
+for (let i = 0; i < Math.min(10, lyricLines.length); i++) {
+  const line = lyricLines[i].trim();
+  console.log(`    [${i}] "${line.substring(0, 50)}${line.length > 50 ? '...' : ''}"`);
+}
+console.log('');
+
+// ============================================================================
+// STEP 5: Convert to KAR
+// ============================================================================
+console.log('🔄 STEP 5: Converting EMK → KAR...');
+const tempDir = path.join(__dirname, 'temp');
+if (!fs.existsSync(tempDir)) fs.mkdirSync(tempDir, { recursive: true });
+
+const outputKar = path.join(tempDir, 'full-debug.kar');
+const result = convertEmkToKar({
+  inputEmk: emkFile,
+  outputKar: outputKar,
+  keepIntermediateFiles: false
+});
+
+console.log('  ✅ Converted');
+console.log('  Warnings:', result.warnings.length);
+if (result.warnings.length > 0) {
+  console.log('  Warnings:');
+  result.warnings.forEach(w => console.log(`    - ${w}`));
+}
+console.log('');
+
+// ============================================================================
+// STEP 6: Analyze KAR MIDI Timing
+// ============================================================================
+console.log('🎼 STEP 6: Analyzing KAR MIDI timing...');
+const karBuffer = fs.readFileSync(outputKar);
+const karMidi = new Midi(karBuffer);
+const karTempo = karMidi.header.tempos[0]?.bpm || 120;
+
+console.log('  Tempo:', karTempo.toFixed(2), 'BPM');
+console.log('  PPQ:', karMidi.header.ppq);
+console.log('  Duration:', karMidi.duration.toFixed(2), 's');
+console.log('  Tempo ratio:', (karTempo / originalTempo).toFixed(3), 'x');
+
+// Find first notes in KAR
+const karFirstNotes = [];
+karMidi.tracks.forEach((track, idx) => {
+  if (track.notes.length > 0 && idx > 0) {
+    const first = track.notes[0];
+    if (first.time < 10) {
+      karFirstNotes.push({ track: idx, time: first.time, midi: first.midi });
+    }
+  }
+});
+karFirstNotes.sort((a, b) => a.time - b.time);
+
+console.log('  First 5 notes in KAR:');
+for (let i = 0; i < Math.min(5, karFirstNotes.length); i++) {
+  console.log(`    Track ${karFirstNotes[i].track}: ${karFirstNotes[i].time.toFixed(3)}s (note ${karFirstNotes[i].midi})`);
+}
+
+let karFirstVocalTime = Infinity;
+for (let i = 0; i < karFirstNotes.length; i++) {
+  if (karFirstNotes[i].time > 1 && karFirstNotes[i].time < 10) {
+    karFirstVocalTime = karFirstNotes[i].time;
+    break;
+  }
+}
+console.log(`  → First vocal note in KAR: ${karFirstVocalTime.toFixed(3)}s`);
+console.log('');
+
+// ============================================================================
+// STEP 7: Read KAR Lyrics with karaoke-player
+// ============================================================================
+console.log('📖 STEP 7: Reading KAR lyrics with karaoke-player...');
+const KarFile = require('./demo-libs/KarFile');
+const karFile = new KarFile();
+karFile.readBuffer(karBuffer);
+const lyrics = karFile.getLyrics();
+
+console.log(`  Total lyrics: ${lyrics.length}`);
+console.log('  First 10 lyrics:');
+for (let i = 0; i < Math.min(10, lyrics.length); i++) {
+  const lyric = lyrics[i];
+  const text = lyric.text.replace(/\n/g, ' ').substring(0, 40);
+  console.log(`    [${i}] ${(lyric.time / 1000).toFixed(3)}s - "${text}"`);
+}
+
+// Find first real lyric
+let firstRealLyricIndex = -1;
+let firstLyricTime = 0;
+for (let i = 0; i < lyrics.length; i++) {
+  const text = lyrics[i].text.replace(/[\.\*\s]/g, '');
+  if (text.length > 3 && !/^(Intro|intro)/.test(text)) {
+    firstRealLyricIndex = i;
+    firstLyricTime = lyrics[i].time / 1000;
+    break;
+  }
+}
+
+if (firstRealLyricIndex >= 0) {
+  console.log(`  → First real lyric: [${firstRealLyricIndex}] ${firstLyricTime.toFixed(3)}s`);
+  console.log(`     Text: "${lyrics[firstRealLyricIndex].text.substring(0, 50)}"`);
+}
+console.log('');
+
+// ============================================================================
+// STEP 8: DIAGNOSIS
+// ============================================================================
+console.log('🔬 STEP 8: DIAGNOSIS');
+console.log('  ' + '='.repeat(76));
+console.log('');
+
+console.log('  📊 Timeline Comparison:');
+console.log('  ' + '-'.repeat(76));
+console.log('  Event                          | EMK Original | KAR File  | Difference');
+console.log('  ' + '-'.repeat(76));
+console.log(`  First vocal note              | ${firstVocalTime.toFixed(3)}s      | ${karFirstVocalTime.toFixed(3)}s   | ${(karFirstVocalTime - firstVocalTime).toFixed(3)}s`);
+console.log(`  First lyric (karaoke-player)  | -            | ${firstLyricTime.toFixed(3)}s   | -`);
+console.log(`  Lyric vs Vocal gap            | -            | -         | ${(firstLyricTime - karFirstVocalTime).toFixed(3)}s`);
+console.log('  ' + '-'.repeat(76));
+console.log('');
+
+const lyricVocalGap = firstLyricTime - karFirstVocalTime;
+
+if (Math.abs(lyricVocalGap) < 0.3) {
+  console.log('  ✅ TIMING IS GOOD: Lyrics and vocals are synchronized (< 0.3s gap)');
+} else if (lyricVocalGap < 0) {
+  console.log(`  ❌ PROBLEM: LYRICS TOO EARLY by ${Math.abs(lyricVocalGap).toFixed(3)}s`);
+  console.log('');
+  console.log('  🔍 Root Cause Analysis:');
+  console.log('     Lyrics appear BEFORE the singing starts.');
+  console.log('     This means cursor timing is NOT being scaled correctly!');
+  console.log('');
+  console.log('  💡 Expected behavior:');
+  console.log(`     - Vocal note: ${karFirstVocalTime.toFixed(3)}s`);
+  console.log(`     - Lyric should appear: ~${karFirstVocalTime.toFixed(3)}s`);
+  console.log(`     - Actual lyric: ${firstLyricTime.toFixed(3)}s`);
+  console.log(`     - Gap: ${Math.abs(lyricVocalGap).toFixed(3)}s too early`);
+  console.log('');
+  console.log('  🔧 Solution:');
+  console.log('     The cursor timing values need to be multiplied by the TEMPO RATIO!');
+  console.log(`     Tempo ratio: ${(karTempo / originalTempo).toFixed(3)}x`);
+  console.log(`     Cursor should be scaled: rawCursor * ${(karTempo / originalTempo).toFixed(3)}`);
+} else {
+  console.log(`  ⚠️  PROBLEM: LYRICS TOO LATE by ${lyricVocalGap.toFixed(3)}s`);
+  console.log('     Lyrics appear AFTER the singing starts.');
+}
+
+console.log('');
+console.log('  ' + '='.repeat(76));
+console.log('');
+
+// Cleanup
+fs.unlinkSync(outputKar);
+
+console.log('✅ Debug complete!');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karaplay/file-coder",
-  "version": "1.5.5",
+  "version": "1.5.6",
   "description": "A comprehensive library for encoding/decoding karaoke files (.emk, .kar, MIDI) with Next.js support. Convert EMK to KAR, read/write karaoke files, full browser and server support.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -30,7 +30,9 @@
     "test:emk:verbose": "node verify-emk-reference.js --verbose",
     "analyze:emk": "node analyze-all-emk.js",
     "prepare": "npm run build",
-    "demo": "node demo-server.js"
+    "demo": "node demo-server.js",
+    "stop": "node stop-demo.js",
+    "restart": "node restart-demo.js"
   },
   "keywords": [
     "karaoke",

package/restart-demo.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+const { execSync, spawn } = require('child_process');
+const os = require('os');
+
+const PORT = 3000;
+const platform = os.platform();
+
+console.log('🔄 Restarting demo server...\n');
+
+// Function to kill process on port
+function killProcessOnPort(port) {
+  try {
+    if (platform === 'win32') {
+      // Windows
+      console.log(`🔍 Finding process on port ${port} (Windows)...`);
+      const output = execSync(`netstat -ano | findstr :${port}`, { encoding: 'utf8' });
+      const lines = output.split('\n').filter(line => line.includes('LISTENING'));
+      
+      if (lines.length > 0) {
+        const pid = lines[0].trim().split(/\s+/).pop();
+        console.log(`❌ Killing process ${pid}...`);
+        execSync(`taskkill /F /PID ${pid}`);
+        console.log('✅ Old process killed\n');
+      } else {
+        console.log('✅ No process found on port (clean start)\n');
+      }
+    } else {
+      // macOS/Linux
+      console.log(`🔍 Finding process on port ${port} (macOS/Linux)...`);
+      
+      // Try method 1: lsof + kill (works in most cases)
+      try {
+        const output = execSync(`lsof -ti:${port}`, { encoding: 'utf8' });
+        const pids = output.trim().split('\n').filter(pid => pid);
+        
+        if (pids.length > 0) {
+          pids.forEach(pid => {
+            try {
+              console.log(`❌ Killing process ${pid}...`);
+              execSync(`kill -9 ${pid}`, { stdio: 'ignore' });
+              console.log('✅ Process killed\n');
+            } catch (killErr) {
+              // Try pkill as fallback
+              try {
+                console.log(`⚠️  kill failed, trying pkill...`);
+                execSync(`pkill -9 -f "node.*demo-server"`, { stdio: 'ignore' });
+                console.log('✅ Process killed via pkill\n');
+              } catch (pkillErr) {
+                console.log(`⚠️  Could not kill process (will continue anyway)\n`);
+              }
+            }
+          });
+          
+          // Wait a bit for port to be released
+          console.log('⏳ Waiting for port to be released...');
+          execSync('sleep 1');
+        } else {
+          console.log('✅ No process found on port\n');
+        }
+      } catch (err) {
+        // lsof returns error if no process found - try pkill as last resort
+        try {
+          execSync(`pkill -9 -f "node.*demo-server"`, { stdio: 'ignore' });
+          console.log('✅ Killed via pkill\n');
+          execSync('sleep 1');
+        } catch {
+          console.log('✅ No process found on port (clean start)\n');
+        }
+      }
+    }
+  } catch (error) {
+    console.error('⚠️  Error killing process:', error.message);
+    console.log('Continuing anyway...\n');
+  }
+}
+
+// Kill old process
+killProcessOnPort(PORT);
+
+// Start new server
+console.log('🚀 Starting demo server...\n');
+console.log('='.repeat(80));
+
+const server = spawn('node', ['demo-server.js'], {
+  stdio: 'inherit'
+});
+
+server.on('error', (err) => {
+  console.error('❌ Failed to start server:', err);
+  process.exit(1);
+});
+
+// Handle Ctrl+C
+process.on('SIGINT', () => {
+  console.log('\n\n🛑 Stopping server...');
+  server.kill('SIGINT');
+  process.exit(0);
+});
+
+process.on('SIGTERM', () => {
+  console.log('\n\n🛑 Stopping server...');
+  server.kill('SIGTERM');
+  process.exit(0);
+});

package/start-demo.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+echo "======================================"
+echo "🎤 Starting EMK to KAR Demo Server"
+echo "======================================"
+echo ""
+echo "Server will start at: http://localhost:3000"
+echo "Demo page: http://localhost:3000/demo-simple.html"
+echo ""
+echo "Press Ctrl+C to stop"
+echo ""
+
+node demo-server.js

package/stop-demo.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const os = require('os');
+
+const PORT = 3000;
+const platform = os.platform();
+
+console.log('🛑 Stopping demo server...\n');
+
+// Function to kill process on port
+function killProcessOnPort(port) {
+  let killed = false;
+  
+  try {
+    if (platform === 'win32') {
+      // Windows
+      console.log(`🔍 Finding process on port ${port} (Windows)...`);
+      const output = execSync(`netstat -ano | findstr :${port}`, { encoding: 'utf8' });
+      const lines = output.split('\n').filter(line => line.includes('LISTENING'));
+      
+      if (lines.length > 0) {
+        const pid = lines[0].trim().split(/\s+/).pop();
+        console.log(`❌ Killing process ${pid}...`);
+        execSync(`taskkill /F /PID ${pid}`);
+        console.log('✅ Server stopped!\n');
+        killed = true;
+      }
+    } else {
+      // macOS/Linux
+      console.log(`🔍 Finding process on port ${port} (macOS/Linux)...`);
+      
+      // Try method 1: pkill (most reliable for node processes)
+      try {
+        console.log(`🔍 Trying pkill for demo-server...`);
+        execSync(`pkill -9 -f "node.*demo-server"`, { encoding: 'utf8' });
+        console.log('✅ Server stopped via pkill!');
+        killed = true;
+        execSync('sleep 1'); // Wait for port to be released
+      } catch (pkillErr) {
+        // pkill didn't find process or failed
+      }
+      
+      // Try method 2: lsof + kill (if pkill didn't work)
+      if (!killed) {
+        try {
+          const output = execSync(`lsof -ti:${port}`, { encoding: 'utf8' });
+          const pids = output.trim().split('\n').filter(pid => pid);
+          
+          if (pids.length > 0) {
+            pids.forEach(pid => {
+              try {
+                console.log(`🔍 Found process ${pid} on port ${port}`);
+                console.log(`❌ Killing process ${pid}...`);
+                execSync(`kill -9 ${pid}`, { encoding: 'utf8' });
+                console.log('✅ Process killed');
+                killed = true;
+              } catch (killErr) {
+                console.log(`⚠️  Could not kill ${pid}: ${killErr.message}`);
+              }
+            });
+            if (killed) {
+              execSync('sleep 1'); // Wait for port to be released
+            }
+          }
+        } catch (err) {
+          // lsof failed, no process found
+        }
+      }
+    }
+    
+    if (killed) {
+      console.log('\n✅ Demo server stopped successfully!\n');
+    } else {
+      console.log('\n⚠️  No demo server found running on port', port, '\n');
+    }
+    
+  } catch (error) {
+    console.log('\n⚠️  No demo server found running\n');
+  }
+}
+
+// Kill process
+killProcessOnPort(PORT);