M4.78: File > Print opens the Print dialog and prints through the system

The Print dialog (Ctrl/Cmd+P) edits the document's print settings in the
sections General, Marks and Bleed, Output, Graphics, Color Management,
Advanced and Summary, with a preview of each printed page under the section
list (drag the art to move its placement). It drives print.setup,
print.preview and file.print; the preview pages now carry their transform,
printed area and trim box. Print sends the job's PDF to the chosen printer
through the new PrintService (lp on macOS/Linux, the shell print verb on
Windows, a hidden frame and the browser's print dialog on the web); without
one, or with PDF File, it saves the PDF. Done only keeps the settings.
UI commands file.print, print.printers and print.printerSetup.

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

docs/control-protocol.md

@@ -392,3 +392,16 @@ the raster rows of PNG Options (`ppi`, `background`, `antiAlias`), then `colorMo
 document starts on `cmyk`), `layers` (true: Write Layers; false: Flat Image, whose background list starts at White),
 `maxEditability` and `hiddenLayers` (with layers) and `embedIcc`. `ui.dialog.set` the fields and `ui.dialog.confirm`
 writes the file(s) with `document.export`.
+
+Print: File → Print… (`file.print` with no params, Ctrl/Cmd+P) opens the `print` dialog on the document's print
+settings. Its fields are the `print.setup` settings (`copies`, `artboards`, `range`, `media`, `orientation`,
+`placement`, `scaling`, `marks`, `bleed`, `output`, `graphics`, `color`, `margin`…; a section is an object, as
+`{field: "marks", value: {"trim": true}}`) plus `printer` (a name from `print.printers`, `""` the system's default) and
+`toFile` (save the job as a PDF), and the UI-only `__section` (General, Marks and Bleed, Output, Graphics, Color
+Management, Advanced, Summary) and `__sheet` (the page the preview shows, 0-based). `ui.dialog.confirm` (Print) keeps
+the settings with the document (`print.setup`, one undo step) and prints them: to the printer through the system's
+print queue (the web: the browser's print dialog), else, with `toFile` or no printing available, a save panel for the
+PDF. With `discard: true` it is Done: it only keeps the settings. Settings that can't print (a missing artboard, a
+range of no tiles) answer with an error and keep the dialog open. `file.print {settings?, printer?, toFile?, path?}`
+prints without the dialog; `print.printers` lists the printers and `print.printerSetup {printer?}` opens their system
+settings (Setup…).

docs/mcp.md

@@ -1488,3 +1488,21 @@ drawn. Files are at most 30000 pixels a side; PSD files don't open in VectorCraf
 {"name":"export","arguments":{"path":"/tmp/poster.psd","options":{"ppi":300,"maxEditability":true}}}
 {"name":"run_command","arguments":{"command":"document.export","params":{"format":"psd","layers":false,"colorModel":"cmyk"}}}
 ```
+
+## Printing
+
+`print.setup {settings?}` keeps print settings with the document (one undo step; without `settings` it answers the
+current ones): the copies, artboards, paper, orientation, placement, scaling and tiling, marks and bleed, composite or
+separations output, graphics and colour management options of File › Print. `print.preview {settings?}` lays the job
+out without printing: `pages`, then one copy's `sheets`, each with its page size, scale, the `transform` from the
+document onto the page (pt, y down), the document `area` it prints and its `trim` box on the page, plus `tiles`, the
+`inks` of a separation and `warnings`. `file.print {settings?, path?}` writes the job as a print-ready PDF (one page per
+sheet, tile, ink and copy); headless it answers `dataBase64`. In the app, `file.print` with no params opens the Print
+dialog, and with params it prints through the system (`printer`: a name from `print.printers`, default the system's
+default printer) or, with `toFile`, a `path` or no printing available, saves the PDF.
+
+```json
+{"name":"run_command","arguments":{"command":"print.setup","params":{"settings":{"media":"a4","scaling":"fit","marks":{"trim":true}}}}}
+{"name":"run_command","arguments":{"command":"print.preview","params":{"settings":{"copies":2,"output":{"mode":"separations"}}}}}
+{"name":"run_command","arguments":{"command":"file.print","params":{"path":"/tmp/job.pdf"}}}
+```