@howells/hairline 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import type { MotionCallbacks } from "./motion.js";
+export declare const sharedShape: {
+    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";
+    }>>;
+    /** Leads every SVG id, to separate charts rendered in separate React roots on one page. */
+    idPrefix: z.ZodOptional<z.ZodString>;
+    /** Glyph widths of a face other than Inter, so notes wrap and reserve room for it. */
+    metrics: z.ZodOptional<z.ZodObject<{
+        advances: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        fallback: z.ZodNumber;
+        tabular: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    /** Show the data table to sighted readers too. It is always there for screen readers. */
+    table: z.ZodOptional<z.ZodBoolean>;
+    /** The chart's accessible name. Each chart has a default that reads the data. */
+    title: z.ZodOptional<z.ZodString>;
+};
+/**
+ * The in-plot note, as one shape: spread `noteShape` into the chart's
+ * strictObject and add `NoteProps` to its props type. `note` is the old name
+ * for `unitNote`, kept so existing callers still work.
+ */
+export declare const noteShape: {
+    /** The old name for `unitNote`; JSON Schema marks it deprecated. */
+    note: z.ZodOptional<z.ZodString>;
+    /** The in-plot key under the axis. */
+    unitNote: z.ZodOptional<z.ZodString>;
+};
+/** The two names an in-plot note goes by, for code that reads them (a deprecation would flag the read). */
+export interface NoteNames {
+    note?: string;
+    unitNote?: string;
+}
+/** A chart's props for the in-plot note: `unitNote`, and the `note` it replaces. */
+export interface NoteProps extends Omit<NoteNames, "note"> {
+    /** @deprecated Use `unitNote`. */
+    note?: string;
+}
+/** What a chart's props add to its payload: functions cannot be JSON. */
+export type SharedCallbacks = MotionCallbacks;

package/lib/types/schema/plumb-scatter.d.ts

@@ -0,0 +1,124 @@
+import { z } from "zod";
+import type { FormatInput } from "./format.js";
+import type { NoteProps, SharedCallbacks } from "./options.js";
+/** One point: a name, where it sits, and an optional key for when names repeat. */
+export declare const plumbDatumSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, z.core.$strict>;
+export declare const plumbScatterSchema: 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<{
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>;
+    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>]>>;
+    formatX: 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>;
+    labelled: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    width: z.ZodOptional<z.ZodNumber>;
+    xDomain: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    xLabels: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString], null>>;
+    yDomain: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    yLabel: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** One point. */
+export type PlumbDatum = z.infer<typeof plumbDatumSchema>;
+/** The validated payload. */
+export type PlumbScatterData = z.infer<typeof plumbScatterSchema>;
+/** What `<PlumbScatter>` takes: the payload, with formats also allowed as functions. */
+export type PlumbScatterProps = SharedCallbacks & Omit<z.input<typeof plumbScatterSchema>, "format" | "formatX" | "note"> & {
+    format?: FormatInput;
+    formatX?: FormatInput;
+} & NoteProps;

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

@@ -0,0 +1,309 @@
+import type { ZodType } from "zod";
+import type { Payload, Validated } from "./validate.js";
+/** The nine jobs of the FT Visual Vocabulary. */
+export type Job = "change-over-time" | "correlation" | "deviation" | "distribution" | "flow" | "magnitude" | "part-to-whole" | "ranking" | "spatial";
+export interface ChartEntry<T = unknown> {
+    /** The chart's name in the package, e.g. "RungBars". */
+    component: string;
+    /** Plain-words shape of `data`, for a prompt. */
+    dataShape: string;
+    /** How much data the chart takes well; the schema enforces the bounds. */
+    limits: {
+        categories?: {
+            max: number;
+            min: number;
+        };
+        series: {
+            max: number;
+            min: number;
+        };
+    };
+    /** The stable id: what a payload's `kind` says. */
+    kind: string;
+    /** The Visual Vocabulary job the chart does best, then the next best. */
+    jobs: readonly [Job, ...Job[]];
+    schema: ZodType<T>;
+    /** Check a payload against `schema`. */
+    validate: (input: Payload) => Validated<T>;
+    whenNotToUse: string;
+    whenToUse: string;
+}
+/** Every chart by kind, typed: `charts["rung-bars"].validate(x)` returns that chart's data. */
+export declare const charts: {
+    "dumbbell-queue": ChartEntry<{
+        animate?: "mount" | "off" | "scroll" | undefined;
+        replayKey?: string | number | undefined;
+        fit?: boolean | undefined;
+        scale?: number | undefined;
+        strokes?: "device" | "proportional" | undefined;
+        idPrefix?: string | undefined;
+        metrics?: {
+            advances: Record<string, number>;
+            fallback: number;
+            tabular?: number | undefined;
+        } | undefined;
+        table?: boolean | undefined;
+        title?: string | undefined;
+        note?: string | undefined;
+        unitNote?: string | undefined;
+        alert?: "fall" | "rise" | undefined;
+        data: {
+            after: number;
+            before: number;
+            id?: string | undefined;
+            label: string;
+        }[];
+        emphasis?: string | undefined;
+        ends?: [string, string] | undefined;
+        format?: "compact" | "decimal" | "integer" | "percent" | {
+            compactDisplay?: "long" | "short" | undefined;
+            currency?: string | undefined;
+            locale?: string | undefined;
+            maximumFractionDigits?: number | undefined;
+            minimumFractionDigits?: number | undefined;
+            notation?: "compact" | "standard" | undefined;
+            signDisplay?: "always" | "auto" | "exceptZero" | "never" | undefined;
+            style?: "currency" | "decimal" | "percent" | "unit" | undefined;
+            unit?: string | undefined;
+            useGrouping?: boolean | undefined;
+        } | undefined;
+        height?: number | undefined;
+        initialWidth?: number | undefined;
+        unit?: number | undefined;
+        width?: number | undefined;
+    }>;
+    "hairline-area": ChartEntry<{
+        animate?: "mount" | "off" | "scroll" | undefined;
+        replayKey?: string | number | undefined;
+        fit?: boolean | undefined;
+        scale?: number | undefined;
+        strokes?: "device" | "proportional" | undefined;
+        idPrefix?: string | undefined;
+        metrics?: {
+            advances: Record<string, number>;
+            fallback: number;
+            tabular?: number | undefined;
+        } | undefined;
+        table?: boolean | undefined;
+        title?: string | undefined;
+        note?: string | undefined;
+        unitNote?: string | undefined;
+        data: {
+            date: string;
+            id?: string | undefined;
+            value: number | null;
+        }[];
+        dateFormat?: "day-month" | "day-month-year" | "month-year" | undefined;
+        emphasis?: string | undefined;
+        format?: "compact" | "decimal" | "integer" | "percent" | {
+            compactDisplay?: "long" | "short" | undefined;
+            currency?: string | undefined;
+            locale?: string | undefined;
+            maximumFractionDigits?: number | undefined;
+            minimumFractionDigits?: number | undefined;
+            notation?: "compact" | "standard" | undefined;
+            signDisplay?: "always" | "auto" | "exceptZero" | "never" | undefined;
+            style?: "currency" | "decimal" | "percent" | "unit" | undefined;
+            unit?: string | undefined;
+            useGrouping?: boolean | undefined;
+        } | undefined;
+        height?: number | undefined;
+        initialWidth?: number | undefined;
+        maxWidth?: number | undefined;
+        ticks?: number[] | undefined;
+        width?: number | undefined;
+    }>;
+    "hairline-line": ChartEntry<{
+        animate?: "mount" | "off" | "scroll" | undefined;
+        replayKey?: string | number | undefined;
+        fit?: boolean | undefined;
+        scale?: number | undefined;
+        strokes?: "device" | "proportional" | undefined;
+        idPrefix?: string | undefined;
+        metrics?: {
+            advances: Record<string, number>;
+            fallback: number;
+            tabular?: number | undefined;
+        } | undefined;
+        table?: boolean | undefined;
+        title?: string | undefined;
+        note?: string | undefined;
+        unitNote?: string | undefined;
+        data: {
+            date: string;
+            id?: string | undefined;
+            value: number | null;
+        }[];
+        dateFormat?: "day-month" | "day-month-year" | "month-year" | undefined;
+        emphasis?: string | undefined;
+        extreme?: "peak" | "trough" | undefined;
+        format?: "compact" | "decimal" | "integer" | "percent" | {
+            compactDisplay?: "long" | "short" | undefined;
+            currency?: string | undefined;
+            locale?: string | undefined;
+            maximumFractionDigits?: number | undefined;
+            minimumFractionDigits?: number | undefined;
+            notation?: "compact" | "standard" | undefined;
+            signDisplay?: "always" | "auto" | "exceptZero" | "never" | undefined;
+            style?: "currency" | "decimal" | "percent" | "unit" | undefined;
+            unit?: string | undefined;
+            useGrouping?: boolean | undefined;
+        } | undefined;
+        height?: number | undefined;
+        initialWidth?: number | undefined;
+        width?: number | undefined;
+    }>;
+    "plumb-scatter": ChartEntry<{
+        animate?: "mount" | "off" | "scroll" | undefined;
+        replayKey?: string | number | undefined;
+        fit?: boolean | undefined;
+        scale?: number | undefined;
+        strokes?: "device" | "proportional" | undefined;
+        idPrefix?: string | undefined;
+        metrics?: {
+            advances: Record<string, number>;
+            fallback: number;
+            tabular?: number | undefined;
+        } | undefined;
+        table?: boolean | undefined;
+        title?: string | undefined;
+        note?: string | undefined;
+        unitNote?: string | undefined;
+        data: {
+            id?: string | undefined;
+            label: string;
+            x: number;
+            y: number;
+        }[];
+        emphasis?: string | undefined;
+        format?: "compact" | "decimal" | "integer" | "percent" | {
+            compactDisplay?: "long" | "short" | undefined;
+            currency?: string | undefined;
+            locale?: string | undefined;
+            maximumFractionDigits?: number | undefined;
+            minimumFractionDigits?: number | undefined;
+            notation?: "compact" | "standard" | undefined;
+            signDisplay?: "always" | "auto" | "exceptZero" | "never" | undefined;
+            style?: "currency" | "decimal" | "percent" | "unit" | undefined;
+            unit?: string | undefined;
+            useGrouping?: boolean | undefined;
+        } | undefined;
+        formatX?: "compact" | "decimal" | "integer" | "percent" | {
+            compactDisplay?: "long" | "short" | undefined;
+            currency?: string | undefined;
+            locale?: string | undefined;
+            maximumFractionDigits?: number | undefined;
+            minimumFractionDigits?: number | undefined;
+            notation?: "compact" | "standard" | undefined;
+            signDisplay?: "always" | "auto" | "exceptZero" | "never" | undefined;
+            style?: "currency" | "decimal" | "percent" | "unit" | undefined;
+            unit?: string | undefined;
+            useGrouping?: boolean | undefined;
+        } | undefined;
+        height?: number | undefined;
+        initialWidth?: number | undefined;
+        labelled?: string[] | undefined;
+        width?: number | undefined;
+        xDomain?: [number, number] | undefined;
+        xLabels?: [string, string] | undefined;
+        yDomain?: [number, number] | undefined;
+        yLabel?: string | undefined;
+    }>;
+    "rung-bars": ChartEntry<{
+        animate?: "mount" | "off" | "scroll" | undefined;
+        replayKey?: string | number | undefined;
+        fit?: boolean | undefined;
+        scale?: number | undefined;
+        strokes?: "device" | "proportional" | undefined;
+        idPrefix?: string | undefined;
+        metrics?: {
+            advances: Record<string, number>;
+            fallback: number;
+            tabular?: number | undefined;
+        } | undefined;
+        table?: boolean | undefined;
+        title?: string | undefined;
+        note?: string | undefined;
+        unitNote?: string | undefined;
+        data: {
+            id?: string | undefined;
+            label: string;
+            value: number;
+        }[];
+        emphasis?: string | undefined;
+        format?: "compact" | "decimal" | "integer" | "percent" | {
+            compactDisplay?: "long" | "short" | undefined;
+            currency?: string | undefined;
+            locale?: string | undefined;
+            maximumFractionDigits?: number | undefined;
+            minimumFractionDigits?: number | undefined;
+            notation?: "compact" | "standard" | undefined;
+            signDisplay?: "always" | "auto" | "exceptZero" | "never" | undefined;
+            style?: "currency" | "decimal" | "percent" | "unit" | undefined;
+            unit?: string | undefined;
+            useGrouping?: boolean | undefined;
+        } | undefined;
+        height?: number | undefined;
+        initialWidth?: number | undefined;
+        unit?: number | undefined;
+        width?: number | undefined;
+    }>;
+    slope: ChartEntry<{
+        animate?: "mount" | "off" | "scroll" | undefined;
+        replayKey?: string | number | undefined;
+        fit?: boolean | undefined;
+        scale?: number | undefined;
+        strokes?: "device" | "proportional" | undefined;
+        idPrefix?: string | undefined;
+        metrics?: {
+            advances: Record<string, number>;
+            fallback: number;
+            tabular?: number | undefined;
+        } | undefined;
+        table?: boolean | undefined;
+        title?: string | undefined;
+        domain?: [number, number] | undefined;
+        emphasis?: string | undefined;
+        format?: "compact" | "decimal" | "integer" | "percent" | {
+            compactDisplay?: "long" | "short" | undefined;
+            currency?: string | undefined;
+            locale?: string | undefined;
+            maximumFractionDigits?: number | undefined;
+            minimumFractionDigits?: number | undefined;
+            notation?: "compact" | "standard" | undefined;
+            signDisplay?: "always" | "auto" | "exceptZero" | "never" | undefined;
+            style?: "currency" | "decimal" | "percent" | "unit" | undefined;
+            unit?: string | undefined;
+            useGrouping?: boolean | undefined;
+        } | undefined;
+        height?: number | undefined;
+        initialWidth?: number | undefined;
+        label?: string | undefined;
+        labels: [string, string];
+        narrowFormat?: "compact" | "decimal" | "integer" | "percent" | {
+            compactDisplay?: "long" | "short" | undefined;
+            currency?: string | undefined;
+            locale?: string | undefined;
+            maximumFractionDigits?: number | undefined;
+            minimumFractionDigits?: number | undefined;
+            notation?: "compact" | "standard" | undefined;
+            signDisplay?: "always" | "auto" | "exceptZero" | "never" | undefined;
+            style?: "currency" | "decimal" | "percent" | "unit" | undefined;
+            unit?: string | undefined;
+            useGrouping?: boolean | undefined;
+        } | undefined;
+        rows: {
+            from: number;
+            id?: string | undefined;
+            name: string;
+            to: number;
+        }[];
+        width?: number | undefined;
+    }>;
+};
+export type ChartKind = keyof typeof charts;
+/** The same entries as a list, for an agent to read and choose from. */
+export declare const registry: readonly ChartEntry[];
+/** The entry for a known kind (typed), or for any string (maybe undefined). */
+export declare function getChart<K extends ChartKind>(kind: K): (typeof charts)[K];
+export declare function getChart(kind: string): ChartEntry | undefined;

package/lib/types/schema/rung-bars.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import type { FormatInput } from "./format.js";
+import type { NoteProps, SharedCallbacks } from "./options.js";
+/** The bars: a label, a value, and an optional key for when labels repeat. */
+export declare const rungDatumSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    value: z.ZodNumber;
+}, z.core.$strict>;
+export declare const rungBarsSchema: 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<{
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        value: z.ZodNumber;
+    }, z.core.$strict>>;
+    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>;
+    unit: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/** One bar. */
+export type RungDatum = z.infer<typeof rungDatumSchema>;
+/** The validated payload. */
+export type RungBarsData = z.infer<typeof rungBarsSchema>;
+/** What `<RungBars>` takes: the payload, with `format` also allowed as a function. */
+export type RungBarsProps = SharedCallbacks & Omit<z.input<typeof rungBarsSchema>, "format" | "note"> & {
+    format?: FormatInput;
+} & NoteProps;

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

@@ -0,0 +1,34 @@
+import { z } from "zod";
+export declare const scaleShape: {
+    /**
+     * Fit the container instead: the svg fills its width at the chart's aspect
+     * ratio. Wins over `scale`.
+     */
+    fit: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Slides: draw at the logical `width`, then show the whole composition
+     * `scale` times larger through the viewBox, so type, spacing and marks grow
+     * together (11 px labels at `scale` 2.5 read 27.5 px). Textures scale too.
+     */
+    scale: z.ZodOptional<z.ZodNumber>;
+    /**
+     * "proportional" (default) lets strokes scale with the composition;
+     * "device" keeps every stroke at one device pixel however large it is shown.
+     * The policy acts on stroked geometry only: rules, grid lines, lines and
+     * paths, rings and outlines. Filled marks (the bars of RungBars and the
+     * stems of HairlineArea are rects, the textures are fills) scale with the
+     * composition either way, so in RungBars "device" changes just its baseline
+     * rule; in the other five charts it also holds their lines and rings
+     * to one device pixel.
+     */
+    strokes: z.ZodOptional<z.ZodEnum<{
+        device: "device";
+        proportional: "proportional";
+    }>>;
+};
+/** How a scaled chart is shown. */
+export interface ScaleOptions {
+    fit?: boolean;
+    scale?: number;
+    strokes?: "device" | "proportional";
+}