fix: resolve component-wrapped views in Page root/top view accessors (#6414)

* fix: resolve component-wrapped views in Page root/top view accessors (#6413)

Under `page.render_views()`, `self.views` is a `Component` (or a single
`View` once unwrapped), not a `list[View]`. `__root_view()` / `__top_view()`
called `len(self.views)` directly, breaking `page.show_drawer()`,
`close_drawer()`, and every page-level accessor backed by the root view
(appbar, drawer, navigation_bar, controls, ...).

Add `__resolved_views()` that unwraps component wrappers and normalizes
a single-View return into a one-element list, and route both view
accessors through it.

Also adds a declarative `NavigationDrawer` example under
`examples/apps/declarative/navigation_drawer` covering the repro from
the issue.

* docs: changelog entry for #6414

Author: FeodorFitsner

CHANGELOG.md

@@ -17,6 +17,7 @@
 * Fix `CodeEditor` background not filling the entire area when `expand=True` ([#6407](https://github.com/flet-dev/flet/pull/6407)) by @FeodorFitsner.
 * Handle unbounded width in `ResponsiveRow` with an explicit error, treat child controls with `col=0` as hidden, and clarify `Container` expansion behavior when `alignment` is set ([#1951](https://github.com/flet-dev/flet/issues/1951), [#3805](https://github.com/flet-dev/flet/issues/3805), [#5209](https://github.com/flet-dev/flet/issues/5209), [#6354](https://github.com/flet-dev/flet/pull/6354)) by @ndonkoHenri.
 * Fix `find_platform_image` selecting incompatible icon formats (e.g. `.icns` on Windows) by ranking glob results per target platform ([#6381](https://github.com/flet-dev/flet/pull/6381)) by @HG-ha.
+* Fix `Page.show_drawer()`, `close_drawer()`, and root/top view accessors (`appbar`, `drawer`, `navigation_bar`, `controls`, ...) failing with `TypeError` under `Page.render_views()` by unwrapping component-wrapped views and normalizing single-view returns ([#6413](https://github.com/flet-dev/flet/issues/6413), [#6414](https://github.com/flet-dev/flet/pull/6414)) by @FeodorFitsner.
 * Fix `auto_scroll` on scrollable controls silently doing nothing unless `scroll` was also explicitly set ([#6397](https://github.com/flet-dev/flet/issues/6397), [#6404](https://github.com/flet-dev/flet/pull/6404)) by @ndonkoHenri.
 
 ### Other changes

sdk/python/examples/apps/declarative/navigation_drawer/main.py

@@ -0,0 +1,51 @@
+import flet as ft
+
+
+@ft.component
+def App():
+    selected, set_selected = ft.use_state(0)
+
+    pages = [
+        ("Home", ft.Icons.HOME_OUTLINED, ft.Icons.HOME),
+        ("Store", ft.Icons.STORE_OUTLINED, ft.Icons.STORE),
+        ("About", ft.Icons.INFO_OUTLINED, ft.Icons.INFO),
+    ]
+
+    async def show_drawer():
+        await ft.context.page.show_drawer()
+
+    async def handle_change(e: ft.Event[ft.NavigationDrawer]):
+        set_selected(e.control.selected_index)
+        await ft.context.page.close_drawer()
+
+    return ft.View(
+        appbar=ft.AppBar(
+            title=ft.Text(pages[selected][0]),
+            leading=ft.IconButton(ft.Icons.MENU, on_click=show_drawer),
+            bgcolor=ft.Colors.SURFACE_CONTAINER_HIGHEST,
+        ),
+        drawer=ft.NavigationDrawer(
+            selected_index=selected,
+            on_change=handle_change,
+            controls=[
+                ft.Container(height=12),
+                *[
+                    ft.NavigationDrawerDestination(
+                        label=label, icon=icon, selected_icon=sel
+                    )
+                    for label, icon, sel in pages
+                ],
+            ],
+        ),
+        controls=[
+            ft.SafeArea(content=ft.Text(f"Welcome to {pages[selected][0]}", size=24))
+        ],
+    )
+
+
+def main(page: ft.Page):
+    page.render_views(App)
+
+
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/apps/declarative/navigation_drawer/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "apps-declarative-navigation-drawer"
+version = "1.0.0"
+description = "Declarative app with a NavigationDrawer whose selected destination drives the page content."
+requires-python = ">=3.10"
+keywords = ["apps", "declarative", "navigation drawer", "state"]
+authors = [{ name = "Flet team", email = "hello@flet.dev" }]
+dependencies = ["flet"]
+
+[dependency-groups]
+dev = ["flet-cli", "flet-desktop", "flet-web"]
+
+[tool.flet.gallery]
+categories = ["Apps/Declarative"]
+
+[tool.flet.metadata]
+title = "Declarative navigation drawer"
+controls = ["View", "AppBar", "NavigationDrawer", "NavigationDrawerDestination", "SafeArea", "Text", "IconButton"]
+layout_pattern = "center-stage"
+complexity = "basic"
+features = ["drawer navigation", "state"]
+
+[tool.flet]
+org = "dev.flet"
+company = "Flet"
+copyright = "Copyright (C) 2023-2026 by Flet"

sdk/python/packages/flet/src/flet/controls/base_page.py

@@ -7,6 +7,7 @@
     Union,
 )
 
+from flet.components.public_utils import unwrap_component
 from flet.controls.adaptive_control import AdaptiveControl
 from flet.controls.animation import AnimationCurve
 from flet.controls.base_control import BaseControl, control
@@ -263,6 +264,12 @@ def handle_page_size(e):
     _overlay: "Overlay" = field(default_factory=lambda: Overlay())
     _dialogs: "Dialogs" = field(default_factory=lambda: Dialogs())
 
+    def __resolved_views(self) -> list[View]:
+        views = unwrap_component(self.views)
+        if isinstance(views, View):
+            return [views]
+        return [unwrap_component(v) for v in views]
+
     def __root_view(self) -> View:
         """
         Return the root view of this page container.
@@ -274,9 +281,10 @@ def __root_view(self) -> View:
             RuntimeError: If no views are available.
         """
 
-        if len(self.views) == 0:
+        views = self.__resolved_views()
+        if len(views) == 0:
             raise RuntimeError("views list is empty.")
-        return self.views[0]
+        return views[0]
 
     def __top_view(self) -> View:
         """
@@ -289,9 +297,10 @@ def __top_view(self) -> View:
             RuntimeError: If no views are available.
         """
 
-        if len(self.views) == 0:
+        views = self.__resolved_views()
+        if len(views) == 0:
             raise RuntimeError("views list is empty.")
-        return self.views[-1]
+        return views[-1]
 
     def update(self, *controls: Control) -> None:
         """