@anvil-works/anvil-pyright 0.0.1 → 0.0.2-canary

package/dist/anvil-typeshed/source/anvil/__init__.pyi

@@ -0,0 +1,1306 @@
+# Type stubs for Anvil
+# Generated files: client/anvil/__init__.pyi, server/anvil/__init__.pyi
+
+from typing import Any, Callable, TypeVar, overload, Iterator, Mapping, Literal
+
+_T = TypeVar("_T")
+_F = TypeVar("_F", bound=Callable[..., Any])
+
+# ============================================================================
+# Media Classes
+# ============================================================================
+
+class Media:
+    """A Media object represents binary data, such as a file.
+
+    [Anvil Docs](https://anvil.works/docs/media)"""
+
+    content_type: str
+    """The MIME type of this Media."""
+
+    name: str | None
+    """The file name associated with this Media, or None if it has no name."""
+
+    url: str | None
+    """The URL where you can download this Media, or None if it is not downloadable."""
+
+    length: int
+    """The length of this Media, in bytes."""
+
+    def get_bytes(self) -> bytes:
+        """Get a binary string of the data represented by this Media object.
+
+        [Anvil Docs](https://anvil.works/docs/media)"""
+        ...
+
+    def get_url(self) -> str | None:
+        """Get a Media object's URL, or None if there isn't one associated with it.
+
+        [Anvil Docs](https://anvil.works/docs/media)"""
+        ...
+
+
+class BlobMedia(Media):
+    """Create a Media object with the specified content_type and content.
+
+    Optionally specify a filename as well.
+
+    [Anvil Docs](https://anvil.works/docs/media)"""
+
+    def __init__(self, content_type: str, content: bytes, *, name: str | None = None) -> None: ...
+
+
+class URLMedia(Media):
+    """Create a Media object representing the data at a specific URL.
+
+    Caution: Getting data from URLs directly in your code will often fail
+    for security reasons, or fail to handle binary data.
+
+    [Anvil Docs](https://anvil.works/docs/media)"""
+
+    def __init__(self, url: str, /) -> None: ...
+
+
+# ============================================================================
+# App Information
+# ============================================================================
+
+class AppEnvironment:
+    """Information about the current app environment."""
+
+    name: str
+    """The name of the current environment."""
+
+    tags: list[str]
+    """Tags associated with the current environment."""
+
+
+class AppInfo:
+    """Information about the current app.
+
+    [Anvil Docs](https://anvil.works/docs/deployment/environment-variables)"""
+
+    id: str
+    """A unique identifier for the current app."""
+
+    branch: str
+    """The Git branch from which the current app is being run.
+
+    This is 'master' for development apps or apps without a published version,
+    and 'published' if this app is being run from its published version."""
+
+    package_name: str
+    """The package name of this app."""
+
+    environment: AppEnvironment
+    """The environment in which the current app is being run."""
+
+    theme_colors: Mapping[str, str]
+    """Theme colors for this app as a readonly dict."""
+
+    def get_asset(self, path: str | None = None) -> Media:
+        """Get an asset file from the app's theme assets."""
+        ...
+
+    def get_client_config(self, package_name: str | None = None) -> dict[str, Any]:
+        """Get the client config for the specified package.
+
+        If no package name is specified, the client config for the current app is returned."""
+        ...
+
+    def get_server_config(self, package_name: str | None = None) -> dict[str, Any]:
+        """Get the server config for the specified package.
+
+        If no package name is specified, the server config for the current app is returned."""
+        ...
+
+
+app: AppInfo
+"""Information about the current app, as an instance of AppInfo."""
+
+
+# ============================================================================
+# Utility Functions
+# ============================================================================
+
+def is_server_side() -> bool:
+    """Check whether Anvil is running server side or not."""
+    ...
+
+
+# @client-only
+# ============================================================================
+# Alert and Notification Functions (client-only)
+# ============================================================================
+
+def alert(
+    content: str | Any,
+    *,
+    title: str = "",
+    buttons: list[Any] | None = None,
+    large: bool = False,
+    dismissible: bool = True,
+    role: str | None = None,
+) -> Any:
+    """Pop up an alert box.
+
+    By default, it will have a single "OK" button which will return True when clicked.
+
+    [Anvil Docs](https://anvil.works/docs/client/python/alerts-and-notifications)"""
+    ...
+
+
+def confirm(
+    content: str | Any,
+    *,
+    title: str = "",
+    buttons: list[Any] | None = None,
+    large: bool = False,
+    dismissible: bool = False,
+    role: str | None = None,
+) -> bool:
+    """Pop up a confirmation box.
+
+    By default, it will have "Yes" and "No" buttons which will return True and False
+    respectively when clicked.
+
+    [Anvil Docs](https://anvil.works/docs/client/python/alerts-and-notifications)"""
+    ...
+
+
+class Notification:
+    """Create a popup notification. Call the show() method to display it.
+
+    Can also be used as a context manager.
+
+    [Anvil Docs](https://anvil.works/docs/client/python/alerts-and-notifications)"""
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        title: str = "",
+        style: str = "info",
+        timeout: int | float = 2,
+    ) -> None: ...
+
+    def show(self) -> "Notification":
+        """Shows the notification."""
+        ...
+
+    def hide(self) -> None:
+        """Hides the notification immediately."""
+        ...
+
+    def __enter__(self) -> "Notification":
+        """Show the notification when entering a 'with' block."""
+        ...
+
+    def __exit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None:
+        """Hide the notification when exiting a 'with' block."""
+        ...
+
+
+# ============================================================================
+# Navigation Functions (client-only)
+# ============================================================================
+
+def get_open_form() -> Any:
+    """Returns the form most recently opened with open_form().
+
+    [Anvil Docs](https://anvil.works/docs/client/python/forms-and-components)"""
+    ...
+
+
+def open_form(form: str | Any, *args: Any, **kwargs: Any) -> None:
+    """Open the specified form as a new page.
+
+    If 'form' is a string, a new form will be created (extra arguments will be passed
+    to its constructor). If 'form' is a Form object, it will be opened directly.
+
+    [Anvil Docs](https://anvil.works/docs/client/python/forms-and-components)"""
+    ...
+
+
+def get_url_hash() -> str | dict[str, str]:
+    """Get the decoded hash (the part after the '#' character) of the URL used to open this app.
+
+    If the first character of the hash is a question mark (eg '#?a=foo&b=bar'),
+    it will be interpreted as query-string-type parameters and returned as a dictionary
+    (eg {'a': 'foo', 'b': 'bar'}).
+
+    [Anvil Docs](https://anvil.works/docs/client/python/navigation-and-urls)"""
+    ...
+
+
+def set_url_hash(val: str | dict[str, str], /) -> None:
+    """Sets the hash of the currently open URL.
+
+    If val is a string, it is added to the URL after a #.
+    If val is a dictionary, it will be interpreted as query-string-type parameters
+    and added to the URL after a hash and question mark (eg '#?a=foo&b=bar').
+
+    [Anvil Docs](https://anvil.works/docs/client/python/navigation-and-urls)"""
+    ...
+
+
+# ============================================================================
+# Other Client-Only Functions
+# ============================================================================
+
+def download(media: Media, /) -> None:
+    """Download the given Media Object immediately in the user's browser.
+
+    [Anvil Docs](https://anvil.works/docs/media)"""
+    ...
+
+
+def get_focused_component() -> "Component | None":
+    """Get the currently focused Anvil component, or None if focus is not in a component."""
+    ...
+
+
+def set_default_error_handling(handler_fn: Callable[[Exception], None] | None, /) -> None:
+    """Set a function to be called when an uncaught exception occurs.
+
+    If set to None, a pop-up will appear letting the user know that an error has occurred."""
+    ...
+
+
+# ============================================================================
+# Decorators
+# ============================================================================
+
+def handle(component_name: str, event_name: str, /) -> Callable[[_F], _F]:
+    """When applied to a form method as a decorator, sets the decorated method
+    as an event handler for the specified component event."""
+    ...
+
+
+# ============================================================================
+# Slot and Layout Classes (client-only)
+# ============================================================================
+
+class Slot:
+    """A Slot class represents a way to add components to an underlying container.
+
+    You will rarely instantiate a Slot on its own; instead your form's layout
+    will contain Slots to which you can add components."""
+
+    def __init__(
+        self,
+        target_container: "Container",
+        insertion_index: int,
+        layout_properties: dict[str, Any] | None = None,
+    ) -> None:
+        """Create a new Slot.
+
+        Args:
+            target_container: The target container into which components added to this slot will be added.
+            insertion_index: The starting index (within the target container) at which components
+                added to this slot will be inserted.
+            layout_properties: A dictionary of layout properties that will be passed as keyword
+                arguments to the target container's add_component() call.
+        """
+        ...
+
+    def add_component(
+        self,
+        component: "Component",
+        *,
+        index: int | None = None,
+        **layout_properties: Any,
+    ) -> None:
+        """Add a component to this slot.
+
+        Calling add_component() on a Slot will add the specified component to its target container.
+
+        Args:
+            component: The component to add to this slot.
+            index: The index, within the slot, at which the component is to be inserted.
+            **layout_properties: Layout properties will be passed on as keyword arguments
+                to the target container's add_component() method.
+        """
+        ...
+
+    def offset_by_slot(self, offset_by_slot: "Slot") -> None:
+        """Inform this Slot of an earlier Slot with the same target container.
+
+        Future calls to add_component() will take account of any components inserted
+        into the earlier slot when calculating the insertion index for the target container."""
+        ...
+
+
+class WithLayout(Component):
+    """Parent class of any form with a layout."""
+
+    layout: "Component"
+    """This form's layout."""
+
+
+# ============================================================================
+# JavaScript Interop (client-only)
+# ============================================================================
+
+class _JS:
+    """JavaScript interop.
+
+    [Anvil Docs](https://anvil.works/docs/client/javascript)"""
+
+    @staticmethod
+    def call(fn_name: str, *args: Any) -> Any: ...
+
+
+js: _JS
+
+
+# ============================================================================
+# Event Type Aliases for Autocomplete
+# ============================================================================
+
+# Base Component events - inherited by all components
+_ComponentEvents = Literal["show", "hide"]
+
+# Button and Link events
+_ButtonEvents = Literal["show", "hide", "click"]
+_LinkEvents = Literal["show", "hide", "click"]
+
+# Text input events
+_TextBoxEvents = Literal["show", "hide", "change", "pressed_enter", "lost_focus", "focus"]
+_TextAreaEvents = Literal["show", "hide", "change", "pressed_enter", "lost_focus", "focus"]
+
+# Selection component events
+_CheckBoxEvents = Literal["show", "hide", "change"]
+_RadioButtonEvents = Literal["show", "hide", "change", "clicked"]
+_DropDownEvents = Literal["show", "hide", "change"]
+_DatePickerEvents = Literal["show", "hide", "change"]
+_FileLoaderEvents = Literal["show", "hide", "change"]
+
+# Timer events
+_TimerEvents = Literal["show", "hide", "tick"]
+
+# Mouse-enabled component events
+_CanvasEvents = Literal["show", "hide", "mouse_down", "mouse_up", "mouse_move", "mouse_enter", "mouse_leave"]
+_ImageEvents = Literal["show", "hide", "mouse_down", "mouse_up", "mouse_move", "mouse_enter", "mouse_leave"]
+
+# Plot events
+_PlotEvents = Literal["show", "hide", "click", "double_click", "hover", "unhover", "select", "deselect"]
+
+# GoogleMap events
+_GoogleMapEvents = Literal["show", "hide", "bounds_changed", "click", "zoom_changed"]
+
+# YouTubeVideo events
+_YouTubeVideoEvents = Literal["show", "hide", "state_change"]
+
+# DataGrid events
+_DataGridEvents = Literal["show", "hide", "pagination_click"]
+
+# Tabs events
+_TabsEvents = Literal["show", "hide", "tab_click"]
+
+
+# ============================================================================
+# Component Base Classes
+# ============================================================================
+
+class Component:
+    """Base class for all Anvil components.
+
+    [Anvil Docs](https://anvil.works/docs/client/components)"""
+
+    visible: bool
+    enabled: bool
+    tooltip: str
+    tag: Any
+    parent: "Container | None"
+    role: str | None
+
+    def add_event_handler(self, event_name: _ComponentEvents | str, handler_func: Callable[..., Any], /) -> None:
+        """Add an event handler function to be called when the event happens on this component.
+
+        Event handlers will be called in the order they are added. Adding the same event
+        handler multiple times will mean it gets called multiple times.
+
+        [Anvil Docs](https://anvil.works/docs/client/python/events)"""
+        ...
+
+    def remove_event_handler(self, event_name: _ComponentEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None:
+        """Remove a specific event handler function for a given event.
+
+        Calling remove_event_handler with just the event name will remove all the handlers for this event.
+
+        [Anvil Docs](https://anvil.works/docs/client/python/events)"""
+        ...
+
+    def set_event_handler(self, event_name: _ComponentEvents | str, handler_func: Callable[..., Any] | None, /) -> None:
+        """Set a function to call when the 'event_name' event happens on this component.
+
+        Using set_event_handler removes all other handlers.
+        Setting the handler function to None removes all handlers.
+
+        [Anvil Docs](https://anvil.works/docs/client/python/events)"""
+        ...
+
+    def get_event_handlers(self, event_name: _ComponentEvents | str, /) -> tuple[Callable[..., Any], ...]:
+        """Get the list of event handler functions for a given event.
+
+        [Anvil Docs](https://anvil.works/docs/client/python/events)"""
+        ...
+
+    def raise_event(self, event_name: _ComponentEvents | str, /, **event_args: Any) -> None:
+        """Raise an event on this component.
+
+        [Anvil Docs](https://anvil.works/docs/client/python/events)"""
+        ...
+
+    def scroll_into_view(self, *, smooth: bool = False, align: str = "center") -> None:
+        """Scroll this component into view.
+
+        [Anvil Docs](https://anvil.works/docs/client/components)"""
+        ...
+
+
+class Container(Component):
+    """Base class for container components.
+
+    [Anvil Docs](https://anvil.works/docs/client/components)"""
+
+    def add_component(self, component: Component, /, **layout_props: Any) -> None:
+        """Add a component to this container.
+
+        [Anvil Docs](https://anvil.works/docs/client/components)"""
+        ...
+
+    def remove_from_parent(self) -> None:
+        """Remove this container from its parent.
+
+        [Anvil Docs](https://anvil.works/docs/client/components)"""
+        ...
+
+    def clear(self) -> None:
+        """Remove all components from this container.
+
+        [Anvil Docs](https://anvil.works/docs/client/components)"""
+        ...
+
+    def get_components(self) -> list[Component]:
+        """Get a list of components in this container.
+
+        [Anvil Docs](https://anvil.works/docs/client/components)"""
+        ...
+
+    def raise_event_on_children(self, event_name: str, /, **event_args: Any) -> None:
+        """Trigger the 'event_name' event on all children of this component.
+
+        Any keyword arguments are passed to the handler function.
+
+        [Anvil Docs](https://anvil.works/docs/client/components)"""
+        ...
+
+
+# ============================================================================
+# Basic Display Components
+# ============================================================================
+
+class Label(Component):
+    """A label for displaying text.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/label)"""
+
+    text: str
+    icon: str
+    icon_align: str
+    font_size: int | None
+    font: str
+    bold: bool
+    italic: bool
+    underline: bool
+    foreground: str
+    background: str
+    border: str
+    align: str
+    spacing_above: str
+    spacing_below: str
+
+
+class Link(Component):
+    """A clickable link component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/link)"""
+
+    text: str
+    url: str
+    icon: str
+    icon_align: str
+    font_size: int | None
+    font: str
+    bold: bool
+    italic: bool
+    underline: bool
+    foreground: str
+    background: str
+    border: str
+    align: str
+
+    def add_event_handler(self, event_name: _LinkEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _LinkEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _LinkEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _LinkEvents | str, /, **event_args: Any) -> None: ...
+
+
+class Image(Component):
+    """An image display component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/image)"""
+
+    source: str | Media
+    display_mode: str
+    horizontal_align: str
+    vertical_align: str
+    height: str
+
+    def add_event_handler(self, event_name: _ImageEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _ImageEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _ImageEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _ImageEvents | str, /, **event_args: Any) -> None: ...
+
+
+class Spacer(Component):
+    """A spacer component for layout.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/spacer)"""
+
+    height: int
+
+
+class RichText(Component):
+    """A rich text display component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/richtext)"""
+
+    content: str
+    format: str
+    data: dict[str, Any]
+
+
+# ============================================================================
+# Input Components
+# ============================================================================
+
+class Button(Component):
+    """A clickable button component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/button)"""
+
+    text: str
+    icon: str
+    icon_align: str
+    font_size: int | None
+    font: str
+    bold: bool
+    italic: bool
+    underline: bool
+    foreground: str
+    background: str
+    border: str
+    align: str
+
+    def add_event_handler(self, event_name: _ButtonEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _ButtonEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _ButtonEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _ButtonEvents | str, /, **event_args: Any) -> None: ...
+
+
+class TextBox(Component):
+    """A single-line text input component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/textbox)"""
+
+    text: str
+    placeholder: str
+    type: str
+    hide_text: bool
+    font_size: int | None
+    font: str
+    bold: bool
+    italic: bool
+    underline: bool
+    foreground: str
+    background: str
+    border: str
+    align: str
+
+    def add_event_handler(self, event_name: _TextBoxEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _TextBoxEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _TextBoxEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _TextBoxEvents | str, /, **event_args: Any) -> None: ...
+
+    def focus(self) -> None:
+        """Set focus to this text box.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/textbox)"""
+        ...
+
+    def select(self) -> None:
+        """Select all text in this text box.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/textbox)"""
+        ...
+
+
+class TextArea(Component):
+    """A multi-line text input component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/textarea)"""
+
+    text: str
+    placeholder: str
+    rows: int | None
+    auto_expand: bool
+    height: str
+    font_size: int | None
+    font: str
+    bold: bool
+    italic: bool
+    underline: bool
+    foreground: str
+    background: str
+    border: str
+
+    def add_event_handler(self, event_name: _TextAreaEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _TextAreaEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _TextAreaEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _TextAreaEvents | str, /, **event_args: Any) -> None: ...
+
+    def focus(self) -> None:
+        """Set focus to this text area.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/textarea)"""
+        ...
+
+    def select(self) -> None:
+        """Select all text in this text area.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/textarea)"""
+        ...
+
+
+class CheckBox(Component):
+    """A checkbox input component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/checkbox)"""
+
+    checked: bool
+    text: str
+    font_size: int | None
+    font: str
+    bold: bool
+    italic: bool
+    underline: bool
+    foreground: str
+    background: str
+    border: str
+    align: str
+
+    def add_event_handler(self, event_name: _CheckBoxEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _CheckBoxEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _CheckBoxEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _CheckBoxEvents | str, /, **event_args: Any) -> None: ...
+
+
+class RadioButton(Component):
+    """A radio button input component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/radiobutton)"""
+
+    selected: bool
+    value: Any
+    group_name: str
+    text: str
+    font_size: int | None
+    font: str
+    bold: bool
+    italic: bool
+    underline: bool
+    foreground: str
+    background: str
+    border: str
+    align: str
+
+    def add_event_handler(self, event_name: _RadioButtonEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _RadioButtonEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _RadioButtonEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _RadioButtonEvents | str, /, **event_args: Any) -> None: ...
+
+    @staticmethod
+    def get_group_value(group_name: str) -> Any:
+        """Get the selected value from a radio button group.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/radiobutton)"""
+        ...
+
+
+class DropDown(Component):
+    """A dropdown selection component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/dropdown)"""
+
+    items: list[Any]
+    selected_value: Any
+    include_placeholder: bool
+    placeholder: str
+    font_size: int | None
+    font: str
+    bold: bool
+    italic: bool
+    underline: bool
+    foreground: str
+    background: str
+    border: str
+    align: str
+
+    def add_event_handler(self, event_name: _DropDownEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _DropDownEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _DropDownEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _DropDownEvents | str, /, **event_args: Any) -> None: ...
+
+
+class DatePicker(Component):
+    """A date picker input component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/datepicker)"""
+
+    date: Any  # datetime.date or None
+    min_date: Any
+    max_date: Any
+    format: str
+    pick_time: bool
+    placeholder: str
+    font_size: int | None
+    font: str
+    bold: bool
+    italic: bool
+    underline: bool
+    foreground: str
+    background: str
+    border: str
+    align: str
+
+    def add_event_handler(self, event_name: _DatePickerEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _DatePickerEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _DatePickerEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _DatePickerEvents | str, /, **event_args: Any) -> None: ...
+
+
+class FileLoader(Component):
+    """A file upload component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/fileloader)"""
+
+    file: Media | None
+    files: list[Media]
+    multiple: bool
+    show_state: bool
+    text: str
+    font_size: int | None
+    font: str
+    bold: bool
+    italic: bool
+    underline: bool
+    foreground: str
+    background: str
+    border: str
+    align: str
+
+    def add_event_handler(self, event_name: _FileLoaderEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _FileLoaderEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _FileLoaderEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _FileLoaderEvents | str, /, **event_args: Any) -> None: ...
+
+    def clear(self) -> None:
+        """Clear the selected file(s).
+
+        [Anvil Docs](https://anvil.works/docs/client/components/fileloader)"""
+        ...
+
+
+# ============================================================================
+# Container Components
+# ============================================================================
+
+class ColumnPanel(Container):
+    """A container that arranges components vertically.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/columnpanel)"""
+
+    col_widths: str
+    col_spacing: str
+    wrap_on: str
+    background: str
+    foreground: str
+    border: str
+    spacing_above: str
+    spacing_below: str
+
+
+class FlowPanel(Container):
+    """A container that arranges components in a flowing layout.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/flowpanel)"""
+
+    align: str
+    spacing: str
+    vertical_align: str
+    background: str
+    foreground: str
+    border: str
+    spacing_above: str
+    spacing_below: str
+
+
+class LinearPanel(Container):
+    """A container that arranges components in a linear layout.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/linearpanel)"""
+
+    background: str
+    foreground: str
+    border: str
+    spacing_above: str
+    spacing_below: str
+
+
+class GridPanel(Container):
+    """A container that arranges components in a grid.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/gridpanel)"""
+
+    background: str
+    foreground: str
+    border: str
+
+
+class XYPanel(Container):
+    """A container that positions components at absolute coordinates.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/xypanel)"""
+
+    background: str
+    foreground: str
+    border: str
+    height: str
+
+
+class DataGrid(Container):
+    """A data grid component for displaying tabular data.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/datagrid)"""
+
+    columns: list[dict[str, Any]]
+    rows_per_page: int | None
+    show_page_controls: bool
+    auto_header: bool
+    wrap_on: str
+    background: str
+    foreground: str
+    border: str
+
+    def add_event_handler(self, event_name: _DataGridEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _DataGridEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _DataGridEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _DataGridEvents | str, /, **event_args: Any) -> None: ...
+
+
+class DataRowPanel(Container):
+    """A row within a DataGrid.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/datagrid)"""
+
+    item: dict[str, Any]
+    background: str
+    foreground: str
+    border: str
+
+
+class RepeatingPanel(Container):
+    """A panel that repeats a template for each item in a list.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/repeatingpanel)"""
+
+    items: list[Any] | Iterator[Any]
+    item_template: str
+    background: str
+    foreground: str
+    border: str
+
+    def get_components(self) -> list[Container]:
+        """Get all repeated template instances.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/repeatingpanel)"""
+        ...
+
+
+class Tabs(Container):
+    """A tabbed container component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/tabs)"""
+
+    tab_titles: list[str]
+
+    def add_event_handler(self, event_name: _TabsEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _TabsEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _TabsEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _TabsEvents | str, /, **event_args: Any) -> None: ...
+
+
+class TabSection(Container):
+    """A section within a Tabs component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/tabs)"""
+
+    pass
+
+
+# ============================================================================
+# Media/Visualization Components
+# ============================================================================
+
+class HtmlTemplate(Container):
+    """A container that renders HTML.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/htmlpanel)"""
+
+    html: str
+
+    def call_js(self, fn_name: str, *args: Any) -> Any:
+        """Call a JavaScript function defined in the HTML.
+
+        [Anvil Docs](https://anvil.works/docs/client/javascript)"""
+        ...
+
+
+class HtmlPanel(Container):
+    """A panel that renders HTML content.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/htmlpanel)"""
+
+    html: str
+
+    def call_js(self, fn_name: str, *args: Any) -> Any:
+        """Call a JavaScript function defined in the HTML.
+
+        [Anvil Docs](https://anvil.works/docs/client/javascript)"""
+        ...
+
+
+class Canvas(Component):
+    """A drawing canvas component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/canvas)"""
+
+    width: int
+    height: int
+    background: str
+
+    def add_event_handler(self, event_name: _CanvasEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _CanvasEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _CanvasEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _CanvasEvents | str, /, **event_args: Any) -> None: ...
+
+    def get_image(self) -> Media:
+        """Get the canvas content as a media object.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/canvas)"""
+        ...
+
+    def reset_context(self) -> None:
+        """Reset the drawing context.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/canvas)"""
+        ...
+
+
+class Plot(Component):
+    """A Plotly chart component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/plot)"""
+
+    data: list[dict[str, Any]]
+    layout: dict[str, Any]
+    config: dict[str, Any]
+    figure: dict[str, Any]
+
+    def add_event_handler(self, event_name: _PlotEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _PlotEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _PlotEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _PlotEvents | str, /, **event_args: Any) -> None: ...
+
+    def redraw(self) -> None:
+        """Redraw the plot.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/plot)"""
+        ...
+
+    def to_image(self, **kwargs: Any) -> Media:
+        """Export the plot as an image.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/plot)"""
+        ...
+
+    def relayout(self, **kwargs: Any) -> None:
+        """Update the plot layout.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/plot)"""
+        ...
+
+    def extend_traces(self, data: dict[str, Any], traces: list[int]) -> None:
+        """Extend trace data.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/plot)"""
+        ...
+
+
+class _LatLng:
+    """A latitude/longitude pair for GoogleMap.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/googlemap)"""
+
+    lat: float
+    lng: float
+
+    def __init__(self, lat: float, lng: float) -> None: ...
+
+
+class _MapMarker(Component):
+    """A marker on a GoogleMap.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/googlemap#markers)"""
+
+    animation: Any
+    """The animation of this Marker."""
+
+    position: _LatLng
+    """The LatLng position of this Marker."""
+
+    icon: Any
+    """The icon to display at the position of this Marker."""
+
+    label: Any
+    """The label to display on this Marker."""
+
+    clickable: bool
+    """True if this Marker can be clicked."""
+
+    draggable: bool
+    """True if this Marker can be dragged."""
+
+    visible: bool
+    """True if this Marker is visible."""
+
+    z_index: int
+    """The z-index of this Marker."""
+
+    def remove(self) -> None:
+        """Remove this marker from the map."""
+        ...
+
+
+class _MapPolygon(Component):
+    """A polygon overlay on a GoogleMap.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/googlemap#polygons)"""
+
+    path: list[_LatLng]
+    """The ordered sequence of LatLng coordinates of the Polygon."""
+
+    geodesic: bool
+    """When true, edges of the polygon are interpreted as geodesic."""
+
+    editable: bool
+    """True if this overlay can be edited by the user."""
+
+    draggable: bool
+    """True if this overlay can be dragged."""
+
+    visible: bool
+    """True if this overlay is visible."""
+
+    stroke_color: str
+    """The stroke color."""
+
+    stroke_opacity: float
+    """The stroke opacity between 0.0 and 1.0."""
+
+    stroke_weight: int
+    """The stroke width in pixels."""
+
+    fill_color: str
+    """The fill color."""
+
+    fill_opacity: float
+    """The fill opacity between 0.0 and 1.0."""
+
+    z_index: int
+    """The z-index of this Polygon."""
+
+    def remove(self) -> None:
+        """Remove this polygon from the map."""
+        ...
+
+
+class _MapPolyline(Component):
+    """A polyline overlay on a GoogleMap.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/googlemap#polylines)"""
+
+    icons: list[Any]
+    """The icons to be rendered along the polyline."""
+
+    path: list[_LatLng]
+    """The ordered sequence of LatLng coordinates of the Polyline."""
+
+    geodesic: bool
+    """When true, edges of the polyline are interpreted as geodesic."""
+
+    editable: bool
+    """True if this overlay can be edited by the user."""
+
+    draggable: bool
+    """True if this overlay can be dragged."""
+
+    visible: bool
+    """True if this overlay is visible."""
+
+    stroke_color: str
+    """The stroke color."""
+
+    stroke_opacity: float
+    """The stroke opacity between 0.0 and 1.0."""
+
+    stroke_weight: int
+    """The stroke width in pixels."""
+
+    z_index: int
+    """The z-index of this Polyline."""
+
+    def remove(self) -> None:
+        """Remove this polyline from the map."""
+        ...
+
+
+class GoogleMap(Component):
+    """A Google Maps component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/googlemap)"""
+
+    center: _LatLng | Any
+    zoom: int
+    map_type: str
+    markers: list[_MapMarker]
+
+    # Nested classes
+    LatLng: type[_LatLng]
+    Marker: type[_MapMarker]
+    Polygon: type[_MapPolygon]
+    Polyline: type[_MapPolyline]
+
+    def add_event_handler(self, event_name: _GoogleMapEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _GoogleMapEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _GoogleMapEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _GoogleMapEvents | str, /, **event_args: Any) -> None: ...
+
+    def add_component(
+        self,
+        component: _MapMarker | _MapPolygon | _MapPolyline,
+        /,
+        **layout_props: Any,
+    ) -> None:
+        """Add a marker, polygon, or polyline to this map."""
+        ...
+
+
+class YouTubeVideo(Component):
+    """A YouTube video player component.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/youtubevideo)"""
+
+    youtube_id: str
+    autoplay: bool
+    loop: bool
+    mute: bool
+    volume: float
+    current_time: float
+    duration: float
+    state: str
+
+    def add_event_handler(self, event_name: _YouTubeVideoEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _YouTubeVideoEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _YouTubeVideoEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _YouTubeVideoEvents | str, /, **event_args: Any) -> None: ...
+
+    def play(self) -> None:
+        """Start playing this YouTube video.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/youtubevideo)"""
+        ...
+
+    def pause(self) -> None:
+        """Pause this YouTube video.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/youtubevideo)"""
+        ...
+
+    def stop(self) -> None:
+        """Stop playing this YouTube video.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/youtubevideo)"""
+        ...
+
+
+# ============================================================================
+# Utility Components
+# ============================================================================
+
+class Timer(Component):
+    """A timer component for periodic events.
+
+    [Anvil Docs](https://anvil.works/docs/client/components/timer)"""
+
+    interval: float
+
+    def add_event_handler(self, event_name: _TimerEvents | str, handler_func: Callable[..., Any], /) -> None: ...
+    def remove_event_handler(self, event_name: _TimerEvents | str, handler_func: Callable[..., Any] | None = None, /) -> None: ...
+    def set_event_handler(self, event_name: _TimerEvents | str, handler_func: Callable[..., Any] | None, /) -> None: ...
+    def raise_event(self, event_name: _TimerEvents | str, /, **event_args: Any) -> None: ...
+
+    def start(self) -> None:
+        """Start the timer.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/timer)"""
+        ...
+
+    def stop(self) -> None:
+        """Stop the timer.
+
+        [Anvil Docs](https://anvil.works/docs/client/components/timer)"""
+        ...
+
+
+# @end-client-only
+
+# @server-only
+# ============================================================================
+# Server-Only: Secrets Access
+# ============================================================================
+
+class _Secrets:
+    """Access to app secrets.
+
+    [Anvil Docs](https://anvil.works/docs/deployment/secrets)"""
+
+    def get_secret(self, name: str) -> str | None: ...
+    def __getattr__(self, name: str) -> str | None: ...
+
+
+secrets: _Secrets
+# @end-server-only