@blueprint-chart/lib 0.1.2

package/dist/dsl/converter.d.ts

@@ -0,0 +1,50 @@
+import { PropertyNode, DataNode, SceneNode, ColorizeNode, HighlightNode, AnnotationNode, SeriesNode, AreaFillNode } from './types';
+import { ColorizeConfig, HighlightConfig, AnnotationConfig, AreaFillConfig, SeriesOverride } from '../charts/types';
+/**
+ * Convert an array of AST property nodes into a key→value map.
+ */
+export declare function propertyMap(properties: PropertyNode[]): Map<string, string | number | boolean>;
+/**
+ * Extract typed chart-type options from AST properties by using the registry's
+ * option definitions to determine the correct type for each key.
+ */
+export declare function extractChartTypeOptions(chartType: string, properties: PropertyNode[]): Record<string, unknown>;
+export declare function dataEntriesToString(data: DataNode): string;
+/**
+ * Extract scene overrides from a SceneNode, returning structured data
+ * suitable for applying scene-level configuration.
+ */
+export declare function extractSceneOverrides(scene: SceneNode, chartType: string): {
+    name: string | null;
+    chartType: string | undefined;
+    properties: Map<string, string | number | boolean>;
+    data: DataNode | null;
+    chartTypeOptions: Record<string, unknown>;
+    colorizes: SceneNode['colorizes'];
+    highlights: SceneNode['highlights'];
+    areaFills: SceneNode['areaFills'];
+    annotations: SceneNode['annotations'];
+    annotationVisibility: SceneNode['annotationVisibility'];
+    series: SceneNode['series'];
+    transforms: SceneNode['transforms'];
+};
+/**
+ * Convert AST highlight nodes to ColorizeConfig objects.
+ */
+export declare function convertColorizes(nodes: ColorizeNode[]): ColorizeConfig[];
+/**
+ * Convert AST highlight nodes to HighlightConfig objects.
+ */
+export declare function convertHighlights(nodes: HighlightNode[]): HighlightConfig[];
+/**
+ * Convert AST area-fill nodes to AreaFillConfig objects.
+ */
+export declare function convertAreaFills(nodes: AreaFillNode[]): AreaFillConfig[];
+/**
+ * Convert AST annotation nodes to AnnotationConfig objects.
+ */
+export declare function convertAnnotations(nodes: AnnotationNode[]): AnnotationConfig[];
+/**
+ * Convert AST series nodes to SeriesOverride objects.
+ */
+export declare function convertSeriesOverrides(nodes: SeriesNode[]): SeriesOverride[];

package/dist/dsl/index.d.ts

@@ -0,0 +1,3 @@
+export { parse } from './parser';
+export { serialize } from './serializer';
+export type { AnnotationNode, AreaFillNode, ChartNode, DataNode, ColorizeNode, HighlightNode, PropertyNode, SceneNode, SeriesNode, StepNode, TransformNode } from './types';

package/dist/dsl/lexer.d.ts

@@ -0,0 +1,8 @@
+export interface Token {
+    type: TokenType;
+    value: string;
+    line: number;
+    column: number;
+}
+export type TokenType = 'keyword' | 'string' | 'number' | 'percent' | 'lbrace' | 'rbrace' | 'equals' | 'tab' | 'identifier' | 'eof';
+export declare function tokenize(input: string): Token[];

package/dist/dsl/parser.d.ts

@@ -0,0 +1,2 @@
+import { ChartNode } from './types';
+export declare function parse(input: string): ChartNode;

package/dist/dsl/serializer.d.ts

@@ -0,0 +1,3 @@
+import { ChartNode } from './types';
+export declare function serialize(ast: ChartNode): string;
+export declare function compactSerialize(ast: ChartNode): string;

package/dist/dsl/types.d.ts

@@ -0,0 +1,88 @@
+import { DslNodeType, AnnotationKind, AnnotationAction } from '../enums';
+export interface PropertyNode {
+    type: DslNodeType.Property;
+    key: string;
+    value: string | number;
+    isPercentage: boolean;
+    values?: (string | number)[];
+}
+export interface DataNode {
+    type: DslNodeType.Data;
+    entries: PropertyNode[];
+}
+export interface ColorizeNode {
+    type: DslNodeType.Colorize;
+    target: string;
+    properties: PropertyNode[];
+}
+export interface HighlightNode {
+    type: DslNodeType.Highlight;
+    target: string;
+}
+export interface AreaFillNode {
+    type: DslNodeType.AreaFill;
+    from: string;
+    to: string;
+    properties: PropertyNode[];
+}
+export interface PointAnnotationNode {
+    type: DslNodeType.Annotation;
+    kind: AnnotationKind.Point;
+    target: string;
+    properties: PropertyNode[];
+}
+export interface RangeAnnotationNode {
+    type: DslNodeType.Annotation;
+    kind: AnnotationKind.Range;
+    properties: PropertyNode[];
+}
+export interface FreeAnnotationNode {
+    type: DslNodeType.Annotation;
+    kind: AnnotationKind.Free;
+    properties: PropertyNode[];
+}
+export type AnnotationNode = PointAnnotationNode | RangeAnnotationNode | FreeAnnotationNode;
+export interface SeriesNode {
+    type: DslNodeType.Series;
+    name: string;
+    properties: PropertyNode[];
+}
+export interface AnnotationVisibilityNode {
+    type: DslNodeType.AnnotationVisibility;
+    action: AnnotationAction;
+    kind: AnnotationKind;
+    id: string;
+}
+export interface SceneNode {
+    type: DslNodeType.Scene;
+    name: string | null;
+    properties: PropertyNode[];
+    data: DataNode | null;
+    colorizes: ColorizeNode[];
+    highlights: HighlightNode[];
+    areaFills: AreaFillNode[];
+    annotations: AnnotationNode[];
+    annotationVisibility: AnnotationVisibilityNode[];
+    series: SeriesNode[];
+    transforms: TransformNode[];
+}
+/** @deprecated Use SceneNode instead */
+export type StepNode = SceneNode;
+export interface TransformNode {
+    type: DslNodeType.Transform;
+    transformType: string;
+    properties: PropertyNode[];
+}
+export interface ChartNode {
+    type: DslNodeType.Chart;
+    chartType: string;
+    properties: PropertyNode[];
+    data: DataNode | null;
+    colorizes: ColorizeNode[];
+    highlights: HighlightNode[];
+    areaFills: AreaFillNode[];
+    annotations: AnnotationNode[];
+    series: SeriesNode[];
+    scenes: SceneNode[];
+    transforms: TransformNode[];
+}

package/dist/enums.d.ts

@@ -0,0 +1,193 @@
+export declare enum ChartType {
+    BarVertical = "bar-vertical",
+    BarHorizontal = "bar-horizontal",
+    BarMulti = "bar-multi",
+    ColumnStacked = "column-stacked",
+    BarStacked = "bar-stacked",
+    BarSplit = "bar-split",
+    BarGrouped = "bar-grouped",
+    Line = "line",
+    LineMulti = "line-multi",
+    Area = "area",
+    AreaStacked = "area-stacked",
+    Donut = "donut",
+    Pie = "pie",
+    VerticalBar = "vertical-bar",
+    HorizontalBar = "horizontal-bar"
+}
+export declare enum AxisDirection {
+    Left = "left",
+    Right = "right"
+}
+export declare enum ScaleType {
+    Linear = "linear",
+    Log = "log"
+}
+export declare enum GridStyle {
+    Solid = "solid",
+    Dashed = "dashed",
+    Dotted = "dotted",
+    None = "none"
+}
+export declare enum LabelPosition {
+    Auto = "auto",
+    Inside = "inside",
+    Outside = "outside",
+    Off = "off"
+}
+export declare enum LabelRotation {
+    Auto = "auto",
+    Horizontal = "horizontal",
+    Vertical = "vertical"
+}
+export declare enum TickPosition {
+    Above = "above",
+    Below = "below"
+}
+export declare enum FrameSizing {
+    Auto = "auto",
+    Standard = "standard",
+    AspectRatio = "aspect-ratio"
+}
+export declare enum CompassDirection {
+    NW = "NW",
+    N = "N",
+    NE = "NE",
+    E = "E",
+    SE = "SE",
+    S = "S",
+    SW = "SW",
+    W = "W",
+    Center = "center"
+}
+export declare enum AnnotationLineStyle {
+    Direct = "direct",
+    CurveLeft = "curve-left",
+    CurveRight = "curve-right",
+    Elbow = "elbow"
+}
+export declare enum StrokeStyle {
+    Solid = "solid",
+    Dotted = "dotted",
+    Dashed = "dashed"
+}
+export declare enum AnnotationKind {
+    Point = "point",
+    Range = "range",
+    Free = "free"
+}
+export declare enum AnnotationAction {
+    Hide = "hide",
+    Show = "show"
+}
+export declare enum RangeAnchor {
+    Start = "start",
+    Center = "center",
+    End = "end"
+}
+export declare enum Orientation {
+    Vertical = "vertical",
+    Horizontal = "horizontal"
+}
+export declare enum SymbolShape {
+    Circle = "circle",
+    Square = "square",
+    Diamond = "diamond",
+    Triangle = "triangle",
+    TriangleDown = "triangleDown",
+    Cross = "cross",
+    Star = "star"
+}
+export declare enum SymbolShowOn {
+    All = "all",
+    First = "first",
+    Last = "last",
+    FirstLast = "firstLast"
+}
+export declare enum SymbolStyle {
+    Filled = "filled",
+    Hollow = "hollow"
+}
+export declare enum SortDirection {
+    Ascending = "ascending",
+    Descending = "descending",
+    None = "none"
+}
+export declare enum SortMode {
+    Total = "total",
+    WithinGroups = "within-groups",
+    None = "none"
+}
+export declare enum LegendPosition {
+    Top = "top",
+    Bottom = "bottom",
+    Left = "left",
+    Right = "right"
+}
+export declare enum Anchor {
+    Start = "start",
+    Middle = "middle",
+    End = "end"
+}
+export declare enum ValueLabelPosition {
+    Inside = "inside",
+    Outside = "outside",
+    Auto = "auto"
+}
+export declare enum CrosshairDirection {
+    Both = "both",
+    Vertical = "vertical",
+    Horizontal = "horizontal"
+}
+export declare enum CrosshairStyle {
+    Solid = "solid",
+    Dashed = "dashed",
+    Dotted = "dotted"
+}
+export declare enum StackMode {
+    Normal = "normal",
+    Percent = "percent"
+}
+export declare enum LineStyle {
+    Solid = "solid",
+    Dashed = "dashed",
+    Dotted = "dotted",
+    None = "none"
+}
+export declare enum ChartOptionType {
+    Colors = "colors",
+    Boolean = "boolean",
+    Select = "select",
+    Text = "text",
+    NumberFormat = "numberFormat",
+    DateFormat = "dateFormat"
+}
+export declare enum DirectLabelMode {
+    Off = "",
+    Auto = "auto",
+    Outside = "outside",
+    Inside = "inside"
+}
+export declare enum Interpolation {
+    Linear = "linear",
+    MonotoneX = "monotoneX",
+    Step = "step",
+    StepBefore = "stepBefore",
+    StepAfter = "stepAfter",
+    Basis = "basis",
+    Cardinal = "cardinal",
+    CatmullRom = "catmullRom"
+}
+export declare enum DslNodeType {
+    Property = "property",
+    Data = "data",
+    Colorize = "colorize",
+    Highlight = "highlight",
+    AreaFill = "areafill",
+    Annotation = "annotation",
+    Series = "series",
+    AnnotationVisibility = "annotation-visibility",
+    Scene = "scene",
+    Transform = "transform",
+    Chart = "chart"
+}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export { ChartType, AxisDirection, ScaleType, GridStyle, LabelPosition, LabelRotation, TickPosition, FrameSizing, CompassDirection, AnnotationLineStyle, StrokeStyle, AnnotationKind, AnnotationAction, RangeAnchor, Orientation, SymbolShape, SymbolShowOn, SymbolStyle, SortDirection, SortMode, LegendPosition, Anchor, ValueLabelPosition, CrosshairDirection, CrosshairStyle, StackMode, LineStyle, ChartOptionType, DirectLabelMode, Interpolation, DslNodeType, } 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';
+export type { FrameElements } from './charts/frame/frame';
+export { createCanvas } from './charts/canvas/canvas';
+export type { CanvasElements } from './charts/canvas/canvas';
+export { renderVerticalAxis } from './charts/axis/vertical-axis';
+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 { 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 { resolveSeriesColor, resolveSeriesInterpolation, isSeriesHidden } from './charts/series-helpers';
+export { resolveBackgroundColor, adjustColorsForBackground, wcagContrastRatio, wcagLevel } from './charts/contrast';
+export { getTransitionDuration, snapshotForFadeOut, commitFadeOut, fadeIn } from './charts/motion';
+export { getCachedChart } from './charts/transition-cache';
+export { getCvdFilterId, createCvdSvgFilter, simulateCvdColor, checkCvdColors } from './charts/colorblind';
+export type { CvdType, CvdIssue } from './charts/colorblind';
+export { parse } from './dsl/parser';
+export { serialize, compactSerialize } from './dsl/serializer';
+export { propertyMap, extractChartTypeOptions, dataEntriesToString, extractSceneOverrides, convertColorizes, convertHighlights, convertAreaFills, convertAnnotations, convertSeriesOverrides } from './dsl/converter';
+export type { AnnotationNode, AnnotationVisibilityNode, PointAnnotationNode, RangeAnnotationNode, FreeAnnotationNode, AreaFillNode, ChartNode, DataNode, ColorizeNode, HighlightNode, PropertyNode, SceneNode, SeriesNode, StepNode, TransformNode } from './dsl/types';
+export { samples } from './samples';
+export type { ChartSample } from './samples';