Address review feedback for Chinese word segmentation (#20178)
This PR addresses selected review suggestions from Sean on PR #19166 and
syncs the branch with the latest master.
Completed:
- [x] Move the braille offset converter helper out of the nested
function.
- [x] Move the word segmentation braille converter import out of the
local scope.
- [x] Move the word segmentation initialization debug log into
initialize().
- [x] Remove unsupported RuntimeError-specific handling around
wordSeg.initialize().
- [x] Log word segmentation initializer resolution and execution
failures.
- [x] Add missing return type annotations for wordSegFlag properties.
- [x] Remove redundant int annotations from IntFlag members.
- [x] Move test helper objects out of nested scopes and add type hints.
- [x] Move braille test configuration setup/cleanup into setUp and
tearDown.
- [x] Update the help ID casing for the word segmentation setting.
- [x] Add a user guide section for the word segmentation setting.
- [x] Move the Chinese word segmentation change log entries to 2026.3.
- [x] Sync with the latest nvaccess/master.
Remaining:
- [ ] Confirm whether the new config option should be exposed in the UI.
---------
Co-authored-by: Michael Curran <mick@nvaccess.org>
Co-authored-by: Leonard de Ruijter <3049216+LeonarddeR@users.noreply.github.com>
Co-authored-by: Sean Budd <sean@nvaccess.org>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
