Expand README ant section, seed five locale bundles

README.md
  - 'Ant + Ivy (JOSM plugins)' becomes generic 'Ant + Ivy' with a
    paragraph explaining the default Ivy resolver chain and a
    pointer at smoke/ as a complete worked example any downstream
    Ant consumer can crib from. Removes the JOSM-specific framing
    so the section reads as the canonical reference for any Ant
    user.
  - All dependency snippets bumped from 0.2.0 to 0.3.0 (Maven,
    Gradle, Ivy).
  - Status banner updated: latest release 0.3.0, available on
    Maven Central since 0.2.0.

src/main/resources/io/github/openhistoricalmap/edtf/format/
  Five new locale bundles seeded as bootstrap translations:
  messages_de, messages_es, messages_fr, messages_it, messages_ja.
  Same key set as the canonical English messages.properties.
  Non-ASCII characters use \u escapes so the files survive
  transcoding regardless of editor.

  These are bootstrap translations to seed the Transifex project;
  per CONTRIBUTING.md, ongoing translation work flows through tx
  pull / push rather than direct file edits.

EdtfFormatterTest
  Nine new tests exercising locale switching: German qualifier,
  interval, and locale-aware month name (java.time picks up
  'Mai' for May automatically); French qualifier and interval;
  Spanish century / decade; Italian BCE year; Japanese season.
  Plus a fallback test (a Klingon-locale formatter still produces
  English because no messages_tlh.properties exists).

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

Author: jeffreyameyer

README.md

@@ -12,8 +12,8 @@ Format (EDTF)][edtf] strings, per **ISO 8601-2:2019** (with Amendment 1,
 This is a port of the JavaScript library [edtf.js][edtf-js] to the JVM,
 targeting Java 17+ with zero runtime dependencies.
 
-> **Status**: First public release (0.2.0). Available on Maven
-> Central.
+> **Status**: Latest release `0.3.0`. Available on Maven Central
+> (since `0.2.0`).
 
 ## Quick start
 
@@ -37,22 +37,40 @@ Available on Maven Central as of `0.2.0`.
 <dependency>
     <groupId>io.github.openhistoricalmap</groupId>
     <artifactId>edtf</artifactId>
-    <version>0.2.0</version>
+    <version>0.3.0</version>
 </dependency>
 ```
 
 ### Gradle
 
 ```groovy
-implementation 'io.github.openhistoricalmap:edtf:0.2.0'
+implementation 'io.github.openhistoricalmap:edtf:0.3.0'
 ```
 
-### Ant + Ivy (JOSM plugins)
+### Ant + Ivy
+
+For Ant projects that resolve dependencies via [Apache Ivy][ivy].
+Drop this into the `<dependencies>` block of your `ivy.xml`:
 
 ```xml
-<dependency org="io.github.openhistoricalmap" name="edtf" rev="0.2.0"/>
+<dependency org="io.github.openhistoricalmap" name="edtf" rev="0.3.0"/>
 ```
 
+The default Ivy resolver chain pulls from Maven Central
+(`repo1.maven.org`), so no additional `ivysettings.xml` is needed
+in most cases. If you maintain a custom resolver chain, ensure
+Maven Central is reachable.
+
+A complete worked example lives at [`smoke/`](smoke/) in this
+repository: a self-contained Ant project (`build.xml` + `ivy.xml` +
+`src/Smoke.java`) that resolves the published artefact, compiles
+against it, runs a tiny program, and asserts on the output.
+[`.github/workflows/smoke.yml`](.github/workflows/smoke.yml) runs
+it daily as a regression check &mdash; the same setup any
+downstream Ant consumer can crib from.
+
+[ivy]: https://ant.apache.org/ivy/
+
 ## EDTF coverage
 
 | Level | Description                                        | Status                 |

src/main/resources/io/github/openhistoricalmap/edtf/format/messages_de.properties

@@ -0,0 +1,43 @@
+# German translation of edtf-java formatter strings.
+#
+# These initial translations seed Transifex; future updates should
+# come through the tx pull / push workflow rather than direct edits.
+# See CONTRIBUTING.md "Localization" for the contributor flow.
+#
+# Java 9+ reads .properties files as UTF-8 by default, but \\u
+# escapes are used here for non-ASCII characters so the files are
+# readable in any editor and survive transcoding.
+
+qualifier.uncertain   = {0} (unsicher)
+qualifier.approximate = circa {0}
+qualifier.mixed       = circa {0} (unsicher)
+
+decade  = die {0}er Jahre
+century = die {0}er Jahre
+
+year.ce    = {0}
+year.bce   = {0} v. Chr.
+year.large = Jahr {0}
+
+season.21 = Q1 {0}
+season.22 = Q2 {0}
+season.23 = Q3 {0}
+season.24 = Q4 {0}
+
+interval.bounded      = {0} bis {1}
+interval.openLower    = vor {0}
+interval.openUpper    = ab {0}
+interval.openBoth     = jederzeit
+interval.unknownLower = bis {0}
+interval.unknownUpper = ab {0}
+
+set.empty  = (leere Menge)
+set.one    = {0}
+set.two    = {0} oder {1}
+set.many   = eines von: {0}
+list.empty = (leere Liste)
+list.one   = {0}
+list.two   = {0} und {1}
+list.many  = {0}
+
+fallback = {0}

src/main/resources/io/github/openhistoricalmap/edtf/format/messages_es.properties

@@ -0,0 +1,36 @@
+# Spanish translation of edtf-java formatter strings.
+# See messages_de.properties for the Transifex bootstrap note.
+
+qualifier.uncertain   = {0} (incierto)
+qualifier.approximate = circa {0}
+qualifier.mixed       = circa {0} (incierto)
+
+decade  = los a\u00f1os {0}
+century = los a\u00f1os {0}
+
+year.ce    = {0}
+year.bce   = {0} a. C.
+year.large = A\u00f1o {0}
+
+season.21 = T1 {0}
+season.22 = T2 {0}
+season.23 = T3 {0}
+season.24 = T4 {0}
+
+interval.bounded      = de {0} a {1}
+interval.openLower    = antes de {0}
+interval.openUpper    = desde {0}
+interval.openBoth     = en cualquier momento
+interval.unknownLower = hasta {0}
+interval.unknownUpper = desde {0}
+
+set.empty  = (conjunto vac\u00edo)
+set.one    = {0}
+set.two    = {0} o {1}
+set.many   = uno de: {0}
+list.empty = (lista vac\u00eda)
+list.one   = {0}
+list.two   = {0} y {1}
+list.many  = {0}
+
+fallback = {0}

src/main/resources/io/github/openhistoricalmap/edtf/format/messages_fr.properties

@@ -0,0 +1,36 @@
+# French translation of edtf-java formatter strings.
+# See messages_de.properties for the Transifex bootstrap note.
+
+qualifier.uncertain   = {0} (incertain)
+qualifier.approximate = vers {0}
+qualifier.mixed       = vers {0} (incertain)
+
+decade  = les ann\u00e9es {0}
+century = les ann\u00e9es {0}
+
+year.ce    = {0}
+year.bce   = {0} av. J.-C.
+year.large = An {0}
+
+season.21 = T1 {0}
+season.22 = T2 {0}
+season.23 = T3 {0}
+season.24 = T4 {0}
+
+interval.bounded      = de {0} \u00e0 {1}
+interval.openLower    = avant {0}
+interval.openUpper    = \u00e0 partir de {0}
+interval.openBoth     = \u00e0 tout moment
+interval.unknownLower = jusqu'\u00e0 {0}
+interval.unknownUpper = depuis {0}
+
+set.empty  = (ensemble vide)
+set.one    = {0}
+set.two    = {0} ou {1}
+set.many   = l''un de\u00a0: {0}
+list.empty = (liste vide)
+list.one   = {0}
+list.two   = {0} et {1}
+list.many  = {0}
+
+fallback = {0}

src/main/resources/io/github/openhistoricalmap/edtf/format/messages_it.properties

@@ -0,0 +1,36 @@
+# Italian translation of edtf-java formatter strings.
+# See messages_de.properties for the Transifex bootstrap note.
+
+qualifier.uncertain   = {0} (incerto)
+qualifier.approximate = circa {0}
+qualifier.mixed       = circa {0} (incerto)
+
+decade  = gli anni {0}
+century = gli anni {0}
+
+year.ce    = {0}
+year.bce   = {0} a.C.
+year.large = Anno {0}
+
+season.21 = T1 {0}
+season.22 = T2 {0}
+season.23 = T3 {0}
+season.24 = T4 {0}
+
+interval.bounded      = dal {0} al {1}
+interval.openLower    = prima del {0}
+interval.openUpper    = dal {0} in poi
+interval.openBoth     = in qualsiasi momento
+interval.unknownLower = fino al {0}
+interval.unknownUpper = dal {0}
+
+set.empty  = (insieme vuoto)
+set.one    = {0}
+set.two    = {0} o {1}
+set.many   = uno tra: {0}
+list.empty = (lista vuota)
+list.one   = {0}
+list.two   = {0} e {1}
+list.many  = {0}
+
+fallback = {0}

src/main/resources/io/github/openhistoricalmap/edtf/format/messages_ja.properties

@@ -0,0 +1,36 @@
+# Japanese translation of edtf-java formatter strings.
+# See messages_de.properties for the Transifex bootstrap note.
+
+qualifier.uncertain   = {0}\uff08\u4e0d\u78ba\u5b9f\uff09
+qualifier.approximate = \u7d04{0}
+qualifier.mixed       = \u7d04{0}\uff08\u4e0d\u78ba\u5b9f\uff09
+
+decade  = {0}\u5e74\u4ee3
+century = {0}\u5e74\u4ee3
+
+year.ce    = {0}\u5e74
+year.bce   = \u7d00\u5143\u524d{0}\u5e74
+year.large = {0}\u5e74
+
+season.21 = {0}\u5e74\u7b2c1\u56db\u534a\u671f
+season.22 = {0}\u5e74\u7b2c2\u56db\u534a\u671f
+season.23 = {0}\u5e74\u7b2c3\u56db\u534a\u671f
+season.24 = {0}\u5e74\u7b2c4\u56db\u534a\u671f
+
+interval.bounded      = {0}\u304b\u3089{1}
+interval.openLower    = {0}\u4ee5\u524d
+interval.openUpper    = {0}\u4ee5\u964d
+interval.openBoth     = \u3044\u3064\u3067\u3082
+interval.unknownLower = {0}\u307e\u3067
+interval.unknownUpper = {0}\u304b\u3089
+
+set.empty  = \uff08\u7a7a\u96c6\u5408\uff09
+set.one    = {0}
+set.two    = {0}\u307e\u305f\u306f{1}
+set.many   = \u6b21\u306e\u3044\u305a\u308c\u304b: {0}
+list.empty = \uff08\u7a7a\u30ea\u30b9\u30c8\uff09
+list.one   = {0}
+list.two   = {0}\u3068{1}
+list.many  = {0}
+
+fallback = {0}

src/test/java/io/github/openhistoricalmap/edtf/format/EdtfFormatterTest.java

@@ -121,4 +121,65 @@ void maskedDateFallsBackToCanonical() {
         // X-masks aren't yet handled by the formatter; falls back.
         assertThat(f.format(Edtf.parse("2020-XX"))).isEqualTo("2020-XX");
     }
+
+    // ----- locale switching -----
+
+    @Test
+    void germanQualifier() {
+        EdtfFormatter de = EdtfFormatter.forLocale(Locale.GERMAN);
+        assertThat(de.format(Edtf.parse("2020?"))).isEqualTo("2020 (unsicher)");
+        assertThat(de.format(Edtf.parse("2020~"))).isEqualTo("circa 2020");
+    }
+
+    @Test
+    void germanInterval() {
+        EdtfFormatter de = EdtfFormatter.forLocale(Locale.GERMAN);
+        assertThat(de.format(Edtf.parse("2020/2021"))).isEqualTo("2020 bis 2021");
+        assertThat(de.format(Edtf.parse("../2020"))).isEqualTo("vor 2020");
+    }
+
+    @Test
+    void germanMonthUsesLocaleMonthNames() {
+        EdtfFormatter de = EdtfFormatter.forLocale(Locale.GERMAN);
+        // java.time supplies the month name in German automatically.
+        assertThat(de.format(Edtf.parse("2020-05"))).isEqualTo("Mai 2020");
+    }
+
+    @Test
+    void frenchQualifier() {
+        EdtfFormatter fr = EdtfFormatter.forLocale(Locale.FRENCH);
+        assertThat(fr.format(Edtf.parse("2020~"))).isEqualTo("vers 2020");
+    }
+
+    @Test
+    void frenchInterval() {
+        EdtfFormatter fr = EdtfFormatter.forLocale(Locale.FRENCH);
+        assertThat(fr.format(Edtf.parse("2020/2021"))).isEqualTo("de 2020 \u00e0 2021");
+    }
+
+    @Test
+    void spanishCenturyAndDecade() {
+        EdtfFormatter es = EdtfFormatter.forLocale(new Locale("es"));
+        assertThat(es.format(Edtf.parse("199"))).isEqualTo("los a\u00f1os 1990");
+        assertThat(es.format(Edtf.parse("20"))).isEqualTo("los a\u00f1os 2000");
+    }
+
+    @Test
+    void italianBceYear() {
+        EdtfFormatter it = EdtfFormatter.forLocale(Locale.ITALIAN);
+        assertThat(it.format(Edtf.parse("-0044"))).isEqualTo("44 a.C.");
+    }
+
+    @Test
+    void japaneseSeason() {
+        EdtfFormatter ja = EdtfFormatter.forLocale(Locale.JAPANESE);
+        assertThat(ja.format(Edtf.parse("2020-21"))).isEqualTo("2020\u5e74\u7b2c1\u56db\u534a\u671f");
+    }
+
+    @Test
+    void unknownLocaleFallsBackToDefaultBundle() {
+        // Klingon hasn't been added; should fall back to root (English).
+        EdtfFormatter kl = EdtfFormatter.forLocale(new Locale("tlh"));
+        assertThat(kl.format(Edtf.parse("2020?"))).isEqualTo("2020 (uncertain)");
+    }
 }