@sapia-ai/chatbot-v3 1.2.0 → 1.3.0

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;

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/TextAnswerInput/TextAnswerInput.d.ts

@@ -4,6 +4,10 @@ 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. */
@@ -52,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, allowEmptySubmit, minWords, maxWords, recommendedWords, placeholder, sendLabel, onBelowMinimum, wordCountLabel, shortResponseHint, goodResponseHint, maxWordsHint, footer, inputLabel, richText, toolbarLabels, allowPaste, onBlockedPaste, 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/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/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

@@ -14,9 +14,12 @@ export type HeaderProps = {
  * 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 a truncating 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.
+ * 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/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;