@fusion.dev/helix 0.40.0 → 0.41.0

package/custom-elements.json

@@ -2709,7 +2709,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The bands take the series palette in order, the first column at the bottom,\nso a legend beside the chart names them in the order they are stacked.\n\nEach band is a pale fill with its top edge drawn at the series' full color.\nThe fills are mixed toward the page rather than made translucent, because\nthe bands overlap where they are drawn and a translucent one would show the\nothers through it.",
+          "description": "The bands take the series palette in order, the first column at the bottom,\nso a legend beside the chart names them in the order they are stacked.\n\nEach band is a pale fill with its top edge drawn at the series' full color.\nThe fills are mixed toward the page rather than made translucent, because\nthe bands overlap where they are drawn and a translucent one would show the\nothers through it.\n\n**No visual axis applies here, and that is the answer rather than a gap.**\nBoth refusals are geometric and both were argued in the stylesheet before\nthey were argued anywhere a reader looks.\n\n`emphasis` is which of a family's two marks carries the reading, and here\nneither can give way. The fill is the value, a band's thickness being its\namount, and the edge is the boundary, which is why it is drawn at full color\nover a pale fill rather than left to two pale fills meeting. Every point on\nthe axis moves one at the other's expense: `outlined` thins the fill until\nthe chart is a set of cumulative lines, which is `LineChart` and is the form\nthis one exists because a reader cannot read shares off; `solid` takes the\nfill to the series' own color, which is the edge's color, so the boundary\ndisappears into the band it bounds. `LineChart` can take the axis because its\nwash is optional there, `area` deciding whether one is drawn at all.\n\n`material` is what reads through a mark, and a band cannot let anything\nthrough. Each is drawn as everything under its top edge with the next one\ndown covering the rest, so a translucent band shows the bands behind it and\nreads as a third color that is in no palette. That is `LineChart`'s recorded\nreason for refusing `wash`, met here from the other side. The strength of a\nfill is still adjustable and is `--area-chart-fill-strength`, which is a\ncontinuum rather than an axis and is a theme's business rather than a\nreader's.",
           "name": "HelixAreaChart",
           "cssProperties": [
             {
@@ -2731,6 +2731,10 @@
             {
               "description": "Thickness of a band's top edge, over `--chart-stroke`.",
               "name": "--area-chart-width"
+            },
+            {
+              "description": "Thickness of a band's top edge, one name across this family, Line Chart and Bar Chart's `lines`, since the three read one shared rule. `--area-chart-width` overrides it here.",
+              "name": "--chart-stroke"
             }
           ],
           "members": [
@@ -2838,6 +2842,44 @@
                 "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "plottedColumns",
+              "type": {
+                "text": "number[]"
+              },
+              "description": "Which cells of a row hold numbers, by their place in it, in table order.\n\nThe same test `readSeries` applies when it drops a column of notes: a\ncolumn is a series where any row parses, so a series survives one blank\ncell and a column of words is never one.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "seriesOf",
+              "return": {
+                "type": {
+                  "text": "number | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "cell",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "The palette slot the cell at this place in a row is drawn in.\n\n**A cell's place in its row is not its series' depth, and the tooltip\nspent a while assuming it was.** `readSeries` drops a column nothing\nparses and `readRows` keeps it, so one column of notes among the figures\nmoves every column after it one color along in the bubble: a row reading\n`Referral 1,080` wearing series three's green beside a legend that says\nseries three is something else, which is the one failure the dot exists\nto prevent.\n\nOverridden where a chart reads the table some other way. `ScatterChart`\nsplits the first plotted column off as the measure across, so its first\n*plotted* series is this table's second numeric column.",
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              },
+              "type": {
+                "text": "seriesOf(cell: number) => number | undefined"
+              }
+            },
             {
               "kind": "field",
               "name": "readings",
@@ -2857,7 +2899,7 @@
               "type": {
                 "text": "Curve | undefined"
               },
-              "description": "How a band's edge gets from one reading to the next.\n\nAbsent is `straight`, for the reason the class doc gives, and absent rather\nthan defaulted because a reflecting property with a default writes its\nattribute onto every host, including the ones nobody configured.",
+              "description": "How a band's edge gets from one reading to the next.\n\nThree values, and the class doc argues for each: `straight` is absent and\nis the default, `smooth` is for a stack read as a shape and is the one that\ncan draw a part as less than nothing, `step` is for a quantity that changes\nat a moment and is ordered the way `straight` is.\n\nAbsent rather than defaulted because a reflecting property with a default\nwrites its attribute onto every host, including the ones nobody configured.",
               "attribute": "curve",
               "reflects": true,
               "inheritedFrom": {
@@ -3558,12 +3600,12 @@
           "helix": {
             "category": "charts",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/area-chart",
             "aliases": [
               "Stacked Area Chart",
               "Composition Chart",
-              "Stream Chart"
+              "Banded Chart"
             ],
             "groups": [
               "charts"
@@ -3577,10 +3619,30 @@
                 "min": 300,
                 "slug": "preview"
               },
+              {
+                "description": "The three curves over one stack: joined straight, smoothed, and held until the next reading. Straight is what an absent `curve` draws.",
+                "min": 300,
+                "slug": "curves"
+              },
               {
                 "description": "The same months as shares, so every reading fills the height and a band is its part of the whole.",
                 "min": 300,
                 "slug": "share"
+              },
+              {
+                "description": "A legend beside the bands, naming them in the order they are stacked and in the colors they are drawn.",
+                "min": 300,
+                "slug": "with-a-legend"
+              },
+              {
+                "description": "A pointer resting on a reading, showing every part and the sum under the name `total-label` gives it.",
+                "min": 300,
+                "slug": "with-a-tooltip"
+              },
+              {
+                "description": "Rules at the levels the total reaches, drawn over the bands rather than under them.",
+                "min": 300,
+                "slug": "with-gridlines"
               }
             ],
             "source": "helix/styled/src/area-chart"
@@ -3619,7 +3681,7 @@
               "type": {
                 "text": "Curve | undefined"
               },
-              "description": "How a band's edge gets from one reading to the next.\n\nAbsent is `straight`, for the reason the class doc gives, and absent rather\nthan defaulted because a reflecting property with a default writes its\nattribute onto every host, including the ones nobody configured.",
+              "description": "How a band's edge gets from one reading to the next.\n\nThree values, and the class doc argues for each: `straight` is absent and\nis the default, `smooth` is for a stack read as a shape and is the one that\ncan draw a part as less than nothing, `step` is for a quantity that changes\nat a moment and is ordered the way `straight` is.\n\nAbsent rather than defaulted because a reflecting property with a default\nwrites its attribute onto every host, including the ones nobody configured.",
               "fieldName": "curve",
               "inheritedFrom": {
                 "name": "HelixHeadlessAreaChart",
@@ -7205,7 +7267,11 @@
               "name": "--bar-chart-line-width"
             },
             {
-              "description": "The color of a single-series axis, taken from that series.",
+              "description": "Thickness of a `lines` series, one name across this family, Line Chart and Area Chart's top edge, since the three read one shared rule. `--bar-chart-line-width` overrides it here.",
+              "name": "--chart-stroke"
+            },
+            {
+              "description": "How wide an axis column is drawn, in `ch`, from the widest number on it. Written on the axis itself, and only where the categories run along the bottom: turned sideways an axis is a row and takes a line's height instead.",
               "name": "--bar-chart-axis",
               "inheritedFrom": {
                 "name": "HelixHeadlessBarChart",
@@ -7250,7 +7316,7 @@
               "type": {
                 "text": "'outlined' | 'solid' | 'subtle' | undefined"
               },
-              "description": "How much ink the columns claim.\n\nThe chart's treatment, which every series takes unless `outlined` or\n`subtle` names it. `outlined` is the mark as its edge alone, `subtle` a wash\nof the series color with that edge on it, and absent is the filled column,\nper the rule that a reflected property takes no default.\n\n**It composes with `material` rather than competing with it.** Emphasis\ndecides what is drawn and material decides how much of it comes through, so\n`glass` thins whatever emphasis put there: the fill on a solid column, the\nstroke on an outlined one. Without that the corner is inert, `glass` setting\na fill opacity on a mark whose fill is `none`, and a combination that\nsilently does nothing is the worst shape this can take.",
+              "description": "How much ink the columns claim.\n\nThe chart's treatment, which every series takes unless `outlined` or\n`subtle` names it. `outlined` is the mark as its edge alone, `subtle` a wash\nof the series color with that edge on it, and absent is the filled column,\nper the rule that a reflected property takes no default.\n\n`solid` is that filled column written out. It matches no rule in the sheet\nand lands on the base one, which is what the resting value of every axis in\nthe registry does, and it is worth having so a consumer switching a chart\nbetween treatments has a word for the one it started at rather than having\nto remove the attribute.\n\n**It composes with `material` rather than competing with it.** Emphasis\ndecides what is drawn and material decides how much of it comes through, so\n`glass` thins whatever emphasis put there: the fill on a solid column, the\nstroke on an outlined one. Without that the corner is inert, `glass` setting\na fill opacity on a mark whose fill is `none`, and a combination that\nsilently does nothing is the worst shape this can take.",
               "attribute": "emphasis",
               "reflects": true
             },
@@ -7279,7 +7345,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Which series are drawn as an outline rather than a fill, by name.\n\nSpace separated and matched against the column headings the table gives,\nthe way `lines` and `secondary` are, so a chart says `outlined=\"Forecast\"`\nrather than counting columns. Names because they are what the table already\ncarries and what the legend already shows.\n\n**The case this exists for is a series that is not a measurement.** A\nforecast, a target, a budget: something drawn on the same axis as the\nothers and not the same kind of fact, which an outline says without a\nsecond legend or a note under the chart.\n\nPer series and not per bar, because a bar is a mark inside a drawing and\nnobody writes markup for one, which is the same reason `material` sits on\nthe chart.",
+              "description": "Which series are drawn as an outline rather than a fill, by name.\n\nSeparated by whitespace or commas and matched against the column headings\nthe table gives, the way `lines` and `secondary` are, so a chart says\n`outlined=\"Forecast\"` rather than counting columns. Names because they are\nwhat the table already carries and what the legend already shows.\n\nAll five read one splitter, `seriesNames` in `core`, because the sentence\nabove was true of the matching and false of the splitting: these three took\na comma and those two did not, so `lines=\"Gateway, Billing\"` drew no line\nand said nothing.\n\n**The case this exists for is a series that is not a measurement.** A\nforecast, a target, a budget: something drawn on the same axis as the\nothers and not the same kind of fact, which an outline says without a\nsecond legend or a note under the chart.\n\nPer series and not per bar, because a bar is a mark inside a drawing and\nnobody writes markup for one, which is the same reason `material` sits on\nthe chart.",
               "attribute": "outlined"
             },
             {
@@ -7391,6 +7457,44 @@
                 "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "plottedColumns",
+              "type": {
+                "text": "number[]"
+              },
+              "description": "Which cells of a row hold numbers, by their place in it, in table order.\n\nThe same test `readSeries` applies when it drops a column of notes: a\ncolumn is a series where any row parses, so a series survives one blank\ncell and a column of words is never one.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "seriesOf",
+              "return": {
+                "type": {
+                  "text": "number | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "cell",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "The palette slot the cell at this place in a row is drawn in.\n\n**A cell's place in its row is not its series' depth, and the tooltip\nspent a while assuming it was.** `readSeries` drops a column nothing\nparses and `readRows` keeps it, so one column of notes among the figures\nmoves every column after it one color along in the bubble: a row reading\n`Referral 1,080` wearing series three's green beside a legend that says\nseries three is something else, which is the one failure the dot exists\nto prevent.\n\nOverridden where a chart reads the table some other way. `ScatterChart`\nsplits the first plotted column off as the measure across, so its first\n*plotted* series is this table's second numeric column.",
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              },
+              "type": {
+                "text": "seriesOf(cell: number) => number | undefined"
+              }
+            },
             {
               "kind": "field",
               "name": "readings",
@@ -7437,7 +7541,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Which series are drawn as a line instead of as columns, by name.\n\nSpace separated, matched against the column headings the table gives, so a\nchart says `lines=\"Margin\"` rather than counting columns. Names because\nthey are what the table already carries and what the legend already shows:\nan index is a fourth place the column order is written down and the first\none to go stale when somebody moves a column.\n\n**A combination chart is one scale, and that is the honest half of it.**\nBoth marks are measured against the same domain, so a line here says\nsomething comparable to the columns beside it. The usual reason to reach\nfor a combination chart is the other thing, a count against a percentage on\na second axis, and that is deliberately not this: two scales on one frame\nlet the author put any two shapes in any relation by choosing the ranges,\nand the reader has no way to see it happening.\n\nA line among columns still measures from zero, because the columns do and\nthey share the axis.",
+              "description": "Which series are drawn as a line instead of as columns, by name.\n\nSeparated by whitespace or commas and matched against the column headings\nthe table gives, so a chart says `lines=\"Margin\"` rather than counting\ncolumns. Names because they are what the table already carries and what the\nlegend already shows: an index is a fourth place the column order is\nwritten down and the first one to go stale when somebody moves a column.\n\n**This says which mark a series takes and nothing about which scale it is\nmeasured on.** Named here alone, a line shares the columns' domain, so it\nsays something comparable to the columns beside it.\n\nThe other half of a combination chart, a count against a percentage on a\nscale of its own, is `secondary`, which is a separate property because it\nis a separate question and because the two compose: `with-a-second-axis`\nships naming one series in both. The argument for why a second scale is opt\nin, and why setting it labels both axes, is written there.\n\nA line among columns measures from zero, because the columns do and they\nshare the axis. So does a line on the second scale, which is that scale's\nown rule rather than this one's.",
               "attribute": "lines",
               "inheritedFrom": {
                 "name": "HelixHeadlessBarChart",
@@ -7450,7 +7554,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Which series are measured against a scale of their own, by name.\n\nSpace separated and matched the way `lines` is, against the column headings\nthe table gives. Opt in: absent, every series shares one domain, which is\nwhat makes a chart comparable and is the right default.\n\n**Two scales on one frame let an author put any two shapes in any relation\nby choosing the ranges, and a reader cannot see it happening.** That is not\na caveat, it is what the feature does: a line that crosses the columns\ntwice and a line that never touches them can be the same two series drawn\nagainst different ranges. It earns its place when the two quantities are\ngenuinely incomparable, a count against a percentage, and it is a way to\nmislead in every other case.\n\n**So it draws its axes**, and that is not optional here. The chart renders\nno value axis at all when there is one scale, because the columns are\nmeasured against each other and a reader needs no numbers to do that. With\ntwo, a reader has no way of knowing there are two, let alone which series\nis on which, so both scales are labeled the moment this is set. An\nunlabeled second axis is the deceptive case rather than the tidy one.\n\nThe grid stays on the primary axis, since a rule measured against two\nscales at once is a rule that means nothing. The tooltip is unaffected: it\nhas always shown every column's own number, which is the reader's way out\nof any scale question the picture raises.",
+              "description": "Which series are measured against a scale of their own, by name.\n\nSeparated and matched the way `lines` is, against the column headings the\ntable gives. Opt in: absent, every series shares one domain, which is what\nmakes a chart comparable and is the right default.\n\n**The scale, and `lines` is the mark.** The two are separate properties\nbecause they answer separate questions and a series usually wants both:\na percentage beside a count is drawn as a line *and* measured on its own\naxis, which is what `with-a-second-axis` writes out. Neither implies the\nother, so a series can be a line on the shared scale and a column can have\na scale to itself.\n\n**Two scales on one frame let an author put any two shapes in any relation\nby choosing the ranges, and a reader cannot see it happening.** That is not\na caveat, it is what the feature does: a line that crosses the columns\ntwice and a line that never touches them can be the same two series drawn\nagainst different ranges. It earns its place when the two quantities are\ngenuinely incomparable, a count against a percentage, and it is a way to\nmislead in every other case.\n\n**So it draws its axes**, and that is not optional here. The chart renders\nno value axis at all when there is one scale, because the columns are\nmeasured against each other and a reader needs no numbers to do that. With\ntwo, a reader has no way of knowing there are two, let alone which series\nis on which, so both scales are labeled the moment this is set. An\nunlabeled second axis is the deceptive case rather than the tidy one.\n\nThe grid stays on the primary axis, since a rule measured against two\nscales at once is a rule that means nothing. The tooltip is unaffected: it\nhas always shown every column's own number, which is the reader's way out\nof any scale question the picture raises.",
               "attribute": "secondary",
               "reflects": true,
               "inheritedFrom": {
@@ -8093,7 +8197,7 @@
               "type": {
                 "text": "'outlined' | 'solid' | 'subtle' | undefined"
               },
-              "description": "How much ink the columns claim.\n\nThe chart's treatment, which every series takes unless `outlined` or\n`subtle` names it. `outlined` is the mark as its edge alone, `subtle` a wash\nof the series color with that edge on it, and absent is the filled column,\nper the rule that a reflected property takes no default.\n\n**It composes with `material` rather than competing with it.** Emphasis\ndecides what is drawn and material decides how much of it comes through, so\n`glass` thins whatever emphasis put there: the fill on a solid column, the\nstroke on an outlined one. Without that the corner is inert, `glass` setting\na fill opacity on a mark whose fill is `none`, and a combination that\nsilently does nothing is the worst shape this can take.",
+              "description": "How much ink the columns claim.\n\nThe chart's treatment, which every series takes unless `outlined` or\n`subtle` names it. `outlined` is the mark as its edge alone, `subtle` a wash\nof the series color with that edge on it, and absent is the filled column,\nper the rule that a reflected property takes no default.\n\n`solid` is that filled column written out. It matches no rule in the sheet\nand lands on the base one, which is what the resting value of every axis in\nthe registry does, and it is worth having so a consumer switching a chart\nbetween treatments has a word for the one it started at rather than having\nto remove the attribute.\n\n**It composes with `material` rather than competing with it.** Emphasis\ndecides what is drawn and material decides how much of it comes through, so\n`glass` thins whatever emphasis put there: the fill on a solid column, the\nstroke on an outlined one. Without that the corner is inert, `glass` setting\na fill opacity on a mark whose fill is `none`, and a combination that\nsilently does nothing is the worst shape this can take.",
               "fieldName": "emphasis"
             },
             {
@@ -8117,7 +8221,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Which series are drawn as an outline rather than a fill, by name.\n\nSpace separated and matched against the column headings the table gives,\nthe way `lines` and `secondary` are, so a chart says `outlined=\"Forecast\"`\nrather than counting columns. Names because they are what the table already\ncarries and what the legend already shows.\n\n**The case this exists for is a series that is not a measurement.** A\nforecast, a target, a budget: something drawn on the same axis as the\nothers and not the same kind of fact, which an outline says without a\nsecond legend or a note under the chart.\n\nPer series and not per bar, because a bar is a mark inside a drawing and\nnobody writes markup for one, which is the same reason `material` sits on\nthe chart.",
+              "description": "Which series are drawn as an outline rather than a fill, by name.\n\nSeparated by whitespace or commas and matched against the column headings\nthe table gives, the way `lines` and `secondary` are, so a chart says\n`outlined=\"Forecast\"` rather than counting columns. Names because they are\nwhat the table already carries and what the legend already shows.\n\nAll five read one splitter, `seriesNames` in `core`, because the sentence\nabove was true of the matching and false of the splitting: these three took\na comma and those two did not, so `lines=\"Gateway, Billing\"` drew no line\nand said nothing.\n\n**The case this exists for is a series that is not a measurement.** A\nforecast, a target, a budget: something drawn on the same axis as the\nothers and not the same kind of fact, which an outline says without a\nsecond legend or a note under the chart.\n\nPer series and not per bar, because a bar is a mark inside a drawing and\nnobody writes markup for one, which is the same reason `material` sits on\nthe chart.",
               "fieldName": "outlined"
             },
             {
@@ -8191,7 +8295,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Which series are drawn as a line instead of as columns, by name.\n\nSpace separated, matched against the column headings the table gives, so a\nchart says `lines=\"Margin\"` rather than counting columns. Names because\nthey are what the table already carries and what the legend already shows:\nan index is a fourth place the column order is written down and the first\none to go stale when somebody moves a column.\n\n**A combination chart is one scale, and that is the honest half of it.**\nBoth marks are measured against the same domain, so a line here says\nsomething comparable to the columns beside it. The usual reason to reach\nfor a combination chart is the other thing, a count against a percentage on\na second axis, and that is deliberately not this: two scales on one frame\nlet the author put any two shapes in any relation by choosing the ranges,\nand the reader has no way to see it happening.\n\nA line among columns still measures from zero, because the columns do and\nthey share the axis.",
+              "description": "Which series are drawn as a line instead of as columns, by name.\n\nSeparated by whitespace or commas and matched against the column headings\nthe table gives, so a chart says `lines=\"Margin\"` rather than counting\ncolumns. Names because they are what the table already carries and what the\nlegend already shows: an index is a fourth place the column order is\nwritten down and the first one to go stale when somebody moves a column.\n\n**This says which mark a series takes and nothing about which scale it is\nmeasured on.** Named here alone, a line shares the columns' domain, so it\nsays something comparable to the columns beside it.\n\nThe other half of a combination chart, a count against a percentage on a\nscale of its own, is `secondary`, which is a separate property because it\nis a separate question and because the two compose: `with-a-second-axis`\nships naming one series in both. The argument for why a second scale is opt\nin, and why setting it labels both axes, is written there.\n\nA line among columns measures from zero, because the columns do and they\nshare the axis. So does a line on the second scale, which is that scale's\nown rule rather than this one's.",
               "fieldName": "lines",
               "inheritedFrom": {
                 "name": "HelixHeadlessBarChart",
@@ -8203,7 +8307,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Which series are measured against a scale of their own, by name.\n\nSpace separated and matched the way `lines` is, against the column headings\nthe table gives. Opt in: absent, every series shares one domain, which is\nwhat makes a chart comparable and is the right default.\n\n**Two scales on one frame let an author put any two shapes in any relation\nby choosing the ranges, and a reader cannot see it happening.** That is not\na caveat, it is what the feature does: a line that crosses the columns\ntwice and a line that never touches them can be the same two series drawn\nagainst different ranges. It earns its place when the two quantities are\ngenuinely incomparable, a count against a percentage, and it is a way to\nmislead in every other case.\n\n**So it draws its axes**, and that is not optional here. The chart renders\nno value axis at all when there is one scale, because the columns are\nmeasured against each other and a reader needs no numbers to do that. With\ntwo, a reader has no way of knowing there are two, let alone which series\nis on which, so both scales are labeled the moment this is set. An\nunlabeled second axis is the deceptive case rather than the tidy one.\n\nThe grid stays on the primary axis, since a rule measured against two\nscales at once is a rule that means nothing. The tooltip is unaffected: it\nhas always shown every column's own number, which is the reader's way out\nof any scale question the picture raises.",
+              "description": "Which series are measured against a scale of their own, by name.\n\nSeparated and matched the way `lines` is, against the column headings the\ntable gives. Opt in: absent, every series shares one domain, which is what\nmakes a chart comparable and is the right default.\n\n**The scale, and `lines` is the mark.** The two are separate properties\nbecause they answer separate questions and a series usually wants both:\na percentage beside a count is drawn as a line *and* measured on its own\naxis, which is what `with-a-second-axis` writes out. Neither implies the\nother, so a series can be a line on the shared scale and a column can have\na scale to itself.\n\n**Two scales on one frame let an author put any two shapes in any relation\nby choosing the ranges, and a reader cannot see it happening.** That is not\na caveat, it is what the feature does: a line that crosses the columns\ntwice and a line that never touches them can be the same two series drawn\nagainst different ranges. It earns its place when the two quantities are\ngenuinely incomparable, a count against a percentage, and it is a way to\nmislead in every other case.\n\n**So it draws its axes**, and that is not optional here. The chart renders\nno value axis at all when there is one scale, because the columns are\nmeasured against each other and a reader needs no numbers to do that. With\ntwo, a reader has no way of knowing there are two, let alone which series\nis on which, so both scales are labeled the moment this is set. An\nunlabeled second axis is the deceptive case rather than the tidy one.\n\nThe grid stays on the primary axis, since a rule measured against two\nscales at once is a rule that means nothing. The tooltip is unaffected: it\nhas always shown every column's own number, which is the reader's way out\nof any scale question the picture raises.",
               "fieldName": "secondary",
               "inheritedFrom": {
                 "name": "HelixHeadlessBarChart",
@@ -8219,7 +8323,7 @@
           "helix": {
             "category": "charts",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/bar-chart",
             "aliases": [
               "Column Chart",
@@ -41331,6 +41435,44 @@
                 "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "plottedColumns",
+              "type": {
+                "text": "number[]"
+              },
+              "description": "Which cells of a row hold numbers, by their place in it, in table order.\n\nThe same test `readSeries` applies when it drops a column of notes: a\ncolumn is a series where any row parses, so a series survives one blank\ncell and a column of words is never one.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "seriesOf",
+              "return": {
+                "type": {
+                  "text": "number | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "cell",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "The palette slot the cell at this place in a row is drawn in.\n\n**A cell's place in its row is not its series' depth, and the tooltip\nspent a while assuming it was.** `readSeries` drops a column nothing\nparses and `readRows` keeps it, so one column of notes among the figures\nmoves every column after it one color along in the bubble: a row reading\n`Referral 1,080` wearing series three's green beside a legend that says\nseries three is something else, which is the one failure the dot exists\nto prevent.\n\nOverridden where a chart reads the table some other way. `ScatterChart`\nsplits the first plotted column off as the measure across, so its first\n*plotted* series is this table's second numeric column.",
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              },
+              "type": {
+                "text": "seriesOf(cell: number) => number | undefined"
+              }
+            },
             {
               "kind": "field",
               "name": "readings",
@@ -41350,9 +41492,8 @@
               "type": {
                 "text": "'large' | 'none' | 'small' | undefined"
               },
-              "description": "How much is left open in the middle.\n\nAbsent is a ring with room for a total in it. `small` and `large` move the\nhole without moving the outer edge, so a chart keeps its footprint.\n\n**`none` is a pie**, and it is the same drawing rather than another one:\nthe radius follows the thickness, so the inner edge reaching the center is\nwhat closing the hole means. A pie reads less accurately than a ring, angle\nbeing harder to judge than length, but it is not *misleading* the way a bar\nmeasured from anything but zero is, which is why this is a value here and\nthe bar chart's baseline is not a property at all.\n\n**Geometry rather than a CSS hook.** The dash arithmetic needs the\ncircumference, which needs the radius, and reading a custom property means\n`getComputedStyle`, which is client-only: a server would draw a different\nring than the client. A plot's proportions are markup for the same reason\n`curve` is.",
+              "description": "How much is left open in the middle.\n\nAbsent is a ring with room for a total in it. `small` and `large` move the\nhole without moving the outer edge, so a chart keeps its footprint.\n\n**`none` is a pie**, and it is the same drawing rather than another one:\nthe radius follows the thickness, so the inner edge reaching the center is\nwhat closing the hole means. A pie reads less accurately than a ring, angle\nbeing harder to judge than length, but it is not *misleading* the way a bar\nmeasured from anything but zero is, which is why this is a value here and\nthe bar chart's baseline is not a property at all.\n\n**Geometry rather than a CSS hook.** The dash arithmetic needs the\ncircumference, which needs the radius, and reading a custom property means\n`getComputedStyle`, which is client-only: a server would draw a different\nring than the client. A plot's proportions are markup for the same reason\n`curve` is.\n\n**And so it does not reflect**, which is the same argument read forward. No\nselector on either tier asks about it and none can want to: everything the\nthickness decides is arithmetic done here and published as\n`--donut-chart-stroke`, which is a number a rule can do sums with where the\nword is not. Reflected, it wrote a value onto every host a script had set\nit on for nothing to read. `sweep` beside it is the converse and reflects,\nbecause three rules select on it.",
               "attribute": "hole",
-              "reflects": true,
               "inheritedFrom": {
                 "name": "HelixHeadlessDonutChart",
                 "module": "src/donut-chart/root/donut-chart-root.ts"
@@ -41910,7 +42051,7 @@
               "type": {
                 "text": "'large' | 'none' | 'small' | undefined"
               },
-              "description": "How much is left open in the middle.\n\nAbsent is a ring with room for a total in it. `small` and `large` move the\nhole without moving the outer edge, so a chart keeps its footprint.\n\n**`none` is a pie**, and it is the same drawing rather than another one:\nthe radius follows the thickness, so the inner edge reaching the center is\nwhat closing the hole means. A pie reads less accurately than a ring, angle\nbeing harder to judge than length, but it is not *misleading* the way a bar\nmeasured from anything but zero is, which is why this is a value here and\nthe bar chart's baseline is not a property at all.\n\n**Geometry rather than a CSS hook.** The dash arithmetic needs the\ncircumference, which needs the radius, and reading a custom property means\n`getComputedStyle`, which is client-only: a server would draw a different\nring than the client. A plot's proportions are markup for the same reason\n`curve` is.",
+              "description": "How much is left open in the middle.\n\nAbsent is a ring with room for a total in it. `small` and `large` move the\nhole without moving the outer edge, so a chart keeps its footprint.\n\n**`none` is a pie**, and it is the same drawing rather than another one:\nthe radius follows the thickness, so the inner edge reaching the center is\nwhat closing the hole means. A pie reads less accurately than a ring, angle\nbeing harder to judge than length, but it is not *misleading* the way a bar\nmeasured from anything but zero is, which is why this is a value here and\nthe bar chart's baseline is not a property at all.\n\n**Geometry rather than a CSS hook.** The dash arithmetic needs the\ncircumference, which needs the radius, and reading a custom property means\n`getComputedStyle`, which is client-only: a server would draw a different\nring than the client. A plot's proportions are markup for the same reason\n`curve` is.\n\n**And so it does not reflect**, which is the same argument read forward. No\nselector on either tier asks about it and none can want to: everything the\nthickness decides is arithmetic done here and published as\n`--donut-chart-stroke`, which is a number a rule can do sums with where the\nword is not. Reflected, it wrote a value onto every host a script had set\nit on for nothing to read. `sweep` beside it is the converse and reflects,\nbecause three rules select on it.",
               "fieldName": "hole",
               "inheritedFrom": {
                 "name": "HelixHeadlessDonutChart",
@@ -41938,7 +42079,7 @@
           "helix": {
             "category": "charts",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/donut-chart",
             "aliases": [
               "Pie Chart",
@@ -54209,6 +54350,44 @@
                 "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "plottedColumns",
+              "type": {
+                "text": "number[]"
+              },
+              "description": "Which cells of a row hold numbers, by their place in it, in table order.\n\nThe same test `readSeries` applies when it drops a column of notes: a\ncolumn is a series where any row parses, so a series survives one blank\ncell and a column of words is never one.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "seriesOf",
+              "return": {
+                "type": {
+                  "text": "number | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "cell",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "The palette slot the cell at this place in a row is drawn in.\n\n**A cell's place in its row is not its series' depth, and the tooltip\nspent a while assuming it was.** `readSeries` drops a column nothing\nparses and `readRows` keeps it, so one column of notes among the figures\nmoves every column after it one color along in the bubble: a row reading\n`Referral 1,080` wearing series three's green beside a legend that says\nseries three is something else, which is the one failure the dot exists\nto prevent.\n\nOverridden where a chart reads the table some other way. `ScatterChart`\nsplits the first plotted column off as the measure across, so its first\n*plotted* series is this table's second numeric column.",
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              },
+              "type": {
+                "text": "seriesOf(cell: number) => number | undefined"
+              }
+            },
             {
               "kind": "field",
               "name": "readings",
@@ -61127,9 +61306,9 @@
               "kind": "field",
               "name": "entries",
               "type": {
-                "text": "'categories' | 'series' | undefined"
+                "text": "'categories' | 'measures' | 'series' | undefined"
               },
-              "description": "Which way to read the table.\n\nAbsent is `series`, one entry per data column. `categories` reads one entry\nper body row instead, for a donut, whose slices are the rows.",
+              "description": "Which way to read the table.\n\nAbsent is `series`, one entry per data column. `categories` reads one entry\nper body row instead, for a donut, whose slices are the rows.\n\n**`measures` is `series` without the first column, and it is for a\nscatter.** That chart reads its first numeric column as the measure\n*across*, so its first plotted series is the table's second and everything\na legend beside it named was one color out: the across column wearing the\ncolor of the first series drawn, and each real series wearing the next\none's. The across gets no entry rather than a shifted one, because it is an\naxis and a scatter already writes its name at the end of the scale under\nthe plot.\n\nA legend cannot ask the chart which of these it is, `for` naming the table\nthey share and not each other, so the consumer says it. That is the same\nshape `categories` already has.",
               "attribute": "entries",
               "reflects": true,
               "inheritedFrom": {
@@ -61554,9 +61733,9 @@
             {
               "name": "entries",
               "type": {
-                "text": "'categories' | 'series' | undefined"
+                "text": "'categories' | 'measures' | 'series' | undefined"
               },
-              "description": "Which way to read the table.\n\nAbsent is `series`, one entry per data column. `categories` reads one entry\nper body row instead, for a donut, whose slices are the rows.",
+              "description": "Which way to read the table.\n\nAbsent is `series`, one entry per data column. `categories` reads one entry\nper body row instead, for a donut, whose slices are the rows.\n\n**`measures` is `series` without the first column, and it is for a\nscatter.** That chart reads its first numeric column as the measure\n*across*, so its first plotted series is the table's second and everything\na legend beside it named was one color out: the across column wearing the\ncolor of the first series drawn, and each real series wearing the next\none's. The across gets no entry rather than a shifted one, because it is an\naxis and a scatter already writes its name at the end of the scale under\nthe plot.\n\nA legend cannot ask the chart which of these it is, `for` naming the table\nthey share and not each other, so the consumer says it. That is the same\nshape `categories` already has.",
               "fieldName": "entries",
               "inheritedFrom": {
                 "name": "HelixHeadlessLegend",
@@ -61728,13 +61907,21 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The lines take the series palette in order, so a chart of one is series one\nand a chart of four is the first four, and a legend beside it maps the same\ntwenty-four.\n\nThe stroke does not scale with the box. `preserveAspectRatio=\"none\"` is what\nlets one drawing fill a narrow card and a wide panel, and without\n`vector-effect: non-scaling-stroke` the same line comes out hairline in the\nfirst and heavy in the second. It rescues strokes and not geometry, which is\nwhy the readings are joined by lines and marked by nothing: a circle in a\nstretched coordinate space is an ellipse, and there is no vector-effect that\nanswers for a shape.",
+          "description": "The lines take the series palette in order, so a chart of one is series one\nand a chart of four is the first four, and a legend beside it maps the same\ntwenty-four.\n\nThe stroke does not scale with the box. `preserveAspectRatio=\"none\"` is what\nlets one drawing fill a narrow card and a wide panel, and without\n`vector-effect: non-scaling-stroke` the same line comes out hairline in the\nfirst and heavy in the second. It rescues strokes and not geometry, which is\nwhy nothing inside the drawing marks a reading: a circle in a stretched\ncoordinate space is an ellipse, and there is no vector-effect that answers\nfor a shape.\n\n**The last reading of each series is marked, and that is the same rule rather\nthan an exception to it.** `terminus` draws an HTML element placed over the\nplot by percentage instead of a shape inside it, so it keeps its shape at any\nwidth. It is on by default, as a dot, because the column of marks at the far\nedge is where a reader looks for \"and what is it now\".",
           "name": "HelixLineChart",
           "cssProperties": [
             {
-              "description": "Thickness of a series drawn as a line, here and on Area Chart's top edge and Bar Chart's `lines`. Each family's own width hook overrides it.",
+              "description": "Thickness of a series drawn as a line, one name across this family, Area Chart's top edge and Bar Chart's `lines`, since the three read one shared rule. Each family's own width hook overrides it.",
               "name": "--chart-stroke"
             },
+            {
+              "description": "A fill for the middle of a `ring` terminus, which is otherwise open. One name across this family and Sparkline, the two reading one shared sheet.",
+              "name": "--chart-terminus-hole"
+            },
+            {
+              "description": "Size of the mark on each series' last reading. One name across this family and Sparkline, the two reading one shared sheet.",
+              "name": "--chart-terminus-size"
+            },
             {
               "description": "How much of a line's color its wash takes.",
               "name": "--line-chart-area-opacity"
@@ -61758,6 +61945,22 @@
             {
               "description": "Thickness of a line, over `--chart-stroke`.",
               "name": "--line-chart-width"
+            },
+            {
+              "description": "Where a series' last reading sits horizontally, as a percentage. Written by the component.",
+              "name": "--chart-terminus-x",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLineChart",
+                "module": "src/line-chart/root/line-chart-root.ts"
+              }
+            },
+            {
+              "description": "Where a series' last reading sits vertically, as a percentage. Written by the component.",
+              "name": "--chart-terminus-y",
+              "inheritedFrom": {
+                "name": "HelixHeadlessLineChart",
+                "module": "src/line-chart/root/line-chart-root.ts"
+              }
             }
           ],
           "members": [
@@ -61885,6 +62088,44 @@
                 "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "plottedColumns",
+              "type": {
+                "text": "number[]"
+              },
+              "description": "Which cells of a row hold numbers, by their place in it, in table order.\n\nThe same test `readSeries` applies when it drops a column of notes: a\ncolumn is a series where any row parses, so a series survives one blank\ncell and a column of words is never one.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "seriesOf",
+              "return": {
+                "type": {
+                  "text": "number | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "cell",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "The palette slot the cell at this place in a row is drawn in.\n\n**A cell's place in its row is not its series' depth, and the tooltip\nspent a while assuming it was.** `readSeries` drops a column nothing\nparses and `readRows` keeps it, so one column of notes among the figures\nmoves every column after it one color along in the bubble: a row reading\n`Referral 1,080` wearing series three's green beside a legend that says\nseries three is something else, which is the one failure the dot exists\nto prevent.\n\nOverridden where a chart reads the table some other way. `ScatterChart`\nsplits the first plotted column off as the measure across, so its first\n*plotted* series is this table's second numeric column.",
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              },
+              "type": {
+                "text": "seriesOf(cell: number) => number | undefined"
+              }
+            },
             {
               "kind": "field",
               "name": "readings",
@@ -61974,7 +62215,7 @@
               "type": {
                 "text": "'none' | 'ring' | 'square' | 'triangle' | undefined"
               },
-              "description": "The shape of the mark on each series' last reading.\n\nAbsent is a dot, and absent rather than defaulted because a reflecting\nproperty with a default writes its attribute onto a host the consumer\nrendered, which React reports as a hydration mismatch.\n\n**One per series, in a column at the far edge**, because every series here\nshares an x-axis and therefore ends at the same reading. That column is the\nuseful thing: it is where a reader looks for \"and what is it now\", which is\nthe question a sparkline's single mark answers too.\n\n`none` lets the lines stop on their own, which suits a chart read for its\nshape rather than for where it finished. The shapes come from\n`helix/styled/src/shared/chart/terminus.css`, the same sheet `Sparkline` takes, so\nthe set is identical wherever one appears.\n\n`ring` is the one that asks something of the drawing. It leaves a hole and a\nline ends at the reading, which is the hole's center, so the `<svg>` is\nmasked with one disc per series and every stroke stops at its own ring's\ninner edge. `mask-composite: intersect` is what makes N holes out of N\nlayers; a single `mask-image` would only ever cut the last one.",
+              "description": "The shape of the mark on each series' last reading.\n\nAbsent is a dot, and absent rather than defaulted because a reflecting\nproperty with a default writes its attribute onto a host the consumer\nrendered, which React reports as a hydration mismatch.\n\n**One per series, in a column at the far edge**, because every series here\nshares an x-axis and therefore ends at the same reading. That column is the\nuseful thing: it is where a reader looks for \"and what is it now\", which is\nthe question a sparkline's single mark answers too.\n\n`none` lets the lines stop on their own, which suits a chart read for its\nshape rather than for where it finished. `square` is the same mark with its\ncorners, for a drawing whose neighbors are square, the columns of a table\nbeside it for instance. `ring` lets the ground through, for a chart drawn\nover something busy. `triangle` points along the axis and reads as \"and\nonward\" rather than as a second claim about the data.\n\nThe shapes come from\n`helix/styled/src/shared/chart/terminus.css`, the same sheet `Sparkline` takes, so\nthe set is identical wherever one appears. **Which is why every value is\nnamed here.** `Sparkline` shipped `square` implemented, drawn, asserted and\nundocumented until the cohort before this one; this family reads the same\nfour out of the same sheet and had left two of them unwritten, so the\nfinding arrived twice. A shared vocabulary wants naming at each door into\nit, because a reader arrives at one door and not at the set.\n\n`ring` is the one that asks something of the drawing. It leaves a hole and a\nline ends at the reading, which is the hole's center, so the `<svg>` is\nmasked with one disc per series and every stroke stops at its own ring's\ninner edge. `mask-composite: intersect` is what makes N holes out of N\nlayers; a single `mask-image` would only ever cut the last one.",
               "attribute": "terminus",
               "reflects": true,
               "inheritedFrom": {
@@ -62681,7 +62922,7 @@
               "type": {
                 "text": "'none' | 'ring' | 'square' | 'triangle' | undefined"
               },
-              "description": "The shape of the mark on each series' last reading.\n\nAbsent is a dot, and absent rather than defaulted because a reflecting\nproperty with a default writes its attribute onto a host the consumer\nrendered, which React reports as a hydration mismatch.\n\n**One per series, in a column at the far edge**, because every series here\nshares an x-axis and therefore ends at the same reading. That column is the\nuseful thing: it is where a reader looks for \"and what is it now\", which is\nthe question a sparkline's single mark answers too.\n\n`none` lets the lines stop on their own, which suits a chart read for its\nshape rather than for where it finished. The shapes come from\n`helix/styled/src/shared/chart/terminus.css`, the same sheet `Sparkline` takes, so\nthe set is identical wherever one appears.\n\n`ring` is the one that asks something of the drawing. It leaves a hole and a\nline ends at the reading, which is the hole's center, so the `<svg>` is\nmasked with one disc per series and every stroke stops at its own ring's\ninner edge. `mask-composite: intersect` is what makes N holes out of N\nlayers; a single `mask-image` would only ever cut the last one.",
+              "description": "The shape of the mark on each series' last reading.\n\nAbsent is a dot, and absent rather than defaulted because a reflecting\nproperty with a default writes its attribute onto a host the consumer\nrendered, which React reports as a hydration mismatch.\n\n**One per series, in a column at the far edge**, because every series here\nshares an x-axis and therefore ends at the same reading. That column is the\nuseful thing: it is where a reader looks for \"and what is it now\", which is\nthe question a sparkline's single mark answers too.\n\n`none` lets the lines stop on their own, which suits a chart read for its\nshape rather than for where it finished. `square` is the same mark with its\ncorners, for a drawing whose neighbors are square, the columns of a table\nbeside it for instance. `ring` lets the ground through, for a chart drawn\nover something busy. `triangle` points along the axis and reads as \"and\nonward\" rather than as a second claim about the data.\n\nThe shapes come from\n`helix/styled/src/shared/chart/terminus.css`, the same sheet `Sparkline` takes, so\nthe set is identical wherever one appears. **Which is why every value is\nnamed here.** `Sparkline` shipped `square` implemented, drawn, asserted and\nundocumented until the cohort before this one; this family reads the same\nfour out of the same sheet and had left two of them unwritten, so the\nfinding arrived twice. A shared vocabulary wants naming at each door into\nit, because a reader arrives at one door and not at the set.\n\n`ring` is the one that asks something of the drawing. It leaves a hole and a\nline ends at the reading, which is the hole's center, so the `<svg>` is\nmasked with one disc per series and every stroke stops at its own ring's\ninner edge. `mask-composite: intersect` is what makes N holes out of N\nlayers; a single `mask-image` would only ever cut the last one.",
               "fieldName": "terminus",
               "inheritedFrom": {
                 "name": "HelixHeadlessLineChart",
@@ -62710,7 +62951,7 @@
           "helix": {
             "category": "charts",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/line-chart",
             "aliases": [
               "Time Series",
@@ -62734,7 +62975,7 @@
                 "slug": "area"
               },
               {
-                "description": "The three curves over one series: joined, smoothed, and held until the next reading.",
+                "description": "The three curves over one series: joined straight, smoothed, and held until the next reading. The smoothed one is what an absent `curve` draws.",
                 "slug": "curves"
               },
               {
@@ -95836,7 +96077,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The points take the series palette in order, so a table with one column\nmeasured up is series one and a table with three is the first three.\n\nEach point has a ring of the page around it and stops short of opaque, so a\ndense cluster reads as dense rather than as one blot, and two points that\noverlap each keep their edge.",
+          "description": "The points take the series palette in order, so a table with one column\nmeasured up is series one and a table with three is the first three.\n\nEach point has a ring of the page around it and stops short of opaque, so a\ndense cluster reads as dense rather than as one blot, and two points that\noverlap each keep their edge.\n\n**No visual axis applies here, and that is the answer rather than a gap.**\nBoth refusals come out of that sentence, and both were argued in the\nstylesheet before they were argued anywhere a reader looks.\n\n`emphasis` is how much ink a mark claims, and on a scatter that channel is\nalready carrying data. The points rest at 0.8 so that where they pile up they\ncompound: how dark a region is *is* how many rows are in it, which is most of\nwhat a reader is looking at a scatter to see and is the one thing a table of\nthe same numbers hides. `solid` flattens a dense cluster and a sparse one into\nthe same picture; `outlined` replaces the pile with overlapping rings, which\nreads as texture rather than as count. An axis whose two ends each cost the\ndrawing its density is not a treatment, it is a second meaning for a property\nthe chart already spends.\n\n`material` is the same refusal said once more. Translucency is the density\nchannel here, so `glass` and `frosted` are two more named stops on a scale\nthe data is using, and a point admitting the page through is a point that\ncounts for less than one.\n\nWhat stays adjustable is `--scatter-chart-point-opacity`, and it is a\ncontinuum rather than an axis: a chart drawn over a busier ground wants a\ndifferent resting density, and that is a fact about the ground rather than a\nclaim about the points.",
           "name": "HelixScatterChart",
           "cssProperties": [
             {
@@ -95993,6 +96234,44 @@
                 "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "plottedColumns",
+              "type": {
+                "text": "number[]"
+              },
+              "description": "Which cells of a row hold numbers, by their place in it, in table order.\n\nThe same test `readSeries` applies when it drops a column of notes: a\ncolumn is a series where any row parses, so a series survives one blank\ncell and a column of words is never one.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "seriesOf",
+              "return": {
+                "type": {
+                  "text": "number | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "cell",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "The palette slot the cell at this place in a row is drawn in.\n\n**A cell's place in its row is not its series' depth, and the tooltip\nspent a while assuming it was.** `readSeries` drops a column nothing\nparses and `readRows` keeps it, so one column of notes among the figures\nmoves every column after it one color along in the bubble: a row reading\n`Referral 1,080` wearing series three's green beside a legend that says\nseries three is something else, which is the one failure the dot exists\nto prevent.\n\nOverridden where a chart reads the table some other way. `ScatterChart`\nsplits the first plotted column off as the measure across, so its first\n*plotted* series is this table's second numeric column.",
+              "inheritedFrom": {
+                "name": "MixinChartSource",
+                "module": "src/mixins/mixin-chart-source/mixin-chart-source.ts"
+              },
+              "type": {
+                "text": "seriesOf(cell: number) => number | undefined"
+              }
+            },
             {
               "kind": "field",
               "name": "readings",
@@ -96530,7 +96809,7 @@
           "helix": {
             "category": "charts",
             "since": "0.1.0",
-            "status": "experimental",
+            "status": "stable",
             "documentation": "https://fusion.dev/helix/components/scatter-chart",
             "aliases": [
               "Scatter Plot",
@@ -96550,10 +96829,20 @@
                 "min": 300,
                 "slug": "preview"
               },
+              {
+                "description": "Forty units, where the points pile up. A cluster reads darker because each point stops short of opaque, which is what `--scatter-chart-point-opacity` is for.",
+                "min": 300,
+                "slug": "dense"
+              },
               {
                 "description": "Two latencies against one load, each a series, from one table with three numeric columns.",
                 "min": 300,
                 "slug": "several-series"
+              },
+              {
+                "description": "A key beside two series, reading `measures` so the column measured across gets no swatch.",
+                "min": 300,
+                "slug": "with-a-legend"
               }
             ],
             "source": "helix/styled/src/scatter-chart"