feat(#10676): require explicit skip action after GPS capture failure

Previously, GPS failure immediately wrote 'not_captured' to the hidden
input, allowing the form to advance without user acknowledgement. Now
the widget waits: retry/skip buttons are shown but the input stays
empty. Clicking Skip removes the buttons, shows a localized confirmation
message, and writes 'skipped' to the input. The geo_capture bind is
marked required so the form cannot be submitted until the user either
captures or explicitly skips.

Also stops the context radio change event from propagating to Enketo's
form handler, which was logging 'Data node not found' warnings and
failing integration tests.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: cliftonmcintosh

api/resources/translations/messages-en.properties

@@ -729,6 +729,7 @@ geolocation.progress = Progress
 geolocation.result.label = Result
 geolocation.retry = Retry here to capture GPS location
 geolocation.skip = Continue without location tracking
+geolocation.skipped = Continuing without location capture
 geolocation.success = Success
 geolocation.unavailable = GPS is not available on this device.
 health_center.field.children = Areas

api/resources/translations/messages-es.properties

@@ -729,6 +729,7 @@ geolocation.progress = Progreso
 geolocation.result.label = Resultado
 geolocation.retry = Reintentar
 geolocation.skip = Continuar sin seguimiento de ubicación
+geolocation.skipped = Continuando sin capturar la ubicación
 geolocation.success = Exitoso
 geolocation.unavailable = El GPS no está disponible en este dispositivo.
 health_center.field.children = Áreas

api/resources/translations/messages-fr.properties

@@ -729,6 +729,7 @@ geolocation.progress = Progression
 geolocation.result.label = Résultat
 geolocation.retry = Réessayer
 geolocation.skip = Continuer sans suivi de localisation
+geolocation.skipped = Poursuite sans capture de localisation
 geolocation.success = Succès
 geolocation.unavailable = Le GPS n'est pas disponible sur cet appareil.
 health_center.field.children = Cliniques

api/resources/translations/messages-ne.properties

@@ -729,6 +729,7 @@ geolocation.progress = प्रगति
 geolocation.result.label = परिणाम
 geolocation.retry = पुनः प्रयास गर्नुहोस्
 geolocation.skip = स्थान ट्र्याकिङ बिना जारी राख्नुहोस्
+geolocation.skipped = स्थान कैप्चर बिना जारी राख्दै
 geolocation.success = सफल
 geolocation.unavailable = यस उपकरणमा GPS उपलब्ध छैन।
 health_center.field.children = क्लिनिक

api/resources/translations/messages-sw.properties

@@ -729,6 +729,7 @@ geolocation.progress = Maendeleo
 geolocation.result.label = Matokeo
 geolocation.retry = Jaribu tena
 geolocation.skip = Endelea bila ufuatiliaji wa eneo
+geolocation.skipped = Inaendelea bila kupata eneo
 geolocation.success = Imefaulu
 geolocation.unavailable = GPS haipatikani kwenye kifaa hiki.
 health_center.field.children = Eneo

tests/e2e/default/contacts/forms/geolocation-contact-create.xml

@@ -29,7 +29,7 @@
       <bind nodeset="/data/person_with_geo/parent" type="string"/>
       <bind nodeset="/data/person_with_geo/type" type="string"/>
       <bind nodeset="/data/person_with_geo/name" type="string" required="true()"/>
-      <bind nodeset="/data/person_with_geo/geo_capture" type="string"/>
+      <bind nodeset="/data/person_with_geo/geo_capture" type="string" required="true()"/>
       <bind nodeset="/data/meta/instanceID" type="string" readonly="true()" jr:preload="uid"/>
     </model>
   </h:head>

tests/e2e/default/contacts/geolocation-widget.wdio-spec.js

@@ -15,6 +15,22 @@ const selectHomeContext = async () => {
   await $('.geolocation-context-options input[value="home"]').click();
 };
 
+const captureAndWait = async () => {
+  await $('.geolocation-capture-btn').click();
+  // GPS may succeed or fail depending on the environment. Wait for either outcome.
+  await browser.waitUntil(
+    async () => {
+      const success = await $('.geolocation-success-msg').isExisting();
+      const skip = await $('.geolocation-skip-btn').isExisting();
+      return success || skip;
+    },
+    { timeout: 35000 }
+  );
+  if (await $('.geolocation-skip-btn').isExisting()) {
+    await $('.geolocation-skip-btn').click();
+  }
+};
+
 describe('Geolocation widget - contact save pipeline', () => {
   const places = placeFactory.generateHierarchy();
   const healthCenter = places.get(CONTACT_TYPES.HEALTH_CENTER);
@@ -91,6 +107,7 @@ describe('Geolocation widget - contact save pipeline', () => {
 
     await $('.or-appearance-geolocation-capture').waitForDisplayed();
     await selectHomeContext();
+    await captureAndWait();
     await commonEnketoPage.setInputValue('Full name', 'Test Person With Geo');
     await genericForm.submitForm();
     await commonPage.waitForPageLoaded();

tests/integration/cht-form/default/forms/geolocation-widget.xml

@@ -9,6 +9,7 @@
           <meta><instanceID/></meta>
         </data>
       </instance>
+      <bind nodeset="/data/geo_capture" type="string" required="true()"/>
     </model>
   </h:head>
   <h:body>

tests/integration/cht-form/default/geolocation-widget.wdio-spec.js

@@ -110,4 +110,22 @@ describe('cht-form web component - Geolocation Widget', () => {
     await $('.geolocation-retry-btn').waitForExist();
     expect(await $('.geolocation-context-options').isDisplayed()).to.be.false;
   });
+
+  it('should show a confirmation message and remove retry/skip buttons when skip is clicked', async () => {
+    await mockConfig.loadForm('default', 'test', 'geolocation-widget');
+
+    await browser.execute((geoFailure) => {
+      window.CHTCore.Geolocation = { currentPromise: Promise.resolve(geoFailure), retry: () => {} };
+    }, GEO_FAILURE);
+
+    await selectHomeContext();
+    await $('.geolocation-capture-btn').click();
+
+    await $('.geolocation-skip-btn').waitForExist();
+    await $('.geolocation-skip-btn').click();
+
+    await $('.geolocation-skipped-msg').waitForExist();
+    expect(await $('.geolocation-retry-btn').isExisting()).to.be.false;
+    expect(await $('.geolocation-skip-btn').isExisting()).to.be.false;
+  });
 });

webapp/src/css/enketo/medic.less

@@ -423,6 +423,11 @@
         text-align: left;
         background-color: @gray-light;
       }
+
+      .geolocation-skipped-msg {
+        margin: 4px 0;
+        font-style: italic;
+      }
     }
   }