@sophistry/charts 0.0.0-stage → 0.0.1

package/dist/data/channels.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Data channels: how a chart reads one field out of each datum. A channel
+ * is a key of the datum (`x="year"`, type-checked against `T`) or a function
+ * `(d, i) => value`. Singular props are channels, plural ones (`xs`,
+ * `colors`, `edges`) literal arrays. With `number[]` data the main numeric
+ * channel defaults to the datum itself. Colour is a constant or a function,
+ * never a key; colour by a field with `series`. Dates in positional
+ * channels are read as epoch milliseconds.
+ *
+ * @packageDocumentation
+ */
+import type { ContextKey } from "@sophistry/core";
+import type { ColorInput } from "@sophistry/core/color";
+import type { TemporalValue, TimeZone } from "@sophistry/core/geometry";
+/**
+ * A channel function: reads one value from a datum and its index.
+ *
+ * @category Channels
+ */
+export type ChannelFn<T, V> = (datum: T, index: number) => V;
+/**
+ * The keys of `T` whose values suit a `V`-valued channel (`V`, `null` or `undefined`).
+ *
+ * @category Channels
+ */
+export type ChannelKey<T, V> = [T] extends [object] ? {
+    [K in keyof T & string]-?: T[K] extends V | null | undefined ? K : never;
+}[keyof T & string] : never;
+/**
+ * Where a chart finds a `V` in each `T`: a key of `T` whose value is a `V`,
+ * or a function `(d, i) => V`.
+ *
+ * @see https://sophistry.dev/guides/charts/#data-and-channels
+ * @category Channels
+ */
+export type Channel<T, V> = ChannelKey<T, V> | ChannelFn<T, V>;
+/**
+ * A position on a continuous axis, as positional channels (`x`, `y`, `x1`,
+ * …) accept it: a number, a `Date`, or a Temporal value (`Instant`,
+ * `ZonedDateTime`, `PlainDate`, `PlainDateTime`).
+ *
+ * @see https://sophistry.dev/guides/charts/#dates-and-time-zones
+ * @category Channels
+ */
+export type PositionValue = number | Date | TemporalValue;
+/**
+ * What a channel of `V`s reads once resolved: dates become epoch
+ * milliseconds, anything else is as given.
+ *
+ * @category Channels
+ */
+export type ChannelRead<V> = V extends Date | TemporalValue ? number : V;
+/**
+ * A number: one constant for every datum, or a per-datum {@link Channel}.
+ *
+ * @category Channels
+ */
+export type Quantity<T> = number | Channel<T, number>;
+/**
+ * A colour: one constant (a CSS string or a `Color` such as `BLUE`) or
+ * `(d, i) => colour`. No key form: a string is always a colour.
+ *
+ * @category Channels
+ */
+export type ColorChannel<T> = ColorInput | ChannelFn<T, ColorInput>;
+/**
+ * Placeholder type of a required channel prop; see {@link RequiredUnless}.
+ * Its name is what a "missing property" error shows.
+ *
+ * @category Channels
+ */
+export interface RequiredChannel<T, V> {
+    /** @internal */
+    readonly __channel?: [T, V];
+}
+/**
+ * Makes the channel prop `K` required unless `T` is already a `V` (then the
+ * channel defaults to the datum itself; nullish members of `T` don't
+ * count). Intersect it with a props interface declaring `K` as an optional
+ * {@link Channel}; `T` stays inferred from `data`.
+ *
+ * @category Channels
+ */
+export type RequiredUnless<T, V, K extends string> = [NonNullable<T>] extends [
+    V
+] ? unknown : {
+    [P in K]-?: RequiredChannel<T, V>;
+};
+/** The identity channel, the default for `number[]` data. */
+export declare const identity: <T, V>(datum: T) => V;
+/** Position of a datum: the default `x` channel for `number[]` data. */
+export declare const indexOf: (_datum: unknown, index: number) => number;
+/**
+ * Turns a {@link Channel} into a plain function: a key reads that property,
+ * a function is called as is. Dates come back as epoch milliseconds (plain
+ * Temporal dates in the axis's `timeZone`, else UTC); read through a
+ * positional channel under a `<Chart>`, they also make that axis a time
+ * axis. An omitted channel resolves to `fallback`, or `undefined`.
+ *
+ * A mark passes the {@link DateSink} it read from {@link dateSinkContext}.
+ *
+ * @param fallback - Used when `channel` is `undefined`.
+ * @param name - Prop name for the error message.
+ * @param sink - Where a positional channel notes dates (the enclosing chart's).
+ * @throws {TypeError} If `channel` is neither a function nor a string or symbol key.
+ * @category Channels
+ */
+export declare function resolveChannel<T, V>(channel: Channel<T, V>, fallback?: undefined, name?: string, sink?: DateSink | null): ChannelFn<T, ChannelRead<V>>;
+export declare function resolveChannel<T, V>(channel: Channel<T, V> | undefined, fallback: ChannelFn<T, V>, name?: string, sink?: DateSink | null): ChannelFn<T, ChannelRead<V>>;
+export declare function resolveChannel<T, V>(channel: Channel<T, V> | undefined, fallback?: undefined, name?: string, sink?: DateSink | null): ChannelFn<T, ChannelRead<V>> | undefined;
+/** An axis a channel's dates can be noted on: a chart's own, or a secondary one. */
+export type DateAxis = "x" | "y" | "x2" | "y2";
+/**
+ * Where positional channels note that they read dates, so `<Chart>` can
+ * infer a `"utc"` scale; also gives the zone an axis reads plain Temporal
+ * dates in.
+ *
+ * @category Extending
+ */
+export interface DateSink {
+    note(axis: DateAxis): void;
+    /** The zone `axis` names, if any, else `"UTC"`. */
+    timeZone(axis: DateAxis): TimeZone;
+}
+/**
+ * Provided by `chart` (and redirected by `secondaryX`/`secondaryY`); outside
+ * one (3D charts, transforms) it is null. Marks read it with
+ * `ctx.context(dateSinkContext)` and pass it to {@link resolveChannel}.
+ *
+ * @category Extending
+ */
+export declare const dateSinkContext: ContextKey<DateSink | null>;
+/**
+ * A {@link Quantity} as a function: a constant ignores the datum. An omitted
+ * quantity resolves to `fallback`, or `undefined`.
+ *
+ * @category Channels
+ */
+export declare function resolveQuantity<T>(quantity: Quantity<T>): ChannelFn<T, number>;
+export declare function resolveQuantity<T>(quantity: Quantity<T> | undefined, fallback: ChannelFn<T, number>): ChannelFn<T, number>;
+export declare function resolveQuantity<T>(quantity: Quantity<T> | undefined): ChannelFn<T, number> | undefined;
+/**
+ * Reads a channel across `data`.
+ *
+ * @param name - Prop name for the error message.
+ * @returns One value per datum, in order (dates as epoch milliseconds).
+ * @category Channels
+ */
+export declare function channelValues<T, V>(data: readonly T[], channel: Channel<T, V> | undefined, fallback?: ChannelFn<T, V>, name?: string, sink?: DateSink | null): (ChannelRead<V> | undefined)[];
+/**
+ * {@link channelValues} for a numeric channel: non-numbers become `NaN`
+ * (which charts skip), dates epoch milliseconds.
+ *
+ * @category Channels
+ */
+export declare function numberValues<T, V extends PositionValue = PositionValue>(data: readonly T[], channel: Channel<T, V> | undefined, fallback?: ChannelFn<T, NoInfer<V>>, name?: string, sink?: DateSink | null): number[];
+/**
+ * A {@link ColorChannel} as a function, or `undefined` when omitted.
+ *
+ * @category Channels
+ */
+export declare function resolveColor<T>(color: ColorChannel<T> | undefined): ChannelFn<T, string> | undefined;
+/**
+ * Colour of datum `i`: the per-datum `color` if given, else the `colors`
+ * palette cycled by index, else `fallback`.
+ *
+ * @param fallback - Used when the palette is empty.
+ * @category Channels
+ */
+export declare function colorResolver<T>(color: ColorChannel<T> | undefined, palette: readonly ColorInput[], fallback: ColorInput): ChannelFn<T, string>;
+//# sourceMappingURL=channels.d.ts.map

package/dist/data/channels.d.ts.map

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

package/dist/end-space.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Where a keyed mark draws each end of its transition when a fitted axis
+ * changes kind between them (band ↔ continuous). Internal.
+ */
+import type { CoordinateSystem } from "@sophistry/core";
+import type { BandScale, Point } from "@sophistry/core/geometry";
+import type { ChartEnds, ChartFrame } from "./frame/types";
+import type { JoinEnd, JoinFrame } from "./join";
+import type { AreaPoint } from "./math/morph";
+/**
+ * What a mark's geometry maps through: a plot's `coordsToPoint`, {@link SCENE_UNITS},
+ * or mid-swap one of {@link EndSpace.morph}'s mixed-unit mappings.
+ */
+export interface Mapper extends Pick<CoordinateSystem, "coordsToPoint"> {
+    /** Which coordinates `coordsToPoint` takes already in scene units (the swapping axes, mid-swap); the rest it maps from data units. */
+    scene?: {
+        x: boolean;
+        y: boolean;
+    };
+}
+/** A mapping for geometry already in scene units: `coordsToPoint` returns its point as given. */
+export declare const SCENE_UNITS: Mapper;
+/** Area runs through `coords`, for a mid-swap area morph; runs reversed by the mapping are turned around so the morph still blends per x. */
+export declare function sceneAreaRuns(runs: readonly (readonly AreaPoint[])[], coords: Mapper): AreaPoint[][];
+/** Where a mark draws each end of its keyed transition: see {@link endSpace}. */
+export interface EndSpace {
+    /** The plot at each end while a fitted axis changes kind (see {@link ChartEnds}); undefined otherwise. */
+    ends: ChartEnds | undefined;
+    /** The coordinates a datum of `end` maps through: that end's plot mid-swap, else the mark's own. */
+    coords(end: JoinEnd): CoordinateSystem;
+    /** A band axis's scale at `end`: that end's mid-swap, else the chart's now. */
+    band(end: JoinEnd, axis: "x" | "y"): BandScale | undefined;
+    /**
+     * A key in both ends, in scene units at update progress `u`, from `a` (its
+     * `data` datum) to `b` (its `to` datum). Mid-swap, the swapping axis blends
+     * in scene units between the two ends' plots. Exact at `u` 0 and 1.
+     */
+    point(a: Point, b: Point, u: number): Point;
+    /** Whether a kind swap runs; marks building their own geometry then build each end through its own `coords` and blend in scene units. */
+    swapping: boolean;
+    /**
+     * A per-datum mark's anchor on one key's frame, in scene units. `anchor`
+     * reads one end's state as a data-unit point. Mid-swap, a key in both ends
+     * blends between its two ends' anchors; any other maps through its own end.
+     */
+    place<S>(frame: JoinFrame<S>, anchor: (state: S, end: JoinEnd) => Point): Point;
+    /**
+     * A per-datum mark's own geometry on one key's frame: `build` maps one
+     * end's state through given coordinates. Mid-swap, a key in both ends
+     * builds each end through its own plot and `blend`s them in scene units.
+     */
+    shape<S, G>(frame: JoinFrame<S>, build: (state: S, end: JoinEnd, coords: CoordinateSystem) => G | null, blend: (a: G, b: G, u: number) => G): G | null;
+    /**
+     * A grouped mark's shape for a group in both ends at update progress `u`.
+     * Without a swap, `morph` blends in data units and `build` maps through the
+     * mark's coordinates. Mid-swap, only the swapping axis blends in scene
+     * units (via `scene`), so an axis that keeps its kind (log, sqrt) morphs
+     * exactly as without a swap. Exact at `u` 0 and 1.
+     */
+    morph<S, G>(a: S, b: S, u: number, spec: {
+        scene: (state: S, coords: Mapper, end: JoinEnd) => S;
+        morph: (a: S, b: S, u: number) => S;
+        build: (state: S, coords: Mapper, end: JoinEnd) => G;
+    }): G;
+    /** Where the axes are drawn at `end`, in data units: that end's own mid-swap, else the chart's; outside a chart, the crossing. */
+    axesAt(end: JoinEnd): {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Plumbing for a keyed mark in a {@link Chart} whose fitted axis changes
+ * kind between the ends (a bar chart's categories becoming a number line).
+ * Keys in both ends move from where end A draws them to where end B does,
+ * leaving keys draw through end A, entering keys through end B, so nothing
+ * jumps when the plot switches axes. Without a swap every method is the
+ * plain path. Call in each `update` with the frame and coordinates it read.
+ *
+ * @param coords - The coordinates the mark otherwise draws through.
+ */
+export declare function endSpace(frame: ChartFrame | null, coords: CoordinateSystem): EndSpace;
+//# sourceMappingURL=end-space.d.ts.map

package/dist/end-space.d.ts.map

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

package/dist/entries/definitions.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `@sophistry/charts/definitions`: every definition the package's main
+ * entry exports, keyed by export name. What `@sophistry/codegen` reads
+ * to generate the framework bindings' chart components (`export const
+ * Scatter = wrap(scatter);`).
+ *
+ * Collected from the main entry's exports, so a definition is picked up as
+ * soon as it is exported from `@sophistry/charts`. Kept off the main
+ * entry: reading the whole module namespace would defeat tree shaking.
+ *
+ * @module @sophistry/charts/definitions
+ */
+import * as entry from "../index";
+/**
+ * Every definition `@sophistry/charts` exports, by export name
+ * (`{ chart, scatter, ... }`).
+ *
+ * @category Charts
+ */
+export declare const definitions: import("@sophistry/core/definitions").DefinitionExports<typeof entry>;
+//# sourceMappingURL=definitions.d.ts.map

package/dist/entries/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/entries/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,KAAK,MAAM,UAAU,CAAC;AAElC;;;;;GAKG;AACH,eAAO,MAAM,WAAW,uEAA4B,CAAC"}

package/dist/entries/definitions.js

@@ -0,0 +1,6 @@
+import { t as e } from "../src-CwGo1bes.js";
+import { collectDefinitions as t } from "@sophistry/core/definitions";
+//#region src/entries/definitions.ts
+var n = t(e);
+//#endregion
+export { n as definitions };

package/dist/frame/band-axis.d.ts

@@ -0,0 +1,43 @@
+/**
+ * A chart's categorical axis: the line the bands stand on, and a name under
+ * (or beside) each band. Internal to the frame (and a group's guides); not
+ * exported from the package entry.
+ */
+import type { AxisOptions, CoordinateSystem } from "@sophistry/core";
+import type { BandKey, BandScale } from "@sophistry/core/geometry";
+import type { MergedAxisOptions } from "./fit";
+/**
+ * Props for {@link bandAxis}.
+ *
+ * @category Extending
+ */
+export interface BandAxisProps {
+    band: BandScale;
+    /** A category name's opacity, 0..1 (a keyed transition fading it in or out). @default 1 */
+    weight?: (key: BandKey) => number;
+    options: MergedAxisOptions;
+    /** An outline around each name; see `LabelProps.halo`. */
+    halo?: AxisOptions["numberHalo"];
+    coords: CoordinateSystem;
+    along: "x" | "y";
+    /** The other axis's value the line sits at, in data units. */
+    at: number;
+    /** Where the line sits across the plot in scene units, in place of `at` (mid-swap). */
+    across?: number;
+    /** On the top or right edge: names face outward (up, right). */
+    far?: boolean;
+    /** The whole axis's opacity, 0..1 (a kind swap's cross-fade). @default 1 */
+    opacity?: number;
+    progress: number;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * A categorical axis: the line the bands stand on, and a name under (or
+ * beside) each band, faded by `weight` and by where the band sits in a
+ * zoomed window.
+ *
+ * @category Extending
+ */
+export declare const bandAxis: import("@sophistry/core").Definition<BandAxisProps, import("@sophistry/core/internal").CompositeNode<BandAxisProps>, keyof BandAxisProps>;
+//# sourceMappingURL=band-axis.d.ts.map

package/dist/frame/band-axis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"band-axis.d.ts","sourceRoot":"","sources":["../../src/frame/band-axis.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,WAAW,EAEX,gBAAgB,EAEhB,MAAM,iBAAiB,CAAC;AAazB,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAS,MAAM,0BAA0B,CAAC;AAM1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAM/C;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;IAClC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IACjC,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC;IACjB,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AA2ID;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,2IAmBnB,CAAC"}

package/dist/frame/coords.d.ts

@@ -0,0 +1,112 @@
+/**
+ * A `chart`'s coordinate systems: the plot through its primary and
+ * secondary axes, the ghost and end mappings of an axis changing kind, and
+ * where the axes stand.
+ *
+ * {@link createChartCoords} is made once per chart; its function runs on
+ * every update and returns the same coordinate system objects while their
+ * mapping is unchanged (they are immutable, so a new one means the mapping
+ * moved).
+ */
+import type { CoordinateSystem, XAxisPosition, YAxisPosition } from "@sophistry/core";
+import type { Bounds, Point, Range } from "@sophistry/core/geometry";
+import type { JoinStages, StageWindow } from "../math/join";
+import type { AxisEnds, MergedAxisOptions, ResolvedAxis } from "./fit";
+import type { SecondaryFlags } from "./secondary";
+import type { ChartEnd, ChartEnds } from "./types";
+/** A kind's crossing on an axis: a band axis's first slot, a continuous one's zero (or nearest end). */
+export declare const crossingOf: (axis: ResolvedAxis) => number;
+/** What one update of the chart's coordinates reads. */
+export interface ChartCoordsInput {
+    xOptions: MergedAxisOptions;
+    yOptions: MergedAxisOptions;
+    x: {
+        axis: ResolvedAxis;
+        range: Range;
+    };
+    y: {
+        axis: ResolvedAxis;
+        range: Range;
+    };
+    x2: {
+        axis: ResolvedAxis;
+        range: Range;
+        options: MergedAxisOptions;
+    };
+    y2: {
+        axis: ResolvedAxis;
+        range: Range;
+        options: MergedAxisOptions;
+    };
+    /** The primary axes' fitted ends (steady while the blend moves). */
+    xEnds: AxisEnds | undefined;
+    yEnds: AxisEnds | undefined;
+    /** The other end of an axis changing kind mid-swap. */
+    xGhost: ResolvedAxis | undefined;
+    yGhost: ResolvedAxis | undefined;
+    axisBands: {
+        x: boolean;
+        y: boolean;
+    };
+    xPosition: XAxisPosition;
+    yPosition: YAxisPosition;
+    plotWidth: number;
+    plotHeight: number;
+    center: Point;
+    stage(pick: (stages: JoinStages) => StageWindow): number;
+}
+/** A chart's coordinate systems on one update. */
+export interface ChartCoords {
+    /** The plot through the primary axes. */
+    coords: CoordinateSystem;
+    /** y through `y2`. */
+    coords2: CoordinateSystem;
+    /** x through `x2`. */
+    coords3: CoordinateSystem;
+    /** Both secondary axes. */
+    coords4: CoordinateSystem;
+    /** The plot through a kind-swapping x axis's ghost. */
+    ghostX: CoordinateSystem;
+    /** The plot through a kind-swapping y axis's ghost. */
+    ghostY: CoordinateSystem;
+    /** Where a kind-swapping axis's ghost stands across the other axis, in data units. */
+    ghostAt(axis: "x" | "y", ghost: ResolvedAxis): number;
+    /** Which fitted axes change kind across the keyed transition, if any. */
+    kindSwap: {
+        x: boolean;
+        y: boolean;
+    } | undefined;
+    /** The ends a context's layers see (see {@link ChartEnds}). */
+    endsThrough(flags: SecondaryFlags): ChartEnds | undefined;
+    /** The primary context's ends, with their mappings even when no axis swaps. */
+    primaryEnds: {
+        ends: ChartEnds | undefined;
+        from: ChartEnd;
+        to: ChartEnd;
+    };
+    /** Mid-swap, where the axes stand at each end blended in scene units. */
+    swapOrigin: (Point & {
+        x2: boolean;
+        y2: boolean;
+    }) | undefined;
+    /** Where each axis is drawn, in data units. */
+    axesAt: {
+        x: number;
+        y: number;
+    };
+    /** The y value the x axis runs along. */
+    xAxisAt: number;
+    /** The x value the y axis stands at. */
+    yAxisAt: number;
+    /** Where the axes are drawn, in scene units. */
+    origin: Point;
+    /** Where the axes' titles hang from. */
+    titlesAt: Point;
+    area: Bounds;
+}
+/**
+ * The chart's coordinate systems and where its axes stand. Make one per
+ * chart in `setup`; call the result in every update.
+ */
+export declare function createChartCoords(): (input: ChartCoordsInput) => ChartCoords;
+//# sourceMappingURL=coords.d.ts.map

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

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

package/dist/frame/fit.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Fitting one axis of a `chart` to its layers' reports: resolving,
+ * comparing, and transitioning axes, and {@link createAxisFit}, made once
+ * per axis (`x`, `y`, `x2`, `y2`) in the chart's `setup`.
+ *
+ * Each step is a function of the chart's current inputs with a last-value
+ * cache, so a step whose inputs
+ * kept their identity returns its last result (and a result equal by value
+ * to the last keeps the last one's identity, so the coordinate systems and
+ * guides downstream see nothing new).
+ */
+import type { BandKey, BandScale, Range, RangeTransition, ScaleSpec, TimeZone } from "@sophistry/core/geometry";
+import type { JoinStages, StageWindow } from "../math/join";
+import type { AxisExtent, ChartLayerExtent, ChartXAxisOptions, ChartYAxisOptions, LayerTransition } from "./types";
+/** One axis's options once `axis` and `xAxis`/`yAxis` are merged. */
+export type MergedAxisOptions = ChartXAxisOptions | ChartYAxisOptions;
+/** A range as given: fixed, or a transition between two. */
+export type GivenRange = Range | RangeTransition | undefined;
+/** How far a stage of the frame's keyed transition has got (0 without one). */
+export type StageAt = (pick: (stages: JoinStages) => StageWindow) => number;
+/** An axis as the plot maps through it: a band scale, or a continuous scale's range. */
+export type ResolvedAxis = {
+    kind: "band";
+    band: BandScale;
+    range: Range;
+} | {
+    kind: "continuous";
+    scale: ScaleSpec;
+    range: Range;
+    base?: number;
+    timeZone?: TimeZone;
+};
+/** Whether an axis's scale is plain linear (the default). */
+export declare function linearScale(scale: ScaleSpec | "band" | undefined): boolean;
+export declare function resolveAxis(options: MergedAxisOptions, fixed: Range | undefined, reports: readonly AxisExtent[], vertical: boolean): ResolvedAxis;
+/** A secondary axis when no layer maps through it (and the stand-in for a band one). */
+export declare const NO_SECONDARY_AXIS: ResolvedAxis;
+/** Both ends of an axis fitted for a keyed transition. */
+export interface AxisEnds {
+    from: ResolvedAxis;
+    to: ResolvedAxis;
+}
+/** How an axis changes over a keyed transition (see `rescaleKind`). */
+export type RescaleChange = "none" | "expand" | "contract" | "shift";
+/** A fitted axis's own transition while a keyed one runs. */
+export type FittedTransition = {
+    kind: "continuous";
+    range: RangeTransition;
+} | {
+    kind: "band";
+    band: BandScale;
+    from: BandScale;
+    to: BandScale;
+} | AxisSwap;
+/**
+ * A fitted axis that changes kind over a keyed transition (band ↔
+ * continuous): the two axes cross-fade over the update stage, the plot
+ * mapping through the near end's axis until its midpoint.
+ */
+export interface AxisSwap {
+    kind: "swap";
+    from: ResolvedAxis;
+    to: ResolvedAxis;
+    u: number;
+}
+export declare function sameAxis(a: ResolvedAxis, b: ResolvedAxis): boolean;
+/**
+ * How long an axis's range is in its own units: bands on a band axis, the
+ * logarithm's span on a log axis, the plain difference otherwise.
+ */
+export declare function axisSpan(axis: ResolvedAxis): number;
+/** {@link sameAxis}, and for a band axis every category in the same place (a blended or slotted band moves them). */
+export declare function samePlacement(a: ResolvedAxis, b: ResolvedAxis): boolean;
+/** Two optional axes placing everything alike. */
+export declare function sameOptionalPlacement(a: ResolvedAxis | undefined, b: ResolvedAxis | undefined): boolean;
+export declare function sameRangeEnds(a: {
+    from: Range;
+    to: Range;
+} | undefined, b: {
+    from: Range;
+    to: Range;
+} | undefined): boolean;
+export declare function sameEnds(a: AxisEnds | undefined, b: AxisEnds | undefined): boolean;
+/** How an axis's fitted range (or category count) changes between the ends. */
+export declare function endsKind(ends: AxisEnds | undefined): RescaleChange;
+/** A fixed range as shown now: itself, or a transition's blend. */
+export declare function shownRange(range: GivenRange, options: MergedAxisOptions): Range | undefined;
+/** Both ends of an axis fitted during a keyed transition; undefined when nothing transitions or the range is given. */
+export declare function fittedEnds(transitioning: boolean, options: MergedAxisOptions, given: GivenRange, list: readonly ChartLayerExtent[], pick: (report: ChartLayerExtent) => AxisExtent | undefined, pickTo: (transition: LayerTransition) => AxisExtent | undefined, vertical: boolean): AxisEnds | undefined;
+/**
+ * The axis the plot maps through now: mid-swap the near end's, on a fitted
+ * transition its blend, else resolved from `extents`. A band axis's `slot`
+ * applies last.
+ */
+export declare function axisNow(options: MergedAxisOptions, given: GivenRange, fit: FittedTransition | undefined, extents: readonly AxisExtent[], vertical: boolean, resolve?: typeof resolveAxis): ResolvedAxis;
+/** A category's strength on a band axis mid-transition: leaving ones fade with the exits, new ones with the enters. */
+export declare function bandWeight(fit: FittedTransition | undefined, stage: StageAt): ((key: BandKey) => number) | undefined;
+/** An axis changing kind through a keyed transition, as its guides draw it. */
+export interface AxisSwapView {
+    /** The opacity of the axis mapped through now. */
+    fade: number;
+    /** The other end, drawn at the rest; undefined outside the update stage. */
+    ghost: ResolvedAxis | undefined;
+}
+/**
+ * An axis changing kind through a keyed transition: `fade` is the opacity of
+ * the axis mapped through now, `ghost` the other end drawn at the rest. Make
+ * one per axis; the ghost keeps its identity while it places alike.
+ */
+export declare function createAxisSwap(): (fit: FittedTransition | undefined) => AxisSwapView;
+/** A secondary axis's range aligned with its primary's ticks, or fitted on its own when no alignment fits. */
+export declare function alignedToPrimary(range: Range, list: readonly AxisExtent[], mine: MergedAxisOptions, primary: MergedAxisOptions): Range;
+/** What one update of an axis's fit reads. Every field keeps its identity while unchanged. */
+export interface AxisFitInput {
+    options: MergedAxisOptions;
+    /** The range given for the axis, if any. */
+    given: GivenRange;
+    /** The reports the axis is fitted to (blends held out). */
+    reports: readonly ChartLayerExtent[];
+    /** Whether a keyed transition runs (steady while its blend moves). */
+    transitioning: boolean;
+    /** A secondary axis's state (see `secondaryFit`). */
+    secondary?: {
+        has: boolean;
+        aligns: boolean;
+        alignedEnds: {
+            from: Range;
+            to: Range;
+        } | undefined;
+    };
+}
+/** One axis as drawn on one update. */
+export interface PlacedAxis {
+    /** The fitted axis's own transition while a keyed one runs. */
+    fitted: FittedTransition | undefined;
+    /** The range as given, or the fitted transition while one runs: what the number line is given. */
+    given: GivenRange;
+    /** The axis the plot maps through now (identity kept while it places alike). */
+    axis: ResolvedAxis;
+    /** Its range (identity kept while equal). */
+    range: Range;
+}
+/** What {@link createAxisFit} fits an axis from. */
+export interface AxisFitDeps {
+    /** A report's extent on this axis. */
+    pick(report: ChartLayerExtent): AxisExtent | undefined;
+    /** A transitioning report's far end's extent on this axis. */
+    pickTo(transition: LayerTransition): AxisExtent | undefined;
+    /** The extents the axis is fitted to at rest; every report's `pick` by default. */
+    extents?: (reports: readonly ChartLayerExtent[]) => AxisExtent[];
+    vertical: boolean;
+    /** A secondary axis: continuous only, ranged by `alignedEnds` with `alignTicks`. */
+    secondary?: boolean;
+}
+/** One axis's fit; see {@link createAxisFit}. */
+export interface AxisFit {
+    /** Both ends during a keyed transition (steady while the blend moves); identity kept while equal. */
+    ends(input: AxisFitInput): AxisEnds | undefined;
+    /** How the axis rescales between the ends. */
+    change(input: AxisFitInput): RescaleChange;
+    /** The axis as drawn now. `primaryGiven` is the primary's given range, for a secondary axis. */
+    place(input: AxisFitInput, stage: StageAt, primaryGiven?: GivenRange): PlacedAxis;
+}
+/**
+ * One axis's fit, in two steps around the frame's transition stages:
+ * `ends` and `change` read only steady inputs and feed the stages;
+ * `place(stage)` gives the axis as drawn each update, compared by placement
+ * so unchanged frames keep every identity. Make one per axis in `setup`.
+ */
+export declare function createAxisFit(deps: AxisFitDeps): AxisFit;
+//# sourceMappingURL=fit.d.ts.map

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

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