📌 Description

Problem

Users encounter errors when trying to use global callbacks in the Gui constructor like:

Gui(pages=pages, on_change=handle_change).run()

TypeError: Gui.__init__() got an unexpected keyword argument 'on_change'

Similarly with the run method, except that does not raise an error which can be even more confusing to troubleshoot.

Suggested solutions

1. Improve the docs to make it clearer that Taipy implicitly finds functions with those exact names, or can be explicitly assigned by gui.on_change = handle_change
2. Better error message when on_change, on_navigate, etc. are passed to the Gui constructor. E.g. "Did you mean to..."
3. Warnings when passing global callback parameters to Gui.run. E.g. same "Did you mean to"

📜 Code of Conduct

• I have checked the existing issues to avoid duplicates.
• I am willing to work on this issue (optional)

✅ Acceptance Criteria

• The refactored code maintains existing functionality without breaking changes.
• Any new code is covered by unit tests.
• Code coverage remains at least 90%.
• Performance improvements are documented, if applicable.