From f395819acdbeb0010bbd9a7cd23b78dd0a2d22aa Mon Sep 17 00:00:00 2001
From: Chandler Copeland <ccopeland@motivhealth.com>
Date: Sat, 21 Mar 2026 16:25:51 -0600
Subject: [PATCH] feat(12.1-02): extend DocumentPageClient with selectedFieldId
 + textFillData shared state

- Add selectedFieldId and textFillData state variables
- Add handleFieldValueChange and handleQuickFill callbacks (both call setPreviewToken(null))
- Pass selectedFieldId, textFillData, onFieldSelect, onFieldValueChange to PdfViewerWrapper
- Pass textFillData, selectedFieldId, onQuickFill to PreparePanel
- textFillData starts as {} (no clientPropertyAddress seeding)
---
 .../_components/DocumentPageClient.tsx        | 25 ++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/teressa-copeland-homes/src/app/portal/(protected)/documents/[docId]/_components/DocumentPageClient.tsx b/teressa-copeland-homes/src/app/portal/(protected)/documents/[docId]/_components/DocumentPageClient.tsx
index 8f5bf75..b28a615 100644
--- a/teressa-copeland-homes/src/app/portal/(protected)/documents/[docId]/_components/DocumentPageClient.tsx
+++ b/teressa-copeland-homes/src/app/portal/(protected)/documents/[docId]/_components/DocumentPageClient.tsx
@@ -23,15 +23,35 @@ export function DocumentPageClient({
   clientPropertyAddress,
 }: DocumentPageClientProps) {
   const [previewToken, setPreviewToken] = useState<string | null>(null);
+  const [selectedFieldId, setSelectedFieldId] = useState<string | null>(null);
+  const [textFillData, setTextFillData] = useState<Record<string, string>>({});
 
   const handleFieldsChanged = useCallback(() => {
     setPreviewToken(null);
   }, []);
 
+  const handleFieldValueChange = useCallback((fieldId: string, value: string) => {
+    setTextFillData(prev => ({ ...prev, [fieldId]: value }));
+    setPreviewToken(null); // TXTF-03: reset staleness on any text value change
+  }, []);
+
+  const handleQuickFill = useCallback((fieldId: string, value: string) => {
+    setTextFillData(prev => ({ ...prev, [fieldId]: value }));
+    setPreviewToken(null); // TXTF-03: reset staleness on quick fill
+  }, []);
+
   return (
     <div className="grid grid-cols-1 lg:grid-cols-3 gap-6">
       <div className="lg:col-span-2">
-        <PdfViewerWrapper docId={docId} docStatus={docStatus} onFieldsChanged={handleFieldsChanged} />
+        <PdfViewerWrapper
+          docId={docId}
+          docStatus={docStatus}
+          onFieldsChanged={handleFieldsChanged}
+          selectedFieldId={selectedFieldId}
+          textFillData={textFillData}
+          onFieldSelect={setSelectedFieldId}
+          onFieldValueChange={handleFieldValueChange}
+        />
       </div>
       <div className="lg:col-span-1 lg:sticky lg:top-6 lg:self-start lg:max-h-[calc(100vh-6rem)] lg:overflow-y-auto">
         <PreparePanel
@@ -44,6 +64,9 @@ export function DocumentPageClient({
           clientPropertyAddress={clientPropertyAddress}
           previewToken={previewToken}
           onPreviewTokenChange={setPreviewToken}
+          textFillData={textFillData}
+          selectedFieldId={selectedFieldId}
+          onQuickFill={handleQuickFill}
         />
       </div>
     </div>