OpenSystemsDevelopment / qpdf

… with `std::deque` in `traverse_field` for better performance and simplify traversal logic.

…ield` function to increase code clarity.

…h `std::list<Dictionary>`, simplify `/Kids` handling, and update method calls for consistency.

…annotation` to increase code clarity.

…h operator[], update type handling for clarity and consistency, and streamline resource merging.

…ndling, replace `QPDFObjectHandle` with direct type usage, and remove redundant `QTC::TC` calls.

…, remove redundant `QTC::TC` call, and simplify type usage.

…e handling to improve clarity and consistency.

…roFormDocumentHelper`, replace redundant maps with `FieldData` encapsulation.

…n `QPDFWriter` and `QPDFJob`.

…eamFilter`, include necessary private headers.

…n `QPDFPageDocumentHelper`, `QPDFPageObjectHelper` and `QPDFPageLabelDocumentHelper`.

…n `QPDFOutlineObjectHelper` and `QPDFOutlineDocumentHelper`.

…s in `QPDFFormFieldObjectHelper`.

…n `QPDFAcroFormDocumentHelper`.

…emove redundant `QTC::TC` calls.

Fixes #1532.

…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.

…s and `Members` structure

- Simplified `Members` implementation by inlining into `NNTree` context.
- Replaced `std::shared_ptr<Members>` with `std::make_shared` for improved clarity and usage consistency.
- Updated method calls to directly access `Members`' `impl`.
- Improved maintainability and alignment with modern C++ practices.

…idate into `NNTree` implementation

- Merged `QPDFNameTreeObjectHelper` and `QPDFNumberTreeObjectHelper` into `NNTree` source for simplification.
- Adjusted `CMakeLists.txt` and headers to reflect changes.

- 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.