karaoke-gen 0.103.1__py3-none-any.whl → 0.107.0__py3-none-any.whl

lyrics_transcriber/frontend/.yarnrc.yml

@@ -1,3 +0,0 @@
-nodeLinker: node-modules
-
-yarnPath: .yarn/releases/yarn-4.7.0.cjs

lyrics_transcriber/frontend/README.md

@@ -1,50 +0,0 @@
-# React + TypeScript + Vite
-
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
-
-Currently, two official plugins are available:
-
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
-
-## Expanding the ESLint configuration
-
-If you are developing a production application, we recommend updating the configuration to enable type aware lint rules:
-
-- Configure the top-level `parserOptions` property like this:
-
-```js
-export default tseslint.config({
-  languageOptions: {
-    // other options...
-    parserOptions: {
-      project: ['./tsconfig.node.json', './tsconfig.app.json'],
-      tsconfigRootDir: import.meta.dirname,
-    },
-  },
-})
-```
-
-- Replace `tseslint.configs.recommended` to `tseslint.configs.recommendedTypeChecked` or `tseslint.configs.strictTypeChecked`
-- Optionally add `...tseslint.configs.stylisticTypeChecked`
-- Install [eslint-plugin-react](https://github.com/jsx-eslint/eslint-plugin-react) and update the config:
-
-```js
-// eslint.config.js
-import react from 'eslint-plugin-react'
-
-export default tseslint.config({
-  // Set the react version
-  settings: { react: { version: '18.3' } },
-  plugins: {
-    // Add the react plugin
-    react,
-  },
-  rules: {
-    // other rules...
-    // Enable its recommended rules
-    ...react.configs.recommended.rules,
-    ...react.configs['jsx-runtime'].rules,
-  },
-})
-```

lyrics_transcriber/frontend/REPLACE_ALL_FUNCTIONALITY.md

@@ -1,210 +0,0 @@
-Please read this doc to understand the "Replace All" modal we implemented in a previous chat: @REPLACE_ALL_FUNCTIONALITY.md 
-
-The primary code for the new modal is here: @ReplaceAllLyricsModal.tsx 
-but the manual sync functionality relies heavily on @EditTimelineSection.tsx, @useManualSync.ts  and @EditActionBar.tsx 
-
-The functionality mostly works but we need to continue refining it and fixing issues until it is good enough for me and other users to use. Please let me know once you've reviewed the above and you're ready for me to explain the first issue.
-
-# Replace All Lyrics Functionality
-
-## Overview
-
-The "Replace All Lyrics" functionality provides a complete solution for replacing transcribed lyrics when the original transcription quality is too poor to edit word-by-word. This feature allows users to start fresh with clipboard content and manually sync timing for the entire song.
-
-## Key Components
-
-### 1. ReplaceAllLyricsModal.tsx
-- **Location**: `src/components/ReplaceAllLyricsModal.tsx`
-- **Purpose**: Standalone modal for replacing all lyrics with clipboard content
-- **Design**: Separate from EditModal.tsx to maintain clean separation of concerns
-
-### 2. Integration Points
-- **useManualSync Hook**: Reuses existing manual sync functionality
-- **AudioPlayer Integration**: Leverages global audio controls and duration
-- **Types**: Uses existing LyricsSegment and Word types
-
-## User Workflow
-
-### Phase 1: Input
-1. **Open Modal**: Access via "Replace All Lyrics" button/action
-2. **Paste Content**: Large textarea for pasting lyrics from clipboard
-3. **Real-time Feedback**: 
-   - Line count display
-   - Word count display
-   - Preview of how content will be parsed
-4. **Validation**: Ensures content is not empty before proceeding
-
-### Phase 2: Manual Sync
-1. **Automatic Conversion**: Each line becomes a LyricsSegment, each word becomes a Word object
-2. **Timeline View**: 
-   - Fixed 30-second zoom window
-   - Shows entire song duration (0 to audio duration)
-   - Visual indicators for word positions
-3. **Manual Timing**: 
-   - Spacebar to mark word timings during playback
-   - Pause/resume functionality for corrections
-   - Real-time progress tracking
-4. **Progress Panel**: 
-   - Shows all segments with sync status
-   - Active segment highlighting (blue)
-   - Completed segments (green) with timing display
-   - Progress indicators (X/Y words synced)
-   - Auto-scroll to follow playback
-
-## Technical Implementation
-
-### Data Structure
-```typescript
-// Each line becomes a LyricsSegment
-{
-  id: string,
-  text: string, // Full line text
-  start_time: number | null,
-  end_time: number | null,
-  words: Word[] // Each word in the line
-}
-
-// Each word becomes a Word object
-{
-  id: string,
-  text: string, // Individual word
-  start_time: number | null,
-  end_time: number | null,
-  confidence: number // Set to 1.0 for manual entries
-}
-```
-
-### Modal Layout
-- **Full Browser Width**: Uses `maxWidth={false}` and viewport-based calculations
-- **Split Layout**: 
-  - Timeline Section: 2/3 width
-  - Progress Panel: 1/3 width
-- **Responsive Design**: Adapts to different screen sizes
-
-### Audio Integration
-- **Duration Detection**: Uses `window.getAudioDuration()` for accurate song length
-- **Playback Control**: Integrates with existing audio controls
-- **Auto-cleanup**: Stops audio when canceling sync
-
-## Key Features Implemented
-
-### 1. Stable Timeline View
-- **Fixed Zoom**: Always shows 30-second window
-- **Full Song Range**: Timeline spans 0 to full audio duration
-- **Prevents Zoom Changes**: Disabled during manual sync to maintain consistency
-
-### 2. Manual Sync Enhancement
-- **Spacebar Timing**: Press spacebar to mark word timings
-- **Pause/Resume**: Alt+P to pause/resume for corrections
-- **Visual Feedback**: 
-  - Current word highlighting
-  - Spacebar press indication
-  - Progress tracking
-
-### 3. Progress Tracking
-- **Segment Status**: Visual indicators for sync progress
-- **Real-time Updates**: Timing updates as words are synced
-- **Auto-scroll**: Follows active segment during sync
-- **Completion Status**: Clear visual feedback for completed segments
-
-### 4. Error Prevention
-- **Input Validation**: Ensures content exists before proceeding
-- **Safe Navigation**: Proper cleanup when canceling
-- **State Management**: Prevents conflicts with existing edit modals
-
-## Bug Fixes Implemented
-
-### 1. Manual Sync Issues
-- **Problem**: Sync stopping after first spacebar press
-- **Solution**: Fixed infinite re-renders in useEffect dependencies
-- **Result**: Stable manual sync throughout entire song
-
-### 2. Timeline Zoom Problems
-- **Problem**: Timeline zooming to single word duration after sync
-- **Solution**: Fixed timeRange calculation to always use full song duration
-- **Result**: Consistent 30-second view regardless of sync progress
-
-### 3. Audio Duration
-- **Problem**: Hardcoded duration fallbacks causing inaccurate timelines
-- **Solution**: Integration with real audio duration from AudioPlayer
-- **Result**: Accurate timeline representation of song length
-
-### 4. Keyboard Conflicts
-- **Problem**: Multiple keyboard handlers causing conflicts
-- **Solution**: Proper handler cleanup and event management
-- **Result**: Clean keyboard interaction without conflicts
-
-## User Experience Improvements
-
-### 1. Visual Feedback
-- **Real-time Counts**: Live word/line counting during input
-- **Progress Indicators**: Clear visual feedback on sync progress
-- **Color Coding**: Blue for active, green for completed segments
-
-### 2. Navigation
-- **Auto-scroll**: Automatically follows playback position
-- **Manual Navigation**: Can manually scroll through segments
-- **Status Preservation**: Maintains state during navigation
-
-### 3. Error Recovery
-- **Pause/Resume**: Ability to pause and correct timing
-- **Cancel Support**: Safe cancellation with proper cleanup
-- **State Reset**: Clean state management between sessions
-
-## Integration with Existing Codebase
-
-### 1. Reused Components
-- **useManualSync**: Leverages existing manual sync logic
-- **Timeline Components**: Reuses timeline visualization
-- **Audio Controls**: Integrates with existing audio system
-
-### 2. Type Safety
-- **TypeScript**: Fully typed implementation
-- **Consistent Interfaces**: Uses existing type definitions
-- **Validation**: Runtime validation for data integrity
-
-### 3. State Management
-- **Isolated State**: Doesn't interfere with existing edit functionality
-- **Clean Separation**: Separate modal for replace vs. edit operations
-- **Proper Cleanup**: Ensures no state leakage between modals
-
-## Performance Considerations
-
-### 1. Rendering Optimization
-- **Memoization**: Strategic use of React.memo and useCallback
-- **Efficient Updates**: Minimal re-renders during sync
-- **Progressive Loading**: Handles large lyric sets efficiently
-
-### 2. Memory Management
-- **Cleanup**: Proper cleanup of event listeners and timers
-- **State Reset**: Clean state management between sessions
-- **Audio Integration**: Efficient audio control integration
-
-## Future Enhancement Opportunities
-
-### 1. Batch Operations
-- **Multi-line Selection**: Select and sync multiple segments at once
-- **Timing Adjustment**: Bulk timing adjustments
-- **Smart Defaults**: AI-suggested timing based on audio analysis
-
-### 2. Import/Export
-- **Format Support**: Support for various lyric file formats
-- **Backup/Restore**: Save and restore sync sessions
-- **Templates**: Predefined timing templates
-
-### 3. Advanced Sync
-- **Beat Detection**: Automatic beat-based timing suggestions
-- **Voice Activity**: Audio analysis for timing hints
-- **Collaborative Sync**: Multi-user timing collaboration
-
-## Summary
-
-The "Replace All Lyrics" functionality provides a comprehensive solution for handling poor-quality transcriptions by:
-
-1. **Complete Replacement**: Replaces all existing lyrics with fresh clipboard content
-2. **Manual Control**: Gives users full control over timing through manual sync
-3. **Visual Feedback**: Provides clear progress tracking and status indicators
-4. **Stable Interface**: Maintains consistent timeline view throughout the process
-5. **Clean Integration**: Works seamlessly with existing audio and editing systems
-
-This implementation significantly improves the user experience for cases where starting fresh is more efficient than editing individual words, while maintaining the high-quality timing precision needed for karaoke applications. 

lyrics_transcriber/frontend/__init__.py

@@ -1,25 +0,0 @@
-"""Frontend module for lyrics transcriber web interface."""
-
-import os
-
-# Get the directory containing this file
-__frontend_dir__ = os.path.dirname(os.path.abspath(__file__))
-
-def get_frontend_assets_dir():
-    """Get the path to the frontend assets directory.
-    
-    Returns the web_assets directory if it exists (packaged version),
-    otherwise returns the dist directory (development version).
-    """
-    web_assets_dir = os.path.join(__frontend_dir__, "web_assets")
-    dist_dir = os.path.join(__frontend_dir__, "dist")
-    
-    if os.path.exists(web_assets_dir):
-        return web_assets_dir
-    elif os.path.exists(dist_dir):
-        return dist_dir
-    else:
-        raise FileNotFoundError(
-            "Frontend assets not found. Please build the frontend first with: "
-            "./scripts/build_frontend.sh"
-        ) 

lyrics_transcriber/frontend/e2e/agentic-corrections.spec.ts

@@ -1,207 +0,0 @@
-import { test, expect } from '@playwright/test';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-
-// Get __dirname equivalent in ESM
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * E2E tests for the agentic correction workflow in the lyrics transcriber frontend.
- *
- * These tests verify:
- * 1. The UI loads correctly with agentic correction data
- * 2. The AgenticCorrectionMetrics panel displays correctly
- * 3. Corrected words are highlighted and clickable
- * 4. The CorrectionDetailCard shows proper information
- */
-
-// Helper function to load fixture data
-async function loadFixtureData(page: import('@playwright/test').Page) {
-  const fixturePath = path.join(__dirname, 'fixtures', 'agentic-correction-data.json');
-
-  // Create a file chooser promise before clicking
-  const fileChooserPromise = page.waitForEvent('filechooser');
-
-  // Click the Load File button
-  await page.getByRole('button', { name: /load file/i }).click();
-
-  // Handle the file chooser
-  const fileChooser = await fileChooserPromise;
-  await fileChooser.setFiles(fixturePath);
-
-  // Wait for data to load by asserting expected content appears
-  await expect(page.getByText('Hello,')).toBeVisible({ timeout: 5000 });
-}
-
-test.describe('Agentic Correction Workflow', () => {
-  test.beforeEach(async ({ page }) => {
-    // Navigate to the app
-    await page.goto('/');
-
-    // Wait for the initial load
-    await expect(page.getByText('Lyrics Correction Review')).toBeVisible();
-  });
-
-  test('should load the app in read-only mode', async ({ page }) => {
-    // Verify read-only mode alert is shown
-    await expect(page.getByText('Running in read-only mode')).toBeVisible();
-
-    // Verify Load File button is present
-    await expect(page.getByRole('button', { name: /load file/i })).toBeVisible();
-  });
-
-  test('should load correction data from JSON file', async ({ page }) => {
-    await loadFixtureData(page);
-
-    // Verify we're no longer in loading state
-    await expect(page.getByText('Loading Lyrics Correction Review...')).not.toBeVisible();
-
-    // Verify expected content from fixture is visible
-    await expect(page.getByText('Hello,')).toBeVisible();
-  });
-
-  test('should render transcription view after loading data', async ({ page }) => {
-    await loadFixtureData(page);
-
-    // Wait for transcription content to render
-    await expect(page.getByText('Hello,')).toBeVisible();
-
-    // Verify the Corrected Transcription header is visible
-    await expect(page.getByText('Corrected Transcription')).toBeVisible();
-  });
-});
-
-test.describe('UI Components', () => {
-  test('should show Load File button on initial load', async ({ page }) => {
-    await page.goto('/');
-
-    // The Load File button should be visible
-    const loadButton = page.getByRole('button', { name: /load file/i });
-    await expect(loadButton).toBeVisible();
-
-    // Should have upload icon
-    const uploadIcon = page.locator('svg[data-testid="UploadFileIcon"]');
-    await expect(uploadIcon).toBeVisible();
-  });
-
-  test('should show read-only mode banner', async ({ page }) => {
-    await page.goto('/');
-
-    // The read-only alert should be visible
-    await expect(page.getByRole('alert')).toBeVisible();
-    await expect(page.getByText(/read-only mode/i)).toBeVisible();
-  });
-
-  test('should have correction metrics component', async ({ page }) => {
-    await page.goto('/');
-
-    // The page structure should be there with Paper components
-    const metricsSection = page.locator('.MuiPaper-root');
-    await expect(metricsSection.first()).toBeVisible();
-  });
-});
-
-test.describe('File Upload Flow', () => {
-  test('should open file dialog when clicking Load File', async ({ page }) => {
-    await page.goto('/');
-
-    // Set up listener for file chooser
-    let fileChooserOpened = false;
-    page.on('filechooser', () => {
-      fileChooserOpened = true;
-    });
-
-    // Click the button
-    const loadButton = page.getByRole('button', { name: /load file/i });
-    await loadButton.click();
-
-    // Wait for the file chooser event to be processed
-    await page.waitForEvent('filechooser', { timeout: 5000 }).catch(() => {
-      // Event already fired
-    });
-
-    // Verify file chooser was triggered
-    expect(fileChooserOpened).toBe(true);
-  });
-});
-
-test.describe('Review Mode', () => {
-  test.beforeEach(async ({ page }) => {
-    await page.goto('/');
-    await expect(page.getByText('Lyrics Correction Review')).toBeVisible();
-  });
-
-  test('should show Review Mode toggle when agentic data is loaded', async ({ page }) => {
-    await loadFixtureData(page);
-
-    // Wait for content to load
-    await expect(page.getByText('Hello,')).toBeVisible();
-
-    // The Review Mode toggle should be visible when agentic corrections are present
-    // It will appear as "Review Off" chip initially (only in non-read-only mode with agentic data)
-    // Note: In read-only mode, the toggle won't appear
-    const reviewChip = page.getByText(/Review Off|Review Mode/i);
-    const chipCount = await reviewChip.count();
-
-    // Log for debugging purposes (will show in test output)
-    if (chipCount === 0) {
-      // Review toggle only shows in edit mode, not read-only mode
-      // This is expected behavior when loading files in read-only mode
-    }
-  });
-
-  test('should show batch actions panel when Review Mode is enabled', async ({ page }) => {
-    await loadFixtureData(page);
-
-    // Wait for content to load
-    await expect(page.getByText('Hello,')).toBeVisible();
-
-    // Find the Review Mode toggle (only visible in non-read-only mode)
-    const reviewToggle = page.getByText(/Review Off/i);
-
-    if (await reviewToggle.isVisible({ timeout: 2000 }).catch(() => false)) {
-      await reviewToggle.click();
-
-      // Wait for the batch actions panel to appear
-      await expect(page.getByRole('button', { name: /Accept High Confidence/i })).toBeVisible({ timeout: 5000 });
-      await expect(page.getByRole('button', { name: /Accept All/i })).toBeVisible();
-      await expect(page.getByRole('button', { name: /Revert All/i })).toBeVisible();
-    }
-  });
-
-  test('should render corrected words with original text preview', async ({ page }) => {
-    await loadFixtureData(page);
-
-    // Wait for transcription content to load
-    await expect(page.getByText('Hello,')).toBeVisible();
-
-    // Verify correction-related content is rendered
-    // The corrected word "now" should be visible (from fixture: "you're" -> "now")
-    await expect(page.getByText('now')).toBeVisible();
-  });
-
-  test('should toggle Review Mode on and off', async ({ page }) => {
-    await loadFixtureData(page);
-
-    // Wait for content to load
-    await expect(page.getByText('Hello,')).toBeVisible();
-
-    // Find the Review toggle (only visible in non-read-only mode)
-    const reviewOff = page.getByText(/Review Off/i);
-
-    if (await reviewOff.isVisible({ timeout: 2000 }).catch(() => false)) {
-      // Click to enable Review Mode
-      await reviewOff.click();
-
-      // Should now show "Review Mode" label (in filled state)
-      await expect(page.getByText(/Review Mode/i).first()).toBeVisible();
-
-      // Click to disable Review Mode
-      await page.getByText(/Review Mode/i).first().click();
-
-      // Should show "Review Off" again
-      await expect(page.getByText(/Review Off/i)).toBeVisible();
-    }
-  });
-});