[n4ff4h]

javaabu/generators v2.0

v2 is a new major of the code generators for the Javaabu next-gen packages (epic #18). It reads a table and writes a complete, tested admin resource:

File	Built on
Model	The relations found in the schema
Factory
Policy and permissions	javaabu/permissions
Filters and sorts	javaabu/filters
Bulk actions	javaabu/bulk-actions
Form, which also validates	javaabu/stencil
Controller and routes
Pages	Blade (javaabu/forms v2) or Inertia React (@javaabu/forms)
Feature tests	They pass as generated

What's new

• Schema. It's read through Laravel's schema builder on MySQL, MariaDB, PostgreSQL and SQLite. Enum options come from the type or from check constraints. Enum classes come from comments or generators.enums. doctrine/dbal is dropped.
• Relations (Smarter generators #7). belongsTo comes from foreign keys, hasMany from other tables' keys, and many-to-many from pivot tables. Filters (search, selects, ranges, trashed) and bulk actions (delete, restore, force delete) are generated from the columns.
• Field choice (Choose fields for index and forms #11). --index, --form, --show, or --interactive with Laravel Prompts.
• Blade or Inertia React (Blade and Inertia React output #12). --views=blade|inertia. The Inertia output is TypeScript pages, a JSON resource, <StencilForm>, <FilterBar> and <BulkActionsTable>.
• Nested resources (Nested models #9). --parent=products gives scoped routes, parent-scoped controllers and bulk actions, and tests.
• Media (Media #10). --media=featured_image:image,gallery:image:multiple gives mediapicker attachment collections, MediaPickerFields, the media library routes, and a test that attaches media.
• User types (Multi-auth generator #8). generate:auth customers [--migration] writes:
  • the model, extending Javaabu\Auth\Models\User
  • the config/auth.php guard, provider and broker
  • UserTypes::register()
  • Route::authRoutes() and Route::userAccountActions()
  • the admin pages of its users
  • No auth controllers or views: auth v3 ships them.
• Translatable (Optional javaabu/translatable support #16), optional. It is feature-detected. Tables with translations/lang columns get JsonTranslatable models and ->translatable() fields. CI also runs without the package.
• Dhivehi (Dhivehi localization and RTL #15). The commands' strings are in lang/en and lang/dv. Generic phrases are added to the app's lang/dv.json, and the generated tests use Thaana.
• Docs (Documentation for people and agents #13) and Boost (Laravel Boost guideline and skill #14). docs/, llms.txt, resources/boost/ and AGENTS.md.
• Foundations (Foundations: PHP 8.4 / Laravel 12+, CI matrix, coverage and codestyle #6).
  • PHP 8.4/8.5 × Laravel 12/13 × lowest/stable, plus Pint.
  • Codecov coverage from one leg.
  • Schema tests on MySQL, MariaDB and PostgreSQL.
  • CI fails if javaabu/helpers or javaabu/settings ^1 is in the production tree.

How it's tested

Besides unit and snapshot tests, CI builds a Laravel app (workbench/, an overlay on Testbench's skeleton) with every next-gen package installed. It generates:

• Blade and Inertia resources
• every column type, a pivot, soft deletes and enum classes
• a nested resource
• media
• a translatable model
• a user type

It then runs the generated tests (111 of them, plus hand-written checks that the user type's login works). It also checks the generated PHP with Pint, and type-checks and Prettier-checks the generated React pages.

Upgrading

See docs/upgrading.md.

• Removed: generate:request (the stencil form validates), the API generators, the per-controller generate:auth_* commands, --path, and the icon config.
• Generated code no longer uses javaabu/helpers.
• Code v1 generated keeps working. v2 doesn't overwrite files unless you pass --force.

For you to do

• Codecov: the org needs Codecov and a CODECOV_TOKEN secret, or coverage uploads and the badge won't work.
• Dhivehi: review the strings listed in docs/advanced-usage/dhivehi-and-rtl.md.
• Docs site: register the package with docs.javaabu.com (Register with Javaabu Docs (docs.javaabu.com) #17).
• Release v2.0 when the next-gen dependencies are released; the dev dependencies point at their VCS branches until then.

🤖 Generated with Claude Code