@karaplay/file-coder 1.5.0 → 1.5.2

package/demo-simple.html

@@ -300,10 +300,10 @@
       <h1>🎤 EMK to KAR Conversion Demo</h1>
       <p>
         Testing <strong>@karaplay/file-coder</strong> 
-        <span class="version">v1.4.9</span>
+        <span class="version">v1.5.0</span>
       </p>
       <p style="margin-top: 10px; color: #666;">
-        ✨ ZXIO Format Tempo Fix (2.78x) | MThd Format (4x) | Simple Audio Playback
+        ✨ ZXIO Format Duration Fix (1.24x) | MThd Format (4x) | Simple Audio Playback
       </p>
     </div>
     
@@ -365,9 +365,9 @@
           <h3 style="color: #667eea; margin-top: 25px; margin-bottom: 10px;">📊 Comparison: EMK vs KAR</h3>
           <div class="status info" style="margin-bottom: 15px;">
             <strong>💡 Why Duration Decreases:</strong><br>
-            When tempo increases (×2.78), the music plays faster, so the total duration decreases proportionally (×0.36).<br>
-            <strong>Formula:</strong> Duration Ratio × Tempo Ratio = 0.36 × 2.78 ≈ 1.0 ✅<br>
-            <strong>This is correct!</strong> The MIDI notes are the same, but they play faster at higher BPM.
+            When tempo increases (×1.24), the music plays faster, so the total duration decreases proportionally (×0.81).<br>
+            <strong>Formula:</strong> Duration Ratio × Tempo Ratio = 0.81 × 1.24 ≈ 1.0 ✅<br>
+            <strong>This is correct!</strong> The MIDI notes are the same, but they play faster at higher BPM. The converted KAR now matches the original song duration (4:42-4:45).
           </div>
           <table class="comparison-table">
             <thead>
@@ -384,6 +384,35 @@
         </div>
         
         <div id="statusContainer"></div>
+        
+        <!-- MIDI Player -->
+        <div id="playerContainer" style="display: none; margin-top: 25px;">
+          <h3 style="color: #667eea; margin-bottom: 15px;">🎵 MIDI Player</h3>
+          <div class="card" style="padding: 20px;">
+            <div style="display: flex; align-items: center; gap: 15px; margin-bottom: 15px;">
+              <button id="playBtn" class="convert-btn" style="flex: 0 0 auto; min-width: 100px;">
+                ▶️ Play
+              </button>
+              <button id="pauseBtn" class="convert-btn" style="flex: 0 0 auto; min-width: 100px; display: none;">
+                ⏸️ Pause
+              </button>
+              <button id="stopBtn" class="convert-btn" style="flex: 0 0 auto; min-width: 100px;">
+                ⏹️ Stop
+              </button>
+              <div style="flex: 1;">
+                <div style="font-size: 14px; color: #666; margin-bottom: 5px;">
+                  <span id="currentTime">0:00</span> / <span id="totalTime">0:00</span>
+                </div>
+                <div style="width: 100%; height: 6px; background: #e0e0e0; border-radius: 3px; overflow: hidden;">
+                  <div id="progressBar" style="width: 0%; height: 100%; background: linear-gradient(90deg, #667eea, #764ba2); transition: width 0.1s;"></div>
+                </div>
+              </div>
+            </div>
+            <div id="playerStatus" style="font-size: 14px; color: #666; padding: 10px; background: #f8f9fa; border-radius: 6px;">
+              ⏳ Ready to play...
+            </div>
+          </div>
+        </div>
       </div>
     </div>
   </div>
@@ -507,6 +536,10 @@
       const convertBtn = document.getElementById('convertBtn');
       const downloadBtn = document.getElementById('downloadBtn');
       
+      // Stop and hide player
+      stopMidi();
+      document.getElementById('playerContainer').style.display = 'none';
+      
       convertBtn.disabled = true;
       convertBtn.innerHTML = '<div class="loading"></div> Converting...';
       
@@ -554,6 +587,10 @@
           document.getElementById('lyricsDisplay').textContent = '✅ Conversion Complete!';
           downloadBtn.disabled = false;
           
+          // Show player
+          document.getElementById('playerContainer').style.display = 'block';
+          midiPlayer.parsedData = null; // Reset to force re-parse
+          
         } else {
           showStatus('error', `❌ Conversion failed!<br>${data.error}`);
           document.getElementById('lyricsDisplay').textContent = 'Conversion failed';
@@ -664,7 +701,7 @@
           emk: '-',
           kar: `${tempoRatio.toFixed(2)}x`,
           change: emkInfo.format === 'ZXIO' ? 
-                  (Math.abs(tempoRatio - 2.78) < 0.1 ? '✅ Correct (2.78x)' : '⚠️ Unexpected') :
+                  (Math.abs(tempoRatio - 1.24) < 0.1 ? '✅ Correct (1.24x)' : '⚠️ Unexpected') :
                   (Math.abs(tempoRatio - 4) < 0.5 ? '✅ Correct (~4x)' : '⚠️ Unexpected')
         }
       ];
@@ -701,9 +738,252 @@
       container.innerHTML = `<div class="status ${type}">${message}</div>`;
     }
     
-    // Event listeners
+    // =================================================================
+    // SIMPLE MIDI PLAYER (using karaoke-player libs + Web Audio API)
+    // =================================================================
+    let midiPlayer = {
+      ac: null,
+      parsedData: null,
+      isPlaying: false,
+      isPaused: false,
+      startTime: 0,
+      pausedTime: 0,
+      activeOscillators: {},
+      updateInterval: null,
+      totalDuration: 0
+    };
+    
+    function initMidiPlayer() {
+      if (!midiPlayer.ac) {
+        midiPlayer.ac = new (window.AudioContext || window.webkitAudioContext)();
+      }
+      document.getElementById('playerStatus').innerHTML = '✅ Ready to play!';
+    }
+    
+    async function parseMidiData(base64Data) {
+      try {
+        document.getElementById('playerStatus').innerHTML = '⏳ Parsing MIDI...';
+        
+        // Call server to parse using karaoke-player libs
+        const response = await fetch('/api/parse-kar', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ karData: base64Data })
+        });
+        
+        const data = await response.json();
+        
+        if (!data.success) {
+          throw new Error(data.error || 'Failed to parse MIDI');
+        }
+        
+        document.getElementById('playerStatus').innerHTML = '✅ MIDI parsed!';
+        return data;
+      } catch (error) {
+        console.error('MIDI parse error:', error);
+        throw error;
+      }
+    }
+    
+    // MIDI note to frequency conversion
+    function midiNoteToFrequency(note) {
+      return 440 * Math.pow(2, (note - 69) / 12);
+    }
+    
+    function formatTime(seconds) {
+      const mins = Math.floor(seconds / 60);
+      const secs = Math.floor(seconds % 60);
+      return `${mins}:${String(secs).padStart(2, '0')}`;
+    }
+    
+    async function playMidi() {
+      if (!convertedKarData) {
+        alert('Please convert a file first!');
+        return;
+      }
+      
+      try {
+        initMidiPlayer();
+        
+        if (!midiPlayer.parsedData) {
+          midiPlayer.parsedData = await parseMidiData(convertedKarData);
+        }
+        
+        if (midiPlayer.isPaused) {
+          resumeMidi();
+          return;
+        }
+        
+        // Stop any playing notes
+        stopMidi();
+        
+        const events = midiPlayer.parsedData.events;
+        
+        // Use duration from server (Tone.js gives accurate duration)
+        midiPlayer.totalDuration = midiPlayer.parsedData.duration || 0;
+        
+        // Convert from milliseconds to seconds
+        const totalSeconds = midiPlayer.totalDuration / 1000;
+        document.getElementById('totalTime').textContent = formatTime(totalSeconds);
+        
+        console.log('🎵 Player Info:');
+        console.log('   Events:', events.length);
+        console.log('   Duration:', totalSeconds.toFixed(2), 'seconds');
+        console.log('   Duration:', formatTime(totalSeconds));
+        
+        // Start playback
+        midiPlayer.isPlaying = true;
+        midiPlayer.isPaused = false;
+        midiPlayer.startTime = midiPlayer.ac.currentTime;
+        midiPlayer.activeOscillators = {};
+        
+        document.getElementById('playBtn').style.display = 'none';
+        document.getElementById('pauseBtn').style.display = 'block';
+        document.getElementById('playerStatus').innerHTML = `▶️ Playing... (${events.length} events)`;
+        
+        // Schedule all notes
+        events.forEach(event => {
+          const scheduleTime = midiPlayer.startTime + (event.time / 1000); // Convert ms to seconds
+          const noteKey = `${event.track}_${event.note}`;
+          
+          // Note On (type 9 = NOTE_ON)
+          if (event.type === 9 && event.velocity > 0) {
+            // Schedule note start
+            setTimeout(() => {
+              if (!midiPlayer.isPlaying) return;
+              
+              try {
+                // Create oscillator
+                const oscillator = midiPlayer.ac.createOscillator();
+                const gainNode = midiPlayer.ac.createGain();
+                
+                oscillator.connect(gainNode);
+                gainNode.connect(midiPlayer.ac.destination);
+                
+                // Set frequency from MIDI note
+                oscillator.frequency.value = midiNoteToFrequency(event.note);
+                oscillator.type = 'sine';
+                
+                // Set volume from velocity
+                gainNode.gain.value = (event.velocity / 127) * 0.3; // Scale down volume
+                
+                // Start oscillator
+                oscillator.start(scheduleTime);
+                
+                // Store for note off
+                midiPlayer.activeOscillators[noteKey] = { oscillator, gainNode, startTime: scheduleTime };
+              } catch (e) {
+                console.error('Note start error:', e);
+              }
+            }, Math.max(0, (event.time / 1000) * 1000));
+          }
+          
+          // Note Off (type 8 = NOTE_OFF or type 9 with velocity 0)
+          if (event.type === 8 || (event.type === 9 && event.velocity === 0)) {
+            // Schedule note stop
+            setTimeout(() => {
+              if (!midiPlayer.isPlaying) return;
+              
+              try {
+                const osc = midiPlayer.activeOscillators[noteKey];
+                if (osc) {
+                  // Fade out
+                  osc.gainNode.gain.exponentialRampToValueAtTime(0.01, scheduleTime + 0.1);
+                  osc.oscillator.stop(scheduleTime + 0.1);
+                  delete midiPlayer.activeOscillators[noteKey];
+                }
+              } catch (e) {
+                console.error('Note stop error:', e);
+              }
+            }, Math.max(0, (event.time / 1000) * 1000));
+          }
+        });
+        
+        // Update progress
+        midiPlayer.updateInterval = setInterval(() => {
+          if (!midiPlayer.isPlaying) {
+            clearInterval(midiPlayer.updateInterval);
+            return;
+          }
+          
+          const currentTime = midiPlayer.ac.currentTime - midiPlayer.startTime;
+          document.getElementById('currentTime').textContent = formatTime(currentTime);
+          
+          const progress = (currentTime / totalSeconds) * 100;
+          document.getElementById('progressBar').style.width = Math.min(progress, 100) + '%';
+          
+          if (currentTime >= totalSeconds + 1) {
+            stopMidi();
+          }
+        }, 100);
+        
+      } catch (error) {
+        console.error('Play error:', error);
+        document.getElementById('playerStatus').innerHTML = '❌ Play error: ' + error.message;
+      }
+    }
+    
+    function pauseMidi() {
+      if (!midiPlayer.isPlaying) return;
+      
+      midiPlayer.isPaused = true;
+      midiPlayer.isPlaying = false;
+      midiPlayer.pausedTime = midiPlayer.ac.currentTime - midiPlayer.startTime;
+      
+      // Stop all active oscillators
+      Object.values(midiPlayer.activeOscillators).forEach(osc => {
+        try {
+          osc.oscillator.stop();
+        } catch (e) {}
+      });
+      midiPlayer.activeOscillators = {};
+      
+      document.getElementById('playBtn').style.display = 'block';
+      document.getElementById('pauseBtn').style.display = 'none';
+      document.getElementById('playerStatus').innerHTML = '⏸️ Paused';
+      
+      if (midiPlayer.updateInterval) {
+        clearInterval(midiPlayer.updateInterval);
+      }
+    }
+    
+    function resumeMidi() {
+      // For simplicity, restart from beginning
+      playMidi();
+    }
+    
+    function stopMidi() {
+      midiPlayer.isPlaying = false;
+      midiPlayer.isPaused = false;
+      midiPlayer.pausedTime = 0;
+      
+      // Stop all active oscillators
+      Object.values(midiPlayer.activeOscillators).forEach(osc => {
+        try {
+          osc.oscillator.stop();
+        } catch (e) {}
+      });
+      midiPlayer.activeOscillators = {};
+      
+      document.getElementById('playBtn').style.display = 'block';
+      document.getElementById('pauseBtn').style.display = 'none';
+      document.getElementById('currentTime').textContent = '0:00';
+      document.getElementById('progressBar').style.width = '0%';
+      document.getElementById('playerStatus').innerHTML = '⏹️ Stopped';
+      
+      if (midiPlayer.updateInterval) {
+        clearInterval(midiPlayer.updateInterval);
+      }
+    }
+    
+    // =================================================================
+    // EVENT LISTENERS
+    // =================================================================
     document.getElementById('convertBtn').addEventListener('click', convertFile);
     document.getElementById('downloadBtn').addEventListener('click', downloadKar);
+    document.getElementById('playBtn').addEventListener('click', playMidi);
+    document.getElementById('pauseBtn').addEventListener('click', pauseMidi);
+    document.getElementById('stopBtn').addEventListener('click', stopMidi);
     
     // Initialize
     loadFileList();

package/dist/index.d.ts

@@ -10,3 +10,4 @@ export { decodeEmk as decodeEmkClient, parseSongInfo as parseSongInfoClient, xor
 export { convertNcnToKarBrowser, parseLyricBuffer, buildKaraokeTrackBrowser, buildMetadataTracksBrowser, fileToBuffer, downloadBuffer, type BrowserConversionOptions, type BrowserConversionResult, } from './ncntokar.browser';
 export { convertEmkToKarBrowser, convertEmkFileToKar, convertEmkFilesBatch, validateThaiLyricReadabilityBrowser, type BrowserEmkToKarOptions, type BrowserEmkToKarResult, } from './emk-to-kar.browser';
 export { readKarBuffer, validateKarBuffer, extractLyricsFromKarBuffer, readKarFile as readKarFileFromBrowser, type KarFileInfo as BrowserKarFileInfo, type KarTrack as BrowserKarTrack, } from './kar-reader.browser';
+export { validateKarFile as validateKarTempo, compareEmkKarTempo, type KarValidationResult } from './kar-validator';

package/dist/index.js

@@ -4,7 +4,7 @@
  * Supports .emk (Extreme Karaoke), .kar (MIDI karaoke), and NCN format conversions
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readKarFileFromBrowser = exports.extractLyricsFromKarBuffer = exports.validateKarBuffer = exports.readKarBuffer = exports.validateThaiLyricReadabilityBrowser = exports.convertEmkFilesBatch = exports.convertEmkFileToKar = exports.convertEmkToKarBrowser = exports.downloadBuffer = exports.fileToBuffer = exports.buildMetadataTracksBrowser = exports.buildKaraokeTrackBrowser = exports.parseLyricBuffer = exports.convertNcnToKarBrowser = exports.looksLikeTextClient = exports.xorDecryptClient = exports.parseSongInfoClient = exports.decodeEmkClient = exports.looksLikeTextServer = exports.xorDecryptServer = exports.parseSongInfoServer = exports.decodeEmkServer = exports.validateThaiLyricReadability = exports.convertEmkToKarBatch = exports.convertEmkToKar = exports.extractLyricsFromKar = exports.validateKarFile = exports.readKarFile = exports.CursorReader = exports.ensureOutputDoesNotExist = exports.ensureReadableFile = exports.endOfTrack = exports.metaEvent = exports.trimLineEndings = exports.splitLinesKeepEndings = exports.readFileTextTIS620 = exports.buildMetadataTracks = exports.buildKaraokeTrack = exports.parseLyricFile = exports.convertWithDefaults = exports.convertNcnToKar = void 0;
+exports.compareEmkKarTempo = exports.validateKarTempo = exports.readKarFileFromBrowser = exports.extractLyricsFromKarBuffer = exports.validateKarBuffer = exports.readKarBuffer = exports.validateThaiLyricReadabilityBrowser = exports.convertEmkFilesBatch = exports.convertEmkFileToKar = exports.convertEmkToKarBrowser = exports.downloadBuffer = exports.fileToBuffer = exports.buildMetadataTracksBrowser = exports.buildKaraokeTrackBrowser = exports.parseLyricBuffer = exports.convertNcnToKarBrowser = exports.looksLikeTextClient = exports.xorDecryptClient = exports.parseSongInfoClient = exports.decodeEmkClient = exports.looksLikeTextServer = exports.xorDecryptServer = exports.parseSongInfoServer = exports.decodeEmkServer = exports.validateThaiLyricReadability = exports.convertEmkToKarBatch = exports.convertEmkToKar = exports.extractLyricsFromKar = exports.validateKarFile = exports.readKarFile = exports.CursorReader = exports.ensureOutputDoesNotExist = exports.ensureReadableFile = exports.endOfTrack = exports.metaEvent = exports.trimLineEndings = exports.splitLinesKeepEndings = exports.readFileTextTIS620 = exports.buildMetadataTracks = exports.buildKaraokeTrack = exports.parseLyricFile = exports.convertWithDefaults = exports.convertNcnToKar = void 0;
 // NCN to KAR converter exports
 var ncntokar_1 = require("./ncntokar");
 Object.defineProperty(exports, "convertNcnToKar", { enumerable: true, get: function () { return ncntokar_1.convertNcnToKar; } });
@@ -62,3 +62,7 @@ Object.defineProperty(exports, "readKarBuffer", { enumerable: true, get: functio
 Object.defineProperty(exports, "validateKarBuffer", { enumerable: true, get: function () { return kar_reader_browser_1.validateKarBuffer; } });
 Object.defineProperty(exports, "extractLyricsFromKarBuffer", { enumerable: true, get: function () { return kar_reader_browser_1.extractLyricsFromKarBuffer; } });
 Object.defineProperty(exports, "readKarFileFromBrowser", { enumerable: true, get: function () { return kar_reader_browser_1.readKarFile; } });
+// KAR tempo/duration validator exports (NEW v1.5.0+)
+var kar_validator_1 = require("./kar-validator");
+Object.defineProperty(exports, "validateKarTempo", { enumerable: true, get: function () { return kar_validator_1.validateKarFile; } });
+Object.defineProperty(exports, "compareEmkKarTempo", { enumerable: true, get: function () { return kar_validator_1.compareEmkKarTempo; } });

package/dist/kar-validator.d.ts

@@ -0,0 +1,66 @@
+/**
+ * KAR File Validation Utilities
+ * Validates tempo, duration, and format accuracy
+ */
+export interface KarValidationResult {
+    valid: boolean;
+    tempo: number;
+    duration: number;
+    durationMinutes: string;
+    ppq: number;
+    trackCount: number;
+    noteCount: number;
+    format: number;
+    warnings: string[];
+    errors: string[];
+}
+/**
+ * Validate KAR file accuracy using Tone.js
+ *
+ * This function uses @tonejs/midi which handles tempo events correctly,
+ * providing accurate duration calculations.
+ *
+ * @param karBuffer - KAR file buffer
+ * @returns Validation results with tempo and duration info
+ *
+ * @example
+ * ```typescript
+ * import { validateKarFile } from '@karaplay/file-coder';
+ * import * as fs from 'fs';
+ *
+ * const karBuffer = fs.readFileSync('song.kar');
+ * const validation = validateKarFile(karBuffer);
+ *
+ * console.log(`Valid: ${validation.valid}`);
+ * console.log(`Tempo: ${validation.tempo} BPM`);
+ * console.log(`Duration: ${validation.durationMinutes}`);
+ * ```
+ */
+export declare function validateKarFile(karBuffer: Buffer): KarValidationResult;
+/**
+ * Compare EMK and converted KAR tempo/duration
+ *
+ * @param emkBuffer - Original EMK file buffer
+ * @param karBuffer - Converted KAR file buffer
+ * @returns Comparison results
+ *
+ * @example
+ * ```typescript
+ * import { compareEmkKarTempo } from '@karaplay/file-coder';
+ *
+ * const comparison = compareEmkKarTempo(emkBuffer, karBuffer);
+ * console.log(`Tempo ratio: ${comparison.tempoRatio.toFixed(2)}x`);
+ * console.log(`Format: ${comparison.format}`);
+ * ```
+ */
+export declare function compareEmkKarTempo(emkBuffer: Buffer, karBuffer: Buffer): {
+    emkTempo: number;
+    karTempo: number;
+    tempoRatio: number;
+    emkDuration: number;
+    karDuration: number;
+    durationRatio: number;
+    format: string;
+    expectedRatio: number;
+    ratioMatch: boolean;
+};

package/dist/kar-validator.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * KAR File Validation Utilities
+ * Validates tempo, duration, and format accuracy
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateKarFile = validateKarFile;
+exports.compareEmkKarTempo = compareEmkKarTempo;
+/**
+ * Validate KAR file accuracy using Tone.js
+ *
+ * This function uses @tonejs/midi which handles tempo events correctly,
+ * providing accurate duration calculations.
+ *
+ * @param karBuffer - KAR file buffer
+ * @returns Validation results with tempo and duration info
+ *
+ * @example
+ * ```typescript
+ * import { validateKarFile } from '@karaplay/file-coder';
+ * import * as fs from 'fs';
+ *
+ * const karBuffer = fs.readFileSync('song.kar');
+ * const validation = validateKarFile(karBuffer);
+ *
+ * console.log(`Valid: ${validation.valid}`);
+ * console.log(`Tempo: ${validation.tempo} BPM`);
+ * console.log(`Duration: ${validation.durationMinutes}`);
+ * ```
+ */
+function validateKarFile(karBuffer) {
+    const warnings = [];
+    const errors = [];
+    try {
+        // Dynamic import to avoid bundling issues
+        const { Midi } = require('@tonejs/midi');
+        const midi = new Midi(karBuffer);
+        // Get basic info
+        const tempo = midi.header.tempos.length > 0 ? midi.header.tempos[0].bpm : 0;
+        const duration = midi.duration;
+        const ppq = midi.header.ppq;
+        const trackCount = midi.tracks.length;
+        // Count notes
+        let noteCount = 0;
+        midi.tracks.forEach((track) => {
+            noteCount += track.notes.length;
+        });
+        // Format duration
+        const minutes = Math.floor(duration / 60);
+        const seconds = Math.floor(duration % 60);
+        const durationMinutes = `${minutes}:${String(seconds).padStart(2, '0')}`;
+        // Validation checks
+        if (tempo === 0) {
+            warnings.push('No tempo event found - may use default 120 BPM');
+        }
+        if (duration === 0) {
+            errors.push('Duration is zero - file may be corrupt or empty');
+        }
+        if (noteCount === 0) {
+            warnings.push('No notes found - file may be empty');
+        }
+        if (trackCount === 0) {
+            errors.push('No tracks found - file may be corrupt');
+        }
+        // Check for unusual values
+        if (tempo > 300) {
+            warnings.push(`High tempo detected (${tempo.toFixed(0)} BPM) - verify playback speed`);
+        }
+        if (duration < 10) {
+            warnings.push(`Very short duration (${duration.toFixed(1)}s) - verify timing`);
+        }
+        return {
+            valid: errors.length === 0,
+            tempo,
+            duration,
+            durationMinutes,
+            ppq,
+            trackCount,
+            noteCount,
+            format: midi.header.format,
+            warnings,
+            errors
+        };
+    }
+    catch (error) {
+        errors.push(`Failed to parse KAR file: ${error?.message || String(error)}`);
+        return {
+            valid: false,
+            tempo: 0,
+            duration: 0,
+            durationMinutes: '0:00',
+            ppq: 0,
+            trackCount: 0,
+            noteCount: 0,
+            format: 0,
+            warnings,
+            errors
+        };
+    }
+}
+/**
+ * Compare EMK and converted KAR tempo/duration
+ *
+ * @param emkBuffer - Original EMK file buffer
+ * @param karBuffer - Converted KAR file buffer
+ * @returns Comparison results
+ *
+ * @example
+ * ```typescript
+ * import { compareEmkKarTempo } from '@karaplay/file-coder';
+ *
+ * const comparison = compareEmkKarTempo(emkBuffer, karBuffer);
+ * console.log(`Tempo ratio: ${comparison.tempoRatio.toFixed(2)}x`);
+ * console.log(`Format: ${comparison.format}`);
+ * ```
+ */
+function compareEmkKarTempo(emkBuffer, karBuffer) {
+    try {
+        const { Midi } = require('@tonejs/midi');
+        // Import from index to get proper exports
+        const index = require('./index');
+        const decodeEmkServer = index.decodeEmkServer || require('./emk/server-decode').decodeEmk;
+        // Decode EMK
+        const decoded = decodeEmkServer(emkBuffer);
+        const emkMidi = new Midi(decoded.midi);
+        // Parse KAR
+        const karMidi = new Midi(karBuffer);
+        const emkTempo = emkMidi.header.tempos[0]?.bpm || 0;
+        const karTempo = karMidi.header.tempos[0]?.bpm || 0;
+        const tempoRatio = karTempo / emkTempo;
+        const emkDuration = emkMidi.duration;
+        const karDuration = karMidi.duration;
+        const durationRatio = karDuration / emkDuration;
+        const format = decoded.isZxioFormat ? 'ZXIO' : 'MThd';
+        const expectedRatio = decoded.isZxioFormat ? 1.24 : 4.0;
+        const ratioMatch = Math.abs(tempoRatio - expectedRatio) < 0.1;
+        return {
+            emkTempo,
+            karTempo,
+            tempoRatio,
+            emkDuration,
+            karDuration,
+            durationRatio,
+            format,
+            expectedRatio,
+            ratioMatch
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to compare EMK/KAR: ${error?.message || String(error)}`);
+    }
+}

package/dist/ncntokar.browser.js

@@ -363,7 +363,19 @@ function ensureTracksHaveEndOfTrack(tracks) {
 function fixEmkMidiTempoBrowser(midi, ticksPerBeat, isZxioFormat = false) {
     // ZXIO format uses a different time base (PPQ / 77.42 instead of PPQ / 24)
     // This gives a ratio of approximately 1.24x instead of 4x
-    const ratio = isZxioFormat ? (ticksPerBeat / 77.42) : (ticksPerBeat / 24);
+    // 
+    // Special case: Some EMK files (e.g., Z2510006.emk) have PPQ >= 480 and are already
+    // properly timed, so they don't need tempo adjustment (ratio = 1x)
+    let ratio;
+    if (isZxioFormat) {
+        ratio = ticksPerBeat / 77.42;
+    }
+    else if (ticksPerBeat >= 480) {
+        ratio = 1.0; // No adjustment needed for high PPQ files
+    }
+    else {
+        ratio = ticksPerBeat / 24; // Standard MThd conversion
+    }
     let fixed = 0;
     // Find and fix all tempo events
     if (midi.tracks) {

package/dist/ncntokar.js

@@ -336,7 +336,19 @@ function ensureTracksHaveEndOfTrack(tracks) {
 function fixEmkMidiTempo(midi, ticksPerBeat, isZxioFormat = false) {
     // ZXIO format uses a different time base (PPQ / 77.42 instead of PPQ / 24)
     // This gives a ratio of approximately 1.24x instead of 4x
-    const ratio = isZxioFormat ? (ticksPerBeat / 77.42) : (ticksPerBeat / 24);
+    // 
+    // Special case: Some EMK files (e.g., Z2510006.emk) have PPQ >= 480 and are already
+    // properly timed, so they don't need tempo adjustment (ratio = 1x)
+    let ratio;
+    if (isZxioFormat) {
+        ratio = ticksPerBeat / 77.42;
+    }
+    else if (ticksPerBeat >= 480) {
+        ratio = 1.0; // No adjustment needed for high PPQ files
+    }
+    else {
+        ratio = ticksPerBeat / 24; // Standard MThd conversion
+    }
     let fixed = 0;
     // Find and fix all tempo events
     if (midi.tracks) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karaplay/file-coder",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "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",
@@ -26,6 +26,9 @@
     "test": "node_modules/.bin/jest",
     "test:watch": "node_modules/.bin/jest --watch",
     "test:coverage": "node_modules/.bin/jest --coverage",
+    "test:emk": "node verify-emk-reference.js",
+    "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"
   },