@carbon/charts 0.44.1 → 0.46.4

package/CHANGELOG.md

@@ -3,7 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [0.44.1](https://github.com/carbon-design-system/carbon-charts/compare/v0.44.0...v0.44.1) (2021-08-19)
+## [0.46.4](https://github.com/carbon-design-system/carbon-charts/compare/v0.46.3...v0.46.4) (2021-08-31)
+
+
+### Bug Fixes
+
+* **core:** display correct toolbar controls based on provided options ([#1127](https://github.com/carbon-design-system/carbon-charts/issues/1127)) ([77e0e43](https://github.com/carbon-design-system/carbon-charts/commit/77e0e431c3c5c57eec3e49757747c1a7835f93de)), closes [#1109](https://github.com/carbon-design-system/carbon-charts/issues/1109)
+
+
+
+
+
+## [0.46.3](https://github.com/carbon-design-system/carbon-charts/compare/v0.46.2...v0.46.3) (2021-08-31)
 
 **Note:** Version bump only for package @carbon/charts
 
@@ -11,29 +22,39 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 
 
-# [0.44.0](https://github.com/carbon-design-system/carbon-charts/compare/v0.43.0...v0.44.0) (2021-08-18)
+## [0.46.2](https://github.com/carbon-design-system/carbon-charts/compare/v0.46.1...v0.46.2) (2021-08-30)
 
+**Note:** Version bump only for package @carbon/charts
 
-### Features
 
-* **core:** support negative values in stacked bar ([#1121](https://github.com/carbon-design-system/carbon-charts/issues/1121)) ([b71cc79](https://github.com/carbon-design-system/carbon-charts/commit/b71cc79876fe56b49cbb08441f41e17ee37fbcff))
 
 
 
+## [0.46.1](https://github.com/carbon-design-system/carbon-charts/compare/v0.46.0...v0.46.1) (2021-08-27)
+
+**Note:** Version bump only for package @carbon/charts
+
+
 
 
-# [0.43.0](https://github.com/carbon-design-system/carbon-charts/compare/v0.42.1...v0.43.0) (2021-08-17)
+
+# [0.46.0](https://github.com/carbon-design-system/carbon-charts/compare/v0.45.1...v0.46.0) (2021-08-27)
 
 
 ### Features
 
-* **core:** remove backgrounds on chart holder & wrapper ([#1120](https://github.com/carbon-design-system/carbon-charts/issues/1120)) ([8044c99](https://github.com/carbon-design-system/carbon-charts/commit/8044c99cd4c307147a164d3e60bbb23d2a0a2dc4))
+* **charts:** add proportional meter chart ([#1040](https://github.com/carbon-design-system/carbon-charts/issues/1040)) ([10592e4](https://github.com/carbon-design-system/carbon-charts/commit/10592e40665d104117b8e2d2580e5edc407c3e8d))
 
 
 
 
 
-## [0.42.1](https://github.com/carbon-design-system/carbon-charts/compare/v0.42.0...v0.42.1) (2021-08-13)
+# Change Log
+
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [0.45.1](https://github.com/carbon-design-system/carbon-charts/compare/v0.45.0...v0.45.1) (2021-08-23)
 
 **Note:** Version bump only for package @carbon/charts
 
@@ -41,16 +62,51 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 
 
-# [0.42.0](https://github.com/carbon-design-system/carbon-charts/compare/v0.41.103...v0.42.0) (2021-08-13)
+# [0.45.0](https://github.com/carbon-design-system/carbon-charts/compare/v0.44.1...v0.45.0) (2021-08-19)
 
+### Features
+
+-   **core:** Add options to map value to other keys
+    ([#1122](https://github.com/carbon-design-system/carbon-charts/issues/1122))
+    ([1835192](https://github.com/carbon-design-system/carbon-charts/commit/18351924acc182c24a7467dfc989fdc1e5c759dc)),
+    closes
+    [#1110](https://github.com/carbon-design-system/carbon-charts/issues/1110)
+    [#1110](https://github.com/carbon-design-system/carbon-charts/issues/1110)
+    [#1110](https://github.com/carbon-design-system/carbon-charts/issues/1110)
+    [#1110](https://github.com/carbon-design-system/carbon-charts/issues/1110)
+    [#1110](https://github.com/carbon-design-system/carbon-charts/issues/1110)
+
+## [0.44.1](https://github.com/carbon-design-system/carbon-charts/compare/v0.44.0...v0.44.1) (2021-08-19)
+
+**Note:** Version bump only for package @carbon/charts
+
+# [0.44.0](https://github.com/carbon-design-system/carbon-charts/compare/v0.43.0...v0.44.0) (2021-08-18)
+
+### Features
+
+-   **core:** support negative values in stacked bar
+    ([#1121](https://github.com/carbon-design-system/carbon-charts/issues/1121))
+    ([b71cc79](https://github.com/carbon-design-system/carbon-charts/commit/b71cc79876fe56b49cbb08441f41e17ee37fbcff))
+
+# [0.43.0](https://github.com/carbon-design-system/carbon-charts/compare/v0.42.1...v0.43.0) (2021-08-17)
 
 ### Features
 
-* **charts:** add histogram ([#1038](https://github.com/carbon-design-system/carbon-charts/issues/1038)) ([07e07b3](https://github.com/carbon-design-system/carbon-charts/commit/07e07b3a2e8bc0eb01a7f4fdfc004e8095fb7b26))
+-   **core:** remove backgrounds on chart holder & wrapper
+    ([#1120](https://github.com/carbon-design-system/carbon-charts/issues/1120))
+    ([8044c99](https://github.com/carbon-design-system/carbon-charts/commit/8044c99cd4c307147a164d3e60bbb23d2a0a2dc4))
 
+## [0.42.1](https://github.com/carbon-design-system/carbon-charts/compare/v0.42.0...v0.42.1) (2021-08-13)
 
+**Note:** Version bump only for package @carbon/charts
 
+# [0.42.0](https://github.com/carbon-design-system/carbon-charts/compare/v0.41.103...v0.42.0) (2021-08-13)
 
+### Features
+
+-   **charts:** add histogram
+    ([#1038](https://github.com/carbon-design-system/carbon-charts/issues/1038))
+    ([07e07b3](https://github.com/carbon-design-system/carbon-charts/commit/07e07b3a2e8bc0eb01a7f4fdfc004e8095fb7b26))
 
 # Change Log
 
@@ -256,15 +312,6 @@ All notable changes to this project will be documented in this file. See
 
 **Note:** Version bump only for package @carbon/charts
 
-# Change Log
-
-All notable changes to this project will be documented in this file. See
-[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-## [0.41.68](https://github.com/carbon-design-system/carbon-charts/compare/v0.41.67...v0.41.68) (2021-06-08)
-
-**Note:** Version bump only for package @carbon/charts
-
 ## [0.41.67](https://github.com/carbon-design-system/carbon-charts/compare/v0.41.66...v0.41.67) (2021-05-31)
 
 ### Bug Fixes

package/README.md

@@ -23,7 +23,7 @@ bundled version of the library.
 ## Step-by-step instructions
 
 Read
-[here](https://carbon-design-system.github.io/carbon-charts/?path=/story/tutorials-getting-started--vanilla)
+[here](https://carbon-design-system.github.io/carbon-charts/?path=/story/docs-getting-started--vanilla)
 
 ## Codesandbox examples
 
@@ -42,7 +42,7 @@ For instance in the case of a donut chart you're able to pass in an additional
 field called `center` in your options configuring the donut center.
 
 For instructions on using the **tabular data format**, see
-[here](https://carbon-design-system.github.io/carbon-charts/?path=/story/tutorials--tabular-data-format)
+[here](https://carbon-design-system.github.io/carbon-charts/?path=/story/docs-tutorials--tabular-data-format)
 
 There are also additional options available depending on the chart type being
 used,

package/build/demo/data/donut.d.ts

@@ -28,6 +28,17 @@ export declare const donutCenteredOptions: {
         alignment: string;
     };
 };
+export declare const donutDataMapsTo: {
+    group: string;
+    count: number;
+}[];
+export declare const donutMapsToOptions: {
+    title: string;
+    resizable: boolean;
+    pie: {
+        valueMapsTo: string;
+    };
+};
 export declare const donutEmptyStateData: any[];
 export declare const donutEmptyStateOptions: {
     title: string;

package/build/demo/data/meter.d.ts

@@ -40,3 +40,34 @@ export declare const meterOptionsNoStatus: {
     };
     height: string;
 };
+export declare const propMeterData: {
+    group: string;
+    value: number;
+}[];
+export declare const propMeterOptions: {
+    title: string;
+    height: string;
+    meter: {
+        proportional: {
+            total: number;
+            unit: string;
+        };
+    };
+    color: {
+        pairing: {
+            option: number;
+        };
+    };
+};
+export declare const propMeterTruncationOptions: {
+    title: string;
+    height: string;
+    meter: {
+        proportional: {
+            total: number;
+            unit: string;
+            totalFormatter: (total: any) => string;
+            breakdownFormatter: (x: any) => string;
+        };
+    };
+};

package/build/demo/data/pie.d.ts

@@ -20,6 +20,17 @@ export declare const pieCenteredOptions: {
         alignment: string;
     };
 };
+export declare const pieDataMapsTo: {
+    group: string;
+    count: number;
+}[];
+export declare const pieMapToOptions: {
+    title: string;
+    resizable: boolean;
+    pie: {
+        valueMapsTo: string;
+    };
+};
 export declare const pieEmptyStateData: any[];
 export declare const pieEmptyStateOptions: {
     title: string;

package/build/src/components/essentials/title-meter.d.ts

@@ -4,6 +4,8 @@ export declare class MeterTitle extends Title {
     type: string;
     renderType: RenderTypes;
     render(): void;
+    displayBreakdownTitle(): void;
+    displayTotal(): void;
     /**
      * Appends the corresponding status based on the value and the peak.
      */

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

@@ -3,5 +3,8 @@ import { RenderTypes } from '../../interfaces';
 export declare class Meter extends Component {
     type: string;
     renderType: RenderTypes;
+    getStackedBounds(data: any, scale: any): any;
     render(animate?: boolean): void;
+    addEventListeners(): void;
+    destroy(): void;
 }

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

@@ -6,7 +6,6 @@ export * from './essentials/title';
 export * from './essentials/title-meter';
 export * from './essentials/tooltip';
 export * from './essentials/tooltip-axis';
-export * from "./essentials/tooltip-histogram";
 export * from './essentials/canvas-chart-clip';
 export * from './graphs/area';
 export * from './graphs/area-stacked';

package/build/src/configuration-non-customizable.d.ts

@@ -149,6 +149,14 @@ export declare const meter: {
         indicatorSize: number;
         paddingLeft: number;
     };
+    total: {
+        paddingLeft: number;
+    };
+    height: {
+        default: number;
+        proportional: number;
+    };
+    dividerWidth: number;
 };
 export declare const pie: {
     radiusOffset: number;

package/build/src/configuration.d.ts

@@ -1,4 +1,4 @@
-import { BaseChartOptions, AxisChartOptions, ScatterChartOptions, LollipopChartOptions, LineChartOptions, BarChartOptions, StackedBarChartOptions, BoxplotChartOptions, AreaChartOptions, PieChartOptions, GaugeChartOptions, DonutChartOptions, BubbleChartOptions, BulletChartOptions, HistogramChartOptions, RadarChartOptions, ComboChartOptions, TreemapChartOptions, CirclePackChartOptions, WorldCloudChartOptions, GridOptions, RulerOptions, TimeScaleOptions, TooltipOptions, MeterChartOptions } from './interfaces';
+import { BaseChartOptions, AxisChartOptions, ScatterChartOptions, LollipopChartOptions, LineChartOptions, BarChartOptions, StackedBarChartOptions, BoxplotChartOptions, AreaChartOptions, PieChartOptions, GaugeChartOptions, DonutChartOptions, BubbleChartOptions, BulletChartOptions, HistogramChartOptions, RadarChartOptions, ComboChartOptions, TreemapChartOptions, CirclePackChartOptions, WorldCloudChartOptions, GridOptions, RulerOptions, TimeScaleOptions, TooltipOptions, MeterChartOptions, ProportionalMeterChartOptions } from './interfaces';
 /**
  * Grid options
  */
@@ -30,6 +30,7 @@ export declare const options: {
     pieChart: PieChartOptions;
     donutChart: DonutChartOptions;
     meterChart: MeterChartOptions;
+    proportionalMeterChart: ProportionalMeterChartOptions;
     radarChart: RadarChartOptions;
     gaugeChart: GaugeChartOptions;
     comboChart: ComboChartOptions;

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

@@ -292,6 +292,11 @@ export interface PieChartOptions extends BaseChartOptions {
             enabled?: Boolean;
         };
         alignment?: Alignments;
+        /**
+         * identifier for value key in your charting data
+         * defaults to value
+         */
+        valueMapsTo?: string;
         sortFunction?: (a: any, b: any) => number;
     };
 }
@@ -334,6 +339,10 @@ export interface DonutChartOptions extends PieChartOptions {
 }
 export interface MeterChartOptions extends BaseChartOptions {
     meter?: {
+        proportional?: {
+            total?: number;
+            unit?: string;
+        };
         peak?: number;
         status?: {
             ranges: Array<{
@@ -352,6 +361,14 @@ export interface MeterChartOptions extends BaseChartOptions {
         };
     };
 }
+export interface ProportionalMeterChartOptions extends BaseChartOptions {
+    meter?: {
+        proportional?: {
+            total?: number;
+            unit?: string;
+        };
+    };
+}
 /**
  * options specific to radar charts
  */

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

@@ -185,3 +185,12 @@ export declare enum CirclePack {
     CIRCLE_MOUSEOUT = "circle-leaf-mouseout",
     CIRCLE_MOUSEMOVE = "circle-leaf-mousemove"
 }
+/**
+ * enum of all meter related events
+ */
+export declare enum Meter {
+    METER_MOUSEOVER = "meter-mouseover",
+    METER_CLICK = "meter-click",
+    METER_MOUSEOUT = "meter-mouseout",
+    METER_MOUSEMOVE = "meter-mousemove"
+}

package/build/src/model/meter.d.ts

@@ -4,8 +4,7 @@ import { ChartModel } from './model';
  *  */
 export declare class MeterChartModel extends ChartModel {
     constructor(services: any);
-    generateDataLabels(newData: any): {};
-    getDisplayData(): any;
+    getMaximumDomain(data: any): any;
     /**
      * Use a provided color for the bar or default to carbon color if no status provided.
      * Defaults to carbon color otherwise.

package/build/src/tools.d.ts

@@ -85,9 +85,10 @@ export declare namespace Tools {
      * @export
      * @param {any} item
      * @param {any} fullData
+     * @param {string} key
      * @returns The percentage in the form of a number (1 significant digit if necessary)
      */
-    export function convertValueToPercentage(item: any, fullData: any): number;
+    export function convertValueToPercentage(item: any, fullData: any, key?: string): number;
     /**
      * Truncate the labels
      * @export