OpenSystemsDevelopment / qpdf

…tion, and streamline stream registration logic.

…ta`and streamline foreign stream handling.

…oreign stream handling, and simplify return logic.

…e encapsulation, and streamline foreign stream handling.

…prove encapsulation, and streamline stream data handling.

…e encapsulation, and streamline stream data handling.

…eamline foreign object handling, and simplify method structure.

…`Copier` usage, and simplify object copying logic.

…ne object copying logic, and simplify method structure.

…object reservation, and streamline method usage.

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

…eamline type-specific handling, and remove redundant test coverage evaluations.

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

… `StreamDataProvider` management.

Implement default constructor, copy/move constructors, and assignment operators for `Stream`. Add overloads for initializing `Stream` with `QPDFObjectHandle`.

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.

Streamline `setLastObjectDescription` usage by consolidating string construction at call sites. Relocate method to the private section to improve encapsulation and restrict access.

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.

…ng handling, and reduce reliance on `reinterpret_cast`.