diff --git a/clipper/app/editor_api.py b/clipper/app/editor_api.py index 6a4b2cd..a104ee0 100644 --- a/clipper/app/editor_api.py +++ b/clipper/app/editor_api.py @@ -121,11 +121,11 @@ def render_clip_edit(engine, clip: dict, session: dict, edit: dict, out: Path, t return cover.relative_to(REPO_ROOT).as_posix() if cover else None -def translation_for(engine, clip: dict, project: dict, base: dict) -> list[dict] | None: - """Frases traduzidas para a legenda de desenvolvimento (doc/clipador/IDIOMAS.md): só com `caption.translation` - ligado e fonte em inglês. Traduz o trecho do projeto se ainda não houver tradução que o cubra.""" +def translation_for(engine, clip: dict, project: dict, base: dict, dev: bool = True) -> list[dict] | None: + """Frases traduzidas para a legenda de desenvolvimento (doc/clipador/IDIOMAS.md): só com `dev.translation` + ligado, render de desenvolvimento e fonte em inglês. Traduz o trecho do projeto se ainda não houver tradução.""" cfg = editor.effective_settings(base, project) - if not cfg["caption"].get("translation"): + if not layout.dev_flags(cfg, dev)["translation"]: return None ps = editor.pieces(project["cuts"]) if not ps: diff --git a/clipper/app/editor_render.py b/clipper/app/editor_render.py index fff6267..f8e80f7 100644 --- a/clipper/app/editor_render.py +++ b/clipper/app/editor_render.py @@ -200,11 +200,13 @@ def chat_events(project: dict, chat: list | None, total: float, def build_project_ass(project: dict, cfg: dict, credit: str, t0: float = 0.0, t1: float | None = None, - chat: list | None = None, translation: list[dict] | None = None) -> str: + chat: list | None = None, translation: list[dict] | None = None, dev: bool = True) -> str: """ASS do projeto em tempo de saída. [t0, t1] recorta a janela (prévia real de poucos segundos). `chat` = mensagens da sessão (ChatMessage) para o bloco de chat na tela, se o projeto pedir. `translation` = frases da fala com tradução ({s, e, text, pt}, tempo da sessão; `clips.translation_json`): - com `caption.translation` ligado, o português sai embaixo da legenda (só para desenvolver, IDIOMAS.md).""" + com `dev.translation` ligado, o português sai embaixo da legenda (só para desenvolver, IDIOMAS.md). + `dev=False` = vídeo final (depois de aprovar): nenhuma camada de desenvolvimento (`layout.dev_flags`).""" + flags = layout.dev_flags(cfg, dev) cap, cred = cfg["caption"], cfg["credit"] total = output_duration(project["cuts"]) t1 = total if t1 is None else min(t1, total) @@ -217,7 +219,7 @@ def build_project_ass(project: dict, cfg: dict, credit: str, t0: float = 0.0, t1 # normal fica idêntico ao de antes). tsize = max(30, int(size * 0.5)) trans_style = (f"Style: Trans,Arial,{tsize},&H00FFE79B,&H00FFE79B,&H00000000,&H80000000,-1,0,0,0,100,100,0,0,1," - f"{max(3, ow // 2)},2,8,60,60,0,1\n") if cap.get("translation") and translation else "" + f"{max(3, ow // 2)},2,8,60,60,0,1\n") if flags["translation"] and translation else "" header = f"""[Script Info] ScriptType: v4.00+ PlayResX: {cw} @@ -315,7 +317,7 @@ Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text intro = "\\fscx85\\fscy85\\t(0,90,\\fscx100\\fscy100)" if preset == "pop" and i == 0 else "" event(0, start, end, "Caption", f"{{{at(start)}{intro}}}" + " ".join(parts)) - if cap.get("translation") and translation: + if flags["translation"] and translation: # Só para desenvolver (doc/clipador/IDIOMAS.md): a frase traduzida em português, menor e em azul claro, # logo embaixo da legenda em inglês (\\an8 = cresce para baixo; \\q0 = quebra a linha se for longa). for line in translation: @@ -609,7 +611,7 @@ def has_audio_stream(ffprobe: str | None, file: Path) -> bool: def render_project(ffmpeg: str, ffprobe: str | None, encoder: list[str], segments: list[tuple[Path, float, float]], project: dict, base_cfg: dict, credit: str, out_file: Path, repo_root: Path, out_range: tuple[float, float] | None = None, timeout: float = 900, chat: list | None = None, - cover_file: Path | None = None, translation: list[dict] | None = None) -> None: + cover_file: Path | None = None, translation: list[dict] | None = None, dev: bool = True) -> None: """Renderiza o projeto (ou só a saída [a, b] para a prévia real). `segments` = (arquivo, início, fim) da sessão. `chat` = mensagens da sessão (para o chat na tela); `cover_file` = capa já renderizada, posta nos 2 primeiros quadros quando o projeto pede (`cover.atStart`).""" @@ -628,7 +630,7 @@ def render_project(ffmpeg: str, ffprobe: str | None, encoder: list[str], segment stem = out_file.stem segs, uniform = uniform_segments(ffmpeg, ffprobe, segs, work, stem) # emenda de resolução/codec (retomada) ass_file = work / f"{stem}.ass" - ass_text = build_project_ass(project, cfg, credit, t0, t1, chat, translation) + ass_text = build_project_ass(project, cfg, credit, t0, t1, chat, translation, dev) ass_file.write_text(ass_text, encoding="utf-8") input0, concat = _concat_input(work, stem, segs, in0, in1 - in0) diff --git a/clipper/app/layout.py b/clipper/app/layout.py index f3e933b..6e562c1 100644 --- a/clipper/app/layout.py +++ b/clipper/app/layout.py @@ -91,10 +91,13 @@ DEFAULTS: dict = { "caption": { "enabled": True, "font": "Arial Black", "size": 84, "color": "#FFFFFF", "highlight": "#FFE500", "outline": "#000000", "outlineWidth": 7, "y": None, "uppercase": True, "maxWords": 3, - # Só para desenvolver (fonte em inglês, doc/clipador/IDIOMAS.md): a tradução em português da fala embaixo - # da legenda em inglês. Desligado = o vídeo publicável; nunca publicar com isto ligado. + # Legado (18/11/2026, manhã): virou `dev.translation`. Ainda lido por `dev_flags` (camadas já salvas). "translation": False, }, + # Camadas SÓ DE DESENVOLVIMENTO (doc/clipador/IDIOMAS.md): entram no vídeo de revisão (antes de aprovar) e NUNCA no + # vídeo final — o render com `dev=False` ignora este grupo inteiro. `translation`: português embaixo da legenda; + # `dub`: dublagem em português por TTS com a voz original abaixada. + "dev": {"translation": False, "dub": False}, "credit": {"enabled": True, "position": "top", "size": 44}, "duration": {"minS": 60, "maxS": 90, "backtrackS": 120}, "format": {"aspect": "vertical"}, @@ -122,6 +125,16 @@ def merge(*layers: dict | None) -> dict: return out +def dev_flags(settings: dict, dev: bool = True) -> dict: + """Camadas de desenvolvimento ligadas neste render. `dev=False` (vídeo final, depois de aprovar) = tudo desligado. + `caption.translation` (legado) conta como `dev.translation`.""" + if not dev: + return {"translation": False, "dub": False} + group = {**DEFAULTS["dev"], **(settings.get("dev") or {})} + return {"translation": bool(group["translation"] or (settings.get("caption") or {}).get("translation")), + "dub": bool(group["dub"])} + + def _rect(value, name: str) -> dict | None: if value is None: return None @@ -180,6 +193,11 @@ def validate(settings: dict) -> dict: if key in cap: o[key] = bool(cap[key]) out["caption"] = o + dev = settings.get("dev") + if dev is not None: + if not isinstance(dev, dict): + raise LayoutError("dev precisa ser um objeto") + out["dev"] = {k: bool(dev[k]) for k in ("translation", "dub") if k in dev} cred = settings.get("credit") if cred is not None: o = {} diff --git a/clipper/tests/test_english_source.py b/clipper/tests/test_english_source.py index d17df4a..60e130e 100644 --- a/clipper/tests/test_english_source.py +++ b/clipper/tests/test_english_source.py @@ -148,3 +148,20 @@ def test_voice_language_maps_audience_codes_to_whisper_codes(): from app.worker import voice_language assert voice_language("en-US") == "en" and voice_language("es-419") == "es" and voice_language("pt-BR") == "pt-BR" assert voice_language("en-GB") == "en" and voice_language("") == "pt-BR" + + +def test_dev_layers_never_reach_the_final_render(tmp_path): + """Contrato `dev` (18/11/2026): camadas de desenvolvimento só no vídeo de revisão; `dev=False` = vídeo final limpo.""" + assert layout.DEFAULTS["dev"] == {"translation": False, "dub": False} + assert layout.validate({"dev": {"translation": True, "dub": True, "x": 1}})["dev"] == {"translation": True, "dub": True} + cfg = layout.merge({"dev": {"translation": True, "dub": True}}) + assert layout.dev_flags(cfg) == {"translation": True, "dub": True} + assert layout.dev_flags(cfg, dev=False) == {"translation": False, "dub": False} + assert layout.dev_flags(layout.merge({"caption": {"translation": True}}))["translation"] is True # legado + clip = {"session_id": 1, "start_s": 10.0, "end_s": 75.0, "peak_s": 50.0, "title": "x", "source": "chat"} + words = [Word(20, 20.4, "No"), Word(20.4, 20.8, "way")] + lines = [{"s": 20.0, "e": 20.8, "text": "No way", "pt": "Não acredito"}] + p = validate(editor.auto_project(clip, None, words, [], 100.0, cfg), tmp_path) + eff = editor.effective_settings(cfg, p) + assert "Não acredito" in editor_render.build_project_ass(p, eff, "x", translation=lines) + assert "Não acredito" not in editor_render.build_project_ass(p, eff, "x", translation=lines, dev=False) diff --git a/panel/src/components/clipper-client.ts b/panel/src/components/clipper-client.ts index 3335f43..ef812ff 100644 --- a/panel/src/components/clipper-client.ts +++ b/panel/src/components/clipper-client.ts @@ -212,9 +212,11 @@ export type CutSettings = { caption: { enabled: boolean; font: string; size: number; color: string; highlight: string; outline: string; outlineWidth: number; y: number | null; uppercase: boolean; maxWords: number; - /** Só para desenvolver (fonte em inglês): a tradução em português embaixo da legenda. Nunca publicar ligado. */ + /** Legado: virou `dev.translation`. */ translation?: boolean; }; + /** Camadas só de desenvolvimento (vídeo de revisão); o vídeo final, depois de aprovar, sai sem elas. */ + dev?: { translation: boolean; dub: boolean }; credit: { enabled: boolean; position: "top" | "bottom"; size: number }; duration: { minS: number; maxS: number; backtrackS: number }; /** O serviço antigo não manda este grupo: use `withFormat` para preencher com vertical. */ diff --git a/panel/src/components/clipper-cut-settings.tsx b/panel/src/components/clipper-cut-settings.tsx index 338afe5..0ba6923 100644 --- a/panel/src/components/clipper-cut-settings.tsx +++ b/panel/src/components/clipper-cut-settings.tsx @@ -510,9 +510,9 @@ function CutSettingsEditor({ scope, onDirty, onClose, onSaved }: {

Ritmo e posição

update("caption", { maxWords })} /> update("caption", { uppercase })} /> - update("caption", { translation })} - hint="Só para desenvolver, em fonte em inglês: a fala traduzida aparece embaixo da legenda. Desligue antes de publicar." /> + update("dev", { translation })} + hint="Só no vídeo de revisão (fonte em inglês): a fala traduzida aparece embaixo da legenda. O vídeo final, ao aprovar, sai sem ela." /> update("caption", { y: auto ? null : 0.74 })} hint={horizontal ? "O serviço escolhe a altura no quadro horizontal." : "Na emenda entre câmera e jogo, ou a cerca de 74% da altura."} />