electionvue/vendor/tecnickcom/tc-lib-pdf/resources/preflight/README.md

External Preflight Matrix

This folder contains a minimal scaffold to generate one sample PDF for each supported mode and run external validators.

Included scripts

• generate_mode_samples.php generates sample PDFs for:
  • pdfx, pdfx1a, pdfx3, pdfx4, pdfx5
  • pdfua, pdfua1, pdfua2
• run_preflight_matrix.sh runs:
  • qpdf --check when qpdf is available
  • verapdf --format text --flavour ua1|ua2 for PDF/UA samples when verapdf is available
  • a custom PDF/X validator command when PDFX_VALIDATOR_CMD is set

Usage

From the repository root:

make preflight

Optional PDF/X validator hook:

PDFX_VALIDATOR_CMD='my-pdfx-validator --mode "$MODE" "$FILE"' make preflight

The script runs the command through bash -lc with these environment variables set per file:

• MODE: the current conformance mode, for example pdfx4
• FILE: the generated sample PDF path
• REPORT: the report file path under target/preflight/report/

Optional custom output directory:

bash resources/preflight/run_preflight_matrix.sh /tmp/tc-lib-pdf-preflight

Reports are written under target/preflight/report/ (or the custom output path).

Notes

• This is a tooling scaffold for repeatable external validation runs.
• veraPDF is used here as an explicit PDF/UA validator, not as a PDF/X validator.
• Final compliance claims still require profile-specific preflight policies and manual review using your selected validation authority.