# export/to-pdf

Workflow per export da SVG a PDF.

## Quando usarlo

Usa questo workflow quando il task richiede conversione di SVG in PDF singolo (uno a uno) con output pronto per handoff tecnico/editoriale base.

## Input minimo

- `input_svg_path`: path file SVG sorgente.
- `output_pdf_path`: path file PDF destinazione.
- `page_mode` opzionale: `fit-artwork` (default) o dimensione pagina esplicita.

## Policy tool selection

### Windows

1. `inkscape` come scelta primaria.
2. `rsvg-convert` non supportato su Windows in questo workflow.

### Altri host (best effort)

1. usa il tool disponibile con resa piu' stabile nel runtime corrente;
2. fallback esplicito in caso di tool mancante/fallimento;
3. se nessun tool disponibile, errore bloccante.

### Ubuntu (policy esplicita)

1. `rsvg-convert` come primaria.
2. fallback `inkscape` in caso di assenza/fallimento.
3. se entrambi assenti -> errore bloccante con chain e next-step installativo.

## Sequenza operativa

1. Valida input SVG e percorso output.
2. Seleziona tool secondo policy host.
3. Esegui export PDF.
4. Valida presenza output e dimensione file > 0.
5. Restituisci report sintetico (tool usato, fallback, warning).

Nota decisionale:
- su Windows la priorita' resta `inkscape`;
- su Ubuntu la priorita' resta `rsvg-convert`;
- non invertire l'ordine senza motivazione esplicita.

## Output atteso

- PDF generato in `output_pdf_path`.
- Report operativo con:
  - tool selezionato;
  - fallback tentati;
  - warning di compatibilita' (font/path/trasparenze) se rilevati.

## Error handling (no fail silenziosi)

- File input non valido/non parseabile -> errore bloccante con causa.
- Tool non disponibile -> errore esplicito con fallback tentati.
- Output mancante o vuoto -> errore finale bloccante.

## Boundary

- Nessun merge multipagina automatico.
- Nessuna preflight tipografica avanzata.
- Nessuna pipeline editoriale completa.