mirror of
https://github.com/nomadkaraoke/karaoke-gen.git
synced 2026-11-20 13:07:57 +09:00
@coderabbitai ignore
## Summary
- Phase 3 of the i18n multilingual initiative — makes the karaoke-gen
frontend fully multilingual (English, Spanish, German)
- Installs `next-intl` with `[locale]` path-based routing,
LanguageSwitcher, and `Accept-Language` API header
- Extracts **1,062 strings** from ~70 components into `messages/en.json`
across 31 namespaces
- Wires `useTranslations()` into all user-facing components (landing,
dashboard, auth, job flow, lyrics review, instrumental review, audio
editor, etc.)
- Admin pages (`/admin/*`) stay outside locale routing — intentionally
excluded from i18n scope
- Static export generates `/en/`, `/es/`, `/de/` directories (45 total
pages) for Cloudflare Pages
- `es.json`/`de.json` are English placeholders — translation via Gemini
pipeline pending
- Translation pipeline (`scripts/translate.py`) and glossary (55
karaoke-specific terms) included
## Key architecture decisions
- Root layout keeps ThemeProvider/TenantProvider (needed by admin pages
outside `[locale]`)
- Only NextIntlClientProvider added to `[locale]/layout.tsx`
- `job-status.ts` labels converted to translation keys; consumers
translate via `useTranslations('jobStatus')`
- Jest mock loads actual `en.json` so existing tests validate i18n
wiring without assertion changes
## Test plan
- [x] All 707 frontend tests pass (39 suites)
- [x] Static build generates all 45 pages across 3 locales
- [x] Admin pages render at `/admin/` without locale prefix
- [x] CodeRabbit review: 4 issues fixed, 7 pre-existing noted
- [ ] Post-deploy: verify `/en/` landing page renders correctly
- [ ] Post-deploy: verify LanguageSwitcher redirects to `/es/` and
`/de/`
- [ ] Post-deploy: verify `/admin/` still works without locale context
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---------
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
329 lines
13 KiB
TypeScript
329 lines
13 KiB
TypeScript
'use client'
|
|
|
|
import { useTranslations } from 'next-intl'
|
|
import { useState } from 'react'
|
|
import { Card } from '@/components/ui/card'
|
|
import { Switch } from '@/components/ui/switch'
|
|
import { Label } from '@/components/ui/label'
|
|
import {
|
|
Tooltip,
|
|
TooltipContent,
|
|
TooltipTrigger,
|
|
} from '@/components/ui/tooltip'
|
|
import { ExternalLink, Lightbulb, X } from 'lucide-react'
|
|
import { CorrectionData } from '@/lib/lyrics-review/types'
|
|
import { cn } from '@/lib/utils'
|
|
|
|
interface GuidancePanelProps {
|
|
data: CorrectionData
|
|
isReadOnly: boolean
|
|
onMetricClick: {
|
|
anchor: () => void
|
|
corrected: () => void
|
|
uncorrected: () => void
|
|
}
|
|
onHandlerToggle: (handler: string, enabled: boolean) => void
|
|
isUpdatingHandlers: boolean
|
|
onHandlerClick?: (handler: string) => void
|
|
statsVisible: boolean
|
|
onStatsToggle: () => void
|
|
}
|
|
|
|
export default function GuidancePanel({
|
|
data,
|
|
isReadOnly,
|
|
onMetricClick,
|
|
onHandlerToggle,
|
|
isUpdatingHandlers,
|
|
onHandlerClick,
|
|
statsVisible,
|
|
onStatsToggle,
|
|
}: GuidancePanelProps) {
|
|
const t = useTranslations('lyricsReview.guidance')
|
|
const [guidanceDismissed, setGuidanceDismissed] = useState(() => {
|
|
if (typeof window === 'undefined') return false
|
|
return localStorage.getItem('lyricsReviewGuidanceDismissed') === 'true'
|
|
})
|
|
|
|
const isMobile = typeof window !== 'undefined' && window.innerWidth < 768
|
|
|
|
// Calculate metrics
|
|
const gapCorrections = data.corrections.reduce(
|
|
(map: Record<string, number>, correction) => {
|
|
const gap = data.gap_sequences.find((g) =>
|
|
g.transcribed_word_ids.includes(correction.word_id)
|
|
)
|
|
if (gap) {
|
|
map[gap.id] = (map[gap.id] || 0) + 1
|
|
}
|
|
return map
|
|
},
|
|
{} as Record<string, number>
|
|
)
|
|
|
|
const correctedGapCount = Object.keys(gapCorrections).length
|
|
const uncorrectedGapCount = data.gap_sequences.length - correctedGapCount
|
|
const totalGaps = data.gap_sequences.length
|
|
|
|
// Handler info
|
|
const handlerCounts =
|
|
data.corrections?.reduce(
|
|
(counts: Record<string, number>, correction) => {
|
|
counts[correction.handler] = (counts[correction.handler] || 0) + 1
|
|
return counts
|
|
},
|
|
{} as Record<string, number>
|
|
) || {}
|
|
|
|
const availableHandlers = data.metadata.available_handlers || []
|
|
const enabledHandlers = new Set(data.metadata.enabled_handlers || [])
|
|
|
|
// Detailed metrics
|
|
const totalWords = data.metadata.total_words || 0
|
|
const anchorWordCount = data.anchor_sequences?.reduce(
|
|
(sum, anchor) => sum + (anchor.transcribed_word_ids?.length || 0),
|
|
0
|
|
) ?? 0
|
|
const multiSourceAnchors = data.anchor_sequences?.filter(
|
|
(anchor) =>
|
|
anchor?.reference_word_ids && Object.keys(anchor.reference_word_ids).length > 1
|
|
).length ?? 0
|
|
const replacedCount = data.corrections.filter(
|
|
(c) => !c.is_deletion && !c.split_total
|
|
).length
|
|
const addedCount = data.corrections.filter((c) => c.split_total).length
|
|
const deletedCount = data.corrections.filter((c) => c.is_deletion).length
|
|
const uncorrectedGaps = data.gap_sequences.filter(
|
|
(gap) => !gapCorrections[gap.id] && gap.transcribed_word_ids.length > 0
|
|
)
|
|
const uncorrectedWordCount = uncorrectedGaps.reduce(
|
|
(sum, gap) => sum + gap.transcribed_word_ids.length,
|
|
0
|
|
)
|
|
const anchorPercentage = totalWords > 0 ? Math.round((anchorWordCount / totalWords) * 100) : 0
|
|
const correctedWordCount = replacedCount + addedCount
|
|
const correctedPercentage = totalWords > 0 ? Math.round((correctedWordCount / totalWords) * 100) : 0
|
|
const uncorrectedPercentage = totalWords > 0 ? Math.round((uncorrectedWordCount / totalWords) * 100) : 0
|
|
|
|
const handleDismiss = () => {
|
|
setGuidanceDismissed(true)
|
|
if (typeof window !== 'undefined') {
|
|
localStorage.setItem('lyricsReviewGuidanceDismissed', 'true')
|
|
}
|
|
}
|
|
|
|
const handleShowTips = () => {
|
|
setGuidanceDismissed(false)
|
|
if (typeof window !== 'undefined') {
|
|
localStorage.removeItem('lyricsReviewGuidanceDismissed')
|
|
}
|
|
}
|
|
|
|
return (
|
|
<div className="space-y-2 mb-2">
|
|
{/* Color legend row */}
|
|
<div className="flex items-center gap-3 text-xs flex-wrap">
|
|
<button
|
|
className="flex items-center gap-1.5 hover:opacity-80 transition-opacity"
|
|
onClick={onMetricClick.anchor}
|
|
>
|
|
<span className="w-2.5 h-2.5 rounded-full bg-blue-500/60 inline-block" />
|
|
<span className="text-muted-foreground">{t('matched')}</span>
|
|
</button>
|
|
<button
|
|
className="flex items-center gap-1.5 hover:opacity-80 transition-opacity"
|
|
onClick={onMetricClick.uncorrected}
|
|
>
|
|
<span className="w-2.5 h-2.5 rounded-full bg-orange-500/60 inline-block" />
|
|
<span className="text-muted-foreground">{t('gapsNeedsReview')}</span>
|
|
</button>
|
|
<button
|
|
className="flex items-center gap-1.5 hover:opacity-80 transition-opacity"
|
|
onClick={onMetricClick.corrected}
|
|
>
|
|
<span className="w-2.5 h-2.5 rounded-full bg-green-500/60 inline-block" />
|
|
<span className="text-muted-foreground">{t('corrected')}</span>
|
|
</button>
|
|
|
|
<div className="flex items-center gap-2 ml-auto">
|
|
{guidanceDismissed && !isReadOnly && (
|
|
<button
|
|
className="text-amber-500 hover:text-amber-400 transition-colors text-xs"
|
|
onClick={handleShowTips}
|
|
>
|
|
{t('showTips')}
|
|
</button>
|
|
)}
|
|
<button
|
|
className={cn(
|
|
'text-xs px-1.5 py-0.5 rounded border transition-colors',
|
|
statsVisible
|
|
? 'border-primary text-primary'
|
|
: 'border-muted text-muted-foreground hover:text-foreground hover:border-foreground/50'
|
|
)}
|
|
onClick={onStatsToggle}
|
|
>
|
|
{statsVisible ? t('hideStats') : t('stats')}
|
|
</button>
|
|
</div>
|
|
</div>
|
|
|
|
{/* Workflow tips (dismissible) */}
|
|
{!guidanceDismissed && !isReadOnly && (
|
|
<div className="flex items-start gap-2 p-2.5 rounded-md bg-amber-500/10 border border-amber-500/20">
|
|
<Lightbulb className="h-4 w-4 text-amber-500 shrink-0 mt-0.5" />
|
|
<div className="text-xs text-muted-foreground flex-1 leading-relaxed space-y-1.5">
|
|
{totalGaps === 0 && Object.keys(data.reference_lyrics).length === 0 ? (
|
|
<p>{t('noReferenceFound')}</p>
|
|
) : totalGaps === 0 ? (
|
|
<p>{t('allMatched')}</p>
|
|
) : (
|
|
<>
|
|
<p>{t('syncedLyricsOnLeft')}</p>
|
|
<p>{t('orangeHighlightedWords')}</p>
|
|
<p>{t('useNAndP')}</p>
|
|
<p>{t('watchOutForPhantomWords')}</p>
|
|
<p>{t('tryTimelineView')}</p>
|
|
</>
|
|
)}
|
|
<a
|
|
href="https://www.youtube.com/watch?v=-dI3r7qXo3A"
|
|
target="_blank"
|
|
rel="noopener noreferrer"
|
|
className="inline-flex items-center gap-1 text-amber-500 hover:text-amber-400 transition-colors mt-1"
|
|
>
|
|
<ExternalLink className="h-3 w-3" />
|
|
{t('watchFullTutorial')}
|
|
</a>
|
|
</div>
|
|
<button
|
|
className="text-muted-foreground hover:text-foreground transition-colors shrink-0"
|
|
onClick={handleDismiss}
|
|
aria-label="Dismiss tip"
|
|
>
|
|
<X className="h-3.5 w-3.5" />
|
|
</button>
|
|
</div>
|
|
)}
|
|
|
|
{/* Stats & Handlers (shown when toggled via header button) */}
|
|
{statsVisible && (
|
|
<div className={cn('flex gap-2 overflow-hidden', isMobile ? 'flex-col' : 'flex-row', isMobile ? 'h-auto' : 'h-[140px]')}>
|
|
{/* Handler panel */}
|
|
<Card className={cn('p-2', isMobile ? 'w-full' : 'w-[280px] min-w-[280px]')}>
|
|
<h4 className="text-xs text-muted-foreground mb-1">{t('correctionHandlers')}</h4>
|
|
<div className="flex-1 overflow-auto flex flex-col">
|
|
{availableHandlers.map((handler: { id: string; name: string; description: string }) => (
|
|
<div key={handler.id} className="mb-1">
|
|
<Tooltip>
|
|
<TooltipTrigger asChild>
|
|
<div className="flex items-center gap-2">
|
|
<Switch
|
|
checked={enabledHandlers.has(handler.id)}
|
|
onCheckedChange={(checked) => onHandlerToggle(handler.id, checked)}
|
|
disabled={isUpdatingHandlers}
|
|
className="scale-75"
|
|
/>
|
|
<Label
|
|
className="text-xs cursor-pointer hover:text-foreground hover:underline transition-colors"
|
|
onClick={() => onHandlerClick?.(handler.id)}
|
|
>
|
|
{handler.name} ({handlerCounts[handler.id] || 0})
|
|
</Label>
|
|
</div>
|
|
</TooltipTrigger>
|
|
<TooltipContent>
|
|
<p>{handler.description}</p>
|
|
</TooltipContent>
|
|
</Tooltip>
|
|
</div>
|
|
))}
|
|
</div>
|
|
</Card>
|
|
|
|
{/* Metrics panel */}
|
|
<div className="flex-1 grid grid-cols-3 gap-2 h-full">
|
|
<Card
|
|
className="p-2 cursor-pointer hover:bg-muted/30 transition-colors flex flex-col overflow-hidden h-full"
|
|
onClick={onMetricClick.anchor}
|
|
>
|
|
<div className="flex items-center gap-1 mb-0.5">
|
|
<div className="w-3 h-3 rounded bg-blue-500/25 shrink-0" />
|
|
<span className="text-xs text-muted-foreground truncate">{t('anchorSequences')}</span>
|
|
</div>
|
|
<span className="text-lg font-semibold leading-tight">
|
|
{data.metadata.anchor_sequences_count ?? '-'} ({anchorPercentage}%)
|
|
</span>
|
|
<span className="text-[10px] text-muted-foreground leading-tight">
|
|
{t('anchorSequencesDesc')}
|
|
</span>
|
|
<div className="mt-auto space-y-0 text-[10px]">
|
|
<div className="flex justify-between">
|
|
<span className="text-muted-foreground">{t('wordsInAnchors')}</span>
|
|
<span>{anchorWordCount}</span>
|
|
</div>
|
|
<div className="flex justify-between">
|
|
<span className="text-muted-foreground">{t('multiSourceMatches')}</span>
|
|
<span>{multiSourceAnchors}</span>
|
|
</div>
|
|
</div>
|
|
</Card>
|
|
|
|
<Card
|
|
className="p-2 cursor-pointer hover:bg-muted/30 transition-colors flex flex-col overflow-hidden h-full"
|
|
onClick={onMetricClick.corrected}
|
|
>
|
|
<div className="flex items-center gap-1 mb-0.5">
|
|
<div className="w-3 h-3 rounded bg-green-500/25 shrink-0" />
|
|
<span className="text-xs text-muted-foreground truncate">{t('correctedGaps')}</span>
|
|
</div>
|
|
<span className="text-lg font-semibold text-green-500 leading-tight">
|
|
{correctedGapCount} ({correctedPercentage}%)
|
|
</span>
|
|
<span className="text-[10px] text-muted-foreground leading-tight">
|
|
{t('correctedGapsDesc')}
|
|
</span>
|
|
<div className="mt-auto space-y-0 text-[10px]">
|
|
<div className="flex justify-between">
|
|
<span className="text-muted-foreground">{t('wordsReplaced')}</span>
|
|
<span>{replacedCount}</span>
|
|
</div>
|
|
<div className="flex justify-between">
|
|
<span className="text-muted-foreground">{t('wordsAddedDeleted')}</span>
|
|
<span>+{addedCount} / -{deletedCount}</span>
|
|
</div>
|
|
</div>
|
|
</Card>
|
|
|
|
<Card
|
|
className="p-2 cursor-pointer hover:bg-muted/30 transition-colors flex flex-col overflow-hidden h-full"
|
|
onClick={onMetricClick.uncorrected}
|
|
>
|
|
<div className="flex items-center gap-1 mb-0.5">
|
|
<div className="w-3 h-3 rounded bg-orange-500/25 shrink-0" />
|
|
<span className="text-xs text-muted-foreground truncate">{t('uncorrectedGaps')}</span>
|
|
</div>
|
|
<span className="text-lg font-semibold text-amber-500 leading-tight">
|
|
{uncorrectedGapCount} ({uncorrectedPercentage}%)
|
|
</span>
|
|
<span className="text-[10px] text-muted-foreground leading-tight">
|
|
{t('uncorrectedGapsDesc')}
|
|
</span>
|
|
<div className="mt-auto space-y-0 text-[10px]">
|
|
<div className="flex justify-between">
|
|
<span className="text-muted-foreground">{t('wordsUncorrected')}</span>
|
|
<span>{uncorrectedWordCount}</span>
|
|
</div>
|
|
<div className="flex justify-between">
|
|
<span className="text-muted-foreground">{t('numberOfGaps')}</span>
|
|
<span>{uncorrectedGaps.length}</span>
|
|
</div>
|
|
</div>
|
|
</Card>
|
|
</div>
|
|
</div>
|
|
)}
|
|
</div>
|
|
)
|
|
}
|