[n4ff4h]

javaabu/stats v2

The next-gen major of stats, built on the fork n4ff4h/stats (next-gen); tracking epic n4ff4h#13. Stat definitions from v1 keep working; the front end, dependencies, routes and database support are new.

What's in it

• Foundations. PHP 8.4+, Laravel 12/13, javaabu/forms v2. No more javaabu/helpers, javaabu/settings or maatwebsite/excel (CI fails if helpers or settings ^1 come back). Branch alias dev-next-gen: 2.x-dev.
• Any database. Date grouping for MySQL, MariaDB, PostgreSQL and SQLite; CI runs the suite on all four.
• Immutable dates. Works in apps that call Date::use(CarbonImmutable::class), as Laravel's starter kits do: dates are CarbonInterface, made with the Date factory. CI runs the whole suite with CarbonImmutable too (Stats fail when the app uses CarbonImmutable (Laravel 13 starter kit default) n4ff4h/stats#14).
• Charts. TimeSeriesChart, CategoryChart, PieChart, Sparkline and StatTile describe a chart in PHP:
  • React draws them with Onu's charts (<StatsChart>, @javaabu/stats through javaabu/manifest). Their npm packages are declared for manifest's pages scope, so manifest:check doesn't ask Blade apps for React packages;
  • Blade draws them as accessible SVG with the same tokens (<x-stats::chart> and friends), mirrored in RTL.
  • Several stats or periods on one plot, and comparisons with the previous period.
• Cached dashboards. Versioned cache keys, TTLs for current and past periods, Stats::forget()/flush(), the InvalidatesStats model trait, Stats::warm() with stats:warm and the WarmStatsCache job.
• Pages. Route::stats() gives time series and categorical pages in Blade or Inertia React:
  • stencil forms, javaabu/filters filters via StatsFilter::from(), and CSV export;
  • for any guard, with overridable controllers.
• API. Route::statsApi() keeps the v1 JSON API.
• Authorization. view_stats through javaabu/permissions and an overridable StatsPolicy.
• Dhivehi and RTL, with docs for people and agents, llms.txt, a Laravel Boost guideline and the javaabu-stats skill.

Upgrade notes

See docs/upgrading.md. The main breaks:

• The material-admin views and the <x-stats::time-series> / <x-stats::categorical> components are removed. Use the pages, charts, or a page per model (extend the controller's filters()).
• Week keys are now the start date of the week, and month keys are YYYY-MM. Hourly keys now match the SQL.
• A plain date_to covers the whole day.
• Date methods type-hint CarbonInterface instead of Carbon; overrides of setDateFrom(), setDateTo(), getMaxDate() and getMinDate() must widen their parameters.
• Exports are CSV without Laravel Excel.
• The route helpers are deprecated in favour of Route::stats() / Route::statsApi().

Before releasing

• Codecov for the Javaabu repo.
• Register with docs.javaabu.com (Register with Javaabu Docs (docs.javaabu.com) n4ff4h/stats#12).
• A Dhivehi speaker should review docs/advanced-usage/dhivehi-and-rtl.md#translations-to-review.
• Once the next-gen packages are released, drop the VCS repositories from composer.json, and move @javaabu/forms to npm.

🤖 Generated with Claude Code