preparing the new magnifier types

[Boumtchack]

Link to issue number:

pre - #19473
parts of #19810

Summary of the issue:

needed to add logic for changing types before new types

Description of user facing changes:

Magnifier got a new cycle gesture to change to soon to be implemented new types: fixed/docked/lens

Description of developer facing changes:

added a placeholder for easier developement to be done.

Description of development approach:

as the new modes will inherite from the same logics, first making sure they can be added correctly to the actual code

Testing strategy:

Unit

Known issues with pull request:

Code Review Checklist:

• Documentation:
  • Change log entry
  • User Documentation
  • Developer / Technical Documentation
  • Context sensitive help for GUI changes
• Testing:
  • Unit tests
  • System (end to end) tests
  • Manual testing
• UX of all users considered:
  • Speech
  • Braille
  • Low Vision
  • Different web browsers
  • Localization in other languages / culture than English
• API is compatible with existing add-ons.
• Security precautions taken.

[Copilot]

Pull request overview

Prepares NVDA’s magnifier subsystem for upcoming magnifier “types” (fullscreen/fixed/docked/lens) by adding type persistence, a cycle gesture, and placeholder implementations.

Changes:

• Add magnifierType to config and wire initialization to create the appropriate magnifier instance.
• Add a global command/gesture to cycle magnifier types and announce the selected type.
• Introduce a PlaceholderMagnifier, expand MagnifierType enum, update docs and unit tests for the new lifecycle.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
user_docs/en/userGuide.md	Adds documentation for magnifier types and placeholder sections for upcoming modes.
tests/unit/test_magnifier/test_magnifier.py	Updates unit test expectations around magnifier type initialization.
tests/unit/test_magnifier/test_fullscreenMagnifier.py	Updates fullscreen tests to explicitly start the magnifier after constructor changes.
source/globalCommands.py	Adds a new script/gesture to cycle magnifier type.
source/config/configSpec.py	Adds magnifierType setting under [magnifier].
source/_magnifier/utils/types.py	Adds CHANGE_MAGNIFIER_TYPE action and new MagnifierType members.
source/_magnifier/placeholderMagnifier.py	Adds placeholder magnifier class for not-yet-implemented types.
source/_magnifier/magnifier.py	Adjusts base class _magnifierType initialization behavior.
source/_magnifier/config.py	Adds getters/setters for magnifierType.
source/_magnifier/commands.py	Adds cycle-type command and updates start message to include type.
source/_magnifier/__init__.py	Refactors module initialization to create magnifier instances by type and support runtime type changes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[seanbudd]

Let's focus on #19732 #19739 #19780 #19882 for now. Once most of these are merged, we can work on #19473 #19915 and #19913. Otherwise, there's too much conflicts between the different PRs. We want to ensure work which has already started gets completed before new work is started.

[seanbudd]

I've reopened this now that most of the other PRs are done or close to done

[seanbudd]

Thanks @Boumtchack