@smileid/usesmileid 12.0.0-beta01 → 12.0.1

package/src/presentation/screen/use_smile_id_consent_screen.tsx

@@ -26,6 +26,7 @@ import { UseSmileIDLearnMoreContent } from "../components/use_smile_id_learn_mor
 import { UseSmileIDPartnerIcon } from "../components/use_smile_id_partner_icon";
 import { UseSmileIDRoundedCheckbox } from "../components/use_smile_id_rounded_checkbox";
 import { useUseSmileIDLocalizations } from "../../l10n/use_smile_id_localizations_provider";
+import { GlobalPrivacyControl } from "../../core/models/global_privacy_control";
 import { getDefaultConsentState, getDeviceLocale } from "../utils/locale_utils";
 import {
   buildConsentRows,
@@ -59,6 +60,12 @@ export type UseSmileIDConsentScreenProps = {
   readonly showAttribution?: boolean;
   readonly onAllow?: (info: ConsentInformation) => void;
   readonly onDeny?: () => void;
+  /**
+   * Partner-declared consent posture; seeds the checkbox's initial state
+   * via `getDefaultConsentState`. Defaults to the universal opt-out
+   * baseline (`GlobalPrivacyControl.OptOut`).
+   */
+  readonly globalPrivacyControl?: GlobalPrivacyControl;
   readonly theme?: UseSmileIDTheme;
   /**
    * Render the bottom-pinned Allow button via a partner-supplied
@@ -107,11 +114,15 @@ export function UseSmileIDConsentScreen(props: UseSmileIDConsentScreenProps) {
   const loc = useUseSmileIDLocalizations();
   const showAttribution = props.showAttribution ?? true;
 
-  // Locale-aware default: ticked outside the EU (`true`), unticked
-  // inside (`false`) to honour GDPR opt-in. `getDefaultConsentState()`
-  // reads the resolved BCP-47 locale and checks the country segment
-  // against the EU member-state set.
-  const [consented, setConsented] = useState(() => getDefaultConsentState());
+  const globalPrivacyControl =
+    props.globalPrivacyControl ?? GlobalPrivacyControl.OptOut;
+
+  // Posture-aware default: the opt-out baseline starts ticked everywhere;
+  // the legacy opt-in posture consults the resolved BCP-47 locale and
+  // starts unticked for EU member states (GDPR opt-in).
+  const [consented, setConsented] = useState(() =>
+    getDefaultConsentState(globalPrivacyControl),
+  );
   const [learnMoreOpen, setLearnMoreOpen] = useState(false);
 
   const subtitleParts = composeConsentSubtitleParts(props.partnerName, loc);

package/src/presentation/screen/use_smile_id_document_back_instructions.tsx

@@ -1,7 +1,8 @@
-import { Pressable, StyleSheet, Text, View } from "react-native";
+import { StyleSheet, Text, View } from "react-native";
 import { SafeAreaView } from "react-native-safe-area-context";
 import type { UseSmileIDTheme } from "../theme/theme";
 import { useUseSmileIDTheme } from "../theme/theme_context";
+import { UseSmileIDAttribution } from "../components/use_smile_id_attribution";
 import { UseSmileIDBackButton } from "../components/use_smile_id_back_button";
 import { UseSmileIDButton } from "../components/use_smile_id_button";
 import { UseSmileIDInstructionsHero } from "../components/use_smile_id_instructions_hero";
@@ -48,7 +49,7 @@ export function UseSmileIDDocumentBackInstructions(
         styles.root,
         {
           backgroundColor: theme.colors.background,
-          paddingHorizontal: theme.spacing.large,
+          paddingHorizontal: theme.spacing.medium,
           paddingVertical: theme.spacing.medium,
         },
       ]}
@@ -70,12 +71,15 @@ export function UseSmileIDDocumentBackInstructions(
           ...theme.typography.pageHeading,
           fontWeight: "800",
           color: theme.colors.titleText,
+          textAlign: "center",
         }}
         testID="si_document_back_instructions_title"
       >
         {localizations.siDocumentFlipTitle(props.documentTypeDisplayName)}
       </Text>
 
+      <View style={{ height: theme.spacing.medium }} />
+
       <View style={styles.hero} testID="si_document_back_instructions_hero">
         <UseSmileIDInstructionsHero
           source={heroSource}
@@ -98,24 +102,17 @@ export function UseSmileIDDocumentBackInstructions(
         {allowSkip ? (
           <>
             <View style={{ height: theme.spacing.small }} />
-            <Pressable
-              onPress={onSkip}
-              accessibilityRole="button"
+            <UseSmileIDButton
+              label={localizations.siDocumentSkipBack}
+              onClick={onSkip}
+              variant="secondary"
+              theme={theme}
               testID="si_document_skip_back_button"
-              style={styles.skip}
-            >
-              <Text
-                style={{
-                  ...theme.typography.button,
-                  color: theme.colors.primary,
-                  textAlign: "center",
-                }}
-              >
-                {localizations.siDocumentSkipBack}
-              </Text>
-            </Pressable>
+            />
           </>
         ) : null}
+        <View style={{ height: theme.spacing.small }} />
+        <UseSmileIDAttribution theme={theme} />
       </View>
     </SafeAreaView>
   );
@@ -125,10 +122,4 @@ const styles = StyleSheet.create({
   root: { flex: 1 },
   hero: { flex: 1 },
   bottom: { alignItems: "center" },
-  skip: {
-    height: 48,
-    alignItems: "center",
-    justifyContent: "center",
-    alignSelf: "stretch",
-  },
 });

package/src/presentation/screen/use_smile_id_document_preview_screen.tsx

@@ -1,6 +1,8 @@
 import { Pressable, StyleSheet, Text, View } from "react-native";
-import { SafeAreaView } from "react-native-safe-area-context";
-import type { DocumentOrientation } from "../../core/models/document_type";
+import {
+  SafeAreaView,
+  useSafeAreaInsets,
+} from "react-native-safe-area-context";
 import type { UseSmileIDTheme } from "../theme/theme";
 import { useUseSmileIDTheme } from "../theme/theme_context";
 import { UseSmileIDAttribution } from "../components/use_smile_id_attribution";
@@ -13,8 +15,8 @@ import { useUseSmileIDLocalizations } from "../../l10n/use_smile_id_localization
 export type UseSmileIDDocumentPreviewScreenProps = {
   /** Local file URI of the captured side being reviewed (front, then back). */
   readonly capturedDocumentPath?: string;
-  /** Capture orientation — drives the document image aspect. */
-  readonly documentOrientation: DocumentOrientation;
+  /** Capture-frame aspect ratio (width / height) — drives the document image aspect. */
+  readonly documentAspectRatio: number;
   readonly showAttribution?: boolean;
   /** Confirm — commit the captured side and advance. */
   readonly onAccept?: () => void;
@@ -38,12 +40,14 @@ export function UseSmileIDDocumentPreviewScreen(
   const theme = props.theme ?? themeFromContext;
   const loc = useUseSmileIDLocalizations();
   const showAttribution = props.showAttribution ?? true;
+  const insets = useSafeAreaInsets();
 
   return (
     <SafeAreaView
+      edges={["left", "right", "bottom"]}
       style={[
         styles.root,
-        { backgroundColor: theme.colors.captureReviewBackground },
+        { backgroundColor: theme.colors.background },
       ]}
       testID="si_document_preview_screen"
     >
@@ -53,7 +57,7 @@ export function UseSmileIDDocumentPreviewScreen(
             styles.closeRow,
             {
               paddingHorizontal: theme.spacing.medium,
-              paddingTop: theme.spacing.small,
+              paddingTop: insets.top + theme.spacing.small,
             },
           ]}
         >
@@ -64,26 +68,27 @@ export function UseSmileIDDocumentPreviewScreen(
             testID="si_document_preview_close"
             style={({ pressed }) => [
               styles.closeButton,
-              {
-                backgroundColor: theme.colors.cardText,
-                opacity: pressed ? 0.7 : 1,
-              },
+              { opacity: pressed ? 0.7 : 1 },
             ]}
           >
-            <SiOutlineClose size={20} color={theme.colors.cardBackground} />
+            <SiOutlineClose size={20} color="#FFFFFF" />
           </Pressable>
         </View>
       ) : null}
 
-      <UseSmileIDCapturedDocumentImage
-        orientation={props.documentOrientation}
-        {...(props.capturedDocumentPath
-          ? { uri: props.capturedDocumentPath }
-          : {})}
-        imageTestID="si_document_preview_image"
-        imageAccessibilityLabel={loc.siPreviewAccessibilityImage}
-        theme={theme}
-      />
+      <View
+        style={[styles.imageRegion, { paddingVertical: theme.spacing.medium }]}
+      >
+        <UseSmileIDCapturedDocumentImage
+          aspectRatio={props.documentAspectRatio}
+          {...(props.capturedDocumentPath
+            ? { uri: props.capturedDocumentPath }
+            : {})}
+          imageTestID="si_document_preview_image"
+          imageAccessibilityLabel={loc.siPreviewAccessibilityImage}
+          theme={theme}
+        />
+      </View>
 
       <UseSmileIDCardSurface theme={theme} style={styles.card}>
         <Text
@@ -119,22 +124,27 @@ export function UseSmileIDDocumentPreviewScreen(
         </View>
       </UseSmileIDCardSurface>
 
-      {showAttribution ? (
-        <UseSmileIDAttribution forceLightMode theme={theme} />
-      ) : null}
+      {showAttribution ? <UseSmileIDAttribution theme={theme} /> : null}
     </SafeAreaView>
   );
 }
 
 const CLOSE_BUTTON_SIZE = 40;
+/** Warm-grey close-button fill for the document preview chrome. */
+const CLOSE_BUTTON_FILL = "#848282";
 
 const styles = StyleSheet.create({
   root: { flex: 1, overflow: "hidden" },
+  // Fills the space between the close row and the card.
+  imageRegion: { flex: 1 },
   closeRow: { flexDirection: "row", justifyContent: "flex-end" },
   closeButton: {
     width: CLOSE_BUTTON_SIZE,
     height: CLOSE_BUTTON_SIZE,
     borderRadius: CLOSE_BUTTON_SIZE / 2,
+    backgroundColor: CLOSE_BUTTON_FILL,
+    borderWidth: 1,
+    borderColor: "rgba(255,255,255,0.1)",
     alignItems: "center",
     justifyContent: "center",
   },

package/src/presentation/screen/use_smile_id_instructions_screen.tsx

@@ -33,6 +33,8 @@ export type UseSmileIDInstructionsScreenProps = {
   readonly showHeroOval?: boolean;
   /** Animate the ring's rising green progress fill. */
   readonly showHeroOvalProgress?: boolean;
+  /** Present the hero in a document card (document flows) instead of an oval. */
+  readonly showCardBackground?: boolean;
   readonly onContinue?: () => void;
   readonly onBack?: () => void;
   readonly theme?: UseSmileIDTheme;
@@ -71,6 +73,7 @@ export function UseSmileIDInstructionsScreen(
   const showAttribution = props.showAttribution ?? true;
   const showHeroOval = props.showHeroOval ?? true;
   const showHeroOvalProgress = props.showHeroOvalProgress ?? true;
+  const showCardBackground = props.showCardBackground ?? false;
   const onContinue = props.onContinue ?? (() => {});
 
   return (
@@ -112,6 +115,7 @@ export function UseSmileIDInstructionsScreen(
         source={heroSource}
         showOval={showHeroOval}
         showOvalProgress={showHeroOvalProgress}
+        showCardBackground={showCardBackground}
         theme={theme}
       />
 

package/src/presentation/screen/use_smile_id_preview_screen.tsx

@@ -1,4 +1,4 @@
-import { useState, type ReactNode } from "react";
+import { useState } from "react";
 import { StyleSheet, Text, View, type LayoutChangeEvent } from "react-native";
 import { SafeAreaView } from "react-native-safe-area-context";
 import type { UseSmileIDTheme } from "../theme/theme";
@@ -16,33 +16,19 @@ export type UseSmileIDPreviewScreenProps = {
   readonly showAttribution?: boolean;
   readonly onAccept?: () => void;
   readonly onReject?: () => void;
-  /**
-   * Render the Accept button via a partner-supplied slot.
-   *
-   * **Slot contract:** providing *any* slot (continue or cancel)
-   * replaces the *entire* default confirmation row. If you supply
-   * `continueButton` and want a Retake control too, supply
-   * `cancelButton` as well — the default Retake tile does not
-   * fall through.
-   */
-  readonly continueButton?: (props: { onClick: () => void }) => ReactNode;
-  /**
-   * Render the Reject (retake) button via a partner-supplied slot.
-   * See the slot contract note on `continueButton`.
-   */
-  readonly cancelButton?: (props: { onClick: () => void }) => ReactNode;
   readonly theme?: UseSmileIDTheme;
 };
 
 /**
  * Preview screen — confirms the captured selfie before submission.
  *
- *   - Uniform light page with the captured image clipped to the face
- *     oval. The oval scales to the leftover height above the card so
- *     the two never overlap; no scrim is painted.
- *   - Bottom card (white, rounded, soft upward shadow) with the title
- *     "Confirm image quality", a caption, and the Retake / Confirm
- *     tiles.
+ *   - Uniform page (`background`, theme-following) with the
+ *     captured image clipped to the face oval. The oval scales to the
+ *     leftover height above the card so the two never overlap; no scrim
+ *     is painted.
+ *   - Bottom card (theme card surface, rounded, soft upward shadow) with
+ *     the title "Confirm image quality", a caption, and the Retake /
+ *     Confirm tiles.
  *   - Attribution sits centered below the card.
  */
 export function UseSmileIDPreviewScreen(props: UseSmileIDPreviewScreenProps) {
@@ -73,15 +59,12 @@ export function UseSmileIDPreviewScreen(props: UseSmileIDPreviewScreenProps) {
     if (state.canRetake) props.onReject?.();
   };
 
-  const customContinue = props.continueButton;
-  const customCancel = props.cancelButton;
-  const hasSlots = Boolean(customContinue || customCancel);
-
   return (
     <SafeAreaView
+      edges={["left", "right", "bottom"]}
       style={[
         styles.root,
-        { backgroundColor: theme.colors.captureReviewBackground },
+        { backgroundColor: theme.colors.background },
       ]}
       testID="si_preview_screen"
       onLayout={onScreenLayout}
@@ -120,29 +103,20 @@ export function UseSmileIDPreviewScreen(props: UseSmileIDPreviewScreenProps) {
           {loc.siPreviewSubtitle}
         </Text>
         <View style={{ marginTop: theme.spacing.medium }}>
-          {hasSlots ? (
-            <View style={styles.buttonRow}>
-              {customCancel ? customCancel({ onClick: handleReject }) : null}
-              {customContinue
-                ? customContinue({ onClick: handleAccept })
-                : null}
-            </View>
-          ) : (
-            <UseSmileIDConfirmationButtons
-              onAccept={handleAccept}
-              onReject={handleReject}
-              acceptLabel={loc.siPreviewConfirm}
-              rejectLabel={loc.siPreviewRetake}
-              theme={theme}
-              testID="si_preview_confirmation_buttons"
-            />
-          )}
+          {/* The confirm/retake buttons are the fixed icon pair and are not
+              customisable. */}
+          <UseSmileIDConfirmationButtons
+            onAccept={handleAccept}
+            onReject={handleReject}
+            acceptLabel={loc.siPreviewConfirm}
+            rejectLabel={loc.siPreviewRetake}
+            theme={theme}
+            testID="si_preview_confirmation_buttons"
+          />
         </View>
       </UseSmileIDCardSurface>
 
-      {showAttribution ? (
-        <UseSmileIDAttribution forceLightMode theme={theme} />
-      ) : null}
+      {showAttribution ? <UseSmileIDAttribution theme={theme} /> : null}
     </SafeAreaView>
   );
 }
@@ -150,10 +124,4 @@ export function UseSmileIDPreviewScreen(props: UseSmileIDPreviewScreenProps) {
 const styles = StyleSheet.create({
   root: { flex: 1, overflow: "hidden" },
   card: { alignItems: "center" },
-  buttonRow: {
-    flexDirection: "row",
-    alignSelf: "stretch",
-    justifyContent: "space-between",
-    alignItems: "center",
-  },
 });

package/src/presentation/screen/use_smile_id_processing_screen.tsx

@@ -3,7 +3,7 @@ import { StyleSheet, View, type LayoutChangeEvent } from "react-native";
 import { SafeAreaView } from "react-native-safe-area-context";
 import type { UseSmileIDTheme } from "../theme/theme";
 import { useUseSmileIDTheme } from "../theme/theme_context";
-import type { DocumentOrientation } from "../../core/models/document_type";
+import { defaultFrameAspectRatio } from "../../core/models/document_type";
 import { UseSmileIDAttribution } from "../components/use_smile_id_attribution";
 import { UseSmileIDCapturedDocumentImage } from "../components/use_smile_id_captured_document_image";
 import { UseSmileIDCapturedImageOval } from "../components/use_smile_id_captured_image_oval";
@@ -35,8 +35,8 @@ export type UseSmileIDProcessingScreenProps = {
    * it (document-job variant).
    */
   readonly documentImageUri?: string;
-  /** Capture orientation for {@link documentImageUri}. Defaults to landscape. */
-  readonly documentOrientation?: DocumentOrientation;
+  /** Capture-frame aspect ratio (width / height) for {@link documentImageUri}. Defaults to landscape. */
+  readonly documentAspectRatio?: number;
   readonly showProgressPercentage?: boolean;
   readonly showAttribution?: boolean;
   readonly onContinue?: () => void;
@@ -110,14 +110,16 @@ export function UseSmileIDProcessingScreen(
     <SafeAreaView
       style={[
         styles.root,
-        { backgroundColor: theme.colors.captureReviewBackground },
+        { backgroundColor: theme.colors.background },
       ]}
       testID="si_processing_screen"
       onLayout={onScreenLayout}
     >
       {hasDocumentImage ? (
         <UseSmileIDCapturedDocumentImage
-          orientation={props.documentOrientation ?? "Landscape"}
+          aspectRatio={
+            props.documentAspectRatio ?? defaultFrameAspectRatio("Landscape")
+          }
           {...(props.documentImageUri ? { uri: props.documentImageUri } : {})}
           imageTestID="si_processing_document_image"
           imageAccessibilityLabel={loc.siCdCapturedImage}
@@ -208,9 +210,7 @@ export function UseSmileIDProcessingScreen(
         ) : null}
       </UseSmileIDCardSurface>
 
-      {showAttribution ? (
-        <UseSmileIDAttribution forceLightMode theme={theme} />
-      ) : null}
+      {showAttribution ? <UseSmileIDAttribution theme={theme} /> : null}
     </SafeAreaView>
   );
 }

package/src/presentation/theme/theme.ts

@@ -67,7 +67,7 @@ export type UseSmileIDColors = {
   previewRejectBorder: string;
 
   // --- Capture review (preview + processing page surface) --------
-  /** Uniform light page behind the capture-review screens. Theme-static. */
+  /** Page surface behind the capture-review screens; light in the light theme, dark in the dark theme. */
   captureReviewBackground: string;
 
   // --- Processing / cards ----------------------------------------
@@ -221,7 +221,7 @@ const sharedTypography: UseSmileIDTypography = {
   cardHeading: {
     fontFamily: dmSans("800"),
     fontSize: 20,
-    lineHeight: 26,
+    lineHeight: 25.5,
     fontWeight: "800",
     letterSpacing: -0.425,
   },
@@ -286,7 +286,7 @@ export const defaultLightTheme: UseSmileIDTheme = {
 
     background: "#F9FAFB",
     cardBackground: "#FFFFFF",
-    instructionCardBackground: "#F9F0E766",
+    instructionCardBackground: "#F9F0E7",
 
     titleText: "#21232C",
     cardText: "#5E646E",
@@ -296,11 +296,11 @@ export const defaultLightTheme: UseSmileIDTheme = {
 
     stroke: "#EAECF0",
 
-    warningFill: "#FEF3C7",
-    warningIcon: "#FF5805",
-    warningStroke: "#FFEDD5",
-    successFill: "#DCFCE7",
-    successIcon: "#2CC05C",
+    warningFill: "#EF43431A", // warning red @10%
+    warningIcon: "#EF4343",
+    warningStroke: "#EF43434D", // warning red @30%
+    successFill: "#00C8531A", // success green @10%
+    successIcon: "#00C853",
 
     captureOverlayBackground: "#FFFFFFE5",
     documentOverlayScrim: "#00000066", // black @40% — surround dim outside the frame
@@ -314,8 +314,9 @@ export const defaultLightTheme: UseSmileIDTheme = {
     ovalWarning: "#EF4343",
     ovalDirectionalIndicator: "#EF4343",
 
-    // Preview/accept/submitting tokens are theme-static (same in dark) so the
-    // capture review surface reads identically across themes.
+    // Preview accept/reject tokens are theme-static (same in dark) so the
+    // review affordances read identically across themes; the page surface
+    // (`captureReviewBackground`) follows the active theme's background.
     previewAcceptBackground: "#04B04A1A", // 10% green
     previewAcceptIcon: "#12B76A",
     previewAcceptBorder: "#04B04A4D", // 30% green
@@ -328,7 +329,7 @@ export const defaultLightTheme: UseSmileIDTheme = {
     cardShadow: "#0000001A", // black @10%
     backButtonBorder: "#FFFFFF1A", // white @10% rim on the dark fill
 
-    smileIdYellow: "#F2BD51",
+    smileIdYellow: "#FDB515",
     offBlack: "#2D2B2A",
     offWhite: "#F9F0E7",
   },
@@ -358,11 +359,11 @@ export const defaultDarkTheme: UseSmileIDTheme = {
     // 15% alpha — divider stroke on dark surfaces.
     stroke: "#EAECF026",
 
-    warningFill: "#3B2F12",
-    warningIcon: "#FF5805",
-    warningStroke: "#5C3A1A",
-    successFill: "#163B27",
-    successIcon: "#2CC05C",
+    warningFill: "#EA2D2D",
+    warningIcon: "#FFFFFF",
+    warningStroke: "#9F0000",
+    successFill: "#00E676",
+    successIcon: "#FFFFFF",
 
     captureOverlayBackground: "#FFFFFFE5",
     documentOverlayScrim: "#00000066", // black @40% — surround dim outside the frame (identical in dark)
@@ -376,20 +377,21 @@ export const defaultDarkTheme: UseSmileIDTheme = {
     ovalWarning: "#EF4343",
     ovalDirectionalIndicator: "#EF4343",
 
-    // Theme-static (match light) — the capture review surface stays consistent.
+    // Accept/reject affordances are theme-static (match light); the page
+    // surface behind them follows the dark background so cards read on-theme.
     previewAcceptBackground: "#04B04A1A", // 10% green
     previewAcceptIcon: "#12B76A",
     previewAcceptBorder: "#04B04A4D", // 30% green
     previewRejectBackground: "#F8FAFC",
     previewRejectIcon: "#90A1B9",
     previewRejectBorder: "#E2E8F0",
-    captureReviewBackground: "#F8FAFC",
+    captureReviewBackground: "#1A1C23",
 
     submittingIndicator: "#2CC05C",
     cardShadow: "#0000001A", // black @10%
     backButtonBorder: "#0000001A", // black @10% rim on the light fill
 
-    smileIdYellow: "#F2BD51",
+    smileIdYellow: "#FDB515",
     offBlack: "#F9F0E7",
     offWhite: "#2D2B2A",
   },

package/src/presentation/utils/__tests__/locale_utils.test.ts

@@ -1,37 +1,78 @@
 import { describe, expect, it } from "vitest";
 
+import {
+  GlobalPrivacyControl,
+  globalPrivacyControlFromWire,
+  GLOBAL_PRIVACY_CONTROL_WIRE_KEY,
+} from "../../../core/models/global_privacy_control";
 import { getDefaultConsentState, isDeviceLocaleInEU } from "../locale_utils";
 
 describe("locale_utils", () => {
   it("EU locale (de-DE) is recognised as EU and default consent is false", () => {
     expect(isDeviceLocaleInEU("de-DE")).toBe(true);
-    expect(getDefaultConsentState("de-DE")).toBe(false);
+    expect(getDefaultConsentState(GlobalPrivacyControl.OptIn, "de-DE")).toBe(
+      false,
+    );
   });
 
   it("non-EU locale (en-US) is not EU and default consent is true", () => {
     expect(isDeviceLocaleInEU("en-US")).toBe(false);
-    expect(getDefaultConsentState("en-US")).toBe(true);
+    expect(getDefaultConsentState(GlobalPrivacyControl.OptIn, "en-US")).toBe(
+      true,
+    );
   });
 
   it("EU locale (fr-FR) is recognised as EU and default consent is false", () => {
     expect(isDeviceLocaleInEU("fr-FR")).toBe(true);
-    expect(getDefaultConsentState("fr-FR")).toBe(false);
+    expect(getDefaultConsentState(GlobalPrivacyControl.OptIn, "fr-FR")).toBe(
+      false,
+    );
   });
 
   it("non-EU locale (en-NG) is not EU and default consent is true", () => {
     expect(isDeviceLocaleInEU("en-NG")).toBe(false);
-    expect(getDefaultConsentState("en-NG")).toBe(true);
+    expect(getDefaultConsentState(GlobalPrivacyControl.OptIn, "en-NG")).toBe(
+      true,
+    );
   });
 
   it("bare language tag with no region falls back to non-EU", () => {
     // `"fr"` has no region segment — the BCP-47 split returns
     // undefined for the country, which never matches the EU set.
     expect(isDeviceLocaleInEU("fr")).toBe(false);
-    expect(getDefaultConsentState("fr")).toBe(true);
+    expect(getDefaultConsentState(GlobalPrivacyControl.OptIn, "fr")).toBe(true);
   });
 
   it("empty locale string falls back to non-EU", () => {
     expect(isDeviceLocaleInEU("")).toBe(false);
     expect(getDefaultConsentState("")).toBe(true);
   });
+
+  describe("global privacy control", () => {
+    it("default posture forces opt-out even for EU locales", () => {
+      expect(getDefaultConsentState()).toBe(true);
+      expect(getDefaultConsentState(GlobalPrivacyControl.OptOut, "de-DE")).toBe(
+        true,
+      );
+      expect(getDefaultConsentState(GlobalPrivacyControl.OptOut, "en-NG")).toBe(
+        true,
+      );
+    });
+
+    it("parses wire values and defaults unknowns to opt-out", () => {
+      expect(globalPrivacyControlFromWire("opt-out")).toBe(
+        GlobalPrivacyControl.OptOut,
+      );
+      expect(globalPrivacyControlFromWire("opt-in")).toBe(
+        GlobalPrivacyControl.OptIn,
+      );
+      expect(globalPrivacyControlFromWire(null)).toBe(
+        GlobalPrivacyControl.OptOut,
+      );
+      expect(globalPrivacyControlFromWire("user_settings")).toBe(
+        GlobalPrivacyControl.OptOut,
+      );
+      expect(GLOBAL_PRIVACY_CONTROL_WIRE_KEY).toBe("global_privacy_control");
+    });
+  });
 });

package/src/presentation/utils/force_max_brightness.tsx

@@ -6,10 +6,10 @@ export interface ForceMaxBrightnessProps {
   /** Target brightness in the range 0.0–1.0. Defaults to 1.0 (max). */
   readonly brightness?: number;
   /**
-   * When false the component is a no-op. Defaults to true. Selfie capture uses
-   * the front camera with the screen as fill light, so callers enable it for
-   * the selfie path only; document capture uses the rear camera, where screen
-   * brightness does not help.
+   * When false the component is a no-op. Defaults to true. Every capture
+   * screen (selfie and document) mounts this enabled so the preview always
+   * runs at full brightness with the screen kept awake for the duration of
+   * the capture.
    */
   readonly enabled?: boolean;
 }