@blueprint-chart/lib 0.1.15 → 0.1.18

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

@@ -27,6 +27,11 @@ export declare class AxisService {
     /**
      * Remove axis groups from DOM before replaceChildren().
      * The groups are kept in memory for reattachment.
+     *
+     * Interrupts any pending D3 transitions on the axis groups (and their
+     * descendants) before detaching so tween callbacks don't continue writing
+     * attributes to nodes that have just been removed from the DOM — which would
+     * otherwise throw in jsdom (no SVG baseVal) and leak work in real browsers.
      */
     detach(): void;
     /**

package/dist/charts/clip-path-helper.d.ts

@@ -0,0 +1,7 @@
+export interface ClipRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare function ensureClipPath(svg: SVGSVGElement, container: Element, key: string, rect: ClipRect): string;

package/dist/charts/contrast.d.ts

@@ -1,10 +1,13 @@
 /**
  * Returns '#fff' or '#333' — whichever has better contrast against `bg`.
+ * Falls back to '#333' (readable on the default light background) when `bg`
+ * isn't a valid color string.
  */
 export declare function contrastTextColor(bg: string): string;
 /**
  * Compute WCAG 2.1 contrast ratio between two colors.
- * Returns a value between 1 and 21.
+ * Returns a value between 1 and 21, or 1 (no contrast) when either input
+ * isn't a valid color string.
  */
 export declare function wcagContrastRatio(fg: string, bg: string): number;
 /**

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

@@ -1,3 +1,4 @@
+export declare function disposeProximityFor(container: Element): void;
 export interface ProximityPoint {
     cx: number;
     cy: number;
@@ -17,6 +18,13 @@ export interface ProximityOptions {
     crosshairColor?: string;
     format?: (point: ProximityPoint) => string;
     numberFormat?: string;
+    /**
+     * When provided, the returned cleanup function is registered in a per-container
+     * registry. Subsequent renders against the same container should call
+     * `disposeProximityFor(container)` to tear down the prior interaction before
+     * a new one is created, preventing leaked tooltips and listeners.
+     */
+    container?: Element;
 }
 export declare function makeDefaultFormat(numberFormat?: string): (p: ProximityPoint) => string;
 /**

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

@@ -1,3 +1,4 @@
+import { ScaleType } from '../enums';
 /**
  * Filter chart labels (and corresponding data) by a horizontal axis range.
  * Returns the indices of labels that fall within [min, max].
@@ -16,4 +17,4 @@ export declare function resolveBarGapPadding(barGap?: number): number;
 export declare function computeLinearDomain(values: number[], range?: {
     min?: number;
     max?: number;
-}): [number, number];
+}, scaleType?: ScaleType): [number, number];

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

@@ -1,2 +1,10 @@
 import { ChartData, ChartOptions } from '../../types';
+/**
+ * Render a pie chart.
+ *
+ * Pie is a thin wrapper around the shared `renderArc` (innerRadiusRatio = 0).
+ * Slices are joined via the SceneTransition orchestrator (`featureJoin` with
+ * role `'mark-per-category'`) inside `renderArc` itself; this file holds no
+ * rendering logic of its own.
+ */
 export declare function render(container: HTMLElement, data: ChartData, options?: ChartOptions, transition?: boolean): void;

package/dist/charts/types.d.ts

@@ -46,7 +46,6 @@ export interface FrameOptions {
     sourceUrl?: string;
     sizing?: FrameSizing;
     aspectRatio?: number;
-    showCredit?: boolean;
     padding?: string;
     transparentBackground?: boolean;
 }

package/dist/dsl/types.d.ts

@@ -14,10 +14,12 @@ export interface ColorizeNode {
     type: DslNodeType.Colorize;
     target: string;
     properties: PropertyNode[];
+    fromHighlight?: boolean;
 }
 export interface HighlightNode {
     type: DslNodeType.Highlight;
     target: string;
+    properties: PropertyNode[];
 }
 export interface AreaFillNode {
     type: DslNodeType.AreaFill;
@@ -82,6 +84,7 @@ export interface ChartNode {
     highlights: HighlightNode[];
     areaFills: AreaFillNode[];
     annotations: AnnotationNode[];
+    annotationVisibility: AnnotationVisibilityNode[];
     series: SeriesNode[];
     scenes: SceneNode[];
     transforms: TransformNode[];

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export { renderHorizontalAxis } from './charts/axis/horizontal-axis';
 export { renderLegend } from './charts/legend/legend';
 export { registerChart, getChart, getChartOptions, listCharts } from './charts/registry';
 export { parseData, buildChartOptions } from './charts/chart-helpers';
+export { recommendCharts } from './recommendations/recommend';
+export type { ChartRecommendation, RecommendationFitness, ColumnType } from './recommendations/recommend';
 export { getChartTypeDefaults, resolveChartTypeOptions } from './charts/resolve';
 export { resolveBarGapPadding, DEFAULT_BAR_GAP } from './charts/scale-helpers';
 export { resolvePalette, listPalettes } from './charts/palettes';
@@ -27,3 +29,5 @@ export { samples } from './samples';
 export type { ChartSample } from './samples';
 export { renderBpc, renderChart, astToDefinition, resolveScene } from './render';
 export type { ChartDefinition, RenderOptions, ResolvedChartState } from './render';
+export { SceneTransition, getSceneTransition, featureJoin, snapshotLiveAttrs, BC_TRANSITION_NAME, } from './transitions';
+export type { CommitOptions, TransitionMode, SceneTransitionState, FeatureRole, FeatureJoinConfig, AttrMap, AttrValue, } from './transitions';