pdftract/crates/pdftract-core/src
jedarden d3fc0de330 feat(pdftract-1os1): implement q/Q stack with depth limit 64 and overflow diagnostics
Implement the q (push) and Q (pop) operators driving a Vec<GraphicsState>
save stack with the PDF spec's 64-level depth limit.

Changes:
- Changed MAX_GSTATE_DEPTH from 32 to 64 per PDF spec section 8.4
- Added gstate_overflow_logged flag to emit overflow diagnostic only once per page
- Q at depth 0 is a no-op that emits GSTATE_STACK_UNDERFLOW diagnostic

Acceptance criteria (all PASS):
- 64 nested q calls succeed; 65th emits diagnostic
- 64 q + 64 Q restores to initial state
- Q at depth 0 is a no-op (no panic)
- 1000 paired q...Q operations succeed (depth never exceeds 1)
- Diagnostic emitted exactly once per page even after multiple overflows

Closes: pdftract-1os1

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-24 16:05:14 -04:00
..
annotation feat(pdftract-4zcj): implement link annotation extractor with dest_array support 2026-05-24 15:59:28 -04:00
attachment feat(pdftract-3lir): implement Filespec dict + EF stream decoder 2026-05-24 13:54:27 -04:00
cache feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
fingerprint feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
font feat(pdftract-2iur): implement nearest-neighbor scanner with Hamming distance and frequency tie-break 2026-05-24 06:57:27 -04:00
forms feat(pdftract-5qca): implement form_fields JSON output + schema integration 2026-05-24 14:36:03 -04:00
layout feat(pdftract-64j83): implement column label assignment to Span.column + Line.column 2026-05-24 14:45:19 -04:00
ocr/preprocessing feat(pdftract-6dki1): implement histogram stretch contrast normalization 2026-05-24 10:30:20 -04:00
parser feat(pdftract-66ykq): implement CCITTFaxDecode passthrough with diagnostics 2026-05-24 13:20:25 -04:00
profiles feat(pdftract-64p5): implement classify CLI subcommand and --auto flag 2026-05-24 15:16:56 -04:00
receipts feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
render feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
schema feat(pdftract-5qca): implement form_fields JSON output + schema integration 2026-05-24 14:36:03 -04:00
signature feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
table feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
atomic_file_writer.rs feat(pdftract-68wfa): implement AtomicFileWriter for atomic file writes 2026-05-24 13:02:37 -04:00
classify.rs feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
content_stream.rs feat(pdftract-1os1): implement q/Q stack with depth limit 64 and overflow diagnostics 2026-05-24 16:05:14 -04:00
diagnostics.rs feat(pdftract-66ykq): implement CCITTFaxDecode passthrough with diagnostics 2026-05-24 13:20:25 -04:00
document.rs feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
dpi.rs feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
extract.rs feat(pdftract-5qca): implement form_fields JSON output + schema integration 2026-05-24 14:36:03 -04:00
graphics_state.rs feat(pdftract-1os1): implement q/Q stack with depth limit 64 and overflow diagnostics 2026-05-24 16:05:14 -04:00
hybrid.rs feat(pdftract-64j83): implement column label assignment to Span.column + Line.column 2026-05-24 14:45:19 -04:00
lib.rs feat(pdftract-46qa): implement 7.6.1 annotation walker dispatcher 2026-05-24 15:30:45 -04:00
markdown.rs feat(pdftract-5qca): implement form_fields JSON output + schema integration 2026-05-24 14:36:03 -04:00
ocr.rs feat(pdftract-6dki1): implement histogram stretch contrast normalization 2026-05-24 10:30:20 -04:00
options.rs feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
preprocess.rs feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
render.rs feat(pdftract-axcri): record inline images as ImageXObject entries 2026-05-24 07:41:50 -04:00
semaphore.rs feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
span_flags.rs feat(pdftract-cbrbg): implement span flag detector for Phase 4.1 2026-05-24 07:28:25 -04:00
url_validation.rs feat(pdftract-3s2i): implement Phase 5.5.2 validation filter 2026-05-24 04:57:17 -04:00
word_boundary.rs feat(pdftract-h2s0z): implement adaptive word boundary detector 2026-05-24 06:06:56 -04:00