feat: add Emergency provider (nature, location, instruction) (#1794)

* feat: add Emergency provider (nature, location, instruction)

Adds a new base provider that generates emergency-related fake data:

  faker.emergency().nature()       // "Fire", "Flood", "Tornado", ...
  faker.emergency().location()     // "Highway", "Shopping mall", ...
  faker.emergency().instruction()  // "Evacuate the building", ...

Includes the provider class, YAML dataset with 35 natures, 35
locations, and 30 instructions, BaseProviders wiring, EnFile resource
registration, and the standard provider-list test.

Closes #1793

* feat: add dryRun flag and emergencyCase sub-provider

Extends Emergency with:
- dryRun(): boolean flag distinguishing training alerts from real
  emergencies (per @L-Evg's suggestion in #1794)
- emergencyCase(): bundles nature, location, instruction, and dryRun
  into an EmergencyCase record for a single-call full emergency

Also fixes the @SInCE tag from 2.7.0 to 2.6.0 (per @kingthorin's review).

---------

Co-authored-by: Matt Van Horn <455140+mvanhorn@users.noreply.github.com>

Author: mvanhorn

src/main/java/net/datafaker/providers/base/BaseProviders.java

@@ -209,6 +209,10 @@ default ElectricalComponents electricalComponents() {
         return getProvider(ElectricalComponents.class, ElectricalComponents::new);
     }
 
+    default Emergency emergency() {
+        return getProvider(Emergency.class, Emergency::new);
+    }
+
     default Emoji emoji() {
         return getProvider(Emoji.class, Emoji::new);
     }

src/main/java/net/datafaker/providers/base/Emergency.java

@@ -0,0 +1,57 @@
+package net.datafaker.providers.base;
+
+/**
+ * Generates emergency-related fake data: the nature of an emergency
+ * (fire, flood, tornado, ...), a plausible emergency location, an
+ * instruction someone might be asked to follow in response, and a
+ * dry-run flag distinguishing training alerts from real emergencies.
+ *
+ * @since 2.6.0
+ */
+public class Emergency extends AbstractProvider<BaseProviders> {
+
+    protected Emergency(BaseProviders faker) {
+        super(faker);
+    }
+
+    /**
+     * @return a type of emergency, e.g. "Fire", "Flood", "Tornado".
+     */
+    public String nature() {
+        return resolve("emergency.nature");
+    }
+
+    /**
+     * @return a plausible location where an emergency might occur,
+     * e.g. "Highway", "Downtown office building".
+     */
+    public String location() {
+        return resolve("emergency.location");
+    }
+
+    /**
+     * @return an instruction to follow during an emergency, e.g.
+     * "Evacuate the building", "Shelter in place".
+     */
+    public String instruction() {
+        return resolve("emergency.instruction");
+    }
+
+    /**
+     * @return {@code true} for a dry-run (training) alert, {@code false}
+     * for a real emergency.
+     */
+    public boolean dryRun() {
+        return faker.random().nextBoolean();
+    }
+
+    /**
+     * @return a complete emergency case bundling {@link #nature()},
+     * {@link #location()}, {@link #instruction()}, and {@link #dryRun()}.
+     */
+    public EmergencyCase emergencyCase() {
+        return new EmergencyCase(nature(), location(), instruction(), dryRun());
+    }
+
+    public record EmergencyCase(String nature, String location, String instruction, boolean dryRun) { }
+}

src/main/java/net/datafaker/service/files/EnFile.java

@@ -103,6 +103,7 @@ public String getPath() {
         "elden_ring.yml",
         "elder_scrolls.yml",
         "electrical_components.yml",
+        "emergency.yml",
         "emoji.yml",
         "esport.yml",
         "englandfootball.yml",

src/main/resources/en/emergency.yml

@@ -0,0 +1,106 @@
+en:
+  faker:
+    emergency:
+      nature:
+      - "Fire"
+      - "Flood"
+      - "Earthquake"
+      - "Tornado"
+      - "Hurricane"
+      - "Tsunami"
+      - "Wildfire"
+      - "Landslide"
+      - "Volcanic eruption"
+      - "Blizzard"
+      - "Severe thunderstorm"
+      - "Hailstorm"
+      - "Heatwave"
+      - "Cold wave"
+      - "Drought"
+      - "Power outage"
+      - "Gas leak"
+      - "Chemical spill"
+      - "Nuclear incident"
+      - "Building collapse"
+      - "Bridge collapse"
+      - "Vehicle accident"
+      - "Train derailment"
+      - "Aircraft incident"
+      - "Maritime incident"
+      - "Medical emergency"
+      - "Pandemic outbreak"
+      - "Hazardous materials"
+      - "Structural fire"
+      - "Forest fire"
+      - "Explosion"
+      - "Bomb threat"
+      - "Active shooter"
+      - "Civil unrest"
+      - "Missing person"
+      location:
+      - "Residential building"
+      - "Downtown office tower"
+      - "Shopping mall"
+      - "School"
+      - "Hospital"
+      - "University campus"
+      - "Factory"
+      - "Warehouse"
+      - "Highway"
+      - "Subway station"
+      - "Train station"
+      - "Bus terminal"
+      - "Airport terminal"
+      - "Seaport"
+      - "Sports stadium"
+      - "Concert venue"
+      - "Convention center"
+      - "Hotel"
+      - "Restaurant"
+      - "Gas station"
+      - "Chemical plant"
+      - "Power plant"
+      - "Data center"
+      - "Apartment complex"
+      - "Government building"
+      - "Park"
+      - "Parking garage"
+      - "Construction site"
+      - "Farm"
+      - "Forest"
+      - "Riverbank"
+      - "Coastline"
+      - "Mountain trail"
+      - "Rural road"
+      - "City square"
+      instruction:
+      - "Evacuate the building immediately"
+      - "Shelter in place"
+      - "Move to higher ground"
+      - "Take cover under a sturdy desk"
+      - "Use the stairs, not the elevator"
+      - "Proceed to the nearest exit"
+      - "Assemble at the designated meeting point"
+      - "Do not re-enter the building"
+      - "Cover your mouth and nose"
+      - "Stay away from windows"
+      - "Turn off gas and electricity"
+      - "Call emergency services"
+      - "Remain calm and await instructions"
+      - "Follow the marked evacuation route"
+      - "Do not use open flames"
+      - "Check on neighbors if safe to do so"
+      - "Stay tuned to official broadcasts"
+      - "Wear protective clothing"
+      - "Avoid downed power lines"
+      - "Drop, cover, and hold on"
+      - "Secure loose objects"
+      - "Do not drive through flooded roads"
+      - "Keep your distance from the affected area"
+      - "Administer first aid if trained"
+      - "Evacuate by vehicle using authorized routes"
+      - "Return only when authorities give the all clear"
+      - "Conserve drinking water"
+      - "Boil water before consumption"
+      - "Move vehicles away from buildings"
+      - "Silence your phone and listen for alerts"

src/test/java/net/datafaker/providers/base/EmergencyTest.java

@@ -0,0 +1,34 @@
+package net.datafaker.providers.base;
+
+import java.util.Collection;
+import java.util.List;
+
+import org.junit.jupiter.api.Test;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+final class EmergencyTest extends BaseFakerTest {
+
+    @Override
+    protected Collection<TestSpec> providerListTest() {
+        Emergency emergency = faker.emergency();
+        return List.of(
+            TestSpec.of(emergency::nature, "emergency.nature"),
+            TestSpec.of(emergency::location, "emergency.location"),
+            TestSpec.of(emergency::instruction, "emergency.instruction"));
+    }
+
+    @Test
+    void shouldReturnDryRunFlag() {
+        assertThat(faker.emergency().dryRun()).isIn(false, true);
+    }
+
+    @Test
+    void shouldReturnEmergencyCase() {
+        Emergency.EmergencyCase emergencyCase = faker.emergency().emergencyCase();
+        assertThat(emergencyCase.nature()).isNotEmpty();
+        assertThat(emergencyCase.location()).isNotEmpty();
+        assertThat(emergencyCase.instruction()).isNotEmpty();
+        assertThat(emergencyCase.dryRun()).isIn(false, true);
+    }
+}