OpenSystemsDevelopment / qpdf

…alize handling in `Files::process_all`, and simplify `handlePageSpecs`.

…file handling in `Inputs`, and simplify related logic.

…lePageSpecs` and `new_selection`, and simplify page specification handling.

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

…zation, simplify `handlePageSpecs` and `new_section`, and streamline file processing logic.

…ce removal handling, and cleanup redundant code in `handlePageSpecs`.

…sing, and simplify page specification handling.

…date page handling logic in `Input`, and optimize page range processing.

…ing logic, and streamline password handling and verbose output.

…ine file handling and resource management logic.

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

…ange handling, and cleanup obsolete logic.

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

…ors for `Members` and `ProgressReporter`

…DFJob_private.hh`, streamline includes, and reduce header dependencies.

… shared helper retrieval, validation methods, and update usages across the codebase. Remove unused test coverage entries.

…t. Add shared helper retrieval, validation methods, and update usages across the codebase.

…le handling. Add shared helper retrieval, validation methods, and update usages across the codebase.

Integrate `QPDFPageLabelDocumentHelper` with `QPDF` for improved page label handling. Add methods for retrieving shared helper instances, validating page label structures, and streamline usage throughout the codebase.

…ame` for improved clarity and consistency, and simplify `/Identity` handling.

…df::Dictionary`, update constructors, and streamline logic with `Dictionary` API.

…simplify iteration logic, update to use `Dictionary` API, and streamline error checks.

…with subscript operator, simplify logic, and improve error checks.

…h subscript operator, streamline `repair` with `Dictionary` initializer, and remove redundant semicolon.

…access, and streamline logic.

…y` with subscript operator, and simplify logic.

…`getKey` with subscript operator, and simplify logic.

…ictionary` APIs, replace `getKey` with subscript operator, streamline logic, and simplify bounds checks.

…y, and simplify implementation.

…erator[]`, and simplify null handling logic.

…actor implementation to simplify null handling and align with API conventions.

…ctionary key access, and simplify null handling logic.

- Added `Array::empty()` as a static method for creating empty arrays.
- Removed unused `Array(bool empty)` constructor and defaulted `Array` constructor.
- Updated `NNTree` methods to use `Array::empty()` for clarity and consistency.

- Marked `NNTreeIterator` and `NNTreeImpl` as `final` to prevent inheritance.
- Inlined `NNTreeIterator` and `NNTreeImpl` methods to streamline code and reduce redundancy.
- Updated constructors, operators, and utility functions in `NNTreeIterator` and `NNTreeImpl` for improved readability and maintainability.

- Added `const` qualifiers to member functions and parameters where applicable.
- Replaced `QPDFObjectHandle` arrays with `qpdf::Array` for improved type clarity.
- Simplified logic in `compareKeyItem` and `compareKeyKid` by removing redundant checks.

- Simplified the code by directly handling limits validation in `compareKeyKid`.
- Improved clarity by reducing unnecessary method indirection.

- Removed `NNTreeDetails` and moved key validation logic directly into `NNTreeImpl`.
- Replaced type determination with `qpdf_object_type_e` for improved clarity.
- Updated `QPDFNameTreeObjectHelper` and `QPDFNumberTreeObjectHelper` to align with the new `NNTreeImpl` structure.
- Simplified methods accessing tree items and validating keys.