inline_forms 8.0.4 → 8.1.1

data/docs/git-deps-assessment.md

@@ -1,93 +0,0 @@
-# Git-sourced installer dependencies — assessment
-
-**Date:** 2026-05-19  
-**Context:** Generated apps from `inline_forms create` used three non-RubyGems pins: `tabs_on_rails` (git + branch), `i18n-active_record` (git), and a commented `will_paginate` fork. This doc records why they existed and what replaced them.
-
-**Related (risk callouts only):** `validation_hints/stuff/rails-7.2-zeitwerk-plan.md` (Track A3), `validation_hints/stuff/rails-8-checklist.md` (Phase 3).
-
----
-
-## Summary (7.13.5+)
-
-| Gem | Was | Now | Reason |
-|-----|-----|-----|--------|
-| `will_paginate` | RubyGems + commented acesuares fork | RubyGems only | Fork never active; comment removed |
-| `tabs_on_rails` | `acesuares/tabs_on_rails` branch `update_remote_before_action` | `~> 3.0` (weppos, RubyGems) | Fork only added unused `:remote` on tab links; upstream 3.0.0 already uses `before_action` |
-| `i18n-active_record` | `acesuares/i18n-active_record` (2012) | **Removed** (7.13.18: no DB translation tables) | Never configured `I18n.backend`; DB tables/view and `extract_translations` removed |
-
-**No generated-app Gemfile should use `:git` for these anymore.**
-
----
-
-## `will_paginate`
-
-- **Fork:** `https://github.com/acesuares/will_paginate.git` (commented out for years).
-- **Usage:** Nested/top-level list pagination in `_list.html.erb`; Turbo Frame nav since 7.5.x (no `:remote => true`).
-- **Verdict:** RubyGems `will_paginate` is sufficient. No acesuares-specific behavior required.
-
----
-
-## `tabs_on_rails`
-
-### Why the fork existed
-
-Branch `update_remote_before_action` on `acesuares/tabs_on_rails` (2019) did two things:
-
-1. `before_filter` → `before_action` (Rails 4+ rename).
-2. Optional `:remote => true` on `tab_for` links (`tabs_builder.rb`).
-
-### What inline_forms actually uses
-
-- Controllers call **`set_tab :resource`** only (generator template + installer).
-- Top bar is **not** built with `tabs_tag` / `tab_for`; `_inline_forms_tabs.html.erb` is a Foundation top-bar with search + new button.
-- Turbo migration removed **`data-remote`** from inline UI; no code passes `:remote` into tabs.
-
-### Upstream today
-
-- **RubyGems:** `tabs_on_rails` **3.0.0** (weppos, 2017).
-- **`set_tab`** already uses **`before_action`** in `lib/tabs_on_rails/action_controller.rb`.
-- **Missing vs fork:** `:remote` on tab links only — **unused by inline_forms**.
-
-### Verdict
-
-**Use `gem 'tabs_on_rails', '~> 3.0'`.** No runtime dependency on the fork. Re-test on Rails 7.2+ / 8.0 when upgrading (gem is unmaintained but tiny).
-
----
-
-## `i18n-active_record`
-
-### History
-
-- Fork existed because MySQL reserves `KEY`; acesuares fork used **`thekey`**.
-- **7.13.5–7.13.17:** gem removed from Gemfile; installer still generated locale/key/translation tables + `translations` view; **`InlineForms::TranslationRecord`** read the view; **`extract_translations`** exported YAML (never routed by default).
-- **`I18n.backend` was never** `I18n::Backend::ActiveRecord` in generated apps.
-
-### Verdict (7.13.18+)
-
-**No DB translation layer.** Generated apps use Rails I18n YAML only (`config/locales/inline_forms_local.en.yml`, etc.). If **I18n::Backend::ActiveRecord** is needed later, add **`i18n-active_record ~> 1.4`** and migrations separately—not via inline_forms installer.
-
----
-
-## Previously removed forks (reference)
-
-| Gem | Removed in | Replacement |
-|-----|------------|-------------|
-| `devise-i18n` | 7.3.4 / 7.10+ | RubyGems `~> 1.16` |
-| `paper_trail` | 7.0.x | RubyGems `~> 16.0` |
-| `switch_user` | 7.2.x | Removed from installer |
-
----
-
-## Verification
-
-After changing `installer_core.rb`:
-
-```bash
-cd /home/code/inline_forms && rvm use . && gem build inline_forms.gemspec && gem build inline_forms_installer.gemspec
-cd /home/code/testInline && rvm use .
-gem install /home/code/inline_forms/inline_forms-*.gem /home/code/inline_forms/inline_forms_installer-*.gem
-rm -rf MyApp && inline_forms create MyApp -d sqlite --example
-cd MyApp && rvm use . && bundle exec rails test
-```
-
-Expect **0 failures**; `Gemfile.lock` should list `tabs_on_rails (3.0.0)` and **no** `i18n-active_record` git source.

data/docs/jquery-widgets.md

@@ -1,25 +0,0 @@
-# jQuery widget migration (Phase 4)
-
-UJS removal (7.8.0) is complete. These jQuery-based widgets remain in the Sprockets bundle:
-
-| Widget | Asset | Status |
-|--------|-------|--------|
-| Datepicker | `jquery.ui.all` | **Centralized** — `initInlineFormsWidgets` in `inline_forms.js`; helpers use `class="datepicker"` only |
-| Month/year picker | jQuery UI datepicker | **Centralized** — `class="datepicker datepicker-month-year"` |
-| Timepicker | `jquery.timepicker.js` | **Centralized** — `class="timepicker"` |
-| Autocomplete | `autocomplete-rails` + inline scripts in `dropdown_with_other` | Still inline / jQuery UI |
-| Foundation | `foundation` jQuery plugin | Required for layout chrome |
-
-## Central init (7.9.8+)
-
-`initInlineFormsWidgets(root)` runs on:
-
-- DOM ready (after `$.datepicker.setDefaults`)
-- `turbo:load`
-- `turbo:frame-load`
-
-Form element `_edit` helpers must **not** emit per-field `<script>` tags; class hooks only.
-
-## Future removal (not started)
-
-Replace with Stimulus or vanilla + `turbo:frame-load` one widget at a time; keep example-app tests green after each.

data/docs/prompt/.gitignore

@@ -1,5 +0,0 @@
-# Keep this directory for checked-in prompt docs.
-# Ignore local scratch files by default.
-*
-!.gitignore
-!*.md

data/docs/prompt/test-the-example-app.md

@@ -1,32 +0,0 @@
-You are in the inline_forms gem repo at /home/code/inline_forms.
-
-Goal:
-Build the current gem, install it into /home/code/testInline, recreate MyApp from scratch using --example, and verify it with Rails tests.
-
-Do all steps end-to-end without asking for confirmation unless a command fails.
-
-Steps:
-1) In /home/code/inline_forms:
-   - Ensure latest code is used.
-   - Run: rvm use .
-   - Build gems: gem build inline_forms.gemspec && gem build inline_forms_installer.gemspec
-   - Confirm the built file names/versions (inline_forms-<version>.gem, inline_forms_installer-<version>.gem).
-
-2) In /home/code/testInline:
-   - Remove old app if present: /home/code/testInline/MyApp
-   - Run: rvm use .
-   - Install the freshly built gems from /home/code/inline_forms/inline_forms-<version>.gem and inline_forms_installer-<version>.gem
-
-3) Still in /home/code/testInline:
-   - Generate fresh example app:
-     inline_forms create MyApp -d sqlite --example
-
-4) In /home/code/testInline/MyApp:
-   - Run: rvm use .
-   - Run verification: bundle exec rails test
-
-Output requirements:
-- Briefly report each phase result (build, install, app generation, test run).
-- Include exact commands run.
-- Include test summary (runs/assertions/failures/errors/skips).
-- If anything fails, stop at the failing step and include the exact error and the next corrective command you recommend.

data/docs/rails-8-phase4-audit.md

@@ -1,39 +0,0 @@
-# Rails 8 — Phase 4 audit (framework defaults & cleanup)
-
-**Date:** 2026-05-22  
-**Scope:** Post–Phase 3 (`inline_forms` 8.0.2 installer + example app gate).
-
-## 4.1 Framework defaults (`rails new` 8.0.5)
-
-Vanilla `rails _8.0.5_ new` (importmap, `--skip-bundle`):
-
-- `config/application.rb`: `config.load_defaults 8.0`, `config.autoload_lib(ignore: %w[assets tasks])`
-- Generator **removes** `config/initializers/new_framework_defaults_8_0.rb` (opt-in flags live only in the railties template until uncommented)
-- Optional 8.0 toggles (all commented in upstream template): `active_support.to_time_preserves_timezone`, `action_dispatch.strict_freshness`, `Regexp.timeout`
-
-**Installer decision:** Match vanilla Rails 8 — rely on `load_defaults 8.0` only; do **not** ship `new_framework_defaults_8_0.rb` in generated apps. Keep a belt-and-suspenders `gsub` to `load_defaults 8.0` if an older `rails new` left another minor.
-
-## 4.2 Rails 8 API / deprecation grep
-
-| Area | Result |
-|------|--------|
-| `form_with` / `model: nil` | No engine usage; inline fields use custom helpers / Turbo, not `form_with` |
-| `form_for` | Devise templates only (upstream Devise 5) |
-| `ActiveRecord::Base.connection` | Unicorn `before_fork` template updated → `connection_pool.disconnect!` |
-| `ActionController` deprecated flags | None in `lib/` |
-| Generator migrations | `ActiveRecord::Migration[8.0]` (tests assert) |
-
-## 4.3 Dart Sass / SCSS
-
-Foundation + engine SCSS still emit Dart Sass 1.x deprecation warnings during `dartsass:build`. Accepted for 8.0 ship; migrate to `@use` / `color.scale` before Dart Sass 3.0 (see `stuff/pipeline.md`).
-
-## 4.4 bundler-audit
-
-| Lockfile | Result (2026-05-22) |
-|----------|---------------------|
-| `validation_hints/Gemfile.lock` | No vulnerabilities found |
-| Example app `MyApp/Gemfile.lock` | No vulnerabilities found (`bundler-audit` on default gemset) |
-
-## 4.5 Example app gate (unchanged baseline)
-
-`inline_forms create MyApp -d sqlite --example` → **88 runs, 502 assertions, 0 failures, 0 errors, 0 skips** (Phase 3, Rails 8.0.5 stack).

data/docs/rails-8-release.md

@@ -1,56 +0,0 @@
-# Rails 8.0 release (8.0.x line)
-
-**Shipped:** 2026-05-22  
-**Tags:** `v8.0.3` (inline_forms, inline_forms_installer, validation_hints)
-
-## Stack
-
-| Component | Constraint |
-|-----------|------------|
-| Ruby | `>= 4.0` (generated apps: `ruby-4.0.4`) |
-| Rails | `>= 8.0`, `< 8.1` |
-| rails-i18n | `>= 8.0`, `< 9.0` |
-| validation_hints | `>= 8.0.2`, `< 9.0` (release **8.0.3** lockstep) |
-
-Install CLI:
-
-```bash
-gem install inline_forms_installer
-inline_forms create MyApp -d sqlite --example
-```
-
-Pre-release local builds: installer auto-installs `*.gem` from `~/inline_forms` / `~/validation_hints` when present (no `path:` in consumer Gemfiles).
-
-## Verification gate (2026-05-22)
-
-| Check | Result |
-|-------|--------|
-| validation_hints `rake test` | 24 runs, 50 assertions, 0 failures |
-| inline_forms `rake test` | 24 runs, 89 assertions, 0 failures |
-| `inline_forms create MyApp -d sqlite --example` | OK (Rails 8.0.5) |
-| `bundle exec rails zeitwerk:check` | All is good! |
-| `bundle exec rails test` (MyApp) | **88 runs, 502 assertions, 0 failures, 0 errors, 0 skips** |
-| `bundler-audit` (validation_hints lockfile) | No vulnerabilities found |
-
-## Migration phases (maintainer runbook)
-
-Canonical step-by-step: `stuff/rails8forReal.md` (local; gitignored in this repo). Mirror checklist: `validation_hints/stuff/rails-8-checklist.md`.
-
-| Phase | Status |
-|-------|--------|
-| 0 Baseline | Done |
-| 1 validation_hints → AR 8 | Done (8.0.1+) |
-| 2 inline_forms engine → Rails 8 | Done (8.0.1+) |
-| 3 Installer + example app | Done (8.0.2+) |
-| 4 Framework defaults + audit | Done (8.0.3) — [`rails-8-phase4-audit.md`](rails-8-phase4-audit.md) |
-| 5 Release + docs | Done (8.0.3) — this file |
-
-## Zeitwerk
-
-See [`zeitwerk-and-load-paths.md`](zeitwerk-and-load-paths.md). No remaining active code on pre-Zeitwerk `app/helpers/form_elements/` paths.
-
-## Deferred
-
-- Dart Sass 3.0 (`@import` removal) — not released; deprecations only on Dart Sass 1.x
-- [`stuff/towards_rails_8.md`](../stuff/towards_rails_8.md) product bets (auth, encryption, …) — post-ship
-- Asset pipeline (`stuff/pipeline.md`) — orthogonal

data/docs/turbo-stream-audit.md

@@ -1,16 +0,0 @@
-# Turbo Stream audit (optional)
-
-Stock inline_forms flows use **`format.html`** inside matching `<turbo-frame>` ids. **`format.turbo_stream`** is used where a single response must update **multiple** frames (e.g. revert from the versions panel).
-
-## Current turbo_stream usage
-
-| Action | Response | Notes |
-|--------|----------|-------|
-| `revert` | `turbo_stream.replace` row + versions frames | Required when POST originates inside `*_versions` frame |
-
-## Candidates for future streams (not migrated)
-
-- Row destroy fade-out animation (today: HTML `row_destroyed` replaces frame)
-- Multi-field batch updates (no stock flow today)
-
-No change required for the example app; integration tests assert HTML frame contracts.

data/docs/ujs-to-turbo.md

@@ -1,207 +0,0 @@
-# UJS → Turbo migration checklist
-
-> **Decommissioned.** This checklist is frozen as of 2026-05-17.  
-> **Use the combined roadmap instead:** [`stuff/roadmap.md`](../stuff/roadmap.md)  
-> Canonical copy also at: `validation_hints/stuff/roadmap.md`
-
-**Steps 1–5 are complete** (inline_forms **7.9.6**). Remaining work (jQuery widget migration, optional `turbo_stream` audit, validation hint copy, Rails security bump) is tracked in **`roadmap.md`**.
-
----
-
-## Historical reference (archived)
-
-<details>
-<summary>Original UJS → Turbo checklist (click to expand)</summary>
-
-Track progress toward full Turbo integration and removal of jQuery UJS from inline_forms generated apps.
-
-**Current gem version:** see `lib/inline_forms/version.rb` (**Step 5** — Turbo Drive on, jquery-ujs / remotipart removed in **7.8.0**)
-
-**Architecture today:** inline interactions use **`<turbo-frame>`** + **`format.html`** (and optional **`format.turbo_stream`**). Turbo loads as an ES module from the layouts; **Turbo Drive** uses the library default (**enabled**). No `*.js.erb` in active engine views; no `jquery_ujs` or `jquery.remotipart` in the Sprockets bundle.
-
-**Target end state:** Stock flows use Turbo Frames + HTML; optional `turbo_stream` where it simplifies a response. jQuery UJS and `*.js.erb` are gone from the engine.
-
----
-
-## Step 1 — Turbo wired (DONE)
-
-- [x] `gem 'turbo-rails'` in installer Gemfile (`bin/inline_forms_installer_core.rb`)
-- [x] Turbo loaded as `<script type="module">` in `layouts/inline_forms.html.erb` and `layouts/application.html.erb`
-- [x] `Turbo.session.drive` uses the **default (enabled)** — **7.8.0** (was disabled while UJS coexisted)
-- [x] Turbo **not** in Sprockets bundle (`app/assets/javascripts/inline_forms/inline_forms.js`) — ESM parse-error lesson from 7.1.1
-- [x] Smoke test: `lib/installer_templates/example_app_tests/test/integration/example_app_turbo_layout_test.rb`
-
----
-
-## Step 2 — Nested list + pagination as Turbo Frame (DONE)
-
-- [x] `_list.html.erb`: nested has_many container is `<turbo-frame id="…_list">` when `parent_class` present
-- [x] Nested pagination: no `:remote => true`; `update=` param matches frame id (`…_list` suffix)
-- [x] `InlineFormsController#index`: HTML for nested frame requests; `turbo_rails/frame` vs `inline_forms` layout negotiation
-- [x] **Nested rows (7.4.2):** per-row `<turbo-frame>` + Turbo presentation links; **`row_html_turbo_allowed?`** enables **`format.html`** row open/close for **`not_accessible_through_html?`** models when **`params[:update]`** is a nested associated row id (`apartment_<aid>_photo_<pid>`). Removed row-level **`data-turbo="false"`** (field cancel + pagination use Turbo inside nested frames).
-- [x] Top-level rows must **not** carry `data-turbo="false"` (would poison inner frames — 7.2.3)
-- [x] Smoke test: `example_app_apartment_photos_pagination_test.rb`
-- [x] Example seed data (Konferensha + photos) for pagination assertions
-
-**Explicitly deferred in this step:** top-level index lists (`/apartments`) stay full-page + UJS row open.
-
----
-
-## Step 3 — Per-row / per-field inline-edit lifecycle
-
-Convert the **`show → edit → update → show_element → close`** cycle without UJS.
-
-### DOM contract (unchanged)
-
-- Every editable region needs a stable id: `{model}_{id}_{attribute}` (e.g. `apartment_5_name`)
-- `params[:update]` must match that id (set by `link_to_inline_edit`, `_edit.html.erb`, etc.)
-
-### Row-level (stock list → full `_show` panel)
-
-- [x] Wrap each top-level list row in `<turbo-frame id="apartment_<id>">` (`_list.html.erb` when `parent_class` is nil)
-- [x] Row title link: GET `show` → HTML `row_show` / `_show` inside frame (no `:remote`; `data-turbo` + `data-turbo-frame`)
-- [x] `InlineFormsController#show` (full record, no `params[:attribute]`): `format.html` → `row_show` / `row_close` + `turbo_rails/frame` when `turbo_frame_request?`, else full `inline_forms` layout
-- [x] `close_link` and `_close` presentation link: Turbo when `@inline_forms_turbo_row` (row HTML path)
-- [x] `soft_delete`, `soft_restore`, `destroy`, `revert`: `format.html` → `row_close` / `row_destroyed` (+ Turbo toolbar links)
-- [x] Remove `edit.js.erb`, `update.js.erb`, `show_element.js.erb` (field lifecycle is Turbo HTML only)
-- [x] Remove `show.js.erb`, `close.js.erb`, `record_destroyed.js.erb`, `show_undo.js.erb` (7.7.0; tree migrated)
-- [x] Remove `:remote => true` from nested `_list` / `_close` / toolbar where migrated (row toolbar, versions, nested `+` use Turbo; top-level `new` was Step 4)
-- [x] Remove `data-turbo="false"` from nested rows once nested inline-edit is Turbo-native (7.4.2)
-
-### Nested associated lists (e.g. Apartment → Photo)
-
-- [x] Each nested row is `<turbo-frame id="{parent}_{id}_{assoc}_{child_id}">` with Turbo presentation links (same contract as top-level).
-- [x] **`row_html_turbo_allowed?`:** `format.html` row open/close for **`not_accessible_through_html?`** models when **`params[:update]`** matches a nested associated row id (≥4 underscore segments, trailing numeric id).
-- [x] Scalar field edit/cancel inside nested **`_show`** uses existing **`format.html`** field templates (no **`UnknownFormat`** for Photo).
-
-### Field-level (`link_to_inline_edit` / `*_show` helpers)
-
-- [x] **Stock `_show` scalar fields**: wrapped in `<turbo-frame id="{model}_{id}_{attribute}">`; `@inline_forms_turbo_field = true` so `link_to_inline_edit` omits `:remote => true`
-- [x] **`link_to_inline_edit`**: uses Turbo when `@inline_forms_turbo_field` or explicit `turbo_frame: true`
-- [x] **`InlineFormsController#edit`, `#update`, `#show`** (single attribute): `format.html` + `field_edit` / `field_show` templates when `turbo_frame_request?`
-- [x] **`_edit.html.erb`**: omits `:remote => true` when `@turbo_frame` (Turbo form submit inside frame)
-- [x] Remove `edit.js.erb`, `update.js.erb`, `show_element.js.erb`
-- [x] **`not_accessible_through_html?` models** (e.g. Photo): nested list row **`show` / `close`** use **`format.html`** when **`params[:update]`** is a nested row id (`row_html_turbo_allowed?`); field **`edit` / `update` / `show`** already always register **`format.html`**.
-
-### Widget re-init after swap
-
-- [x] ActionText/Trix: `turbo:frame-load` in `inline_forms.js` attaches Trix editors after frame replace
-- [x] jQuery UI datepicker / timepicker: re-bound on `turbo:frame-load` (autocomplete widgets in field partials still use inline scripts until Step 5)
-
-### Helpers (`app/helpers/inline_forms_helper.rb`)
-
-- [x] `close_link`, `link_to_soft_delete`, `link_to_destroy`, `link_to_new_record`, `link_to_versions_list`, `close_versions_list_link`: Turbo frame attrs only (**7.8.0**; `turbo_row:` retained for API compat)
-
-### Tests
-
-- [x] Integration: stock row open/close on `/apartments` (Turbo frame + HTML `show` / `close`): `example_app_apartment_row_turbo_test.rb`
-- [x] Integration: open apartment row → edit text field → save → cancel (field flow: `example_app_apartment_field_turbo_test.rb`)
-- [x] Integration: nested Photo row open/close + name field cancel (`example_app_apartment_photos_pagination_test.rb`)
-- [x] Integration: replace photo image (multipart) inside nested frame (`example_app_apartment_photos_pagination_test.rb`)
-- [x] Integration: custom field-only page (`ApartmentsController#name_list`) — Turbo edit/update/cancel without full `_show`
-- [x] Assert no `406 UnknownFormat` on Turbo field update (name list test)
-- [x] Integration: row destroy + PaperTrail revert via Turbo (`example_app_apartment_row_turbo_test.rb`)
-- [x] Integration: versions panel open/close via Turbo (`example_app_apartment_versions_turbo_test.rb`)
-
----
-
-## Step 4 — Remaining UJS surfaces
-
-### Lists and create flow
-
-- [x] Top-level index: wrap in `<turbo-frame id="apartments_list">`; in-frame pagination (7.7.0)
-- [x] `new` / `create`: frame refresh replacing list container (7.7.0)
-- [x] Remove `new.js.erb`, `list.js.erb` (7.7.0)
-- [x] `_new.html.erb`: Turbo path when `@turbo_frame` (no `:remote` on cancel)
-
-### Tree
-
-- [x] ~~`:tree` / `_tree.html.erb`~~ — **archived in 7.7.0** (`archived/form_elements/tree/`); needs host tree gem/APIs. Turbo-ready partial kept in archive.
-
-### Versions panel
-
-- [x] `VersionsConcern#list_versions`: HTML frame (`versions_panel` / `versions_list_panel`, `turbo_rails/frame` layout) — **7.7.3** drops `format.js`
-- [x] Remove `versions.js.erb`, `versions_list.js.erb` (**7.7.3**)
-- [x] `_versions_list.html.erb`: revert uses `inline_forms_turbo_link_data` (row frame), not `:remote => true`
-
-### Geo / misc
-
-- [x] ~~`geo_code_curacao`~~ — **archived in 7.6.0** (`archived/form_elements/geo_code_curacao/`). If restored, migrate `list_streets.js.erb` to frame or stream.
-
-### Controller cleanup
-
-- [x] Every action in `InlineFormsController` + `VersionsConcern` has a non-JS response path (**7.8.0** audit)
-- [ ] Audit `respond_to` blocks: parallel `format.turbo_stream` where stream is cleaner than full frame (optional)
-
-### Tests
-
-- [x] Top-level list pagination in frame (`example_app_apartment_top_level_pagination_test.rb`)
-- [x] Create apartment → list frame updates (`example_app_apartment_top_level_new_test.rb`)
-- [x] Versions panel open/close + revert from list (`example_app_apartment_versions_turbo_test.rb`, **7.7.3**)
-- [x] Assert zero `data-remote="true"` in rendered HTML for inline_forms flows (helpers + `_new` / `_close` no longer fall back to UJS — **7.8.0**)
-
----
-
-## Step 5 — Enable Drive, remove UJS (DONE in **7.8.0**)
-
-- [x] Remove `Turbo.session.drive = false` from both layouts (Drive default **on**)
-- [x] Delete `//= require jquery_ujs` from `inline_forms.js`
-- [x] Delete `//= require jquery.remotipart` from `inline_forms.js`
-- [x] Delete all `app/views/inline_forms/*.js.erb` (completed by **7.7.3**)
-- [x] Remove `format.js` branches from controllers (none remain on stock actions)
-- [x] Update `example_app_turbo_layout_test.rb`: refute `Turbo.session.drive = false`
-- [x] Full `bundle exec rails test` in `--example` app (before release)
-
-### jQuery (optional follow-up — not required to drop UJS)
-
-These can remain while UJS is gone; separate migration if desired:
-
-- [ ] `jquery.ui.all` (datepicker)
-- [ ] `jquery.timepicker.js`
-- [ ] `autocomplete-rails`
-- [ ] `foundation` jQuery plugin → consider Foundation JS without jQuery or Stimulus
-
----
-
-## Reference — UJS inventory
-
-### `*.js.erb` (all to delete by Step 5)
-
-| File | Effect |
-|------|--------|
-| `show.js.erb` | Replace row with `_show` |
-| `edit.js.erb` | Replace `#update_span` with `_edit` form |
-| `update.js.erb` | Replace with `{form_element}_show` |
-| `show_element.js.erb` | Single-field show after update |
-| `new.js.erb` | Replace with `_new` form |
-| `list.js.erb` | Replace list container |
-| `close.js.erb` | Fade + `_close` partial |
-| `record_destroyed.js.erb` | Fade out row |
-| `show_undo.js.erb` | Undo link after destroy |
-| ~~`versions.js.erb`~~ | Removed **7.7.3** — versions panel HTML frame |
-| ~~`versions_list.js.erb`~~ | Removed **7.7.3** — versions list HTML frame |
-| ~~`geo_code_curacao/list_streets.js.erb`~~ | Archived 7.6.0 — street autocomplete JSON |
-
-### Controller actions still on `format.js`
-
-None on `InlineFormsController` / `VersionsConcern` stock actions (**7.8.0**). Host app controllers may still use `format.js`.
-
-### Key files
-
-- `app/controllers/inline_forms_controller.rb`
-- `app/controllers/concerns/versions_concern.rb`
-- `app/views/inline_forms/_list.html.erb`, `_show.html.erb`, `_edit.html.erb`, `_new.html.erb`
-- `app/helpers/inline_forms_helper.rb`
-- `app/helpers/form_elements/*.rb` (`*_show` → `link_to_inline_edit`)
-- `app/assets/javascripts/inline_forms/inline_forms.js`
-- `app/views/layouts/inline_forms.html.erb`
-
----
-
-## Custom field-only pages (helper bypass)
-
-Stock `_show` / `_list` are not required for inline edit. Any page can call form-element helpers (e.g. `text_field_show(apartment, :name)`) inside a container with id `apartment_<id>_name`. Edit/update still hit `ApartmentsController#edit` / `#update` via polymorphic paths.
-
-Example app **`--example` name list** (`GET /apartments/name_list`): custom page using the **same** turbo-field contract as stock `_show` (not a separate code path). Linked from the **More** menu; regression-tested after stock field Turbo lands.
-
-</details>

data/docs/zeitwerk-and-load-paths.md

@@ -1,49 +0,0 @@
-# Zeitwerk and load paths (inline_forms + validation_hints)
-
-**Last verified:** 2026-05-22 — `bundle exec rails zeitwerk:check` on a fresh **`inline_forms create MyApp -d sqlite --example`** app (Rails **8.0.5**): **All is good!**
-
-## inline_forms engine
-
-### Autoloaded by Zeitwerk (host app eager load)
-
-Under the engine’s `app/` tree:
-
-- `app/controllers/` — `InlineFormsController`, concerns
-- `app/helpers/inline_forms_helper.rb`
-- `app/models/concerns/inline_forms/soft_deletable.rb`
-- `app/validators/*` — custom validators
-
-### Intentionally **not** Zeitwerk-autoloaded
-
-| Path | Mechanism | Why |
-|------|-----------|-----|
-| `lib/inline_forms/form_elements/*_helper.rb` | `Rails.autoloaders.main.ignore` + `FormElements.load_helpers!` (`Dir[]` + `require`) | Historical top-level helper method names (`text_field_show`, …); `_helper.rb` filenames do not map to Zeitwerk constants |
-| `lib/inline_forms.rb` boot | Explicit `require` of version, registry, `form_elements`, `turbo_tabs_builder`, `archived_form_elements` | Boot order before engine initializers |
-| `lib/generators/` | Rails generator autoload | Not part of host app Zeitwerk |
-| `archived/form_elements/` | Not required | Legacy project-specific elements; registry blocks use in `inline_forms_attribute_list` |
-
-Track B migration (7.13.x): moved active elements from `app/helpers/form_elements/*.rb` to `lib/inline_forms/form_elements/*_helper.rb`. See `CHANGELOG.md` (Zeitwerk / form elements).
-
-### Nothing left on the old path
-
-There is **no** `app/helpers/form_elements/` in the shipped gem (only under `archived/`).
-
-## validation_hints
-
-| Path | Mechanism | Why |
-|------|-----------|-----|
-| `lib/active_model/hints.rb` | Explicit `require` in `lib/validation_hints.rb` | Defines `ActiveModel::Hints` in the `ActiveModel` namespace (collapse); not under `validation_hints/` |
-| `lib/validation_hints/validations_patch.rb` | Explicit `require` | Patches applied via `ActiveSupport.on_load(:active_model)` |
-| `lib/validation_hints/railtie.rb` | Loaded when `Rails::Railtie` is defined | Standard gem entry |
-
-Non-Rails use: `require "validation_hints"` loads hints + patch + I18n without Zeitwerk.
-
-## Host app checklist
-
-After upgrading or generating an app:
-
-```bash
-cd MyApp && rvm use . && bundle exec rails zeitwerk:check
-```
-
-If you vendor custom form-element helpers into the host app, keep them under `app/helpers/` with Zeitwerk-friendly names or add `config.autoload_lib` / ignores as needed.