@carbon/charts 0.30.5 → 0.30.9

package/build/demo/data/time-series-axis.d.ts

@@ -11,12 +11,9 @@ export declare const lineTimeSeriesData15seconds: {
 export declare const lineTimeSeries15secondsOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
 };
@@ -33,12 +30,9 @@ export declare const lineTimeSeriesDataMinute: {
 export declare const lineTimeSeriesMinuteOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
 };
@@ -55,12 +49,9 @@ export declare const lineTimeSeriesData30minutes: {
 export declare const lineTimeSeries30minutesOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
 };
@@ -77,12 +68,9 @@ export declare const lineTimeSeriesDataHourlyDefaultTicksFormats: {
 export declare const lineTimeSeriesHourlyDefaultLocaleOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
 };
@@ -99,12 +87,9 @@ export declare const lineTimeSeriesDataHourlyCustomTicksFormats: {
 export declare const lineTimeSeriesHourlyCustomTicksFormatsOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
     timeScale: {
@@ -129,12 +114,9 @@ export declare const lineTimeSeriesDataDaily: {
 export declare const lineTimeSeriesDailyOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
 };
@@ -151,12 +133,9 @@ export declare const lineTimeSeriesDataWeekly: {
 export declare const lineTimeSeriesWeeklyOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
     timeScale: {
@@ -176,12 +155,9 @@ export declare const lineTimeSeriesDataMonthlyDefaultLocale: {
 export declare const lineTimeSeriesMonthlyDefaultLocaleOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
 };
@@ -198,12 +174,9 @@ export declare const lineTimeSeriesDataMonthlyCustomLocale: {
 export declare const lineTimeSeriesMonthlyCustomLocaleOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
     timeScale: {
@@ -223,12 +196,9 @@ export declare const lineTimeSeriesDataQuarterly: {
 export declare const lineTimeSeriesQuarterlyOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
 };
@@ -245,12 +215,9 @@ export declare const lineTimeSeriesDataYearly: {
 export declare const lineTimeSeriesYearlyOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
 };
@@ -267,12 +234,9 @@ export declare const lineTimeSeriesDataSingleDatum: {
 export declare const lineTimeSeriesSingleDatumOptions: {
     title: string;
     axes: {
-        left: {
-            secondary: boolean;
-        };
+        left: {};
         bottom: {
             scaleType: string;
-            primary: boolean;
         };
     };
 };

package/build/src/charts/bar-grouped.d.ts

@@ -1,6 +1,6 @@
 import { AxisChart } from "../axis-chart";
-import { ChartConfig, ScatterChartOptions } from "../interfaces/index";
+import { BarChartOptions, ChartConfig } from "../interfaces/index";
 export declare class GroupedBarChart extends AxisChart {
-    constructor(holder: Element, chartConfigs: ChartConfig<ScatterChartOptions>);
+    constructor(holder: Element, chartConfigs: ChartConfig<BarChartOptions>);
     getComponents(): any[];
 }

package/build/src/charts/bar-simple.d.ts

@@ -1,8 +1,6 @@
 import { AxisChart } from "../axis-chart";
-import { ChartConfig, ScatterChartOptions } from "../interfaces/index";
-import { SimpleBarChartModel } from "../model-simple-bar";
+import { BarChartOptions, ChartConfig } from "../interfaces/index";
 export declare class SimpleBarChart extends AxisChart {
-    model: SimpleBarChartModel;
-    constructor(holder: Element, chartConfigs: ChartConfig<ScatterChartOptions>);
+    constructor(holder: Element, chartConfigs: ChartConfig<BarChartOptions>);
     getComponents(): any[];
 }

package/build/src/components/essentials/legend.d.ts

@@ -3,9 +3,5 @@ export declare class Legend extends Component {
     type: string;
     render(): void;
     breakItemsIntoLines(addedLegendItems: any): void;
-    getLegendItemArray(): {
-        key: string;
-        value: any;
-    }[];
     addEventListeners(): void;
 }

package/build/src/components/essentials/tooltip-bar.d.ts

@@ -7,7 +7,7 @@ export declare class TooltipBar extends Tooltip {
      * positive valued data and below negative value data.
      * @param hoveredElement
      */
-    getTooltipPosition(hoveredElement: any): {
+    getTooltipPosition(hoveredElement: any, data?: any): {
         placement: TooltipPosition;
         position: {
             left: number;

package/build/src/components/essentials/tooltip-pie.d.ts

@@ -0,0 +1,5 @@
+import { Tooltip } from "./tooltip";
+import { TooltipTypes } from "../../interfaces";
+export declare class TooltipPie extends Tooltip {
+    getTooltipHTML(d: any, type: TooltipTypes): string;
+}

package/build/src/components/essentials/tooltip-scatter.d.ts

@@ -1,5 +1,5 @@
 import { Tooltip } from "./tooltip";
 import { TooltipTypes } from "./../../interfaces";
 export declare class TooltipScatter extends Tooltip {
-    getTooltipHTML(data: any, type: TooltipTypes): string;
+    getTooltipHTML(datum: any, type: TooltipTypes): string;
 }

package/build/src/components/graphs/bar-grouped.d.ts

@@ -3,12 +3,14 @@ import { ScaleBand } from "d3-scale";
 export declare class GroupedBar extends Bar {
     type: string;
     groupScale: ScaleBand<any>;
+    padding: number;
     init(): void;
-    getGroupWidth(): number;
-    setGroupScale(): void;
-    getBarWidth(): number;
+    protected getDataCorrespondingToLabel(label: string): any;
+    protected getGroupWidth(): number;
+    protected getTotalGroupPadding(): number;
+    protected getBarWidth(): any;
+    protected setGroupScale(): void;
     render(animate: boolean): void;
-    addLabelsToDataPoints(d: any, index: any): any;
     handleLegendOnHover: (event: CustomEvent<any>) => void;
     handleLegendMouseOut: (event: CustomEvent<any>) => void;
     addEventListeners(): void;

package/build/src/components/graphs/bar-simple.d.ts

@@ -5,7 +5,6 @@ export declare class SimpleBar extends Bar {
     render(animate: boolean): void;
     handleLegendOnHover: (event: CustomEvent<any>) => void;
     handleLegendMouseOut: (event: CustomEvent<any>) => void;
-    addLabelsToDataPoints(d: any, index: any): any;
     addEventListeners(): void;
     destroy(): void;
 }

package/build/src/components/graphs/bar-stacked.d.ts

@@ -2,7 +2,6 @@ import { Bar } from "./bar";
 export declare class StackedBar extends Bar {
     type: string;
     init(): void;
-    getStackData(): any;
     render(animate: boolean): void;
     handleLegendOnHover: (event: CustomEvent<any>) => void;
     handleLegendMouseOut: (event: CustomEvent<any>) => void;

package/build/src/components/graphs/bubble.d.ts

@@ -4,5 +4,4 @@ export declare class Bubble extends Scatter {
     type: string;
     getRadiusScale(selection: Selection<any, any, any, any>): import("d3-scale").ScaleLinear<number, number>;
     styleCircles(selection: Selection<any, any, any, any>, animate: boolean): void;
-    addLabelsToDataPoints(d: any, index: any): any;
 }

package/build/src/components/graphs/line.d.ts

@@ -1,7 +1,9 @@
 import { Component } from "../component";
 export declare class Line extends Component {
     type: string;
-    lineGenerator: any;
     init(): void;
     render(animate?: boolean): void;
+    handleLegendOnHover: (event: CustomEvent<any>) => void;
+    handleLegendMouseOut: (event: CustomEvent<any>) => void;
+    destroy(): void;
 }

package/build/src/components/graphs/pie.d.ts

@@ -4,7 +4,6 @@ export declare class Pie extends Component {
     arc: any;
     hoverArc: any;
     init(): void;
-    getDataList(): any;
     getInnerRadius(): any;
     render(animate?: boolean): void;
     renderCallouts(calloutData: any[]): void;

package/build/src/components/graphs/scatter.d.ts

@@ -7,7 +7,6 @@ export declare class Scatter extends Component {
     styleCircles(selection: Selection<any, any, any, any>, animate: boolean): void;
     handleLegendOnHover: (event: CustomEvent<any>) => void;
     handleLegendMouseOut: (event: CustomEvent<any>) => void;
-    addLabelsToDataPoints(d: any, index: any): any;
     addEventListeners(): void;
     destroy(): void;
 }

package/build/src/components/index.d.ts

@@ -3,6 +3,7 @@ export * from "./essentials/legend";
 export * from "./essentials/title";
 export * from "./essentials/tooltip";
 export * from "./essentials/tooltip-bar";
+export * from "./essentials/tooltip-pie";
 export * from "./essentials/tooltip-scatter";
 export * from "./graphs/bar-simple";
 export * from "./graphs/bar-grouped";

package/build/src/interfaces/axis-scales.d.ts

@@ -9,20 +9,6 @@ export interface AxisOptions {
      * type of the scale used on axis
      */
     scaleType?: ScaleTypes;
-    /**
-     * Whether the Axis should be used as the domain
-     * axis of the chart. In the case of Cartesian Scales
-     * you would expect to only have 1 axis (dimension) being used as domain
-     * Domain usually represents labels, ordinal values, time intervals etc.
-     */
-    useAsGraphDomain?: boolean;
-    /**
-     * Whether the Axis should be used as the range
-     * axis of the chart. In the case of Cartesian Scales
-     * you would expect to only have 1 axis (dimension) being used as range
-     * Range usually follows a linear scale
-     */
-    useAsGraphRange?: boolean;
     /**
      * Whether the Axis should use the specified domain
      * instead of it being dynamically generated based on data extents.
@@ -31,14 +17,16 @@ export interface AxisOptions {
      * Example for discrete axis scale: ['Qty', 'More', 'Sold']
      */
     domain?: AxisDomain[];
-    primary?: boolean;
-    secondary?: boolean;
     /**
     * Whether the Axis should be forced to include 0 as a starting point
     * (or ending point, in case of all negative axis).
     * Default: true
     */
     includeZero?: boolean;
+    /**
+     * identifies what key within the data the axis values would map to
+     */
+    mapsTo?: string;
     /**
      * optional title for the scales
      */

package/build/src/interfaces/charts.d.ts

@@ -47,7 +47,25 @@ export interface BaseChartOptions {
         /**
          * optional prefixing string for css classes (defaults to 'cc')
          */
-        prefix?: String;
+        prefix?: string;
+    };
+    /**
+     * options related to charting data
+     */
+    data?: {
+        /**
+         * identifier for data groups
+         */
+        groupMapsTo?: string;
+    };
+    /**
+     * options related to color scales
+     */
+    color?: {
+        /**
+         * e.g. { "Dataset 1": "blue" }
+         */
+        scale?: object;
     };
 }
 /**
@@ -94,6 +112,10 @@ export interface BubbleChartOptions extends AxisChartOptions {
      * options for the individual bubbles
      */
     bubble?: {
+        /**
+         * the key to lookup in charting data for the bubble radius value
+         */
+        radiusMapsTo?: string;
         /**
          * A function that would determine the range of the bubble radius to use
          * Returns an array with the 1st value being the min and the 2nd value being the max radius

package/build/src/interfaces/enums.d.ts

@@ -28,10 +28,6 @@ export declare enum CartesianOrientations {
     VERTICAL = "vertical",
     HORIZONTAL = "horizontal"
 }
-export declare enum AxisTypes {
-    PRIMARY = "primary",
-    SECONDARY = "secondary"
-}
 /**
  * enum of all possible scale types
  */

package/build/src/interfaces/events.d.ts

@@ -1,3 +1,16 @@
+/**
+ * enum of all events related to the chart on the DOM
+ */
+export declare enum Chart {
+    RENDER_FINISHED = "render-finished",
+    RESIZE = "chart-resize"
+}
+/**
+ * enum of all events related to the chart model
+ */
+export declare enum Model {
+    UPDATE = "model-update"
+}
 /**
  * enum of all axis-related events
  */
@@ -43,6 +56,13 @@ export declare enum Line {
     POINT_CLICK = "scatter-click",
     POINT_MOUSEOUT = "scatter-mouseout"
 }
+/**
+ * enum of all tooltip events
+ */
+export declare enum Tooltip {
+    SHOW = "show-tooltip",
+    HIDE = "hide-tooltip"
+}
 /**
  * enum of all legend related events
  */

package/build/src/model-pie.d.ts

@@ -3,11 +3,5 @@ import { ChartModel } from "./model";
  * as well as some misc. information to be shared among components */
 export declare class PieChartModel extends ChartModel {
     constructor(services: any);
-    sanitize(data: any): any;
-    generateDataLabels(newData: any): {};
-    getDisplayData(): any;
-    toggleDataLabel(changedLabel: string): void;
-    setColorScale(): void;
-    getFillColor(label: string): any;
-    getStrokeColor(label: string): any;
+    sanitize(data: any): any[];
 }

package/build/src/model.d.ts

@@ -9,22 +9,41 @@ export declare class ChartModel {
     protected services: any;
     protected state: any;
     /**
-     * A list of all the labels that have existed within the lifetime of the chart
+     * A list of all the data groups that have existed within the lifetime of the chart
      * @type string[]
      */
-    protected allDataLabels: string[];
-    protected patternScale: {};
+    protected allDataGroups: string[];
     protected colorScale: any;
     constructor(services: any);
-    sanitize(data: any): any;
+    /**
+     * Converts data provided in the older format to tabular
+     *
+     */
+    protected transformToTabularData(data: any): any[];
+    protected getTabularData(data: any): any[];
+    protected sanitize(data: any): any[];
     getDisplayData(): any;
     getData(): any;
     /**
      *
      * @param newData The new raw data to be set
      */
-    setData(newData: any): any;
-    generateDataLabels(newData: any): {};
+    setData(newData: any): any[];
+    protected updateAllDataGroups(): void;
+    protected generateDataGroups(data: any): {
+        name: string;
+        status: Number;
+    }[];
+    getDataGroups(): any;
+    getActiveDataGroups(): any;
+    getDataGroupNames(): any;
+    getActiveDataGroupNames(): any;
+    getGroupedData(): {
+        name: string;
+        data: any;
+    }[];
+    getDataValuesGroupedByKeys(): any;
+    getStackedData(): any[][];
     /**
      * @return {Object} The chart's options
      */
@@ -44,17 +63,16 @@ export declare class ChartModel {
     update(): void;
     setUpdateCallback(cb: Function): void;
     toggleDataLabel(changedLabel: string): void;
-    setColorScale(): void;
+    protected setColorScale(): void;
     /**
      * Should the data point be filled?
-     * @param datasetLabel
-     * @param label
+     * @param group
+     * @param key
      * @param value
      * @param defaultFilled the default for this chart
      */
-    getIsFilled(datasetLabel: any, label?: any, data?: any, defaultFilled?: boolean): any;
-    getFillColor(datasetLabel: any, label?: any, data?: any): any;
-    getStrokeColor(datasetLabel: any, label?: any, data?: any): any;
+    getIsFilled(group: any, key?: any, data?: any, defaultFilled?: boolean): any;
+    getFillColor(group: any, key?: any, data?: any): any;
+    getStrokeColor(group: any, key?: any, data?: any): any;
     getFillScale(): any;
-    protected updateAllDataLabels(): void;
 }

package/build/src/services/scales-cartesian.d.ts

@@ -18,8 +18,14 @@ export declare class CartesianScales extends Service {
     protected orientation: CartesianOrientations;
     getDomainAxisPosition(): AxisPositions;
     getRangeAxisPosition(): AxisPositions;
-    setDefaultAxes(): void;
     update(animate?: boolean): void;
+    protected findMainVerticalAxisPosition(): AxisPositions.LEFT | AxisPositions.RIGHT;
+    protected findMainHorizontalAxisPosition(): AxisPositions.TOP | AxisPositions.BOTTOM;
+    protected findDomainAndRangeAxesPositions(mainVerticalAxisPosition: AxisPositions, mainHorizontalAxisPosition: AxisPositions): {
+        domainAxisPosition: any;
+        rangeAxisPosition: any;
+    };
+    findDomainAndRangeAxes(): void;
     determineOrientation(): void;
     getOrientation(): CartesianOrientations;
     getScaleByPosition(axisPosition: AxisPositions): any;
@@ -33,8 +39,10 @@ export declare class CartesianScales extends Service {
     getValueFromScale(axisPosition: AxisPositions, datum: any, index?: number): any;
     getDomainValue(d: any, i: any): any;
     getRangeValue(d: any, i: any): any;
-    /** Uses the primary Y Axis to get data items associated with that value.  */
-    getDataFromDomain(domainValue: any): any[];
+    getDomainIdentifier(): any;
+    getRangeIdentifier(): any;
+    /** Uses the primary Y Axis to get data items associated with that value. */
+    getDataFromDomain(domainValue: any): any;
     protected getScaleDomain(axisPosition: AxisPositions): any;
     protected createScale(axisPosition: AxisPositions): any;
 }

package/build/src/tools.d.ts

@@ -1,4 +1,4 @@
-import { CartesianOrientations, AxisChartOptions } from "./interfaces";
+import { CartesianOrientations } from "./interfaces";
 export declare namespace Tools {
     export const debounce: any;
     export const clone: any;
@@ -15,7 +15,7 @@ export declare namespace Tools {
      * @param {AxisChartOptions} providedOptions user provided options
      * @returns merged options
      */
-    export function mergeDefaultChartOptions(defaultOptions: AxisChartOptions, providedOptions: AxisChartOptions): any;
+    export function mergeDefaultChartOptions(defaultOptions: any, providedOptions: any): any;
     /**************************************
      *  DOM-related operations            *
      *************************************/

package/build/stories/tutorials.stories.d.ts

@@ -0,0 +1 @@
+import "../demo/styles.scss";