@incodetech/web 2.2.0 → 2.3.0-rc.1

package/dist/{tutorial-LQuJ4dse.js → tutorial-BP1F722m.js}

@@ -1,207 +1,14 @@
-import { a as useTranslation } from "./uiConfig-Dqnjankd.js";
-import { C as k, d as T, g as q, l as A, m as g, p as d, v as y, y as u } from "./vendor-preact-BPXMFRom.js";
-import { l as TransitionSpinner, o as Page } from "./incodeComponent-BtFz-bx2.js";
-import { a as useAnimationData, d as cn, n as LoadingIcon, o as Lottie, t as Spacer } from "./spacer-DLEDuWEx.js";
-import { n as Title } from "./spinner-CJCOHUKx.js";
-import { n as ErrorIcon, r as Button } from "./incode-logo-DeIDDejm.js";
-import { v as WarningIcon } from "./icons-ChHV5iHi.js";
-import { t as SuccessIcon } from "./successIcon-DS8BLsgy.js";
-import { t as Modal } from "./modal-BH2wi8Q0.js";
-import { t as ManualCaptureButton } from "./manualCaptureButton-D58WsS-x.js";
-//#region src/shared/errorContent/errorContent.tsx
-var ErrorContent = ({ title, description, attemptsRemaining, onButtonClick, "data-testid": testId }) => {
-	const { t } = useTranslation();
-	const noMoreAttempts = attemptsRemaining <= 0;
-	return /* @__PURE__ */ u(Modal.Root, {
-		open: true,
-		dismissible: false,
-		hasBackdrop: false,
-		class: "IncodeErrorContent",
-		children: /* @__PURE__ */ u(Modal.Content, {
-			class: "IncodeErrorContentContent",
-			children: /* @__PURE__ */ u(Page, {
-				"data-testid": testId,
-				className: "IncodeErrorContentPage",
-				children: /* @__PURE__ */ u("div", {
-					class: "IncodeErrorContentContainer",
-					children: [/* @__PURE__ */ u("div", {
-						class: "IncodeErrorContentIconContainer",
-						children: [
-							noMoreAttempts ? /* @__PURE__ */ u(ErrorIcon, { size: 32 }) : /* @__PURE__ */ u(WarningIcon, { size: 32 }),
-							/* @__PURE__ */ u(Spacer, { size: 16 }),
-							/* @__PURE__ */ u(Modal.Title, {
-								class: "IncodeErrorContentTitle",
-								children: title
-							}),
-							/* @__PURE__ */ u(Spacer, { size: 12 }),
-							/* @__PURE__ */ u(Modal.Subtitle, {
-								class: "IncodeErrorContentDescription",
-								children: description
-							})
-						]
-					}), /* @__PURE__ */ u("div", {
-						class: "IncodeErrorContentAttemptsContainer",
-						children: [
-							!noMoreAttempts ? /* @__PURE__ */ u(k, { children: [/* @__PURE__ */ u("p", {
-								class: "IncodeErrorContentAttemptsText",
-								children: t("common.attemptsRemaining", { count: attemptsRemaining })
-							}), /* @__PURE__ */ u(Spacer, { size: 24 })] }) : null,
-							/* @__PURE__ */ u(Button, {
-								onClick: onButtonClick,
-								children: noMoreAttempts ? t("common.continue") : t("common.tryAgain")
-							}),
-							/* @__PURE__ */ u(Spacer, { size: 16 })
-						]
-					})]
-				})
-			})
-		})
-	});
-};
-//#endregion
-//#region src/shared/baseTutorial/replaceBaseTutorial.ts
-/**
-* The brand blues baked into the tutorial animations. The selfie oval/shoulders
-* use `#007aff`; the ID/passport tutorials additionally use `#006aff` (the
-* default brand blue) for their accent. Both are re-tinted to the active
-* branding color.
-*
-* Authored as hex and converted to Lottie's normalized `[r, g, b]` (0–1) form.
-* The two greens are ~0.06 apart, comfortably outside `COLOR_MATCH_TOLERANCE`,
-* so they neither cross-match nor catch the (grayscale/white) document and
-* face artwork.
-*/
-var SOURCE_BRAND_COLORS = ["#007aff", "#006aff"].map(hexToRgbUnit).filter((color) => color !== null);
-/**
-* Per-channel tolerance when matching a source color. The baked values are
-* authored as rounded decimals (e.g. `0.48`), so an exact comparison is too
-* brittle; a small tolerance keeps the match robust without catching
-* unrelated colors.
-*/
-var COLOR_MATCH_TOLERANCE = .02;
-/**
-* Reads a CSS custom property off the document root and returns its value.
-* Returns `fallback` (empty by default) when the property is unset or
-* unavailable (e.g. during SSR / tests). With the default empty fallback the
-* recolor no-ops, leaving the animation's authored colors in place — which are
-* the default brand blue, so no theme-specific literal is needed here.
-*/
-function getCssVariableAsHex(variableName, fallback = "") {
-	if (typeof document === "undefined") return fallback;
-	return getComputedStyle(document.documentElement).getPropertyValue(variableName).trim() || fallback;
-}
-function hexToRgbUnit(hex) {
-	let normalized = hex.replace("#", "").trim();
-	if (normalized.length === 3) normalized = normalized.split("").map((char) => char + char).join("");
-	const result = /^([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(normalized);
-	if (!result) return null;
-	return [
-		Number.parseInt(result[1], 16) / 255,
-		Number.parseInt(result[2], 16) / 255,
-		Number.parseInt(result[3], 16) / 255
-	];
-}
-function channelMatches(a, b) {
-	return Math.abs(a - b) <= COLOR_MATCH_TOLERANCE;
-}
-function isSourceColor(r, g, b) {
-	return SOURCE_BRAND_COLORS.some(([sr, sg, sb]) => channelMatches(r, sr) && channelMatches(g, sg) && channelMatches(b, sb));
-}
-function isStaticColorArray(value) {
-	return Array.isArray(value) && value.length >= 3 && value.every((entry) => typeof entry === "number");
-}
-function recolorSolid(node, target) {
-	const colorHolder = node.c;
-	if (!colorHolder || typeof colorHolder !== "object") return;
-	const k = colorHolder.k;
-	if (isStaticColorArray(k) && isSourceColor(k[0], k[1], k[2])) {
-		k[0] = target[0];
-		k[1] = target[1];
-		k[2] = target[2];
-	}
-}
-function recolorGradient(node, target) {
-	const gradient = node.g;
-	if (!gradient || typeof gradient !== "object") return;
-	const { p, k } = gradient;
-	const stopCount = typeof p === "number" ? p : 0;
-	const stops = k?.k;
-	if (stopCount <= 0 || !Array.isArray(stops)) return;
-	for (let stop = 0; stop < stopCount; stop++) {
-		const base = stop * 4;
-		const r = stops[base + 1];
-		const g = stops[base + 2];
-		const b = stops[base + 3];
-		if (typeof r === "number" && typeof g === "number" && typeof b === "number" && isSourceColor(r, g, b)) {
-			stops[base + 1] = target[0];
-			stops[base + 2] = target[1];
-			stops[base + 3] = target[2];
-		}
-	}
-}
-function recolorNode(node, target) {
-	if (Array.isArray(node)) {
-		for (const child of node) recolorNode(child, target);
-		return;
-	}
-	if (!node || typeof node !== "object") return;
-	const obj = node;
-	if (obj.ty === "fl" || obj.ty === "st") recolorSolid(obj, target);
-	else if (obj.ty === "gf" || obj.ty === "gs") recolorGradient(obj, target);
-	for (const key of Object.keys(obj)) recolorNode(obj[key], target);
-}
-/**
-* Returns a deep copy of `animationData` with the baked-in brand blue swapped
-* for `hexColor`. The input is never mutated. Unparseable colors leave the
-* animation untouched.
-*/
-function replaceLottieColor(animationData, hexColor) {
-	const target = hexToRgbUnit(hexColor);
-	if (!target) return animationData;
-	const clone = JSON.parse(JSON.stringify(animationData));
-	recolorNode(clone, target);
-	return clone;
-}
-//#endregion
-//#region src/shared/baseTutorial/baseTutorial.tsx
-var BaseTutorial = ({ className = "", animationData, title, titleId, subtitle, onContinue, buttonText, disclaimerText, isLoading, stopFramePosition = "middle", recolor = true }) => {
-	const themedAnimationData = T(() => {
-		if (!animationData) return null;
-		if (!recolor) return animationData;
-		return replaceLottieColor(animationData, getCssVariableAsHex("--primitive-color-brand-500"));
-	}, [animationData, recolor]);
-	return /* @__PURE__ */ u(Page, {
-		className: cn("IncodeTutorialPage", className),
-		title,
-		titleId,
-		subtitle,
-		children: [/* @__PURE__ */ u("div", {
-			class: "IncodeBaseTutorialContainer",
-			children: /* @__PURE__ */ u("div", {
-				class: "IncodeBaseTutorialAnimationContainer",
-				"aria-hidden": "true",
-				children: themedAnimationData ? /* @__PURE__ */ u(Lottie, {
-					animationData: themedAnimationData,
-					className: "IncodeBaseTutorialAnimation",
-					autoStop: true,
-					stopFramePosition
-				}) : null
-			})
-		}), /* @__PURE__ */ u("div", { children: [/* @__PURE__ */ u("p", {
-			class: "IncodeBaseTutorialDisclaimer",
-			children: disclaimerText
-		}), /* @__PURE__ */ u("div", {
-			class: "IncodeBaseTutorialButtonContainer",
-			children: /* @__PURE__ */ u(Button, {
-				onClick: onContinue,
-				class: "IncodeBaseTutorialButton",
-				isLoading,
-				children: buttonText
-			})
-		})] })]
-	});
-};
-//#endregion
+import { o as useTranslation } from "./uiConfig-BcjOx3PY.js";
+import { S as k, _ as y, c as A, f as d, h as q, p as g, v as u } from "./vendor-preact-C0jX1Cbq.js";
+import { c as Page, d as TransitionSpinner } from "./incodeComponent-DeVV0gEn.js";
+import { a as useAnimationData, d as cn, n as LoadingIcon, t as Spacer } from "./spacer-DZ-t7RMQ.js";
+import { t as Title } from "./typography-CYO7ELEl.js";
+import { r as SuccessIcon } from "./icons-DNXYxUPA.js";
+import { t as ErrorContent } from "./errorContent-aJuo21I4.js";
+import { t as ConnectionError } from "./connectionError-Haw33Di8.js";
+import { c as useCoverMedia } from "./denied-CB1v3PyY.js";
+import { t as BaseTutorial } from "./baseTutorial-BM2Ho3QZ.js";
+import { t as ManualCaptureButton } from "./manualCaptureButton-2RTC1vZC.js";
 //#region src/shared/capture/faceOutline.tsx
 var FaceOutline = () => {
 	return /* @__PURE__ */ u("svg", {
@@ -309,7 +116,7 @@ var Notification = ({ detectionState, disabled, guideStyle = "silhouette" }) =>
 		faceAngle: t(dotted ? "notifications.onFaceAngle" : "notifications.onFaceAngleV2"),
 		headWear: t("notifications.removeHeadwear"),
 		lenses: t("notifications.removeLenses"),
-		eyesClosed: t("notifications.eyesClosed"),
+		eyesClosed: t("notifications.closedEyes"),
 		faceMask: t("notifications.mask"),
 		centerFace: centerFaceText,
 		getReady: t("notifications.getReady"),
@@ -404,16 +211,20 @@ var Notification = ({ detectionState, disabled, guideStyle = "silhouette" }) =>
 */
 var AvatarCanvas = ({ canvas, mirrored }) => {
 	const hostRef = A(null);
+	const canvasRef = A(null);
 	y(() => {
 		const host = hostRef.current;
 		if (!host || !canvas) return void 0;
 		canvas.classList.add("IncodeCaptureAvatarElement");
 		canvas.classList.toggle("IncodeCaptureAvatarMirrored", mirrored);
 		host.appendChild(canvas);
+		canvasRef.current = canvas;
 		return () => {
 			if (canvas.parentElement === host) host.removeChild(canvas);
+			if (canvasRef.current === canvas) canvasRef.current = null;
 		};
 	}, [canvas, mirrored]);
+	useCoverMedia(canvasRef, canvas);
 	return /* @__PURE__ */ u("div", {
 		ref: hostRef,
 		class: "IncodeCaptureAvatarHost",
@@ -450,8 +261,8 @@ var CaptureStatusPage = ({ icon, title, className, isLoading }) => {
 //#endregion
 //#region src/modules/selfie/errorModal.tsx
 var defaultError = {
-	title: "Something went wrong",
-	description: "Please try again later"
+	title: "common.somethingWentWrong",
+	description: "support.tryAgain"
 };
 var errorContent = {
 	MASK_ERROR: {
@@ -521,6 +332,10 @@ var errorContent = {
 		title: "notifications.removeHeadwear",
 		description: "notifications.removeHeadwearDescription"
 	},
+	FACE_OCCLUDED: {
+		title: "notifications.faceOccluded",
+		description: "notifications.faceOccludedDescription"
+	},
 	FACE_TOO_BLURRY: {
 		title: "notifications.spoof",
 		description: "notifications.spoofDescription"
@@ -561,6 +376,7 @@ var ERROR_CODES = [
 	"FACE_MASK_DETECTED",
 	"CLOSED_EYES_DETECTED",
 	"HEAD_COVER_DETECTED",
+	"FACE_OCCLUDED",
 	"FACE_CROPPING_FAILED",
 	"FACE_TOO_SMALL",
 	"FACE_TOO_BLURRY",
@@ -582,8 +398,9 @@ var ErrorModal = ({ error, attemptsRemaining, onTryAgain }) => {
 	const { t } = useTranslation();
 	if (!error) return null;
 	const { title, description } = errorContent[parseErrorCode(error) ?? error] ?? defaultError;
-	const titleText = t(title) ?? title;
-	const descriptionText = attemptsRemaining <= 0 ? t("notifications.selfieCaptureFailedDescription") : t(description);
+	const noMoreAttempts = attemptsRemaining <= 0;
+	const titleText = noMoreAttempts ? t("notifications.selfieCaptureFailed") : t(title) ?? title;
+	const descriptionText = noMoreAttempts ? t("notifications.selfieCaptureFailedDescription") : t(description);
 	return /* @__PURE__ */ u(ErrorContent, {
 		"data-testid": "face-capture-error-modal",
 		title: titleText,
@@ -605,7 +422,7 @@ var Capture = ({ manager, state }) => {
 	}, [detectionStatus]);
 	if (captureStatus === "initializing") return /* @__PURE__ */ u(TransitionSpinner, { subtitleKey: "loadingCircle.preparingCamera" });
 	if (captureStatus === "detecting") {
-		if (detectionStatus === "offline") return /* @__PURE__ */ u(Page, { title: "No internet connection" });
+		if (detectionStatus === "offline") return /* @__PURE__ */ u(ConnectionError, { onRefresh: () => window.location.reload() });
 		const getBorderState = () => {
 			if (isManualCapturing) return "capturing";
 			if (detectionStatus === "detecting") return "idle";
@@ -675,19 +492,7 @@ var Capture = ({ manager, state }) => {
 			]
 		});
 	}
-	if (captureStatus === "capturing") return /* @__PURE__ */ u(Page, {
-		className: "IncodeCaptureCapturingPage",
-		title: "Capturing",
-		subtitle: "Taking photo...",
-		children: /* @__PURE__ */ u("div", {
-			class: "IncodeCaptureCapturingActions",
-			children: /* @__PURE__ */ u(Button, {
-				isLoading: true,
-				children: "Capturing..."
-			})
-		})
-	});
-	if (captureStatus === "uploading") return /* @__PURE__ */ u(CaptureStatusPage, {
+	if (captureStatus === "capturing" || captureStatus === "uploading") return /* @__PURE__ */ u(CaptureStatusPage, {
 		className: "IncodeCaptureStatusUploading",
 		isLoading: true,
 		icon: /* @__PURE__ */ u(LoadingIcon, { size: 64 }),
@@ -709,8 +514,12 @@ var Capture = ({ manager, state }) => {
 };
 var Video = ({ stream, mirrored }) => {
 	const ref = A(null);
+	useCoverMedia(ref, stream);
 	y(() => {
-		if (ref.current && stream) ref.current.srcObject = stream;
+		if (ref.current && stream) {
+			ref.current.srcObject = stream;
+			ref.current.play().catch(() => {});
+		}
 	}, [stream]);
 	return /* @__PURE__ */ u("video", {
 		ref,
@@ -723,7 +532,7 @@ var Video = ({ stream, mirrored }) => {
 };
 //#endregion
 //#region src/modules/selfie/tutorial.tsx
-var Tutorial = ({ manager, ageAssurance = false }) => {
+var Tutorial = ({ manager, ageAssurance = false, showManualUploadLink = false }) => {
 	const { t } = useTranslation();
 	const [isLoading, setIsLoading] = d(false);
 	const { data: animationData, isOverride } = useAnimationData("selfie.tutorial");
@@ -741,8 +550,13 @@ var Tutorial = ({ manager, ageAssurance = false }) => {
 		buttonText: t(ageAssurance ? "face.tutorial.ageAssuranceStartCapture" : "face.tutorial.startCapture"),
 		disclaimerText: t("face.tutorial.autoCapture"),
 		isLoading,
+		secondaryAction: showManualUploadLink ? {
+			label: t("selfiev2.manualUpload.uploadSelfieManually"),
+			onClick: () => manager.goToManualUpload(),
+			testId: "selfie-manual-upload-link"
+		} : void 0,
 		className: "IncodeSelfieTutorial"
 	});
 };
 //#endregion
-export { ErrorContent as i, Capture as n, BaseTutorial as r, Tutorial as t };
+export { Capture as n, Tutorial as t };

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

@@ -52,9 +52,7 @@ export declare const CertificateIssuance: FC<Omit<CertificateIssuanceProps, "con
     config?: (Omit<unknown, never> & DeepPartial<Pick<unknown, never>>) | undefined;
 }>;
 
-declare type CertificateIssuanceProps = IncodeModuleProps<CertificateIssuanceConfig> & {
-    manager?: CertificateIssuanceManager;
-};
+declare type CertificateIssuanceProps = IncodeModuleProps<CertificateIssuanceConfig, void, CertificateIssuanceManager>;
 
 /**
  * A module `config` intersected with the per-instance override maps. Typed at
@@ -172,6 +170,8 @@ export { }
 
 declare global {
     interface HTMLElementTagNameMap {
-        'incode-certificate-issuance': HTMLElement & IncodeModuleProps<CertificateIssuanceConfig>;
+        'incode-certificate-issuance': HTMLElement & IncodeModuleProps<CertificateIssuanceConfig,
+  void,
+  CertificateIssuanceManager>;
     }
 }

package/dist/types/dynamic-forms.d.ts

@@ -0,0 +1,177 @@
+import { DeepPartial } from '@incodetech/core/flow';
+import { DynamicFormsConfig } from '@incodetech/core/dynamic-forms';
+import { DynamicFormsManager } from '@incodetech/core/dynamic-forms';
+import { FC } from 'preact/compat';
+import { FunctionComponent } from 'preact';
+import { SVGProps } from 'preact/compat';
+
+/**
+ * Allowlisted keys for overridable Lottie animations
+ */
+declare type AnimationKey = 'id.tutorial.front' | 'id.tutorial.back' | 'id.tutorial.passport' | 'id.flip' | 'id.processing' | 'selfie.tutorial' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in Lottie animation.
+ *
+ * - `LottieAnimationData` — a parsed Lottie JSON object.
+ * - `{ url }` — fetched and cached at runtime.
+ * - `{ animationData }` — explicit object form.
+ */
+declare type AnimationOverride = LottieAnimationData | {
+    url: string;
+} | {
+    animationData: LottieAnimationData;
+};
+
+declare type AnimationOverrides = Partial<Record<AnimationKey, AnimationOverride>>;
+
+/**
+ * Allowlisted keys for overridable branded SVG illustrations
+ */
+declare type AssetKey = 'faceMatch.success' | 'faceMatch.fail' | 'documentCapture.tutorial' | 'id.uploadScreen' | 'id.ageVerification.dob' | 'id.ageVerification.scan' | 'id.ageVerification.privacy' | 'videoSelfie.success' | 'videoSelfie.fail' | 'videoSelfie.tutorial.permission' | 'videoSelfie.tutorial.selfie' | 'videoSelfie.tutorial.frontId' | 'videoSelfie.tutorial.backId' | 'videoSelfie.tutorial.poa' | 'videoSelfie.tutorial.questions' | 'videoSelfie.tutorial.speech' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in SVG illustration.
+ *
+ * - `string` — a URL, or raw `<svg …>` markup (detected by a leading `<`).
+ * - `{ url }` — fetched and rendered via `<img>`; no script execution.
+ * - `{ raw }` — inline markup; sanitized before injection.
+ * - `{ svg }` — a precompiled component, for build-time integrations.
+ */
+declare type AssetOverride = string | {
+    url: string;
+} | {
+    raw: string;
+} | {
+    svg: SvgComponent;
+};
+
+declare type AssetOverrides = Partial<Record<AssetKey, AssetOverride>>;
+
+/**
+ * A module `config` intersected with the per-instance override maps. Typed at
+ * the UI boundary so core config types (e.g. `IdCaptureConfig`) stay untouched;
+ * `FlowConfig` also declares the maps directly.
+ */
+declare type ConfigWithOverrides<TConfig> = TConfig & InstanceOverrides;
+
+export declare const DynamicForms: FC<Omit<DynamicFormsProps, "config"> & {
+    config?: (Omit<unknown, never> & DeepPartial<Pick<unknown, never>>) | undefined;
+}>;
+
+declare type DynamicFormsProps = IncodeModuleProps<DynamicFormsConfig, void, DynamicFormsManager>;
+
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
+declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TConfigInput = ConfigWithOverrides<TConfig>> = {
+    /**
+     * Module configuration required to render the flow.
+     * For Web Components, this is typically assigned via `element.config = ...`.
+     *
+     * Also carries optional per-instance `assets`/`animations` override maps;
+     * they override the global `setup({ uiConfig })` values for this
+     * element only and are ignored by the core manager.
+     */
+    config?: TConfigInput;
+    /**
+     * Optional pre-built manager. When provided, the module does not create or manage the manager lifecycle.
+     */
+    manager?: TManager;
+    /**
+     * Callback invoked when the module completes successfully.
+     * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
+     */
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
+    /**
+     * Callback invoked when a fatal module error occurs.
+     *
+     * @param error - Human-readable error message.
+     * @param errorCode - Optional numeric code (e.g. HTTP status). Populated by
+     *   the workflow and flow modules on QR validation failures —
+     *   `4026` (`expiredUUID`), `4081` (`invalidQRuuid`) or `4083` (`onboardingUrlAlreadyUsed`).
+     * @param moduleErrorCode - Optional machine-readable error code (e.g. a
+     *   `FaceErrorCode` such as `NONEXISTENT_CUSTOMER`). Lets an orchestrator
+     *   branch on the specific terminal error without parsing the message string.
+     */
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
+};
+
+/**
+ * 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>`
+ * or `<TransitionSpinner>` reads them via {@link useInstanceOverrides} without
+ * any prop drilling.
+ */
+declare type InstanceOverrides = {
+    assets?: AssetOverrides;
+    animations?: AnimationOverrides;
+    spinner?: SpinnerPresentation;
+};
+
+declare type LottieAnimationData = {
+    fr: number;
+    v: string;
+    ip: number;
+    op: number;
+    w: number;
+    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>>;
+
+export { }
+
+declare global {
+    interface HTMLElementTagNameMap {
+        'incode-dynamic-forms': HTMLElement & IncodeModuleProps<DynamicFormsConfig,
+  void,
+  DynamicFormsManager>;
+    }
+}