@sophistry/charts 0.0.0-stage → 0.0.1

package/dist/frame/format.d.ts

@@ -0,0 +1,41 @@
+/** How a `chart` writes a channel's value in a tooltip (`frame.format`). */
+import type { BandKey, TimeZone } from "@sophistry/core/geometry";
+import type { OrdinalColorScale } from "../math/ordinal";
+import type { MergedAxisOptions, ResolvedAxis } from "./fit";
+import type { SecondaryFlags } from "./secondary";
+import type { ChartColorOptions, ChartFormatChannel, ChartSizeLegendOptions } from "./types";
+/** A formatter of one channel's values. */
+export type ValueFormat = (value: number | BandKey) => string;
+/**
+ * How an axis writes a value in a tooltip: a band axis a category's name, a
+ * continuous one through its `tickFormat` at its current range (a full date,
+ * by default, on a time axis).
+ */
+export declare function axisValueFormat(options: MergedAxisOptions, axis: ResolvedAxis): ValueFormat;
+/** A moment written in full on `timeZone`'s clock, to the precision it carries: the day, then the minute or the second. */
+export declare function dateText(value: number, timeZone: TimeZone): string;
+/** An axis whose values a chart formats. */
+export interface FormatAxis {
+    options: MergedAxisOptions;
+    axis: ResolvedAxis;
+}
+/** What a chart's formats read on one update. */
+export interface ChartFormatsInput {
+    x: FormatAxis;
+    y: FormatAxis;
+    x2: FormatAxis;
+    y2: FormatAxis;
+    color: ChartColorOptions | undefined;
+    colorScale: OrdinalColorScale;
+    sizeOptions: ChartSizeLegendOptions;
+}
+/**
+ * The formatters a chart's contexts write values with, by secondary flags.
+ * Make one per chart; each update passes its axes, and a formatter is built
+ * lazily (when a tooltip asks) and kept while its axis keeps its identity.
+ *
+ * @returns `(input) => (flags) => format`: `format(channel)` for the context
+ *   through `flags`.
+ */
+export declare function createChartFormats(): (input: ChartFormatsInput) => (flags: SecondaryFlags) => (channel: ChartFormatChannel) => ValueFormat;
+//# sourceMappingURL=format.d.ts.map

package/dist/frame/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/frame/format.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAOlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACX,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,MAAM,SAAS,CAAC;AAEjB,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,KAAK,MAAM,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,YAAY,GAChB,WAAW,CAmCb;AAED,2HAA2H;AAC3H,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAalE;AAED,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE,YAAY,CAAC;CACnB;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IACjC,CAAC,EAAE,UAAU,CAAC;IACd,CAAC,EAAE,UAAU,CAAC;IACd,EAAE,EAAE,UAAU,CAAC;IACf,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACrC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,WAAW,EAAE,sBAAsB,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,CACrC,KAAK,EAAE,iBAAiB,KACpB,CAAC,KAAK,EAAE,cAAc,KAAK,CAAC,OAAO,EAAE,kBAAkB,KAAK,WAAW,CAyD3E"}

package/dist/frame/guide-metrics.d.ts

@@ -0,0 +1,37 @@
+/** Sizes and gaps for a chart's guides, shared by `chart` and a group's guides so they match. */
+/** An axis title's font size when none is given. */
+export declare const AXIS_LABEL_FONT_SIZE = 0.34;
+/** The gap between an axis's numbers and its title. */
+export declare const AXIS_LABEL_GAP = 0.22;
+/** The title's font size when none is given. */
+export declare const TITLE_FONT_SIZE = 0.42;
+/** The gap under the title. */
+export declare const TITLE_GAP = 0.35;
+/** The gap between the plotting area and a legend beside or above it. */
+export declare const LEGEND_GAP = 0.35;
+/** The gap between the colour legend and the size key under (or beside) it. */
+export declare const KEYS_GAP = 0.25;
+/** The colour bar's thickness. */
+export declare const COLORBAR_THICKNESS = 0.22;
+/**
+ * Half a line of text at `fontSize` (a line is `1.2` of it): from a line's
+ * edge to its middle, as a rotated title stands off the edge it reads along.
+ */
+export declare function halfLine(fontSize: number): number;
+/** A key's laid-out size, and how present it is (0 at a transition end with no legend), scaling the gap before it. */
+export interface KeyExtent {
+    width: number;
+    height: number;
+    presence: number;
+}
+/** A key's size at each end of a keyed transition (`to` only when the ends differ). */
+export interface KeyEnds {
+    from: KeyExtent;
+    to: KeyExtent | undefined;
+}
+/** Two laid-out boxes of the same size (or both none). */
+export declare function sameKeyExtent(a: KeyExtent | undefined, b: KeyExtent | undefined): boolean;
+export declare function sameKeyEnds(a: KeyEnds | undefined, b: KeyEnds | undefined): boolean;
+/** A key's size now: its own end's, or blended between the ends by the update stage's progress `u`. */
+export declare function keyExtentNow(ends: KeyEnds | undefined, u: () => number): KeyExtent | undefined;
+//# sourceMappingURL=guide-metrics.d.ts.map

package/dist/frame/guide-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-metrics.d.ts","sourceRoot":"","sources":["../../src/frame/guide-metrics.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAIjG,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,uDAAuD;AACvD,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,gDAAgD;AAChD,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,+BAA+B;AAC/B,eAAO,MAAM,SAAS,OAAO,CAAC;AAC9B,yEAAyE;AACzE,eAAO,MAAM,UAAU,OAAO,CAAC;AAC/B,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,kCAAkC;AAClC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,sHAAsH;AACtH,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,uFAAuF;AACvF,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,SAAS,GAAG,SAAS,CAAC;CAC1B;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAC5B,CAAC,EAAE,SAAS,GAAG,SAAS,EACxB,CAAC,EAAE,SAAS,GAAG,SAAS,GACtB,OAAO,CAMT;AAED,wBAAgB,WAAW,CAC1B,CAAC,EAAE,OAAO,GAAG,SAAS,EACtB,CAAC,EAAE,OAAO,GAAG,SAAS,GACpB,OAAO,CAIT;AAED,uGAAuG;AACvG,wBAAgB,YAAY,CAC3B,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,CAAC,EAAE,MAAM,MAAM,GACb,SAAS,GAAG,SAAS,CAQvB"}

package/dist/frame/guides.d.ts

@@ -0,0 +1,68 @@
+/**
+ * What a `chart` draws around its layers: the grid, zero lines, axes
+ * (number lines and band axes, with a kind swap's ghost), titles, the colour
+ * bar, the legend and the size keys.
+ *
+ * {@link createChartGuides} is made once per chart; its function runs in
+ * every chart update, keeps each guide's node by role (writing props into
+ * it rather than rebuilding it) and returns the nodes in paint order.
+ */
+import type { CompositeContext, SceneNode } from "@sophistry/core";
+import type { Range } from "@sophistry/core/geometry";
+import type { Theme } from "@sophistry/core/themes";
+import type { JoinStages, StageWindow } from "../math/join";
+import type { ChartCoords } from "./coords";
+import type { AxisEnds, AxisSwapView, FittedTransition, GivenRange, MergedAxisOptions, ResolvedAxis } from "./fit";
+import type { ChartKeys } from "./keys";
+import type { ChartLayout } from "./layout";
+import type { ChartLayerExtent, ChartProps } from "./types";
+/** One primary axis as the guides draw it. */
+export interface GuideAxis {
+    options: MergedAxisOptions;
+    axis: ResolvedAxis;
+    range: Range;
+    given: GivenRange;
+    fitted: FittedTransition | undefined;
+    ends: AxisEnds | undefined;
+    /** A kind swap's cross-fade (see `createAxisSwap`). */
+    swap: AxisSwapView;
+}
+/** One secondary axis as the guides draw it. */
+export interface GuideSecondaryAxis {
+    has: boolean;
+    options: MergedAxisOptions;
+    given: GivenRange;
+    range: Range;
+}
+/** The frame state the guides draw from on one update. */
+export interface GuideFrame {
+    props: Readonly<ChartProps>;
+    theme: Theme;
+    reports: readonly ChartLayerExtent[];
+    x: GuideAxis;
+    y: GuideAxis;
+    x2: GuideSecondaryAxis;
+    y2: GuideSecondaryAxis;
+    axisZeros: {
+        xSpans: boolean;
+        ySpans: boolean;
+        xFrom: boolean;
+        yFrom: boolean;
+    };
+    axisBands: {
+        x: boolean;
+        y: boolean;
+    };
+    stage(pick: (stages: JoinStages) => StageWindow): number;
+    layout: ChartLayout;
+    keys: ChartKeys;
+    coords: ChartCoords;
+    frameProgress: number;
+    legendProgress: number;
+}
+/**
+ * The frame's guides. Make one per chart in `setup`; call the result in
+ * every update with the chart's context and frame state.
+ */
+export declare function createChartGuides(): (ctx: CompositeContext<ChartProps>, frame: GuideFrame) => SceneNode[];
+//# sourceMappingURL=guides.d.ts.map

package/dist/frame/guides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guides.d.ts","sourceRoot":"","sources":["../../src/frame/guides.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAEX,gBAAgB,EAEhB,SAAS,EAGT,MAAM,iBAAiB,CAAC;AAYzB,OAAO,KAAK,EAEX,KAAK,EAGL,MAAM,0BAA0B,CAAC;AAoBlC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAIpD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EACX,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,MAAM,OAAO,CAAC;AAWf,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAQ5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE5D,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,uDAAuD;IACvD,IAAI,EAAE,YAAY,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IAClC,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;CACb;AAED,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,CAAC,EAAE,SAAS,CAAC;IACb,CAAC,EAAE,SAAS,CAAC;IACb,EAAE,EAAE,kBAAkB,CAAC;IACvB,EAAE,EAAE,kBAAkB,CAAC;IACvB,SAAS,EAAE;QACV,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;KACf,CAAC;IACF,SAAS,EAAE;QAAE,CAAC,EAAE,OAAO,CAAC;QAAC,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACtC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,WAAW,GAAG,MAAM,CAAC;IACzD,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACvB;AAgDD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,CACpC,GAAG,EAAE,gBAAgB,CAAC,UAAU,CAAC,EACjC,KAAK,EAAE,UAAU,KACb,SAAS,EAAE,CAouBf"}

package/dist/frame/keys.d.ts

@@ -0,0 +1,97 @@
+/**
+ * What a `chart`'s keys show: the colour scale and its legend, the size
+ * keys, and the colour bar's ramp, all from the layers' steady reports.
+ *
+ * {@link createChartKeys} is made once per chart; its function runs in
+ * every chart update and keeps each result's identity while it is equal,
+ * so the legend and the layers see nothing new while only a blend moves.
+ * The size-scale helpers are shared with a chart group's guides.
+ */
+import type { ColorInput } from "@sophistry/core/color";
+import type { BandKey } from "@sophistry/core/geometry";
+import type { Theme } from "@sophistry/core/themes";
+import type { JoinStages, StageWindow } from "../math/join";
+import type { OrdinalColorScale } from "../math/ordinal";
+import type { ChartLayerExtent, ChartProps, ChartSizeLegendOptions, LegendMark, RampExtent, SharedSizeDomain, SizeExtent } from "./types";
+/** One legend entry (as `legend` takes it). */
+export interface FrameLegendEntry {
+    key?: BandKey;
+    label: string;
+    color: ColorInput;
+    mark?: LegendMark;
+}
+/** A legend's keyed transition (as `legend` takes it). */
+export interface FrameLegendTransition {
+    from: readonly BandKey[];
+    to: readonly BandKey[];
+    exit: number;
+    update: number;
+    enter: number;
+}
+/** The stages a stack of size keys transitions on (as `sizeKeyStack` takes them). */
+export interface FrameSizeKeyStages {
+    exit: number;
+    update: number;
+    enter: number;
+}
+/**
+ * One size scale over sized layers' reports: the greatest maximum at each
+ * end (a pinned `sizeMaxValue` counts at both). Undefined when no layer
+ * sizes by value.
+ */
+export declare function sharedSizeDomain(reports: readonly ChartLayerExtent[]): SharedSizeDomain | undefined;
+/** Two shared size domains with the same ends. */
+export declare function sameSizeDomain(a: SharedSizeDomain | undefined, b: SharedSizeDomain | undefined): boolean;
+/** A layer's size scale on a shared one: the shared maximum at each end, unless the layer pins its own or nothing is shared. */
+export declare function onSharedSize(size: SizeExtent, shared: SharedSizeDomain | undefined): SizeExtent;
+/**
+ * A frame's size keys over its sized layers, in layer order: one per
+ * distinct drawn scale, titled by its first layer's channel. With
+ * `byRange` (a group's keys), one per distinct `sizeRange`, left out
+ * unless its layers agree on the maximum.
+ */
+export declare function sizeKeysOf(sizes: readonly (SizeExtent | undefined)[], drawn: (size: SizeExtent) => SizeExtent, byRange?: boolean): SizeExtent[];
+/** The legend swatch over every reporting layer: every layer's mark, merged. */
+export declare function mergedLegendMark(reports: readonly ChartLayerExtent[]): LegendMark;
+/** What one update of a chart's keys reads. */
+export interface ChartKeysInput {
+    props: Readonly<ChartProps>;
+    theme: Theme;
+    /** The steady reports (identity kept while unchanged). */
+    reports: readonly ChartLayerExtent[];
+    /** Whether a keyed transition runs (steady while its blend moves). */
+    transitioning: boolean;
+    /** How far a stage of the transition has got. */
+    stage(pick: (stages: JoinStages) => StageWindow): number;
+    /** A chart group's colour scale, which wins over the chart's own. */
+    groupColorScale?: OrdinalColorScale;
+    /** A chart group's shared size domain, which wins over the chart's own. */
+    groupSizeDomain?: SharedSizeDomain;
+    /** The chart is a group's panel. */
+    grouped?: boolean;
+}
+/** A chart's keys on one update; every field keeps its identity while equal. */
+export interface ChartKeys {
+    colorScale: OrdinalColorScale;
+    legendEntries: readonly FrameLegendEntry[];
+    legendPosition: "right" | "top" | undefined;
+    legendEnds: {
+        from: readonly BandKey[];
+        to: readonly BandKey[];
+    } | undefined;
+    legendTransition: FrameLegendTransition | undefined;
+    sizeDomain: SharedSizeDomain | undefined;
+    sizeOptions: ChartSizeLegendOptions;
+    sizeKeys: readonly SizeExtent[];
+    sizePosition: "right" | "top" | undefined;
+    /** Where the frame's keys go (the colour legend and the size key): their shared side. */
+    guidesPosition: "right" | "top" | undefined;
+    sizeStages: FrameSizeKeyStages | undefined;
+    ramp: RampExtent | undefined;
+}
+/**
+ * The colour scale, legend, size keys and colour bar ramp of a chart. Make
+ * one per chart in `setup`; call the result in every update.
+ */
+export declare function createChartKeys(): (input: ChartKeysInput) => ChartKeys;
+//# sourceMappingURL=keys.d.ts.map

package/dist/frame/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/frame/keys.ts"],"names":[],"mappings":"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"}

package/dist/frame/layout.d.ts

@@ -0,0 +1,146 @@
+/**
+ * How much room a `chart`'s guides take around its plot, and so the plot's
+ * size and centre: pure measurements (text measured through `measureLabel`)
+ * and {@link createChartLayout}, which wires them to the frame with caches
+ * so a frame of a transition re-measures nothing it measured before.
+ */
+import type { AxisOptions, XAxisPosition, YAxisPosition } from "@sophistry/core";
+import type { BandScale, Bounds, Point, Range, RangeTransition } from "@sophistry/core/geometry";
+import type { Theme } from "@sophistry/core/themes";
+import type { JoinStages, StageWindow } from "../math/join";
+import type { FittedTransition, GivenRange, MergedAxisOptions, ResolvedAxis } from "./fit";
+import { type KeyExtent } from "./guide-metrics";
+import type { ChartKeys } from "./keys";
+import type { ChartLayerExtent, ChartMargin, ChartProps, ChartSide } from "./types";
+/** A category name's font size when the axis gives none. */
+export declare const DEFAULT_CATEGORY_FONT_SIZE = 0.28;
+/** The gap between a band axis's line and its names when the axis gives none. */
+export declare const DEFAULT_CATEGORY_NUMBER_GAP = 0.16;
+/** The subtitle's font size when none is given. */
+export declare const DEFAULT_SUBTITLE_FONT_SIZE = 0.3;
+/** The gap between the title and the subtitle under it. */
+export declare const SUBTITLE_GAP = 0.14;
+/** The least of `width` (or `height`) the plot keeps when the guides beside it would take more. */
+export declare const MIN_PLOT_SHARE = 0.4;
+/** Room on the two sides of one axis of the plot. */
+export interface Sides {
+    low: number;
+    high: number;
+}
+/** The widest category name a band axis writes, in scene units; 0 when it writes none. */
+export declare function bandNamesWidth(options: MergedAxisOptions, band: BandScale, fontFamily: string): number;
+/** The chart-only keys stripped, for an axis's options to reach `numberLine`. */
+export declare function numberLineOptions(options: MergedAxisOptions): AxisOptions;
+/** What an axis's `numberLine` is given: the transition while one runs, else the resolved range. */
+export declare function axisRange(given: Range | RangeTransition | undefined, resolved: Range): Range | RangeTransition;
+/**
+ * Two ends' rooms mixed at `t`; a group's panel keeps the larger, since the
+ * group's grid holds still through a transition.
+ */
+export declare function mixRoom(from: number, to: number, t: number, grouped: boolean): number;
+/** A room measured at a range, or at each end of a range transition and mixed by its progress. */
+export declare function roomOver(range: Range | RangeTransition, measure: (at: Range) => number, grouped: boolean): number;
+/** Whether an axis's line stands on the plot's low edge (bottom, left), where its numbers hang outside. */
+export declare function atLowEdge(position: XAxisPosition | YAxisPosition, band: boolean, other: Range, otherBand: boolean): boolean;
+/** The layers' reserved margins: the widest request per side. */
+export declare function widestMargins(reports: readonly ChartLayerExtent[]): Required<ChartMargin>;
+/**
+ * The keys on the right: the legend, then the size keys under it, or beside
+ * it when the two stacked would run past `maxHeight` (read only then).
+ */
+export declare function keysColumnOf(legend: KeyExtent | undefined, size: KeyExtent | undefined, maxHeight: () => number): (KeyExtent & {
+    beside: boolean;
+}) | undefined;
+/** The keys above the plot: the legend's rows, then the size key's under them. */
+export declare function keysRowOf(legend: KeyExtent | undefined, size: KeyExtent | undefined): KeyExtent | undefined;
+/** The room keys above the plot take: the gap before them (as present as they are) and their rows. */
+export declare function keysRoom(keys: KeyExtent | undefined): number;
+/** The room the title and subtitle take above everything else, with the gap under them. */
+export declare function headingRoom(heading: {
+    title?: string;
+    titleFontSize?: number;
+    subtitle?: string;
+    subtitleFontSize?: number;
+}): number;
+/** The plot's extent along one axis: what `total` leaves after the guides, down to `MIN_PLOT_SHARE` of it. */
+export declare function plotExtent(total: number, sides: Sides): number;
+/** How far the plot's centre sits from the footprint's: toward the side with less room. */
+export declare function centerOffset(shrink: number, sides: Sides): number;
+/**
+ * A side's reserved margin in scene units: the band beside `box`, past
+ * `numbers` (that side's axis numbers), `depth` deep.
+ */
+export declare function marginBand(box: Bounds, side: ChartSide, depth: number, numbers: number): Bounds;
+/** One primary axis as the layout reads it. */
+export interface LayoutAxis {
+    options: MergedAxisOptions;
+    axis: ResolvedAxis;
+    given: GivenRange;
+    range: Range;
+    fitted: FittedTransition | undefined;
+}
+/** One secondary axis as the layout reads it. */
+export interface LayoutSecondaryAxis {
+    options: MergedAxisOptions;
+    axis: ResolvedAxis;
+    given: GivenRange;
+    has: boolean;
+}
+/** What one update of a chart's layout reads. */
+export interface ChartLayoutInput {
+    props: Readonly<ChartProps>;
+    theme: Theme;
+    /** Whether the chart is a panel of a group. */
+    grouped: boolean;
+    reports: readonly ChartLayerExtent[];
+    stage(pick: (stages: JoinStages) => StageWindow): number;
+    x: LayoutAxis;
+    y: LayoutAxis;
+    x2: LayoutSecondaryAxis;
+    y2: LayoutSecondaryAxis;
+    axisBands: {
+        x: boolean;
+        y: boolean;
+    };
+    keys: ChartKeys;
+}
+/** A chart's rooms, plot size and centre on one update. */
+export interface ChartLayout {
+    xPosition: XAxisPosition;
+    yPosition: YAxisPosition;
+    xFar: boolean;
+    yFar: boolean;
+    margin: Required<ChartMargin>;
+    leftNumbersRoom: number;
+    bottomNumbersRoom: number;
+    rightNumbersRoom: number;
+    y2NumbersRoom: number;
+    topNumbersRoom: number;
+    rightAxisRoom: number;
+    topAxisRoom: number;
+    legendColumn: KeyExtent | undefined;
+    legendRow: KeyExtent | undefined;
+    sizeColumn: KeyExtent | undefined;
+    sizeRow: KeyExtent | undefined;
+    sizeOffsets: readonly Point[];
+    keysColumn: (KeyExtent & {
+        beside: boolean;
+    }) | undefined;
+    /** The frame's keys, laid out where they go: the column on the right, or the rows on top. */
+    keysNow: KeyExtent | undefined;
+    leftRoom: number;
+    rightRoom: number;
+    topRoom: number;
+    bottomRoom: number;
+    plotWidth: number;
+    plotHeight: number;
+    center: Point;
+    titleSize: number;
+}
+/**
+ * A chart's layout. Make one per chart in `setup`; call the result in every
+ * update. Text is measured once per options and range (a range transition's
+ * frames mix their ends' measurements), legends and keys once per entry list.
+ */
+export declare function createChartLayout(): (input: ChartLayoutInput) => ChartLayout;
+//# sourceMappingURL=layout.d.ts.map

package/dist/frame/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/frame/layout.ts"],"names":[],"mappings":"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"}

package/dist/frame/registry.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A chart's layer registry: where layers report their extents.
+ *
+ * Reports are kept per layer (by an owner object) in first-report order.
+ * A report is normalised as it arrives: each axis's `values` shrink to their
+ * finite extremes (only those count for fitting), so comparing a report
+ * with the last one costs a few numbers however large the data. A report
+ * equal by value to the layer's last one changes nothing; any other change
+ * asks the chart to update (`onChange`, which only marks).
+ */
+import type { ChartLayerExtent, ChartLayers } from "./types";
+/** A report with every axis's values reduced to their extremes. */
+export declare function normaliseReport(extent: ChartLayerExtent): ChartLayerExtent;
+/**
+ * A chart's registry: {@link ChartLayers} plus the current reports.
+ *
+ * @internal
+ */
+export interface LayerRegistry extends ChartLayers {
+    /** Every layer's report, in first-report order; the same array while none changed. */
+    reports(): readonly ChartLayerExtent[];
+    /** How many layers have reported. */
+    readonly count: number;
+}
+/**
+ * Makes a registry. `onChange` runs (synchronously, possibly inside a
+ * commit) whenever the reports change; it must only mark.
+ *
+ * @internal
+ */
+export declare function createLayerRegistry(onChange: () => void): LayerRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/frame/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/frame/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAc,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAgBzE,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAa1E;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,sFAAsF;IACtF,OAAO,IAAI,SAAS,gBAAgB,EAAE,CAAC;IACvC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,aAAa,CA6BvE"}

package/dist/frame/reports.d.ts

@@ -0,0 +1,54 @@
+/**
+ * How a `chart` reads its layers' reports: the steady (blend-free) view of
+ * them, given ranges with dates, the zone an axis reads plain Temporal
+ * values in, and the shape of the keyed transition the layers report. The
+ * registry itself is `registry.ts`.
+ */
+import type { Range, RangeTransition, ScaleSpec, TimeZone } from "@sophistry/core/geometry";
+import type { DateAxis } from "../data/channels";
+import type { JoinStages, JoinStaging } from "../math/join";
+import type { ChartAxisOptions, ChartLayerExtent, ChartProps, ChartRange } from "./types";
+/** A given range with `Date` or Temporal ends read as epoch milliseconds (plain ones in `timeZone`); anything else as is. */
+export declare function numericRange(range: ChartRange | RangeTransition | undefined, timeZone: TimeZone): Range | RangeTransition | undefined;
+/** The zone an axis reads plain Temporal values in: its own, else its scale's (local for `"time"`), else UTC. */
+export declare function optionsTimeZone(options: {
+    scale?: ScaleSpec | "band";
+    timeZone?: TimeZone;
+}): TimeZone;
+/** An axis's options as given to `props`, merged over `axis`. */
+export declare function givenOptions(props: Readonly<ChartProps>, axis: DateAxis): ChartAxisOptions;
+/**
+ * A layer's report with a keyed transition's blend held out: the same
+ * object when it has no transition, else a copy whose `transition.t` is 0.
+ */
+export declare function steadyReport(report: ChartLayerExtent): ChartLayerExtent;
+/**
+ * Whether two values say the same thing: compared by value through plain
+ * objects and arrays, anything else (a colormap function, say) by identity.
+ */
+export declare function sameData(a: unknown, b: unknown): boolean;
+/** Whether two joins are staged the same. */
+export declare function sameStages(a: JoinStages | undefined, b: JoinStages | undefined): boolean;
+/**
+ * The reports with the blend held out, compared by value: the same array
+ * while no layer changed anything but its blend. Make one per chart.
+ */
+export declare function createSteadyReports(): (live: readonly ChartLayerExtent[]) => readonly ChartLayerExtent[];
+/** The blend of the first transitioning layer, if any. */
+export declare function firstBlend(live: readonly ChartLayerExtent[]): number | undefined;
+/** The shape of a keyed transition: its staging and whether any join enters or exits. */
+export interface TransitionShape {
+    staging: JoinStaging | undefined;
+    enters: boolean;
+    exits: boolean;
+}
+/** The keyed transition the layers report, steady while its blend moves; undefined without one. */
+export declare function transitionShapeOf(reports: readonly ChartLayerExtent[]): TransitionShape | undefined;
+/** Two transition shapes alike. */
+export declare function sameShape(a: TransitionShape | undefined, b: TransitionShape | undefined): boolean;
+/**
+ * Whether a layer has noted dates on `axis` and no layer reports categories
+ * there (categories keep an axis a band axis).
+ */
+export declare function datesOn(dated: ReadonlySet<DateAxis>, live: readonly ChartLayerExtent[], axis: DateAxis): boolean;
+//# sourceMappingURL=reports.d.ts.map

package/dist/frame/reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/frame/reports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,KAAK,EACL,eAAe,EACf,SAAS,EACT,QAAQ,EACR,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,KAAK,EACX,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,UAAU,EAEV,MAAM,SAAS,CAAC;AAEjB,6HAA6H;AAC7H,wBAAgB,YAAY,CAC3B,KAAK,EAAE,UAAU,GAAG,eAAe,GAAG,SAAS,EAC/C,QAAQ,EAAE,QAAQ,GAChB,KAAK,GAAG,eAAe,GAAG,SAAS,CAMrC;AAED,iHAAiH;AACjH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACxC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACpB,GAAG,QAAQ,CAKX;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAC3B,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC3B,IAAI,EAAE,QAAQ,GACZ,gBAAgB,CAUlB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAOvE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAsBxD;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,CACzB,CAAC,EAAE,UAAU,GAAG,SAAS,EACzB,CAAC,EAAE,UAAU,GAAG,SAAS,GACvB,OAAO,CAWT;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,CACtC,IAAI,EAAE,SAAS,gBAAgB,EAAE,KAC7B,SAAS,gBAAgB,EAAE,CAoB/B;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CACzB,IAAI,EAAE,SAAS,gBAAgB,EAAE,GAC/B,MAAM,GAAG,SAAS,CAGpB;AAED,yFAAyF;AACzF,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CACf;AAED,mGAAmG;AACnG,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAClC,eAAe,GAAG,SAAS,CAY7B;AAED,mCAAmC;AACnC,wBAAgB,SAAS,CACxB,CAAC,EAAE,eAAe,GAAG,SAAS,EAC9B,CAAC,EAAE,eAAe,GAAG,SAAS,GAC5B,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACtB,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC5B,IAAI,EAAE,SAAS,gBAAgB,EAAE,EACjC,IAAI,EAAE,QAAQ,GACZ,OAAO,CAGT"}

package/dist/frame/secondary-axes.d.ts

@@ -0,0 +1,74 @@
+/**
+ * `secondaryX` and `secondaryY`: the layers inside map one axis through the
+ * enclosing chart's secondary scale. They provide lifted versions of the
+ * chart's contexts to their children: the frame and coordinate system
+ * through the secondary axis, a report sink that moves the layers' extents
+ * onto it, and a date sink that notes dates there.
+ */
+import type { SceneNode } from "@sophistry/core";
+/**
+ * Props for {@link secondaryY}.
+ *
+ * @category Charts
+ */
+export interface SecondaryYProps {
+    /** The layers to map through the secondary y axis. */
+    children?: readonly SceneNode[];
+}
+/**
+ * Props for {@link secondaryX}.
+ *
+ * @category Charts
+ */
+export interface SecondaryXProps {
+    /** The layers to map through the secondary x axis. */
+    children?: readonly SceneNode[];
+}
+/**
+ * A secondary y axis, drawn on the plot's right edge. Layers inside share
+ * the chart's x axis, colours, legend and reveal but map y through the
+ * chart's `y2Range`, `y2Axis` and `y2Label`. Only inside a `chart`.
+ *
+ * @example
+ * ```ts
+ * import { bars, chart, linePlot, secondaryY } from "@sophistry/charts";
+ *
+ * const data = [
+ * 	{ month: "Jan", temp: 3, rain: 60 },
+ * 	{ month: "Feb", temp: 4, rain: 45 },
+ * 	{ month: "Mar", temp: 8, rain: 50 },
+ * ];
+ * chart.create({
+ * 	width: 8,
+ * 	height: 4,
+ * 	y2Label: "rain (mm)",
+ * 	children: [
+ * 		linePlot.create({ data, x: "month", y: "temp" }),
+ * 		secondaryY.create({ children: [bars.create({ data, category: "month", value: "rain" })] }),
+ * 	],
+ * });
+ * ```
+ *
+ * @see https://sophistry.dev/guides/charts/#the-chart-frame
+ * @category Charts
+ */
+export declare const secondaryY: import("@sophistry/core").Definition<{
+    children?: readonly SceneNode[];
+}, import("@sophistry/core/internal").CompositeNode<{
+    children?: readonly SceneNode[];
+}>, "children">;
+/**
+ * A secondary x axis, drawn along the plot's top edge. Layers inside share
+ * the chart's y axis, colours, legend and reveal but map x through the
+ * chart's `x2Range`, `x2Axis` and `x2Label`. Nest it with
+ * {@link secondaryY} for both. Only inside a `chart`.
+ *
+ * @see https://sophistry.dev/guides/charts/#the-chart-frame
+ * @category Charts
+ */
+export declare const secondaryX: import("@sophistry/core").Definition<{
+    children?: readonly SceneNode[];
+}, import("@sophistry/core/internal").CompositeNode<{
+    children?: readonly SceneNode[];
+}>, "children">;
+//# sourceMappingURL=secondary-axes.d.ts.map

package/dist/frame/secondary-axes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secondary-axes.d.ts","sourceRoot":"","sources":["../../src/frame/secondary-axes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AASnE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAChC;AAmDD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,UAAU;eA7Dc,SAAS,SAAS,EAAE;;;eA6DX,CAAC;AAE/C;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;eAxEc,SAAS,SAAS,EAAE;;;eAwEX,CAAC"}