@schemavaults/ui 0.100.0 → 0.102.0

package/dist/components/layout/dashboard-layout/useDashboardLayoutReducedMotion.d.ts

@@ -0,0 +1,36 @@
+import { type DashboardLayoutReducedMotionSetting } from "./dashboard-layout-reduced-motion";
+/**
+ * The reduced-motion setting in force for the surrounding dashboard layout.
+ *
+ * `DashboardLayout` publishes its resolved setting through Framer Motion's
+ * `MotionConfig`, so this reads it straight back out — no second context to
+ * keep in step. Pair it with
+ * {@link ./dashboard-layout-reduced-motion!reducedMotionClassName} on any
+ * element of the layout that animates in CSS.
+ */
+export declare function useDashboardLayoutReducedMotionSetting(): DashboardLayoutReducedMotionSetting;
+/**
+ * Whether the dashboard layout should skip its animations right now.
+ *
+ * Accounts for both the `prefers-reduced-motion` media query and the layout's
+ * `reducedMotion` prop. Use it for the animations that run in JavaScript —
+ * Framer Motion's `layout` reflow and animation durations — where a decision
+ * has to be made rather than a media query declared. Exported so
+ * consumer-supplied top bar and sidebar footer components can match the
+ * layout chrome they are rendered into.
+ */
+export declare function useDashboardLayoutReducedMotion(): boolean;
+/**
+ * Resolve `DashboardLayout`'s `reducedMotion` prop into the setting it hands
+ * to `MotionConfig` for its subtree.
+ *
+ * When the prop is omitted the default is `"user"`: the layout opts into
+ * honouring `prefers-reduced-motion`, unlike Framer Motion, which defaults to
+ * `"never"`. An enclosing `MotionConfig` that has already forced
+ * `reducedMotion="always"` (an app-wide "reduce motion" preference) is
+ * inherited rather than relaxed back to the media query; an enclosing
+ * `"never"` is not, since ignoring the viewer's setting should have to be
+ * opted into on the layout itself.
+ */
+export declare function useResolvedDashboardLayoutReducedMotionSetting(setting?: DashboardLayoutReducedMotionSetting): DashboardLayoutReducedMotionSetting;
+export default useDashboardLayoutReducedMotion;

package/dist/components/layout/dashboard-layout/useDashboardLayoutReducedMotion.js

@@ -0,0 +1,55 @@
+"use client";
+import { useContext } from "react";
+import { MotionConfigContext, useReducedMotionConfig } from "../../../framer-motion";
+import { DEFAULT_DASHBOARD_LAYOUT_REDUCED_MOTION_SETTING, } from "./dashboard-layout-reduced-motion";
+/**
+ * The reduced-motion setting in force for the surrounding dashboard layout.
+ *
+ * `DashboardLayout` publishes its resolved setting through Framer Motion's
+ * `MotionConfig`, so this reads it straight back out — no second context to
+ * keep in step. Pair it with
+ * {@link ./dashboard-layout-reduced-motion!reducedMotionClassName} on any
+ * element of the layout that animates in CSS.
+ */
+export function useDashboardLayoutReducedMotionSetting() {
+    return (useContext(MotionConfigContext).reducedMotion ??
+        DEFAULT_DASHBOARD_LAYOUT_REDUCED_MOTION_SETTING);
+}
+/**
+ * Whether the dashboard layout should skip its animations right now.
+ *
+ * Accounts for both the `prefers-reduced-motion` media query and the layout's
+ * `reducedMotion` prop. Use it for the animations that run in JavaScript —
+ * Framer Motion's `layout` reflow and animation durations — where a decision
+ * has to be made rather than a media query declared. Exported so
+ * consumer-supplied top bar and sidebar footer components can match the
+ * layout chrome they are rendered into.
+ */
+export function useDashboardLayoutReducedMotion() {
+    // `useReducedMotionConfig()` is `boolean | null`; null only means the media
+    // query has not been read, which is not a preference for reduced motion.
+    return useReducedMotionConfig() === true;
+}
+/**
+ * Resolve `DashboardLayout`'s `reducedMotion` prop into the setting it hands
+ * to `MotionConfig` for its subtree.
+ *
+ * When the prop is omitted the default is `"user"`: the layout opts into
+ * honouring `prefers-reduced-motion`, unlike Framer Motion, which defaults to
+ * `"never"`. An enclosing `MotionConfig` that has already forced
+ * `reducedMotion="always"` (an app-wide "reduce motion" preference) is
+ * inherited rather than relaxed back to the media query; an enclosing
+ * `"never"` is not, since ignoring the viewer's setting should have to be
+ * opted into on the layout itself.
+ */
+export function useResolvedDashboardLayoutReducedMotionSetting(setting) {
+    const inheritedSetting = useContext(MotionConfigContext).reducedMotion;
+    if (setting !== undefined) {
+        return setting;
+    }
+    return inheritedSetting === "always"
+        ? "always"
+        : DEFAULT_DASHBOARD_LAYOUT_REDUCED_MOTION_SETTING;
+}
+export default useDashboardLayoutReducedMotion;
+//# sourceMappingURL=useDashboardLayoutReducedMotion.js.map

package/dist/components/layout/dashboard-layout/useDashboardLayoutReducedMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDashboardLayoutReducedMotion.js","sourceRoot":"","sources":["../../../../src/components/layout/dashboard-layout/useDashboardLayoutReducedMotion.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EACL,+CAA+C,GAEhD,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,UAAU,sCAAsC;IACpD,OAAO,CACL,UAAU,CAAC,mBAAmB,CAAC,CAAC,aAAa;QAC7C,+CAA+C,CAChD,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,+BAA+B;IAC7C,4EAA4E;IAC5E,yEAAyE;IACzE,OAAO,sBAAsB,EAAE,KAAK,IAAI,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,8CAA8C,CAC5D,OAA6C;IAE7C,MAAM,gBAAgB,GACpB,UAAU,CAAC,mBAAmB,CAAC,CAAC,aAAa,CAAC;IAEhD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,gBAAgB,KAAK,QAAQ;QAClC,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,+CAA+C,CAAC;AACtD,CAAC;AAED,eAAe,+BAA+B,CAAC"}

package/dist/components/layout/dashboard-layout/useToggleDashboardLayoutCollapsedTransitionTime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The duration, in seconds, of the sidebar expand/collapse animations.
+ *
+ * `0` when motion is reduced, so the wordmark and the group labels appear and
+ * disappear with the sidebar instead of scaling and fading over a third of a
+ * second. The staggered delays in those variants are derived from this same
+ * value, so they collapse to `0` along with it.
+ *
+ * Framer Motion's own `reducedMotion` handling only switches off *transform*
+ * and layout animations; the width, height and padding animations in the
+ * sidebar are none of those, which is why the duration is zeroed explicitly.
+ */
+export declare function useToggleDashboardLayoutCollapsedTransitionTime(): number;
+export default useToggleDashboardLayoutCollapsedTransitionTime;

package/dist/components/layout/dashboard-layout/useToggleDashboardLayoutCollapsedTransitionTime.js

@@ -0,0 +1,21 @@
+"use client";
+import toggleDashboardLayoutCollapsedTransitionTime from "./toggle-dashboard-layout-collapsed-transition-time";
+import useDashboardLayoutReducedMotion from "./useDashboardLayoutReducedMotion";
+/**
+ * The duration, in seconds, of the sidebar expand/collapse animations.
+ *
+ * `0` when motion is reduced, so the wordmark and the group labels appear and
+ * disappear with the sidebar instead of scaling and fading over a third of a
+ * second. The staggered delays in those variants are derived from this same
+ * value, so they collapse to `0` along with it.
+ *
+ * Framer Motion's own `reducedMotion` handling only switches off *transform*
+ * and layout animations; the width, height and padding animations in the
+ * sidebar are none of those, which is why the duration is zeroed explicitly.
+ */
+export function useToggleDashboardLayoutCollapsedTransitionTime() {
+    const reduced = useDashboardLayoutReducedMotion();
+    return reduced ? 0 : toggleDashboardLayoutCollapsedTransitionTime;
+}
+export default useToggleDashboardLayoutCollapsedTransitionTime;
+//# sourceMappingURL=useToggleDashboardLayoutCollapsedTransitionTime.js.map

package/dist/components/layout/dashboard-layout/useToggleDashboardLayoutCollapsedTransitionTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToggleDashboardLayoutCollapsedTransitionTime.js","sourceRoot":"","sources":["../../../../src/components/layout/dashboard-layout/useToggleDashboardLayoutCollapsedTransitionTime.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,4CAA4C,MAAM,qDAAqD,CAAC;AAC/G,OAAO,+BAA+B,MAAM,mCAAmC,CAAC;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,+CAA+C;IAC7D,MAAM,OAAO,GAAY,+BAA+B,EAAE,CAAC;IAC3D,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,4CAA4C,CAAC;AACpE,CAAC;AAED,eAAe,+CAA+C,CAAC"}

package/dist/components/ui/index.d.ts

@@ -196,6 +196,8 @@ export * from "./line-chart";
 export type * from "./line-chart";
 export * from "./radar-chart";
 export type * from "./radar-chart";
+export * from "./scatter-plot";
+export type * from "./scatter-plot";
 export * from "./comparison-slider";
 export type * from "./comparison-slider";
 export * from "./theme-selector";

package/dist/components/ui/index.js

@@ -97,6 +97,7 @@ export * from "./pie-chart";
 export * from "./bar-chart";
 export * from "./line-chart";
 export * from "./radar-chart";
+export * from "./scatter-plot";
 export * from "./comparison-slider";
 export * from "./theme-selector";
 export * from "./tree-view";

package/dist/components/ui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/ui/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/ui/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AAGzB,cAAc,uBAAuB,CAAC;AAGtC,cAAc,aAAa,CAAC;AAG5B,cAAc,eAAe,CAAC;AAG9B,cAAc,SAAS,CAAC;AAGxB,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,mBAAmB,CAAC;AAGlC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,kBAAkB,CAAC;AAGjC,cAAc,aAAa,CAAC;AAG5B,cAAc,kCAAkC,CAAC;AAGjD,cAAc,cAAc,CAAC;AAG7B,cAAc,YAAY,CAAC;AAG3B,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC;AAExB,cAAc,WAAW,CAAC;AAG1B,cAAc,YAAY,CAAC;AAG3B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,QAAQ,CAAC;AAGvB,cAAc,QAAQ,CAAC;AAGvB,cAAc,aAAa,CAAC;AAG5B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,WAAW,CAAC;AAG1B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,UAAU,CAAC;AAGzB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,WAAW,CAAC;AAG1B,cAAc,WAAW,CAAC;AAG1B,cAAc,YAAY,CAAC;AAG3B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAG7B,cAAc,eAAe,CAAC;AAG9B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,YAAY,CAAC;AAG3B,cAAc,2BAA2B,CAAC;AAG1C,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,eAAe,CAAC;AAG9B,cAAc,WAAW,CAAC;AAG1B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,eAAe,CAAC;AAG9B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,QAAQ,CAAC;AAGvB,cAAc,QAAQ,CAAC;AAGvB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC;AAGxB,cAAc,iBAAiB,CAAC;AAGhC,cAAc,cAAc,CAAC;AAG7B,cAAc,cAAc,CAAC;AAG7B,cAAc,OAAO,CAAC;AAGtB,cAAc,eAAe,CAAC;AAG9B,cAAc,WAAW,CAAC;AAG1B,cAAc,UAAU,CAAC;AAGzB,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,cAAc,UAAU,CAAC;AAGzB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAG7B,cAAc,WAAW,CAAC;AAG1B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,eAAe,CAAC;AAG9B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,WAAW,CAAC;AAG1B,cAAc,UAAU,CAAC;AAGzB,cAAc,QAAQ,CAAC;AAGvB,cAAc,cAAc,CAAC;AAG7B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,aAAa,CAAC;AAG5B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,cAAc,CAAC;AAG7B,cAAc,eAAe,CAAC;AAG9B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,cAAc,aAAa,CAAC;AAG5B,cAAc,0BAA0B,CAAC;AAGzC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,YAAY,CAAC;AAG3B,cAAc,eAAe,CAAC;AAG9B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,eAAe,CAAC;AAG9B,cAAc,QAAQ,CAAC;AAGvB,cAAc,qBAAqB,CAAC;AAGpC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,eAAe,CAAC;AAG9B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,cAAc,mBAAmB,CAAC"}

package/dist/components/ui/scatter-plot/index.d.ts

@@ -0,0 +1,3 @@
+export { ScatterPlot, scatterPlotVariants, scatterPlotSizeIds, scatterPlotColorIds, scatterPlotShapeIds, } from "./scatter-plot";
+export type * from "./scatter-plot";
+export { ScatterPlot as default } from "./scatter-plot";

package/dist/components/ui/scatter-plot/index.js

@@ -0,0 +1,3 @@
+export { ScatterPlot, scatterPlotVariants, scatterPlotSizeIds, scatterPlotColorIds, scatterPlotShapeIds, } from "./scatter-plot";
+export { ScatterPlot as default } from "./scatter-plot";
+//# sourceMappingURL=index.js.map

package/dist/components/ui/scatter-plot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/ui/scatter-plot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/components/ui/scatter-plot/scatter-plot.d.ts

@@ -0,0 +1,169 @@
+import { type VariantProps } from "class-variance-authority";
+import type { HTMLAttributes, KeyboardEvent, MouseEvent, ReactElement, ReactNode, Ref } from "react";
+export declare const scatterPlotSizeIds: ["sm", "md", "lg", "xl"];
+export type ScatterPlotSizeId = (typeof scatterPlotSizeIds)[number];
+export declare const scatterPlotColorIds: ["default", "primary", "positive", "warning", "destructive", "muted"];
+export type ScatterPlotColorId = (typeof scatterPlotColorIds)[number];
+export declare const scatterPlotShapeIds: ["circle", "square", "triangle", "diamond"];
+export type ScatterPlotShapeId = (typeof scatterPlotShapeIds)[number];
+export declare const scatterPlotVariants: (props?: ({
+    size?: "sm" | "lg" | "xl" | "md" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface ScatterPlotPoint {
+    /** X value in domain units. Non-finite values are skipped. */
+    x: number;
+    /** Y value in domain units. Non-finite values are skipped. */
+    y: number;
+    /**
+     * Optional magnitude used to scale the marker (bubble chart mode). Values
+     * are mapped through a square-root scale onto `sizeRange` so that marker
+     * *area* -- not radius -- is proportional to the value. Ignored when the
+     * chart has no `sizeRange`-eligible data.
+     */
+    size?: number;
+    /** Human-readable label for the point (used in aria-labels and tooltips). */
+    label?: string;
+    /** Stable identifier for the point. Defaults to the index. */
+    id?: string;
+}
+export interface ScatterPlotSeries {
+    /** Stable identifier for the series. Used as React key and click payload. */
+    id: string;
+    /** Display name for the series. */
+    label?: string;
+    /** Points to plot. Order is irrelevant except for paint order. */
+    points: ReadonlyArray<ScatterPlotPoint>;
+    /** Preset color id from the chart palette. Ignored if `color` is provided. */
+    colorId?: ScatterPlotColorId;
+    /**
+     * Override the marker color with a raw CSS color (e.g. `"#ff0080"` or
+     * `"hsl(var(--chart-1))"`). Takes precedence over `colorId`.
+     */
+    color?: string;
+    /** Marker shape. Defaults to a rotation based on the series index. */
+    shape?: ScatterPlotShapeId;
+    /** Override the chart-level `pointRadius` for this series. */
+    pointRadius?: number;
+    /** Override the chart-level `pointOpacity` for this series. */
+    pointOpacity?: number;
+    /** Render a least-squares trend line for this series. Defaults to `false`. */
+    trendLine?: boolean;
+    /** Extra classes applied to this series' markers. */
+    className?: string;
+    /** Fired when a point in this series is clicked or activated via keyboard. */
+    onPointClick?: (point: ScatterPlotPoint, series: ScatterPlotSeries, event: MouseEvent<SVGPathElement> | KeyboardEvent<SVGPathElement>) => void;
+}
+export interface ScatterPlotValueLabelContext {
+    series: ScatterPlotSeries;
+    point: ScatterPlotPoint;
+    index: number;
+}
+export interface ScatterPlotReferenceLine {
+    /** Position of the line in domain units. */
+    value: number;
+    /** Optional label rendered next to the line. */
+    label?: string;
+    /** Extra classes applied to the line element. */
+    className?: string;
+}
+export interface ScatterPlotProps extends Omit<HTMLAttributes<HTMLDivElement>, "onClick">, VariantProps<typeof scatterPlotVariants> {
+    /** Series to render, in order (later series are drawn on top). */
+    series: ReadonlyArray<ScatterPlotSeries>;
+    /** Accessible label describing what the chart represents. */
+    label: string;
+    /** Override the rendered canvas width in pixels (defaults are size-aware). */
+    width?: number;
+    /** Override the rendered canvas height in pixels (defaults are size-aware). */
+    height?: number;
+    /** Lower bound of the x-axis. Defaults to the smallest x across series. */
+    xMin?: number;
+    /** Upper bound of the x-axis. Defaults to the largest x across series. */
+    xMax?: number;
+    /** Lower bound of the y-axis. Defaults to the smallest y across series. */
+    yMin?: number;
+    /** Upper bound of the y-axis. Defaults to the largest y across series. */
+    yMax?: number;
+    /** Marker radius in pixels when points carry no `size`. Defaults to `4`. */
+    pointRadius?: number;
+    /**
+     * Min/max marker radius in pixels for points that carry a `size`. Defaults
+     * to `[4, 14]`.
+     */
+    sizeRange?: readonly [number, number];
+    /** Marker fill opacity, useful for dense/overlapping data. Defaults to `0.8`. */
+    pointOpacity?: number;
+    /** Render the x/y axis lines. Defaults to `true`. */
+    showAxis?: boolean;
+    /**
+     * Number of evenly-spaced horizontal gridlines drawn across the y-axis. `0`
+     * disables them. Defaults to `0`.
+     */
+    gridLineCount?: number;
+    /**
+     * Number of evenly-spaced vertical gridlines drawn across the x-axis. `0`
+     * disables them. Defaults to `0`.
+     */
+    verticalGridLineCount?: number;
+    /**
+     * Format an x-axis tick label. Return `null` to skip the tick. When omitted,
+     * ticks render only if `showXAxisLabels` is `true` (raw values).
+     */
+    xTickFormatter?: (x: number, index: number) => string | null;
+    /** Number of evenly-spaced x-axis ticks, endpoints included. Defaults to `5`. */
+    xTickCount?: number;
+    /** Render raw-value x-axis ticks. Ignored when `xTickFormatter` is set. */
+    showXAxisLabels?: boolean;
+    /**
+     * Format a y-axis tick label. Return `null` to skip the tick. When omitted,
+     * ticks render only if `showYAxisLabels` is `true` (raw values).
+     */
+    yTickFormatter?: (y: number, index: number) => string | null;
+    /** Number of evenly-spaced y-axis ticks, endpoints included. Defaults to `5`. */
+    yTickCount?: number;
+    /** Render raw-value y-axis ticks. Ignored when `yTickFormatter` is set. */
+    showYAxisLabels?: boolean;
+    /**
+     * Width in pixels reserved for y-axis tick labels (the left gutter).
+     * Defaults to `36`. Only applied when y-axis labels are visible.
+     */
+    yTickLabelWidth?: number;
+    /** Axis title rendered under the x-axis. */
+    xAxisTitle?: string;
+    /** Axis title rendered (rotated) alongside the y-axis. */
+    yAxisTitle?: string;
+    /** Vertical reference line(s) at fixed x positions. */
+    xReferenceLines?: ReadonlyArray<ScatterPlotReferenceLine>;
+    /** Horizontal reference line(s) at fixed y positions. */
+    yReferenceLines?: ReadonlyArray<ScatterPlotReferenceLine>;
+    /** Render a text label next to every point. Defaults to `false`. */
+    showValueLabels?: boolean;
+    /**
+     * Customize the point-label text. Return `null` to skip a point. Defaults to
+     * the point's `label`, falling back to `(x, y)`.
+     */
+    valueLabelFormatter?: (context: ScatterPlotValueLabelContext) => string | null;
+    /**
+     * Fallback handler invoked for any point that doesn't have its own
+     * series-level `onPointClick`.
+     */
+    onPointClick?: (point: ScatterPlotPoint, series: ScatterPlotSeries, event: MouseEvent<SVGPathElement> | KeyboardEvent<SVGPathElement>) => void;
+    /** Text rendered when no finite data points are supplied. */
+    emptyMessage?: string;
+    /** Optional content overlaid on top of the plot area. */
+    children?: ReactNode;
+    /** Extra classes for the overlay content wrapper. */
+    overlayClassName?: string;
+    /** Extra classes applied to every point-label `<text>` element. */
+    valueLabelClassName?: string;
+    /** Extra classes applied to every axis tick `<text>` element. */
+    tickLabelClassName?: string;
+    /** Extra classes applied to the axis / gridline `<line>` elements. */
+    axisClassName?: string;
+    /** Optional ref forwarded to the wrapper element. */
+    ref?: Ref<HTMLDivElement>;
+}
+declare function ScatterPlot({ series, label, size, width, height, xMin, xMax, yMin, yMax, pointRadius, sizeRange, pointOpacity, showAxis, gridLineCount, verticalGridLineCount, xTickFormatter, xTickCount, showXAxisLabels, yTickFormatter, yTickCount, showYAxisLabels, yTickLabelWidth, xAxisTitle, yAxisTitle, xReferenceLines, yReferenceLines, showValueLabels, valueLabelFormatter, onPointClick, emptyMessage, children, className, overlayClassName, valueLabelClassName, tickLabelClassName, axisClassName, ref, ...props }: ScatterPlotProps): ReactElement;
+declare namespace ScatterPlot {
+    var displayName: string;
+}
+export { ScatterPlot };