@blueprint-chart/lib 2.0.0 → 2.2.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

@@ -31,6 +31,7 @@ export declare function renderInsideArcLabels(parent: d3.Selection<SVGGElement,
     chartWidth: number;
     chartHeight: number;
     fontSize?: number;
+    bgColor?: string;
 }): void;
 export declare function renderAutoArcLabels(parent: d3.Selection<SVGGElement, unknown, null, undefined>, data: ArcLabelDatum[], opts: {
     outerRadius: number;
@@ -44,8 +45,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/scale-helpers.d.ts

@@ -12,7 +12,7 @@ export declare const DEFAULT_BAR_GAP = 60;
  * to [0, 100]; non-finite or undefined values fall back to DEFAULT_BAR_GAP.
  */
 export declare function resolveBarGapPadding(barGap?: number): number;
-export declare function computeLinearDomain(values: number[], range?: AxisRange, scaleType?: ScaleType): [number, number];
+export declare function computeLinearDomain(values: number[], range?: AxisRange, scaleType?: ScaleType, anchorZero?: boolean): [number, number];
 /**
  * Decade tick values (1, 10, 100, ...) for a logarithmic axis, or null when the
  * scale is not logarithmic or holds no decade.

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;

package/dist/charts/value-label-fit.d.ts

@@ -7,6 +7,11 @@ export interface ValueLabelFitInput {
     /** px extent along y (vertical bar: length; horizontal bar: thickness) */
     barHeight: number;
 }
+/**
+ * A per-character estimate held while labels were bare numbers. A number
+ * format adds a prefix and a suffix (`$1,200,000.0M`), and the shared measurer
+ * keeps the `max(measured, floor)` shape that a headless CJK render needs.
+ */
 export declare function estimateLabelWidth(text: string): number;
 export declare function shouldRenderValueLabel(input: ValueLabelFitInput): boolean;
 /**

package/dist/embed.js

@@ -1,2 +1,2 @@
-import { a as e, i as t, o as n, r, t as i } from "./runtime-DDhsXDn5.js";
+import { a as e, i as t, o as n, r, t as i } from "./runtime-gzeMNwqx.js";
 export { r as ERROR_MESSAGE, t as RESIZE_MESSAGE, i as buildSrcdoc, e as isErrorMessage, n as readResizeHeight };

package/dist/enums.d.ts

@@ -44,6 +44,24 @@ export declare enum TickPosition {
     Above = "above",
     Below = "below"
 }
+/**
+ * How the frame sizes itself, as the *renderer* names it.
+ *
+ * These are deliberately not the DSL's vocabulary. The `sizing` property in BPC
+ * source takes `responsive`, `fixed` or `max-width`, and the two sets share no
+ * value, so `sizing = standard` in a chart is not valid DSL. The mapping:
+ *
+ * | DSL `sizing` | FrameSizing    | meaning                                 |
+ * |--------------|----------------|-----------------------------------------|
+ * | `responsive` | `Auto`         | fill the container                      |
+ * | `fixed`      | `Standard`     | a fixed width, set by `fixedWidth`      |
+ * | `max-width`  | `Standard`     | fill up to `maxWidth`                   |
+ * | (n/a)        | `AspectRatio`  | reached through `heightMode`, not `sizing` |
+ *
+ * Renaming either side is a breaking change with no automatic migration (it
+ * would mean rewriting user BPC source), so the two vocabularies stay and this
+ * table is the contract. See issue #122.
+ */
 export declare enum FrameSizing {
     Auto = "auto",
     Standard = "standard",