@neofaceid/web-sdk 1.35.0 → 1.36.0

package/dist/neoface-id-sdk.es.js

@@ -1,9 +1,9 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import React, { useRef, useState, useCallback, useReducer, useEffect, forwardRef } from "react";
+import React, { useRef, useState, useCallback, useEffect, useReducer, forwardRef } from "react";
 import { createRoot } from "react-dom/client";
-import { jsxs, jsx, Fragment } from "react/jsx-runtime";
+import { jsxs, Fragment, jsx } from "react/jsx-runtime";
 import * as faceapi from "face-api.js";
 class CameraPermissionDenied extends Error {
   constructor(message) {
@@ -6219,6 +6219,201 @@ const api = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty(
   validateToken,
   videoToBase64
 }, Symbol.toStringTag, { value: "Module" }));
+function measureFrameBrightness(video, options = {}) {
+  if (!video || video.videoWidth === 0 || video.videoHeight === 0) return 0;
+  const sample = options.sample ?? 64;
+  const vw = video.videoWidth;
+  const vh = video.videoHeight;
+  const roi = options.roi ?? centerRoi(vw, vh, 0.4);
+  const canvas = options.scratch ?? document.createElement("canvas");
+  canvas.width = sample;
+  canvas.height = sample;
+  const ctx = canvas.getContext("2d", { willReadFrequently: true });
+  if (!ctx) return 0;
+  try {
+    ctx.drawImage(
+      video,
+      roi.x,
+      roi.y,
+      roi.width,
+      roi.height,
+      0,
+      0,
+      sample,
+      sample
+    );
+    const data = ctx.getImageData(0, 0, sample, sample).data;
+    return computeLumaMean(data);
+  } catch {
+    return 0;
+  }
+}
+function centerRoi(vw, vh, fraction) {
+  const w = Math.round(vw * fraction);
+  const h = Math.round(vh * fraction);
+  return {
+    x: Math.round((vw - w) / 2),
+    y: Math.round((vh - h) / 2),
+    width: w,
+    height: h
+  };
+}
+function computeLumaMean(rgba) {
+  const len = rgba.length;
+  if (len === 0) return 0;
+  let sum = 0;
+  let n = 0;
+  for (let i = 0; i < len; i += 4) {
+    const r = rgba[i];
+    const g = rgba[i + 1];
+    const b = rgba[i + 2];
+    sum += 0.2126 * r + 0.7152 * g + 0.0722 * b;
+    n += 1;
+  }
+  if (n === 0) return 0;
+  return sum / (n * 255);
+}
+const DARK_THRESHOLD$1 = 0.235;
+const IMPROVEMENT_TARGET$1 = 0.12;
+const SAMPLE_INTERVAL_MS$1 = 600;
+const EVALUATION_DELAY_MS$1 = 600;
+const MIN_TOGGLE_MS$1 = 3e3;
+function useScreenFlash(videoRef, options = {}) {
+  const enabled = options.enabled ?? true;
+  const darkThreshold = options.darkThreshold ?? DARK_THRESHOLD$1;
+  const improvementTarget = options.improvementTarget ?? IMPROVEMENT_TARGET$1;
+  const sampleIntervalMs = options.sampleIntervalMs ?? SAMPLE_INTERVAL_MS$1;
+  const minToggleMs = options.minToggleMs ?? MIN_TOGGLE_MS$1;
+  const [flashOn, setFlashOn] = useState(false);
+  const [lastBrightness, setLastBrightness] = useState(0);
+  const darkStreakRef = useRef(0);
+  const lastToggleAtRef = useRef(0);
+  const preFlashBrightnessRef = useRef(null);
+  const flashOnRef = useRef(false);
+  const scratchRef = useRef(null);
+  useEffect(() => {
+    flashOnRef.current = flashOn;
+  }, [flashOn]);
+  useEffect(() => {
+    if (!enabled) {
+      setFlashOn(false);
+      return () => {
+      };
+    }
+    if (typeof document !== "undefined" && !scratchRef.current) {
+      scratchRef.current = document.createElement("canvas");
+    }
+    let timer = null;
+    let evalTimer = null;
+    let disposed = false;
+    const tick = () => {
+      if (disposed) return;
+      const b = measureFrameBrightness(videoRef.current, {
+        scratch: scratchRef.current ?? void 0
+      });
+      setLastBrightness(b);
+      const now = Date.now();
+      if (!flashOnRef.current) {
+        if (b > 0 && b < darkThreshold) {
+          darkStreakRef.current += 1;
+        } else {
+          darkStreakRef.current = 0;
+        }
+        if (darkStreakRef.current >= 2 && now - lastToggleAtRef.current >= minToggleMs) {
+          preFlashBrightnessRef.current = b;
+          lastToggleAtRef.current = now;
+          flashOnRef.current = true;
+          setFlashOn(true);
+          darkStreakRef.current = 0;
+          evalTimer = setTimeout(() => {
+            if (disposed) return;
+            const after = measureFrameBrightness(videoRef.current, {
+              scratch: scratchRef.current ?? void 0
+            });
+            const gained = after - (preFlashBrightnessRef.current ?? 0);
+            if (gained < improvementTarget) {
+              lastToggleAtRef.current = Date.now();
+              flashOnRef.current = false;
+              setFlashOn(false);
+            }
+            preFlashBrightnessRef.current = null;
+          }, EVALUATION_DELAY_MS$1);
+        }
+      }
+    };
+    timer = setInterval(tick, sampleIntervalMs);
+    tick();
+    return () => {
+      disposed = true;
+      if (timer) clearInterval(timer);
+      if (evalTimer) clearTimeout(evalTimer);
+    };
+  }, [enabled, darkThreshold, improvementTarget, sampleIntervalMs, minToggleMs, videoRef]);
+  return { flashOn, lastBrightness };
+}
+function ScreenFlashOverlay({
+  active,
+  zIndex = 10001,
+  onDismiss
+}) {
+  if (!active) return null;
+  const overlayStyle = {
+    position: "fixed",
+    inset: 0,
+    background: "#FFFFFF",
+    zIndex,
+    pointerEvents: "none",
+    animation: "nfid-flash-in 200ms ease-out"
+  };
+  const hintStyle = {
+    position: "fixed",
+    top: 12,
+    left: "50%",
+    transform: "translateX(-50%)",
+    zIndex: zIndex + 1,
+    background: "rgba(10,19,32,.72)",
+    color: "#FFFFFF",
+    fontSize: 12,
+    fontWeight: 600,
+    letterSpacing: 0.2,
+    padding: "6px 12px",
+    borderRadius: 999,
+    pointerEvents: onDismiss ? "auto" : "none",
+    display: "flex",
+    alignItems: "center",
+    gap: 8
+  };
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("style", { children: `
+        @keyframes nfid-flash-in { from { opacity: 0 } to { opacity: 1 } }
+        @media (prefers-reduced-motion: reduce) {
+          .nfid-screen-flash { animation: none !important; }
+        }
+      ` }),
+    /* @__PURE__ */ jsx("div", { className: "nfid-screen-flash", style: overlayStyle, "aria-hidden": "true" }),
+    /* @__PURE__ */ jsxs("div", { className: "nfid-screen-flash-hint", style: hintStyle, role: "status", children: [
+      "Aumentando a luz da tela",
+      onDismiss && /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: onDismiss,
+          "aria-label": "Desligar iluminação assistiva",
+          style: {
+            background: "transparent",
+            border: "none",
+            color: "#FFFFFF",
+            cursor: "pointer",
+            fontSize: 14,
+            lineHeight: 1,
+            padding: "0 4px"
+          },
+          children: "×"
+        }
+      )
+    ] })
+  ] });
+}
 const modalReducer$1 = (state, action) => {
   switch (action.type) {
     case "PERMISSION_GRANTED":
@@ -6358,7 +6553,8 @@ function FaceCaptureModal({
   accessToken,
   onClose,
   onSuccess,
-  onCannotGesture
+  onCannotGesture,
+  autoLighting = true
 }) {
   const videoRef = useRef(null);
   const canvasRef = useRef(null);
@@ -6412,6 +6608,8 @@ function FaceCaptureModal({
   useEffect(() => {
     injectThemeStyles();
   }, []);
+  const flashEnabled = autoLighting && (state.status === "ready" || state.status === "capturing");
+  const { flashOn } = useScreenFlash(videoRef, { enabled: flashEnabled });
   useEffect(() => {
     const loadModels = async () => {
       try {
@@ -6500,6 +6698,7 @@ function FaceCaptureModal({
     setLivenessAttempts(0);
   };
   return /* @__PURE__ */ jsxs("div", { className: "neofaceid-root", style: styles.overlay, children: [
+    /* @__PURE__ */ jsx(ScreenFlashOverlay, { active: flashOn }),
     /* @__PURE__ */ jsx("style", { children: keyframes }),
     /* @__PURE__ */ jsx("style", { children: mediaStyles }),
     /* @__PURE__ */ jsxs("div", { style: styles.modal, className: "modal", children: [
@@ -6985,7 +7184,8 @@ function BiometricRegistrationModal({
   onSuccess,
   onPhotosCaptured,
   onError,
-  onCannotGesture
+  onCannotGesture,
+  autoLighting = true
 }) {
   const videoRef = useRef(null);
   const canvasRef = useRef(null);
@@ -7007,6 +7207,8 @@ function BiometricRegistrationModal({
   useEffect(() => {
     injectThemeStyles();
   }, []);
+  const flashEnabled = autoLighting && (state.status === "liveness" || state.status === "camera-loading");
+  const { flashOn } = useScreenFlash(videoRef, { enabled: flashEnabled });
   useEffect(() => {
     if (state.status === "liveness") {
       const newStep = state.step;
@@ -8384,6 +8586,7 @@ function BiometricRegistrationModal({
           }
         }
       ` }),
+    /* @__PURE__ */ jsx(ScreenFlashOverlay, { active: flashOn }),
     /* @__PURE__ */ jsx("div", { className: "neofaceid-root modal-overlay", children: /* @__PURE__ */ jsxs("div", { className: "modal-content", children: [
       /* @__PURE__ */ jsx("button", { type: "button", className: "close-button", onClick: onClose, children: "×" }),
       state.status === "liveness" && renderLivenessDetection(),
@@ -8770,6 +8973,122 @@ const DEFAULT_CONSENT_INFO = {
   privacyPolicyUrl: DEFAULT_PRIVACY_URL,
   retentionDays: DEFAULT_RETENTION_DAYS
 };
+const DARK_THRESHOLD = 0.235;
+const IMPROVEMENT_TARGET = 0.12;
+const SAMPLE_INTERVAL_MS = 600;
+const EVALUATION_DELAY_MS = 600;
+const MIN_TOGGLE_MS = 3e3;
+const OVERLAY_ID_PREFIX = "nfid-flash-";
+function createScreenFlashController(getVideo, options = {}) {
+  const darkThreshold = options.darkThreshold ?? DARK_THRESHOLD;
+  const improvementTarget = options.improvementTarget ?? IMPROVEMENT_TARGET;
+  const sampleIntervalMs = options.sampleIntervalMs ?? SAMPLE_INTERVAL_MS;
+  const minToggleMs = options.minToggleMs ?? MIN_TOGGLE_MS;
+  const zIndex = options.zIndex ?? 10001;
+  const overlayId = `${OVERLAY_ID_PREFIX}${Math.random().toString(36).slice(2, 9)}`;
+  let interval = null;
+  let evalTimer = null;
+  let flashOn = false;
+  let lastBrightness = 0;
+  let darkStreak = 0;
+  let lastToggleAt = 0;
+  let preFlashBrightness = null;
+  let overlayEl = null;
+  let scratchCanvas = null;
+  const showOverlay = () => {
+    if (overlayEl || typeof document === "undefined") return;
+    overlayEl = document.createElement("div");
+    overlayEl.id = overlayId;
+    overlayEl.setAttribute("aria-hidden", "true");
+    overlayEl.style.cssText = `
+      position: fixed; inset: 0; background: #FFFFFF;
+      z-index: ${zIndex}; pointer-events: none;
+      opacity: 0; transition: opacity 200ms ease-out;
+    `;
+    document.body.appendChild(overlayEl);
+    requestAnimationFrame(() => {
+      if (overlayEl) overlayEl.style.opacity = "1";
+    });
+  };
+  const hideOverlay = () => {
+    if (!overlayEl) return;
+    const el = overlayEl;
+    overlayEl = null;
+    el.style.opacity = "0";
+    setTimeout(() => {
+      if (el.parentNode) el.parentNode.removeChild(el);
+    }, 220);
+  };
+  const setFlashOn = (next) => {
+    if (flashOn === next) return;
+    flashOn = next;
+    if (next) showOverlay();
+    else hideOverlay();
+    if (options.onChange) options.onChange(next, lastBrightness);
+  };
+  const tick = () => {
+    if (typeof document !== "undefined" && !scratchCanvas) {
+      scratchCanvas = document.createElement("canvas");
+    }
+    const b = measureFrameBrightness(getVideo(), {
+      scratch: scratchCanvas ?? void 0
+    });
+    lastBrightness = b;
+    const now = Date.now();
+    if (!flashOn) {
+      if (b > 0 && b < darkThreshold) darkStreak += 1;
+      else darkStreak = 0;
+      if (darkStreak >= 2 && now - lastToggleAt >= minToggleMs) {
+        preFlashBrightness = b;
+        lastToggleAt = now;
+        darkStreak = 0;
+        setFlashOn(true);
+        evalTimer = setTimeout(() => {
+          const after = measureFrameBrightness(getVideo(), {
+            scratch: scratchCanvas ?? void 0
+          });
+          const gained = after - (preFlashBrightness ?? 0);
+          if (gained < improvementTarget) {
+            lastToggleAt = Date.now();
+            setFlashOn(false);
+          }
+          preFlashBrightness = null;
+        }, EVALUATION_DELAY_MS);
+      }
+    }
+  };
+  return {
+    start() {
+      if (options.enabled === false) return;
+      if (interval) return;
+      tick();
+      interval = setInterval(tick, sampleIntervalMs);
+    },
+    stop() {
+      if (interval) {
+        clearInterval(interval);
+        interval = null;
+      }
+      if (evalTimer) {
+        clearTimeout(evalTimer);
+        evalTimer = null;
+      }
+      setFlashOn(false);
+      darkStreak = 0;
+      preFlashBrightness = null;
+    },
+    destroy() {
+      this.stop();
+      scratchCanvas = null;
+    },
+    get flashOn() {
+      return flashOn;
+    },
+    get lastBrightness() {
+      return lastBrightness;
+    }
+  };
+}
 class BiometricCaptureModal {
   constructor(options) {
     __publicField(this, "modal", null);
@@ -8779,6 +9098,7 @@ class BiometricCaptureModal {
     __publicField(this, "options");
     __publicField(this, "countdownInterval", null);
     __publicField(this, "isCapturing", false);
+    __publicField(this, "flashController", null);
     this.options = options;
   }
   /**
@@ -8789,6 +9109,10 @@ class BiometricCaptureModal {
       await this.createModal();
       await this.initializeCamera();
       this.enableCaptureButton();
+      if (this.options.autoLighting !== false) {
+        this.flashController = createScreenFlashController(() => this.video);
+        this.flashController.start();
+      }
     } catch (error) {
       this.options.onError(
         new NeoFaceError(
@@ -8974,6 +9298,10 @@ class BiometricCaptureModal {
    * Limpa recursos (câmera, intervalos, etc.)
    */
   cleanup() {
+    if (this.flashController) {
+      this.flashController.destroy();
+      this.flashController = null;
+    }
     if (this.stream) {
       this.stream.getTracks().forEach((track) => track.stop());
       this.stream = null;
@@ -10866,7 +11194,7 @@ const biometricDetection = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.
   initializeBiometricDetection,
   isAdvancedDetectionAvailable
 }, Symbol.toStringTag, { value: "Module" }));
-const VERSION = "1.35.0";
+const VERSION = "1.36.0";
 const RELEASE_DATE = "2026-09-02";
 let cachedSession = null;
 function getCachedCaptureSession() {
@@ -10894,7 +11222,9 @@ async function openCaptureSession({
         "Content-Type": "application/json",
         "X-App-Token": applicationToken
       },
-      body: JSON.stringify({ purpose })
+      // NEO-424 · backend real aceita apenas valores em UPPERCASE
+      // (`AUTHORIZATION`, `LOGIN`, `ONBOARDING`, …). API pública mantém lowercase.
+      body: JSON.stringify({ purpose: String(purpose).toUpperCase() })
     });
   } catch (err) {
     const message = err instanceof Error ? err.message : "Erro de rede";
@@ -10912,16 +11242,20 @@ async function openCaptureSession({
   const raw = await response.json().catch(() => null);
   const payload = (raw == null ? void 0 : raw.data) ?? raw;
   const sessionId = payload == null ? void 0 : payload.session_id;
-  const expiresAt = payload == null ? void 0 : payload.expires_at;
-  if (!sessionId || !expiresAt) {
+  if (!sessionId) {
     throw new NeoFaceError(
-      "Resposta inválida ao abrir sessão de captura (campos ausentes)",
+      "Resposta inválida ao abrir sessão de captura (session_id ausente)",
       ErrorType.API_ERROR
     );
   }
+  const expiresAt = typeof (payload == null ? void 0 : payload.expires_at) === "string" && payload.expires_at.length > 0 ? payload.expires_at : deriveExpiresAt(payload == null ? void 0 : payload.expires_in);
   cachedSession = { session_id: sessionId, expires_at: expiresAt };
   return cachedSession;
 }
+function deriveExpiresAt(expiresIn) {
+  const seconds = typeof expiresIn === "number" && Number.isFinite(expiresIn) ? expiresIn : 0;
+  return new Date(Date.now() + seconds * 1e3).toISOString();
+}
 async function withCaptureSession(params, fn) {
   const session = cachedSession ?? await openCaptureSession(params);
   try {
@@ -11126,9 +11460,12 @@ class OnboardingCaptureModal {
     __publicField(this, "subtitle");
     __publicField(this, "faceBlob", null);
     __publicField(this, "documentBlob", null);
+    __publicField(this, "autoLighting");
+    __publicField(this, "flashController", null);
     this.countdownSeconds = (options == null ? void 0 : options.countdown) ?? 3;
     this.title = options == null ? void 0 : options.title;
     this.subtitle = options == null ? void 0 : options.subtitle;
+    this.autoLighting = (options == null ? void 0 : options.autoLighting) !== false;
   }
   /**
    * Abre o modal, inicia câmera e gerencia o fluxo de captura dos dois passos.
@@ -11242,6 +11579,10 @@ class OnboardingCaptureModal {
     }
     this.video.srcObject = this.stream;
     await this.video.play();
+    if (this.autoLighting && !this.flashController) {
+      this.flashController = createScreenFlashController(() => this.video);
+      this.flashController.start();
+    }
   }
   /**
    * Executa a contagem regressiva e atualiza textos para captura de rosto.
@@ -11326,6 +11667,10 @@ class OnboardingCaptureModal {
    * Fecha o modal e libera a câmera.
    */
   async close() {
+    if (this.flashController) {
+      this.flashController.destroy();
+      this.flashController = null;
+    }
     if (this.stream) {
       this.stream.getTracks().forEach((t) => t.stop());
       this.stream = null;
@@ -12459,201 +12804,6 @@ function AuthorizePermissionDenied({
     ] })
   ] });
 }
-function measureFrameBrightness(video, options = {}) {
-  if (!video || video.videoWidth === 0 || video.videoHeight === 0) return 0;
-  const sample = options.sample ?? 64;
-  const vw = video.videoWidth;
-  const vh = video.videoHeight;
-  const roi = options.roi ?? centerRoi(vw, vh, 0.4);
-  const canvas = options.scratch ?? document.createElement("canvas");
-  canvas.width = sample;
-  canvas.height = sample;
-  const ctx = canvas.getContext("2d", { willReadFrequently: true });
-  if (!ctx) return 0;
-  try {
-    ctx.drawImage(
-      video,
-      roi.x,
-      roi.y,
-      roi.width,
-      roi.height,
-      0,
-      0,
-      sample,
-      sample
-    );
-    const data = ctx.getImageData(0, 0, sample, sample).data;
-    return computeLumaMean(data);
-  } catch {
-    return 0;
-  }
-}
-function centerRoi(vw, vh, fraction) {
-  const w = Math.round(vw * fraction);
-  const h = Math.round(vh * fraction);
-  return {
-    x: Math.round((vw - w) / 2),
-    y: Math.round((vh - h) / 2),
-    width: w,
-    height: h
-  };
-}
-function computeLumaMean(rgba) {
-  const len = rgba.length;
-  if (len === 0) return 0;
-  let sum = 0;
-  let n = 0;
-  for (let i = 0; i < len; i += 4) {
-    const r = rgba[i];
-    const g = rgba[i + 1];
-    const b = rgba[i + 2];
-    sum += 0.2126 * r + 0.7152 * g + 0.0722 * b;
-    n += 1;
-  }
-  if (n === 0) return 0;
-  return sum / (n * 255);
-}
-const DARK_THRESHOLD = 0.235;
-const IMPROVEMENT_TARGET = 0.12;
-const SAMPLE_INTERVAL_MS = 600;
-const EVALUATION_DELAY_MS = 600;
-const MIN_TOGGLE_MS = 3e3;
-function useScreenFlash(videoRef, options = {}) {
-  const enabled = options.enabled ?? true;
-  const darkThreshold = options.darkThreshold ?? DARK_THRESHOLD;
-  const improvementTarget = options.improvementTarget ?? IMPROVEMENT_TARGET;
-  const sampleIntervalMs = options.sampleIntervalMs ?? SAMPLE_INTERVAL_MS;
-  const minToggleMs = options.minToggleMs ?? MIN_TOGGLE_MS;
-  const [flashOn, setFlashOn] = useState(false);
-  const [lastBrightness, setLastBrightness] = useState(0);
-  const darkStreakRef = useRef(0);
-  const lastToggleAtRef = useRef(0);
-  const preFlashBrightnessRef = useRef(null);
-  const flashOnRef = useRef(false);
-  const scratchRef = useRef(null);
-  useEffect(() => {
-    flashOnRef.current = flashOn;
-  }, [flashOn]);
-  useEffect(() => {
-    if (!enabled) {
-      setFlashOn(false);
-      return () => {
-      };
-    }
-    if (typeof document !== "undefined" && !scratchRef.current) {
-      scratchRef.current = document.createElement("canvas");
-    }
-    let timer = null;
-    let evalTimer = null;
-    let disposed = false;
-    const tick = () => {
-      if (disposed) return;
-      const b = measureFrameBrightness(videoRef.current, {
-        scratch: scratchRef.current ?? void 0
-      });
-      setLastBrightness(b);
-      const now = Date.now();
-      if (!flashOnRef.current) {
-        if (b > 0 && b < darkThreshold) {
-          darkStreakRef.current += 1;
-        } else {
-          darkStreakRef.current = 0;
-        }
-        if (darkStreakRef.current >= 2 && now - lastToggleAtRef.current >= minToggleMs) {
-          preFlashBrightnessRef.current = b;
-          lastToggleAtRef.current = now;
-          flashOnRef.current = true;
-          setFlashOn(true);
-          darkStreakRef.current = 0;
-          evalTimer = setTimeout(() => {
-            if (disposed) return;
-            const after = measureFrameBrightness(videoRef.current, {
-              scratch: scratchRef.current ?? void 0
-            });
-            const gained = after - (preFlashBrightnessRef.current ?? 0);
-            if (gained < improvementTarget) {
-              lastToggleAtRef.current = Date.now();
-              flashOnRef.current = false;
-              setFlashOn(false);
-            }
-            preFlashBrightnessRef.current = null;
-          }, EVALUATION_DELAY_MS);
-        }
-      }
-    };
-    timer = setInterval(tick, sampleIntervalMs);
-    tick();
-    return () => {
-      disposed = true;
-      if (timer) clearInterval(timer);
-      if (evalTimer) clearTimeout(evalTimer);
-    };
-  }, [enabled, darkThreshold, improvementTarget, sampleIntervalMs, minToggleMs, videoRef]);
-  return { flashOn, lastBrightness };
-}
-function ScreenFlashOverlay({
-  active,
-  zIndex = 10001,
-  onDismiss
-}) {
-  if (!active) return null;
-  const overlayStyle = {
-    position: "fixed",
-    inset: 0,
-    background: "#FFFFFF",
-    zIndex,
-    pointerEvents: "none",
-    animation: "nfid-flash-in 200ms ease-out"
-  };
-  const hintStyle = {
-    position: "fixed",
-    top: 12,
-    left: "50%",
-    transform: "translateX(-50%)",
-    zIndex: zIndex + 1,
-    background: "rgba(10,19,32,.72)",
-    color: "#FFFFFF",
-    fontSize: 12,
-    fontWeight: 600,
-    letterSpacing: 0.2,
-    padding: "6px 12px",
-    borderRadius: 999,
-    pointerEvents: onDismiss ? "auto" : "none",
-    display: "flex",
-    alignItems: "center",
-    gap: 8
-  };
-  return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx("style", { children: `
-        @keyframes nfid-flash-in { from { opacity: 0 } to { opacity: 1 } }
-        @media (prefers-reduced-motion: reduce) {
-          .nfid-screen-flash { animation: none !important; }
-        }
-      ` }),
-    /* @__PURE__ */ jsx("div", { className: "nfid-screen-flash", style: overlayStyle, "aria-hidden": "true" }),
-    /* @__PURE__ */ jsxs("div", { className: "nfid-screen-flash-hint", style: hintStyle, role: "status", children: [
-      "Aumentando a luz da tela",
-      onDismiss && /* @__PURE__ */ jsx(
-        "button",
-        {
-          type: "button",
-          onClick: onDismiss,
-          "aria-label": "Desligar iluminação assistiva",
-          style: {
-            background: "transparent",
-            border: "none",
-            color: "#FFFFFF",
-            cursor: "pointer",
-            fontSize: 14,
-            lineHeight: 1,
-            padding: "0 4px"
-          },
-          children: "×"
-        }
-      )
-    ] })
-  ] });
-}
 const STYLE_ID = "neofaceid-authorize-styles";
 const GESTURE_TO_GLYPH = {
   center: "center",
@@ -12987,6 +13137,7 @@ class DocumentCaptureModal {
     __publicField(this, "options");
     __publicField(this, "selectedDocument", null);
     __publicField(this, "currentStep", "select");
+    __publicField(this, "flashController", null);
     __publicField(this, "frontBlob", null);
     __publicField(this, "backBlob", null);
     this.options = {
@@ -13378,6 +13529,7 @@ class DocumentCaptureModal {
         this.video.playsInline = true;
         this.video.srcObject = this.stream;
         await this.video.play();
+        this.startScreenFlash();
       }
     } catch (error) {
       console.error("[DocumentCapture] Camera error:", error);
@@ -13390,6 +13542,7 @@ class DocumentCaptureModal {
           if (this.video) {
             this.video.srcObject = this.stream;
             await this.video.play();
+            this.startScreenFlash();
           }
         } catch (fallbackError) {
           (_c = this.resolvePromise) == null ? void 0 : _c.call(this, {
@@ -13404,11 +13557,22 @@ class DocumentCaptureModal {
     }
   }
   stopCamera() {
+    if (this.flashController) {
+      this.flashController.destroy();
+      this.flashController = null;
+    }
     if (this.stream) {
       this.stream.getTracks().forEach((track) => track.stop());
       this.stream = null;
     }
   }
+  // NEO-425 · US14.11.a — screen flash assistivo. Chamado após câmera acordar.
+  startScreenFlash() {
+    if (this.options.autoLighting === false) return;
+    if (this.flashController) return;
+    this.flashController = createScreenFlashController(() => this.video);
+    this.flashController.start();
+  }
   async handleCapture() {
     var _a2;
     if (!this.video || !this.canvas) return;