@cloudscape-design/components 3.0.1012 → 3.0.1014

package/internal/components/cartesian-chart/chart-container.d.ts

@@ -1,14 +1,13 @@
 import React from 'react';
 interface CartesianChartContainerProps {
-    minHeight: number;
-    fitHeight: boolean;
-    hasFilters: boolean;
-    leftAxisLabel: React.ReactNode;
-    leftAxisLabelMeasure: React.ReactNode;
-    bottomAxisLabel: React.ReactNode;
-    chartPlot: React.ReactNode;
-    popover: React.ReactNode;
+  minHeight: number;
+  fitHeight: boolean;
+  hasFilters: boolean;
+  leftAxisLabel: React.ReactNode;
+  leftAxisLabelMeasure: React.ReactNode;
+  bottomAxisLabel: React.ReactNode;
+  chartPlot: React.ReactNode;
+  popover: React.ReactNode;
 }
 export declare const CartesianChartContainer: React.ForwardRefExoticComponent<CartesianChartContainerProps & React.RefAttributes<HTMLDivElement>>;
-export {};
-//# sourceMappingURL=chart-container.d.ts.map
+export {};

package/internal/components/cartesian-chart/constants.d.ts

@@ -2,5 +2,4 @@ export declare const TICK_LENGTH = 8;
 export declare const TICK_MARGIN = 4;
 export declare const TICK_LINE_HEIGHT = 16;
 export declare const X_TICK_COUNT_RATIO = 100;
-export declare const Y_TICK_COUNT_RATIO = 50;
-//# sourceMappingURL=constants.d.ts.map
+export declare const Y_TICK_COUNT_RATIO = 50;

package/internal/components/cartesian-chart/emphasized-baseline.d.ts

@@ -1,12 +1,16 @@
 /// <reference types="react" />
 import { NumericChartScale } from './scales';
 interface EmphasizedBaselineProps {
-    axis?: 'x' | 'y';
-    width: number;
-    height: number;
-    scale: NumericChartScale;
+  axis?: 'x' | 'y';
+  width: number;
+  height: number;
+  scale: NumericChartScale;
 }
 declare const _default: typeof EmphasizedBaseline;
 export default _default;
-declare function EmphasizedBaseline({ axis, width, height, scale }: EmphasizedBaselineProps): JSX.Element | null;
-//# sourceMappingURL=emphasized-baseline.d.ts.map
+declare function EmphasizedBaseline({
+  axis,
+  width,
+  height,
+  scale
+}: EmphasizedBaselineProps): JSX.Element | null;

package/internal/components/cartesian-chart/highlighted-point.d.ts

@@ -1,17 +1,16 @@
 import React from 'react';
 interface SeriesPoint {
-    key: string;
-    x: number;
-    y: number;
-    color: string;
+  key: string;
+  x: number;
+  y: number;
+  color: string;
 }
 interface HighlightedPointProps {
-    point: null | SeriesPoint;
-    role?: 'group' | 'button';
-    ariaLabel?: string;
-    ariaHasPopup?: boolean;
-    ariaExpanded?: boolean;
+  point: null | SeriesPoint;
+  role?: 'group' | 'button';
+  ariaLabel?: string;
+  ariaHasPopup?: boolean;
+  ariaExpanded?: boolean;
 }
 declare const _default: React.MemoExoticComponent<React.ForwardRefExoticComponent<HighlightedPointProps & React.RefAttributes<SVGGElement>>>;
-export default _default;
-//# sourceMappingURL=highlighted-point.d.ts.map
+export default _default;

package/internal/components/cartesian-chart/inline-start-labels.d.ts

@@ -2,17 +2,26 @@
 import { ChartDataTypes } from '../../../mixed-line-bar-chart/interfaces';
 import { ChartScale, NumericChartScale } from './scales';
 interface InlineStartLabelsProps {
-    axis?: 'x' | 'y';
-    plotWidth: number;
-    plotHeight: number;
-    maxLabelsWidth?: number;
-    scale: ChartScale | NumericChartScale;
-    ticks: readonly ChartDataTypes[];
-    tickFormatter?: (value: number) => string;
-    title?: string;
-    ariaRoleDescription?: string;
+  axis?: 'x' | 'y';
+  plotWidth: number;
+  plotHeight: number;
+  maxLabelsWidth?: number;
+  scale: ChartScale | NumericChartScale;
+  ticks: readonly ChartDataTypes[];
+  tickFormatter?: (value: number) => string;
+  title?: string;
+  ariaRoleDescription?: string;
 }
 declare const _default: typeof InlineStartLabels;
 export default _default;
-declare function InlineStartLabels({ axis, plotWidth, plotHeight, maxLabelsWidth, scale, ticks, tickFormatter, title, ariaRoleDescription, }: InlineStartLabelsProps): JSX.Element;
-//# sourceMappingURL=inline-start-labels.d.ts.map
+declare function InlineStartLabels({
+  axis,
+  plotWidth,
+  plotHeight,
+  maxLabelsWidth,
+  scale,
+  ticks,
+  tickFormatter,
+  title,
+  ariaRoleDescription
+}: InlineStartLabelsProps): JSX.Element;

package/internal/components/cartesian-chart/interfaces.d.ts

@@ -2,203 +2,203 @@
 import { BaseComponentProps } from '../../base-component';
 import { NonCancelableEventHandler } from '../../events';
 export interface CartesianChartProps<T extends ChartDataTypes, Series> extends BaseComponentProps {
-    /**
-     * Determines the type of scale for values on the x axis.
-     */
-    xScaleType?: ScaleType;
-    /**
-     * Determines the type of scale for values on the y axis.
-     */
-    yScaleType?: 'linear' | 'log';
-    /**
-     * Determines the domain of the x axis, i.e. the range of values that will be visible in the chart.
-     * For numerical and time-based data this is represented as an array with two values: `[minimumValue, maximumValue]`.
-     * For categorical data this is represented as an array of strings that determine the categories to display.
-     *
-     * It is recommended to set this explicitly. If not, the component will determine a domain that fits all data points.
-     * When controlling this directly, make sure to update the value based on filtering changes.
-     */
-    xDomain?: ReadonlyArray<T>;
-    /**
-     * Determines the domain of the y axis, i.e. the range of values that will be visible in the chart.
-     * The domain is defined by a tuple: `[minimumValue, maximumValue]`.
-     *
-     * It is recommended to set this explicitly. If not, the component will determine a domain that fits all data points.
-     * When controlling this directly, make sure to update the value based on filtering changes.
-     */
-    yDomain?: ReadonlyArray<number>;
-    /**
-     * The title of the x axis.
-     */
-    xTitle?: string;
-    /**
-     * The title of the y axis.
-     */
-    yTitle?: string;
-    /**
-     * Optional title for the legend.
-     */
-    legendTitle?: string;
-    /**
-     * ARIA label that is assigned to the chart itself. It should match the visible label on the page, e.g. in the container header.
-     * Do not use `ariaLabel` and `ariaLabelledby` at the same time.
-     */
-    ariaLabel?: string;
-    /**
-     * Sets `aria-labelledby` on the chart itself.
-     * If there is a visible label for the chart on the page, e.g. in the container header, set this property to the ID of that header element.
-     * Do not use `ariaLabel` and `ariaLabelledby` at the same time.
-     */
-    ariaLabelledby?: string;
-    /**
-     * A description of the chart that assistive technologies can use (through `aria-describedby`).
-     * Provide a concise summary of the data visualized in the chart.
-     */
-    ariaDescription?: string;
-    /**
-     * An object containing all the necessary localized strings required by the component.
-     * @i18n
-     */
-    i18nStrings?: CartesianChartProps.I18nStrings<T>;
-    /**
-     * Function to format the displayed label of an x axis tick.
-     */
-    xTickFormatter?: CartesianChartProps.TickFormatter<T>;
-    /**
-     * Function to format the displayed label of a y axis tick.
-     */
-    yTickFormatter?: CartesianChartProps.TickFormatter<number>;
-    /**
-     * An optional pixel value number that fixes the height of the chart area.
-     * If not set explicitly, the component will use a default height that is defined internally.
-     * When used with `fitHeight`, this property defines the minimum height of the chart area.
-     */
-    height?: number;
-    /**
-     * Determines the maximum width the detail popover will be limited to.
-     */
-    detailPopoverSize?: 'small' | 'medium' | 'large';
-    /**
-     * Additional content that is displayed at the bottom of the detail popover.
-     */
-    detailPopoverFooter?: CartesianChartProps.DetailPopoverFooter<T>;
-    /**
-     * When set to `true`, the legend beneath the chart is not displayed.
-     * It is highly recommended to keep this set to `false`.
-     */
-    hideLegend?: boolean;
-    /**
-     * When set to `true`, the default filtering dropdown is not displayed.
-     * It is still possible to render additional filters with the `additionalFilters` slot.
-     */
-    hideFilter?: boolean;
-    /**
-     * Additional filters that are added above the chart component.
-     * Make sure to update the `data` property when any of your custom filters change the data to be displayed.
-     */
-    additionalFilters?: React.ReactNode;
-    /**
-     * The currently highlighted data series, usually through hovering over a series or the legend.
-     * A value of `null` means no series is highlighted.
-     *
-     * - If you do not set this property, series are highlighted automatically when hovering over one of the triggers (uncontrolled behavior).
-     * - If you explicitly set this property, you must set an `onHighlightChange` listener to update this property when a series should be highlighted (controlled behavior).
-     */
-    highlightedSeries?: Series | null;
-    /**
-     * An array of series objects that determines which of the data series are currently displayed, i.e. not filtered out.
-     * - If you do not set this property, series are shown and hidden automatically when using the default filter component (uncontrolled behavior).
-     * - If you explicitly set this property, you must set an `onFilterChange` listener to update this property when the visible series should change, or when one of your custom filters changes the number of visible series (controlled behavior).
-     */
-    visibleSeries?: ReadonlyArray<Series>;
-    /**
-     * Specifies the current status of loading data.
-     * * `loading`: data fetching is in progress.
-     * * `finished`: data has loaded successfully.
-     * * `error`: an error occurred during fetch. You should provide user an option to recover.
-     **/
-    statusType?: 'loading' | 'finished' | 'error';
-    /**
-     * Content that is displayed when the data passed to the component is empty.
-     */
-    empty?: React.ReactNode;
-    /**
-     * Content that is displayed when there is no data to display due to the built-in filtering.
-     */
-    noMatch?: React.ReactNode;
-    /**
-     * Text that is displayed when the chart is loading, i.e. when `statusType` is set to `"loading"`.
-     * @i18n
-     */
-    loadingText?: string;
-    /**
-     * Text that is displayed when the chart is in error state, i.e. when `statusType` is set to `"error"`.
-     * @i18n
-     */
-    errorText?: string;
-    /**
-     * Text for the recovery button that is displayed next to the error text.
-     * @i18n
-     **/
-    recoveryText?: string;
-    /**
-     * Called when the user clicks the recovery button that appears when there is an error state.
-     * Use this to enable the user to retry a failed request or provide another option for the user
-     * to recover from the error.
-     */
-    onRecoveryClick?: NonCancelableEventHandler;
-    /**
-     * Called when the values of the internal filter component changed.
-     * This will **not** be called for any custom filter components you have defined in `additionalFilters`.
-     */
-    onFilterChange?: NonCancelableEventHandler<CartesianChartProps.FilterChangeDetail<Series>>;
-    /**
-     * Called when the highlighted series has changed because of user interaction.
-     */
-    onHighlightChange?: NonCancelableEventHandler<CartesianChartProps.HighlightChangeDetail<Series>>;
-    /**
-     * Enable this property to make the chart fit into the available height of the parent container.
-     */
-    fitHeight?: boolean;
+  /**
+   * Determines the type of scale for values on the x axis.
+   */
+  xScaleType?: ScaleType;
+  /**
+   * Determines the type of scale for values on the y axis.
+   */
+  yScaleType?: 'linear' | 'log';
+  /**
+   * Determines the domain of the x axis, i.e. the range of values that will be visible in the chart.
+   * For numerical and time-based data this is represented as an array with two values: `[minimumValue, maximumValue]`.
+   * For categorical data this is represented as an array of strings that determine the categories to display.
+   *
+   * It is recommended to set this explicitly. If not, the component will determine a domain that fits all data points.
+   * When controlling this directly, make sure to update the value based on filtering changes.
+   */
+  xDomain?: ReadonlyArray<T>;
+  /**
+   * Determines the domain of the y axis, i.e. the range of values that will be visible in the chart.
+   * The domain is defined by a tuple: `[minimumValue, maximumValue]`.
+   *
+   * It is recommended to set this explicitly. If not, the component will determine a domain that fits all data points.
+   * When controlling this directly, make sure to update the value based on filtering changes.
+   */
+  yDomain?: ReadonlyArray<number>;
+  /**
+   * The title of the x axis.
+   */
+  xTitle?: string;
+  /**
+   * The title of the y axis.
+   */
+  yTitle?: string;
+  /**
+   * Optional title for the legend.
+   */
+  legendTitle?: string;
+  /**
+   * ARIA label that is assigned to the chart itself. It should match the visible label on the page, e.g. in the container header.
+   * Do not use `ariaLabel` and `ariaLabelledby` at the same time.
+   */
+  ariaLabel?: string;
+  /**
+   * Sets `aria-labelledby` on the chart itself.
+   * If there is a visible label for the chart on the page, e.g. in the container header, set this property to the ID of that header element.
+   * Do not use `ariaLabel` and `ariaLabelledby` at the same time.
+   */
+  ariaLabelledby?: string;
+  /**
+   * A description of the chart that assistive technologies can use (through `aria-describedby`).
+   * Provide a concise summary of the data visualized in the chart.
+   */
+  ariaDescription?: string;
+  /**
+   * An object containing all the necessary localized strings required by the component.
+   * @i18n
+   */
+  i18nStrings?: CartesianChartProps.I18nStrings<T>;
+  /**
+   * Function to format the displayed label of an x axis tick.
+   */
+  xTickFormatter?: CartesianChartProps.TickFormatter<T>;
+  /**
+   * Function to format the displayed label of a y axis tick.
+   */
+  yTickFormatter?: CartesianChartProps.TickFormatter<number>;
+  /**
+   * An optional pixel value number that fixes the height of the chart area.
+   * If not set explicitly, the component will use a default height that is defined internally.
+   * When used with `fitHeight`, this property defines the minimum height of the chart area.
+   */
+  height?: number;
+  /**
+   * Determines the maximum width the detail popover will be limited to.
+   */
+  detailPopoverSize?: 'small' | 'medium' | 'large';
+  /**
+   * Additional content that is displayed at the bottom of the detail popover.
+   */
+  detailPopoverFooter?: CartesianChartProps.DetailPopoverFooter<T>;
+  /**
+   * When set to `true`, the legend beneath the chart is not displayed.
+   * It is highly recommended to keep this set to `false`.
+   */
+  hideLegend?: boolean;
+  /**
+   * When set to `true`, the default filtering dropdown is not displayed.
+   * It is still possible to render additional filters with the `additionalFilters` slot.
+   */
+  hideFilter?: boolean;
+  /**
+   * Additional filters that are added above the chart component.
+   * Make sure to update the `data` property when any of your custom filters change the data to be displayed.
+   */
+  additionalFilters?: React.ReactNode;
+  /**
+   * The currently highlighted data series, usually through hovering over a series or the legend.
+   * A value of `null` means no series is highlighted.
+   *
+   * - If you do not set this property, series are highlighted automatically when hovering over one of the triggers (uncontrolled behavior).
+   * - If you explicitly set this property, you must set an `onHighlightChange` listener to update this property when a series should be highlighted (controlled behavior).
+   */
+  highlightedSeries?: Series | null;
+  /**
+   * An array of series objects that determines which of the data series are currently displayed, i.e. not filtered out.
+   * - If you do not set this property, series are shown and hidden automatically when using the default filter component (uncontrolled behavior).
+   * - If you explicitly set this property, you must set an `onFilterChange` listener to update this property when the visible series should change, or when one of your custom filters changes the number of visible series (controlled behavior).
+   */
+  visibleSeries?: ReadonlyArray<Series>;
+  /**
+   * Specifies the current status of loading data.
+   * * `loading`: data fetching is in progress.
+   * * `finished`: data has loaded successfully.
+   * * `error`: an error occurred during fetch. You should provide user an option to recover.
+   **/
+  statusType?: 'loading' | 'finished' | 'error';
+  /**
+   * Content that is displayed when the data passed to the component is empty.
+   */
+  empty?: React.ReactNode;
+  /**
+   * Content that is displayed when there is no data to display due to the built-in filtering.
+   */
+  noMatch?: React.ReactNode;
+  /**
+   * Text that is displayed when the chart is loading, i.e. when `statusType` is set to `"loading"`.
+   * @i18n
+   */
+  loadingText?: string;
+  /**
+   * Text that is displayed when the chart is in error state, i.e. when `statusType` is set to `"error"`.
+   * @i18n
+   */
+  errorText?: string;
+  /**
+   * Text for the recovery button that is displayed next to the error text.
+   * @i18n
+   **/
+  recoveryText?: string;
+  /**
+   * Called when the user clicks the recovery button that appears when there is an error state.
+   * Use this to enable the user to retry a failed request or provide another option for the user
+   * to recover from the error.
+   */
+  onRecoveryClick?: NonCancelableEventHandler;
+  /**
+   * Called when the values of the internal filter component changed.
+   * This will **not** be called for any custom filter components you have defined in `additionalFilters`.
+   */
+  onFilterChange?: NonCancelableEventHandler<CartesianChartProps.FilterChangeDetail<Series>>;
+  /**
+   * Called when the highlighted series has changed because of user interaction.
+   */
+  onHighlightChange?: NonCancelableEventHandler<CartesianChartProps.HighlightChangeDetail<Series>>;
+  /**
+   * Enable this property to make the chart fit into the available height of the parent container.
+   */
+  fitHeight?: boolean;
 }
 export declare namespace CartesianChartProps {
-    interface FilterChangeDetail<Series> {
-        visibleSeries: ReadonlyArray<Series>;
-    }
-    interface HighlightChangeDetail<Series> {
-        highlightedSeries: Series | null;
-    }
-    interface TickFormatter<T> {
-        (value: T): string;
-    }
-    interface ValueFormatter<YType, XType = null> {
-        (yValue: YType, xValue: XType): string;
-    }
-    interface DetailPopoverFooter<T> {
-        (xValue: T): React.ReactNode;
-    }
-    interface I18nStrings<T> {
-        /** Visible label of the default filter */
-        filterLabel?: string;
-        /** Placeholder text of the default filter */
-        filterPlaceholder?: string;
-        /** ARIA label for the default filter which is appended to any option that is selected */
-        filterSelectedAriaLabel?: string;
-        /** ARIA label that is associated with the legend in case there is no visible `legendTitle` defined */
-        legendAriaLabel?: string;
-        /** ARIA label for details popover dismiss button */
-        detailPopoverDismissAriaLabel?: string;
-        /** Name of the ARIA role description of the chart, e.g. "line chart" */
-        chartAriaRoleDescription?: string;
-        /** Name of the ARIA role description of the x axis, e.g. "x axis" */
-        xAxisAriaRoleDescription?: string;
-        /** Name of the ARIA role description of the y axis, e.g. "y axis" */
-        yAxisAriaRoleDescription?: string;
-        /** @deprecated Use `xTickFormatter` on the component instead. */
-        xTickFormatter?: TickFormatter<T>;
-        /** @deprecated Use `yTickFormatter` on the component instead. */
-        yTickFormatter?: TickFormatter<number>;
-    }
+  interface FilterChangeDetail<Series> {
+    visibleSeries: ReadonlyArray<Series>;
+  }
+  interface HighlightChangeDetail<Series> {
+    highlightedSeries: Series | null;
+  }
+  interface TickFormatter<T> {
+    (value: T): string;
+  }
+  interface ValueFormatter<YType, XType = null> {
+    (yValue: YType, xValue: XType): string;
+  }
+  interface DetailPopoverFooter<T> {
+    (xValue: T): React.ReactNode;
+  }
+  interface I18nStrings<T> {
+    /** Visible label of the default filter */
+    filterLabel?: string;
+    /** Placeholder text of the default filter */
+    filterPlaceholder?: string;
+    /** ARIA label for the default filter which is appended to any option that is selected */
+    filterSelectedAriaLabel?: string;
+    /** ARIA label that is associated with the legend in case there is no visible `legendTitle` defined */
+    legendAriaLabel?: string;
+    /** ARIA label for details popover dismiss button */
+    detailPopoverDismissAriaLabel?: string;
+    /** Name of the ARIA role description of the chart, e.g. "line chart" */
+    chartAriaRoleDescription?: string;
+    /** Name of the ARIA role description of the x axis, e.g. "x axis" */
+    xAxisAriaRoleDescription?: string;
+    /** Name of the ARIA role description of the y axis, e.g. "y axis" */
+    yAxisAriaRoleDescription?: string;
+    /** @deprecated Use `xTickFormatter` on the component instead. */
+    xTickFormatter?: TickFormatter<T>;
+    /** @deprecated Use `yTickFormatter` on the component instead. */
+    yTickFormatter?: TickFormatter<number>;
+  }
 }
 export type ChartDataTypes = number | string | Date;
 export type ScaleType = 'linear' | 'log' | 'time' | 'categorical';
@@ -207,5 +207,4 @@ export type YScaleType = 'linear' | 'log';
 export type ScaleRange = [number, number];
 export type ChartDomain<T extends ChartDataTypes> = ReadonlyArray<T>;
 export type XDomain<T extends ChartDataTypes> = ChartDomain<T>;
-export type YDomain = ChartDomain<number>;
-//# sourceMappingURL=interfaces.d.ts.map
+export type YDomain = ChartDomain<number>;

package/internal/components/cartesian-chart/label-utils.d.ts

@@ -1,19 +1,23 @@
 import { ChartDataTypes } from './interfaces';
 import { ChartScale, NumericChartScale } from './scales';
 export interface FormattedTick {
-    position: number;
-    space: number;
-    lines: string[];
+  position: number;
+  space: number;
+  lines: string[];
 }
-export declare function formatTicks({ ticks, scale, getLabelSpace, tickFormatter, }: {
-    ticks: readonly ChartDataTypes[];
-    scale: ChartScale | NumericChartScale;
-    getLabelSpace: (label: string) => number;
-    tickFormatter?: (value: any) => string;
+export declare function formatTicks({
+  ticks,
+  scale,
+  getLabelSpace,
+  tickFormatter
+}: {
+  ticks: readonly ChartDataTypes[];
+  scale: ChartScale | NumericChartScale;
+  getLabelSpace: (label: string) => number;
+  tickFormatter?: (value: any) => string;
 }): FormattedTick[];
 export declare function getVisibleTicks(ticks: readonly FormattedTick[], from: number, until: number, balanceTicks?: boolean): readonly FormattedTick[];
 export declare function getSVGTextSize(element: null | SVGTextElement): undefined | {
-    width: number;
-    height: number;
-};
-//# sourceMappingURL=label-utils.d.ts.map
+  width: number;
+  height: number;
+};

package/internal/components/cartesian-chart/labels-measure.d.ts

@@ -2,13 +2,18 @@
 import { ChartDataTypes } from '../../../mixed-line-bar-chart/interfaces';
 import { ChartScale, NumericChartScale } from './scales';
 interface LabelsMeasureProps {
-    scale: ChartScale | NumericChartScale;
-    ticks: readonly ChartDataTypes[];
-    tickFormatter?: (value: ChartDataTypes) => string;
-    autoWidth: (value: number) => void;
-    maxLabelsWidth?: number;
+  scale: ChartScale | NumericChartScale;
+  ticks: readonly ChartDataTypes[];
+  tickFormatter?: (value: ChartDataTypes) => string;
+  autoWidth: (value: number) => void;
+  maxLabelsWidth?: number;
 }
 declare const _default: typeof LabelsMeasure;
 export default _default;
-declare function LabelsMeasure({ scale, ticks, tickFormatter, autoWidth, maxLabelsWidth }: LabelsMeasureProps): JSX.Element;
-//# sourceMappingURL=labels-measure.d.ts.map
+declare function LabelsMeasure({
+  scale,
+  ticks,
+  tickFormatter,
+  autoWidth,
+  maxLabelsWidth
+}: LabelsMeasureProps): JSX.Element;