svelteplot 0.3.5-pr-121.9 → 0.3.5

package/dist/types.d.ts

@@ -0,0 +1,834 @@
+import type { ScaleBand, ScaleLinear, ScaleOrdinal } from 'd3-scale';
+import type { ComponentProps, Snippet } from 'svelte';
+import type { MouseEventHandler } from 'svelte/elements';
+import type { MarkerShape } from './marks/helpers/Marker.svelte';
+import type { Writable } from 'svelte/store';
+import type * as CSS from 'csstype';
+import type { Area, AreaX, AreaY, Arrow, AxisX, AxisY, BarX, BarY, BoxX, BoxY, Brush, BrushX, BrushY, Cell, Dot, Frame, Geo, Graticule, GridX, GridY, Line, Link, Pointer, Rect, RectX, RectY, RuleX, RuleY, Sphere, Spike, Text, TickX, TickY, Vector } from './marks';
+import type { GeoProjection } from 'd3-geo';
+import type { Clip } from './helpers/projection';
+export type MarkType = 'area' | 'arrow' | 'axisX' | 'axisY' | 'barX' | 'barY' | 'cell' | 'dot' | 'vector' | 'frame' | 'geo' | 'gridX' | 'gridY' | 'line' | 'rect' | 'regression' | 'ruleX' | 'ruleY' | 'swoopyArrow' | 'text' | 'tickX' | 'tickY';
+export type ScaleName = 'x' | 'y' | 'r' | 'color' | 'opacity' | 'length' | 'symbol' | 'fx' | 'fy' | 'projection';
+export type ScaleType = 'linear' | 'pow' | 'sqrt' | 'log' | 'symlog' | 'time' | 'point' | 'ordinal' | 'sequential' | 'band' | 'categorical' | 'cyclical' | 'threshold' | 'quantile-cont' | 'quantile' | 'quantize' | 'diverging' | 'diverging-log' | 'diverging-pow' | 'diverging-sqrt' | 'diverging-symlog';
+export type Mark<T> = {
+    id: symbol;
+    type: MarkType;
+    channels: ScaledChannelName[];
+    scales: Set<ScaleName>;
+    data: DataRecord<T>[];
+    options: T;
+};
+export type ScaledChannelName = 'fill' | 'fillOpacity' | 'opacity' | 'r' | 'length' | 'stroke' | 'strokeOpacity' | 'symbol' | 'fx' | 'fy' | 'x' | 'x1' | 'x2' | 'y' | 'y1' | 'y2';
+export type ChannelName = ScaledChannelName | 'z' | 'sort' | 'filter' | 'interval';
+export type RawValue = number | Date | boolean | string | symbol;
+export type ScaleOptions = {
+    /**
+     * Override the automatic scale type detection.
+     */
+    type: ScaleType | 'auto';
+    /**
+     * Set a custom domain for the scale instead of auto-computing the domain
+     * from the mark data channels.
+     */
+    domain?: RawValue[];
+    /**
+     * Set a custom range for the scale.
+     */
+    range?: RawValue[];
+    /**
+     * Reverse the scale.
+     */
+    reverse: boolean;
+    label?: string;
+    interval?: string | number;
+    clamp: boolean;
+    nice: boolean;
+    zero: boolean;
+    round: boolean;
+    percent: boolean;
+    transform?: (d: RawValue) => RawValue;
+    /**
+     * set the padding for band scales
+     */
+    padding: number;
+    /**
+     * set the align for band or point scales
+     */
+    align: number;
+    /**
+     * set the inner padding for band scales
+     */
+    paddingInner?: number;
+    /**
+     * set the outer padding for band scales
+     */
+    paddingOuter?: number;
+    insetLeft?: number;
+    insetRight?: number;
+    insetTop?: number;
+    insetBottom?: number;
+    ticks?: (number | Date)[];
+    tickSpacing: number;
+    base?: number;
+    sort?: ChannelAccessor | ((a: RawValue, b: RawValue) => number) | {
+        channel: string;
+        order: 'ascending' | 'descending';
+    };
+    constant?: number;
+};
+export type ColorScaleOptions = ScaleOptions & {
+    legend: boolean;
+    type: ScaleType | 'categorical' | 'sequential' | 'cyclical' | 'threshold' | 'quantile' | 'quantize' | 'diverging' | 'diverging-log' | 'diverging-pow' | 'diverging-sqrt' | 'diverging-symlog';
+    scheme: string;
+    /**
+     * fallback color used for null/undefined
+     */
+    unknown: string;
+    /**
+     * center value for diverging scales
+     */
+    pivot: number;
+    /**
+     * number of colors for quantize and quantile-threshold scales
+     */
+    n: number;
+    interpolate: (d: any) => typeof d;
+    /**
+     * The tick format for the color scale legend.
+     */
+    tickFormat: false | Intl.NumberFormatOptions | ((d: RawValue) => string);
+};
+export type AxisXAnchor = 'bottom' | 'top' | 'both';
+export type AxisYAnchor = 'left' | 'right' | 'both';
+export type XScaleOptions = ScaleOptions & {
+    /**
+     * Activate the implicit GridX mark. For more control over the grid styling
+     * and layering, add an explicit GridX mark to your plot instead of using the
+     * implicit grids.
+     */
+    grid: boolean;
+    /**
+     * Controls the position of the implicit AxisX mark, or set to false to disable
+     * the implicit AxisX mark. For more control over the axis styling and layering
+     * add an explicit AxisX mark to your plot instead of using the implicit axes.
+     */
+    axis: AxisXAnchor | false;
+    /**
+     * rotate the axis ticks
+     */
+    tickRotate: number;
+    labelAnchor: 'auto' | 'left' | 'center' | 'right';
+    tickFormat: false | Intl.NumberFormatOptions | ((d: RawValue) => string);
+};
+export type YScaleOptions = ScaleOptions & {
+    /**
+     * Activate the implicit GridY mark. For more control over the grid styling
+     * and layering, add an explicit GridY mark to your plot instead of using the
+     * implicit grids.
+     */
+    grid: boolean;
+    /**
+     * Controls the position of the implicit AxisY mark, or set to false to disable
+     * the implicit AxisY mark. For more control over the axis styling and layering
+     * add an explicit AxisY mark to your plot instead of using the implicit axes.
+     */
+    axis: AxisYAnchor | false;
+    tickFormat: false | Intl.NumberFormatOptions | ((d: RawValue) => string);
+    /**
+     * rotate the axis ticks
+     */
+    tickRotate: number;
+    labelAnchor: 'auto' | 'bottom' | 'middle' | 'top';
+};
+export type LegendScaleOptions = ScaleOptions & {
+    legend: boolean;
+};
+export type PlotOptions = {
+    /**
+     * The plot title, rendered as H2 tag above the SVG element. Instead of
+     * using the title, you can also pass a "header" snippet and render your
+     * own custom title markup.
+     */
+    title: string;
+    /**
+     * The plot subtitle, rendered as H3 tag above the SVG element. Instead of
+     * using the subtitle, you can also pass a "header" snippet and render your
+     * own custom title markup.
+     */
+    subtitle: string;
+    /**
+     * The plot caption, rendered as FIGCAPTION tag below the SVG element. Instead of
+     * using the caption, you can also pass a "footer" snippet and render your
+     * own custom title markup.
+     */
+    caption: string;
+    /**
+     * By default, the plot will extend to fit 100% of the parent container width. By
+     * setting the maxWidth style property you can limit the width of your plot.
+     */
+    maxWidth?: string;
+    /**
+     * force the plot into a fixed width
+     */
+    width?: number;
+    /**
+     * force the plot into a fixed height
+     */
+    height: 'auto' | number | ((d: number) => number);
+    /**
+     * Convenience option for setting all four margins at once, in px.
+     */
+    margin: number | {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /**
+     * Left margin of the plot, in px.
+     */
+    marginLeft: number;
+    /**
+     * Right margin of the plot, in px.
+     */
+    marginRight: number;
+    /**
+     * Top margin of the plot, in px.
+     */
+    marginTop: number;
+    /**
+     * Bottom margin of the plot, in px.
+     */
+    marginBottom: number;
+    /**
+     * Activates the implicit GridX and GridY marks.
+     */
+    grid: boolean;
+    /**
+     * Activates the implicit AxisX and AxisY marks.
+     */
+    axes: boolean;
+    /**
+     * Activates the implicit frame marks
+     */
+    frame: boolean;
+    /**
+     * Convenience shortcut for setting both the x and y scale insets.
+     */
+    inset: number;
+    /**
+     * Convenience shortcut for setting both the x and y scale paddings
+     */
+    padding: number;
+    /**
+     * Geo-projection
+     */
+    projection: string | null | {
+        type?: string;
+        rotate?: [number, number] | [number, number, number];
+        domain?: object;
+        inset?: number;
+        clip?: Clip;
+    } | {
+        type: (d: {
+            width: number;
+            height: number;
+        }) => GeoProjection;
+    };
+    /**
+     * if not null, computes a default height such that a variation of one
+     * unit in the x dimension is represented by the corresponding number
+     * of pixels as a variation in the y dimension of one unit.
+     */
+    aspectRatio: number | null;
+    /**
+     * Top-level faceting options
+     */
+    facet: Partial<{
+        /**
+         * The data to facet by. Turns on automatic faceting for all marks that
+         * use the exact same data (===)
+         */
+        data: DataRecord<any>[];
+        x: ChannelAccessor;
+        y: ChannelAccessor;
+    }>;
+    /**
+     * Options for the shared x scale.
+     */
+    x: Partial<XScaleOptions>;
+    /**
+     * Options for the shared y scale
+     */
+    y: Partial<YScaleOptions>;
+    /**
+     * Options for the shared radius scale
+     */
+    r: Partial<ScaleOptions>;
+    color: Partial<ColorScaleOptions>;
+    opacity: Partial<ScaleOptions>;
+    symbol: Partial<LegendScaleOptions>;
+    length: Partial<ScaleOptions>;
+    fx: Partial<ScaleOptions>;
+    fy: Partial<ScaleOptions>;
+    children: Snippet<[
+        {
+            width: number;
+            height: number;
+            options: PlotOptions;
+            scales: PlotScales;
+        }
+    ]>;
+    /**
+     * You can use the header snippet to render a custom title and subtitle for
+     * your plot, or place a legend above the visualization.
+     */
+    header: Snippet;
+    footer: Snippet;
+    /**
+     * The underlay snippet is useful for adding a layer of custom HTML markup
+     * behind the SVG body of your plot, e.g. for a watermark or background image.
+     */
+    underlay: Snippet<[PlotOptions]>;
+    /**
+     * The overlay snippet is useful for adding a layer of custom HTML markup
+     * in front of the SVG body of your plot, e.g. for HTML tooltips.
+     */
+    overlay: Snippet;
+    facetAxes: Snippet;
+    /**
+     * if you set testid, the plot container will get a data-testid attribute which
+     * can be useful for automatic testing
+     */
+    testid: string;
+    /**
+     * in case you want to give your Plot element an extra CSS class
+     */
+    class: string | null;
+    /**
+     * if set to true, the plot will use the implicit scales
+     */
+    implicitScales: boolean;
+    /**
+     * locale used for automatic axis ticks
+     */
+    locale: string;
+    /**
+     * pass a @emotion/css function to style plot using dynamic classes
+     */
+    css: (d: string) => string | undefined;
+};
+export type GenericMarkOptions = Record<string | symbol, any>;
+export type DataRecord<T = Record<string | symbol, RawValue>> = T & {
+    ___orig___?: RawValue | [RawValue, RawValue];
+};
+export type ResolvedDataRecord<T = Record<string | symbol, RawValue>> = Partial<Record<ScaledChannelName, any>> & {
+    datum: DataRecord<T>;
+};
+export type ScaledDataRecord<T = Record<string | symbol, RawValue>> = Partial<Record<ScaledChannelName, number | string | boolean | undefined>> & {
+    datum: DataRecord<T>;
+    valid: Boolean;
+};
+export type DataRow<T = Record<string | symbol, RawValue>> = DataRecord<T> | RawValue | [number, number] | null;
+export type PlotScale = {
+    type: ScaleType;
+    domain: RawValue[];
+    range: RawValue[];
+    autoTitle?: string;
+    /**
+     * The number of marks that are using this scale.
+     */
+    manualActiveMarks: number;
+    /**
+     * Set of accessors used in channels that are bound to this scale.
+     */
+    uniqueScaleProps: Set<ChannelAccessor>;
+    skip: Map<ScaledChannelName, Set<symbol>>;
+    fn: ScaleLinear<RawValue, number> & ScaleBand<RawValue> & ScaleOrdinal<string | Date, number> & ScaleOrdinal<string | Date, string>;
+};
+export type CurveName = 'basis' | 'basis-closed' | 'basis-open' | 'bundle' | 'bump-x' | 'bump-y' | 'cardinal' | 'cardinal-closed' | 'cardinal-open' | 'catmull-rom' | 'catmull-rom-closed' | 'catmull-rom-open' | 'linear' | 'linear-closed' | 'monotone-x' | 'monotone-y' | 'natural' | 'step' | 'step-after' | 'step-before';
+export type MarkerOptions = {
+    /**
+     * the marker for the starting point of a line segment
+     */
+    markerStart?: boolean | MarkerShape | Snippet;
+    /**
+     * the marker for any intermediate point of a line segment
+     */
+    markerMid?: boolean | MarkerShape | Snippet;
+    /**
+     * the marker for the end point of a line segment
+     */
+    markerEnd?: boolean | MarkerShape | Snippet;
+    /**
+     * shorthand for setting the marker on all points
+     */
+    marker?: boolean | MarkerShape | Snippet;
+};
+export type PlotScales = Record<ScaleName, PlotScale>;
+export type ChannelAccessor<T = Record<string | symbol, RawValue>> = ChannelValue<T> | {
+    /** the channel value */
+    value: ChannelValue<T>;
+    /** you can bypass the scale by passing null */
+    scale: boolean | null;
+};
+export type ChannelValue<T = Record<string | symbol, RawValue>> = RawValue | keyof T | ((d: T) => RawValue) | null | undefined;
+export type ConstantAccessor<T, D = Record<string | symbol, RawValue>> = T | ((d: D) => T) | null | undefined;
+export type PlotState = {
+    width: number;
+    height: number;
+    options: PlotOptions;
+    facetWidth: number;
+    facetHeight: number;
+    plotWidth: number;
+    plotHeight: number;
+    scales: PlotScales;
+    body: HTMLDivElement;
+    /**
+     * True if there's a color scale and a symbol scale and both are bound to the same
+     * single channel accessor.
+     */
+    colorSymbolRedundant: boolean;
+    /**
+     * True if the plot is using filled dot marks.
+     */
+    hasFilledDotMarks: boolean;
+    css: ((d: string) => string) | null;
+};
+export type PlotContext = {
+    /**
+     * Registers a mark with the Plot component along with its
+     * data and the channel mappings.
+     */
+    addMark: (mark: Mark<GenericMarkOptions>) => Mark<GenericMarkOptions>;
+    /**
+     * Updates a mark after either the data or the channel mappings
+     * have been updated.
+     */
+    updateMark: (mark: Mark<GenericMarkOptions>) => void;
+    /**
+     * Unregister a mark from the Plot component after the mark
+     * component has been destroyed.
+     */
+    removeMark: (mark: Mark<GenericMarkOptions>) => void;
+    getPlotState: () => PlotState;
+    getTopLevelFacet: () => PlotOptions['facet'];
+    /**
+     * Updates the plots internal facetWidth and facetHeight dimensions
+     * which are used as range for the positional scales x and y.
+     */
+    updateDimensions: (width: number, height: number) => void;
+};
+type FacetState = {
+    fx: RawValue;
+    fy: RawValue;
+    /**
+     * True, if the facet is the leftmost in its row
+     */
+    left: boolean;
+    /**
+     * True, if the facet is the topmost in its column
+     */
+    top: boolean;
+    /**
+     * True, if the facet is the rightmost in its row
+     */
+    right: boolean;
+    /**
+     * True, if the facet is the bottommost in its column
+     */
+    bottom: boolean;
+    /**
+     * True, if the adjacent facet to the top is empty
+     */
+    topEmpty: boolean;
+    /**
+     * True, if the adjacent facet to the bottom is empty
+     */
+    bottomEmpty: boolean;
+    /**
+     * True, if the adjacent facet to the left is empty
+     */
+    leftEmpty: boolean;
+    /**
+     * True, if the adjacent facet to the right is empty
+     */
+    rightEmpty: boolean;
+};
+/**
+ * Test if the given data record is visible in the current facet.
+ */
+type TestFacetFunction = (datum: DataRecord<any>, channels: Record<ChannelName, ChannelAccessor>) => boolean;
+export type FacetContext = {
+    /**
+     * Returns a stateful function that tests whether a specific data
+     * record is visible in the current facet or not.
+     */
+    getTestFacet: () => TestFacetFunction;
+    getFacetState: () => FacetState;
+};
+export type LinkableMarkProps<T> = {
+    /**
+     * if set, the mark element will be wrapped in a <a> link element
+     */
+    href?: ConstantAccessor<string, T>;
+    /**
+     * the relationship of the target object to the link object (e.g. "noopener")
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a#rel
+     */
+    rel?: ConstantAccessor<string, T>;
+    /**
+     * the link target mime type, e.g. "text/csv"
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a#type
+     */
+    type?: ConstantAccessor<string, T>;
+    /**
+     * the target of the link, e.g. "_blank" or "_self"
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a#target
+     */
+    target?: ConstantAccessor<'_self' | '_blank' | '_parent' | '_top' | string, T>;
+    /**
+     * if set to true, the link will be downloaded instead of navigating to it
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download
+     */
+    download?: ConstantAccessor<boolean, T>;
+    [key: `data-sveltekit-${string}`]: string | boolean | undefined;
+};
+export type BaseMarkProps<T> = Partial<{
+    /**
+     * Filter the data without modifying the inferred scales
+     */
+    filter?: ConstantAccessor<boolean, T>;
+    facet?: 'auto' | 'include' | 'exclude';
+    fx: ChannelAccessor<T>;
+    fy: ChannelAccessor<T>;
+    dx: ConstantAccessor<number, T>;
+    dy: ConstantAccessor<number, T>;
+    fill: ChannelAccessor<T>;
+    fillOpacity: ConstantAccessor<number, T>;
+    sort: string | ConstantAccessor<RawValue, T> | ((a: RawValue, b: RawValue) => number) | {
+        /** sort data using an already defined channel */
+        channel: string;
+        /** sort order */
+        order?: 'ascending' | 'descending';
+    };
+    stroke: ChannelAccessor<T>;
+    strokeWidth: ConstantAccessor<number, T>;
+    strokeOpacity: ConstantAccessor<number, T>;
+    strokeLinejoin: ConstantAccessor<CSS.Property.StrokeLinejoin, T>;
+    strokeLinecap: ConstantAccessor<CSS.Property.StrokeLinecap, T>;
+    strokeMiterlimit: ConstantAccessor<number, T>;
+    opacity: ChannelAccessor<T>;
+    strokeDasharray: ConstantAccessor<string, T>;
+    strokeDashoffset: ConstantAccessor<number, T>;
+    mixBlendMode: ConstantAccessor<CSS.Property.MixBlendMode, T>;
+    clipPath: string;
+    imageFilter: ConstantAccessor<string, T>;
+    shapeRendering: ConstantAccessor<CSS.Property.ShapeRendering, T>;
+    paintOrder: ConstantAccessor<string, T>;
+    onclick?: MouseEventHandler<SVGPathElement>;
+    ondblclick?: MouseEventHandler<SVGPathElement>;
+    onmouseup?: MouseEventHandler<SVGPathElement>;
+    onmousedown?: MouseEventHandler<SVGPathElement>;
+    onmouseenter?: MouseEventHandler<SVGPathElement>;
+    onmousemove?: MouseEventHandler<SVGPathElement>;
+    onmouseleave?: MouseEventHandler<SVGPathElement>;
+    onmouseout?: MouseEventHandler<SVGPathElement>;
+    onmouseover?: MouseEventHandler<SVGPathElement>;
+    onpointercancel?: MouseEventHandler<SVGPathElement>;
+    onpointerdown?: MouseEventHandler<SVGPathElement>;
+    onpointerup?: MouseEventHandler<SVGPathElement>;
+    onpointerenter?: MouseEventHandler<SVGPathElement>;
+    onpointerleave?: MouseEventHandler<SVGPathElement>;
+    onpointermove?: MouseEventHandler<SVGPathElement>;
+    onpointerover?: MouseEventHandler<SVGPathElement>;
+    onpointerout?: MouseEventHandler<SVGPathElement>;
+    ondrag?: MouseEventHandler<SVGPathElement>;
+    ondrop?: MouseEventHandler<SVGPathElement>;
+    ondragstart?: MouseEventHandler<SVGPathElement>;
+    ondragenter?: MouseEventHandler<SVGPathElement>;
+    ondragleave?: MouseEventHandler<SVGPathElement>;
+    ondragover?: MouseEventHandler<SVGPathElement>;
+    ondragend?: MouseEventHandler<SVGPathElement>;
+    ontouchstart?: MouseEventHandler<SVGPathElement>;
+    ontouchmove?: MouseEventHandler<SVGPathElement>;
+    ontouchend?: MouseEventHandler<SVGPathElement>;
+    ontouchcancel?: MouseEventHandler<SVGPathElement>;
+    oncontextmenu?: MouseEventHandler<SVGPathElement>;
+    onwheel?: MouseEventHandler<SVGPathElement>;
+    /**
+     * if you want to give your mark element an extra CSS class
+     */
+    class: string | null;
+    cursor: ConstantAccessor<CSS.Property.Cursor, T>;
+}>;
+export type BorderRadius = number | {
+    topLeft?: number;
+    topRight?: number;
+    bottomRight?: number;
+    bottomLeft?: number;
+};
+export type BaseRectMarkProps<T> = {
+    inset?: ConstantAccessor<number, T>;
+    insetLeft?: ConstantAccessor<number, T>;
+    insetTop?: ConstantAccessor<number, T>;
+    insetRight?: ConstantAccessor<number, T>;
+    insetBottom?: ConstantAccessor<number, T>;
+    borderRadius?: BorderRadius;
+};
+export type Channels<T> = Record<string, ChannelAccessor<T> | ConstantAccessor<string | number | boolean | symbol, T>>;
+export type TransformArg<T> = Channels<T> & BaseMarkProps<T> & {
+    data: T[];
+};
+export type MapArg<T> = Channels<T> & {
+    data: T[];
+};
+export type TransformArgsRow = Partial<Channels> & {
+    data: DataRow[];
+};
+export type TransformArgsRecord = Partial<Channels> & {
+    data: DataRecord[];
+};
+export type ColorScheme = 'brbg' | 'prgn' | 'piyg' | 'puor' | 'rdbu' | 'rdgy' | 'rdylbu' | 'rdylgn' | 'spectral' | 'burd' | 'buylrd' | 'blues' | 'greens' | 'grays' | 'greys' | 'oranges' | 'purples' | 'reds' | 'turbo' | 'viridis' | 'magma' | 'inferno' | 'plasma' | 'cividis' | 'cubehelix' | 'warm' | 'cool' | 'bugn' | 'bupu' | 'gnbu' | 'orrd' | 'pubu' | 'pubugn' | 'purd' | 'rdpu' | 'ylgn' | 'ylgnbu' | 'ylorbr' | 'ylorrd' | 'rainbow' | 'sinebow' | 'accent' | 'category10' | 'dark2' | 'paired' | 'pastel1' | 'pastel2' | 'set1' | 'set2' | 'set3' | 'tableau10' | 'observable10';
+export type MarkStyleProps = 'strokeDasharray' | 'strokeLinejoin' | 'strokeLinecap' | 'opacity' | 'cursor' | 'pointerEvents' | 'blend' | 'fill' | 'fillOpacity' | 'fontWeight' | 'fontVariant' | 'fontSize' | 'fontStyle' | 'stroke' | 'strokeWidth' | 'strokeOpacity' | 'x' | 'y' | 'clipPath' | 'mask' | 'filter' | 'angle' | 'radius' | 'symbol' | 'textAnchor' | 'width';
+export type AutoMarginStores = {
+    autoMarginTop: Writable<Map<string, number>>;
+    autoMarginLeft: Writable<Map<string, number>>;
+    autoMarginRight: Writable<Map<string, number>>;
+    autoMarginBottom: Writable<Map<string, number>>;
+};
+type IgnoreDefaults = 'data' | 'facet' | ChannelName | 'title' | 'automatic' | 'children';
+/**
+ * these are the default options for the plot marks that can be set using
+ * the 'svelteplot/defaults' context.
+ */
+export type PlotDefaults = {
+    /**
+     * default plot height
+     */
+    height: number;
+    /**
+     * default plot inset
+     */
+    inset: number;
+    /**
+     * default color scheme
+     */
+    colorScheme: ColorScheme;
+    categoricalColorScheme: ColorScheme | string[];
+    /**
+     * fallback color to be used for null/NA
+     */
+    unknown: string;
+    /**
+     * optional @emotion/css function to style the plot
+     */
+    css: (d: string) => string | undefined;
+    /**
+     * for computing the automatic height based on the number of
+     * domain items in a point scale
+     */
+    pointScaleHeight: number;
+    /**
+     * for computing the automatic height based on the number of
+     * domain items in a band scale
+     */
+    bandScaleHeight: number;
+    /**
+     * initial width of the plot before measuring the actual width
+     */
+    initialWidth: number;
+    /**
+     * locale, used for automatic axis ticks
+     */
+    locale: string;
+    /**
+     * default number format for axis ticks
+     */
+    numberFormat: Intl.NumberFormatOptions;
+    /**
+     * default dot radius for line markers, used in dot, circle, and circle-stroke markers
+     */
+    markerDotRadius: number;
+    /**
+     * default props for area marks, applied to area, areaX, and areaY marks
+     */
+    area: Partial<Omit<ComponentProps<typeof Area>, IgnoreDefaults>>;
+    /**
+     * default props for areaX marks
+     */
+    areaX: Partial<Omit<ComponentProps<typeof AreaX>, IgnoreDefaults>>;
+    /**
+     * default props for areaY marks
+     */
+    areaY: Partial<Omit<ComponentProps<typeof AreaY>, IgnoreDefaults>>;
+    /**
+     * default props for arrow marks
+     */
+    arrow: Partial<Omit<ComponentProps<typeof Arrow>, IgnoreDefaults>>;
+    /**
+     * default props for axis marks, applied to both axisX and axisY marks
+     */
+    axis: Partial<Omit<ComponentProps<typeof AxisX>, 'data' | 'facet' | ChannelName | 'facetAnchor' | 'labelAnchor' | 'anchor'> & {
+        implicit: boolean;
+    }>;
+    /**
+     * default props for axisX marks
+     */
+    axisX: Partial<Omit<ComponentProps<typeof AxisX>, IgnoreDefaults> & {
+        implicit: boolean;
+    }>;
+    /**
+     * default props for axisY marks
+     */
+    axisY: Partial<Omit<ComponentProps<typeof AxisY>, IgnoreDefaults> & {
+        implicit: boolean;
+    }>;
+    /**
+     * default props for bar marks, applied to both barX and barY marks
+     */
+    bar: Partial<Omit<ComponentProps<typeof BarX>, IgnoreDefaults>>;
+    /**
+     * default props for barX marks
+     */
+    barX: Partial<Omit<ComponentProps<typeof BarX>, IgnoreDefaults>>;
+    /**
+     * default props for barY marks
+     */
+    barY: Partial<Omit<ComponentProps<typeof BarY>, IgnoreDefaults>>;
+    /**
+     * default props for box marks, applied to boxX and boxY marks
+     */
+    box: Partial<Omit<ComponentProps<typeof BoxX>, IgnoreDefaults>>;
+    /**
+     * default props for boxX marks
+     */
+    boxX: Partial<Omit<ComponentProps<typeof BoxX>, IgnoreDefaults>>;
+    /**
+     * default props for boxY marks
+     */
+    boxY: Partial<Omit<ComponentProps<typeof BoxY>, IgnoreDefaults>>;
+    /**
+     * default props for brush marks, applied to brush, brushX and brushY marks
+     */
+    brush: Partial<Omit<ComponentProps<typeof Brush>, IgnoreDefaults | 'limitDimension'>>;
+    /**
+     * default props for brushX marks
+     */
+    brushX: Partial<Omit<ComponentProps<typeof BrushX>, IgnoreDefaults>>;
+    /**
+     * default props for brushY marks
+     */
+    brushY: Partial<Omit<ComponentProps<typeof BrushY>, IgnoreDefaults>>;
+    /**
+     * default props for cell marks
+     */
+    cell: Partial<Omit<ComponentProps<typeof Cell>, IgnoreDefaults>>;
+    /**
+     * default props for dot marks
+     */
+    dot: Partial<Omit<ComponentProps<typeof Dot>, IgnoreDefaults>>;
+    /**
+     * default props for frame marks
+     */
+    frame: Partial<ComponentProps<typeof Frame> & {
+        implicit: boolean;
+    }>;
+    /**
+     * default props for geo marks
+     */
+    geo: Partial<Omit<ComponentProps<typeof Geo>, IgnoreDefaults>>;
+    /**
+     * default props for graticule marks
+     */
+    graticule: Partial<Omit<ComponentProps<typeof Graticule>, IgnoreDefaults>>;
+    /**
+     * default props for grid marks, applied to both gridX and gridY marks
+     */
+    grid: Partial<Omit<ComponentProps<typeof GridX>, IgnoreDefaults> & {
+        implicit: boolean;
+    }>;
+    /**
+     * default props for gridX marks
+     */
+    gridX: Partial<Omit<ComponentProps<typeof GridX>, IgnoreDefaults> & {
+        implicit: boolean;
+    }>;
+    /**
+     * default props for gridY marks
+     */
+    gridY: Partial<Omit<ComponentProps<typeof GridY>, IgnoreDefaults> & {
+        implicit: boolean;
+    }>;
+    /**
+     * default props for line marks
+     */
+    line: Partial<Omit<ComponentProps<typeof Line>, IgnoreDefaults>>;
+    /**
+     * default props for link marks
+     */
+    link: Partial<Omit<ComponentProps<typeof Link>, IgnoreDefaults>>;
+    /**
+     * default props for pointer marks
+     */
+    pointer: Partial<Omit<ComponentProps<typeof Pointer>, IgnoreDefaults>>;
+    /**
+     * default props for rect marks, applied to rect and rectX marks
+     */
+    rect: Partial<Omit<ComponentProps<typeof Rect>, IgnoreDefaults>>;
+    /**
+     * default props for rectX marks
+     */
+    rectX: Partial<Omit<ComponentProps<typeof RectX>, IgnoreDefaults>>;
+    /**
+     * default props for rectY marks
+     */
+    rectY: Partial<Omit<ComponentProps<typeof RectY>, IgnoreDefaults>>;
+    /**
+     * default props for rule marks
+     */
+    rule: Partial<Omit<ComponentProps<typeof RuleX>, IgnoreDefaults>>;
+    /**
+     * default props for rule marks
+     */
+    ruleX: Partial<Omit<ComponentProps<typeof RuleX>, IgnoreDefaults>>;
+    /**
+     * default props for rule marks
+     */
+    ruleY: Partial<Omit<ComponentProps<typeof RuleY>, IgnoreDefaults>>;
+    /**
+     * default props for sphere marks
+     */
+    sphere: Partial<ComponentProps<typeof Sphere>>;
+    /**
+     * default props for spike marks
+     */
+    spike: Partial<Omit<ComponentProps<typeof Spike>, IgnoreDefaults>>;
+    /**
+     * default props for text marks
+     */
+    text: Partial<Omit<ComponentProps<typeof Text>, IgnoreDefaults>>;
+    /**
+     * default props for tick marks, applied to tickX and tickY marks
+     */
+    tick: Partial<Omit<ComponentProps<typeof TickX>, IgnoreDefaults>>;
+    /**
+     * default props for tickX marks
+     */
+    tickX: Partial<Omit<ComponentProps<typeof TickX>, IgnoreDefaults>>;
+    /**
+     * default props for tickY marks
+     */
+    tickY: Partial<Omit<ComponentProps<typeof TickY>, IgnoreDefaults>>;
+    /**
+     * default props for vector marks
+     */
+    vector: Partial<Omit<ComponentProps<typeof Vector>, IgnoreDefaults>>;
+};
+export type MapIndexObject = {
+    mapIndex: (I: number[], S: RawValue[], T: RawValue[]) => void;
+};
+export type MapMethod = 'cumsum' | 'rank' | 'quantile' | ((I: number[], S: number[]) => number[]) | MapIndexObject;
+export type MapOptions = Partial<Record<ScaledChannelName, MapMethod>>;
+export type UsedScales = Record<ScaledChannelName, boolean>;
+export {};