@mathstack/viz 0.0.1-beta.0

package/lib/axes/y/y-axis.d.ts

@@ -0,0 +1,53 @@
+import { AbstractConstructor } from '../../core/common-behaviors/constructor';
+import { ContinuousValue, DataValue } from '../../core/types/values';
+import { XyAxis } from '../base/xy-axis-base';
+import { Ticks } from '../ticks/ticks';
+import { YAxisConfig } from './y-axis-config';
+/**
+ * A mixin that extends `XyAxis` with the functionality needed for a y-axis.
+ *
+ * For internal library use only.
+ */
+export declare function yAxisMixin<Tick extends DataValue | ContinuousValue, TicksConfig extends Ticks<Tick>, T extends AbstractConstructor<XyAxis<Tick, TicksConfig>>>(Base: T): (abstract new (...args: any[]) => {
+    config: YAxisConfig<Tick, TicksConfig>;
+    translate: string;
+    setAxisFunction(): void;
+    setTranslate(): void;
+    getTranslateDistance(): number;
+    getLeftTranslate(range: [number, number]): number;
+    getRightTranslate(range: [number, number]): number;
+    getBaselineTranslate(): string | null;
+    setScale(): void;
+    initNumTicks(): number;
+    createLabel(): void;
+    axis: any;
+    axisFunction: any;
+    axisGroup: import("d3-selection").Selection<SVGGElement, any, SVGGElement, any>;
+    gridGroup: import("d3-selection").Selection<SVGGElement, any, SVGGElement, any>;
+    scale: any;
+    elRef: import("@angular/core").ElementRef<SVGGElement>;
+    isFirstDraw: boolean;
+    setTicks(tickFormat: string | ((value: Tick) => string)): void;
+    readonly class: Record<"label" | "gridGroup" | "gridLine" | "axisGroup", string>;
+    initFromConfig(): void;
+    setAxisFromScaleAndConfig(): void;
+    setTickSize(): void;
+    drawMarks(): void;
+    drawAxis(): void;
+    processTicks(): void;
+    setTickFontSize(tickTextSelection: any): void;
+    wrapAxisTickText(tickTextSelection: any): void;
+    processDomain(): void;
+    processTickLabels(): void;
+    otherAxisHasPosAndNegValues(dimension: "x" | "y"): boolean;
+    drawGrid(): void;
+    getGridLineLength(): number;
+    getTransition(selection: any): any;
+    scales: import("@mathstack/viz").XyChartScales;
+    chart: import("@mathstack/viz").XyChartComponent;
+    destroyRef: import("@angular/core").DestroyRef;
+    ngOnInit(): void;
+    subscribeToScales(): void;
+    getTransitionDuration(): number;
+    ngOnChanges(changes: import("@angular/core").SimpleChanges): void;
+}) & T;

package/lib/axes/y-ordinal/y-ordinal-axis-builder.d.ts

@@ -0,0 +1,29 @@
+import { DataValue } from '../../core/types/values';
+import { XyAxisBaseBuilder } from '../base/config/xy-axis-builder';
+import { TicksBuilder } from '../ticks/ticks-builder';
+import { VicYOrdinalAxisConfig } from './y-ordinal-axis-config';
+import * as i0 from "@angular/core";
+export declare class VicYOrdinalAxisConfigBuilder<Tick extends DataValue> extends XyAxisBaseBuilder {
+    private _side;
+    private ticksBuilder;
+    constructor();
+    /**
+     * OPTIONAL. Specifies the location of the axis on the chart.
+     *
+     * @param value - The side of the chart where the axis will be placed.
+     *
+     * If not called, the default value is `left`.
+     */
+    side(value: 'left' | 'right'): this;
+    /**
+     * OPTIONAL. Specifies properties for axis ticks.
+     *
+     * @param ticks - A function that specifies properties for axis ticks.
+     */
+    ticks(ticks: (ticks: TicksBuilder<Tick>) => void): this;
+    ticks(ticks: null): this;
+    private getTicksBuilder;
+    getConfig(): VicYOrdinalAxisConfig<Tick>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VicYOrdinalAxisConfigBuilder<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<VicYOrdinalAxisConfigBuilder<any>>;
+}

package/lib/axes/y-ordinal/y-ordinal-axis-config.d.ts

@@ -0,0 +1,25 @@
+import { DataValue } from '../../core';
+import { AbstractConstructor } from '../../core/common-behaviors/constructor';
+import { XyAxisConfig } from '../base/config/xy-axis-config';
+import { VicOrdinalAxisOptions } from '../ordinal/ordinal-axis-config';
+import { Ticks } from '../ticks/ticks';
+import { YAxisOptions } from '../y/y-axis-config';
+type XyAxisConfigType<T extends DataValue> = AbstractConstructor<XyAxisConfig<T, Ticks<T>>>;
+declare const AbstractYOrdinalAxis: (abstract new (...args: any[]) => {
+    side: "left" | "right";
+    getNumTicksBySpacing(spacing: number, dimensions: {
+        height: number;
+        width: number;
+    }): number;
+    baseline: import("../baseline/axis-baseline").AxisBaseline;
+    grid: import("../grid/grid-config").Grid;
+    label: import("../label/axis-label").AxisLabel;
+    ticks: Ticks<DataValue>;
+    getValidatedNumTicks(numTicks: number): number;
+    readonly marksClass: string;
+    readonly mixBlendMode: string;
+}) & XyAxisConfigType<DataValue>;
+export declare class VicYOrdinalAxisConfig<Tick extends DataValue> extends AbstractYOrdinalAxis {
+    constructor(options: YAxisOptions & VicOrdinalAxisOptions<Tick>);
+}
+export {};

package/lib/axes/y-ordinal/y-ordinal-axis.component.d.ts

@@ -0,0 +1,89 @@
+import { DataValue } from '../../core/types/values';
+import { XyAxis } from '../base/xy-axis-base';
+import { Ticks } from '../ticks/ticks';
+import * as i0 from "@angular/core";
+declare const YOrdinalAxis: (abstract new (...args: any[]) => {
+    config: import("../y/y-axis-config").YAxisConfig<string | number | Date, Ticks<string | number | Date>>;
+    translate: string;
+    setAxisFunction(): void;
+    setTranslate(): void;
+    getTranslateDistance(): number;
+    getLeftTranslate(range: [number, number]): number;
+    getRightTranslate(range: [number, number]): number;
+    getBaselineTranslate(): string | null;
+    setScale(): void;
+    initNumTicks(): number;
+    createLabel(): void;
+    axis: any;
+    axisFunction: any;
+    axisGroup: import("d3-selection").Selection<SVGGElement, any, SVGGElement, any>;
+    gridGroup: import("d3-selection").Selection<SVGGElement, any, SVGGElement, any>;
+    scale: any;
+    elRef: import("@angular/core").ElementRef<SVGGElement>;
+    isFirstDraw: boolean;
+    setTicks(tickFormat: string | ((value: string | number | Date) => string)): void;
+    readonly class: Record<"label" | "gridGroup" | "gridLine" | "axisGroup", string>;
+    initFromConfig(): void;
+    setAxisFromScaleAndConfig(): void;
+    setTickSize(): void;
+    drawMarks(): void;
+    drawAxis(): void;
+    processTicks(): void;
+    setTickFontSize(tickTextSelection: any): void;
+    wrapAxisTickText(tickTextSelection: any): void;
+    processDomain(): void;
+    processTickLabels(): void;
+    otherAxisHasPosAndNegValues(dimension: "x" | "y"): boolean;
+    drawGrid(): void;
+    getGridLineLength(): number;
+    getTransition(selection: any): any;
+    scales: import("@mathstack/viz").XyChartScales;
+    chart: import("@mathstack/viz").XyChartComponent;
+    destroyRef: import("@angular/core").DestroyRef;
+    ngOnInit(): void;
+    subscribeToScales(): void;
+    getTransitionDuration(): number;
+    ngOnChanges(changes: import("@angular/core").SimpleChanges): void;
+}) & (abstract new (...args: any[]) => {
+    config: import("../ordinal/ordinal-axis-config").VicOrdinalAxisConfig<DataValue>;
+    setTicks(tickFormat: string | ((value: DataValue) => string)): void;
+    axis: any;
+    axisFunction: any;
+    axisGroup: import("d3-selection").Selection<SVGGElement, any, SVGGElement, any>;
+    gridGroup: import("d3-selection").Selection<SVGGElement, any, SVGGElement, any>;
+    scale: any;
+    elRef: import("@angular/core").ElementRef<SVGGElement>;
+    isFirstDraw: boolean;
+    setAxisFunction(): any;
+    setTranslate(): void;
+    setScale(): void;
+    createLabel(): void;
+    getBaselineTranslate(): string | null;
+    readonly class: Record<"label" | "gridGroup" | "gridLine" | "axisGroup", string>;
+    initFromConfig(): void;
+    setAxisFromScaleAndConfig(): void;
+    setTickSize(): void;
+    drawMarks(): void;
+    drawAxis(): void;
+    processTicks(): void;
+    setTickFontSize(tickTextSelection: any): void;
+    wrapAxisTickText(tickTextSelection: any): void;
+    processDomain(): void;
+    processTickLabels(): void;
+    otherAxisHasPosAndNegValues(dimension: "x" | "y"): boolean;
+    drawGrid(): void;
+    getGridLineLength(): number;
+    getTransition(selection: any): any;
+    scales: import("@mathstack/viz").XyChartScales;
+    chart: import("@mathstack/viz").XyChartComponent;
+    destroyRef: import("@angular/core").DestroyRef;
+    ngOnInit(): void;
+    subscribeToScales(): void;
+    getTransitionDuration(): number;
+    ngOnChanges(changes: import("@angular/core").SimpleChanges): void;
+}) & (abstract new () => XyAxis<DataValue, Ticks<DataValue>>);
+export declare class YOrdinalAxisComponent extends YOrdinalAxis {
+    static ɵfac: i0.ɵɵFactoryDeclaration<YOrdinalAxisComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<YOrdinalAxisComponent, "[vic-y-ordinal-axis]", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
+}
+export {};

package/lib/axes/y-quantitative-axis/y-quantitative-axis-builder.d.ts

@@ -0,0 +1,29 @@
+import { ContinuousValue } from '../../core/types/values';
+import { XyAxisBaseBuilder } from '../base/config/xy-axis-builder';
+import { QuantitativeTicksBuilder } from '../ticks/ticks-builder';
+import { VicYQuantitativeAxisConfig } from './y-quantitative-axis-config';
+import * as i0 from "@angular/core";
+export declare class VicYQuantitativeAxisConfigBuilder<Tick extends ContinuousValue> extends XyAxisBaseBuilder {
+    private _side;
+    private ticksBuilder;
+    constructor();
+    /**
+     * OPTIONAL. Specifies the location of the axis on the chart.
+     *
+     * @param value - The side of the chart where the axis will be placed.
+     *
+     * If not called, the default value is `left`.
+     */
+    side(value: 'left' | 'right'): this;
+    /**
+     * OPTIONAL. Specifies properties for axis ticks.
+     *
+     * @param ticks - A function that specifies properties for axis ticks.
+     */
+    ticks(ticks: (ticks: QuantitativeTicksBuilder<Tick>) => void): this;
+    ticks(ticks: null): this;
+    private getTicksBuilder;
+    getConfig(): VicYQuantitativeAxisConfig<Tick>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VicYQuantitativeAxisConfigBuilder<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<VicYQuantitativeAxisConfigBuilder<any>>;
+}

package/lib/axes/y-quantitative-axis/y-quantitative-axis-config.d.ts

@@ -0,0 +1,25 @@
+import { AbstractConstructor } from '../../core/common-behaviors/constructor';
+import { ContinuousValue } from '../../core/types/values';
+import { XyAxisConfig } from '../base/config/xy-axis-config';
+import { VicQuantitativeAxisOptions } from '../quantitative/quantitative-axis-config';
+import { QuantitativeTicks } from '../ticks/ticks';
+import { YAxisOptions } from '../y/y-axis-config';
+type XyAxisConfigType<T extends ContinuousValue> = AbstractConstructor<XyAxisConfig<T, QuantitativeTicks<T>>>;
+declare const AbstractYQuantitative: (abstract new (...args: any[]) => {
+    side: "left" | "right";
+    getNumTicksBySpacing(spacing: number, dimensions: {
+        height: number;
+        width: number;
+    }): number;
+    baseline: import("../baseline/axis-baseline").AxisBaseline;
+    grid: import("../grid/grid-config").Grid;
+    label: import("../label/axis-label").AxisLabel;
+    ticks: QuantitativeTicks<ContinuousValue>;
+    getValidatedNumTicks(numTicks: number): number;
+    readonly marksClass: string;
+    readonly mixBlendMode: string;
+}) & XyAxisConfigType<ContinuousValue>;
+export declare class VicYQuantitativeAxisConfig<Tick extends ContinuousValue> extends AbstractYQuantitative {
+    constructor(options: YAxisOptions & VicQuantitativeAxisOptions<Tick>);
+}
+export {};

package/lib/axes/y-quantitative-axis/y-quantitative-axis.component.d.ts

@@ -0,0 +1,54 @@
+import { ContinuousValue } from '../../core';
+import { AbstractConstructor } from '../../core/common-behaviors/constructor';
+import { XyAxis } from '../base/xy-axis-base';
+import { QuantitativeTicks, Ticks } from '../ticks/ticks';
+import * as i0 from "@angular/core";
+type XyAxisType<T extends ContinuousValue> = AbstractConstructor<XyAxis<T, QuantitativeTicks<T>>>;
+declare const YQuantitativeAxis: (abstract new (...args: any[]) => {
+    config: import("../y/y-axis-config").YAxisConfig<ContinuousValue, Ticks<ContinuousValue>>;
+    translate: string;
+    setAxisFunction(): void;
+    setTranslate(): void;
+    getTranslateDistance(): number;
+    getLeftTranslate(range: [number, number]): number;
+    getRightTranslate(range: [number, number]): number;
+    getBaselineTranslate(): string | null;
+    setScale(): void;
+    initNumTicks(): number;
+    createLabel(): void;
+    axis: any;
+    axisFunction: any;
+    axisGroup: import("d3-selection").Selection<SVGGElement, any, SVGGElement, any>;
+    gridGroup: import("d3-selection").Selection<SVGGElement, any, SVGGElement, any>;
+    scale: any;
+    elRef: import("@angular/core").ElementRef<SVGGElement>;
+    isFirstDraw: boolean;
+    setTicks(tickFormat: string | ((value: ContinuousValue) => string)): void;
+    readonly class: Record<"label" | "gridGroup" | "gridLine" | "axisGroup", string>;
+    initFromConfig(): void;
+    setAxisFromScaleAndConfig(): void;
+    setTickSize(): void;
+    drawMarks(): void;
+    drawAxis(): void;
+    processTicks(): void;
+    setTickFontSize(tickTextSelection: any): void;
+    wrapAxisTickText(tickTextSelection: any): void;
+    processDomain(): void;
+    processTickLabels(): void;
+    otherAxisHasPosAndNegValues(dimension: "x" | "y"): boolean;
+    drawGrid(): void;
+    getGridLineLength(): number;
+    getTransition(selection: any): any;
+    scales: import("@mathstack/viz").XyChartScales;
+    chart: import("@mathstack/viz").XyChartComponent;
+    destroyRef: import("@angular/core").DestroyRef;
+    ngOnInit(): void;
+    subscribeToScales(): void;
+    getTransitionDuration(): number;
+    ngOnChanges(changes: import("@angular/core").SimpleChanges): void;
+}) & XyAxisType<ContinuousValue>;
+export declare class YQuantitativeAxisComponent extends YQuantitativeAxis {
+    static ɵfac: i0.ɵɵFactoryDeclaration<YQuantitativeAxisComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<YQuantitativeAxisComponent, "[vic-y-quantitative-axis]", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
+}
+export {};

package/lib/bars/bars.component.d.ts

@@ -0,0 +1,91 @@
+import { ElementRef, InjectionToken, NgZone } from '@angular/core';
+import { Selection } from 'd3-selection';
+import { BehaviorSubject } from 'rxjs';
+import { XyChartScales } from '../charts/xy-chart/xy-chart.component';
+import { GenericScale } from '../core';
+import { DataValue } from '../core/types/values';
+import { VicXyPrimaryMarks } from '../marks/xy-marks/xy-primary-marks/xy-primary-marks';
+import { BarsConfig } from './config/bars-config';
+import * as i0 from "@angular/core";
+export declare const BARS: InjectionToken<BarsComponent<unknown, DataValue>>;
+export type BarGroupSelection = Selection<SVGGElement, number, SVGSVGElement, unknown>;
+export type BarSelection = Selection<SVGRectElement, number, SVGGElement, number>;
+export type BarLabelSelection = Selection<SVGTextElement, number, SVGGElement, number>;
+export type BarDatum<T> = {
+    index: number;
+    quantitative: number;
+    ordinal: T;
+    color: string;
+};
+export interface BarsTooltipDatum<Datum> {
+    datum: Datum;
+    color: string;
+    values: {
+        x: string;
+        y: string;
+        category: string;
+    };
+}
+type BarsSvgElement = 'g' | 'bar' | 'label' | 'background';
+export declare class BarsComponent<Datum, TOrdinalValue extends DataValue> extends VicXyPrimaryMarks<Datum, BarsConfig<Datum, TOrdinalValue>> {
+    barGroups: BarGroupSelection;
+    bars: BehaviorSubject<BarSelection>;
+    bars$: import("rxjs").Observable<BarSelection>;
+    labels: BehaviorSubject<BarLabelSelection>;
+    labels$: import("rxjs").Observable<BarSelection>;
+    scales: {
+        color: GenericScale<any, any>;
+    } & XyChartScales;
+    protected zone: NgZone;
+    elRef: ElementRef<any>;
+    get class(): Record<BarsSvgElement, string>;
+    setChartScalesFromRanges(useTransition: boolean): void;
+    drawMarks(): void;
+    drawBars(transitionDuration: number): void;
+    drawBackgrounds(transitionDuration: number): void;
+    getBarGroupColorClass(i: number): string;
+    getBarDatumFromIndex(i: number): BarDatum<TOrdinalValue>;
+    getBarGroupTransform(datum: BarDatum<TOrdinalValue>): string;
+    getBarFill(datum: BarDatum<TOrdinalValue>): string;
+    drawLabels(transitionDuration: number): void;
+    getBarX(d: BarDatum<TOrdinalValue>): number;
+    getBarXOrdinal(d: BarDatum<TOrdinalValue>): number;
+    getBarXQuantitative(d: BarDatum<TOrdinalValue>): number;
+    getBarY(d: BarDatum<TOrdinalValue>): number;
+    getBarYOrdinal(d: BarDatum<TOrdinalValue>): number;
+    getBarYQuantitative(d: BarDatum<TOrdinalValue>): number;
+    getQuantitativeDomainFromScale(): number[];
+    getBarWidth(d: BarDatum<TOrdinalValue>): number;
+    getBarWidthOrdinal(): number;
+    getBarHeight(d: BarDatum<TOrdinalValue>): number;
+    getBarHeightOrdinal(): number;
+    getBackgroundTransform(d: BarDatum<TOrdinalValue>): string | null;
+    getBackgroundWidth(): number;
+    getBackgroundBarHeight(): number;
+    getBarDimensionQuantitative(d: BarDatum<TOrdinalValue>, dimension: 'x' | 'y'): number;
+    getBarQuantitativeOrigin(): number;
+    getBarPattern(d: BarDatum<TOrdinalValue>): string;
+    getBarColor(d: BarDatum<TOrdinalValue>): string;
+    getLabelText(d: BarDatum<TOrdinalValue>): string;
+    getLabelTextAnchor(d: BarDatum<TOrdinalValue>, labelBbox: DOMRect): 'start' | 'middle' | 'end';
+    getLabelDominantBaseline(d: BarDatum<TOrdinalValue>, labelBbox: DOMRect): 'text-after-edge' | 'text-before-edge' | 'central';
+    alignTextInPositiveDirection(d: BarDatum<TOrdinalValue>, labelBbox: DOMRect): boolean;
+    getLabelColor(d: BarDatum<TOrdinalValue>, labelBbox: DOMRect): string;
+    labelFitsOutsideBar(d: BarDatum<TOrdinalValue>, labelBbox: DOMRect): boolean;
+    getBarToChartEdgeDistance(isPositiveValue: boolean, range: [number, number], endOfBarPosition: number): number;
+    getLabelDomRect(d: BarDatum<TOrdinalValue>): DOMRect;
+    getLabelX(d: BarDatum<TOrdinalValue>, bbox: DOMRect): number;
+    getLabelY(d: BarDatum<TOrdinalValue>, bbox: DOMRect): number;
+    getLabelQuantitativeAxisPosition(d: BarDatum<TOrdinalValue>, bbox: DOMRect): number;
+    getLabelPositionForZeroOrNonnumericValue(): number;
+    getLabelPositionForNumericValue(d: BarDatum<TOrdinalValue>, bbox: DOMRect): number;
+    getLabelOrigin(d: BarDatum<TOrdinalValue>, isPositiveValue: boolean): number;
+    positionZeroOrNonNumericValueLabelInPositiveDirection(): boolean;
+    isZeroOrNonNumeric(value: unknown): boolean;
+    updateBarElements(): void;
+    getTooltipData(datum: Datum): BarsTooltipDatum<Datum>;
+    getSourceDatumFromBarDatum(barDatum: BarDatum<TOrdinalValue>): Datum;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BarsComponent<any, any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BarsComponent<any, any>, "[vic-primary-marks-bars]", never, {}, {}, never, never, true, never>;
+}
+export {};

package/lib/bars/bars.module.d.ts

@@ -0,0 +1,8 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./bars.component";
+import * as i2 from "./events/bars-events.directive";
+export declare class VicBarsModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<VicBarsModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<VicBarsModule, never, [typeof i1.BarsComponent, typeof i2.BarsEventsDirective], [typeof i1.BarsComponent, typeof i2.BarsEventsDirective]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<VicBarsModule>;
+}

package/lib/bars/config/backgrounds/bars-backgrounds-builder.d.ts

@@ -0,0 +1,27 @@
+import { BarsBackgrounds } from './bars-backgrounds';
+export declare class BarsBackgroundsBuilder {
+    private _color;
+    private _events;
+    constructor();
+    /**
+     * OPTIONAL. Determines the color of the background.
+     *
+     * @param value - The color of the background.
+     *
+     * If not called, the default color is 'whitesmoke'.
+     */
+    color(value: string): this;
+    /**
+     * Determines whether the background is interactive or not.
+     *
+     * @param value - If `true`, the background is interactive and will respond to Viz Components events. If `false`, the background is not interactive.
+     *
+     * If not called, the default value is `false`.
+     */
+    events(value: boolean): this;
+    /**
+     * @internal
+     * This function is for internal use only and should never be called by the user.
+     */
+    _build(): BarsBackgrounds;
+}

package/lib/bars/config/backgrounds/bars-backgrounds-options.d.ts

@@ -0,0 +1,4 @@
+export interface BarsBackgroundsOptions {
+    color: string;
+    events: boolean;
+}

package/lib/bars/config/backgrounds/bars-backgrounds.d.ts

@@ -0,0 +1,6 @@
+import { BarsBackgroundsOptions } from './bars-backgrounds-options';
+export declare class BarsBackgrounds {
+    readonly color: string;
+    readonly events: boolean;
+    constructor(options: BarsBackgroundsOptions);
+}

package/lib/bars/config/bars-builder.d.ts

@@ -0,0 +1,132 @@
+import { DataValue } from '../../core/types/values';
+import { FillDefinition } from '../../data-dimensions';
+import { NumberChartPositionDimensionBuilder } from '../../data-dimensions/continuous-quantitative/number-chart-position/number-chart-position-builder';
+import { OrdinalChartPositionDimensionBuilder } from '../../data-dimensions/ordinal/ordinal-chart-position/ordinal-chart-position-builder';
+import { OrdinalVisualValueDimensionBuilder } from '../../data-dimensions/ordinal/ordinal-visual-value/ordinal-visual-value-builder';
+import { PrimaryMarksBuilder } from '../../marks/primary-marks/config/primary-marks-builder';
+import { BarsBackgroundsBuilder } from './backgrounds/bars-backgrounds-builder';
+import { BarsConfig } from './bars-config';
+import { BarsDimensions } from './bars-dimensions';
+import { BarsLabelsBuilder } from './labels/bars-labels-builder';
+import * as i0 from "@angular/core";
+declare abstract class BaseDimensionsBuilder<Datum, TOrdinalValue extends DataValue> {
+    protected _ordinalDimensionBuilder: OrdinalChartPositionDimensionBuilder<Datum, TOrdinalValue>;
+    protected _quantitativeDimensionBuilder: NumberChartPositionDimensionBuilder<Datum>;
+    get ordinalDimensionBuilder(): OrdinalChartPositionDimensionBuilder<Datum, TOrdinalValue>;
+    get quantitativeDimensionBuilder(): NumberChartPositionDimensionBuilder<Datum>;
+    protected initOrdinalDimensionBuilder(): void;
+    protected initQuantitativeDimensionBuilder(): void;
+}
+export declare class HorizontalBarsDimensionsBuilder<Datum, TOrdinalValue extends DataValue> extends BaseDimensionsBuilder<Datum, TOrdinalValue> {
+    /**
+     * REQUIRED. Specifies how values derived from `Datum` (of type `number`) set the x domain of the chart, and how those values are displayed.
+     *
+     * @param x - A function that specifies how the quantitative values that are mapped to the x dimension will be used in the chart.
+     */
+    x(x: (x: NumberChartPositionDimensionBuilder<Datum>) => void): this;
+    /**
+     * REQUIRED. Specifies how values derived from `Datum` (may be type `string`, `number`, or `Date`, though typically `string`) set the y domain of the chart, and how those values are displayed.
+     *
+     * @param y - A function that specifies how ordinal/categorical values that are mapped to the y dimension will be used in the chart.
+     */
+    y(y: (y: OrdinalChartPositionDimensionBuilder<Datum, TOrdinalValue>) => void): this;
+}
+export declare class VerticalBarsDimensionsBuilder<Datum, TOrdinalValue extends DataValue> extends BaseDimensionsBuilder<Datum, TOrdinalValue> {
+    /**
+     * REQUIRED. Specifies how values derived from `Datum` (may be type `string`, `number`, or `Date`, though typically `string`) set the x domain of the chart, and how those values are displayed.
+     *
+     * @param x - A function that specifies how ordinal/categorical values that are mapped to the x dimension will be used in the chart.
+     */
+    x(x: (x: OrdinalChartPositionDimensionBuilder<Datum, TOrdinalValue>) => void): this;
+    /**
+     * REQUIRED. Specifies how values derived from `Datum` (of type `number`) set the y domain of the chart, and how those values are displayed.
+     *
+     * @param y - A function that specifies how the quantitative values that are mapped to the y dimension will be used in the chart.
+     */
+    y(y: (y: NumberChartPositionDimensionBuilder<Datum>) => void): this;
+}
+/**
+ * Builds a configuration object for a BarsComponent.
+ *
+ * Must be added to a providers array in or above the component that consumes it if it is injected via the constructor. (e.g. `providers: [VicBarsConfigBuilder]` in the component decorator)
+ *
+ * The first generic parameter, Datum, is the type of the data that will be used to create the bars.
+ *
+ * The second generic parameter, TOrdinalValue, is the type of the ordinal data that will be used to position the bars.
+ */
+export declare class VicBarsConfigBuilder<Datum, OrdinalDomain extends DataValue> extends PrimaryMarksBuilder<Datum> {
+    protected _customFills: FillDefinition<Datum>[];
+    protected dimensions: BarsDimensions;
+    protected _orientation: 'horizontal' | 'vertical';
+    protected backgroundsBuilder: BarsBackgroundsBuilder;
+    protected colorDimensionBuilder: OrdinalVisualValueDimensionBuilder<Datum, string, string>;
+    protected labelsBuilder: BarsLabelsBuilder<Datum>;
+    protected ordinalDimensionBuilder: OrdinalChartPositionDimensionBuilder<Datum, OrdinalDomain>;
+    protected quantitativeDimensionBuilder: NumberChartPositionDimensionBuilder<Datum>;
+    constructor();
+    /**
+     * OPTIONAL. Specifies properties of bars to be drawn behind the bars that represent data values. The background bars span the full width of the chart.
+     *
+     * @param backgrounds - A function that specifies the color of background bars and whether they respond to events, or `null` to unset the backgrounds function.
+     *
+     * If called with no arguments, the default background will be `whitesmoke` and events will be `false`.
+     *
+     * If not called, no background bars will be created.
+     */
+    backgrounds(backgrounds: (backgrounds: BarsBackgroundsBuilder) => void): this;
+    backgrounds(): this;
+    backgrounds(backgrounds: null): this;
+    /**
+     * OPTIONAL. Specifies how values derived from `Datum` (of type `string`) set the color of the bars, and how those values are displayed.
+     *
+     * @param color - A function that specifies how values derived from `Datum` will be used to set the color of the bars, or null to unset the color., or null to unset the color function.
+     *
+     * If not called, all bars will be colored with the first color in `d3.schemeTableau10`, the default `range` color scale.
+     */
+    color(color: (color: OrdinalVisualValueDimensionBuilder<Datum, string, string>) => void): this;
+    color(color: null): this;
+    private initColorDimensionBuilder;
+    /**
+     * OPTIONAL. Determines custom fills for specified bars. Intended to be used with a user-provided fill in <defs> (provided in html) whose `id` is referenced here. The `shouldApply` function is used to determine whether the fill should be applied to a given datum.
+     *
+     * @param values - An array of custom fills ({ defId: string; shouldApply: (d: Datum) => boolean;}[]), or `null` to unset the custom fills.
+     *
+     * This will override any fill set by the `color` dimension.
+     */
+    customFills(values: FillDefinition<Datum>[] | null): this;
+    /**
+     * REQUIRED FOR HORIZONTAL BAR CHART.
+     *
+     * @param bars - A function that specifies properties for the horizontal bars, or `null` to not set the horizontal orientation.
+     */
+    horizontal(bars: (bars: HorizontalBarsDimensionsBuilder<Datum, OrdinalDomain>) => void): this;
+    horizontal(bars: null): this;
+    /**
+     * OPTIONAL. Specifies properties of labels to be rendered at the end of bars, typically used to show bar values.
+     *
+     * @param labels - A function that specifies properties for the labels, or `null` to unset the labels.
+     *
+     * If not called, no labels will be created.
+     */
+    labels(labels: (labels: BarsLabelsBuilder<Datum>) => void): this;
+    labels(labels: null): this;
+    /**
+     * REQUIRED FOR VERTICAL BAR CHART.
+     *
+     * @param bars - A function that specifies properties for the vertical bars, or `null` to not set the vertical orientation.
+     */
+    vertical(bars: (bars: VerticalBarsDimensionsBuilder<Datum, OrdinalDomain>) => void): this;
+    vertical(bars: null): this;
+    /**
+     * REQUIRED. Validates and builds the configuration object for the bars that can be passed to BarsComponent.
+     *
+     * The user must call this at the end of the chain of methods to build the configuration object.
+     */
+    getConfig(): BarsConfig<Datum, OrdinalDomain>;
+    protected validateBuilder(componentName: string): void;
+    protected getOrdinalDimensionName(): string;
+    protected getQuantitativeDimensionName(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VicBarsConfigBuilder<any, any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<VicBarsConfigBuilder<any, any>>;
+}
+export {};

package/lib/bars/config/bars-config.d.ts

@@ -0,0 +1,27 @@
+import { DataValue } from '../../core/types/values';
+import { FillDefinition } from '../../data-dimensions';
+import { NumberChartPositionDimension } from '../../data-dimensions/continuous-quantitative/number-chart-position/number-chart-position';
+import { OrdinalChartPositionDimension } from '../../data-dimensions/ordinal/ordinal-chart-position/ordinal-chart-position';
+import { OrdinalVisualValueDimension } from '../../data-dimensions/ordinal/ordinal-visual-value/ordinal-visual-value';
+import { XyPrimaryMarksConfig } from '../../marks/xy-marks/xy-primary-marks/xy-primary-marks-config';
+import { BarsBackgrounds } from './backgrounds/bars-backgrounds';
+import { BarsDimensions } from './bars-dimensions';
+import { BarsOptions } from './bars-options';
+import { BarsLabels } from './labels/bars-labels';
+export declare class BarsConfig<Datum, OrdinalDomain extends DataValue> extends XyPrimaryMarksConfig<Datum> implements BarsOptions<Datum, OrdinalDomain> {
+    barsKeyFunction: (i: number) => string;
+    readonly backgrounds: BarsBackgrounds;
+    readonly color: OrdinalVisualValueDimension<Datum, string, string>;
+    readonly customFills: FillDefinition<Datum>[];
+    readonly dimensions: BarsDimensions;
+    hasNegativeValues: boolean;
+    readonly labels: BarsLabels<Datum>;
+    readonly ordinal: OrdinalChartPositionDimension<Datum, OrdinalDomain>;
+    readonly quantitative: NumberChartPositionDimension<Datum>;
+    constructor(dimensions: BarsDimensions, options: BarsOptions<Datum, OrdinalDomain>);
+    protected initPropertiesFromData(): void;
+    protected setDimensionPropertiesFromData(): void;
+    protected setValueIndices(): void;
+    protected setHasNegativeValues(): void;
+    protected setBarsKeyFunction(): void;
+}

package/lib/bars/config/bars-dimensions.d.ts

@@ -0,0 +1,11 @@
+export interface BarsDimensions {
+    x: 'ordinal' | 'quantitative';
+    y: 'ordinal' | 'quantitative';
+    ordinal: 'x' | 'y';
+    quantitative: 'x' | 'y';
+    quantitativeDimension: 'width' | 'height';
+    isHorizontal: boolean;
+    isVertical: boolean;
+}
+export declare const HORIZONTAL_BARS_DIMENSIONS: BarsDimensions;
+export declare const VERTICAL_BARS_DIMENSIONS: BarsDimensions;

package/lib/bars/config/bars-options.d.ts

@@ -0,0 +1,16 @@
+import { DataValue } from '../../core/types/values';
+import { FillDefinition } from '../../data-dimensions';
+import { NumberChartPositionDimension } from '../../data-dimensions/continuous-quantitative/number-chart-position/number-chart-position';
+import { OrdinalChartPositionDimension } from '../../data-dimensions/ordinal/ordinal-chart-position/ordinal-chart-position';
+import { OrdinalVisualValueDimension } from '../../data-dimensions/ordinal/ordinal-visual-value/ordinal-visual-value';
+import { DataMarksOptions } from '../../marks/config/marks-options';
+import { BarsBackgrounds } from './backgrounds/bars-backgrounds';
+import { BarsLabels } from './labels/bars-labels';
+export interface BarsOptions<Datum, OrdinalDomain extends DataValue> extends DataMarksOptions<Datum> {
+    backgrounds: BarsBackgrounds;
+    color: OrdinalVisualValueDimension<Datum, string, string>;
+    customFills: FillDefinition<Datum>[];
+    ordinal: OrdinalChartPositionDimension<Datum, OrdinalDomain>;
+    quantitative: NumberChartPositionDimension<Datum>;
+    labels: BarsLabels<Datum>;
+}