@blueprint-chart/lib 1.8.3 → 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/axis-options.d.ts

@@ -0,0 +1,3 @@
+import { ChartOptions, ChartTypeOptions } from './types';
+export declare function buildVerticalAxisOptions(opts: Partial<ChartTypeOptions>): Partial<ChartOptions>;
+export declare function buildHorizontalAxisOptions(opts: Partial<ChartTypeOptions>): Partial<ChartOptions>;

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

@@ -1,4 +1,4 @@
-import { Margin } from '../types';
+import { AxisRange, Margin } from '../types';
 export interface CanvasElements {
     svg: SVGSVGElement;
     chartArea: SVGGElement;
@@ -20,10 +20,7 @@ export declare function computeMarginDelta(priorMargin: Pick<Margin, 'top' | 'le
  * 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?: {
-    min?: number;
-    max?: number;
-}, numberFormat?: string | null, scaleType?: string): number;
+export declare function estimateVerticalLabelWidth(values: number[], range?: AxisRange, numberFormat?: string | null, scaleType?: string): number;
 /**
  * Estimate the pixel width of the widest string label (for band/category axes).
  */

package/dist/charts/category-label-line.d.ts

@@ -0,0 +1,16 @@
+/** Height of the strip an inline category label is drawn in. */
+export declare const CATEGORY_LABEL_HEIGHT = 13;
+/**
+ * Height the inline category label may take out of `extent` — a band's
+ * thickness, or the plot height for column charts. Shrinks the strip, and then
+ * gives up on it, rather than letting the subtraction turn the bar's own extent
+ * negative: a rect with a negative height is not rendered at all, so a dense
+ * chart lost every one of its bars.
+ */
+export declare function categoryLabelLineHeight(extent: number): number;
+/**
+ * Whether a horizontal bar chart should draw its category labels above their
+ * bars instead of in the left gutter. An explicit `outside` keeps them in the
+ * gutter: the author asked for them there.
+ */
+export declare function categoryLabelsNeedTheirOwnLine(containerWidth: number, verticalLabelPosition?: string): boolean;

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

@@ -1,3 +1,2 @@
-import { ChartData, ChartOptions, ChartTypeOptions } from './types';
-export declare function parseData(raw: string): ChartData;
-export declare function buildChartOptions(opts: Partial<ChartTypeOptions>, backgroundColor?: string): Partial<ChartOptions>;
+export { parseData } from './parse-data';
+export { buildChartOptions } from './chart-options';

package/dist/charts/chart-options.d.ts

@@ -0,0 +1,2 @@
+import { ChartOptions, ChartTypeOptions } from './types';
+export declare function buildChartOptions(opts: Partial<ChartTypeOptions>, backgroundColor?: string, chartType?: string): Partial<ChartOptions>;

package/dist/charts/contrast.d.ts

@@ -28,9 +28,10 @@ export declare function resolveBackgroundColor(el?: Element | null): string;
 export declare function readableColor(color: string, bg?: string): string;
 /**
  * Adjusts an array of colors so that:
- * 1. Every color is readable against `bg` (WCAG contrast ratio >= 3).
- * 2. Adjacent colors are perceptually distinguishable (deltaE >= 12).
+ * 1. Every color is readable against `bg` (WCAG contrast ratio >= MIN_CONTRAST).
+ * 2. No color is perceptually close to any other (deltaE >= MIN_ADJACENT_DELTA_E).
  *
- * Only lightness is changed — hue and saturation are preserved.
+ * Lightness is changed first; hue rotates only when the lightness axis is
+ * exhausted, so a palette whose entries share a hue still comes out distinct.
  */
 export declare function adjustColorsForBackground(colors: string[], bg: string): string[];

package/dist/charts/date-parse.d.ts

@@ -6,6 +6,12 @@ export declare function parseDate(s: string): Date | null;
  * Jan 1 2020 rather than the number 2020.
  */
 export declare function parseDateOrNumber(s: string): number | undefined;
+/**
+ * Parse a string as a plain number or, failing that, as a date (epoch ms).
+ * Numbers take precedence so a numeric axis bound like "2000" stays the
+ * number 2000 instead of Jan 1 2000.
+ */
+export declare function parseNumberOrDate(s: string): number | undefined;
 export declare function detectDates(labels: string[]): {
     dates: Date[];
     granularity: DateGranularity;

package/dist/charts/frame/frame.d.ts

@@ -5,4 +5,10 @@ export interface FrameElements {
     body: HTMLElement;
     footer: HTMLElement;
 }
+/**
+ * Expand a CSS `padding` shorthand to its four sides. The stylesheet feeds each
+ * side into a separate shorthand slot, so a raw multi-value string would build
+ * an over-long declaration that the browser rejects outright.
+ */
+export declare function expandPaddingShorthand(padding: string): [string, string, string, string];
 export declare function createFrame(container: HTMLElement, options?: FrameOptions | null): FrameElements;

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/parse-data.d.ts

@@ -0,0 +1,2 @@
+import { ChartData } from './types';
+export declare function parseData(raw: string): ChartData;

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/plugins/highlight.d.ts

@@ -1,9 +1,15 @@
 /** Opacity applied to non-targeted marks when a highlight is active. */
 export declare const HIGHLIGHT_DIM_OPACITY = 0.35;
-/** Build the set of highlighted target keys from the DSL highlight directives. */
-export declare function highlightTargetSet(highlights?: {
+/**
+ * Build the set of highlighted target keys from the DSL highlight directives,
+ * keeping only the ones present in `keys` (the mark keys the caller will draw).
+ * A target naming a renamed or misspelled category would otherwise leave a
+ * non-empty set that matches no mark, and `highlightOpacity` would dim
+ * everything instead of emphasising anything.
+ */
+export declare function highlightTargetSet(highlights: {
     target: string;
-}[]): Set<string>;
+}[] | undefined, keys: Iterable<string>): Set<string>;
 /**
  * Opacity for a mark given the active highlight targets:
  * no targets → `base`; this key targeted → `base`; otherwise → HIGHLIGHT_DIM_OPACITY.

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

@@ -1,12 +1,10 @@
+import { AxisRange } from './types';
 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].
  */
-export declare function filterLabelsByRange(labels: string[], range?: {
-    min?: number;
-    max?: number;
-}): number[];
+export declare function filterLabelsByRange(labels: string[], range?: AxisRange): number[];
 export declare const DEFAULT_BAR_GAP = 60;
 /**
  * Convert a barGap (percentage of bar size) to a d3 scaleBand paddingInner value.
@@ -14,7 +12,16 @@ 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?: {
-    min?: number;
-    max?: number;
-}, scaleType?: ScaleType): [number, number];
+export declare function computeLinearDomain(values: number[], range?: AxisRange, scaleType?: ScaleType): [number, number];
+/**
+ * Decade tick values (1, 10, 100, ...) for a logarithmic axis, or null when the
+ * scale is not logarithmic or holds no decade.
+ *
+ * d3's symlog scale generates ticks linearly, which on a log axis stacks every
+ * label into the top decade and emits a 0 that a log axis cannot represent.
+ * The domain floor is 0 once `.nice()` has run, so decades start at 1 there.
+ */
+export declare function logTickValues(scale: {
+    domain: () => unknown[];
+    constant?: () => unknown;
+}, maxTicks: number): number[] | null;

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

@@ -1,4 +1,25 @@
-import { SeriesOverride } from './types';
+import { ChartData, SeriesOverride } from './types';
+/**
+ * The series a multi-series renderer should draw. A `data` block with no
+ * `series` meta-row carries its numbers in `values` alone, which left the
+ * stacked, grouped and split renderers with an empty series list and nothing
+ * to draw. Such data is a stack, a group or a panel of one: it gets a single
+ * unnamed series, so every category still renders one bar.
+ */
+export declare function seriesOrImplicit(data: ChartData): {
+    name: string;
+    values: number[];
+}[];
+/**
+ * Extend `colors` so it covers `count` series. `resolveSeriesColor` indexes
+ * modulo the palette length, so a chart with more series than the palette has
+ * colours paints two of them identically in both the plot and the legend;
+ * interpolating through LCH gives every series its own colour, the way the arc
+ * renderer already does for slices. Entries chroma cannot parse are dropped
+ * rather than fed to `chroma.scale`, which throws on them and would take the
+ * whole render down.
+ */
+export declare function expandColorsToSeries(colors: string[], count: number): string[];
 export declare function resolveSeriesColor(name: string, index: number, colors: string[], overrides?: SeriesOverride[]): string;
 export declare function resolveSeriesDash(name: string, overrides?: SeriesOverride[]): string;
 export declare function resolveSeriesWidth(name: string, overrides?: SeriesOverride[]): number;

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

@@ -12,6 +12,6 @@ export interface StackedPoint {
 export declare function computeStack(data: ChartData): d3.Series<Record<string, number>, string>[];
 /**
  * Compute a stacked layout normalized to 100%.
- * Each category's values sum to 100.
+ * Each category's magnitudes sum to 100, negatives below the baseline.
  */
 export declare function computeStack100(data: ChartData): d3.Series<Record<string, number>, string>[];

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/themes/index.d.ts

@@ -0,0 +1,6 @@
+export interface ThemeEntry {
+    name: string;
+    label: string;
+    description: string;
+}
+export declare function listThemes(): ThemeEntry[];

package/dist/charts/types.d.ts

@@ -16,13 +16,19 @@ export interface ColorizeConfig {
 export interface HighlightConfig {
     target: string;
 }
+/**
+ * An axis range bound. A string keeps the raw DSL value so each axis can parse
+ * it in its own unit space: a number on a value axis, a date on a
+ * date-detected category axis.
+ */
+export interface AxisRange {
+    min?: number | string;
+    max?: number | string;
+}
 export interface AxisOptions {
     direction?: AxisDirection;
     scaleType?: ScaleType;
-    range?: {
-        min?: number;
-        max?: number;
-    };
+    range?: AxisRange;
     ticks?: number[];
     showAxis?: boolean;
     showTicks?: boolean;

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

@@ -9,3 +9,34 @@ export interface ValueLabelFitInput {
 }
 export declare function estimateLabelWidth(text: string): number;
 export declare function shouldRenderValueLabel(input: ValueLabelFitInput): boolean;
+/**
+ * Pixel width of a text's ink, never below the per-glyph floor: `measureText` is
+ * asked about 11px sans-serif while the chart renders in its own font, so an
+ * under-report is what lets a label cross a boundary it was measured to fit in.
+ */
+export declare function estimateTextInk(text: string, font?: string): number;
+export interface LabelViewport {
+    /** Plot extent in chart-area coordinates. */
+    width: number;
+    height: number;
+    /** Canvas margins around the plot, which the label may reach into. */
+    margin: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+}
+/**
+ * Place a value label above a point mark, in chart-area coordinates, so its ink
+ * box stays inside the SVG viewport. Labels for line and area charts sit outside
+ * the plot clip, so nothing else stops the canvas edge from slicing one: a cut
+ * number reads as a smaller one, which is worse than a missing label.
+ *
+ * A mark the axis range excludes is labelled at the plot edge it was clipped to,
+ * matching what bar-horizontal does for the same case.
+ */
+export declare function clampPointLabel(text: string, cx: number, cy: number, vp: LabelViewport): {
+    x: number;
+    y: number;
+};

package/dist/dsl/converter.d.ts

@@ -1,5 +1,10 @@
 import { PropertyNode, DataNode, SceneNode, ColorizeNode, HighlightNode, AnnotationNode, SeriesNode, AreaFillNode } from './types';
 import { ColorizeConfig, HighlightConfig, AnnotationConfig, AreaFillConfig, SeriesOverride } from '../charts/types';
+/**
+ * A DSL boolean is case-insensitive: `validate.ts` lowercases before comparing,
+ * so `TRUE` passes validation and must resolve the same way here.
+ */
+export declare const toBool: (v: unknown) => boolean;
 /**
  * Convert an array of AST property nodes into a key→value map.
  */

package/dist/dsl/quoting.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Wrap a label, target, name or value in quotes for emission as DSL. Newlines
+ * and tabs are escaped rather than emitted raw: the data-string format read by
+ * `parseData` is line-oriented, so a raw newline inside a label costs the row.
+ */
+export declare function quoteDslString(value: string): string;
+/** Reverse of `quoteDslString`, for the escape set the grammar's `EscapeChar` accepts. */
+export declare function unescapeDslString(value: string): string;
+/** Strip the surrounding quotes of a quoted segment, if any, and unescape it. */
+export declare function unquoteDslString(value: string): string;
+/**
+ * Split on the commas that separate list entries, leaving alone the ones that
+ * belong to an entry: inside a quoted string (`"Paris, France"`) or inside a
+ * functional notation (`rgb(230,57,70)`).
+ */
+export declare function splitTopLevelCommas(value: string): string[];

package/dist/dsl/types.d.ts

@@ -13,12 +13,18 @@ export interface PropertyNode {
     quotedKey?: boolean;
     /** `//` comment lines authored immediately above this node, text only (no `//`). */
     leadingComments?: string[];
+    /** `//` comment authored at the end of this node's own line, text only (no `//`). */
+    trailingComment?: string;
 }
 export interface DataNode {
     type: DslNodeType.Data;
     entries: PropertyNode[];
     /** `//` comment lines authored immediately above this node, text only (no `//`). */
     leadingComments?: string[];
+    /** `//` comment authored at the end of this node's own line, text only (no `//`). */
+    trailingComment?: string;
+    /** `//` comment lines authored after this block's last member, text only (no `//`). */
+    trailingComments?: string[];
 }
 export interface ColorizeNode {
     type: DslNodeType.Colorize;
@@ -27,6 +33,10 @@ export interface ColorizeNode {
     fromHighlight?: boolean;
     /** `//` comment lines authored immediately above this node, text only (no `//`). */
     leadingComments?: string[];
+    /** `//` comment authored at the end of this node's own line, text only (no `//`). */
+    trailingComment?: string;
+    /** `//` comment lines authored after this block's last member, text only (no `//`). */
+    trailingComments?: string[];
 }
 export interface HighlightNode {
     type: DslNodeType.Highlight;
@@ -34,6 +44,8 @@ export interface HighlightNode {
     properties: PropertyNode[];
     /** `//` comment lines authored immediately above this node, text only (no `//`). */
     leadingComments?: string[];
+    /** `//` comment authored at the end of this node's own line, text only (no `//`). */
+    trailingComment?: string;
 }
 export interface AreaFillNode {
     type: DslNodeType.AreaFill;
@@ -42,6 +54,10 @@ export interface AreaFillNode {
     properties: PropertyNode[];
     /** `//` comment lines authored immediately above this node, text only (no `//`). */
     leadingComments?: string[];
+    /** `//` comment authored at the end of this node's own line, text only (no `//`). */
+    trailingComment?: string;
+    /** `//` comment lines authored after this block's last member, text only (no `//`). */
+    trailingComments?: string[];
 }
 export interface PointAnnotationNode {
     type: DslNodeType.Annotation;
@@ -50,6 +66,10 @@ export interface PointAnnotationNode {
     properties: PropertyNode[];
     /** `//` comment lines authored immediately above this node, text only (no `//`). */
     leadingComments?: string[];
+    /** `//` comment authored at the end of this node's own line, text only (no `//`). */
+    trailingComment?: string;
+    /** `//` comment lines authored after this block's last member, text only (no `//`). */
+    trailingComments?: string[];
 }
 export interface RangeAnnotationNode {
     type: DslNodeType.Annotation;
@@ -57,6 +77,10 @@ export interface RangeAnnotationNode {
     properties: PropertyNode[];
     /** `//` comment lines authored immediately above this node, text only (no `//`). */
     leadingComments?: string[];
+    /** `//` comment authored at the end of this node's own line, text only (no `//`). */
+    trailingComment?: string;
+    /** `//` comment lines authored after this block's last member, text only (no `//`). */
+    trailingComments?: string[];
 }
 export interface FreeAnnotationNode {
     type: DslNodeType.Annotation;
@@ -64,6 +88,10 @@ export interface FreeAnnotationNode {
     properties: PropertyNode[];
     /** `//` comment lines authored immediately above this node, text only (no `//`). */
     leadingComments?: string[];
+    /** `//` comment authored at the end of this node's own line, text only (no `//`). */
+    trailingComment?: string;
+    /** `//` comment lines authored after this block's last member, text only (no `//`). */
+    trailingComments?: string[];
 }
 export type AnnotationNode = PointAnnotationNode | RangeAnnotationNode | FreeAnnotationNode;
 export interface SeriesNode {
@@ -72,6 +100,10 @@ export interface SeriesNode {
     properties: PropertyNode[];
     /** `//` comment lines authored immediately above this node, text only (no `//`). */
     leadingComments?: string[];
+    /** `//` comment authored at the end of this node's own line, text only (no `//`). */
+    trailingComment?: string;
+    /** `//` comment lines authored after this block's last member, text only (no `//`). */
+    trailingComments?: string[];
 }
 export interface SceneNode {
     type: DslNodeType.Scene;
@@ -86,6 +118,10 @@ export interface SceneNode {
     transforms: TransformNode[];
     /** `//` comment lines authored immediately above this node, text only (no `//`). */
     leadingComments?: string[];
+    /** `//` comment authored at the end of this node's own line, text only (no `//`). */
+    trailingComment?: string;
+    /** `//` comment lines authored after this block's last member, text only (no `//`). */
+    trailingComments?: string[];
 }
 export interface TransformNode {
     type: DslNodeType.Transform;
@@ -93,6 +129,10 @@ export interface TransformNode {
     properties: PropertyNode[];
     /** `//` comment lines authored immediately above this node, text only (no `//`). */
     leadingComments?: string[];
+    /** `//` comment authored at the end of this node's own line, text only (no `//`). */
+    trailingComment?: string;
+    /** `//` comment lines authored after this block's last member, text only (no `//`). */
+    trailingComments?: string[];
 }
 export interface ChartNode {
     type: DslNodeType.Chart;
@@ -106,4 +146,6 @@ export interface ChartNode {
     series: SeriesNode[];
     scenes: SceneNode[];
     transforms: TransformNode[];
+    /** `//` comment lines authored after this block's last member, text only (no `//`). */
+    trailingComments?: string[];
 }

package/dist/dsl/validate.d.ts

@@ -23,6 +23,12 @@ export interface ValidationResult {
  * catches the `fromX`/`toX`-on-a-range bug.
  */
 export declare const POINT_ANNOTATION_KEYS: Set<string>;
+/**
+ * Series override body property keys, derived from the keys
+ * convertSeriesOverrides() in converter.ts actually reads. Anything not listed
+ * never reaches SeriesOverride, so the renderer cannot honour it.
+ */
+export declare const SERIES_OVERRIDE_KEYS: Set<string>;
 export declare const RANGE_ANNOTATION_KEYS: Set<string>;
 export declare const FREE_ANNOTATION_KEYS: Set<string>;
 /**

package/dist/embed.js

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

package/dist/enums.d.ts

@@ -192,3 +192,26 @@ export declare enum DslNodeType {
     Transform = "transform",
     Chart = "chart"
 }
+export declare enum TransformType {
+    Sort = "sort",
+    Filter = "filter",
+    HideColumns = "hide-columns",
+    Transpose = "transpose",
+    Parse = "parse",
+    Rename = "rename",
+    GroupBy = "group-by",
+    Computed = "computed"
+}
+export declare enum FilterCondition {
+    Equals = "equals",
+    NotEquals = "not-equals",
+    Contains = "contains",
+    GreaterThan = "greater-than",
+    LessThan = "less-than"
+}
+export declare enum ParseOperationCategory {
+    Type = "type",
+    String = "string",
+    Numeric = "numeric",
+    Date = "date"
+}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { ChartType, AxisDirection, ScaleType, GridStyle, LabelPosition, LabelRotation, TickPosition, FrameSizing, CompassDirection, AnnotationLineStyle, StrokeStyle, AnnotationKind, RangeAnchor, Orientation, SymbolShape, SymbolShowOn, SymbolStyle, SortDirection, SortMode, LegendPosition, Anchor, ValueLabelPosition, CrosshairDirection, CrosshairStyle, StackMode, LineStyle, ChartOptionType, DirectLabelMode, Interpolation, DslNodeType, } from './enums';
+export { ChartType, AxisDirection, ScaleType, GridStyle, LabelPosition, LabelRotation, TickPosition, FrameSizing, CompassDirection, AnnotationLineStyle, StrokeStyle, AnnotationKind, RangeAnchor, Orientation, SymbolShape, SymbolShowOn, SymbolStyle, SortDirection, SortMode, LegendPosition, Anchor, ValueLabelPosition, CrosshairDirection, CrosshairStyle, StackMode, LineStyle, ChartOptionType, DirectLabelMode, Interpolation, DslNodeType, TransformType, FilterCondition, ParseOperationCategory, } from './enums';
 export { ANNOTATION_KIND_KEYWORD } from './enums';
 export type { ChartData, ChartOptions, ChartRenderer, ChartOptionDef, ChartTypeOptions, ChartTypeOptionKey, ColorizeConfig, HighlightConfig, AxisOptions, FrameOptions, AreaFillConfig, AnnotationConfig, PointAnnotationConfig, RangeAnnotationConfig, FreeAnnotationConfig, AnnotationLineConfig, LineSymbolConfig, SeriesOverride, Margin, } from './charts/types';
 export { createFrame } from './charts/frame/frame';
@@ -19,6 +19,8 @@ export { getChartTypeDefaults, resolveChartTypeOptions } from './charts/resolve'
 export { resolveBarGapPadding, DEFAULT_BAR_GAP } from './charts/scale-helpers';
 export { resolvePalette, listPalettes } from './charts/palettes';
 export type { PaletteEntry } from './charts/palettes';
+export { listThemes } from './charts/themes';
+export type { ThemeEntry } from './charts/themes';
 export { resolveSeriesColor, resolveSeriesInterpolation, isSeriesHidden } from './charts/series-helpers';
 export { resolveBackgroundColor, adjustColorsForBackground, wcagContrastRatio, wcagLevel } from './charts/contrast';
 export { getTransitionDuration, snapshotForFadeOut, commitFadeOut, fadeIn } from './charts/motion';
@@ -27,15 +29,21 @@ export { getCvdFilterId, createCvdSvgFilter, simulateCvdColor, checkCvdColors }
 export type { CvdType, CvdIssue } from './charts/colorblind';
 export { parse } from './dsl/parser';
 export { serialize, compactSerialize, compactSerializeDeep } from './dsl/serializer';
+export { quoteDslString } from './dsl/quoting';
+export { toBool } from './dsl/converter';
 export { propertyMap, extractChartTypeOptions, dataEntriesToString, extractSceneOverrides, convertColorizes, convertHighlights, convertAreaFills, convertAnnotations, convertSeriesOverrides } from './dsl/converter';
 export type { AnnotationNode, PointAnnotationNode, RangeAnnotationNode, FreeAnnotationNode, AreaFillNode, ChartNode, DataNode, ColorizeNode, HighlightNode, PropertyNode, SceneNode, SeriesNode, TransformNode } from './dsl/types';
 export { validateChart } from './dsl/validate';
 export type { ValidationIssue, ValidationResult } from './dsl/validate';
+export { TRANSFORM_TYPES, applyTransformSteps, applyTransformNodes, applyTransformNodesToChartData, transformNodesToSteps, transformValue, parseOperations, parseOperationMap, isTypeCompatible, getOutputType, NULL_VALUE, parseBpcData, serializeTableData, chartDataToTable, detectColumnTypes, cleanNumericValue, isDateValue, isNumberValue, } from './transforms';
+export type { ParseOperation, TransformResult, TransformStep } from './transforms';
 export { samples } from './samples';
 export type { ChartSample } from './samples';
 export { renderBpc, renderChart, astToDefinition, resolveScene, render } from './render';
 export type { ChartDefinition, RenderOptions, ResolvedChartState, ChartHandle, RenderApiOptions, OutputOptions } from './render';
 export { ChartParseError, PngBrowserUnsupportedError, MissingNodeRenderDepsError } from './render';
+export { buildFrameSvg } from './render';
+export type { FrameSvgLayout, FrameSvgTextBlock, FrameSvgPlot, ChartAccessibility } from './render';
 export { buildSrcdoc } from './runtime/runtime';
 export { SceneTransition, getSceneTransition, featureJoin, snapshotLiveAttrs, BC_TRANSITION_NAME, } from './transitions';
 export type { CommitOptions, TransitionMode, SceneTransitionState, FeatureRole, FeatureJoinConfig, AttrMap, AttrValue, } from './transitions';