@fusion.dev/helix-docs 0.194.0 → 0.196.0

package/content/charting.mdx

@@ -12,11 +12,11 @@ Helix has these chart families, and each one has its own API page:
 - `Line Chart`
 - `Area Chart`
 - `Scatter Chart`
-- `Spatial Scatter Chart`, drawn in three dimensions by `@fusion.dev/helix-plot`
-- `Spatial Surface Chart`, drawn in three dimensions by `@fusion.dev/helix-plot`
+- `Spatial Scatter Chart`, drawn in three dimensions
+- `Spatial Surface Chart`, drawn in three dimensions
 - `Donut Chart`
 - `Heatmap`
-- `Spatial Heatmap`
+- `Spatial Heatmap`, drawn in three dimensions
 - `Sparkline`
 - `Trend`
 - `Legend`, which all of the charts share
@@ -40,20 +40,14 @@ Choose a chart by the question it answers.
   overlaps the series, and `Area Chart` adds them.
 - **Parts of one whole, at one moment.** `Donut Chart`.
 - **Whether two measures relate.** `Scatter Chart`, with one point per row.
-- **Where rows fall on three measures, and which gather together.** `Scatter
-  3D`, with one point per row in a box you can turn. Use it for data that has
-  three dimensions, such as clusters or embeddings. Its table and its flat
-  scatter carry the exact values.
-- **How one measure rises and falls over two others.** `Spatial Surface Chart`, with one
-  row per place on a grid, drawn as a surface you can turn. Use it for a measure
-  over two ranges, such as load by hour and by day. Its table carries the exact
-  values.
-
-The spatial charts and `Spatial Heatmap` draw themselves in 3D in SVG, which a
-server, a print, and a page without WebGL all show. Shift with an arrow turns
-the spatial charts' drawing. `@fusion.dev/helix-plot` draws all three with
-three.js instead, lit and in perspective, in a view you can drag round and
-zoom.
+- **Where rows fall on three measures, and which gather together.** `Spatial
+  Scatter Chart`, with one point per row in a box you can turn. Use it for data
+  that has three dimensions, such as clusters or embeddings. Its table and its
+  tooltip carry the exact values.
+- **How one measure rises and falls over two others.** `Spatial Surface Chart`,
+  with one row per place on a grid, drawn as a surface you can turn. Use it for
+  a measure over two ranges, such as load by hour and by day. Its table carries
+  the exact values.
 - **How each day or check went.** `Heatmap`, for uptime, contributions, or
   activity.
 - **The same days, as a relief.** `Spatial Heatmap` reads the same table as
@@ -65,6 +59,12 @@ zoom.
   Use `Trend` to show which way one measurement moved and whether that is good
   news.
 
+The three spatial charts draw themselves in 3D in SVG, which a
+print and a page without WebGL show too, and a drag or Shift with an arrow
+turns. `@fusion.dev/helix-plot` can also draw all three with three.js, lit and
+in perspective, in a view you can drag round and zoom. The
+[spatial charts guide](./spatial-charts) covers both.
+
 ## Charts read their data from a table
 
 ```html
@@ -127,8 +127,11 @@ reading a chart is usually read for:
 - `Donut Chart`: each slice's share of the whole.
 - `Scatter Chart`: each series' number of points and how strongly the two
   measures relate.
+- `Spatial Scatter Chart`: its three measures and its number of points.
+- `Spatial Surface Chart`: its measures, its number of readings, and the range
+  of its heights.
 
-`Heatmap` is an image with that name. `Sparkline` takes a `label` of its own.
+`Heatmap` and `Spatial Heatmap` are each an image with that name. `Sparkline` takes a `label` of its own.
 
 ## Tables that change
 
@@ -184,6 +187,8 @@ These parts change direction:
   right
 - `Line Chart`, `Area Chart`, and `Sparkline`, with their end marks
 - `Heatmap`'s weeks, which were already a grid laid out along the line
+- `Spatial Heatmap`'s weeks in its SVG drawing. A three.js drawing keeps its
+  direction, and the chart's labels follow it.
 - A half `Donut Chart`, which is read across
 
 These parts keep their direction:
@@ -197,6 +202,9 @@ These parts keep their direction:
   number line runs that way in every script. Its axis names read in their own
   direction, so a name in Arabic reads right to left under the far end of the
   plot. Its summary and tooltip follow the page's direction.
+- `Spatial Scatter Chart` and `Spatial Surface Chart` are laid out as on a
+  left-to-right page, because all three of their axes are measures. Their
+  summaries and tooltips follow the page's direction.
 
 To keep a chart left to right on a right-to-left page, such as a number line in
 a mathematics text, set `dir="ltr"` on the chart element. You need nothing else.

package/content/introduction.mdx

@@ -64,6 +64,7 @@ each framework.
 | `@fusion.dev/helix-icons` | You are drawing an icon outside a component |
 | `@fusion.dev/helix-map` | You are drawing a map with MapLibre, Leaflet, or a renderer of your own. See [Maps](./maps) |
 | `@fusion.dev/helix-graph` | You are drawing a graph with Sigma.js, cosmos.gl, three.js, or a renderer of your own. See [Graphs](./graphs) |
+| `@fusion.dev/helix-plot` | You are drawing a spatial chart with three.js. See [Spatial charts](./spatial-charts) |
 | `@fusion.dev/helix-core` | You are building a new Helix component |
 
 React uses the elements directly. Helix ships a `jsx.d.ts` that types every