chore: merge main, resolve biome formatting conflicts

Merge origin/main into feat/external-2fa-codes. Resolve formatting
conflicts caused by biome rollout; preserve both feature streams:
PR's external 2FA token + signing-session 2FA proof additions plus
main's RateLimit/RecipientExpired/signingReminders/date-auto-insert.

In complete-document-with-token.ts, drop the duplicate early
field-fetching block introduced when main moved that logic later
with date auto-insert support; keep the EXTERNAL_TWO_FACTOR_AUTH
check using derivedRecipientActionAuth.

packages/ui/components/field/envelope-field-tooltip.tsx

@@ -1,12 +1,10 @@
-import { useCallback, useEffect, useState } from 'react';
-
+import { getBoundingClientRect } from '@documenso/lib/client-only/get-bounding-client-rect';
+import { PDF_VIEWER_PAGE_SELECTOR } from '@documenso/lib/constants/pdf-viewer';
 import type { Field } from '@prisma/client';
 import { TooltipArrow } from '@radix-ui/react-tooltip';
 import type { VariantProps } from 'class-variance-authority';
 import { cva } from 'class-variance-authority';
-
-import { getBoundingClientRect } from '@documenso/lib/client-only/get-bounding-client-rect';
-import { PDF_VIEWER_PAGE_SELECTOR } from '@documenso/lib/constants/pdf-viewer';
+import { useCallback, useEffect, useState } from 'react';
 
 import { cn } from '../../lib/utils';
 import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '../../primitives/tooltip';
@@ -26,21 +24,13 @@ const tooltipVariants = cva('font-semibold', {
 interface EnvelopeFieldToolTipProps extends VariantProps<typeof tooltipVariants> {
   children: React.ReactNode;
   className?: string;
-  field: Pick<
-    Field,
-    'id' | 'inserted' | 'fieldMeta' | 'positionX' | 'positionY' | 'width' | 'height' | 'page'
-  >;
+  field: Pick<Field, 'id' | 'inserted' | 'fieldMeta' | 'positionX' | 'positionY' | 'width' | 'height' | 'page'>;
 }
 
 /**
  * Renders a tooltip for a given field.
  */
-export function EnvelopeFieldToolTip({
-  children,
-  color,
-  className = '',
-  field,
-}: EnvelopeFieldToolTipProps) {
+export function EnvelopeFieldToolTip({ children, color, className = '', field }: EnvelopeFieldToolTipProps) {
   const [coords, setCoords] = useState({
     x: 0,
     y: 0,
@@ -49,9 +39,7 @@ export function EnvelopeFieldToolTip({
   });
 
   const calculateCoords = useCallback(() => {
-    const $page = document.querySelector<HTMLElement>(
-      `${PDF_VIEWER_PAGE_SELECTOR}[data-page-number="${field.page}"]`,
-    );
+    const $page = document.querySelector<HTMLElement>(`${PDF_VIEWER_PAGE_SELECTOR}[data-page-number="${field.page}"]`);
 
     if (!$page) {
       return;
@@ -90,9 +78,7 @@ export function EnvelopeFieldToolTip({
   }, [calculateCoords]);
 
   useEffect(() => {
-    const $page = document.querySelector<HTMLElement>(
-      `${PDF_VIEWER_PAGE_SELECTOR}[data-page-number="${field.page}"]`,
-    );
+    const $page = document.querySelector<HTMLElement>(`${PDF_VIEWER_PAGE_SELECTOR}[data-page-number="${field.page}"]`);
 
     if (!$page) {
       return;
@@ -124,7 +110,7 @@ export function EnvelopeFieldToolTip({
         <Tooltip delayDuration={0} open={!field.inserted || !field.fieldMeta}>
           <TooltipTrigger className="absolute inset-0 w-full"></TooltipTrigger>
 
-          <TooltipContent className={tooltipVariants({ color, className })} sideOffset={2}>
+          <TooltipContent className={tooltipVariants({ color, className: cn(className, 'z-40') })} sideOffset={2}>
             {children}
             <TooltipArrow />
           </TooltipContent>

packages/ui/components/field/field-tooltip.tsx

@@ -1,18 +1,12 @@
+import { useFieldPageCoords } from '@documenso/lib/client-only/hooks/use-field-page-coords';
 import type { Field } from '@prisma/client';
 import { TooltipArrow } from '@radix-ui/react-tooltip';
 import type { VariantProps } from 'class-variance-authority';
 import { cva } from 'class-variance-authority';
 import { createPortal } from 'react-dom';
 
-import { useFieldPageCoords } from '@documenso/lib/client-only/hooks/use-field-page-coords';
-
 import { cn } from '../..//lib/utils';
-import {
-  Tooltip,
-  TooltipContent,
-  TooltipProvider,
-  TooltipTrigger,
-} from '../..//primitives/tooltip';
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '../..//primitives/tooltip';
 
 const tooltipVariants = cva('font-semibold', {
   variants: {
@@ -29,10 +23,7 @@ const tooltipVariants = cva('font-semibold', {
 interface FieldToolTipProps extends VariantProps<typeof tooltipVariants> {
   children: React.ReactNode;
   className?: string;
-  field: Pick<
-    Field,
-    'id' | 'inserted' | 'fieldMeta' | 'positionX' | 'positionY' | 'width' | 'height' | 'page'
-  >;
+  field: Pick<Field, 'id' | 'inserted' | 'fieldMeta' | 'positionX' | 'positionY' | 'width' | 'height' | 'page'>;
 }
 
 /**
@@ -65,7 +56,7 @@ export function FieldToolTip({ children, color, className = '', field }: FieldTo
           <TooltipTrigger className="absolute inset-0 w-full"></TooltipTrigger>
 
           <TooltipContent
-            className={tooltipVariants({ color, className })}
+            className={tooltipVariants({ color, className: cn(className, 'z-40') })}
             sideOffset={2}
             onClick={onTooltipContentClick}
           >

packages/ui/components/field/field.tsx

@@ -1,12 +1,11 @@
-import React, { useEffect, useMemo, useState } from 'react';
-
-import { type Field, FieldType } from '@prisma/client';
-import { createPortal } from 'react-dom';
-
 import { useElementBounds } from '@documenso/lib/client-only/hooks/use-element-bounds';
 import { useFieldPageCoords } from '@documenso/lib/client-only/hooks/use-field-page-coords';
-import { PDF_VIEWER_PAGE_SELECTOR } from '@documenso/lib/constants/pdf-viewer';
+import { useIsPageInDom } from '@documenso/lib/client-only/hooks/use-is-page-in-dom';
+import { PDF_VIEWER_CONTENT_SELECTOR, PDF_VIEWER_PAGE_SELECTOR } from '@documenso/lib/constants/pdf-viewer';
 import { isFieldUnsignedAndRequired } from '@documenso/lib/utils/advanced-fields-helpers';
+import { type Field, FieldType } from '@prisma/client';
+import React, { useEffect, useMemo, useState } from 'react';
+import { createPortal } from 'react-dom';
 
 import type { RecipientColorStyles } from '../../lib/recipient-colors';
 import { cn } from '../../lib/utils';
@@ -17,17 +16,11 @@ export type FieldContainerPortalProps = {
   children: React.ReactNode;
 };
 
-export function FieldContainerPortal({
-  field,
-  children,
-  className = '',
-}: FieldContainerPortalProps) {
+export function FieldContainerPortal({ field, children, className = '' }: FieldContainerPortalProps) {
   const alternativePortalRoot = document.getElementById('document-field-portal-root');
 
   const coords = useFieldPageCoords(field);
-  const $pageBounds = useElementBounds(
-    `${PDF_VIEWER_PAGE_SELECTOR}[data-page-number="${field.page}"]`,
-  );
+  const $pageBounds = useElementBounds(`${PDF_VIEWER_PAGE_SELECTOR}[data-page-number="${field.page}"]`);
 
   const maxWidth = $pageBounds?.width ? $pageBounds.width - coords.x : undefined;
 
@@ -73,14 +66,10 @@ export type FieldRootContainerProps = {
   readonly?: boolean;
 };
 
-export function FieldRootContainer({
-  field,
-  children,
-  color,
-  className,
-  readonly,
-}: FieldRootContainerProps) {
+export function FieldRootContainer({ field, children, color, className, readonly }: FieldRootContainerProps) {
   const [isValidating, setIsValidating] = useState(false);
+  const isPageInDom = useIsPageInDom(field.page);
+
   const ref = React.useRef<HTMLDivElement>(null);
 
   useEffect(() => {
@@ -88,6 +77,18 @@ export function FieldRootContainer({
       return;
     }
 
+    // Check the validation signal on the PDF viewer container. When a field
+    // mounts after the virtual list scrolls to its page, the per-element
+    // `data-validate` attribute will not have been set yet. The signal on the
+    // `[data-pdf-content]` container bridges this gap so newly-rendered fields
+    // pick up the validation state immediately.
+    const pdfContent = document.querySelector(PDF_VIEWER_CONTENT_SELECTOR);
+
+    if (pdfContent?.getAttribute('data-validate-fields') === 'true' && isFieldUnsignedAndRequired(field)) {
+      ref.current.setAttribute('data-validate', 'true');
+      setIsValidating(true);
+    }
+
     const observer = new MutationObserver((_mutations) => {
       if (ref.current) {
         setIsValidating(ref.current.getAttribute('data-validate') === 'true');
@@ -101,7 +102,11 @@ export function FieldRootContainer({
     return () => {
       observer.disconnect();
     };
-  }, []);
+  }, [isPageInDom]);
+
+  if (!isPageInDom) {
+    return null;
+  }
 
   return (
     <FieldContainerPortal field={field}>