update cupertino controls

Author: ndonkoHenri

sdk/python/packages/flet/src/flet/controls/cupertino/cupertino_action_sheet.py

@@ -12,37 +12,48 @@
 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
     """
     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`"
+        )

sdk/python/packages/flet/src/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):

sdk/python/packages/flet/src/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(

sdk/python/packages/flet/src/flet/controls/cupertino/cupertino_app_bar.py

@@ -15,27 +15,27 @@ class CupertinoAppBar(Control):
     An iOS-styled app bar.
 
     Note:
-        The alignment of the [`title`][(c).] depends on whether this app bar is [`large`][(c).] or not.
-        If it is `True`, the `title` is left-aligned and if it is `False` (the default),
-        the `title` is centered.
+        The alignment of the [`title`][(c).] depends on whether
+        this app bar is [`large`][(c).] or not.
+        If it is `True`, the [`title`][(c).] is left-aligned and if it
+        is `False` (the default), the [`title`][(c).] is centered.
     """
 
     leading: Optional[Control] = None
     """
     A control to display at the start of this app bar.
 
-    Typically the leading control is an [`Icon`][flet.Icon] or an
-    [`IconButton`][flet.IconButton].
+    Typically the leading control is an [`Icon`][flet.] or an [`IconButton`][flet.] .
 
-    If it is `None` and [`automatically_imply_leading = True`][flet.CupertinoAppBar.automatically_imply_leading],
+    If it is `None` and [`automatically_imply_leading`][(c).] is `True`,
     an appropriate button will be automatically created.
     """
 
     title: Optional[StrOrControl] = None
     """
     A string or a control to display in the middle of this app bar.
 
-    Typically a [`Text`][flet.Text].
+    Typically a [`Text`][flet.].
     """
 
     trailing: Optional[Control] = None
@@ -54,20 +54,21 @@ class CupertinoAppBar(Control):
 
     automatically_imply_leading: Optional[bool] = None
     """
-    Whether we should try to imply the [`leading`][flet.CupertinoAppBar.leading]
-    control if `None`.
+    Whether we should try to imply the [`leading`][(c).] control if `None`.
 
-    - If `True` and `leading` is `None`, the app bar will automatically determine an appropriate leading control.
-    - If `False` and `leading` is `None`, the space is allocated to the `title`.
-    - If a `leading` control is provided, this parameter has no effect.
+    - If `True` and [`leading`][(c).] is `None`, the app bar will automatically
+        determine an appropriate leading control.
+    - If `False` and [`leading`][(c).] is `None`,
+        the space is allocated to the [`title`][(c).].
+    - If a [`leading`][(c).] control is provided, this parameter has no effect.
     """
 
     automatically_imply_title: Optional[bool] = None
     """
     Whether we should try to imply the `title` control if `None`.
 
-    - If True and `title` is `None`, a [`Text`][flet.Text] control containing the
-      current route's title will be automatically filled in.
+    - If True and `title` is `None`, a [`Text`][flet.] control containing the
+        current route's title will be automatically filled in.
     - If the `title` is not `None`, this parameter has no effect.
     """
 
@@ -84,10 +85,10 @@ class CupertinoAppBar(Control):
     If `None`, the app bar will adopt the following defaults:
 
     - vertically, contents will be sized to the same height as the app bar itself minus
-      the status bar.
+        the status bar.
     - horizontally, padding will be `16` pixels according to iOS specifications unless
-      the leading widget is an automatically inserted back button, in which case the
-      padding will be `0`.
+        the leading widget is an automatically inserted back button, in which case the
+        padding will be `0`.
 
     Note:
         Vertical padding (`top` and `bottom`) won't change the height of this app bar.
@@ -97,8 +98,8 @@ class CupertinoAppBar(Control):
     """
     Determines whether the app bar transitions between routes.
 
-    If `True`, this app bar will animate on top of route transitions when the destination
-    route also contains a `CupertinoAppBar` or `CupertinoSliverAppBar` with
+    If `True`, this app bar will animate on top of route transitions when the
+    destination route also contains a `CupertinoAppBar` or `CupertinoSliverAppBar` with
     `transition_between_routes` set to `True`.
 
     This transition also occurs during edge back swipe gestures, mimicking native iOS
@@ -111,49 +112,48 @@ class CupertinoAppBar(Control):
 
     previous_page_title: Optional[str] = None
     """
-    Manually specify the previous route's title when automatically implying the leading back button.
+    Manually specify the previous route's title when automatically implying
+    the leading back button.
 
     Overrides the text shown with the back chevron instead of automatically showing the
-    previous route's title when [`automatically_imply_leading`][flet.CupertinoAppBar.automatically_imply_leading]
-    is `True`.
+    previous route's title when [`automatically_imply_leading`][(c).] is `True`.
 
     Note:
         Has no effect if `leading` is not `None` or if
-        [`automatically_imply_leading`][flet.CupertinoAppBar.automatically_imply_leading] is `False`.
+        [`automatically_imply_leading`][(c).] is `False`.
     """
 
     brightness: Optional[Brightness] = None
     """
-    The brightness of the specified [`bgcolor`][flet.CupertinoAppBar.bgcolor].
+    The brightness of the specified [`bgcolor`][(c).].
 
     Setting this value changes the style of the system status bar. It is typically used
-    to increase the contrast ratio of the system status bar over `bgcolor`.
+    to increase the contrast ratio of the system status bar over [`bgcolor`][(c).].
 
     If `None` (the default), its value will be inferred from the relative luminance of
-    the `bgcolor`.
+    the [`bgcolor`][(c).].
     """
 
     automatic_background_visibility: Optional[bool] = None
     """
-    Whether the navigation bar should appear transparent when content is scrolled under
-    it.
+    Whether the navigation bar should appear transparent
+    when content is scrolled under it.
 
-    If `False`, the navigation bar will display its [`bgcolor`][flet.CupertinoAppBar.bgcolor].
+    If `False`, the navigation bar will display its [`bgcolor`][(c).].
     """
 
     enable_background_filter_blur: Optional[bool] = None
     """
-    Whether to have a blur effect when a non-opaque [`bgcolor`][flet.CupertinoAppBar.bgcolor] is used.
+    Whether to have a blur effect when a non-opaque [`bgcolor`][(c).] is used.
 
-    This will only be respected when
-    [`automatic_background_visibility`][flet.CupertinoAppBar.automatic_background_visibility]
+    This will only be respected when [`automatic_background_visibility`][(c).]
     is `False` or until content scrolls under the navigation bar.
     """
 
     large: bool = False
     """
     Whether to use a large app bar layout.
 
-    If `True`, the title will be left-aligned and if it is `False`, the title will be
-    centered.
+    If `True`, the [`title`][(c).] is left-aligned;
+    if `False`, the [`title`][(c).] is centered.
     """

sdk/python/packages/flet/src/flet/controls/cupertino/cupertino_bottom_sheet.py

@@ -12,23 +12,23 @@
 @control("CupertinoBottomSheet")
 class CupertinoBottomSheet(DialogControl):
     """
-    A Cupertino version of modal bottom sheet.
+    A Cupertino bottom sheet.
     """
 
     content: Control
     """
-    The control to be displayed.
+    The control to be displayed in this bottom sheet.
     """
 
     modal: bool = False
     """
-    Whether this bottom sheet can be dismissed/closed by clicking the area outside of
-    it.
+    Whether this bottom sheet can be dismissed/closed by
+    clicking the area outside of it.
     """
 
     bgcolor: Optional[ColorValue] = None
     """
-    The sheet's background color.
+    The background color of this bottom sheet.
     """
 
     height: Optional[Number] = None

sdk/python/packages/flet/src/flet/controls/cupertino/cupertino_button.py

@@ -49,7 +49,7 @@ class CupertinoButton(LayoutControl):
 
     icon_color: Optional[ColorValue] = None
     """
-    The foreground color of the [`icon`][flet.CupertinoButton.icon].
+    The foreground color of the [`icon`][(c).].
     """
 
     bgcolor: Optional[ColorValue] = None
@@ -110,7 +110,7 @@ class CupertinoButton(LayoutControl):
     """
     The URL to open when this button is clicked.
 
-    Additionally, if [`on_click`][flet.CupertinoButton.on_click] event callback is
+    Additionally, if [`on_click`][(c).] event callback is
     provided, it is fired after that.
     """
 
@@ -124,9 +124,9 @@ class CupertinoButton(LayoutControl):
     """
     The color to use for the focus highlight for keyboard interactions.
 
-    Defaults to a slightly transparent [`bgcolor`][flet.CupertinoButton.bgcolor].
+    Defaults to a slightly transparent [`bgcolor`][(c).].
     If `bgcolor` is `None`, defaults to a slightly transparent
-    [`CupertinoColors.ACTIVE_BLUE`][flet.CupertinoColors.ACTIVE_BLUE].
+    [`CupertinoColors.ACTIVE_BLUE`][flet.].
     'Slightly transparent' in this context means the color is used with an opacity
     of `0.80`, a brightness of `0.69` and a saturation of `0.835`.
     """