flet 0.70.0.dev5623__py3-none-any.whl → 0.70.0.dev5771__py3-none-any.whl

flet/controls/core/list_view.py

@@ -29,7 +29,7 @@ class ListView(LayoutControl, ScrollableControl, AdaptiveControl):
 
     horizontal: bool = False
     """
-    Whether to layout the [`controls`][flet.ListView.controls] horizontally.
+    Whether to layout the [`controls`][(c).] horizontally.
     """
 
     reverse: bool = False
@@ -37,7 +37,7 @@ class ListView(LayoutControl, ScrollableControl, AdaptiveControl):
     Whether the scroll view scrolls in the reading direction.
 
     For example, if the reading direction is left-to-right and
-    [`horizontal`][flet.ListView.horizontal] is `True`,
+    [`horizontal`][(c).] is `True`,
     then the scroll view scrolls from left to right when `reverse` is `False`
     and from right to left when `reverse` is `True`.
 
@@ -47,18 +47,18 @@ class ListView(LayoutControl, ScrollableControl, AdaptiveControl):
 
     spacing: Number = 0
     """
-    The height of divider between the [`controls`][flet.ListView.controls].
+    The height of divider between the [`controls`][(c).].
     """
 
     item_extent: Optional[Number] = None
     """
-    A fixed height or width (when [`horizontal`][flet.ListView.horizontal] is `True`)
+    A fixed height or width (when [`horizontal`][(c).] is `True`)
     of an item to optimize rendering.
     """
 
     first_item_prototype: bool = False
     """
-    Whether the dimensions of the first item of [`controls`][flet.ListView.controls]
+    Whether the dimensions of the first item of [`controls`][(c).]
     should be used as a "prototype" for all other items,
     i.e. their `height` or `width` will be the same as the first item.
     """
@@ -75,7 +75,7 @@ class ListView(LayoutControl, ScrollableControl, AdaptiveControl):
 
     clip_behavior: ClipBehavior = ClipBehavior.HARD_EDGE
     """
-    How to clip the [`controls`][flet.ListView.controls]
+    How to clip the [`controls`][(c).]
     """
 
     semantic_child_count: Optional[int] = None
@@ -98,7 +98,7 @@ class ListView(LayoutControl, ScrollableControl, AdaptiveControl):
 
     build_controls_on_demand: bool = True
     """
-    Whether the [`controls`][flet.ListView.controls] should be built lazily/on-demand.
+    Whether the [`controls`][(c).] should be built lazily/on-demand.
 
     This is particularly useful when dealing with a large number of controls.
     """

flet/controls/core/markdown.py

@@ -317,7 +317,7 @@ class Markdown(LayoutControl):
     """
     Called when a link within Markdown document is clicked/tapped.
 
-    The [`data`][flet.Event.data] property of the event handler argument
+    The [`data`][flet.Event.] property of the event handler argument
     contains the clickedURL.
 
     Example:

flet/controls/core/pagelet.py

@@ -22,7 +22,7 @@ class Pagelet(LayoutControl, AdaptiveControl):
     Implements the basic Material Design visual layout structure.
 
     Use it for projects that require a "page within a page" layouts with its own
-    [`AppBar`][flet..], [`BottomAppBar`][flet..], [`NavigationDrawer`][flet..],
+    [`AppBar`][flet.], [`BottomAppBar`][flet.], [`NavigationDrawer`][flet.],
     such as demos and galleries.
 
     Raises:
@@ -39,29 +39,29 @@ class Pagelet(LayoutControl, AdaptiveControl):
 
     appbar: Optional[Union[AppBar, CupertinoAppBar]] = None
     """
-    An [`AppBar`][flet.AppBar] control to display at the top
+    An [`AppBar`][flet.] control to display at the top
     of the Pagelet.
     """
 
     navigation_bar: Optional[Union[NavigationBar, CupertinoNavigationBar]] = None
     """
-    A navigation bar ([`NavigationBar`][flet.NavigationBar] or
-    [`CupertinoNavigationBar`][flet.CupertinoNavigationBar]) control to display
+    A navigation bar ([`NavigationBar`][flet.] or
+    [`CupertinoNavigationBar`][flet.]) control to display
     at the bottom of the `Pagelet`.
 
     Note:
-        If both the `navigation_bar` and [`bottom_appbar`][flet.Pagelet.bottom_appbar]
+        If both the `navigation_bar` and [`bottom_appbar`][(c).]
         properties are specified, `navigation_bar` takes precedence and will
         be displayed.
     """
 
     bottom_appbar: Optional[BottomAppBar] = None
     """
-    A [`BottomAppBar`][flet.BottomAppBar] control to display at
+    A [`BottomAppBar`][flet.] control to display at
     the bottom of the `Pagelet`.
 
     Note:
-        If both the `bottom_appbar` and [`navigation_bar`][flet.Pagelet.navigation_bar]
+        If both the `bottom_appbar` and [`navigation_bar`][(c).]
         properties are specified, `bottom_appbar` takes precedence and will
         be displayed.
     """
@@ -74,19 +74,19 @@ class Pagelet(LayoutControl, AdaptiveControl):
 
     drawer: Optional[NavigationDrawer] = None
     """
-    A [`NavigationDrawer`][flet.NavigationDrawer] control to
+    A [`NavigationDrawer`][flet.] control to
     display as a panel sliding from the start edge of the page.
     """
 
     end_drawer: Optional[NavigationDrawer] = None
     """
-    A [`NavigationDrawer`][flet.NavigationDrawer] control to
+    A [`NavigationDrawer`][flet.] control to
     display as a panel sliding from the end edge of the page.
     """
 
     floating_action_button: Optional[Control] = None
     """
-    A [`FloatingActionButton`][flet.FloatingActionButton]
+    A [`FloatingActionButton`][flet.]
     control to display on top of Pagelet content.
     """
 

flet/controls/core/reorderable_draggable.py

@@ -7,7 +7,7 @@ from flet.controls.layout_control import LayoutControl
 @control("ReorderableDraggable")
 class ReorderableDraggable(LayoutControl, AdaptiveControl):
     """
-    Used to drag an item in a [`ReorderableListView`][flet.ReorderableListView].
+    Used to drag an item in a [`ReorderableListView`][flet.].
 
     It creates a listener for a drag immediately following a pointer down
     event over the given [`content`][(c).] control.

flet/controls/core/responsive_row.py

@@ -24,7 +24,7 @@ class ResponsiveRow(LayoutControl, AdaptiveControl):
     By default, a virtual grid has 12 columns, but that can be customized with
     [`columns`][(c).] property.
 
-    Similar to `expand` property, every control has [`col`][flet.Control.col]
+    Similar to `expand` property, every control has [`col`][flet.Control.]
     property which allows specifying how many columns a control should span.
     """
 
@@ -40,13 +40,13 @@ class ResponsiveRow(LayoutControl, AdaptiveControl):
 
     alignment: MainAxisAlignment = MainAxisAlignment.START
     """
-    Defines how the child [`controls`][flet.ResponsiveRow.controls] should be
+    Defines how the child [`controls`][(c).] should be
     placed horizontally.
     """
 
     vertical_alignment: CrossAxisAlignment = CrossAxisAlignment.START
     """
-    Defines how the child [`controls`][flet.ResponsiveRow.controls] should be placed
+    Defines how the child [`controls`][(c).] should be placed
     vertically.
     """
 
@@ -55,10 +55,10 @@ class ResponsiveRow(LayoutControl, AdaptiveControl):
     The spacing between controls in a row in virtual pixels.
 
     Note:
-        Has effect only when [`alignment`][flet.ResponsiveRow.alignment] is set to
-        [`MainAxisAlignment.START`][flet.MainAxisAlignment.START],
-        [`MainAxisAlignment.END`][flet.MainAxisAlignment.END],
-        or [`MainAxisAlignment.CENTER`][flet.MainAxisAlignment.CENTER].
+        Has effect only when [`alignment`][(c).] is set to
+        [`MainAxisAlignment.START`][flet.],
+        [`MainAxisAlignment.END`][flet.],
+        or [`MainAxisAlignment.CENTER`][flet.].
     """
 
     run_spacing: ResponsiveNumber = 10

flet/controls/core/row.py

@@ -16,7 +16,7 @@ class Row(LayoutControl, ScrollableControl, AdaptiveControl):
     Displays its children in a horizontal array.
 
     To cause a child control to expand and fill the available horizontal space, set
-    its [`expand`][flet.Control.expand] property.
+    its [`expand`][(c).] property.
     """
 
     controls: list[Control] = field(default_factory=list)
@@ -26,23 +26,23 @@ class Row(LayoutControl, ScrollableControl, AdaptiveControl):
 
     alignment: MainAxisAlignment = MainAxisAlignment.START
     """
-    Defines how the child [`controls`][flet.Row.controls] should be placed horizontally.
+    Defines how the child [`controls`][(c).] should be placed horizontally.
     """
 
     vertical_alignment: CrossAxisAlignment = CrossAxisAlignment.CENTER
     """
-    Defines how the child [`controls`][flet.Row.controls] should be placed vertically.
+    Defines how the child [`controls`][(c).] should be placed vertically.
     """
 
     spacing: Number = 10
     """
-    The spacing between the child [`controls`][flet.Row.controls].
+    The spacing between the child [`controls`][(c).].
 
     Note:
-        Has effect only when [`alignment`][flet.ResponsiveRow.alignment] is set to
-        [`MainAxisAlignment.START`][flet.MainAxisAlignment.START],
-        [`MainAxisAlignment.END`][flet.MainAxisAlignment.END],
-        or [`MainAxisAlignment.CENTER`][flet.MainAxisAlignment.CENTER].
+        Has effect only when [`alignment`][(c).] is set to
+        [`MainAxisAlignment.START`][flet.],
+        [`MainAxisAlignment.END`][flet.],
+        or [`MainAxisAlignment.CENTER`][flet.].
     """
 
     tight: bool = False

flet/controls/core/semantics.py

@@ -12,10 +12,12 @@ __all__ = ["Semantics"]
 @control("Semantics")
 class Semantics(Control):
     """
-    Provides semantic annotations for the control tree, describing the meaning and purpose of controls.
+    Provides semantic annotations for the control tree, describing the meaning
+    and purpose of controls.
 
-    These annotations are utilized by accessibility tools, search engines, and semantic analysis software
-    to better understand the structure and functionality of the application.
+    These annotations are utilized by accessibility tools, search engines,
+    and semantic analysis software to better understand the structure and
+    functionality of the application.
     """
 
     content: Optional[Control] = None
@@ -25,7 +27,7 @@ class Semantics(Control):
 
     label: Optional[str] = None
     """
-    A textual description of the [`content`][flet.Semantics.content].
+    A textual description of the [`content`][(c).].
     """
 
     expanded: Optional[bool] = None
@@ -52,12 +54,13 @@ class Semantics(Control):
 
     obscured: Optional[bool] = None
     """
-    Whether [`value`][flet.Semantics.value] should be obscured.
+    Whether [`value`][(c).] should be obscured.
     """
 
     multiline: Optional[bool] = None
     """
-    Whether the [`value`][flet.Semantics.value] is coming from a field that supports multiline text editing.
+    Whether the [`value`][(c).] is coming from a field that supports multiline
+    text editing.
     """
 
     focusable: Optional[bool] = None

flet/controls/core/shader_mask.py

@@ -16,7 +16,7 @@ class ShaderMask(LayoutControl):
     Applies a mask generated by a shader to its [`content`][(c).].
 
     For example, it can be used to gradually fade out the edge of a control by
-    using a [`LinearGradient`][flet.LinearGradient] mask.
+    using a [`LinearGradient`][flet.] mask.
     """
 
     shader: Gradient
@@ -26,13 +26,13 @@ class ShaderMask(LayoutControl):
 
     content: Optional[Control] = None
     """
-    The Control to which the [`shader`][flet.ShaderMask.shader] is applied.
+    The Control to which the [`shader`][(c).] is applied.
     """
 
     blend_mode: BlendMode = BlendMode.MODULATE
     """
     The blend mode to use when applying the shader to the
-    [`content`][flet.ShaderMask.content].
+    [`content`][(c).].
     """
 
     border_radius: Optional[BorderRadiusValue] = None

flet/controls/core/stack.py

@@ -49,14 +49,14 @@ class Stack(LayoutControl, AdaptiveControl):
     alignment: Optional[Alignment] = None
     """
     Specifies the alignment for non-positioned (those without explicit
-    alignment properties such as [`top`][flet.LayoutControl.top]
-    or [`bottom`][flet.LayoutControl.bottom]) and
-    partially-positioned [`controls`][flet.Stack.controls].
+    alignment properties such as [`top`][flet.LayoutControl.]
+    or [`bottom`][flet.LayoutControl.]) and
+    partially-positioned [`controls`][(c).].
     """
 
     fit: StackFit = StackFit.LOOSE
     """
-    How to size the non-positioned [`controls`][flet.Stack.controls].
+    How to size the non-positioned [`controls`][(c).].
     """
 
     def init(self):

flet/controls/core/text.py

@@ -177,7 +177,7 @@ class Text(LayoutControl):
     Display text.
 
     It consists of two sources combined to produce the final text:
-    [`value`][(c).] and [`spans`][(c)].
+    [`value`][(c).] and [`spans`][(c).].
     """
 
     value: str = ""
@@ -187,7 +187,7 @@ class Text(LayoutControl):
 
     spans: Optional[list[TextSpan]] = None
     """
-    The list of [`TextSpan`][flet.TextSpan]
+    The list of [`TextSpan`][flet.]
     objects to build a rich text paragraph.
     """
 
@@ -297,7 +297,7 @@ class Text(LayoutControl):
     Whether to show cursor (blinking caret) when the text is selected.
 
     Note:
-        Has effect only when [`selectable`][flet.Text.selectable] is `True`.
+        Has effect only when [`selectable`][(c).] is `True`.
     """
 
     enable_interactive_selection: bool = True
@@ -310,7 +310,7 @@ class Text(LayoutControl):
     the user, text cannot be copied.
 
     Note:
-        Has effect only when [`selectable`][flet.Text.selectable] is `True`.
+        Has effect only when [`selectable`][(c).] is `True`.
     """
 
     selection_cursor_width: Number = 2.0
@@ -324,7 +324,7 @@ class Text(LayoutControl):
     Negative values may be used to reverse this behavior.
 
     Note:
-        Has effect only when [`selectable`][flet.Text.selectable] is `True`.
+        Has effect only when [`selectable`][(c).] is `True`.
     """
 
     selection_cursor_height: Optional[Number] = None
@@ -344,7 +344,7 @@ class Text(LayoutControl):
     Called when the user taps on this selectable text.
 
     Note:
-        Has effect only when [`selectable`][flet.Text.selectable] is `True`.
+        Has effect only when [`selectable`][(c).] is `True`.
     """
 
     on_selection_change: Optional[EventHandler[TextSelectionChangeEvent["Text"]]] = None
@@ -352,5 +352,5 @@ class Text(LayoutControl):
     Called when the user changes the selection of text (including the cursor location).
 
     Note:
-        Has effect only when [`selectable`][flet.Text.selectable] is `True`.
+        Has effect only when [`selectable`][(c).] is `True`.
     """

flet/controls/core/text_span.py

@@ -14,7 +14,7 @@ class TextSpan(Control):
     """
     A text span.
 
-    Usage Example: As a child of [`Text.spans`][flet.Text.spans].
+    Usage Example: As a child of [`Text.spans`][flet.].
 
     For the object to be useful, at least one of [`text`][(c).] or
     [`spans`][(c).] should be set.
@@ -25,7 +25,7 @@ class TextSpan(Control):
     The text contained in this span.
 
     Note:
-        If both `text` and [`spans`][flet.TextSpan.spans] are defined,
+        If both `text` and [`spans`][(c).] are defined,
         the `text` takes precedence.
     """
 
@@ -39,7 +39,7 @@ class TextSpan(Control):
     Additional spans to include as children.
 
     Note:
-        If both `spans` and [`text`][flet.TextSpan.text] are defined,
+        If both `spans` and [`text`][(c).] are defined,
         the `text` takes precedence.
     """
 
@@ -47,7 +47,7 @@ class TextSpan(Control):
     """
     The URL to open when this button is clicked.
 
-    Additionally, if [`on_click`][flet.TextSpan.on_click] event callback is provided,
+    Additionally, if [`on_click`][(c).] event callback is provided,
     it is fired after that.
     """
 

flet/controls/core/transparent_pointer.py

@@ -14,9 +14,9 @@ class TransparentPointer(LayoutControl):
     two widgets in Stack"](https://stackoverflow.com/questions/65269190/pass-trough-all-
     gestures-between-two-widgets-in-stack) problem.
 
-    For example, if there is an [`Button`][flet.Button]
-    inside [`Container`][flet.Container] with
-    [`GestureDetector`][flet.GestureDetector] then tapping on
+    For example, if there is an [`Button`][flet.]
+    inside [`Container`][flet.] with
+    [`GestureDetector`][flet.] then tapping on
     a button won't be "visible" to a gesture detector behind it. With
     `TransparentPointer` a tapping event doesn't stop on a button, but goes up to the
     parent, similar to event bubbling in HTML/JS.

flet/controls/core/view.py

@@ -33,14 +33,14 @@ class View(ScrollableControl, LayoutControl):
     View is the top most container for all other controls.
 
     A root view is automatically created when a new user session started. From layout
-    perspective the View represents a [`Column`][flet.Column]
+    perspective the View represents a [`Column`][flet.]
     control, so it has a similar behavior and shares same properties.
     """
 
     route: Optional[str] = None
     """
     View's route - not currently used by Flet framework, but can be used in a user
-    program to update [`Page.route`][flet.Page.route] when a view popped.
+    program to update [`Page.route`][flet.] when a view popped.
     """
 
     controls: list[BaseControl] = field(default_factory=list)
@@ -73,19 +73,19 @@ class View(ScrollableControl, LayoutControl):
 
     appbar: Optional[Union[AppBar, CupertinoAppBar]] = None
     """
-    An [`AppBar`][flet.AppBar] control to display at the top of
+    An [`AppBar`][flet.] control to display at the top of
     the `Page`.
     """
 
     bottom_appbar: Optional[BottomAppBar] = None
     """
-    A [`BottomAppBar`][flet.BottomAppBar] control to display at the bottom of
+    A [`BottomAppBar`][flet.] control to display at the bottom of
     the `Page`.
     """
 
     floating_action_button: Optional[FloatingActionButton] = None
     """
-    A [`FloatingActionButton`][flet.FloatingActionButton] control to display on top
+    A [`FloatingActionButton`][flet.] control to display on top
     of `Page` content.
     """
 
@@ -93,31 +93,31 @@ class View(ScrollableControl, LayoutControl):
         Union[FloatingActionButtonLocation, OffsetValue]
     ] = None
     """
-    Describes position of [`floating_action_button`][flet.View.floating_action_button]
+    Describes position of [`floating_action_button`][(c).]
     """
 
     navigation_bar: Union[NavigationBar, CupertinoNavigationBar, None] = None
     """
-    A navigation bar ([`NavigationBar`][flet.NavigationBar] or
-    [`CupertinoNavigationBar`][flet.CupertinoNavigationBar]) control to display
+    A navigation bar ([`NavigationBar`][flet.] or
+    [`CupertinoNavigationBar`][flet.]) control to display
     at the bottom of the `Page`.
     """
 
     drawer: Optional[NavigationDrawer] = None
     """
-    A [`NavigationDrawer`][flet.NavigationDrawer] control to
+    A [`NavigationDrawer`][flet.] control to
     display as a panel sliding from the start edge of the view.
     """
 
     end_drawer: Optional[NavigationDrawer] = None
     """
-    A [`NavigationDrawer`][flet.NavigationDrawer] control to
+    A [`NavigationDrawer`][flet.] control to
     display as a panel sliding from the end edge of the view.
     """
 
     vertical_alignment: MainAxisAlignment = MainAxisAlignment.START
     """
-    Defines how the child [`controls`][flet.View.controls] should be placed vertically.
+    Defines how the child [`controls`][(c).] should be placed vertically.
     """
 
     horizontal_alignment: CrossAxisAlignment = CrossAxisAlignment.START
@@ -127,14 +127,14 @@ class View(ScrollableControl, LayoutControl):
 
     spacing: Number = 10
     """
-    The vertical spacing between [`controls`][flet.View.controls] on the `Page`.
+    The vertical spacing between [`controls`][(c).] on the `Page`.
 
     Note:
-        Has effect only when [`vertical_alignment`][flet.View.vertical_alignment]
+        Has effect only when [`vertical_alignment`][(c).]
         is set to
-        [`MainAxisAlignment.START`][flet.MainAxisAlignment.START],
-        [`MainAxisAlignment.END`][flet.MainAxisAlignment.END],
-        or [`MainAxisAlignment.CENTER`][flet.MainAxisAlignment.CENTER].
+        [`MainAxisAlignment.START`][flet.],
+        [`MainAxisAlignment.END`][flet.],
+        or [`MainAxisAlignment.CENTER`][flet.].
     """
 
     padding: Optional[PaddingValue] = field(default_factory=lambda: Padding.all(10))

flet/controls/core/window.py

@@ -63,7 +63,7 @@ class Window(BaseControl):
     Sets background color of an application window.
 
     Tip:
-        Can be used together with [`Page.bgcolor`][flet.Page.bgcolor] to make
+        Can be used together with [`Page.bgcolor`][flet.] to make
         a window transparent.
     """
 

flet/controls/core/window_drag_area.py

@@ -36,7 +36,7 @@ class WindowDragArea(LayoutControl):
     Called when the `WindowDragArea` is double-tapped and `maximizable=True`.
 
     Info:
-        When a double-tap event is fired, the [`type`][flet.WindowEvent.type]
+        When a double-tap event is fired, the [`type`][flet.WindowEvent.]
         property of the event handler argument can only be one of the following:
         `WindowEventType.MAXIMIZE`, `WindowEventType.UNMAXIMIZE`.
     """

flet/controls/cupertino/cupertino_action_sheet.py

@@ -12,13 +12,16 @@ __all__ = ["CupertinoActionSheet"]
 class CupertinoActionSheet(LayoutControl):
     """
     An iOS-style action sheet.
+
+    Action sheets are generally used to give the user a choice between
+    two or more choices for the current context.
     """
 
     title: Optional[StrOrControl] = None
     """
     A control containing the title of the action sheet.
 
-    Typically a [`Text`][flet.Text] control.
+    Typically a [`Text`][flet.] control.
     """
 
     message: Optional[StrOrControl] = None
@@ -26,23 +29,31 @@ class CupertinoActionSheet(LayoutControl):
     A control containing a descriptive message that provides more details about the
     reason for the alert.
 
-    Typically a [`Text`][flet.Text] control.
+    Typically a [`Text`][flet.] control.
     """
 
     actions: Optional[list[Control]] = None
     """
     A list of action buttons to be shown in the sheet.
 
-    These actions are typically
-    [`CupertinoActionSheetAction`][flet.CupertinoActionSheetAction]s.
-
-    This list must have at least one action.
+    These actions are typically [`CupertinoActionSheetAction`][flet.]s.
     """
 
     cancel: Optional[Control] = None
     """
     An optional control to be shown below the actions but grouped separately from them.
 
-    Typically a [`CupertinoActionSheetAction`][flet.CupertinoActionSheetAction]
-    button.
+    Typically a [`CupertinoActionSheetAction`][flet.] button.
     """
+
+    def before_update(self):
+        super().before_update()
+        assert (
+            self.actions is not None
+            or self.title is not None
+            or self.message is not None
+            or self.cancel is not None
+        ), (
+            "This action sheet must have a non-None value for at least one of the "
+            "following arguments: `actions`, `title`, `message`, or `cancel`"
+        )

flet/controls/cupertino/cupertino_activity_indicator.py

@@ -13,26 +13,25 @@ class CupertinoActivityIndicator(LayoutControl):
     An iOS-style activity indicator that spins clockwise.
 
     Raises:
-        ValueError: If `radius` is not strictly greater than 0.
+        ValueError: If [`radius`][(c).] is not strictly greater than `0`.
     """
 
     radius: Number = 10
     """
-    The radius of the activity indicator.
+    The radius of this indicator.
 
     Note:
-        Must be strictly greater than 0.
+        Must be strictly greater than `0`.
     """
 
     color: Optional[ColorValue] = None
     """
-    Defines the color of the activity
-    indicator.
+    Defines the color of this indicator.
     """
 
     animating: bool = True
     """
-    Whether the activity indicator is running its animation.
+    Whether this indicator is running its animation.
     """
 
     def before_update(self):

flet/controls/cupertino/cupertino_alert_dialog.py

@@ -28,27 +28,24 @@ class CupertinoAlertDialog(DialogControl):
 
     title: Optional[StrOrControl] = None
     """
-    The (optional) title of the dialog is displayed in a large font at the top of the
-    dialog.
+    The title of this dialog, displayed in a large font at the top of this dialog.
 
-    Typically a [`Text`][flet.Text] control.
+    Typically a [`Text`][flet.] control.
     """
 
     content: Optional[Control] = None
     """
-    The (optional) content of the dialog is displayed in the center of the dialog in a
-    lighter font.
+    The content of this dialog, displayed in a light font at the center of this dialog.
 
-    Typically this is a [`Column`][flet.Column] that contains
-    the dialog's [`Text`][flet.Text] message.
+    Typically a [`Column`][flet.] that contains
+    the dialog's [`Text`][flet.] message.
     """
 
     actions: list[Control] = field(default_factory=list)
     """
-    The (optional) set of actions that are displayed at the bottom of the dialog.
+    A set of actions that are displayed at the bottom of the dialog.
 
-    Typically this is a list of
-    [`CupertinoDialogAction`][flet.CupertinoDialogAction] controls.
+    Typically this is a list of [`CupertinoDialogAction`][flet.] controls.
     """
 
     inset_animation: Animation = field(