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

lyrics_transcriber/frontend/package.json

@@ -1,48 +0,0 @@
-{
-  "name": "lyrics-transcriber-frontend",
-  "private": true,
-  "homepage": "https://nomadkaraoke.github.io/lyrics-transcriber-frontend",
-  "version": "0.86.0",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc -b && vite build --mode development",
-    "build-prod": "tsc -b && vite build",
-    "lint": "eslint .",
-    "preview": "vite preview",
-    "predeploy": "npm run build-prod",
-    "deploy": "gh-pages -d dist",
-    "test": "playwright test",
-    "test:ui": "playwright test --ui",
-    "test:headed": "playwright test --headed"
-  },
-  "dependencies": {
-    "@emotion/react": "^11.14.0",
-    "@emotion/styled": "^11.14.0",
-    "@mui/icons-material": "^6.3.0",
-    "@mui/material": "^6.3.0",
-    "@mui/system": "^6.4.3",
-    "lucide-react": "^0.562.0",
-    "nanoid": "^5.0.9",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "zod": "^3.24.1"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.17.0",
-    "@playwright/test": "^1.57.0",
-    "@types/react": "^18.3.18",
-    "@types/react-dom": "^18.3.5",
-    "@vitejs/plugin-react": "^4.3.4",
-    "eslint": "^9.17.0",
-    "eslint-plugin-react-hooks": "^5.0.0",
-    "eslint-plugin-react-refresh": "^0.4.16",
-    "gh-pages": "^6.3.0",
-    "globals": "^15.14.0",
-    "playwright": "^1.57.0",
-    "typescript": "~5.6.2",
-    "typescript-eslint": "^8.18.2",
-    "vite": "^6.0.5"
-  },
-  "packageManager": "yarn@4.7.0"
-}

lyrics_transcriber/frontend/playwright.config.ts

@@ -1,69 +0,0 @@
-import { defineConfig, devices } from '@playwright/test';
-
-/**
- * Playwright configuration for lyrics-transcriber frontend E2E tests.
- * Tests run against the local dev server (localhost:5173) served by vite.
- */
-export default defineConfig({
-  testDir: './e2e',
-
-  // Run tests sequentially for now
-  fullyParallel: false,
-
-  // Fail the build on CI if you accidentally left test.only in the source code
-  forbidOnly: !!process.env.CI,
-
-  // Retry on CI only
-  retries: process.env.CI ? 2 : 0,
-
-  // Single worker
-  workers: 1,
-
-  // Reporter to use
-  reporter: [
-    ['html', { open: 'never' }],
-    ['list'],
-  ],
-
-  // Shared settings for all tests
-  use: {
-    // Base URL for the local dev server
-    baseURL: 'http://localhost:5173',
-
-    // Collect trace on failure for debugging
-    trace: 'on-first-retry',
-
-    // Screenshot on failure
-    screenshot: 'only-on-failure',
-
-    // Video on failure
-    video: 'on-first-retry',
-
-    // Increase timeout for complex interactions
-    actionTimeout: 30000,
-  },
-
-  // Longer timeout for tests
-  timeout: 120000, // 2 minutes per test
-
-  // Expect timeout for assertions
-  expect: {
-    timeout: 30000, // 30 seconds for expects
-  },
-
-  // Configure projects (browsers)
-  projects: [
-    {
-      name: 'chromium',
-      use: { ...devices['Desktop Chrome'] },
-    },
-  ],
-
-  // Run local dev server before starting tests
-  webServer: {
-    command: 'npm run dev',
-    url: 'http://localhost:5173',
-    reuseExistingServer: !process.env.CI,
-    timeout: 120000,
-  },
-});

lyrics_transcriber/frontend/src/App.tsx

@@ -1,243 +0,0 @@
-import UploadFileIcon from '@mui/icons-material/UploadFile'
-import { Alert, Box, Button, Modal, Typography } from '@mui/material'
-import { ThemeProvider } from '@mui/material/styles'
-import CssBaseline from '@mui/material/CssBaseline'
-import { useEffect, useState, useMemo } from 'react'
-import { ApiClient, FileOnlyClient, LiveApiClient } from './api'
-import CorrectionMetrics from './components/CorrectionMetrics'
-import LyricsAnalyzer from './components/LyricsAnalyzer'
-import AppHeader from './components/AppHeader'
-import { CorrectionData } from './types'
-import { createAppTheme } from './theme'
-
-const THEME_STORAGE_KEY = 'nomad-karaoke-lyrics-theme'
-
-export default function App() {
-  const [isDarkMode, setIsDarkMode] = useState(() => {
-    // Initialize from localStorage
-    const stored = localStorage.getItem(THEME_STORAGE_KEY)
-    return stored !== 'light' // Default to dark
-  })
-  const [data, setData] = useState<CorrectionData | null>(null)
-  const [showMetadata, setShowMetadata] = useState(false)
-  const [error, setError] = useState<string | null>(null)
-  const [apiClient, setApiClient] = useState<ApiClient | null>(null)
-  const [isReadOnly, setIsReadOnly] = useState(true)
-  const [audioHash, setAudioHash] = useState<string>('')
-
-  // Create theme based on mode
-  const theme = useMemo(() => createAppTheme(isDarkMode ? 'dark' : 'light'), [isDarkMode])
-
-  // Handle theme toggle
-  const handleToggleTheme = () => {
-    const newIsDark = !isDarkMode
-    setIsDarkMode(newIsDark)
-    localStorage.setItem(THEME_STORAGE_KEY, newIsDark ? 'dark' : 'light')
-  }
-
-  useEffect(() => {
-    // Parse query parameters
-    const params = new URLSearchParams(window.location.search)
-    const encodedApiUrl = params.get('baseApiUrl')
-    const audioHashParam = params.get('audioHash')
-    const reviewTokenParam = params.get('reviewToken')
-
-    if (encodedApiUrl) {
-      const baseApiUrl = decodeURIComponent(encodedApiUrl)
-      // Pass reviewToken to LiveApiClient for authentication
-      setApiClient(new LiveApiClient(baseApiUrl, reviewTokenParam || undefined))
-      setIsReadOnly(false)
-      if (audioHashParam) {
-        setAudioHash(audioHashParam)
-      }
-      // Fetch initial data
-      fetchData(baseApiUrl, reviewTokenParam || undefined)
-    } else {
-      setApiClient(new FileOnlyClient())
-      setIsReadOnly(true)
-    }
-  }, [])
-
-  const fetchData = async (baseUrl: string, reviewToken?: string) => {
-    try {
-      const client = new LiveApiClient(baseUrl, reviewToken)
-      const data = await client.getCorrectionData()
-      // console.log('Full correction data from API:', data)
-      setData(data)
-    } catch (err) {
-      const error = err as Error
-      setError(`Failed to fetch data: ${error.message}`)
-    }
-  }
-
-  const handleFileLoad = async () => {
-    const input = document.createElement('input')
-    input.type = 'file'
-    input.accept = '.json'
-
-    input.onchange = async (e) => {
-      const file = (e.target as HTMLInputElement).files?.[0]
-      if (!file) return
-
-      try {
-        const text = await file.text()
-        const parsedData = JSON.parse(text) as CorrectionData
-        console.log('File data loaded:', {
-          sampleGap: parsedData.gap_sequences?.[0],
-          sampleWord: parsedData.corrected_segments?.[0]?.words?.[0],
-          sampleCorrection: parsedData.corrections?.[0]
-        })
-
-        // Validate the structure
-        if (!parsedData.corrected_segments || !parsedData.gap_sequences) {
-          throw new Error('Invalid file format: missing required fields')
-        }
-
-        setData(parsedData)
-      } catch (err) {
-        const error = err as Error
-        setError(`Error loading file: ${error.message}. Please make sure it is a valid JSON file.`)
-      }
-    }
-
-    input.click()
-  }
-
-  const renderMetadataModal = () => {
-    if (!data) return null
-
-    return (
-      <Modal
-        open={showMetadata}
-        onClose={() => setShowMetadata(false)}
-        aria-labelledby="metadata-modal"
-      >
-        <Box sx={{
-          position: 'absolute',
-          top: '50%',
-          left: '50%',
-          transform: 'translate(-50%, -50%)',
-          width: 400,
-          bgcolor: 'background.paper',
-          boxShadow: 24,
-          p: 4,
-          borderRadius: 1,
-        }}>
-          <Typography variant="h6" gutterBottom>
-            Correction Process Details
-          </Typography>
-          <Box sx={{ mb: 2 }}>
-            <Typography variant="subtitle2" color="text.secondary">
-              Total Words
-            </Typography>
-            <Typography>
-              {data.metadata.total_words}
-            </Typography>
-          </Box>
-          <Box sx={{ mb: 2 }}>
-            <Typography variant="subtitle2" color="text.secondary">
-              Gap Sequences
-            </Typography>
-            <Typography>
-              {data.metadata.gap_sequences_count}
-            </Typography>
-          </Box>
-          <Box sx={{ mb: 2 }}>
-            <Typography variant="subtitle2" color="text.secondary">
-              Corrections Made
-            </Typography>
-            <Typography>
-              {data.corrections_made}
-            </Typography>
-          </Box>
-          <Box sx={{ mb: 2 }}>
-            <Typography variant="subtitle2" color="text.secondary">
-              Correction Ratio
-            </Typography>
-            <Typography>
-              {(data.metadata.correction_ratio * 100).toFixed(1)}%
-            </Typography>
-          </Box>
-          {/* Add any other metadata fields that are available */}
-        </Box>
-      </Modal>
-    )
-  }
-
-  if (!data) {
-    return (
-      <ThemeProvider theme={theme}>
-        <CssBaseline />
-        <AppHeader isDarkMode={isDarkMode} onToggleTheme={handleToggleTheme} />
-        <Box sx={{ p: 3 }}>
-          {error && (
-            <Alert severity="error" sx={{ mb: 2 }} onClose={() => setError(null)}>
-              {error}
-            </Alert>
-          )}
-          {isReadOnly ? (
-            <>
-              <Alert severity="info" sx={{ mb: 2 }}>
-                Running in read-only mode. Connect to an API to enable editing.
-              </Alert>
-              <Box sx={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', mb: 3 }}>
-                <Typography variant="h4">
-                  Lyrics Correction Review
-                </Typography>
-                <Button
-                  variant="outlined"
-                  startIcon={<UploadFileIcon />}
-                  onClick={handleFileLoad}
-                >
-                  Load File
-                </Button>
-              </Box>
-              <Box sx={{ mb: 3 }}>
-                <CorrectionMetrics />
-              </Box>
-            </>
-          ) : (
-            <Box sx={{ display: 'flex', justifyContent: 'center', alignItems: 'center', height: '50vh' }}>
-              <Typography variant="h6" color="text.secondary">
-                Loading Lyrics Transcription Review...
-              </Typography>
-            </Box>
-          )}
-        </Box>
-      </ThemeProvider>
-    )
-  }
-
-  return (
-    <ThemeProvider theme={theme}>
-      <CssBaseline />
-      <AppHeader isDarkMode={isDarkMode} onToggleTheme={handleToggleTheme} />
-      <Box sx={{
-        p: 1.5,
-        pb: 3,
-        maxWidth: '100%',
-        overflowX: 'hidden'
-      }}>
-        {error && (
-          <Alert severity="error" sx={{ mb: 1 }} onClose={() => setError(null)}>
-            {error}
-          </Alert>
-        )}
-        {isReadOnly && (
-          <Alert severity="info" sx={{ mb: 1 }}>
-            Running in read-only mode. Connect to an API to enable editing.
-          </Alert>
-        )}
-        <LyricsAnalyzer
-          data={data}
-          onFileLoad={handleFileLoad}
-          onShowMetadata={() => setShowMetadata(true)}
-          apiClient={apiClient}
-          isReadOnly={isReadOnly}
-          audioHash={audioHash}
-        />
-        {renderMetadataModal()}
-      </Box>
-    </ThemeProvider>
-  )
-}

lyrics_transcriber/frontend/src/api.ts

@@ -1,262 +0,0 @@
-import { CorrectionData, CorrectionAnnotation } from './types';
-import { validateCorrectionData } from './validation';
-
-// New file to handle API communication
-export interface ApiClient {
-    getCorrectionData: () => Promise<CorrectionData>;
-    submitCorrections: (data: CorrectionData) => Promise<void>;
-    getAudioUrl: (audioHash: string) => string;
-    generatePreviewVideo: (data: CorrectionData, options?: PreviewOptions) => Promise<PreviewVideoResponse>;
-    getPreviewVideoUrl: (previewHash: string) => string;
-    updateHandlers: (enabledHandlers: string[]) => Promise<CorrectionData>;
-    isUpdatingHandlers?: boolean;
-    addLyrics: (source: string, lyrics: string) => Promise<CorrectionData>;
-    submitAnnotations: (annotations: Omit<CorrectionAnnotation, 'annotation_id' | 'timestamp'>[]) => Promise<void>;
-    getAnnotationStats: () => Promise<any>;
-}
-
-// Add new interface for the minimal update payload
-interface CorrectionUpdate {
-    corrections: CorrectionData['corrections'];
-    corrected_segments: CorrectionData['corrected_segments'];
-}
-
-// Add interface for preview generation options
-export interface PreviewOptions {
-    use_background_image?: boolean;
-}
-
-// Add new interface for preview response
-interface PreviewVideoResponse {
-    status: "success" | "error";
-    preview_hash?: string;
-    message?: string;
-}
-
-// Add new interface for adding lyrics
-interface AddLyricsRequest {
-    source: string;
-    lyrics: string;
-}
-
-export class LiveApiClient implements ApiClient {
-    private reviewToken?: string;
-
-    constructor(private baseUrl: string, reviewToken?: string) {
-        this.baseUrl = baseUrl.replace(/\/$/, '')
-        this.reviewToken = reviewToken
-    }
-
-    public isUpdatingHandlers = false;
-
-    /**
-     * Build URL with reviewToken query parameter if available
-     */
-    private buildUrl(path: string): string {
-        const url = `${this.baseUrl}${path}`
-        if (this.reviewToken) {
-            const separator = url.includes('?') ? '&' : '?'
-            return `${url}${separator}review_token=${encodeURIComponent(this.reviewToken)}`
-        }
-        return url
-    }
-
-    async getCorrectionData(): Promise<CorrectionData> {
-        const response = await fetch(this.buildUrl('/correction-data'));
-        if (!response.ok) {
-            throw new Error(`API error: ${response.statusText}`);
-        }
-        const rawData = await response.json();
-
-        try {
-            // This will throw if validation fails
-            return validateCorrectionData(rawData);
-        } catch (error) {
-            console.error('Data validation failed:', error);
-            throw new Error('Invalid data received from server: missing or incorrect fields');
-        }
-    }
-
-    async submitCorrections(data: CorrectionData): Promise<void> {
-        // Extract only the needed fields
-        const updatePayload: CorrectionUpdate = {
-            corrections: data.corrections,
-            corrected_segments: data.corrected_segments
-        };
-
-        const response = await fetch(this.buildUrl('/complete'), {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(updatePayload)
-        });
-
-        if (!response.ok) {
-            throw new Error(`API error: ${response.statusText}`);
-        }
-    }
-
-    getAudioUrl(audioHash: string): string {
-        return this.buildUrl(`/audio/${audioHash}`)
-    }
-
-    async generatePreviewVideo(data: CorrectionData, options?: PreviewOptions): Promise<PreviewVideoResponse> {
-        // Extract only the needed fields, just like in submitCorrections
-        // Include use_background_image option (defaults to false for fast black background)
-        const updatePayload = {
-            corrections: data.corrections,
-            corrected_segments: data.corrected_segments,
-            use_background_image: options?.use_background_image ?? false,
-        };
-
-        const response = await fetch(this.buildUrl('/preview-video'), {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(updatePayload)
-        });
-
-        if (!response.ok) {
-            return {
-                status: 'error',
-                message: `API error: ${response.statusText}`
-            };
-        }
-
-        return await response.json();
-    }
-
-    getPreviewVideoUrl(previewHash: string): string {
-        return this.buildUrl(`/preview-video/${previewHash}`);
-    }
-
-    async updateHandlers(enabledHandlers: string[]): Promise<CorrectionData> {
-        console.log('API: Starting handler update...');
-        this.isUpdatingHandlers = true;
-        console.log('API: Set isUpdatingHandlers to', this.isUpdatingHandlers);
-        
-        try {
-            const response = await fetch(this.buildUrl('/handlers'), {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify(enabledHandlers)
-            });
-
-            if (!response.ok) {
-                throw new Error(`API error: ${response.statusText}`);
-            }
-
-            const data = await response.json();
-            if (data.status === 'error') {
-                throw new Error(data.message || 'Failed to update handlers');
-            }
-
-            console.log('API: Handler update successful');
-            return validateCorrectionData(data.data);
-        } finally {
-            this.isUpdatingHandlers = false;
-            console.log('API: Set isUpdatingHandlers to', this.isUpdatingHandlers);
-        }
-    }
-
-    async addLyrics(source: string, lyrics: string): Promise<CorrectionData> {
-        const payload: AddLyricsRequest = {
-            source,
-            lyrics
-        };
-
-        const response = await fetch(this.buildUrl('/add-lyrics'), {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(payload)
-        });
-
-        if (!response.ok) {
-            throw new Error(`API error: ${response.statusText}`);
-        }
-
-        const data = await response.json();
-        if (data.status === 'error') {
-            throw new Error(data.message || 'Failed to add lyrics');
-        }
-
-        return validateCorrectionData(data.data);
-    }
-
-    async submitAnnotations(annotations: Omit<CorrectionAnnotation, 'annotation_id' | 'timestamp'>[]): Promise<void> {
-        // Submit each annotation to the backend
-        for (const annotation of annotations) {
-            const response = await fetch(this.buildUrl('/v1/annotations'), {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify(annotation)
-            });
-
-            if (!response.ok) {
-                console.error(`Failed to submit annotation:`, annotation);
-                // Continue with other annotations even if one fails
-            }
-        }
-    }
-
-    async getAnnotationStats(): Promise<any> {
-        const response = await fetch(this.buildUrl('/v1/annotations/stats'));
-        if (!response.ok) {
-            throw new Error(`API error: ${response.statusText}`);
-        }
-        return await response.json();
-    }
-}
-
-export class FileOnlyClient implements ApiClient {
-    async getCorrectionData(): Promise<CorrectionData> {
-        throw new Error('Not supported in file-only mode');
-    }
-
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async submitCorrections(_data: CorrectionData): Promise<void> {
-        throw new Error('Not supported in file-only mode');
-    }
-
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    getAudioUrl(_audioHash: string): string {
-        throw new Error('Not supported in file-only mode');
-    }
-
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async generatePreviewVideo(_data: CorrectionData, _options?: PreviewOptions): Promise<PreviewVideoResponse> {
-        throw new Error('Not supported in file-only mode');
-    }
-
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    getPreviewVideoUrl(_previewHash: string): string {
-        throw new Error('Not supported in file-only mode');
-    }
-
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async updateHandlers(_enabledHandlers: string[]): Promise<CorrectionData> {
-        throw new Error('Not supported in file-only mode');
-    }
-
-    async addLyrics(): Promise<CorrectionData> {
-        throw new Error('Not supported in file-only mode');
-    }
-
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async submitAnnotations(_annotations: Omit<CorrectionAnnotation, 'annotation_id' | 'timestamp'>[]): Promise<void> {
-        throw new Error('Not supported in file-only mode');
-    }
-
-    async getAnnotationStats(): Promise<any> {
-        throw new Error('Not supported in file-only mode');
-    }
-}
-