@gouvfr-lasuite/ui-kit 0.18.7 → 0.19.1

package/dist/index.d.ts

@@ -10,6 +10,7 @@ import { JSX } from 'react/jsx-runtime';
 import { Key } from 'react-stately';
 import { LabelHTMLAttributes } from 'react';
 import { MemoExoticComponent } from 'react';
+import { ModalSize } from '@gouvfr-lasuite/cunningham-react';
 import { NodeApi } from 'react-arborist';
 import { NodeRendererProps } from 'react-arborist';
 import { Option as Option_2 } from '@gouvfr-lasuite/cunningham-react';
@@ -31,9 +32,10 @@ export declare type AccessData<UserType, T> = T & {
     id: string;
     role: string;
     user: UserData<UserType>;
+    is_explicit?: boolean;
 };
 
-export declare const AccessRoleDropdown: ({ roles, onSelect, canUpdate, selectedRole, isOpen, onOpenChange, roleTopMessage, }: AccessRoleDropdownProps) => JSX.Element;
+export declare const AccessRoleDropdown: ({ roles, onSelect, canUpdate, selectedRole, isOpen, onOpenChange, roleTopMessage, onDelete, }: AccessRoleDropdownProps) => JSX.Element;
 
 declare type AccessRoleDropdownProps = {
     selectedRole: string;
@@ -43,6 +45,7 @@ declare type AccessRoleDropdownProps = {
     isOpen?: boolean;
     onOpenChange?: (isOpen: boolean) => void;
     roleTopMessage?: DropdownMenuProps["topMessage"];
+    onDelete?: () => void;
 };
 
 export declare type AddShareUserListProps<UserType> = {
@@ -502,6 +505,49 @@ export declare type BaseTreeViewData<T> = {
 
 export declare const containerSizeMap: Record<IconSize, number>;
 
+export declare const ContextMenu: <T>({ children, options, context, disabled, asChild, onFocus, onBlur, }: ContextMenuProps<T>) => JSX.Element;
+
+declare type ContextMenuContextValue = {
+    open: (config: {
+        position: {
+            x: number;
+            y: number;
+        };
+        items: MenuItem[];
+        onBlur?: () => void;
+    }) => void;
+    close: () => void;
+};
+
+/**
+ * @deprecated Use MenuItem instead
+ */
+export declare type ContextMenuItem = MenuItem;
+
+/**
+ * @deprecated Use MenuItemAction instead
+ */
+export declare type ContextMenuItemAction = MenuItemAction;
+
+/**
+ * @deprecated Use MenuItemSeparator instead
+ */
+export declare type ContextMenuItemSeparator = MenuItemSeparator;
+
+export declare type ContextMenuProps<T = unknown> = {
+    children: ReactNode;
+    options: MenuItem[] | ((context: T) => MenuItem[]);
+    context?: T;
+    disabled?: boolean;
+    asChild?: boolean;
+    /** Called when the menu opens on this trigger */
+    onFocus?: () => void;
+    /** Called when the menu closes (if it was open on this trigger) */
+    onBlur?: () => void;
+};
+
+export declare const ContextMenuProvider: ({ children }: PropsWithChildren) => JSX.Element;
+
 export declare const cunninghamConfig: {
     themes: {
         default: any;
@@ -520,21 +566,25 @@ export declare type CustomTranslations = Partial<Record<TranslationKey, string>>
 
 export declare const DropdownMenu: ({ options, isOpen, onOpenChange, children, selectedValues, onSelectValue, topMessage, shouldCloseOnInteractOutside, }: PropsWithChildren<DropdownMenuProps>) => JSX.Element;
 
-export declare type DropdownMenuOption = {
-    label: string;
-    subText?: string;
-    icon?: ReactNode;
-    callback?: () => void | Promise<unknown>;
-    isDisabled?: boolean;
-    showSeparator?: boolean;
-    isHidden?: boolean;
+/**
+ * Union type for DropdownMenu items (supports separators)
+ */
+export declare type DropdownMenuItem = DropdownMenuOption | MenuItemSeparator;
+
+/**
+ * DropdownMenu option extending the shared MenuItemAction
+ * Adds selection-specific props: isChecked, value
+ * @deprecated showSeparator - use MenuItemSeparator instead
+ */
+export declare type DropdownMenuOption = MenuItemAction & {
     isChecked?: boolean;
-    testId?: string;
     value?: string;
+    /** @deprecated Use MenuItem with { type: "separator" } instead */
+    showSeparator?: boolean;
 };
 
 export declare type DropdownMenuProps = {
-    options: DropdownMenuOption[];
+    options: DropdownMenuItem[];
     onOpenChange?: (isOpen: boolean) => void;
     selectedValues?: string[];
     onSelectValue?: (value: string) => void;
@@ -979,6 +1029,12 @@ export declare const getContainerSize: (iconSize: IconSize) => number;
 
 export declare const getIconSize: (iconSize: IconSize) => number;
 
+/**
+ * Returns the appropriate icon for the step based on active state.
+ * Extracted to avoid duplication between desktop and mobile views.
+ */
+export declare const getStepIcon: (step: OnboardingStep, isActive: boolean) => ReactNode;
+
 export declare const getUIKitThemesFromGlobals: (globals: Parameters<typeof getThemesFromGlobals>[0], options?: Parameters<typeof getThemesFromGlobals>[1]) => Record<string, any>;
 
 /**
@@ -1088,10 +1144,18 @@ export declare const LaGaufre: () => JSX.Element;
 
 export declare const LaGaufreV2: MemoExoticComponent<({ apiUrl, data, ...props }: LaGaufreV2Props) => JSX.Element>;
 
-export declare type LaGaufreV2Props = {
-    widgetPath: string;
+declare type LaGaufreV2API = {
     apiUrl: string;
-    data?: ServicesResponse;
+    data?: never;
+};
+
+declare type LaGaufreV2Data = {
+    apiUrl?: never;
+    data: ServicesResponse;
+};
+
+export declare type LaGaufreV2Props = {
+    widgetPath?: string;
     fontFamily?: string;
     background?: string;
     headerLogo?: string;
@@ -1104,7 +1168,7 @@ export declare type LaGaufreV2Props = {
     showMoreLimit?: number;
     viewMoreLabel?: string;
     viewLessLabel?: string;
-};
+} & (LaGaufreV2API | LaGaufreV2Data);
 
 /**
  * A DropdownMenu specific to languages.
@@ -1312,6 +1376,15 @@ export declare const locales: {
                     alt: string;
                 };
             };
+            onboarding: {
+                skip: string;
+                next: string;
+                previous: string;
+                complete: string;
+                stepLabel: string;
+                currentStepSuffix: string;
+                contentRegionLabel: string;
+            };
         };
     };
     "fr-FR": {
@@ -1482,6 +1555,15 @@ export declare const locales: {
                     alt: string;
                 };
             };
+            onboarding: {
+                skip: string;
+                next: string;
+                previous: string;
+                complete: string;
+                stepLabel: string;
+                currentStepSuffix: string;
+                contentRegionLabel: string;
+            };
         };
     };
 };
@@ -1502,8 +1584,107 @@ export declare type MainLayoutProps = {
     setIsLeftPanelOpen?: (isLeftPanelOpen: boolean) => void;
 };
 
+/**
+ * Union type for all menu items
+ */
+export declare type MenuItem = MenuItemAction | MenuItemSeparator;
+
+/**
+ * Base action item for menus (shared between ContextMenu and DropdownMenu)
+ */
+export declare type MenuItemAction = {
+    id?: string;
+    label: string;
+    subText?: string;
+    icon?: ReactNode;
+    callback?: () => void | Promise<unknown>;
+    isDisabled?: boolean;
+    isHidden?: boolean;
+    variant?: "default" | "danger";
+    testId?: string;
+};
+
+/**
+ * Separator item for menus
+ */
+export declare type MenuItemSeparator = {
+    type: "separator";
+};
+
+export { ModalSize }
+
 export { NodeRendererProps }
 
+export declare const OnboardingModal: ({ isOpen, size, appName, mainTitle, steps, initialStep, footerLink, hideContent, onSkip, onComplete, onClose, labels, }: OnboardingModalProps) => JSX.Element | null;
+
+export declare interface OnboardingModalProps {
+    /** Whether the modal is open */
+    isOpen: boolean;
+    /** Size of the modal on desktop (default: ModalSize.LARGE). On mobile, always ModalSize.FULL */
+    size?: ModalSize;
+    /** Name of the application or module (e.g., "Discover Docs", "Welcome to Messaging") */
+    appName?: string;
+    /** Main heading of the onboarding modal (e.g., "Learn the core principles") */
+    mainTitle: string;
+    /** Array of onboarding steps */
+    steps: OnboardingStep[];
+    /** Initial step index (default: 0) */
+    initialStep?: number;
+    /** Optional footer link - requires either href or onClick */
+    footerLink?: {
+        label: string;
+    } & ({
+        href: string;
+        onClick?: () => void;
+    } | {
+        onClick: () => void;
+        href?: string;
+    });
+    /** Callback when user clicks Skip */
+    onSkip?: () => void;
+    /** Callback when user clicks Understood (last step) */
+    onComplete: () => void;
+    /** Callback when user clicks the close button */
+    onClose: () => void;
+    /** Hide the content/preview zone (text-only mode) */
+    hideContent?: boolean;
+    /** Custom labels for i18n */
+    labels?: {
+        skip?: string;
+        next?: string;
+        previous?: string;
+        complete?: string;
+    };
+}
+
+export declare interface OnboardingStep {
+    /** Icon displayed next to the step title */
+    icon: ReactNode;
+    /** Icon displayed when the step is active (optional, defaults to icon with brand color) */
+    activeIcon?: ReactNode;
+    /** Step title */
+    title: string;
+    /** Step description, visible only when the step is active */
+    description?: string;
+    /** Content displayed in the preview zone (image, video, component, etc.) */
+    content?: ReactNode;
+}
+
+export declare interface OnboardingStepItemProps {
+    /** Step data */
+    step: OnboardingStep;
+    /** Whether this step is active */
+    isActive: boolean;
+    /** Click handler */
+    onClick: () => void;
+    /** Step index (0-based) for accessibility */
+    index: number;
+    /** Total number of steps */
+    totalSteps: number;
+    /** Accessible label for the step */
+    ariaLabel: string;
+}
+
 export declare type OpenMap = {
     [id: string]: boolean;
 };
@@ -1592,6 +1773,23 @@ export declare type QuickSearchProps = {
     children?: ReactNode;
 };
 
+export declare const ReleaseNoteModal: ({ steps, ...props }: ReleaseNoteModalProps) => JSX.Element;
+
+export declare interface ReleaseNoteModalProps extends Omit<OnboardingModalProps, "hideContent" | "steps"> {
+    steps: ReleaseNoteStep[];
+}
+
+export declare interface ReleaseNoteStep {
+    /** Icon displayed next to the step title */
+    icon: ReactNode;
+    /** Icon displayed when the step is active */
+    activeIcon?: ReactNode;
+    /** Step title */
+    title: string;
+    /** Step description, visible only when the step is active */
+    description?: string;
+}
+
 declare type ResponsiveStates = {
     isMobile: boolean;
     isTablet: boolean;
@@ -1617,7 +1815,7 @@ declare type ServicesResponse = {
     error?: unknown;
 };
 
-export declare const ShareInvitationItem: <UserType, InvitationType>({ invitation, roles, updateRole, deleteInvitation, canUpdate, showMoreActionsButton, roleTopMessage, }: ShareInvitationItemProps<UserType, InvitationType>) => JSX.Element;
+export declare const ShareInvitationItem: <UserType, InvitationType>({ invitation, roles, updateRole, deleteInvitation, canUpdate, roleTopMessage, }: ShareInvitationItemProps<UserType, InvitationType>) => JSX.Element;
 
 export declare type ShareInvitationItemProps<UserType, InvitationType> = {
     invitation: InvitationData<UserType, InvitationType>;
@@ -1626,7 +1824,6 @@ export declare type ShareInvitationItemProps<UserType, InvitationType> = {
     deleteInvitation?: (invitation: InvitationData<UserType, InvitationType>) => void;
     canUpdate?: boolean;
     roleTopMessage?: string;
-    showMoreActionsButton?: boolean;
 };
 
 export declare const ShareMemberItem: <UserType, AccessType>({ accessData, accessRoleKey, roles, updateRole, deleteAccess, canUpdate, roleTopMessage, }: ShareMemberItemProps<UserType, AccessType>) => JSX.Element;
@@ -1901,6 +2098,8 @@ export declare const TreeViewSeparator: ({ top, left }: CursorProps) => JSX.Elem
  */
 export declare function useArrowRoving(container: HTMLElement | null): void;
 
+export declare const useContextMenuContext: () => ContextMenuContextValue;
+
 /**
  * Hook for using custom translations with type safety.
  *