@sapia-ai/chatbot-v3 1.0.0

package/dist/sapia.d.ts

@@ -0,0 +1,4 @@
+export { createChatbot, type Chatbot, type CreateChatbotOptions } from './embed/createChatbot';
+export { DEFAULT_CONTAINER_ID } from './embed/constants';
+export { CHATBOT_EVENTS } from './core/events';
+export { PHChatBot, PHChatBotCallbackFunction, CHATBOT_CONTAINER_ID } from './embed/compat';

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

@@ -0,0 +1,47 @@
+import { ReactNode, Ref } from 'react';
+import { ChatLogItem } from '../types';
+export type SliderLabels = {
+    label: string;
+    hint: string;
+    submitLabel: string;
+};
+export type DropdownLabels = {
+    searchPlaceholder: string;
+    searchLabel: string;
+};
+export type MediaLabels = {
+    uploadProgress: string;
+    uploadFailed: string;
+    retryUpload: string;
+    playVideo: string;
+    videoAnswer: string;
+    /** Accessible title for a backend-delivered embedded agent video. */
+    embeddedVideo: string;
+};
+export type ChatBubbleLabels = {
+    retry: string;
+    optionsGroup: string;
+    edit: string;
+    cancelEdit: string;
+    /** Eyebrow on every agent transcript turn, e.g. "Interviewer". */
+    speakerLabel: string;
+};
+export type ChatBubbleProps = {
+    item: ChatLogItem;
+    labels: ChatBubbleLabels;
+    sliderLabels: SliderLabels;
+    dropdownLabels: DropdownLabels;
+    mediaLabels: MediaLabels;
+    onRetry?: () => void;
+    onSelectOption?: (optionId: string) => void;
+    onSubmitSlider?: (score: number) => void;
+    onEdit?: (questionId: string) => void;
+    onCancelEdit?: () => void;
+    onRetryVideo?: () => void;
+    onResolveVideoUrl?: (questionId: string, extension: string) => Promise<string>;
+    /** Attaches to the bubble's root <li> so the log can scroll it into view. */
+    rootRef?: Ref<HTMLLIElement>;
+    /** Rendered inside the question card body (e.g. the video recorder). */
+    footer?: ReactNode;
+};
+export declare const ChatBubble: ({ item, labels, sliderLabels, dropdownLabels, mediaLabels, onRetry, onSelectOption, onSubmitSlider, onEdit, onCancelEdit, onRetryVideo, onResolveVideoUrl, rootRef, footer, }: ChatBubbleProps) => import("react").JSX.Element;

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

@@ -0,0 +1,33 @@
+import { ReactNode } from 'react';
+import { ChatBubbleLabels, DropdownLabels, MediaLabels, SliderLabels } from '../ChatBubble/ChatBubble';
+import { ChatLogItem } from '../types';
+export type ChatLogProps = {
+    items: ChatLogItem[];
+    typing: boolean;
+    /** Stable screen-reader label for the loading status, e.g. "Interviewer is typing". */
+    typingLabel: string;
+    /** Phase-1 loading phrase shown after a candidate answer. */
+    typingReadingLabel: string;
+    /** Phase-2 loading phrase (and the only one on the first agent turn). */
+    typingThinkingLabel: string;
+    bubbleLabels: ChatBubbleLabels;
+    sliderLabels: SliderLabels;
+    dropdownLabels: DropdownLabels;
+    mediaLabels: MediaLabels;
+    onRetry?: () => void;
+    onSelectOption?: (optionId: string) => void;
+    onSubmitSlider?: (score: number) => void;
+    onEdit?: (questionId: string) => void;
+    onCancelEdit?: () => void;
+    onRetryVideo?: () => void;
+    onResolveVideoUrl?: (questionId: string, extension: string) => Promise<string>;
+    /** Node rendered inside the question card identified by cardFooterItemId (e.g. video recorder). */
+    cardFooter?: ReactNode;
+    /** Bubble id whose card receives cardFooter. */
+    cardFooterItemId?: string;
+};
+/**
+ * Scrollable interview transcript. aria-live announces new bubbles to screen
+ * readers; the log auto-scrolls to the newest message.
+ */
+export declare const ChatLog: ({ items, typing, typingLabel, typingReadingLabel, typingThinkingLabel, bubbleLabels, sliderLabels, dropdownLabels, mediaLabels, onRetry, onSelectOption, onSubmitSlider, onEdit, onCancelEdit, onRetryVideo, onResolveVideoUrl, cardFooter, cardFooterItemId, }: ChatLogProps) => import("react").JSX.Element;

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

@@ -0,0 +1,17 @@
+export type TypingIndicatorProps = {
+    /** Stable accessible description for screen readers, e.g. "Interviewer is typing". */
+    ariaLabel: string;
+    /** Phase-1 status shown briefly when responding to a candidate answer. */
+    readingLabel: string;
+    /** Phase-2 status (and the only status when there's no answer to read). */
+    thinkingLabel: string;
+    /** True when the previous message is a candidate answer (enables the "reading" phase). */
+    afterAnswer: boolean;
+};
+/**
+ * Pre-stream loading status: a phrase + animated dots rendered directly in the
+ * transcript (no bubble/background) under the interviewer left rule. When
+ * responding to an answer it reads "Reading your response…" then "Thinking about
+ * it…"; on the first agent turn it shows only the "thinking" phrase.
+ */
+export declare const TypingIndicator: ({ ariaLabel, readingLabel, thinkingLabel, afterAnswer, }: TypingIndicatorProps) => import("react").JSX.Element;

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

@@ -0,0 +1,71 @@
+export type ChatItemSender = 'agent' | 'candidate';
+/** A selectable answer option (MCQ/dropdown option or button-group button). */
+export type ChatOptionItem = {
+    id: string;
+    text: string;
+};
+/** Video answer state rendered inside a candidate bubble. */
+export type ChatVideoItem = {
+    /** Upload in flight: progress 0–1. */
+    uploadProgress?: number;
+    /** Local recorded blob for immediate playback (just-submitted answer). */
+    blob?: Blob;
+    /** For historical answers: fetch a signed playback URL via these. */
+    questionId: string;
+    extension?: string;
+    /** Upload failed; retry available. */
+    failed?: boolean;
+};
+/** A backend-delivered embedded video shown inside an agent bubble (intro/explainer). */
+export type ChatEmbeddedVideoItem = {
+    /** The raw video URL from the agent content (YouTube/Vimeo/generic). */
+    url: string;
+};
+/** Rating-slider state rendered inside a candidate bubble. */
+export type ChatSliderItem = {
+    min: number;
+    max: number;
+    defaultValue: number;
+    /** The submitted score once answered. */
+    submittedValue?: number;
+    /** Slider accepts input (current unanswered question only). */
+    enabled: boolean;
+};
+export type ChatLogItem = {
+    id: string;
+    sender: ChatItemSender;
+    /** Message paragraphs in display order. */
+    paragraphs: string[];
+    /** Visual treatment: plain conversational bubble, or the elevated question card. */
+    variant?: 'bubble' | 'card';
+    /** Card-only eyebrow, e.g. "Question 2 of 4" or "Single choice question". */
+    questionLabel?: string;
+    /** Card-only dark badge, e.g. "Video". Present only on video question cards. */
+    questionBadge?: string;
+    /** Sanitized rich-text HTML for a candidate answer; rendered instead of plain paragraphs. */
+    answerHtml?: string;
+    /** Selectable options rendered inside the bubble (option-type questions). */
+    options?: ChatOptionItem[];
+    /** How the options render: a button list (MCQ/BGQ) or a searchable dropdown. */
+    optionsKind?: 'list' | 'dropdown';
+    /** The chosen option once answered (or while submitting). */
+    selectedOptionId?: string;
+    /** Options accept clicks (current unanswered question only). */
+    optionsEnabled?: boolean;
+    /** Rating slider rendered inside the bubble (slider questions). */
+    slider?: ChatSliderItem;
+    /** Video answer rendered inside the bubble (video questions). */
+    video?: ChatVideoItem;
+    /** Backend-delivered video embedded inside an agent bubble. */
+    embeddedVideo?: ChatEmbeddedVideoItem;
+    /** Answer submission in flight. */
+    pending?: boolean;
+    /** Answer submission failed; retry available. */
+    failed?: boolean;
+    /** An answered bubble whose answer can be re-edited; carries the question id. */
+    editableQuestionId?: string;
+    /** This bubble's answer is currently being re-edited. */
+    editing?: boolean;
+    /** Agent text is still streaming in; renders a blinking caret at the end. */
+    streaming?: boolean;
+};

package/dist/ui/constants.d.ts

@@ -0,0 +1,2 @@
+/** Class scoping every style in dist/sapia-chatbot.css (see src/styles/index.css). */
+export declare const WIDGET_ROOT_CLASS = "sapia-chatbot";

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

@@ -0,0 +1,18 @@
+import { ChatOptionItem } from '../../chat/types';
+export type DropdownInputProps = {
+    options: ChatOptionItem[];
+    selectedOptionId?: string;
+    /** Accepts input; false once answered or while submitting. */
+    enabled?: boolean;
+    pending?: boolean;
+    searchPlaceholder: string;
+    searchLabel: string;
+    groupLabel: string;
+    onSelect?: (optionId: string) => void;
+};
+/**
+ * Searchable option picker for DROPDOWN questions (ported from legacy
+ * components/Dropdown): a filter input over a visible option list — clicking
+ * an option submits it. AntD/ahooks-free.
+ */
+export declare const DropdownInput: ({ options, selectedOptionId, enabled, pending, searchPlaceholder, searchLabel, groupLabel, onSelect, }: DropdownInputProps) => import("react").JSX.Element;

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

@@ -0,0 +1,18 @@
+import { ChatOptionItem } from '../../chat/types';
+export type OptionListProps = {
+    options: ChatOptionItem[];
+    /** The chosen option (highlighted; stays highlighted after answering). */
+    selectedOptionId?: string;
+    /** Options accept clicks; false once answered or while submitting. */
+    enabled?: boolean;
+    /** Submission in flight for the selected option. */
+    pending?: boolean;
+    groupLabel: string;
+    onSelect?: (optionId: string) => void;
+};
+/**
+ * Selectable answer options for MCQ/terms-accept/button-group questions.
+ * Pure presentational: single select, real buttons, keyboard accessible.
+ * Replaces legacy components/OptionList (AntD-free).
+ */
+export declare const OptionList: ({ options, selectedOptionId, enabled, pending, groupLabel, onSelect, }: OptionListProps) => import("react").JSX.Element;

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

@@ -0,0 +1,19 @@
+export type PhoneCountryOption = {
+    code: string;
+    callingCode: string;
+    name: string;
+    flag: string;
+};
+export type PhoneAnswerInputProps = {
+    countries: PhoneCountryOption[];
+    defaultCountryCode: string;
+    disabled?: boolean;
+    countryLabel: string;
+    inputLabel: string;
+    placeholder: string;
+    sendLabel: string;
+    /** 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). */
+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

@@ -0,0 +1,19 @@
+export type SliderInputProps = {
+    min: number;
+    max: number;
+    defaultValue: number;
+    /** The submitted score once answered (renders read-only at this value). */
+    submittedValue?: number;
+    /** Slider accepts input; false once answered or while submitting. */
+    enabled?: boolean;
+    pending?: boolean;
+    label: string;
+    hint: string;
+    submitLabel: string;
+    onSubmit?: (score: number) => void;
+};
+/**
+ * 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;

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

@@ -0,0 +1,32 @@
+export type RichToolbarLabels = {
+    toolbar: string;
+    bold: string;
+    italic: string;
+    underline: string;
+    bulletList: string;
+    numberList: string;
+};
+export type TextAnswerInputProps = {
+    /** Receives plain text and, in rich mode, the sanitized HTML rendering. */
+    onSubmit: (text: string, html?: string) => void;
+    disabled?: boolean;
+    /** Character rules from the current question (legacy RuleName min/max/recommended). */
+    minLength?: number;
+    maxLength?: number;
+    recommendedLength?: 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;
+    /** 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;
+};
+export declare const TextAnswerInput: ({ onSubmit, disabled, minLength, maxLength, recommendedLength, placeholder, sendLabel, minLengthHint, okHint, footer, inputLabel, richText, toolbarLabels, onPaste, }: TextAnswerInputProps) => import("react").JSX.Element;

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

@@ -0,0 +1,54 @@
+import { RefObject } from 'react';
+export type VideoRecorderLabels = {
+    openCamera: string;
+    startRecording: string;
+    stopRecording: string;
+    reRecord: string;
+    submit: string;
+    cameraError: string;
+    preview: string;
+    /** Design-only setup/recording labels (optional; fall back to no chrome). */
+    camera?: string;
+    microphone?: string;
+    on?: string;
+    off?: string;
+    finishHint?: string;
+    cameraOff?: string;
+};
+export type VideoRecorderPhase = 'idle' | 'preview' | 'recording' | 'review' | 'error';
+export type VideoRecorderProps = {
+    phase: VideoRecorderPhase;
+    elapsedSeconds: number;
+    maxSeconds: number;
+    /** True once a recording is captured and ready to submit. */
+    hasResult: boolean;
+    showPreview: boolean;
+    videoRef: RefObject<HTMLVideoElement | null>;
+    disabled?: boolean;
+    labels: VideoRecorderLabels;
+    onOpenCamera: () => void;
+    /** Begins the 3-2-1 countdown before recording (preferred over onStartRecording). */
+    onBeginCountdown?: () => void;
+    onStartRecording?: () => void;
+    onStopRecording: () => void;
+    onReRecord: () => void;
+    onSubmit: () => void;
+    /** Camera/mic toggle state + handlers (setup phase). */
+    camOn?: boolean;
+    micOn?: boolean;
+    onToggleCamera?: () => void;
+    onToggleMicrophone?: () => void;
+    /** 3-2-1 countdown value before recording (null/<=0 = hidden). */
+    countdown?: number | null;
+    /** Precomposed "n/max attempts" label; hides the re-record button at the cap. */
+    attemptsLabel?: string;
+    canRetake?: boolean;
+    /** Object URL for the recorded take, played back in review. */
+    reviewUrl?: string | null;
+};
+/**
+ * Camera preview + record/review controls, styled to the Chat-3000 design.
+ * The MediaRecorder lifecycle, countdown, toggles and attempts live in
+ * react/useVideoRecorder; this component only renders state + buttons.
+ */
+export declare const VideoRecorder: ({ phase, elapsedSeconds, maxSeconds, hasResult, showPreview, videoRef, disabled, labels, onOpenCamera, onBeginCountdown, onStartRecording, onStopRecording, onReRecord, onSubmit, camOn, micOn, onToggleCamera, onToggleMicrophone, countdown, attemptsLabel, canRetake, reviewUrl, }: VideoRecorderProps) => import("react").JSX.Element;

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

@@ -0,0 +1,11 @@
+export type EmbeddedVideoProps = {
+    /** Raw agent-delivered video URL (YouTube/Vimeo/generic). */
+    url: string;
+    /** Accessible title/label for the embed. */
+    label: string;
+};
+/**
+ * Backend-delivered video embedded inside an agent bubble (intro/explainer).
+ * Thin wrapper that lazy-loads the heavy player stack on demand.
+ */
+export declare const EmbeddedVideo: ({ url, label }: EmbeddedVideoProps) => import("react").JSX.Element;

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

@@ -0,0 +1,16 @@
+export type EmbeddedVideoPlayerProps = {
+    /** Raw agent-delivered video URL (YouTube/Vimeo/generic). */
+    url: string;
+    /** Accessible title/label for the embed. */
+    label: string;
+};
+/**
+ * Renders a backend-delivered embedded video inside an agent bubble. Ported from
+ * legacy phapp-fi-widget components/VideoPlayer: Vimeo URLs use the dedicated
+ * VimeoPlayer (custom iframe attributes / referrerPolicy), everything else
+ * (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.
+ */
+export declare const EmbeddedVideoPlayer: ({ url, label }: EmbeddedVideoPlayerProps) => import("react").JSX.Element;

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

@@ -0,0 +1,20 @@
+export type VimeoPlayerProps = {
+    src: string;
+    /** Accessible title applied to the embed iframe. */
+    title: string;
+    width?: string;
+    height?: string;
+    onPlay?: () => void;
+    onPause?: () => void;
+    onEnded?: () => void;
+    onError?: (error: Error) => void;
+};
+/**
+ * Vimeo embed via @vimeo/player. Ported from legacy phapp-fi-widget
+ * components/VimeoPlayer — the iframe is created manually so the required
+ * attributes (notably referrerPolicy="origin", critical for domain-restricted
+ * videos, and the autoplay/fullscreen allow-list) are present on first render.
+ * Deviation from legacy: dropped the useAssessmentStateContext "pause when the
+ * recorder opens" coupling — the v3 library has no such global state.
+ */
+export declare const VimeoPlayer: ({ src, title, width, height, onPlay, onPause, onEnded, onError, }: VimeoPlayerProps) => import("react").JSX.Element;

package/dist/ui/media/UploadProgress/UploadProgress.d.ts

@@ -0,0 +1,7 @@
+export type UploadProgressProps = {
+    /** 0–1. */
+    value: number;
+    label: string;
+};
+/** Accessible determinate progress bar for a video upload. */
+export declare const UploadProgress: ({ value, label }: UploadProgressProps) => import("react").JSX.Element;

package/dist/ui/media/VideoPlayer/VideoPlayer.d.ts

@@ -0,0 +1,13 @@
+export type VideoPlayerProps = {
+    /** Local recorded blob (just-submitted answer), played without a network call. */
+    blob?: Blob;
+    /** Lazily resolves a signed playback URL (historical answers). */
+    resolveUrl?: () => Promise<string>;
+    playLabel: string;
+    label: string;
+};
+/**
+ * Plays a recorded video answer. Uses the local blob when available, otherwise
+ * fetches a signed URL on demand. Native <video controls> — keyboard accessible.
+ */
+export declare const VideoPlayer: ({ blob, resolveUrl, playLabel, label }: VideoPlayerProps) => import("react").JSX.Element;

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

@@ -0,0 +1,6 @@
+import { ButtonHTMLAttributes, ReactNode } from 'react';
+export type ButtonProps = {
+    children: ReactNode;
+    variant?: 'primary' | 'ghost';
+} & ButtonHTMLAttributes<HTMLButtonElement>;
+export declare const Button: ({ children, variant, type, className, ...rest }: ButtonProps) => import("react").JSX.Element;

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

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+export type DialogAction = {
+    label: string;
+    onClick: () => void;
+    variant?: 'primary' | 'ghost';
+};
+export type DialogProps = {
+    open: boolean;
+    title: string;
+    children?: ReactNode;
+    actions: DialogAction[];
+    /** Called on Escape / overlay click; omit to force an action choice. */
+    onClose?: () => void;
+};
+/** Modal dialog on Radix (focus trap, aria handled). Replaces AntD Modal. */
+export declare const Dialog: ({ open, title, children, actions, onClose }: DialogProps) => import("react").JSX.Element;

package/dist/ui/richText.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Strips everything except a small inline/list formatting allow-list and removes
+ * all attributes (class/style/href/on*), re-adding only controlled list/block
+ * spacing. Returns "" when no DOM is available (SSR).
+ */
+export declare const sanitizeRichText: (html: string) => string;

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

@@ -0,0 +1,21 @@
+export type AccessVerificationLabels = {
+    title: string;
+    description: string;
+    inputLabel: string;
+    placeholder: string;
+    submit: string;
+    mismatchError: string;
+};
+export type AccessVerificationFormProps = {
+    /** Masked email hint, e.g. "du*****@sapia.ai". */
+    emailHint?: string;
+    mismatch?: boolean;
+    submitting?: boolean;
+    labels: AccessVerificationLabels;
+    onSubmit: (email: string) => void;
+};
+/**
+ * Email gate shown before the interview when the assessment requires
+ * verification (legacy AccessVerification). Pure presentational.
+ */
+export declare const AccessVerificationForm: ({ emailHint, mismatch, submitting, labels, onSubmit, }: AccessVerificationFormProps) => import("react").JSX.Element;

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

@@ -0,0 +1,11 @@
+export type CopyLinkButtonProps = {
+    copyLabel: string;
+    copiedLabel: string;
+    /** 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.
+ */
+export declare const CopyLinkButton: ({ copyLabel, copiedLabel, className }: CopyLinkButtonProps) => import("react").JSX.Element;

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

@@ -0,0 +1,15 @@
+export type DoneScreenLabels = {
+    title: string;
+    subtitle: string;
+    nextLabel: string;
+    steps: [string, string, string];
+    ratingPrompt: string;
+};
+export type DoneScreenProps = {
+    labels: DoneScreenLabels;
+};
+/**
+ * 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;

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

@@ -0,0 +1,13 @@
+export type HeaderProps = {
+    title: string;
+    /** Muted second line, e.g. "Sapia chat interview". */
+    subtitle?: string;
+    logoUrl?: string;
+    logoAlt?: string;
+    /** Progress pill text, e.g. "Question 2 of 4" or "Getting started". */
+    progressLabel?: string;
+};
+/**
+ * Interview header: branding/title, a muted subtitle, and a progress pill.
+ */
+export declare const Header: ({ title, subtitle, logoUrl, logoAlt, progressLabel, }: HeaderProps) => import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+export type PreparingScreenProps = {
+    /** Status text, e.g. "Preparing your interview…". */
+    label: string;
+};
+/**
+ * Full-screen loading state shown while the interview is being fetched/started.
+ * Re-skin of the previous loading paragraph; announced via role="status".
+ */
+export declare const PreparingScreen: ({ label }: PreparingScreenProps) => import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+export type ProgressBarProps = {
+    /** Answered question count. */
+    value: number;
+    /** Total question count; bar hidden when 0. */
+    max: number;
+    /** Accessible name, e.g. "Interview progress". */
+    label: string;
+};
+export declare const ProgressBar: ({ value, max, label }: ProgressBarProps) => import("react").JSX.Element | null;

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

@@ -0,0 +1,22 @@
+export type WelcomeScreenLabels = {
+    /** Eyebrow above the greeting, e.g. "Chat interview". */
+    eyebrow: string;
+    greeting: string;
+    intro: string;
+    /** Copy-link affordance, e.g. "Copy link · resume later". */
+    copyLinkResume: string;
+    copied: string;
+    next: string;
+};
+export type WelcomeScreenProps = {
+    labels: WelcomeScreenLabels;
+    logoUrl?: string;
+    logoAlt?: string;
+    onNext: () => void;
+};
+/**
+ * Pre-interview welcome gate. Greets the candidate (name/role/company when the
+ * API supplies them) and starts the interview on "Begin". A centred column with
+ * a smile eyebrow — the library bundles no stock photography.
+ */
+export declare const WelcomeScreen: ({ labels, logoUrl, logoAlt, onNext }: WelcomeScreenProps) => import("react").JSX.Element;

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

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+export type WidgetRootProps = {
+    children: ReactNode;
+    /** CSS custom properties (--sc-*) produced by core/theme. */
+    themeVariables?: Record<string, string>;
+    dir?: 'ltr' | 'rtl';
+};
+/**
+ * Root element of the widget. Carries the scoping class for all packaged
+ * styles plus the theme CSS variables, so theming never re-renders children.
+ */
+export declare const WidgetRoot: ({ children, themeVariables, dir }: WidgetRootProps) => import("react").JSX.Element;