@foris/avocado-suite 1.8.23 → 1.8.25

package/dist/components/beacon/Beacon.d.ts

@@ -0,0 +1,7 @@
+import { ButtonHTMLAttributes } from 'react';
+export interface BeaconProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'type' | 'aria-label'> {
+    /** Accessible name. Required — the beacon has no text content. */
+    label: string;
+}
+declare const Beacon: import("react").ForwardRefExoticComponent<BeaconProps & import("react").RefAttributes<HTMLButtonElement>>;
+export default Beacon;

package/dist/components/beacon/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './Beacon';
+export type { BeaconProps } from './Beacon';

package/dist/components/card-accordion/CardAccordion.d.ts

@@ -1,14 +1,18 @@
 import type { FC, ReactNode } from 'react';
 import type { IconTypes } from '../../../../avocado-icons';
 export interface CardAccordionProps {
-    /** Content action */
+    /** Primary call to action, rendered below the header when condensed */
     actionContent?: ReactNode;
-    /** Content card accordion */
-    children: ReactNode | string;
+    /** Accessible name of the card, required when `title` is not a plain string */
+    ariaLabel?: string;
+    /** Collapsible panel content. Without it the card renders no panel */
+    children?: ReactNode;
     /** Overwrite className */
     className?: string;
+    /** Layout density, defaults to 'expanded'. Mobile always renders condensed */
+    density?: 'expanded' | 'condensed';
     /** Description content */
-    description?: ReactNode | string;
+    description?: ReactNode;
     /** Disabled state */
     disabled?: boolean;
     /** Size Icon */
@@ -17,10 +21,21 @@ export interface CardAccordionProps {
     iconName?: IconTypes;
     /** Gradient Icon */
     iconGradient?: boolean;
-    /** Set accordion visibility */
+    /** Overflow control, always rendered beside the chevron */
+    menuContent?: ReactNode;
+    /** Toggle handler, its presence turns the card controlled */
+    onToggle?: (opened: boolean) => void;
+    /** Open state: initial when uncontrolled, required with `onToggle` */
     opened?: boolean;
-    /** Set title */
-    title: string;
+    /** A string renders in `Heading h3`, other nodes plain, hence `ariaLabel` */
+    title: ReactNode;
+    /** Cosmetic variant, only radius and panel background. Default 'default' */
+    type?: 'default' | 'expressive';
 }
+/**
+ * A header click landing on one of these belongs to the consumer, not the toggle.
+ * Exported so the tests assert against the same list.
+ */
+export declare const INTERACTIVE_SELECTOR: string;
 declare const CardAccordion: FC<CardAccordionProps>;
 export default CardAccordion;

package/dist/components/card-notification/CardNotification.d.ts

@@ -1,9 +1,11 @@
 import type { FC, ReactElement, ReactNode } from 'react';
+import { IconTypes } from '../../../../avocado-icons';
 declare enum NotificationState {
     Warning = "warning",
     Error = "error",
     Info = "info",
-    Success = "success"
+    Success = "success",
+    Neutral = "neutral"
 }
 export interface CardNotificationProps {
     /** Content card notification */
@@ -14,12 +16,17 @@ export interface CardNotificationProps {
     dismissible?: boolean;
     /** Extra content to be displayed below the main content of the card */
     extraContent?: ReactNode;
+    /**
+     * Overrides the default state icon, or sets one for `neutral`
+     * (which has no default icon).
+     */
+    icon?: IconTypes;
     /** Outlined variant */
     outlined?: boolean;
     /** State or variant of the notification */
     state: `${NotificationState}`;
     /** Title of the notification */
-    title: ReactElement | string;
+    title?: ReactElement | string;
 }
 declare const CardNotification: FC<CardNotificationProps>;
 export default CardNotification;

package/dist/components/hotspot/Hotspot.d.ts

@@ -0,0 +1,33 @@
+import { FC, ReactNode } from 'react';
+/** Declared here on purpose: `react-joyride` must not leak into the public API. */
+export type HotspotPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'right' | 'center' | 'auto';
+interface HotspotBaseProps {
+    /** CSS selector of the element the card anchors to and the spotlight cuts out. */
+    target: string;
+    content: ReactNode;
+    title?: string;
+    /** Controls visibility. The consumer owns "already seen" persistence. */
+    isOpen: boolean;
+    onClose: () => void;
+    /** Fires when the card becomes visible. Analytics hook. */
+    onOpen?: () => void;
+    /** Label of the confirm button. Required — avocado-suite ships no copy. */
+    closeLabel: string;
+    placement?: HotspotPlacement;
+    /** Spotlight inset around the target, in px. Default 8. */
+    spotlightPadding?: number;
+    /** Default 1000. Escape hatch for shells that stack differently. */
+    zIndex?: number;
+    className?: string;
+}
+export type HotspotProps = HotspotBaseProps & ({
+    showBeacon?: false;
+    beaconLabel?: never;
+    beaconClassName?: never;
+} | {
+    showBeacon: true;
+    beaconLabel: string;
+    beaconClassName?: string;
+});
+declare const Hotspot: FC<HotspotProps>;
+export default Hotspot;

package/dist/components/hotspot/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './Hotspot';
+export type { HotspotPlacement, HotspotProps } from './Hotspot';

package/dist/index.d.ts

@@ -51,6 +51,8 @@ import Weekly from './components/weekly';
 import WeeklyGroup from './components/weekly-group';
 import Drawer from './components/drawer/Drawer';
 import Banner from './components/banner';
+import Beacon from './components/beacon';
+import Hotspot from './components/hotspot';
 import SidebarMenu from './components/sidebar-menu/SidebarMenu';
 import AccessPanel from './components/access-panel/AccessPanel';
 import AccountMenu from './components/account-menu/AccountMenu';
@@ -61,11 +63,13 @@ import { toast } from 'react-toastify';
  * Hooks
  */
 export { useFloatingPortal } from './hooks/useFloatingPortal';
-export { Banner, Header, NavList, Drawer, AccessPanel, AccountMenu, SidebarMenu, Weekly, WeeklyGroup, Accordion, Box, Breadcrumbs, Button, Card, CardAccordion, CardNotification, Checkbox, DataCard, DataTable, DatePicker, Divider, Donut, DonutLabels, DonutLegend, DropdownButton, Heading, Link, Loading, Menu, Modal, Pager, Pill, PreviewerMarkdown, Processing, ProgressBar, RadioButton, RoundButton, Select, SelectPagination, SkeletonBase, SkeletonCircle, Stepper, Switch, Tabs, Tag, Text, TextField, Textarea, ThemeProvider, ThemeStore, LocaleStore, Timer, Toaster, Tooltip, Table, toast, };
+export { Banner, Beacon, Header, Hotspot, NavList, Drawer, AccessPanel, AccountMenu, SidebarMenu, Weekly, WeeklyGroup, Accordion, Box, Breadcrumbs, Button, Card, CardAccordion, CardNotification, Checkbox, DataCard, DataTable, DatePicker, Divider, Donut, DonutLabels, DonutLegend, DropdownButton, Heading, Link, Loading, Menu, Modal, Pager, Pill, PreviewerMarkdown, Processing, ProgressBar, RadioButton, RoundButton, Select, SelectPagination, SkeletonBase, SkeletonCircle, Stepper, Switch, Tabs, Tag, Text, TextField, Textarea, ThemeProvider, ThemeStore, LocaleStore, Timer, Toaster, Tooltip, Table, toast, };
 /**
  * Types
  */
 export type { ButtonProps } from './components/button/Button';
+export type { BeaconProps } from './components/beacon';
+export type { HotspotPlacement, HotspotProps } from './components/hotspot';
 export type { BreadcrumbItem } from './components/breadcrumbs/Breadcrumbs';
 export type { CardAccordionProps } from './components/card-accordion/CardAccordion';
 export type { CardNotificationProps } from './components/card-notification/CardNotification';