@sapia-ai/chatbot-v3 1.1.1 → 1.3.0

package/dist/ui/chat/ChatBubble/ChatBubble.d.ts

@@ -1,8 +1,8 @@
 import { ReactNode, Ref } from 'react';
-import { ChatLogItem } from '../types';
+import { ChatCardKind, ChatLogItem } from '../types';
 export type SliderLabels = {
+    /** Accessible name for the range input — the backend's question is the visible prompt. */
     label: string;
-    hint: string;
     submitLabel: string;
 };
 export type DropdownLabels = {
@@ -47,10 +47,17 @@ export type ChatBubbleProps = {
     rootRef?: Ref<HTMLLIElement>;
     /** Rendered inside the question card body (e.g. the video recorder). */
     footer?: ReactNode;
+    /**
+     * Replaces the quiet editing marker on the bubble under edit (the edit banner, for an
+     * option question that opens no composer for a docked one to sit above).
+     */
+    editingFooter?: ReactNode;
+    /** Draws one card the item names; the react glue owns each card's copy and data. */
+    renderCard?: (kind: ChatCardKind) => ReactNode;
 };
 /**
  * Memoized: the transcript re-renders on every store write (roughly 60/s while an agent message
  * streams in), and each render re-parses every settled paragraph's markdown from scratch. Default
  * shallow comparison suffices — ChatLog is passed stable item and label references.
  */
-export declare const ChatBubble: import('react').MemoExoticComponent<({ item, labels, sliderLabels, dropdownLabels, mediaLabels, onRetry, onSelectOption, onSubmitSlider, onEdit, onRetryVideo, onResolveVideoUrl, rootRef, footer, }: ChatBubbleProps) => import("react").JSX.Element>;
+export declare const ChatBubble: import('react').MemoExoticComponent<({ item, labels, sliderLabels, dropdownLabels, mediaLabels, onRetry, onSelectOption, onSubmitSlider, onEdit, onRetryVideo, onResolveVideoUrl, rootRef, footer, editingFooter, renderCard, }: ChatBubbleProps) => import("react").JSX.Element>;

package/dist/ui/chat/ChatLog/ChatLog.d.ts

@@ -1,6 +1,7 @@
 import { ReactNode } from 'react';
 import { ChatBubbleLabels, DropdownLabels, MediaLabels, SliderLabels } from '../ChatBubble/ChatBubble';
-import { ChatLogItem } from '../types';
+import { HintDisclosureLabels } from '../HintDisclosure/HintDisclosure';
+import { ChatCardKind, ChatLogItem } from '../types';
 export type ChatLogProps = {
     items: ChatLogItem[];
     typing: boolean;
@@ -11,6 +12,8 @@ export type ChatLogProps = {
     /** Phase-2 loading phrase (and the only one on the first agent turn). */
     typingThinkingLabel: string;
     bubbleLabels: ChatBubbleLabels;
+    /** Copy for the collapse/expand toggle on a folded hint run. */
+    hintLabels: HintDisclosureLabels;
     sliderLabels: SliderLabels;
     dropdownLabels: DropdownLabels;
     mediaLabels: MediaLabels;
@@ -24,12 +27,14 @@ export type ChatLogProps = {
     cardFooter?: ReactNode;
     /** Bubble id whose card receives cardFooter. */
     cardFooterItemId?: string;
-    /** Node pinned as the first transcript entry (e.g. the pre-interview summary card). */
-    header?: ReactNode;
+    /** Node rendered under the bubble being re-edited, in place of its quiet editing marker. */
+    editingFooter?: ReactNode;
+    /** Draws one card an item names (the summary, the resume link); passed through to ChatBubble. */
+    renderCard?: (kind: ChatCardKind) => ReactNode;
 };
 /**
  * Scrollable interview transcript. The log auto-scrolls to the newest message; settled turns
  * are announced once through a separate visually-hidden live region (the transcript itself is
  * deliberately not one — see the announcer effect below).
  */
-export declare const ChatLog: ({ items, typing, typingLabel, typingReadingLabel, typingThinkingLabel, bubbleLabels, sliderLabels, dropdownLabels, mediaLabels, onRetry, onSelectOption, onSubmitSlider, onEdit, onRetryVideo, onResolveVideoUrl, cardFooter, cardFooterItemId, header, }: ChatLogProps) => import("react").JSX.Element;
+export declare const ChatLog: ({ items, typing, typingLabel, typingReadingLabel, typingThinkingLabel, bubbleLabels, hintLabels, sliderLabels, dropdownLabels, mediaLabels, onRetry, onSelectOption, onSubmitSlider, onEdit, onRetryVideo, onResolveVideoUrl, cardFooter, cardFooterItemId, editingFooter, renderCard, }: ChatLogProps) => import("react").JSX.Element;

package/dist/ui/chat/EditBanner/EditBanner.d.ts

@@ -6,11 +6,17 @@ export type EditBannerProps = {
     /** Cancel copy, server-supplied ("Press ESC or click here to cancel editing"). */
     cancelLabel: string;
     onCancel: () => void;
+    /**
+     * Drops the docking chrome so the strip can sit in the transcript instead. An option
+     * question opens no composer, so a docked strip would strand the cancel control at the
+     * bottom of the widget while the options it belongs to sit further up the log.
+     */
+    inline?: boolean;
 };
 /**
- * Docked strip naming the answer under edit and offering the single cancel control.
- * Repeats the composer's own column classes so it lines up with the input box at any
+ * Strip naming the answer under edit and offering the single cancel control. Docked, it
+ * repeats the composer's own column classes so it lines up with the input box at any
  * container width. role="status" so entering edit mode is announced; the Escape
  * shortcut it advertises is bound in react/SapiaChatbot.
  */
-export declare const EditBanner: ({ label, questionLabel, cancelLabel, onCancel }: EditBannerProps) => import("react").JSX.Element;
+export declare const EditBanner: ({ label, questionLabel, cancelLabel, onCancel, inline, }: EditBannerProps) => import("react").JSX.Element;

package/dist/ui/chat/HintDisclosure/HintDisclosure.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+export type HintDisclosureLabels = {
+    /** Opens the folded hints, e.g. "Read the full brief". */
+    expand: string;
+    /** Closes them again, e.g. "Show less". */
+    collapse: string;
+};
+export type HintDisclosureProps = {
+    /** The foldable hint bubbles — each renders its own <li>. */
+    children: ReactNode;
+    labels: HintDisclosureLabels;
+    /** Open state, owned by ChatLog: the bubble above needs it too, for the trailing ellipsis. */
+    expanded: boolean;
+    onToggle: () => void;
+};
+/**
+ * Progressive disclosure for a stack of agent hints. Open on arrival so the brief is read as it
+ * streams, then folded away once it has served its purpose.
+ */
+export declare const HintDisclosure: ({ children, labels, expanded, onToggle }: HintDisclosureProps) => import("react").JSX.Element;

package/dist/ui/chat/SummaryCard/SummaryCard.d.ts

@@ -8,39 +8,34 @@ export declare enum SummaryKind {
     RATING = "rating",
     GENERIC = "generic"
 }
-/** One breakdown row: a count with its FE-owned label and (optional) description. */
+/** One breakdown row: a count with its resolved label and (optional) description. */
 export type SummaryCategory = {
     count: number;
     label: string;
+    /** May carry markdown emphasis — the video row bolds its retry budget. */
     description?: string;
     /** Drives the row icon; falls back to a generic mark when omitted. */
     kind?: SummaryKind;
 };
+/** Footer line linking out to the privacy policy; omitted when no URL is configured. */
+export type SummaryPrivacy = {
+    text: string;
+    linkLabel: string;
+    url: string;
+};
 export type SummaryCardProps = {
-    /** Backend-authored heading, e.g. "Welcome to your interview — here's what to expect.". */
-    title: string;
-    /** Uppercase label for the total panel, e.g. "Total". */
+    /** Uppercase label for the total panel, e.g. "TOTAL". */
     totalLabel: string;
-    /** Total-questions meta, e.g. "3 questions". */
-    questionsLabel: string;
-    /** Estimated-time meta, e.g. "~9 min". */
-    minutesLabel: string;
-    /** Per-category breakdown rows (already mapped to FE labels). */
+    /** Resolved total line, e.g. "10 Questions (~ 30 minutes)". */
+    countLabel: string;
+    /** Per-category breakdown rows (already mapped to their labels). */
     categories: SummaryCategory[];
-    /** BE-authored Continue label; rendered as a button only when onContinue is set (gate mode). */
-    continueLabel?: string;
-    /** Continue handler; its presence switches the card into blocking gate mode. */
-    onContinue?: () => void;
-    /** Play the pre-interview reveal (typing dots → title types in → card fades in). */
-    animate?: boolean;
-    /** Accessible label for the reveal's typing-dots phase. */
-    typingLabel?: string;
-    /** Phrase shown beside the dots during the reveal ("Thinking…"). */
-    thinkingLabel?: string;
+    privacy?: SummaryPrivacy;
+    /** Appended inside links that open a new tab. */
+    opensNewTab: string;
 };
 /**
- * Pre-interview summary. An elevated white card with the agent's welcome title,
- * a centred TOTAL panel (question count + estimated time), and an accent-barred
- * breakdown list — one icon row per question type.
+ * "What to expect": an elevated white card with a centred TOTAL panel (question count and time
+ * estimate) and an accent-barred breakdown list — one icon row per question type.
  */
-export declare const SummaryCard: ({ title, totalLabel, questionsLabel, minutesLabel, categories, continueLabel, onContinue, animate, typingLabel, thinkingLabel, }: SummaryCardProps) => import("react").JSX.Element;
+export declare const SummaryCard: ({ totalLabel, countLabel, categories, privacy, opensNewTab, }: SummaryCardProps) => import("react").JSX.Element;

package/dist/ui/chat/types.d.ts

@@ -8,14 +8,20 @@ export declare enum ChatBubbleVariant {
     CARD = "card"
 }
 /**
- * How options render: a numbered button list (MCQ/BGQ), a searchable dropdown, or a
- * single full-width CTA pill for one-off control prompts (consent / submit).
+ * How options render: a numbered button list (MCQ/BGQ) or a searchable dropdown, both drawn inside
+ * the bubble, or ACTION — a one-off control prompt (consent / submit / break acknowledgement) whose
+ * single option is drawn by the bottom dock instead, so it survives an arbitrarily tall step.
  */
 export declare enum ChatOptionsKind {
     LIST = "list",
     DROPDOWN = "dropdown",
     ACTION = "action"
 }
+/** A card drawn in place of one agent content bubble, instead of that bubble's text. */
+export declare enum ChatCardKind {
+    ASSESSMENT_SUMMARY = "assessment-summary",
+    COPY_LINK = "copy-link"
+}
 /** A selectable answer option (MCQ/dropdown option or button-group button). */
 export type ChatOptionItem = {
     id: string;
@@ -58,6 +64,11 @@ export type ChatLogItem = {
     questionLabel?: string;
     /** Card-only dark badge, e.g. "Video". Present only on video question cards. */
     questionBadge?: string;
+    /**
+     * Cards drawn after this bubble's paragraphs. The backend authors a marker bubble as the last
+     * bubble of its step, so appending them is the bubble's own order.
+     */
+    cards?: ChatCardKind[];
     /** Selectable options rendered inside the bubble (option-type questions). */
     options?: ChatOptionItem[];
     optionsKind?: ChatOptionsKind;
@@ -81,4 +92,9 @@ export type ChatLogItem = {
     editing?: boolean;
     /** Agent text is still streaming in; renders a blinking caret at the end. */
     streaming?: boolean;
+    /**
+     * An unanswerable agent aside. More than two in a row collapse behind a disclosure —
+     * a long intro brief otherwise pushes the first question off screen.
+     */
+    isHint?: boolean;
 };

package/dist/ui/constants.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Flat ceiling on an answer regardless of the question's word rule (legacy
+ * MAX_CHARACTER_COUNT). Guards the request body when a question ships no maximum.
+ */
+export declare const MAX_ANSWER_CHARACTERS = 5000;
 /** Class scoping every style in dist/sapia-chatbot.css (see src/styles/index.css). */
 export declare const WIDGET_ROOT_CLASS = "sapia-chatbot";
 export declare const SLIM_SCROLLBAR = "sc:[scrollbar-width:thin] sc:[scrollbar-color:#8f8f96_transparent] sc:[&::-webkit-scrollbar]:w-1.5 sc:[&::-webkit-scrollbar-track]:bg-transparent sc:[&::-webkit-scrollbar-thumb]:rounded-full sc:[&::-webkit-scrollbar-thumb]:bg-field-border";

package/dist/ui/hooks/usePreventPaste.d.ts

@@ -0,0 +1,17 @@
+import { RefObject } from 'react';
+type UsePreventPasteParams = {
+    /** When true the hook is a no-op (paste is permitted). */
+    allowPaste: boolean;
+    /** Wrapper element of the composer; only events inside it are blocked. */
+    containerRef: RefObject<HTMLElement | null>;
+    /** Called for each blocked attempt (drives the INVALID_PASTE_ANSWER_ACTION log). */
+    onBlockedPaste?: () => void;
+};
+/**
+ * Blocks paste and drop inside a composer. Listeners are bound to `document` in the capture phase
+ * rather than to the element: assistive overlays such as ReciteMe re-parse the host DOM, which
+ * detaches per-node and React-synthetic handlers (legacy TG-21437). `beforeinput` covers keyboards
+ * that insert pasted text without firing a `paste` event.
+ */
+export declare const usePreventPaste: ({ allowPaste, containerRef, onBlockedPaste, }: UsePreventPasteParams) => void;
+export {};

package/dist/ui/inputs/LocationAnswerInput/LocationAnswerInput.d.ts

@@ -0,0 +1,34 @@
+export type LocationSuggestionItem = {
+    id: string;
+    /** Accessible option label — the full prediction text. */
+    label: string;
+    /** Emphasised leading part ("Melbourne"). */
+    mainText: string;
+    /** Trailing context ("VIC, Australia"); may be empty. */
+    secondaryText: string;
+};
+export type LocationAnswerInputProps = {
+    suggestions: LocationSuggestionItem[];
+    disabled?: boolean;
+    /** Autocomplete is unavailable: the listbox never opens and Send is the only path. */
+    manualMode?: boolean;
+    placeholder: string;
+    inputLabel: string;
+    sendLabel: string;
+    suggestionsLabel: string;
+    /** Announced once a set of predictions settles, e.g. "5 locations found". */
+    suggestionsAnnouncement: (count: number) => string;
+    /** Text the input opens on when re-editing an answered location. */
+    initialText?: string;
+    onSearch: (input: string) => void;
+    onSelectSuggestion: (suggestion: LocationSuggestionItem) => void;
+    /** Send pressed with typed text and no prediction chosen. */
+    onSubmitText: (text: string) => void;
+};
+/**
+ * Location PII input: an ARIA combobox over the composer's chrome, backed by Google Places
+ * predictions (ported from legacy PlacesAutoComplete). Choosing a prediction submits immediately,
+ * as legacy does; Send always submits whatever is typed, so an unlisted town or an unreachable
+ * Places API never traps the candidate.
+ */
+export declare const LocationAnswerInput: ({ suggestions, disabled, manualMode, placeholder, inputLabel, sendLabel, suggestionsLabel, suggestionsAnnouncement, initialText, onSearch, onSelectSuggestion, onSubmitText, }: LocationAnswerInputProps) => import("react").JSX.Element;

package/dist/ui/inputs/PhoneAnswerInput/PhoneAnswerInput.d.ts

@@ -2,7 +2,6 @@ export type PhoneCountryOption = {
     code: string;
     callingCode: string;
     name: string;
-    flag: string;
 };
 export type PhoneAnswerInputProps = {
     countries: PhoneCountryOption[];
@@ -15,5 +14,9 @@ export type PhoneAnswerInputProps = {
     /** Receives the national number text and the selected ISO country code. */
     onSubmit: (text: string, countryCode: string) => void;
 };
-/** Phone PII input: country picker + national number (replaces legacy PhoneEditor). */
+/**
+ * Phone PII input: country picker + national number (replaces legacy PhoneEditor). The picker is a
+ * native select behind a compact trigger, so a phone keeps its own wheel picker over the 240-odd
+ * countries without the closed control having to be wide enough for a country name.
+ */
 export declare const PhoneAnswerInput: ({ countries, defaultCountryCode, disabled, countryLabel, inputLabel, placeholder, sendLabel, onSubmit, }: PhoneAnswerInputProps) => import("react").JSX.Element;

package/dist/ui/inputs/SliderInput/SliderInput.d.ts

@@ -8,7 +8,6 @@ export type SliderInputProps = {
     enabled?: boolean;
     pending?: boolean;
     label: string;
-    hint: string;
     submitLabel: string;
     onSubmit?: (score: number) => void;
 };
@@ -16,4 +15,4 @@ export type SliderInputProps = {
  * Experience-rating slider (legacy renderSlider, AntD-free). Native range
  * input: keyboard accessible (arrow keys) out of the box.
  */
-export declare const SliderInput: ({ min, max, defaultValue, submittedValue, enabled, pending, label, hint, submitLabel, onSubmit, }: SliderInputProps) => import("react").JSX.Element;
+export declare const SliderInput: ({ min, max, defaultValue, submittedValue, enabled, pending, label, submitLabel, onSubmit, }: SliderInputProps) => import("react").JSX.Element;

package/dist/ui/inputs/TextAnswerInput/TextAnswerInput.d.ts

@@ -4,29 +4,50 @@ export type RichToolbarLabels = {
     italic: string;
     bulletList: string;
     numberList: string;
+    /** Opens the composer over the transcript, filling the widget below its chrome. */
+    expand: string;
+    /** Returns it to the inline height. */
+    collapse: string;
 };
 export type TextAnswerInputProps = {
     /** Receives the answer text — markdown in rich mode, plain text otherwise. */
     onSubmit: (text: string) => void;
     disabled?: boolean;
-    /** Character rules from the current question (legacy RuleName min/max/recommended). */
-    minLength?: number;
-    maxLength?: number;
-    recommendedLength?: number;
+    /**
+     * Permits sending an empty composer. Off by default — an empty answer is only meaningful where
+     * the question is optional (the post-interview feedback comment sends a skip).
+     */
+    allowEmptySubmit?: boolean;
+    /** Word bounds from the current question (the BE *TextLength rules are word counts). */
+    minWords?: number;
+    maxWords?: number;
+    recommendedWords?: number;
     placeholder: string;
     sendLabel: string;
-    /** Hint shown while below minLength, e.g. "Please write at least {min} characters". */
-    minLengthHint?: string;
-    /** Affirmation shown once the minimum is met, e.g. "Looking good". */
-    okHint?: string;
+    /**
+     * Called instead of onSubmit when the answer is under minWords, with the count and a
+     * submit callback to run if the candidate chooses to send it anyway. Omit to send short
+     * answers straight through — the minimum only ever warns, it never withholds Send.
+     */
+    onBelowMinimum?: (words: number, submit: () => void) => void;
+    /** Counter label for a word count, e.g. "42 words". */
+    wordCountLabel?: (count: number) => string;
+    /** Counter message while under minWords. */
+    shortResponseHint?: string;
+    /** Counter message between the minimum and the maximum. */
+    goodResponseHint?: string;
+    /** Counter message once maxWords is reached. */
+    maxWordsHint?: string;
     /** Reassurance caption under the composer. */
     footer?: string;
     inputLabel: string;
     /** Enables the rich-text editor + formatting toolbar (plain-text FTQ only). */
     richText?: boolean;
     toolbarLabels?: RichToolbarLabels;
-    /** Called when the candidate pastes (AGC paste logging). */
-    onPaste?: () => void;
+    /** Permits paste for this question (ALLOW_PASTE tag or an internal session). Blocked by default. */
+    allowPaste?: boolean;
+    /** Called for each blocked paste attempt (AGC paste logging). */
+    onBlockedPaste?: () => void;
     /** SC 1.3.5 token for PII questions (e.g. "email", "name"); omitted for free-text answers. */
     autoComplete?: string;
     /** Plain text the composer opens on (re-editing a submitted answer). */
@@ -35,5 +56,11 @@ export type TextAnswerInputProps = {
     initialMarkdown?: string;
     /** Moves focus to the editor on mount (used when an edit opens the composer). */
     focusOnMount?: boolean;
+    /**
+     * Fullscreen state. Owned by the shell rather than here: expanding covers the transcript, which
+     * is a sibling of this component and has to go inert at the same moment.
+     */
+    expanded?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
 };
-export declare const TextAnswerInput: ({ onSubmit, disabled, minLength, maxLength, recommendedLength, placeholder, sendLabel, minLengthHint, okHint, footer, inputLabel, richText, toolbarLabels, onPaste, autoComplete, initialText, initialMarkdown, focusOnMount, }: TextAnswerInputProps) => import("react").JSX.Element;
+export declare const TextAnswerInput: ({ onSubmit, disabled, allowEmptySubmit, minWords, maxWords, recommendedWords, placeholder, sendLabel, onBelowMinimum, wordCountLabel, shortResponseHint, goodResponseHint, maxWordsHint, footer, inputLabel, richText, toolbarLabels, allowPaste, onBlockedPaste, autoComplete, initialText, initialMarkdown, focusOnMount, expanded, onExpandedChange, }: TextAnswerInputProps) => import("react").JSX.Element;

package/dist/ui/media/EmbeddedVideo/EmbeddedVideoPlayer.d.ts

@@ -11,6 +11,6 @@ export type EmbeddedVideoPlayerProps = {
  * (YouTube etc.) uses react-player. Lazy-loaded by ./EmbeddedVideo so react-player
  * and @vimeo/player land in a separate chunk (size budget, ADR-024/ADR-025).
  * Deviation from legacy: dropped the isVideoModuleOpen auto-pause coupling and the
- * fixed-pixel responsive sizing — the embed now fills the full bubble width.
+ * fixed-pixel responsive sizing — the player fills the frame ./EmbeddedVideo supplies.
  */
 export declare const EmbeddedVideoPlayer: ({ url, label }: EmbeddedVideoPlayerProps) => import("react").JSX.Element;

package/dist/ui/primitives/MarkdownText/MarkdownText.d.ts

@@ -0,0 +1,24 @@
+export declare enum MarkdownFlow {
+    /** No block wrapper — for copy that sits inside an existing heading, span or label. */
+    INLINE = "inline",
+    /** Paragraphs with the chat log's spacing, for multi-paragraph copy. */
+    BLOCK = "block"
+}
+export type MarkdownTextProps = {
+    /** Translated copy, possibly carrying markdown emphasis or links. */
+    children: string;
+    flow?: MarkdownFlow;
+    /**
+     * Label for the visually-hidden new-tab warning, e.g. "opens in a new tab". Supplying it is
+     * what makes links open in a new tab: without a warning to announce, a new tab would be an
+     * unannounced context change (SC 3.2.5), so those links stay in the current one.
+     */
+    opensNewTab?: string;
+};
+/**
+ * Renders translated copy as markdown — the backend writes emphasis and links into the
+ * translation file, so the raw template cannot go straight into the DOM. Raw HTML in the
+ * source is ignored rather than injected: react-markdown skips it without rehype-raw, so
+ * no sanitizer is needed here.
+ */
+export declare const MarkdownText: ({ children, flow, opensNewTab, }: MarkdownTextProps) => import("react").JSX.Element;

package/dist/ui/shell/CohortClosedScreen/CohortClosedScreen.d.ts

@@ -0,0 +1,9 @@
+export type CohortClosedScreenLabels = {
+    title: string;
+    message: string;
+};
+export type CohortClosedScreenProps = {
+    labels: CohortClosedScreenLabels;
+};
+/** Terminal screen for an assessment whose cohort has closed — nothing here can be answered. */
+export declare const CohortClosedScreen: ({ labels }: CohortClosedScreenProps) => import("react").JSX.Element;

package/dist/ui/shell/CopyLinkButton/CopyLinkButton.d.ts

@@ -1,11 +1,18 @@
 export type CopyLinkButtonProps = {
     copyLabel: string;
     copiedLabel: string;
+    /**
+     * Link to copy. The widget can be embedded on a host page, so the current URL is only correct
+     * when the widget owns the address bar — pass the assessment's own link whenever it is known.
+     */
+    url?: string;
+    /** Render the duplicate-squares glyph before the label (in-transcript pill). */
+    withIcon?: boolean;
     /** Style overrides; the base only sets cursor/transition. */
     className?: string;
 };
 /**
- * Copies the current page URL (the pause-and-resume link) and flashes a
- * confirmation. Purely client-side — no core/api involvement.
+ * Copies the pause-and-resume link and flashes a confirmation. Purely client-side — no core/api
+ * involvement beyond the URL it is handed.
  */
-export declare const CopyLinkButton: ({ copyLabel, copiedLabel, className }: CopyLinkButtonProps) => import("react").JSX.Element;
+export declare const CopyLinkButton: ({ copyLabel, copiedLabel, url, withIcon, className, }: CopyLinkButtonProps) => import("react").JSX.Element;

package/dist/ui/shell/DoneScreen/DoneScreen.d.ts

@@ -7,9 +7,12 @@ export type DoneScreenLabels = {
 };
 export type DoneScreenProps = {
     labels: DoneScreenLabels;
+    /** Pre-validated absolute URL to continue to; omitted when the host supplied none. */
+    redirectUrl?: string;
+    redirectLabel?: string;
 };
 /**
  * Completion screen shown when the interview has ended. The star rating is
  * decorative only (no submission) per the redesign scope decision.
  */
-export declare const DoneScreen: ({ labels }: DoneScreenProps) => import("react").JSX.Element;
+export declare const DoneScreen: ({ labels, redirectUrl, redirectLabel }: DoneScreenProps) => import("react").JSX.Element;

package/dist/ui/shell/Header/AutoScrollTitle.d.ts

@@ -0,0 +1,15 @@
+export type AutoScrollTitleProps = {
+    title: string;
+};
+/**
+ * The header's branded title. Scrolls itself when it is too long for the container, so the
+ * employer and role can be read in full on a phone instead of clipping forever.
+ *
+ * Motion that starts on its own has to be stoppable: hover, keyboard focus, and touch-and-hold
+ * each pause it. The heading is a tab stop only while it is actually moving — a static title
+ * would be a focus stop that does nothing. Reduced motion drops back to truncation.
+ *
+ * The whole string is always in the DOM, so assistive tech gets the full title whatever is
+ * visible.
+ */
+export declare const AutoScrollTitle: ({ title }: AutoScrollTitleProps) => import("react").JSX.Element;

package/dist/ui/shell/Header/Header.d.ts

@@ -9,5 +9,17 @@ export type HeaderProps = {
 };
 /**
  * Interview header: branding/title, a muted subtitle, and a progress pill.
+ *
+ * The right-hand end of the row always keeps a 44px slot free. Recite Me — and any other
+ * host-page accessibility overlay — pins its launcher to the top-right of the page, on top of
+ * whatever the widget drew there, and the count used to be the casualty.
+ *
+ * Below 640px of *container* width there is no room for a pill beside the title, so the count
+ * renders as a subtitle suffix instead. Container width, not viewport: hosts embed the widget at
+ * arbitrary widths, so a media query would answer the wrong question. `px` and not `rem` so a
+ * host that changes the root font size cannot move the breakpoint.
+ *
+ * The title scrolls itself when it does not fit — see AutoScrollTitle. The subtitle truncates
+ * instead, because it is fixed chrome the candidate loses nothing by not finishing.
  */
 export declare const Header: ({ title, subtitle, logoUrl, logoAlt, progressLabel, }: HeaderProps) => import("react").JSX.Element;

package/dist/ui/shell/Header/useAutoScrollTitle.d.ts

@@ -0,0 +1,16 @@
+import { RefObject } from 'react';
+export type AutoScrollMetrics = {
+    shouldScroll: boolean;
+    /** Pixels of overflow, i.e. how far left the text must travel to end flush right. */
+    distancePx: number;
+    durationMs: number;
+};
+/**
+ * Measures whether the header title overflows its window and how far it has to travel to be read
+ * in full. Returns `shouldScroll: false` when it fits, or when the OS asks for reduced motion.
+ *
+ * One observer on one node: `scrollWidth` reports the full content width through `overflow:
+ * hidden`, so the overflow is a single subtraction and there is nothing to gain from watching the
+ * text separately.
+ */
+export declare const useAutoScrollTitle: (windowRef: RefObject<HTMLElement | null>) => AutoScrollMetrics;

package/dist/ui/shell/TerminalMessageScreen/TerminalMessageScreen.d.ts

@@ -0,0 +1,10 @@
+export type TerminalMessageScreenProps = {
+    /** Backend copy (markdown) explaining why the interview stopped. */
+    message: string;
+};
+/**
+ * Terminal screen for an interview the backend ended with an explanation rather than a
+ * completion — archived cohort or reused assessment. No title: the backend copy is a
+ * self-contained message.
+ */
+export declare const TerminalMessageScreen: ({ message }: TerminalMessageScreenProps) => import("react").JSX.Element;

package/dist/ui/shell/WidgetRoot/themeVariables.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The widget's --sc-* custom properties, for subtrees that render outside the widget root.
+ * Radix portals a dialog to document.body, where the root's inline style no longer cascades and
+ * every brand token silently falls back to its default — a black CTA on a purple-branded
+ * interview. Anything portalled has to paint these on its own outermost node.
+ */
+export declare const ThemeVariablesContext: import('react').Context<Record<string, string> | undefined>;
+export declare const useThemeVariables: () => Record<string, string> | undefined;