@incodetech/web 2.2.0-rc.1 → 2.2.0-rc.3

package/dist/pdfViewer-DHgpC35P.js

@@ -0,0 +1,2 @@
+import { t as PdfViewer } from "./pdfViewer-BbRv7mHX.js";
+export { PdfViewer };

package/dist/phone/phone.es.js

@@ -1,12 +1,12 @@
 import { a as useTranslation } from "../uiConfig-D7ezQeZ7.js";
 import { h as q, v as u } from "../vendor-preact-mvwZ8mJj.js";
-import { _ as useModuleTerminalCallbacks, g as isTerminalModuleState, o as Page, r as withStandaloneModuleBootstrap, t as IncodeComponent, y as useManager } from "../incodeComponent-B-daxouV.js";
-import { t as Spacer } from "../spacer-Bnmh-DfR.js";
-import { r as Button } from "../incode-logo-cGsd55rc.js";
-import { t as OtpInput } from "../otpInput-B3vUjmBF.js";
-import { t as Checkbox } from "../checkbox-Jgwh943i.js";
-import { t as PhoneInputComposed } from "../phoneInputComposed-D1ZBsd4S.js";
-import { t as registerIncodeModuleElement } from "../incodeModule-uyUrSSUM.js";
+import { _ as useModuleTerminalCallbacks, g as isTerminalModuleState, o as Page, r as withStandaloneModuleBootstrap, t as IncodeComponent, y as useManager } from "../incodeComponent-B6hBTDEE.js";
+import { t as Spacer } from "../spacer-C6GdxqM-.js";
+import { r as Button } from "../incode-logo-DkPbEPiI.js";
+import { t as OtpInput } from "../otpInput-BWiL_nBW.js";
+import { t as Checkbox } from "../checkbox-gbHumlEi.js";
+import { t as PhoneInputComposed } from "../phoneInputComposed-Bvy15RAe.js";
+import { t as registerIncodeModuleElement } from "../incodeModule-CCI32xbn.js";
 import { createPhoneManager } from "@incodetech/core/phone";
 //#region src/modules/phone/phone.tsx
 /**

package/dist/{phoneInputComposed-D1ZBsd4S.js → phoneInputComposed-Bvy15RAe.js}

@@ -1,9 +1,9 @@
 import { S as k, _ as y, a as D, d as T, h as q, l as A, p as d, v as u } from "./vendor-preact-mvwZ8mJj.js";
-import { n as ErrorIcon } from "./incode-logo-cGsd55rc.js";
-import "./icons-D0cfSCBM.js";
+import { n as ErrorIcon } from "./incode-logo-DkPbEPiI.js";
+import "./icons-CIjsoS44.js";
 import { t as SuccessIcon } from "./successIcon-Bj8Y9CuI.js";
-import { t as InputComposed } from "./inputComposed-Pp_XN1-h.js";
-import { t as DropdownComposed } from "./dropdownComposed-BXleSN7n.js";
+import { t as InputComposed } from "./inputComposed-CGB8zKbd.js";
+import { t as DropdownComposed } from "./dropdownComposed-Bk8viDop.js";
 //#region ../../node_modules/.pnpm/libphonenumber-js@1.12.31/node_modules/libphonenumber-js/metadata.min.json.js
 var metadata_min_json_default = {
 	"version": 4,

package/dist/{processing-vGhs5Gvb.js → processing-DN0NyNqR.js}

@@ -1,5 +1,5 @@
 import { v as u } from "./vendor-preact-mvwZ8mJj.js";
-import { l as TransitionSpinner } from "./incodeComponent-B-daxouV.js";
+import { l as TransitionSpinner } from "./incodeComponent-B6hBTDEE.js";
 //#region src/shared/processing/processing.tsx
 var Processing = () => {
 	return /* @__PURE__ */ u(TransitionSpinner, {});

package/dist/qe-signature/qe-signature.es.js

@@ -1,7 +1,7 @@
 import { v as u } from "../vendor-preact-mvwZ8mJj.js";
-import { r as withStandaloneModuleBootstrap } from "../incodeComponent-B-daxouV.js";
-import { n as ElectronicSignature } from "../electronic-signature-COBKJBjU.js";
-import { t as registerIncodeModuleElement } from "../incodeModule-uyUrSSUM.js";
+import { r as withStandaloneModuleBootstrap } from "../incodeComponent-B6hBTDEE.js";
+import { n as ElectronicSignature } from "../electronic-signature-DGL6y3os.js";
+import { t as registerIncodeModuleElement } from "../incodeModule-CCI32xbn.js";
 //#region src/modules/qe-signature/qe-signature.tsx
 var QeSignatureWithLocalConfig = ({ config, manager, onFinish, onError }) => {
 	return /* @__PURE__ */ u(ElectronicSignature, {

package/dist/{radioGroupComposed-CYPHpI6a.js → radioGroupComposed-CPFZJOtR.js}

@@ -1,9 +1,9 @@
 import { a as useTranslation } from "./uiConfig-D7ezQeZ7.js";
 import { a as D, p as d, v as u } from "./vendor-preact-mvwZ8mJj.js";
-import { u as cn } from "./spacer-Bnmh-DfR.js";
-import { n as ErrorIcon } from "./incode-logo-cGsd55rc.js";
-import "./icons-D0cfSCBM.js";
-import { t as InputComposed } from "./inputComposed-Pp_XN1-h.js";
+import { d as cn } from "./spacer-C6GdxqM-.js";
+import { n as ErrorIcon } from "./incode-logo-DkPbEPiI.js";
+import "./icons-CIjsoS44.js";
+import { t as InputComposed } from "./inputComposed-CGB8zKbd.js";
 //#region src/shared/errorParams.ts
 /**
 * Resolves error params by translating the `fieldName` key

package/dist/redirect-to-mobile/redirect-to-mobile.es.js

@@ -1,18 +1,18 @@
 import { t as __commonJSMin } from "../rolldown-runtime--E5BIlTp.js";
 import { a as useTranslation, i as Trans } from "../uiConfig-D7ezQeZ7.js";
 import { S as k, _ as y, h as q, l as A, m as g, p as d, v as u } from "../vendor-preact-mvwZ8mJj.js";
-import { _ as useModuleTerminalCallbacks, c as usePageUiConfig, l as TransitionSpinner, r as withStandaloneModuleBootstrap, s as VerifiedByIncodeLogo, t as IncodeComponent, y as useManager } from "../incodeComponent-B-daxouV.js";
-import { t as Spacer } from "../spacer-Bnmh-DfR.js";
-import { n as ErrorIcon, r as Button, t as incode_logo_default } from "../incode-logo-cGsd55rc.js";
-import "../extensibility-DBilbbhC.js";
-import "../icons-D0cfSCBM.js";
+import { _ as useModuleTerminalCallbacks, c as usePageUiConfig, l as TransitionSpinner, r as withStandaloneModuleBootstrap, s as VerifiedByIncodeLogo, t as IncodeComponent, y as useManager } from "../incodeComponent-B6hBTDEE.js";
+import { t as Spacer } from "../spacer-C6GdxqM-.js";
+import { n as ErrorIcon, r as Button, t as incode_logo_default } from "../incode-logo-DkPbEPiI.js";
+import "../extensibility-CFhCNmsm.js";
+import "../icons-CIjsoS44.js";
 import { t as SuccessIcon } from "../successIcon-Bj8Y9CuI.js";
-import { t as AutoFocusTitle } from "../autoFocusTitle-D7VzaZ2P.js";
-import { n as formatResendTimer, r as useResendTimerAnnouncements } from "../otpInput-B3vUjmBF.js";
-import { r as getCountryByCallingCode, t as PhoneInputComposed } from "../phoneInputComposed-D1ZBsd4S.js";
+import { t as AutoFocusTitle } from "../autoFocusTitle-Edt8-trP.js";
+import { n as formatResendTimer, r as useResendTimerAnnouncements } from "../otpInput-BWiL_nBW.js";
+import { r as getCountryByCallingCode, t as PhoneInputComposed } from "../phoneInputComposed-Bvy15RAe.js";
 import { t as registerIncodeElement } from "../registerIncodeElement-BduCekz5.js";
-import { t as Snackbar } from "../snackbar-BzyWgQ7J.js";
-import { t as Tabs } from "../tabs-B_TxQ9ZQ.js";
+import { t as Snackbar } from "../snackbar-zbTKBgCx.js";
+import { t as Tabs } from "../tabs-BjLPiKhZ.js";
 import { createRedirectToMobileManager } from "@incodetech/core/redirect-to-mobile";
 //#region src/modules/redirect-to-mobile/redirectHeader.tsx
 var RedirectHeader = ({ logoSrc }) => {
@@ -2820,7 +2820,7 @@ var RedirectToMobileContent = ({ config, manager: externalManager, services, onF
 		}
 	}, [state.status, onContinue]);
 	const content = (() => {
-		if (state.status === "idle" || state.status === "loading") return /* @__PURE__ */ u(TransitionSpinner, { hideText: true });
+		if (state.status === "idle" || state.status === "loading") return /* @__PURE__ */ u(TransitionSpinner, { renderMode: "spinnerOnly" });
 		if (state.status === "redirecting") return /* @__PURE__ */ u(QrScreen, {
 			redirectUrl: state.redirectUrl,
 			phonePrefix: state.phonePrefix,

package/dist/{richText-2OnIN9ff.js → richText-DnGJiTPl.js}

@@ -1,5 +1,5 @@
 import { t as preact_markup_module_default, v as u } from "./vendor-preact-mvwZ8mJj.js";
-import { l as purify } from "./spacer-Bnmh-DfR.js";
+import { u as purify } from "./spacer-C6GdxqM-.js";
 import { t as _defineProperty } from "./defineProperty-BbpBna-2.js";
 //#region ../../node_modules/.pnpm/marked@17.0.5/node_modules/marked/lib/marked.esm.js
 var _Class;

package/dist/selfie/selfie.es.js

@@ -1,10 +1,10 @@
 import { _ as y, v as u } from "../vendor-preact-mvwZ8mJj.js";
-import { _ as useModuleTerminalCallbacks, g as isTerminalModuleState, l as TransitionSpinner, r as withStandaloneModuleBootstrap, t as IncodeComponent, y as useManager } from "../incodeComponent-B-daxouV.js";
-import { i as preloadAnimations } from "../spacer-Bnmh-DfR.js";
-import { t as Processing } from "../processing-vGhs5Gvb.js";
-import { n as Capture, t as Tutorial } from "../tutorial-Cuy2ZEG9.js";
-import { n as Permissions } from "../manualCaptureButton-BldgUGso.js";
-import { t as registerIncodeModuleElement } from "../incodeModule-uyUrSSUM.js";
+import { _ as useModuleTerminalCallbacks, g as isTerminalModuleState, l as TransitionSpinner, r as withStandaloneModuleBootstrap, t as IncodeComponent, y as useManager } from "../incodeComponent-B6hBTDEE.js";
+import { i as preloadAnimations } from "../spacer-C6GdxqM-.js";
+import { t as Processing } from "../processing-DN0NyNqR.js";
+import { n as Capture, t as Tutorial } from "../tutorial-B1F5C8Si.js";
+import { n as Permissions } from "../manualCaptureButton-ByWujoAK.js";
+import { t as registerIncodeModuleElement } from "../incodeModule-CCI32xbn.js";
 import { createSelfieManager } from "@incodetech/core/selfie";
 //#region src/modules/selfie/preloadTutorialAssets.ts
 var started = false;
@@ -30,7 +30,7 @@ var SelfieContent = ({ config, manager: externalManager, onFinish, onError }) =>
 		onError,
 		error: state.status === "error" ? state.error : void 0
 	});
-	if (state.status === "idle" || state.status === "loading") return /* @__PURE__ */ u(TransitionSpinner, { hideText: true });
+	if (state.status === "idle" || state.status === "loading") return /* @__PURE__ */ u(TransitionSpinner, { renderMode: "spinnerOnly" });
 	if (state.status === "tutorial") return /* @__PURE__ */ u(Tutorial, {
 		manager,
 		ageAssurance: state.ageAssurance

package/dist/signature/signature.es.js

@@ -1,11 +1,11 @@
 import { a as useTranslation } from "../uiConfig-D7ezQeZ7.js";
 import { _ as y, a as D, h as q, l as A, p as d, u as F, v as u } from "../vendor-preact-mvwZ8mJj.js";
-import { _ as useModuleTerminalCallbacks, o as Page, r as withStandaloneModuleBootstrap, t as IncodeComponent, y as useManager } from "../incodeComponent-B-daxouV.js";
-import { t as Spacer } from "../spacer-Bnmh-DfR.js";
-import { r as Button } from "../incode-logo-cGsd55rc.js";
-import "../extensibility-DBilbbhC.js";
-import { t as VerificationResult } from "../verificationResult-IUf0w1aR.js";
-import { t as registerIncodeModuleElement } from "../incodeModule-uyUrSSUM.js";
+import { _ as useModuleTerminalCallbacks, o as Page, r as withStandaloneModuleBootstrap, t as IncodeComponent, y as useManager } from "../incodeComponent-B6hBTDEE.js";
+import { t as Spacer } from "../spacer-C6GdxqM-.js";
+import { r as Button } from "../incode-logo-DkPbEPiI.js";
+import "../extensibility-CFhCNmsm.js";
+import { t as VerificationResult } from "../verificationResult-tgNeUuHO.js";
+import { t as registerIncodeModuleElement } from "../incodeModule-CCI32xbn.js";
 import { t as _defineProperty } from "../defineProperty-BbpBna-2.js";
 import { createSignatureManager } from "@incodetech/core/signature";
 //#region ../../node_modules/.pnpm/signature_pad@5.1.3/node_modules/signature_pad/dist/signature_pad.js

package/dist/{snackbar-BzyWgQ7J.js → snackbar-zbTKBgCx.js}

@@ -1,5 +1,5 @@
 import { v as u } from "./vendor-preact-mvwZ8mJj.js";
-import { u as cn } from "./spacer-Bnmh-DfR.js";
+import { d as cn } from "./spacer-C6GdxqM-.js";
 //#region src/shared/snackbar/snackbar.tsx
 var Snackbar = ({ variant = "neutral", children, className, ariaLive = "polite" }) => {
 	return /* @__PURE__ */ u("div", {

package/dist/{spacer-Bnmh-DfR.js → spacer-C6GdxqM-.js}

@@ -2341,4 +2341,4 @@ var Spacer = ({ size, className, direction = "vertical" }) => {
 	return /* @__PURE__ */ u("div", { class: `${className || ""}` });
 };
 //#endregion
-export { useAnimationData as a, InstanceOverridesProvider as c, preloadAnimations as i, purify$1 as l, LoadingIcon as n, Lottie as o, AnimatedAsset as r, Asset as s, Spacer as t, cn as u };
+export { useAnimationData as a, InstanceOverridesProvider as c, cn as d, preloadAnimations as i, useInstanceOverrides as l, LoadingIcon as n, Lottie as o, AnimatedAsset as r, Asset as s, Spacer as t, purify$1 as u };

package/dist/{spinner-HP_c74K-.js → spinner-CaEPC8gQ.js}

@@ -1,5 +1,5 @@
 import { S as k, _ as y, a as D, l as A, v as u } from "./vendor-preact-mvwZ8mJj.js";
-import { n as LoadingIcon, t as Spacer, u as cn } from "./spacer-Bnmh-DfR.js";
+import { d as cn, n as LoadingIcon, t as Spacer } from "./spacer-C6GdxqM-.js";
 //#region src/shared/typography/typography.tsx
 var Title = D(({ children, className, ...rest }, ref) => {
 	return /* @__PURE__ */ u("h2", {
@@ -48,7 +48,7 @@ var sizeMap = {
 	medium: 48,
 	large: 64
 };
-var Spinner = ({ title, subtitle, ariaLabel, size = "medium", fullScreen = true, className, presentational = false }) => {
+var Spinner = ({ title, subtitle, ariaLabel, size = "medium", fullScreen = true, className, presentational = false, hideIcon = false }) => {
 	const iconSize = sizeMap[size];
 	const titleRef = A(null);
 	const containerRef = A(null);
@@ -63,7 +63,7 @@ var Spinner = ({ title, subtitle, ariaLabel, size = "medium", fullScreen = true,
 	]);
 	return /* @__PURE__ */ u("div", {
 		ref: containerRef,
-		class: cn("IncodeSpinner", fullScreen && "IncodeSpinnerFullScreen", className),
+		class: cn("IncodeSpinner", fullScreen && "IncodeSpinnerFullScreen", hideIcon && "IncodeSpinnerTextOnly", className),
 		"data-testid": "spinner",
 		"data-title": title,
 		"data-subtitle": subtitle,
@@ -76,7 +76,7 @@ var Spinner = ({ title, subtitle, ariaLabel, size = "medium", fullScreen = true,
 		children: /* @__PURE__ */ u("div", {
 			class: "IncodeSpinnerContent",
 			"aria-hidden": ariaLabel ? true : void 0,
-			children: [/* @__PURE__ */ u(LoadingIcon, { size: iconSize }), (title || subtitle) && /* @__PURE__ */ u(k, { children: [/* @__PURE__ */ u(Spacer, { size: 16 }), /* @__PURE__ */ u("div", {
+			children: [!hideIcon && /* @__PURE__ */ u(LoadingIcon, { size: iconSize }), (title || subtitle) && /* @__PURE__ */ u(k, { children: [!hideIcon && /* @__PURE__ */ u(Spacer, { size: 16 }), /* @__PURE__ */ u("div", {
 				class: "IncodeSpinnerText",
 				children: [title && /* @__PURE__ */ u(Title, {
 					ref: titleRef,

package/dist/{statusPage-C0vTVW0Q.js → statusPage-C-2V2g63.js}

@@ -1,7 +1,7 @@
 import { m as g, v as u } from "./vendor-preact-mvwZ8mJj.js";
-import { o as Page } from "./incodeComponent-B-daxouV.js";
-import { t as Spacer } from "./spacer-Bnmh-DfR.js";
-import { t as AutoFocusTitle } from "./autoFocusTitle-D7VzaZ2P.js";
+import { o as Page } from "./incodeComponent-B6hBTDEE.js";
+import { t as Spacer } from "./spacer-C6GdxqM-.js";
+import { t as AutoFocusTitle } from "./autoFocusTitle-Edt8-trP.js";
 //#region src/shared/statusPage/statusPage.tsx
 var StatusPage = ({ variant, icon, title, subtitle, hideFooterBranding, actions, isLive }) => {
 	const subtitleId = `${g()}-subtitle`;

package/dist/{tabs-B_TxQ9ZQ.js → tabs-BjLPiKhZ.js}

@@ -1,5 +1,5 @@
 import { b as Q, g as x, m as g, p as d, v as u } from "./vendor-preact-mvwZ8mJj.js";
-import { u as cn } from "./spacer-Bnmh-DfR.js";
+import { d as cn } from "./spacer-C6GdxqM-.js";
 //#region src/shared/tabs/tabs.tsx
 var TabsContext = Q(null);
 var useTabsContext = () => {

package/dist/{tutorial-Cuy2ZEG9.js → tutorial-B1F5C8Si.js}

@@ -1,13 +1,13 @@
 import { a as useTranslation } from "./uiConfig-D7ezQeZ7.js";
 import { S as k, _ as y, d as T, h as q, l as A, m as g, p as d, v as u } from "./vendor-preact-mvwZ8mJj.js";
-import { l as TransitionSpinner, o as Page } from "./incodeComponent-B-daxouV.js";
-import { a as useAnimationData, n as LoadingIcon, o as Lottie, t as Spacer, u as cn } from "./spacer-Bnmh-DfR.js";
-import { n as Title } from "./spinner-HP_c74K-.js";
-import { n as ErrorIcon, r as Button } from "./incode-logo-cGsd55rc.js";
-import { v as WarningIcon } from "./icons-D0cfSCBM.js";
+import { l as TransitionSpinner, o as Page } from "./incodeComponent-B6hBTDEE.js";
+import { a as useAnimationData, d as cn, n as LoadingIcon, o as Lottie, t as Spacer } from "./spacer-C6GdxqM-.js";
+import { n as Title } from "./spinner-CaEPC8gQ.js";
+import { n as ErrorIcon, r as Button } from "./incode-logo-DkPbEPiI.js";
+import { v as WarningIcon } from "./icons-CIjsoS44.js";
 import { t as SuccessIcon } from "./successIcon-Bj8Y9CuI.js";
-import { t as Modal } from "./modal-BlczH_pL.js";
-import { t as ManualCaptureButton } from "./manualCaptureButton-BldgUGso.js";
+import { t as Modal } from "./modal-9-lPt5Hj.js";
+import { t as ManualCaptureButton } from "./manualCaptureButton-ByWujoAK.js";
 //#region src/shared/errorContent/errorContent.tsx
 var ErrorContent = ({ title, description, attemptsRemaining, onButtonClick, "data-testid": testId }) => {
 	const { t } = useTranslation();
@@ -603,7 +603,7 @@ var Capture = ({ manager, state }) => {
 	y(() => {
 		if (detectionStatus === "manualCapture") manualCaptureRef.current?.focus();
 	}, [detectionStatus]);
-	if (captureStatus === "initializing") return /* @__PURE__ */ u(TransitionSpinner, { spinnerConfig: { subtitle: t("loadingCircle.preparingCamera") } });
+	if (captureStatus === "initializing") return /* @__PURE__ */ u(TransitionSpinner, { subtitleKey: "loadingCircle.preparingCamera" });
 	if (captureStatus === "detecting") {
 		if (detectionStatus === "offline") return /* @__PURE__ */ u(Page, { title: "No internet connection" });
 		const getBorderState = () => {

package/dist/types/ae-signature.d.ts

@@ -117,15 +117,17 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TCon
 };
 
 /**
- * Per-instance asset/animation overrides for a single mounted SDK module.
+ * Per-instance overrides for a single mounted SDK module.
  *
  * These ride on the module's `config` prop and are published once at the
  * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
- * reads them via {@link useInstanceOverrides} without any prop drilling.
+ * or `<TransitionSpinner>` reads them via {@link useInstanceOverrides} without
+ * any prop drilling.
  */
 declare type InstanceOverrides = {
     assets?: AssetOverrides;
     animations?: AnimationOverrides;
+    spinner?: SpinnerPresentation;
 };
 
 declare type LottieAnimationData = {
@@ -137,6 +139,30 @@ declare type LottieAnimationData = {
     h: number;
 };
 
+/**
+ * Host-facing loader presentation, settable globally via
+ * `setup({ uiConfig: { spinner } })` or per element via `config.spinner`.
+ *
+ * Copy is deliberately absent. Loader text comes from i18n (`loadingCircle.*`),
+ * which keeps it localizable — a literal string here would freeze in whatever
+ * language the host typed it in when the user switches language mid-flow — and
+ * leaves one source of truth for user-facing strings.
+ */
+declare type SpinnerPresentation = {
+    renderMode?: SpinnerRenderMode;
+    size?: SpinnerSize;
+};
+
+/**
+ * Which parts of a loader render.
+ *
+ * An enum rather than a pair of booleans so the meaningless fourth state —
+ * neither icon nor text, i.e. a blank screen — is unrepresentable.
+ */
+declare type SpinnerRenderMode = 'spinnerAndText' | 'spinnerOnly' | 'textOnly';
+
+declare type SpinnerSize = 'small' | 'medium' | 'large';
+
 /** An SVG imported as a Preact component (the `?react` import shape). */
 declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
 

package/dist/types/antifraud.d.ts

@@ -117,15 +117,17 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TCon
 };
 
 /**
- * Per-instance asset/animation overrides for a single mounted SDK module.
+ * Per-instance overrides for a single mounted SDK module.
  *
  * These ride on the module's `config` prop and are published once at the
  * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
- * reads them via {@link useInstanceOverrides} without any prop drilling.
+ * or `<TransitionSpinner>` reads them via {@link useInstanceOverrides} without
+ * any prop drilling.
  */
 declare type InstanceOverrides = {
     assets?: AssetOverrides;
     animations?: AnimationOverrides;
+    spinner?: SpinnerPresentation;
 };
 
 declare type LottieAnimationData = {
@@ -137,6 +139,30 @@ declare type LottieAnimationData = {
     h: number;
 };
 
+/**
+ * Host-facing loader presentation, settable globally via
+ * `setup({ uiConfig: { spinner } })` or per element via `config.spinner`.
+ *
+ * Copy is deliberately absent. Loader text comes from i18n (`loadingCircle.*`),
+ * which keeps it localizable — a literal string here would freeze in whatever
+ * language the host typed it in when the user switches language mid-flow — and
+ * leaves one source of truth for user-facing strings.
+ */
+declare type SpinnerPresentation = {
+    renderMode?: SpinnerRenderMode;
+    size?: SpinnerSize;
+};
+
+/**
+ * Which parts of a loader render.
+ *
+ * An enum rather than a pair of booleans so the meaningless fourth state —
+ * neither icon nor text, i.e. a blank screen — is unrepresentable.
+ */
+declare type SpinnerRenderMode = 'spinnerAndText' | 'spinnerOnly' | 'textOnly';
+
+declare type SpinnerSize = 'small' | 'medium' | 'large';
+
 /** An SVG imported as a Preact component (the `?react` import shape). */
 declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
 

package/dist/types/authentication.d.ts

@@ -119,15 +119,17 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TCon
 };
 
 /**
- * Per-instance asset/animation overrides for a single mounted SDK module.
+ * Per-instance overrides for a single mounted SDK module.
  *
  * These ride on the module's `config` prop and are published once at the
  * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
- * reads them via {@link useInstanceOverrides} without any prop drilling.
+ * or `<TransitionSpinner>` reads them via {@link useInstanceOverrides} without
+ * any prop drilling.
  */
 declare type InstanceOverrides = {
     assets?: AssetOverrides;
     animations?: AnimationOverrides;
+    spinner?: SpinnerPresentation;
 };
 
 declare type LottieAnimationData = {
@@ -139,6 +141,30 @@ declare type LottieAnimationData = {
     h: number;
 };
 
+/**
+ * Host-facing loader presentation, settable globally via
+ * `setup({ uiConfig: { spinner } })` or per element via `config.spinner`.
+ *
+ * Copy is deliberately absent. Loader text comes from i18n (`loadingCircle.*`),
+ * which keeps it localizable — a literal string here would freeze in whatever
+ * language the host typed it in when the user switches language mid-flow — and
+ * leaves one source of truth for user-facing strings.
+ */
+declare type SpinnerPresentation = {
+    renderMode?: SpinnerRenderMode;
+    size?: SpinnerSize;
+};
+
+/**
+ * Which parts of a loader render.
+ *
+ * An enum rather than a pair of booleans so the meaningless fourth state —
+ * neither icon nor text, i.e. a blank screen — is unrepresentable.
+ */
+declare type SpinnerRenderMode = 'spinnerAndText' | 'spinnerOnly' | 'textOnly';
+
+declare type SpinnerSize = 'small' | 'medium' | 'large';
+
 /** An SVG imported as a Preact component (the `?react` import shape). */
 declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
 

package/dist/types/certificate-issuance.d.ts

@@ -119,15 +119,17 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TCon
 };
 
 /**
- * Per-instance asset/animation overrides for a single mounted SDK module.
+ * Per-instance overrides for a single mounted SDK module.
  *
  * These ride on the module's `config` prop and are published once at the
  * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
- * reads them via {@link useInstanceOverrides} without any prop drilling.
+ * or `<TransitionSpinner>` reads them via {@link useInstanceOverrides} without
+ * any prop drilling.
  */
 declare type InstanceOverrides = {
     assets?: AssetOverrides;
     animations?: AnimationOverrides;
+    spinner?: SpinnerPresentation;
 };
 
 declare type LottieAnimationData = {
@@ -139,6 +141,30 @@ declare type LottieAnimationData = {
     h: number;
 };
 
+/**
+ * Host-facing loader presentation, settable globally via
+ * `setup({ uiConfig: { spinner } })` or per element via `config.spinner`.
+ *
+ * Copy is deliberately absent. Loader text comes from i18n (`loadingCircle.*`),
+ * which keeps it localizable — a literal string here would freeze in whatever
+ * language the host typed it in when the user switches language mid-flow — and
+ * leaves one source of truth for user-facing strings.
+ */
+declare type SpinnerPresentation = {
+    renderMode?: SpinnerRenderMode;
+    size?: SpinnerSize;
+};
+
+/**
+ * Which parts of a loader render.
+ *
+ * An enum rather than a pair of booleans so the meaningless fourth state —
+ * neither icon nor text, i.e. a blank screen — is unrepresentable.
+ */
+declare type SpinnerRenderMode = 'spinnerAndText' | 'spinnerOnly' | 'textOnly';
+
+declare type SpinnerSize = 'small' | 'medium' | 'large';
+
 /** An SVG imported as a Preact component (the `?react` import shape). */
 declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
 

package/dist/types/consent.d.ts

@@ -117,15 +117,17 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TCon
 };
 
 /**
- * Per-instance asset/animation overrides for a single mounted SDK module.
+ * Per-instance overrides for a single mounted SDK module.
  *
  * These ride on the module's `config` prop and are published once at the
  * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
- * reads them via {@link useInstanceOverrides} without any prop drilling.
+ * or `<TransitionSpinner>` reads them via {@link useInstanceOverrides} without
+ * any prop drilling.
  */
 declare type InstanceOverrides = {
     assets?: AssetOverrides;
     animations?: AnimationOverrides;
+    spinner?: SpinnerPresentation;
 };
 
 declare type LottieAnimationData = {
@@ -137,6 +139,30 @@ declare type LottieAnimationData = {
     h: number;
 };
 
+/**
+ * Host-facing loader presentation, settable globally via
+ * `setup({ uiConfig: { spinner } })` or per element via `config.spinner`.
+ *
+ * Copy is deliberately absent. Loader text comes from i18n (`loadingCircle.*`),
+ * which keeps it localizable — a literal string here would freeze in whatever
+ * language the host typed it in when the user switches language mid-flow — and
+ * leaves one source of truth for user-facing strings.
+ */
+declare type SpinnerPresentation = {
+    renderMode?: SpinnerRenderMode;
+    size?: SpinnerSize;
+};
+
+/**
+ * Which parts of a loader render.
+ *
+ * An enum rather than a pair of booleans so the meaningless fourth state —
+ * neither icon nor text, i.e. a blank screen — is unrepresentable.
+ */
+declare type SpinnerRenderMode = 'spinnerAndText' | 'spinnerOnly' | 'textOnly';
+
+declare type SpinnerSize = 'small' | 'medium' | 'large';
+
 /** An SVG imported as a Preact component (the `?react` import shape). */
 declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
 

package/dist/types/cross-document-data-match.d.ts

@@ -117,15 +117,17 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TCon
 };
 
 /**
- * Per-instance asset/animation overrides for a single mounted SDK module.
+ * Per-instance overrides for a single mounted SDK module.
  *
  * These ride on the module's `config` prop and are published once at the
  * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
- * reads them via {@link useInstanceOverrides} without any prop drilling.
+ * or `<TransitionSpinner>` reads them via {@link useInstanceOverrides} without
+ * any prop drilling.
  */
 declare type InstanceOverrides = {
     assets?: AssetOverrides;
     animations?: AnimationOverrides;
+    spinner?: SpinnerPresentation;
 };
 
 declare type LottieAnimationData = {
@@ -137,6 +139,30 @@ declare type LottieAnimationData = {
     h: number;
 };
 
+/**
+ * Host-facing loader presentation, settable globally via
+ * `setup({ uiConfig: { spinner } })` or per element via `config.spinner`.
+ *
+ * Copy is deliberately absent. Loader text comes from i18n (`loadingCircle.*`),
+ * which keeps it localizable — a literal string here would freeze in whatever
+ * language the host typed it in when the user switches language mid-flow — and
+ * leaves one source of truth for user-facing strings.
+ */
+declare type SpinnerPresentation = {
+    renderMode?: SpinnerRenderMode;
+    size?: SpinnerSize;
+};
+
+/**
+ * Which parts of a loader render.
+ *
+ * An enum rather than a pair of booleans so the meaningless fourth state —
+ * neither icon nor text, i.e. a blank screen — is unrepresentable.
+ */
+declare type SpinnerRenderMode = 'spinnerAndText' | 'spinnerOnly' | 'textOnly';
+
+declare type SpinnerSize = 'small' | 'medium' | 'large';
+
 /** An SVG imported as a Preact component (the `?react` import shape). */
 declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
 

package/dist/types/curp-validation.d.ts

@@ -117,15 +117,17 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TCon
 };
 
 /**
- * Per-instance asset/animation overrides for a single mounted SDK module.
+ * Per-instance overrides for a single mounted SDK module.
  *
  * These ride on the module's `config` prop and are published once at the
  * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
- * reads them via {@link useInstanceOverrides} without any prop drilling.
+ * or `<TransitionSpinner>` reads them via {@link useInstanceOverrides} without
+ * any prop drilling.
  */
 declare type InstanceOverrides = {
     assets?: AssetOverrides;
     animations?: AnimationOverrides;
+    spinner?: SpinnerPresentation;
 };
 
 declare type LottieAnimationData = {
@@ -137,6 +139,30 @@ declare type LottieAnimationData = {
     h: number;
 };
 
+/**
+ * Host-facing loader presentation, settable globally via
+ * `setup({ uiConfig: { spinner } })` or per element via `config.spinner`.
+ *
+ * Copy is deliberately absent. Loader text comes from i18n (`loadingCircle.*`),
+ * which keeps it localizable — a literal string here would freeze in whatever
+ * language the host typed it in when the user switches language mid-flow — and
+ * leaves one source of truth for user-facing strings.
+ */
+declare type SpinnerPresentation = {
+    renderMode?: SpinnerRenderMode;
+    size?: SpinnerSize;
+};
+
+/**
+ * Which parts of a loader render.
+ *
+ * An enum rather than a pair of booleans so the meaningless fourth state —
+ * neither icon nor text, i.e. a blank screen — is unrepresentable.
+ */
+declare type SpinnerRenderMode = 'spinnerAndText' | 'spinnerOnly' | 'textOnly';
+
+declare type SpinnerSize = 'small' | 'medium' | 'large';
+
 /** An SVG imported as a Preact component (the `?react` import shape). */
 declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;