enarratio-astro 0.4.2 → 0.4.3

package/CHANGELOG.md

@@ -7,6 +7,18 @@ every such change is listed here.
 
 ## [Unreleased]
 
+## [0.4.3] - 2026-11-07
+
+### Changed
+
+- The `astro` peer dependency is `>=6` (was exactly `7.4.4`), as the README says. A site on any supported Astro version now installs
+  without a peer conflict; the version tested here stays pinned in the repository's dev dependencies.
+
+### Removed
+
+- `parseChartBlock` is no longer exported from `enarratio-astro/markdown`. It was undocumented; use the
+  `remarkCharts` or `satteriCharts` plugin instead.
+
 ## [0.4.2] - 2026-11-03
 
 ### Changed

package/README.md

@@ -36,6 +36,7 @@ const downloads = [
   { year: 2026, package: "Plugin", downloads: 2800 },
 ];
 ---
+
 <Chart
   type="line"
   data={downloads}
@@ -57,7 +58,7 @@ columns. The chart CSS is written once per page, however many charts it has.
 A code block whose language is `chart` becomes a chart: options, a line of three dashes, then the
 data.
 
-~~~md
+````md
 ```chart
 type: bar
 x: team
@@ -72,7 +73,7 @@ Support,Closed,22
 Platform,Open,5
 Platform,Closed,31
 ```
-~~~
+````
 
 Register the plugin for Astro's Markdown processor. Astro 7's default, Sätteri:
 
@@ -102,28 +103,28 @@ interactive chart on the page and works with view transitions.
 
 The component's props and a Markdown block's keys are the same:
 
-| Option | Used by | Notes |
-|---|---|---|
-| `type` | all | `bar` (default), `line`, `area` (stacked), `scatter` or `heatmap`. |
-| `data` | all | The data (component only; in Markdown it follows the dashes). Up to 5000 rows and 50 columns. |
-| `alt` | all | **Required.** What the chart shows and finds, in a sentence. It names the chart for screen readers. |
-| `title`, `subtitle` | all | Optional. Shown above the chart. |
-| `caption`, `notes` | all | Optional. The caption, under the chart, is for method or caveats; notes are a smaller line for definitions. |
-| `source`, `sourceHref` | all | Optional. Where the data came from, linked when `sourceHref` is set, beside a CSV download of the data. |
-| `byline` | all | Optional. Who made the chart. |
-| `x` | all | The column along the x axis. Column names match without regard to case. ISO dates make a time axis in line and area charts. |
-| `y` | all | The value column. Bar charts count rows when it is missing. For a heatmap, the row column. |
-| `series` | bar, line, area, scatter | Splits rows into series, told apart by color and by legend, labels or symbols. |
-| `value` | heatmap | The cell value column. |
-| `xLabel`, `yLabel` | all | Axis labels. |
-| `xUnit`, `yUnit` | all | Optional. The unit, shown after the axis label (`Sales (units)`) and in the table and summary. |
-| `layout` | bar | `stacked` (default) or `grouped`. |
-| `orientation` | bar | `vertical` (default) or `horizontal`. |
-| `scale` | line, scatter | `linear` (default) or `log`. |
-| `regression` | scatter | A least-squares line with its 95% band. |
-| `dataTable` | all | `details` (default; behind a "Data table" toggle) or `visually-hidden` (screen readers only). |
-| `id` | all | The figure's id. |
-| `interactive` | all | Adds the enhancement script. Off by default, so pages stay script-free. |
+| Option                 | Used by                  | Notes                                                                                                                       |
+| ---------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
+| `type`                 | all                      | `bar` (default), `line`, `area` (stacked), `scatter` or `heatmap`.                                                          |
+| `data`                 | all                      | The data (component only; in Markdown it follows the dashes). Up to 5000 rows and 50 columns.                               |
+| `alt`                  | all                      | **Required.** What the chart shows and finds, in a sentence. It names the chart for screen readers.                         |
+| `title`, `subtitle`    | all                      | Optional. Shown above the chart.                                                                                            |
+| `caption`, `notes`     | all                      | Optional. The caption, under the chart, is for method or caveats; notes are a smaller line for definitions.                 |
+| `source`, `sourceHref` | all                      | Optional. Where the data came from, linked when `sourceHref` is set, beside a CSV download of the data.                     |
+| `byline`               | all                      | Optional. Who made the chart.                                                                                               |
+| `x`                    | all                      | The column along the x axis. Column names match without regard to case. ISO dates make a time axis in line and area charts. |
+| `y`                    | all                      | The value column. Bar charts count rows when it is missing. For a heatmap, the row column.                                  |
+| `series`               | bar, line, area, scatter | Splits rows into series, told apart by color and by legend, labels or symbols.                                              |
+| `value`                | heatmap                  | The cell value column.                                                                                                      |
+| `xLabel`, `yLabel`     | all                      | Axis labels.                                                                                                                |
+| `xUnit`, `yUnit`       | all                      | Optional. The unit, shown after the axis label (`Sales (units)`) and in the table and summary.                              |
+| `layout`               | bar                      | `stacked` (default) or `grouped`.                                                                                           |
+| `orientation`          | bar                      | `vertical` (default) or `horizontal`.                                                                                       |
+| `scale`                | line, scatter            | `linear` (default) or `log`.                                                                                                |
+| `regression`           | scatter                  | A least-squares line with its 95% band.                                                                                     |
+| `dataTable`            | all                      | `details` (default; behind a "Data table" toggle) or `visually-hidden` (screen readers only).                               |
+| `id`                   | all                      | The figure's id.                                                                                                            |
+| `interactive`          | all                      | Adds the enhancement script. Off by default, so pages stay script-free.                                                     |
 
 A chart that cannot be drawn (a column that is not in the data, text in a number column, a missing
 `alt`) is replaced by a short note saying why, and the reason is logged, so one mistake never

package/dist/data.d.ts

@@ -5,9 +5,6 @@ export interface Table {
     readonly columns: readonly string[];
     readonly rows: ReadonlyArray<Readonly<Record<string, Cell>>>;
 }
-/** Limits that keep one chart's render bounded, whatever an editor pastes. */
-export declare const MAX_ROWS = 5000;
-export declare const MAX_COLUMNS = 50;
 /**
  * Parses the data an editor pasted or typed: CSV, semicolon-separated or tab-separated text
  * whose first row names the columns. Throws an Error whose message an editor can act on.

package/dist/data.js

@@ -1,6 +1,6 @@
 /** Limits that keep one chart's render bounded, whatever an editor pastes. */
-export const MAX_ROWS = 5000;
-export const MAX_COLUMNS = 50;
+const MAX_ROWS = 5000;
+const MAX_COLUMNS = 50;
 const NUMBER = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i;
 const GROUPED_NUMBER = /^[+-]?\d{1,3}(?:,\d{3})+(?:\.\d+)?$/;
 /** Reads a cell: numbers (including "1,234") become numbers, an empty cell `null`, the rest text. */

package/dist/markdown.d.ts

@@ -1,23 +1,6 @@
-import { type ChartSpec } from "./chart.js";
 import { type StyleOptions } from "./styles.js";
 /** Options for the Markdown plugins: how charts are styled. */
 export type MarkdownChartOptions = StyleOptions;
-/**
- * Reads a `chart` code block: `key: value` lines, a line of three dashes, then the data.
- *
- * ```chart
- * type: line
- * x: month
- * y: visitors
- * alt: Monthly visitors rise from 820 to 1,190.
- * ---
- * month,visitors
- * 2026-01-01,820
- * ```
- */
-export declare function parseChartBlock(source: string): ChartSpec & {
-    readonly interactive: boolean;
-};
 /** The parts of a Markdown code node the plugins read. */
 interface CodeNode {
     readonly type: "code";

package/dist/markdown.js

@@ -41,7 +41,7 @@ const KEYS = new Set([
  * 2026-01-01,820
  * ```
  */
-export function parseChartBlock(source) {
+function parseChartBlock(source) {
     const lines = source.split(/\r?\n/);
     const rule = lines.findIndex((line) => line.trim() === "---");
     if (rule === -1)

package/package.json

@@ -1,27 +1,33 @@
 {
   "name": "enarratio-astro",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Accessible charts for Astro: a Chart component and charts in Markdown, drawn on the server by Enarratio",
   "keywords": [
+    "accessibility",
     "astro",
     "astro-component",
-    "withastro",
     "charts",
-    "accessibility",
+    "enarratio",
     "markdown",
-    "enarratio"
+    "withastro"
   ],
   "homepage": "https://github.com/DrDustinEdwards/astro/tree/main/packages/enarratio-astro#readme",
   "bugs": {
     "url": "https://github.com/DrDustinEdwards/astro/issues"
   },
+  "license": "MIT",
+  "author": "Dustin Edwards (https://dustinedwards.info)",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/DrDustinEdwards/astro.git",
     "directory": "packages/enarratio-astro"
   },
-  "license": "MIT",
-  "author": "Dustin Edwards (https://dustinedwards.info)",
+  "files": [
+    "dist",
+    "src",
+    "CHANGELOG.md",
+    "README.md"
+  ],
   "type": "module",
   "sideEffects": false,
   "exports": {
@@ -37,30 +43,24 @@
     "./Enhance.astro": "./src/Enhance.astro",
     "./package.json": "./package.json"
   },
-  "files": [
-    "dist",
-    "src",
-    "CHANGELOG.md",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=22.22"
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "test": "vitest run",
     "prepare": "npm run build"
   },
-  "peerDependencies": {
-    "astro": "7.4.4"
-  },
   "dependencies": {
     "@observablehq/plot": "0.6.17",
     "enarratio": "0.7.3",
     "linkedom": "0.18.14"
   },
-  "publishConfig": {
-    "access": "public",
-    "tag": "latest"
+  "peerDependencies": {
+    "astro": ">=6"
+  },
+  "engines": {
+    "node": ">=22.22"
   }
 }

package/src/Enhance.astro

@@ -11,7 +11,9 @@
   import { enhance } from "enarratio/enhance";
 
   function run() {
-    for (const chart of document.querySelectorAll<HTMLElement>("[data-enarratio-interactive-chart]")) {
+    for (const chart of document.querySelectorAll<HTMLElement>(
+      "[data-enarratio-interactive-chart]",
+    )) {
       enhance(chart);
     }
   }

package/src/chart.ts

@@ -141,9 +141,8 @@ async function draw(spec: ChartSpec, options: RenderOptions): Promise<string> {
   const log = spec.scale === "log" ? ({ yType: "log" } as const) : {};
 
   // Enarratio types its field options by the row type; parsed rows are only known at run time,
-  // so the options are checked here and passed on as plain objects.
-  // biome-ignore lint/suspicious/noExplicitAny: see above
-  type Loose = any;
+  // so every row is a record of cells and the columns are checked here.
+  type Loose = Record<string, Cell>;
 
   switch (type as ChartType) {
     case "bar": {

package/src/data.ts

@@ -8,8 +8,8 @@ export interface Table {
 }
 
 /** Limits that keep one chart's render bounded, whatever an editor pastes. */
-export const MAX_ROWS = 5000;
-export const MAX_COLUMNS = 50;
+const MAX_ROWS = 5000;
+const MAX_COLUMNS = 50;
 
 const NUMBER = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i;
 const GROUPED_NUMBER = /^[+-]?\d{1,3}(?:,\d{3})+(?:\.\d+)?$/;

package/src/markdown.ts

@@ -46,7 +46,7 @@ const KEYS = new Set([
  * 2026-01-01,820
  * ```
  */
-export function parseChartBlock(source: string): ChartSpec & { readonly interactive: boolean } {
+function parseChartBlock(source: string): ChartSpec & { readonly interactive: boolean } {
   const lines = source.split(/\r?\n/);
   const rule = lines.findIndex((line) => line.trim() === "---");
   if (rule === -1)