Files
audio-ui/components/editor/Waveform.tsx
Sebastian Krüger ed9ac0b24f feat: implement Phase 4 - selection and editing features
Added comprehensive audio editing capabilities:
- Region selection with Shift+drag on waveform
- Visual selection feedback with blue overlay and borders
- AudioBuffer manipulation utilities (cut, copy, paste, delete, trim)
- EditControls UI component with edit buttons
- Keyboard shortcuts (Ctrl+A, Ctrl+X, Ctrl+C, Ctrl+V, Delete, Escape)
- Clipboard management for cut/copy/paste operations
- Updated useAudioPlayer hook with loadBuffer method

New files:
- types/selection.ts - Selection and ClipboardData interfaces
- lib/audio/buffer-utils.ts - AudioBuffer manipulation utilities
- components/editor/EditControls.tsx - Edit controls UI

Modified files:
- components/editor/Waveform.tsx - Added selection support
- components/editor/AudioEditor.tsx - Integrated edit operations
- lib/hooks/useAudioPlayer.ts - Added loadBuffer method

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-17 15:50:42 +01:00

287 lines
8.4 KiB
TypeScript

'use client';
import * as React from 'react';
import { cn } from '@/lib/utils/cn';
import { generateMinMaxPeaks } from '@/lib/waveform/peaks';
import type { Selection } from '@/types/selection';
export interface WaveformProps {
audioBuffer: AudioBuffer | null;
currentTime: number;
duration: number;
onSeek?: (time: number) => void;
className?: string;
height?: number;
zoom?: number;
scrollOffset?: number;
amplitudeScale?: number;
selection?: Selection | null;
onSelectionChange?: (selection: Selection | null) => void;
}
export function Waveform({
audioBuffer,
currentTime,
duration,
onSeek,
className,
height = 128,
zoom = 1,
scrollOffset = 0,
amplitudeScale = 1,
selection = null,
onSelectionChange,
}: WaveformProps) {
const canvasRef = React.useRef<HTMLCanvasElement>(null);
const containerRef = React.useRef<HTMLDivElement>(null);
const [width, setWidth] = React.useState(800);
const [isDragging, setIsDragging] = React.useState(false);
const [isSelecting, setIsSelecting] = React.useState(false);
const [selectionStart, setSelectionStart] = React.useState<number | null>(null);
// Handle resize
React.useEffect(() => {
const handleResize = () => {
if (containerRef.current) {
setWidth(containerRef.current.clientWidth);
}
};
handleResize();
window.addEventListener('resize', handleResize);
return () => window.removeEventListener('resize', handleResize);
}, []);
// Draw waveform
React.useEffect(() => {
const canvas = canvasRef.current;
if (!canvas || !audioBuffer) return;
const ctx = canvas.getContext('2d');
if (!ctx) return;
// Set canvas size
const dpr = window.devicePixelRatio || 1;
canvas.width = width * dpr;
canvas.height = height * dpr;
canvas.style.width = `${width}px`;
canvas.style.height = `${height}px`;
ctx.scale(dpr, dpr);
// Clear canvas
ctx.fillStyle = getComputedStyle(canvas).getPropertyValue('--color-waveform-bg') || '#f5f5f5';
ctx.fillRect(0, 0, width, height);
// Calculate visible width based on zoom
const visibleWidth = Math.floor(width * zoom);
// Generate peaks for visible portion
const { min, max } = generateMinMaxPeaks(audioBuffer, visibleWidth, 0);
// Draw waveform
const middle = height / 2;
const baseScale = (height / 2) * amplitudeScale;
// Waveform color
const waveformColor = getComputedStyle(canvas).getPropertyValue('--color-waveform') || '#3b82f6';
const progressColor = getComputedStyle(canvas).getPropertyValue('--color-waveform-progress') || '#10b981';
// Calculate progress position
const progressX = duration > 0 ? ((currentTime / duration) * visibleWidth) - scrollOffset : 0;
// Draw grid lines (every 1 second)
ctx.strokeStyle = 'rgba(128, 128, 128, 0.2)';
ctx.lineWidth = 1;
const secondsPerPixel = duration / visibleWidth;
const pixelsPerSecond = visibleWidth / duration;
for (let sec = 0; sec < duration; sec++) {
const x = (sec * pixelsPerSecond) - scrollOffset;
if (x >= 0 && x <= width) {
ctx.beginPath();
ctx.moveTo(x, 0);
ctx.lineTo(x, height);
ctx.stroke();
}
}
// Draw waveform with scroll offset
const startIdx = Math.max(0, Math.floor(scrollOffset));
const endIdx = Math.min(visibleWidth, Math.floor(scrollOffset + width));
for (let i = startIdx; i < endIdx; i++) {
const x = i - scrollOffset;
if (x < 0 || x >= width) continue;
const minVal = min[i] * baseScale;
const maxVal = max[i] * baseScale;
// Use different color for played portion
ctx.fillStyle = x < progressX ? progressColor : waveformColor;
ctx.fillRect(
x,
middle + minVal,
1,
Math.max(1, maxVal - minVal)
);
}
// Draw center line
ctx.strokeStyle = 'rgba(0, 0, 0, 0.1)';
ctx.lineWidth = 1;
ctx.beginPath();
ctx.moveTo(0, middle);
ctx.lineTo(width, middle);
ctx.stroke();
// Draw selection
if (selection) {
const selectionStartX = ((selection.start / duration) * visibleWidth) - scrollOffset;
const selectionEndX = ((selection.end / duration) * visibleWidth) - scrollOffset;
if (selectionEndX >= 0 && selectionStartX <= width) {
const clampedStart = Math.max(0, selectionStartX);
const clampedEnd = Math.min(width, selectionEndX);
ctx.fillStyle = 'rgba(59, 130, 246, 0.3)';
ctx.fillRect(clampedStart, 0, clampedEnd - clampedStart, height);
// Selection borders
ctx.strokeStyle = '#3b82f6';
ctx.lineWidth = 2;
if (selectionStartX >= 0 && selectionStartX <= width) {
ctx.beginPath();
ctx.moveTo(selectionStartX, 0);
ctx.lineTo(selectionStartX, height);
ctx.stroke();
}
if (selectionEndX >= 0 && selectionEndX <= width) {
ctx.beginPath();
ctx.moveTo(selectionEndX, 0);
ctx.lineTo(selectionEndX, height);
ctx.stroke();
}
}
}
// Draw playhead
if (progressX >= 0 && progressX <= width) {
ctx.strokeStyle = '#ef4444';
ctx.lineWidth = 2;
ctx.beginPath();
ctx.moveTo(progressX, 0);
ctx.lineTo(progressX, height);
ctx.stroke();
}
}, [audioBuffer, width, height, currentTime, duration, zoom, scrollOffset, amplitudeScale, selection]);
const handleClick = (e: React.MouseEvent<HTMLCanvasElement>) => {
if (!onSeek || !duration || isDragging) return;
const canvas = canvasRef.current;
if (!canvas) return;
const rect = canvas.getBoundingClientRect();
const x = e.clientX - rect.left;
// Account for zoom and scroll
const visibleWidth = width * zoom;
const actualX = x + scrollOffset;
const clickedTime = (actualX / visibleWidth) * duration;
onSeek(clickedTime);
};
const handleMouseDown = (e: React.MouseEvent<HTMLCanvasElement>) => {
if (!duration) return;
const canvas = canvasRef.current;
if (!canvas) return;
const rect = canvas.getBoundingClientRect();
const x = e.clientX - rect.left;
const visibleWidth = width * zoom;
const actualX = x + scrollOffset;
const clickedTime = (actualX / visibleWidth) * duration;
// Shift key for selection
if (e.shiftKey && onSelectionChange) {
setIsSelecting(true);
setSelectionStart(clickedTime);
onSelectionChange({ start: clickedTime, end: clickedTime });
} else if (onSeek) {
// Regular dragging for scrubbing
setIsDragging(true);
onSeek(clickedTime);
}
};
const handleMouseMove = (e: React.MouseEvent<HTMLCanvasElement>) => {
if (!duration) return;
const canvas = canvasRef.current;
if (!canvas) return;
const rect = canvas.getBoundingClientRect();
const x = e.clientX - rect.left;
const visibleWidth = width * zoom;
const actualX = x + scrollOffset;
const currentTime = (actualX / visibleWidth) * duration;
const clampedTime = Math.max(0, Math.min(duration, currentTime));
// Handle selection dragging
if (isSelecting && onSelectionChange && selectionStart !== null) {
const start = Math.min(selectionStart, clampedTime);
const end = Math.max(selectionStart, clampedTime);
onSelectionChange({ start, end });
}
// Handle scrubbing
else if (isDragging && onSeek) {
onSeek(clampedTime);
}
};
const handleMouseUp = () => {
setIsDragging(false);
setIsSelecting(false);
setSelectionStart(null);
};
const handleMouseLeave = () => {
setIsDragging(false);
setIsSelecting(false);
setSelectionStart(null);
};
return (
<div ref={containerRef} className={cn('w-full', className)}>
{audioBuffer ? (
<canvas
ref={canvasRef}
onMouseDown={handleMouseDown}
onMouseMove={handleMouseMove}
onMouseUp={handleMouseUp}
onMouseLeave={handleMouseLeave}
className={cn(
'w-full rounded-lg border border-border',
isDragging ? 'cursor-grabbing' : isSelecting ? 'cursor-text' : 'cursor-pointer'
)}
style={{ height: `${height}px` }}
/>
) : (
<div
className="flex items-center justify-center rounded-lg border-2 border-dashed border-border bg-muted/30"
style={{ height: `${height}px` }}
>
<p className="text-sm text-muted-foreground">
Load an audio file to see waveform
</p>
</div>
)}
</div>
);
}