@blueprint-chart/lib 2.5.0 → 2.6.0

package/dist/charts/axis/horizontal-axis.d.ts

@@ -12,7 +12,7 @@ interface AxisDatum {
  * than `maxLines`. Used to avoid rotating labels when wrapping suffices.
  */
 declare function wrapLabel(label: string, maxWidthPx: number, maxLines?: number): string[] | null;
-type AnyXScale = d3.ScaleBand<string> | d3.ScalePoint<string> | d3.ScaleLinear<number, number> | d3.ScaleSymLog<number, number> | d3.ScaleTime<number, number>;
+type AnyXScale = d3.ScaleBand<string> | d3.ScalePoint<string> | d3.ScaleLinear<number, number> | d3.ScaleSymLog<number, number> | d3.ScaleLogarithmic<number, number> | d3.ScaleTime<number, number>;
 declare function buildTickFormatter(fmt: string | null, labels: string[]): ((d: string | d3.NumberValue) => string) | null;
 declare function thinLabels(domain: string[], availableWidth: number, formatter?: ((d: string | d3.NumberValue) => string) | null): string[];
 /**

package/dist/charts/canvas/canvas.d.ts

@@ -16,11 +16,18 @@ export declare function computeMarginDelta(priorMargin: Pick<Margin, 'top' | 'le
     dx: number;
     dy: number;
 } | undefined;
+export declare const DEFAULT_MARGIN: Margin;
+export declare const DEFAULT_WIDTH = 600;
+export declare const DEFAULT_HEIGHT = 400;
 /**
  * Estimate the pixel width of the widest tick label for a vertical axis.
  * Uses an offscreen canvas for measurement, falling back to character-count estimation.
  */
 export declare function estimateVerticalLabelWidth(values: number[], range?: AxisRange, numberFormat?: string | null, scaleType?: string): number;
+export declare function estimateScaleLabelWidth(scale: {
+    ticks: (n?: number) => number[];
+    tickFormat: (n?: number) => (v: number) => string;
+}, numberFormat?: string | null): number;
 /**
  * Estimate the pixel width of the widest string label (for band/category axes).
  */

package/dist/charts/plugins/annotations/context.d.ts

@@ -1,8 +1,8 @@
 import { AnnotationSnapshot } from './snapshots';
 import type * as d3 from 'd3';
 export interface AnnotationContext {
-    scaleX: d3.ScaleBand<string> | d3.ScalePoint<string> | d3.ScaleTime<number, number> | d3.ScaleLinear<number, number>;
-    scaleY: d3.ScaleLinear<number, number> | d3.ScaleSymLog<number, number>;
+    scaleX: d3.ScaleBand<string> | d3.ScalePoint<string> | d3.ScaleTime<number, number> | d3.ScaleLinear<number, number> | d3.ScaleLogarithmic<number, number> | d3.ScaleSymLog<number, number>;
+    scaleY: d3.ScaleLinear<number, number> | d3.ScaleSymLog<number, number> | d3.ScaleLogarithmic<number, number>;
     data: {
         label: string;
         value: number;

package/dist/charts/plugins/annotations/shared.d.ts

@@ -8,7 +8,8 @@ export declare function scaleXValue(scale: AnnotationContext['scaleX'], label: s
 export declare function computeAnchorPoint(datum: {
     label: string;
     value: number;
-}, scaleX: AnnotationContext['scaleX'], scaleY: d3.ScaleLinear<number, number> | d3.ScaleSymLog<number, number>, anchorDirection: CompassDirection, orientation?: 'horizontal'): {
+    x?: number;
+}, scaleX: AnnotationContext['scaleX'], scaleY: AnnotationContext['scaleY'], anchorDirection: CompassDirection, orientation?: 'horizontal'): {
     x: number;
     y: number;
 };

package/dist/charts/plugins/proximity.d.ts

@@ -6,12 +6,14 @@ export interface ProximityPoint {
     value: number;
     series?: string;
     color: string;
+    r?: number;
 }
 export interface ProximityOptions {
     width: number;
     height: number;
     points: ProximityPoint[];
     tooltip?: boolean;
+    nearest?: 'x' | 'xy';
     crosshair?: boolean;
     crosshairDirection?: 'both' | 'vertical' | 'horizontal';
     crosshairStyle?: 'solid' | 'dashed' | 'dotted';

package/dist/charts/scale-helpers.d.ts

@@ -24,4 +24,5 @@ export declare function computeLinearDomain(values: number[], range?: AxisRange,
 export declare function logTickValues(scale: {
     domain: () => unknown[];
     constant?: () => unknown;
+    base?: () => unknown;
 }, maxTicks: number): number[] | null;

package/dist/charts/types/scatter/emphasis.d.ts

@@ -0,0 +1,7 @@
+import { ScatterPoint } from './points';
+export declare function highlightedPointNames(points: ScatterPoint[], targets: string[]): Set<string>;
+export declare function splitColorOverrides(points: ScatterPoint[], overrides: Map<string, string>): {
+    points: Map<string, string>;
+    groups: Map<string, string>;
+};
+export declare function resolvePointColor(point: ScatterPoint, overrides: Map<string, string>, groups: Map<string, string>, fallback: string): string;

package/dist/charts/types/scatter/issues.d.ts

@@ -0,0 +1,20 @@
+import { AxisRange, ChartData } from '../../types';
+import { ScaleType } from '../../../enums';
+import { ScatterMapping } from './mapping';
+export interface ScatterIssue {
+    code: string;
+    severity: 'error' | 'warning';
+    message: string;
+    key?: 'x' | 'y' | 'size' | 'group';
+    suggestion?: string;
+}
+type ScaleTypes = {
+    x?: ScaleType;
+    y?: ScaleType;
+};
+type Ranges = {
+    x?: AxisRange;
+    y?: AxisRange;
+};
+export declare function scatterIssues(data: ChartData, overrides: ScatterMapping, scaleTypes: ScaleTypes, ranges: Ranges, trend?: string): ScatterIssue[];
+export {};

package/dist/charts/types/scatter/labels.d.ts

@@ -0,0 +1,17 @@
+export interface LabelCandidate {
+    key: string;
+    text: string;
+    cx: number;
+    cy: number;
+    r: number;
+}
+export interface PlacedLabel {
+    key: string;
+    x: number;
+    y: number;
+    anchor: 'start' | 'middle' | 'end';
+}
+export declare function placePointLabels(candidates: LabelCandidate[], bounds: {
+    width: number;
+    height: number;
+}, fontPx: number): PlacedLabel[];

package/dist/charts/types/scatter/legend.d.ts

@@ -0,0 +1,11 @@
+import { ScatterPoint } from './points';
+export declare function groupColors(points: ScatterPoint[], palette: string[]): Map<string, string>;
+export declare function sizeLegendValues(maxSize: number): number[];
+export interface KeyConfig {
+    sizeLabel?: string;
+    sizeValues: number[];
+    radius: (value: number) => number;
+    trend: boolean;
+}
+export declare function scatterKeyWidth({ sizeLabel, sizeValues, radius, trend }: KeyConfig): number;
+export declare function renderScatterKey(parent: SVGGElement, cfg: KeyConfig): SVGGElement | null;

package/dist/charts/types/scatter/mapping.d.ts

@@ -0,0 +1,10 @@
+import { ChartData } from '../../types';
+export declare const MAPPING_NONE = "none";
+export interface ScatterMapping {
+    x?: string;
+    y?: string;
+    size?: string;
+    group?: string;
+}
+export declare function numericColumns(data: ChartData): string[];
+export declare function resolveScatterMapping(data: ChartData, overrides?: ScatterMapping): ScatterMapping;

package/dist/charts/types/scatter/points.d.ts

@@ -0,0 +1,24 @@
+import { ChartData } from '../../types';
+import { ScaleType } from '../../../enums';
+import { ScatterMapping } from './mapping';
+export interface ScatterPoint {
+    name: string;
+    x: number;
+    y: number;
+    size?: number;
+    group?: string;
+}
+export type DropReason = 'missing-x' | 'missing-y' | 'invalid-size' | 'non-positive-log-x' | 'non-positive-log-y';
+export interface DroppedRow {
+    name: string;
+    reason: DropReason;
+}
+type ScaleTypes = {
+    x?: ScaleType;
+    y?: ScaleType;
+};
+export declare function buildScatterPoints(data: ChartData, mapping: ScatterMapping, scaleTypes: ScaleTypes): {
+    points: ScatterPoint[];
+    dropped: DroppedRow[];
+};
+export {};

package/dist/charts/types/scatter/scales.d.ts

@@ -0,0 +1,18 @@
+import { ScaleType } from '../../../enums';
+import { AxisRange } from '../../types';
+import * as d3 from 'd3';
+export type ScatterScale = d3.ScaleLinear<number, number> | d3.ScaleLogarithmic<number, number> | d3.ScaleSymLog<number, number>;
+export declare function buildScatterScale(type: ScaleType | undefined, values: number[], range?: AxisRange): ScatterScale;
+export declare function axisTransform(type: ScaleType | undefined): {
+    forward: (v: number) => number;
+    inverse: (t: number) => number;
+};
+/**
+ * Widest `[start, end]` pixel range that keeps every bubble inside
+ * `[0, length]`, and both ends of the domain at least `edgePad` from the edges. Only the bubbles that reach an edge cost
+ * margin, so a large bubble in the middle of the cloud reserves none.
+ */
+export declare function fitRange(scale: ScatterScale, items: {
+    value: number;
+    r: number;
+}[], length: number, edgePad?: number): [number, number];

package/dist/charts/types/scatter/scatter.d.ts

@@ -0,0 +1,6 @@
+import { ChartData, ChartOptions } from '../../types';
+export declare const DEFAULT_COLOR = "#4e79a7";
+export declare const DOT_RADIUS = 4.5;
+export declare const FILL_OPACITY = 0.7;
+export declare function maxBubbleRadius(width: number, height: number): number;
+export declare function render(container: HTMLElement, data: ChartData, options?: ChartOptions, transition?: boolean): void;

package/dist/charts/types/scatter/tooltip.d.ts

@@ -0,0 +1,8 @@
+import { ScatterMapping } from './mapping';
+import { ScatterPoint } from './points';
+type Formats = {
+    x?: string;
+    y?: string;
+};
+export declare function formatScatterTooltip(point: ScatterPoint, mapping: ScatterMapping, formats: Formats): string;
+export {};

package/dist/charts/types/scatter/trend.d.ts

@@ -0,0 +1,24 @@
+import { ScaleType } from '../../../enums';
+import { ScatterPoint } from './points';
+export declare const TREND_MODES: readonly ["overall", "per-group"];
+export type TrendMode = typeof TREND_MODES[number];
+export declare function isTrendMode(value: string | undefined): value is TrendMode;
+export interface TrendSegment {
+    key: string;
+    group?: string;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+export declare function fitLeastSquares(xs: number[], ys: number[]): {
+    slope: number;
+    intercept: number;
+} | null;
+export declare function trendSegments(points: ScatterPoint[], mode: TrendMode, scaleTypes: {
+    x?: ScaleType;
+    y?: ScaleType;
+}): {
+    segments: TrendSegment[];
+    skipped: string[];
+};

package/dist/charts/types.d.ts

@@ -7,6 +7,10 @@ export interface ChartData {
         name: string;
         values: number[];
     }[];
+    textColumns?: {
+        name: string;
+        values: (string | undefined)[];
+    }[];
 }
 export interface ColorizeConfig {
     target: string;
@@ -190,6 +194,11 @@ export interface ChartOptions {
     waterfallTotal?: boolean;
     sharedScale?: boolean;
     categoryLabelLine?: boolean;
+    x?: string;
+    y?: string;
+    size?: string;
+    group?: string;
+    trend?: string;
 }
 export type ChartRenderer = (container: HTMLElement, data: ChartData, options: ChartOptions, transition?: boolean) => void;
 export interface ChartOptionDef {
@@ -275,5 +284,10 @@ export interface ChartTypeOptions {
     waterfallTotal: boolean;
     sharedScale: boolean;
     categoryLabelLine: boolean;
+    x: string;
+    y: string;
+    size: string;
+    group: string;
+    trend: string;
 }
 export type ChartTypeOptionKey = keyof ChartTypeOptions;

package/dist/dsl/suggest.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Pick the nearest candidate to `value` by edit distance. Returns undefined
+ * when nothing is close enough (distance must be < half the value length, and
+ * at most 3 edits) to avoid noisy suggestions.
+ */
+export declare function nearest(value: string, candidates: Iterable<string>): string | undefined;

package/dist/enums.d.ts

@@ -12,6 +12,7 @@ export declare enum ChartType {
     AreaStacked = "area-stacked",
     Donut = "donut",
     Pie = "pie",
+    Scatter = "scatter",
     VerticalBar = "vertical-bar",
     HorizontalBar = "horizontal-bar"
 }
@@ -21,7 +22,8 @@ export declare enum AxisDirection {
 }
 export declare enum ScaleType {
     Linear = "linear",
-    Log = "log"
+    Log = "log",
+    Symlog = "symlog"
 }
 export declare enum GridStyle {
     Solid = "solid",

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export { renderLegend } from './charts/legend/legend';
 export { registerChart, getChart, getChartOptions, listCharts } from './charts/registry';
 export { parseData, buildChartOptions } from './charts/chart-helpers';
 export { stripDigitGroupSpaces } from './charts/number-parse';
+export { resolveScatterMapping, numericColumns, MAPPING_NONE, type ScatterMapping } from './charts/types/scatter/mapping';
 export { recommendCharts } from './recommendations/recommend';
 export { classifyIntent } from './recommendations/intent';
 export { shapeOf } from './recommendations/shape';