OpenSystemsDevelopment / qpdf

…`Lin`, encapsulate optimization data within `Lin`, update usage across the codebase, and streamline related logic in `QPDF_linearization`.

…` methods, update usage across codebase, and streamline related logic.

… `QPDFPageDocumentHelper`, consolidate redundant logic, and streamline method calls.

… streamline error handling, and improve encapsulation.

… and streamline stream handling.

…tion, and streamline stream registration logic.

…ta`and streamline foreign stream handling.

…prove encapsulation, and streamline stream data handling.

…eamline foreign object handling, and simplify method structure.

…object reservation, and streamline method usage.

…rect_object`, simplify object replacement, and streamline method usage.

…t usage of `std::shared_ptr`, simplify stream data management, and enforce `final` specifier.

Replace `getParsedOffset()` with the new `offset()` method across `QPDFObjectHandle` and related classes for consistent offset handling. Simplify logic and remove redundant `getParsedOffset()` implementation.

…proved encapsulation.

Encapsulate linearization-related logic in `QPDF::Doc::Linearization`. Refactor methods, relocate implementations, and update all references accordingly to streamline and centralize linearization functionality.

Relocate `Pages` methods to `QPDF::Doc` for improved encapsulation of page-related logic. Adjust all references and methods to use the new placement.

Refactor `pages` method and related members in `QPDF::Doc` to `page_dh`. Update all associated references to reflect the change.

Relocate `Objects` to `QPDF::Doc` for improved encapsulation of object-related logic. Adjust all relevant methods and references to use the new placement.

Relocate `reconstructed_xref` to `QPDF::Doc` for improved encapsulation of cross-reference reconstruction state. Adjust all references to use the updated placement.

Relocate `StreamCopier` to `QPDF::Doc` for improved encapsulation of stream copying functionality. Adjust all references to use the updated placement.

Relocate `JobSetter` to `QPDF::Doc` for improved encapsulation of job-related logic. Adjust all references to use the new placement.

Relocate `Writer` to `QPDF::Doc` for better encapsulation of writer-related logic. Adjust all references to use the new placement.

Relocate `Pipe` functionality to `QPDF::Doc::Streams` for improved encapsulation of stream-related logic. Adjust all references to use the new placement.

Relocate `Resolver` to `QPDF::Doc` for improved encapsulation of resolution logic. Adjust all references accordingly to use the new placement.

Relocate `ParseGuard` to `QPDF::Doc` for better encapsulation of parsing logic. Adjust references in `QPDFParser` accordingly to use the new placement.

Replace direct access to document helpers (`acroform()`, `pages()`, `embedded_files()`, etc.) with calls through `QPDF::doc()` for better encapsulation. Adjust related methods, constructors, and memory management accordingly.

Add `QPDF::Doc` as an inner class to manage document-level functionality. Update memory management in `QPDF::Members` to include `Doc` and ensure proper initialization. Add `QPDF::doc()` method for internal access. Refactor constructors accordingly.

Introduce new methods: `data()` to access buffer content, `empty()` to check buffer state, and `size()` to retrieve buffer size. Update unit tests to validate the behavior of these methods alongside existing functionality.

Implement `Buffer::view()` to provide a read-only view of the buffer content. Update unit tests to validate `view()` behavior alongside `move()`. Include necessary `#include <string_view>` for functionality.

Refactor `Buffer`: implement `move()` method to enable efficient transfer of content to a string, leaving the buffer empty. Include unit tests for `move()` functionality to ensure correctness. Remove redundant `#include <cstring>` for cleanup.

…ance error and warning handling within `BaseHandle` and `QPDF`, highlighting that the error condition is not covered in CI testing without generating codecov noise.

…input_entry`, centralize input file handling in `infile_name`, update `new_selection` logic, and simplify page range and input processing.

…, replace redundant file warning logic in `handlePageSpecs`, and simplify resource management.

…page_heap` and `page_spec_qpdfs`, simplify file handling, and improve code clarity.

…n` method, and update logic for handling page specifications.

…parameter, return success status, and streamline warning handling logic.

…based structure for page mapping, improve indexing logic, and clean up redundant variables.