feat(bokeh): implement scatter-shot-chart (#5115)

## Implementation: `scatter-shot-chart` - bokeh

Implements the **bokeh** version of `scatter-shot-chart`.

**File:** `plots/scatter-shot-chart/implementations/bokeh.py`

**Parent Issue:** #4416

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

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

plots/scatter-shot-chart/implementations/bokeh.py

@@ -0,0 +1,278 @@
+""" pyplots.ai
+scatter-shot-chart: Basketball Shot Chart
+Library: bokeh 3.9.0 | Python 3.14.3
+Quality: 91/100 | Created: 2026-03-20
+"""
+
+import numpy as np
+from bokeh.io import export_png, save
+from bokeh.models import ColumnDataSource, HoverTool, Label, Legend, LegendItem, Range1d
+from bokeh.plotting import figure
+from bokeh.resources import CDN
+
+
+# Data
+np.random.seed(42)
+n_shots = 350
+
+x = np.zeros(n_shots)
+y = np.zeros(n_shots)
+made = np.zeros(n_shots, dtype=bool)
+shot_type = []
+zone_label = []
+
+for i in range(n_shots):
+    zone = np.random.choice(["paint", "midrange", "three", "corner3", "ft"], p=[0.25, 0.20, 0.30, 0.10, 0.15])
+    if zone == "paint":
+        x[i] = np.random.uniform(-8, 8)
+        y[i] = np.random.uniform(0, 12)
+        made[i] = np.random.random() < 0.55
+        shot_type.append("2-pointer")
+        zone_label.append("Paint")
+    elif zone == "midrange":
+        x[i] = np.random.uniform(-16, 16)
+        y[i] = np.random.uniform(5, 20)
+        dist = np.sqrt(x[i] ** 2 + y[i] ** 2)
+        while dist > 23.0 or dist < 5:
+            x[i] = np.random.uniform(-16, 16)
+            y[i] = np.random.uniform(5, 20)
+            dist = np.sqrt(x[i] ** 2 + y[i] ** 2)
+        made[i] = np.random.random() < 0.42
+        shot_type.append("2-pointer")
+        zone_label.append("Mid-Range")
+    elif zone == "three":
+        angle = np.random.uniform(0.25, np.pi - 0.25)
+        r = np.random.uniform(24, 28)
+        x[i] = r * np.cos(angle)
+        y[i] = r * np.sin(angle)
+        x[i] = np.clip(x[i], -24, 24)
+        y[i] = np.clip(y[i], 10, 33)
+        made[i] = np.random.random() < 0.36
+        shot_type.append("3-pointer")
+        zone_label.append("Three-Point")
+    elif zone == "corner3":
+        side = np.random.choice([-1, 1])
+        x[i] = side * np.random.uniform(21.5, 23)
+        y[i] = np.random.uniform(0, 10)
+        made[i] = np.random.random() < 0.39
+        shot_type.append("3-pointer")
+        zone_label.append("Corner 3")
+    else:
+        x[i] = np.random.uniform(-1.5, 1.5)
+        y[i] = np.random.uniform(13.5, 16.5)
+        made[i] = np.random.random() < 0.78
+        shot_type.append("free-throw")
+        zone_label.append("Free Throw")
+
+shot_type = np.array(shot_type)
+zone_label = np.array(zone_label)
+
+# Zone efficiency stats for storytelling
+zones = ["Paint", "Mid-Range", "Three-Point", "Corner 3", "Free Throw"]
+zone_stats = {}
+for z in zones:
+    mask = zone_label == z
+    z_made = int(np.sum(made[mask]))
+    z_total = int(np.sum(mask))
+    z_pct = z_made / z_total * 100 if z_total > 0 else 0
+    zone_stats[z] = (z_made, z_total, z_pct)
+
+# Plot — 1:1 aspect ratio for undistorted court
+p = figure(
+    width=3600,
+    height=3600,
+    title="scatter-shot-chart · bokeh · pyplots.ai",
+    x_range=Range1d(-27, 27),
+    y_range=Range1d(-3, 33),
+    toolbar_location=None,
+    match_aspect=True,
+)
+
+# Court floor
+p.rect(x=0, y=16.5, width=54, height=37, fill_color="#F5F0E8", line_color=None)
+
+# Baseline and sidelines (half-court)
+p.line([-25, 25], [0, 0], line_color="#888888", line_width=4)
+p.line([-25, -25], [0, 35], line_color="#888888", line_width=3)
+p.line([25, 25], [0, 35], line_color="#888888", line_width=3)
+
+# Paint / key area (16 ft wide, 19 ft from baseline)
+p.line([-8, -8, 8, 8], [0, 19, 19, 0], line_color="#888888", line_width=3)
+
+# Free-throw circle (top half solid, bottom half dashed)
+theta_top = np.linspace(0, np.pi, 100)
+theta_bot = np.linspace(np.pi, 2 * np.pi, 100)
+p.line(6 * np.cos(theta_top), 19 + 6 * np.sin(theta_top), line_color="#888888", line_width=3)
+p.line(6 * np.cos(theta_bot), 19 + 6 * np.sin(theta_bot), line_color="#888888", line_width=2, line_dash="dashed")
+
+# Restricted area arc (4 ft radius from basket center)
+theta_ra = np.linspace(0, np.pi, 100)
+p.line(4 * np.cos(theta_ra), 4 * np.sin(theta_ra), line_color="#888888", line_width=2)
+
+# Three-point arc (23.75 ft at top, 22 ft corners)
+theta_3pt = np.linspace(np.arccos(22.0 / 23.75), np.pi - np.arccos(22.0 / 23.75), 200)
+p.line(23.75 * np.cos(theta_3pt), 23.75 * np.sin(theta_3pt), line_color="#888888", line_width=3)
+
+# Corner three-point lines (22 ft from basket, straight down to baseline)
+corner_y = 23.75 * np.sin(np.arccos(22.0 / 23.75))
+p.line([-22, -22], [0, corner_y], line_color="#888888", line_width=3)
+p.line([22, 22], [0, corner_y], line_color="#888888", line_width=3)
+
+# Basket (hoop at center of rim, ~1.5 ft from backboard)
+hoop_theta = np.linspace(0, 2 * np.pi, 50)
+p.line(0.75 * np.cos(hoop_theta), 0.75 * np.sin(hoop_theta) + 1.5, line_color="#C44E2B", line_width=5)
+
+# Backboard
+p.line([-3, 3], [0, 0], line_color="#555555", line_width=6)
+
+# Shot markers — colorblind-safe: blue for made, orange for missed
+made_mask = made
+missed_mask = ~made
+
+result_label = np.where(made, "Made", "Missed")
+distance = np.round(np.sqrt(x**2 + y**2), 1)
+
+source_made = ColumnDataSource(
+    data={
+        "x": x[made_mask],
+        "y": y[made_mask],
+        "result": result_label[made_mask],
+        "zone": zone_label[made_mask],
+        "shot_type": shot_type[made_mask],
+        "distance": distance[made_mask],
+    }
+)
+source_missed = ColumnDataSource(
+    data={
+        "x": x[missed_mask],
+        "y": y[missed_mask],
+        "result": result_label[missed_mask],
+        "zone": zone_label[missed_mask],
+        "shot_type": shot_type[missed_mask],
+        "distance": distance[missed_mask],
+    }
+)
+
+r_made = p.scatter(
+    x="x",
+    y="y",
+    source=source_made,
+    size=20,
+    fill_color="#2171B5",
+    fill_alpha=0.5,
+    line_color="white",
+    line_width=1.5,
+    marker="circle",
+)
+
+r_missed = p.scatter(
+    x="x",
+    y="y",
+    source=source_missed,
+    size=18,
+    fill_color=None,
+    fill_alpha=0,
+    line_color="#E6550D",
+    line_width=3.5,
+    marker="x",
+)
+
+# HoverTool — Bokeh's signature interactive feature
+hover = HoverTool(
+    renderers=[r_made, r_missed],
+    tooltips=[("Result", "@result"), ("Zone", "@zone"), ("Shot Type", "@shot_type"), ("Distance", "@distance ft")],
+    point_policy="snap_to_data",
+)
+p.add_tools(hover)
+
+# Legend
+n_made = int(np.sum(made))
+n_missed = int(np.sum(~made))
+legend = Legend(
+    items=[
+        LegendItem(label=f"Made ({n_made})", renderers=[r_made]),
+        LegendItem(label=f"Missed ({n_missed})", renderers=[r_missed]),
+    ],
+    location="top_center",
+    orientation="horizontal",
+)
+
+p.add_layout(legend, "above")
+p.legend.label_text_font_size = "28pt"
+p.legend.label_text_color = "#333333"
+p.legend.glyph_width = 40
+p.legend.glyph_height = 40
+p.legend.spacing = 50
+p.legend.padding = 20
+p.legend.background_fill_alpha = 0.0
+p.legend.border_line_color = None
+
+# FG% summary
+fg_pct = n_made / n_shots * 100
+p.add_layout(
+    Label(
+        x=0,
+        y=32,
+        text=f"FG: {fg_pct:.1f}%  ·  {n_shots} attempts",
+        text_font_size="26pt",
+        text_color="#666666",
+        text_align="center",
+        text_font_style="bold",
+    )
+)
+
+# Zone efficiency breakdown — data storytelling
+zone_positions = {
+    "Paint": [(0, 6)],
+    "Mid-Range": [(15, 14)],
+    "Three-Point": [(0, 29)],
+    "Corner 3": [(-21, 5), (21, 5)],
+    "Free Throw": [(-12, 17)],
+}
+for z, positions in zone_positions.items():
+    z_made, z_total, z_pct = zone_stats[z]
+    for zx, zy in positions:
+        p.add_layout(
+            Label(
+                x=zx,
+                y=zy,
+                text=f"{z_pct:.0f}%",
+                text_font_size="22pt",
+                text_color="#333333",
+                text_align="center",
+                text_font_style="bold",
+                background_fill_color="#F5F0E8",
+                background_fill_alpha=0.9,
+            )
+        )
+        p.add_layout(
+            Label(
+                x=zx,
+                y=zy - 1.8,
+                text=f"{z_made}/{z_total}",
+                text_font_size="18pt",
+                text_color="#777777",
+                text_align="center",
+                background_fill_color="#F5F0E8",
+                background_fill_alpha=0.9,
+            )
+        )
+
+# Style
+p.title.text_font_size = "40pt"
+p.title.text_color = "#222222"
+p.title.text_font_style = "bold"
+p.title.align = "center"
+
+p.xaxis.visible = False
+p.yaxis.visible = False
+p.xgrid.grid_line_color = None
+p.ygrid.grid_line_color = None
+
+p.background_fill_color = "#F5F0E8"
+p.border_fill_color = "#FAFAFA"
+p.outline_line_color = None
+
+# Save
+export_png(p, filename="plot.png")
+save(p, filename="plot.html", resources=CDN, title="scatter-shot-chart · bokeh · pyplots.ai")