titles

willmcgugan · willmcgugan · commit 54cec67bd803 · 2024-07-17T17:16:40.000+01:00
diff --git a/docs/api/app.md b/docs/api/app.md
@@ -1,3 +1,7 @@
+---
+title: "textual.app"
+---
+
 ::: textual.app
     options:
         filters:
diff --git a/docs/api/await_complete.md b/docs/api/await_complete.md
@@ -1 +1,5 @@
+---
+title: "textual.await_complete"
+---
+
 ::: textual.await_complete
diff --git a/docs/api/await_remove.md b/docs/api/await_remove.md
@@ -1 +1,5 @@
+---
+title: "textual.await_remove"
+---
+
 ::: textual.await_remove
diff --git a/docs/api/binding.md b/docs/api/binding.md
@@ -1 +1,5 @@
+---
+title: "textual.binding"
+---
+
 ::: textual.binding
diff --git a/docs/api/cache.md b/docs/api/cache.md
@@ -1 +1,5 @@
+---
+title: "textual.cache"
+---
+
 ::: textual.cache
diff --git a/docs/api/color.md b/docs/api/color.md
@@ -1 +1,5 @@
+---
+title: "textual.color"
+---
+
 ::: textual.color
diff --git a/docs/api/command.md b/docs/api/command.md
@@ -1 +1,5 @@
+---
+title: "textual.command"
+---
+
 ::: textual.command
diff --git a/docs/api/constants.md b/docs/api/constants.md
@@ -1 +1,6 @@
+---
+title: "textual.constants"
+---
+
+
 ::: textual.constants
diff --git a/docs/api/containers.md b/docs/api/containers.md
@@ -1,3 +1,6 @@
-::: textual.containers
+---
+title: "textual.containers"
+---
+
 
-::: textual.widgets.ContentSwitcher
+::: textual.containers
diff --git a/docs/api/content_switcher.md b/docs/api/content_switcher.md
diff --git a/docs/api/coordinate.md b/docs/api/coordinate.md
@@ -1 +1,6 @@
+---
+title: "textual.coordinate"
+---
+
+
 ::: textual.coordinate
diff --git a/docs/api/errors.md b/docs/api/errors.md
@@ -1 +1,5 @@
+---
+title: "textual.errors"
+---
+
 ::: textual.errors
diff --git a/docs/api/events.md b/docs/api/events.md
@@ -1 +1,6 @@
+---
+title: "textual.events"
+---
+
+
 ::: textual.events
diff --git a/docs/api/filter.md b/docs/api/filter.md
@@ -1 +1,6 @@
+---
+title: "textual.filter"
+---
+
+
 ::: textual.filter
diff --git a/docs/api/fuzzy_matcher.md b/docs/api/fuzzy_matcher.md
@@ -1 +1,6 @@
+---
+title: "textual.fuzzy"
+---
+
+
 ::: textual.fuzzy
diff --git a/docs/api/geometry.md b/docs/api/geometry.md
@@ -1 +1,6 @@
+---
+title: "textual.geometry"
+---
+
+
 ::: textual.geometry
diff --git a/docs/api/lazy.md b/docs/api/lazy.md
@@ -1 +1,6 @@
+---
+title: "textual.lazy"
+---
+
+
 ::: textual.lazy
diff --git a/docs/api/logger.md b/docs/api/logger.md
@@ -1,3 +1,8 @@
+---
+title: "textual.Logger"
+---
+
+
 # Logger
 
 A [logger class](/guide/devtools/#logging-handler) that logs to the Textual [console](/guide/devtools#console).
diff --git a/docs/api/logging.md b/docs/api/logging.md
@@ -1 +1,4 @@
+---
+title: "textual.logging"
+---
 ::: textual.logging
diff --git a/docs/api/map_geometry.md b/docs/api/map_geometry.md
@@ -1,3 +1,8 @@
+---
+title: "textual.map_geometry"
+---
+
+
 A data structure returned by [screen.find_widget][textual.screen.Screen.find_widget].
 
-::: textual._compositor.MapGeometry
+::: textual.map_geometry
diff --git a/docs/api/message.md b/docs/api/message.md
@@ -1 +1,5 @@
+---
+title: "textual.message"
+---
+
 ::: textual.message
diff --git a/docs/api/message_pump.md b/docs/api/message_pump.md
@@ -1 +1,5 @@
+---
+title: "textual.message_pump"
+---
+
 ::: textual.message_pump
diff --git a/docs/api/on.md b/docs/api/on.md
@@ -1,3 +1,7 @@
+---
+title: "textual.on"
+---
+
 # On
 
 ::: textual.on
diff --git a/docs/api/pilot.md b/docs/api/pilot.md
@@ -1 +1,5 @@
+---
+title: "textual.pilot"
+---
+
 ::: textual.pilot
diff --git a/docs/api/query.md b/docs/api/query.md
@@ -1 +1,5 @@
+---
+title: "textual.css.query"
+---
+
 ::: textual.css.query
diff --git a/docs/api/reactive.md b/docs/api/reactive.md
@@ -1 +1,5 @@
+---
+title: "textual.reactive"
+---
+
 ::: textual.reactive
diff --git a/docs/api/renderables.md b/docs/api/renderables.md
@@ -1,3 +1,7 @@
+---
+title: "textual.renderables"
+---
+
 A collection of Rich renderables which may be returned from a widget's `render()` method.
 
 ::: textual.renderables.bar
diff --git a/docs/api/screen.md b/docs/api/screen.md
@@ -1 +1,6 @@
+---
+title: "textual.screen"
+---
+
+
 ::: textual.screen
diff --git a/docs/api/scroll_view.md b/docs/api/scroll_view.md
@@ -1 +1,6 @@
+---
+title: "textual.scroll_view"
+---
+
+
 ::: textual.scroll_view
diff --git a/docs/api/scrollbar.md b/docs/api/scrollbar.md
@@ -1 +1,5 @@
+---
+title: "textual.scrollbar"
+---
+
 ::: textual.scrollbar
diff --git a/docs/api/signal.md b/docs/api/signal.md
@@ -1 +1,6 @@
+---
+title: "textual.signal"
+---
+
+
 ::: textual.signal
diff --git a/docs/api/strip.md b/docs/api/strip.md
@@ -1 +1,6 @@
+---
+title: "textual.strip"
+---
+
+
 ::: textual.strip
diff --git a/docs/api/suggester.md b/docs/api/suggester.md
@@ -1 +1,6 @@
+---
+title: "textual.suggester"
+---
+
+
 ::: textual.suggester
diff --git a/docs/api/system_commands_source.md b/docs/api/system_commands_source.md
@@ -1 +1,7 @@
-::: textual._system_commands
+---
+title: "textual.system_commands"
+---
+
+
+
+::: textual.system_commands
diff --git a/docs/api/timer.md b/docs/api/timer.md
@@ -1 +1,5 @@
+---
+title: "textual.timer"
+---
+
 ::: textual.timer
diff --git a/docs/api/types.md b/docs/api/types.md
@@ -1 +1,6 @@
+---
+title: "textual.types"
+---
+
+
 ::: textual.types
diff --git a/docs/api/validation.md b/docs/api/validation.md
@@ -1 +1,6 @@
+---
+title: "textual.validation"
+---
+
+
 ::: textual.validation
diff --git a/docs/api/walk.md b/docs/api/walk.md
@@ -1 +1,6 @@
+---
+title: "textual.walk"
+---
+
+
 ::: textual.walk
diff --git a/docs/api/widget.md b/docs/api/widget.md
@@ -1,3 +1,8 @@
+---
+title: "textual.widget"
+---
+
+
 ::: textual.widget
     options:
         filters:
diff --git a/docs/api/work.md b/docs/api/work.md
@@ -1,2 +1,6 @@
+---
+title: "textual.work"
+---
+
 
 ::: textual.work
diff --git a/docs/api/worker.md b/docs/api/worker.md
@@ -1 +1,5 @@
+---
+title: "textual.worker"
+---
+
 ::: textual.worker
diff --git a/docs/api/worker_manager.md b/docs/api/worker_manager.md
@@ -1 +1,5 @@
-::: textual._worker_manager
+---
+title: "textual.worker_manager"
+---
+
+::: textual.worker_manager
diff --git a/mkdocs-nav.yml b/mkdocs-nav.yml
@@ -187,7 +187,6 @@ nav:
       - "api/command.md"
       - "api/constants.md"
       - "api/containers.md"
-      - "api/content_switcher.md"
       - "api/coordinate.md"
       - "api/dom_node.md"
       - "api/events.md"
diff --git a/src/textual/_compositor.py b/src/textual/_compositor.py
@@ -34,6 +34,7 @@
 from ._context import visible_screen_stack
 from ._loop import loop_last
 from .geometry import NULL_OFFSET, NULL_SPACING, Offset, Region, Size, Spacing
+from .map_geometry import MapGeometry
 from .strip import Strip, StripRenderable
 
 if TYPE_CHECKING:
@@ -52,35 +53,6 @@ class ReflowResult(NamedTuple):
     resized: set[Widget]  # Widgets that have been resized
 
 
-class MapGeometry(NamedTuple):
-    """Defines the absolute location of a Widget."""
-
-    region: Region
-    """The (screen) [region][textual.geometry.Region] occupied by the widget."""
-    order: tuple[tuple[int, int, int], ...]
-    """Tuple of tuples defining the painting order of the widget.
-
-    Each successive triple represents painting order information with regards to
-    ancestors in the DOM hierarchy and the last triple provides painting order
-    information for this specific widget.
-    """
-    clip: Region
-    """A [region][textual.geometry.Region] to clip the widget by (if a Widget is within a container)."""
-    virtual_size: Size
-    """The virtual [size][textual.geometry.Size] (scrollable area) of a widget if it is a container."""
-    container_size: Size
-    """The container [size][textual.geometry.Size] (area not occupied by scrollbars)."""
-    virtual_region: Region
-    """The [region][textual.geometry.Region] relative to the container (but not necessarily visible)."""
-    dock_gutter: Spacing
-    """Space from the container reserved by docked widgets."""
-
-    @property
-    def visible_region(self) -> Region:
-        """The Widget region after clipping."""
-        return self.clip.intersection(self.region)
-
-
 # Maps a widget on to its geometry (information that describes its position in the composition)
 CompositorMap: TypeAlias = "dict[Widget, MapGeometry]"
 
diff --git a/src/textual/_system_commands.py b/src/textual/_system_commands.py
diff --git a/src/textual/_worker_manager.py b/src/textual/_worker_manager.py
diff --git a/src/textual/app.py b/src/textual/app.py
diff --git a/src/textual/dom.py b/src/textual/dom.py
diff --git a/tests/command_palette/test_declare_sources.py b/tests/command_palette/test_declare_sources.py
