Files
OpenCut/apps/web/src/stores/timeline-store.ts
T

693 lines
18 KiB
TypeScript
Raw Normal View History

2025-06-26 00:37:35 +02:00
import { create } from "zustand";
import type {
TrackType,
TimelineElement,
CreateTimelineElement,
} from "@/types/timeline";
import { useEditorStore } from "./editor-store";
import { useMediaStore, getMediaAspectRatio } from "./media-store";
2025-06-26 00:37:35 +02:00
// Helper function to manage element naming with suffixes
const getElementNameWithSuffix = (
originalName: string,
suffix: string
): string => {
// Remove existing suffixes to prevent accumulation
const baseName = originalName
.replace(/ \(left\)$/, "")
.replace(/ \(right\)$/, "")
.replace(/ \(audio\)$/, "")
.replace(/ \(split \d+\)$/, "");
return `${baseName} (${suffix})`;
};
2025-06-26 00:37:35 +02:00
export interface TimelineTrack {
id: string;
name: string;
type: TrackType;
elements: TimelineElement[];
2025-06-26 00:37:35 +02:00
muted?: boolean;
}
interface TimelineStore {
tracks: TimelineTrack[];
history: TimelineTrack[][];
redoStack: TimelineTrack[][];
// Multi-selection
selectedElements: { trackId: string; elementId: string }[];
selectElement: (trackId: string, elementId: string, multi?: boolean) => void;
deselectElement: (trackId: string, elementId: string) => void;
clearSelectedElements: () => void;
setSelectedElements: (
elements: { trackId: string; elementId: string }[]
) => void;
2025-06-26 00:37:35 +02:00
// Drag state
dragState: {
isDragging: boolean;
elementId: string | null;
2025-06-26 00:37:35 +02:00
trackId: string | null;
startMouseX: number;
startElementTime: number;
2025-06-26 00:37:35 +02:00
clickOffsetTime: number;
currentTime: number;
};
setDragState: (dragState: Partial<TimelineStore["dragState"]>) => void;
startDrag: (
elementId: string,
2025-06-26 00:37:35 +02:00
trackId: string,
startMouseX: number,
startElementTime: number,
2025-06-26 00:37:35 +02:00
clickOffsetTime: number
) => void;
updateDragTime: (currentTime: number) => void;
endDrag: () => void;
// Actions
addTrack: (type: TrackType) => string;
insertTrackAt: (type: TrackType, index: number) => string;
2025-06-26 00:37:35 +02:00
removeTrack: (trackId: string) => void;
addElementToTrack: (trackId: string, element: CreateTimelineElement) => void;
removeElementFromTrack: (trackId: string, elementId: string) => void;
moveElementToTrack: (
2025-06-26 00:37:35 +02:00
fromTrackId: string,
toTrackId: string,
elementId: string
2025-06-26 00:37:35 +02:00
) => void;
updateElementTrim: (
2025-06-26 00:37:35 +02:00
trackId: string,
elementId: string,
2025-06-26 00:37:35 +02:00
trimStart: number,
trimEnd: number
) => void;
updateElementStartTime: (
2025-06-26 00:37:35 +02:00
trackId: string,
elementId: string,
2025-06-26 00:37:35 +02:00
startTime: number
) => void;
toggleTrackMute: (trackId: string) => void;
// Split operations for elements
splitElement: (
trackId: string,
elementId: string,
splitTime: number
) => string | null;
splitAndKeepLeft: (
trackId: string,
elementId: string,
splitTime: number
) => void;
splitAndKeepRight: (
trackId: string,
elementId: string,
splitTime: number
) => void;
separateAudio: (trackId: string, elementId: string) => string | null;
2025-06-26 00:37:35 +02:00
// Computed values
getTotalDuration: () => number;
// History actions
2025-06-26 00:37:35 +02:00
undo: () => void;
redo: () => void;
pushHistory: () => void;
}
export const useTimelineStore = create<TimelineStore>((set, get) => ({
tracks: [],
history: [],
redoStack: [],
selectedElements: [],
2025-06-26 00:37:35 +02:00
pushHistory: () => {
const { tracks, history } = get();
2025-06-26 00:37:35 +02:00
set({
history: [...history, JSON.parse(JSON.stringify(tracks))],
redoStack: [],
2025-06-26 00:37:35 +02:00
});
},
undo: () => {
const { history, redoStack, tracks } = get();
if (history.length === 0) return;
const prev = history[history.length - 1];
set({
tracks: prev,
history: history.slice(0, -1),
redoStack: [...redoStack, JSON.parse(JSON.stringify(tracks))],
2025-06-26 00:37:35 +02:00
});
},
selectElement: (trackId, elementId, multi = false) => {
2025-06-26 00:37:35 +02:00
set((state) => {
const exists = state.selectedElements.some(
(c) => c.trackId === trackId && c.elementId === elementId
2025-06-26 00:37:35 +02:00
);
if (multi) {
return exists
? {
selectedElements: state.selectedElements.filter(
(c) => !(c.trackId === trackId && c.elementId === elementId)
2025-06-26 00:37:35 +02:00
),
}
: {
selectedElements: [
...state.selectedElements,
{ trackId, elementId },
],
};
2025-06-26 00:37:35 +02:00
} else {
return { selectedElements: [{ trackId, elementId }] };
2025-06-26 00:37:35 +02:00
}
});
},
deselectElement: (trackId, elementId) => {
2025-06-26 00:37:35 +02:00
set((state) => ({
selectedElements: state.selectedElements.filter(
(c) => !(c.trackId === trackId && c.elementId === elementId)
2025-06-26 00:37:35 +02:00
),
}));
},
clearSelectedElements: () => {
set({ selectedElements: [] });
2025-06-26 00:37:35 +02:00
},
setSelectedElements: (elements) => set({ selectedElements: elements }),
2025-06-26 00:37:35 +02:00
addTrack: (type) => {
get().pushHistory();
// Generate proper track name based on type
const trackName =
type === "media"
? "Media Track"
: type === "text"
? "Text Track"
: type === "audio"
? "Audio Track"
: "Track";
2025-06-26 00:37:35 +02:00
const newTrack: TimelineTrack = {
id: crypto.randomUUID(),
name: trackName,
2025-06-26 00:37:35 +02:00
type,
elements: [],
2025-06-26 00:37:35 +02:00
muted: false,
};
set((state) => ({
tracks: [...state.tracks, newTrack],
}));
return newTrack.id;
},
insertTrackAt: (type, index) => {
get().pushHistory();
// Generate proper track name based on type
const trackName =
type === "media"
? "Media Track"
: type === "text"
? "Text Track"
: type === "audio"
? "Audio Track"
: "Track";
const newTrack: TimelineTrack = {
id: crypto.randomUUID(),
name: trackName,
type,
elements: [],
muted: false,
};
set((state) => {
const newTracks = [...state.tracks];
newTracks.splice(index, 0, newTrack);
return { tracks: newTracks };
});
return newTrack.id;
},
2025-06-26 00:37:35 +02:00
removeTrack: (trackId) => {
get().pushHistory();
set((state) => ({
tracks: state.tracks.filter((track) => track.id !== trackId),
}));
},
addElementToTrack: (trackId, elementData) => {
2025-06-26 00:37:35 +02:00
get().pushHistory();
// Validate element type matches track type
const track = get().tracks.find((t) => t.id === trackId);
if (!track) {
console.error("Track not found:", trackId);
return;
}
// Validate element can be added to this track type
if (track.type === "media" && elementData.type !== "media") {
console.error("Media track only accepts media elements");
return;
}
if (track.type === "text" && elementData.type !== "text") {
console.error("Text track only accepts text elements");
return;
}
if (track.type === "audio" && elementData.type !== "media") {
console.error("Audio track only accepts media elements");
return;
}
// For media elements, validate mediaId exists
if (elementData.type === "media" && !elementData.mediaId) {
console.error("Media element must have mediaId");
return;
}
// For text elements, validate required text properties
if (elementData.type === "text" && !elementData.content) {
console.error("Text element must have content");
return;
}
// Check if this is the first element being added to the timeline
const currentState = get();
const totalElementsInTimeline = currentState.tracks.reduce(
(total, track) => total + track.elements.length,
0
);
const isFirstElement = totalElementsInTimeline === 0;
const newElement: TimelineElement = {
...elementData,
2025-06-26 00:37:35 +02:00
id: crypto.randomUUID(),
startTime: elementData.startTime || 0,
2025-06-26 00:37:35 +02:00
trimStart: 0,
trimEnd: 0,
} as TimelineElement; // Type assertion since we trust the caller passes valid data
2025-06-26 00:37:35 +02:00
// If this is the first element and it's a media element, automatically set the project canvas size
// to match the media's aspect ratio
if (isFirstElement && newElement.type === "media") {
const mediaStore = useMediaStore.getState();
const mediaItem = mediaStore.mediaItems.find(
(item) => item.id === newElement.mediaId
);
if (
mediaItem &&
(mediaItem.type === "image" || mediaItem.type === "video")
) {
const editorStore = useEditorStore.getState();
editorStore.setCanvasSizeFromAspectRatio(
getMediaAspectRatio(mediaItem)
);
}
}
2025-06-26 00:37:35 +02:00
set((state) => ({
tracks: state.tracks.map((track) =>
track.id === trackId
? { ...track, elements: [...track.elements, newElement] }
2025-06-26 00:37:35 +02:00
: track
),
}));
},
removeElementFromTrack: (trackId, elementId) => {
2025-06-26 00:37:35 +02:00
get().pushHistory();
set((state) => ({
tracks: state.tracks
.map((track) =>
track.id === trackId
? {
...track,
elements: track.elements.filter(
(element) => element.id !== elementId
),
2025-06-26 00:37:35 +02:00
}
: track
)
.filter((track) => track.elements.length > 0),
2025-06-26 00:37:35 +02:00
}));
},
moveElementToTrack: (fromTrackId, toTrackId, elementId) => {
2025-06-26 00:37:35 +02:00
get().pushHistory();
set((state) => {
const fromTrack = state.tracks.find((track) => track.id === fromTrackId);
const elementToMove = fromTrack?.elements.find(
(element) => element.id === elementId
);
2025-06-26 00:37:35 +02:00
if (!elementToMove) return state;
2025-06-26 00:37:35 +02:00
return {
tracks: state.tracks
.map((track) => {
if (track.id === fromTrackId) {
return {
...track,
elements: track.elements.filter(
(element) => element.id !== elementId
),
2025-06-26 00:37:35 +02:00
};
} else if (track.id === toTrackId) {
return {
...track,
elements: [...track.elements, elementToMove],
2025-06-26 00:37:35 +02:00
};
}
return track;
})
.filter((track) => track.elements.length > 0),
2025-06-26 00:37:35 +02:00
};
});
},
updateElementTrim: (trackId, elementId, trimStart, trimEnd) => {
2025-06-26 00:37:35 +02:00
get().pushHistory();
set((state) => ({
tracks: state.tracks.map((track) =>
track.id === trackId
? {
...track,
elements: track.elements.map((element) =>
element.id === elementId
? { ...element, trimStart, trimEnd }
: element
2025-06-26 00:37:35 +02:00
),
}
: track
),
}));
},
updateElementStartTime: (trackId, elementId, startTime) => {
2025-06-26 00:37:35 +02:00
get().pushHistory();
set((state) => ({
tracks: state.tracks.map((track) =>
track.id === trackId
? {
...track,
elements: track.elements.map((element) =>
element.id === elementId ? { ...element, startTime } : element
2025-06-26 00:37:35 +02:00
),
}
: track
),
}));
},
toggleTrackMute: (trackId) => {
get().pushHistory();
set((state) => ({
tracks: state.tracks.map((track) =>
track.id === trackId ? { ...track, muted: !track.muted } : track
),
}));
},
splitElement: (trackId, elementId, splitTime) => {
const { tracks } = get();
const track = tracks.find((t) => t.id === trackId);
const element = track?.elements.find((c) => c.id === elementId);
if (!element) return null;
const effectiveStart = element.startTime;
const effectiveEnd =
element.startTime +
(element.duration - element.trimStart - element.trimEnd);
if (splitTime <= effectiveStart || splitTime >= effectiveEnd) return null;
get().pushHistory();
const relativeTime = splitTime - element.startTime;
const firstDuration = relativeTime;
const secondDuration =
element.duration - element.trimStart - element.trimEnd - relativeTime;
const secondElementId = crypto.randomUUID();
set((state) => ({
tracks: state.tracks.map((track) =>
track.id === trackId
? {
...track,
elements: track.elements.flatMap((c) =>
c.id === elementId
? [
{
...c,
trimEnd: c.trimEnd + secondDuration,
name: getElementNameWithSuffix(c.name, "left"),
},
{
...c,
id: secondElementId,
startTime: splitTime,
trimStart: c.trimStart + firstDuration,
name: getElementNameWithSuffix(c.name, "right"),
},
]
: [c]
),
}
: track
),
}));
return secondElementId;
},
// Split element and keep only the left portion
splitAndKeepLeft: (trackId, elementId, splitTime) => {
const { tracks } = get();
const track = tracks.find((t) => t.id === trackId);
const element = track?.elements.find((c) => c.id === elementId);
if (!element) return;
const effectiveStart = element.startTime;
const effectiveEnd =
element.startTime +
(element.duration - element.trimStart - element.trimEnd);
if (splitTime <= effectiveStart || splitTime >= effectiveEnd) return;
get().pushHistory();
const relativeTime = splitTime - element.startTime;
const durationToRemove =
element.duration - element.trimStart - element.trimEnd - relativeTime;
set((state) => ({
tracks: state.tracks.map((track) =>
track.id === trackId
? {
...track,
elements: track.elements.map((c) =>
c.id === elementId
? {
...c,
trimEnd: c.trimEnd + durationToRemove,
name: getElementNameWithSuffix(c.name, "left"),
}
: c
),
}
: track
),
}));
},
// Split element and keep only the right portion
splitAndKeepRight: (trackId, elementId, splitTime) => {
const { tracks } = get();
const track = tracks.find((t) => t.id === trackId);
const element = track?.elements.find((c) => c.id === elementId);
if (!element) return;
const effectiveStart = element.startTime;
const effectiveEnd =
element.startTime +
(element.duration - element.trimStart - element.trimEnd);
if (splitTime <= effectiveStart || splitTime >= effectiveEnd) return;
get().pushHistory();
const relativeTime = splitTime - element.startTime;
set((state) => ({
tracks: state.tracks.map((track) =>
track.id === trackId
? {
...track,
elements: track.elements.map((c) =>
c.id === elementId
? {
...c,
startTime: splitTime,
trimStart: c.trimStart + relativeTime,
name: getElementNameWithSuffix(c.name, "right"),
}
: c
),
}
: track
),
}));
},
// Extract audio from video element to an audio track
separateAudio: (trackId, elementId) => {
const { tracks } = get();
const track = tracks.find((t) => t.id === trackId);
const element = track?.elements.find((c) => c.id === elementId);
if (!element || track?.type !== "media") return null;
get().pushHistory();
// Find existing audio track or prepare to create one
const existingAudioTrack = tracks.find((t) => t.type === "audio");
const audioElementId = crypto.randomUUID();
if (existingAudioTrack) {
// Add audio element to existing audio track
set((state) => ({
tracks: state.tracks.map((track) =>
track.id === existingAudioTrack.id
? {
...track,
elements: [
...track.elements,
{
...element,
id: audioElementId,
name: getElementNameWithSuffix(element.name, "audio"),
},
],
}
: track
),
}));
} else {
// Create new audio track with the audio element in a single atomic update
const newAudioTrack: TimelineTrack = {
id: crypto.randomUUID(),
name: "Audio Track",
type: "audio",
elements: [
{
...element,
id: audioElementId,
name: getElementNameWithSuffix(element.name, "audio"),
},
],
muted: false,
};
set((state) => ({
tracks: [...state.tracks, newAudioTrack],
}));
}
return audioElementId;
},
2025-06-26 00:37:35 +02:00
getTotalDuration: () => {
const { tracks } = get();
if (tracks.length === 0) return 0;
const trackEndTimes = tracks.map((track) =>
track.elements.reduce((maxEnd, element) => {
const elementEnd =
element.startTime +
element.duration -
element.trimStart -
element.trimEnd;
return Math.max(maxEnd, elementEnd);
2025-06-26 00:37:35 +02:00
}, 0)
);
return Math.max(...trackEndTimes, 0);
},
redo: () => {
const { redoStack } = get();
if (redoStack.length === 0) return;
const next = redoStack[redoStack.length - 1];
set({ tracks: next, redoStack: redoStack.slice(0, -1) });
},
dragState: {
isDragging: false,
elementId: null,
2025-06-26 00:37:35 +02:00
trackId: null,
startMouseX: 0,
startElementTime: 0,
2025-06-26 00:37:35 +02:00
clickOffsetTime: 0,
currentTime: 0,
},
setDragState: (dragState) =>
set((state) => ({
dragState: { ...state.dragState, ...dragState },
})),
startDrag: (
elementId,
trackId,
startMouseX,
startElementTime,
clickOffsetTime
) => {
2025-06-26 00:37:35 +02:00
set({
dragState: {
isDragging: true,
elementId,
2025-06-26 00:37:35 +02:00
trackId,
startMouseX,
startElementTime,
2025-06-26 00:37:35 +02:00
clickOffsetTime,
currentTime: startElementTime,
2025-06-26 00:37:35 +02:00
},
});
},
updateDragTime: (currentTime) => {
set((state) => ({
dragState: {
...state.dragState,
currentTime,
},
}));
},
endDrag: () => {
set({
dragState: {
isDragging: false,
elementId: null,
2025-06-26 00:37:35 +02:00
trackId: null,
startMouseX: 0,
startElementTime: 0,
2025-06-26 00:37:35 +02:00
clickOffsetTime: 0,
currentTime: 0,
},
});
},
}));