nicegui-bootstrap-components 0.1.0__py3-none-any.whl

nicegui_bootstrap_components/bs/__init__.py

@@ -0,0 +1,267 @@
+"""Native Bootstrap component surface (PascalCase classes, snake_case aliases)."""
+
+from __future__ import annotations
+
+from ._actions import Button, ButtonGroup, button, button_group
+from ._alert_spinner import Alert, Spinner, alert, spinner
+from ._carousel import Carousel, carousel
+from ._choices import (
+    Checkbox,
+    Checklist,
+    RadioButton,
+    RadioItems,
+    Select,
+    Switch,
+    checkbox,
+    checklist,
+    radio_button,
+    radio_items,
+    select,
+    switch,
+)
+from ._content import (
+    Badge,
+    Card,
+    CardBody,
+    CardFooter,
+    CardGroup,
+    CardHeader,
+    CardImg,
+    CardImgOverlay,
+    CardLink,
+    ListGroup,
+    ListGroupItem,
+    Placeholder,
+    Progress,
+    Table,
+    badge,
+    card,
+    card_body,
+    card_footer,
+    card_group,
+    card_header,
+    card_img,
+    card_img_overlay,
+    card_link,
+    list_group,
+    list_group_item,
+    placeholder,
+    progress,
+    table,
+)
+from ._forms import (
+    Form,
+    FormFeedback,
+    FormFloating,
+    FormText,
+    InputGroup,
+    InputGroupText,
+    Label,
+    form,
+    form_feedback,
+    form_floating,
+    form_text,
+    input_group,
+    input_group_text,
+    label,
+)
+from ._inputs import Input, Textarea, input, textarea
+from ._layout import Col, Container, Row, Stack, col, container, row, stack
+from ._nav import (
+    Breadcrumb,
+    Nav,
+    NavItem,
+    NavLink,
+    Pagination,
+    breadcrumb,
+    nav,
+    nav_item,
+    nav_link,
+    pagination,
+)
+from ._navbar import (
+    Navbar,
+    NavbarBrand,
+    NavbarSimple,
+    NavbarToggler,
+    navbar,
+    navbar_brand,
+    navbar_simple,
+    navbar_toggler,
+)
+from ._overlays import (
+    Accordion,
+    AccordionItem,
+    Collapse,
+    DropdownMenu,
+    DropdownMenuItem,
+    Fade,
+    Modal,
+    ModalBody,
+    ModalFooter,
+    ModalHeader,
+    ModalTitle,
+    Offcanvas,
+    accordion,
+    accordion_item,
+    collapse,
+    dropdown_menu,
+    dropdown_menu_item,
+    fade,
+    modal,
+    modal_body,
+    modal_footer,
+    modal_header,
+    modal_title,
+    offcanvas,
+)
+from ._scope import Scope, scope
+from ._tabs import Tab, Tabs, tab, tabs
+from ._toast import Toast, toast
+from ._tooltip_popover import (
+    Popover,
+    PopoverBody,
+    PopoverHeader,
+    Tooltip,
+    popover,
+    popover_body,
+    popover_header,
+    tooltip,
+)
+
+__all__ = [
+    "Accordion",
+    "AccordionItem",
+    "Alert",
+    "Badge",
+    "Breadcrumb",
+    "Button",
+    "ButtonGroup",
+    "Card",
+    "CardBody",
+    "CardFooter",
+    "CardGroup",
+    "CardHeader",
+    "CardImg",
+    "CardImgOverlay",
+    "CardLink",
+    "Carousel",
+    "Checkbox",
+    "Checklist",
+    "Col",
+    "Collapse",
+    "Container",
+    "DropdownMenu",
+    "DropdownMenuItem",
+    "Fade",
+    "Form",
+    "FormFeedback",
+    "FormFloating",
+    "FormText",
+    "Input",
+    "InputGroup",
+    "InputGroupText",
+    "Label",
+    "ListGroup",
+    "ListGroupItem",
+    "Modal",
+    "ModalBody",
+    "ModalFooter",
+    "ModalHeader",
+    "ModalTitle",
+    "Nav",
+    "NavItem",
+    "NavLink",
+    "Navbar",
+    "NavbarBrand",
+    "NavbarSimple",
+    "NavbarToggler",
+    "Offcanvas",
+    "Pagination",
+    "Placeholder",
+    "Popover",
+    "PopoverBody",
+    "PopoverHeader",
+    "Progress",
+    "RadioButton",
+    "RadioItems",
+    "Row",
+    "Scope",
+    "Select",
+    "Spinner",
+    "Stack",
+    "Switch",
+    "Tab",
+    "Table",
+    "Tabs",
+    "Textarea",
+    "Toast",
+    "Tooltip",
+    "accordion",
+    "accordion_item",
+    "alert",
+    "badge",
+    "breadcrumb",
+    "button",
+    "button_group",
+    "card",
+    "card_body",
+    "card_footer",
+    "card_group",
+    "card_header",
+    "card_img",
+    "card_img_overlay",
+    "card_link",
+    "carousel",
+    "checkbox",
+    "checklist",
+    "col",
+    "collapse",
+    "container",
+    "dropdown_menu",
+    "dropdown_menu_item",
+    "fade",
+    "form",
+    "form_feedback",
+    "form_floating",
+    "form_text",
+    "input",
+    "input_group",
+    "input_group_text",
+    "label",
+    "list_group",
+    "list_group_item",
+    "modal",
+    "modal_body",
+    "modal_footer",
+    "modal_header",
+    "modal_title",
+    "nav",
+    "nav_item",
+    "nav_link",
+    "navbar",
+    "navbar_brand",
+    "navbar_simple",
+    "navbar_toggler",
+    "offcanvas",
+    "pagination",
+    "placeholder",
+    "popover",
+    "popover_body",
+    "popover_header",
+    "progress",
+    "radio_button",
+    "radio_items",
+    "row",
+    "scope",
+    "select",
+    "spinner",
+    "stack",
+    "switch",
+    "tab",
+    "table",
+    "tabs",
+    "textarea",
+    "toast",
+    "tooltip",
+]

nicegui_bootstrap_components/bs/_actions.py

@@ -0,0 +1,232 @@
+"""Button family: Button, ButtonGroup (native + compat sibling types)."""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+from typing import Any
+
+from .._base import BootstrapElement, make_surface_classes
+
+__all__ = [
+    "Button",
+    "ButtonGroup",
+    "DbcButton",
+    "DbcButtonGroup",
+    "button",
+    "button_dom_attrs",
+    "button_group",
+    "button_group_classes",
+    "button_structural_classes",
+]
+
+_COLORS = frozenset(
+    {
+        "primary",
+        "secondary",
+        "success",
+        "info",
+        "warning",
+        "danger",
+        "light",
+        "dark",
+        "link",
+    }
+)
+_SIZES = frozenset({"sm", "lg", "md"})
+_GROUP_SIZES = frozenset({"sm", "lg", "md"})
+_TYPES = frozenset({"button", "reset", "submit"})
+
+
+def button_structural_classes(
+    *,
+    color: str,
+    outline: bool = False,
+    size: str | None = None,
+    active: bool = False,
+    disabled: bool = False,
+    as_link: bool = False,
+) -> list[str]:
+    """Return Bootstrap ``btn`` classes. Unknown colors raise ``ValueError``."""
+    if color not in _COLORS:
+        raise ValueError(f"Unknown Button color: {color!r}")
+    if size is not None and size not in _SIZES:
+        raise ValueError(f"Invalid Button size: {size!r}")
+    classes = ["btn"]
+    if color == "link":
+        classes.append("btn-link")
+    elif outline:
+        classes.append(f"btn-outline-{color}")
+    else:
+        classes.append(f"btn-{color}")
+    if size and size != "md":
+        classes.append(f"btn-{size}")
+    if active:
+        classes.append("active")
+    if disabled and as_link:
+        classes.append("disabled")
+    return classes
+
+
+def button_dom_attrs(
+    *,
+    href: str | None,
+    external_link: bool | None,
+    disabled: bool,
+    type: str = "button",
+    target: str | None = None,
+    download: str | bool | None = None,
+    name: str | None = None,
+    value: str | None = None,
+) -> tuple[str, dict[str, Any]]:
+    """Return ``(tag, attrs)``. Falsy href is omitted; ``external_link`` never leaks."""
+    if type not in _TYPES:
+        raise ValueError(f"Invalid Button type: {type!r}")
+    as_link = bool(href)
+    attrs: dict[str, Any] = {}
+    if as_link:
+        attrs["href"] = href
+        attrs["role"] = "button"
+        if external_link is True:
+            attrs["target"] = "_blank"
+            attrs["rel"] = "noopener noreferrer"
+        elif target:
+            attrs["target"] = target
+        if download is True:
+            attrs["download"] = True
+        elif download:
+            attrs["download"] = download
+        if disabled:
+            attrs["aria-disabled"] = "true"
+            attrs["tabindex"] = "-1"
+    else:
+        attrs["type"] = type
+        if disabled:
+            attrs["disabled"] = True
+    if name:
+        attrs["name"] = name
+    if value is not None and value != "":
+        attrs["value"] = value
+    return ("a" if as_link else "button", attrs)
+
+
+def button_group_classes(*, size: str | None = None, vertical: bool = False) -> list[str]:
+    """Return Bootstrap ``btn-group`` classes."""
+    if size is not None and size not in _GROUP_SIZES:
+        raise ValueError(f"Invalid ButtonGroup size: {size!r}")
+    classes = ["btn-group"]
+    if size in {"sm", "lg"}:
+        classes.append(f"btn-group-{size}")
+    if vertical:
+        classes.append("btn-group-vertical")
+    return classes
+
+
+def _apply_dom_attrs(element: Any, attrs: dict[str, Any]) -> None:
+    parts: list[str] = []
+    for key, val in attrs.items():
+        if val is True:
+            parts.append(str(key))
+        elif val is False or val is None or val == "":
+            continue
+        else:
+            parts.append(f"{key}={val}")
+    if parts:
+        element.props(" ".join(parts))
+
+
+class _ButtonImpl(BootstrapElement):
+    """Private Button implementation. Click listener is registered in ``__init__`` only."""
+
+    component_name = "Button"
+    children_kind = "phrasing"
+    reserved_classes = ("btn",)
+
+    def __init__(
+        self,
+        children: object = None,
+        *,
+        _surface: str,
+        color: str = "primary",
+        outline: bool = False,
+        size: str | None = None,
+        disabled: bool = False,
+        active: bool = False,
+        n_clicks: int = 0,
+        type: str = "button",
+        href: str | None = None,
+        external_link: bool | None = None,
+        download: str | bool | None = None,
+        target: str | None = None,
+        name: str | None = None,
+        value: str | None = None,
+        on_click: Callable[..., Any] | None = None,
+        **kwargs: Any,
+    ) -> None:
+        self._surface = _surface
+        tag, attrs = button_dom_attrs(
+            href=href,
+            external_link=external_link,
+            disabled=disabled,
+            type=type,
+            target=target,
+            download=download,
+            name=name,
+            value=value,
+        )
+        self._structural_classes = tuple(
+            button_structural_classes(
+                color=color,
+                outline=outline,
+                size=size,
+                active=active,
+                disabled=disabled,
+                as_link=tag == "a",
+            )
+        )
+        self._desired_tag = tag
+        self._html_attrs = attrs
+        self._n_clicks = int(n_clicks)
+        self.disabled = bool(disabled)
+        self._on_click = on_click
+        super().__init__(children, tag=tag, **kwargs)
+        _apply_dom_attrs(self, attrs)
+        self.on("click", self._handle_click)
+
+    @property
+    def n_clicks(self) -> int:
+        """Compat click counter (read-only observable)."""
+        return self._n_clicks
+
+    def _handle_click(self, *_args: Any, **_kwargs: Any) -> None:
+        if self.disabled:
+            return
+        self._n_clicks += 1
+        if self._on_click is not None:
+            self._on_click()
+
+
+class _ButtonGroupImpl(BootstrapElement):
+    """Private ButtonGroup implementation."""
+
+    component_name = "ButtonGroup"
+    children_kind = "grouping"
+
+    def __init__(
+        self,
+        children: object = None,
+        *,
+        _surface: str,
+        size: str | None = None,
+        vertical: bool = False,
+        **kwargs: Any,
+    ) -> None:
+        self._surface = _surface
+        self._structural_classes = tuple(button_group_classes(size=size, vertical=vertical))
+        super().__init__(children, **kwargs)
+        _apply_dom_attrs(self, {"role": "group"})
+
+
+Button, DbcButton = make_surface_classes("Button", globals())
+button = Button
+ButtonGroup, DbcButtonGroup = make_surface_classes("ButtonGroup", globals())
+button_group = ButtonGroup