@carbon/charts 1.8.0 → 1.9.0-rc.0

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

@@ -1,512 +0,0 @@
-import { GaugeTypes, Statuses, ArrowDirections, Alignments, ChartTypes, TreeTypes, DividerStatus, ColorLegendType, ChartTheme, Projection } from './enums';
-import { LegendOptions, TooltipOptions, GridOptions, AxesOptions, ZoomBarsOptions } from './index';
-import { BarOptions, StackedBarOptions, ToolbarOptions } from './components';
-import { AxisOptions, BinnedAxisOptions, ComboChartAxisOptions, TimeScaleOptions } from './axis-scales';
-/**
- * Base chart options common to any chart
- */
-export interface BaseChartOptions {
-    /**
-     * Optionally specify a title for the chart
-     */
-    title?: string;
-    /**
-     * boolean to disable animations (enabled by default)
-     */
-    animations?: boolean;
-    /**
-     * boolean to prevent the container from resizing
-     */
-    resizable?: boolean;
-    /**
-     * Optionally specify a width for the chart
-     */
-    width?: string;
-    /**
-     * Optionally specify a height for the chart
-     */
-    height?: string;
-    /**
-     * Optionally specify a theme for the chart
-     */
-    theme?: ChartTheme;
-    /**
-     * tooltip configuration
-     */
-    tooltip?: TooltipOptions;
-    /**
-     * legend configuration
-     */
-    legend?: LegendOptions;
-    /**
-     * toolbar configurations
-     */
-    toolbar?: ToolbarOptions;
-    /**
-     * Optional function to determine whether is filled based on datasetLabel, label, and/or data
-     */
-    getIsFilled?: (datasetLabel: any, label?: any, data?: any, defaultFilled?: boolean) => boolean;
-    /**
-     * Optional function to generate the fill color based on datasetLabel, label, and/or data
-     */
-    getFillColor?: (group: string, label?: string, data?: any, defaultFillColor?: string) => string;
-    /**
-     * Optional function to generate the stroke color based on datasetLabel, label, and/or data
-     * (note) - not all chart types support the stroke color (e.g. wordcloud)
-     */
-    getStrokeColor?: (group: string, label?: any, data?: any, defaultStrokeColor?: string) => string;
-    /**
-     * stylesheet options
-     */
-    style?: {
-        /**
-         * optional prefixing string for css classes (defaults to 'cc')
-         */
-        prefix?: string;
-    };
-    /**
-     * options related to charting data
-     */
-    data?: {
-        /**
-         * identifier for data groups
-         */
-        groupMapsTo?: string;
-        /**
-         * used to simulate data loading in skeleton way
-         */
-        loading?: boolean;
-        /**
-         * options related to pre-selected data groups
-         * Remains empty if every legend item is active or dataset doesn't have the data groups.
-         */
-        selectedGroups?: string[];
-    };
-    /**
-     * options related to color scales
-     */
-    color?: {
-        /**
-         * e.g. { 'Dataset 1': 'blue' }
-         */
-        scale?: object;
-        /**
-         * use a carbon dataviz preset color palette
-         * put the index (selection of which variant)
-         */
-        pairing?: {
-            /**
-             * the number of color variants in the palette (defaults to using the number of data groups in the given data)
-             */
-            numberOfVariants?: number;
-            /**
-             * the option number of the color paring
-             */
-            option?: number;
-        };
-        gradient?: {
-            enabled?: boolean;
-            /**
-             * hex color array
-             * e.g. ['#fff', '#000', ...]
-             */
-            colors?: Array<String>;
-        };
-    };
-    fileDownload?: {
-        /**
-         * the number of color variants in the palette (defaults to using the number of data groups in the given data)
-         */
-        fileName?: (type: 'png' | 'jpg' | 'csv') => string;
-    };
-}
-/**
- * Options common to any chart with an axis
- */
-export interface AxisChartOptions extends BaseChartOptions {
-    axes?: AxesOptions<AxisOptions>;
-    grid?: GridOptions;
-    timeScale?: TimeScaleOptions;
-    /**
-     * zoombar configuration
-     */
-    zoomBar?: ZoomBarsOptions;
-}
-/**
- * Options common to binned charts with an axis
- */
-export interface BinnedAxisChartOptions extends AxisChartOptions {
-    axes?: AxesOptions<BinnedAxisOptions>;
-    grid?: GridOptions;
-    timeScale?: TimeScaleOptions;
-    /**
-     * zoombar configuration
-     */
-    zoomBar?: ZoomBarsOptions;
-}
-/**
- * options specific to boxplot charts
- */
-export interface BoxplotChartOptions extends AxisChartOptions {
-}
-/**
- * options specific to bar charts
- */
-export interface BarChartOptions extends AxisChartOptions {
-    bars?: BarOptions;
-}
-/**
- * options specific to stacked bar charts
- */
-export interface StackedBarChartOptions extends BarChartOptions {
-    bars?: StackedBarOptions;
-}
-/**
- * options specific to scatter charts
- */
-export interface ScatterChartOptions extends AxisChartOptions {
-    /**
-     * options for the points
-     */
-    points?: {
-        /**
-         * sets the radius of the point
-         */
-        radius: number;
-        fillOpacity?: number;
-        filled?: boolean;
-        enabled?: boolean;
-    };
-}
-/**
- * options specific to lollipop charts
- */
-export interface LollipopChartOptions extends ScatterChartOptions {
-}
-/**
- * options specific to bubble charts
- */
-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;
-        /**
-         * options for what the bubble radius value maps to
-         */
-        radiusLabel?: 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
-         */
-        radiusRange?: Function;
-        /**
-         * Opacity of the fills used within each circle
-         */
-        fillOpacity?: number;
-        /**
-         * enabled scatter dot or not
-         */
-        enabled?: boolean;
-    };
-}
-/**
- * options specific to bullet charts
- */
-export interface BulletChartOptions extends AxisChartOptions {
-    /**
-     * options for the individual bullets
-     */
-    bullet?: {
-        performanceAreaTitles?: string[];
-    };
-}
-/**
- * options specific to histogram charts
- */
-export interface HistogramChartOptions extends AxisChartOptions {
-    /**
-     * options related to bins
-     */
-    bins?: {
-        rangeLabel?: string;
-    };
-}
-/**
- * options specific to line charts
- */
-export interface LineChartOptions extends ScatterChartOptions {
-    /**
-     * options for the curve of the line
-     */
-    curve?: string | {
-        name: string;
-    };
-}
-/**
- * options specific to area charts
- */
-export interface AreaChartOptions extends AxisChartOptions {
-    /**
-     * options for the curve of the line
-     */
-    curve?: string | {
-        name: string;
-    };
-    /**
-     * options to bound the area of the chart
-     */
-    bounds?: {
-        upperBoundMapsTo?: string;
-        lowerBoundMapsTo?: string;
-    };
-}
-/**
- * options specific to area charts
- */
-export interface StackedAreaChartOptions extends ScatterChartOptions {
-    /**
-     * options for the curve of the line
-     */
-    curve?: string | {
-        name: string;
-    };
-}
-/**
- * options specific to world cloud charts
- */
-export interface WordCloudChartTooltipOptions extends TooltipOptions {
-    /** the label that shows up by the highlighted word in the tooltip */
-    wordLabel?: string;
-    /** the label that shows up by the value of the highlighted word in the tooltip */
-    valueLabel?: string;
-}
-export interface WorldCloudChartOptions extends BaseChartOptions {
-    wordCloud?: {
-        /** what key in your charting data will the font sizes map to? */
-        fontSizeMapsTo?: string;
-        /** a function (chartSize, data) => {} that'll decide the range of font sizes, e.g. [10, 80] */
-        fontSizeRange?: Function;
-        /** what key in your charting data will the words map to? */
-        wordMapsTo?: string;
-    };
-    /**
-     * tooltip configuration
-     */
-    tooltip?: WordCloudChartTooltipOptions;
-}
-/**
- * options specific to pie charts
- */
-export interface PieChartOptions extends BaseChartOptions {
-    pie?: {
-        labels?: {
-            formatter?: Function;
-            enabled?: Boolean;
-        };
-        alignment?: Alignments;
-        /**
-         * identifier for value key in your charting data
-         * defaults to value
-         */
-        valueMapsTo?: string;
-        sortFunction?: (a: any, b: any) => number;
-    };
-}
-/**
- * options specific to gauge charts
- */
-export interface GaugeChartOptions extends BaseChartOptions {
-    gauge?: {
-        arcWidth?: number;
-        deltaArrow?: {
-            direction?: ArrowDirections;
-            size?: Function;
-            enabled: Boolean;
-        };
-        showPercentageSymbol?: Boolean;
-        status?: Statuses;
-        deltaFontSize?: Function;
-        numberSpacing?: number;
-        numberFormatter?: Function;
-        valueFontSize?: Function;
-        type?: GaugeTypes;
-        alignment?: Alignments;
-    };
-}
-/**
- * options specific to donut charts
- */
-export interface DonutChartOptions extends PieChartOptions {
-    donut?: {
-        center?: {
-            label?: string;
-            number?: number;
-            numberFontSize?: Function;
-            titleFontSize?: Function;
-            titleYPosition?: Function;
-            numberFormatter?: Function;
-        };
-        alignment?: Alignments;
-    };
-}
-export interface MeterChartOptions extends BaseChartOptions {
-    meter?: {
-        showLabels?: boolean;
-        proportional?: {
-            total?: number;
-            unit?: string;
-        };
-        peak?: number;
-        status?: {
-            ranges: Array<{
-                range: [number, number];
-                status: Statuses;
-            }>;
-        };
-        height?: number;
-        title?: {
-            percentageIndicator?: {
-                /**
-                 * rendering of the percentage value relative to the dataset within title
-                 */
-                enabled?: boolean;
-            };
-        };
-    };
-}
-export interface ProportionalMeterChartOptions extends BaseChartOptions {
-    meter?: {
-        proportional?: {
-            total?: number;
-            unit?: string;
-        };
-    };
-}
-/**
- * options specific to radar charts
- */
-export interface RadarChartOptions extends BaseChartOptions {
-    radar?: {
-        axes: {
-            angle: string;
-            value: string;
-        };
-        alignment?: Alignments;
-    };
-}
-/**
- * options specific to combo charts
- */
-export interface ComboChartOptions extends AxisChartOptions {
-    axes?: AxesOptions<ComboChartAxisOptions>;
-    comboChartTypes: Array<{
-        type: ChartTypes | any;
-        options?: object;
-        correspondingDatasets: Array<string>;
-    }>;
-}
-export interface TreemapChartOptions extends BaseChartOptions {
-}
-export interface TreeChartOptions extends BaseChartOptions {
-    tree?: {
-        type?: TreeTypes;
-        rootTitle?: string;
-    };
-}
-export interface CirclePackChartOptions extends BaseChartOptions {
-    circlePack?: {
-        circles: {
-            fillOpacity: number;
-        };
-        hierachyLevel: number;
-        padding?: {
-            outer?: number;
-            inner?: number;
-        };
-    };
-}
-/**
- * options specific to Alluvial charts
- */
-export interface AlluvialChartOptions extends BaseChartOptions {
-    alluvial: {
-        units?: string;
-        /**
-         * List of nodes to draw
-         */
-        nodes: Array<{
-            name: string;
-            category?: string;
-        }>;
-        /**
-         * Node alignment (Default is center)
-         */
-        nodeAlignment?: Alignments;
-        /**
-         * Set the node padding
-         */
-        nodePadding?: number;
-        /**
-         * Enable single color usage for lines
-         */
-        monochrome?: boolean;
-    };
-}
-/**
- * options specific to Heatmap charts
- */
-export interface HeatmapChartOptions extends BaseChartOptions {
-    heatmap: {
-        /**
-         * Divider width state - will default to auto
-         * No cell divider for cell dimensions less than 16
-         */
-        divider?: {
-            state?: DividerStatus;
-        };
-        /**
-         * customize color legend
-         * enabled by default on select charts
-         */
-        colorLegend?: {
-            /**
-             * Text to display beside or on top of the legend
-             * Position is determined by text length
-             */
-            title?: string;
-            type: ColorLegendType;
-        };
-    };
-}
-/**
- * Options common to any thematic chart
- */
-export interface ThematicChartOptions extends BaseChartOptions {
-    thematic: {
-        projection: Projection;
-    };
-}
-/**
- * Options common to any thematic chart
- */
-export interface ChoroplethChartOptions extends ThematicChartOptions {
-    choropleth: {
-        /**
-         * customize color legend
-         * enabled by default on select charts
-         */
-        colorLegend?: {
-            /**
-             * Text to display beside or on top of the legend
-             * Position is determined by text length
-             */
-            title?: string;
-            type: ColorLegendType;
-        };
-    };
-}

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

@@ -1,7 +0,0 @@
-export * from './a11y';
-export * from './axis-scales';
-export * from './charts';
-export * from './components';
-export * from './enums';
-export * from './layout';
-export * from './model';

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

@@ -1,15 +0,0 @@
-import { LayoutAlignItems, LayoutDirection, RenderTypes } from './enums';
-export interface LayoutConfigs {
-    /**
-     * Direction/orientation of the layout
-     */
-    direction?: LayoutDirection;
-    /**
-     * Whether to render through SVG or HTML
-     */
-    renderType?: RenderTypes;
-    /**
-     * how the layout will align its children
-     */
-    alignItems?: LayoutAlignItems;
-}

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

@@ -1,52 +0,0 @@
-import { AxisFlavor } from '../interfaces';
-import { ChartModelCartesian } from './cartesian-charts';
-/** The gauge chart model layer */
-export declare class HeatmapModel extends ChartModelCartesian {
-    protected axisFlavor: AxisFlavor;
-    private _colorScale;
-    private _domains;
-    private _ranges;
-    private _matrix;
-    constructor(services: any);
-    /**
-     * @override
-     * @param value
-     * @returns string
-     */
-    getFillColor(value: number): any;
-    /**
-     * Generate a list of all unique domains
-     * @returns String[]
-     */
-    getUniqueDomain(): string[];
-    /**
-     * Generates a list of all unique ranges
-     * @returns String[]
-     */
-    getUniqueRanges(): string[];
-    /**
-     * Generates a matrix (If doesn't exist) and returns it
-     * @returns Object
-     */
-    getMatrix(): {};
-    /**
-     *
-     * @param newData The new raw data to be set
-     */
-    setData(newData: any): any;
-    /**
-     * Converts Object matrix into a single array
-     * @returns Object[]
-     */
-    getMatrixAsArray(): Object[];
-    /**
-     * Generate tabular data from display data
-     * @returns Array<Object>
-     */
-    getTabularDataArray(): any[];
-    getColorClassName(configs: {
-        value?: number;
-        originalClassName?: string;
-    }): string;
-    protected setColorClassNames(): void;
-}

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

@@ -1,19 +0,0 @@
-import { ChartModel } from './model';
-/** The meter chart model layer which extends some of the data setting options.
- * Meter only uses 1 dataset
- *  */
-export declare class MeterChartModel extends ChartModel {
-    constructor(services: 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.
-     * @param group dataset group label
-     */
-    getFillColor(group: string): any;
-    /**
-     * Get the associated status for the data by checking the ranges
-     */
-    getStatus(): any;
-    getTabularDataArray(): any[];
-}

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

@@ -1,107 +0,0 @@
-import { ColorClassNameTypes } from '../interfaces';
-/** The charting model layer which includes mainly the chart data and options,
- * as well as some misc. information to be shared among components */
-export declare class ChartModel {
-    protected services: any;
-    protected state: any;
-    /**
-     * A list of all the data groups that have existed within the lifetime of the chart
-     * @type string[]
-     */
-    protected allDataGroups: string[];
-    protected colorScale: any;
-    protected colorClassNames: any;
-    constructor(services: any);
-    getAllDataFromDomain(groups?: any): any;
-    /**
-     * Charts that have group configs passed into them, only want to retrieve the display data relevant to that chart
-     * @param groups the included datasets for the particular chart
-     */
-    getDisplayData(groups?: any): any;
-    getData(): any;
-    isDataEmpty(): boolean;
-    /**
-     *
-     * @param newData The new raw data to be set
-     */
-    setData(newData: any): any;
-    getDataGroups(groups?: any): any;
-    getActiveDataGroups(groups?: any): any;
-    getDataGroupNames(groups?: any): any;
-    getActiveDataGroupNames(groups?: any): any;
-    private aggregateBinDataByGroup;
-    getBinConfigurations(): {
-        bins: import("d3-array").Bin<number, number>[];
-        binsDomain: any[];
-    };
-    getBinnedStackedData(): any[][];
-    getGroupedData(groups?: any): {
-        name: string;
-        data: any;
-    }[];
-    getStackKeys({ bins, groups }?: {
-        bins?: any;
-        groups?: any;
-    }): any;
-    getDataValuesGroupedByKeys({ bins, groups }: {
-        bins?: any;
-        groups?: any;
-    }): any;
-    getStackedData({ percentage, groups, divergent }: {
-        percentage?: boolean;
-        groups?: any;
-        divergent?: boolean;
-    }): any[][];
-    /**
-     * @return {Object} The chart's options
-     */
-    getOptions(): any;
-    set(newState: any, configs?: any): void;
-    get(property?: string): any;
-    /**
-     *
-     * @param newOptions New options to be set
-     */
-    setOptions(newOptions: any): void;
-    /**
-     *
-     * Updates miscellanous information within the model
-     * such as the color scales, or the legend data labels
-     */
-    update(animate?: boolean): void;
-    toggleDataLabel(changedLabel: string): void;
-    /**
-     * Should the data point be filled?
-     * @param group
-     * @param key
-     * @param value
-     * @param defaultFilled the default for this chart
-     */
-    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;
-    isUserProvidedColorScaleValid(): any;
-    getColorClassName(configs: {
-        classNameTypes: ColorClassNameTypes[];
-        dataGroupName?: string;
-        originalClassName?: string;
-    }): string;
-    /**
-     * For charts that might hold an associated status for their dataset
-     */
-    getStatus(): any;
-    getAllDataGroupsNames(): string[];
-    /**
-     * Converts data provided in the older format to tabular
-     *
-     */
-    protected transformToTabularData(data: any): any[];
-    getTabularDataArray(): any[];
-    exportToCSV(): void;
-    protected getTabularData(data: any): any[];
-    protected sanitize(data: any): any;
-    protected updateAllDataGroups(): void;
-    protected generateDataGroups(data: any): any;
-    protected setCustomColorScale(): void;
-    protected setColorClassNames(): void;
-}