@incodetech/core 2.3.2 → 2.4.0-rc.0

package/dist/{idCaptureManager-BNmVJQkd.esm.js → idCaptureManager-D4V8vXtY.esm.js}

@@ -1,12 +1,16 @@
-import { l as BrowserStorageProvider } from "./setup-BuPbxpwF.esm.js";
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-ijlbX_Wx.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-CAgFE-k3.esm.js";
+import { u as BrowserStorageProvider } from "./setup-C38QkrSP.esm.js";
 import { t as topLevelStateName } from "./topLevelStateName-B5i2avbh.esm.js";
-import { s as createActor, u as createManager } from "./xstate.esm-BuFLFuzz.esm.js";
-import { t as setWasmDsFlagSync } from "./wasmDsFlagSync-DYrLUEII.esm.js";
+import { i as assign, s as createActor, u as createManager } from "./xstate.esm-DSajW7CJ.esm.js";
+import { n as fromPromise } from "./xstate-actors.esm-8Gzepa_A.esm.js";
+import { t as splitTrackedName } from "./splitTrackedName-3zJRd2RD.esm.js";
+import { t as setWasmDsFlagSync } from "./wasmDsFlagSync-BXCGqP48.esm.js";
 import { t as BrowserVisibilityObserverProvider } from "./BrowserVisibilityObserverProvider-BrJN1B8A.esm.js";
-import { o as resetWasmMotionPrimedForModule, r as primeMotionFromUserGestureIfNeeded } from "./permissionServices-EY3_Vx6c.esm.js";
-import { a as createIdProtectedCaptureController, n as provideIdProtectedCaptureController, o as findIdProtectedCaptureController, s as getManualUploadTabs, t as idCaptureMachine } from "./idCaptureStateMachine-BbiZD3uf.esm.js";
-import { b as resolveIdCaptureThresholds, y as resolveCaptureOptimizingTreatment } from "./idCaptureServices-dtDG2HXS.esm.js";
+import { c as resetWasmMotionPrimedForModule, o as requiresMotionPermissionUserGesture, r as primeMotionFromUserGestureIfNeeded } from "./permissionServices-d2UW0r_L.esm.js";
+import { t as getDeviceClass } from "./getDeviceClass-bsWdEDxP.esm.js";
+import { _ as mapDeviceWalletScreenName, c as createIdCaptureOnlyDeliveryActor, d as captureOnlyNeedsBack, f as hasOnCaptureCallback, g as BrowserDigitalCredentialsProvider, l as createIdProtectedCaptureController, n as provideIdProtectedCaptureController, p as pickIdCaptureOnlyConfig, s as attachIdProtectedCaptureController, t as idCaptureMachine, u as findIdProtectedCaptureController } from "./idCaptureStateMachine-PJt0yzom.esm.js";
+import { _ as ID_ERROR_CODES, b as resolveIdCaptureThresholds, v as resolveCaptureOptimizingTreatment, y as resolveCountdownStepMs } from "./idCaptureServices-DJ33k3-p.esm.js";
+import { t as invokeOnCaptureCallback } from "./invokeOnCaptureCallback-BW7V3vub.esm.js";
 //#region src/modules/id/digitalUpload/instrumentation.ts
 const TERMINAL_REASONS = /* @__PURE__ */ new Set(["DIGITAL_ID_REQUESTED_BUT_OTHER_PROVIDED", "ID_TYPE_UNACCEPTABLE"]);
 function isHoldingState(value) {
@@ -41,23 +45,6 @@ function mapDigitalIdScreenName(value, failReason) {
 	return "uploadDigitalid.review.default";
 }
 //#endregion
-//#region src/modules/id/deviceWallet/instrumentation.ts
-/**
-* Maps a device-wallet child-machine snapshot to a tracked screen name.
-* Family is `deviceWallet.*` — emitted cross-family under the parent
-* `idCapture` module token, same as `mapDigitalIdScreenName`. See
-* `docs/patterns/INSTRUMENTATION.md`.
-*/
-function mapDeviceWalletScreenName(value, failReason) {
-	if (value === "presenting") return "deviceWallet.wallet.default";
-	if (value === "failed") {
-		if (failReason === "NO_CREDENTIAL") return "deviceWallet.error.nocredential";
-		if (failReason === "UNSUPPORTED_PLATFORM") return "deviceWallet.error.unsupported";
-		return "deviceWallet.error.default";
-	}
-	return "deviceWallet.loading.default";
-}
-//#endregion
 //#region src/modules/digital-id-redirect/instrumentation.ts
 /**
 * Maps a digital-ID web-redirect (Trinsic iDIN/FTN) child-machine snapshot value
@@ -86,67 +73,6 @@ function mapDigitalIdRedirectScreenName(value) {
 	}
 }
 //#endregion
-//#region src/modules/id/manualUpload/instrumentation.ts
-/**
-* Maps an ID Manual Upload child-machine snapshot to the exact Figma
-* "Tracked Events" screen name. Source: ID Manual Upload Figma file
-* (`https://www.figma.com/design/WCx6d4zXG5nu946mu0KZNO/ID-Manual-Upload---Latest-Design?node-id=2462-18986`).
-*
-* Family is `IDmanual.*` — emitted cross-family under the parent
-* `idCapture` module token (same precedent as `uploadDigitalid.*` from
-* the digital-upload sub-flow). Manual upload has no standalone manager
-* or module token of its own.
-*
-* The mapper returns Figma-verbatim strings (e.g.
-* `'IDmanual.upload.uploadedFrontandBack'`) which the adapter emits as-is
-* on `event.screen`. See `docs/patterns/INSTRUMENTATION.md`.
-*
-* In-scope Figma screens (driven from child SM state + context):
-*
-* - `IDmanual.upload.default` — selecting, ID tab, no front file yet
-* - `IDmanual.upload.uploadedFront` — selecting, ID tab, front uploaded,
-*   back still needed
-* - `IDmanual.upload.uploadedFrontandBack` — selecting, ID tab, both
-*   sides uploaded (or `onlyFront`/`skipBackFromServer` short-circuit)
-* - `IDmanual.upload.passport` — selecting, passport tab, no file
-* - `IDmanual.upload.uploadedPassport` — selecting, passport tab,
-*   passport uploaded
-* - `IDmanual.error.document` — selecting, with a populated
-*   `errorMessage`
-*
-* Figma screens intentionally NOT mapped here (parent-level surfaces or
-* shared with other families):
-*
-* - `IDmanual.documentchooser.default` / `IDmanual.howtoverify` —
-*   the chooser and the "how to verify" tutorial are PARENT-LEVEL
-*   `idCapture` surfaces (one shared React component, fired BEFORE the
-*   user picks manual-vs-digital). The Upload Digital ID canvas
-*   describes the same physical pixels under its own family name.
-*   Decision (Option A, recorded in `.cursor/commands/sync-events.md`):
-*   keep emitting the neutral parent names `idCapture.documentchooser`
-*   and `idCapture.tutorial.{front,back,passport}` and treat the
-*   per-canvas Figma names as design-side aliases. Per-flow attribution
-*   would require a `selectedDocumentType`-aware override at the parent
-*   dispatcher — explicitly NOT shipped here.
-* - `digitalID.success.default` — appears on the canvas for reference,
-*   but the actual success surface is emitted by `mapDigitalIdScreenName`
-*   as `uploadDigitalid.success.default`. Manual upload has no dedicated
-*   success screen; `finished` returns control to the parent SM.
-*
-* Returns `undefined` for transient (`uploadingFront`/`uploadingBack`/
-* `uploadingPassport`/`checkRetries`) and terminal (`retriesExhausted`/
-* `exhausted`/`finished`) states — the parent dispatcher falls back to
-* its existing default (`idCapture.manualIdUpload`) for those beats.
-*/
-function mapIdManualUploadScreenName(value, context) {
-	if (value !== "selecting" || context === void 0) return;
-	if (context.errorMessage !== null) return "IDmanual.error.document";
-	if (context.activeTab === "passport") return context.passportUploaded ? "IDmanual.upload.uploadedPassport" : "IDmanual.upload.passport";
-	if (!context.frontUploaded) return "IDmanual.upload.default";
-	if (context.backUploaded || context.skipBackFromServer || context.onlyFront) return "IDmanual.upload.uploadedFrontandBack";
-	return "IDmanual.upload.uploadedFront";
-}
-//#endregion
 //#region src/internal/idCapture/idCaptureManagerFactory.ts
 function getPermissionStatus(snapshot) {
 	if (!snapshot.matches("permissions")) return;
@@ -160,7 +86,7 @@ function getPermissionStatus(snapshot) {
 function getCaptureStatus(snapshot) {
 	const matches = {
 		initializing: snapshot.matches({ capture: "initializing" }),
-		detecting: snapshot.matches({ capture: "detecting" }) || snapshot.matches({ capture: "choosingDetectionStrategy" }) || snapshot.matches({ capture: { detectingWithOptimization: "searching" } }),
+		detecting: snapshot.matches({ capture: "detecting" }) || snapshot.matches({ capture: "help" }) || snapshot.matches({ capture: "choosingDetectionStrategy" }) || snapshot.matches({ capture: { detectingWithOptimization: "searching" } }),
 		manualCaptureWaiting: snapshot.matches({ capture: "manualCaptureWaiting" }),
 		capturing: snapshot.matches({ capture: "capturing" }),
 		capturingManual: snapshot.matches({ capture: "capturingManual" }),
@@ -223,7 +149,7 @@ function getErrorTitleKey(errorCode, currentMode) {
 function getErrorSubtitleKey(errorCode, uploadResponse, currentMode) {
 	if (!errorCode) return void 0;
 	const isPassport = currentMode === "passport";
-	if (errorCode === "WRONG_DOCUMENT_SIDE") return uploadResponse?.side === "back" ? "idv2.capture.processing.errors.wrongSide.back.subtitle" : "idv2.capture.processing.errors.wrongSide.front.subtitle";
+	if (errorCode === "WRONG_DOCUMENT_SIDE") return currentMode === "back" ? "idv2.capture.processing.errors.wrongSide.back.subtitle" : "idv2.capture.processing.errors.wrongSide.front.subtitle";
 	if (errorCode === "CLASSIFICATION_FAILED") return isPassport ? "idv2.capture.processing.errors.classification.subtitlePassport" : "idv2.capture.processing.errors.classification.subtitle";
 	return {
 		UPLOAD_ERROR: "idv2.capture.processing.errors.upload.subtitle",
@@ -245,6 +171,7 @@ function getErrorSubtitleKey(errorCode, uploadResponse, currentMode) {
 }
 function shouldCaptureBack(context) {
 	if (context.isDigitalUpload) return false;
+	if (hasOnCaptureCallback(context.config)) return captureOnlyNeedsBack(context);
 	if (!(context.currentMode === "front" || context.currentMode === "passport")) return false;
 	if (context.config.onlyBack) return false;
 	if (context.config.usSmartCapture && context.currentMode === "front") return false;
@@ -283,7 +210,7 @@ function mapCaptureState(snapshot, context, presentationStream) {
 		status: "capture",
 		captureStatus,
 		stream: presentationStream,
-		usingBackCamera: context.usingBackCamera ?? true,
+		usingBackCamera: context.usingBackCamera ?? getDeviceClass() !== "desktop",
 		detectionStatus: context.detectionStatus,
 		attemptsRemaining: context.attemptsRemaining,
 		uploadError,
@@ -291,6 +218,7 @@ function mapCaptureState(snapshot, context, presentationStream) {
 		selectedDocumentType: getEffectiveSelectedDocumentType(context),
 		tutorialEnabled: context.config.showTutorial === true,
 		counterValue: context.counterValue,
+		countdownStepMs: resolveCountdownStepMs(context.config),
 		orientation: context.orientation,
 		idType: context.idType,
 		previewImageUrl: context.previewImageUrl,
@@ -316,7 +244,8 @@ function mapPermissionsState(snapshot, context) {
 		permissionStatus: getPermissionStatus(snapshot) ?? "idle",
 		selectedDocumentType: getEffectiveSelectedDocumentType(context),
 		currentMode: context.currentMode,
-		tutorialEnabled: context.config.showTutorial === true
+		tutorialEnabled: context.config.showTutorial === true,
+		requiresMotionPermissionUserGesture: requiresMotionPermissionUserGesture(context.config.ds)
 	};
 }
 function getLoadingPhase(snapshot) {
@@ -331,12 +260,14 @@ function mapLoadingState(snapshot, phase) {
 		phase,
 		tutorialEnabled: snapshot.context.config.showTutorial === true,
 		selectedDocumentType: getEffectiveSelectedDocumentType(snapshot.context),
-		currentMode: snapshot.context.currentMode
+		currentMode: snapshot.context.currentMode,
+		requiresMotionPermissionUserGesture: requiresMotionPermissionUserGesture(snapshot.context.config.ds)
 	};
 }
 function getTutorialPhase(snapshot) {
 	if (snapshot.matches({ tutorial: "checkingPermission" })) return "checkingPermission";
 	if (snapshot.matches({ tutorial: "waitingForPermission" })) return "waitingForPermission";
+	if (snapshot.matches({ tutorial: "requestingMotionPermission" })) return "waitingForPermission";
 	if (snapshot.matches({ tutorial: { initializingCamera: { userIntent: "clicked" } } })) return "waitingForCamera";
 	if (snapshot.matches({ tutorial: "initializingCamera" })) return "initializingCamera";
 	return "ready";
@@ -346,57 +277,8 @@ function mapTutorialState(snapshot, context) {
 		status: "tutorial",
 		phase: getTutorialPhase(snapshot),
 		selectedDocumentType: getEffectiveSelectedDocumentType(context),
-		currentMode: context.currentMode
-	};
-}
-function mapManualUploadState(snapshot) {
-	const { config } = snapshot.context;
-	const { showIdTab, showPassportTab } = getManualUploadTabs(config);
-	const childSnapshot = snapshot.children["manualIdUpload"]?.getSnapshot();
-	const childCtx = childSnapshot?.context;
-	const childValue = childSnapshot?.value;
-	const phase = childValue === "retriesExhausted" ? "exhausted" : childValue === "uploadingFront" || childValue === "uploadingBack" || childValue === "uploadingPassport" ? "uploading" : "selecting";
-	const uploadingSide = childValue === "uploadingFront" ? "front" : childValue === "uploadingBack" ? "back" : childValue === "uploadingPassport" ? "passport" : void 0;
-	/**
-	* Server told us the document doesn't need a back side (e.g. passport-class
-	* docs, single-sided IDs). Treat the back slot as uploaded so the UI shows
-	* a green check rather than hiding the slot — matches v1's behavior and
-	* keeps both slots visible once the front has been processed.
-	*/
-	const backUploaded = (childCtx?.backUploaded ?? false) || (childCtx?.skipBackFromServer ?? false);
-	/**
-	* Manual upload is client-authoritative for the back side: the slot must be
-	* shown or hidden before any upload round-trip, so there is no
-	* `skipBackIdCapture` to defer to yet. The side-only flags are therefore read
-	* directly here (`onlyFront`: ENG-50532; `onlyBack`: ENG-51547). The camera
-	* path is the opposite: it forwards only-front and waits for the server's
-	* answer.
-	*/
-	const onlyFront = config.onlyFront === true;
-	const onlyBack = config.onlyBack === true;
-	const idTabCanContinue = onlyBack && backUploaded || !onlyBack && (childCtx?.frontUploaded ?? false) && (onlyFront || backUploaded);
-	const canContinue = childCtx?.activeTab === "id" ? idTabCanContinue : !onlyBack && (childCtx?.passportUploaded ?? false);
-	const showFrontSlot = !onlyBack;
-	const showBackSlot = onlyBack || !onlyFront;
-	return {
-		status: "manualUpload",
-		phase,
-		uploadingSide,
-		activeTab: childCtx?.activeTab ?? "id",
-		showIdTab,
-		showPassportTab,
-		showFrontSlot,
-		showBackSlot,
-		frontFileName: childCtx?.frontFile?.name,
-		backFileName: childCtx?.backFile?.name,
-		passportFileName: childCtx?.passportFile?.name,
-		frontUploaded: childCtx?.frontUploaded ?? false,
-		backUploaded,
-		passportUploaded: childCtx?.passportUploaded ?? false,
-		canContinue,
-		retriesLeft: childCtx?.retriesLeft ?? snapshot.context.config.captureAttempts,
-		errorKey: childCtx?.errorMessage ?? null,
-		errorSide: childCtx?.errorSide ?? null
+		currentMode: context.currentMode,
+		requiresMotionPermissionUserGesture: requiresMotionPermissionUserGesture(context.config.ds)
 	};
 }
 function mapDigitalUploadState(snapshot) {
@@ -466,7 +348,8 @@ function mapState(snapshot, presentationStream) {
 	if (loadingPhase) return mapLoadingState(snapshot, loadingPhase);
 	if (snapshot.matches("chooser")) return {
 		status: "chooser",
-		availableDocumentTypes: context.availableDocumentTypes
+		availableDocumentTypes: context.availableDocumentTypes,
+		digitalIdRedirectOptions: context.digitalIdRedirectOptions
 	};
 	if (snapshot.matches("loading")) return mapLoadingState(snapshot, "bootstrapping");
 	if (snapshot.matches("tutorial")) return mapTutorialState(snapshot, context);
@@ -509,7 +392,6 @@ function mapState(snapshot, presentationStream) {
 		status: "error",
 		error: context.error ?? "Unknown error"
 	};
-	if (snapshot.matches("manualIdUpload")) return mapManualUploadState(snapshot);
 	if (snapshot.matches("digitalIdUpload")) return mapDigitalUploadState(snapshot);
 	if (snapshot.matches("digitalIdRedirect") || snapshot.matches("digitalIdRedirectReturning")) return mapDigitalIdRedirectState(snapshot);
 	if (snapshot.matches("deviceWallet") || snapshot.matches("digitalIdRouting")) return mapDeviceWalletState(snapshot);
@@ -525,11 +407,18 @@ function createApi({ actor, trackElementClicked, trackCaptureAttemptFinished })
 			resetWasmMotionPrimedForModule();
 			actor.send({ type: "LOAD" });
 		},
-		selectDocument(documentType) {
+		/**
+		* Picks a chooser option. For `'digitalIdRedirect'`, pass the provider of
+		* the card the user tapped (`digitalIdRedirectOptions[].providerId`) so the
+		* verification is created for that provider; without it the first
+		* configured redirect method is launched (backwards compatible).
+		*/
+		selectDocument(documentType, options) {
 			trackElementClicked?.(`selectDocument.${documentType}`);
 			actor.send({
 				type: "SELECT_DOCUMENT",
-				documentType
+				documentType,
+				providerId: options?.providerId
 			});
 		},
 		async nextStep() {
@@ -545,6 +434,15 @@ function createApi({ actor, trackElementClicked, trackCaptureAttemptFinished })
 			actor.send({ type: "NEXT_STEP" });
 		},
 		/**
+		* Continues from Tutorial into permission orchestration. When iOS requires
+		* a user gesture for Deepsight motion, the motion-only request starts from
+		* this event; otherwise Core proceeds to its existing permission state.
+		*/
+		continueToPermission() {
+			trackElementClicked?.("nextStep");
+			actor.send({ type: "CONTINUE_TO_PERMISSION" });
+		},
+		/**
 		* Requests camera (and, when deepsight is enabled, motion) permission.
 		* Effective in `permissions.idle`, `permissions.waitingForUser`,
 		* `permissions.motionOnly`, `permissions.learnMore`, `tutorial.ready`,
@@ -552,8 +450,8 @@ function createApi({ actor, trackElementClicked, trackCaptureAttemptFinished })
 		* the camera pre-warms it records the user's intent to continue, so the
 		* tutorial advances to capture as soon as the warm-up finishes).
 		*/
-		requestPermission() {
-			trackElementClicked?.("requestPermission");
+		requestPermission(options) {
+			if (options?.trigger !== "automatic") trackElementClicked?.("requestPermission");
 			actor.send({ type: "REQUEST_PERMISSION" });
 		},
 		goToLearnMore() {
@@ -591,6 +489,18 @@ function createApi({ actor, trackElementClicked, trackCaptureAttemptFinished })
 			trackElementClicked?.("switchToManualCapture");
 			actor.send({ type: "SWITCH_TO_MANUAL_CAPTURE" });
 		},
+		switchToAutoCapture() {
+			trackElementClicked?.("secondaryCTA.takePhotoAutomatically");
+			actor.send({ type: "SWITCH_TO_AUTO_CAPTURE" });
+		},
+		/** Pauses live detection; returns false when capture can no longer enter Help. */
+		openHelp() {
+			actor.send({ type: "OPEN_HELP" });
+			return actor.getSnapshot().matches({ capture: "help" });
+		},
+		closeHelp() {
+			actor.send({ type: "CLOSE_HELP" });
+		},
 		continueToBack() {
 			trackElementClicked?.("continueToBack");
 			actor.send({ type: "CONTINUE_TO_BACK" });
@@ -621,35 +531,6 @@ function createApi({ actor, trackElementClicked, trackCaptureAttemptFinished })
 				detectionArea
 			});
 		},
-		/**
-		* Manual upload: tab change (ID / Passport). Resets per-tab file selections.
-		* Note: there is intentionally no `switchToManualUpload` method — entry to
-		* the manual-upload flow is gated by config + Chooser to prevent a
-		* dev-console bypass of live camera capture.
-		*/
-		manualUploadChangeTab(tab) {
-			trackElementClicked?.(`manualUpload.tab.${tab}`);
-			actor.send({
-				type: "MANUAL_UPLOAD_TAB_CHANGED",
-				tab
-			});
-		},
-		manualUploadSelectFile(side, file) {
-			trackElementClicked?.(`manualUpload.select.${side}`);
-			actor.send({
-				type: "MANUAL_UPLOAD_FILE_SELECTED",
-				side,
-				file
-			});
-		},
-		manualUploadContinue() {
-			trackElementClicked?.("manualUpload.continue");
-			actor.send({ type: "MANUAL_UPLOAD_CONTINUE" });
-		},
-		manualUploadReset() {
-			trackElementClicked?.("manualUpload.reset");
-			actor.send({ type: "MANUAL_UPLOAD_RESET" });
-		},
 		digitalUploadNextStep() {
 			trackElementClicked?.("digitalUpload.nextStep");
 			actor.send({ type: "DIGITAL_UPLOAD_NEXT_STEP" });
@@ -742,8 +623,7 @@ function getCaptureLiveCueScreen(screens, detectionStatus) {
 	switch (detectionStatus) {
 		case "wrongSide": return `${screens.capturePrefix}.livecue-${screens.liveCueSide}`;
 		case "blur": return `${screens.capturePrefix}.livecue-blur`;
-		case "farAway":
-		case "idNotDetected": return `${screens.capturePrefix}.livecue-align`;
+		case "farAway": return `${screens.capturePrefix}.livecue-align`;
 		case "glare": return `${screens.capturePrefix}.livecue-glare`;
 		case "offline": return `${screens.capturePrefix}.livecue-dark`;
 		case "manualCapture": return `${screens.capturePrefix}.manual`;
@@ -753,17 +633,17 @@ function getCaptureLiveCueScreen(screens, detectionStatus) {
 }
 function getCaptureErrorScreen(screens, errorCode) {
 	switch (errorCode) {
-		case "WRONG_DOCUMENT_SIDE": return `${screens.errorPrefix}.wrongside`;
+		case "WRONG_DOCUMENT_SIDE": return `${screens.errorPrefix}.wrongSide`;
 		case "GLARE_DETECTED": return `${screens.errorPrefix}.glare`;
 		case "LOW_SHARPNESS": return `${screens.errorPrefix}.blur`;
-		case "READABILITY_ISSUE": return `${screens.errorPrefix}.notreadable`;
+		case "READABILITY_ISSUE": return `${screens.errorPrefix}.notReadable`;
 		case "ID_TYPE_UNACCEPTABLE":
-		case "CLASSIFICATION_FAILED": return `${screens.errorPrefix}.notaccepted`;
+		case "CLASSIFICATION_FAILED": return `${screens.errorPrefix}.notAccepted`;
 		case "RETRY_EXHAUSTED_CONTINUE_TO_BACK":
 		case "RETRY_EXHAUSTED_SKIP_BACK":
 		case "NO_MORE_TRIES": return `${screens.errorPrefix}.failedExhausted`;
 		case "NO_TOKEN":
-		case "SERVER_ERROR": return `${screens.errorPrefix}.nointernet`;
+		case "SERVER_ERROR": return `${screens.errorPrefix}.noConnection`;
 		default: return `${screens.errorPrefix}.failed`;
 	}
 }
@@ -781,10 +661,12 @@ function getCaptureSubstateScreen(snapshot, screens) {
 		case "checkingStream":
 		case "initializing":
 		case "initializingDeepsight": return "idCapture.loader.preparingcamera";
-		case "detecting": return getCaptureLiveCueScreen(screens, context.detectionStatus);
+		case "detecting":
+		case "help": return getCaptureLiveCueScreen(screens, context.detectionStatus);
 		case "manualCaptureWaiting": return `${screens.capturePrefix}.manual`;
 		case "capturing": return `${screens.capturePrefix}.takingphoto`;
 		case "capturingManual": return `${screens.capturePrefix}.manual`;
+		case "submittingBarcode":
 		case "uploading":
 		case "uploadCompleted":
 		case "validatingUpload": return `${screens.analyzingPrefix}.uploading`;
@@ -794,6 +676,7 @@ function getCaptureSubstateScreen(snapshot, screens) {
 	if (typeof captureValue === "object" && captureValue !== null) {
 		const substates = Object.keys(captureValue);
 		if (substates.includes("checkingStream") || substates.includes("initializing") || substates.includes("initializingDeepsight")) return "idCapture.loader.preparingcamera";
+		if (substates.includes("detectingWithOptimization")) return captureValue.detectingWithOptimization === "searching" ? getCaptureLiveCueScreen(screens, context.detectionStatus) : `${screens.capturePrefix}.default`;
 		if (substates.includes("detecting")) return getCaptureLiveCueScreen(screens, context.detectionStatus);
 		if (substates.includes("manualCaptureWaiting")) return `${screens.capturePrefix}.manual`;
 		if (substates.includes("capturing")) return `${screens.capturePrefix}.takingphoto`;
@@ -814,7 +697,7 @@ function getPermissionScreen(value) {
 		default: return "idCapture.permissions.default";
 	}
 }
-function getIdCaptureScreenName(snapshot) {
+function getIdCaptureTrackedName(snapshot) {
 	const { value, context } = snapshot;
 	if (value === void 0 || value === null) return void 0;
 	const topLevel = topLevelStateName(value);
@@ -826,7 +709,7 @@ function getIdCaptureScreenName(snapshot) {
 		case "chooser": return "idCapture.documentchooser";
 		case "loading": return "idCapture.loader.default";
 		case "tutorial": return screens.tutorial;
-		case "ageVerification": return "idCapture.tutorial.ageverification";
+		case "ageVerification": return "idCapture.tutorial.ageVerification";
 		case "permissions": return getPermissionScreen(value);
 		case "capture": return getCaptureSubstateScreen(snapshot, screens);
 		case "mandatoryConsent": return "idCapture.mandatoryConsent";
@@ -843,11 +726,6 @@ function getIdCaptureScreenName(snapshot) {
 			const childContext = child?.context;
 			return mapDigitalIdScreenName(child?.value, childContext?.failReason ?? null);
 		}
-		case "manualIdUpload": {
-			const child = snapshot.children["manualIdUpload"]?.getSnapshot();
-			const childContext = child?.context;
-			return mapIdManualUploadScreenName(child?.value, childContext) ?? "idCapture.manualIdUpload";
-		}
 		case "digitalIdRedirect":
 		case "digitalIdRedirectReturning": {
 			const child = snapshot.children["digitalIdRedirect"]?.getSnapshot();
@@ -862,8 +740,13 @@ function getIdCaptureScreenName(snapshot) {
 		default: return `idCapture.${topLevel}`;
 	}
 }
-function mapIdCaptureScreenName(snapshot) {
-	return getIdCaptureScreenName(snapshot);
+function getIdCaptureScreenName(snapshot) {
+	const name = getIdCaptureTrackedName(snapshot);
+	return name?.startsWith("idCapture.") ? splitTrackedName(name).screen : name;
+}
+function getIdCaptureStateName(snapshot) {
+	const name = getIdCaptureTrackedName(snapshot);
+	return name?.startsWith("idCapture.") ? splitTrackedName(name).state : void 0;
 }
 /**
 * Figma-aligned, machine-stable reason token per upload error code. Mirrors the
@@ -961,8 +844,10 @@ function createIdCaptureManagerFromActor(actor, visibilityObserver = new Browser
 		actor,
 		mapState: (snapshot) => mapState(snapshot, protectedCaptureController?.getProjection().stream),
 		createApi,
+		beforeStop: () => actor.send({ type: "QUIT" }),
 		instrumentation: createManagerInstrumentation(eventModuleNames.idCapture, {
-			getEventScreenName: mapIdCaptureScreenName,
+			getEventScreenName: getIdCaptureScreenName,
+			getEventStateName: getIdCaptureStateName,
 			getErrorName: getIdCaptureErrorName,
 			getErrorPayload: getIdCaptureErrorPayload,
 			visibilityObserver: {
@@ -977,20 +862,6 @@ function createIdCaptureManagerFromActor(actor, visibilityObserver = new Browser
 	});
 }
 //#endregion
-//#region ../infra/src/providers/browser/BrowserDigitalCredentialsProvider.ts
-var BrowserDigitalCredentialsProvider = class {
-	isAvailable() {
-		return typeof navigator !== "undefined" && typeof navigator.credentials?.get === "function" && typeof globalThis.DigitalCredential !== "undefined";
-	}
-	async get(request, options) {
-		return { response: (await navigator.credentials.get({
-			mediation: "required",
-			signal: options?.signal,
-			digital: { requests: [request] }
-		}))?.data?.response };
-	}
-};
-//#endregion
 //#region src/modules/id/idCaptureActor.ts
 function createIdCaptureActor(options) {
 	const dependencies = {
@@ -1012,6 +883,197 @@ function createIdCaptureActor(options) {
 	} }).start();
 }
 //#endregion
+//#region src/modules/id/idCaptureOnlyStateMachine.ts
+function buildSubImage(canvas) {
+	if (!canvas) return void 0;
+	canvas.updateBlob();
+	const blobData = canvas.getBlobData();
+	if (!blobData) return void 0;
+	const imageBase64 = canvas.getBase64Image() ?? "";
+	if (!imageBase64) return void 0;
+	return {
+		imageBase64,
+		blob: blobData.blob,
+		url: blobData.url
+	};
+}
+/**
+* Local finalize for the captureOnly flow. Reads the canvases the base
+* machine's `storeCapturedCanvasInProvider` already prepared:
+*   - `originalCanvas` — full unprocessed frame.
+*   - `transformedCanvas` — homography-warped crop produced by the WASM
+*     `transformPerspective`.
+*
+* Deepsight metadata is best-effort; failure does not block delivery.
+*/
+async function finalizeIdCaptureOnly(input, signal) {
+	const originalCanvas = input.canvas;
+	if (!originalCanvas) throw new Error(ID_ERROR_CODES.UPLOAD_ERROR);
+	const imageData = originalCanvas.getImageData() ?? void 0;
+	let metadata = "";
+	if (input.deepsightService && imageData) try {
+		await input.deepsightService.analyzeFrame(imageData);
+		if (signal.aborted) throw new DOMException("Aborted", "AbortError");
+		metadata = input.deepsightService.getMetadata();
+	} catch (error) {
+		if (error?.name === "AbortError") throw error;
+	}
+	const imageBase64 = originalCanvas.getBase64Image() ?? "";
+	originalCanvas.updateBlob();
+	const blobData = originalCanvas.getBlobData();
+	if (!blobData) throw new Error(ID_ERROR_CODES.UPLOAD_ERROR);
+	return {
+		imageBase64,
+		blob: blobData.blob,
+		url: blobData.url,
+		metadata,
+		croppedImage: buildSubImage(input.croppedCanvas ?? null)
+	};
+}
+/**
+* ID capture state machine variant for the captureOnly flow. Shares the full
+* base ID-capture state tree (chooser, tutorial, permissions, capture,
+* front/back finished, processing, finished); only the upload, process, and
+* recording steps are local instead of remote.
+*/
+const idCaptureOnlyMachine = idCaptureMachine.provide({
+	actors: { 
+	/** No backend processing in captureOnly. */
+processId: fromPromise(async () => ({ isDocumentExpired: false })) },
+	actions: {
+		attachProtectedController: assign(({ self }) => {
+			attachIdProtectedCaptureController(self, createIdProtectedCaptureController({ finalizeCaptureOnly: finalizeIdCaptureOnly }));
+			return {};
+		}),
+		/**
+		* Routes the rich payload from local delivery into `captureOnlyImages`
+		* keyed by side instead of the regular `capturedImages` slot.
+		*/
+		storeCapturedImage: assign(({ context, event }) => {
+			if (!("output" in event) || !context.currentMode) return { captureOnlyImages: context.captureOnlyImages };
+			const image = event.output;
+			const side = context.currentMode === "back" ? "back" : "front";
+			return {
+				captureOnlyImages: {
+					...context.captureOnlyImages,
+					[side]: image
+				},
+				previewImageUrl: image.croppedImage?.url ?? image.url ?? context.previewImageUrl
+			};
+		})
+	},
+	guards: {
+		hasUploadValidationError: () => false,
+		/** No backend answer in captureOnly: the SDK config decides. */
+		shouldContinueToBack: ({ context }) => captureOnlyNeedsBack(context)
+	}
+});
+function provideIdCaptureOnlyController(controller) {
+	return provideIdProtectedCaptureController(idCaptureOnlyMachine, controller).provide({ actors: { captureOnlyDelivery: createIdCaptureOnlyDeliveryActor(controller) } });
+}
+//#endregion
+//#region src/modules/id/idCaptureOnlyActor.ts
+/**
+* Defaults the capture-only flow applies for every {@link IdCaptureConfig}
+* option the integrator doesn't set. Capture-only doesn't talk to a backend, so
+* the upload/processing-oriented flags (device wallet, barcode, extra pages,
+* smart capture, …) all default off; both document types are accepted. The
+* integrator overrides only what they care about — `onCapture` is the one field
+* they must supply.
+*/
+const DEFAULT_ID_CAPTURE_ONLY_CONFIG = {
+	showTutorial: true,
+	captureAttempts: 3,
+	isDeepsightEnabled: false,
+	enableId: true,
+	enablePassport: true,
+	deviceWallet: false,
+	onlyFront: false,
+	onlyBack: false,
+	barcodeCapture: false,
+	fetchAdditionalPage: false,
+	secondId: false,
+	thirdId: false,
+	autoCaptureTimeout: 5,
+	deviceIdleTimeout: 10,
+	digitalIdsUpload: false,
+	showDocumentChooserScreen: false,
+	enableIdRecording: false,
+	usSmartCapture: false,
+	perCountryPerDocOverrides: {}
+};
+function createIdCaptureOnlyActor(options) {
+	const mergedConfig = {
+		...DEFAULT_ID_CAPTURE_ONLY_CONFIG,
+		...options.config
+	};
+	const config = {
+		...mergedConfig,
+		thresholds: resolveIdCaptureThresholds(mergedConfig)
+	};
+	return createActor(provideIdCaptureOnlyController(createIdProtectedCaptureController({ finalizeCaptureOnly: finalizeIdCaptureOnly })), { input: {
+		config,
+		dependencies: options.dependencies
+	} }).start();
+}
+//#endregion
+//#region src/modules/id/idCaptureOnlyManager.ts
+/** A back-only capture (`onlyBack`) has no front image (ENG-58695). */
+function buildCaptureOnlyResponse({ front, back }) {
+	if (front) return {
+		frontImage: front,
+		backImage: back
+	};
+	if (back) return {
+		frontImage: void 0,
+		backImage: back
+	};
+}
+/**
+* Wraps an ID captureOnly actor with a manager that fires `onCapture` exactly
+* once when the actor reaches the `finished` final state. `complete` fires
+* for both `finished` and `closed` — gating on `finished` prevents a
+* user-quit mid-capture from delivering a partial payload.
+*/
+function attachOnCaptureFiring(actor, config) {
+	const subscription = actor.subscribe({ complete: () => {
+		const snapshot = actor.getSnapshot();
+		if (!snapshot.matches("finished")) return;
+		const response = buildCaptureOnlyResponse(snapshot.context.captureOnlyImages);
+		if (!response) return;
+		invokeOnCaptureCallback(config.onCapture, response, eventModuleNames.id);
+	} });
+	return () => subscription.unsubscribe();
+}
+/**
+* `visibilityObserver` is an optional override escape-hatch — first-party
+* callers omit it and the downstream factory defaults to
+* `BrowserVisibilityObserverProvider`. Pass a custom or no-op observer to
+* disable `background`/`foreground` tracking or to run in a non-DOM
+* environment (e.g. SSR / tests).
+*/
+function createIdCaptureOnlyManagerFromActor(actor, config, visibilityObserver) {
+	const unsubscribe = attachOnCaptureFiring(actor, config);
+	const manager = createIdCaptureManagerFromActor(actor, visibilityObserver);
+	return {
+		...manager,
+		stop: () => {
+			unsubscribe();
+			manager.stop();
+		}
+	};
+}
+/**
+* Creates a captureOnly ID capture manager.
+*
+* Unlike {@link createIdCaptureManager}, the captured ID image(s) are
+* delivered locally to the integrator's `onCapture` callback instead of
+* being uploaded to the Incode backend. `onCapture` is required.
+*/
+function createIdCaptureOnlyManager(options) {
+	return createIdCaptureOnlyManagerFromActor(createIdCaptureOnlyActor(options), options.config);
+}
+//#endregion
 //#region src/modules/id/idCaptureManager.ts
 /**
 * Creates a manager for the regular ID capture flow. The shared
@@ -1019,11 +1081,15 @@ function createIdCaptureActor(options) {
 * `internal/idCapture/idCaptureManagerFactory.ts`; this file is a thin
 * wrapper that creates the actor and delegates to the factory.
 *
-* For the captureOnly flow (rich payload delivered locally via `onCapture`),
-* use `createIdCaptureOnlyManager`.
+* A config with an `onCapture` callback runs the captureOnly flow instead
+* (see `createIdCaptureOnlyManager`): no backend, images go to `onCapture`.
 */
 function createIdCaptureManager(options) {
+	if (hasOnCaptureCallback(options.config)) return createIdCaptureOnlyManager({
+		config: pickIdCaptureOnlyConfig(options.config),
+		dependencies: options.dependencies
+	});
 	return createIdCaptureManagerFromActor(createIdCaptureActor(options));
 }
 //#endregion
-export { createIdCaptureActor as n, createIdCaptureManagerFromActor as r, createIdCaptureManager as t };
+export { idCaptureOnlyMachine as a, createIdCaptureOnlyActor as i, createIdCaptureOnlyManager as n, createIdCaptureActor as o, createIdCaptureOnlyManagerFromActor as r, createIdCaptureManagerFromActor as s, createIdCaptureManager as t };