1.0.0

[1.0.0] - 2026-03-13

First stable release. The core API and template conventions are now considered stable.

Added

• requestMethod template variable — All templates now receive the HTTP method of the current
  request (GET, POST, PATCH, DELETE, PUT, HEAD, OPTIONS, OTHER). Enables
  conditional rendering for post-mutation feedback (e.g., showing "Created successfully!" after POST).

• Per-status-code error templates — HtmlResponseHelper.renderErrorPage() now looks for
  templates/errors/{statusCode}.html before falling back to the generic templates/error.html.
  Added PathBasedTemplateResolver.resolveError() to support this lookup. Example 404 page added
  to the product-catalog example at templates/errors/404.html.

• MongoDB count caching — MongoHtmlResponseHandler now caches the results of
  estimatedDocumentCount(), countDocuments(), listDatabaseNames(), and listCollectionNames()
  with a 5-second TTL using a ConcurrentHashMap<String, CacheEntry>. Eliminates one or more
  extra MongoDB round-trips per rendered page. Cache hits are logged at DEBUG level.

• JUnit 5 test suite — Added junit-jupiter 6.0.3 and mockito-core 5.23.0 (with
  byte-buddy 1.18.7-jdk5 for Java 25 support). New test classes:

  • PathBasedTemplateResolverTest — 29 tests covering collection, document, fragment, and error
    template resolution, including all hierarchical fallback branches.
  • HtmxRequestDetectorTest — 14 tests covering HTMX header parsing and isTargeting().
  • TemplateContextBuilderTest — 12 tests covering auth variables, requestMethod, and
    context merging.
  • HtmxResponseHelperTest — 12 tests covering all HTMX response header methods.

• "Handling Mutations" section in DEVELOPERS_GUIDE.md — Documents three patterns for
  responding to form submissions and API mutations: HTMX Fragment Swap (recommended), Post-Redirect-Get,
  and inline response with requestMethod.

Changed

• Version bumped from 0.2.0-SNAPSHOT to 1.0.0 in pom.xml and core/pom.xml.

• DEVELOPERS_GUIDE.md — Version updated to 1.0.0, date updated to 2026-03-13.

• README.md — Maven/Gradle coordinates updated from RELEASE_VERSION placeholder to 1.0.0.

• TEMPLATE_CONTEXT_REFERENCE.md — requestMethod variable documented in Authentication Context
  section.

---

Full Changelog: 0.1.0...1.0.0