@cumulus-ui/components 0.1.0

package/dist/multiselect/interfaces.d.ts

@@ -0,0 +1,121 @@
+import { BaseSelectProps } from '../select/interfaces.js';
+import { OptionDefinition, OptionGroup as OptionGroupDefinition } from '../internal/generated/cloudscape-types.js';
+export interface MultiselectProps extends BaseSelectProps {
+    /**
+     * Specifies the currently selected options.
+     * Provide an empty array to clear the selection.
+     */
+    selectedOptions: ReadonlyArray<MultiselectProps.Option>;
+    /**
+     * Specifies an inline label that appears next to the multiselect trigger.
+     */
+    inlineLabelText?: string;
+    /**
+     * Determines whether the dropdown list stays open after the user selects an item.
+     */
+    keepOpen?: boolean;
+    /**
+     * Specifies the maximum number of displayed tokens. If the property isn't set, all of the tokens are displayed.
+     */
+    tokenLimit?: number;
+    /**
+     * Hides the tokens displayed underneath the component.
+     * Only use this if the selected options are displayed elsewhere on the page.
+     */
+    hideTokens?: boolean;
+    /**
+     * Shows tokens inside the trigger instead of below it.
+     */
+    inlineTokens?: boolean;
+    /**
+     * Specifies an `aria-label` for the token deselection button.
+     * @i18n
+     */
+    deselectAriaLabel?: MultiselectProps.DeselectAriaLabelFunction;
+    /**
+     * An object containing all the localized strings required by the component.
+     *
+     * * `selectAllText` (string) - Specifies the text to be displayed next to the checkbox that selects or deselects all options.
+     * * `tokenLimitShowFewer` (string) - Specifies the text to be displayed in the "Show fewer" button for the token group control.
+     * * `tokenLimitShowMore` (string) - Specifies the text to be displayed in the "Show more" button for the token group control. This string should not contain the number of hidden tokens
+     * because this will be added by the component automatically.
+     * @i18n
+     */
+    i18nStrings?: MultiselectProps.I18nStrings;
+    /** @event change — CustomEvent<MultiselectProps.MultiselectChangeDetail> */
+    /**
+     * Automatically focuses the trigger when component is mounted.
+     */
+    autoFocus?: boolean;
+    /**
+     * Adds an aria-label to the "Show fewer" button for the token group control.
+     * Use to assign unique labels when there are multiple token groups with the same `tokenLimitShowFewer` label on one page.
+     */
+    tokenLimitShowFewerAriaLabel?: string;
+    /**
+     * Adds an aria-label to the "Show more" button for the token group control.
+     * Use to assign unique labels when there are multiple token groups with the same `tokenLimitShowMore` label on one page.
+     */
+    tokenLimitShowMoreAriaLabel?: string;
+    /**
+     * Enables users to select and deselect all options with a special extra checkbox which is displayed at the start of the dropdown.
+     */
+    enableSelectAll?: boolean;
+    /**
+     * Specifies a render function to render custom options in the dropdown menu.
+     *
+     */
+    renderOption?: MultiselectProps.MultiselectOptionItemRenderer;
+}
+export declare namespace MultiselectProps {
+    type Option = OptionDefinition;
+    type OptionGroup = OptionGroupDefinition;
+    type Options = ReadonlyArray<Option | OptionGroup>;
+    interface MultiselectOptionItem {
+        type: 'item';
+        index: number;
+        option: Option;
+        disabled: boolean;
+        highlighted: boolean;
+        selected: boolean;
+        parent: MultiselectOptionGroupItem | null;
+    }
+    interface MultiselectOptionGroupItem {
+        type: 'group';
+        index: number;
+        option: OptionGroup;
+        indeterminate: boolean;
+        disabled: boolean;
+        highlighted: boolean;
+        selected: boolean;
+    }
+    interface MultiselectSelectAllItem {
+        type: 'select-all';
+        option: Option;
+        indeterminate: boolean;
+        highlighted: boolean;
+        selected: boolean;
+    }
+    type MultiselectItem = MultiselectOptionItem | MultiselectOptionGroupItem | MultiselectSelectAllItem;
+    type MultiselectOptionItemRenderer = (props: {
+        item: MultiselectItem;
+        filterText?: string;
+    }) => unknown | null;
+    type DeselectAriaLabelFunction = (option: Option) => string;
+    type TriggerVariant = 'placeholder' | 'tokens';
+    interface I18nStrings {
+        selectAllText?: string;
+        tokenLimitShowFewer?: string;
+        tokenLimitShowMore?: string;
+    }
+    interface MultiselectChangeDetail {
+        selectedOptions: ReadonlyArray<Option>;
+    }
+    interface Ref {
+        /**
+         * Sets focus on the element without opening the dropdown or showing a visual focus indicator.
+         */
+        focus(): void;
+    }
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/multiselect/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/multiselect/interfaces.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,WAAW,IAAI,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AACnH,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD;;;OAGG;IACH,eAAe,EAAE,aAAa,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxD;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,gBAAgB,CAAC,yBAAyB,CAAC;IAC/D;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC;IAC3C,4EAA4E;IAC5E;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC;;;OAGG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC,6BAA6B,CAAC;CAC/D;AACD,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,KAAK,MAAM,GAAG,gBAAgB,CAAC;IAC/B,KAAK,WAAW,GAAG,qBAAqB,CAAC;IACzC,KAAK,OAAO,GAAG,aAAa,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;IACnD,UAAU,qBAAqB;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,0BAA0B,GAAG,IAAI,CAAC;KAC3C;IACD,UAAU,0BAA0B;QAClC,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,WAAW,CAAC;QACpB,aAAa,EAAE,OAAO,CAAC;QACvB,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC;KACnB;IACD,UAAU,wBAAwB;QAChC,IAAI,EAAE,YAAY,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,OAAO,CAAC;QACvB,WAAW,EAAE,OAAO,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC;KACnB;IACD,KAAK,eAAe,GAAG,qBAAqB,GAAG,0BAA0B,GAAG,wBAAwB,CAAC;IACrG,KAAK,6BAA6B,GAAG,CAAC,KAAK,EAAE;QAC3C,IAAI,EAAE,eAAe,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,GAAG,IAAI,CAAC;IACrB,KAAK,yBAAyB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5D,KAAK,cAAc,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC/C,UAAU,WAAW;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B;IACD,UAAU,uBAAuB;QAC/B,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;KACxC;IACD,UAAU,GAAG;QACX;;WAEG;QACH,KAAK,IAAI,IAAI,CAAC;KACf;CACF"}

package/dist/navigable-group/interfaces.d.ts

@@ -0,0 +1,26 @@
+export interface NavigableGroupProps {
+    /** @slot default — The children that will be rendered inside the navigation group */
+    /**
+     * A method that should return a unique identifier for a given element.
+     * The element passed will be the first focusable descendent of a child component.
+     */
+    getItemKey: (element: HTMLElement) => string;
+    /**
+     * Determines which arrow keys move focus sequentially within the group:
+     * - `horizontal` - left and right arrow keys
+     * - `vertical` - up and down arrow keys
+     * - `both` - all arrow keys
+     */
+    navigationDirection?: 'horizontal' | 'vertical' | 'both';
+}
+export interface InternalNavigableGroupProps extends NavigableGroupProps {
+}
+export declare namespace NavigableGroupProps {
+    interface Ref {
+        /**
+         * Focuses the first focusable element (or previously focused element) in the navigation group.
+         */
+        focus(): void;
+    }
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/navigable-group/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/navigable-group/interfaces.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,qFAAqF;IACrF;;;OAGG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,CAAC;IAC7C;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;CAC1D;AACD,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;CAAG;AAC3E,MAAM,CAAC,OAAO,WAAW,mBAAmB,CAAC;IAC3C,UAAU,GAAG;QACX;;WAEG;QACH,KAAK,IAAI,IAAI,CAAC;KACf;CACF"}

package/dist/pagination/interfaces.d.ts

@@ -0,0 +1,59 @@
+export interface PaginationProps {
+    /**
+     * Index of the current page. The first page has an index of 1.
+     */
+    currentPageIndex: number;
+    /**
+     * Sets the total number of pages. Only positive integers are allowed.
+     */
+    pagesCount: number;
+    /**
+     * Sets the pagination variant. It can be either default (when setting it to `false`) or open ended (when setting it
+     * to `true`). Default pagination navigates you through the items list. The open-end variant enables you
+     * to lazy-load your items because it always displays three dots before the next page icon. The next page button is
+     * never disabled. When the user clicks on it but there are no more items to show, the
+     * `onNextPageClick` handler is called with `requestedPageAvailable: false` in the event detail.
+     */
+    openEnd?: boolean;
+    /**
+     * If set to `true`, the pagination links will be disabled. Use it, for example, if you want to prevent the user
+     * from changing page before items are loaded.
+     */
+    disabled?: boolean;
+    /**
+     * Adds aria-labels to the pagination buttons:
+     * * `paginationLabel` (string) - Label for the entire pagination group. It allows users to distinguish context
+     * * in cases of multiple pagination components in a page.
+     * * `previousPageLabel` (string) - Previous page button.
+     * * `pageLabel` (number => string) - Individual page button, this function is called for every page number that's rendered.
+     * * `nextPageLabel` (string) - Next page button
+     *
+     * Example:
+     * ```
+     * {
+     *   nextPageLabel: 'Next page',
+     *   paginationLabel: 'Table pagination',
+     *   previousPageLabel: 'Previous page',
+     *   pageLabel: pageNumber => `Page ${pageNumber}`
+     * }
+     * ```
+     * @i18n
+     */
+    ariaLabels?: PaginationProps.Labels;
+}
+export declare namespace PaginationProps {
+    interface Labels {
+        nextPageLabel?: string;
+        paginationLabel?: string;
+        previousPageLabel?: string;
+        pageLabel?: (pageNumber: number) => string;
+    }
+    interface PageClickDetail {
+        requestedPageAvailable: boolean;
+        requestedPageIndex: number;
+    }
+    interface ChangeDetail {
+        currentPageIndex: number;
+    }
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/pagination/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/pagination/interfaces.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC;CAIrC;AACD,MAAM,CAAC,OAAO,WAAW,eAAe,CAAC;IACvC,UAAU,MAAM;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;KAC5C;IACD,UAAU,eAAe;QACvB,sBAAsB,EAAE,OAAO,CAAC;QAChC,kBAAkB,EAAE,MAAM,CAAC;KAC5B;IACD,UAAU,YAAY;QACpB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;CACF"}

package/dist/panel-layout/interfaces.d.ts

@@ -0,0 +1,88 @@
+export interface PanelLayoutProps {
+    /**
+     * Position of the panel with respect to the main content
+     */
+    panelPosition?: PanelLayoutProps.PanelPosition;
+    /**
+     * Initial panel size, for uncontrolled behavior.
+     *
+     * The actual size will be constrained by `minPanelSize` and `maxPanelSize`, if set.
+     */
+    defaultPanelSize?: number;
+    /**
+     * Size of the panel. If provided, and panel is resizable, the component is controlled,
+     * so you must also provide `onPanelResize`.
+     *
+     * The actual size will be constrained by `minPanelSize` and `maxPanelSize`, if set.
+     */
+    panelSize?: number;
+    /**
+     * The minimum size of the panel.
+     */
+    minPanelSize?: number;
+    /**
+     * The maximum size of the panel.
+     */
+    maxPanelSize?: number;
+    /**
+     * Indicates whether the panel is resizable.
+     */
+    resizable?: boolean;
+    /**
+     * Panel contents.
+     */
+    panelContent: unknown;
+    /**
+     * Main content area displayed next to the panel.
+     */
+    mainContent: unknown;
+    /**
+     * Makes the panel content focusable. This should be used if there are no focusable elements
+     * inside the panel, to ensure it is keyboard scrollable.
+     *
+     * Provide either `{ariaLabel: "Panel label"}` or `{ariaLabelledby: "panel-label-id"}`
+     */
+    panelFocusable?: PanelLayoutProps.FocusableConfig;
+    /**
+     * Makes the main content area focusable. This should be used if there are no focusable elements
+     * inside the content, to ensure it is keyboard scrollable.
+     *
+     * Provide either `{ariaLabel: "Main label"}` or `{ariaLabelledby: "main-label-id"}`
+     */
+    mainFocusable?: PanelLayoutProps.FocusableConfig;
+    /**
+     * Determines which content is displayed:
+     * - 'all': Both panel and main content are displayed.
+     * - 'panel-only': Only panel is displayed.
+     * - 'main-only': Only main content is displayed.
+     */
+    display?: PanelLayoutProps.Display;
+    /**
+     * An object containing all the necessary localized strings required by the component.
+     * @i18n
+     */
+    i18nStrings?: PanelLayoutProps.I18nStrings;
+}
+export declare namespace PanelLayoutProps {
+    type PanelPosition = 'side-start' | 'side-end';
+    type Display = 'all' | 'panel-only' | 'main-only';
+    interface PanelResizeDetail {
+        totalSize: number;
+        panelSize: number;
+    }
+    interface FocusableConfig {
+        ariaLabel?: string;
+        ariaLabelledby?: string;
+    }
+    interface I18nStrings {
+        resizeHandleAriaLabel?: string;
+        resizeHandleTooltipText?: string;
+    }
+    interface Ref {
+        /**
+         * Focuses the resize handle of the panel layout.
+         */
+        focusResizeHandle(): void;
+    }
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/panel-layout/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/panel-layout/interfaces.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,aAAa,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC;IAC/C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC;IAClD;;;;;OAKG;IACH,aAAa,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC;IACjD;;;;;OAKG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC;CAG5C;AACD,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,KAAK,aAAa,GAAG,YAAY,GAAG,UAAU,CAAC;IAC/C,KAAK,OAAO,GAAG,KAAK,GAAG,YAAY,GAAG,WAAW,CAAC;IAClD,UAAU,iBAAiB;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB;IACD,UAAU,eAAe;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;IACD,UAAU,WAAW;QACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;KAClC;IACD,UAAU,GAAG;QACX;;WAEG;QACH,iBAAiB,IAAI,IAAI,CAAC;KAC3B;CACF"}

package/dist/pie-chart/interfaces.d.ts

@@ -0,0 +1,209 @@
+import { PopoverProps } from '../popover/interfaces.js';
+export interface SeriesInfo {
+    label: string;
+    color: string;
+    index: number;
+    markerType: 'line' | 'rectangle';
+}
+interface ChartDetailPair {
+    key: unknown;
+    value: unknown;
+}
+export interface PieChartProps<T extends PieChartProps.Datum = PieChartProps.Datum> {
+    /**
+     * An array that represents the source of data for the displayed segments.
+     * Each element can have the following properties:
+     *
+     * * `title` (string) - A human-readable title for this data point.
+     * * `value` (number) - Numeric value that determines the segment size.
+     *                        A segment with a value of zero (0) or lower (negative number) won't have a segment.
+     * * `color`: (string) - (Optional) Color value for this segment that takes priority over the automatically assigned color.
+     *                        Can be any valid CSS color identifier.
+     *
+     * As long as your data object implements the properties above, you can also define additional properties
+     * that are relevant to your data visualization.
+     * The full data object will be passed down to events and properties like `detailPopoverContent`.
+     */
+    data: ReadonlyArray<T>;
+    /**
+     * Specifies the size of the pie or donut chart.
+     * When used with `fitHeight`, this property defines the minimum size of the chart area.
+     */
+    size?: 'small' | 'medium' | 'large';
+    /**
+     * Visual variant of the pie chart. Currently supports the default `pie` variant and the `donut` variant.
+     * The donut variant provides a slot in the center of the chart that can contain additional information.
+     * For more information, see `innerContent`.
+     */
+    variant?: 'pie' | 'donut';
+    /**
+     * A function that determines the details that are displayed in the popover when hovering over a segment.
+     * The function is called with the data of the target segment and is expected to return an array of detail pairs.
+     * By default, each segment displays two detail pairs: count and percentage.
+     *
+     * Each pair has the following properties:
+     * * `key` (unknown) - Name of the detail or metric.
+     * * `value` (unknown) - The value of this detail for the target segment.
+     */
+    detailPopoverContent?: PieChartProps.DetailPopoverContentFunction<T>;
+    /**
+     * Additional content that is displayed at the bottom of the detail popover.
+     */
+    detailPopoverFooter?: PieChartProps.DetailPopoverFooter<T>;
+    /**
+     * A function that determines the description of a segment that is displayed on the chart, unless `hideDescriptions` is set to `true`.
+     * This is an optional description that explains the segment and is displayed underneath the label.
+     * The function is called with the data object of each segment and is expected to return the description as a string.
+     */
+    segmentDescription?: PieChartProps.SegmentDescriptionFunction<T>;
+    /**
+     * Determines the maximum width of the popover.
+     */
+    detailPopoverSize?: PopoverProps.Size;
+    /**
+     * Hides legend beneath the chart when set to `true`.
+     * We highly recommend that you leave this unspecified or set to `false`.
+     */
+    hideLegend?: boolean;
+    /**
+     * Hides label titles next to the chart segments when set to `true`.
+     * We highly recommend that you leave this unspecified or set to `false`.
+     */
+    hideTitles?: boolean;
+    /**
+     * Hides the label descriptions next to the chart segments when set to `true`.
+     */
+    hideDescriptions?: boolean;
+    /**
+     * Hides the default filtering dropdown when set to `true`.
+     * You can still display additional filters with the `additionalFilters` slot.
+     */
+    hideFilter?: boolean;
+    /**
+     * Additional metric number that's displayed in the center of the chart if `variant` is set to `donut`.
+     */
+    innerMetricValue?: string;
+    /**
+     * Additional description that's displayed in the center of the chart below `innerMetricValue` if `variant` is set to `donut`.
+     * This is usually the unit of the `innerMetricValue`.
+     */
+    innerMetricDescription?: string;
+    /**
+     * Title for the legend.
+     */
+    legendTitle?: string;
+    /** @slot additionalFilters — Additional filters that you can add above the chart component */
+    /**
+     * Specifies the currently highlighted data segment. Highlighting is typically the result of
+     * a user hovering over or selecting a segment in the chart or the legend.
+     * A value of `null` means no segment is being highlighted.
+     *
+     * - If you don't set this property, segments are highlighted automatically when a user hovers over or selects one of the triggers (that is, uncontrolled behavior).
+     * - If you explicitly set this property, you must set an `onHighlightChange` listener to update this property when a segment should be highlighted (that is, controlled behavior).
+     */
+    highlightedSegment?: T | null;
+    /**
+     * An array of data segment objects that determines which data segments are currently visible (that is, not filtered out).
+     *
+     * - If you don't set this property, segments are filtered automatically when using the default filtering of the component (that is, uncontrolled behavior).
+     * - If you explicitly set this property, you must set an `onFilterChange` listener to update this property when the list of filtered segments changes (that is, controlled behavior).
+     */
+    visibleSegments?: ReadonlyArray<T>;
+    /**
+     * Specifies the current status of loading data.
+     * * `loading` - Indicates that data fetching is in progress.
+     * * `finished` - Indicates that data has loaded successfully.
+     * * `error` - Indicates that an error occurred during fetch. You should provide an option to enable the user to recover.
+     **/
+    statusType?: 'loading' | 'finished' | 'error';
+    /** @slot empty — Content that's displayed when the data passed to the component is empty */
+    /** @slot noMatch — Content that's displayed when there is no data to display because it doesn't match the specified filter */
+    /**
+     * Text that's displayed when the chart is loading (that is, when `statusType` is set to `loading`).
+     * @i18n
+     */
+    loadingText?: string;
+    /**
+     * Text that's displayed when the chart is in error state (that is, when `statusType` is set to `error`).
+     * @i18n
+     */
+    errorText?: string;
+    /**
+     * Text for the recovery button that's displayed next to the error text.
+     * @i18n
+     **/
+    recoveryText?: string;
+    /** @event recoveryClick — CustomEvent<void> */
+    /** @event highlightChange — CustomEvent<PieChartProps.HighlightChangeDetail<T>> */
+    /** @event filterChange — CustomEvent<PieChartProps.FilterChangeDetail<T>> */
+    /**
+     * ARIA label that's assigned to the chart. It should match the visible label on the page
+     * (for example, in the container header). Use either `ariaLabel` or `ariaLabelledby` (you can't use both).
+     */
+    ariaLabel?: string;
+    /**
+     * Sets `aria-labelledby` on the chart. If there is a visible label for the chart on the page
+     * (for example, in the container header), set this property to the ID of that header element.
+     * Use either `ariaLabel` or `ariaLabelledby` (you can't use both).
+     */
+    ariaLabelledby?: string;
+    /**
+     * A description of the chart that assistive technologies can use (through `aria-describedby` and `<title>`).
+     * Provide a concise summary of the data visualized in the chart.
+     */
+    ariaDescription?: string;
+    /**
+     * An object that contains all of the localized strings required by the component.
+     * @i18n
+     */
+    i18nStrings?: PieChartProps.I18nStrings;
+    /**
+     * Enable this property to make the chart fit into the available height of the parent container.
+     */
+    fitHeight?: boolean;
+}
+export declare namespace PieChartProps {
+    interface Datum {
+        title: string;
+        value: number;
+        color?: string;
+    }
+    type PieChartData = ReadonlyArray<Datum>;
+    interface DetailPopoverContentFunction<T = Datum> {
+        (segment: T, visibleDataSum: number): ReadonlyArray<ChartDetailPair>;
+    }
+    interface DetailPopoverFooter<T> {
+        (segment: T): unknown;
+    }
+    interface SegmentDescriptionFunction<T = Datum> {
+        (segment: T, visibleDataSum: number): string;
+    }
+    interface HighlightChangeDetail<T> {
+        highlightedSegment: T | null;
+    }
+    interface FilterChangeDetail<T> {
+        visibleSegments: ReadonlyArray<T>;
+    }
+    interface I18nStrings {
+        /** Name of the "Value" key that is displayed in the details popover by default */
+        detailsValue?: string;
+        /** Name of the "Percentage" key that is displayed in the details popover by default */
+        detailsPercentage?: string;
+        /** 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. "pie chart" */
+        chartAriaRoleDescription?: string;
+        /** Name of the ARIA role description of each segment, e.g. "segment" */
+        segmentAriaRoleDescription?: string;
+    }
+}
+export {};
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/pie-chart/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/pie-chart/interfaces.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;CAClC;AACD,UAAU,eAAe;IACvB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AACD,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,aAAa,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK;IAChF;;;;;;;;;;;;;OAaG;IACH,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;IAC1B;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,aAAa,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC;IACrE;;OAEG;IACH,mBAAmB,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC3D;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,aAAa,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;IACjE;;OAEG;IACH,iBAAiB,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC;IACtC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACnC;;;;;QAKI;IACJ,UAAU,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IAC9C,4FAA4F;IAC5F,8HAA8H;IAC9H;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;QAGI;IACJ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,mFAAmF;IACnF,6EAA6E;IAC7E;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC;IACxC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AACD,MAAM,CAAC,OAAO,WAAW,aAAa,CAAC;IACrC,UAAU,KAAK;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;IACD,KAAK,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACzC,UAAU,4BAA4B,CAAC,CAAC,GAAG,KAAK;QAC9C,CAAC,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;KACtE;IACD,UAAU,mBAAmB,CAAC,CAAC;QAC7B,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;KACvB;IACD,UAAU,0BAA0B,CAAC,CAAC,GAAG,KAAK;QAC5C,CAAC,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;KAC9C;IACD,UAAU,qBAAqB,CAAC,CAAC;QAC/B,kBAAkB,EAAE,CAAC,GAAG,IAAI,CAAC;KAC9B;IACD,UAAU,kBAAkB,CAAC,CAAC;QAC5B,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;KACnC;IACD,UAAU,WAAW;QACnB,kFAAkF;QAClF,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,uFAAuF;QACvF,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,0CAA0C;QAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,6CAA6C;QAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,yFAAyF;QACzF,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,sGAAsG;QACtG,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,oDAAoD;QACpD,6BAA6B,CAAC,EAAE,MAAM,CAAC;QACvC,uEAAuE;QACvE,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,wEAAwE;QACxE,0BAA0B,CAAC,EAAE,MAAM,CAAC;KACrC;CACF;AACD,OAAO,EAAE,CAAC"}

package/dist/popover/interfaces.d.ts

@@ -0,0 +1,92 @@
+export interface PopoverProps {
+    /**
+     * Determines where the popover is displayed when opened, relative to the trigger.
+     * If the popover doesn't have enough space to open in this direction, it
+     * automatically chooses a better direction based on available space.
+     */
+    position?: PopoverProps.Position;
+    /**
+     * Determines the maximum width for the popover.
+     */
+    size?: PopoverProps.Size;
+    /**
+     * Expands the popover body to its maximum width regardless of content.
+     * For example, use it when you need to place a column layout in the popover content.
+     */
+    fixedWidth?: boolean;
+    /**
+     * Specifies the type of content inside the trigger region. The following types are available:
+     * - `text` - Use for triggers containing inline components, like status indicator.
+     * - `text-inline` - Use for triggers containing plain text only.
+     * - `custom` - Use for the [button](/components/button/) component.
+     */
+    triggerType?: PopoverProps.TriggerType;
+    /**
+     * Adds `aria-label` to the text trigger button. Use this to provide an accessible name for triggers
+     * that don't have visible text, and to distinguish between multiple triggers with identical visible text.
+     */
+    triggerAriaLabel?: string;
+    /**
+     * Specifies if the text trigger content should wrap. If you set it to false, it prevents the text from
+     * wrapping and truncates it with an ellipsis.
+     */
+    wrapTriggerText?: boolean;
+    /** @slot default — Element that triggers the popover when selected by the user */
+    /**
+     * Specifies optional header text for the popover.
+     */
+    header?: string;
+    /** @slot content — Content of the popover */
+    /**
+     * Determines whether the dismiss button is shown in the popover body.
+     */
+    dismissButton?: boolean;
+    /**
+     * Adds an `aria-label` to the dismiss button for accessibility.
+     * @i18n
+     */
+    dismissAriaLabel?: string;
+    /**
+     * By default, the popover is constrained to fit inside its parent
+     * [stacking context](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Positioning/Understanding_z_index/The_stacking_context).
+     * Enabling this property will allow the popover to be rendered in the root stack context using
+     * [React Portals](https://reactjs.org/docs/portals.html).
+     * Enable this setting if you need the popover to ignore its parent stacking context, such as in side navigation.
+     *
+     * Note: Using popover rendered with portal within a Modal is not supported.
+     */
+    renderWithPortal?: boolean;
+}
+/**
+ * The position the popover is actually in, given space constraints.
+ */
+export type InternalPosition = 'right-top' | 'right-bottom' | 'left-top' | 'left-bottom' | 'top-center' | 'top-right' | 'top-left' | 'bottom-center' | 'bottom-right' | 'bottom-left';
+export interface Offset {
+    insetInlineStart: number;
+    insetBlockStart: number;
+}
+export interface Dimensions {
+    inlineSize: number;
+    blockSize: number;
+}
+export type BoundingBox = Dimensions & Offset;
+export type Rect = BoundingBox & {
+    insetBlockEnd: number;
+    insetInlineEnd: number;
+};
+export declare namespace PopoverProps {
+    type Position = 'top' | 'right' | 'bottom' | 'left';
+    type Size = 'small' | 'medium' | 'large';
+    type TriggerType = 'text' | 'text-inline' | 'custom';
+    interface Ref {
+        /**
+         * Sets focus on the popover's trigger and dismisses the popover if open.
+         */
+        focus(): void;
+        /**
+         * Dismisses the popover without focusing the trigger. Use only if an element other than the trigger needs to be focused after dismissing the popover.
+         */
+        dismiss(): void;
+    }
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/popover/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/popover/interfaces.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kFAAkF;IAClF;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AACD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,CAAC;AACtL,MAAM,WAAW,MAAM;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;AAC9C,MAAM,MAAM,IAAI,GAAG,WAAW,GAAG;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AACF,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,KAAK,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpD,KAAK,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzC,KAAK,WAAW,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC;IACrD,UAAU,GAAG;QACX;;WAEG;QACH,KAAK,IAAI,IAAI,CAAC;QACd;;WAEG;QACH,OAAO,IAAI,IAAI,CAAC;KACjB;CACF"}