@ember-eui/core 14.0.0 → 14.1.0

package/declarations/components/eui-badge.d.ts

@@ -4,17 +4,58 @@ import type { TemplateOnlyComponent } from '@ember/component/template-only';
 export interface EuiBadgeSignature {
     Element: HTMLButtonElement | HTMLAnchorElement | HTMLSpanElement;
     Args: {
+        /**
+         * `'default'`, `'hollow'`, `'primary'`, `'success'`, `'accent'`,
+         * `'warning'`, `'danger'` or any hex color (`'#DA8B45'`); the text color
+         * is picked for contrast. Defaults to `'default'`.
+         */
         color?: keyof typeof colorMapping | EuiBadgeColorType | string;
+        /**
+         * Icon shown in the badge, anything `EuiIcon`'s `@type` accepts.
+         */
         iconType?: EuiIconSignature['Args']['type'];
+        /**
+         * Side of the text the icon is on. Defaults to `'left'`.
+         */
         iconSide?: 'left' | 'right';
+        /**
+         * Makes the icon a separate button calling this function, e.g. an "x" to
+         * remove the badge. Requires `@iconType` and `@iconOnClickAriaLabel`.
+         */
         iconOnClick?: () => void;
+        /**
+         * Accessible label (and hover title) of the `@iconOnClick` button.
+         */
         iconOnClickAriaLabel?: string;
+        /**
+         * @deprecated Has no effect, see `EuiIcon`.
+         */
         iconUseSvg?: boolean;
+        /**
+         * Disables the badge's buttons and links and greys it out.
+         */
         isDisabled?: boolean;
+        /**
+         * Makes the badge (or its text, when it has an `@iconType`) a button
+         * calling this function.
+         */
         onClick?: () => void;
+        /**
+         * Accessible label of the `@onClick` button, when the text alone does not
+         * describe the action.
+         */
         onClickAriaLabel?: string;
+        /**
+         * Makes the badge (or its text, when it has an `@iconType`) a link.
+         */
         href?: string;
+        /**
+         * `target` of the `@href` link, e.g. `'_blank'`.
+         */
         target?: string;
+        /**
+         * Extra props for the `@iconOnClick` button.
+         */
         closeButtonProps?: {
             tabIndex?: number;
             dataSelectedIconIndex?: number;
@@ -22,6 +63,7 @@ export interface EuiBadgeSignature {
         };
     };
     Blocks: {
+        /** The badge's text. */
         default: [];
     };
 }

package/declarations/components/eui-badge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eui-badge.d.ts","sourceRoot":"","sources":["../../src/components/eui-badge.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EAClB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,CAAC;IACjE,IAAI,EAAE;QACJ,KAAK,CAAC,EAAE,MAAM,OAAO,YAAY,GAAG,iBAAiB,GAAG,MAAM,CAAC;QAC/D,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;QACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE;YACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,qBAAqB,CAAC,EAAE,MAAM,CAAC;YAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED,QAAA,MAAM,QAAQ,EAAE,qBAAqB,CAAC,iBAAiB,CAkKrD,CAAC;AAEH,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"eui-badge.d.ts","sourceRoot":"","sources":["../../src/components/eui-badge.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EAClB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,CAAC;IACjE,IAAI,EAAE;QACJ;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,OAAO,YAAY,GAAG,iBAAiB,GAAG,MAAM,CAAC;QAC/D;;WAEG;QACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAC5B;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;QACzB;;WAEG;QACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B;;WAEG;QACH,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB;;WAEG;QACH,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QACrB;;;WAGG;QACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;WAEG;QACH,gBAAgB,CAAC,EAAE;YACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,qBAAqB,CAAC,EAAE,MAAM,CAAC;YAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QACN,wBAAwB;QACxB,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED,QAAA,MAAM,QAAQ,EAAE,qBAAqB,CAAC,iBAAiB,CAmKrD,CAAC;AAEH,eAAe,QAAQ,CAAC"}

package/declarations/components/eui-beacon.d.ts

@@ -0,0 +1,15 @@
+import type { TemplateOnlyComponent } from '@ember/component/template-only';
+/**
+ * A pulsing dot that draws attention to something new, e.g. next to a
+ * feature a tour points at.
+ */
+export interface EuiBeaconSignature {
+    Element: HTMLDivElement;
+    Args: {
+        /** Diameter of the center dot in px. Defaults to `12`. */
+        size?: number;
+    };
+}
+declare const EuiBeacon: TemplateOnlyComponent<EuiBeaconSignature>;
+export default EuiBeacon;
+//# sourceMappingURL=eui-beacon.d.ts.map

package/declarations/components/eui-beacon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eui-beacon.d.ts","sourceRoot":"","sources":["../../src/components/eui-beacon.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE;QACJ,0DAA0D;QAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,QAAA,MAAM,SAAS,EAAE,qBAAqB,CAAC,kBAAkB,CAavD,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/declarations/components/eui-beta-badge.d.ts

@@ -6,55 +6,61 @@ export interface EuiBetaBadgeSignature {
     Element: HTMLSpanElement;
     Args: {
         /**
-         * The label to use for the beta badge. Usually a single letter.
+         * The badge's text, e.g. `'Beta'`, or a single letter (rendered as a
+         * circle). Also its hover title. The default block replaces it.
          */
         label?: string;
         /**
-         * The title to use for the beta badge. Usually a full word.
+         * Hover title when there is no `@label` (e.g. with `@iconType`), and the
+         * title of the `@tooltipContent` tooltip.
          */
         title?: string;
         /**
-         * The icon to use for the beta badge.
+         * Renders an icon instead of `@label` (icon-only badge). Give it a
+         * `@title` so it has a name.
          */
         iconType?: EuiIconSignature['Args']['type'];
         /**
-         * The color of the beta badge.
+         * `'hollow'`, `'accent'` or `'subdued'`. Defaults to `'hollow'`.
          */
         color?: keyof typeof colorMapping;
         /**
-         * The size of the beta badge.
+         * `'s'` or `'m'`. Defaults to `'m'`.
          */
         size?: keyof typeof sizeMapping;
         /**
-         * The position of the tooltip for the beta badge.
+         * Where the `@tooltipContent` tooltip appears: `'top'`, `'right'`,
+         * `'bottom'` or `'left'`. Defaults to `'top'`.
          */
         tooltipPosition?: EuiToolTipSignature['Args']['position'];
         /**
-         * The content of the tooltip for the beta badge.
+         * Shows a tooltip with this text on hover, e.g. what "Beta" means here.
          */
         tooltipContent?: string;
         /**
-         * The aria-label for the beta badge.
+         * Accessible label of the badge when it is a link or button
+         * (`@href` / `@onClick`).
          */
         onClickAriaLabel?: string;
         /**
-         * The href for the beta badge.
+         * Makes the badge a link.
          */
         href?: string;
         /**
-         * The target for the beta badge.
+         * `target` of the `@href` link, e.g. `'_blank'`.
          */
         target?: string;
         /**
-         * The rel for the beta badge.
+         * `rel` of the `@href` link, e.g. `'noopener'`.
          */
         rel?: string;
         /**
-         * The action to call when the beta badge is clicked.
+         * Makes the badge a button calling this function.
          */
         onClick?: (event: MouseEvent) => void;
     };
     Blocks: {
+        /** Custom content instead of `@label` / `@iconType`. */
         default: [];
     };
 }

package/declarations/components/eui-beta-badge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eui-beta-badge.d.ts","sourceRoot":"","sources":["../../src/components/eui-beta-badge.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE;QACJ;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;WAEG;QACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,OAAO,YAAY,CAAC;QAElC;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,OAAO,WAAW,CAAC;QAChC;;WAEG;QACH,eAAe,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QAC1D;;WAEG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB;;WAEG;QACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QACb;;WAEG;QACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;KACvC,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED,QAAA,MAAM,YAAY,EAAE,qBAAqB,CAAC,qBAAqB,CAoM7D,CAAC;AAEH,eAAe,YAAY,CAAC"}
+{"version":3,"file":"eui-beta-badge.d.ts","sourceRoot":"","sources":["../../src/components/eui-beta-badge.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE;QACJ;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;;WAGG;QACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,OAAO,YAAY,CAAC;QAElC;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,OAAO,WAAW,CAAC;QAChC;;;WAGG;QACH,eAAe,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QAC1D;;WAEG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB;;;WAGG;QACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QACb;;WAEG;QACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;KACvC,CAAC;IACF,MAAM,EAAE;QACN,wDAAwD;QACxD,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED,QAAA,MAAM,YAAY,EAAE,qBAAqB,CAAC,qBAAqB,CAoM7D,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/declarations/components/eui-bottom-bar.d.ts

@@ -1,21 +1,61 @@
 import GlimmerComponent from '@glimmer/component';
 import { htmlSafe } from '@ember/template';
 export interface EuiButtomBarArgs {
+    /**
+     * With `@position="fixed"`, pads the bottom of `<body>` by the bar's height
+     * so it does not cover the end of the page. Defaults to `true`.
+     */
     affordForDisplacement?: boolean;
+    /**
+     * Class added to `<body>` while the bar is rendered.
+     */
     bodyClassName?: string;
+    /**
+     * `'fixed'` renders the bar in a portal, fixed to the bottom of the
+     * window. `'sticky'` keeps it at the bottom of its scrolling container,
+     * `'static'` renders it in place. Defaults to `'fixed'`.
+     */
     position?: 'fixed' | 'static' | 'sticky';
+    /**
+     * @deprecated Has no effect: the bar uses a portal when `@position` is
+     * `'fixed'`.
+     */
     usePortal?: boolean;
+    /**
+     * Padding inside the bar: `'none'`, `'s'`, `'m'` or `'l'`.
+     * Defaults to `'m'`.
+     */
     paddingSize?: 'none' | 's' | 'm' | 'l';
+    /**
+     * Accessible name of the bar's region landmark (announced to screen
+     * readers). Defaults to "Page level controls". With `@position="fixed"`,
+     * screen readers are also told the bar appeared at the end of the page.
+     */
     landmarkHeading?: string;
+    /**
+     * Distance from the top in px (only for `'sticky'` / `'static'`).
+     * Defaults to `0`.
+     */
     top?: number;
+    /**
+     * Distance from the right edge in px. Defaults to `0`.
+     */
     right?: number;
+    /**
+     * Distance from the left edge in px, e.g. the width of a side nav.
+     * Defaults to `0`.
+     */
     left?: number;
+    /**
+     * Distance from the bottom in px. Defaults to `0`.
+     */
     bottom?: number;
 }
 export interface EuiBottomBarSignature {
     Element: HTMLElement;
     Args: EuiButtomBarArgs;
     Blocks: {
+        /** The bar's content, usually buttons in an EuiFlexGroup. */
         default: [];
     };
 }

package/declarations/components/eui-bottom-bar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eui-bottom-bar.d.ts","sourceRoot":"","sources":["../../src/components/eui-bottom-bar.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAW3C,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoCD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE;QAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,gBAAgB,CAAC,qBAAqB,CAAC;IAC/E,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAEnE,IAAI,qBAAqB,IAAI,OAAO,CAInC;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,eAAe,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAUjD;CA8DF"}
+{"version":3,"file":"eui-bottom-bar.d.ts","sourceRoot":"","sources":["../../src/components/eui-bottom-bar.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAW3C,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACvC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoCD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE;QACN,6DAA6D;QAC7D,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,gBAAgB,CAAC,qBAAqB,CAAC;IAC/E,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAEnE,IAAI,qBAAqB,IAAI,OAAO,CAInC;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,eAAe,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAUjD;CAwEF"}

package/declarations/components/eui-breadcrumbs.d.ts

@@ -9,41 +9,62 @@ export type EuiBreadcrumb = {
      * Visible label of the breadcrumb
      */
     text: string;
+    /**
+     * Makes the breadcrumb a link.
+     */
     href?: string;
+    /**
+     * Makes the breadcrumb clickable, e.g. to transition with the router.
+     */
     onClick?: (e: MouseEvent) => void;
+    /**
+     * Class for the breadcrumb's text element.
+     */
     className?: string;
     /**
      * Force a max-width on the breadcrumb text
      */
     truncate?: boolean;
+    /**
+     * Set internally on the "…" item holding collapsed breadcrumbs.
+     */
     ellipsis?: boolean;
+    /**
+     * `EuiLink` color of a clickable breadcrumb. Defaults to `'subdued'`, and
+     * `'text'` for the last one.
+     */
     color?: string;
-    'aria-current': string;
+    /**
+     * Set internally; the last breadcrumb gets `aria-current="page"`.
+     */
+    'aria-current'?: string;
 };
 interface EuiBreadcrumbsComponentArgs {
     /**
-     * Hides extra (above the max) breadcrumbs under a collapsed item as the window gets smaller.
-     * Pass a custom #EuiBreadcrumbResponsiveMaxCount object to change the number of breadcrumbs to show at the particular breakpoints.
-     *
-     * Pass `false` to turn this behavior off.
-     *
-     * Default: `{ xs: 1, s: 2, m: 4 }`
+     * Shows fewer breadcrumbs on smaller screens, collapsing the ones in the
+     * middle into a "…" popover. `true` uses `{ xs: 1, s: 2, m: 4 }` (at most
+     * 1 breadcrumb on extra small screens, 2 on small, 4 on medium); pass an
+     * object with any of the `xs`, `s`, `m`, `l`, `xl` keys for your own
+     * limits (a missing key falls back to `@max`). Never shows more than
+     * `@max`. Defaults to off.
      */
     responsive?: boolean | EuiBreadcrumbResponsiveMaxCount;
     /**
      * Forces all breadcrumbs to single line and
      * truncates each breadcrumb to a particular width,
-     * except for the last item
+     * except for the last item. Defaults to `true`.
      */
     truncate?: boolean;
     /**
-     * Collapses the inner items past the maximum set here
-     * into a single ellipses item.
-     * Omitting or passing a `0` value will show all breadcrumbs.
+     * Collapses the breadcrumbs in the middle past this number into a single
+     * "…" item that opens a popover with them. Defaults to `5`; pass `0` or
+     * `null` to always show all breadcrumbs.
      */
     max?: number | null;
     /**
-     * The array of individual #EuiBreadcrumb items
+     * The breadcrumbs, from the root to the current page:
+     * `[{ text: 'Home', href: '/' }, { text: 'Users', onClick: … }, { text: 'Jane' }]`.
+     * The last one is the current page.
      */
     breadcrumbs: EuiBreadcrumb[];
 }

package/declarations/components/eui-breadcrumbs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eui-breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/components/eui-breadcrumbs.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAM3C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAetC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,+BAA+B,GAAG;KAK3C,GAAG,IAAI,iBAAiB,CAAC,CAAC,EAAE,MAAM;CACpC,CAAC;AAQF,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IAElC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAmEF,UAAU,2BAA2B;IACnC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,+BAA+B,CAAC;IAEvD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,2BAA2B,CAAC;IAClC,MAAM,EAAE;QAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,SAAS,CAAC,uBAAuB,CAAC;IACnE,iBAAiB,gCAAC;gBAEf,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B;IAO3D,4BAA4B,aAQ1B;IAEF,IAAI,gBAAgB,oCAInB;IAED,IAAI,GAAG,kBAMN;IAED,IAAI,QAAQ,YAEX;IAED,IAAI,aAAa,IAAI,2BAA2B,CAAC,KAAK,CAAC,CAqBtD;IAED,IACI,kBAAkB;;;MASrB;CA6HF"}
+{"version":3,"file":"eui-breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/components/eui-breadcrumbs.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAM3C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAetC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,+BAA+B,GAAG;KAK3C,GAAG,IAAI,iBAAiB,CAAC,CAAC,EAAE,MAAM;CACpC,CAAC;AAQF,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IAElC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAmEF,UAAU,2BAA2B;IACnC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,+BAA+B,CAAC;IAEvD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;;;OAIG;IACH,WAAW,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,2BAA2B,CAAC;IAClC,MAAM,EAAE;QAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,SAAS,CAAC,uBAAuB,CAAC;IACnE,iBAAiB,gCAAC;gBAEf,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B;IAO3D,4BAA4B,aAQ1B;IAEF,IAAI,gBAAgB,oCAInB;IAED,IAAI,GAAG,kBAMN;IAED,IAAI,QAAQ,YAEX;IAED,IAAI,aAAa,IAAI,2BAA2B,CAAC,KAAK,CAAC,CAqBtD;IAED,IACI,kBAAkB;;;MASrB;CA6HF"}

package/declarations/components/eui-button-content.d.ts

@@ -3,16 +3,25 @@ import type { TemplateOnlyComponent } from '@ember/component/template-only';
 export interface EuiButtonContentSignature {
     Element: HTMLSpanElement;
     Args: {
+        /** `'right'` puts the icon after the text. Defaults to the left side. */
         iconSide?: 'right';
+        /** Replaces the icon with a loading spinner. */
         isLoading?: boolean;
+        /** Icon before (or after) the text; anything `EuiIcon`'s `@type` accepts. */
         iconType?: EuiIconSignature['Args']['type'];
+        /** Size of the icon (and spinner). Defaults to `'m'`. */
         iconSize?: EuiIconSignature['Args']['size'];
+        /** Extra classes for the icon. */
         iconClasses?: string;
+        /** @deprecated Has no effect, see `EuiIcon`. */
         useSvg?: boolean;
+        /** @deprecated Not needed: a component passed as `@iconType` is rendered. */
         useComponent?: boolean;
+        /** Classes for the element wrapping the text. */
         textClasses?: string;
     };
     Blocks: {
+        /** The button's text. */
         default: [];
     };
 }

package/declarations/components/eui-button-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eui-button-content.d.ts","sourceRoot":"","sources":["../../src/components/eui-button-content.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE;QACJ,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED,QAAA,MAAM,gBAAgB,EAAE,qBAAqB,CAAC,yBAAyB,CAiCrE,CAAC;AAEH,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"eui-button-content.d.ts","sourceRoot":"","sources":["../../src/components/eui-button-content.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE;QACJ,yEAAyE;QACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,gDAAgD;QAChD,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,6EAA6E;QAC7E,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C,yDAAyD;QACzD,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C,kCAAkC;QAClC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gDAAgD;QAChD,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,6EAA6E;QAC7E,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,iDAAiD;QACjD,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,MAAM,EAAE;QACN,yBAAyB;QACzB,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED,QAAA,MAAM,gBAAgB,EAAE,qBAAqB,CAAC,yBAAyB,CAiCrE,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/declarations/components/eui-button-empty.d.ts

@@ -5,26 +5,57 @@ import type { TemplateOnlyComponent } from '@ember/component/template-only';
 export interface EuiButtonEmptySignature {
     Element: HTMLAnchorElement | HTMLButtonElement;
     Args: {
+        /** Shows a spinner instead of the icon and disables the button. */
         isLoading?: boolean;
+        /** `'xs'`, `'s'` or `'m'`. Defaults to `'m'`. */
         size?: keyof typeof sizeMapping;
+        /** Size of the icon. Defaults to `'m'` (`'s'` for `@size="xs"`). */
         iconSize?: EuiButtonContentSignature['Args']['iconSize'];
+        /**
+         * `'primary'`, `'danger'`, `'text'`, `'ghost'`, `'warning'` or
+         * `'success'`. Defaults to `'primary'`.
+         */
         color?: keyof typeof colorMapping;
+        /** Icon next to the text; anything `EuiIcon`'s `@type` accepts. */
         iconType?: EuiIconSignature['Args']['type'];
+        /** `'right'` puts the icon after the text. Defaults to the left side. */
         iconSide?: EuiButtonContentSignature['Args']['iconSide'];
+        /** Extra classes for the icon. */
         iconClasses?: string;
+        /** Classes for the element wrapping the text. */
         textClasses?: string;
+        /** Classes for the element wrapping the icon and text. */
         contentClasses?: string;
+        /**
+         * Removes the padding on `'left'`, `'right'` or `'both'` sides, to align
+         * the text with content above or below it.
+         */
         flush?: keyof typeof flushMapping;
+        /**
+         * Renders an `<a>` link instead of a `<button>` (a disabled or loading
+         * button stays a `<button>`).
+         */
         href?: string;
+        /** `target` of the `@href` link, e.g. `'_blank'`. */
         target?: string;
+        /** Disables the button and greys it out. */
         isDisabled?: boolean;
+        /** @deprecated Has no effect, see `EuiIcon`. */
         useSvg?: boolean;
+        /** @deprecated Not needed: a component passed as `@iconType` is rendered. */
         useComponent?: boolean;
+        /** `type` of the `<button>`, e.g. `'submit'`. Defaults to `'button'`. */
         type?: string;
+        /**
+         * For toggle buttons: sets `aria-pressed` to `"true"` / `"false"`. Leave
+         * it undefined for regular buttons.
+         */
         isSelected?: boolean;
+        /** Same as `@isDisabled`. */
         disabled?: boolean;
     };
     Blocks: {
+        /** The button's text. */
         default: [];
     };
 }

package/declarations/components/eui-button-empty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eui-button-empty.d.ts","sourceRoot":"","sources":["../../src/components/eui-button-empty.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;IAC/C,IAAI,EAAE;QACJ,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,OAAO,WAAW,CAAC;QAChC,QAAQ,CAAC,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QACzD,KAAK,CAAC,EAAE,MAAM,OAAO,YAAY,CAAC;QAClC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C,QAAQ,CAAC,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QACzD,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,OAAO,YAAY,CAAC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED,QAAA,MAAM,cAAc,EAAE,qBAAqB,CAAC,uBAAuB,CAsDjE,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"eui-button-empty.d.ts","sourceRoot":"","sources":["../../src/components/eui-button-empty.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;IAC/C,IAAI,EAAE;QACJ,mEAAmE;QACnE,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,iDAAiD;QACjD,IAAI,CAAC,EAAE,MAAM,OAAO,WAAW,CAAC;QAChC,oEAAoE;QACpE,QAAQ,CAAC,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QACzD;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,OAAO,YAAY,CAAC;QAClC,mEAAmE;QACnE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5C,yEAAyE;QACzE,QAAQ,CAAC,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QACzD,kCAAkC;QAClC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iDAAiD;QACjD,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,0DAA0D;QAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,OAAO,YAAY,CAAC;QAClC;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,qDAAqD;QACrD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,4CAA4C;QAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,gDAAgD;QAChD,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,6EAA6E;QAC7E,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,yEAAyE;QACzE,IAAI,CAAC,EAAE,MAAM,CAAC;QACd;;;WAGG;QACH,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,6BAA6B;QAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,MAAM,EAAE;QACN,yBAAyB;QACzB,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED,QAAA,MAAM,cAAc,EAAE,qBAAqB,CAAC,uBAAuB,CAsDjE,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/declarations/components/eui-button-group-button.d.ts

@@ -3,24 +3,49 @@ import type { TemplateOnlyComponent } from '@ember/component/template-only';
 export interface EuiButtonGroupButtonSignature {
     Element: EuiButtonSignature['Element'];
     Args: {
+        /** Id of the option, passed to `@onChange`. */
         id: string;
+        /** Value of the option, passed to `@onChange` for single selection. */
         value?: string;
+        /**
+         * `'label'` wraps a hidden radio input (single selection groups),
+         * `'button'` renders a toggle button (multi selection groups).
+         */
         element?: 'label' | 'button';
+        /** `name` of the radio input, shared by the group's buttons. */
         name?: string;
+        /** The button's text (visually hidden with `@isIconOnly`). */
         label?: string;
+        /** Disables the button. */
         isDisabled?: boolean;
+        /** Whether the option is selected. */
         isSelected?: boolean;
+        /** Shows only the icon; the label is kept for screen readers. */
         isIconOnly?: boolean;
+        /** `'s'`, `'m'` or `'compressed'`. */
         size?: EuiButtonSignature['Args']['size'];
+        /** Color of the selected button, see `EuiButtonGroup`. */
         color?: EuiButtonSignature['Args']['color'];
+        /** Classes for the element wrapping the icon and text. */
         contentClasses?: EuiButtonSignature['Args']['contentClasses'];
+        /** `'right'` puts the icon after the text. */
         iconSide?: EuiButtonSignature['Args']['iconSide'];
+        /** Icon of the button; anything `EuiIcon`'s `@type` accepts. */
         iconType?: EuiButtonSignature['Args']['iconType'];
+        /** Size of the icon. */
         iconSize?: EuiButtonSignature['Args']['iconSize'];
+        /** Extra classes for the icon. */
         iconClasses?: EuiButtonSignature['Args']['iconClasses'];
+        /** Shows a spinner instead of the icon. */
         isLoading?: EuiButtonSignature['Args']['isLoading'];
+        /** Classes for the element wrapping the text. */
         textClasses?: EuiButtonSignature['Args']['textClasses'];
+        /** `type` of the button (multi selection only). */
         type?: EuiButtonSignature['Args']['type'];
+        /**
+         * Called with the option's `id` (and `value` for single selection) when
+         * it is clicked.
+         */
         onChange: (id: string, value?: string) => void;
     };
 }

package/declarations/components/eui-button-group-button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eui-button-group-button.d.ts","sourceRoot":"","sources":["../../src/components/eui-button-group-button.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;QAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1C,KAAK,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;QAC5C,cAAc,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAC9D,QAAQ,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QAClD,QAAQ,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QAClD,QAAQ,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QAClD,WAAW,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QACxD,SAAS,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;QACpD,WAAW,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QACxD,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1C,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;KAChD,CAAC;CACH;AAYD,QAAA,MAAM,oBAAoB,EAAE,qBAAqB,CAAC,6BAA6B,CA0D7E,CAAC;AAEH,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"eui-button-group-button.d.ts","sourceRoot":"","sources":["../../src/components/eui-button-group-button.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,EAAE;QACJ,+CAA+C;QAC/C,EAAE,EAAE,MAAM,CAAC;QACX,uEAAuE;QACvE,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;;WAGG;QACH,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;QAC7B,gEAAgE;QAChE,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,8DAA8D;QAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,2BAA2B;QAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,sCAAsC;QACtC,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,iEAAiE;QACjE,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,sCAAsC;QACtC,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1C,0DAA0D;QAC1D,KAAK,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;QAC5C,0DAA0D;QAC1D,cAAc,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAC9D,8CAA8C;QAC9C,QAAQ,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QAClD,gEAAgE;QAChE,QAAQ,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QAClD,wBAAwB;QACxB,QAAQ,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QAClD,kCAAkC;QAClC,WAAW,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QACxD,2CAA2C;QAC3C,SAAS,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;QACpD,iDAAiD;QACjD,WAAW,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QACxD,mDAAmD;QACnD,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1C;;;WAGG;QACH,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;KAChD,CAAC;CACH;AAYD,QAAA,MAAM,oBAAoB,EAAE,qBAAqB,CAAC,6BAA6B,CA0D7E,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/declarations/components/eui-button-group.d.ts

@@ -1,38 +1,87 @@
 import type { EuiButtonGroupButtonSignature } from './eui-button-group-button';
 import type { TemplateOnlyComponent } from '@ember/component/template-only';
 export interface Option {
+    /** Disables this option. Defaults to the group's `@isDisabled`. */
     isDisabled?: boolean;
+    /** Icon of the option; required for `@isIconOnly` groups. */
     iconType?: EuiButtonGroupButtonSignature['Args']['iconType'];
+    /** Value passed to `@onChange` (single selection only). */
     value?: EuiButtonGroupButtonSignature['Args']['value'];
+    /**
+     * Text of the option. Always set it: with `@isIconOnly` it is hidden but
+     * read by screen readers.
+     */
     label?: EuiButtonGroupButtonSignature['Args']['label'];
+    /** Unique id of the option, used by `@idSelected` / `@idToSelectedMap`. */
     id: EuiButtonGroupButtonSignature['Args']['id'];
+    /** Shows a spinner instead of the icon. */
     isLoading?: EuiButtonGroupButtonSignature['Args']['isLoading'];
+    /** `'right'` puts the icon after the text. */
     iconSide?: EuiButtonGroupButtonSignature['Args']['iconSide'];
+    /** Size of the icon. */
     iconSize?: EuiButtonGroupButtonSignature['Args']['iconSize'];
+    /** Classes for the element wrapping the text. */
     textClasses?: EuiButtonGroupButtonSignature['Args']['textClasses'];
+    /** Classes for the element wrapping the icon and text. */
     contentClasses?: EuiButtonGroupButtonSignature['Args']['contentClasses'];
+    /** Extra classes for the icon. */
     iconClasses?: EuiButtonGroupButtonSignature['Args']['iconClasses'];
+    /** `type` of the button (multi selection only). */
     type?: EuiButtonGroupButtonSignature['Args']['type'];
+    /** Class for the option's button. */
     className?: string;
+    /** Accessible label of the option's button. */
     'aria-label'?: string;
 }
 export interface EuiButtonGroupSignature {
     Element: HTMLFieldSetElement;
     Args: {
+        /**
+         * `'s'`, `'m'`, or `'compressed'` (for forms, e.g. inside an
+         * `EuiFormRow` with `@display="rowCompressed"`). Defaults to `'s'`.
+         */
         buttonSize?: 's' | 'm' | 'compressed';
+        /**
+         * Color of the selected buttons: `'primary'`, `'text'`, `'ghost'`,
+         * `'success'`, `'warning'` or `'danger'`. Defaults to `'text'`.
+         */
         color?: 'primary' | 'text' | 'ghost' | 'success' | 'warning' | 'danger';
+        /** Stretches the group, and its buttons evenly, to its container's width. */
         isFullWidth?: boolean;
+        /** Disables every option. */
         isDisabled?: boolean;
+        /**
+         * `'single'`: one option selected at a time, set with `@idSelected`
+         * (radio buttons). `'multi'`: each option toggles, set with
+         * `@idToSelectedMap`. Defaults to `'single'`.
+         */
         type?: 'single' | 'multi';
+        /**
+         * Describes the group for screen readers (visually hidden legend).
+         * Required for accessibility.
+         */
         legend?: string;
+        /** `name` of the radio inputs (single selection). Defaults to a random id. */
         name?: string;
+        /** Extra class(es) for the fieldset. */
         className?: string;
+        /** Shows only the options' icons; their labels stay for screen readers. */
         isIconOnly?: EuiButtonGroupButtonSignature['Args']['isIconOnly'];
+        /**
+         * Called with the clicked option's `id` (and its `value` for `'single'`).
+         * Update `@idSelected` / `@idToSelectedMap` here.
+         */
         onChange: EuiButtonGroupButtonSignature['Args']['onChange'];
+        /** Id of the selected option (`@type="single"`). */
         idSelected?: Option['id'];
+        /**
+         * Selected state by option id, e.g. `{ bold: true, italic: false }`
+         * (`@type="multi"`).
+         */
         idToSelectedMap?: {
             [key: string]: EuiButtonGroupButtonSignature['Args']['isSelected'];
         };
+        /** The buttons: `[{ id: 'left', label: 'Left', iconType: 'editorAlignLeft' }]`. */
         options?: Array<Option>;
     };
 }

package/declarations/components/eui-button-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eui-button-group.d.ts","sourceRoot":"","sources":["../../src/components/eui-button-group.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,WAAW,MAAM;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IAC7D,KAAK,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;IACvD,EAAE,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;IAC/D,QAAQ,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IAC7D,QAAQ,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IAC7D,WAAW,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;IACnE,cAAc,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzE,WAAW,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;IACnE,IAAI,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,IAAI,EAAE;QACJ,UAAU,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,YAAY,CAAC;QACtC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;QACxE,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACjE,QAAQ,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QAC5D,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,eAAe,CAAC,EAAE;YAChB,CAAC,GAAG,EAAE,MAAM,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;SACpE,CAAC;QACF,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;KACzB,CAAC;CACH;AAED,eAAO,MAAM,cAAc,EAAE,qBAAqB,CAAC,uBAAuB,CAyDxE,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"eui-button-group.d.ts","sourceRoot":"","sources":["../../src/components/eui-button-group.ts"],"names":[],"mappings":"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"}