@howells/hairline 0.0.0-stage → 0.2.0

package/lib/types/index.d.ts

@@ -0,0 +1,82 @@
+export { Candlestick } from "./charts/basics/candlestick.js";
+export { DotHeat } from "./charts/basics/dot-heat.js";
+export { DumbbellQueue } from "./charts/basics/dumbbell-queue.js";
+export { HairlineArea } from "./charts/basics/hairline-area.js";
+export { HairlineLine } from "./charts/basics/hairline-line.js";
+export { NestedTreemap } from "./charts/basics/nested-treemap.js";
+export { PairedRungs } from "./charts/basics/paired-rungs.js";
+export { PlumbScatter } from "./charts/basics/plumb-scatter.js";
+export { RungBars } from "./charts/basics/rung-bars.js";
+export { RungHistogram } from "./charts/basics/rung-histogram.js";
+export { RungWaterfall } from "./charts/basics/rung-waterfall.js";
+export { StackedRungs } from "./charts/basics/stacked-rungs.js";
+export { StreamRibbon } from "./charts/basics/stream-ribbon.js";
+export { TickBox } from "./charts/basics/tick-box.js";
+export { TickDonut } from "./charts/basics/tick-donut.js";
+export { TickGauge } from "./charts/basics/tick-gauge.js";
+export { TickRows } from "./charts/basics/tick-rows.js";
+export { CircularGraph as CircularBeadGraph } from "./charts/big/circular-graph.js";
+export { ForceGalaxy } from "./charts/big/force-galaxy.js";
+export { ThreadTriptych } from "./charts/big/thread-triptych.js";
+export { Slope } from "./charts/board/slope.js";
+export { AreaDifference } from "./charts/forms/area-difference.js";
+export { BrushedOverview } from "./charts/forms/brushed-overview.js";
+export { ChordRing } from "./charts/forms/chord-ring.js";
+export { CirclePack } from "./charts/forms/circle-pack.js";
+export { HatchedStack } from "./charts/forms/hatched-stack.js";
+export { RadialYear } from "./charts/forms/radial-year.js";
+export { AggregateSankey } from "./charts/glance/aggregate-sankey.js";
+export { BarRace } from "./charts/glance/bar-race.js";
+export { BigSlice } from "./charts/glance/big-slice.js";
+export { ChunkyBars } from "./charts/glance/chunky-bars.js";
+export { CircularGraph } from "./charts/glance/circular-graph.js";
+export { DivergingBar } from "./charts/glance/diverging-bar.js";
+export { DotWaffle } from "./charts/glance/dot-waffle.js";
+export { DrawIn } from "./charts/glance/draw-in.js";
+export { DynamicStream } from "./charts/glance/dynamic-stream.js";
+export { ForceGraph } from "./charts/glance/force-graph.js";
+export { JitterStrip } from "./charts/glance/jitter-strip.js";
+export { MatrixHeatGlance } from "./charts/glance/matrix-heat-glance.js";
+export { PictorialBar } from "./charts/glance/pictorial-bar.js";
+export { RainfallDualArea } from "./charts/glance/rainfall-dual-area.js";
+export { RankStrip } from "./charts/glance/rank-strip.js";
+export { ScatterMorph } from "./charts/glance/scatter-morph.js";
+export { SingleAxis } from "./charts/glance/single-axis.js";
+export { StaggerWave } from "./charts/glance/stagger-wave.js";
+export { TreeLR } from "./charts/glance/tree-lr.js";
+export { Violin } from "./charts/glance/violin.js";
+export { ArcMatrix } from "./charts/lupi/arc-matrix.js";
+export { BallotTally } from "./charts/lupi/ballot-tally.js";
+export { BarcodeLollipop } from "./charts/lupi/barcode-lollipop.js";
+export { BrandSpectrum } from "./charts/lupi/brand-spectrum.js";
+export { BubbleAlmanac } from "./charts/lupi/bubble-almanac.js";
+export { CalendarHeat } from "./charts/lupi/calendar-heat.js";
+export { ClusterField } from "./charts/lupi/cluster-field.js";
+export { DotCascade } from "./charts/lupi/dot-cascade.js";
+export { DottyMatrix } from "./charts/lupi/dotty-matrix.js";
+export { HourglassStream } from "./charts/lupi/hourglass-stream.js";
+export { HundredField } from "./charts/lupi/hundred-field.js";
+export { LaunchFan } from "./charts/lupi/launch-fan.js";
+export { MatrixHeat } from "./charts/lupi/matrix-heat.js";
+export { ParallelCoordinates } from "./charts/lupi/parallel-coordinates.js";
+export { RadialConvergence } from "./charts/lupi/radial-convergence.js";
+export { RadialPatchwork } from "./charts/lupi/radial-patchwork.js";
+export { Ridgeline } from "./charts/lupi/ridgeline.js";
+export { TrendLineage } from "./charts/lupi/trend-lineage.js";
+export { TypeColonnade } from "./charts/lupi/type-colonnade.js";
+export { DailyUsers } from "./charts/originals/daily-users.js";
+export { FeatureRank } from "./charts/originals/feature-rank.js";
+export { ResponseTime } from "./charts/originals/response-time.js";
+export { RevenueByPlan } from "./charts/originals/revenue-by-plan.js";
+export type { DailyDatum } from "./schema/daily.js";
+export type { DumbbellDatum, DumbbellQueueData, DumbbellQueueProps, } from "./schema/dumbbell-queue.js";
+export type { HairlineAreaData, HairlineAreaProps, } from "./schema/hairline-area.js";
+export type { HairlineLineData, HairlineLineProps, } from "./schema/hairline-line.js";
+export type { Keyed } from "./schema/key.js";
+export type { FontMetrics } from "./schema/metrics.js";
+export type { MotionCallbacks } from "./schema/motion.js";
+export type { NoteNames, NoteProps, SharedCallbacks } from "./schema/options.js";
+export type { PlumbDatum, PlumbScatterData, PlumbScatterProps, } from "./schema/plumb-scatter.js";
+export type { RungDatum, RungBarsData, RungBarsProps, } from "./schema/rung-bars.js";
+export type { ScaleOptions } from "./schema/scale.js";
+export type { SlopeRow, SlopeData, SlopeProps } from "./schema/slope.js";

package/lib/types/kit.d.ts

@@ -0,0 +1,22 @@
+export { phase, crisp } from "./charts/axes.js";
+export type { Margin, TickMark } from "./charts/axes.js";
+export { Chart, Plot, Tooltip, SplitClips } from "./charts/core.js";
+export type { LegendItem } from "./charts/core.js";
+export { FILL_TONES, FILL_FAMILIES, FILL_LADDERS, toneClass, } from "./charts/fills.js";
+export type { FillTone, FillFamily } from "./charts/fills.js";
+export { useMeasure, useReveal, useMotionPreference, useReducedMotion, IdScope, useSvgId, useEntry, useScrub, useHover, } from "./charts/hooks.js";
+export type { Animate, Sync, HoverAt, Hover } from "./charts/hooks.js";
+export { DimGroup, HitRect, HitCircle, HitPath, TipText } from "./charts/hover.js";
+export { Dot, Ring, Bar } from "./charts/markers.js";
+export { DOT, RING_WEIGHT, TICK, MARK_WEIGHT, STEM, LABEL_TICK, RING_STEP, KEY, } from "./charts/marks.js";
+export type { DotSize, RingWeight, TickSize } from "./charts/marks.js";
+export { easeTravel, DURATION } from "./charts/motion.js";
+export type { StaggerTier } from "./charts/motion.js";
+export { PlotNote, FootNote } from "./charts/plot-note.js";
+export { HRule, VRule, Stem, Tick, HGrid, VGrid, Cursor } from "./charts/rules.js";
+export type { RuleKind } from "./charts/rules.js";
+export { ChartSvg } from "./charts/svg.js";
+export { Label, XLabels } from "./charts/text.js";
+export type { Voice } from "./charts/text.js";
+export { Hatch, CrossHatch, Rules, Stipple, DotScreen, Beads, DottedLine, DotRing, DottedPath, PixelLine, KeySwatch, EngravedRect, PlateLabel, } from "./charts/texture.js";
+export { TEXTURE_PITCH, HALFTONE_R, paint, useTextureIds, } from "./charts/texture-ids.js";

package/lib/types/lib/format.d.ts

@@ -0,0 +1,58 @@
+export declare const fmtInt: (n: number | {
+    valueOf(): number;
+}) => string;
+/** Thousands-grouped, to a fixed number of decimals. */
+export declare const fixedFormat: (decimals: number) => (n: number | {
+    valueOf(): number;
+}) => string;
+/**
+ * A value axis's labels: the chart's format, or, when it is the default whole
+ * number, one with just the decimals the ticks need, so a narrow range does
+ * not print 8, 8, 7, 7 and a tick at 0.25 does not round to 0.3.
+ */
+export declare const axisFormat: (fmt: (v: number) => string, whole: boolean, ticks: number[]) => (v: number) => string;
+export declare const fmtMs: (v: number) => string;
+export declare const fmtK: (v: number) => string;
+export declare const fmtKInt: (v: number) => string;
+/**
+ * Money in the house style: lowercase k and m, no space, and only the decimals
+ * the magnitude needs ($940, $512k, $8.92m, $18.4m). Every chart uses this.
+ */
+export declare const fmtMoney: (v: number) => string;
+/** A price to the cent, in the same house style ($21.30, −$0.45). */
+export declare const fmtPrice: (v: number) => string;
+/** Signed percent with a true minus sign: +4%, −10%, 0%. */
+export declare const fmtSignedPct: (v: number, digits?: number) => string;
+/** Signed delta with a true minus sign: +31 ms, −41 ms. */
+export declare const fmtSignedMs: (v: number) => string;
+export declare const fmtMonth: (d: Date) => string;
+export declare const fmtDay: (d: Date) => string;
+/**
+ * Month ticks in the broadsheet style: the year is printed on the first tick
+ * and wherever it changes, nowhere else ("Jul 2024 · Jan 2025 · Jul · Jan 2026").
+ */
+export declare const monthTickLabels: (dates: readonly Date[]) => string[];
+/**
+ * Year ticks in the broadsheet style: the first year in full and later years
+ * abbreviated, except at a new century ("2000 05 10 15").
+ */
+export declare const yearTickLabels: (dates: readonly Date[]) => string[];
+/**
+ * Day ticks in the broadsheet style: the month is printed on the first tick
+ * and wherever it changes, nowhere else ("24 Aug · 31 · 7 Sep · 14").
+ */
+export declare const dayTickLabels: (dates: readonly Date[]) => string[];
+/** Temperature in degrees Celsius to one decimal place ("12.3 °C", "−2.2 °C"). */
+export declare const fmtDegC: (v: number) => string;
+/** Mains frequency as published, to three decimal places ("49.275 Hz"). */
+export declare const fmtHz: (v: number) => string;
+/** Carbon intensity, grams of CO₂ per kilowatt hour, whole grams ("142 g/kWh"). */
+export declare const fmtGCO2: (v: number) => string;
+/** Signed change in carbon intensity with a true minus sign ("−85 g/kWh", "+12 g/kWh"). */
+export declare const fmtSignedGCO2: (v: number) => string;
+/** Energy in gigawatt hours, whole ("3,521 GWh"). */
+export declare const fmtGWh: (v: number) => string;
+/** Energy in terawatt hours (the input is TWh), to one decimal place ("87.4 TWh"). */
+export declare const fmtTWh: (v: number) => string;
+/** A count with its noun: "1 bar", "3 bars". */
+export declare const plural: (n: number, noun: string) => string;

package/lib/types/lib/random.d.ts

@@ -0,0 +1,5 @@
+export declare const mulberry32: (seed: number) => () => number;
+/** Stable value in [0, 1) for a pair of integers. */
+export declare const rnd: (i: number, k?: number) => number;
+/** Stable value in [-1, 1). */
+export declare const rndSigned: (i: number, k?: number) => number;

package/lib/types/maps.d.ts

@@ -0,0 +1,2 @@
+export { USChoropleth } from "./charts/maps/us-choropleth.js";
+export { WorldChoropleth } from "./charts/maps/world-choropleth.js";

package/lib/types/schema/daily.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+/** A calendar day ("2024-03-04") or an instant ("2024-03-04T09:00:00Z"). */
+export declare const isoDateSchema: z.ZodUnion<readonly [z.ZodISODate, z.ZodISODateTime]>;
+/**
+ * One reading. `value` is null (or, from TypeScript, NaN or infinite) for a
+ * day with no reading: the chart draws a gap there, not a zero.
+ */
+export declare const dailyDatumSchema: z.ZodObject<{
+    date: z.ZodUnion<readonly [z.ZodISODate, z.ZodISODateTime]>;
+    id: z.ZodOptional<z.ZodString>;
+    value: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>;
+/** One reading. */
+export type DailyDatum = z.infer<typeof dailyDatumSchema>;

package/lib/types/schema/dumbbell-queue.d.ts

@@ -0,0 +1,91 @@
+import { z } from "zod";
+import type { FormatInput } from "./format.js";
+import type { NoteProps, SharedCallbacks } from "./options.js";
+/** One row: a label, the value before and the value after. */
+export declare const dumbbellDatumSchema: z.ZodObject<{
+    after: z.ZodNumber;
+    before: z.ZodNumber;
+    id: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+}, z.core.$strict>;
+export declare const dumbbellQueueSchema: z.ZodObject<{
+    animate: z.ZodOptional<z.ZodEnum<{
+        mount: "mount";
+        off: "off";
+        scroll: "scroll";
+    }>>;
+    replayKey: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    fit: z.ZodOptional<z.ZodBoolean>;
+    scale: z.ZodOptional<z.ZodNumber>;
+    strokes: z.ZodOptional<z.ZodEnum<{
+        device: "device";
+        proportional: "proportional";
+    }>>;
+    idPrefix: z.ZodOptional<z.ZodString>;
+    metrics: z.ZodOptional<z.ZodObject<{
+        advances: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        fallback: z.ZodNumber;
+        tabular: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    table: z.ZodOptional<z.ZodBoolean>;
+    title: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    unitNote: z.ZodOptional<z.ZodString>;
+    alert: z.ZodOptional<z.ZodEnum<{
+        fall: "fall";
+        rise: "rise";
+    }>>;
+    data: z.ZodArray<z.ZodObject<{
+        after: z.ZodNumber;
+        before: z.ZodNumber;
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+    }, z.core.$strict>>;
+    emphasis: z.ZodOptional<z.ZodString>;
+    ends: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString], null>>;
+    format: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        compact: "compact";
+        decimal: "decimal";
+        integer: "integer";
+        percent: "percent";
+    }>, z.ZodObject<{
+        compactDisplay: z.ZodOptional<z.ZodEnum<{
+            long: "long";
+            short: "short";
+        }>>;
+        currency: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodString>;
+        maximumFractionDigits: z.ZodOptional<z.ZodNumber>;
+        minimumFractionDigits: z.ZodOptional<z.ZodNumber>;
+        notation: z.ZodOptional<z.ZodEnum<{
+            compact: "compact";
+            standard: "standard";
+        }>>;
+        signDisplay: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            auto: "auto";
+            exceptZero: "exceptZero";
+            never: "never";
+        }>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            currency: "currency";
+            decimal: "decimal";
+            percent: "percent";
+            unit: "unit";
+        }>>;
+        unit: z.ZodOptional<z.ZodString>;
+        useGrouping: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>]>>;
+    height: z.ZodOptional<z.ZodNumber>;
+    initialWidth: z.ZodOptional<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/** One row. */
+export type DumbbellDatum = z.infer<typeof dumbbellDatumSchema>;
+/** The validated payload. */
+export type DumbbellQueueData = z.infer<typeof dumbbellQueueSchema>;
+/** What `<DumbbellQueue>` takes: the payload, with `format` also allowed as a function. */
+export type DumbbellQueueProps = SharedCallbacks & Omit<z.input<typeof dumbbellQueueSchema>, "format" | "note"> & {
+    format?: FormatInput;
+} & NoteProps;

package/lib/types/schema/format.d.ts

@@ -0,0 +1,101 @@
+import { z } from "zod";
+/**
+ * Named presets. All print with the en-US locale unless the descriptor says
+ * otherwise, so the server, headless Chromium and the browser agree.
+ *
+ * - `integer`: 12,345
+ * - `decimal`: 12,345.6 (one decimal)
+ * - `compact`: 12k, 1.2m
+ * - `percent`: a fraction as a percentage, 0.12 prints 12%
+ */
+export declare const FORMAT_PRESETS: readonly ["integer", "decimal", "compact", "percent"];
+/** The Intl.NumberFormat options a descriptor may carry (plus `locale`). */
+export declare const intlFormatSchema: z.ZodObject<{
+    compactDisplay: z.ZodOptional<z.ZodEnum<{
+        long: "long";
+        short: "short";
+    }>>;
+    currency: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodString>;
+    maximumFractionDigits: z.ZodOptional<z.ZodNumber>;
+    minimumFractionDigits: z.ZodOptional<z.ZodNumber>;
+    notation: z.ZodOptional<z.ZodEnum<{
+        compact: "compact";
+        standard: "standard";
+    }>>;
+    signDisplay: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        auto: "auto";
+        exceptZero: "exceptZero";
+        never: "never";
+    }>>;
+    style: z.ZodOptional<z.ZodEnum<{
+        currency: "currency";
+        decimal: "decimal";
+        percent: "percent";
+        unit: "unit";
+    }>>;
+    unit: z.ZodOptional<z.ZodString>;
+    useGrouping: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/** A formatter as data: a preset name or Intl number-format options. */
+export declare const formatSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    compact: "compact";
+    decimal: "decimal";
+    integer: "integer";
+    percent: "percent";
+}>, z.ZodObject<{
+    compactDisplay: z.ZodOptional<z.ZodEnum<{
+        long: "long";
+        short: "short";
+    }>>;
+    currency: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodString>;
+    maximumFractionDigits: z.ZodOptional<z.ZodNumber>;
+    minimumFractionDigits: z.ZodOptional<z.ZodNumber>;
+    notation: z.ZodOptional<z.ZodEnum<{
+        compact: "compact";
+        standard: "standard";
+    }>>;
+    signDisplay: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        auto: "auto";
+        exceptZero: "exceptZero";
+        never: "never";
+    }>>;
+    style: z.ZodOptional<z.ZodEnum<{
+        currency: "currency";
+        decimal: "decimal";
+        percent: "percent";
+        unit: "unit";
+    }>>;
+    unit: z.ZodOptional<z.ZodString>;
+    useGrouping: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>]>;
+export type FormatDescriptor = z.infer<typeof formatSchema>;
+/** What a chart prop accepts: a descriptor, or (TypeScript only) a function. */
+export type FormatInput = FormatDescriptor | ((value: number) => string);
+/**
+ * Turn any `FormatInput` into a function; `undefined` prints with `String`.
+ * Throws on a descriptor the schema would reject: validate payloads first.
+ */
+export declare const resolveFormat: (input: FormatInput | undefined) => ((value: number) => string);
+/**
+ * Named date presets, printed in UTC so a day is the same day everywhere.
+ *
+ * - `day-month`: 4 Mar
+ * - `day-month-year`: 4 Mar 2024
+ * - `month-year`: Mar 2024
+ */
+export declare const DATE_FORMAT_PRESETS: readonly ["day-month", "day-month-year", "month-year"];
+/** A date formatter as data: a preset name. */
+export declare const dateFormatSchema: z.ZodEnum<{
+    "day-month": "day-month";
+    "day-month-year": "day-month-year";
+    "month-year": "month-year";
+}>;
+export type DateFormatDescriptor = z.infer<typeof dateFormatSchema>;
+/** What a chart prop accepts: a preset, or (TypeScript only) a function. */
+export type DateFormatInput = DateFormatDescriptor | ((date: Date) => string);
+/** Turn any `DateFormatInput` into a function; `undefined` is `day-month`. */
+export declare const resolveDateFormat: (input: DateFormatInput | undefined) => ((date: Date) => string);

package/lib/types/schema/hairline-area.d.ts

@@ -0,0 +1,83 @@
+import { z } from "zod";
+import type { DateFormatInput, FormatInput } from "./format.js";
+import type { NoteProps, SharedCallbacks } from "./options.js";
+export declare const hairlineAreaSchema: z.ZodObject<{
+    animate: z.ZodOptional<z.ZodEnum<{
+        mount: "mount";
+        off: "off";
+        scroll: "scroll";
+    }>>;
+    replayKey: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    fit: z.ZodOptional<z.ZodBoolean>;
+    scale: z.ZodOptional<z.ZodNumber>;
+    strokes: z.ZodOptional<z.ZodEnum<{
+        device: "device";
+        proportional: "proportional";
+    }>>;
+    idPrefix: z.ZodOptional<z.ZodString>;
+    metrics: z.ZodOptional<z.ZodObject<{
+        advances: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        fallback: z.ZodNumber;
+        tabular: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    table: z.ZodOptional<z.ZodBoolean>;
+    title: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    unitNote: z.ZodOptional<z.ZodString>;
+    data: z.ZodArray<z.ZodObject<{
+        date: z.ZodUnion<readonly [z.ZodISODate, z.ZodISODateTime]>;
+        id: z.ZodOptional<z.ZodString>;
+        value: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    dateFormat: z.ZodOptional<z.ZodEnum<{
+        "day-month": "day-month";
+        "day-month-year": "day-month-year";
+        "month-year": "month-year";
+    }>>;
+    emphasis: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        compact: "compact";
+        decimal: "decimal";
+        integer: "integer";
+        percent: "percent";
+    }>, z.ZodObject<{
+        compactDisplay: z.ZodOptional<z.ZodEnum<{
+            long: "long";
+            short: "short";
+        }>>;
+        currency: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodString>;
+        maximumFractionDigits: z.ZodOptional<z.ZodNumber>;
+        minimumFractionDigits: z.ZodOptional<z.ZodNumber>;
+        notation: z.ZodOptional<z.ZodEnum<{
+            compact: "compact";
+            standard: "standard";
+        }>>;
+        signDisplay: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            auto: "auto";
+            exceptZero: "exceptZero";
+            never: "never";
+        }>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            currency: "currency";
+            decimal: "decimal";
+            percent: "percent";
+            unit: "unit";
+        }>>;
+        unit: z.ZodOptional<z.ZodString>;
+        useGrouping: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>]>>;
+    height: z.ZodOptional<z.ZodNumber>;
+    initialWidth: z.ZodOptional<z.ZodNumber>;
+    maxWidth: z.ZodOptional<z.ZodNumber>;
+    ticks: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    width: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/** The validated payload. */
+export type HairlineAreaData = z.infer<typeof hairlineAreaSchema>;
+/** What `<HairlineArea>` takes: the payload, with both formats also allowed as functions. */
+export type HairlineAreaProps = SharedCallbacks & Omit<z.input<typeof hairlineAreaSchema>, "dateFormat" | "format" | "note"> & {
+    dateFormat?: DateFormatInput;
+    format?: FormatInput;
+} & NoteProps;

package/lib/types/schema/hairline-line.d.ts

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import type { DateFormatInput, FormatInput } from "./format.js";
+import type { NoteProps, SharedCallbacks } from "./options.js";
+export declare const hairlineLineSchema: z.ZodObject<{
+    animate: z.ZodOptional<z.ZodEnum<{
+        mount: "mount";
+        off: "off";
+        scroll: "scroll";
+    }>>;
+    replayKey: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    fit: z.ZodOptional<z.ZodBoolean>;
+    scale: z.ZodOptional<z.ZodNumber>;
+    strokes: z.ZodOptional<z.ZodEnum<{
+        device: "device";
+        proportional: "proportional";
+    }>>;
+    idPrefix: z.ZodOptional<z.ZodString>;
+    metrics: z.ZodOptional<z.ZodObject<{
+        advances: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        fallback: z.ZodNumber;
+        tabular: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    table: z.ZodOptional<z.ZodBoolean>;
+    title: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    unitNote: z.ZodOptional<z.ZodString>;
+    data: z.ZodArray<z.ZodObject<{
+        date: z.ZodUnion<readonly [z.ZodISODate, z.ZodISODateTime]>;
+        id: z.ZodOptional<z.ZodString>;
+        value: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    dateFormat: z.ZodOptional<z.ZodEnum<{
+        "day-month": "day-month";
+        "day-month-year": "day-month-year";
+        "month-year": "month-year";
+    }>>;
+    emphasis: z.ZodOptional<z.ZodString>;
+    extreme: z.ZodOptional<z.ZodEnum<{
+        peak: "peak";
+        trough: "trough";
+    }>>;
+    format: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        compact: "compact";
+        decimal: "decimal";
+        integer: "integer";
+        percent: "percent";
+    }>, z.ZodObject<{
+        compactDisplay: z.ZodOptional<z.ZodEnum<{
+            long: "long";
+            short: "short";
+        }>>;
+        currency: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodString>;
+        maximumFractionDigits: z.ZodOptional<z.ZodNumber>;
+        minimumFractionDigits: z.ZodOptional<z.ZodNumber>;
+        notation: z.ZodOptional<z.ZodEnum<{
+            compact: "compact";
+            standard: "standard";
+        }>>;
+        signDisplay: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            auto: "auto";
+            exceptZero: "exceptZero";
+            never: "never";
+        }>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            currency: "currency";
+            decimal: "decimal";
+            percent: "percent";
+            unit: "unit";
+        }>>;
+        unit: z.ZodOptional<z.ZodString>;
+        useGrouping: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>]>>;
+    height: z.ZodOptional<z.ZodNumber>;
+    initialWidth: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/** The validated payload. */
+export type HairlineLineData = z.infer<typeof hairlineLineSchema>;
+/** What `<HairlineLine>` takes: the payload, with both formats also allowed as functions. */
+export type HairlineLineProps = SharedCallbacks & Omit<z.input<typeof hairlineLineSchema>, "dateFormat" | "format" | "note"> & {
+    dateFormat?: DateFormatInput;
+    format?: FormatInput;
+} & NoteProps;

package/lib/types/schema/key.d.ts

@@ -0,0 +1,12 @@
+/** A datum that can be addressed by key. */
+export type Keyed = {
+    id?: string;
+} & ({
+    date: string;
+} | {
+    label: string;
+} | {
+    name: string;
+});
+/** The key a datum is addressed by: `id`, else its label, name or date. */
+export declare const keyOf: (datum: Keyed) => string;

package/lib/types/schema/metrics.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+/**
+ * A face's glyph advances, in em. `advances` maps a character to its width;
+ * any character not listed takes `fallback`. `tabular`, when given, is the
+ * width of every digit in text set with tabular figures (it overrides the
+ * digits listed in `advances` there).
+ */
+export declare const fontMetricsSchema: z.ZodObject<{
+    advances: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    fallback: z.ZodNumber;
+    tabular: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type FontMetrics = z.infer<typeof fontMetricsSchema>;
+/**
+ * Inter, bucketed from measurements and rounded up so a label that "fits"
+ * really does: narrow punctuation, slim brackets and `1`, wide `m` and `w`,
+ * widest `%@MW—…`, then 0.63em lower case and 0.76em capitals (the fallback
+ * is applied per case, see `advance`). Tabular figures are 0.65em.
+ */
+export declare const INTER_METRICS: FontMetrics;
+/**
+ * Width of a string at `size` px, from a metrics table: the same answer
+ * everywhere, because nothing is measured. `tabular` sets digits at the
+ * table's tabular width.
+ */
+export declare const textWidth: (text: string, size: number, metrics?: FontMetrics, tabular?: boolean) => number;

package/lib/types/schema/motion.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const motionShape: {
+    /**
+     * When the entry draws in. "scroll": when the chart scrolls into view.
+     * "mount": at once, without scrolling. "off": never; the chart is drawn, and
+     * ready, in the first HTML. The default is "off" for a fixed-size chart
+     * (`width` and `height` given) and "scroll" for a responsive one. Under
+     * reduced motion the chart is drawn in the first paint whatever this says.
+     */
+    animate: z.ZodOptional<z.ZodEnum<{
+        mount: "mount";
+        off: "off";
+        scroll: "scroll";
+    }>>;
+    /** Change it to replay the entry without remounting the chart. */
+    replayKey: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+};
+/** What a chart's props add to its payload for motion. */
+export interface MotionCallbacks {
+    /** Called when the chart has settled: the same moment `data-hl-ready` turns "true". */
+    onReady?: () => void;
+}