@foris/avocado-suite 1.14.2 → 1.16.0

package/dist/components/Pill/Pill.d.ts

@@ -1,11 +1,16 @@
 import React from 'react';
 import { IconTypes, Color } from '../../../../avocado-icons';
-export interface PillProps {
-    /** Optional Icon name */
-    icon?: IconTypes;
-    /** Overwrite icon original color */
+export type PillStatus = 'neutral' | 'info' | 'success' | 'warning' | 'error';
+export interface PillProps extends Omit<React.HTMLAttributes<HTMLElement>, 'color'> {
+    /** Root element. Use `span` inside buttons or running text */
+    as?: 'div' | 'span';
+    /** Colors the pill from the theme tokens of the status. `color` and `textColor` take precedence */
+    status?: PillStatus;
+    /** Avocado icon name, or an element (e.g. a Lucide icon) rendered hidden from assistive technology */
+    icon?: IconTypes | React.ReactElement;
+    /** Overwrite icon original color. Applies to avocado icon names only */
     iconColor?: `${Color}`;
-    /** Icon filled state */
+    /** Icon filled state. Applies to avocado icon names only */
     iconFilled?: boolean;
     /** Overwrite pill original color */
     color?: `${Color}`;
@@ -13,8 +18,12 @@ export interface PillProps {
     textColor?: `${Color}`;
     /** Controls pill outlined state */
     outlined?: boolean;
+    /** Renders the pill as a count badge showing this number instead of `children` */
+    count?: number;
+    /** Highest count shown; a greater `count` renders as `{max}+` */
+    max?: number;
     /** content pill */
-    children: React.ReactNode | string;
+    children?: React.ReactNode | string;
     /** overwrite className */
     className?: string;
 }

package/dist/components/checkbox/Checkbox.d.ts

@@ -10,6 +10,10 @@ export interface CheckboxProps extends React.DetailedHTMLProps<React.InputHTMLAt
     labelRight?: ReactNode | string;
     /** disabled state */
     disabled?: boolean;
+    /** Help text shown below the checkbox and linked to it */
+    helpText?: string;
+    /** Error message shown below the checkbox; marks it invalid */
+    error?: string;
     ref?: any;
 }
 declare const Checkbox: FC<CheckboxProps>;

package/dist/components/header-navigation/HeaderNavigation.d.ts

@@ -1,4 +1,4 @@
-import type { FC, HTMLAttributes } from 'react';
+import type { FC, HTMLAttributes, ReactNode } from 'react';
 import type { Color, IconTypes } from '../../../../avocado-icons';
 import { type BreadcrumbItem } from '../breadcrumbs/Breadcrumbs';
 import type { MenuItem } from '../../types/menu.types';
@@ -26,20 +26,37 @@ export type HeaderNavigationImageBackground = {
      */
     overlayColor?: string;
 };
+/** Overflow actions shown at the end of the title row. */
+export type HeaderNavigationMenu = {
+    items: MenuItem[];
+    /** Accessible name for the trigger; defaults to the page title. */
+    label?: string;
+    disabled?: boolean;
+};
 export type HeaderNavigationBackground = 'default' | 'brand' | HeaderNavigationImageBackground;
 /** Reusable page navigation, with content and actions supplied by its host. */
 export interface HeaderNavigationProps extends HTMLAttributes<HTMLElement> {
     /** Page title, rendered as the primary heading. */
     title: string;
-    /** Optional explanation of the page's purpose. */
-    description?: string;
+    /** Optional content shown above the title, below the breadcrumbs. */
+    topLabel?: ReactNode;
+    /** Optional content right after the title text, e.g. an info button. */
+    titleTrailing?: ReactNode;
+    /** Optional content at the end of the title row, e.g. view toggles. */
+    titleActions?: ReactNode;
+    /** Optional supporting copy below the title: text or inline content. */
+    description?: ReactNode;
     /** Navigation hierarchy; mobile shows the parent page. */
-    breadcrumbsItems?: BreadcrumbItem[];
+    breadcrumbs?: BreadcrumbItem[];
     /** Optional overflow actions, without product-specific routing. */
+    menu?: HeaderNavigationMenu;
+    /** @deprecated Use `breadcrumbs`. */
+    breadcrumbsItems?: BreadcrumbItem[];
+    /** @deprecated Use `menu.items`. */
     menuItems?: MenuItem[];
-    /** Accessible name for the overflow trigger; defaults to the page title. */
+    /** @deprecated Use `menu.label`. */
     menuLabel?: string;
-    /** Disables the overflow trigger. */
+    /** @deprecated Use `menu.disabled`. */
     menuDisabled?: boolean;
     /** Gray by default, brand blue, or a full-bleed hero photograph. */
     background?: HeaderNavigationBackground;

package/dist/components/header-navigation/headerNavigation.util.d.ts

@@ -0,0 +1,3 @@
+import type { ReactNode } from 'react';
+/** True when React would paint something, so optional slots skip empty wrappers. */
+export declare const hasContent: (node: ReactNode) => boolean;

package/dist/components/header-navigation/headerNavigation.util.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/header-navigation/index.d.ts

@@ -1,2 +1,2 @@
 export { default } from './HeaderNavigation';
-export type { HeaderNavigationBackground, HeaderNavigationImageBackground, HeaderNavigationProps, HeaderNavigationVisual, } from './HeaderNavigation';
+export type { HeaderNavigationBackground, HeaderNavigationImageBackground, HeaderNavigationMenu, HeaderNavigationProps, HeaderNavigationVisual, } from './HeaderNavigation';

package/dist/components/link/Link.d.ts

@@ -1,4 +1,4 @@
-import { FC } from 'react';
+import { FC, MouseEvent } from 'react';
 import { IconTypes } from '../../../../avocado-icons';
 export interface LinkProps extends React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement> {
     /** Render content link */
@@ -17,8 +17,8 @@ export interface LinkProps extends React.DetailedHTMLProps<React.AnchorHTMLAttri
     inverse?: boolean;
     /** Use size 'sm' or 'md'. Default 'md' */
     size?: 'sm' | 'md';
-    /** Handle onClock event */
-    onClick?: () => void;
+    /** Receives the click event; call `preventDefault()` to route in-app. Not called when disabled */
+    onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
 }
 declare const Link: FC<LinkProps>;
 export default Link;

package/dist/components/modal/Modal.d.ts

@@ -1,5 +1,6 @@
-import { type ReactNode, type FC } from 'react';
+import { type FC, type ReactNode } from 'react';
 import { type Color } from '../../../../avocado-icons';
+import { type FocusTarget } from '../../utils/focus/useDialogFocus';
 type HeaderStatusColor = 'warning' | 'danger' | Extract<keyof typeof Color, 'palette_1_50' | 'palette_2_50' | 'palette_3_50' | 'palette_4_50' | 'palette_5_50' | 'palette_6_50' | 'palette_7_50' | 'palette_8_50' | 'palette_9_50' | 'palette_10_50' | 'palette_11_50' | 'palette_12_50' | 'palette_13_50' | 'palette_14_50' | 'palette_15_50' | 'palette_16_50' | 'palette_17_50' | 'palette_18_50'>;
 export interface ModalProps {
     /** Footer actions or buttons */
@@ -20,6 +21,22 @@ export interface ModalProps {
     open: boolean;
     /** Header bordered */
     headerBordered?: boolean;
+    /** `alertdialog` for destructive or urgent confirmations */
+    role?: 'dialog' | 'alertdialog';
+    /** Accessible name when `header` is not a string */
+    accessibleLabel?: string;
+    /** Id of the element that describes the dialog */
+    describedBy?: string;
+    /** Accessible name of the close button. Defaults to a localized "Close" */
+    closeLabel?: string;
+    /** Element focused on open, as a ref or a function. Defaults to the first focusable element */
+    initialFocus?: FocusTarget;
+    /** Element focused on close when the opener is no longer in the document */
+    finalFocus?: () => HTMLElement | null;
+    /** Ignores Escape */
+    disableEscape?: boolean;
+    /** Ignores every close request and disables the close button */
+    closeDisabled?: boolean;
 }
 declare const Modal: FC<ModalProps>;
 export default Modal;

package/dist/components/modal/modal.locale.d.ts

@@ -0,0 +1,8 @@
+export declare const MODAL_STRINGS: {
+    en: {
+        close: string;
+    };
+    es: {
+        close: string;
+    };
+};

package/dist/components/select/Select.d.ts

@@ -7,6 +7,8 @@ export interface SelectProps extends Props {
     disabled?: boolean;
     /** Error option */
     error?: string | boolean;
+    /** Help text shown below the select. Hidden while a string `error` is shown */
+    helpText?: string;
     /** Text to be displayed representing the option */
     label?: string;
     /** [react-select] Array of options that populate the select menu */

package/dist/components/select/components/SelectIndicators.d.ts

@@ -2,6 +2,7 @@ import { ClearIndicatorProps, DropdownIndicatorProps } from 'react-select';
 export declare const ClearIndicator: (props: ClearIndicatorProps) => import("react/jsx-runtime").JSX.Element;
 export declare const DropdownIndicator: (props: DropdownIndicatorProps) => import("react/jsx-runtime").JSX.Element;
 interface ErrorIndicator {
+    id?: string;
     message: string;
 }
 export declare const ErrorIndicator: (props: ErrorIndicator) => import("react/jsx-runtime").JSX.Element;

package/dist/components/select/components/SelectInput.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="react" />
+import { InputProps } from 'react-select';
+/** Space-separated ids of the help and error texts that describe the input */
+export declare const SelectDescriptionContext: import("react").Context<string | undefined>;
+export declare const SelectInput: (props: InputProps) => import("react/jsx-runtime").JSX.Element;

package/dist/index.d.ts

@@ -91,7 +91,7 @@ export type { BarChartProps, BarChartReferenceLine, BarChartSeries, } from './co
 export type { DonutProps, DonutSegment, DonutSize, DonutCenterMode, IDonutItem, } from './components/donut/Donut';
 export { toDonutLegendItems } from './components/donut/donut.util';
 export type { HeadingProps } from './components/heading/Heading';
-export type { HeaderNavigationBackground, HeaderNavigationImageBackground, HeaderNavigationProps, HeaderNavigationVisual, } from './components/header-navigation';
+export type { HeaderNavigationBackground, HeaderNavigationImageBackground, HeaderNavigationMenu, HeaderNavigationProps, HeaderNavigationVisual, } from './components/header-navigation';
 export type { ContextualNavigationProps, ContextualNavigationItem, } from './components/contextual-navigation';
 export type { LinkProps } from './components/link/Link';
 export type { LineChartProps, LineChartRow, LineChartSeries, LineChartVariant, LineChartCurveType, LineChartReference, } from './components/line-chart';