Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
import { saveProjectFilesWithHistory } from "../utils/studioFileHistory";
import { patchMediaColorGradingInHtml } from "./editor/colorGradingScopePatch";
import { hasRelativeLutSource } from "./studioMediaJobs";
export type ColorGradingScope = "source-file" | "project";
export type ColorGradingScopeResult = { changedFiles: number; changedElements: number };
type ProjectFileReader = (path: string) => Promise<string>;
type ProjectFileWriter = (path: string, content: string) => Promise<void>;
type ShowToast = (message: string, tone?: "error" | "info") => void;
type RecordEdit = (entry: {
label: string;
files: Record<string, { before: string; after: string }>;
}) => Promise<void>;
export const EMPTY_COLOR_GRADING_SCOPE_RESULT: ColorGradingScopeResult = {
changedFiles: 0,
changedElements: 0,
};
interface ApplyColorGradingScopeOptions {
scope: ColorGradingScope;
value: string | null;
selectedSourceFile: string;
compositionPaths: string[];
projectId: string;
waitForPendingDomEditSaves: () => Promise<void>;
readProjectFile: ProjectFileReader;
writeProjectFile: ProjectFileWriter;
recordEdit: RecordEdit;
reloadPreview: () => void;
showToast: ShowToast;
}
function colorGradingScopePaths(
scope: ColorGradingScope,
selectedSourceFile: string,
compositionPaths: string[],
): string[] {
return scope === "source-file" ? [selectedSourceFile] : compositionPaths;
}
// fallow-ignore-next-line complexity
export async function applyColorGradingScopeUpdate({
scope,
value,
selectedSourceFile,
compositionPaths,
projectId,
waitForPendingDomEditSaves,
readProjectFile,
writeProjectFile,
recordEdit,
reloadPreview,
showToast,
}: ApplyColorGradingScopeOptions): Promise<ColorGradingScopeResult> {
await waitForPendingDomEditSaves();
if (scope === "project" && hasRelativeLutSource(value)) {
showToast(
"Project-wide color grading cannot copy relative LUT paths. Apply to this file or use a URL/data LUT.",
"error",
);
return EMPTY_COLOR_GRADING_SCOPE_RESULT;
}
let changedElements = 0;
const patchGrading = (before: string) => {
const result = patchMediaColorGradingInHtml(before, value);
changedElements += result.count;
return result.html;
};
const paths = colorGradingScopePaths(scope, selectedSourceFile, compositionPaths);
const changedPaths = await saveProjectFilesWithHistory({
projectId,
label: value ? "Apply color grading" : "Clear color grading",
files: Object.fromEntries(paths.map((path) => [path, patchGrading])),
readFile: readProjectFile,
writeFile: writeProjectFile,
recordEdit,
});
if (changedPaths.length === 0) {
showToast("No color grading changed", "info");
return EMPTY_COLOR_GRADING_SCOPE_RESULT;
}
reloadPreview();
showToast(
`${value ? "Applied" : "Cleared"} color grading on ${changedElements} media item${changedElements === 1 ? "" : "s"}`,
"info",
);
return { changedFiles: changedPaths.length, changedElements };
}