feat(seaborn): implement sunburst-basic (#9923)

## Implementation: `sunburst-basic` - python/seaborn

Implements the **python/seaborn** version of `sunburst-basic`.

**File:** `plots/sunburst-basic/implementations/python/seaborn.py`

**Parent Issue:** #821

---
:robot: *[impl-generate
workflow](https://github.com/MarkusNeusinger/anyplot/actions/runs/30187132041)*

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Markus Neusinger <2921697+MarkusNeusinger@users.noreply.github.com>

Author: github-actions[bot]

plots/sunburst-basic/implementations/python/seaborn.py

@@ -1,15 +1,18 @@
 """ anyplot.ai
 sunburst-basic: Basic Sunburst Chart
-Library: seaborn 0.13.2 | Python 3.13.13
-Quality: 83/100 | Updated: 2026-05-04
+Library: seaborn 0.13.2 | Python 3.13.14
+Quality: 84/100 | Updated: 2026-07-26
 """
 
 import os
 
+import matplotlib.colors as mcolors
+import matplotlib.patheffects as path_effects
 import matplotlib.pyplot as plt
 import numpy as np
 import pandas as pd
 import seaborn as sns
+import seaborn.objects as so
 
 
 # Theme tokens
@@ -19,25 +22,47 @@
 INK = "#1A1A17" if THEME == "light" else "#F0EFE8"
 INK_SOFT = "#4A4A44" if THEME == "light" else "#B8B7B0"
 
-# Okabe-Ito palette — first series always #009E73
-IMPRINT = ["#009E73", "#C475FD", "#4467A3"]
+# Imprint palette — first series always #009E73; abstract folders get canonical order
+IMPRINT = ["#009E73", "#C475FD", "#4467A3", "#BD8233"]
 
-# Hierarchical data: Company budget breakdown (in $K)
-# Level 1: Departments, Level 2: Teams, Level 3: Projects
+# Ring-label text colors, chosen per-wedge from the wedge's own fill luminance rather than
+# a fixed theme token — wedge fills are data colors (branch tints), not page chrome, so their
+# brightness varies independently of THEME and a single INK/INK_SOFT choice can't stay legible
+# across the whole range from pale tints to fully-saturated branch colors.
+WEDGE_LABEL_LIGHT = "#F0EFE8"  # for text on saturated/dark wedge fills
+WEDGE_LABEL_DARK = "#1A1A17"  # for text on pale wedge tints
+
+
+def _label_color(hex_color):
+    r, g, b = mcolors.to_rgb(hex_color)
+    luminance = 0.299 * r + 0.587 * g + 0.114 * b
+    return WEDGE_LABEL_DARK if luminance > 0.5 else WEDGE_LABEL_LIGHT
+
+
+def _label_halo(fill_color):
+    # Opposite-tone halo so a label stays legible even where it overhangs its wedge
+    # onto the page background — PAGE_BG flips between light/dark per THEME, but the
+    # wedge-derived fill color above doesn't, so a plain fill can vanish into PAGE_BG.
+    halo_color = WEDGE_LABEL_LIGHT if fill_color == WEDGE_LABEL_DARK else WEDGE_LABEL_DARK
+    return [path_effects.withStroke(linewidth=2.5, foreground=halo_color)]
+
+
+# Hierarchical data: a repository's disk usage (in MB)
+# Level 1: top-level directories, Level 2: subdirectories, Level 3: leaf folders
 data = {
-    "Engineering": {
-        "Frontend": {"Web App": 150, "Mobile": 120},
-        "Backend": {"API": 180, "Database": 90},
-        "DevOps": {"Cloud": 100, "CI/CD": 60},
+    "src/": {
+        "components/": {"widgets/": 42, "forms/": 28},
+        "services/": {"api-client/": 35, "auth/": 18},
+        "utils/": {"helpers/": 15, "validators/": 10},
     },
-    "Sales": {"North": {"Enterprise": 200, "SMB": 80}, "South": {"Enterprise": 150, "SMB": 70}},
-    "Marketing": {"Digital": {"SEO": 60, "Ads": 140}, "Brand": {"Events": 80, "Content": 50}},
+    "assets/": {"images/": {"icons/": 22, "photos/": 48}, "fonts/": {"sans/": 8, "serif/": 6}},
+    "tests/": {"integration/": {"api/": 24, "e2e/": 30}, "unit/": {"components/": 20, "services/": 16}},
+    "docs/": {"guides/": {"getting-started/": 5, "tutorials/": 9}, "reference/": {"api/": 12, "changelog/": 3}},
 }
 
 sns.set_theme(
     style="white",
-    context="poster",
-    font_scale=1.1,
+    context="notebook",
     rc={
         "figure.facecolor": PAGE_BG,
         "axes.facecolor": PAGE_BG,
@@ -47,140 +72,167 @@
         "xtick.color": INK_SOFT,
         "ytick.color": INK_SOFT,
         "grid.color": INK,
-        "grid.alpha": 0.10,
+        "grid.alpha": 0.12,
         "legend.facecolor": ELEVATED_BG,
         "legend.edgecolor": INK_SOFT,
     },
 )
 
-# Build hierarchical structure and color scheme
-level1_names = []
-level1_values = []
-level2_names = []
-level2_values = []
-level3_names = []
-level3_values = []
-level1_colors = []
-level2_colors = []
-level3_colors = []
-
-for i, (dept, teams) in enumerate(data.items()):
-    dept_total = sum(sum(projs.values()) for projs in teams.values())
-    level1_names.append(dept)
-    level1_values.append(dept_total)
+# Build hierarchical structure and branch-coherent colors
+level1_names, level1_values, level1_colors = [], [], []
+level2_names, level2_values, level2_colors = [], [], []
+level3_names, level3_values, level3_colors = [], [], []
+
+for i, (top_dir, subdirs) in enumerate(data.items()):
+    dir_total = sum(sum(leaves.values()) for leaves in subdirs.values())
+    level1_names.append(top_dir)
+    level1_values.append(dir_total)
     base_color = IMPRINT[i % len(IMPRINT)]
     level1_colors.append(base_color)
 
-    # Light palette for child levels shows branch relationships via seaborn
-    dept_light_palette = sns.light_palette(base_color, n_colors=6, reverse=False)
+    # Light tints of the branch color carry the parent/child relationship visually
+    branch_tints = sns.light_palette(base_color, n_colors=6)
 
-    for j, (team, projects) in enumerate(teams.items()):
-        team_total = sum(projects.values())
-        level2_names.append(team)
-        level2_values.append(team_total)
-        level2_colors.append(dept_light_palette[3 + j % 2])
+    for j, (subdir, leaves) in enumerate(subdirs.items()):
+        subdir_total = sum(leaves.values())
+        level2_names.append(subdir)
+        level2_values.append(subdir_total)
+        level2_colors.append(branch_tints[3 + j % 2])
 
-        for k, (proj, value) in enumerate(projects.items()):
-            level3_names.append(proj)
-            level3_values.append(value)
-            level3_colors.append(dept_light_palette[4 + k % 2])
+        for k, (leaf, size) in enumerate(leaves.items()):
+            level3_names.append(leaf)
+            level3_values.append(size)
+            level3_colors.append(branch_tints[4 + k % 2])
 
-# Figure layout: sunburst left, summary bar chart right
-fig = plt.figure(figsize=(16, 9), facecolor=PAGE_BG)
-ax_sun = fig.add_axes([0.02, 0.05, 0.58, 0.85])
-ax_bar = fig.add_axes([0.65, 0.15, 0.32, 0.70])
+
+# Figure layout: sunburst left, branch-size summary right
+fig = plt.figure(figsize=(8, 4.5), dpi=400, facecolor=PAGE_BG)
+ax_sun = fig.add_axes((0.02, 0.05, 0.54, 0.86))
+ax_bar = fig.add_axes((0.60, 0.18, 0.36, 0.58))
 ax_sun.set_facecolor(PAGE_BG)
 ax_bar.set_facecolor(PAGE_BG)
 
-ring_width = 0.28
+ring_width = 0.32
 inner_radius = 0.22
 
-# Level 3 (outermost ring)
+# Level 3 (outermost ring — leaf folders)
 wedges3, _ = ax_sun.pie(
     level3_values,
     radius=inner_radius + 3 * ring_width,
     colors=level3_colors,
     startangle=90,
     counterclock=False,
-    wedgeprops={"width": ring_width, "edgecolor": PAGE_BG, "linewidth": 2.5},
+    wedgeprops={"width": ring_width, "edgecolor": PAGE_BG, "linewidth": 2},
 )
 
-# Level 2 (middle ring)
+# Level 2 (middle ring — subdirectories)
 wedges2, _ = ax_sun.pie(
     level2_values,
     radius=inner_radius + 2 * ring_width,
     colors=level2_colors,
     startangle=90,
     counterclock=False,
-    wedgeprops={"width": ring_width, "edgecolor": PAGE_BG, "linewidth": 2.5},
+    wedgeprops={"width": ring_width, "edgecolor": PAGE_BG, "linewidth": 2},
 )
 
-# Level 1 (innermost ring) — white labels contrast against saturated Okabe-Ito fills
-wedges1, _ = ax_sun.pie(
+# Level 1 (innermost ring — top-level directories)
+wedges1, texts1 = ax_sun.pie(
     level1_values,
     radius=inner_radius + ring_width,
     colors=level1_colors,
     labels=level1_names,
-    labeldistance=0.55,
+    labeldistance=0.6,
     startangle=90,
     counterclock=False,
-    wedgeprops={"width": ring_width, "edgecolor": PAGE_BG, "linewidth": 2.5},
-    textprops={"fontsize": 18, "fontweight": "bold", "color": "white"},
+    wedgeprops={"width": ring_width, "edgecolor": PAGE_BG, "linewidth": 2},
+    textprops={"fontsize": 14, "fontweight": "bold"},
 )
+for text, color in zip(texts1, level1_colors, strict=True):
+    fill = _label_color(color)
+    text.set_color(fill)
+    text.set_path_effects(_label_halo(fill))
 
-# Level 2 labels (only for large enough segments)
+# Level 2 labels — horizontal, shown only where the wedge is wide enough to hold text
+level2_label_positions = []  # (x, y) of rendered labels, checked by level-3 labels below
 for i, wedge in enumerate(wedges2):
     ang = (wedge.theta2 + wedge.theta1) / 2
+    span = wedge.theta2 - wedge.theta1
+    if span <= 15:
+        continue
     r = inner_radius + 1.5 * ring_width
     x = r * np.cos(np.radians(ang))
     y = r * np.sin(np.radians(ang))
-    if (wedge.theta2 - wedge.theta1) > 18:
-        ax_sun.text(x, y, level2_names[i], ha="center", va="center", fontsize=13, fontweight="medium", color=INK)
-
-# Level 3 labels (higher threshold to avoid crowding)
+    fill = _label_color(level2_colors[i])
+    ax_sun.text(
+        x,
+        y,
+        level2_names[i].rstrip("/"),
+        ha="center",
+        va="center",
+        fontsize=12,
+        color=fill,
+        path_effects=_label_halo(fill),
+    )
+    level2_label_positions.append((x, y))
+
+# Level 3 labels — higher threshold to avoid crowding the outermost, narrowest wedges
 for i, wedge in enumerate(wedges3):
     ang = (wedge.theta2 + wedge.theta1) / 2
-    r = inner_radius + 2.5 * ring_width
+    span = wedge.theta2 - wedge.theta1
+    if span <= 10:
+        continue
+    r = inner_radius + 2.6 * ring_width
     x = r * np.cos(np.radians(ang))
     y = r * np.sin(np.radians(ang))
-    if (wedge.theta2 - wedge.theta1) > 16:
-        ax_sun.text(x, y, level3_names[i], ha="center", va="center", fontsize=11, color=INK_SOFT)
-
-# Center text showing total
-total_budget = sum(level1_values)
-ax_sun.text(0, 0, f"${total_budget:,}K\nTotal", ha="center", va="center", fontsize=22, fontweight="bold", color=INK)
+    # Skip if a level-2 label already sits on almost the same horizontal line — at this
+    # radius scale their text would run together (e.g. "componentsforms") with no visible gap.
+    if any(abs(y - ly) < 0.08 and abs(x - lx) < 0.9 for lx, ly in level2_label_positions):
+        continue
+    fill = _label_color(level3_colors[i])
+    ax_sun.text(
+        x,
+        y,
+        level3_names[i].rstrip("/"),
+        ha="center",
+        va="center",
+        fontsize=10,
+        color=fill,
+        path_effects=_label_halo(fill),
+    )
+
+# Center text showing repository total
+total_size = sum(level1_values)
+ax_sun.text(0, 0, f"{total_size} MB", ha="center", va="center", fontsize=15, fontweight="bold", color=INK)
 ax_sun.set_aspect("equal")
-
-# Bar chart with palette matching sunburst branch colors
-dept_palette = dict(zip(level1_names, IMPRINT, strict=True))
-df_dept = pd.DataFrame({"Department": level1_names, "Budget ($K)": level1_values})
-sns.barplot(
-    data=df_dept,
-    y="Department",
-    x="Budget ($K)",
-    hue="Department",
-    palette=dept_palette,
-    ax=ax_bar,
-    legend=False,
-    edgecolor=PAGE_BG,
-    linewidth=2,
+outer_radius = inner_radius + 3 * ring_width
+sun_lim = outer_radius * 1.08
+ax_sun.set_xlim(-sun_lim, sun_lim)
+ax_sun.set_ylim(-sun_lim, sun_lim)
+
+# Companion panel: directory totals via seaborn's Objects interface (so.Plot),
+# colored with the same branch hues as the sunburst rings
+df_dir = pd.DataFrame({"Directory": level1_names, "Size (MB)": level1_values}).sort_values("Size (MB)", ascending=True)
+(
+    so.Plot(df_dir, x="Size (MB)", y="Directory", color="Directory")
+    .add(so.Bar(edgecolor=PAGE_BG, edgewidth=2))
+    .scale(color=so.Nominal(dict(zip(level1_names, IMPRINT, strict=True))))
+    .on(ax_bar)
+    .plot()
 )
+for legend in fig.legends:
+    legend.set_visible(False)
 
-ax_bar.set_xlabel("Budget ($K)", fontsize=18, color=INK)
+ax_bar.set_xlabel("Size (MB)", fontsize=20, color=INK)
 ax_bar.set_ylabel("", color=INK)
 ax_bar.tick_params(axis="both", labelsize=16, colors=INK_SOFT)
-ax_bar.set_title("Department Totals", fontsize=20, fontweight="bold", pad=15, color=INK)
-ax_bar.grid(True, axis="x", alpha=0.15, color=INK)
-ax_bar.spines["top"].set_visible(False)
-ax_bar.spines["right"].set_visible(False)
-ax_bar.spines["left"].set_color(INK_SOFT)
-ax_bar.spines["bottom"].set_color(INK_SOFT)
-
-for i, v in enumerate(level1_values):
-    ax_bar.text(v + 15, i, f"${v}K", va="center", fontsize=14, fontweight="medium", color=INK)
-
-fig.suptitle(
-    "Company Budget · sunburst-basic · seaborn · anyplot.ai", fontsize=26, fontweight="bold", y=0.98, color=INK
-)
+ax_bar.set_title("Directory Totals", fontsize=18, fontweight="bold", pad=12, color=INK)
+ax_bar.xaxis.grid(True, alpha=0.15, color=INK)
+sns.despine(ax=ax_bar)
+
+for i, v in enumerate(df_dir["Size (MB)"]):
+    ax_bar.text(v + 4, i, f"{v} MB", va="center", fontsize=13, fontweight="normal", color=INK)
+ax_bar.set_xlim(0, max(level1_values) * 1.22)
+
+fig.suptitle("sunburst-basic · python · seaborn · anyplot.ai", fontsize=18, fontweight="bold", y=0.98, color=INK)
 
-plt.savefig(f"plot-{THEME}.png", dpi=300, bbox_inches="tight", facecolor=PAGE_BG)
+plt.savefig(f"plot-{THEME}.png", dpi=400, facecolor=PAGE_BG)