xnano.components.button

def get_label_text(self) -> str:
    """Return the plain-text form of ``label``."""
    if isinstance(self.label, str):
        return self.label
    value = getattr(self.label, "value", None)
    if isinstance(value, str):
        return value
    content = getattr(self.label, "content", None)
    if isinstance(content, str):
        return content
    return str(self.label)

def handle_keyboard(self, keyboard: "KeyboardEventData") -> bool:
    """Leave keyboard activation to the grid's event hooks.

    Args:
        keyboard: The keyboard event payload.

    Returns:
        ``False`` so the event continues to hooks.
    """
    del keyboard
    return False

def compose(self, ctx: "ComponentRenderContext") -> Any:
    """Compose a styled label, wrapped in a panel when focused.

    Args:
        ctx: Render-time scope for this paint.

    Returns:
        A ``TextBlock``, or a ``Panel`` around it while focused and
        not disabled.
    """
    from xnano.core.content import Panel, Run, TextBlock

    del ctx
    foreground, background = self._resolved_colors()
    caption = f"{self.left}{self.get_label_text()}{self.right}"
    block = TextBlock(
        lines=(
            (
                Run(
                    text=caption,
                    foreground=foreground,
                    background=background,
                ),
            ),
        ),
        foreground=foreground,
        background=background,
        z=self.z,
        visible=self.visible,
    )
    if self.focused and not self.disabled:
        return Panel(
            child=block,
            background=background,
            border_color=foreground,
            z=self.z,
            visible=self.visible,
        )
    return block

def component_post_init(self) -> None:
    """Initialize subclass state after dataclass fields are assigned.

    Override this method instead of ``__post_init__``.
    """
    return None

def get_frame(self) -> Any | None:
    """Optional frame/panel chrome around composed content."""
    return None

def get_size(self, ctx: ComponentRenderContext[StateT]) -> Size:
    """Return the preferred cell size of this component."""
    return Size(width=0, height=0)

def before_render(
    self,
    ctx: ComponentRenderContext[StateT],
    area: "Area",
) -> "Area":
    """Called before rendering; returns the effective render area."""
    return area

def after_render(
    self,
    ctx: ComponentRenderContext[StateT],
    area: "Area",
) -> None:
    """Called after rendering for optional post-paint work."""
    return None

@responsive_noop
def compose_extra_small(
    self, ctx: ComponentRenderContext[StateT]
) -> Content | None:
    """Compose content when the viewport is extra small (< 40 cols).

    Optional responsive counterpart to :meth:`compose`. When
    overridden, it is used *instead of* ``compose`` while the window
    is in this size tier. Overriding any ``compose_*`` variant opts the
    component into breakpoint dispatch; a component that overrides none
    pays no per-frame cost.
    """
    return None

@responsive_noop
def compose_small(
    self, ctx: ComponentRenderContext[StateT]
) -> Content | None:
    """Compose content when the viewport is small (40–79 cols).

    See :meth:`compose_extra_small`.
    """
    return None

@responsive_noop
def compose_medium(
    self, ctx: ComponentRenderContext[StateT]
) -> Content | None:
    """Compose content when the viewport is medium (80–119 cols).

    See :meth:`compose_extra_small`.
    """
    return None

@responsive_noop
def compose_large(
    self, ctx: ComponentRenderContext[StateT]
) -> Content | None:
    """Compose content when the viewport is large (120–159 cols).

    See :meth:`compose_extra_small`.
    """
    return None

@responsive_noop
def compose_extra_large(
    self, ctx: ComponentRenderContext[StateT]
) -> Content | None:
    """Compose content when the viewport is extra large (>= 160 cols).

    See :meth:`compose_extra_small`.
    """
    return None

def handle_paste(self, text: str) -> bool:
    """Optional paste handler while focused.

    Returns:
        ``True`` when the paste was consumed.
    """
    return False