refactor: writer.py vira pacote, um módulo por assunto

O writer tinha 4.199 linhas, das quais 3.300 numa única classe com dezoito
assuntos dentro. Achar o trecho de zoom exigia rolar por marcadores,
velocidade e legendas.

Agora é o pacote fcpxml/writer/, com um arquivo por assunto e o
FCPXMLModifier montado por composição de mixins. Mixins, e não objetos
separados, porque todas essas operações mexem no mesmo documento e nos
mesmos índices — separá-las em objetos independentes transformaria toda
chamada interna em travessia de fronteira sem nada em troca. A divisão que
importa aqui é de leitura, não de estado.

Nenhuma mudança de comportamento e nenhuma alteração nos ~50 pontos que
importam do writer: o __init__ re-exporta tudo, inclusive os nomes com
underscore que a suíte já usava.

    core      723   carga, índices, navegação na spine, save
    titles    600   títulos e legendas dinâmicas
    cut       333   dividir, cortar faixas, apagar
    speed     297   velocidade e zoom
    (+ 20 módulos menores)

Único ajuste de chamada: quatro testes faziam patch em
fcpxml.writer.subprocess, que agora mora em writer.document (ver
Engine/docs/05_EXPERIENCIAS.md #23).

Lint zerado, 1441 testes passando.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

code/fcpxml/writer/api.py

@@ -0,0 +1,55 @@
+"""Atalhos de uma linha para as operações mais comuns.
+
+Extraído de writer.py — ver fcpxml/writer/__init__.py para o conjunto.
+"""
+
+from typing import Optional
+
+from ..models import (
+    MarkerType,
+)
+from .modifier import FCPXMLModifier
+
+# ============================================================================
+# CONVENIENCE FUNCTIONS
+# ============================================================================
+
+def modify_fcpxml(filepath: str) -> FCPXMLModifier:
+    """
+    Open an FCPXML file for modification.
+
+    Usage:
+        modifier = modify_fcpxml("project.fcpxml")
+        modifier.add_marker(...)
+        modifier.save("output.fcpxml")
+    """
+    return FCPXMLModifier(filepath)
+
+
+def add_marker_to_file(
+    filepath: str,
+    timecode: str,
+    name: str,
+    marker_type: str = "standard",
+    output_path: Optional[str] = None
+) -> str:
+    """Convenience function to add a marker to an FCPXML file."""
+    modifier = FCPXMLModifier(filepath)
+    modifier.add_marker_at_timeline(
+        timecode, name,
+        MarkerType.from_string(marker_type)
+    )
+    return modifier.save(output_path)
+
+
+def trim_clip_in_file(
+    filepath: str,
+    clip_id: str,
+    trim_start: Optional[str] = None,
+    trim_end: Optional[str] = None,
+    output_path: Optional[str] = None
+) -> str:
+    """Convenience function to trim a clip in an FCPXML file."""
+    modifier = FCPXMLModifier(filepath)
+    modifier.trim_clip(clip_id, trim_start, trim_end)
+    return modifier.save(output_path)