@llmnative/react 1.31.0 → 1.32.0

package/dist/types/src/components/blocks/Notifications.d.ts

@@ -1,12 +1,32 @@
 import React from "react";
 import type { BadgeProps } from "../ui/Badge";
 import type { MotionReference } from "../../motion";
-interface NotificationItem {
+/** A button on a notification: it acts without opening the notification. */
+export interface NotificationAction {
+    label: string;
+    icon?: string;
+    /** May return a promise: the button shows it is working until it settles. */
+    onClick: () => void | Promise<unknown>;
+    /** `primary` stands out; the default is quiet. */
+    variant?: "primary" | "default";
+    /** Closes the menu once the action is done; by default it stays open. */
+    closeOnClick?: boolean;
+}
+export interface NotificationItem {
+    /** Stable key of the notification (the index otherwise). */
+    id?: string;
     title: string;
-    url: string;
+    /** A line under the title: what and where. */
+    description?: React.ReactNode;
+    /** Where the notification leads: a route of the app, or an address when `external`. Without it, it only shows. */
+    url?: string;
+    /** Opens `url` as an address in a new tab instead of a route of the app. */
+    external?: boolean;
     time: string;
     icon: string;
     read?: boolean;
+    /** Buttons under the notification, to act on it from the menu. */
+    actions?: NotificationAction[];
 }
 interface NotificationsProps {
     items?: NotificationItem[];
@@ -15,9 +35,11 @@ interface NotificationsProps {
     seeAllUrl?: string;
     /** Callback for "mark all as read" — shown in the header only when there are items */
     onMarkAllRead?: () => void;
+    /** Called when a notification is opened (e.g. to mark it read); the menu closes. */
+    onItemClick?: (item: NotificationItem, index: number) => void;
     /** Named motion preset for notification items appearance. */
     motion?: MotionReference;
     className?: string;
 }
-declare function Notifications({ items, badge, seeAllUrl, onMarkAllRead, motion, className, }: NotificationsProps): React.JSX.Element;
+declare function Notifications({ items, badge, seeAllUrl, onMarkAllRead, onItemClick, motion, className, }: NotificationsProps): React.JSX.Element;
 export default Notifications;

package/dist/types/src/components/index.d.ts

@@ -5,6 +5,7 @@ export type { BreadcrumbItem, BreadcrumbsProps, BreadcrumbSchemaOptions } from '
 export { default as Carousel } from './blocks/Carousel';
 export * from './blocks/Dropdown';
 export { default as Notifications } from './blocks/Notifications';
+export type { NotificationItem, NotificationAction } from './blocks/Notifications';
 export { default as Search } from './blocks/Search';
 export { default as Toolbar } from './blocks/Toolbar';
 export type { ToolbarProps } from './blocks/Toolbar';