1from __future__ import annotations
2 
3import argparse
4import json
5import runpy
6import sys
7from pathlib import Path
8 
9from video_timeline_editor import captions, clip, contain, cover, crop_box, project, text_overlay, transform
10from video_timeline_editor.application.timeline_service import TimelineService
11from video_timeline_editor.domain.model import Clip, Project
12from video_timeline_editor.infrastructure.transcripts import resolve_path
13 
14 
15def load_timeline(timeline_path: Path) -> tuple[Project, list[Clip]]:
16    helper_globals = {
17        "Path": Path,
18        "PROJECT_DIR": timeline_path.parent.resolve(),
19        "SKILL_DIR": Path(__file__).resolve().parents[2],
20        "project": project,
21        "clip": clip,
22        "contain": contain,
23        "cover": cover,
24        "crop_box": crop_box,
25        "transform": transform,
26        "text_overlay": text_overlay,
27        "captions": captions,
28    }
29    scope = runpy.run_path(str(timeline_path), init_globals=helper_globals)
30    project_cfg = scope.get("PROJECT")
31    timeline = scope.get("TIMELINE")
32    if not isinstance(project_cfg, Project):
33        raise ValueError("Timeline file must define PROJECT = project(...)")
34    if not isinstance(timeline, list) or not all(isinstance(item, Clip) for item in timeline):
35        raise ValueError("Timeline file must define TIMELINE = [clip(...), ...]")
36    return project_cfg, timeline
37 
38 
39def print_dry_run(manifest: dict) -> None:
40    print(f"Timeline: {manifest['project']['output']}")
41    print(f"Frame:    {manifest['project']['width']}x{manifest['project']['height']} @ {manifest['project']['fps']}fps")
42    print()
43    for clip_info in manifest["clips"]:
44        words = clip_info["caption_words"]
45        aligned = " word-snap" if clip_info["word_aligned_trim"] else ""
46        caption_suffix = f" captions={words}" if words else ""
47        print(
48            f"{clip_info['id']:12s} {clip_info['duration']:6.2f}s  "
49            f"{clip_info['label']}  "
50            f"[src {clip_info['actual_src_in']:.2f} -> {clip_info['actual_src_out']:.2f}]{aligned}{caption_suffix}"
51        )
52    print()
53    print(f"Estimated total: {manifest['total_duration']:.2f}s")
54 
55 
56def main() -> int:
57    parser = argparse.ArgumentParser(description="Render a declarative FFmpeg timeline")
58    parser.add_argument("--timeline", required=True, help="Path to timeline.py file")
59    parser.add_argument("--dry", action="store_true", help="Print the computed edit plan without rendering")
60    parser.add_argument("--only", nargs="+", help="Render only the listed clip ids, in timeline order")
61    parser.add_argument("--manifest", help="Write computed manifest JSON to this path")
62    parser.add_argument("--open", action="store_true", help="Open the rendered output when done")
63    args = parser.parse_args()
64 
65    timeline_path = Path(args.timeline).resolve()
66    project_cfg, timeline = load_timeline(timeline_path)
67    if args.only:
68        selected = set(args.only)
69        timeline = [entry for entry in timeline if entry.id in selected]
70        if not timeline:
71            raise ValueError("No clips matched --only")
72 
73    service = TimelineService(project_cfg, timeline_path.parent.resolve())
74    manifest = service.analyze_timeline(timeline)
75 
76    if args.manifest:
77        manifest_path = resolve_path(args.manifest, timeline_path.parent)
78        manifest_path.parent.mkdir(parents=True, exist_ok=True)
79        manifest_path.write_text(json.dumps(manifest, indent=2) + "\n")
80 
81    if args.dry:
82        print_dry_run(manifest)
83        return 0
84 
85    final_manifest = service.render_timeline(timeline, open_after=args.open)
86    if args.manifest:
87        manifest_path = resolve_path(args.manifest, timeline_path.parent)
88        manifest_path.write_text(json.dumps(final_manifest, indent=2) + "\n")
89 
90    print(f"Output: {final_manifest['output']}")
91    print(f"Duration: {final_manifest['total_duration']:.2f}s")
92    return 0
93 
94 
95if __name__ == "__main__":
96    try:
97        raise SystemExit(main())
98    except Exception as exc:
99        print(str(exc), file=sys.stderr)
100        raise SystemExit(1)
101