Support extra scale bands and docs fixes

Add two intermediate scale bands (small, large) and map them to the three displayed tiers so highlights resolve correctly (ScaleAwarePage). Remove an unused chartFrame style from the scale-aware suggestions blog and update links/paths in the release blog entry. Clarify API name in chartCapabilityTypes comment (suggestChartsGrouped), add a missing sample array in dataScaleProfile tests, and update dataScaleProfile's comment to note that per-chart minBand/maxBand can hard-filter as well as affect ranking.

Author: emeeks

docs/src/blog/entries/release-3-6-0.js

@@ -8,13 +8,12 @@ function Body() {
       <p>
         3.6.0 is the AI release. The library has carried{" "}
         <Link to="/intelligence/observation-hooks">observation hooks</Link>,{" "}
-        <Link to="/charts/annotations">native annotations</Link>, and a{" "}
-        <Link to="/features/server-side-rendering">streaming-first runtime</Link> for a while; this
-        version turns those pieces into an explicit AI-facing surface. Charts now declare what
-        they're for, datasets get profiled and ranked, audiences get calibrated, and conversations
-        anchor back onto the chart instead of stopping at a chat bubble. Three case-study posts
-        published alongside this release walk through what that makes possible. Full release notes
-        are on{" "}
+        <Link to="/features/annotations">native annotations</Link>, and a{" "}
+        <Link to="/features/push-api">streaming-first runtime</Link> for a while; this version turns
+        those pieces into an explicit AI-facing surface. Charts now declare what they're for,
+        datasets get profiled and ranked, audiences get calibrated, and conversations anchor back
+        onto the chart instead of stopping at a chat bubble. Three case-study posts published
+        alongside this release walk through what that makes possible. Full release notes are on{" "}
         <a
           href="https://github.com/nteract/semiotic/blob/main/CHANGELOG.md#360---2026-05-31"
           target="_blank"

docs/src/blog/entries/scale-aware-suggestions.js

@@ -10,15 +10,6 @@ import {
 
 // ─── Shared styling ────────────────────────────────────────────────────────
 
-const chartFrame = {
-  background: "var(--surface-1)",
-  borderRadius: 8,
-  padding: 16,
-  border: "1px solid var(--surface-3)",
-  overflow: "hidden",
-  margin: "20px 0",
-}
-
 const sideBySide = {
   display: "grid",
   gridTemplateColumns: "repeat(3, minmax(0, 1fr))",

docs/src/pages/features/ScaleAwarePage.js

@@ -54,10 +54,18 @@ const BANDS = ["tiny", "medium", "huge"]
 
 const BAND_LABEL = {
   tiny: "Tiny (≤3)",
+  small: "Small (~15)",
   medium: "Medium (~140)",
+  large: "Large (~1k)",
   huge: "Huge (>5k)",
 }
 
+// effectiveBand can be any of the five ScaleBand values, but only three tiers
+// are displayed. Map the in-between bands to the nearest displayed tier so the
+// highlight still resolves.
+const toDisplayedBand = (band) =>
+  band === "small" ? "tiny" : band === "large" ? "huge" : band
+
 const DATASETS = {
   layered: {
     label: "Categories × Categories × Value",
@@ -305,7 +313,7 @@ function ScaleAwareDemo() {
             key={band}
             band={band}
             suggestion={grouped[band][0]}
-            highlighted={effectiveBand === band}
+            highlighted={toDisplayedBand(effectiveBand) === band}
           />
         ))}
       </div>

src/components/ai/chartCapabilityTypes.ts

@@ -267,7 +267,7 @@ export interface Suggestion {
 
 /**
  * Multi-tier grouping of suggestions by scale band. Returned by
- * `suggestCharts` when `groupByScale: true` is passed.
+ * `suggestChartsGrouped()`.
  *
  * Each tier is a ranked list of suggestions whose `scaleRange.band` falls in
  * that tier. A single chart can appear in multiple tiers when its sweet-spot

src/components/ai/dataScaleProfile.test.ts

@@ -37,6 +37,7 @@ function makeProfile(overrides: Partial<ChartDataProfile> = {}): ChartDataProfil
   return {
     rowCount: 50,
     fields: { x: { type: "numeric", min: 0, max: 100, distinctCount: 50 } as never },
+    sample: [],
     data: [],
     candidates: { x: [], y: [], size: [], category: [], series: [], time: [] },
     primary: { x: "x", y: "y" },

src/components/ai/dataScaleProfile.ts

@@ -15,8 +15,9 @@
  *             + qualityBias(quality, capability, profile)
  *             + audienceBias(audience, capability)
  *
- * Each layer can be omitted independently. None of them gate the suggestion;
- * `fits()` is still the only hard reject.
+ * Each layer can be omitted independently. Most adjust ranking only, but
+ * per-chart scale preferences can also hard-filter via `minBand`/`maxBand`
+ * exclusions in addition to `fits()`.
  */
 
 import type { ChartCapability, ChartDataProfile } from "./chartCapabilityTypes"