@nxgt/material 3.70.0 → 3.71.0

package/dist/lib/components/ui/layout/record-page/record-page.d.ts

@@ -0,0 +1,27 @@
+import { ReactNode } from 'react';
+import { ActivityContentProps } from '../app-shell/activity-content.js';
+export type RecordPageProps = Omit<ActivityContentProps, 'aside' | 'asideLabel' | 'asideLabelledBy' | 'asideStack' | 'asideClassName' | 'asideSide'> & {
+    /**
+     * The record's facts, usually a {@link RecordDetails}: a side panel from
+     * `asideFrom` (`xl` by default), sticky under the app bar, and stacked
+     * below it. A `complementary` landmark named by `detailsLabel`.
+     */
+    details?: ReactNode;
+    /** The side panel's accessible name (`aria-label`), such as "Item details". */
+    detailsLabel?: string;
+    /** The id of the heading inside the details that names the panel. */
+    detailsLabelledBy?: string;
+    /** Where the details go below `asideFrom`: `'after'` the content (default) or `'before'` it. */
+    detailsStack?: 'before' | 'after';
+    /** Classes for the side panel itself. */
+    detailsClassName?: string;
+};
+/**
+ * RecordPage - the page of one record: a header card (`header`, or `title`,
+ * `subtitle` and `actions`), the content, and the record's facts (`details`,
+ * a {@link RecordDetails}) as a side panel from `xl` that stacks after the
+ * content, or before it, below. It composes `ActivityContent`, so `width`,
+ * `notice`, `inset`, `titleAs` and the others work as there; only the side
+ * panel's props are renamed `details*`. A layout: no data, no state.
+ */
+export declare function RecordPage({ details, detailsLabel, detailsLabelledBy, detailsStack, detailsClassName, ...props }: RecordPageProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/chat/chat-conversation-item.d.ts

@@ -3,7 +3,13 @@ import { StatusTone } from '../../display/status-indicator/status-indicator.js';
 export type ChatConversationItemProps = {
     avatarSrc?: string;
     avatarFallback?: ReactNode;
+    /**
+     * The conversation's name. A string also becomes the `title` attribute of
+     * the clipped line, so the full text stays readable on hover.
+     */
     title: ReactNode;
+    /** The full text of a clipped `title` that is not a string (a node). */
+    titleText?: string;
     preview?: ReactNode;
     timestamp?: ReactNode;
     unreadCount?: number;
@@ -13,5 +19,5 @@ export type ChatConversationItemProps = {
     status?: StatusTone;
     /** Shows a typing line instead of the preview. */
     isTyping?: boolean;
-} & Omit<ComponentProps<'button'>, 'children'>;
-export declare function ChatConversationItem({ avatarSrc, avatarFallback, title, preview, timestamp, unreadCount, isActive, isLoading, status, isTyping, className, ...props }: ChatConversationItemProps): import("react").JSX.Element;
+} & Omit<ComponentProps<'button'>, 'children' | 'title'>;
+export declare function ChatConversationItem({ avatarSrc, avatarFallback, title, titleText, preview, timestamp, unreadCount, isActive, isLoading, status, isTyping, className, ...props }: ChatConversationItemProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/chat/chat-markdown.d.ts

@@ -2,5 +2,9 @@ import { ComponentProps } from 'react';
 export { sanitizeHref } from '../../display/markdown/markdown.utils.js';
 export type ChatMarkdownProps = {
     content: string;
+    /** KaTeX maths, default `true`; see `Markdown`. */
+    math?: boolean;
+    /** Mermaid diagrams, default `true`; see `Markdown`. */
+    mermaid?: boolean;
 } & Omit<ComponentProps<'div'>, 'children'>;
 export declare function ChatMarkdown({ content, className, ...props }: ChatMarkdownProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/chat/chat-message-list.d.ts

@@ -1,4 +1,5 @@
 import { ComponentProps, ReactNode } from 'react';
+import { ScrollArea } from '../../primitives/scroll-area/scroll-area.js';
 import { ChatDensity, ChatLayout } from './chat-layout-context.js';
 export type ChatMessageListProps = {
     isTyping?: boolean;
@@ -14,5 +15,11 @@ export type ChatMessageListProps = {
     /** `comfortable` (default) or `compact`, for every `ChatMessage` inside. */
     density?: ChatDensity;
     children?: ReactNode;
+    /**
+     * Attributes for the scrolling element itself. It is a tab stop by default
+     * (`tabIndex={0}`), so a keyboard reader can scroll a transcript that holds
+     * nothing focusable; pass `tabIndex={-1}` to opt out.
+     */
+    viewportProps?: ComponentProps<typeof ScrollArea>['viewportProps'];
 } & Omit<ComponentProps<'div'>, 'children' | 'dir'>;
-export declare function ChatMessageList({ isTyping, typingLabel, typingAvatar, emptyState, scrollToBottomLabel, showScrollToBottom, bottomThreshold, layout, density, children, className, ...props }: ChatMessageListProps): import("react").JSX.Element;
+export declare function ChatMessageList({ isTyping, typingLabel, typingAvatar, emptyState, scrollToBottomLabel, showScrollToBottom, bottomThreshold, layout, density, children, className, viewportProps, ...props }: ChatMessageListProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/chat/index.d.ts

@@ -15,4 +15,6 @@ export * from './chat-typing-indicator.js';
 export * from './chat-widget.js';
 export * from './partials/chat-composer-attachment-chip.js';
 export * from './partials/chat-composer-attachments.js';
+export * from './proposal/chat-action-proposal.js';
+export * from './proposal/chat-tool-activity.js';
 export * from './use-chat-composer-attachments.js';

package/dist/lib/components/ui/widgets/chat/partials/chat-conversation-item-text.d.ts

@@ -1,7 +1,8 @@
 import { ReactNode } from 'react';
 /** The title, timestamp, preview (or typing line) and unread badge of a conversation row. */
-export declare function ChatConversationItemText({ title, preview, timestamp, unreadCount, isActive, isTyping, }: {
+export declare function ChatConversationItemText({ title, titleText, preview, timestamp, unreadCount, isActive, isTyping, }: {
     title: ReactNode;
+    titleText?: string;
     preview?: ReactNode;
     timestamp?: ReactNode;
     unreadCount?: number;

package/dist/lib/components/ui/widgets/chat/partials/chat-empty-thread.d.ts

@@ -0,0 +1,2 @@
+/** The default empty state of a message list. */
+export declare function ChatEmptyThread(): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/chat/proposal/chat-action-proposal-parts.d.ts

@@ -0,0 +1,24 @@
+import { ReactNode, RefObject } from 'react';
+import { ChatActionProposalStatus } from './chat-action-proposal.rules.js';
+export declare function ProposalFailure({ code, message, }: {
+    code?: string;
+    message?: ReactNode;
+}): import("react").JSX.Element | null;
+export declare function ProposalButtons({ actions, onConfirm, onReject, confirmLabel, rejectLabel, busy, locked, }: {
+    actions?: ReactNode;
+    onConfirm?: () => void;
+    onReject?: () => void;
+    confirmLabel?: string;
+    rejectLabel?: string;
+    busy: boolean;
+    locked: boolean;
+}): import("react").JSX.Element;
+export declare function Deadline({ at, status, }: {
+    at: Date | string | number;
+    status: ChatActionProposalStatus;
+}): import("react").JSX.Element | null;
+export declare function ProposalHeader({ toolLabel, status, statusRef, }: {
+    toolLabel?: ReactNode;
+    status: ChatActionProposalStatus;
+    statusRef: RefObject<HTMLSpanElement | null>;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/chat/proposal/chat-action-proposal.d.ts

@@ -0,0 +1,39 @@
+import { ComponentProps, ReactNode } from 'react';
+import { ChatActionProposalStatus } from './chat-action-proposal.rules.js';
+export type { ChatActionProposalStatus };
+export type ChatActionProposalProps = {
+    /** What the assistant wants to do, in a few words. */
+    title: ReactNode;
+    /** The effect in plain words: what will change, and for whom. */
+    summary?: ReactNode;
+    /** The tool behind the action (a name, a badge, an icon with a name). */
+    toolLabel?: ReactNode;
+    /** Extra detail under the summary (a list of the records touched). */
+    children?: ReactNode;
+    /** The last moment to answer; written in the active language. */
+    deadline?: Date | string | number;
+    /** Default `pending`. Only `pending` shows the buttons. */
+    status?: ChatActionProposalStatus;
+    /** A `failed` proposal: the code the tool returned, shown beside the message. */
+    failureCode?: string;
+    /** A `failed` proposal: why, in words. */
+    failureMessage?: ReactNode;
+    /** The confirm button. With neither this nor `actions`, no buttons. */
+    onConfirm?: () => void;
+    /** The reject button. */
+    onReject?: () => void;
+    confirmLabel?: string;
+    rejectLabel?: string;
+    /** An answer is being sent: both buttons are disabled and Confirm shows its spinner. */
+    busy?: boolean;
+    /** Disables both buttons without the spinner (a read-only viewer). */
+    disabled?: boolean;
+    /** Replaces the two buttons (a split button, a reason dialog's trigger). Shown while `pending` only. */
+    actions?: ReactNode;
+} & Omit<ComponentProps<'section'>, 'title' | 'children'>;
+/**
+ * A card in a chat thread for an action an assistant proposes and the user
+ * confirms or rejects. Once answered, the focus moves to the status line so
+ * a screen reader reads the outcome.
+ */
+export declare function ChatActionProposal({ title, summary, toolLabel, children, deadline, status, failureCode, failureMessage, onConfirm, onReject, confirmLabel, rejectLabel, busy, disabled, actions, className, ...props }: ChatActionProposalProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/chat/proposal/chat-action-proposal.rules.d.ts

@@ -0,0 +1,17 @@
+import { IconName } from '@fortawesome/fontawesome-common-types';
+import { BadgeTone } from '../../../display/badge/badge.js';
+/** Where a proposed action stands. Only `pending` can still be answered. */
+export type ChatActionProposalStatus = 'pending' | 'running' | 'confirmed' | 'failed' | 'rejected' | 'expired';
+type StatusLook = {
+    tone: BadgeTone;
+    icon: IconName;
+    label: string;
+};
+/** Each status: a tone, an icon and its English fallback (`material.chat.proposal.status.<status>`). Colour is never the only signal. */
+export declare const PROPOSAL_STATUS: Record<ChatActionProposalStatus, StatusLook>;
+/** The buttons show only while the proposal waits for an answer. */
+export declare function proposalAnswerable(status: ChatActionProposalStatus): boolean;
+/** The state of a tool step in a message list. */
+export type ChatToolActivityState = 'running' | 'ok' | 'failed';
+export declare const TOOL_STATE: Record<ChatToolActivityState, StatusLook>;
+export {};

package/dist/lib/components/ui/widgets/chat/proposal/chat-tool-activity.d.ts

@@ -0,0 +1,16 @@
+import { ComponentProps, ReactNode } from 'react';
+import { ChatToolActivityState } from './chat-action-proposal.rules.js';
+export type { ChatToolActivityState };
+export type ChatToolActivityProps = {
+    /** The tool's name (`search_students`) or a friendly label. */
+    name: ReactNode;
+    /** Default `running`. */
+    state?: ChatToolActivityState;
+    /** A short result or error under the name. */
+    detail?: ReactNode;
+} & Omit<ComponentProps<'div'>, 'children'>;
+/**
+ * One compact row for a tool step the assistant took, inside a
+ * `ChatMessageList`: the name, then Running, Done or Failed with its icon.
+ */
+export declare function ChatToolActivity({ name, state, detail, className, ...props }: ChatToolActivityProps): import("react").JSX.Element;

package/dist/lib/i18n/resources/en/en.d.ts

@@ -129,6 +129,7 @@ export declare const en: {
             retry: string;
             remove: string;
             "replace-named": string;
+            "remove-named": string;
             failed: string;
             "error-status": string;
             "error-status-code": string;
@@ -253,6 +254,25 @@ export declare const en: {
                 open: string;
                 close: string;
             };
+            proposal: {
+                status: {
+                    pending: string;
+                    running: string;
+                    confirmed: string;
+                    failed: string;
+                    rejected: string;
+                    expired: string;
+                };
+                confirm: string;
+                reject: string;
+                "respond-by": string;
+                "expired-at": string;
+            };
+            tool: {
+                running: string;
+                ok: string;
+                failed: string;
+            };
         };
         gallery: {
             label: string;
@@ -1370,6 +1390,11 @@ export declare const en: {
             stay: string;
             leave: string;
         };
+        "stale-notice": {
+            title: string;
+            description: string;
+            reload: string;
+        };
         "load-more": {
             shown: string;
             "shown-count": string;
@@ -3006,5 +3031,20 @@ export declare const en: {
             label: string;
             column: string;
         };
+        "record-actions": {
+            archive: string;
+            restore: string;
+            delete: string;
+            archived: string;
+            restored: string;
+            undo: string;
+            failed: string;
+            "archive-title": string;
+            "archive-description": string;
+            "archive-confirm": string;
+            "delete-title": string;
+            "delete-description": string;
+            "delete-confirm": string;
+        };
     };
 };

package/dist/lib/i18n/resources/en/material.json.d.ts

@@ -119,6 +119,7 @@ declare const _default: {
 		"retry": "Retry",
 		"remove": "Remove",
 		"replace-named": "Replace {name}",
+		"remove-named": "Remove {name}",
 		"failed": "Upload failed",
 		"error-status": "Upload failed with status {status}",
 		"error-status-code": "Upload failed with status {status} ({code})",
@@ -242,6 +243,25 @@ declare const _default: {
 		"widget": {
 			"open": "Open chat",
 			"close": "Close chat"
+		},
+		"proposal": {
+			"status": {
+				"pending": "Awaiting your answer",
+				"running": "Running",
+				"confirmed": "Confirmed",
+				"failed": "Failed",
+				"rejected": "Rejected",
+				"expired": "Expired"
+			},
+			"confirm": "Confirm",
+			"reject": "Reject",
+			"respond-by": "Respond by",
+			"expired-at": "Expired on"
+		},
+		"tool": {
+			"running": "Running",
+			"ok": "Done",
+			"failed": "Failed"
 		}
 	},
 	"gallery": {
@@ -1360,6 +1380,11 @@ declare const _default: {
 		"stay": "Stay",
 		"leave": "Leave"
 	},
+	"stale-notice": {
+		"title": "This record changed",
+		"description": "Someone else saved this record before you. What you typed is kept. Reload the record to see their version.",
+		"reload": "Reload the record"
+	},
 	"load-more": {
 		"shown": "Showing {shown} of {total}",
 		"shown-count": "{shown, plural, one {# shown} other {# shown}}",
@@ -2995,6 +3020,21 @@ declare const _default: {
 	"row-menu": {
 		"label": "Actions for {name}",
 		"column": "Actions"
+	},
+	"record-actions": {
+		"archive": "Archive",
+		"restore": "Restore",
+		"delete": "Delete permanently",
+		"archived": "{name} archived",
+		"restored": "{name} restored",
+		"undo": "Undo",
+		"failed": "The action failed.",
+		"archive-title": "Archive {name}?",
+		"archive-description": "{name} will be hidden. You can restore it later.",
+		"archive-confirm": "Archive",
+		"delete-title": "Delete {name} permanently?",
+		"delete-description": "This cannot be undone.",
+		"delete-confirm": "Delete permanently"
 	}
 }
 ;

package/dist/lib/i18n/resources/fr/fr.d.ts

@@ -129,6 +129,7 @@ export declare const fr: {
             retry: string;
             remove: string;
             "replace-named": string;
+            "remove-named": string;
             failed: string;
             "error-status": string;
             "error-status-code": string;
@@ -253,6 +254,25 @@ export declare const fr: {
                 open: string;
                 close: string;
             };
+            proposal: {
+                status: {
+                    pending: string;
+                    running: string;
+                    confirmed: string;
+                    failed: string;
+                    rejected: string;
+                    expired: string;
+                };
+                confirm: string;
+                reject: string;
+                "respond-by": string;
+                "expired-at": string;
+            };
+            tool: {
+                running: string;
+                ok: string;
+                failed: string;
+            };
         };
         gallery: {
             label: string;
@@ -1370,6 +1390,11 @@ export declare const fr: {
             stay: string;
             leave: string;
         };
+        "stale-notice": {
+            title: string;
+            description: string;
+            reload: string;
+        };
         "load-more": {
             shown: string;
             "shown-count": string;
@@ -3006,5 +3031,20 @@ export declare const fr: {
             label: string;
             column: string;
         };
+        "record-actions": {
+            archive: string;
+            restore: string;
+            delete: string;
+            archived: string;
+            restored: string;
+            undo: string;
+            failed: string;
+            "archive-title": string;
+            "archive-description": string;
+            "archive-confirm": string;
+            "delete-title": string;
+            "delete-description": string;
+            "delete-confirm": string;
+        };
     };
 };

package/dist/lib/i18n/resources/fr/material.json.d.ts

@@ -119,6 +119,7 @@ declare const _default: {
 		"retry": "Réessayer",
 		"remove": "Supprimer",
 		"replace-named": "Remplacer {name}",
+		"remove-named": "Supprimer {name}",
 		"failed": "Échec de l'envoi",
 		"error-status": "Échec de l'envoi (statut {status})",
 		"error-status-code": "Échec de l'envoi (statut {status}, {code})",
@@ -242,6 +243,25 @@ declare const _default: {
 		"widget": {
 			"open": "Ouvrir la discussion",
 			"close": "Fermer la discussion"
+		},
+		"proposal": {
+			"status": {
+				"pending": "En attente de votre réponse",
+				"running": "En cours",
+				"confirmed": "Confirmée",
+				"failed": "Échec",
+				"rejected": "Refusée",
+				"expired": "Expirée"
+			},
+			"confirm": "Confirmer",
+			"reject": "Refuser",
+			"respond-by": "Répondre avant le",
+			"expired-at": "Expirée le"
+		},
+		"tool": {
+			"running": "En cours",
+			"ok": "Terminé",
+			"failed": "Échec"
 		}
 	},
 	"gallery": {
@@ -1360,6 +1380,11 @@ declare const _default: {
 		"stay": "Rester",
 		"leave": "Quitter"
 	},
+	"stale-notice": {
+		"title": "Cet enregistrement a changé",
+		"description": "Quelqu’un d’autre a enregistré cet enregistrement avant vous. Ce que vous avez saisi est conservé. Rechargez l’enregistrement pour voir sa version.",
+		"reload": "Recharger l’enregistrement"
+	},
 	"load-more": {
 		"shown": "Affichage de {shown} sur {total}",
 		"shown-count": "{shown, plural, one {# affiché} other {# affichés}}",
@@ -2995,6 +3020,21 @@ declare const _default: {
 	"row-menu": {
 		"label": "Actions pour {name}",
 		"column": "Actions"
+	},
+	"record-actions": {
+		"archive": "Archiver",
+		"restore": "Restaurer",
+		"delete": "Supprimer définitivement",
+		"archived": "{name} archivé",
+		"restored": "{name} restauré",
+		"undo": "Annuler",
+		"failed": "L’action a échoué.",
+		"archive-title": "Archiver {name} ?",
+		"archive-description": "{name} sera masqué. Vous pourrez le restaurer plus tard.",
+		"archive-confirm": "Archiver",
+		"delete-title": "Supprimer {name} définitivement ?",
+		"delete-description": "Cette action est irréversible.",
+		"delete-confirm": "Supprimer définitivement"
 	}
 }
 ;

package/dist/lib/i18n/resources/resources.d.ts

@@ -127,6 +127,7 @@ export declare const resources: {
                 retry: string;
                 remove: string;
                 "replace-named": string;
+                "remove-named": string;
                 failed: string;
                 "error-status": string;
                 "error-status-code": string;
@@ -251,6 +252,25 @@ export declare const resources: {
                     open: string;
                     close: string;
                 };
+                proposal: {
+                    status: {
+                        pending: string;
+                        running: string;
+                        confirmed: string;
+                        failed: string;
+                        rejected: string;
+                        expired: string;
+                    };
+                    confirm: string;
+                    reject: string;
+                    "respond-by": string;
+                    "expired-at": string;
+                };
+                tool: {
+                    running: string;
+                    ok: string;
+                    failed: string;
+                };
             };
             gallery: {
                 label: string;
@@ -1368,6 +1388,11 @@ export declare const resources: {
                 stay: string;
                 leave: string;
             };
+            "stale-notice": {
+                title: string;
+                description: string;
+                reload: string;
+            };
             "load-more": {
                 shown: string;
                 "shown-count": string;
@@ -3004,6 +3029,21 @@ export declare const resources: {
                 label: string;
                 column: string;
             };
+            "record-actions": {
+                archive: string;
+                restore: string;
+                delete: string;
+                archived: string;
+                restored: string;
+                undo: string;
+                failed: string;
+                "archive-title": string;
+                "archive-description": string;
+                "archive-confirm": string;
+                "delete-title": string;
+                "delete-description": string;
+                "delete-confirm": string;
+            };
         };
     };
     fr: {
@@ -3128,6 +3168,7 @@ export declare const resources: {
                 retry: string;
                 remove: string;
                 "replace-named": string;
+                "remove-named": string;
                 failed: string;
                 "error-status": string;
                 "error-status-code": string;
@@ -3252,6 +3293,25 @@ export declare const resources: {
                     open: string;
                     close: string;
                 };
+                proposal: {
+                    status: {
+                        pending: string;
+                        running: string;
+                        confirmed: string;
+                        failed: string;
+                        rejected: string;
+                        expired: string;
+                    };
+                    confirm: string;
+                    reject: string;
+                    "respond-by": string;
+                    "expired-at": string;
+                };
+                tool: {
+                    running: string;
+                    ok: string;
+                    failed: string;
+                };
             };
             gallery: {
                 label: string;
@@ -4369,6 +4429,11 @@ export declare const resources: {
                 stay: string;
                 leave: string;
             };
+            "stale-notice": {
+                title: string;
+                description: string;
+                reload: string;
+            };
             "load-more": {
                 shown: string;
                 "shown-count": string;
@@ -6005,6 +6070,21 @@ export declare const resources: {
                 label: string;
                 column: string;
             };
+            "record-actions": {
+                archive: string;
+                restore: string;
+                delete: string;
+                archived: string;
+                restored: string;
+                undo: string;
+                failed: string;
+                "archive-title": string;
+                "archive-description": string;
+                "archive-confirm": string;
+                "delete-title": string;
+                "delete-description": string;
+                "delete-confirm": string;
+            };
         };
     };
 };