@sapia-ai/chatbot-v3 1.1.0 → 1.2.0

package/dist/{jsx-runtime-24G8w2Bf.js → jsx-runtime-CpK9sRtl.js}

@@ -1,4 +1,4 @@
-import { S as e } from "./messages-DCvBcspv.js";
+import { C as e } from "./messages-t5h3u6nr.js";
 //#region ../../node_modules/.pnpm/react@19.2.7/node_modules/react/cjs/react-jsx-runtime.production.js
 var t = /* @__PURE__ */ e(((e) => {
 	var t = Symbol.for("react.transitional.element"), n = Symbol.for("react.fragment");
@@ -21,4 +21,4 @@ var t = /* @__PURE__ */ e(((e) => {
 //#endregion
 export { n as t };
 
-//# sourceMappingURL=jsx-runtime-24G8w2Bf.js.map
+//# sourceMappingURL=jsx-runtime-CpK9sRtl.js.map

package/dist/{messages-DCvBcspv.js → messages-t5h3u6nr.js}

@@ -1968,11 +1968,13 @@ var $ = /* @__PURE__ */ function(e) {
 }({}), Xn = /* @__PURE__ */ function(e) {
 	return e.FI_ATS_ASSESSMENT_ORDER_COMPLETED = "FI_ATS_ASSESSMENT_ORDER_COMPLETED", e.FI_ASSESSMENT_STARTED = "FI_ASSESSMENT_STARTED", e.FI_ASSESSMENT_PII_SAVED = "FI_ASSESSMENT_PII_SAVED", e.FI_ASSESSMENT_PII_COMPLETED = "FI_ASSESSMENT_PII_COMPLETED", e.FI_ASSESSMENT_INPROGRESS = "FI_ASSESSMENT_INPROGRESS", e.FI_ASSESSMENT_COMPLETED = "FI_ASSESSMENT_COMPLETED", e.FI_ASSESSMENT_ENDED = "FI_ASSESSMENT_ENDED", e.FI_ASSESSMENT_DROPPED_OUT = "FI_ASSESSMENT_DROPPED_OUT", e.FI_PREDICTION_STARTED = "FI_PREDICTION_STARTED", e.FI_PREDICTION_COMPLETED = "FI_PREDICTION_COMPLETED", e.FI_ASSESSMENT_DUPLICATED = "FI_ASSESSMENT_DUPLICATED", e;
 }({}), Zn = /* @__PURE__ */ function(e) {
-	return e.TEXT = "Text", e.VOICE_PLAYER = "VoicePlayer", e.VIDEO_PLAYER = "VideoPlayer", e.SLIDER = "Slider", e;
+	return e.SUBMIT_QUESTION = "SUBMIT_QUESTION_MESSAGE", e.FEEDBACK_CUSTOMER_SATISFACTION_QUESTION = "FEEDBACK_CUSTOMER_SATISFACTION_QUESTION_MESSAGE", e;
 }({}), Qn = /* @__PURE__ */ function(e) {
+	return e.TEXT = "Text", e.VOICE_PLAYER = "VoicePlayer", e.VIDEO_PLAYER = "VideoPlayer", e.SLIDER = "Slider", e;
+}({}), $n = /* @__PURE__ */ function(e) {
 	return e.HINT = "Hint", e.QUESTION = "Question", e;
 }({});
 //#endregion
-export { s as C, o as S, Mn as _, Qn as a, Pn as b, qn as c, Jn as d, Bn as f, An as g, jn as h, Gn as i, Wn as l, Ln as m, Yn as n, Un as o, $ as p, Zn as r, Kn as s, Xn as t, Hn as u, On as v, l as w, Nn as x, kn as y };
+export { o as C, Nn as S, l as T, An as _, Zn as a, kn as b, Kn as c, Hn as d, Jn as f, jn as g, Ln as h, Gn as i, qn as l, $ as m, Yn as n, $n as o, Bn as p, Qn as r, Un as s, Xn as t, Wn as u, Mn as v, s as w, Pn as x, On as y };
 
-//# sourceMappingURL=messages-DCvBcspv.js.map
+//# sourceMappingURL=messages-t5h3u6nr.js.map

package/dist/react/AnswerInput.d.ts

@@ -1,12 +1,14 @@
 import { InterviewEngine } from '../core/interview';
 import { Region } from '../api/config';
-import { CurrentInputKind, EditingDraft, TextRules } from './bubbleViewModel';
+import { CurrentInputKind, EditingDraft, WordCountRule } from './bubbleViewModel';
 import { UiStrings } from './strings';
 export type AnswerInputProps = {
     engine: InterviewEngine;
+    /** Scopes the "don't show me this again" opt-out to this interview. */
+    assessmentId: string;
     kind: CurrentInputKind;
     disabled: boolean;
-    textRules: TextRules;
+    wordCountRule: WordCountRule;
     strings: UiStrings;
     candidateCountryCode?: string;
     region: Region;
@@ -14,7 +16,11 @@ export type AnswerInputProps = {
     maxVideoSeconds?: number;
     /** Stored answer to open the composer on when re-editing. */
     draft?: EditingDraft;
-    /** Called when the candidate pastes into a text answer (AGC paste log). */
-    onPaste?: () => void;
+    /** Permits paste in the free-text composer (ALLOW_PASTE tag or an internal session). */
+    allowPaste: boolean;
+    /** The optional post-interview feedback comment: no word rules, and an empty send is a skip. */
+    isFeedbackComment: boolean;
+    /** Called for each blocked paste attempt (AGC paste log). */
+    onBlockedPaste?: () => void;
 };
-export declare const AnswerInput: ({ engine, kind, disabled, textRules, strings, candidateCountryCode, region, maxVideoSeconds, draft, onPaste, }: AnswerInputProps) => import("react").JSX.Element;
+export declare const AnswerInput: ({ engine, assessmentId, kind, disabled, wordCountRule, strings, candidateCountryCode, region, maxVideoSeconds, draft, allowPaste, isFeedbackComment, onBlockedPaste, }: AnswerInputProps) => import("react").JSX.Element;

package/dist/react/SapiaChatbot.d.ts

@@ -11,8 +11,12 @@ export type SapiaChatbotProps = {
     apiOrigin?: string;
     theme?: Theme;
     showHeader?: boolean;
+    /** Internal session (Sapia staff / QA): permits paste on every question. */
+    isInternalUser?: boolean;
     /** Interview language override (e.g. "fr"); defaults to the browser language. */
     language?: string;
+    /** Absolute http(s) URL offered as a "continue" CTA once the interview ends. */
+    redirectUrl?: string;
     /** Receives every widget event; or pass an emitter via createChatbot. */
     onEvent?: ChatbotEventHandler;
     /** @internal used by embed/createChatbot to share its emitter. */
@@ -20,4 +24,4 @@ export type SapiaChatbotProps = {
     /** @internal streaming transport override (mock SSE for the demo / tests). */
     fetchImpl?: typeof fetch;
 };
-export declare const SapiaChatbot: ({ env, region, appId, assessmentId, apiOrigin, theme, showHeader, language, onEvent, emitter, fetchImpl, }: SapiaChatbotProps) => import("react").JSX.Element;
+export declare const SapiaChatbot: ({ env, region, appId, assessmentId, apiOrigin, theme, showHeader, isInternalUser, language, redirectUrl, onEvent, emitter, fetchImpl, }: SapiaChatbotProps) => import("react").JSX.Element;

package/dist/react/bubbleViewModel.d.ts

@@ -1,15 +1,27 @@
 import { MessageBubble } from '../core/bubbles/types';
 import { ChatLogItem } from '../ui/chat/types';
+/** Interview-wide conditions that freeze answers the candidate has already given. */
+export type AnswerLocks = {
+    /** Terms accepted: consent is tied to the identity on file, so PII and SMS consent freeze. */
+    termsAccepted: boolean;
+    /** The final submit is through: the whole transcript is the submission, so nothing is editable. */
+    submitted: boolean;
+};
 /** Per-card eyebrow + optional dark badge, keyed by agent bubble id. */
 export type QuestionCard = {
     label: string;
     badge?: string;
 };
-export declare const mapBubblesToChatItems: (bubbles: MessageBubble[], cards?: Map<string, QuestionCard>, streamingBubbleId?: string) => ChatLogItem[];
-export type TextRules = {
-    minLength?: number;
-    maxLength?: number;
-    recommendedLength?: number;
+export declare const mapBubblesToChatItems: (bubbles: MessageBubble[], cards?: Map<string, QuestionCard>, locks?: AnswerLocks, streamingBubbleId?: string) => ChatLogItem[];
+/**
+ * Word bounds for the current question. The rule names say "TextLength" but the
+ * values are word counts — the backend interpolates them into the question text
+ * the candidate reads as "between {recommended} and {max} words".
+ */
+export type WordCountRule = {
+    min?: number;
+    recommend?: number;
+    max?: number;
 };
 /**
  * The agent bubble whose answer the bottom input targets: the question under
@@ -61,6 +73,17 @@ export declare enum CurrentInputKind {
     VIDEO = "video"
 }
 export declare const currentInputKind: (bubbles: MessageBubble[], editingQuestionId?: string) => CurrentInputKind;
-export declare const currentTextRules: (bubbles: MessageBubble[], editingQuestionId?: string) => TextRules;
+export declare const currentWordCountRule: (bubbles: MessageBubble[], editingQuestionId?: string) => WordCountRule;
+/**
+ * Whether the question the composer currently targets opts out of the paste block. Reads the same
+ * bubble as the other composer selectors, so re-editing an earlier answer picks up that question's
+ * tag rather than the newest question's.
+ */
+export declare const currentQuestionAllowsPaste: (bubbles: MessageBubble[], editingQuestionId?: string) => boolean;
+/**
+ * Whether the composer currently targets the optional post-interview feedback comment. Sending
+ * nothing is a valid answer there, and it carries none of the word-count rules an FTQ does.
+ */
+export declare const isFeedbackCommentQuestion: (bubbles: MessageBubble[], editingQuestionId?: string) => boolean;
 /** Max video answer length in seconds (legacy reuses the voice-seconds rule). */
 export declare const currentMaxVideoSeconds: (bubbles: MessageBubble[], editingQuestionId?: string) => number;

package/dist/react/strings.d.ts

@@ -40,7 +40,6 @@ export declare const buildStrings: (t: Translator) => {
         description: string;
         kind: SummaryKind;
     };
-    answerLooksGood: string;
     composerFooter: string;
     richToolbar: string;
     richBold: string;
@@ -48,6 +47,9 @@ export declare const buildStrings: (t: Translator) => {
     richBulletList: string;
     richNumberList: string;
     inputPlaceholder: string;
+    inputPlaceholderPaste: string;
+    /** Placeholder for the optional feedback comment, which says sending empty skips it. */
+    feedbackCommentPlaceholder: string;
     inputLabel: string;
     sendLabel: string;
     retryLabel: string;
@@ -56,12 +58,20 @@ export declare const buildStrings: (t: Translator) => {
     editingLabel: string;
     editBannerLabel: string;
     optionsGroupLabel: string;
+    /** Opens a folded run of intro hints. */
+    hintExpand: string;
+    /** Closes it again. */
+    hintCollapse: string;
     senderAgent: string;
     senderCandidate: string;
     opensNewTab: string;
     widgetLabel: string;
+    /**
+     * Accessible name for the rating slider, with no visible counterpart: the backend's own question
+     * ("Please rate your experience.") is the prompt, so a second line of widget copy saying the same
+     * thing read as a duplicate on screen and announced twice off it.
+     */
     sliderLabel: string;
-    sliderHint: string;
     submitRatingLabel: string;
     dropdownSearchPlaceholder: string;
     dropdownSearchLabel: string;
@@ -73,7 +83,17 @@ export declare const buildStrings: (t: Translator) => {
     nameConfirmBody: (suggested: string) => string;
     useSuggestedLabel: (suggested: string) => string;
     useOriginalLabel: string;
-    minLengthHint: (min: number) => string;
+    /** Composer word counter, e.g. "42 words". */
+    wordCount: (count: number) => string;
+    shortResponseHint: (min: number) => string;
+    goodResponseHint: string;
+    maxWordsHint: string;
+    shortAnswerTitle: (min: number) => string;
+    shortAnswerAim: (min: number, recommended?: number) => string;
+    shortAnswerEditAnytime: string;
+    shortAnswerEditNow: string;
+    dontShowAgainLabel: string;
+    continueLabel: string;
     loadingLabel: string;
     preparingLabel: string;
     doneTitle: (name?: string) => string;
@@ -81,7 +101,10 @@ export declare const buildStrings: (t: Translator) => {
     doneNextLabel: string;
     doneSteps: [string, string, string];
     doneRatingPrompt: string;
+    doneRedirect: string;
     startFailedMessage: string;
+    cohortClosedTitle: string;
+    cohortClosedMessage: string;
     /** PII validation error message for a given fi_error_pii* key. */
     piiError: (key: string) => string;
     videoOpenCamera: string;
@@ -117,5 +140,8 @@ export declare const buildStrings: (t: Translator) => {
     agcMessage: (attempt: number) => string;
     agcEdit: string;
     agcContinue: string;
+    editFailedTitle: string;
+    editFailedMessage: string;
+    editFailedDismiss: string;
 };
 export type UiStrings = ReturnType<typeof buildStrings>;

package/dist/{react-DEF8h8hc.js → react--hlAJW6n.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-t5h3u6nr.js";
+import { t } from "./react-BtFG4mMU.js";
 import { t as n } from "./defineProperty-DiFpLzd2.js";
 import { a as r, i, n as a, r as o, t as s } from "./classPrivateFieldSet2-DtQPURVD.js";
 import { t as c } from "./dist-FvHBWiRa.js";
@@ -455,4 +455,4 @@ var $ = Z({
 //#endregion
 export { $ as default };
 
-//# sourceMappingURL=react-DEF8h8hc.js.map
+//# sourceMappingURL=react--hlAJW6n.js.map

package/dist/{react-y4vaW3OH.js → react-B6p_EGvt.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-t5h3u6nr.js";
+import { t } from "./react-BtFG4mMU.js";
 import { t as n } from "./defineProperty-DiFpLzd2.js";
 import { a as r, i, n as a, r as o, t as s } from "./classPrivateFieldSet2-DtQPURVD.js";
 //#region ../../node_modules/.pnpm/twitch-video-element@0.1.6/node_modules/twitch-video-element/dist/twitch-video-element.js
@@ -365,4 +365,4 @@ var J = K({
 //#endregion
 export { J as default };
 
-//# sourceMappingURL=react-y4vaW3OH.js.map
+//# sourceMappingURL=react-B6p_EGvt.js.map

package/dist/{react-DDjfkpOE.js → react-BKQw6USG.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-t5h3u6nr.js";
+import { t } from "./react-BtFG4mMU.js";
 import { t as n } from "./defineProperty-DiFpLzd2.js";
 import { a as r, i, n as a, r as o, t as s } from "./classPrivateFieldSet2-DtQPURVD.js";
 //#region ../../node_modules/.pnpm/super-media-element@1.4.2/node_modules/super-media-element/super-media-element.js
@@ -369,4 +369,4 @@ var P = M({
 //#endregion
 export { P as default };
 
-//# sourceMappingURL=react-DDjfkpOE.js.map
+//# sourceMappingURL=react-BKQw6USG.js.map

package/dist/{react-qa12DkXH.js → react-Bh9U4IBe.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-t5h3u6nr.js";
+import { t } from "./react-BtFG4mMU.js";
 import { t as n } from "./defineProperty-DiFpLzd2.js";
 import { a as r, i, n as a, r as o, t as s } from "./classPrivateFieldSet2-DtQPURVD.js";
 //#region ../../node_modules/.pnpm/tiktok-video-element@0.1.2/node_modules/tiktok-video-element/dist/tiktok-video-element.js
@@ -332,4 +332,4 @@ var K = W({
 //#endregion
 export { K as default };
 
-//# sourceMappingURL=react-qa12DkXH.js.map
+//# sourceMappingURL=react-Bh9U4IBe.js.map

package/dist/{react-DOgLiyZi.js → react-BtFG4mMU.js}

@@ -1,4 +1,4 @@
-import { S as e } from "./messages-DCvBcspv.js";
+import { C as e } from "./messages-t5h3u6nr.js";
 //#region ../../node_modules/.pnpm/react@19.2.7/node_modules/react/cjs/react.production.js
 var t = /* @__PURE__ */ e(((e) => {
 	var t = Symbol.for("react.transitional.element"), n = Symbol.for("react.portal"), r = Symbol.for("react.fragment"), i = Symbol.for("react.strict_mode"), a = Symbol.for("react.profiler"), o = Symbol.for("react.consumer"), s = Symbol.for("react.context"), c = Symbol.for("react.forward_ref"), l = Symbol.for("react.suspense"), u = Symbol.for("react.memo"), d = Symbol.for("react.lazy"), f = Symbol.for("react.activity"), p = Symbol.iterator;
@@ -292,4 +292,4 @@ var t = /* @__PURE__ */ e(((e) => {
 //#endregion
 export { n as t };
 
-//# sourceMappingURL=react-DOgLiyZi.js.map
+//# sourceMappingURL=react-BtFG4mMU.js.map

package/dist/{react-Bw5AugJc.js → react-Bx1VLQqP.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-t5h3u6nr.js";
+import { t } from "./react-BtFG4mMU.js";
 import { t as n } from "./defineProperty-DiFpLzd2.js";
 import { n as r } from "./hls-mBncGwsE.js";
 import { a as i, i as a, n as o, r as s, t as c } from "./classPrivateFieldSet2-DtQPURVD.js";
@@ -215,4 +215,4 @@ var b = v({
 //#endregion
 export { b as default };
 
-//# sourceMappingURL=react-Bw5AugJc.js.map
+//# sourceMappingURL=react-Bx1VLQqP.js.map

package/dist/{react-DPFikgTM.js → react-DFkljL-6.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-t5h3u6nr.js";
+import { t } from "./react-BtFG4mMU.js";
 import { t as n } from "./defineProperty-DiFpLzd2.js";
 import { a as r, i, n as a, r as o, t as s } from "./classPrivateFieldSet2-DtQPURVD.js";
 import { t as c } from "./dist-FvHBWiRa.js";
@@ -2207,4 +2207,4 @@ var rt = tt({
 //#endregion
 export { rt as default };
 
-//# sourceMappingURL=react-DPFikgTM.js.map
+//# sourceMappingURL=react-DFkljL-6.js.map

package/dist/{react-BjO903pN.js → react-DJK2_GuR.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-t5h3u6nr.js";
+import { t } from "./react-BtFG4mMU.js";
 import { t as n } from "./defineProperty-DiFpLzd2.js";
 import { a as r, i, n as a, r as o, t as s } from "./classPrivateFieldSet2-DtQPURVD.js";
 //#region ../../node_modules/.pnpm/spotify-audio-element@1.0.4/node_modules/spotify-audio-element/dist/spotify-audio-element.js
@@ -309,4 +309,4 @@ var W = H({
 //#endregion
 export { W as default };
 
-//# sourceMappingURL=react-BjO903pN.js.map
+//# sourceMappingURL=react-DJK2_GuR.js.map

package/dist/{react-D8hV9uow.js → react-yXcg2glq.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-t5h3u6nr.js";
+import { t } from "./react-BtFG4mMU.js";
 import { t as n } from "./defineProperty-DiFpLzd2.js";
 import { i as r, n as i, t as a } from "./classPrivateFieldSet2-DtQPURVD.js";
 import { n as o, t as s } from "./dist-BOe6WyvN.js";
@@ -190,4 +190,4 @@ var S = b({
 //#endregion
 export { S as default };
 
-//# sourceMappingURL=react-D8hV9uow.js.map
+//# sourceMappingURL=react-yXcg2glq.js.map

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

@@ -1,8 +1,8 @@
 import { ReactNode, Ref } from 'react';
 import { 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 = {

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

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 import { ChatBubbleLabels, DropdownLabels, MediaLabels, SliderLabels } from '../ChatBubble/ChatBubble';
+import { HintDisclosureLabels } from '../HintDisclosure/HintDisclosure';
 import { ChatLogItem } from '../types';
 export type ChatLogProps = {
     items: ChatLogItem[];
@@ -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;
@@ -32,4 +35,4 @@ export type ChatLogProps = {
  * 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, header, }: ChatLogProps) => 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/types.d.ts

@@ -81,4 +81,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/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

@@ -9,24 +9,41 @@ 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). */
@@ -36,4 +53,4 @@ export type TextAnswerInputProps = {
     /** Moves focus to the editor on mount (used when an edit opens the composer). */
     focusOnMount?: boolean;
 };
-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, }: 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/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/Header.d.ts

@@ -9,5 +9,14 @@ 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 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.
  */
 export declare const Header: ({ title, subtitle, logoUrl, logoAlt, progressLabel, }: HeaderProps) => import("react").JSX.Element;

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;