feat: Emeroteca section — periodicals browsing gated on server capability

[fabiodalez-dev]

What

Read-only Emeroteca section for instances running Pinakes 0.7.77+ with the periodicals mobile bridge (fabiodalez-dev/Pinakes#411). The app follows the Book Club pattern for optional server-side plugins end to end.

How it works

• Capability gating: periodicalsAvailable flag in FeatureStore (default false — the entry point stays hidden until confirmed). An authenticated probe of GET /api/v1/periodicals/health runs in refreshHealth() in parallel with the book-club probe: 2xx → on, 404 → off, other errors keep the last known value; instance-switch guard included.
• Navigation: entry point in Profile next to Book Club (Newspaper icon); nested graph periodicals → periodicals/{id} → periodicals/years/{yearId}/{year} → periodicals/issues/{id} with the standard slide-in transitions.
• Screens: mastheads list (350ms-debounced search, type filter chips, cursor load-more with dedup) → masthead detail (logo, ISSN, publisher, coverage, holdings statement, volume years with owned/issue counts) → issues of a year (cover, number, date, colour-coded status badge) → issue detail (large cover, spoglio table of contents, Open PDF shown only when the server exposes a public pdf_url).
• Data layer: separate PeriodicalsApi Retrofit interface + defensive @Serializable DTOs (nullable + defaults), PeriodicalsRepository via the shared apiCall/ApiResult plumbing.
• i18n: 57 new keys in all four locales (en/it/fr/de), appended in identical order for generateI18nRes.

Tests & checks

• PeriodicalsUiStateTest: 12 pure-function tests (page merge without duplicates incl. boundary overlap, type filter toggle, status→badge mapping, pdf gating) — ViewModels are exercised only through their pure state functions, per project convention.
• ./gradlew testDebugUnitTest → 145/145 green
• ./gradlew lintDebug → 0 errors (no new warnings)
• ./gradlew assembleDebug and assembleRelease (R8) → build; existing keep rules already cover the new @Serializable DTOs and Retrofit interface.

Notes

• No versionCode/versionName bump here: that happens with the release build as usual.
• Server-side counterpart: feat(emeroteca): mobile bridge — read-only periodicals API for the Android app Pinakes#411 — without it (or with the emeroteca plugin inactive) the probe returns 404 and the section simply never appears.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 4ec4e0f6-533e-43aa-90a7-446d64a4424a

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}