@blueprint-chart/lib 2.0.0 → 2.1.0

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

@@ -14,6 +14,15 @@ export interface AxisServiceConfig {
     };
     order?: 'vertical-first' | 'horizontal-first';
 }
+/**
+ * Drop the cached AxisService when a container switches chart type.
+ *
+ * The cache is keyed per container only, so the next type inherits the previous
+ * one's axis DOM, and d3-axis's tick data-join reuses ticks that match by
+ * value, so a type that stripped its tick labels (`labelPosition = off`) leaves
+ * the next type's ticks permanently text-less.
+ */
+export declare function resetAxesOnChartTypeChange(container: HTMLElement, chartType: string): void;
 export declare class AxisService {
     private vGroup;
     private hGroup;

package/dist/charts/legend/legend-size.d.ts

@@ -1,3 +1,16 @@
+/**
+ * Legend item text and the px advance to the next item. `maxWidth` is the row
+ * width: a single item wider than the row is truncated with an ellipsis, since
+ * nothing downstream clips it and the text otherwise runs past the frame edge.
+ * The suffix carries the value, so it survives and the label absorbs the cut.
+ */
+export declare function fitLegendItem(label: string, suffix?: string, maxWidth?: number): {
+    label: string;
+    suffix: string;
+    width: number;
+};
+/** Width a vertical legend column needs for `texts`. */
+export declare function legendColumnWidth(texts: string[]): number;
 export declare function estimateLegendSize(labels: string[], position: string, availableWidth?: number): {
     width: number;
     height: number;

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

@@ -22,6 +22,11 @@ export declare function bboxEdgeToward(bbox: {
     y: number;
 };
 export declare function ensureArrowMarker(svg: SVGElement | null, color?: string): string;
+/**
+ * A non-positive radius paints nothing — SVG rejects a negative `r` outright —
+ * so an unusable size resolves to the documented default instead.
+ */
+export declare function resolveCircleRadius(size?: number): number;
 export declare function renderTargetCircle(g: d3.Selection<SVGGElement, unknown, null, undefined>, cx: number, cy: number, opts?: {
     size?: number;
     style?: StrokeStyle;
@@ -53,5 +58,11 @@ export declare function renderAnnotationText(g: d3.Selection<SVGGElement, unknow
     backgroundColor?: string;
     textOutline?: boolean;
 }): void;
-export declare function resolveXPosition(value: number | string, scaleX: AnnotationContext['scaleX'], anchor?: RangeAnchor): number;
-export declare function resolveYPosition(value: number | string, scaleY: d3.ScaleLinear<number, number> | d3.ScaleSymLog<number, number>): number;
+/**
+ * Position of a range endpoint on the category axis, or `null` when the endpoint
+ * does not resolve. Anchoring an unresolved endpoint at the plot origin would
+ * silently highlight a category the author never named.
+ */
+export declare function resolveXPosition(value: number | string, scaleX: AnnotationContext['scaleX'], anchor?: RangeAnchor): number | null;
+/** Position of a range endpoint on the value axis, or `null` when it does not resolve. */
+export declare function resolveYPosition(value: number | string, scaleY: d3.ScaleLinear<number, number> | d3.ScaleSymLog<number, number>): number | null;

package/dist/charts/plugins/arc-labels.d.ts

@@ -44,8 +44,16 @@ export declare function renderAutoArcLabels(parent: d3.Selection<SVGGElement, un
  * Estimate extra margins needed for arc labels beyond what the arc already
  * occupies.  The text column sits at outerRadius + STUB_LENGTH + HORIZONTAL_SEG + 6
  * from centre; we need room for the text itself beyond that.
+ *
+ * `available` is the box the arc has to fit in. The margins are capped against
+ * it, because they are subtracted from the canvas with no other lower bound:
+ * one long label, a phone-width container or twenty slices otherwise leave a
+ * radius of zero and no arcs are painted.
  */
-export declare function estimateArcLabelMargins(labels: string[], outerRadius: number): {
+export declare function estimateArcLabelMargins(labels: string[], outerRadius: number, available?: {
+    width: number;
+    height: number;
+}): {
     left: number;
     right: number;
     top: number;

package/dist/charts/text-measure.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared text measurement for the layout estimators: axis tick density, legend
+ * item advance, arc label margins and annotation wrapping all need to know how
+ * wide a string will actually render.
+ *
+ * Three sources, first available wins:
+ * 1. an offscreen 2D canvas — the browser and the editor;
+ * 2. a detached SVG `<text>` and `getComputedTextLength()` — what the Node
+ *    backend has, through the jsdom shim in `render/backends/text-shim.ts`;
+ * 3. the per-glyph estimate below, when a render environment offers neither.
+ *
+ * The result is never below the estimate. The font the Node backend bundles
+ * (DejaVu Sans) has no CJK glyphs, so measuring Japanese text there returns the
+ * width of the notdef box (~0.6em) rather than the ~1em a CJK face advances;
+ * without the floor, wide scripts would be under-reserved headlessly.
+ */
+/** Rendered width of `text` in px at `fontSizePx`, in the chart font. */
+export declare function measureTextWidth(text: string, fontSizePx: number): number;
+/** Rendered width of the widest of `texts`, or 0 when there are none. */
+export declare function measureMaxTextWidth(texts: string[], fontSizePx: number): number;
+/**
+ * Longest prefix of `text` that fits in `maxWidth`, with `suffix` appended when
+ * anything had to be dropped. Returns `text` unchanged when it already fits.
+ */
+export declare function truncateToWidth(text: string, maxWidth: number, fontSizePx: number, suffix?: string): string;