@howells/hairline 0.0.0-stage → 0.2.0

package/lib/json-schema/rung-bars.json

@@ -0,0 +1,230 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "note": {
+      "deprecated": true,
+      "description": "Deprecated: use `unitNote`.",
+      "type": "string"
+    },
+    "unitNote": {
+      "description": "The in-plot key under the axis.",
+      "type": "string"
+    },
+    "animate": {
+      "description": "When the entry draws in: \"scroll\" as the chart scrolls into view, \"mount\" at once, \"off\" never (drawn, and ready, in the first HTML). The default is \"off\" for a fixed-size chart and \"scroll\" for a responsive one. Under reduced motion the chart is drawn in the first paint.",
+      "type": "string",
+      "enum": [
+        "scroll",
+        "mount",
+        "off"
+      ]
+    },
+    "replayKey": {
+      "description": "Change it to replay the entry without remounting the chart.",
+      "type": [
+        "string",
+        "number"
+      ]
+    },
+    "fit": {
+      "description": "Fill the container's width at the chart's aspect ratio. Wins over `scale`.",
+      "type": "boolean"
+    },
+    "scale": {
+      "description": "Slides: draw at the logical width, then show the composition this many times larger, type and textures with it.",
+      "type": "number",
+      "exclusiveMinimum": 0
+    },
+    "strokes": {
+      "description": "\"device\" keeps every stroke at one device pixel, and is the default when the chart is scaled (`scale` or `fit`); \"proportional\" scales strokes with the composition. It acts on stroked geometry only (rules, lines, rings, outlines): filled marks, such as the bars of RungBars, scale either way.",
+      "type": "string",
+      "enum": [
+        "proportional",
+        "device"
+      ]
+    },
+    "idPrefix": {
+      "description": "Leads every SVG id, to separate charts rendered in separate React roots on one page.",
+      "type": "string",
+      "pattern": "^[A-Za-z][\\w-]*$"
+    },
+    "metrics": {
+      "description": "Glyph widths of a face other than Inter, so notes wrap and reserve room for it.",
+      "type": "object",
+      "properties": {
+        "advances": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1
+          },
+          "additionalProperties": {
+            "type": "number",
+            "exclusiveMinimum": 0
+          }
+        },
+        "fallback": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "tabular": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        }
+      },
+      "required": [
+        "advances",
+        "fallback"
+      ],
+      "additionalProperties": false
+    },
+    "table": {
+      "description": "Show the data table to sighted readers too. It is always there for screen readers.",
+      "type": "boolean"
+    },
+    "title": {
+      "description": "The chart's accessible name. Each chart has a default that reads the data.",
+      "type": "string",
+      "minLength": 1
+    },
+    "data": {
+      "minItems": 1,
+      "maxItems": 24,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "description": "A unique key, for when two bars share a label.",
+            "type": "string",
+            "minLength": 1
+          },
+          "label": {
+            "type": "string",
+            "description": "Names the bar, and is its key unless `id` is given."
+          },
+          "value": {
+            "type": "number",
+            "description": "The bar's value, counted off in rungs of `unit`."
+          }
+        },
+        "required": [
+          "label",
+          "value"
+        ],
+        "additionalProperties": false
+      },
+      "description": "The bars, 1 to 24."
+    },
+    "emphasis": {
+      "description": "The bar to draw in the hero colour, by key. Defaults to the largest.",
+      "type": "string"
+    },
+    "format": {
+      "description": "How values print: a preset name or Intl number-format options.",
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "integer",
+            "decimal",
+            "compact",
+            "percent"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "compactDisplay": {
+              "type": "string",
+              "enum": [
+                "short",
+                "long"
+              ]
+            },
+            "currency": {
+              "type": "string",
+              "minLength": 3,
+              "maxLength": 3
+            },
+            "locale": {
+              "type": "string",
+              "minLength": 2
+            },
+            "maximumFractionDigits": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 20
+            },
+            "minimumFractionDigits": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 20
+            },
+            "notation": {
+              "type": "string",
+              "enum": [
+                "standard",
+                "compact"
+              ]
+            },
+            "signDisplay": {
+              "type": "string",
+              "enum": [
+                "auto",
+                "always",
+                "exceptZero",
+                "never"
+              ]
+            },
+            "style": {
+              "type": "string",
+              "enum": [
+                "decimal",
+                "percent",
+                "currency",
+                "unit"
+              ]
+            },
+            "unit": {
+              "type": "string"
+            },
+            "useGrouping": {
+              "type": "boolean"
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
+    "height": {
+      "description": "Fixed height in px. Without it a bar chart is 460 tall.",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "initialWidth": {
+      "description": "Responsive mode only: the width of the first render, before measuring.",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "unit": {
+      "description": "Units per rung.",
+      "type": "number",
+      "exclusiveMinimum": 0
+    },
+    "width": {
+      "description": "Fixed width in px. Giving it turns measuring off.",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    }
+  },
+  "required": [
+    "data"
+  ],
+  "additionalProperties": false
+}

package/lib/json-schema/slope.json

@@ -0,0 +1,333 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "animate": {
+      "description": "When the entry draws in: \"scroll\" as the chart scrolls into view, \"mount\" at once, \"off\" never (drawn, and ready, in the first HTML). The default is \"off\" for a fixed-size chart and \"scroll\" for a responsive one. Under reduced motion the chart is drawn in the first paint.",
+      "type": "string",
+      "enum": [
+        "scroll",
+        "mount",
+        "off"
+      ]
+    },
+    "replayKey": {
+      "description": "Change it to replay the entry without remounting the chart.",
+      "type": [
+        "string",
+        "number"
+      ]
+    },
+    "fit": {
+      "description": "Fill the container's width at the chart's aspect ratio. Wins over `scale`.",
+      "type": "boolean"
+    },
+    "scale": {
+      "description": "Slides: draw at the logical width, then show the composition this many times larger, type and textures with it.",
+      "type": "number",
+      "exclusiveMinimum": 0
+    },
+    "strokes": {
+      "description": "\"device\" keeps every stroke at one device pixel, and is the default when the chart is scaled (`scale` or `fit`); \"proportional\" scales strokes with the composition. It acts on stroked geometry only (rules, lines, rings, outlines): filled marks, such as the bars of RungBars, scale either way.",
+      "type": "string",
+      "enum": [
+        "proportional",
+        "device"
+      ]
+    },
+    "idPrefix": {
+      "description": "Leads every SVG id, to separate charts rendered in separate React roots on one page.",
+      "type": "string",
+      "pattern": "^[A-Za-z][\\w-]*$"
+    },
+    "metrics": {
+      "description": "Glyph widths of a face other than Inter, so notes wrap and reserve room for it.",
+      "type": "object",
+      "properties": {
+        "advances": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1
+          },
+          "additionalProperties": {
+            "type": "number",
+            "exclusiveMinimum": 0
+          }
+        },
+        "fallback": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "tabular": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        }
+      },
+      "required": [
+        "advances",
+        "fallback"
+      ],
+      "additionalProperties": false
+    },
+    "table": {
+      "description": "Show the data table to sighted readers too. It is always there for screen readers.",
+      "type": "boolean"
+    },
+    "title": {
+      "description": "The chart's accessible name. Each chart has a default that reads the data.",
+      "type": "string",
+      "minLength": 1
+    },
+    "domain": {
+      "description": "The y range as [lowest, highest]. Defaults to the extent of the rows.",
+      "type": "array",
+      "prefixItems": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "number"
+        }
+      ],
+      "items": false,
+      "minItems": 2,
+      "maxItems": 2
+    },
+    "emphasis": {
+      "description": "The row to draw in the hero colour, by key. Defaults to the biggest fall.",
+      "type": "string"
+    },
+    "format": {
+      "description": "How values print: a preset name or Intl number-format options.",
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "integer",
+            "decimal",
+            "compact",
+            "percent"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "compactDisplay": {
+              "type": "string",
+              "enum": [
+                "short",
+                "long"
+              ]
+            },
+            "currency": {
+              "type": "string",
+              "minLength": 3,
+              "maxLength": 3
+            },
+            "locale": {
+              "type": "string",
+              "minLength": 2
+            },
+            "maximumFractionDigits": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 20
+            },
+            "minimumFractionDigits": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 20
+            },
+            "notation": {
+              "type": "string",
+              "enum": [
+                "standard",
+                "compact"
+              ]
+            },
+            "signDisplay": {
+              "type": "string",
+              "enum": [
+                "auto",
+                "always",
+                "exceptZero",
+                "never"
+              ]
+            },
+            "style": {
+              "type": "string",
+              "enum": [
+                "decimal",
+                "percent",
+                "currency",
+                "unit"
+              ]
+            },
+            "unit": {
+              "type": "string"
+            },
+            "useGrouping": {
+              "type": "boolean"
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
+    "height": {
+      "description": "Fixed height in px. Without it a slope chart is 420 tall.",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "initialWidth": {
+      "description": "Responsive mode only: the width of the first render, before measuring.",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "label": {
+      "description": "The accessible name. Defaults to a reading of the rows.",
+      "type": "string"
+    },
+    "labels": {
+      "type": "array",
+      "prefixItems": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "string"
+        }
+      ],
+      "items": false,
+      "minItems": 2,
+      "maxItems": 2,
+      "description": "Names the two points, left then right, e.g. [\"Jan 2023\", \"Dec 2024\"]."
+    },
+    "narrowFormat": {
+      "description": "The same on a phone (under 520px wide), where a unit would crowd the columns.",
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "integer",
+            "decimal",
+            "compact",
+            "percent"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "compactDisplay": {
+              "type": "string",
+              "enum": [
+                "short",
+                "long"
+              ]
+            },
+            "currency": {
+              "type": "string",
+              "minLength": 3,
+              "maxLength": 3
+            },
+            "locale": {
+              "type": "string",
+              "minLength": 2
+            },
+            "maximumFractionDigits": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 20
+            },
+            "minimumFractionDigits": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 20
+            },
+            "notation": {
+              "type": "string",
+              "enum": [
+                "standard",
+                "compact"
+              ]
+            },
+            "signDisplay": {
+              "type": "string",
+              "enum": [
+                "auto",
+                "always",
+                "exceptZero",
+                "never"
+              ]
+            },
+            "style": {
+              "type": "string",
+              "enum": [
+                "decimal",
+                "percent",
+                "currency",
+                "unit"
+              ]
+            },
+            "unit": {
+              "type": "string"
+            },
+            "useGrouping": {
+              "type": "boolean"
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
+    "rows": {
+      "minItems": 1,
+      "maxItems": 12,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "from": {
+            "type": "number",
+            "description": "The value at the left point."
+          },
+          "id": {
+            "description": "A unique key, for when two rows share a name.",
+            "type": "string",
+            "minLength": 1
+          },
+          "name": {
+            "type": "string",
+            "description": "Names the row, and is its key unless `id` is given."
+          },
+          "to": {
+            "type": "number",
+            "description": "The value at the right point."
+          }
+        },
+        "required": [
+          "from",
+          "name",
+          "to"
+        ],
+        "additionalProperties": false
+      },
+      "description": "The rows, 1 to 12."
+    },
+    "width": {
+      "description": "Fixed width in px. Giving it turns measuring off.",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    }
+  },
+  "required": [
+    "labels",
+    "rows"
+  ],
+  "additionalProperties": false
+}

package/lib/kit.js

@@ -0,0 +1,16 @@
+"use client";
+import { IdScope as e, useEntry as t, useHover as n, useMeasure as r, useMotionPreference as i, useReducedMotion as a, useReveal as o, useScrub as s, useSvgId as c } from "./charts/hooks.js";
+import { Chart as l, Plot as u, SplitClips as d, Tooltip as f } from "./charts/core.js";
+import { DimGroup as p, HitCircle as m, HitPath as h, HitRect as g, TipText as _ } from "./charts/hover.js";
+import { crisp as v, phase as y } from "./charts/axes.js";
+import { DOT as b, KEY as x, LABEL_TICK as S, MARK_WEIGHT as C, RING_STEP as w, RING_WEIGHT as T, STEM as E, TICK as D } from "./charts/marks.js";
+import { Bar as O, Dot as k, Ring as A } from "./charts/markers.js";
+import { FootNote as j, PlotNote as M } from "./charts/plot-note.js";
+import { Cursor as N, HGrid as P, HRule as F, Stem as I, Tick as L, VGrid as R, VRule as z } from "./charts/rules.js";
+import { ChartSvg as B } from "./charts/svg.js";
+import { Label as V, XLabels as H } from "./charts/text.js";
+import { HALFTONE_R as U, TEXTURE_PITCH as W, paint as G, useTextureIds as K } from "./charts/texture-ids.js";
+import { Beads as q, CrossHatch as J, DotRing as Y, DotScreen as X, DottedLine as Z, DottedPath as Q, EngravedRect as $, Hatch as ee, KeySwatch as te, PixelLine as ne, PlateLabel as re, Rules as ie, Stipple as ae } from "./charts/texture.js";
+import { DURATION as oe, easeTravel as se } from "./charts/motion.js";
+import { FILL_FAMILIES as ce, FILL_LADDERS as le, FILL_TONES as ue, toneClass as de } from "./charts/fills.js";
+export { O as Bar, q as Beads, l as Chart, B as ChartSvg, J as CrossHatch, N as Cursor, b as DOT, oe as DURATION, p as DimGroup, k as Dot, Y as DotRing, X as DotScreen, Z as DottedLine, Q as DottedPath, $ as EngravedRect, ce as FILL_FAMILIES, le as FILL_LADDERS, ue as FILL_TONES, j as FootNote, U as HALFTONE_R, P as HGrid, F as HRule, ee as Hatch, m as HitCircle, h as HitPath, g as HitRect, e as IdScope, x as KEY, te as KeySwatch, S as LABEL_TICK, V as Label, C as MARK_WEIGHT, ne as PixelLine, re as PlateLabel, u as Plot, M as PlotNote, w as RING_STEP, T as RING_WEIGHT, A as Ring, ie as Rules, E as STEM, d as SplitClips, I as Stem, ae as Stipple, W as TEXTURE_PITCH, D as TICK, L as Tick, _ as TipText, f as Tooltip, R as VGrid, z as VRule, H as XLabels, v as crisp, se as easeTravel, G as paint, y as phase, de as toneClass, t as useEntry, n as useHover, r as useMeasure, i as useMotionPreference, a as useReducedMotion, o as useReveal, s as useScrub, c as useSvgId, K as useTextureIds };

package/lib/lib/format.js

@@ -0,0 +1,29 @@
+"use client";
+import { format as e, precisionFixed as t } from "d3-format";
+import { utcFormat as n } from "d3-time-format";
+//#region src/lib/format.ts
+var r = e(",.0f"), i = (t) => e(`,.${t}f`), a = 6, o = (e, t, n) => e.every((e) => Math.abs(Number(e.toFixed(t)) - e) <= n * 1e-9), s = (e, n, r) => {
+	let s = r.length > 1 ? Math.abs(r[1] - r[0]) : 1;
+	if (!n || s >= 1) return e;
+	let c = Math.min(t(s), a);
+	for (; c < a && !o(r, c, s);) c += 1;
+	return i(c);
+}, c = (e) => `${r(e / 1e3)}k`, l = (e) => {
+	let t = Math.abs(e), n = e < 0 ? "−" : "";
+	if (t >= 1e6) {
+		let e = t / 1e6;
+		return `${n}$${e >= 10 ? e.toFixed(1) : e.toFixed(2)}m`.replace(/\.?0+m$/u, "m");
+	}
+	return t >= 1e3 ? `${n}$${Math.round(t / 1e3)}k` : `${n}$${Math.round(t)}`;
+}, u = (e) => `${e < 0 ? "−" : ""}$${Math.abs(e).toFixed(2)}`, d = (e, t = 0) => e === 0 ? "0%" : `${e > 0 ? "+" : "−"}${Math.abs(e).toFixed(t)}%`, f = n("%b %Y"), p = n("%-d %b %Y"), m = (e) => f(e), h = (e) => p(e), g = n("%b"), _ = n("%Y"), v = n("%y"), y = (e) => e.map((t, n) => {
+	let r = e[n - 1];
+	return r === void 0 || r.getUTCFullYear() !== t.getUTCFullYear() ? f(t) : g(t);
+}), b = (e) => e.map((e, t) => t === 0 || e.getUTCFullYear() % 100 == 0 ? _(e) : v(e)), x = n("%-d %b"), S = n("%-d"), C = (e) => e.map((t, n) => {
+	let r = e[n - 1];
+	return r === void 0 || r.getUTCMonth() !== t.getUTCMonth() || r.getUTCFullYear() !== t.getUTCFullYear() ? x(t) : S(t);
+}), w = (e) => {
+	let t = Math.abs(e).toFixed(1);
+	return `${e < 0 && t !== "0.0" ? "−" : ""}${t} °C`;
+}, T = (e, t) => `${e} ${t}${e === 1 ? "" : "s"}`;
+//#endregion
+export { s as axisFormat, C as dayTickLabels, i as fixedFormat, h as fmtDay, w as fmtDegC, r as fmtInt, c as fmtKInt, l as fmtMoney, m as fmtMonth, u as fmtPrice, d as fmtSignedPct, y as monthTickLabels, T as plural, b as yearTickLabels };

package/lib/lib/random.js

@@ -0,0 +1,8 @@
+"use client";
+//#region src/lib/random.ts
+var e = (e, t = 0) => {
+	let n = Math.sin(e * 127.1 + t * 311.7) * 43758.5453;
+	return n - Math.floor(n);
+}, t = (t, n = 0) => e(t, n) * 2 - 1;
+//#endregion
+export { e as rnd, t as rndSigned };

package/lib/maps.js

@@ -0,0 +1,4 @@
+"use client";
+import { USChoropleth as e } from "./charts/maps/us-choropleth.js";
+import { WorldChoropleth as t } from "./charts/maps/world-choropleth.js";
+export { e as USChoropleth, t as WorldChoropleth };

package/lib/schema/daily.js

@@ -0,0 +1,9 @@
+import { z as e } from "zod";
+//#region src/schema/daily.ts
+var t = e.union([e.iso.date(), e.iso.datetime()]), n = e.strictObject({
+	date: t.describe("The day of the reading, as an ISO date or date-time."),
+	id: e.string().min(1).optional().describe("Names the reading, and is its key; without it the date is."),
+	value: e.number().nullable().describe("The reading. Null is a day with no reading, drawn as a gap.")
+});
+//#endregion
+export { n as dailyDatumSchema, t as isoDateSchema };

package/lib/schema/dumbbell-queue.js

@@ -0,0 +1,28 @@
+import { formatSchema as e } from "./format.js";
+import { keyOf as t } from "./key.js";
+import { noteShape as n, sharedShape as r } from "./options.js";
+import { z as i } from "zod";
+//#region src/schema/dumbbell-queue.ts
+var a = i.strictObject({
+	after: i.number().describe("The later value."),
+	before: i.number().describe("The earlier value."),
+	id: i.string().min(1).optional().describe("A unique key, for when two rows share a label."),
+	label: i.string().describe("Names the row, and is its key unless `id` is given.")
+}), o = i.strictObject({
+	...n,
+	...r,
+	alert: i.enum(["fall", "rise"]).optional().describe("Which direction of change is drawn in the alert colour. Defaults to a rise."),
+	data: i.array(a).min(1).max(12).describe("The rows, 1 to 12."),
+	emphasis: i.string().optional().describe("The row to draw in the hero colour, by key. Defaults to the biggest change."),
+	ends: i.tuple([i.string(), i.string()]).optional().describe("Axis end labels: [low end, high end]."),
+	format: e.optional().describe("How values print: a preset name or Intl number-format options."),
+	height: i.number().int().positive().optional().describe("Fixed height in px. Without it the chart is 380 tall."),
+	initialWidth: i.number().int().positive().optional().describe("Responsive mode only: the width of the first render, before measuring."),
+	unit: i.number().positive().optional().describe("Size of one rung in data units: the gap counts off in these."),
+	width: i.number().int().positive().optional().describe("Fixed width in px. Giving it turns measuring off.")
+}).refine((e) => e.emphasis === void 0 || e.data.some((n) => t(n) === e.emphasis), {
+	message: "emphasis names no row: it must equal a datum's id or label",
+	path: ["emphasis"]
+});
+//#endregion
+export { a as dumbbellDatumSchema, o as dumbbellQueueSchema };