banners

16def configure(
17    team: str = _UNSET,
18    date: str = _UNSET,
19    icon=_UNSET,
20    palette=_UNSET,
21    background=_UNSET,
22) -> None:
23    """Set global defaults shared by all slides and reset the section counter.
24
25    Call this once at the top of the notebook. Any slide parameter left at its
26    default will inherit the value set here. Calling `configure()` without
27    arguments only resets the section counter.
28
29    Args:
30        team: Team line shown in `Cover`, `Intro`, and `Closing` banners.
31        date: Date string shown in `Cover` (e.g. `"April 2026"`).
32        icon: Icon applied to all slides. Pass a dict with keys `"src"`
33            (path, URL, or bytes) and optionally `"size"` (CSS height).
34        palette: Color palette applied to `Cover`, `Intro`, and `Closing`.
35            Pass any `Palette` instance or predefined constant
36            (`BLUE`, `GREEN`, `PURPLE`, `GRAY`).
37        background: Background applied to all slides. Pass a `Background`
38            instance (`Background.color()`, `Background.gradient()`, or
39            `Background.image()`). Individual slides can override this with
40            their own `background` argument.
41
42    Example:
43        ```python
44        from banners import configure, Background
45        from banners.palette import BLUE
46
47        configure(
48            team="Analytics Team",
49            date="April 2026",
50            palette=BLUE,
51            icon={"src": "img/logo.png"},
52            background=Background.gradient("#0f172a", "#1e3a5f"),
53        )
54        ```
55    """
56    if team is not _UNSET:
57        _state["team"] = team
58    if date is not _UNSET:
59        _state["date"] = date
60    if icon is not _UNSET:
61        _state["icon"] = icon
62    if palette is not _UNSET:
63        _state["palette"] = palette
64    if background is not _UNSET:
65        _state["background"] = background
66    _state["_section_counter"] = 0

 25class Slide:
 26    """Abstract base class for all slide types.
 27
 28    Subclasses must implement `_render_banner` to produce the banner HTML.
 29    The `render` method assembles the full slide as a `mo.vstack`.
 30
 31    Content layout is resolved automatically based on what is passed:
 32
 33    - **Single item** — rendered at full width.
 34    - **List of N items** — rendered as an equal-width CSS grid (`1fr` per
 35      column) regardless of type. Pass `content_kind` to wrap `Text` items
 36      in a `mo.callout` box.
 37
 38    Args:
 39        title: Main heading of the slide.
 40        subtitle: Support phrase displayed inside the banner.
 41        content: Content elements below the banner. Accepts a single
 42            `Text`, `Image`, or `Graph` instance, a list of them, or any
 43            marimo component.
 44        palette: Color palette for the banner. Defaults to `ORANGE`.
 45        content_kind: Box style applied to `Text` items when the content is
 46            a list of text-only elements. Accepted values: `"neutral"`,
 47            `"info"`, `"success"`, `"warn"`, `"danger"`.
 48
 49    Example:
 50        ```python
 51        from banners.slides import Section
 52        from banners.content import Text, Graph
 53
 54        Section(
 55            title="Pipeline",
 56            content=[
 57                Text("Each stage runs independently."),
 58                Graph("graph LR\\n  A --> B --> C"),
 59            ],
 60        ).render()
 61        ```
 62    """
 63
 64    def __init__(
 65        self,
 66        title: str,
 67        subtitle: str = "",
 68        content: "list[ContentItem] | ContentItem | None" = None,
 69        palette: Palette | None = None,
 70        content_kind: "str | None" = None,
 71        footer: str = "",
 72        background=None,
 73    ) -> None:
 74        self.title = title
 75        self.subtitle = subtitle
 76        self.content = content
 77        self.palette = palette or Palette()
 78        self.content_kind = content_kind
 79        self.footer = footer
 80        self.background = background
 81
 82    def render(self) -> mo.Html:
 83        """Assemble and return the complete slide as a marimo component.
 84
 85        Returns:
 86            A `mo.Html` component (via `mo.vstack`) ready to display in a
 87            marimo cell.
 88        """
 89        banner = self._render_banner()
 90        content_parts = self._render_content() + self._render_footer()
 91        return self._wrap_slide(banner, content_parts)
 92
 93    def _wrap_slide(self, banner, content_parts: list):
 94        if self.background is None:
 95            return mo.vstack([banner] + content_parts)
 96        bg_css = self.background.css if hasattr(self.background, "css") else str(self.background)
 97        banner_html = mo.as_html(banner).text
 98        if content_parts:
 99            content_inner = mo.as_html(mo.vstack(content_parts)).text
100            tc = self.background.text_color() if (
101                self.content_kind is None and hasattr(self.background, "text_color")
102            ) else None
103            if tc is not None:
104                uid = f"sbg{id(self):x}"
105                tags = (
106                    f".{uid} h1,.{uid} h2,.{uid} h3,.{uid} h4,.{uid} h5,.{uid} h6,"
107                    f".{uid} p,.{uid} li,.{uid} blockquote,.{uid} code,.{uid} pre,"
108                    f".{uid} em,.{uid} strong,.{uid} td,.{uid} th"
109                )
110                content_html = (
111                    f"<style>{tags}{{color:{tc}!important;}}</style>"
112                    f'<div class="{uid}" style="color:{tc};">{content_inner}</div>'
113                )
114            else:
115                content_html = content_inner
116        else:
117            content_html = ""
118        return mo.Html(
119            f'<div style="background:{bg_css};padding:1rem;border-radius:0.75rem;">'
120            f"{banner_html}{content_html}</div>"
121        )
122
123    def _render_footer(self) -> list:
124        if self.footer:
125            return [mo.md(f"> {self.footer}")]
126        return []
127
128    def _display_(self):
129        return self.render()
130
131    def _render_banner(self) -> mo.Html:
132        """Produce the banner HTML for this slide type.
133
134        Raises:
135            NotImplementedError: Must be implemented by each subclass.
136        """
137        raise NotImplementedError(f"{type(self).__name__} must implement _render_banner()")
138
139    def _render_content(self) -> list:
140        """Resolve content items into marimo components and apply layout.
141
142        Returns:
143            A list of marimo components to be stacked below the banner.
144        """
145        if self.content is None:
146            return []
147
148        items = self.content if isinstance(self.content, list) else [self.content]
149
150        if len(items) == 1:
151            return [self._render_item(items[0])]
152
153        rendered = [
154            self._render_item(item, wrap_kind=self.content_kind)
155            for item in items
156        ]
157
158        return [self._css_grid(rendered)]
159
160    def _render_item(self, item: ContentItem, wrap_kind: "str | None" = None):
161        """Render a single content item into a marimo component.
162
163        Args:
164            item: A `Text`, `Image`, `Graph`, plain string, or marimo component.
165            wrap_kind: If set and the item is `Text` or `str`, wraps the
166                rendered markdown in a `mo.callout` with this kind.
167
168        Returns:
169            A marimo component.
170        """
171        from .content.text import Text as _Text
172
173        if isinstance(item, (_Text, str)):
174            md = mo.md(item.body if isinstance(item, _Text) else item)
175            return mo.callout(md, kind=wrap_kind) if wrap_kind else md
176
177        if hasattr(item, "render") and callable(item.render):
178            return item.render()
179
180        return item
181
182    @staticmethod
183    def _css_grid(items: list) -> mo.Html:
184        """Wrap rendered items in an equal-width CSS grid container.
185
186        Args:
187            items: List of marimo `mo.Html` components.
188
189        Returns:
190            A `mo.Html` component with a CSS grid layout (`1fr` per column).
191        """
192        cols = " ".join(["1fr"] * len(items))
193        parts = []
194        for item in items:
195            html = mo.as_html(item).text
196            parts.append(f'<div style="min-width:0;">{html}</div>')
197        inner = "".join(parts)
198        return mo.Html(
199            f'<div style="display:grid;grid-template-columns:{cols};'
200            f'gap:1rem;align-items:start;">{inner}</div>'
201        )
202
203    @staticmethod
204    def _tag_line(text: str, color: str) -> str:
205        return (
206            f'<div style="font-size:0.85rem;letter-spacing:0.2em;text-transform:uppercase;'
207            f'color:{color};margin-bottom:0.5rem;">{text}</div>'
208        )
209
210    @staticmethod
211    def _icon_src(icon) -> str:
212        """Convert a path, URL, or bytes to a base64 data URI.
213
214        Args:
215            icon: File path (`str` or `Path`), URL string, or raw `bytes`.
216
217        Returns:
218            A `data:image/<mime>;base64,...` string.
219        """
220        _EXT_MIME = {
221            "jpg": "jpeg", "jpeg": "jpeg", "png": "png",
222            "svg": "svg+xml", "gif": "gif", "webp": "webp",
223        }
224        if isinstance(icon, str) and icon.startswith(("http://", "https://")):
225            ext = icon.split("?")[0].rsplit(".", 1)[-1].lower()
226            mime = _EXT_MIME.get(ext, "png")
227            req = urllib.request.Request(icon, headers={"User-Agent": "Mozilla/5.0"})
228            ctx = ssl.create_default_context()
229            ctx.check_hostname = False
230            ctx.verify_mode = ssl.CERT_NONE
231            with urllib.request.urlopen(req, timeout=10, context=ctx) as r:
232                data = r.read()
233                ct = r.headers.get("Content-Type", "")
234            if "svg" in ct:
235                mime = "svg+xml"
236            elif "jpeg" in ct or "jpg" in ct:
237                mime = "jpeg"
238            elif "png" in ct:
239                mime = "png"
240            b64 = base64.b64encode(data).decode()
241            return f"data:image/{mime};base64,{b64}"
242
243        if isinstance(icon, (str, Path)):
244            p = Path(icon)
245            mime = _EXT_MIME.get(p.suffix.lower().lstrip("."), "png")
246            b64 = base64.b64encode(p.read_bytes()).decode()
247            return f"data:image/{mime};base64,{b64}"
248
249        b64 = base64.b64encode(icon).decode()
250        return f"data:image/png;base64,{b64}"
251
252    def _icon_corner_html(self, icon: "dict | None", bottom: str, right: str, default_size: str) -> str:
253        if icon is None:
254            return ""
255        try:
256            size = icon.get("size", default_size)
257            src = self._icon_src(icon["src"])
258            return (
259                f'<img src="{src}" '
260                f'style="position:absolute;bottom:{bottom};right:{right};'
261                f'height:{size};opacity:0.85;border-radius:4px;">'
262            )
263        except Exception:
264            return ""
265
266    def _icon_inline_html(self, icon: "dict | None", default_size: str, style: str = "") -> str:
267        if icon is None:
268            return ""
269        try:
270            size = icon.get("size", default_size)
271            src = self._icon_src(icon["src"])
272            return f'<img src="{src}" style="height:{size};{style}border-radius:4px;">'
273        except Exception:
274            return ""

11class Cover(Slide):
12    """Title slide with a large centered gradient banner.
13
14    Intended as the **first slide** of every presentation.
15
16    Args:
17        title: Main project title.
18        subtitle: Short context phrase displayed inside the banner.
19        date: Date string shown at the bottom of the banner (e.g. `"April 2026"`).
20        content: Elements displayed below the banner. Accepts a single
21            `Text`, `Image`, or `Graph` instance, or a list of them.
22        palette: Color palette for the banner gradient. Defaults to `ORANGE`.
23        content_kind: Box style for `Text` lists (`"neutral"`, `"info"`,
24            `"success"`, `"warn"`, `"danger"`).
25        team: Team line shown in small caps above the title.
26        icon: Institutional icon placed in the bottom-right corner of the
27            banner. Pass a dict with keys `"src"` (path, URL, or bytes) and
28            optionally `"size"` (CSS height, default `"44px"`).
29
30    Example:
31        ```python
32        from banners.slides import Cover
33        from banners.content import Text
34        from banners.palette import BLUE
35
36        Cover(
37            title="Churn Prediction v2",
38            subtitle="Model migration and deployment.",
39            date="April 2026",
40            palette=BLUE,
41            content=[
42                Text("**Accuracy** — 91% AUC on holdout."),
43                Text("**Latency** — p99 under 30 ms."),
44                Text("**Coverage** — All active segments."),
45            ],
46            content_kind="neutral",
47        ).render()
48        ```
49    """
50
51    def __init__(
52        self,
53        title: str,
54        subtitle: str = "",
55        date: str = "",
56        content=None,
57        palette: Palette | None = None,
58        content_kind: "str | None" = None,
59        footer: str = "",
60        team: str = "",
61        icon: "dict | None" = None,
62        background=None,
63    ) -> None:
64        background = background if background is not None else _cfg.get("background")
65        super().__init__(title, subtitle, content, palette or _cfg.get("palette"), content_kind, footer, background=background)
66        self.date = date or _cfg.get("date", "")
67        self.team = team or _cfg.get("team", "")
68        self.icon = icon if icon is not None else _cfg.get("icon")
69
70    def _render_banner(self) -> mo.Html:
71        p = self.palette
72        team_html = self._tag_line(self.team, p.text_tag) if self.team else ""
73        subtitle_html = (
74            f'<p style="font-size:1.3rem;color:{p.text_sub};margin:1rem 0 0.25rem;">{self.subtitle}</p>'
75            if self.subtitle else ""
76        )
77        date_html = (
78            f'<p style="font-size:0.9rem;color:{p.text_muted};margin-top:0.5rem;">{self.date}</p>'
79            if self.date else ""
80        )
81        icon_html = self._icon_corner_html(self.icon, bottom="1rem", right="1.5rem", default_size="44px")
82        return mo.Html(f"""
83        <div style="position:relative;text-align:center;padding:3rem 2rem 1.5rem;
84                    background:{p.gradient};border-radius:1rem;color:{p.text_main};margin-bottom:1.5rem;">
85            {team_html}
86            <h1 style="font-size:3.2rem;font-weight:800;margin:0.5rem 0;color:{p.text_main};line-height:1.15;">{self.title}</h1>
87            {subtitle_html}
88            {date_html}
89            {icon_html}
90        </div>
91        """)

 11class Intro(Slide):
 12    """Compact gradient banner for slides that open a thematic block.
 13
 14    Typically used for slides 2–3 to set context or frame the problem.
 15    Supports an optional `summary` callout block between the banner and
 16    the content area, and an optional `footer` blockquote.
 17
 18    Args:
 19        title: Slide heading.
 20        subtitle: Support phrase displayed inside the banner below the title.
 21        content: Elements displayed below the summary block. Accepts a single
 22            `Text`, `Image`, or `Graph` instance, or a list of them.
 23        palette: Color palette for the banner gradient. Defaults to `ORANGE`.
 24        content_kind: Box style for `Text` lists (`"neutral"`, `"info"`,
 25            `"success"`, `"warn"`, `"danger"`).
 26        tag: Short label shown in small caps above the title
 27            (e.g. `"Context"`, `"Problem"`). Falls back to the team line
 28            when empty.
 29        summary: Full-width highlighted block rendered between the banner
 30            and the content area. Displayed as a yellow `warn` callout.
 31        footer: Closing quote shown at the bottom of the slide as a blockquote.
 32        team: Team line used as the tag fallback.
 33        icon: Icon placed in the bottom-right corner of the banner. Pass a
 34            dict with keys `"src"` (path, URL, or bytes) and optionally
 35            `"size"` (CSS height, default `"36px"`).
 36
 37    Example:
 38        ```python
 39        from banners.slides import Intro
 40        from banners.content import Text
 41
 42        Intro(
 43            title="Why we're here",
 44            subtitle="What was at stake and what motivated this work.",
 45            tag="Context",
 46            summary="Models were running on servers with a confirmed shutdown date.",
 47            content=[
 48                Text("**Operational risk** — No fallback if the server goes down."),
 49                Text("**No traceability** — No record of the active version."),
 50                Text("**Manual process** — Undocumented and person-dependent."),
 51            ],
 52            content_kind="warn",
 53            footer="The question wasn't whether to migrate — but how.",
 54        ).render()
 55        ```
 56    """
 57
 58    def __init__(
 59        self,
 60        title: str,
 61        subtitle: str = "",
 62        content=None,
 63        palette: Palette | None = None,
 64        content_kind: "str | None" = None,
 65        tag: str = "",
 66        summary: str = "",
 67        footer: str = "",
 68        team: str = "",
 69        icon: "dict | None" = None,
 70        background=None,
 71    ) -> None:
 72        background = background if background is not None else _cfg.get("background")
 73        super().__init__(title, subtitle, content, palette or _cfg.get("palette"), content_kind, footer, background=background)
 74        self.tag = tag
 75        self.summary = summary
 76        self.team = team or _cfg.get("team", "")
 77        self.icon = icon if icon is not None else _cfg.get("icon")
 78
 79    def render(self) -> mo.Html:
 80        """Assemble banner, summary callout, content, and footer.
 81
 82        Returns:
 83            A `mo.Html` component ready to display in a marimo cell.
 84        """
 85        banner = self._render_banner()
 86        content_parts = []
 87        if self.summary:
 88            content_parts.append(mo.callout(mo.md(self.summary), kind="warn"))
 89        content_parts.extend(self._render_content())
 90        content_parts.extend(self._render_footer())
 91        return self._wrap_slide(banner, content_parts)
 92
 93    def _render_banner(self) -> mo.Html:
 94        p = self.palette
 95        label = self.tag if self.tag else self.team
 96        top_html = self._tag_line(label, p.text_tag)
 97        subtitle_html = (
 98            f'<p style="font-size:1.1rem;color:{p.text_sub};margin:0.5rem 0 0;">{self.subtitle}</p>'
 99            if self.subtitle else ""
100        )
101        icon_html = self._icon_corner_html(self.icon, bottom="0.75rem", right="1.25rem", default_size="36px")
102        return mo.Html(f"""
103        <div style="position:relative;padding:1.6rem 2rem;background:{p.gradient};
104                    border-radius:0.75rem;color:{p.text_main};margin-bottom:1.25rem;">
105            {top_html}
106            <h2 style="font-size:2rem;font-weight:700;margin:0;color:{p.text_main};line-height:1.2;">{self.title}</h2>
107            {subtitle_html}
108            {icon_html}
109        </div>
110        """)

 11class Section(Slide):
 12    """Intermediate section slide with a left color border and dark background.
 13
 14    Takes less vertical space than `Cover` or `Closing`, leaving more room
 15    for content. Intended for **all middle slides** of a presentation.
 16
 17    Args:
 18        title: Section heading.
 19        subtitle: Short support phrase shown to the right of the title.
 20        content: Elements displayed below the banner. Accepts a single
 21            `Text`, `Image`, or `Graph` instance, or a list of them.
 22            Lists that contain any `Image` or `Graph` automatically use
 23            an equal-width CSS grid layout.
 24        palette: `SectionPalette` instance controlling the border color and
 25            dark background gradient. Defaults to the orange `SectionPalette`.
 26        content_kind: Box style for `Text`-only lists (`"neutral"`, `"info"`,
 27            `"success"`, `"warn"`, `"danger"`).
 28        number: Section number displayed large on the left of the banner
 29            (e.g. `"01"`, `"02"`). Omit to hide.
 30        footer: Closing quote shown at the bottom of the slide as a blockquote.
 31        icon: Icon placed at the right end of the banner, vertically centered.
 32            Pass a dict with keys `"src"` (path, URL, or bytes) and optionally
 33            `"size"` (CSS height, default `"32px"`).
 34
 35    Example:
 36        ```python
 37        from banners.slides import Section
 38        from banners.content import Text, Graph
 39
 40        Section(
 41            title="Pipeline architecture",
 42            subtitle="How data flows end to end.",
 43            number="02",
 44            content=[
 45                Text("Each stage is independently versioned and monitored."),
 46                Graph(\"\"\"
 47                graph LR
 48                    A[Ingest] --> B[Transform] --> C[Model] --> D[Serve]
 49                \"\"\"),
 50            ],
 51            footer="All stages emit structured logs to the observability stack.",
 52        ).render()
 53        ```
 54    """
 55
 56    def __init__(
 57        self,
 58        title: str,
 59        subtitle: str = "",
 60        content=None,
 61        palette: SectionPalette | None = None,
 62        content_kind: "str | None" = None,
 63        number: "str | None" = None,
 64        footer: str = "",
 65        icon: "dict | None" = None,
 66        background=None,
 67    ) -> None:
 68        if palette is None:
 69            global_palette = _cfg.get("palette")
 70            palette = global_palette.to_section_palette() if global_palette is not None else SectionPalette()
 71        elif isinstance(palette, Palette) and not isinstance(palette, SectionPalette):
 72            palette = palette.to_section_palette()
 73        background = background if background is not None else _cfg.get("background")
 74        super().__init__(title, subtitle, content, palette, content_kind, footer, background=background)
 75        self.number = number if number is not None else _cfg._next_section_number()
 76        self.icon = icon if icon is not None else _cfg.get("icon")
 77
 78    def render(self) -> mo.Html:
 79        """Assemble banner, content, and footer.
 80
 81        Returns:
 82            A `mo.Html` component ready to display in a marimo cell.
 83        """
 84        banner = self._render_banner()
 85        content_parts = self._render_content() + self._render_footer()
 86        return self._wrap_slide(banner, content_parts)
 87
 88    def _render_banner(self) -> mo.Html:
 89        p = self.palette
 90        number_html = (
 91            f'<div style="font-size:2.5rem;font-weight:900;color:{p.border};'
 92            f'line-height:1;margin-bottom:0.2rem;opacity:0.85;flex-shrink:0;">{self.number}</div>'
 93            if self.number else ""
 94        )
 95        subtitle_html = (
 96            f'<p style="font-size:0.95rem;color:{p.text_sub};margin:0.3rem 0 0;">{self.subtitle}</p>'
 97            if self.subtitle else ""
 98        )
 99        icon_html = self._icon_inline_html(
100            self.icon, default_size="32px", style="margin-left:auto;flex-shrink:0;opacity:0.8;"
101        )
102        return mo.Html(f"""
103        <div style="padding:1.1rem 1.5rem;background:{p.gradient};
104                    border-left:5px solid {p.border};border-radius:0 0.5rem 0.5rem 0;
105                    color:{p.text_main};margin-bottom:1.25rem;display:flex;align-items:center;gap:1.2rem;">
106            {number_html}
107            <div style="flex:1;">
108                <h3 style="font-size:1.5rem;font-weight:700;margin:0;color:{p.text_main};">{self.title}</h3>
109                {subtitle_html}
110            </div>
111            {icon_html}
112        </div>
113        """)

 11class Closing(Slide):
 12    """Closing slide with a large centered banner and an optional metrics row.
 13
 14    Same visual weight as `Cover`. Intended as the **last slide** of every
 15    presentation. The `stats` parameter renders a row of `mo.stat` boxes
 16    useful for summarizing key numbers.
 17
 18    Args:
 19        title: Main closing message. Keep it conclusive and direct.
 20        subtitle: Support phrase displayed inside the banner below the title.
 21        content: Elements displayed above the stats row. Accepts a single
 22            `Text`, `Image`, or `Graph` instance, or a list of them.
 23        palette: Color palette for the banner gradient. Defaults to `ORANGE`.
 24        content_kind: Box style for `Text` lists (`"neutral"`, `"info"`,
 25            `"success"`, `"warn"`, `"danger"`).
 26        team: Team line shown in small caps at the bottom of the banner.
 27        stats: List of metric tuples `(value, label, caption)` rendered as
 28            a horizontal row of bordered `mo.stat` boxes. Keep `value` short
 29            (a number, symbol, or 1–3 words). Comfortable range: 2–4 items.
 30        footer: Closing quote shown at the bottom of the slide as a blockquote.
 31        icon: Icon placed in the bottom-right corner of the banner. Pass a
 32            dict with keys `"src"` (path, URL, or bytes) and optionally
 33            `"size"` (CSS height, default `"44px"`).
 34
 35    Example:
 36        ```python
 37        from banners.slides import Closing
 38
 39        Closing(
 40            title="One framework for all models.",
 41            subtitle="Infrastructure solved. Team focuses on data science.",
 42            stats=[
 43                ("Low",   "Effort per new model", "Just configure data"),
 44                ("↑ ROI", "Cumulative return",     "Each migration amortizes more"),
 45                ("100%",  "Traceability",          "Automatic end-to-end tracking"),
 46                ("1",     "Shared codebase",       "Everyone contributes"),
 47            ],
 48        ).render()
 49        ```
 50    """
 51
 52    def __init__(
 53        self,
 54        title: str,
 55        subtitle: str = "",
 56        content=None,
 57        palette: Palette | None = None,
 58        content_kind: "str | None" = None,
 59        footer: str = "",
 60        team: str = "",
 61        stats: "list[tuple[str, str, str]] | None" = None,
 62        icon: "dict | None" = None,
 63        background=None,
 64    ) -> None:
 65        background = background if background is not None else _cfg.get("background")
 66        super().__init__(title, subtitle, content, palette or _cfg.get("palette"), content_kind, footer, background=background)
 67        self.team = team or _cfg.get("team", "")
 68        self.stats = stats
 69        self.icon = icon if icon is not None else _cfg.get("icon")
 70
 71    def render(self) -> mo.Html:
 72        """Assemble banner, content, stats row, and footer.
 73
 74        Returns:
 75            A `mo.Html` component ready to display in a marimo cell.
 76        """
 77        banner = self._render_banner()
 78        content_parts = self._render_content()
 79        if self.stats:
 80            content_parts.append(
 81                mo.hstack(
 82                    [mo.stat(v, label=l, caption=c, bordered=True) for v, l, c in self.stats],
 83                    justify="space-around",
 84                )
 85            )
 86        content_parts.extend(self._render_footer())
 87        return self._wrap_slide(banner, content_parts)
 88
 89    def _render_banner(self) -> mo.Html:
 90        p = self.palette
 91        subtitle_html = (
 92            f'<p style="font-size:1.2rem;color:{p.text_sub};margin:1rem 0 1.5rem;">{self.subtitle}</p>'
 93            if self.subtitle else ""
 94        )
 95        team_html = (
 96            f'<div style="font-size:0.78rem;letter-spacing:0.15em;text-transform:uppercase;'
 97            f'color:{p.text_muted};margin-top:1rem;">{self.team}</div>'
 98            if self.team else ""
 99        )
100        icon_html = self._icon_corner_html(self.icon, bottom="1rem", right="1.5rem", default_size="44px")
101        return mo.Html(f"""
102        <div style="position:relative;text-align:center;padding:3rem 2rem 2rem;
103                    background:{p.gradient};border-radius:1rem;color:{p.text_main};margin-bottom:1.5rem;">
104            <h1 style="font-size:2.6rem;font-weight:800;color:{p.text_main};margin-bottom:0.5rem;line-height:1.2;">{self.title}</h1>
105            {subtitle_html}
106            {team_html}
107            {icon_html}
108        </div>
109        """)