@nxgt/material 3.57.0 → 3.59.0

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

@@ -0,0 +1,32 @@
+import { ChatLayoutValue } from './chat-layout-context.js';
+import { ChatMessageProps } from './chat-message.types.js';
+/** The props of a `ChatMessage` that shape its content; the others go to the row's `div`. */
+declare const CONTENT_KEYS: readonly ["variant", "avatar", "avatarFallback", "avatarSrc", "timestamp", "toolName", "isStreaming", "isLoading", "status", "onRetry", "footer", "copyable", "copyText", "children", "groupPosition", "author", "edited", "replyTo", "onReply", "onDelete", "onReact", "reactionSuggestions", "reactions", "onReactionToggle", "menuItems"];
+export type ChatMessageContent = Pick<ChatMessageProps, (typeof CONTENT_KEYS)[number]>;
+/** Splits a message's props into its content props and the `div` props. */
+export declare function splitChatMessageProps(props: Omit<ChatMessageProps, 'layout' | 'density'>): {
+    content: ChatMessageContent;
+    dom: Omit<ChatMessageProps, 'layout' | 'density' | keyof ChatMessageContent>;
+};
+/** What a message derives from its props and the list's layout, shared by its row and its body. */
+export declare function chatMessageView(content: ChatMessageContent, { layout, density }: ChatLayoutValue): {
+    variant: import('./chat-message.variants.js').ChatMessageVariant;
+    groupPosition: import('./chat-group.js').ChatGroupPosition;
+    status: import('./chat-message-meta.js').ChatMessageStatus;
+    layout: import('./chat-layout-context.js').ChatLayout;
+    density: import('./chat-layout-context.js').ChatDensity;
+    flat: boolean;
+    isUser: boolean;
+    lead: boolean;
+    tail: boolean;
+    failed: boolean;
+    metaTime: import('react').ReactNode;
+    isLoading: boolean;
+    edited: boolean;
+    alignEnd: boolean;
+    hasAvatar: boolean;
+    copyText: string | undefined;
+    hasMeta: boolean;
+};
+export type ChatMessageView = ReturnType<typeof chatMessageView>;
+export {};

package/dist/lib/components/ui/widgets/chat/partials/chat-composer-notices.d.ts

@@ -0,0 +1,8 @@
+import { ChatComposerProps } from '../chat-composer.js';
+import { useChatComposer } from '../use-chat-composer.js';
+type NoticesProps = Pick<ChatComposerProps, 'value' | 'onValueChange' | 'onSend' | 'suggestions' | 'onSuggestionSelect' | 'mentions'> & {
+    composer: ReturnType<typeof useChatComposer>;
+};
+/** What sits above the field: quick replies, the send error and the mention list. */
+export declare function ChatComposerNotices({ composer, value, onValueChange, onSend, suggestions, onSuggestionSelect, mentions, }: NoticesProps): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/widgets/chat/partials/chat-composer-surface.d.ts

@@ -0,0 +1,11 @@
+import { ChatComposerProps } from '../chat-composer.js';
+import { useChatComposer } from '../use-chat-composer.js';
+type SurfaceProps = Pick<ChatComposerProps, 'value' | 'onValueChange' | 'attachments' | 'onAttachmentsChange' | 'accept' | 'maxFiles' | 'maxLength' | 'actions' | 'emojis' | 'replyTo' | 'onCancelReply' | 'onStop' | 'isLoading' | 'onSend' | 'suggestions' | 'onSuggestionSelect' | 'mentions'> & {
+    composer: ReturnType<typeof useChatComposer>;
+    floating: boolean;
+};
+/** The composer's rounded field: the quoted reply, the attachments and the input row. */
+export declare function ChatComposerSurface({ composer, floating, ...props }: SurfaceProps): import("react").JSX.Element;
+/** The classes of the composer's form: docked under the list or floating. */
+export declare function composerFormClass(floating: boolean): string;
+export {};

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

@@ -0,0 +1,4 @@
+/** The placeholder row shown while a conversation loads. */
+export declare function ChatConversationItemSkeleton({ className, }: {
+    className?: string;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,10 @@
+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, }: {
+    title: ReactNode;
+    preview?: ReactNode;
+    timestamp?: ReactNode;
+    unreadCount?: number;
+    isActive: boolean;
+    isTyping: boolean;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+/** The inbox's left column: an optional header and the scrolling conversation list. */
+export declare function ChatInboxList({ list, listHeader, hidden, }: {
+    list: ReactNode;
+    listHeader?: ReactNode;
+    /** Hides the column below the `md` container width (the thread is showing). */
+    hidden: boolean;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+/** The inbox's right column: the thread with its back bar, or the "pick a conversation" state. */
+export declare function ChatInboxThread({ thread, context, onBack, hidden, }: {
+    thread?: ReactNode;
+    context: {
+        back: () => void;
+    };
+    onBack: () => void;
+    /** Hides the column below the `md` container width (the list is showing). */
+    hidden: boolean;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/chat/partials/chat-message-action-menus.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+/** Classes of the toolbar's icon buttons. */
+export declare const BUTTON = "size-7 [&_svg]:size-3.5";
+type Side = 'start' | 'end' | 'row';
+/** The toolbar's reaction picker: a menu of emojis. */
+export declare function ChatReactMenu({ side, emojis, onReact, }: {
+    side: Side;
+    emojis: string[];
+    onReact: (emoji: string) => void;
+}): import("react").JSX.Element;
+/** The toolbar's "more" menu: the consumer's items, then delete. */
+export declare function ChatMoreMenu({ side, onDelete, children, }: {
+    side: Side;
+    onDelete?: () => void;
+    children?: ReactNode;
+}): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,6 @@
+import { ChatMessageContent, ChatMessageView } from '../chat-message.view.js';
+/** The column of a message: heading, tool badge, bubble, reactions, status line and footer. */
+export declare function ChatMessageBody({ content, view, }: {
+    content: ChatMessageContent;
+    view: ChatMessageView;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/chat/partials/chat-scroll-to-latest.d.ts

@@ -0,0 +1,7 @@
+/** The floating "scroll to latest" button over the list's bottom edge. */
+export declare function ChatScrollToLatest({ visible, count, label, onClick, }: {
+    visible: boolean;
+    count: number;
+    label?: string;
+    onClick: () => void;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/chat/partials/chat-typing-row.d.ts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+import { ChatDensity, ChatLayout } from '../chat-layout-context.js';
+/** The "someone is typing" row at the end of the list, with the typer's avatar. */
+export declare function ChatTypingRow({ density, layout, avatar, label, }: {
+    density: ChatDensity;
+    layout: ChatLayout;
+    avatar?: ReactNode;
+    label?: string;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/chat/use-chat-inbox-pane.d.ts

@@ -0,0 +1,13 @@
+import { ChatInboxPane } from './chat-inbox.js';
+/** The inbox's pane (list or thread), controlled or not, and the context handed to the thread. */
+export declare function useChatInboxPane({ pane: controlled, defaultPane, onPaneChange, }: {
+    pane?: ChatInboxPane;
+    defaultPane?: ChatInboxPane;
+    onPaneChange?: (pane: ChatInboxPane) => void;
+}): {
+    pane: ChatInboxPane;
+    setPane: (next: ChatInboxPane) => void;
+    context: {
+        back: () => void;
+    };
+};

package/dist/lib/components/ui/widgets/chat/use-chat-widget-open.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The widget's open state (controlled or not) and its focus hand-off: opening
+ * focuses the message field, closing hands focus back to the launcher when it
+ * was inside the panel.
+ */
+export declare function useChatWidgetOpen({ open: controlled, defaultOpen, onOpenChange, }: {
+    open?: boolean;
+    defaultOpen: boolean;
+    onOpenChange?: (open: boolean) => void;
+}): {
+    open: boolean;
+    setOpen: (next: boolean) => void;
+    launcherRef: import('react').RefObject<HTMLButtonElement | null>;
+    panelRef: import('react').RefObject<HTMLDivElement | null>;
+};
+/** The launcher's name: the consumer's, else "Open chat" / "Close chat". */
+export declare function useLauncherLabel(launcherLabel: string | undefined, open: boolean): string;
+/** The classes of the widget's root: pinned to a corner, only its children take the pointer. */
+export declare function chatWidgetClass(strategy: 'fixed' | 'absolute', side: 'start' | 'end'): string;

package/dist/lib/components/ui/widgets/code-editor/toolbar/code-view-tools.d.ts

@@ -0,0 +1,10 @@
+export type CodeViewToolsProps = {
+    disabled?: boolean;
+    wordWrap: boolean;
+    onWordWrapChange: (wordWrap: boolean) => void;
+    fullscreen?: boolean;
+    onFullscreenChange?: (fullscreen: boolean) => void;
+    onFind: () => void;
+};
+/** The pill's View group: Find, Word wrap and, when offered, Full screen. */
+export declare function CodeViewTools({ disabled, wordWrap, onWordWrapChange, fullscreen, onFullscreenChange, onFind, }: CodeViewToolsProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/code-editor/use-monaco-options.d.ts

@@ -0,0 +1,9 @@
+import { editor } from 'monaco-editor';
+import { CodeEditorOptionsInput } from './code-editor-options.js';
+/**
+ * Monaco's options, memoised on every field: a new label reaches Monaco
+ * through `updateOptions`, as every option does.
+ */
+export declare function useMonacoOptions(input: CodeEditorOptionsInput): editor.IStandaloneEditorConstructionOptions;
+/** The tab size is the model's: set again when it changes after mount. */
+export declare function useModelTabSize(mounted: editor.IStandaloneCodeEditor | undefined, tabSizeInput: number | undefined): void;

package/dist/lib/components/ui/widgets/editor/extensions/custom/accordion/accordion-item-actions.d.ts

@@ -0,0 +1,7 @@
+import { AccordionItemAttrs } from './const.js';
+export type AccordionItemActionsProps = Pick<AccordionItemAttrs, 'title' | 'content'> & {
+    onUpdate: (attrs: Partial<AccordionItemAttrs>) => void;
+    onRemove: () => void;
+};
+/** An item's Edit and Remove buttons, shown on hover of its header. */
+export declare function AccordionItemActions({ title, content, onUpdate, onRemove, }: AccordionItemActionsProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/editor/extensions/custom/action-card/action-card-tile.d.ts

@@ -0,0 +1,10 @@
+import { ActionCardItemAttrs, ActionCardVariant } from './const.js';
+export type ActionCardTileProps = {
+    item: ActionCardItemAttrs;
+    variant: ActionCardVariant;
+    isEditable: boolean;
+    onUpdate: (attrs: Partial<ActionCardItemAttrs>) => void;
+    onRemove: () => void;
+};
+/** One card of the block: a link when read-only, with Edit and Remove when editable. */
+export declare function ActionCardTile({ item, variant, isEditable, onUpdate, onRemove, }: ActionCardTileProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/editor/extensions/custom/select-card/select-card-tile.d.ts

@@ -0,0 +1,11 @@
+import { SelectCardOptionAttrs } from './const.js';
+export type SelectCardTileProps = {
+    option: SelectCardOptionAttrs;
+    active: boolean;
+    isEditable: boolean;
+    onToggle: () => void;
+    onUpdate: (attrs: Partial<SelectCardOptionAttrs>) => void;
+    onRemove: () => void;
+};
+/** One option of the selector: a card that toggles, with Edit and Remove when editable. */
+export declare function SelectCardTile({ option, active, isEditable, onToggle, onUpdate, onRemove, }: SelectCardTileProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/editor/extensions/custom/select-card/toggle-selection.d.ts

@@ -0,0 +1,3 @@
+import { SelectCardMode } from './const.js';
+/** The selected values after a click on `target`: it joins or leaves; a single selector holds one at most. */
+export declare function toggleSelection(mode: SelectCardMode, value: string[], target: string): string[];

package/dist/lib/components/ui/widgets/editor/extensions/custom/shared/use-node-list.d.ts

@@ -0,0 +1,11 @@
+import { ReactNodeViewProps } from '@tiptap/react';
+/**
+ * The list a block keeps in one node attribute (items, options…), with the
+ * three edits every block offers: change one, remove one, add one.
+ */
+export declare function useNodeList<T>(props: ReactNodeViewProps<HTMLDivElement>, attribute: string, makeItem: (count: number) => T): {
+    items: T[];
+    update: (index: number, attrs: Partial<T>) => void;
+    remove: (index: number) => void;
+    add: () => void;
+};

package/dist/lib/components/ui/widgets/editor/extensions/emoji/use-emoji-groups.d.ts

@@ -0,0 +1,13 @@
+import { EmojiItem } from '@tiptap/extension-emoji';
+/**
+ * The picker's tabs (all, recent, general, then one per group) and the
+ * handler that inserts an emoji and moves it to the front of the recents.
+ */
+export declare function useEmojiGroups(emojis: EmojiItem[], onSelect: (value: string) => void): {
+    groups: {
+        all: EmojiItem[];
+        recent: EmojiItem[];
+        general: EmojiItem[];
+    };
+    handleEmojiUpdate: (emojiName: string) => () => void;
+};

package/dist/lib/components/ui/widgets/editor/presets/compact-editor-parts.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+import { EditorLook } from '../core/editor-look.js';
+/** The small toolbar above the text, docked to the card. */
+export declare function CompactEditorHead({ look }: {
+    look: EditorLook;
+}): import("react").JSX.Element;
+/** The strip under the text: the character counter and your `actions`. */
+export declare function CompactEditorFooter({ actions }: {
+    actions: ReactNode;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/editor/presets/document-editor-frame-parts.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { EditorLook } from '../core/editor-look.js';
+/** The side rail: a sticky column that stays below the sticky header. */
+export declare function Rail({ side, children, }: {
+    side: 'start' | 'end';
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** The frame's surface: a bordered card, a column when it holds a floating bar. */
+export declare function frameClass(look: EditorLook, hasBar: boolean, className?: string): string;
+/** The sticky header: who else is editing, the toolbar, the panels. */
+export declare function FrameHeader({ presence, panels, children, }: {
+    presence?: ReactNode;
+    panels?: ReactNode;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** The comment threads, in a margin rail beside the text. */
+export declare function FrameComments({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/editor/presets/document-editor-layout.d.ts

@@ -0,0 +1,5 @@
+import { documentEditorSlots } from './document-editor-slots.js';
+type Slots = Parameters<typeof documentEditorSlots>[0];
+/** The text in its surface: the docked frame or the page, with the slots the props call for. */
+export declare function DocumentEditorLayout(props: Slots): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/widgets/editor/presets/document-editor-overlays.d.ts

@@ -0,0 +1,6 @@
+import { DocumentEditorProps } from './document-editor-types.js';
+/** What floats over the document: the upload signal, menus, panels, comment sync. */
+export declare function DocumentEditorOverlays({ onUpload, onUploadingChange, withComments, commentsAdapter, }: Pick<DocumentEditorProps, 'onUpload' | 'onUploadingChange'> & {
+    withComments: boolean;
+    commentsAdapter?: NonNullable<DocumentEditorProps['comments']>['adapter'];
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/editor/presets/document-editor-page-parts.d.ts

@@ -0,0 +1,25 @@
+import { ReactNode } from 'react';
+import { PageMode } from '../partials/page-mode-switch.js';
+import { ViewerComponents } from '../viewer/types.js';
+/** The sticky header: the Write / Preview / Markdown switch, the toolbar, the panels. */
+export declare function PageHeader({ mode, onModeChange, showSwitch, presence, panels, children, }: {
+    mode: PageMode;
+    onModeChange: (mode: PageMode) => void;
+    showSwitch: boolean;
+    presence?: ReactNode;
+    panels?: ReactNode;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** The sheet: the editor while writing, else the chosen view of its content. */
+export declare function PageSheet({ expressive, handleGutter, mode, previewComponents, children, }: {
+    expressive: boolean;
+    handleGutter: boolean;
+    mode: PageMode;
+    previewComponents?: ViewerComponents;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** Under the sheet; after the floating bar when there is one. */
+export declare function PageFooter({ floating, children, }: {
+    floating: boolean;
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/editor/presets/rich-chat-composer/composer-class.d.ts

@@ -0,0 +1,8 @@
+import { EditorLook } from '../../core/editor-look.js';
+/** The composer card: a pill when collapsed, else rounded by look. */
+export declare function composerClass({ pill, look, editable, className, }: {
+    pill: boolean;
+    look: EditorLook;
+    editable: boolean;
+    className?: string;
+}): string;

package/dist/lib/components/ui/widgets/editor/presets/rich-chat-composer/partials/composer-toolbar.d.ts

@@ -0,0 +1,6 @@
+import { EditorLook } from '../../../core/editor-look.js';
+/** The small formatting toolbar the format toggle reveals above the tools. */
+export declare function ComposerToolbar({ id, look, }: {
+    id: string;
+    look: EditorLook;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/editor/presets/rich-chat-composer/partials/format-buttons.d.ts

@@ -0,0 +1,8 @@
+/** The format toggle that shows the small toolbar, and `@` when there are people to mention. */
+export declare function FormatButtons({ formatOpen, toolbarId, onFormatToggle, mentionable, }: {
+    formatOpen: boolean;
+    /** The id of the toolbar the format toggle reveals. */
+    toolbarId: string;
+    onFormatToggle: () => void;
+    mentionable: boolean;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/editor/presets/use-document-features.d.ts

@@ -0,0 +1,15 @@
+import { DocumentEditorProps } from './document-editor-types.js';
+type Input = Pick<DocumentEditorProps, 'features' | 'mentions' | 'outline' | 'onUpload' | 'uploadOptions' | 'onAssist' | 'assistOptions' | 'comments' | 'collaboration'>;
+/**
+ * The document editor's feature set: the document kit, then yours, the
+ * outline, and the upload, assistant, comments and collaboration features
+ * the props turn on.
+ */
+export declare function useDocumentFeatures({ features, mentions, outline, onUpload, uploadOptions, onAssist, assistOptions, comments, collaboration, }: Input): {
+    defaults: import('../index.js').EditorFeature[];
+    commentsFeature: (import('../index.js').EditorFeature & {
+        key: string;
+    }) | undefined;
+    editorFeatures: import('../index.js').FeatureInput;
+};
+export {};

package/dist/lib/components/ui/widgets/education/questions/partials/question-body.d.ts

@@ -0,0 +1,5 @@
+import { QuestionProps } from '../types.js';
+/** The answer control for the question's kind. */
+export declare function QuestionBody(props: QuestionProps & {
+    labelledBy: string;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/education/questions/partials/question-content.d.ts

@@ -0,0 +1,3 @@
+import { QuestionProps } from '../types.js';
+/** A question's fieldset: prompt, header, media, hint, the answer body and the feedback. */
+export declare function QuestionContent({ question, value, onValueChange, revealed: revealedProp, verdict, points, feedback, disabled, variant, density, showShortcuts, number, showFeedback, }: QuestionProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/education/questions/partials/question-extras.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+/** The hint box a question opens on demand. */
+export declare function QuestionHint({ id, children, }: {
+    id: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** The explanation shown once revealed when the feedback block is off. */
+export declare function QuestionExplanation({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/education/questions/partials/question-outcome.d.ts

@@ -0,0 +1,7 @@
+import { QuestionProps } from '../types.js';
+type Props = Pick<QuestionProps, 'question' | 'value' | 'verdict' | 'points' | 'feedback' | 'showFeedback'> & {
+    revealed: boolean;
+};
+/** What follows a revealed answer: the server's verdict, or the local feedback, or just the explanation when feedback is off. */
+export declare function QuestionOutcome({ question, value, verdict, points, feedback, revealed, showFeedback, }: Props): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/widgets/education/questions/question-options.keyboard.d.ts

@@ -0,0 +1,17 @@
+import { KeyboardEvent } from 'react';
+import { QuestionProps } from './types.js';
+/**
+ * Arrow keys move the focus between the option tiles (wrapping); on a
+ * single-choice question that is not revealed, the focused tile is picked.
+ */
+export declare function moveOptionFocus(event: KeyboardEvent<HTMLDivElement>, { multiple, revealed, onToggle, }: {
+    multiple: boolean;
+    revealed: boolean;
+    onToggle: (id: string) => void;
+}): void;
+/** The tiles' grid: four columns of pictures, a side-by-side pair, or one or two columns. */
+export declare function optionsGridClass({ pictures, pair, density, }: {
+    pictures: boolean;
+    pair: boolean;
+    density: QuestionProps['density'];
+}): string;

package/dist/lib/components/ui/widgets/education/questions/question.d.ts

@@ -1,2 +1,2 @@
 import { QuestionProps } from './types.js';
-export declare function QuestionCard({ question, value, onValueChange, revealed: revealedProp, verdict, points, feedback, disabled, className, variant, density, showShortcuts, number, showFeedback, }: QuestionProps): import("react").JSX.Element;
+export declare function QuestionCard({ question, value, onValueChange, revealed, verdict, points, feedback, disabled, className, variant, density, showShortcuts, number, showFeedback, }: QuestionProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/education/questions/types.d.ts

@@ -19,7 +19,7 @@ export type QuestionMedia = QuestionImage & {
     name?: string;
 };
 /** The server's verdict on an answer: shown as given, never recomputed. */
-export type QuestionVerdict = 'correct' | 'incorrect' | 'pending';
+export type QuestionVerdict = 'correct' | 'incorrect' | 'pending' | 'unanswered';
 /** Points earned out of the points the question is worth. */
 export type QuestionPoints = {
     awarded: number;
@@ -62,7 +62,8 @@ export type QuestionProps = {
     /**
      * The verdict the server gave, shown as given (no comparison with
      * `question.correct` in the browser). It reveals the card; `pending` is a
-     * free answer still waiting for a grader. `question.correct` may still
+     * free answer still waiting for a grader; `unanswered` is a question left
+     * blank (no value is shown, the points read 0). `question.correct` may still
      * be passed to highlight the correct choices.
      */
     verdict?: QuestionVerdict;

package/dist/lib/components/ui/widgets/education/quizzes/partials/quiz-shortcuts.d.ts

@@ -0,0 +1,6 @@
+import { Question } from '../../questions/types.js';
+/** The keyboard hints under the nav: 1-N to answer, Enter to continue. Large containers only. */
+export declare function QuizShortcuts({ current, revealed, }: {
+    current: Question | undefined;
+    revealed: boolean;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/education/quizzes/partials/results-actions.d.ts

@@ -0,0 +1,7 @@
+/** The results' buttons: retry the wrong answers (when there are some) and try again. */
+export declare function ResultsActions({ wrong, onRetryWrong, onReset, }: {
+    /** How many questions were answered wrong. */
+    wrong: number;
+    onRetryWrong: () => void;
+    onReset: () => void;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/education/quizzes/partials/results-ring.d.ts

@@ -0,0 +1,5 @@
+/** The wavy score ring with the percentage in its middle. */
+export declare function ResultsRing({ percent, tone, }: {
+    percent: number;
+    tone: 'success' | 'primary' | 'warning';
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/education/quizzes/quiz.flow.d.ts

@@ -0,0 +1,29 @@
+import { QuestionAnswer } from '../questions/types.js';
+import { QuizProps } from './types.js';
+export type QuizPrimary = 'check' | 'next' | 'submit';
+/**
+ * The primary button of the nav: Check (practice, once there is something to
+ * check), else Next, else Submit on the last question; and whether it can act.
+ */
+export declare function quizPrimary({ mode, revealed, answer, blocked, last, canNext, canSubmit, }: {
+    mode: NonNullable<QuizProps['mode']>;
+    revealed: boolean;
+    answer: QuestionAnswer | null;
+    blocked: boolean;
+    last: boolean;
+    canNext: boolean;
+    canSubmit: boolean;
+}): {
+    primary: QuizPrimary;
+    canPrimary: boolean;
+};
+/** The quiz props the model passes on as they are, with the defaults of density and shortcuts. */
+export declare function quizConfig(props: QuizProps): {
+    readonly title: import('react').ReactNode;
+    readonly description: import('react').ReactNode;
+    readonly timeLimit: number | undefined;
+    readonly timerPaused: boolean | undefined;
+    readonly passingScore: number | undefined;
+    readonly density: "comfortable" | "compact";
+    readonly showShortcuts: boolean;
+};

package/dist/lib/components/ui/widgets/education/quizzes/quiz.slice.d.ts

@@ -1,4 +1,5 @@
 import { PayloadAction } from '@reduxjs/toolkit';
+import { BoundSliceActions } from '../../../../../lib/redux/bind-slice-actions.js';
 import { QuestionAnswer } from '../questions/types.js';
 import { QuizChromeState } from './types.js';
 /** The chrome with every field present. */
@@ -202,6 +203,8 @@ export declare const quizActions: import('@reduxjs/toolkit').CaseReducerActions<
     }, action: PayloadAction<string[]>) => void;
     reset: () => Required<QuizChromeState>;
 }, "quiz">;
+/** The quiz slice's actions bound to its dispatch, as `useSliceReducer` hands them. */
+export type QuizActions = BoundSliceActions<typeof quizActions>;
 export declare const quizSelectors: {
     selectCanNext: (state: QuizChromeState, length: number) => boolean;
     selectCanPrev: (state: QuizChromeState) => boolean;

package/dist/lib/components/ui/widgets/education/quizzes/use-quiz-actions.d.ts

@@ -0,0 +1,20 @@
+import { Question, QuestionAnswer } from '../questions/types.js';
+import { QuizPrimary } from './quiz.flow.js';
+import { QuizActions } from './quiz.slice.js';
+import { QuizProps } from './types.js';
+/** Submit, next and the primary button's action (check, next or submit). */
+export declare function useQuizActions({ actions, questions, answers, current, answer, roundLength, primary, canPrimary, onSubmit, }: {
+    actions: QuizActions;
+    questions: Question[];
+    answers: Record<string, QuestionAnswer>;
+    current: Question | undefined;
+    answer: QuestionAnswer | null;
+    roundLength: number;
+    primary: QuizPrimary;
+    canPrimary: boolean;
+    onSubmit: QuizProps['onSubmit'];
+}): {
+    submit: (timedOut?: boolean) => void;
+    next: () => void;
+    runPrimary: () => void;
+};

package/dist/lib/components/ui/widgets/education/quizzes/use-quiz-flow.d.ts

@@ -0,0 +1,29 @@
+import { Question } from '../questions/types.js';
+import { QuizState } from './quiz.slice.js';
+import { QuizProps } from './types.js';
+/**
+ * What the quiz derives from its state: the current question and its answer,
+ * whether its verdict shows, the score, the wrong ids, and what the primary
+ * button (check, next or submit) is and can do.
+ */
+export declare function useQuizFlow({ questions, round, state, mode, }: {
+    questions: Question[];
+    round: Question[];
+    state: QuizState;
+    mode: NonNullable<QuizProps['mode']>;
+}): {
+    current: Question;
+    answer: string | string[] | null;
+    revealed: boolean;
+    score: {
+        correct: number;
+        total: number;
+        percent: number;
+    };
+    wrong: string[];
+    answered: number;
+    canNext: boolean;
+    canSubmit: boolean;
+    primary: import('./quiz.flow.js').QuizPrimary;
+    canPrimary: boolean;
+};

package/dist/lib/components/ui/widgets/education/quizzes/use-quiz-lifecycle.d.ts

@@ -0,0 +1,12 @@
+import { Question } from '../questions/types.js';
+import { QuizActions, QuizState } from './quiz.slice.js';
+import { scoreQuiz } from './quiz.utils.js';
+import { QuizProps } from './types.js';
+/** The questions of the current round (all, or a retry's), keeping the index inside them. */
+export declare function useQuizRound(questions: Question[], retryIds: string[] | null, currentIndex: number, actions: QuizActions): Question[];
+/** Calls `onComplete` once per submission, with the score and the answers. */
+export declare function useQuizComplete({ state, score, onComplete, }: {
+    state: QuizState;
+    score: ReturnType<typeof scoreQuiz>;
+    onComplete: QuizProps['onComplete'];
+}): void;

package/dist/lib/components/ui/widgets/education/quizzes/use-quiz.d.ts

@@ -1,8 +1,9 @@
 import { Question, QuestionAnswer } from '../questions/types.js';
+import { QuizPrimary } from './quiz.flow.js';
 import { QuizState } from './quiz.slice.js';
 import { scoreQuiz } from './quiz.utils.js';
 import { QuizProps } from './types.js';
-export type QuizPrimary = 'check' | 'next' | 'submit';
+export type { QuizPrimary };
 export type QuizModel = Pick<QuizProps, 'title' | 'description' | 'timeLimit' | 'timerPaused' | 'passingScore'> & {
     questions: Question[];
     /** The questions of this round: all of them, or a retry's. */

package/dist/lib/components/ui/widgets/event-calendar/partials/calendar-step-buttons.d.ts

@@ -0,0 +1,2 @@
+/** The previous and next arrows: one period back or forward. */
+export declare function CalendarStepButtons(): import("react").JSX.Element;